Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Posting-Version: version B 2.10.2 9/18/84; site watmath.UUCP
Path: utzoo!watmath!bstempleton
From: bstempleton@watmath.UUCP (Brad Templeton)
Newsgroups: net.sources,net.news
Subject: Posters to net.sources, PLEASE say what your programs do
Message-ID: <2056@watmath.UUCP>
Date: Sat, 2-Aug-86 17:47:11 EDT
Article-I.D.: watmath.2056
Posted: Sat Aug  2 17:47:11 1986
Date-Received: Sun, 3-Aug-86 03:34:05 EDT
Distribution: net
Organization: U of Waterloo, Ontario
Lines: 36
Xref: watmath net.sources:5380 net.news:5144

How can I communicate this message to posters in net.sources:

	When you post to net.sources, please include a one-page
	description of the program as the first thing in the file.

It seems that well over half the postings in net.sources are like this:

Subject: foo - part 1

#
# Here is foo - enjoy!
#
cat <<FOO >foo.c
/*
 * foo
 */

main(argc,argv) ..........
...........


Or they start with the makefile, or a header, or at best troff source
for the man page.  I hate having to read through the whole article
at 1200 baud to see what it is about.


So, at the start of a net.sources article, please always place a page that
says:

	1) What the program does
	2) Who it is for
	3) What machines & systems it should run under

And try and get as much as possible in the subject line.
-- 
Brad Templeton, Looking Glass Software, Waterloo, Ont. (519) 884-7473