bug-texinfo
[Top][All Lists]

## Re: Feature request: multilevel indexing for TeX

 From: Raymond Toy Subject: Re: Feature request: multilevel indexing for TeX Date: Sat, 18 May 2019 14:46:27 -0700

Found a small issue and I'm not sure of the cause. I can easily workaround this since @subentry works for all output formats that I care about (pdf, html, info).

Before @subentry was available I used this macro:

@macro cpsubindex {topic,subtopic}
@iftex
@cindex \topic\!\subtopic\
@end iftex
@ifnottex
@cindex \topic\, \subtopic\
@end ifnottex
@end macro

With my old hack.  With the new texinfo, I changed the macro to say

@cindex \topic\ @subentry \subtopic\

makeinfo --pdf foo.texi

has errors like:

Unde
fined control sequence.
\temp ->\xeatspaces {unix} \subentry
\xeatspaces { pathnames}
\dosubindwrite ...mpty \xdef \indexsortkey {\temp
}\ifx \indexsortkey \empty...

\safewhatsit ... \else \vskip -\whatsitskip \fi #1
\ifx \lastskipmacro \zeros...

\dosubind ...dcsname }\safewhatsit \dosubindwrite
}\fi
l.2 ...s {unix} @subentry @xeatspaces { pathnames}

l.1657 @cpsubindex{unix, pathnames}

I'm assuming the macro call @cpsubindex{unix, pathnames} expands into

@cindex {unix} @subentry @xeatspaces { pathnames}

and that @xeatspaces is causing problems.

It's easy enough for me to work around this by just globally replacing @cpsubindex{foo, bar} with @cindex foo @subentry bar

On Fri, May 10, 2019 at 12:41 AM <address@hidden> wrote:
You're welcome. Gavin did most of the work.

I've revised (but not yet merged) the index for the gawk manual to take
advantage of the new features, and it too looks wonderful. I'm pleased
with the new features and am glad other people are using them too.

Regards,

Arnold

> Thanks so much for implementing this!  I can get rid of the hacks I had and
> make use of it in other docs.
>
> I did use this new version to generate Maxima's manual in pdf.  The index
> entries and subentries look fine for the most part, but there are a few
> oddities.  I don't know if I messed up or if it's a bug in texinfo.  When I
> isolate the problem, I'll let you know.
>
> But in general it looks fantastic!  And much better than the hack I was
> using!
>
>
> On Sun, Apr 28, 2019 at 2:20 AM Gavin Smith <address@hidden>
> wrote:
>
> > On Sun, Apr 28, 2019 at 02:33:25AM -0600, address@hidden wrote:
> > > Gavin Smith <address@hidden> wrote:
> > >
> > > > On Sat, Mar 02, 2019 at 04:33:30PM +0000, Gavin Smith wrote:
> > > > > Implemented as @subentry in git commit 372cfab.
> > > > >
> > > > > A test file is attached. Please feel free to experiment.
> > > > >
> > > > > It still needs to be implemented in texi2any, once the syntax is
> > > > > finalised. Volunteers are welcome.
> > > >
> > > > I've added some support for @seeentry and @seealso in index entries in
> > > > texi2any.  They are ignored except for DocBook output.
> > >
> > > Truly awesome!!!
> > >
> > > How do mean "ignored"?  Do you simply remove the @subentry and use
> > > the rest of the line as the index text, in Info, for example?
> >
> > I mean entries with @seeentry and @seealso do not add any index entries
> > for HTML and Info output.  @subentry isn't ignored.
> >
> > > I'd suggest something like  s/ address@hidden +/, /g   in sed syntax
> > > for Info, if that makes sense to you.
> >
> > In HTML and Info output, this is what is done already - the parts are
> > separated by commas.
> >
> > > And once again, a huge THANK YOU for working with me to add this feature
> > > to Texinfo.  I have been working on the gawk manual's index to take
> > > advantage of this and it makes for an incredible improvement.
> >
> > That is very good to hear.  Thank you for suggesting the new features
> > and working to implement them in texindex.  I'm sure others will find
> > them useful too.
> >
> >
>
> --
> Ray

--
Ray