hokey@plus5.UUCP (10/07/86)
I propose the following format for the first line of a routine: *label* *ls* ; [*owner*] [ ; [ *date* ] [ ; [ *description* ] ] ] where: *label* ::= the name of the routine *owner* ::= [ *contact* ] [ [ *pgm* , ] ... *pgm* ] *date* ::= the date and optionally time of the last modification. Possible formats include: RFC822: a *date* or *date-time* ISO 2014, 3307, and 4031: YYYYMMDDhhmmss-hhmm or YYYYMMDDhhmmssZ (for UCT) *description* ::= A brief description of the routine. A fifth semicolon piece is often used for a copyright notice. *contact* ::= *route-addr* NOTE: see RFC822 for a description of *route-addr*. *quoted-string*s are not permitted. *pgm* ::= *name* The purpose of the first line is to provide identification of the routine and a maintenance contact. The *pgm* list is used to classify the "position" of the routine in the package/program heirarchy. *pgm*s are listed from left to right, as most- to least-significant. It is expected that other pertinent information, such as Author and Summary information, be placed in "offline" comments. Examples: MUP ;Costar,Maint,Monitor;19760207;Bring monitor UP XM ;<MailMan-Bugs@VA.GOV>VA,MailMan;;MailMan main menu driver; XMINI ;VA,MainMan,Init; Hokey