diff --git a/Changes b/Changes index bdbdcdfc1..845e6907c 100644 --- a/Changes +++ b/Changes @@ -8,7 +8,13 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -#### Andries Brouwer +A Costa +Andries Brouwer +Bas Zoetekouw +Dan Jacobson +Delian Krustev +Dora Anna Volgyesi +Martin (Joey) Schulze Apologies if I missed anyone! @@ -16,7 +22,7 @@ Global changes -------------- Typographical or grammatical errors have been corrected in several -places. +places. (Special thanks to A Costa.) New pages @@ -25,3 +31,120 @@ New pages Changes to individual pages --------------------------- + +_exit.2 + mtk / aeb + Reversed 2.04 introduction of the term "process termination + function". + +close.2 + mtk + Clarified what type of lock close() affects. + Minor formatting changes. + +dup.2 + mtk + Consistent use of terms "open file description", + "file status flags", and "file decriptor flags" + Removed mention of lock sharing -- it was not + accurate. + Minor formatting fixes + +fcntl.2 + mtk + Consistent use of terms "open file description", + "file status flags", and "file decriptor flags" + Some rewriting of discussion of file descriptor flags + Under F_DUPFD, replaced some text duplicated in dup.2 + with a cross ref to dup.2 + Minor wording and formatting fixes + +fpclassify.3 + mtk / Martin (Joey) Schulze / Bas Zoetekouw + The return value of isinf() changed in glibc 2.02 + to differentiate positive and neagtive infinity. + See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765 + +getgid.2 +getuid.2 + Delian Krustev + Remove confusing text describing real and effective IDs. + As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852 + +getitimer.2 + mtk + The short sleep bug (up to 1 jiffy) that was newly noted in + man-pages-2.04 has just been fixed in 2.6.12. + +getpriority.2 + mtk + Changed range documented in main text from -20..20 to -20..19. + Noted that the range is -20..20 on some systems. + +open.2 + mtk + Clarification of term "open file description" along with + explanation of what information it maintains. + Various minor wording changes + +atexit.3 + mtk / aeb + Reversed 2.04 introduction of the term "process termination + function". + mtk + Noted use of atexit() for establishing function to be invoked on + shared library unload. + Noted that atexit()-registered functions are not invoked on + abnormal termination. + Formatting fixes. + +exit.3 + mtk / aeb + Reversed 2.04 introduction of the term "process termination + function". + mtk + Minor rewording and formatting changes. + +getloadavg.3 + mtk + Added #define _BSD_SOURCE to prototype + +log2.3 + Martin (Joey) Schulze + Add ERANGE error. + +readdir.3 + mtk + Added definition of Linux dirent structure. + Some formatting cleanups. + +strtod.3 + Dora Anna Volgyesi/ mtk + strtold() and strtof() need _ISOC99_SOURCE of _XOPEN_SOURCE=600 + As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668 + +tdestroy.3 + mtk + New link to tsearch.3 + +tsearch.3 + mtk + Added tdestroy to .TH line + +mem.4 + mtk + Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem" + +null.4 + mtk + Change "chown root:mem /dev/null /dev/zero" to + "chown root:root /dev/null /dev/zero" + +vcs.4 + Dan Jacobson / Martin (Joey) Schulze + Replaced "selection(1)" by "gpm(8)" under SEE ALSO + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515 + +urn.7 + mtk + New link to uri.7 diff --git a/Changes.old b/Changes.old index f8935ede4..df7404f3f 100644 --- a/Changes.old +++ b/Changes.old @@ -792,7 +792,7 @@ Dave Love Dieter Brueggemann Geoff Clare Guido Trotter -kabloom kabloom@ucdavis.edu +kabloom Kevin Ryde Justin Pryzby Mike Furr diff --git a/man1/intro.1 b/man1/intro.1 index a4790c2f3..2f5ff575a 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -240,7 +240,7 @@ usually .IR less . Hit the space bar to get the next page, hit q to quit. .LP -In documentation it is custumary to refer to man pages +In documentation it is customary to refer to man pages by giving the name and section number, as in .BR man (1). Man pages are terse, and allow you to find quickly some forgotten diff --git a/man3/fclose.3 b/man3/fclose.3 index ab56455a4..18e14197f 100644 --- a/man3/fclose.3 +++ b/man3/fclose.3 @@ -66,7 +66,7 @@ to the stream results in undefined behaviour. .SH ERRORS .TP .B EBADF -The filedescriptor underlying +The file descriptor underlying .I fp is not valid. .\" This error cannot occur unless you are mixing ANSI C stdio operations and diff --git a/man4/epoll.4 b/man4/epoll.4 index 3357d9af2..2ba0d36a0 100644 --- a/man4/epoll.4 +++ b/man4/epoll.4 @@ -163,7 +163,7 @@ While the usage of when employed like a Level Triggered interface does have the same semantics of .BR poll (2), -an Edge Triggered usage requires more clarifiction to avoid stalls +an Edge Triggered usage requires more clarification to avoid stalls in the application event loop. In this example, listener is a non-blocking socket on which .BR listen (2) @@ -345,7 +345,7 @@ If you use an event cache or store all the fd's returned from then make sure to provide a way to mark its closure dynamically (ie- caused by a previous event's processing). Suppose you receive 100 events from .BR epoll_wait (2), -and in eventi #47 a condition causes event #13 to be closed. +and in event #47 a condition causes event #13 to be closed. If you remove the structure and close() the fd for event #13, then your event cache might still say there are events waiting for that fd causing confusion. diff --git a/man4/tty_ioctl.4 b/man4/tty_ioctl.4 index a481b8bf5..8ba000e12 100644 --- a/man4/tty_ioctl.4 +++ b/man4/tty_ioctl.4 @@ -226,7 +226,7 @@ and all processes in the current session lose their controlling tty. When successful, equivalent to .IR "*argp = tcgetpgrp(fd)" . .br -Get the process group ID of the foreground proces group on this tty. +Get the process group ID of the foreground process group on this tty. .TP .BI "TIOCSPGRP const pid_t *" argp Equivalent to diff --git a/man5/charmap.5 b/man5/charmap.5 index 6755b7cef..886a1bc9e 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -22,7 +22,7 @@ .SH NAME charmap \- character symbols to define character encodings .SH DESCRIPTION -A character set description (charmap) defines a characterset of +A character set description (charmap) defines a character set of available characters and their encodings. All supported character sets should have the .B portable character set diff --git a/man5/dir_colors.5 b/man5/dir_colors.5 index e8b814b61..8bb50352f 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 @@ -216,7 +216,7 @@ uses the following defaults: \fBFILE\fR 0 Regular file \fBDIR\fR 32 Directory \fBLINK\fR 36 Symbolic link -\fBORPHAN\fR undefined Orphanned symbolic link +\fBORPHAN\fR undefined Orphaned symbolic link \fBMISSING\fR undefined Missing file \fBFIFO\fR 31 Named pipe (FIFO) \fBSOCK\fR 33 Socket diff --git a/man5/hosts.equiv.5 b/man5/hosts.equiv.5 index cbc0eb3e0..6db9cb969 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -18,7 +18,7 @@ to the local host. Users logged into that host are allowed to access like-named user accounts on the local host without supplying a password. The \fIhostname\fP may be (optionally) preceded by a plus (+) sign. If the plus sign is used alone it allows any host to access your system. -You can expicitly deny access to a host by preceding the \fIhostname\fP +You can explicitly deny access to a host by preceding the \fIhostname\fP by a minus (-) sign. Users from that host must always supply a password. For security reasons you should always use the FQDN of the hostname and not the short hostname. diff --git a/man5/nsswitch.conf.5 b/man5/nsswitch.conf.5 index 4c2170345..ec7b2d37c 100644 --- a/man5/nsswitch.conf.5 +++ b/man5/nsswitch.conf.5 @@ -218,7 +218,7 @@ and .BR /etc/shadow . If this is not sufficient, the NSS `compat' service provides full +/- semantics. By default, the source is `nis', but this may be -overriden by specifying `nisplus' as source for the pseudo-databases +overridden by specifying `nisplus' as source for the pseudo-databases .BR passwd_compat, .B group_compat and diff --git a/man5/proc.5 b/man5/proc.5 index 93541cc40..5cbb9432f 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -477,12 +477,12 @@ cache buffer size in KB capacity number of sectors driver driver version geometry physical and logical geometry -identify in hexidecimal +identify in hexadecimal media media type model manufacturer's model number settings drive settings -smart_thresholds in hexidecimal -smart_values in hexidecimal +smart_thresholds in hexadecimal +smart_values in hexadecimal .fi The @@ -491,7 +491,7 @@ utility provides access to this information in a friendly format. .TP .I /proc/interrupts This is used to record the number of interrupts per each IRQ on (at -least) the i386 architechure. Very easy to read formatting, done in +least) the i386 architecture. Very easy to read formatting, done in ASCII. .TP .I /proc/iomem @@ -649,7 +649,7 @@ Defined in .IR /usr/src/linux/net/core/dev_mcast.c : .nf .in +5 -indx ifterface_name dmi_u dmi_g dmi_address +indx interface_name dmi_u dmi_g dmi_address 2 eth0 1 0 01005e000001 3 eth1 1 0 01005e000001 4 eth2 1 0 01005e000001 @@ -1427,7 +1427,7 @@ for easy understanding. provides further background on the information shown by these files. .TP .I /proc/tty -Subdirectory containing the psuedo-files and subdirectories for +Subdirectory containing the pseudo-files and subdirectories for tty drivers and line disciplines. .TP .I /proc/uptime diff --git a/man5/termcap.5 b/man5/termcap.5 index a330f8b86..ae1be3c29 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -189,7 +189,7 @@ ws Width of status line if different from screen width @8 enter/send key @9 exit key al Insert one line -AL Indert %1 lines +AL Insert %1 lines ac Pairs of block graphic characters to map alternate character set ae End alternative character set as Start alternative character set for block graphic characters @@ -272,7 +272,7 @@ kd Cursor down key kD Key for delete character under cursor ke turn keypad off kE Key for clear to end of line -kF Key for scolling forward/down +kF Key for scrolling forward/down kh Cursor home key kH Cursor hown down key kI Insert character/Insert mode key @@ -282,7 +282,7 @@ kM Key for exit insert mode kN Key for next page kP Key for previous page kr Cursor right key -kR Key for scolling backward/up +kR Key for scrolling backward/up ks Turn keypad on kS Clear to end of screen key kt Clear this tab key @@ -356,7 +356,7 @@ UP Cursor up %1 lines us Start underlining vb Visible bell ve Normal cursor visible -vi Cursor unvisible +vi Cursor invisible vs Standout cursor wi Set window from line %1 to %2 and column %3 to %4 XF XOFF character if not ^S @@ -364,11 +364,11 @@ XF XOFF character if not ^S .LP There are several ways of defining the control codes for string capabilities: .LP -Normal Characters except '^','\e' and '%' repesent themself. +Every normal character represents itself, except '^','\e' and '%'. .LP A '^x' means Control-x. Control-A equals 1 decimal. .LP -\ex means a special code. x can be one of the following charaters: +\ex means a special code. x can be one of the following characters: .RS E Escape (27) .br @@ -385,7 +385,7 @@ f Form feed (12) 0 Null character. A \exxx specifies the octal character xxx. .RE .IP i -Increments paramters by one. +Increments parameters by one. .IP r Single parameter capability .IP + @@ -420,7 +420,7 @@ The following names are available: , left arrow (<) \&. down arrow (v) 0 full square (#) -I latern (#) +I lantern (#) - upper arrow (^) \&' rhombus (+) a chess board (:) diff --git a/man7/bootparam.7 b/man7/bootparam.7 index 2e348fdbb..09767d6a8 100644 --- a/man7/bootparam.7 +++ b/man7/bootparam.7 @@ -396,7 +396,7 @@ General notation for this section: .I iobase -- the first I/O port that the SCSI host occupies. These are -specified in hexidecimal notation, and usually lie in the range from +specified in hexadecimal notation, and usually lie in the range from 0x200 to 0x3ff. .I irq diff --git a/man7/capabilities.7 b/man7/capabilities.7 index ad7b824bc..7ab9f21de 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -295,8 +295,8 @@ a process may manipulate its own capability sets, or, if it has the capability, those of another process. .SS Capability bounding set -When a program is execed, the permitted and effective capabities are ANDed -with the current value of the so-called +When a program is execed, the permitted and effective capabilities +are ANDed with the current value of the so-called .IR "capability bounding set" , defined in the file .IR /proc/sys/kernel/cap-bound . diff --git a/man7/glob.7 b/man7/glob.7 index 02ead1c5b..8357e528b 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -151,7 +151,7 @@ and (iii) ranges. POSIX specifies ranges in an internationally more useful way and adds three more types: (iii) Ranges X-Y comprise all characters that fall between X -and Y (inclusive) in the currect collating sequence as defined +and Y (inclusive) in the current collating sequence as defined by the LC_COLLATE category in the current locale. (iv) Named character classes, like diff --git a/man7/hier.7 b/man7/hier.7 index 2b8c21a53..104e875cb 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -326,7 +326,7 @@ The message catalogs for native language support go here. Files for SGML and XML. .TP .I /usr/share/terminfo -The datebase for terminfo. +The database for terminfo. .TP .I /usr/share/tmac Troff macros that are not distributed with groff. diff --git a/man7/ip.7 b/man7/ip.7 index 466747f3b..836b46e74 100644 --- a/man7/ip.7 +++ b/man7/ip.7 @@ -711,7 +711,7 @@ allocated to sockets. Allocation starts with the first number and ends with the second number. Note that these should not conflict with the ports used by masquerading (although the case is handled). -Also arbitary choices may cause problems with some firewall packet +Also arbitrary choices may cause problems with some firewall packet filters that make assumptions about the local ports in use. First number should be at least >1024, better >4096 to avoid clashes with well known ports and to minimize firewall problems. @@ -820,7 +820,7 @@ Modifying firewall settings without or effective user id 0. Binding to a reserved port without the .B CAP_NET_BIND_SERVICE -capacibility or effective user id 0. +capability or effective user id 0. .TP .B EADDRINUSE diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 7cff2fd70..6b4eeafef 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -144,8 +144,8 @@ is currently supported for that. It is only allowed for IPv6 sockets that are connected and bound to a v4-mapped-on-v6 address. The argument is a pointer to a integer containing .B AF_INET. -This is useful to pass v4-mapped sockets as filedescriptors to programs that -don't know how to deal with the IPv6 API. +This is useful to pass v4-mapped sockets as file descriptors to +programs that don't know how to deal with the IPv6 API. .TP .B IPV6_PKTINFO Set delivery of the diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index 54040c3af..53e503427 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -50,8 +50,8 @@ struct rtattr }; .fi -These attributes should be only manipulated using the RTA_* macros or libnetlink, -see +These attributes should be only manipulated using the RTA_* macros +or libnetlink, see .BR rtnetlink (3). .SH MESSAGES @@ -245,9 +245,9 @@ RTPROT_STATIC:by the administrator Values larger than .B RTPROT_STATIC -are not interpreted by the kernel, they are just for user information. They -may be used to tag the source of a routing information or to distingush between -multiple routing daemons. See +are not interpreted by the kernel, they are just for user information. +They may be used to tag the source of a routing information or to +distinguish between multiple routing daemons. See .BR for the routing daemon identifiers which are already assigned. @@ -298,7 +298,7 @@ RT_TABLE_MAIN:the main table RT_TABLE_LOCAL:the local table .TE -The user may assign arbitary values between +The user may assign arbitrary values between .B RT_TABLE_UNSPEC and .BR RT_TABLE_DEFAULT . @@ -328,8 +328,8 @@ RTA_CACHEINFO:: .B Fill these values in! .TP .BR RTM_NEWNEIGH ", " RTM_DELNEIGH ", " RTM_GETNEIGH -Add, remove or receive information about a neighbour table entry (e.g. an ARP -entry). The message contains an +Add, remove or receive information about a neighbour table +entry (e.g. an ARP entry). The message contains an .B ndmsg structure. diff --git a/man7/signal.7 b/man7/signal.7 index 5c67c7cce..cd5cbc235 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -196,7 +196,7 @@ If the signal is sent using an accompanying value (either an integer or a pointer) can be sent with the signal. If the receiving process establishes a handler for this signal using the -.B SA_SIGACTION +.B SA_SIGINFO flag to .BR sigaction (2) then it can obtain this data via the diff --git a/man7/suffixes.7 b/man7/suffixes.7 index b57aa4234..44d00a79f 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -73,7 +73,7 @@ Suffix File type .arc \fBarc\fP(1) archive .arj \fBarj\fP(1) archive .asc PGP ASCII-armoured data - .asm (GNU) assember source file + .asm (GNU) assembler source file .au Audio sound file .aux LaTeX auxiliary file .avi (msvideo) movie @@ -145,7 +145,7 @@ Suffix File type .image bitmap source .in configuration template, especially for GNU Autoconf .info files for the Emacs info browser - .info-[0-9]+ splitted info files + .info-[0-9]+ split info files .ins LaTeX package install file for docstrip .itcl itcl source code; itcl ([incr Tcl]) is an OO extension of tcl @@ -217,7 +217,7 @@ Suffix File type .rules rules for something .s assembler source .sa stub libraries for a.out shared libraries - .sc \fBsc\fP(1) spreadsheed commands + .sc \fBsc\fP(1) spreadsheet commands .scm Scheme source code .sed sed source file .sgml SGML source file diff --git a/man7/udp.7 b/man7/udp.7 index b9b5e2e43..2de638195 100644 --- a/man7/udp.7 +++ b/man7/udp.7 @@ -15,8 +15,9 @@ udp \- User Datagram Protocol for IPv4 .br .B udp_socket = socket(PF_INET, SOCK_DGRAM, 0); .SH DESCRIPTION -This is an implemention of the User Datagram Protocol described in RFC\ 768. It -implements a connectionless, unreliable datagram packet service. +This is an implementation of the User Datagram Protocol +described in RFC\ 768. +It implements a connectionless, unreliable datagram packet service. Packets may be reordered or duplicated before they arrive. UDP generates and checks checksums to catch transmission errors. diff --git a/man8/sync.8 b/man8/sync.8 index c1dbd5124..6c85e8b31 100644 --- a/man8/sync.8 +++ b/man8/sync.8 @@ -6,7 +6,7 @@ .TH SYNC 8 1998-11 "GNU fileutils 4.0" "Linux Programmer's Manual" .SH NAME sync \- synchronize data on disk with memory -.SH SYNOPSYS +.SH SYNOPSIS .B "sync [\-\-help] [\-\-version]" .SH DESCRIPTION .B sync