[Top][All Lists]

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

Re: [help-texinfo] proof-of-concept documentation category system

From: Karl Berry
Subject: Re: [help-texinfo] proof-of-concept documentation category system
Date: Mon, 21 May 2007 18:16:11 -0500

Hi Robert,

    Here is some example output. The list of categories is near the end of
    this page.

I'm afraid I don't understand.  Your example here seems to be within a
single manual.  In that case, can't you just use an index for this
purpose?  (Whether or not it's called an "index" in the output.)

Oh, I guess you want to have the categories included in the actual
output, too, e.g.,
That can't be done with an index, although adding a feature to indexes
to make it possible seems fairly feasible.  I'm not sure, but I don't
think hardwiring knowledge of "Categories" as a special case is the best
general approach.

The interesting thing about the wikipedia categories is that they cut
across articles, of course.

The equivalent feature in Texinfo is @dircategory, although it is
definitely underdeveloped and underused.  In particular, forcing the dir
file to be a single node is highly problematic if there were going to be
thousands of Texinfo categories.  It's already problematic to list every
libc function, which is, after all, part of the idea of Info (replace
man).  However, changing this is unfortunately not easy.


reply via email to

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