Re: [Schematics-development] SRFI Documentation

[Noel W. <noe...@ya...>]

--- Jens_Axel_Søgaard <jen...@so...> wrote:
> This reminds me. It would very useful to include the
> documentation of the srfi in the helpdesk.

Agreed.  I don't use SRFIs enough because the
documentation is missing.

> I am however not quite sure, which document format
> is best for the
> Helpdesk. Just including the html-pages from
> srfi.schemers.org wouldn't
> be enough to make them searchable - or would it?

Nope.  The two formats are HTML or text (doc.txt). 
For HTML you need to create an index and keywords
file.  The PLT guys use slatex and some custom macros
to do this.  We can probably get hold them - I did for
the SchemeUnit documentation but never got the OK to
include them in the Schematics CVS (I will try again).
 Alternatively we could use another docuementation
prep system (e.g. make SchemeDoc usable or build off
Mole/LAML etc.)  The doc.txt route is quicker - you
just to markup up the text the correct way but long
term I find HTML documentation nicer.

Cheers,
Noel

=====
Email: noelwelsh <at> yahoo <dot> com
Jabber: noelw <at> jabber <dot> org

__________________________________
Do you Yahoo!?
Yahoo! Calendar - Free online calendar with sync to Outlook(TM).
http://calendar.yahoo.com