Re: [PATCH] Turn on more documentation

[Ludovic Courtès]

Hi!

Noah Lavine <address@hidden> skribis:

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

All of our manual except “Standard Library” is maintained this way.  It
takes discipline to keep up-to-date, but it also leads to a better
manual IMO.

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

Yes, I was hoping he would be reading us, let’s see.  ;-)

Thanks,
Ludo’.