bug-texinfo
[Top][All Lists]
Advanced

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

Re: Feature request: multilevel indexing for TeX


From: arnold
Subject: Re: Feature request: multilevel indexing for TeX
Date: Sun, 19 May 2019 01:43:14 -0600
User-agent: Heirloom mailx 12.5 7/5/10

Hi.

Gavin is the TeXpert, but 

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

Doing that is probably your best bet, IMHO.

Arnold

Raymond Toy <address@hidden> wrote:

> 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}
>
> \scanmacro ...\\=\active \scantokens address@hidden
>                                                   \aftermacro \catcode
> address@hidden
> 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
> >
> > Raymond Toy <address@hidden> wrote:
> >
> > > 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



reply via email to

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