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
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
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