🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

1 total messages Started by hokey Tue, 07 Oct 1986 11:40
Proposal: First Line Convention
#28
Author: hokey
Date: Tue, 07 Oct 1986 11:40
45 lines
1829 bytes
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
Thread Navigation

This is a paginated view of messages in the thread with full content displayed inline.

Messages are displayed in chronological order, with the original post highlighted in green.

Use pagination controls to navigate through all messages in large threads.

Back to All Threads