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