[plt-scheme] scribbling newbie

From: Richard Cleis (rcleis at mac.com)
Date: Sat Jan 12 08:57:44 EST 2008

Thanks.  That works.  The paths make more sense, too :)

rac

On Jan 12, 2008, at 5:37 AM, Yavuz Arkun wrote:

> Richard Cleis wrote:
>> setup-plt: Docs failure: algol60.scrbl:4:1: compile: unbound  
>> variable in module in: title
>>
>> I'm using a MacIntel with the Full nightly build.  Should it work  
>> with:
>>
>> #lang scribble/doc
>> @(require scribble/algol60)
>>
>> @title{algol library}
>>
>> Welcome to my documentation: @scheme[(list 'testing 1 2 3)].
>>
>> rac
>>
>>
>> _________________________________________________
>>  For list-related administrative tasks:
>>  http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>>
> I think you need to have a
>
> @require[scribble/manual]
>
> after the #lang scribble/doc line for the @title, @scheme etc to be  
> defined. Some of these are defined in scribble/basic, but scribble/ 
> manual reexports all of them plus some other stuff useful for  
> documenting Scheme.
>
> Incidentally, as far as I can understand, @(require X) and @require 
> [X] evaluate to the same thing, but the Scribble documentation uses  
> the first form while the .scrbl files themselves use the second one  
> (even the scribble.scrbl file itself). Is there a difference that I  
> am missing?
>
> Yavuz
> _________________________________________________
>  For list-related administrative tasks:
>  http://list.cs.brown.edu/mailman/listinfo/plt-scheme



Posted on the users mailing list.