[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#226345: marked as done (glibc-doc: Incorrect and unsightly formatting in man pages)

Your message dated Sun, 1 Oct 2006 17:49:18 +0200
with message-id <20061001154916.GA28176@bode.aurel32.net>
and subject line glibc-doc: wrong formatting for all pthread_* manpages
has caused the attached Bug report 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 I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--- Begin Message ---
Package: glibc-doc
Version: 2.3.2-8
Severity: normal

There seems to be a strange use of exclamation marks to emphasize text in the
glibc-doc man pages. This is not how man pages are formatted. Looking at other
man pages it seems the nroff code that should be used for these cases is .BR.

The exclamation marks are particularly unsightly. If the entries cannot be
generated from whatever source the documentation is coming from I would suggest
not doing anything at all. Though obviously formatting it correctly would be
better yet.

An example:

!pthread_self! return the thread identifier for the calling thread.


-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux stark.dyndns.tv 2.4.23-pre4 #1 SMP Sun Sep 21 04:35:38 EDT 2003 i686

-- no debconf information

--- End Message ---
--- Begin Message ---
Version : 2.3.6-1

On Fri, Nov 14, 2003 at 10:49:51AM +0100, Erwan David wrote:
> Package: glibc-doc
> Version: 2.3.2.ds1-10
> Severity: normal
> manpages of pthread related functions all carry | and ! and no formatting of function names is done.

This bug has been fixed in version 2.3.6-1. Closing it.

  .''`.  Aurelien Jarno	            | GPG: 1024D/F1BCDB73
 : :' :  Debian developer           | Electrical Engineer
 `. `'   aurel32@debian.org         | aurelien@aurel32.net
   `-    people.debian.org/~aurel32 | www.aurel32.net

--- End Message ---

Reply to: