Index: ossp-pkg/rc/rc.pod RCS File: /v/ossp/cvs/ossp-pkg/rc/rc.pod,v rcsdiff -q -kk '-r1.36' '-r1.37' -u '/v/ossp/cvs/ossp-pkg/rc/rc.pod,v' 2>/dev/null --- rc.pod 2003/06/23 15:46:05 1.36 +++ rc.pod 2003/06/23 16:44:55 1.37 @@ -124,7 +124,7 @@ specify the location of one or more optional function files. They act like libraries, containing commands which are prepended to the sections of their -corresponding Cs just before execution. +corresponding Fs just before execution. =item B<-h>|B<--help> @@ -264,27 +264,26 @@ =head1 ERROR HANDLING -Rich and fine-tuned error handling is possible by writing one or both of the -following sections into F(s). These sections typically reference the -local F's variables ${rc_errcode} and ${rc_errstring} for more -information about which error was encountered and its text. +Fine-tuned error handling is possible by writing one or both of the following +section labels into an F. These sections typically reference the local +F's variables ${rc_errcode} and ${rc_errstring} for more information +about which error was encountered and its text. =item B<%error> If an error condition arises during an F's processing, control will pass to the B<%error> section whose commands will begin to run. Should no such -B<%error> section exist, rc will stop any rcfile processing and write error -strings to the console and syslog using LOG_USER and LOG_ERR (see syslog(3)). -An empty B<%error> section in each F is synonymous to a -C option (which doesn't exist). +B<%error> section exist, rc will stop processing and write error strings to +the console and syslog using LOG_USER and LOG_ERR (see syslog(3)). An empty +B<%error> section in each F will cause errors to be ignored. In any +case of error however, rcfile processing will stop. =item B<%default> The commands in the B<%default> section are run when the corresponding F contains no section label matching the one(s) specified on the command line. If the appropriate section label doesn't exist and neither does -B<%default>, then an error is assumed and control flows to the B<%error> -section. +B<%default>, then nothing happens and processing silently procedes. =head1 EXAMPLES @@ -313,7 +312,7 @@ /opt/binbin/rc --print --info mico /usr/local/bin/rc --print httpd reload -Arguments in the form of name=value pairs may be passed to the section(s) +Arguments in the form of name=value pairs may be passed to the B given on the command line. In the F, such arguments will appear as normal configuration variables. They can be referenced as such (by default as ${myarg}). On the command line, the arguments following a section will be @@ -337,8 +336,8 @@ =head1 SEE ALSO OSSP rc integrates concepts taken from other run-command architectures. For -more information, inspect the /etc/rc structures provided by the NetBSD, -FreeBSD, Solaris, and Red Hat distributions. +more information, inspect the /etc/rc? structures provided by the NetBSD, +FreeBSD, Solaris, and Linux distributions. rc-sample(5).