User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:14.0)
            Gecko/20120713 Thunderbird/14.0
MIME-Version: 1.0
References: <CAFUtaNHRKba73YJFrRjCDjd4o0n4b0qwBHpFJK2mYfMLqixcuA@mail.gmail.com>           
            <5032AD8E.20103@morningstar2.co.uk>
            <CANQYN6yghjiij7hG79bbU5oL1KSYGvvJnbiw2Ex+Gbi1bkrcFQ@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Message-ID:  <5033B17B.1070405@morningstar2.co.uk>
Date:         Tue, 21 Aug 2012 17:04:11 +0100
Reply-To: Mailing list for the LaTeX3 project
              <LATEX-L@listserv.uni-heidelberg.de>
Sender: Mailing list for the LaTeX3 project <LATEX-L@listserv.uni-heidelberg.de>
From: Joseph Wright <joseph.wright@MORNINGSTAR2.CO.UK>
Subject: Re: l3doc.pdf
To: LATEX-L@listserv.uni-heidelberg.de
In-Reply-To:  <CANQYN6yghjiij7hG79bbU5oL1KSYGvvJnbiw2Ex+Gbi1bkrcFQ@mail.gmail.com>
Precedence: list
Status: R

On 21/08/2012 16:51, Bruno Le Floch wrote:
> On 8/20/12, Joseph Wright <joseph.wright@morningstar2.co.uk> wrote:
>> On 20/08/2012 18:31, Joel C. Salomon wrote:
>>> Also, when typesetting it on my own system, I get this error message
>>>
>>> (./l3doc.ind [47]
>>> ! Misplaced alignment tab character &.
>>> l.9   \item \verb*&\&&
>>>                       \pfill \hdclindex{1129}{}{0}, \hdclindex{1142}{}{0}
>>> ?
>>
>> Typesets fine here at present.
> 
> I get the same error as Joel.  Joseph, did you run makeindex?  I'm running
> 
> pdflatex l3doc.dtx
> makeindex -q -s l3doc.ist -o l3doc.ind l3doc.idx
> pdflatex l3doc.dtx
> 
> to get the error.  The problem comes from indexing the \& command when
> the \verbatimchar used by indexing macros is &.  Ideally, we could
> change the verbatim character depending on the function being indexed.
>  The same error occurs with one of the l3fp files IIRC, since &
> appears in a \begin{macro} argument.  Changing the \verbatimchar to
> something else would just be a temporary fix.
> 
> Bruno
> 

Quite possibly true: when I say 'typesets fine' I mean

  make doc F=l3doc (Unix)
  make doc l3doc   (Windows)

produces a PDF with a reasonable index.
-- 
Joseph Wright