[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 Wed, 31 Jan 2007 01:30:04 +0100
with message-id <45BFE30C.9040203@aurel32.net>
and subject line Bug#220719: 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:

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


.SH "SEE ALSO"
!pthread_equal!(3),
!pthread_join!(3),
!pthread_detach!(3),
!pthread_setschedparam!(3),
!pthread_getschedparam!(3).


-- 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
Locale: LANG=C, LC_CTYPE=C

-- no debconf information

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

Timo Juhani Lindfors a écrit :
> Hi,
> 
> I reopened this bug since I don't see glibc-doc 2.3.6-1 anywhere.

http://packages.debian.org/unstable/doc/glibc-doc

Closing the bug.



-- 
  .''`.  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: