While I don't know what "rc" really stands for (I've been assuming it means resource configuration, but that's just a WAG), I have roughly followed the UNIX conventions; the main difference is that continuation lines are indicated not by leading whitespace but by starting with a backslash. This allows whitespace to be used as a human visual aid.
This is the configuration file for SLAC Announcements.
Recent Announcements
- Recent Period
- indicates how far back in time announcements are considered recent. The value consists of three items: a minus sign, a number, and a letter. The letter is 'd' for days, 'm' for months, or 'y' for years; the number is for how many of these time units to span.
- Recent from First
- indicates whether the earliest recent month should begin on the first day of the month.
Web page date display formats
- Subhead Date Format
- specifies the date format for the month headings in the Recent section of the Announcements page.
- Appearance Date Format
- specifies the date format for the appearance date prefix on each list item.
- Update Date Format
- specifies the date format for the date the Announcements page was last refreshed by the compose script.
Files and Directories
- Log File
- Approved announcement submissions are logged to this file for auditing purposes.
- Database File
- Announcement data is stored here for HTML generation.
- SSI Two
- bbrows.ssi -- being phased out in favor of ann-current.ssi.
- SSI Welcome
- Not used?.
- SSI Current
- Current announcements. Supersedes bbrows.ssi.
- SSI Recent
- Recent announcements.
- SSI Update
- Date/time the SSIs were last refreshed from the database.
- SSI Update By
- Contains name of script which refreshed the files.
- Review File
- Contains CR-delimited list of email addresses; first line is reviewer.
- Review Directory
- The Review File's location.
Email Addresses
- Review List
- Addresses on this list receive a copy of the announcement submission.
- Action List
- This address (including rye) acts upon the approved submission.
- Mailing List
- When an announcement is approved, email is sent to this address. Leave blank to disable.
- Script Errors To
- (reserved for future use)
This is the configuration file for SLAC Conferences.
Recent Conferences
- Recent Period
- indicates how far back in time conferences are considered recent. The value consists of three items: a minus sign, a number, and a letter. The letter is 'd' for days, 'm' for months, or 'y' for years; the number is for how many of these time units to span.
- Recent from First
- indicates whether the earliest recent month should begin on the first day of the month.
Web page date display formats
- Subhead Date Format
- specifies the date format for the month headings in the Recent section of the Conferences page.
- Appearance Date Format
- specifies the date format for the appearance date prefix on each list item.
- Update Date Format
- specifies the date format for the date the Conferences page was last refreshed by the compose script.
Files and Directories
- Log File
- Approved conference submissions are logged to this file for auditing purposes.
- Database File
- Conference data is stored here for HTML generation.
- SSI Welcome
- Current and Upcoming conferences.
- SSI Current
- Current conferences.
- SSI Upcoming
- Upcoming conferences.
- SSI Recent
- Recent conferences.
- SSI Update
- Date/time the SSIs were last refreshed from the database.
- SSI Update By
- Contains name of script which refreshed the files.
- Review File
- Contains CR-delimited list of email addresses; first line is reviewer.
- Review Directory
- The Review File's location.
Email Addresses
- Review List
- Addresses on this list receive a copy of the announcement submission.
- Action List
- This address (including rye) acts upon the approved submission.
- Mailing List
- When an announcement is approved, email is sent to this address. Leave blank to disable.
- Script Errors To
- (reserved for future use)
This is the configuration file for SLAC Classified Ads.
Web page date display formats
- Update Date Format
- the date format for the date the Classified Ads page was last refreshed by the compose script.
Ad Run Period
- Run Days
- Number of days an ad remains posted.
HTML Options
- Ad Category Prefix
- HTML code before the ad category name.
- Ad Category Suffix
- HTML code after the ad category name.
- Ad Copy Prefix
- HTML code before the ad copy.
- Ad Copy Suffix
- HTML code after the ad copy.
- No Ads CA
- HTML code when no ads are current, on the Classified Ads page.
- No Ads QN
- HTML code when no ads are current, on the QuickNews page.
Files and Directories
- Log File
- Approved classsified ad submissions are logged to this file for auditing purposes.
- Database File
- Classified ad data is stored here for HTML generation.
- SSI One
- ad.ssi.
- SSI Two
- ad-qn.ssi.
- SSI Update
- Date/time the SSIs were last refreshed from the database.
- SSI Update By
- Contains name of script which refreshed the files.
- Review File
- Contains CR-delimited list of email addresses; first line is reviewer.
- Review Directory
- The Review File's location.
Email Addresses
- Review List
- Addresses on this list receive a copy of the classsified ad submission.
- Action List
- This address (including rye) acts upon the approved submission.
- Mailing List
- When a classsified ad is approved, email is sent to this address. Leave blank to disable.
- Script Errors To
- (reserved for future use)
This file contains the search result messages for Announcement and Conference searches.
The placeholders ^0, ^1, and ^2 refer to variables in the annfind.pl script; placeholders ^3, ^4, and ^5 refer to keys 3, 4, and 5 in this rcfile. The rest of the keys are for each of the possible search results, and are used to build up the message presented to the user.
This file contains category codes/names used by xxxxxx.xx for Classified Ad display.
This file MUST be kept in sync with the category popup on the submission form, otherwise the compose script may generate incorrect or blank category names.
This file contains error messages and email messages used by catcher.pl for Announcement, Conference, and Classified Ad submissions.