Re: POSIX.1-2013 man pages for review

[John Spencer <maillist-musl-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 1097 bytes --]

Michael, Felix,

On 09/19/2013 09:59 AM, Michael Kerrisk (man-pages) wrote:
>
> Thanks to some work by Felix Janda, we now have a set of
> scripts that convert the source format that we received from
> IEEE/TOG to the man pages using the "man" macros. Felix has
> done some excellent work, and I've spent quite some time
> reviewing the results. However, before definitively releasing

great work, thanks !


> these pages, I would like to have further review of the pages,
> and I am soliciting that review with this mail
>
> The main purposes of this review are to:
> * detect any problems injected by the conversion process
>    (e.g., spurious text added or deleted)
> * find any formatting issues with the resulting pages.


i've run a test script[0] using my own manpage viewer[1]
and attached the results. it seems that ~10% of the manpages use some
special groff features. i'd rather see these removed/replaced with 
something nroff-compatible.

[0] https://github.com/rofl0r/hardcore-utils/blob/master/tests/mantest.sh
[1] https://github.com/rofl0r/hardcore-utils/blob/master/man.c

--JS

[-- Attachment #2: man.log --]
[-- Type: text/x-log, Size: 4917 bytes --]

=== status report  ===
total manpages	: 1143
buggy manpages	: 137
total failures	: 406
unique failures	: 12

bug list:
    122 **** Unknown formatter command: .ne
    106 **** Unknown formatter command: .TS
    106 **** Unknown formatter command: .TE
     24 **** Unknown formatter command: .ce
     14 **** Unknown formatter command: .EQ
     14 **** Unknown formatter command: .EN
     11 **** Unknown formatter command: .nr
      3 **** Unknown formatter command: .T&
      2 **** Unknown formatter command: .tr
      2 **** Unknown formatter command: .in
      1 **** Unknown formatter command: .Im

=== detail ===
page			total	unique
/root/man/man3p/posix_trace_close.3p	3	3
/root/man/man3p/regcomp.3p	2	4
/root/man/man3p/nl_langinfo.3p	1	1
/root/man/man3p/semop.3p	3	3
/root/man/man3p/ilogb.3p	2	2
/root/man/man3p/endutxent.3p	2	2
/root/man/man3p/wctype.3p	2	2
/root/man/man3p/open.3p	1	1
/root/man/man3p/posix_madvise.3p	1	1
/root/man/man3p/semctl.3p	1	1
/root/man/man3p/glob.3p	2	2
/root/man/man3p/freopen.3p	2	2
/root/man/man3p/localeconv.3p	2	4
/root/man/man3p/shmctl.3p	1	1
/root/man/man3p/fopen.3p	2	2
/root/man/man3p/pthread_cond_timedwait.3p	1	1
/root/man/man3p/strftime.3p	2	2
/root/man/man3p/posix_trace_getnext_event.3p	1	1
/root/man/man3p/drand48.3p	3	4
/root/man/man3p/sigaction.3p	3	3
/root/man/man3p/realpath.3p	1	1
/root/man/man3p/posix_spawn_file_actions_addclose.3p	1	1
/root/man/man3p/fma.3p	1	1
/root/man/man3p/fork.3p	1	1
/root/man/man3p/dirname.3p	2	2
/root/man/man3p/msync.3p	2	2
/root/man/man3p/putmsg.3p	1	2
/root/man/man3p/futimens.3p	1	1
/root/man/man3p/getdate.3p	2	4
/root/man/man3p/log1p.3p	1	1
/root/man/man3p/timer_create.3p	1	1
/root/man/man3p/getsockname.3p	1	1
/root/man/man3p/sysconf.3p	2	4
/root/man/man3p/tgamma.3p	1	1
/root/man/man3p/scalbln.3p	1	1
/root/man/man3p/pthread_key_create.3p	1	1
/root/man/man3p/mq_open.3p	1	1
/root/man/man3p/socket.3p	1	1
/root/man/man3p/lgamma.3p	2	2
/root/man/man3p/system.3p	1	1
/root/man/man3p/posix_trace_create.3p	2	8
/root/man/man3p/printf.3p	3	3
/root/man/man3p/sigtimedwait.3p	1	1
/root/man/man3p/getpriority.3p	1	1
/root/man/man3p/chmod.3p	2	4
/root/man/man3p/fwscanf.3p	1	1
/root/man/man3p/pthread_mutex_lock.3p	2	2
/root/man/man3p/sendto.3p	1	2
/root/man/man3p/tzset.3p	2	2
/root/man/man3p/sqrt.3p	2	2
/root/man/man3p/readlink.3p	1	1
/root/man/man3p/fputc.3p	1	1
/root/man/man3p/write.3p	1	1
/root/man/man3p/posix_spawn_file_actions_destroy.3p	1	1
/root/man/man3p/getc_unlocked.3p	1	1
/root/man/man3p/fstatvfs.3p	1	1
/root/man/man3p/gai_strerror.3p	2	2
/root/man/man3p/mmap.3p	3	5
/root/man/man3p/erf.3p	3	3
/root/man/man3p/wordexp.3p	3	3
/root/man/man3p/fdopendir.3p	1	1
/root/man/man3p/msgsnd.3p	1	1
/root/man/man3p/truncate.3p	1	1
/root/man/man3p/mknod.3p	3	5
/root/man/man3p/ioctl.3p	1	2
/root/man/man3p/pthread_mutex_destroy.3p	1	1
/root/man/man3p/fstatat.3p	1	1
/root/man/man3p/fcntl.3p	1	1
/root/man/man3p/getpeername.3p	1	1
/root/man/man3p/sendmsg.3p	1	1
/root/man/man3p/lockf.3p	2	2
/root/man/man3p/fscanf.3p	1	1
/root/man/man3p/atanh.3p	1	1
/root/man/man3p/utime.3p	1	1
/root/man/man3p/tan.3p	1	1
/root/man/man3p/fattach.3p	1	1
/root/man/man3p/fpathconf.3p	3	3
/root/man/man3p/fgetwc.3p	1	1
/root/man/man3p/fwprintf.3p	1	4
/root/man/man1p/write.1p	1	1
/root/man/man1p/sccs.1p	1	1
/root/man/man1p/val.1p	2	2
/root/man/man1p/ctags.1p	1	2
/root/man/man1p/nl.1p	2	2
/root/man/man1p/expr.1p	3	5
/root/man/man1p/pax.1p	7	31
/root/man/man1p/ex.1p	3	10
/root/man/man1p/lex.1p	4	12
/root/man/man1p/ps.1p	4	7
/root/man/man1p/dirname.1p	2	2
/root/man/man1p/touch.1p	2	2
/root/man/man1p/c99.1p	4	13
/root/man/man1p/yacc.1p	4	5
/root/man/man1p/mailx.1p	1	2
/root/man/man1p/dd.1p	2	3
/root/man/man1p/find.1p	1	2
/root/man/man1p/qsub.1p	4	4
/root/man/man1p/awk.1p	4	14
/root/man/man1p/file.1p	4	5
/root/man/man1p/tail.1p	2	2
/root/man/man1p/bc.1p	3	5
/root/man/man1p/gencat.1p	2	2
/root/man/man1p/ed.1p	2	4
/root/man/man1p/get.1p	3	4
/root/man/man1p/tr.1p	2	2
/root/man/man1p/prs.1p	2	2
/root/man/man1p/ls.1p	1	1
/root/man/man1p/printf.1p	3	3
/root/man/man1p/qhold.1p	1	1
/root/man/man1p/chmod.1p	2	4
/root/man/man1p/vi.1p	1	3
/root/man/man1p/od.1p	4	4
/root/man/man1p/stty.1p	4	7
/root/man/man1p/sort.1p	2	2
/root/man/man1p/uuencode.1p	4	4
/root/man/man1p/ar.1p	1	1
/root/man/man1p/sed.1p	1	8
/root/man/man0p/tar.h.0p	2	6
/root/man/man0p/complex.h.0p	2	2
/root/man/man0p/tgmath.h.0p	2	6
/root/man/man0p/cpio.h.0p	2	2
/root/man/man0p/float.h.0p	3	15
/root/man/man0p/langinfo.h.0p	2	2
/root/man/man0p/pthread.h.0p	2	2
/root/man/man0p/fcntl.h.0p	1	1
/root/man/man0p/fmtmsg.h.0p	2	2
/root/man/man0p/inttypes.h.0p	2	8
/root/man/man0p/sys_stat.h.0p	3	3
/root/man/man0p/math.h.0p	2	2
/root/man/man0p/time.h.0p	1	1
/root/man/man0p/termios.h.0p	2	4
/root/man/man0p/signal.h.0p	3	9
/root/man/man0p/netinet_in.h.0p	1	1
/root/man/man0p/unistd.h.0p	1	3
/root/man/man0p/stdint.h.0p	3	3
/root/man/man0p/spawn.h.0p	1	1
/root/man/man0p/stdio.h.0p	1	1