[plt-scheme] scribbling newbie

From: Jos Koot (jos.koot at telefonica.net)
Date: Tue Jan 8 15:07:42 EST 2008

Thanks for the quick response. It works fine. Now I can continue on 
scribbling "make/doc.txt".
Jos

----- Original Message ----- 
From: "Matthew Flatt" <mflatt at cs.utah.edu>
To: "Jos Koot" <jos.koot at telefonica.net>
Cc: <plt-scheme at list.cs.brown.edu>
Sent: Tuesday, January 08, 2008 8:47 PM
Subject: Re: [plt-scheme] scribbling newbie


> At Tue, 8 Jan 2008 19:46:04 +0100, "Jos Koot" wrote:
>> 1: what would be the simplest way to see a preview of a scribble? I 
>> looked
>> very hard for such a tool but could not find it.
>
> Building via `setup-plt' is the best way to preview.
>
> When documents get very large, I sometimes run the `scribble'
> executable directly on a file that implements a sub-section. A preview
> generated that way doesn't have all teh right links, though.
>
>> 2: Working on windows XP, I have an info.ss file and a trial.scrbl file 
>> in
>> directory c:\documents and setting\... ...\collects\trial almost 
>> literally
>> copied from the scribble intro. However, setup-plt.exe -l trial produces:
>> setup-plt: don't know how to compile collection: trial. A compile 
>> directory is
>> made and info_ss.dep and info_ss.zo are stored there by setup-plt.exe, 
>> nothing
>> else. Help please?
>
> In addition to the `scribblings' entry, "info.ss" needs a `name' entry.
> So, a suitable initial "info.ss" is
>
>  (module info setup/infotab
>    (define name "Some documentation")
>    (define scribblings '(("manual.scrbl" ()))))
>
>
> The Scribble docs as written assume that you already have an "info.ss",
> so I'll improve the Scribble docs.
>
> Matthew
>
> 



Posted on the users mailing list.