Justin,
> I'm attaching a patch to fix spelling errors found throughout the
> manpages package. Some of the changes are debatable; for example,
> changing between British and American spelling.
Indeed; editorial decisions should be labelled as such;
they are not patches.
> At first I though to
> leave these alone; but I ultimately decided to make the changes anyway
> for better consistency.
Yes, I'd been thinking to patch everything to match New Zealand
spelling, actually.
But seriously. The US/UK inconsistency in spelling in the man
pages is unfortunate. However, I'm not (yet) prepared to dictate
one way or the other. And it's not even clear that US spelling
is the majority position in absolute numbers among the English
speakers of the world.
> If you want these reversed or dropped just
> say so.
These changes won't go upstream.
> FYI my procedure was to find all unique words in the manpages matching
> ^[A-Z]?[a-z]+$ by using sed s/ /\n/g, and to run aspell on that list
> (one letter at a time).
>
> Then zgrep -lf ./aspell-backup-file (not the new file..) to get a
> reduced list of pages to fiddle with. paste aspell{,.bak}, and the
> result tweaked in vim to create a sed script with ~100 substitute
> commands.
>
> for f in `<./manpages-badwords-pages`; do d=${f#/}; mkdir -p
> {old/,}${d%/[!/]*}; zcat $f |sed -f ./manpages-badwords.diff >$d; gunzip -c
> $f >old/$d;
> diff -u {old/,}$d; done
You cannot autogenerate patches, unless you carefully visually
inspect the results. See one of my comments below.
Some comments on the patches:
> -case, opening for read only will succeed even if noone has
> +case, opening for read only will succeed even if no one has
Better "no-one".
> --- old/usr/share/man/man4/st.4.gz 2006-05-28 15:33:16.000000000 -0400
> +++ usr/share/man/man4/st.4.gz 2006-05-28 15:33:16.000000000 -0400
> -Retension tape.
> +Retention tape.
No!! At best "re-tension".
> +++ usr/share/man/man2/adjtime.2.gz 2006-05-28 15:33:18.000000000 -0400
> -lost this much elapsed time. If positive, the system clock is speeded
> +lost this much elapsed time. If positive, the system clock is sped
"speeded" seems perfectly acceptable to me.
> -.BI "const char *" filesystemtype ", unsigned long " mountflags ,
> +.BI "const char *" filesystem type ", unsigned long " mountflags ,
You are joking...
> -The prototypes are missing from the abovementioned include file.
> +The prototypes are missing from the above mentioned include file.
"abovementioned" is perfectly acceptable.
> --- old/usr/share/man/man2/umount.2.gz 2006-05-28 15:33:28.000000000
> -0400
> +++ usr/share/man/man2/umount.2.gz 2006-05-28 15:33:28.000000000 -0400
> -All functions are fully ANSI X3.159-1989 conformant, but provide the
> +All functions are fully ANSI X3.159-1989 conforming, but provide the
"conformant" is perfectly acceptable; even preferable.
Below is what actually got applied for upstream 2.34.
Thanks,
Michael
Index: man3/sem_open.3
===================================================================
--- man3/sem_open.3 (revision 1009)
+++ man3/sem_open.3 (working copy)
@@ -50,7 +50,7 @@
.IR oflag ,
then the semaphore is created if
it does not already exist.
-The owner (user ID) of the seamphore is set to the effective
+The owner (user ID) of the semaphore is set to the effective
user ID of the calling process.
The group ownership (group ID) is set to the effective group ID
of the calling process.
Index: man3/errno.3
===================================================================
--- man3/errno.3 (revision 1172)
+++ man3/errno.3 (working copy)
@@ -297,7 +297,7 @@
Exec format error (POSIX.1)
.TP
.BR ENOKEY
-Reuired key not available
+Required key not available
.TP
.BR ENOLCK
No locks available (POSIX.1)
Index: man3/ctermid.3
===================================================================
--- man3/ctermid.3 (revision 953)
+++ man3/ctermid.3 (working copy)
@@ -54,6 +54,6 @@
.PP
It is not assured that the program can open the terminal.
.\" in glibc 2.3.x, x >= 4, the glibc headers threw an error
-.\" if ctermid() was fiven an argument; fixed in 2.4.
+.\" if ctermid() was given an argument; fixed in 2.4.
.SH "SEE ALSO"
.BR ttyname (3)
Index: man3/dbopen.3
===================================================================
--- man3/dbopen.3 (revision 597)
+++ man3/dbopen.3 (working copy)
@@ -468,7 +468,7 @@
Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992.
.SH BUGS
The typedef DBT is a mnemonic for ``data base thang'', and was used
-because noone could think of a reasonable name that wasn't already used.
+because no-one could think of a reasonable name that wasn't already used.
.PP
The file descriptor interface is a kludge and will be deleted in a
future version of the interface.
Index: man3/rtnetlink.3
===================================================================
--- man3/rtnetlink.3 (revision 924)
+++ man3/rtnetlink.3 (working copy)
@@ -6,7 +6,7 @@
.\" $Id: rtnetlink.3,v 1.2 1999/05/18 10:35:10 freitag Exp $
.TH RTNETLINK 3 1999-05-14 "Linux Man Page" "Linux Programmer's Manual"
.SH NAME
-rtnetlink \- Macros to manipuate rtnetlink messages
+rtnetlink \- Macros to manipulate rtnetlink messages
.SH SYNOPSIS
.B #include <asm/types.h>
.br
Index: man3/rcmd.3
===================================================================
--- man3/rcmd.3 (revision 392)
+++ man3/rcmd.3 (working copy)
@@ -155,7 +155,7 @@
service is allowed.
.Pp
If this file does not exist, is not a regular file, is owned by anyone
-other than the user or the superuser, or is writeable by anyone other
+other than the user or the superuser, or is writable by anyone other
than the owner, the check automatically fails.
Zero is returned if the machine name is listed in the
.Dq Pa hosts.equiv
Index: man3/inet.3
===================================================================
--- man3/inet.3 (revision 816)
+++ man3/inet.3 (working copy)
@@ -113,7 +113,7 @@
.SH NOTE
When you using numbers-and-dots notation for addresses,
be aware that each number will be interpreted as octal
-if preceeded by a 0 and as hexadecimal if preceeded by 0x.
+if preceded by a 0 and as hexadecimal if preceded by 0x.
For example, \fBinet_aton("226.000.000.037", &t)\fP will
interpret the address as \fI266.0.0.31\fP and not \fI226.0.0.37\fP.
.SH "GLIBC NOTES"
Index: man4/console_codes.4
===================================================================
--- man4/console_codes.4 (revision 1266)
+++ man4/console_codes.4 (working copy)
@@ -395,7 +395,7 @@
left corner is (1,1).
.SH "COMPARISONS WITH OTHER TERMINALS"
Many different terminal types are described, like the Linux console,
-as being `VT100-compatible'. Here we discuss differences vbetween the
+as being `VT100-compatible'. Here we discuss differences between the
Linux console an the two most important others, the DEC VT102 and
.BR xterm (1).
.\"
Index: man4/st.4
===================================================================
--- man4/st.4 (revision 786)
+++ man4/st.4 (working copy)
@@ -291,7 +291,7 @@
.IP MTRESET
Reset drive.
.IP MTRETEN
-Retension tape.
+Re-tension tape.
.IP MTREW
Rewind.
.IP MTSEEK
Index: man5/group.5
===================================================================
--- man5/group.5 (revision 600)
+++ man5/group.5 (working copy)
@@ -45,7 +45,7 @@
.SH BUGS
As the 4.2BSD
.BR initgroups (3)
-man page says: Noone seems to keep /etc/group up-to-date.
+man page says: No-one seems to keep /etc/group up-to-date.
.SH FILES
/etc/group
.SH "SEE ALSO"
Index: man7/epoll.7
===================================================================
--- man7/epoll.7 (revision 1328)
+++ man7/epoll.7 (working copy)
@@ -141,12 +141,12 @@
and can be used wherever the latter is used since it shares the
same semantics. Since even with the Edge Triggered
.B epoll
-multiple events can be generated up on receival of multiple chunks of data,
+multiple events can be generated up on receipt of multiple chunks of data,
the caller has the option to specify the
.B EPOLLONESHOT
flag, to tell
.B epoll
-to disable the associated file descriptor after the receival of an event with
+to disable the associated file descriptor after the receipt of an event with
.BR epoll_wait (2).
When the
.B EPOLLONESHOT
Index: man7/fifo.7
===================================================================
--- man7/fifo.7 (revision 1123)
+++ man7/fifo.7 (working copy)
@@ -27,7 +27,7 @@
until the other end is opened also.
.PP
A process can open a FIFO in non-blocking mode. In this
-case, opening for read only will succeed even if noone has
+case, opening for read only will succeed even if no-one has
opened on the write side yet; opening for write only will
fail with ENXIO (no such device or address) unless the other
end has already been opened.
Index: man7/locale.7
===================================================================
--- man7/locale.7 (revision 844)
+++ man7/locale.7 (working copy)
@@ -34,7 +34,7 @@
.fi
.SH DESCRIPTION
A locale is a set of language and cultural rules. These cover aspects
-such as language for messages, different character sets, lexigraphic
+such as language for messages, different character sets, lexicographic
conventions, etc. A program needs to be able to determine its locale
and act accordingly to be portable to different cultures.
.PP
--
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]
