This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: GFDL/GPL issues


> We are already having trouble keeping our documentation up-to-date.
> Some of it is in such a poor shape as to be laughable.  Yes, it's
> mostly our fault, but if we were able to generate documentation by
> simply extracting it from the code.  Tools exist for this, and
> properly maintained, they are very useful.

I disagree and think that's backwards.  To get good quality
documentation, we have to WRITE good quality documentation.  Using
tools to generate it from sources will DECREASE its quality, in my
opinion.  The best measure of quality of a document is how much time
people spend writing and editing it.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]