home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume16 / intro16 < prev    next >
Internet Message Format  |  1991-01-02  |  39KB

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