Index: ossp-pkg/rc/rc-sample.pod RCS File: /v/ossp/cvs/ossp-pkg/rc/rc-sample.pod,v rcsdiff -q -kk '-r1.6' '-r1.7' -u '/v/ossp/cvs/ossp-pkg/rc/rc-sample.pod,v' 2>/dev/null --- rc-sample.pod 2002/01/30 22:55:26 1.6 +++ rc-sample.pod 2002/01/31 20:00:54 1.7 @@ -9,10 +9,10 @@ This documents typical use cases for B. -=head1 USE CASE: OpenPKG Run-Command Facility +=head1 USE CASE: OpenPKG Runcommand Facility This describes how B is used as the B -(http://www.openpkg.org/) run-command facility. +(http://www.openpkg.org/) runcommand facility. First, the involved files: @@ -24,7 +24,7 @@ =item F -This is the B configuration file, hard-coded into +This is the B configuration file, hardcoded into F at configure/build time with the Autoconf option C<--with-config=/cw/etc/rc.cf>. It is installed at B bootstrap time and used read-only. @@ -39,13 +39,14 @@ RequireGroup cw # how to parse RC files - ParseEnvDef (?<=^\s*)([a-zA-Z_][a-zA-Z_0-9]*)=(?:"([^"]*)"|'([^']*)'|(\S+)) + ParseEnvAss (?<=^\s*)([a-zA-Z_][a-zA-Z_0-9]*)=(?:"([^"]*)"|'([^']*)'|(\S+)) ParseSectionDef (?<=^|\n)%([a-zA-Z][a-zA-Z0-9]*)(\s+-[a-zA-Z]\s*\S+)*\s*\n(.+?)(?=\n%%\S+|$) + ParseSectionRef (?<=^\s*|;\s*)@([a-zA-Z][a-zA-Z0-9]*)(\s+[^\n]+)? ParseSectionParam (?<=^|\s)-([a-zA-Z])\s*(\S+) - ParseSectionRef (?<=^\s*|;\s*)%([a-zA-Z][a-zA-Z0-9]*)(\s+[^\n]+)? - ParseParamRef \$([0-9]) NameConfig config NameCommon common + NameDefault default + NameError error Execute root %s Execute !root sudo %s @@ -53,7 +54,7 @@ =item F (C<%common> extensions) -This is the B Bourne-Shell script providing a set of reusable +This is the B Bourne shell script providing a set of reusable functions. It is installed at B bootstrap time and used read-only. @@ -85,7 +86,7 @@ This is the B configuration script where the administrator overrides the variables from the script's C<%config> sections. It it generated (as an empty file) on B bootstrap time and manually -edited later to influence the behaviours of the package's run-command +edited later to influence the behaviours of the package's runcommand scripts (here F). foo_enable=yes @@ -93,7 +94,7 @@ =item F -This is the example run-command script of an B package C. +This is the example runcommand script of an B package C. It is installed by package C and used read-only. #!/cw/etc/rc