On 11/ 8/11 06:25 PM, Alan Coopersmith wrote:
...
grep '(3)' /net/stard.us.oracle.com/tank/ws/UL/6919172/components/coreutils/build/prototype/i386/mangled/usr/gnu/share/man/man1/*

suggests a few more coreutils man pages could use (3) -> (3C) fixes.

And since they all have a header warning that you shouldn't modify the man page,
since it's generated via help2man, I wonder if it wouldn't be better to patch
coreutils-8.5/man/help2man to do the (3) -> (3C) translation, plus any other
man page fixups needed.


By searching for all man page references in the various man pages under
/tank/ws/UL/6919172/components/coreutils/build/prototype/i386/mangled/usr/gnu/share/man/
we see the following:

We don't have man pages for:

  chattr(1)
  .../man1/rm.1:120:unlink(1), unlink(2), chattr(1), shred(1)

  rev(1)
  .../man1/tac.1:65:\fBrev\fP(1).


We need to adjust the following adjustments:

  ftruncate(2) ==>  ftruncate(3C)
  .../man1/truncate.1:82:dd(1), truncate(2), ftruncate(2)

  truncate(2) ==>  truncate(3C)
  .../man1/truncate.1:82:dd(1), truncate(2), ftruncate(2)


  mkdtemp(3) ==>  mkdtemp(3C)
  .../man1/mktemp.1:83:mkstemp(3), mkdtemp(3), mktemp(3)

  mkstemp(3) ==>  mkstemp(3C)
  .../man1/mktemp.1:83:mkstemp(3), mkdtemp(3), mktemp(3)

  mktemp(3) ==>  mktemp(3C)
  .../man1/mktemp.1:83:mkstemp(3), mkdtemp(3), mktemp(3)


  getcwd(3) ==>  getcwd(3C)
  .../man1/pwd.1:63:getcwd(3)

  mkfifo(3) ==>  mkfifo(3C)
  .../man1/mkfifo.1:61:mkfifo(3)

  sleep(3) ==>  sleep(3C)
  .../man1/sleep.1:60:sleep(3)

It would be easier to just extend the patch to make those
further adjustments as our Userland build process doesn't
call help2man. See the publish-trans.txt build transcript at:

  
/net/stard.us.oracle.com/tank/ws/UL/6919172/components/coreutils/publish-trans.txt

New webrev at:

  http://jurassic.us.oracle.com/~richb/6919172-v2/

x86 Workspace (with just the component in question built) is at:

  /net/stard.us.oracle.com/tank/ws/UL/6919172/

Thanks.


_______________________________________________
userland-discuss mailing list
userland-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/userland-discuss

Reply via email to