home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / macintosh / alt-sources-mac next >
Internet Message Format  |  1995-07-26  |  16KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news!uhog.mit.edu!news.mathworks.com!gatech!howland.reston.ans.net!newsserver.jvnc.net!newsserver2.jvnc.net!netnews.upenn.edu!netaxs.com!f8dy
  2. From: f8dy@netaxs.com (Mark Pilgrim)
  3. Newsgroups: alt.sources.mac,alt.answers,news.answers
  4. Subject: alt.sources.mac FAQ
  5. Followup-To: poster
  6. Date: 26 Jul 1995 06:26:09 GMT
  7. Organization: Net Access - Philadelphia's Internet Connection
  8. Lines: 342
  9. Approved: news-answers-request@MIT.Edu
  10. Message-ID: <3v4n61$dvs@netaxs.com>
  11. NNTP-Posting-Host: unix3.netaxs.com
  12. Summary: please read this before posting anything to alt.sources.mac
  13. X-Newsreader: TIN [version 1.2 PL2]
  14. Xref: senator-bedfellow.mit.edu alt.sources.mac:2175 alt.answers:10930 news.answers:49313
  15.  
  16.  
  17. Archive-Name: macintosh/alt-sources-mac
  18. Submitted-by: f8dy@netaxs.com (Mark Pilgrim)
  19. Last-modified: 22-apr-94
  20. Version: 7
  21.  
  22. This compilation is intended to answer some of the most frequent questions
  23. about alt.sources.mac.  It is posted every week (usually Thursday) to
  24. alt.sources.mac and every other week (usually Thursday) to alt.answers and
  25. news.answers.  Please read it thoroughly before posting _anything_ to
  26. alt.sources.mac.  If you've read it and still aren't clear on why/what/how
  27. to post, e-mail the FAQ maintainer (f8dy@netaxs.com) or the group's creator
  28. (dnebing@andy.bgsu.edu) instead of posting a "What do I do" post.
  29.  
  30. Many FAQs, including this one, are available on the archive site rtfm.mit.edu
  31. in the directory pub/usenet/news.answers. The name under which a FAQ is
  32. archived appears in the "Archive-Name:" line at the top of the article.  This
  33. FAQ is archived as "macintosh/alt-sources-mac".
  34.  
  35. To find a particular topic by number, search for the number surrounded by
  36. rounded parentheses; i.e. to find information about acceptable content of
  37. posts, search for "(2.3)".  To find references to a topic, search for the
  38. number surrounded by less-than and greater-than signs; i.e. to find references
  39. to acceptable content of posts, search for "<2.3>".
  40.  
  41. Table of contents:
  42. -----------------
  43. 1. Why (and why not) to post to alt.sources.mac
  44.    1.1. Reasons to post here / general introduction
  45.    1.2. Reasons to post elsewhere
  46.    1.3. Reasons alt.sources.mac is called alt.sources.mac and not
  47.         anything else
  48. 2. What (and what not) to post to alt.sources.mac
  49.    2.1. Acceptable platforms/systems/environments
  50.    2.2. Unacceptable platforms/systems/environments
  51.    2.3. Acceptable content of posts
  52.    2.4. Unacceptable content of posts
  53. 3. How (and how not) to post to alt.sources.mac
  54.    3.1. General posting formatting guidelines
  55.    3.2. Small posts, snippets, cross-posts from other newsgroups
  56.    3.3. Larger posts
  57. 4. FTP sites
  58.    4.1. FTP sites which carry alt.sources.mac archives
  59.    4.1.1. FTP sites which will carry alt.sources.mac archives real soon now
  60.    4.2. FTP sites which carry other Macintosh source code
  61. 5. Things not included in this classification
  62.    5.1. Copyrights of posts
  63.    5.2. FAQ credits
  64.    5.3. ObSource
  65.  
  66. (1.1) Reasons to post here / general introduction
  67.  
  68. The alt.sources.mac newsgroup is intended to be a repository for Macintosh
  69. source code of all sorts that people wish to distribute and share with others.
  70. There are no restrictions on the type of source code you can post here --
  71. any mac, any language, any system version, any purpose. (see <2.1> and <2.3>
  72. below for details).
  73.  
  74. A common reason to post to alt.sources.mac is when you are posting a useful
  75. bit of source code to some other newsgroup, and you think that it might prove
  76. useful to other people in the future, in which case you can cross-post it
  77. here.
  78.  
  79. Alt.sources.mac is unmoderated, so your source code will be distributed
  80. throughout the USENET (or, at least, the portion of the USENET that receives
  81. alt.sources.mac -- see <1.2> below) immediately, without having to wait for a
  82. moderator's approval, like you have to do for some of the other newsgroups.
  83.  
  84. Furthermore, alt.sources.mac is archived at several anonymous ftp sites (see
  85. <4.1> below), so people will be able to get your software from the archive
  86. after you've posted it, rather than having to ask you to mail it to them.
  87.  
  88. Finally, you might have a snippet of mac source code that is really too
  89. small to submit as a package to one of the other major source newsgroups (see
  90. <3.2> below).
  91.  
  92. (1.2) Reasons not to post here
  93.  
  94. Alt.sources.mac IS NOT for requests for source code; the alt.sources.wanted
  95. newsgroup is for that.  Alt.sources.mac IS NOT for comments and discussion
  96. about source code, even source code posted in alt.sources.mac; the
  97. alt.sources.d newsgroup is for that.  Only source code should be posted to
  98. alt.sources.mac.
  99.  
  100. Alt.sources.mac isn't as widely propagated as the source newsgroups in the
  101. "comp" hierarchy, since more sites tend to get "comp" than "alt".  Therefore,
  102. if you want your source code to have as wide a distribution as possible, you
  103. might want to use the comp.sources.mac newsgroup instead of, or in addition
  104. to, alt.sources.mac.
  105.  
  106.  
  107. (1.3) Reasons alt.sources.mac is called alt.sources.mac and not anything else
  108.  
  109. A bunch of clever linguists have asked on alt.sources.mac why the group is
  110. not called alt.source.code.mac, alt.source-code.mac, or alt.sourcecode.mac.
  111. Some people feel that "sources" is an ambiguous term which implies that
  112. people can freely post questions like "Where can I find X?"  In fact, they
  113. are right, but their linguistic arguments are largely irrelevant.
  114.  
  115. Alt.sourcecode.mac does not fit into the Usenet naming hierarchy.  Like it
  116. or not, there is an established naming scheme, and source groups like
  117. alt.sources, alt.sources.amiga, alt.sources.d, alt.sources.index,
  118. alt.sources.patches, and alt.sources.wanted were around long before
  119. alt.sources.mac came into existence.  There is no alt.sourcecode.* hierarchy.
  120. This name policy is enforced by a group of influential news administrators
  121. who manage the large sites (like uu.net) that directly or indirectly provide
  122. newsfeeds to most of the world.  This naming scheme has been around for a
  123. long time, is very widely accepted, and was an important consideration when
  124. these people agreed to create alt.sources.mac.
  125.  
  126. In short, there is nothing we can do about the name "alt.sources.mac".  It
  127. may be confusing to people who are unfamiliar with the group's purpose, but
  128. that's what FAQs are for.  If you're really adamant about trying to change
  129. the name, please discuss it in alt.config, NOT in alt.sources.mac.
  130.  
  131.  
  132. (2.1) Acceptable platforms/systems/environments
  133.  
  134. Source code can be for the entire Macintosh line (including the Centris and
  135. Quadra lines), Newton, and the new PowerMac line of Macintosh computers.
  136.  
  137. Source code can be for any Macintosh operating system (6, 7, 7Pro, etc.), as
  138. well as Bento, A/UX (as long as the source is A/UX specific and does not apply
  139. to UN*X in general), etc.
  140.             
  141.  
  142. (2.2) Unacceptable platforms/systems/environments
  143.  
  144. Anything not mentioned in <2.1> above.  No UN*X, VAX, IBM, Apple //, TRS-80,
  145. Commodore, Amiga, or HP programs allowed.  Really.  All these other
  146. platforms have their own newsgroups or list-servers.  If it's not for the
  147. Mac, Newton, or PowerMac, it doesn't belong in alt.sources.mac.
  148.  
  149.  
  150. (2.3) Acceptable content of posts
  151.  
  152. Alt.sources.mac is EXCLUSIVELY for posting source code.  The source code
  153. may be in any form, textual or otherwise (i.e. Prograph files).  Also
  154. appropriate sources would include:
  155.  
  156. Resources:  Resources used in Macintosh programs.  These can include
  157.             CDEF's, MDEF's, as well as any other resource.
  158.  
  159. Scripts:    Scripts for either AppleScript, QuicKeys, Userland
  160.             Frontier, as well as any other scripting system.
  161.  
  162. Projects:   This includes project files for the Think compilers, as
  163.             well as Makefiles, AppMaker or Marksman project files, etc.
  164.  
  165. Source code can be for a full software product, library, patches, glue, or
  166. even code snippets.  See <3.3> below for how to post large archives.
  167.  
  168. Note on project files: in some programming environments (e.g. THINK C), the
  169. newest version of a project file is not backwardly-compatible.  For instance,
  170. THINK C 6 project files can not be read by THINK C 5.  Along with the project
  171. file, you should include a text file in the archive explaining how to set up
  172. the project from scratch.  
  173.  
  174.  
  175. (2.4) Unacceptable content of posts
  176.  
  177. Do not post copyrighted source code that is not yours unless you have
  178. permission from the original author.  This includes posts you see on
  179. other newsgroups; always consult the original author before cross-posting.
  180.  
  181. Do not post something that can only be decompressed with a commercial
  182. decompression program.  If you insist on compressing your source archive
  183. with a commercial compression program, make sure that either (a) it can be
  184. decompressed with a free/shareware program, or (b) it is self-extracting.
  185.  
  186. Do not post source code to viruses or intentionally malicious software.
  187.  
  188. Do not post anything that doesn't include some sort of Mac source code (see
  189. <1.3>, <2.1> above).
  190.  
  191.  
  192. (3.1) General format for all posts
  193.  
  194. Choose a good subject line for your posting that accurately describes what
  195. it contains.  The alt.sources.mac archive site generates its indices of the
  196. newsgroup from the subject lines of the postings in it, so try to make sure
  197. that there are relevant keywords in your subject that people can search for
  198. when looking for your source code later.  For source code archives spread
  199. over several posts (see <3.3> below), the subject lines should include not
  200. only the archive name, type, and platform, but also the part number:
  201.         Ghost 1.0 (word game, THINK C, part 0 of 10)
  202.         Ghost 1.0 (part 1 of 10)
  203.         ...
  204.         Ghost 1.0 (part 10 of 10)
  205.  
  206. Put a Followup-To: header line in your posting which directs followups
  207. somewhere other than alt.sources.mac.  This is especially important if you
  208. cross-post your alt.sources.mac posting from some other newsgroup, because
  209. people will often respond to the posting in that newsgroup without realizing
  210. it was cross-posted to alt.sources.mac.
  211.  
  212. At the top of your posting, separated from the main header of the posting
  213. by a blank line, include "Archive-name:" and "Submitted-by:" lines:
  214.         Archive-name: ghost-10.hqx
  215.         Submitted-by: f8dy@netaxs.com
  216.  
  217. The "name" on the first line should be a short one-word string that can serve
  218. as a "tag" for the package.  If your post is a complete program with a unique
  219. name, you can just use the name of the program as the archive name.  If you
  220. are posting a patch to a previously posted bit of source code, you would do
  221. something like "name/patchN", where N is the number of the patch.  If you post
  222. source code in multiple parts, do "name/part1", "name/part2", etc.  The second
  223. line should contain a return mail address for you.
  224.  
  225. This informational header (note that it is an auxiliary header, in the body of
  226. the posting, NOT part of the main message header) is used by some automatic
  227. archiving software to maintain alt.sources.mac archives automatically.  There
  228. are other useful fields you may want to put in the auxiliary header; if you
  229. are curious, see the documentation for the "rkive" program in the
  230. comp.sources.misc archives to find out what they are.
  231.  
  232. Other than the informational header, each post should include the following
  233. additional information about the content of the post: the type of code, a
  234. brief description of the code, the language of the code, and (if necessary)
  235. the specific programming environment the code was written in (e.g. THINK C
  236. vs. MPW C, QuickBASIC vs. Visual BASIC).  Answer all these questions early
  237. in the post; people should not have to search through the entire package
  238. just to figure out what it is.
  239.  
  240. For large posts (more than a few pages), this information should constitute
  241. the entire first post (part 0).  See <3.3> below for details.
  242.  
  243.  
  244. (3.2) Small posts, snippets, cross-posts from other newsgroups
  245.  
  246. Any small amount of source code (less than a few pages) can be posted as
  247. straight text.
  248.  
  249. If you post a single function to comp.sys.mac.programmer and feel it would
  250. serve the general community to have it on alt.sources.mac (and therefore
  251. archived on ftp sites around the world as well), cross-post it with a
  252. descriptive subject line.  Please remember to include a "Followup-To:" line
  253. to the original newsgroup or your own e-mail address.
  254.  
  255. If the source code, however small, relies on resources in a resource file,
  256. or if it is in two or more separate files, use the format for larger posts
  257. (see <3.3> below).
  258.  
  259.  
  260. (3.3) Large posts
  261.  
  262. Large source archives (for instance, code and resources for an entire
  263. program) are problematic, because some users must download an entire news
  264. article to read it.  Also, some newsreaders will cut off very large posts
  265. (over 1000 lines).  Therefore, put all relevant information about the
  266. source code in the first post, labeled "part 0 of n", where n is the number
  267. of posts the source code is split into.
  268.  
  269. After the informational post, the source code itself should be compressed
  270. and BinHexed.  (Compact Pro and Stuffit Lite are the favored compression
  271. programs, and the compressed archive should then be converted to BinHex 4.0
  272. format with any program that does that sort of thing.  Compact Pro and
  273. BinHex both do this quite well.)
  274.  
  275. The BinHex file should be split into sections of no more than 800 lines each.
  276. In unix, this can be accomplished with the command
  277.         split -800 filename
  278.  
  279. Each post should have a subject line that contains the part number ("part 0
  280. of n" for the informational post, "part 1 of n" for the first 800 lines of
  281. BinHexed source code, "part 2 of n", etc.).  Remember, these subject lines
  282. are used as indices when your source code gets archived on ftp sites (see
  283. <4.1> below).
  284.  
  285.  
  286. (4.1) FTP sites which carry alt.sources.mac archives
  287.  
  288. ftpbio.bgsu.edu (129.1.252.66) - /pub/alt.sources.mac
  289.  
  290. mac.archive.umich.edu (141.211.120.11) - /mac/development/source (entire
  291. programs) and /mac/development/source/snippets (code fragments).
  292.  
  293.  
  294. (4.2) FTP sites which carry other Macintosh source code
  295.  
  296. sumex-aim.stanford.edu (36.44.0.6) - /info-mac/dev/src
  297.  
  298. ftp.apple.com (130.43.2.3) - /dts/mac - Apple's primary FTP site.  It has
  299. lots of goodies that you won't find anywhere else, sample code and snippets
  300. and tech notes, programming tools and so on.
  301.  
  302. seeding.apple.com (130.43.3.3) - Not much code here, but it does have the
  303. MacTCP docs.
  304.  
  305. nic.switch.ch (130.59.1.40) - /software/mac/src - This is a fountain of
  306. source of all kinds, perhaps the most comprehensive source code archive for
  307. the Mac. It has source for lots of unix ported utilities as well as lots of
  308. "normal" mac source code.
  309.  
  310. ftp.acns.nwu.edu (129.105.16.52) - /pub - Source code for Disinfectant 2.4
  311. (except the anti-virus code) and NewsWatcher.
  312.  
  313. ftp.qualcomm.com (192.35.156.5) - /mac/eudora - Source code for Eudora.
  314.  
  315. ftp.ncsa.uiuc.edu (141.142.20.50) - /Mac - lots of NCSA source code
  316. (Telnet, Mosaic etc) and classes for Think Class Library.
  317.  
  318. redback.cs.uwa.edu.au (130.95.80.61) - /others/PeterLewis - stuff written
  319. by Peter Lewis.
  320.  
  321. ics.uci.edu (128.195.1.1) - /mac/think-c - Home of the think-c mailing list,
  322. has lots of code & classes, etc., for THINK C.
  323.  
  324. ftp.cc.umanitoba.ca (130.179.16.24) - /Mac-Develop/Source - Home of the
  325. develop mailing list, also has lots of misc stuff not found elsewhere.
  326.  
  327.  
  328. (5.1) Copyrights of posts
  329.  
  330. Source code that is posted on alt.sources.mac is copyrighted by the author
  331. unless otherwise stated.  Permission must be granted by the author of the
  332. code before being submitted by a second party.  Source code that is
  333. distributed via this newsgroup can be archived and distributed in any form
  334. as long as the source is in its original posted form.
  335.  
  336.  
  337. (5.2) FAQ credits
  338.  
  339. This FAQ compilation is maintained by Mark Pilgrim (f8dy@netaxs.com).  It
  340. draws information and phrasing from many sources, including:
  341.   - the original welcome message for alt.sources.mac, by Dave Nebinger
  342.   - the original welcome message for alt.sources, by Jonathan Kamens
  343.   - the original RFD for alt.sources.mac, by Dave Nebinger
  344.   - the beta FAQ compilation for alt.sources.mac, by Peter N. Lewis
  345.  
  346.  
  347. (5.3) ObSource
  348.  
  349. Since alt.sources.mac is exclusively for posting Macintosh source code, here
  350. is some C code to convert a char to its rot-13 equivalent:
  351.  
  352. unsigned char Rot13(unsigned char theChar)
  353. {
  354.   return (((theChar|0x20)<'a') || ((theChar|0x20)>'z')) ? theChar :
  355.          ((theChar|0x20)<='m') ? theChar+13 : theChar-13;
  356. }
  357.  
  358.