tags 404364 fixed-upstream
thanks
(in truth, only *mostly* fixed -- there are a few open questions below.)
Salut Nicolas,
I'm the upstream man-pages maintainer. Thanks for your wonderful patches!
(How did you get all of this stuff?)
The changes listed below will appear in upstream 2.44.
> During the review of the French translation of manpages, I found the
> attached typos.
And thanks also for splitting your suggestions into separate patches --
makes my life so much easier...
> manpages.diff contains some typos
See my comments to this patch below; I have a few open questions, which
I've marked ***.
> The other patches are probably not to be applied as is.
>
> manpages.svipc.7.diff the structures described in svipc.7 do not match
> the ones defined in /usr/include
Indeed! I have applied your patch as you gave it.
> manpages.EACCESS.diff inotify_add_watch.2 and sem_open.3 mention an
> EACCESS error code. I think it is a typo and the
> error code should be EACCES
Yes -- sadly, both typos made by me! Fixed now.
> manpages.questions.diff various questions:
See my comments to this patch below; I have a few open questions, which
I've marked ***.
> * intro.1: The centered header title is "Linux Programmer's
> Manual" shouldn't it be "Linux User's Manual" for
> section 1. The same kind of issue may appear in other
> pages. Just tell me if you want a patch for the
> others.
>
> * symlink.2: Something is missing before "re multiple files ..."
>
> * fcloseall.3: I don't understand "or set of functions"
>
> * iconv_open.3: iconv --list differs from what the man page says.
>
> * malloc.3: The same apply to calloc. Crashes are related to heap
> corruption
>
> * capabilities.7: Bullets 2. and 3. exist, but 1. is missing
>
> * mdoc.7: /usr/src/share/tmac/README do not exist on Linux.
>
> Kind Regards,
>
>
> ------------------------------------------------------------------------
>
> diff -rauN ../orig/manpages-2.39/man2/execve.2 ./manpages-2.39/man2/execve.2
> --- ../orig/manpages-2.39/man2/execve.2 2006-08-04 14:39:17.000000000
> +0200
> +++ ./manpages-2.39/man2/execve.2 2006-12-22 19:24:36.000000000 +0100
> @@ -68,7 +68,7 @@
> If the set-user-ID bit is set on the program file pointed to by
> \fIfilename\fP, and the calling process is not being ptraced,
> then the effective user ID of the calling process is changed
> -to that of the owner of the program file. i
> +to that of the owner of the program file.
Seems to have been fixed already (Current version of man-pages is 2.43)
> diff -rauN ../orig/manpages-2.39/man2/fdatasync.2
> ./manpages-2.39/man2/fdatasync.2
> --- ../orig/manpages-2.39/man2/fdatasync.2 2006-08-04 11:41:28.000000000
> +0200
> +++ ./manpages-2.39/man2/fdatasync.2 2006-12-22 19:25:22.000000000 +0100
> @@ -88,7 +88,7 @@
> .SH "CONFORMING TO"
> POSIX.1-2001.
> .SH "SEE ALSO"
> -.BR fsync (2)
> +.BR fsync (2),
Seems to have been fixed already.
> --- ../orig/manpages-2.39/man2/futex.2 2006-08-04 11:41:28.000000000
> +0200
> +++ ./manpages-2.39/man2/futex.2 2006-12-22 19:25:51.000000000 +0100
> @@ -201,7 +201,7 @@
> was added. In Linux 2.6.7 a sixth parameter was added \(em messy, especially
> on the s390 architecture.
> .SH "CONFORMING TO"
> -This system call is Minux specific.
> +This system call is Linux specific.
Fixed already.
> diff -rauN ../orig/manpages-2.39/man2/gethostname.2
> ./manpages-2.39/man2/gethostname.2
> --- ../orig/manpages-2.39/man2/gethostname.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/gethostname.2 2006-12-22 19:26:56.000000000
> +0100
> @@ -78,7 +78,7 @@
> .B CAP_SYS_ADMIN
> capability.
> .SH "CONFORMING TO"
> -SVr4, 4.4BSD (this interfaces first appeared in 4.2BSD).
> +SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD).
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/getsockopt.2
> ./manpages-2.39/man2/getsockopt.2
> --- ../orig/manpages-2.39/man2/getsockopt.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/getsockopt.2 2006-12-22 19:27:17.000000000 +0100
> @@ -158,7 +158,7 @@
> is a file, not a socket.
> .SH "CONFORMING TO"
> SVr4, 4.4BSD (these system calls first appeared in 4.2BSD),
> - POSIX.1-2001.
> +POSIX.1-2001.
Thanks; applied.
> --- ../orig/manpages-2.39/man2/ioctl_list.2 2005-07-06 08:54:27.000000000
> +0200
> +++ ./manpages-2.39/man2/ioctl_list.2 2006-12-22 23:50:38.000000000 +0100
> @@ -158,7 +158,7 @@
> 0x000089E3 SIOCAX25NOUID const int *
> 0x000089E4 SIOCAX25DIGCTL const int *
> 0x000089E5 SIOCAX25GETPARMS struct ax25_parms_struct * // I-O
> -0x000089E6 SIOCAX25SETPARMS const struct ax25_parms-struct *
> +0x000089E6 SIOCAX25SETPARMS const struct ax25_parms_struct *
Thanks; applied.
> // <include/linux/cdk.h>
> 0x00007314 STL_BINTR void
> diff -rauN ../orig/manpages-2.39/man2/ioprio_set.2
> ./manpages-2.39/man2/ioprio_set.2
> --- ../orig/manpages-2.39/man2/ioprio_set.2 2006-08-04 11:41:28.000000000
> +0200
> +++ ./manpages-2.39/man2/ioprio_set.2 2006-12-22 19:28:48.000000000 +0100
> @@ -72,7 +72,7 @@
> have a matching real UID.
> .PP
> If
> -.I who
> +.I which
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/kill.2 ./manpages-2.39/man2/kill.2
> --- ../orig/manpages-2.39/man2/kill.2 2006-08-03 15:57:17.000000000 +0200
> +++ ./manpages-2.39/man2/kill.2 2006-12-22 19:29:28.000000000 +0100
> @@ -101,7 +101,7 @@
> a process which already committed termination, but
> has not yet been \fBwait\fP()ed for.
> .SH NOTES
> -The only signals that can be sent task number one, the
> +The only signals that can be sent to the task number one, the
Thanks; applied (but as "sent to process ID 1").
> --- ../orig/manpages-2.39/man2/msgctl.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/msgctl.2 2006-12-22 19:30:50.000000000 +0100
> @@ -62,7 +62,7 @@
> .in +4n
>
> struct msqid_ds {
> - struct ipc_perm msg_perm; /* Ownership and permissions
> + struct ipc_perm msg_perm; /* Ownership and permissions */
> time_t msg_stime; /* Time of last msgsnd() */
> time_t msg_rtime; /* Time of last msgrcv() */
> time_t msg_ctime; /* Time of last change */
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/pciconfig_read.2
> ./manpages-2.39/man2/pciconfig_read.2
> --- ../orig/manpages-2.39/man2/pciconfig_read.2 2005-10-19
> 08:54:38.000000000 +0200
> +++ ./manpages-2.39/man2/pciconfig_read.2 2006-12-22 19:32:14.000000000
> +0100
> @@ -64,25 +64,26 @@
> .TP
> .B EINVAL
> .I len
> -value is invalid. This does not apply to pci_iobase.
> +value is invalid. This does not apply to pciconfig_iobase.
> .TP
> .B EIO
> I/O error.
> .TP
> .B ENODEV
> -For pci_iobase, hose value is NULL? For the other calls, could not find a
> slot.
> +For pciconfig_iobase, hose value is NULL? For the other calls, could not
> find a slot.
> .TP
> .B ENOSYS
> The system has not implemented these calls (CONFIG_PCI not defined).
> .TP
> .B EOPNOTSUPP
> -This return value is only valid for pci_iobase. It is returned if the value
> for
> +This return value is only valid for pciconfig_iobase. It is returned if the
> value for
> .I
> which
> is invalid.
> .TP
> .B EPERM
> -User does not have the CAP_SYS_ADMIN capability. This does not apply to
> pci_iobase.
> +User does not have the CAP_SYS_ADMIN capability. This does not apply to
> +pciconfig_iobase.
> .SH "CONFORMING TO"
> These calls are Linux specific, available since Linux 2.0.26/2.1.11.
> .SH "SEE ALSO"
> diff -rauN ../orig/manpages-2.39/man2/ptrace.2 ./manpages-2.39/man2/ptrace.2
Thanks; applied.
> --- ../orig/manpages-2.39/man2/ptrace.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/ptrace.2 2006-12-22 19:33:02.000000000 +0100
> @@ -278,7 +278,7 @@
> For PTRACE_SYSEMU, continue and stop on entry to the next syscall,
> which will not be executed. For PTRACE_SYSEMU_SINGLESTEP, do the same
> but also singlestep if not a syscall. This call is used by programs like
> -User Mode Linux that want to emulate all the the child's syscalls.
> +User Mode Linux that want to emulate all the child's syscalls.
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/select.2 ./manpages-2.39/man2/select.2
> --- ../orig/manpages-2.39/man2/select.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/select.2 2006-12-22 19:34:25.000000000 +0100
> @@ -240,7 +240,7 @@
> Some code calls
> .BR select ()
> with all three sets empty,
> -.I n
> +.I nfds
Thanks; applied.
> --- ../orig/manpages-2.39/man2/shmctl.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/shmctl.2 2006-12-22 19:35:03.000000000 +0100
> @@ -117,7 +117,7 @@
> Write the values of some members of the
> .I shmid_ds
> structure pointed to by
> -.I arg.buf
> +.I buf
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/signal.2 ./manpages-2.39/man2/signal.2
> --- ../orig/manpages-2.39/man2/signal.2 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man2/signal.2 2006-12-22 19:36:41.000000000 +0100
> @@ -40,7 +40,7 @@
> system call installs a new signal handler for the signal with number
> .IR signum .
> The signal handler is set to
> -.I sighandler
> +.I handler
> which may be a user specified function, or either
> .B SIG_IGN
> or
> @@ -58,11 +58,11 @@
> .BR signal (7))
> occurs.
> Finally, if the handler is set to a function
> -.I sighandler
> +.I handler
> then first either the handler is reset to SIG_DFL
> or an implementation-dependent blocking of the signal
> is performed and next
> -.I sighandler
> +.I handler
> is called with argument
> .IR signum .
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/socket.2 ./manpages-2.39/man2/socket.2
> --- ../orig/manpages-2.39/man2/socket.2 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man2/socket.2 2006-12-22 19:37:25.000000000 +0100
> @@ -76,6 +76,7 @@
> T{
> .B PF_INET6
> T}:IPv6 Internet protocols:
> +.BR ipv6 (7)
> T{
> .B PF_IPX
> T}:IPX \- Novell protocols:
I agree that this reference should be added, but you formatted the change
wrongly. I've fixed and applied.
> diff -rauN ../orig/manpages-2.39/man2/socketcall.2
> ./manpages-2.39/man2/socketcall.2
> --- ../orig/manpages-2.39/man2/socketcall.2 2005-10-19 08:54:38.000000000
> +0200
> +++ ./manpages-2.39/man2/socketcall.2 2006-12-22 19:38:27.000000000 +0100
> @@ -23,7 +23,7 @@
> .\" USA.
> .\"
> .\" Modified Tue Oct 22 22:11:53 1996 by Eric S. Raymond <[EMAIL PROTECTED]>
> -.TH IPC 2 1995-04-15 "Linux 1.2.4" "Linux Programmer's Manual"
> +.TH SOCKETCALL 2 1995-04-15 "Linux 1.2.4" "Linux Programmer's Manual"
> .SH NAME
> socketcall \- socket system calls
> .SH SYNOPSIS
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man2/sync_file_range.2
> ./manpages-2.39/man2/sync_file_range.2
> --- ../orig/manpages-2.39/man2/sync_file_range.2 2006-07-20
> 18:16:51.000000000 +0200
> +++ ./manpages-2.39/man2/sync_file_range.2 2006-12-22 20:13:32.000000000
> +0100
> @@ -119,7 +119,7 @@
> .TP
> .B SYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE |
> SYNC_FILE_RANGE_WAIT_AFTER
> This is a traditional
> -.BR fdatasync(2)
> +.BR fdatasync (2)
> operation.
> It is a write-for-data-integrity operation
> that will ensure that all pages in the specified range which were dirty when
> diff -rauN ../orig/manpages-2.39/man3/addseverity.3
> ./manpages-2.39/man3/addseverity.3
Thanks; applied.
> --- ../orig/manpages-2.39/man3/addseverity.3 2006-03-20 04:13:48.000000000
> +0100
> +++ ./manpages-2.39/man3/addseverity.3 2006-12-21 23:27:39.000000000
> +0100
> @@ -48,7 +48,7 @@
> .SH "CONFORMING TO"
> This function is not specified in the X/Open Portability Guide
> although the
> -.BR fmtsmg ()
> +.BR fmtmsg ()
> function is. It is available on System V
> systems.
> .SH "SEE ALSO"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/assert_perror.3
> ./manpages-2.39/man3/assert_perror.3
> --- ../orig/manpages-2.39/man3/assert_perror.3 2006-05-26
> 21:14:38.000000000 +0200
> +++ ./manpages-2.39/man3/assert_perror.3 2006-12-21 23:28:24.000000000
> +0100
> @@ -43,7 +43,7 @@
> generates no code, and hence does nothing at all.
> Otherwise, the macro
> .BR assert_perror ()
> -prints an error message to standard output and terminates the program
> +prints an error message to standard error and terminates the program
> by calling
> .BR abort ()
> if
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/bcopy.3 ./manpages-2.39/man3/bcopy.3
> --- ../orig/manpages-2.39/man3/bcopy.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/bcopy.3 2006-12-21 23:28:49.000000000 +0100
> @@ -28,7 +28,7 @@
> .\" Modified Sun Feb 26 14:52:00 1995 by Rik Faith <[EMAIL PROTECTED]>
> .\" Modified Tue Oct 22 23:48:10 1996 by Eric S. Raymond <[EMAIL PROTECTED]>
> .\" "
> -.TH BCOPY 3 2002-12-31 "Linux" "LINUX Programmer's Manual"
> +.TH BCOPY 3 2002-12-31 "Linux" "Linux Programmer's Manual"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/cerf.3 ./manpages-2.39/man3/cerf.3
> --- ../orig/manpages-2.39/man3/cerf.3 2006-08-03 15:57:30.000000000 +0200
> +++ ./manpages-2.39/man3/cerf.3 2006-12-21 23:29:16.000000000 +0100
> @@ -1,7 +1,7 @@
> .\" Copyright 2002 Walter Harms ([EMAIL PROTECTED])
> .\" Distributed under GPL
> .\"
> -.TH cerf 3 2002-07-28 "" "complex math routines"
> +.TH CERF 3 2002-07-28 "" "complex math routines"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/errno.3 ./manpages-2.39/man3/errno.3
> --- ../orig/manpages-2.39/man3/errno.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/errno.3 2006-12-21 23:30:31.000000000 +0100
> @@ -423,7 +423,7 @@
> .\" ESRMNT is defined but appears not to be used
> .TP
> .BR ESTALE
> -Stale file handle (POSIX.1))
> +Stale file handle (POSIX.1)
> .sp
> This error can occur for NFS and for other file systems
> .TP
> diff -rauN ../orig/manpages-2.39/man3/error.3 ./manpages-2.39/man3/error.3
Thanks; applied.
> --- ../orig/manpages-2.39/man3/error.3 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man3/error.3 2006-12-21 23:31:57.000000000 +0100
> @@ -65,10 +65,12 @@
> The program name printed by
> .BR error ()
> is the value of the global variable
> -.IR program_invocation_name.
> -.IR program_invocation_name has the the same initial value as
> +.IR program_invocation_name .
> +.I program_invocation_name
> +has the same initial value as
> .IR main ()'s
> -.IR argv[0] ), and is
> +.IR argv[0] ),
> +and is
> declared as
> .IR "extern char *program_invocation_name"
> in
> diff -rauN ../orig/manpages-2.39/man3/fopen.3 ./manpages-2.39/man3/fopen.3
*** This does not apply. Please recheck an up-to-date page.
> --- ../orig/manpages-2.39/man3/fopen.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/fopen.3 2006-12-21 23:34:08.000000000 +0100
> @@ -227,7 +227,7 @@
> and
> .BR freopen ()
> functions conform to C89.
> - The
> +The
> .BR fdopen ()
> function conforms to POSIX.1-1990.
> .SH "GLIBC EXTENSIONS"
> diff -rauN ../orig/manpages-2.39/man3/fpclassify.3
> ./manpages-2.39/man3/fpclassify.3
Already fixed.
> --- ../orig/manpages-2.39/man3/fpclassify.3 2006-04-21 21:07:17.000000000
> +0200
> +++ ./manpages-2.39/man3/fpclassify.3 2006-12-21 23:34:21.000000000 +0100
> @@ -3,7 +3,7 @@
> .\" This was done with the help of the glibc manual.
> .\"
> .\" 2004-10-31, aeb, corrected
> -.TH fpclassify 3 2004-10-31 "" "Linux Programmer's Manual"
> +.TH FPCLASSIFY 3 2004-10-31 "" "Linux Programmer's Manual"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/getrpcport.3
> ./manpages-2.39/man3/getrpcport.3
> --- ../orig/manpages-2.39/man3/getrpcport.3 2006-08-04 14:39:17.000000000
> +0200
> +++ ./manpages-2.39/man3/getrpcport.3 2006-12-21 23:35:32.000000000 +0100
> @@ -1,7 +1,7 @@
> .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
> .\"
> .\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
> -.TH GETRPCPORT 3R 1987-10-06
> +.TH GETRPCPORT 3 1987-10-06
> .SH NAME
> getrpcport \- get RPC port number
> .SH SYNOPSIS
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/glob.3 ./manpages-2.39/man3/glob.3
> --- ../orig/manpages-2.39/man3/glob.3 2006-08-03 15:57:30.000000000 +0200
> +++ ./manpages-2.39/man3/glob.3 2006-12-21 23:38:00.000000000 +0100
> @@ -34,7 +34,7 @@
> .sp
> .BI "int glob(const char *" pattern ", int " flags ,
> .br
> -.BI " int " errfunc "(const char *" epath ", int " eerrno ),
> +.BI " int (*" errfunc ") (const char *" epath ", int " eerrno ),
> .br
> .BI " glob_t *" pglob );
> .br
Applied. Thanks!
> diff -rauN ../orig/manpages-2.39/man3/isgreater.3
> ./manpages-2.39/man3/isgreater.3
> --- ../orig/manpages-2.39/man3/isgreater.3 2006-06-01 00:16:55.000000000
> +0200
> +++ ./manpages-2.39/man3/isgreater.3 2006-12-21 23:41:08.000000000 +0100
> @@ -57,5 +57,5 @@
> .SH "CONFORMING TO"
> C99
> .SH "SEE ALSO"
> -.BR fpclassify (3)
> +.BR fpclassify (3),
> .BR isnan (3)
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/log10.3 ./manpages-2.39/man3/log10.3
> --- ../orig/manpages-2.39/man3/log10.3 2006-08-04 11:29:30.000000000
> +0200
> +++ ./manpages-2.39/man3/log10.3 2006-12-21 23:41:30.000000000 +0100
> @@ -29,7 +29,7 @@
> .\" Modified 2002-07-27 by Walter Harms
> .\" ([EMAIL PROTECTED])
> .\"
> -.TH EXP 3 2002-07-27 "" "Linux Programmer's Manual"
> +.TH LOG10 3 2002-07-27 "" "Linux Programmer's Manual"
> .SH NAME
> log10, log10f, log10l \- base-10 logarithmic function
> .SH SYNOPSIS
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/log.3 ./manpages-2.39/man3/log.3
> --- ../orig/manpages-2.39/man3/log.3 2006-08-04 11:29:30.000000000 +0200
> +++ ./manpages-2.39/man3/log.3 2006-12-21 23:41:40.000000000 +0100
> @@ -29,7 +29,7 @@
> .\" Modified 2002-07-27 by Walter Harms
> .\" ([EMAIL PROTECTED])
> .\"
> -.TH EXP 3 2002-07-27 "" "Linux Programmer's Manual"
> +.TH LOG 3 2002-07-27 "" "Linux Programmer's Manual"
> .SH NAME
> log, logf, logl \- natural logarithmic function
> .SH SYNOPSIS
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/rand.3 ./manpages-2.39/man3/rand.3
> --- ../orig/manpages-2.39/man3/rand.3 2006-08-03 15:57:30.000000000 +0200
> +++ ./manpages-2.39/man3/rand.3 2006-12-21 23:43:41.000000000 +0100
> @@ -146,7 +146,7 @@
> .BR rand ()
> and
> .BR srand ()
> -conform to SVr4, 4.3BSD, C89, C89, POSIX.1-2001.
> +conform to SVr4, 4.3BSD, C89, C99, POSIX.1-2001.
Thanks -- applied.
> diff -rauN ../orig/manpages-2.39/man3/regex.3 ./manpages-2.39/man3/regex.3
> --- ../orig/manpages-2.39/man3/regex.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/regex.3 2006-12-21 23:44:11.000000000 +0100
> @@ -29,7 +29,7 @@
> .in \\n(INu+\\$1
> .ti -\\$1
> ..
> -.TH REGCOMP 3 1998-05-08 GNU "Linux Programmer's Manual"
> +.TH REGEX 3 1998-05-08 GNU "Linux Programmer's Manual"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/sincos.3 ./manpages-2.39/man3/sincos.3
> --- ../orig/manpages-2.39/man3/sincos.3 2004-11-15 14:11:26.000000000
> +0100
> +++ ./manpages-2.39/man3/sincos.3 2006-12-21 23:46:02.000000000 +0100
> @@ -1,7 +1,7 @@
> .\" Copyright 2002 Walter Harms ([EMAIL PROTECTED])
> .\" Distributed under GPL, 2002-07-27 Walter Harms
> .\"
> -.TH sincos 3 2004-10-05 "GNU" "Linux Programmer's Manual"
> +.TH SINCOS 3 2004-10-05 "GNU" "Linux Programmer's Manual"
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/system.3 ./manpages-2.39/man3/system.3
> --- ../orig/manpages-2.39/man3/system.3 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man3/system.3 2006-12-21 23:46:22.000000000 +0100
> @@ -74,7 +74,7 @@
> .BR system ()
> does not affect the wait status of any other children.
> .SH "CONFORMING TO"
> -C89, C99, POSIX..1-2001.
> +C89, C99, POSIX.1-2001.
Looks like this is already fixed.
> diff -rauN ../orig/manpages-2.39/man3/tsearch.3 ./manpages-2.39/man3/tsearch.3
> --- ../orig/manpages-2.39/man3/tsearch.3 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man3/tsearch.3 2006-12-21 23:47:26.000000000 +0100
> @@ -94,7 +94,7 @@
> and after visiting the children. Thus, the choice of name \fBpost\%order\fP
> is rather confusing.)
> .PP
> -\fBtdestroy\fP() removes the whole tree pointed to by \fIrootp\fP,
> +\fBtdestroy\fP() removes the whole tree pointed to by \fIroot\fP,
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/wctrans.3 ./manpages-2.39/man3/wctrans.3
> --- ../orig/manpages-2.39/man3/wctrans.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/wctrans.3 2006-12-21 23:47:57.000000000 +0100
> @@ -40,7 +40,7 @@
> .SH "CONFORMING TO"
> C99.
> .SH "SEE ALSO"
> -.BR wctrans (3)
> +.BR towctrans (3)
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man3/xcrypt.3 ./manpages-2.39/man3/xcrypt.3
> --- ../orig/manpages-2.39/man3/xcrypt.3 2006-01-14 18:14:10.000000000
> +0100
> +++ ./manpages-2.39/man3/xcrypt.3 2006-12-21 23:48:26.000000000 +0100
> @@ -6,7 +6,7 @@
> .\" 3. xencrypt() a hexstring
> .\" to bad to be true :(
> .\"
> -.TH xcrypt 3 2003-04-04 "" "RPC cryptography"
> +.TH XCRYPT 3 2003-04-04 "" "RPC cryptography"
> .SH NAME
> xencrypt, xdecrypt, passwd2des \- RFS password encryption
> .SH SYNOPSIS
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man4/sd.4 ./manpages-2.39/man4/sd.4
> --- ../orig/manpages-2.39/man4/sd.4 2006-02-09 21:24:53.000000000 +0100
> +++ ./manpages-2.39/man4/sd.4 2006-12-22 20:15:07.000000000 +0100
> @@ -25,8 +25,10 @@
> .SH NAME
> sd \- Driver for SCSI Disk Drives
> .SH SYNOPSIS
> +.nf
> #include <linux/hdreg.h> /* for HDIO_GETGEO */
> #include <linux/fs.h> /* for BLKGETSIZE and BLKRRPART */
> +.fi
> .SH CONFIG
> The block device name has the following form:
> .BI sd lp,
> diff -rauN ../orig/manpages-2.39/man5/dir_colors.5
> ./manpages-2.39/man5/dir_colors.5
Thanks; applied.
> --- ../orig/manpages-2.39/man5/dir_colors.5 2006-12-21 23:25:37.000000000
> +0100
> +++ ./manpages-2.39/man5/dir_colors.5 2006-12-22 20:15:25.000000000 +0100
> @@ -127,7 +127,7 @@
> Specifies the color used for a socket.
> .TP
> .B DOOR \fIcolor-sequence\fR
> -(Supported since file-utils 4.1)
> +(Supported since fileutils 4.1)
> Specifies the color used for a door (Solaris 2.5 and later).
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man7/feature_test_macros.7
> ./manpages-2.39/man7/feature_test_macros.7
> --- ../orig/manpages-2.39/man7/feature_test_macros.7 2006-08-03
> 15:58:08.000000000 +0200
> +++ ./manpages-2.39/man7/feature_test_macros.7 2006-12-22
> 20:17:44.000000000 +0100
> @@ -129,11 +129,11 @@
> .BR _SVID_SOURCE ,
> .BR _POSIX_SOURCE ,
> and
> -.BR POSIX_C_SOURCE =199506.
> +.BR _POSIX_C_SOURCE =199506.
> If individual macros are defined, then other macros are disabled
> unless they are also explicitly defined. (Exception:
> if
> -.BR POSIX_C_SOURCE
> +.BR _POSIX_C_SOURCE
> is not otherwise defined,
> then it is always defined with the value 199506,
> unless the compiler is invoked in one of its standard modes, e.g., the
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man7/man.7 ./manpages-2.39/man7/man.7
> --- ../orig/manpages-2.39/man7/man.7 2006-12-21 23:25:37.000000000 +0100
> +++ ./manpages-2.39/man7/man.7 2006-12-22 20:22:10.000000000 +0100
> @@ -47,7 +47,7 @@
> .I title
> .SH DESCRIPTION
> This manual page explains the
> -.B "groff tmac.an"
> +.B "groff an.tmac"
> macro package (often called the
> .B man
> macro package) and related conventions for creating manual (man) pages.
> diff -rauN ../orig/manpages-2.39/man7/mdoc.7 ./manpages-2.39/man7/mdoc.7
*** Can you please give me further details on this? I don't know whether
this change is correct.
> --- ../orig/manpages-2.39/man7/mdoc.7 2006-12-21 23:25:37.000000000 +0100
> +++ ./manpages-2.39/man7/mdoc.7 2006-12-22 20:25:37.000000000 +0100
> @@ -71,7 +71,7 @@
> includes the structural and physical page layout macros.
> The second contains the manual and general text domain
> macros which differentiate the
> -.Nm -\mdoc
> +.Nm \-mdoc
> package from other
> .Xr troff
> formatting packages.
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man7/posixoptions.7
> ./manpages-2.39/man7/posixoptions.7
> --- ../orig/manpages-2.39/man7/posixoptions.7 2006-08-03 15:58:08.000000000
> +0200
> +++ ./manpages-2.39/man7/posixoptions.7 2006-12-23 14:40:01.000000000
> +0100
> @@ -606,7 +606,7 @@
> .IR pthread_equal (),
> .IR pthread_exit (),
> .IR pthread_getspecific (),
> -.IR pthread_join( ,
> +.IR pthread_join (),
> .IR pthread_key_create (),
> .IR pthread_key_delete (),
> .IR pthread_mutex_destroy (),
Thanks; applied.
> ------------------------------------------------------------------------
>
> diff -rauN ../orig/manpages-2.39/man1/intro.1 ./manpages-2.39/man1/intro.1
> --- ../orig/manpages-2.39/man1/intro.1 2006-08-03 08:13:56.000000000
> +0200
> +++ ./manpages-2.39/man1/intro.1 2006-12-22 19:23:48.000000000 +0100
> @@ -20,7 +20,7 @@
> .\" Formatted or processed versions of this manual, if unaccompanied by
> .\" the source, must acknowledge the copyright and authors of this work.
> .\"
> -.TH INTRO 1 2002-08-06 "Linux" "Linux Programmer's Manual"
> +.TH INTRO 1 2002-08-06 "Linux" "Linux User's Manual"
I'm not sure that I am so worried about this. But I changed it anyway.
> diff -rauN ../orig/manpages-2.39/man2/symlink.2 ./manpages-2.39/man2/symlink.2
> --- ../orig/manpages-2.39/man2/symlink.2 2006-08-03 15:57:17.000000000
> +0200
> +++ ./manpages-2.39/man2/symlink.2 2006-12-22 20:09:44.000000000 +0100
> @@ -139,6 +139,7 @@
> .SH "CONFORMING TO"
> SVr4, 4.3BSD, POSIX.1-2001.
> .\" SVr4 documents additional error codes EDQUOT and ENOSYS.
> +.\" SOmething is missing here ?
I agree that something is strange. I've simply removed the following text:
> See
> .BR open (2)
> re multiple files with the same name, and NFS.
> diff -rauN ../orig/manpages-2.39/man3/fcloseall.3
> ./manpages-2.39/man3/fcloseall.3
> --- ../orig/manpages-2.39/man3/fcloseall.3 2005-10-19 08:54:38.000000000
> +0200
> +++ ./manpages-2.39/man3/fcloseall.3 2006-12-21 23:32:59.000000000 +0100
> @@ -51,6 +51,7 @@
> The
> .BR fcloseall ()
> function dissociates all open streams
> +.\"NOTE: I don't understand "or set of functions"
Neither do I. This whole page reads strangely, and the description of the
return value seems at odds with the info page and with the source code.
I rewrote the page. It now reads:
NAME
fcloseall - close all open streams
SYNOPSIS
#define _GNU_SOURCE
#include <stdio.h>
int fcloseall(void);
DESCRIPTION
The fcloseall() function closes all of the calling pro-
cess's open streams. Buffered output for each stream is
written before it is closed (as for fflush(3)); buffered
input is discarded.
The standard streams, stdin, stdout, and stderr are also
closed.
RETURN VALUE
This function returns 0 if all files were successfully
closed; on error, EOF is returned.
CONFORMING TO
This function is a GNU extension.
SEE ALSO
close(2), fclose(3), fflush(3), fopen(3), setbuf(3)
> diff -rauN ../orig/manpages-2.39/man3/iconv_open.3
> ./manpages-2.39/man3/iconv_open.3
> --- ../orig/manpages-2.39/man3/iconv_open.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/iconv_open.3 2006-12-21 23:40:37.000000000 +0100
> @@ -23,6 +23,10 @@
> for converting byte sequences from character encoding \fIfromcode\fP to
> character encoding \fItocode\fP.
> .PP
> +.\" According to iconv --list:
> +.\" "This does not necessarily mean that all combinations of these names
> +.\" can be used for the FROM and TO command line parameters."
> +.\" Who's right?
*** Where does the text that you are quoting come from?
(no changes, yet)
> The values permitted for \fIfromcode\fP and \fItocode\fP and the supported
> combinations are system dependent. For the GNU C library, the permitted
> values are listed by the \fBiconv \-\-list\fP command, and all combinations
> diff -rauN ../orig/manpages-2.39/man3/malloc.3 ./manpages-2.39/man3/malloc.3
> --- ../orig/manpages-2.39/man3/malloc.3 2006-08-03 15:57:30.000000000
> +0200
> +++ ./manpages-2.39/man3/malloc.3 2006-12-21 23:42:58.000000000 +0100
> @@ -141,6 +141,7 @@
> .IR errno .
> .LP
> Crashes in
> +.BR calloc (),
> .BR malloc (),
> .BR free ()
> or
Thanks; applied.
> diff -rauN ../orig/manpages-2.39/man7/capabilities.7
> ./manpages-2.39/man7/capabilities.7
> --- ../orig/manpages-2.39/man7/capabilities.7 2006-08-03 15:58:08.000000000
> +0200
> +++ ./manpages-2.39/man7/capabilities.7 2006-12-23 13:50:25.000000000
> +0100
> @@ -379,7 +379,7 @@
> kernel version 2.2.11.
> .SS Current and Future Implementation
> A full implementation of capabilities requires:
> -
> +.\" Missing 1.
> .IP 2. 4
> that the kernel provide
> system calls allowing a thread's capability sets to
> diff -rauN ../orig/manpages-2.39/man7/mdoc.7 ./manpages-2.39/man7/mdoc.7
Already fixed (2.40).
> --- ../orig/manpages-2.39/man7/mdoc.7 2006-12-21 23:25:37.000000000 +0100
> +++ ./manpages-2.39/man7/mdoc.7 2006-12-22 20:25:37.000000000 +0100
> @@ -401,6 +401,7 @@
> .Xr man 7
> for more information on these macros.
> .Sh CONFIGURATION
> +.\" not available at least on Linux.
> For site specific configuration of the macro package,
> see the file
> .Pa /usr/src/share/tmac/README .
Agreed; I've removed this section.
Thanks once again Nicolas for all of these fixes -- just tremendous!
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
http://www.kernel.org/pub/linux/docs/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]
