diff --git a/man3/assert.3 b/man3/assert.3 index 2d9e17901..d1269018f 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -24,7 +24,7 @@ .\" .\" Modified Sat Jul 24 21:42:42 1993 by Rik Faith .\" Modified Tue Oct 22 23:44:11 1996 by Eric S. Raymond -.TH ASSERT 3 2002-08-25 "GNU" "Linux Programmer's Manual" +.TH ASSERT 3 2013-09-26 "GNU" "Linux Programmer's Manual" .SH NAME assert \- abort the program if assertion is false .SH SYNOPSIS @@ -50,8 +50,8 @@ if .I expression is false (i.e., compares equal to zero). .LP -The purpose of this macro is to help the programmer find bugs in -his program. +The purpose of this macro is to help programmers find bugs in +their programs. The message "assertion failed in file foo.c, function do_bar(), line 1287" is of no help at all to a user. .SH RETURN VALUE diff --git a/man3/assert_perror.3 b/man3/assert_perror.3 index a120344ad..b68722180 100644 --- a/man3/assert_perror.3 +++ b/man3/assert_perror.3 @@ -25,7 +25,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH ASSERT_PERROR 3 2002-08-25 "GNU" "Linux Programmer's Manual" +.TH ASSERT_PERROR 3 2013-09-26 "GNU" "Linux Programmer's Manual" .SH NAME assert_perror \- test errnum and abort .SH SYNOPSIS @@ -59,8 +59,8 @@ No value is returned. .SH CONFORMING TO This is a GNU extension. .SH BUGS -The purpose of the assert macros is to help the programmer find bugs in -his program, things that cannot happen unless there was a coding mistake. +The purpose of the assert macros is to help programmers find bugs in +their programs, things that cannot happen unless there was a coding mistake. However, with system or library calls the situation is rather different, and error returns can happen, and will happen, and should be tested for. Not by an assert, where the test goes away when diff --git a/man3/rexec.3 b/man3/rexec.3 index 94fa9e575..79dc61e2f 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -38,7 +38,7 @@ .\" .\" 2013-06-21, mtk, Converted from mdoc to man macros .\" -.TH REXEC 3 2013-07-04 "Linux" "Linux Programmer's Manual" +.TH REXEC 3 2013-09-26 "Linux" "Linux Programmer's Manual" .SH NAME rexec, rexec_af \- return stream to a remote command .SH SYNOPSIS @@ -70,9 +70,9 @@ Otherwise is set to the standard name of the host. If a username and password are both specified, then these are used to authenticate to the foreign host; otherwise -the environment and then the user's +the environment and then the .I .netrc -file in his +file in user's home directory are searched for appropriate information. If all this fails, the user is prompted for the information. .PP diff --git a/man3/rpc.3 b/man3/rpc.3 index c1d2f7d6b..b89c71db1 100644 --- a/man3/rpc.3 +++ b/man3/rpc.3 @@ -8,7 +8,7 @@ .\" .\" 2007-12-30, mtk, Convert function prototypes to modern C syntax .\" -.TH RPC 3 2008-07-17 "" "Linux Programmer's Manual" +.TH RPC 3 2013-09-26 "" "Linux Programmer's Manual" .SH NAME rpc \- library routines for remote procedure calls .SH SYNOPSIS AND DESCRIPTION @@ -699,9 +699,9 @@ A global variable reflecting the RPC service side's read file descriptor bit mask; it is suitable as a parameter to the .BR select (2) system call. -This is of interest only if a service implementor does not call -.BR svc_run (), -but rather does his own asynchronous event processing. +This is of interest only if a service implementor does their own +asynchronous event processing, instead of calling +.BR svc_run (). This variable is read-only (do not pass its address to .BR select (2)!), yet it may change after calls to