X-Recipient:	archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status:	No, hits=-1.0 required=5.0 tests=AWL,BAYES_00,FROM_12LTRDOM
X-Spam-Check-By:	sourceware.org
Date:	Thu, 3 May 2012 23:07:31 +0200
From:	Jens Schweikhardt <schweikh AT schweikhardt DOT net>
To:	cygwin AT cygwin DOT com
Subject:	Swallowed words in most section 3 man pages' SEE ALSO section
Message-ID:	<20120503210731.GA3905@schweikhardt.net>
MIME-Version:	1.0
User-Agent:	Mutt/1.5.21 (2010-09-15)
X-IsSubscribed:	yes
Mailing-List:	contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id:	<cygwin.cygwin.com>
List-Subscribe:	<mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive:	<http://sourceware.org/ml/cygwin/>
List-Post:	<mailto:cygwin AT cygwin DOT com>
List-Help:	<mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender:	cygwin-owner AT cygwin DOT com
Mail-Followup-To:	cygwin AT cygwin DOT com
Delivered-To:	mailing list cygwin AT cygwin DOT com

hello, world\n

it appears that quite a number of functions in section 3 of the manual
have the following SEE ALSO section (# added where a word is missing).

$ man 3 strstr
[...]
SEE ALSO

   strstr is part of the # library.  The full documentation for # is
   maintained as a Texinfo manual.  If info and # are properly installed
   at your site, the command info will give you access to the complete manual.


This is due to missing arguments in /usr/share/man/man3/*.3.gz for
the bold face macro .B:

SH "SEE ALSO"
.B strstr
is part of the
.B
library.
The full documentation for
.B
is maintained as a Texinfo manual.  If
.B info
and
.B
are properly installed at your site, the command
.IP
.B info
.PP
will give you access to the complete manual.


For a list of man pages where this is the case (more than 400), just zgrep
for '^\.B $':
/usr/share/man/man3$ zgrep '^\.B $' *.gz|sort -u|wc
     410     413    6752


Regards,

	Jens
-- 
Jens Schweikhardt http://www.schweikhardt.net/
SIGSIG -- signature too long (core dumped)

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple

- Raw text -