LATEX-L Archives

Mailing list for the LaTeX3 project


Options: Use Classic View

Use Monospaced Font
Show Text Part by Default
Condense Mail Headers

Topic: [<< First] [< Prev] [Next >] [Last >>]

Print Reply
Sender: Mailing list for the LaTeX3 project <[log in to unmask]>
Date: Thu, 23 Aug 2012 15:12:50 +0200
Reply-To: Mailing list for the LaTeX3 project <[log in to unmask]>
Message-ID: <[log in to unmask]>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
In-Reply-To: <[log in to unmask]>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
From: Frank Mittelbach <[log in to unmask]>
Parts/Attachments: text/plain (23 lines)

> I must say I'm shocked that you're still using \verb in indices. This is
> certainly one of the cruftier parts of doc.sty, and generally something
> which is just begging for throwing weird errors at users down the line.
> xdoc2.dtx shows how one can cleanly avoid this. It may "only" be half
> the age of doc.sty, but surely some of you should have looked at it. ;-)

l3doc is not a new version of doc.sty. It is a quick and dirty class 
file to produce documentation for the expl3 code. It should certainly be 
revised (and probably completely rewritten) but until now it wasn't at 
all our focus. It wasn't meant for general consumption or wider use and 
it just worked as far as it had to (or a little less)

If somebody steps up to do a redesign and proper implementation that 
would certainly a good thing, but as the saying goes, you can fight only 
so many battles at the same time and this wasn't one. It only came up 
because Joel started using this class for his own code and finding 
things we never encountered or didn't really felt bother by (so far)