guile-devel
[Top][All Lists]
Advanced

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

Re: [PATCH] Turn on more documentation


From: Andy Wingo
Subject: Re: [PATCH] Turn on more documentation
Date: Tue, 15 May 2012 22:19:43 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.4 (gnu/linux)

Howdy,

On Sun 06 May 2012 12:14, address@hidden (Ludovic Courtès) writes:

> 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 agree.  I used to think that auto-generation would work as well or
better than .texi files, but I think time has definitely proved me
wrong, and the GCS right
(http://www.gnu.org/prep/standards/html_node/Doc-Strings-and-Manuals.html).
The right thing to do is to rework the "Standard Library" documentation
into .texi files.

Andy
-- 
http://wingolog.org/



reply via email to

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