[racket] scribble/text language
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 <mflatt at cs.utah.edu> 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.
>
>