home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / games / volume12 / intro11 < prev    next >
Internet Message Format  |  1991-01-03  |  12KB
  1. Path: uunet!zephyr.ens.tek.com!tekred!saab!billr
  2. From: billr@saab.CNA.TEK.COM (Bill Randle)
  3. Newsgroups: comp.sources.games
  4. Subject: v12INF1:  Introduction to comp.sources.games
  5. Message-ID: <6746@tekred.CNA.TEK.COM>
  6. Date: 20 Dec 90 23:14:13 GMT
  7. Sender: news@tekred.CNA.TEK.COM
  8. Lines: 265
  9. Approved: billr@saab.CNA.TEK.COM
  10.  
  11. Submitted-by: Bill Randle <billr@tekred.CNA.TEK.COM>
  12. Posting-number: Volume 12, Info 1
  13. Archive-name: intro11
  14.  
  15.  
  16. This is the first of several introductory messages about comp.sources.games:
  17.    *1. How to submit sources to comp.sources.games.
  18.     2. List of sources posted to this newsgroup arranged numerically
  19.     by volume/issue number.  It provides a listing of the
  20.     Volume/Issue, the Archive-name and the Subject for each
  21.     posting. [Part 1/2: vols 1-7]
  22.     3. List of sources posted to this newsgroup arranged numerically
  23.     by volume/issue number.  It provides a listing of the
  24.     Volume/Issue, the Archive-name and the Subject for each
  25.     posting. [Part 2/2: vols 8-11]
  26.     4. List of sources posted to this newsgroup arranged
  27.     alphabetically by name.  It provides a listing of the the
  28.     Archive-name, Volume/Issue, and the Subject for each posting.
  29.     [Part 1/2: a-o]
  30.     5. List of sources posted to this newsgroup arranged
  31.     alphabetically by name.  It provides a listing of the the
  32.     Archive-name, Volume/Issue, and the Subject for each posting.
  33.     [Part 2/2: p-z]
  34.     6. List of the patches that have been posted in c.s.g.
  35.     7. Index of sources in the games archive on saab.  (This
  36.     includes some games that have not been posted to the c.s.g.
  37.     newsgroup (e.g. X-windows games). [Part 1/2: a-s]
  38.     8. Index of sources in the games archive on saab.  (This
  39.     includes some games that have not been posted to the c.s.g.
  40.     newsgroup (e.g. X-windows games). [Part 2/2: t-z]
  41.     9. The list of archive sites and how to contact them.
  42.  
  43. There are *many* things covered in this posting -- each new topic is
  44. preceded by a Subject: line.  If you get bored reading a particular
  45. section, fast forward to the next Subject: line and read that one.
  46. Please don't submit sources without having read -everything- in this
  47. file (you'll be tested and graded later :-).
  48.  
  49. I am always looking for suggestions on how to improve the usefulness
  50. of the newsgroup.  Please do not hesitate to send suggestions to
  51. billr@saab.CNA.TEK.COM.
  52.  
  53. --------------------
  54. Subject:  The structure of comp.sources.games articles
  55.  
  56. Each posting in comp.sources.games is called an "issue"; there are roughly 100
  57. issues to a volume.  The division is arbitrary, and has varied in
  58. the past.  There are two types of articles in comp.sources.games; sources
  59. and "information postings."  They can be distinguished by the subject
  60. line:
  61.     Subject:  v03INF1:  Introduction to comp.sources.games
  62.  
  63. This first word in the title identifies this as the first info posting of
  64. volume three.  Similarly, the subject line shown below:
  65.  
  66.     Subject:  v01i060:  war - intergalactic simulation, Part01/40
  67.  
  68. identifies this as the 60th source article in Volume 1.  All sources are
  69. broken up into pieces.  This is done so that there could be a proper storage
  70. directory when patches are issued. This is part 1 of a 40 part posting. 
  71.  
  72. The first few lines of an article are auxiliary headers that look like this:
  73.  
  74.     Submitted-by: root@freeware.ATT.COM
  75.     Posting-number: Volume 7, Issue 82
  76.     Archive-name: monopoly/Part01
  77.     Environment: Unix
  78.  
  79. The "Submitted-by" is the author of the program.  IF YOU HAVE COMMENTS ABOUT
  80. THE SOURCES PUBLISHED IN COMP.SOURCES.GAMES, THIS IS THE PERSON TO CONTACT.
  81. When possible, this address is in domain form, otherwise it is a UUCP bang
  82. path relative to some major site such as "uunet."
  83.  
  84. The second line repeats the volume/issue information for the aide of NOTES
  85. sites and automatic archiving programs.
  86.  
  87. The Archive-name is the "official" name of this source in the archive.  Large
  88. postings will have names that look like this:
  89.  
  90.     Archive-name: zork/Part01
  91.  
  92. Please try to use this name when requesting that sources be mailed to you.
  93. Also, note that the "part number" given in the title, and the archive name
  94. given in the auxiliary header need not be identical.
  95.  
  96. The Environment is a few key words describing the operating environment
  97. required by the program. Typical keywords are: Unix, MS-DOS, VMS, X11,
  98. SunView, Curses, etc.
  99.  
  100. -----------------
  101. Subject: Patches Handling
  102.  
  103. Patches will be handled as swiftly as possible. Authors of sources posted
  104. to c.s.g should send all patches to me so that I can post them back through
  105. the newsgroup in order that the patches can be archived. This has not been
  106. done in the past in other sources groups and has lead to lost patches. If
  107. the patches must get out *real* fast, post them to comp.sources.games.bugs
  108. and send me a copy at the same time so that they will be available when
  109. they are needed in the future.
  110.  
  111. To support the tracking of patches, the Patch-To: line is used in c.s.g.
  112. The Patch-To: line exists for articles that are patches to previously posted 
  113. software. The Patch-To: line only appears in articles that are posted, 
  114. "Official", patches. The initial postings would not contain the Patch-To: 
  115. auxiliary header line.
  116.  
  117. Patch-To: syntax
  118.     Patch-To: package-name: Volume X, Issue x[-y,z]
  119.  
  120. Patch-To: examples. These are examples and do not reflect the
  121. accurate volume/issue numbering for rkive.
  122.  
  123. In the first example, the article that contains the following line
  124. is a patch to a single part posting.
  125.     Patch-To: rkive: Volume 22, Issue 122
  126.  
  127. This example shows that the 122-124 indicates the patch applies to
  128. a multi-part posting. The '-' is used to mean "article A through article
  129. B, inclusive..
  130.     Patch-To: rkive: Volume 22, Issue 122-124
  131.  
  132. If a patch applies to multiple part postings that are not consecutive, the
  133. ',' is used to separate the part issue numbers. It is possible to mix both
  134. ',' and '-' on a single Patch-To: line.
  135.     Patch-To: rkive: Volume 22, Issue 122,125,126,127
  136.     Patch-To: rkive: Volume 22, Issue 122,125-127
  137.  
  138. If a new release is posted instead of a large set of patches, then the
  139. posting will ontain a Supercedes: header line with a format similar to
  140. the Patch-To: header.
  141.  
  142. Supercedes: syntax
  143.     Supercedes: package-name: Volume X, Issue x[-y,z]
  144.  
  145. Supercedes: examples
  146.     Supercedes: rkive: Volume 22, Issue 122-124
  147.     Supercedes: rkive: Volume 22, Issue 122-125,127
  148.  
  149. --------------------
  150. Subject: Reporting and tracking bugs.
  151.  
  152. You should subscribe to comp.sources.games.bugs.
  153.  
  154. Sometimes, when new versions of previously-published software is available,
  155. just patches are put out, usually in the form of shar files containing
  156. input for the "patch" program, new files, etc.  Sometimes complete new
  157. versions are put out.  Which method is used depends on the poster and
  158. the moderator.  Minor updates must be in patch form and update the 
  159. patchlevel.h file.  Major updates should be the guidelines for postings.
  160.  
  161. To report bugs, contact the person listed in the Submitted-by header.
  162. Often there is a contact address in a README file, too.  I do not maintain
  163. the sources I moderate, so don't send your bug reports to me.
  164. Likewise, I normally do not post patches for a package from anyone
  165. except the author. If you have patches you would like to see included
  166. in the package, send them to the person listed in the Submitted-by
  167. header. If the original author is incommunicado I will consider posting
  168. patches submitted by other people.
  169.  
  170. --------------------
  171. Subject: Submitting source for publication
  172.  
  173. Items intended for posting or queries and problem notes should be sent to
  174. games@saab.CNA.TEK.COM
  175.  
  176. If you want verification of arrival, say so in a cover note, or at the
  177. beginning of your submission, if it is small.  I try to verify that a
  178. program works, and if I can't get it to work, I may hold up posting it
  179. for a couple of days.  Please note that, except in rare cases, source
  180. that doesn't meet the guidelines will not be published.  The backlog
  181. from receipt to posting varies from one to three weeks depending mostly
  182. on the set of submissions currently in my queue and my current work load.
  183.  
  184. -------------------
  185. Subject: Guidelines
  186.  
  187. To make life easier for both myself and the users of the comp.sources.games
  188. newsgroup, I request that all submissions follow the following guidelines.
  189.  
  190. Initial Submissions:
  191.     1.  Source filenames need to be 12 or fewer characters in length.
  192.     2.  Source files need to be less than 50K bytes in size.
  193.     3.  A Makefile is highly desirable. 
  194.     4.  A manual page is desirable.
  195.     5.  A README file is required. This should contain a brief
  196.         description of what the posting is and any special
  197.         considerations in building it. The README should
  198.         also contain a list of authors and the distribution
  199.         and copying policy. 
  200.  
  201. Updates, patches, etc.:
  202.     It is up to the author to determine if there have been major enough
  203.     changes to warrant a complete reposting. This may be necessary if the
  204.     size of the patches exceeds the size of the source, but in most cases
  205.     only patches are posted. Total repostings should be treated as an 
  206.     initial posting. What follows pertains to patches...
  207.  
  208.     1.  When patches are submitted, they should be in context diff 
  209.         format.
  210.     2.  A patch to patchlevel.h should be done to reflect that the
  211.         patch has been applied.
  212.     3.  Include information about which previously posted issues 
  213.         the patch pertains to if they were initially posted to c.s.g.
  214.  
  215.     The patch program is currently at version 2.0 patchlevel 12, and may
  216.     be obtained via anonymous ftp from jpl-devvax.jpl.nasa.gov.  The
  217.     original 2.0 distribution and the first 11 patches are in the
  218.     comp.sources.unix archives on uunet.  The exact patchlevel is
  219.     probably not important for applying most patches, but you should
  220.     have some variety of 2.0, as it supports features like creating new
  221.     files and adding/subtracting lines with only one copy of the context,
  222.     as are created by recent varieties of diff.
  223.  
  224.     Patches can be made with diff -c on many machines and
  225.     with diffc on others. Diffc can be found in volume 1 of comp.sources.unix
  226.     archives. GNU diff can also be used to create context diffs.
  227.  
  228. ------------------------
  229. Subject: Becoming an archive site
  230.  
  231. If you collect comp.sources.games postings and are willing and able to make
  232. your collection available to other people, please let me know.  Benefits
  233. include the undying gratitude of your colleagues, and a promise from me to
  234. try to make sure you never lose an article.  
  235.  
  236. --------------------
  237. Subject: Accessing the archives
  238.  
  239. The complete archives are fairly large; an average volume is three to
  240. four megabytes.
  241.  
  242. There are several active archive sites around the net, but more are always
  243. welcome - especially outside the US.
  244.  
  245. Some sites below will send tapes through the mail.  For those sites, send
  246. a 1/2" mag tape WITH RETURN POSTAGE and RETURN MAILER.  Tapes without
  247. postage or mailer will not be returned.  No other methods (COD, etc.) are
  248. available; please don't ask. Other sites may make 1/4" mag tapes, 8mm
  249. mag tapes or floppy disks. It doesn't hurt to ask.
  250.  
  251. --------------------
  252. Subject: Editorial comments
  253.  
  254. I generally accept any game (or entertaining diversion) software without
  255. regard to host architecture or operating system. There are some exceptions,
  256. as there are specific newsgroups for many architectures. Thus if your
  257. game is IBM PC specific or Mac or Atari only, it is generally better
  258. to post it in the comp.sources.<favorite architecture> newsgroup (if
  259. it exists). The other exception is games that are specific to the
  260. X-Windows windowing system. They should be generally posted to the
  261. comp.sources.x newsgroup. If the moderator will not accept it for
  262. posting there, send it to me. Games that utilize more than one display
  263. system, e.g. X11 and SunView should be sent to me. Although there is
  264. a comp.sources.sun newsgroup, SunView based games have historically
  265. been posted in the comp.sources.games newsgroup.
  266.  
  267.  
  268.     "Top 6 pet peeves of the comp.sources.games moderator."
  269.  
  270. 1.   Programs that don't compile right the first time.
  271. 2.   Programs that don't execute right the first time.
  272. 3.   Patches that don't apply correctly.
  273. 4.   Individual source files larger than ~50K bytes.
  274. 5.   Submissions that do not contain a README or Makefile file.
  275. 6.   Submissions that do not contain a man page.
  276.