Re: What's an annex? stratum?

Markus Deuling
2007-06-26T18:34:05Z

Eli Zaretskii wrote:

> That's not surprising: programmers don't like writing documentation as
> much as they like writing code. That is one reason why gdbint.texinfo
> is in such poor shape.
>
> In any case, if people here believe comments are a reasonable
> substitute for documentation, perhaps I should from now on reject code
> patches that do not explain themselves clearly, and do not contain
> enough references to other related portions of GDB.
>

Maybe the process of getting a patch into mainline should be changed. Currently a patch without a proper
Changelog has no chance. Maybe we should extend that and say a patch must have Changelog and one or two
lines (or even moren) in documentation whenever reasonable.

For example the guy that wrote the part for inferior function calls definitely wrote no doc :-)

For my opinion GDB's Internal Manual is very important and should be cultivated much more.

--
Markus Deuling
GNU Toolchain for Linux on Cell BE
deuling@de.ibm.com