Lars, > 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) frank