On 21/08/2012 16:51, Bruno Le Floch wrote:
> On 8/20/12, Joseph Wright <[log in to unmask]> 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