home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume28 / intro28 < prev    next >
Text File  |  1992-02-01  |  48KB  |  1,009 lines
  1. Newsgroups: comp.sources.misc
  2. From: kent@sparky.imd.sterling.com (Kent Landfield)
  3. Subject:  v28INF1:  Introduction to comp.sources.misc
  4. Message-ID: <1992Jan31.231657.18560@sparky.imd.sterling.com>
  5. X-Md4-Signature: efcc51e5036f8a533bb02cc4bae247f3
  6. Date: Fri, 31 Jan 1992 23:16:57 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: kent@sparky.imd.sterling.com (Kent Landfield)
  10. Posting-number: Volume 28, Info 1
  11. Archive-name: intro28
  12. Last-modified: 31-Jan-1992
  13.  
  14. I have received a couple of requests to add a header indicating when the 
  15. INFormational postings were last modified.   The Last-modified: header
  16. should make it easier for you to determine if the information has 
  17. changed since the last time it came through your spool directory...
  18.  
  19. This is the first of six introductory messages about comp.sources.misc.
  20. It describes the newsgroup's history, how to submit sources to c.s.misc, 
  21. where the archive sites are, and how to contact and access them.  The
  22. second, third, fourth and fifth postings together comprise the index of 
  23. previously posted software. The sixth article is a cross-index of patches 
  24. that have been posted to this newsgroup.
  25.  
  26. As always, I am looking for suggestions on how to improve the usefulness
  27. of the newsgroup.  *Please* do not hesitate to send suggestions to
  28. kent@sparky.imd.sterling.com.
  29.  
  30.             -Kent+
  31. --------------------
  32. Subject:  Introduction
  33.  
  34. Comp.sources.misc is sort of a "catch-all" sources group.  The group 
  35. is run in a generally informal manner.  *Any* program source code will
  36. be accepted. Discussion and "sources wanted" requests will be discarded 
  37. with a message back to the sender advising him/her to post to the correct 
  38. newsgroup.  Please do not send either to me, they don't belong here.
  39.  
  40. The moderated comp.sources.misc replaced the unmoderated net.sources in 
  41. May 1987.  This was done by the Usenet backbone in response to the observed 
  42. fact that net.sources was largely NON-sources. The initial moderator of 
  43. comp.sources.misc was Brandon Allbery.  Mail Brandon received at the time 
  44. indicated that the majority of people were willing to trade the small 
  45. delays (mainly caused by network delays in mail) for having a source 
  46. group that wasn't full of noise.
  47.  
  48. As stated above, the only reason a submission will be rejected is if it is 
  49. non-source.  I am striving to get things out as quickly as possible. Testing
  50. of the source is not done. I will, however, assure that postings are in shar 
  51. format and that shar'ed submissions can be unshar'ed correctly. If a patch
  52. is submitted, I assure that the patch can be applied to the sources it is to
  53. patch. If the submission is something that needs testing, it probably should 
  54. be sent to comp.sources.unix or comp.sources.reviewed instead.
  55.  
  56. (Send submissions to unix-sources-moderator@pa.dec.com or
  57.                   to csr@calvin.doc.ca in that case.) 
  58.  
  59. --------------------
  60. Subject: Deciding where to post your software
  61.  
  62. There are four choices for sources newsgroups, not counting local sources
  63. groups (fl.sources) or groups for specific systems (comp.sys.sun, et al.).
  64. Choosing between them can be somewhat difficult for the novice, and even for
  65. seasoned sources posters with unusual submissions.  Here, then, is a
  66. discussion of the various "primary" sources groups, their advantages and
  67. disadvantages, and a crude attempt at quantifying when to use them.
  68.  
  69. First off is comp.sources.unix, the major sources group.  It is rather
  70. unfortunately named, but don't let that stop you from trying to submit
  71. something if it fits the group's guidelines otherwise.  The benefits you'll
  72. get are testing of source on at least some machines before posting and
  73. guaranteed archiving at many Internet and UUCP sites.  The problem is that
  74. smaller postings aren't usually accepted, especially if they don't come with a
  75. Makefile and README file -- and sometimes the moderator declares a moratorium
  76. on certain types of postings, like text editors.  Trying doesn't hurt,
  77. however; if the moderator rejects something, he dumps it into the c.s.misc
  78. mailbox.  I should also note that the current policy of comp.sources.unix is
  79. not to accept "shareware" programs, programs which request or require a fee to
  80. the author for continued use. 
  81.  
  82. Second is comp.sources.reviewed. It is using a Peer Review process to accept 
  83. or reject submissions.  Similar to the process used for academic journals, 
  84. submissions are sent to a moderator who then sends the sources to Peer 
  85. Review volunteers for evaluation.  The Reviewers try to provide a timely 
  86. evaluation of the software by compiling and running it on their machine. 
  87. If the Moderator and Peer Reviewers judge a submission to be acceptable, 
  88. the sources are posted along with the written comments provided by the 
  89. Reviewers.  If a submission is not found to be acceptable, the author 
  90. is provided with the Reviewers' comments, and they have the option of 
  91. addressing those comments and submitting the sources again. The benefits 
  92. of this group are that your software will be thoroughly tested by multiple 
  93. reviewers on multiple systems prior to it being posted to the world.
  94.  
  95. For small sources and beta copies of programs (which probably should not be
  96. archived, in favor of the production release), one might choose alt.sources.
  97. It has one major advantage over the other possibilities:  there is no
  98. moderation, meaning no delays and no rules for formatting.  (It is suggested 
  99. that you add an "Archive-name:" to your postings so as to help out those who
  100. do archive the group.)  You're free to just pipe a source file to inews if the 
  101. fit takes you (not that I recommend it).  It also has one major disadvantage:  
  102. since the group isn't moderated, there is nothing preventing people from 
  103. starting up discussions ranging from source code topics to why EUnet works 
  104. the way it does.  This, if you'll recall, is what caused comp.sources.misc 
  105. to be created in the first place.  Another disadvantage is that, being an 
  106. "alt" group, it doesn't get as wide a distribution as the "mainstream" Usenet.
  107. (For further information on the "alt" hierarchy, see the "Alternative Newsgroup
  108. Hierarchies" document posted once a month by Gene Spafford in news.lists.)
  109.  
  110. And then there's this group, comp.sources.misc.  The original charter called
  111. for moderation solely to reject non-source postings, nothing more; the intent
  112. was to provide net.sources without the noise.  This grew as a policy was  
  113. adopted of letting the group be controlled more by its users (submitters, 
  114. readers, archivers) than by "moderative fiat".  The advantages of posting 
  115. here are that archiving is as widespread as that of comp.sources.unix, that
  116. anything that is source code can be posted, and that it's guaranteed not to
  117. be lost in non-source, discussion postings; the disadvantages are that there
  118. is a slight delay caused by having to filter stuff through the moderator.
  119.  
  120. So which do you choose?  While there are no hard rules, there does seem to be
  121. an evolving rationale for the use of the groups:  if your software is in need
  122. of beta-testing and it is not quite ready for mainstream archiving, post it to
  123. alt.sources.  After the beta period is over, submit it to the appropriate 
  124. comp.sources.whichever group for worldwide distribution and archiving.
  125.  
  126. In general, games usually are sent to comp.sources.games regardless of their 
  127. size.  Programs which are specific to a particular computer might be better 
  128. off in an specialized sources group like comp.sources.sun or comp.sources.amiga,
  129. and X-Window based applications can be posted through comp.sources.x.
  130. Released, major programs usually go to comp.sources.unix, and comp.sources.misc
  131. is used for the rest.
  132.  
  133. Remember though, it's up to you to decide to which newsgroup a your submission
  134. should be posted to.
  135.  
  136. --------------------
  137. Subject:  The structure of comp.sources.misc articles
  138.  
  139. Each posting in comp.sources.misc is called an "issue"; there are roughly 
  140. 100 issues to a volume.  The division is arbitrary, and has varied greatly 
  141. in the past.  There are two types of articles in comp.sources.misc; sources 
  142. and "informational postings."  They can be distinguished by the subject line.
  143.  
  144.     Subject:  v03INF1:  Introduction to comp.sources.misc
  145.  
  146. This first word in the title identifies this as the first info posting of
  147. volume three.  Similarly, the subject line shown below:
  148.  
  149.     Subject:  v014i082:  lc - Categorize and List Files In Columns, Part01/02
  150.  
  151. identifies this as the 82nd source article in Volume 14.  In the above 
  152. example, the Part01/02 indicates that this is the first part of a two
  153. part posting.  The first few lines of an article are auxiliary headers 
  154. that look like this:
  155.  
  156.     Submitted-by: kent@sparky.IMD.Sterling.COM (Kent Landfield)
  157.     Posting-number: Volume 14, Issue 82
  158.     Archive-name: lc/part01
  159.  
  160. The "Submitted-by" line in each issue is the author of the program.  IF YOU 
  161. HAVE COMMENTS ABOUT AN ISSUE PUBLISHED IN COMP.SOURCES.MISC, THIS IS THE PERSON
  162. TO CONTACT.  When possible, this address is in domain form, otherwise it is a 
  163. UUCP bang path relative to some major site such as "uunet."
  164.  
  165. The second line repeats the volume/issue information for the aide of NOTES
  166. sites and automatic archiving programs such as rkive.
  167.  
  168. The Archive-name is the "official" name of this source in the archive.  
  169.  
  170. All source postings will be treated as multi-part postings have been done
  171. in the past.  All source postings will be stored in a subdirectory within 
  172. the volume directory.  This gives me a place to store patches as well as 
  173. allows me to have more informative archive names without having to worry 
  174. how many spaces the part numbering, patch indicator or compression suffix 
  175. will take up.  Postings will have names that look like this:
  176.  
  177.     Source posting
  178.         Archive-name: lc/part01
  179.  
  180.     Patch posting
  181.         Archive-name: lc/patch01
  182.  
  183. Note that the part number and patch number will be zero padded for convenience 
  184. sake as was requested by several people.  Also, note that the "part number" 
  185. given in the title will be used to give the reader an indication of the total
  186. number of parts that make up the complete set of sources. The example below
  187. shows that this is part 21 of a 23 part submission.
  188.  
  189. v17i102: calentool - day/week/month/year-at-a-glance SunView tool, Part21/23
  190.  
  191. Informational (INF) postings such as this posting will not be stored in a 
  192. subdirectory as are the source postings. INF postings will have archive 
  193. names such as indx22v1-7 and patchlog22.  From an archiving perspective, 
  194. archive names for all INFormational postings will be specified so as to 
  195. store the INF postings directly in the volume's base directory.  Archive 
  196. names for source postings will be specified so as to store the sources in
  197. subdirectories within the volume's base directory.
  198.  
  199. To support the tracking of patches the Patch-To: line is used in c.s.misc.
  200. The Patch-To: line exists for articles that are patches to previously posted 
  201. software. The Patch-To: line only appears in articles that are posted, 
  202. "Official", patches. The initial postings do not contain the Patch-To: 
  203. auxiliary header line.
  204.  
  205.     Patch-To: syntax
  206.         Patch-To: package-name: Volume X, Issue x[-y,z]
  207.  
  208. Patch-To: examples. These are examples and do not reflect the accurate 
  209. volume/issue numbering for rkive.
  210.  
  211. In the first example, the article that contains the following line
  212. is a patch to a single part posting.
  213.     Patch-To: rkive: Volume 22, Issue 122
  214.  
  215. This example shows that the 122-124 indicates the patch applies to
  216. a multi-part posting. The '-' is used to mean "article A through article
  217. B, inclusive..
  218.     Patch-To: rkive: Volume 22, Issue 122-124
  219.  
  220. If a patch applies to multiple part postings that are not consecutive, the
  221. ',' is used to separate the part issue numbers. It is possible to mix both
  222. ',' and '-' on a single Patch-To: line.
  223.     Patch-To: rkive: Volume 22, Issue 122,125,126,127
  224.                        or
  225.     Patch-To: rkive: Volume 22, Issue 122,125-127
  226.  
  227. If a new release is posted instead of a large set of patches, the new 
  228. posting will contain a Supersedes: header line with a format similar 
  229. to the Patch-To: header.
  230.  
  231.     Supersedes: syntax
  232.         Supersedes: package-name: Volume X, Issue x[-y,z]
  233.     
  234.     Supersedes: example
  235.         Supersedes: rkive: Volume 22, Issue 122-127
  236.  
  237. The Supersedes: line is helpful for cleaning archives by providing a pointer 
  238. to previous versions that the archive administrators can then remove from 
  239. their archives.
  240.  
  241. The Environment: auxiliary header line is included to give you a quick 
  242. indication which resources are required to use a particular issue. 
  243.  
  244. In a newsgroup not restricted to one type of operating system, one type of 
  245. machine or one type of architecture there is a need for this type of information
  246. in the header.  The intent is to provide you more external information about 
  247. the package contained within the posting.  This allows you to determine if the 
  248. package has special requirements that may prevent you from using it.  It is 
  249. extremely irritating to take the time to unpack something just to find out 
  250. that you can't use it.
  251.  
  252. The news Keyword: line has been used to a certain extent for this,
  253. but if news articles are saved with 'w' rather than 's' from "rn"
  254. then the news headers don't get saved with the article.
  255.  
  256.     Environment: syntax
  257.         Environment: Keyword [, keyword ..] 
  258.  
  259.     Environment: example
  260.         Environment: SunView, XView, X11R4, termcap
  261.  
  262. The keywords usage is case insensitive. There is also a NOT indicator
  263. (e.g. !AIX) so that the moderator can specify that the package runs 
  264. on everything "but" the specified keyword.
  265.  
  266. The following is a list of keywords used within articles that have been
  267. posted to c.s.misc and their meanings.  Keywords are added to this list 
  268. on a first-use basis.
  269.  
  270.     Operating Systems:
  271.         AIX       - should operate on any AIX 
  272.         AIX3.1    - should operate on AIX Version 3.1
  273.         AMIGA     - should operate on AMIGA OS
  274.         ATARI     - should operate on an Atari ST
  275.         BSD       - should operate on any BSD based unix
  276.         CPM-68K   - should operate on CPM based 68000 
  277.         COHERENT  - should operate on Mark Williams Coherent OS
  278.         DOS       - should operate on DOS (oops)
  279.         ISC-UNIX  - should operate on ISC UNIX
  280.         ISC       - should operate on ISC UNIX (oops)
  281.         MS-DOS    - should operate on MSDOS 
  282.         OS/2      - should operate on IBM's OS/2
  283.         OSF/1     - should operate on OSF/1
  284.     SCO       - should operate on SCO UNIX
  285.     SCOXENIX  - should operate on SCO XENIX
  286.         SUNOS     - should operate on SUNOS
  287.         SYSV      - should operate on System 5
  288.         SYSV/386  - should operate on a 386 running System 5
  289.         SYSVR2    - should operate on System 5.2
  290.         SYSVR3    - should operate on System 5.3
  291.         SYSVR4    - should operate on System 5.4
  292.         VMS       - should operate on VMS
  293.         UNIX      - should operate on any unix system... (right...)
  294.         ULTRIX    - should operate on Ultrix
  295.         XENIX     - should operate on XENIX OSs
  296.  
  297.     Language Support:  (C is the default so not specified)
  298.  
  299.         ANSI-C    - Requires ANSI compatible C compiler
  300.         AWK       - pattern scanning and processing language
  301.         C++       - Requires C++ Programming language
  302.         Flex      - fast lexical analyzer generator
  303.         Fortran   - Written in Fortran
  304.         Icon      - Written in the Icon Programming Language
  305.     INET      - Requires BSD networking support
  306.         LaTex     - Requires the LaTex support
  307.         MIPS      - Mips C compiler
  308.         Pascal    - Requires a pascal compiler
  309.         Perl      - Practical Extraction and Report Language
  310.         Pro*C     - Requires Oracle Pro*C compiler
  311.         TurboC    - Requires Turbo C
  312.  
  313.     Windowing Support:  
  314.  
  315.         Curses    - Requires the curses library
  316.         Sunview   - Requires the Xview library
  317.         Xlib      - Requires the X Windows library
  318.         Xview     - Requires the Xview library
  319.         X11R4     - Requires the X Window System Release 4
  320.  
  321.     System Support:  System Utilities needed
  322.  
  323.         Cnews     - USENET network news 
  324.         Csh       - The C-Shell command interpreter
  325.         C-shell   - The C-Shell command interpreter (oops)
  326.         DBX       - BSD based source-level debugger
  327.     Emacs     - GNU Emacs 
  328.         getopt    - parse command options in shell scripts
  329.         MMDF      - MMDF mail transport
  330.         Oracle    - Oracle Database
  331.         pathalias - mail routing tool
  332.         Sendmail  - BSD based mail transport
  333.     Smail     - Smail3 mail transport 
  334.     tput      - Initialize a terminal or query the terminfo database
  335.  
  336.     Functionality Support:  System supported functionality
  337.  
  338.     symlink   - System supports symbolic links
  339.     INET      - Requires BSD based networking facilities
  340.  
  341.     Hardware Tested on:
  342.  
  343.         SGI       - Runs on Silicon Graphics systems
  344.         DEC       - Runs on DEC Risc Workstations
  345.     Cray2     - Runs on a Cray2 supercomputer with UniCos
  346.     Alliant   - Runs on Alliant minisupercomputers
  347.     Convex    - Runs on Convex minisupercomputers
  348.     Amdahl    - Runs on Amdahl mainframes
  349.     Sun       - Runs on Sun Microsystems Workstations
  350.     Mac       - Runs on Mac
  351.     PC        - Runs on PCs or PC compatibles running DOS
  352.     MIDI      - You will need a MIDI to run this.
  353.         HPLJ      - HP Laserjet II or III printer or compatible
  354.         CDROM     - Requires a cdrom player.
  355.  
  356.     General Notes:
  357.     !16BIT   - Don't try to to run on a 16 bit machine (8088,186,286)
  358.     32BIT    - Requires 32 Bit Architecture
  359.  
  360. As you can probably see from my mounting mistakes, I have not yet automated
  361. [dummy-proofed :-)] the process of keyword selection within my posting 
  362. software. Its coming... It really is. :-)
  363.  
  364. Prior to January 1, 1988, a different archive header system was used.  At the
  365. time, it was not expected that comp.sources.misc would be welded into the
  366. then-evolving standard for sources archiving.  There was only one special 
  367. header line, and it resided in the main header.  It looked like
  368.  
  369.         X-Archive: yymm/nn
  370.  
  371. where "yymm" was the year and month of the submission date and "nn" was 
  372. a sequence number.  Please keep this in mind when dealing with archive 
  373. submissions from 1987.
  374.  
  375. --------------------
  376. Subject: Guidelines for submitting source for publication
  377.  
  378. Items intended for posting and problem notes should be sent to
  379. "sources-misc@uunet.uu.net" or to "sources-misc@sparky.imd.sterling.com".
  380.  
  381. Newsgroup-related mail that is *not* a submission should be sent to me at
  382.     sources-misc-request@uunet.uu.net 
  383.             or
  384.     sources-misc-request@sparky.imd.sterling.com.
  385.  
  386. I have changed my policy of notification when sources are submitted
  387. to comp.sources.misc.  In the past I have not notified everyone that
  388. their submissions were received.  This has caused some problems that
  389. could have been avoided if both parties knew how to deal with the other.
  390.  
  391. When you submit a package to comp.sources.misc I will respond letting you 
  392. know that I have received it.  If you do not hear from me in 72 hours, 
  393. there may be a problem!  I hope that by making everyone aware of this
  394. new policy, the newsgroup will get a better throughput as authors aren't
  395. waiting for me to respond when I do not know to respond... 
  396.  
  397. To make life easier for both myself and the users of the comp.sources.misc
  398. newsgroup, I request that all submissions follow the following guidelines.
  399. Not following these guidelines may result in longer delays, since some things
  400. *must* be fixed for news to accept the submission, and others fixed so that 
  401. I can spend time processing submissions rather than responding to flames.  ;-)
  402.  
  403. First, uuencoded postings are heavily frowned upon.  If at all possible, 
  404. binary data files should be translated to an ASCII format that is usable 
  405. by others.  If it's not possible, consider sending the machine-dependent 
  406. parts of the posting to another newsgroup.  If all else fails, it will be 
  407. accepted if it is not the only component of the submission; otherwise, it 
  408. may be better to announce the availability of the item via anonymous FTP, 
  409. UUCP, FTAM, etc.
  410.  
  411. A corollary of the above rule is that uuencoded (ABEd, btoa'd, BinHexed, ...)
  412. compressed (packed, ...) archives are not acceptable regardless of the
  413. compression and/or archiving method used.  Not everyone has ARC, PKZIP, ZOO,
  414. StuffIt, or even cpio or tar and the "compress" program.
  415.  
  416. The second rule is that "shell archives" as created by "shar", "cshar",
  417. "bundle", etc. be used to package files.  Preferably, use cshar:  it guards
  418. against mangling by older news programs, Bitnet mailers, etc.  I must repack
  419. non-shar'ed submissions so that they have a better chance of surviving older
  420. mail/news systems and inter-network gateways. 
  421.  
  422. Third, *please* send me a Subject: to be used in posting your submission.
  423. Certain large postings in the past have arrived sans Subject:.  Not only does
  424. this force me to make one up for the archive list, but you have to live with 
  425. what I make up... :-)
  426.  
  427. Fourth, *please* send me an archive-name or package name that you want the
  428. submission archived by.  If you do not send me one then I get to name your
  429. sources in the archives...   Do you see a pattern forming here... :-)
  430.  
  431. Fifth, I need Environment: header information.  If your submission has 
  432. limitations, such as it does not run on SYSV or limited to a specific 
  433. version of SUNOS, or whatever the conditions, *PLEASE* inform me so that 
  434. it can be included in the Environment: header line.  This way people who 
  435. are not able to run your submission will not take the time to ftp or unpack 
  436. it.  I will try to determine the Environment: information if you do not
  437. supply any but if you want it right...
  438.  
  439. If the submission is a complete reposting of a previous posted package,
  440. let me know that the posting is superseding your previous submission.
  441.  
  442. Each of the postings should contain a "blurb" that describes what the posting
  443. is/does/contains. This should only be a paragraph or two.  When you submit
  444. your sources, please include the blurb on the first part. If you do not write
  445. it yourself, I will have to grab it out of the submission somewhere.
  446.  
  447. Please do not package executable programs and sources in the same
  448. submission.  Executable binary programs are inherently system-dependent, and
  449. therefore should be posted to a system-specific "binaries" group.  And, as a
  450. special case, Un*x executables should NEVER be posted to the Usenet.
  451.  
  452. Please keep source filenames to 12 or fewer characters in length.
  453. Not everyone has long filenames... :-(
  454.  
  455. I have been receiving a number of messages with uucp addresses that are not
  456. reachable.  Please specify a domain based address if possible. If you do not 
  457. know what your domain based address is, please ask the administrator of your
  458. site or that of your upstream news feed.  
  459.  
  460. Other nice things to consider/supply when submitting sources...
  461.    1.  A Makefile.
  462.    2.  A manual page is highly recommended for any substantial sized
  463.        submissions.
  464.    3.  A README file is also highly desirable. This should contain 
  465.        a brief description of what the posting is and any special
  466.        considerations in building it. The README should
  467.        also contain a list of authors and the distribution
  468.        and copying policy. 
  469.    4.  A patchlevel.h -- This file can be used to keep track 
  470.        of how many official patches have been applied.  
  471.  
  472. Other considerations:
  473.  
  474. The posting software I use reads the submission and prompts me for all 
  475. the information needed to post. It uses information in the header supplied 
  476. by you as the default information.  The Subject: line is usually munged.  
  477. The auxiliary headers supplied in the submission are used where appropriate. 
  478.  
  479. The following headers are passed through the software untouched.  
  480.  
  481.         Keywords:, Organization:, Reply-To: and Summary:
  482.  
  483. If you supplied them, they are put into the posted article.
  484.  
  485. Again, Please let me know what should go in the Environment: line.  If you 
  486. don't take the time to do that I have to try to determine what is accurate.  
  487. Sometimes that's hard to do without full blown testing.  Archive-name:, 
  488. Subject:, and Environment: are the three pieces of information that I really 
  489. need.  Otherwise I get to make up what is supplied there.  Don't complain to 
  490. me if I get it wrong and you didn't take the time to send me the correct info
  491. in the first place... If you did send me the information and I got it wrong,
  492. give it to me with both barrels...
  493.  
  494. -----------------
  495. Subject: Patches Handling
  496.  
  497. Patches will be handled as swiftly as possible. Authors of sources posted
  498. to c.s.misc should send all patches to me so that I can post them back through
  499. the newsgroup in order that the patches can be archived. This has not been
  500. done in the past in other sources groups and has lead to lost patches. If
  501. the patches must get out *real* fast, post them to comp.sources.bugs and
  502. send me a copy at the same time so that they will be available when they
  503. are needed in the future. Again, patches will receive priority processing
  504. so make sure I get them...
  505.  
  506. I would prefer not to post patches that are not sent by the author of the
  507. original posting unless special arrangements have been made with the author.
  508. Please send your unofficial patches to the author so that the author can
  509. incorporate them into their postings baseline.  Unofficial patches can
  510. be posted to comp.sources.bugs as a method of letting the community use
  511. the fix or enhancement during the interim.
  512.  
  513. It is up to the author to determine if there have been major enough
  514. changes to warrant a complete reposting. This may be necessary if the
  515. size of the patches exceeds the size of the source but in most cases
  516. only patches are posted. Total repostings should be treated as an 
  517. initial posting. What follows pertains to patches...
  518.  
  519.     1.  When patches are submitted, they should be in context diff 
  520.         format.  Patches can be made with diff -c on 4.XBSD based 
  521.         machines and with diffc on others. Diffc can be found in 
  522.         volume 1 of comp.sources.unix archives. GNU diff can also be 
  523.         used to create context diffs.
  524.     2.  A patch to patchlevel.h should be done to reflect that the
  525.         patch has been applied if a patchlevel.h existed in the initial
  526.         posting. If one was not included initially, maybe now is a
  527.         good time to consider including one... :-)
  528.     3.  Include information about which previously posted issues 
  529.         the patch pertains to if they were initially posted to c.s.misc.
  530.  
  531. For more information on patch see patch.man in util/patch/patch.man 
  532. in the X11 Release 4 distribution or in volume7 of the comp.sources.unix
  533. archives. 
  534.  
  535. ------------------------
  536. Subject: Special services 
  537.  
  538. One way to solve the problem of an announcement not going out the same day as
  539. the posting it announces is to send the announcement to me under separate
  540. cover. Please, it slows things down if I have to break a submission apart to
  541. get at the file.  Please supply instructions as to where it should be posted, 
  542. and I will insure that both go out the same day, if possible.  (If one of the 
  543. other newsgroups is also moderated, there's not a whole lot I can do about it.)
  544. The same goes for binaries and/or other material associated with a source; send
  545. it under separate cover and tell me what to do with it, and I will try to
  546. arrange for them to all go out at the same time.
  547.  
  548. --------------------
  549. Subject: Reporting and tracking bugs.
  550.  
  551. You should subscribe to comp.sources.bugs.
  552.  
  553. Sometimes, when new versions of previously-published software is available,
  554. just patches are put out, usually in the form of shar files containing
  555. input for the "patch" program, new files, etc.  Sometimes complete new
  556. versions are put out.  Which method is used depends on the poster and
  557. the moderator.  Minor updates must be in patch form and should update the 
  558. patchlevel.h file.  Major updates should follow the guidelines for 
  559. initial postings.
  560.  
  561. To report bugs, contact the person listed in the Submitted-by: header.
  562. Often there is a contact address in a README file, too.  I *do not* maintain
  563. the sources I moderate, so don't send your bug reports to me.  That just
  564. forces a delay in the right person getting them as I will forward them on
  565. to the author.  Likewise, I normally do not post patches for a package from 
  566. anyone except the author. If you have patches you would like to see included
  567. in the package, send them to the person listed in the Submitted-by:
  568. header.
  569.  
  570. ------------------------
  571. Subject: Newsgroup Status Information.
  572.  
  573. You should subscribe to comp.sources.d.
  574.  
  575. In some newsgroups, postings such as "I will be out of town..." and
  576. "What's in the queue to post..." have been posted as INF postings with
  577. an Archive-name: of /dev/null or .junk.  I will not post these types of
  578. messages to c.s.misc due to the limited amount of time that information of
  579. this type is useful.  I will post these kinds of messages to comp.sources.d
  580. as the need arises.  In this manner, the informational c.s.d postings can 
  581. expire as they should and will not be archived taking up disk space forever.
  582.  
  583. --------------------
  584. Subject: Accessing the archives
  585.  
  586. The complete archives are fairly large; an average volume is four megabytes.
  587.  
  588. There are several active archive sites around the net.  I am currently
  589. trying to locate archive sites in Europe, and Asia.  If you are interested 
  590. *please* contact me.
  591.  
  592. Some sites below will send tapes through the mail.  For those sites, send
  593. the appropriate type of tape media WITH RETURN POSTAGE and RETURN MAILER.  
  594. Tapes without postage or mailer will not be returned.  No other methods 
  595. (COD, etc.) are available; please don't ask.  You will need to contact the
  596. individual archive sites to determine if they can support your type of media.
  597.  
  598. There a couple sites that provide email access to their archives. Please
  599. use them when you need to locate a missing issue. Please don't ask me for 
  600. missing issues, unless you are sure you are reporting a net-wide problem of
  601. propagation. At the end are detailed instructions on how to access
  602. the archives.  More sites will be listed there in the future.
  603.  
  604. I have access to archives here at Sterling. I do not have ftp or email
  605. archive access available at the present time.  Coming RSN...  I have as 
  606. complete a set of archives as I have found. I have all the issues listed in 
  607. the indexes except for the first volume. If you have articles from volume 1 
  608. please send me a list of articles so I can see if there are some I do not have.
  609.  
  610. If anyone has an article that was posted to the group that is not listed
  611. in the indexes, please send me the information and a copy of the article
  612. so that I can update the archive sites that I maintain.  Nothing from April 
  613. and May 1987 was ever archived to my knowledge. If I'm wrong, send them my
  614. way... I am willing to contribute a tape to a site on the internet that is 
  615. willing to make the archives available.  
  616.  
  617. Submissions prior to July, 1987 have no auxiliary header information at all.
  618. At the time, the group's original charter was in full force, and archiving 
  619. was not considered to be important.
  620.  
  621. **** Work-in-progress:
  622. ****
  623. ****  Volume 1 and 2 articles are currently being assigned auxiliary headers.
  624. ****  I am planning on making the corrected articles available to archive 
  625. ****  sites and anyone else who wish them when I have completed the task.
  626. ****  If you want to have me notify you when I am done, send me some mail.
  627.  
  628. --------------------
  629. Subject: Archive access via ftp
  630.  
  631. If an archive site provides "anonymous FTP" access, sites directly on the
  632. Internet (that is, sites possessing an IP address, which looks like four
  633. small numbers separated with periods) can use the "ftp" program to get at
  634. sources.  Sites which aren't on the Internet (more properly, the NSFnet) can
  635. not use ftp to retrieve this information.  And no, having the ftp program
  636. does not mean that you can access NSFnet:  there are many systems which use
  637. TCP/IP over local networks only, and at least one brand of system which has a
  638. program called "ftp" that has nothing to do with the Internet at all.
  639.  
  640. You should check with a local system administrator to find out the details of
  641. using ftp.  On most systems and to most archive sites, the following will
  642. work:  type the command "ftp system.domain" (example:  "ftp uunet.uu.net" --
  643. case does not matter), enter "anonymous" when it asks for a user name, and
  644. enter *your* Internet address for the password.  If "ftp" says that the
  645. system doesn't exist, check your spelling -- if the system name is spelled
  646. correctly, look for an IP address for the archive site and badger your system
  647. administrator to install a version of ftp which knows about nameservers.  You
  648. should also be warned that some systems (like uunet) will not accept FTP
  649. connections from sites not registered with a nameserver.
  650.  
  651. Once you are logged in to the archive system, you will get a prompt that
  652. looks like "ftp>".  (It may not be identical, since it is possible to change
  653. the ftp prompt with a command in many versions of ftp.)  At this point, you
  654. can use "cd" to change directories, "ls" or "dir" to list files, and "get" to
  655. retrieve them.  For sources archives, it is not necessary to worry about file
  656. types unless the files are compressed; in that case, you must use the
  657. "binary" command for Unix or VMS hosts and "tenex" on Tenex (TOPS-10, TENEX,
  658. TOPS-20/TWENEX) hosts.  *** Not switching the file type can result in a
  659. garbled file, especially on Tenex hosts, which do not store binary data the
  660. same way as Unix hosts. ***  To disconnect from the archive site, enter the
  661. "bye" command.
  662.  
  663. --------------------
  664. Subject: Archive access via uucp
  665.  
  666. UUCP archives aren't quite as standardized as FTP archives; check the archive
  667. list for the user name and password to use, and ask your system administrator
  668. to arrange to be able to poll the archive site.  (If s/he/it refuses, you are
  669. stuck.)  
  670.  
  671. The "uucp" command is used to request files from a UUCP archive.  Unlike FTP,
  672. UUCP does not (usually) do the transfer immediately; this is because most
  673. UUCP sites must be called over phone lines, so long-distance calls will
  674. usually be made in the early morning hours.
  675.  
  676. Since you can't look around in the archives, you must know the pathname of
  677. the article to be retrieved.  Most archives have an index file available via
  678. UUCP; check the archive list in the next posting.  It's a good idea to
  679. retrieve this file before getting anything from the archive, since things can
  680. move around without warning.
  681.  
  682. The command to retrieve a submission looks like
  683.  
  684.          uucp -r archivesite!path/to/file
  685.  
  686. "archivesite" is the name of the archive site, and "path/to/file" is the
  687. pathname listed in the archive index for that site.  Please be warned that
  688. for security reasons, it is not usually possible to specify wildcards (?, *,
  689. [], or ~name) in the pathname.  Also, while more recent versions of uucp
  690. allow a uucp command to traverse multiple systems (uucp -r
  691. systemA!systemB!file), for security reasons this is usually disabled.  In
  692. both cases you won't find out until after the archive site has been called.
  693.  
  694. --------------------
  695. Subject: Archive access via email 
  696.  
  697. Some archive sites have mail servers that will accept mail from you and mail
  698. back files from the archive.  There are no standards here; however, it's
  699. usually safe to mail a message containing the single word "help" to the mail
  700. server.  Check the archive list for more information.  
  701.  
  702. As an example, to receive the index from the comp.sources.misc archives on 
  703. uunet, send the following one line as the body of a message to uunet!netlib.
  704.  
  705. send index from comp.sources.misc
  706.  
  707. IMPORTANT TO REMEMBER: Mail Based Archive Servers (MBAS) are there for the
  708. convenience of the community and are *easily* abused. Please do not request to
  709. have a MBAS send you GCC or X11R4.  A good deal of this traffic goes through
  710. intermediate sites that have not advertised this service.  You would be
  711. taking resources away that are not yours to take...  This type of 
  712. irresponsibility will do nothing but irritate the sites that feed you and
  713. may jeopardize your facilities in the process...
  714.  
  715. --------------------
  716. Subject: Extracting a retrieved archive member
  717.  
  718. If the article came from an archive site, it may be compressed; if it was 
  719. sent by a mail server, it may also be uuencoded.  Compressed files have an 
  720. extension of ".Z".  Uuencoded files can be recognized by a line saying 
  721. "begin 666 filename", followed by lines of what looks like random gobbledygook.
  722. (If a mail server splits a file into multiple parts, you may just have the
  723. gobbledygook.  In this case, the server will include a message saying which
  724. part of the file it is, and will tell you how to combine them.)
  725.  
  726. To extract a uuencoded file, give the command "uudecode filename".  This will
  727. create a (binary, usually compressed) file in the current directory.
  728.  
  729. To extract a compressed file, give the command "uncompress filename".  The
  730. ".Z" extension will be removed from the file.  The original, compressed file
  731. will be removed as part of this operation.
  732.  
  733. After doing this, you should be left with a news article exactly as it is
  734. stored in the news spool directories.  This file will contain a news header,
  735. a description (usually), and a "shell archive" ("shar").  Move to an empty
  736. directory (important!) and unpack the archive.  Some systems have a command
  737. "unshar" to unpack these files; if yours does, use it.  Otherwise, you can
  738. use an editor to remove the header, then just say "sh filename".  I use a
  739. small (one line) shell script:
  740.  
  741.                         sed '1,/^[#:]/d' $1 | sh
  742.  
  743. which will handle anything (I hope!) in the comp.sources.misc archives.  I do
  744. attempt to confirm that a shell archive contains nothing dangerous, but if
  745. you unpack as root and the archive removes your /etc directory or something
  746. equally unpleasant, I don't want to hear about it.  Unpack shell archives as
  747. an unprivileged user.
  748.  
  749. Once you've unpacked the archive, you're on your own.  Keep the header from
  750. the submission handy, in case you can't figure out what's going on; the
  751. address in the "Submitted-by:" line can be used to contact the author of the
  752. program.
  753.  
  754. ------------------------
  755. Subject: Becoming an archive site
  756.  
  757. If you collect comp.sources.misc postings and are willing and able to make
  758. your collection available to other people, please let me know.  Benefits
  759. include the undying gratitude of your colleagues, and a promise from me to
  760. try to make sure you never lose an article whether you use rkive or not... :-)
  761.  
  762. I am currently looking for archive sites outside the US.  If you can provide 
  763. access to your archives send me some email and I will get you some publicity...
  764. :-)  If you need automated tools to build and maintain your archives, I have 
  765. those too .. :-) If you need a tape of the archives to get you jump-started, 
  766. let me know.
  767.  
  768. PLEASE NOTE: Mail Based Archive Servers (MBAS) are there for the convenience
  769. of the community but are too easily abused.  Because of this, I can not,
  770. in good conscience, list archive sites whose *sole* access is mail based.
  771. If you can't supply anonymous ftp as a secondary method for accessing your
  772. archives then consider uucp.  It is easy enough to set up a uucp account for 
  773. archive access with the appropriate security to protect your other system 
  774. resources.
  775.  
  776. --------------------
  777. Subject: Listing of archive sites in no particular order
  778.  
  779. Here is what each field means:
  780. Site:        The name of the site nice enough to act as an archive site.
  781. Contact:     The name of the person to contact and their mail address
  782. Location:    The general area of the world the site is located in.
  783. Modems:      For providing UUCP access, what types of modems are available.
  784. UUCP:        Type of UUCP access is available.
  785. FTP:         Type of FTP access is available.
  786. Mail Server: Account address of the automated mail server if available.
  787. Additional:  Additional information pertaining to accessing the archive.
  788.  
  789. NA - Not Available
  790.  
  791.             ************************
  792.                  U S A - EASTERN 
  793.             ************************
  794.  
  795. Site:         bhjat
  796. Contact:      Burt Janz (bhjat!bhj)
  797. Location:     Nashua, NH
  798. UUCP:         Anonymous uucp (login: nuucp  password: nuucp)
  799. Modems:       2400 Baud N81 - (603) 889-6154
  800. FTP:          N/A
  801. Mail Server:  Not yet available.
  802. Additional:   Index location: /usr5/archives/ls-lR.Z
  803.               Archiving c.s.games-misc-unix-x, alt.sources,
  804.               comp.sys.handhelds
  805.  
  806. Site:        schizo.samsung.com
  807. Contact:     Andy Rosen (rosen@samsung.com)
  808. Location:    Andover, MA
  809. Modems:      NA
  810. UUCP:        NA
  811. FTP:         Anonymous
  812. Mail Server: None
  813. Additional:  Files are stored by volume number, archive name and are
  814.              compressed.  Volumes 1 through 6 and 11 through 15 are present.
  815.              Examples:
  816.                /pub/usenet-archives/comp.sources.misc/volume15/fb/part01.Z
  817.                /pub/usenet-archives/comp.sources.misc/volume6/gone-2.0.Z
  818.  
  819.  
  820. Site:        slug.pws.bull.com [128.35.10.203]
  821. Contact:     Warren Lavallee <warren@pws.bull.com>
  822. Location:    Billerica, MA.  (NEARnet)
  823. Modems:      T2500
  824. UUCP:        NA
  825. FTP:         anonymous ftp 24 hours day.  limit 6 users at a time
  826. Mail Server: NA
  827. Additional:  Due to internal restructuring, this site may not be
  828.              accessible some times over the next month.
  829.              Carry FULL comp.sources.* archives (since the
  830.              beginning).  Usenet archives are currently taking 170M.
  831.  
  832.  
  833. Site:         uunet.uu.net 
  834. Contact:      Kent Landfield (kent@uunet.uu.net) (402) 291-8300
  835. Location:     Fairfax, VA 
  836. Modems:       Telebit 
  837. UUCP:         uunet uucp customers and 1-900-GOT-SRCS
  838. FTP:          anonymous ftp
  839. Mail server:  netlib@uunet
  840. Additional:   UUNET is keeping archives in ~ftp/comp.sources.misc, and 
  841.               I will be maintaining them.  Volume 1 as well as shareware 
  842.               which has been posted to the group are not available from
  843.               uunet.  Volume 1 will be put back up in the near future.  
  844.               In the mean time, if you need any of those issues please 
  845.               send me some mail and I will arrange to get them to you.  
  846.               For more information concerning the archives on uunet, send 
  847.               an email message netlib@uunet.uu.net with the following as 
  848.               the body of the message:
  849.             send index from comp.sources.misc
  850.               You can also use 1-900-GOT-SRCS to access this archive.
  851.  
  852.  
  853.             ************************
  854.                  U S A - CENTRAL 
  855.             ************************
  856.  
  857. Site:         sparky
  858. Contact:      Kent Landfield (kent@sparky.imd.sterling.com) (402) 291-8300
  859. Location:     Omaha/Bellevue, NE
  860. Modems:       Telebit 
  861. UUCP:         On request
  862. FTP:          NA
  863. Mail server:  NA
  864. Additional:   Tapes made on request
  865.  
  866.  
  867. Site:         sir-alan
  868. Contact:      mikes@iuvax.cs.indiana.edu (812-855-3974 days 812-333-6564 eves)
  869. Location:     Bloomington, IN
  870. Modems:       Telebit (812-333-0450)
  871. UUCP:         Anonymous uucp
  872. FTP:          Coming..
  873. Mail server:  NA
  874. Additional:   Archive site for comp.sources.[games,misc,sun,unix,x], 
  875.               some alt.sources, XENIX(68K/286/386)
  876.               uucp-anon: ogin: nuucp password: anon-uucp
  877.               uucp-anon directory: /u/pdsrc, /u/pubdir, /u/uunet, 
  878.               help in /u/pubdir/HELP 
  879.  
  880.  
  881. Site:         wuarchive.wustl.edu [128.252.135.4]
  882. Contact:      Wuarchive Maintainers <archives@wugate.wustl.edu>
  883. Location:     Saint Louis, Missouri.  Connected to MIDnet Regional.
  884. UUCP:         Subscription UUCP access available ($300.00/year flat fee)
  885. Modems:       Telebit Trailblazer Plus and T2500.
  886. FTP:          Anonymous FTP.  T1 connectivity - 24 hours/day, 7 days/week.
  887. Mail Server:  NA
  888. Additional:   Access during all hours is encouraged.  Plenty of available
  889.               bandwidth.  Wuarchive has everything! :-) :-)
  890.  
  891.  
  892.             ************************
  893.                  U S A - WESTERN 
  894.             ************************
  895.  
  896. Site:         aeras
  897. Contact:      Stewart Boutcher (stewart@aeras) (408) 922-1832
  898. Location:     San Jose, CA
  899. Modems:       2400, 9600 & 19200
  900. UUCP:         Anonymous 
  901. FTP:          NA
  902. Mail server:  NA
  903. Additional:   SnailMail tapes (Under duress)
  904.      Systems/L.sys information:
  905.      aeras Any 2400  4089439152 "" "" ogin:--ogin: uugarch word: freebee
  906.      aeras Any 9600  4089439396 "" "" ogin:--ogin: uugarch word: freebee
  907.      aeras Any 19200 4089439246 "" "" ogin:--ogin: uugarch word: freebee
  908.           
  909.      Suggested places to get additional information:
  910.          /u3/archive/sources/LISTING.Z
  911.      LISTING.Z contains the names of all the programs stored in the 
  912.      archives, and the sizes.  Note: all archives have probably been 
  913.      stored in compressed form, with 16 bit compression.  All multiple 
  914.      file programs have been stored in separate directories, then compressed.
  915.      
  916.      More information about the files stored in a particular volume are 
  917.      kept in files called LOGFILE. Such as:
  918.          /u3/archive/sources/x/vol1/LOGFILE
  919.      would be the one to get to examine the exact contents of volume 1
  920.      of the x section.  Additional information from files:  sample command 
  921.      to recover files:
  922.          uucp aeras!/u3/archive/sources/games/vol1/LOGFILE /tmp/.
  923.      Special note:  wild cards have been proven to not be reliable, so 
  924.                     to assure success they are not recommended tools.
  925.  
  926.  
  927. Site:        lll-winken.llnl.gov (128.11514.1)
  928. Contact:     Joe Carlson (carlson@lll-winken.llnl.gov)
  929. Location:    San Francisco, CA
  930. Modems:      NA
  931. UUCP:        NA
  932. FTP:         Anonymous FTP
  933. Mail Server: Account address of the automated mail server if available.
  934. Additional:  Articles are stored by X-Archive: index in subdirectories of 
  935.              comp.sources.misc/volN.  Note that these archives start from
  936.              9/87; anything from April to August isn't available.  
  937.   *NOTICE*:  lll-winken is not permitting anonymous FTP for the time being.  
  938.              The archives are temporarily available on polaris.llnl.gov,
  939.              128.115.14.19.  
  940.  
  941.  
  942.             ************************
  943.                     Australia
  944.             ************************
  945.  
  946.  
  947. Site:        ftp.Adelaide.EDU.AU [129.127.40.3]
  948. Contact:     Mark Prior <mrp@ITD.Adelaide.EDU.AU>
  949. Location:    The University of Adelaide
  950.              Adelaide, AUSTRALIA
  951. Modems:      NA
  952. UUCP:        NA
  953. FTP:         Anonymous ftp, ftp.Adelaide.EDU.AU [129.127.40.3]
  954. Mail Server: NA
  955. Additional:  Also available via ACSnet fetchfile (sirius.ua.oz)
  956.  
  957.              The comp.sources.misc archive is in the subdirectory
  958.              pub/sources/misc and is archived in compressed form by
  959.              issue number (subdirectories for each volume). The
  960.              file INDEX in the pub/soures/misc directory lists the
  961.              issues available.
  962.  
  963.              We will also make tapes (1600/6250bpi) or QIC-11/24 if
  964.              you supply the tape AND a return mailer. No promises
  965.              for speed for this though.
  966.  
  967.  
  968.             ************************
  969.                     Canada
  970.             ************************
  971.  
  972.  
  973. Site:        array.UUCP
  974. Contact:     Rob Marchand, rob@array.UUCP || ...uunet!attcan!lsuc!array!rob
  975. Location:    Toronto, Ontario, Canada
  976. Modems:      2400 baud, perhaps TB in the future (hopefully :-)
  977. UUCP:        On Request.
  978. FTP:         NA
  979. Mail Server: NA 
  980. Additional:  I have most stuff for comp.sources.unix, comp.sources.misc,
  981.              comp.sources.bugs and alt.sources.
  982.  
  983.  
  984.             ************************
  985.                     France   
  986.             ************************
  987.  
  988. Site:        irisa.irisa.fr 
  989. Contact:     Didier Lamballais (lamballais@irisa.fr)
  990.              Raymond Trepos    (trepos@irisa.fr)
  991. Location:    Institut de Recherche en Informatique et Systemes Aleatoires
  992.          Campus universitaire de Beaulieu
  993.          35042 Rennes Cedex
  994.          FRANCE
  995. UUCP:        NA
  996. Modems:      NA
  997. FTP:         Anonymous FTP (login: ftp or anonymous, 
  998.                             Password: your e-mail address)
  999. Mail Server: NA 
  1000. Additional:  Additional information pertaining to accessing the archive.
  1001.          List of archived newsgroups :
  1002.          alt.sources, comp.binaries.atari.st, comp.binaries.ibm.pc,
  1003.          comp.binaries.mac, comp.sources.atari.st, comp.sources.games,
  1004.          comp.sources.mac, comp.sources.misc, comp.sources.sun,
  1005.          comp.sources.unix, comp.sources.x, comp.sys.sun
  1006.          under "News" directory.
  1007.          Some local stuff and RFCs are also available.
  1008.  
  1009.