Source-Changes-D archive

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

Re: CVS commit: src/lib/libpthread

On Mon, May 17, 2010 at 07:35:37PM +0200, Matthias Drochner wrote:
> Also, the xrefs are not sorted strictly alphabetically but
> in some logical order which is good imo.

The Xrefs are generally a symptom of the manual page format. As D. Holland
well said, the "man -k is so 1980s".

In my opinion we could have more introductory sections that connect the
pages in a more logical manner.[1] Just listing the manual pages in the
intro-sections is not enough.

For example, I think memoryallocators(9) and atomic_ops(3) are good
examples. The latter highlights also nicely and briefly the rationale, which
is often entirely missing in the man-pages. (Often the question particularly
in the kernel is: why? Not how.)

So in the long run we could have e.g. libc(3) or kernel(9).

Another option could be a book-like index, which I already mentioned on

- Jukka.

[1] It would be interesting to use e.g. Graphviz to see what kind of a
    spider web the Xrefs really are.

Home | Main Index | Thread Index | Old Index