I've tracked it a bit further:
On Thu, May 03, 2012 at 11:07:31PM +0200, Jens Schweikhardt wrote:
# 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
This is a bug in the "cygwin-doc" package, in the newlibinfo2man.pl
perl script.
157 sub print_footer
158 {
159 $out_handle = $_[0];
160 print { $out_handle } ".SH \"SEE ALSO\"\n";
161 if ((!grep /\Q$node/, @summary_nodes) && ($node ne "Library Index"))
162 {
163 print { $out_handle } ".B $node\n";
164 print { $out_handle } "is part of the\n";
165 print { $out_handle } ".B $title\n";
166 print { $out_handle } "library.\n";
167 }
168 print { $out_handle } "The full documentation for\n";
169 print { $out_handle } ".B $title\n";
170 print { $out_handle } "is maintained as a Texinfo manual. If \n";
171 print { $out_handle } ".B info\n";
172 print { $out_handle } "and\n";
173 print { $out_handle } ".B $title\n";
174 print { $out_handle } "are properly installed at your site, ";
175 print { $out_handle } "the command\n";
176 print { $out_handle } ".IP\n";
177 print { $out_handle } ".B info $title\n";
178 print { $out_handle } ".PP\n";
179 print { $out_handle } "will give you access to the complete manual.\n";
180 print "finished $node of $title\n" if ($debug);
181 close ($out_handle);
182 }
$title is undefined because it is declared "my" in the loop iterating
over @ARGV calling print_footer. Can someone with more cygwin|src|build-fu
fix this? Thanks!
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
