tags 378544 fixed-upstream
thanks

Thomas,

Thanks for your report.  Fixes, as described below, will appear in upstream
2.37.

> Here is the list of some problems found with `groff -Tascii -wmac -mman
> $file` and the comments. Most of the problems result in a missing line.
> It sometimes seems to be wanted (macro .nl for example), but would be
> better with a known macro (to ease the gettextization for example).
> However, sometimes there is a real problem that should be fixed.

Thanks for doing this.

>> ./man2/shmget.2:132: warning: `Br' not defined
> 
> results: incomple sentence
> fix: .BR instead of .Br

Fixed.

>> ./man3/isalpha.3:39: warning: `nl' not defined
>> ./man3/basename.3:30: warning: `nl' not defined
>> ./man3/confstr.3:37: warning: `nl' not defined
>> ./man3/fpathconf.3:32: warning: `nl' not defined
>> ./man3/gets.3:33: warning: `nl' not defined
>> ./man3/getw.3:31: warning: `nl' not defined
>> ./man3/glob.3:36: warning: `nl' not defined
>> ./man3/posix_fallocate.3:32: warning: `nl' not defined
>> ./man3/puts.3:32: warning: `nl' not defined
>> ./man3/random.3:39: warning: `nl' not defined
>> ./man3/getline.3:33: warning: `nl' not defined 
>> ./man3/malloc.3:35: warning: `nl' not defined
>> ./man3/posix_memalign.3:40: warning: `nl' not defined 
>> ./man3/toupper.3:33: warning: `nl' not defined
> 
> results: ok
> fix: .br instead of .nl

Done.

>> ./man3/getloadavg.3:37: warning: `Fd' not defined
> 
> results: line dismissed
> fix: .B instead of .Fd

Not correct; no change.  (Is the Debian page different from my upstream,
perhaps?)

>> ./man3/rpc.3:79: warning: `UX' not defined
> 
> results: ok
> fix: should be removed

Done.

>> ./man5/utmp.5:206: warning: `SP' not defined
> 
> results: ok
> fix: .sp instead of .SP

Done.

>> ./man7/capabilities.7:272: warning: `IT' not defined
> 
> results: line dismissed
> fix: .IR instead of .IT

Done.

>> ./man7/uri.7:229: warning: `UR' not defined
> 
> results: line dismissed
> fix: .IR instead of .UR, and should probably be rephrased.

Done.

>> ./man7/uri.7:231: warning: `UE' not defined
> 
> results: ok
> fix: should be removed

Done.

> And another problem not detected by this command but found while
> gettextizing the pages with po4a:
> * man2/remap_file_pages.2:47
>     \fB1.\fp should be \fB1.\fP
> * man2/remap_file_pages.2:54
>     \fB2.\fp should be \fB2.\fP

Done.

Thanks again Thomas.

Cheers,

Michael

-- 
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7

Want to help with man page maintenance?  Grab the latest tarball at
ftp://ftp.win.tue.nl/pub/linux-local/manpages/,
read the HOWTOHELP file and grep the source files for 'FIXME'.



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to