Right. Also, I like how the @syntax document very simply states, up top, "It might be easiest to do ... to run the examples in this section". A similar sentence at the top of this documentation would make a big difference. (It's not obvious that some #lang scribble/... things can be run through scribble but others must be run through racket.)
Shriram On Mon, Sep 26, 2011 at 8:25 AM, Matthew Flatt <[email protected]> wrote: > At Sun, 25 Sep 2011 21:35:08 -0400, Eli Barzilay wrote: >> 50 minutes ago, Shriram Krishnamurthi wrote: >> > Does the scribble/text language work in 5.1.3? Here's the first >> > example in the docs: >> > >> > #lang scribble/text >> > Programming languages should >> > be designed not by piling >> > feature on top of feature, but >> > blah blah blah. >> > >> > ventoux ~/Desktop/r/sk/gradelang> scribble try2.scrbl >> > [...] >> >> Run it with just `racket'. (The `scribble' command line tool is for >> compiling documentation, which is really unrelated to >> `scribble/text'.) > > Can you fix the docs to explain that? One observation to add to the > introduction might be that `scribble --text' produces a text version > for a Scribble document, while `scribble/text' is for a different task. > > _________________________________________________ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/users

