On Sun, Sep 07, 2008 at 06:56:07PM +0000, Thorsten Glaser wrote: > Colin Watson dixit: > >The Debian Policy Manual documents the current situation: > > > > Due to limitations in current implementations, all characters in the > > manual page source should be representable in the usual legacy > ^^^^^^^^^^^^^^^^^^ > Interesting twist if this appears to comments as well. (But with your > fix, I believe this won’t be necessary any more ☺)
Well, it literally does mean the whole file. But yes, it's a bit odd, and wasn't really intended to be that strict. I did consider stripping comments entirely before passing them on down the toolchain, but that would mean that line/byte numbers would be wrong, which could be confusing. > >-.\" * ` generates b-.\" * ' generates b-.\" * - generates b+.\" * ` > >generates U+2018 in groff, so use \` > >+.\" * ' generates U+2019 in groff, \' generates B4, so use \*(aq > >+.\" * - generates U+2010 in groff, \- generates U+2212, fixed in > >tmac/mdoc/doc-groff > > I think your mail arrived here in a broken state. It displays as intended here: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=498082 I suspect that either your mail user agent or something in your local mail delivery system is line-wrapping incorrectly. > >After this fix, you still have a "warning: `aV' not defined", but that's > >a genuine problem in your pages rather than in either groff or man-db. > > Interesting too. I will have to look at how GNU groff’s mdoc implementation > defines the .Nx, .Ox &c. macros then. (MirBSD uses AT&T nroff (and offers > GNU groff via ports) with the (a bugfixed) UCB mdoc implementation for both > *roff processors, so that this issue has not appeared there yet.) Right. I think .aV used to be part of the internal implementation of mdoc; docj.tmac still has it, commented as "parse argument vector (recursive)". As far as I can tell this was replaced by the doc-parse-args macro, probably in Werner Lemberg's complete rewrite of mdoc in March 2001. However, it wasn't obvious to me how to upgrade your macro. If you need help writing a replacement portable to both AT&T troff and modern groff, the members of the [EMAIL PROTECTED] list are tremendously well-informed and are usually very helpful with such things. Cheers, -- Colin Watson [EMAIL PROTECTED] -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
