Re: [racket-dev] Documentation

2013-12-08 Thread Robby Findler
Should the history.txt files get stuck into the end of the manuals for the time being? Robby On Sun, Dec 8, 2013 at 8:37 AM, Matthew Flatt wrote: > At Sun, 8 Dec 2013 11:09:39 +0100, Jens Axel Søgaard wrote: > > In cases where the semantics of constructs are changed, should the > > documentati

Re: [racket-dev] Documentation

2013-12-08 Thread Matthew Flatt
At Sun, 8 Dec 2013 11:09:39 +0100, Jens Axel Søgaard wrote: > In cases where the semantics of constructs are changed, should the > documentation have a margin note stating the version number of the > change? Yes, it really should. Details like this get listed in "HISTORY.txt" (the `case` form app

Re: [racket-dev] Documentation lacuna?

2013-01-22 Thread Norman Gray
Jay, hello. On 2013 Jan 22, at 14:24, Jay McCarthy wrote: > I've pushed this change: The example makes it very clear, and is more direct than what I wrote. I did notice "then @racket[mime] is add as a", which should be "added", but I think my inner copy-editor needs a holiday All the be

Re: [racket-dev] Documentation lacuna?

2013-01-22 Thread Jay McCarthy
I've pushed this change: http://git.racket-lang.org/plt/commitdiff/d071dc43873b7e84a59e3c9df47a6c8b3f7c6b1d?hp=7b33298b6654bcd55105e24e99545b98db3206ba Jay On Mon, Jan 21, 2013 at 9:57 AM, Norman Gray wrote: > > Jay, hello. > > On 2013 Jan 21, at 16:12, Jay McCarthy wrote: > >> I don't underst

Re: [racket-dev] Documentation lacuna?

2013-01-21 Thread Norman Gray
Jay, hello. On 2013 Jan 21, at 16:12, Jay McCarthy wrote: > I don't understand your concern. > > The response structure, which is the only actual structure (everything > else is an interface on it)... > > a) Allows #f as the mime type ...but the documentation doesn't say what #f means here.

Re: [racket-dev] Documentation lacuna?

2013-01-21 Thread Jay McCarthy
I don't understand your concern. The response structure, which is the only actual structure (everything else is an interface on it)... a) Allows #f as the mime type b) Has you provide an 'output' function that does the output. If you don't want there to be any output, then don't write any: (resp

Re: [racket-dev] Documentation lacuna?

2013-01-21 Thread Norman Gray
Sorry, an addendum... On 2013 Jan 21, at 12:23, Norman Gray wrote: > In the web server, the documentation for RESPONSE and, by implication, > RESPONSE/FULL does not explain how to avoid including a message-body in the > response, as is required for 1xx, 204, 304 statuses (and those alone). >

Re: [racket-dev] Documentation for dynamic-require and related terms is confusing.

2012-09-19 Thread Joe Gibbs Politz
+1. I started using dynamic-require for the first time over the past few weeks, and was quite bewildered at first. It took me a while to figure out that all I needed was a symbol, and I don't understand the other options yet. I mentioned this separately to Matthew already, because he was helping

Re: [racket-dev] Documentation for dynamic-require and related terms is confusing.

2012-09-16 Thread Matthias Felleisen
I will second the idea behind this request. (I thought I had to use dynamic-require's second argument in the summer, and after studying it for quite a while, i was happy to figure out a way around it.) On Sep 14, 2012, at 3:17 PM, Carl Eastlund wrote: > I just tried to figure out what the se

Re: [racket-dev] Documentation problem

2012-06-25 Thread Antonio Menezes Leitao
> > > Did you use `raco docs' to open the documentation page? > No. All I did was to access the Help Desk from DrRacket's Help menu. BTW, this is a fresh install, after uninstalling the previous version. I can see the wrong links in the file index.html, in AppData/Roaming/Racket/5.3.0.11/doc/

Re: [racket-dev] Documentation problem

2012-06-23 Thread Eli Barzilay
Yesterday, Antonio Menezes Leitao wrote: > Hi, > > Recent nightly builds (e.g., for 5.3.0.10 or 5.3.0.11) install > documentation files that incorrectly point to 5.3.0.4 files. > > This is visible after accessing the Help Desk: the page says it's > for version 5.3.0.4 and clicking on any of the l

Re: [racket-dev] documentation reorganization

2011-07-02 Thread Robby Findler
I don't think you can demote either of these: The Racket Drawing Toolkit The Racket Graphical Interface Toolkit Robby On Sat, Jul 2, 2011 at 10:57 AM, Guillaume Marceau wrote: > On Fri, Jul 1, 2011 at 8:45 PM, Ryan Culpepper wrote: >> I just pushed a commit intended to improve the usabilit

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Guillaume Marceau
On Fri, Jul 1, 2011 at 8:45 PM, Ryan Culpepper wrote: > I just pushed a commit intended to improve the usability of the main > documentation page, especially for newcomers to Racket. You can also > see the new version here: This is great. Heres a few comments that come to mind: Underneath the "

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Robby Findler
Yes, I understood you. I'm observing that making it plural is not helping. On Fri, Jul 1, 2011 at 9:06 PM, Eli Barzilay wrote: > Three minutes ago, Robby Findler wrote: >> On Sat, Jul 2, 2011 at 9:53 AM, Eli Barzilay wrote: >> > Four minutes ago, Robby Findler wrote: >> >> On Sat, Jul 2, 2011 at

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Eli Barzilay
Three minutes ago, Robby Findler wrote: > On Sat, Jul 2, 2011 at 9:53 AM, Eli Barzilay wrote: > > Four minutes ago, Robby Findler wrote: > >> On Sat, Jul 2, 2011 at 9:41 AM, Ryan Culpepper wrote: > >> > re "Low-Level API": the other category labels are generally > >> > plural, and other manuals m

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Robby Findler
On Sat, Jul 2, 2011 at 9:53 AM, Eli Barzilay wrote: > Four minutes ago, Robby Findler wrote: >> On Sat, Jul 2, 2011 at 9:41 AM, Ryan Culpepper wrote: >> > re "Low-Level API": the other category labels are generally >> > plural, and other manuals might get inserted into this category >> > (eg by p

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Sam Tobin-Hochstadt
On Fri, Jul 1, 2011 at 9:41 PM, Ryan Culpepper wrote: > re "misc": Do you mean "Other"? Would you prefer "Other Languages and > Libraries" or "Other Manuals"? I think those should just go under "Experimental Languages", since they're both languages, and at least one is experimental. -- sam th sa

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Eli Barzilay
Four minutes ago, Robby Findler wrote: > On Sat, Jul 2, 2011 at 9:41 AM, Ryan Culpepper wrote: > > re "Low-Level API": the other category labels are generally > > plural, and other manuals might get inserted into this category > > (eg by planet packages) > > The page is regenerated when new manua

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Robby Findler
On Sat, Jul 2, 2011 at 9:41 AM, Ryan Culpepper wrote: > re "Low-Level API": the other category labels are generally plural, and > other manuals might get inserted into this category (eg by planet packages) The page is regenerated when new manuals are added, no? Just make it plural then. > re "mi

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Ryan Culpepper
re "Low-Level API": the other category labels are generally plural, and other manuals might get inserted into this category (eg by planet packages) re "misc": Do you mean "Other"? Would you prefer "Other Languages and Libraries" or "Other Manuals"? Ryan On 07/01/2011 06:51 PM, Robby Findler

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Carl Eastlund
Great stuff. This is a big improvement. Carl Eastlund On Fri, Jul 1, 2011 at 8:45 PM, Ryan Culpepper wrote: > I just pushed a commit intended to improve the usability of the main > documentation page, especially for newcomers to Racket. You can also > see the new version here: > >  http://www.c

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Robby Findler
This looks great to me. Minor thing: "Low-Level APIs" => "Low-Level API" and the last section actually can have a name other than "misc" I think. Robby On Sat, Jul 2, 2011 at 8:45 AM, Ryan Culpepper wrote: > I just pushed a commit intended to improve the usability of the main > documentation pa

Re: [racket-dev] documentation reorganization

2011-07-01 Thread Jon Rafkind
I think the 'guide' and 'reference' links could use a description of what they are similar to the tutorial links. On 07/01/2011 06:45 PM, Ryan Culpepper wrote: > I just pushed a commit intended to improve the usability of the main > documentation page, especially for newcomers to Racket. You can a

Re: [racket-dev] Documentation for 'disappeared-use and 'disappeared-binding

2010-11-28 Thread Robby Findler
The basic idea is that some identifiers from the original program don't survive into the fully expanded form. So macros that makes those identifiers disappear record that they've done so with this syntax property. Robby On Sun, Nov 28, 2010 at 6:02 AM, Casey Klein wrote: > The documentation does

Re: [racket-dev] Documentation bug - 12.6.3: Reading numbrs

2010-07-27 Thread Eli Barzilay
On Jul 27, The Configurator wrote: > > Shouldn't all the usages of inexact->exact here actually be > exact->inexact ? Yes, thanks -- fixed in git. -- ((lambda (x) (x x)) (lambda (x) (x x))) Eli Barzilay: http://barzilay.org/ Maze is Life!