[racket] scribble/text language

From: Shriram Krishnamurthi (sk at cs.brown.edu)
Date: Mon Sep 26 09:02:49 EDT 2011

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.
>
>



Posted on the users mailing list.