[racket] feeding input to Scribble and source location info

From: Neil Van Dyke (neil at neilvandyke.org)
Date: Sun Aug 28 15:58:02 EDT 2011

Matthew Flatt wrote at 08/28/2011 08:40 AM:
> At Sun, 28 Aug 2011 02:46:18 -0400, Neil Van Dyke wrote:
>> Oh, another option to get rid of the two modes: write out a file that 
>> specifies a custom reader (coming from a PLaneT package), and that 
>> reader can read syntax objects and return those rather than making 
>> syntax objects from reading text.
> That sounds right to me, except I'm not sure about the "write out"
> part. I image your document source should be
>  #lang planet neil/toscribble/doc
>  "sourcefile"
> where the reader specified by `neil/toscribble/doc' reads the named
> file and produces a syntax object for a module that is a Scribble
> document.

I should have mentioned that my need is for API documentation embedded 
in a normal "#lang racket/base" file.  So, although it's the source file 
for the documentation, I can't simply hand that file directly to 
Scribble.  I need to translate the file first, and then either call 
Scribble directly with syntax objects or (sounds like) write out a file 
that Scribble then processes.

If I write out a file, but I want Scribble error messages to point to 
locations in the original "#lang racket/base" source file, then I think 
I'll need the written-out file to have the "#lang planet 
neil/toscribble/doc" line that will do a reader trick to make syntax 
objects with locations that refer to the original "#lang racket/base" file.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20110828/5be03e63/attachment.html>

Posted on the users mailing list.