[Openmcl-devel] some threads documentation, finally

[Ram Krishnan]

On Tuesday, April 15, 2003, at 12:14 PM, Gary Byers wrote:

> On Tue, 15 Apr 2003, Ram Krishnan wrote:
>
>> Any chance of pushing some of this documentation back as doc-strings? 
>> I
>> noticed the code itself doesn't have doc-strings but perhaps we can
>> load the doc-strings and associate them to the function/special
>> variable symbols at startup?
>
> The document sources are now in LyX (www.lyx.org) format, using LyX's
> "DocBook article (SGML)" style.  LyX can export SGML, and there are
> lots of tools for converting from DocBook SGML to other formats (HTML,
> PDF, GNU texinfo, ...).
>
> There might be some way (people who actually understand this stuff 
> might
> know ...) of using existing tools to translate the SGML into something 
> like:
>
> ...
> (function process-run-function "doc-string-for-process-run-function")
> (variable *current-process* "doc-string-for-*current-process*")
> ...
>
> Since the SGML files seem to be structured fairly sanely, it may not
> be too hard to just write a lisp parser that extracts the doc strings.
>
> I know that LyX is available for OSX as part of Fink; I never had much
> luck getting its DocBook support to work there (but admit to not having
> tried too hard.)  If anyone's interested in pursuing this and can't
> produce SGML from the .lyx files (which are now in "Pre_0_14" CVS), 
> please
> let me know and I'll make the .sgml files available.

I tried installing LyX using Fink and am running into problems so could 
you please make the SGML files available? I'd be happy to try and code 
up a little Lisp utility for generating the doc-strings from SGML.

Regards,

-ram


_______________________________________________
Openmcl-devel mailing list
Openmcl-devel at clozure.com
http://clozure.com/cgi-bin/mailman/listinfo/openmcl-devel