Hi!
I have some questions about texinfo.
1) texinfo.tex contains the following comments:
% The index entry written in the file actually looks like
% \entry {sortstring}{page}{topic}
% or
% \entry {sortstring}{page}{topic}{subtopic}
% The texindex program reads in these files and writes files
% containing these kinds of lines:
% \initial {c}
% before the first topic whose initial is c
% \entry {topic}{pagelist}
% for a topic that is used without subtopics
% \primary {topic}
% for the beginning of a topic that is used with subtopics
% \secondary {subtopic}{pagelist}
% for each subtopic.
i.e., it is supposed that texinfo.tex could generate \entry lines
of two types: with 3 and with 4 arguments (and texindex does support
both these types as documented above). But i found no code in
texinfo.tex which could generate \entry lines with 4 arguments (i.e.
with a subtopic); the \dosubind macro always creates a 3-argument
\entry lines.
So, how one is supposed to create index entries with real subtopics
in a texinfo documents?
2) the @cindexsub command is defined but does not seem to work:
a line
@cindexsub "test" qwerty
in a texinfo file generates an error:
! Use of @cindexsub doesn't match its definition.
l.153 @cindexsub "
test" qwerty
This is because the catcode of " while processing a texinfo file
is 13 (active), while it is 12 at the definition time.
(and there are two definitions of \cindexsub in texinfo.tex, the
first one being useless, as it is redefined by the second one)
3) comments in texinfo.tex say that the meaning of parameters
in \entry lines in texinfo.tex-generated index files is the following:
% \entry {sortstring}{page}{topic}
I.e., the first argument is a "sortstring" (a sorting key).
But e.g. a line
@cindex CVS_CLIENT_PORT
in a texinfo file generates the following entry in a .cp file:
\entry{CVS{\_}CLIENT{\_}PORT}{25}{CVS_CLIENT_PORT}
It looks like the first argument is NOT a "sortstring", but it
is a string that should be typesetted (i.e. it is a "topic"),
because it contains "typesetting hooks" like {\_}, while
the third argument IS a "sortstring".
It is a bug in documentation? What is the right meaning of first
and third parameters of \entry?
How is the texindex program interpretting these parameters (de facto)?
Best,
v.
