home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / answers / apple2 / part1 next >
Internet Message Format  |  1993-12-04  |  37KB

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!usc!cs.utexas.edu!uunet!caen!dmag
  2. From: dmag@caen.engin.umich.edu (Dan DeMaggio)
  3. Newsgroups: comp.sys.apple2,news.answers
  4. Subject: comp.sys.apple2 - Frequently Asked Questions (and answers) part 1 of 2
  5. Supersedes: <a1_751507756@caen.engin.umich.edu>
  6. Followup-To: comp.sys.apple2
  7. Date: 4 Dec 1993 04:31:38 GMT
  8. Organization: University of Michigan Engineering, Ann Arbor
  9. Lines: 715
  10. Approved: news-answers-request@MIT.Edu
  11. Distribution: world
  12. Expires: 7 Jan 1994 04:30:30 GMT
  13. Message-ID: <a1_754979430@caen.engin.umich.edu>
  14. Reply-To: dmag@umich.edu
  15. NNTP-Posting-Host: ri.engin.umich.edu
  16. Summary: What you need to know about comp.sys.apple2 and comp.binaries.apple2,
  17.          two newsgroups dedicated to the Apple ][ family of computers.
  18. Originator: dmag@ri.engin.umich.edu
  19. Xref: senator-bedfellow.mit.edu comp.sys.apple2:65886 news.answers:15462
  20.  
  21. Archive-name: apple2/part1
  22. Last-modified: 03 Dec 1993
  23. Version: 3.4.1
  24.  
  25.  
  26.  
  27. ----------------------------------------------------------------------
  28.  
  29. Date: 1/1/93
  30. From: dmag@umich.edu
  31. Subject: The FAQ (Frequently Asked Questions) post
  32.  
  33.       Hi! Welcome to the comp.sys.apple2 newsgroup!
  34.       This article contains the answers to some Frequently Asked Questions
  35.  (FAQ) often seen in comp.sys.apple2. I am posting this article (once every
  36.  three weeks or so--but once a week in September) to help reduce the volume in
  37.  this newsgroup and to provide hard-to-find information of general interest.
  38.       I hope it answers some of your questions. If you have other questions,
  39.  feel free to e-mail me.
  40.      Dan DeMaggio (dmag@umich.edu)
  41.       P.S. On a suggestion, I've converted this to the news archive format (I
  42.  think).
  43.  
  44.         Table of contents
  45.         -----------------
  46. Part I: The Net
  47.  - What is c.s.a2? What is INFO-APPLE?                    (Why is there air?)
  48.  - What is c.b.a2?                                     (Binaries only please)
  49.  - FTP sites and e-mail servers      (or How To Get Great Programs for Free!)
  50.  - File name extensions                                    (How to ID a file)
  51.  - Archivers and decoders                          (What they are useful for)
  52.  - Downloading                         (Term programs and download protocols)
  53.  - Field guide to file formats                     (How to ID a file part II)
  54.  
  55. Part II: Apple stuff
  56.  - What is an Apple II?                 (common configurations and additions)
  57.  - Frequently Asked Questions   (IBM+HFS disks, HD drives, computer versions)
  58.  - GS System 6.0 Notes                                     (from the experts)
  59.  - What the Apple II can do                 (ideas for adding to your system)
  60.  - Apple II resources                              (Places supporting the II)
  61.  - troubleshooting           (90% of problems can be solved with these hints)
  62.  - SCSI Notes                                    (Notes on dealing with SCSI)
  63.  
  64.  
  65.       New items are marked with:
  66. ---- NEW OR CHANGED
  67.  
  68.       FTP-able items are marked like this:
  69. FTP:  apple2.archive.umich.edu /apple2/faq/faq1.txt
  70.       Note that the apple2.archive.umich.edu site is often loaded down, so see
  71.  the section on FTP for other sites, including mirrors of umich.
  72.  
  73. ------------------------------
  74.  
  75. Date: 8/8/93
  76. From: dmag@umich.edu
  77. Subject:  What is comp.sys.apple2?  What is INFO-APPLE?
  78.  
  79.       Comp.sys.apple2.* are a series of Usenet newsgroup that created for the
  80.  discussion of the Apple II series of computers. This forum provides a way for
  81.  interested people to compare notes, ask questions, and share insights about
  82.  Apple IIs. Each message gets passed on to tens of thousands of systems around
  83.  the world that make up Usenet. Please do not cross-post unnecessarialy.
  84.  
  85. comp.sys.apple2                 Discussion about Apple II micros.
  86. comp.sys.apple2.comm            Apple II data communications.
  87. comp.sys.apple2.gno             The Apple IIGS GNO multitasking environment.
  88. comp.sys.apple2.marketplace     Buying, selling and trading Apple II equipment.
  89. comp.sys.apple2.programmer      Programming on the Apple II.
  90. comp.sys.apple2.usergroups      All about Apple II user groups.
  91. comp.sources.apple2          +  Source code-only postings for the Apple II.
  92. comp.binaries.apple2            Binary-only postings for the Apple II computer.
  93. alt.emulators.ibmpc.apple2      discussion of an IBM program that emulates a II
  94. (+) c.sources.a2 is the only group that is moderated.
  95.  
  96.  
  97.  
  98.  
  99.       INFO-APPLE is a mailing list that is maintained on some networks other
  100.  than Usenet. Comp.sys.apple2 messages are sent to INFO-APPLE and INFO-APPLE
  101.  messages are sent to comp.sys.apple2. The central location of INFO-APPLE is
  102.  at apple.com.
  103.      Thank you, Apple Computer!
  104.       Comp.sys.apple2 is also accessed by users of ProLine bulletin board
  105.  systems. ProLine systems run, appropriately enough, on Apple II computers.
  106.  ProLine users account for a large group of participants on comp.sys.apple2.
  107.  Using ProLine's Conference System, users can read and reply to articles on
  108.  comp.sys.apple2, as well as many other Usenet newsgroups. And since ProLine
  109.  systems have UUCP/Internet access, users can also exchange electronic mail
  110.  with people world-wide.
  111.       To subscribe (or (sadly) unsubscribe) to INFO-APPLE, send your request to
  112.  the info-apple-request@apple.com address. Please do not send subscription
  113.  requests to info-apple@apple.com - it is doubtful that you will achieve what
  114.  you are attempting!!!! There is no need to subscribe to INFO-APPLE when you
  115.  are getting comp.sys.apple2, since the messages are identical.
  116.       To post a message to the thousands of readers of INFO-APPLE (and
  117.  comp.sys.apple2) subscribers send their messages to one of the following
  118.  addresses: info-apple@apple.com OR comp-sys-apple2@ucbvax.berkeley.edu. To
  119.  post programs to be used by thousands of grateful readers, send the
  120.  appropriately formatted mail to one of the following addresses: Ececutable
  121.  code in BSQ format (with text describing what it is in the first message) to
  122.  comp-binaries-apple2@ucbvax.berkeley.edu. Source code in AAF format should go
  123.  to comp-sources-apple2@ucbvax.berkeley.edu
  124.      [There is no need for comp.sys.apple2 users to do this - they can use the
  125.  standard posting features of Usenet.]
  126.       On BITNET, INFO-APP@NDSUVM1 (aka VM1.Nodak.Edu) is available through the
  127.  LISTSERV on NDSUVM1 to distribute the Apple II discussion mail and
  128.  APPLE2-L@BROWNVM distributes messages dealing with programs. They work by
  129.  maintaining a private list of users who wish to see the messages in their
  130.  mailbox.
  131.  
  132. ------------------------------
  133.  
  134. Date: 1/1/93
  135. From: dmag@umich.edu
  136. Subject: comp.binaries.apple2 and comp.sources.apple2
  137.  
  138.       Comp.binaries.apple2 is a newsgroup used to distribute public domain,
  139.  freeware, and shareware Apple II software (executables, pictures, sounds,
  140.  etc...). Software distributed on comp.binaries.apple2 is expected to be a
  141.  BinSCII text file of ShrinkIt archives. [See later in the FAQ for information
  142.  on getting these programs.] ALWAYS include text in the first message that
  143.  describes what is in the BSQ file. Include such things as what type of
  144.  computer it runs on and what it does.
  145.       [Public Domain programs may be used and copyied freely. FreeWare is the
  146.  same, except that the origninal owner retains the Copyright. ShareWare
  147.  programs can be distributed freely, and tried out for free, but if you use it
  148.  a lot, you are expected to help pay for it.]
  149.       Comp.sources.apple2 is a newsgroup used to distribute public domain,
  150.  freeware, and shareware Apple II source code. The posts in
  151.  comp.sources.apple2 should be in Apple Archive Format. Contact
  152.  jac@paul.rutgers.edu for details.
  153.       Discussions concerning the software posted in these groups, or the
  154.  methods of locating, decoding, or accessing this software, or questions on
  155.  locating archive sites of this software, or any OTHER discussions are to be
  156.  held in comp.sys.apple2. If someone DOES either intentionally or accidentally
  157.  post to these groups, please respond only in Email - do not compound the
  158.  problem!
  159.      Note: Distributing commercial software on the net is a crime - just don't
  160.  do it!
  161.  
  162. ------------------------------
  163.  
  164. Date: 1/1/93
  165. From: dmag@umich.edu
  166. Subject: E-mail to other services
  167.  
  168.       Compuserve: Enter the Compuserve numerical address, replacing commas with
  169.  periods, and tack "@compuserve.com" to the end. America Online: Enter the
  170.  America Online address, followed by "@aol.com". Do not use uppercase letters
  171.  in the AOL name.
  172.  
  173. ------------------------------
  174.  
  175. Date: 6/7/93
  176. From: dmag@umich.edu
  177. Subject: Anonymous FTP sites and e-mail servers
  178.  
  179.       FTP stands for File Transfer Protocol. It allows one Internet computer to
  180.  access files on another site. Many sites archive software and make it
  181.  available via Anonymous FTP. The following is a list of sites with Apple //
  182.  related files.
  183.  
  184. THE BIG SEVEN
  185. =============
  186. (All the shareware, freeware, & PD ware you could possibly want)
  187.  
  188. Site name                Directory
  189. ---------                ---------
  190. apple2.archive.umich.edu /archive/apple2 (Note 1)
  191. brownvm.brown.edu        LISTSERV.193 (Note 2)
  192. cco.caltech.edu          /pub/apple2 (mostly GS, but some non-GS)
  193. f.ms.uky.edu             /pub/appleII
  194. grind.isca.uiowa.edu     /apple2
  195. plains.nodak.edu         /pub/apple2
  196. wuarchive.wustl.edu      /systems/apple2
  197.                          /usenet/comp.binaries.apple2
  198.                          /usenet/comp.sources.apple2
  199.  
  200. Note 1: The umich site is hard to FTP to directly. Use Gopher
  201. (type "gopher gopher.itd.umich.edu"), AFS (type "cd
  202. /afs/umich.edu/group/itd/archive/apple2"), or use these mirrors:
  203.  wuarchive.wustl.edu:/mirrors/archive.umich.edu
  204.  info2.rus.uni-stuttgart.de:/afs/umich.edu/group/itd/archive
  205.  archive.orst.edu:/pub/mirrors/archive.umich.edu
  206.  
  207. Note 2: Files on brownvm.brown.edu are stored by serial number.  For a
  208. human-readable directory, send e-mail with the text "help" to
  209. listserv@brownvm.brown.edu.
  210.  
  211. Smaller sites
  212. =============
  213. calvin.sfasu.edu         /pub/apple2 (HyperC, a few other things)
  214. cs.bu.edu                /PC/APPLE (a little bit of everything)
  215. ftp.apple.com            /dts/aii (sys software, tech notes)
  216. ftp.cc.utexas.edu        /gifstuff (some Apple GIF programs)
  217. ftp.hawaii.edu           /incoming/apple2 (a couple of games)
  218. iskut.ucs.ubc.ca         /pub/apple (Kermit, BinSCII, unshrinkit)
  219. pindarus.cs.uiuc.edu     /pub/apple2 (GNO utils and info)
  220. slab.slip.uiuc.edu       /apple2 (GScii, fonts, GS sys 6)
  221. ucrmath.ucr.edu          /PC/apple2 (LISA assembler)
  222.  
  223. Archives of comp.sources.apple2
  224. ===============================
  225. wuarchive.wustl.edu      /usenet/comp.sources.apple2 (complete!)
  226. cnam.cnam.fr             /pub/Archives/comp.sources.apple2 (incomplete)
  227. hp4nl.nluug.nl           /pub/newsarchive/comp/sources/apple2 (incomplete)
  228. mcsun.eu.net             /pub/newsarchive/comp/sources/apple2 (incomplete)
  229. nic.funet.fi             /pub/archive/comp.sources.apple2 (complete?)
  230.  
  231. Archives of comp.sys.apple2
  232. ===========================
  233. relay.cs.toronto.edu     /pub/lists.1989 (1989 only)
  234. wsmr-simtel20.army.mil   PD2:<ARCHIVES.APPLE> (1990 and 1991 only)
  235.  
  236. Kermit-only archives
  237. ====================
  238. watsun.cc.columbia.edu   /kermit/a (the OFFICIAL source for Kermit)
  239. j.cc.purdue.edu          /kermit/appleII (an old version)
  240. oswego.oswego.edu        /pub/kermit/appleII (an old version)
  241. shark.nosc.mil           KER*MIT.
  242. syr.edu                  /software/kermit/appleII (an old version)
  243.  
  244. Apple II-related e-mail servers
  245. ===============================
  246. Internet address                 BITNET address
  247. ----------------                 --------------
  248. LISTSERV@brownvm.brown.edu       LISTSERV@BROWNVM (APPLE2-L archives)
  249. LISTSERV@utarlvm1.uta.edu        LISTSERV@UTARLVM1 (games from APPLE2-L)
  250. archive-server@plains.nodak.edu  FILESERV@PLAINS (lotsa stuff)
  251. LISTSERV@vm1.nodak.edu           LISTSERV@NDSUVM1 (INFO-APPLE mailing list)
  252.  
  253. Users without USENET access may subscribe to comp.sys.apple2/INFO-APPLE by
  254. writing to info-apple-request@apple.com.
  255.  
  256. Generic FTP-by-email servers
  257. ============================
  258. BITFTP@PUCC (BITNET only)
  259. ftpmail@decwrl.dec.com
  260.  
  261.  
  262.  
  263. Subtopic:  A quick blurb on Anonymous FTP
  264. ================================
  265.       FTP is a protocol for tranfer between different computers on the
  266.  internet. Most Proline sites are not directly on the internet, and cannot do
  267.  regular FTP. Anonymous FTP is where you use "anonymous" as your username, and
  268.  your e-mail address as your password. As a guest, you must not abuse your
  269.  privileges: Only use the site at off peak times: i.e. after 6pm LOCAL time.
  270.  (Yes, these sites are all over the world: fr=France, jp=Japan). Your system
  271.  administrator can help you if you are not familiar with FTP.
  272.       You can use the following commands in FTP:
  273.  
  274. Command                Explanation
  275. -------------          -------------------------------------
  276. type binary            set binary mode to on for .SHK, .tar,
  277.                        or .Z files.  (Not needed for .BSQ files)
  278. ls                     list the files in the current remote directory
  279. cd /pub/apple2         to change the current directory
  280. get file.name          to get a file from the remote system
  281. put file.name          to send a file to the remote system
  282. quit                   leave FTP
  283.  
  284.     
  285.  
  286. Subtopic:  Apple II-related Electronic Mail servers
  287. ================================
  288.      [users who have access to FTP should not need to use the e-mail servers]
  289.       APPLE2-L is an software archive of Apple II programs provided by a BITNET
  290.  mail server. To get help, send mail with a body of 'help' to
  291.  LISTSERV@BROWNVM.BITNET. You can also send the message 'INDEX APPLE2-L' for a
  292.  long listing of the Apple 2 archives. To get a program (BinSCII in this
  293.  example), send the message 'get APPLE2-L 89-01123'. The file will come by
  294.  return e-mail in text format. Most of the files come in BinSCII format
  295.  (except BinSCII, of course-- it's in EXE format). Note that many sites have a
  296.  maximum size on e-mail, so be sure to check the size of the file (the nrecs
  297.  column) before getting it. The server may break up files for you (and you
  298.  must piece them together before decoding them).
  299.       Chris Chung <CHRIS@BROWNVM> administers APPLE2-L. (Thanks Chris!)
  300.       There is also the server at plains.nodak. Send e-mail with the body
  301.  'help' or 'index appleII' to archive-server@plains.nodak.edu for details.
  302.       Note that these e-mail servers must do more work than FTP servers, and
  303.  they can cause quite a bit of traffic on the networks. Do not abuse them by
  304.  requesting large files. For alternatives, check the 'Apple II resources' part
  305.  of the FAQ.
  306.  
  307. ---------Internet-------------             ----------BITNET--------
  308. archive-server@plains.nodak.edu            FILESERV@PLAINS (BITNET)
  309. KERMSRV@cuvmb.cc.columbia.edu              KERMSRV@CUVMA (BITNET)
  310. LISTSERV@brownvm.brown.edu                 LISTSERV@BROWNVM (BITNET)
  311. LISTSERV@utarlvm1.uta.edu                  LISTSERV@UTARLVM1 (BITNET)
  312.        {umn-cs, ogicse, uunet}!plains!archive-server (UUCP)
  313.  
  314.  
  315.       Note: Most games from comp.binaries.apple2 are stored on UTARLVM1, rather
  316.  than BROWNVM.
  317.  
  318. Subtopic:  Archie, the archive searcher
  319. ================================
  320.       There is a program called archie that allows you to search many archives
  321.  quickly. Look for the program 'archie' or 'xarchie' at your site, or you can
  322.  telnet (login as archie) to:
  323.  
  324. archie.rutgers.edu   128.6.18.15   (Rutgers University)
  325. archie.unl.edu       129.93.1.14   (University of Nebraska in Lincoln)
  326. archie.ans.net       147.225.1.2   (ANS archie server)
  327. archie.mcgill.ca     132.206.2.3   (Canada server, original archie site)
  328. archie.au            139.130.4.6   (Australian server)
  329. archie.funet.fi      128.214.6.100 (European server in Finland)
  330. archie.doc.ic.ac.uk  146.169.11.3  (UK/England server)
  331. archie.cs.huji.ac.il 132.65.6.15   (Israel server)
  332. archie.wide.ad.jp    133.4.3.6     (Japanese server)
  333.  
  334.      
  335.  
  336. ------------------------------
  337.  
  338. Date: 6/7/93
  339. From: dmag@umich.edu
  340. Subject: Some common filename extensions
  341.  
  342.       Many times, people put filename extensions (extra characters at the end
  343.  of a filename) to denote what type of file it is. Please note that these are
  344.  just accepted standards. If a file does not indicate it's type, see the
  345.  'Field guide to file formats'. The following is a table of some common
  346.  filename extensions. See the section on 'Archivers and decoders' for programs
  347.  that will deal with these files.
  348.  
  349. Extension   What is it?  (What program do I use?)
  350. ---------  ---------------------------------------------------------------
  351.  
  352.  .aaf   [TEXT] Apple Archive Format for source code (aaf.unpacker)
  353.  .ACU   NuFX (Shrinkit)
  354.  .ARC   ARC Archive (IBM ARC, GS Shrinkit, //e Angel or DeArc2E)
  355.  .CPT   Compactor Pro archive (Compactor Pro on a Mac only)
  356.  .BSC   BinScii file. [TEXT]  (BinScii)
  357.  .BSQ   BinScii'ed NuFX file. [TEXT]  (BinScii, Shrinkit on the result)
  358.  .BXY   NuFX archive with a Binary II header.  (Shrinkit)
  359.  .BNY   BLU archive. (Shrinkit)
  360.  .BQY   NuFX with BLU header. (Shrinkit)
  361.  .BNX   NuFX with BLU header. (Shrinkit)
  362.  .exe   Executioner file [TEXT]. May only work in DOS 3.3.
  363.  .GIF   Graphics Interchange Format: Compressed picture.
  364.         (IIGIF for //e, many programs for all other computers)
  365.  .HQX   Mac BinHex file. [TEXT] (BinHex on Mac or GSCII+)
  366.  .JPG   Newer graphics format. (only Unix/IBM/etc viewers)
  367.  .JPEG  Newer graphics format. (only Unix/IBM/etc viewers)
  368.  .LZH   LZH Archive (IBM/Amiga LZH program, //e Angel)
  369.  .LHA   LHA Archive (IBM/Amiga LZH program, //e Angel)
  370.  .QQ    BLU archive.  (Shrinkit)
  371.  .SEA   Self-extracting archive (Might be Mac, Might be Shrinkit archive)
  372.  .SIT   Mac StuffIt archive. (Stuffit on Mac or GS ShrinkIt)
  373.         GS Shrinkit will not decode StuffIt Deluxe files.
  374.  .SHK   NuFX archive. (Shrinkit)
  375.  .SDK   NuFX with a shrunk disk image. (Shrinkit)
  376.  .tar   Unix Tape Archive (Unix tar [with -xvf option, GS EXE tar])
  377.  .txt   [TEXT] An ASCII text file: usually english text.
  378.  .TIFF  Graphics format (GS SHR Convert)
  379.  .uu    Unix uuencode file [TEXT] (//e uudecode, Unix uudecode)
  380.  .ZOO   IBM Zoo Archive (GS Shrinkit or IBM ZOO program, //e Angel)
  381.  .ZIP   IBM Zip Archive (GS EXE Unzip, IBM PKUNZIP, Unix unzip, //e Angel)
  382.  .Z     Compressed file (GS Shrinkit, Unix uncompress, //e Angel)
  383.  
  384.  
  385.       All of these types, except the ones marked [TEXT] are BINARY files.
  386.  Binary files cannot be sent over e-mail, posted to the newsgroups or FTP'd in
  387.  text mode. You must FTP them in binary mode (see the section on FTP). You can
  388.  also download them using kermit, X-,Y- or Z-Modem.
  389.       Generally, anything labeled as 'Archive' above will contain multiple
  390.  files, and even subdirectories. Most archives are also in compressed format.
  391.       Sometimes you will find multiple filename extensions. Simply take the
  392.  filename extensions apart one at a time and you should be able to reconstruct
  393.  the original file. (i.e. somefile.bsq.tar.Z would mean: uncompress, untar,
  394.  unbinscii, then unShrink to get the original file!)
  395.  
  396. ------------------------------
  397.  
  398. Date: 1/1/93
  399. From: dmag@umich.edu
  400. Subject: Archivers and decoders
  401.  
  402.  
  403. Subtopic:  BinSCII
  404. ================================
  405.       BinScii converts binary files to text files and back. Binary files
  406.  contain pictures, computer programs, etc. Text files usually contain human
  407.  readable text (like this file), but a BinSCII file just looks like a jumble
  408.  of letters and symbols. A BinScii text file is larger than the original
  409.  binary file. Binscii is needed to transfer programs across the network when
  410.  there is no binary mode (like the Usenet newsgroups and e-mail).
  411.       When turning a binary file into text, BinSCII will output a series of
  412.  files. Each file contains a segment of the original program encoded in
  413.  BinSCII format. These segments are small enough to be posted or e-mailed
  414.  without clogging the network. (Actually, they are usually posted 3 at a time
  415.  to save bandwidth).
  416.       When re-creating a binary file from the BinScii segments, all one has to
  417.  do is collect ALL the segments and run them through BinScii. Each segment has
  418.  a header that tells BinScii which segment it is. BinScii is intelligent
  419.  enough to wade through all extraneous text (i.e. newsgroup headers, etc) and
  420.  find the segments. It does not matter what order the segments are in, and the
  421.  segments can be in different files. The only thing you have to remember is
  422.  that BinScii does not check to see if ALL of the segments have been accounted
  423.  for. If there are segments missing, the program will not work, or more likely
  424.  you will get a 'file corrupted' error when unshrinking.
  425. FTP:  apple2.archive.umich.edu /apple2/8bit/archivers/binscii.exe
  426. FTP:  ?
  427.       GS users can use GSCII+, an NDA version of Binscii. GSCII+ can also
  428.  encode/decode several other formats.
  429. FTP:  apple2.archive.umich.edu /apple2/gs/archivers/gscii.bsc
  430.      [ Note that most files on the network are NuFX archives that have been
  431.  BinSCII'ed so they can be posted. After running Binscii, you will still need
  432.  to run ShrinkIt on the resulting file.]
  433.       For those of us on Unix boxes who are able to transfer binary files to
  434.  our Apple ][, SciiBin can reduce the time spend downloading. It is a
  435.  decode-only version of BinSCII written in C. The idea is that you compile
  436.  this on your Unix box, and run your BinScii files from comp.binaries.apple2
  437.  through it. It will re-create the original (smaller) file. This works great
  438.  if there is a NuFX archive in the BinSCII file, but can cause problems if
  439.  BinSCII was applied directly to ProDos executable files. (Unix has no way of
  440.  storing the ProDos file type and aux type of a file, so they simply get lost.
  441.  See the section on filetypes.
  442. FTP:  wuarchive.wustl.edu /?
  443.       If you need a Unix BinSCII encoder, Bsc will do the trick. The source
  444.  code is in "Apple archive format".
  445. FTP:  cco.caltech.edu /pub/apple2/source/bsc.aaf ?
  446. FTP:  apple2.archive.umich.edu /apple2/unix/bsc.aaf
  447.  
  448. Subtopic:  ShrinkIt and NuFX archives
  449. ================================
  450.       ShrinkIt is an Apple II program which takes one or more Apple II ProDOS
  451.  files or disks and 'archives' them into a single file (called a NuFX
  452.  archive). It also stores all the vital ProDos information, such as filetype
  453.  and auxtype. Usually these files are denoted by putting a ".SHK" extension on
  454.  the archive. ShrinkIt can also shrink an entire disk into a file (extension
  455.  ".SDK"), but this is only used when the disk is not ProDos. ShrinkIt is also
  456.  a menu driven utility that compresses/extracts, but also formats disks,
  457.  copies files, etc. ShrinkIt can also extract programs with Binary II headers,
  458.  and files in BLU archives.
  459. FTP:  apple2.archive.umich.edu /apple2/8bit/archivers/shrinkit.3.3.exe.bsc
  460.       GShk is a version of ShrinkIt for GS computers. This is even more of a
  461.  wonder utility in that it extracts many different archive types (Unix
  462.  compress, PC Arc, Mac StuffIt, Apple Single). Files encoded with GShk are
  463.  usually smaller than those encoded with ShrinkIt, but can still be extracted
  464.  with ShrinkIt (except files with resource forks).
  465.       ShrinkIt+ and UnShrinkIt+ are programs for the Apple II+ that allow an
  466.  Apple II+ user to create NuFX archives and extract from them. Autounshrink is
  467.  a NuFX extractor that attempts to recover from errors within an NuFX file.
  468.  
  469. Subtopic:  Executioner
  470. ================================
  471.       Executioner was the standard program previous to BinSCII for converting
  472.  Apple II files into text to be mailed/posted. It is no longer considered the
  473.  standard for most transferals of Apple II binary files. Presently,
  474.  Executioner is typically only used to distribute BinSCII. Some older files in
  475.  the various archives may also be encoded with this program. Many of them will
  476.  not work under ProDos.
  477.       To translate an Executioner text file to an Apple II file required that
  478.  you delete the mail headers/trailers, translated the newlines into carriage
  479.  returns, download the file to your Apple II and from Applesoft Basic, type
  480.  the command 'EXEC <filename>' where <filename> is the name of the file you
  481.  downloaded.
  482.  
  483. Subtopic:  Apple Archive Format (aaf)
  484. ================================
  485.       Apple Archive Format was invented as a standard way to post source code
  486.  to comp.sources.apple2. The C and Basic source code to aaf unpackers are
  487.  available on the various FTP sites, in aaf format. Fortunately, files in aaf
  488.  format can be turned back into source code with a simple text editor. Just
  489.  break the file up into component files and remove the first character of each
  490.  line.
  491. FTP:  apple2.archive.umich.edu /apple2/unix/*.aaf
  492.  
  493. Subtopic:  Net standard formats
  494. ================================
  495.       There are several formats that are used widely on the Internet. The most
  496.  common in FTP sites are tar (.tar) and compress (.Z). To undo a Tape ARchive,
  497.  type 'tar -xvf filename.tar'. To undo a compress, type 'uncompress
  498.  filename.Z'. Since tar does not make the file smaller, and compress can only
  499.  compress 1 file, many times you will find files that are 'tarred an
  500.  feathered'. They have a '.tar.Z' extension. Just run uncompress then un-tar
  501.  the result.
  502.       To distribute binaries on the net, most other groups use uuencode (c.b.a2
  503.  uses BinSCII). To return them to normal, type 'uudecode filename'. Note that
  504.  uuencoded things were not meant to be split up and posted, so when getting
  505.  multiple parts, you will have to paste them together and run them through
  506.  uudecode. (BinSCII is a lot smarter, that's why we use it on c.b.a2.) BinSCII
  507.  is better because 1) It stores the ProDos filetype, etc. 2) It splits the
  508.  file into 12K chunks, 3) It does a CRC checksum on each chunk.
  509.       Most of these 'Unix' standard formats are available on the Apple. For
  510.  example, ShrinkIt GS will uncompress files, there is a uudecode for the //e,
  511.  and Tar is available as a GS shell executable.
  512. FTP:  apple2.archive.umich.edu /apple2/8bit/util/dearc.*
  513.  
  514. Subtopic:  A quick note about ProDos filetypes
  515. ================================
  516.       ProDos keeps some information about a file's type. Files can be text
  517.  (TXT), binary (BIN), executable (SYS), fonts (FON), etc. Most other file
  518.  systems do not have a place to store this information, so it may get 'lost'
  519.  when you upload the file. Similarly, when you download a file, you may not
  520.  know the file type. Most comm programs will use some default. For NuFX
  521.  archives, this is not a big deal, since you can still unpack an archive if
  522.  the filetype is wrong (and the archive stores the filetype of the files
  523.  inside the archive). For other files, you may need to change the file's type.
  524.  One utility I recommend is File Attribute Zapper II.
  525. FTP:  apple2.archive.umich.edu /apple2/8bit/util/fazz.2.3.bsq
  526.  
  527. Program        Format   Author
  528. ---------------------------------------------------------------------------
  529. Nulib v3.21      C      Andy McFadden  (fadden@uts.amdahl.com)
  530. SciiBin v3.10    C      Marcel Mol, Dave Whitnet, Bruce Kahn
  531. Bsc v1.2         C      Neil Parker
  532. Executioner      A      Glen Bredon
  533. BinSCII v1.0.3   A      David Whitney  (davewh@microsoft.com)
  534. ShrinkIt v3.3    A      Andy Nicholas  (shrinkit@apple.com)
  535. (Un)ShrinkIt+    A      Andy Nicholas  (shrinkit@apple.com)
  536. AutoUnShrink     A      Andy Nicholas  (shrinkit@apple.com)
  537. GShk v1.1        G      Andy Nicholas  (shrinkit@apple.com)
  538. GSCII+ 2.3.1     G      Darek Taubert  (dat33228@uxa.cso.uiuc.edu)
  539.  
  540. Format:
  541.   C - Distributed as source code written in C.
  542.   A - Executable, runs on most Apple //s.
  543.   G - Executable, runs on GS only.
  544.  
  545.      |Type| NuFX | Bin  | uuen-| com-  |.ZOO | Bin | LZH/| Stuff| ARC | Other|
  546. Program | |      | SCII | code | press |     | Hex | LHA | -It  |     |      |
  547. --------|-|------|------|------|-------|-----|-----|-----|------|-----|------|
  548. Binscii |E|      |   X  |      |       |     |     |     |      |     |      |
  549. Shrinkit|E|   X  |      |      |       |     |     |     |      |     |      |
  550. DeArc   |E|      |      |      |       |     |     |     |      |  D  |      |
  551. Angel[1]|E|      |      |      |   X   |  X  |     |  X  |      |  X  | .ZIP |
  552. GShk    |G|   X  |      |      |   D   |  D  |     |     |  D   |  D  |      |
  553. GSCII+  |G|      |   X  |   X  |       |     |  D  |     |      |     | .AAF |
  554. sscii   |X|      |   X  |   X  |       |     |  X  |     |      |     |      |
  555. PMPUnzip|X|      |      |      |       |     |     |     |      |     | .ZIP |
  556. LHext   |X|      |      |      |       |     |     |  D? |      |     |      |
  557. BSC     |C|      |   E  |      |       |     |     |     |      |     |      |
  558. Nulib   |C|   X  |      |      |       |     |     |     |      |     |      |
  559. SciiBin |C|      |   D  |      |       |     |     |     |      |     |      |
  560.  
  561. (Key:   E = Encode only,    D = Decode only,  X = Encode and Decode)
  562. (Type:  E = Apple //e,  G = GS Only,  X = GS EXE file, C = C Source code)
  563.  
  564. [1] Angel is pretty Buggy, but it's worth a try.
  565.  
  566.     
  567.  
  568. ------------------------------
  569.  
  570. Date: 6/7/93
  571. From: dmag@umich.edu
  572. Subject: How to get stuff off the net
  573.  
  574.       This is a tricky question. You will have to look around for what
  575.  resources you can get your hands on. You can break it down into two steps.
  576.  Step 1: Get the file to your online account. Step 2: get the file to your ][.
  577.       Step 1:
  578.       -Get it via FTP (See section on FTP.)
  579.       -get it off of comp.binaries.apple2 (see local readnews [rn] man page)
  580.       -Have someone e-mail you the file.
  581.       -Find the file in the downloads section of a BBS/online service.
  582.       Once you have the file on your online account, you may want to run
  583.  uudecode, uncompress, tar, SciiBin, Nulib, etc on the file. See the section
  584.  on Decoders and archivers for details. By far, most Apple // files are
  585.  transferred around in either .SHK (NuFX) or .BSQ format. I recommend getting
  586.  SciiBin to turn your .BSQ files into .SHK files for 3 reasons: 1) The archive
  587.  is smaller than the original files, and a LOT smaller than BinScii files. 2)
  588.  One file can hold all the files and documentation for the program. 3) The
  589.  archive keeps the ProDos filetype information.
  590.       Step 2 also has a variety of options:
  591.  a) If your ][ has a modem, you may be able to download it directly. There are
  592.      a variety of downloading protocols (both sides must support the same
  593.      protocol). Kermit is slowest, but can work over a 7 bit network. X-Modem
  594.      is faster and available just about everywhere. Y-modem and Z-modem are
  595.      even better. (the Unix command for zmodem is usually 'sz'). Sometimes
  596.      downloading can be tricky if you are not familiar with your terminal
  597.      program.
  598.  b) If you have access to a Mac or IBM that is on the internet/has a modem,
  599.      see the Q & A section on ways to tranfer files from those computers.
  600.       Once you get the file to your Apple, you have to undo any encoding (i.e.
  601.  run ShrinkIt). Alternately, you may have to change the ProDos file type. One
  602.  easy way is to use File Attribute Zapper II (FAZII).
  603.  
  604. Subtopic:  Communications programs
  605. ================================
  606.       If you go for route (a) above, you will need a communications program on
  607.  your Apple //. Most of the time, the program is simply a 'dumb terminal'
  608.  putting characters on the screen and sending them out the serial port to the
  609.  modem. There are two areas where the program actually DOES something:
  610.  terminal emulation and downloading. Emulation is where your computer pretends
  611.  to be a certain type of terminal. By far, the standard is VT-100. This allows
  612.  the other computer to do nice effects on your screen, like clear it or move
  613.  text around. If your program doesn't support it, your screen may look funny,
  614.  and you will see ]'s and ;'s where the remote computer is trying to make the
  615.  screen look nice. IBM's use a special character set and variation of VT-100
  616.  called ANSI. ProTerm supports a subset of this (no graphics), and also
  617.  another format called ProTerm Special Emulation (PSE). [Don't you just love
  618.  standards?]
  619.       The other time your term program matters is when you are trying to
  620.  download. By far, the Apple ][ standard is X-modem. It allows a file to be
  621.  sent across a modem with an error correction protocol. New variations are
  622.  Y-modem and Z-modem. These are very, very nice and should be used where
  623.  possible. Note that both sides have to support it in order to use it. There
  624.  is also a protocol called Kermit. You are probably better off using X-modem,
  625.  but sometimes it is useful.
  626.  
  627.  
  628.  
  629. Program   Comp Emulations     Protocols             Note
  630. ------------------------------------------------------------------------------
  631. ProTerm    E$  PSE, VT-100     Kermit, X,Y,Z-modem  From InSync
  632. Kermit-65  E   VT-100          Kermit, X-modem      Hard to use,Works on ][+
  633. Z-Link     E   VT-100          X-modem              Good.
  634. CommSys    E   none            X-modem              Works on ][+
  635. TIC        E$  VT-52 (+)       X-modem              For hackers. From Q-Labs
  636. Agate      E   mono ANSI       X,(Y,Z rec'v only)   Unpacks ZIP, Buggy
  637. ColorTerm  GS  color ANSI      X-modem              Desktop based
  638. MegaTerm   GS  color ANSI      none                 ProDOS 8
  639. ANSITerm   GS$ color ANSI, PSE X,Y,Z-modem          Editor, scrollback, etc.
  640. SnowTerm   GS  VT-100 (+)      none                 Desktop based
  641. FreeTerm   GS  none            X-modem              Desktop based
  642. GenComm    GS  none            none                 Text, Shell Compat.
  643. GSVT       GS  VT-100          none                 Desktop
  644. GTerm      GS  color ANSI      none                 Written in BASIC/ML
  645. Telcom     GS  VT-100, PSE     X, (Y rec'v only)    Shell compat
  646. ----------Key:---------
  647. Key: $ = A commercial program
  648. Computer:  E = works on GS and //e, GS = only works on GS
  649.  
  650. See the resources section for where to buy the commercial programs.
  651.  
  652.  
  653.       All of the non-commercial programs are available on the different FTP
  654.  sites. If you don't have a comm program already, your best bet is to have
  655.  someone mail you one on a disk.
  656.      *T 1/1/93,dmag@umich.edu,Field guide to file formats
  657.       Here is a simple guide to help you identify a file. You should always go
  658.  by filename extension first, but not everybody uses those. In Unix, you can
  659.  use the 'head' command to look at the first couple of lines of a file. If it
  660.  turns out to be a binary file, you may be in for a nasty surprise. You may
  661.  want to use the Unix 'file' command to find out if it is a text file or not
  662.  first. Once you have identified the file, see the section on filename
  663.  extensions for how to deal with it.
  664.       If there are lines in the file that look like this (there can be other
  665.  text before it--search for 'FiLeStArT'):
  666.  
  667. FiLeStArTfIlEsTaRt
  668. ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789()
  669. GBINSCII        AQhmAAAAA8)4MIAI02DA9ARMQEDtAQhmAIVZ
  670. gYITA6u7xADA0MjM3YTNBlDOENkQwYURzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  671. CFUOFR0QxAjR0MjM3YTNBlDOENkQwAQRzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  672. ..
  673.  
  674.  
  675.      then you've got something encoded by BinSCII. You must decode _all_ the
  676.  parts using BinSCII before attempting to extract using ShrinkIt.
  677.       On the other hand, if you have a binary file which resembles:
  678.  
  679. NuFilei][![/#NuFX_<:c[[[ H`F-fGSCII~[
  680. cRJ0)fNN^P)3'A2p6SF6X#GPd<9#'LC^08N7n\NB7Dd!eMN&eYX0Am=fXp
  681. d@PAsp7rh`I'NS0ALAfi2)2ysGEQ$k9CP%L9
  682. ...
  683.  
  684.      then you have a NuFX file (note the key words NuFile and NuFX). You
  685.  should be able to extract the files it contains using ShrinkIt.
  686.       On the third hand, if you have a text file which resembles:
  687.  
  688. begin 666 nonsense.bny
  689. M4W5N3U,@4F5L96%S92 T+C$@*%-$4U0V,"D@(S@Z(%1U92!/8W0@.2 Q,CHS
  690. M...3HT.2!%1%0@,3DY, HT
  691.  
  692.      then you have a uuencoded file.
  693.       On another hand, if you have a text file which begins with
  694.  
  695. (This file must be converted with BinHex 4.0)
  696. :$&4)48C28N0&,P0*9!"6593K8dP8)3%!!!#L@!!!!!!Qie0*9#%!!3!!SPKb6'&
  697. e!3!!!!!!!!!#!!P8D'8J4QpbBf9P)IN33)(4$N#"d4K!JG%S!!!!!`!'VfJ!"VP
  698.  
  699.  
  700.      then you have a BinHex file. The GSCII+ NDA by Derek Taubert decodes
  701.  BinHex files on an Apple IIGS. You can also use a variety of macintosh
  702.  programs to do the decoding. There is also a Unix implementation of BinHex
  703.  called mcvert.
  704.       On one more hand, if you have a text file which resembles:
  705.  
  706. CALL-151
  707. E00:38 A5 FF D0 32 D8 20 8E FD AD 30 BF 8D 6A 0E 20 00 BF C7 6D 0E 0D 80 02
  708. E18:D0 1D 20 00 BF C5 69 0E B0 15 AD 81 02 29 0F AA E8 8E 80 02 A9 2F 8D 81
  709.  
  710.  
  711.      and more lines like that, followed by a bunch of lines that look like:
  712.  
  713. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  714. 008DF2038DF3038DF4036CFCFFE6A4A5A4C96F90CFA9008DFCBFA9018DFDBFA0
  715. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  716.  
  717.  
  718.      then you have an Executioner file.
  719.  
  720. ======================================================================
  721. This FAQ is available on-line at apple2.archive.umich.edu (see FTP)
  722. Permission granted to reproduce in non-profit User Group newsletters.
  723.  
  724. Any additions/corrections/suggestions would be appreciated.  Also,
  725. if this FAQ has helped you, e-mail me and let me know!
  726.                                         Dan DeMaggio (dmag@umich.edu)
  727.  
  728.     -- 
  729.             -=- Dan DeMaggio -=- dmag@umich.edu -=-
  730. "That is really incredible. That is truly incredible.  That is so
  731. incredibly incredible that I think I'd like to steal it." -Zaphod
  732. -- 
  733.             -=- Dan DeMaggio -=- dmag@umich.edu -=-
  734. "That is really incredible. That is truly incredible.  That is so
  735. incredibly incredible that I think I'd like to steal it." -Zaphod
  736.