home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / compsrcs / misc / volume20 / intro20 < prev    next >
Encoding:
Internet Message Format  |  1991-08-27  |  39.9 KB

  1. From pa.dec.com!decwrl!uunet!sparky!kent Fri May 24 12:54:58 PDT 1991
  2. Article: 2387 of comp.sources.misc
  3. Newsgroups: comp.sources.misc
  4. Path: pa.dec.com!decwrl!uunet!sparky!kent
  5. From: Kent Landfield <kent@sparky.imd.sterling.com>
  6. Subject:  v20INF1:  Introduction to comp.sources.misc
  7. Message-ID: <1991May20.162859.25205@sparky.IMD.Sterling.COM>
  8. X-Md4-Signature: ad760c3126823c9d0498e1fe1c30a3f8
  9. Sender: kent@sparky.IMD.Sterling.COM (Kent Landfield)
  10. Organization: Sterling Software, IMD
  11. Date: Mon, 20 May 1991 16:28:59 GMT
  12. Approved: kent@sparky.imd.sterling.com
  13.  
  14. Submitted-by: Kent Landfield <kent@sparky.imd.sterling.com>
  15. Posting-number: Volume 20, Info 1
  16. Archive-name: intro20
  17.  
  18. I am *still* requesting comments on a new auxiliary header, Environment:.  
  19. It would be used to specify the runtime requirements needed by a submission.
  20. I have been shown that in a newsgroup that is not restricted to one type of 
  21. operating system, one type of machine or one type of architecture that there 
  22. is a need for this type of information in the header.  I am not sure about 
  23. its usage at this point. *Please* send me your opinions on its proposed 
  24. usage, yea or nea..
  25.  
  26. Is there anyone in Asia that would like to provide comp.sources.misc archive
  27. access to the sites located in that part of the world ?  If you would like
  28. to but don't know where to start, *please* send me some mail.  I can get you
  29. setup with both the software to run it as well as a copy of the archives
  30. themselves.
  31.  
  32. This is the first of five introductory messages about comp.sources.misc.
  33. It describes the newsgroup's history, how to submit sources to c.s.misc, 
  34. where the archive sites are, and how to contact and access them.  The
  35. second, third and fourth postings together comprise the index of previously
  36. posted software. The fifth article is a cross-index of patches that have 
  37. been posted to this newsgroup.
  38.  
  39. As always, I am looking for suggestions on how to improve the usefulness
  40. of the newsgroup. Do not hesitate to send suggestions to kent@uunet.uu.net
  41. or kent@sparky.imd.sterling.com.
  42.  
  43.             -Kent+
  44. --------------------
  45. Subject:  Introduction
  46.  
  47. Comp.sources.misc is sort of a "catch-all" sources group.  The group 
  48. is run in a generally informal manner.  *Any* program source code will
  49. be accepted. Discussion and "sources wanted" requests will be discarded 
  50. with a message back to the sender advising him/her to post to the correct 
  51. newsgroup.  Please do not send either to me, they don't belong here.
  52.  
  53. The moderated comp.sources.misc replaced the unmoderated net.sources in May
  54. 1987.  This was done by the Usenet backbone in response to the observed fact
  55. that net.sources was largely NON-sources by number of articles. The initial
  56. moderator of comp.sources.misc was Brandon Allbery.  Mail Brandon received
  57. at the time indicated that the majority of people were willing to trade the
  58. small delays (mainly caused by network delays in mail) for having a source 
  59. group that wasn't full of noise.
  60.  
  61. As stated above, the only reason a submission will be rejected is if it is 
  62. non-source.  I am striving to get things out as quickly as possible. Testing
  63. of the source is not done. I will, however, assure that postings are in shar 
  64. format and that shar'ed submissions can be unshar'ed correctly. If a patch
  65. is submitted, I assure that the patch can be applied to the sources it is to
  66. patch. If the submission is something that needs testing, it probably should 
  67. be sent to comp.sources.unix instead.  
  68. (Send submissions to comp-sources-unix@<backbone> in that case.) 
  69.  
  70. --------------------
  71. Subject: Deciding where to post your software
  72.  
  73. There are three choices for sources newsgroups, not counting local sources
  74. groups (fl.sources) or groups for specific systems (comp.sys.sun, et al.).
  75. Choosing between them can be somewhat difficult for the novice, and even for
  76. seasoned sources posters with unusual submissions.  Here, then, is a
  77. discussion of the various "primary" sources groups, their advantages and
  78. disadvantages, and a crude attempt at quantifying when to use them.
  79.  
  80. First off is comp.sources.unix, the major sources group.  It is rather
  81. unfortunately named, but don't let that stop you from trying to submit
  82. something if it fits the group's guidelines otherwise.  The benefits you'll
  83. get are testing of source on at least some machines before posting and
  84. guaranteed archiving at many Internet and UUCP sites.  The problem is that
  85. smaller postings aren't usually accepted, especially if they don't come with a
  86. Makefile and README file -- and sometimes the moderator declares a moratorium
  87. on certain types of postings, like text editors.  Trying doesn't hurt,
  88. however; if the moderator rejects something, he dumps it into the c.s.misc
  89. mailbox.  I should also note that the current policy of comp.sources.unix is
  90. not to accept "shareware" programs, programs which request or require a fee to
  91. the author for continued use. 
  92.  
  93. For small sources and beta copies of programs (which probably should not be
  94. archived, in favor of the production release), one might choose alt.sources.
  95. It has one major advantage over the other possibilities:  there is no
  96. moderation, meaning no delays and no rules for formatting.  You're free to
  97. just pipe a source file to inews if the fit takes you (not that I recommend
  98. it).  But it also has one major disadvantage:  since the group isn't
  99. moderated, there is nothing preventing people from starting up discussions
  100. ranging from source code topics to why EUnet works the way it does.  This, if
  101. you'll recall, is what caused comp.sources.misc to be created in the first
  102. place; although it seems that at least some people have benefited from the
  103. lesson and have started to work harder to prevent its happening to
  104. alt.sources.  Another disadvantage is that, being an "alt" group, it doesn't
  105. get as wide a distribution as the "mainstream" Usenet.  (For further
  106. information on the "alt" hierarchy, see the "Alternative Newsgroup
  107. Hierarchies" document posted once a month by Gene Spafford in news.lists.)
  108.  
  109. And then there's this group, comp.sources.misc.  The original charter called
  110. for moderation solely to reject non-source postings, nothing more; the intent
  111. was to provide net.sources without the noise.  This changed rather quickly,
  112. as a policy was  adopted of letting the group be controlled more by its users
  113. (submitters, readers, archivers) than by "moderative fiat".  The advantages of
  114. posting here are that archiving is almost as widespread as that of
  115. comp.sources.unix, that anything that is source code can be posted, and that
  116. it's guaranteed not to be lost in non-source, discussion postings; the
  117. disadvantages are that there is a slight delay caused by having to filter stuff
  118. 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. Released,
  130. 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 100
  140. issues to a volume.  The division is arbitrary, and has varied greatly in
  141. the past.  There are two types of articles in comp.sources.misc; sources
  142. and "informational postings."  They can be distinguished by the subject
  143. line. All source postings will be stored in a subdirectory within the
  144. volume so that patches have a place to be stored.
  145.  
  146.     Subject:  v03INF1:  Introduction to comp.sources.misc
  147.  
  148. This first word in the title identifies this as the first info posting of
  149. volume three.  Similarly, the subject line shown below:
  150.  
  151.     Subject:  v014i082:  lc - Categorize and List Files In Columns, Part01/02
  152.  
  153. identifies this as the 82nd source article in Volume 14.  In the above 
  154. example, the Part01/02 indicates that this is the first part of a two
  155. part posting.  All sources are broken up into pieces.  This is done so
  156. that there could be a proper storage directory when patches are issued.
  157.  
  158. The first few lines of an article are auxiliary headers that look like this:
  159.  
  160.     Submitted-by: kent@sparky.IMD.Sterling.COM (Kent Landfield)
  161.     Posting-number: Volume 14, Issue 82
  162.     Archive-name: lc/part01
  163.  
  164. The "Submitted-by" line in each issue is the author of the program.  IF YOU 
  165. HAVE COMMENTS ABOUT AN ISSUE PUBLISHED IN COMP.SOURCES.MISC, THIS IS THE PERSON
  166. TO CONTACT.  When possible, this address is in domain form, otherwise it is a 
  167. UUCP bang path relative to some major site such as "uunet."
  168.  
  169. The second line repeats the volume/issue information for the aide of NOTES
  170. sites and automatic archiving programs such as rkive.
  171.  
  172. The Archive-name is the "official" name of this source in the archive.  
  173.  
  174. All source postings will be treated as multi-part postings have been done
  175. in the past. The postings will have a subdirectory under the volume directory.
  176. This gives me a place to store patches as well as allows me to have more
  177. informative archive names without having to worry how many spaces the part
  178. numbering, patch indicator or compression suffix will take up.  Postings will 
  179. have names that look like this:
  180.  
  181.     Source posting
  182.         Archive-name: lc/part01
  183.  
  184.     Patch posting
  185.         Archive-name: lc/patch01
  186.  
  187. Please try to use this name when requesting that sources be mailed to you.
  188. Note that the part number and patch number will be zero padded for convenience 
  189. sake as was requested by several people.  Also, note that the "part number" 
  190. given in the title will be used to give the reader an indication of the total
  191. number of parts that make up the complete set of sources. The example below
  192. shows that this is part 21 of a 23 part submission.
  193.  
  194. v17i102: calentool - day/week/month/year-at-a-glance SunView tool, Part21/23
  195.  
  196. Informational postings such as this posting will not be stored in a 
  197. subdirectory as is the source postings. INF postings will have archive 
  198. names such as indx20v1-7 and patchlog20.  From an archiving perspective, 
  199. archive names for all INFormational postings will be specified so as to 
  200. store the INF postings directly in the volume's base directory.  Archive 
  201. names for source postings will be specified so as to store the sources in
  202. subdirectories within the volume's base directory.
  203.  
  204. To support the tracking of patches the Patch-To: line is used in c.s.misc.
  205. The Patch-To: line exists for articles that are patches to previously posted 
  206. software. The Patch-To: line only appears in articles that are posted, 
  207. "Official", patches. The initial postings do not contain the Patch-To: 
  208. auxiliary header line.
  209.  
  210.     Patch-To: syntax
  211.         Patch-To: package-name: Volume X, Issue x[-y,z]
  212.  
  213. Patch-To: examples. These are examples and do not reflect the accurate 
  214. volume/issue numbering for rkive.
  215.  
  216. In the first example, the article that contains the following line
  217. is a patch to a single part posting.
  218.     Patch-To: rkive: Volume 22, Issue 122
  219.  
  220. This example shows that the 122-124 indicates the patch applies to
  221. a multi-part posting. The '-' is used to mean "article A through article
  222. B, inclusive..
  223.     Patch-To: rkive: Volume 22, Issue 122-124
  224.  
  225. If a patch applies to multiple part postings that are not consecutive, the
  226. ',' is used to separate the part issue numbers. It is possible to mix both
  227. ',' and '-' on a single Patch-To: line.
  228.     Patch-To: rkive: Volume 22, Issue 122,125,126,127
  229.                        or
  230.     Patch-To: rkive: Volume 22, Issue 122,125-127
  231.  
  232. If a new release is posted instead of a large set of patches, the new 
  233. posting will contain a Supersedes: header line with a format similar 
  234. to the Patch-To: header.
  235.  
  236.     Supersedes: syntax
  237.         Supersedes: package-name: Volume X, Issue x[-y,z]
  238.     
  239.     Supersedes: example
  240.         Supersedes: rkive: Volume 22, Issue 122-127
  241.  
  242. The Supersedes: line is helpful for cleaning archives by providing a pointer 
  243. to previous versions that the archive administrators can then remove from 
  244. their archives.
  245.  
  246. Prior to January 1, 1988, a different archive header system was used.  At the
  247. time, it was not expected that comp.sources.misc would be welded into the
  248. then-evolving standard for sources archiving.  There was only one special 
  249. header line, and it resided in the main header.  It looked like
  250.  
  251.         X-Archive: yymm/nn
  252.  
  253. where "yymm" was the year and month of the submission date and "nn" was 
  254. a sequence number.  Please keep this in mind when dealing with archive 
  255. submissions from 1987.
  256.  
  257. -----------------
  258. Subject: Patches Handling
  259.  
  260. Patches will be handled as swiftly as possible. Authors of sources posted
  261. to c.s.misc should send all patches to me so that I can post them back through
  262. the newsgroup in order that the patches can be archived. This has not been
  263. done in the past in other sources groups and has lead to lost patches. If
  264. the patches must get out *real* fast, post them to comp.sources.bugs and
  265. send me a copy at the same time so that they will be available when they
  266. are needed in the future. Again, patches will receive priority processing
  267. so make sure I get them...
  268.  
  269. I would prefer not to post patches that are not sent by the author of the
  270. original posting unless special arrangements have been made with the author.
  271. Please send your unofficial patches to the author so that the author can
  272. incorporate them into their postings baseline.  Unofficial patches can
  273. be posted to comp.sources.bugs as a method of letting the community use
  274. the fix or enhancement during the interium.
  275.  
  276. It is up to the author to determine if there have been major enough
  277. changes to warrant a complete reposting. This may be necessary if the
  278. size of the patches exceeds the size of the source but in most cases
  279. only patches are posted. Total repostings should be treated as an 
  280. initial posting. What follows pertains to patches...
  281.  
  282.     1.  When patches are submitted, they should be in context diff 
  283.         format.  Patches can be made with diff -c on 4.XBSD based 
  284.         machines and with diffc on others. Diffc can be found in 
  285.         volume 1 of comp.sources.unix archives. GNU diff can also be 
  286.         used to create context diffs.
  287.     2.  A patch to patchlevel.h should be done to reflect that the
  288.         patch has been applied if a patchlevel.h existed in the initial
  289.         posting. If one was not included initially, maybe now is a
  290.         good time to consider including one... :-)
  291.     3.  Include information about which previously posted issues 
  292.         the patch pertains to if they were initially posted to c.s.misc.
  293.  
  294. For more information on patch see patch.man in util/patch/patch.man 
  295. in the X11 Release 4 distribution or in volume7 of the comp.sources.unix
  296. archives. 
  297.  
  298. --------------------
  299. Subject: Guidelines for submitting source for publication
  300.  
  301. Items intended for posting and problem notes should be sent to
  302. "sources-misc@uunet.uu.net" or to "sources-misc@sparky.imd.sterling.com".
  303.  
  304. Newsgroup-related mail that is *not* a submission should be sent to me at
  305.     sources-misc-request@uunet.uu.net 
  306.             or
  307.     sources-misc-request@sparky.imd.sterling.com.
  308.  
  309. If you want verification of arrival, say so in a cover note, or at the
  310. beginning of your submission, if it is small.  I will try to do this by
  311. default but if you want it guaranteed, ask...
  312.  
  313. To make life easier for both myself and the users of the comp.sources.misc
  314. newsgroup, I request that all submissions follow the following guidelines.
  315. Not following these guidelines may result in longer delays, since some things
  316. *must* be fixed for news to accept the submission, and others fixed so that 
  317. I can spend time processing submissions rather than responding to flames.  ;-)
  318.  
  319. First, uuencoded postings are frowned upon.  If at all possible, binary data
  320. files should be translated to an ASCII format that is usable by others.  If
  321. it's not possible, consider sending the machine-dependent parts of the
  322. posting to another newsgroup.  If all else fails, it will be accepted if it
  323. is not the only component of the submission; otherwise, it may be better to
  324. announce the availability of the item via anonymous FTP, UUCP, FTAM, etc
  325.  
  326. A corollary of the above rule is that uuencoded (ABEd, btoa'd, BinHexed, ...)
  327. compressed (packed, ...) archives are not acceptable regardless of the
  328. compression and/or archiving method used.  Not everyone has ARC, PKZIP, ZOO,
  329. StuffIt, or even cpio or tar and the "compress" program.
  330.  
  331. The second rule is that "shell archives" as created by "shar", "cshar",
  332. "bundle", etc. be used to package files.  Preferably, use cshar:  it guards
  333. against mangling by older news programs, Bitnet mailers, etc.  I must repack
  334. non-shar'ed submissions so that they have a better chance of surviving older
  335. mail/news systems and inter-network gateways. 
  336.  
  337. Third, *please* send me a Subject: to be used in posting your submission.
  338. Certain large postings in the past have arrived sans Subject:; not only does
  339. this force me to make one up for the archive list.
  340.  
  341. Fourth, *please* send me an archive-name or package name that you want the
  342. submission archived by. If you do not send me one then I get to name your
  343. sources in the archives...
  344.  
  345. Fifth, if your submission has limitations, such as it does not run on 
  346. SYSV or limited to a specific version of SUNOS, or whatever the conditions,
  347. *PLEASE* inform me so that it can be included in the blurb that appears on
  348. the first part of the posting.  This way people who are not able to run your
  349. submission will not take the time to ftp or unpack it. 
  350.  
  351. The following information should be supplied as appropriate:
  352.  
  353.     1. If the submission is a patch to a previous posting, let me know the
  354.        volume and issue(s) that it appeared in. 
  355.     2. If the submission is a complete reposting of a previous posted package,
  356.        let me know that the posting is superseding your previous submission.
  357.  
  358. Each of the postings should contain a "blurb" that describes what the posting
  359. is/does/contains. This should only be a paragraph or two.  When you submit
  360. your sources, please include the blurb on the first part. If you do not write
  361. it youself, I will have to grab it out of the submission somewhere.
  362.  
  363. Please do not package executable programs and sources in the same
  364. submission.  Executable binary programs are inherently system-dependent, and
  365. therefore should be posted to a system-specific "binaries" group.  And, as a
  366. special case, Un*x executables should NEVER be posted to the Usenet.
  367.  
  368. Please keep source filenames to 12 or fewer characters in length.
  369. Not everyone has long filenames... :-(
  370.  
  371. Other nice things to consider/supply when submitting sources...
  372.    1.  A Makefile.
  373.    2.  A manual page is highly recommended for any substantial sized
  374.        submissions.
  375.    3.  A README file is also highly desirable. This should contain 
  376.        a brief description of what the posting is and any special
  377.        considerations in building it. The README should
  378.        also contain a list of authors and the distribution
  379.        and copying policy. 
  380.    4.  A patchlevel.h -- This file can be used to keep track 
  381.        of how many official patches have been applied.  
  382.    5.  Any additional documentation (past the recommended man page) 
  383.        should be in PostScript format.  
  384.  
  385. ------------------------
  386. Subject: Special services 
  387.  
  388. One way to solve the problem of an announcement not going out the same day as
  389. the posting it announces is to send the announcement to me -- under separate
  390. cover, please, it slows things down if I have to break a submission apart to
  391. get at the file -- with instructions as to where it should be posted, and I
  392. will insure that both go out the same day, if possible.  (If one of the other
  393. newsgroups is also moderated, there's not a whole lot I can do about it.) The
  394. same goes for binaries and/or other material associated with a source; send
  395. it under separate cover and tell me what to do with it, and I will try to
  396. arrange for them to all go out at the same time.
  397.  
  398. To help avoid the longer delays and possible network difficulties between the
  399. main comp.sources.misc receiving address and sites in Australia,
  400. john@basser.cs.su.oz.au acts as a sub-moderator for our friends "down
  401. under".  It's not required to send sources to him, but the submission will be
  402. seen by your neighbors that much more quickly if it doesn't have to cross the
  403. ocean twice.  It also saves on the bills incurred by all that trans-oceanic
  404. data transfer, which might not matter to you but *does* matter to your site
  405. admin and to the Australian gateway maintainers.
  406.  
  407. --------------------
  408. Subject: Reporting and tracking bugs.
  409.  
  410. You should subscribe to comp.sources.bugs.
  411.  
  412. Sometimes, when new versions of previously-published software is available,
  413. just patches are put out, usually in the form of shar files containing
  414. input for the "patch" program, new files, etc.  Sometimes complete new
  415. versions are put out.  Which method is used depends on the poster and
  416. the moderator.  Minor updates must be in patch form and should update the 
  417. patchlevel.h file.  Major updates should follow the guidelines for 
  418. initial postings.
  419.  
  420. To report bugs, contact the person listed in the Submitted-by: header.
  421. Often there is a contact address in a README file, too.  I *do not* maintain
  422. the sources I moderate, so don't send your bug reports to me.  That just
  423. forces a delay in the right person getting them as I will forward them on
  424. to the author.  Likewise, I normally do not post patches for a package from 
  425. anyone except the author. If you have patches you would like to see included
  426. in the package, send them to the person listed in the Submitted-by:
  427. header.
  428.  
  429. ------------------------
  430. Subject: Newsgroup Status Information.
  431.  
  432. You should subscribe to comp.sources.d.
  433.  
  434. In some newsgroups, postings such as "I will be out of town..." and
  435. "What's in the queue to post..." have been posted as INF postings with
  436. an Archive-name: of /dev/null or .junk.  I will not post these types of
  437. messages to c.s.misc due to the limited amount of time that information of
  438. this type is useful.  I will post these kinds of messages to comp.sources.d
  439. as the need arises.  In this manner, the informational c.s.d postings can 
  440. expire as they should and will not be archived taking up disk space forever.
  441.  
  442. --------------------
  443. Subject: Accessing the archives
  444.  
  445. The complete archives are fairly large; an average volume is 3.8 megabytes.
  446.  
  447. There are several active archive sites around the net.  I am currently
  448. trying to locate archive sites in Europe, Asia and Australia.  If you 
  449. are interested *please* contact me.
  450.  
  451. Some sites below will send tapes through the mail.  For those sites, send
  452. a 1/2" mag tape WITH RETURN POSTAGE and RETURN MAILER.  Tapes without
  453. postage or mailer will not be returned.  No other methods (COD, etc.) are
  454. available; please don't ask.
  455.  
  456. There a couple sites that provide email access to their archives. Please
  457. use them when you need to locate a missing issue. Please don't ask me for 
  458. missing issues, unless you are sure you are reporting a net-wide problem of
  459. propagation. At the end are detailed instructions on how to access
  460. the archives.  More sites will be listed there in the future.
  461.  
  462. I have access to archives here at Sterling. I do not have ftp or email
  463. archive access available at the present time.  I have as complete a 
  464. set of archives as I have found. I have all the issues listed in the indexes
  465. except for the first volume. If you have articles from volume 1 please send
  466. me a list of articles so I can see if there are some I do not have.
  467.  
  468. If anyone has an article that was posted to the group that is not listed
  469. in the indexes, please send me the information and a copy of the article
  470. so that I can update the archive sites that I maintain.  Nothing from April 
  471. and May 1987 was ever archived to my knowledge. If I'm wrong, send them my
  472. way... I am willing to contribute a tape to a site on the internet that is 
  473. willing to make the archives available.  
  474.  
  475. Submissions prior to July, 1987 have no auxiliary header information at all.
  476. At the time, the group's original charter was in full force, and archiving 
  477. was not considered to be important.  These articles may be assigned 
  478. auxiliary headers in the future, but for now ...
  479.  
  480. --------------------
  481. Subject: Archive access via ftp
  482.  
  483. If an archive site provides "anonymous FTP" access, sites directly on the
  484. Internet (that is, sites possessing an IP address, which looks like four
  485. small numbers separated with periods) can use the "ftp" program to get at
  486. sources.  Sites which aren't on the Internet (more properly, the NSFnet) can
  487. not use ftp to retrieve this information.  And no, having the ftp program
  488. does not mean that you can access NSFnet:  there are many systems which use
  489. TCP/IP over local networks only, and at least one brand of system which has a
  490. program called "ftp" that has nothing to do with the Internet at all.
  491.  
  492. You should check with a local system administrator to find out the details of
  493. using ftp.  On most systems and to most archive sites, the following will
  494. work:  type the command "ftp system.domain" (example:  "ftp uunet.uu.net" --
  495. case does not matter), enter "anonymous" when it asks for a user name, and
  496. enter *your* Internet address for the password.  If "ftp" says that the
  497. system doesn't exist, check your spelling -- if the system name is spelled
  498. correctly, look for an IP address for the archive site and badger your system
  499. administrator to install a version of ftp which knows about nameservers.  You
  500. should also be warned that some systems (like uunet) will not accept FTP
  501. connections from sites not registered with a nameserver.
  502.  
  503. Once you are logged in to the archive system, you will get a prompt that
  504. looks like "ftp>".  (It may not be identical, since it is possible to change
  505. the ftp prompt with a command in many versions of ftp.)  At this point, you
  506. can use "cd" to change directories, "ls" or "dir" to list files, and "get" to
  507. retrieve them.  For sources archives, it is not necessary to worry about file
  508. types unless the files are compressed; in that case, you must use the
  509. "binary" command for Unix or VMS hosts and "tenex" on Tenex (TOPS-10, TENEX,
  510. TOPS-20/TWENEX) hosts.  *** Not switching the file type can result in a
  511. garbled file, especially on Tenex hosts, which do not store binary data the
  512. same way as Unix hosts. ***  To disconnect from the archive site, enter the
  513. "bye" command.
  514.  
  515. --------------------
  516. Subject: Archive access via uucp
  517.  
  518. UUCP archives aren't quite as standardized as FTP archives; check the archive
  519. list for the user name and password to use, and ask your system administrator
  520. to arrange to be able to poll the archive site.  (If s/he/it refuses, you are
  521. stuck.)  
  522.  
  523. The "uucp" command is used to request files from a UUCP archive.  Unlike FTP,
  524. UUCP does not (usually) do the transfer immediately; this is because most
  525. UUCP sites must be called over phone lines, so long-distance calls will
  526. usually be made in the early morning hours.
  527.  
  528. Since you can't look around in the archives, you must know the pathname of
  529. the article to be retrieved.  Most archives have an index file available via
  530. FTP; check the archive list in the next posting.  It's a good idea to
  531. retrieve this file before getting anything from the archive, since things can
  532. move around without warning.
  533.  
  534. The command to retrieve a submission looks like
  535.  
  536.          uucp -r archivesite!path/to/file
  537.  
  538. "archivesite" is the name of the archive site, and "path/to/file" is the
  539. pathname listed in the archive index for that site.  Please be warned that
  540. for security reasons, it is not usually possible to specify wildcards (?, *,
  541. [], or ~name) in the pathname.  Also, while more recent versions of uucp
  542. allow a uucp command to traverse multiple systems (uucp -r
  543. systemA!systemB!file), for security reasons this is usually disabled.  In
  544. both cases you won't find out until after the archive site has been called.
  545.  
  546. --------------------
  547. Subject: Archive access via email 
  548.  
  549. Some archive sites have mail servers that will accept mail from you and mail
  550. back files from the archive.  There are no standards here; however, it's
  551. usually safe to mail a message containing the single word "help" to the mail
  552. server.  Check the archive list for more information.  
  553.  
  554. IMPORTANT TO REMEMBER: Mail Based Archive Servers (MBAS) are there for the
  555. convenience of the community and are *easily* abused. Please do not request to
  556. have a MBAS send you GCC or X11R4.  A good deal of this traffic goes through
  557. intermediate sites that have not advertised this service.  You would be
  558. taking resources away that are not yours to take...  
  559.  
  560. --------------------
  561. Subject: Extracting a retrieved archive member
  562.  
  563. If the article came from an archive site, it may be compressed; if it was 
  564. sent by a mail server, it may also be uuencoded.  Compressed files have an 
  565. extension of ".Z".  Uuencoded files can be recognized by a line saying 
  566. "begin 666 filename", followed by lines of what looks like random gobbledygook.
  567. (If a mail server splits a file into multiple parts, you may just have the
  568. gobbledygook.  In this case, the server will include a message saying which
  569. part of the file it is, and will tell you how to combine them.)
  570.  
  571. To extract a uuencoded file, give the command "uudecode filename".  This will
  572. create a (binary, usually compressed) file in the current directory.
  573.  
  574. To extract a compressed file, give the command "uncompress filename".  The
  575. ".Z" extension will be removed from the file.  The original, compressed file
  576. will be removed as part of this operation.
  577.  
  578. After doing this, you should be left with a news article exactly as it is
  579. stored in the news spool directories.  This file will contain a news header,
  580. a description (usually), and a "shell archive" ("shar").  Move to an empty
  581. directory (important!) and unpack the archive.  Some systems have a command
  582. "unshar" to unpack these files; if yours does, use it.  Otherwise, you can
  583. use an editor to remove the header, then just say "sh filename".  I use a
  584. small (one line) shell script:
  585.  
  586.                         sed '1,/^[#:]/d' $1 | sh
  587.  
  588. which will handle anything (I hope!) in the comp.sources.misc archives.  I do
  589. attempt to confirm that a shell archive contains nothing dangerous, but if
  590. you unpack as root and the archive removes your /etc directory or something
  591. equally unpleasant, I don't want to hear about it.  Unpack shell archives as
  592. an unprivileged user.
  593.  
  594. Once you've unpacked the archive, you're on your own.  Keep the header from
  595. the submission handy, in case you can't figure out what's going on; the
  596. address in the "Submitted-by:" line can be used to contact the author of the
  597. program.
  598.  
  599. ------------------------
  600. Subject: Becoming an archive site
  601.  
  602. If you collect comp.sources.misc postings and are willing and able to make
  603. your collection available to other people, please let me know.  Benefits
  604. include the undying gratitude of your colleagues, and a promise from me to
  605. try to make sure you never lose an article whether you use rkive or not... :-)
  606.  
  607. I am currently looking for archive sites outside the US.  If you can provide 
  608. access to your archives send me some email and I will get you some publicity...
  609. :-)  If you need automated tools to build and maintain your archives, I have 
  610. those too .. :-) If you need a tape of the archives to get you jump-started, 
  611. let me know.
  612.  
  613. PLEASE NOTE: Mail Based Archive Servers (MBAS) are there for the convenience
  614. of the community but are too easily abused.  Because of this, I can not,
  615. in good conscience, list archive sites whose *sole* access is mail based.
  616. If you can't supply anonymous ftp as a secondary method for accessing your
  617. archives then consider uucp.  It is easy enough to set up a uucp account for 
  618. archive access with the appropriate security to protect your other system 
  619. resources.
  620.  
  621. --------------------
  622. Subject: Listing of archive sites in no particular order
  623.  
  624. Here is what each field means:
  625. Site:        The name of the site nice enough to act as an archive site.
  626. Contact:     The name of the person to contact and their mail address
  627. Location:    The general area of the world the site is located in.
  628. Modems:      For providing UUCP access, what types of modems are available.
  629. UUCP:        Type of UUCP access is available.
  630. FTP:         Type of FTP access is available.
  631. Mail Server: Account address of the automated mail server if available.
  632. Additional:  Additional information pertaining to accessing the archive.
  633.  
  634. NA - Not Available
  635.  
  636.             ************************
  637.                  U S A - EASTERN 
  638.             ************************
  639.  
  640. Site:        schizo.samsung.com
  641. Contact:     Andy Rosen (rosen@samsung.com)
  642. Location:    Andover, MA
  643. Modems:      NA
  644. UUCP:        NA
  645. FTP:         Anonymous
  646. Mail Server: None
  647. Additional:  Files are stored by volume number, archive name and are
  648.              compressed.  Volumes 1 through 6 and 11 through 15 are present.
  649.              Examples:
  650.                /pub/usenet-archives/comp.sources.misc/volume15/fb/part01.Z
  651.                /pub/usenet-archives/comp.sources.misc/volume6/gone-2.0.Z
  652.  
  653.  
  654. Site:        slug.pws.bull.com [128.35.10.203]
  655. Contact:     Warren Lavallee <warren@pws.bull.com>
  656. Location:    Billerica, MA.  (NEARnet)
  657. Modems:      T2500
  658. UUCP:        NA
  659. FTP:         anonymous ftp 24 hours day.  limit 6 users at a time
  660. Mail Server: NA
  661. Additional:  Due to internal restructuring, this site may not be
  662.              accessible some times over the next month.
  663.              Carry FULL comp.sources.* archives (since the
  664.              beginning).  Usenet archives are currently taking 170M.
  665.  
  666.  
  667. Site:         uunet.uu.net 
  668. Contact:      Kent Landfield (kent@uunet.uu.net)
  669. Location:     Fairfax, VA 
  670. Modems:       Telebit 
  671. UUCP:         uunet uucp customers only
  672. FTP:          anonymous ftp
  673. Mail server:  netlib@uunet
  674. Additional:   UUNET is keeping archives in ~ftp/comp.sources.misc, and 
  675.               I will be maintaining them.  Volumes 1 and 2 are not available, 
  676.               and some earlier versions of programs have been removed due to 
  677.               space considerations.  You can also use 1-900-GOT-SRCS to access 
  678.               this archive.
  679.  
  680.  
  681.             ************************
  682.                  U S A - CENTRAL 
  683.             ************************
  684.  
  685. Site:         sparky
  686. Contact:      Kent Landfield (kent@sparky.imd.sterling.com)
  687. Location:     Omaha/Bellevue, NE
  688. Modems:       Telebit 
  689. UUCP:         On request
  690. FTP:          NA
  691. Mail server:  NA
  692. Additional:   Tapes made on request
  693.  
  694.  
  695. Site:         sir-alan
  696. Contact:      mikes@iuvax.cs.indiana.edu (812-855-3974 days 812-333-6564 eves)
  697. Location:     Bloomington, IN
  698. Modems:       Telebit (812-333-0450)
  699. UUCP:         Anonymous uucp
  700. FTP:          Coming..
  701. Mail server:  NA
  702. Additional:   Archive site for comp.sources.[games,misc,sun,unix,x], 
  703.               some alt.sources, XENIX(68K/286/386)
  704.               uucp-anon: ogin: nuucp password: anon-uucp
  705.               uucp-anon directory: /u/pdsrc, /u/pubdir, /u/uunet, 
  706.               help in /u/pubdir/HELP 
  707.  
  708.  
  709. Site:         wuarchive.wustl.edu [128.252.135.4]
  710. Contact:      Wuarchive Maintainers <archives@wugate.wustl.edu>
  711. Location:     Saint Louis, Missouri.  Connected to MIDnet Regional.
  712. UUCP:         Subscription UUCP access available ($300.00/year flat fee)
  713. Modems:       Telebit Trailblazer Plus and T2500.
  714. FTP:          Anonymous FTP.  T1 connectivity - 24 hours/day, 7 days/week.
  715. Mail Server:  NA
  716. Additional:   Access during all hours is encouraged.  Plenty of available
  717.               bandwidth.  Wuarchive has everything! :-) :-)
  718.  
  719.  
  720.             ************************
  721.                  U S A - WESTERN 
  722.             ************************
  723.  
  724. Site:         aeras
  725. Contact:      Rob Simon (simon@aeras)
  726. Location:     San Jose, CA
  727. Modems:       1200, 2400, Telebit
  728. UUCP:         Anonymous 
  729. FTP:          NA
  730. Mail server:  NA
  731. Additional:   SnailMail tapes (Under duress)
  732.      Systems/L.sys information:
  733.      aeras Any 1200  4089439152 "" "" ogin:--ogin: uugarch word: freebee
  734.      aeras Any 19200 4089439246 "" "" ogin:--ogin: uugarch word: freebee
  735.      aeras Any 2400  4089439396 "" "" ogin:--ogin: uugarch word: freebee
  736.           
  737.      Suggested places to get additional information:
  738.          /u3/archive/sources/LISTING
  739.      LISTING contains the names of all the programs stored in the 
  740.      archives, and the sizes.  Note: all archives have probably been 
  741.      stored in compressed form, with 12 bit compression (for machines 
  742.      that can't handle 16 bit).  All multiple file programs have been 
  743.      stored in separate directories, then compressed.
  744.      
  745.      More information about the files stored in a particular volume are 
  746.      kept in files called LOGFILE. Such as:
  747.          /u3/archive/sources/x/vol1/LOGFILE
  748.      would be the one to get to examine the exact contents of volume 1
  749.      of the x section.  Additional information from files:  sample command 
  750.      to recover files:
  751.          uucp aeras!/u3/archive/sources/games/vol1/LOGFILE /tmp/.
  752.      Special note:  wild cards have been proven to not be reliable, so 
  753.                     to assure success they are not recommended tools.
  754.  
  755.  
  756. Site:        lll-winken.llnl.gov (128.11514.1)
  757. Contact:     Joe Carlson (carlson@lll-winken.llnl.gov)
  758. Location:    San Francisco, CA
  759. Modems:      NA
  760. UUCP:        NA
  761. FTP:         Anonymous FTP
  762. Mail Server: Account address of the automated mail server if available.
  763. Additional:  Articles are stored by X-Archive: index in subdirectories of 
  764.              comp.sources.misc/volN.  Note that these archives start from
  765.              9/87; anything from April to August isn't available.  
  766.   *NOTICE*:  lll-winken is not permitting anonymous FTP for the time being.  
  767.              The archives are temporarily available on polaris.llnl.gov,
  768.              128.115.14.19.  
  769.  
  770.  
  771.             ************************
  772.                     Australia
  773.             ************************
  774.  
  775.  
  776. Site:        ftp.Adelaide.EDU.AU [129.127.40.3]
  777. Contact:     Mark Prior <mrp@ITD.Adelaide.EDU.AU>
  778. Location:    The University of Adelaide
  779.              Adelaide, AUSTRALIA
  780. Modems:      NA
  781. UUCP:        NA
  782. FTP:         Anonymous ftp, ftp.Adelaide.EDU.AU [129.127.40.3]
  783. Mail Server: NA
  784. Additional:  Also available via ACSnet fetchfile (sirius.ua.oz)
  785.  
  786.              The comp.sources.misc archive is in the subdirectory
  787.              pub/sources/misc and is archived in compressed form by
  788.              issue number (subdirectories for each volume). The
  789.              file INDEX in the pub/soures/misc directory lists the
  790.              issues available.
  791.  
  792.              We will also make tapes (1600/6250bpi) or QIC-11/24 if
  793.              you supply the tape AND a return mailer. No promises
  794.              for speed for this though.
  795.  
  796.  
  797.             ************************
  798.                     Canada
  799.             ************************
  800.  
  801.  
  802. Site:        array.UUCP
  803. Contact:     Rob Marchand, rob@array.UUCP || ...uunet!attcan!lsuc!array!rob
  804. Location:    Toronto, Ontario, Canada
  805. Modems:      2400 baud, perhaps TB in the future (hopefully :-)
  806. UUCP:        On Request.
  807. FTP:         NA
  808. Mail Server: NA 
  809. Additional:  I have most stuff for comp.sources.unix, comp.sources.misc,
  810.              comp.sources.bugs and alt.sources.
  811.  
  812.  
  813.             ************************
  814.                     France   
  815.             ************************
  816.  
  817. Site:        irisa.irisa.fr 
  818. Contact:     Didier Lamballais (lamballais@irisa.fr)
  819.              Raymond Trepos    (trepos@irisa.fr)
  820. Location:    Institut de Recherche en Informatique et Systemes Aleatoires
  821.          Campus universitaire de Beaulieu
  822.          35042 Rennes Cedex
  823.          FRANCE
  824. UUCP:        NA
  825. Modems:      NA
  826. FTP:         Anonymous FTP (login: ftp or anonymous, 
  827.                             Password: your e-mail address)
  828. Mail Server: NA 
  829. Additional:  Additional information pertaining to accessing the archive.
  830.          List of archived newsgroups :
  831.          alt.sources, comp.binaries.atari.st, comp.binaries.ibm.pc,
  832.          comp.binaries.mac, comp.sources.atari.st, comp.sources.games,
  833.          comp.sources.mac, comp.sources.misc, comp.sources.sun,
  834.          comp.sources.unix, comp.sources.x, comp.sys.sun
  835.          under "News" directory.
  836.          Some local stuff and RFCs are also available.
  837.  
  838. -- 
  839. Kent Landfield                   INTERNET: kent@sparky.IMD.Sterling.COM
  840. Sterling Software, IMD           UUCP:     uunet!sparky!kent
  841. Phone:    (402) 291-8300         FAX:      (402) 291-4362
  842. Please send comp.sources.misc-related mail to kent@uunet.uu.net.
  843.  
  844.  
  845.