Re: [racket] planet/scribble and versions

2011-10-18 Thread Carl Eastlund
On Fri, Sep 9, 2011 at 3:36 PM, Carl Eastlund wrote: > On Fri, Sep 9, 2011 at 3:30 PM, Neil Van Dyke wrote: >> >> I would like for the *displayed* form in the formatted documentation to be >> ":MAJOR:MINOR", and the form that Scribble uses for "require" to be >> ":MAJOR:=MINOR". > > Aha.  Yes, th

Re: [racket] planet/scribble and versions

2011-09-09 Thread Carl Eastlund
On Fri, Sep 9, 2011 at 3:30 PM, Neil Van Dyke wrote: > > I would like for the *displayed* form in the formatted documentation to be > ":MAJOR:MINOR", and the form that Scribble uses for "require" to be > ":MAJOR:=MINOR". Aha. Yes, this is important. It should be doing that; it's a bug that it's

Re: [racket] planet/scribble and versions

2011-09-09 Thread Neil Van Dyke
I should give more context about where I'm coming from. It seems that Scribble does a "require" of the module being documented. PLaneT's notion of backward-compatible is a big simplification, and is not foolproof. The author can make a mistake, or there can be a difference of understanding on

Re: [racket] planet/scribble and versions

2011-09-09 Thread Carl Eastlund
That really depends on what you mean by "correct". The :MAJOR:MINOR form is recommended in planet because it allows you to link to bug fix updates without changing your source code. If the Scribble utilities were to force a :MAJOR:=MINOR form, anyone copying these links would no longer get code c

[racket] planet/scribble and versions

2011-09-08 Thread Neil Van Dyke
Are the macros for PLaneT package specs in "planet/scribble" correct? I haven't traced the code thoroughly, but if the output of "syntax-source-planet-package-symbol" will be used as-is for actual "require" during Scribble formatting... won't the ":MAJOR:MINOR" (not ":MAJOR:=MINOR") version le