Your message dated Fri, 28 Nov 2008 20:00:17 +0100
with message-id <[EMAIL PROTECTED]>
and subject line Re: Bug#411303:
has caused the Debian Bug report #411303,
regarding inconsistencies in manpage formatting practices
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [EMAIL PROTECTED]
immediately.)
--
411303: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411303
Debian Bug Tracking System
Contact [EMAIL PROTECTED] with problems
--- Begin Message ---
Package: manpages,groff
Version: 1.18.1.1-12
I would like to resolve at least one inconsistency regarding preferred
manpage formatting practices. Quoting .SH arguments; see Debian
#368996. manpages man.7 and groff_man.7 have different advice about
whether .SH arguments with spaces should be quoted. Colin indicates
that man(7) should probably change.
Also, where are \f[BRP] documented, anyway? I hope there is something
more than the groff.7 paragraph "Fonts are identified..."....
On Thu, Jul 27, 2006 at 04:09:02PM +0100, Colin Watson wrote:
> On Thu, Jul 27, 2006 at 10:15:37AM -0400, Justin Pryzby wrote:
> > On Thu, Jul 27, 2006 at 08:39:42AM +0100, Colin Watson wrote:
> > > On Thu, Jul 27, 2006 at 08:20:39AM +0200, Martin Schulze wrote:
> > > > I'm writing you because of Bug#368996 in which the reporter
> > > > claims that when you use the .SH macro and the parameter
> > > > contains a space character it should be quoted. Is this true?
> > >
> > > To the best of my knowledge, this is not the case. See groff_man(7),
> > > which says:
> > >
> > > .SH [text for a heading]
> > > Sets up an unnumbered section heading sticking out to
> > > the left. Prints out all the text following SH up to
> > > the end of the line (resp. the text in the next input
> > > line if there is no argument to SH) in bold face, one
> > > size larger than the base document size. Additionally,
> > > the left margin for the following text is reset to its
> > > default value.
> >
> > I'm reading man.7:
> >
> > If the name contains spaces and appears on the same line as .SH,
> > then place the heading in double quotes.
>
> In my experience, man(7) frequently gives somewhat dubious advice, and
> is less authoritative than groff_man(7).
--- End Message ---
--- Begin Message ---
Michael Kerrisk wrote:
> I long ago (April 2007, man-pgaes-2.48) fixed the problem that was the
> source of Justsin's complaint for this bug. Isn't it time to close
> it?
Right. Closing now.
Regards,
Joey
--
If you come from outside of Finland, you live in wrong country.
-- motd of irc.funet.fi
--- End Message ---
