Re: [PATCH] Turn on more documentation

[Noah Lavine]

Hello,

> 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.
>
> WDYT?

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.

Noah