This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: "Roadmap to the manual" chapter in the manual has out of order chapters and missing chapters.
- From: Roland McGrath <roland at hack dot frob dot com>
- To: "Carlos O'Donell" <carlos at redhat dot com>
- Cc: GNU C Library <libc-alpha at sourceware dot org>
- Date: Fri, 28 Feb 2014 13:30:17 -0800 (PST)
- Subject: Re: "Roadmap to the manual" chapter in the manual has out of order chapters and missing chapters.
- Authentication-results: sourceware.org; auth=none
- References: <5310FEC1 dot 1020504 at redhat dot com>
If you follow all the history back to the original writing of the manual, I
suspect you'll find that it was entirely correct to begin with. I think
chapters have been added and reordered without regard to the effect on the
introduction. The manual was originally written by a good writer with
structure that made it a good read for the beginner. It has accreted a lot
more content and miscellaneous changes since then, with basically no
attention whatsoever to writing quality.