[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] Turn on more documentation

From: Noah Lavine
Subject: Re: [PATCH] Turn on more documentation
Date: Mon, 7 May 2012 08:30:20 -0400


> The problem is that the auto-generated “Standard Library” section looks
> very poor in comparison to the rest of the manual.  So we should really
> try hard to write good doc by hands for these, and come up with a handy
> structure (instead of one node per module, all under “Standard
> Library”).

I could do that pretty easily, but I'm afraid that documentation that
isn't in the same file as the code would tend to be updated less often
than documentation in the same file. It might not be a problem though,
and I'm happy to try.

The other alternative is to make our documentation format more
expressive, but that might be a lot of trouble.

> However, I believe Thien-Thi’s Guile 1.4 has good doc for at least some
> of these modules, and it would be great if it could be incorporated.

That would be ideal, but I was concerned that the documentation wasn't
copyrighted by the FSF. Unless Thien-Thi is interested in contributing
it, of course.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]