home *** CD-ROM | disk | FTP | other *** search
/ Univers Interactif 3 / INTERACTIF.BIN / pc / planeten / internet / fetch21b.txt < prev    next >
Internet Message Format  |  1995-04-17  |  59KB

  1. Date: Tue, 25 Aug 1992 08:34:32 -0500 
  2. From: darnelll@sy2000.cet.fsu.edu
  3. Subject: Fetch Help 2.1b4 Text File 
  4.  
  5. The great communication program Fetch located in the archives at Sumex in
  6. the communication folder has interactive help.  I, as well as some of my
  7. colleagues, prefer to read this offline in printed form.  I copied this
  8. help using Resedit from the program itself and take no credit for it but
  9. wish to only distribute it so other users may benefit from this.  Dartmouth
  10. and those that worked on this project deserve all the credit for this
  11. wonderful application.
  12.  
  13. **********************************************************************
  14. Larry Darnell                                         (904) 644-4720
  15. 406 MCH, B-150                                        (904) 644-5803 Fax
  16. Florida State University                       Computer Support Specialist
  17. Tallahassee, FL 32306-4018                     darnelll@sy2000.cet.fsu.edu
  18. FETCH HELP
  19.  
  20. About Fetch...
  21.  
  22. Fetch is a Macintosh program for transferring files.  It uses the File
  23. Transfer Protocol (FTP) and therefore allows a networked Macintosh to
  24. transfer files with any connected machine that supports FTP.  Fetch
  25. requires a Mac 512KE, System 4.1, and either KSP 1.03 or MacTCP.
  26.  
  27. If you have questions or comments about Fetch please send them to Jim
  28. Matthews (or to Fetch@Dartmouth.edu).
  29.  
  30. The current version of Fetch is 2.1b4.  The information in this help file
  31. may not be accurate for other versions.
  32.  
  33. Fetch is Copyright   1992, Trustees of Dartmouth College.
  34.  
  35. Free non-commercial distribution of this software is permitted.  Contact
  36. the Dartmouth College Grants and Contracts office (Hanover, NH 03755) for
  37. information on commercial distribution.
  38.  
  39. Where to start
  40.  
  41. If you are familiar with file transfer and FTP specifically you should
  42. start with the "Quick Guide to Fetch" topic.  If you are new to file
  43. transfer and would like to learn in a step-by-step fashion you should try
  44. "A Fetch Tutorial."  All of the Fetch commands and screen elements are
  45. explained under the "Reference" heading, and most computer terms used in
  46. the help screens are defined under "Glossary of Terms."
  47.  
  48. Quick Guide to Fetch
  49.  
  50. Connecting
  51.    When you start Fetch or press the Open Connection... button you will be
  52. prompted with the connection dialog box.  You must specifiy the name or IP
  53. number of the machine you wish to connect to, either by typing it in or by
  54. choosing an item from the Shortcuts pop-up menu.  You may enter an user id
  55. and password.  If you do not enter a user id Fetch will substitute the name
  56. "anonymous."  If you do not enter a password your default password will be
  57. used (the default password is specified in Preferences).  So in order to
  58. use "anonymous FTP" you only need to enter a machine name.
  59.  
  60. Directories
  61.    Fetch displays directories roughly the same way that the Macintosh
  62. system displays folders.   Once you are connected the current directory is
  63. displayed as the title of a pop-up menu above the file list.  You can
  64. change directory in several ways.  Double-clicking the name of a directory
  65. in the file list (or selecting it and hitting enter) causes Fetch to enter
  66. that directory.  The pop-up menu above the file lists lets you move to any
  67. ancestor of the current directory.  Choosing the Change Directory...
  68. command from the Directories menu prompts you for a directory name and
  69. makes that the current directory.  Finally, the bottom of the Directories
  70. menu includes every directory you have entered since opening the
  71. connection.  You may re-enter any one by selecting it from the menu.
  72.  
  73. Getting a File
  74.    To get a file, double-click on its name or select it and click the Get
  75. File... button.  If the Automatic radio button is chosen Fetch will try to
  76. figure out what kind of file it is from its name, and treat it as a text
  77. file if it can't make an educated guess (see Automatic/Text/Binary under
  78. Reference).  If the Text button is selected the file will be treated as
  79. text, and you will have the option of converting any BinHex files embedded
  80. in the text file.  If the Binary button is selected Fetch will check to see
  81. if the file is in MacBinary II, AppleSingle, MacBinary I or MacHost format,
  82. and otherwise save it without any formatting or conversion.  If you know
  83. what kind of file you are getting you should select the appropriate button.
  84.  Most of the time, however, the Automatic setting will do the right thing.
  85.  
  86. Putting a File
  87.    To Transfer a file from your Macintosh to another machine click on the
  88. Put File... button.  You will be asked to pick a file and prompted for the
  89. name and format to give the file you are putting.  You should choose
  90. MacBinary II format if you plan to simply store the file on the other
  91. machine, BinHex if you plan to mail it to someone, and either Text, Wrapped
  92. Text, or Raw Data if you plan to manipulate the file on the host computer. 
  93. Text will simply create a text file using the rules of the other system,
  94. Wrapped Text will limit lines to a certain length, and Raw Data will not
  95. perform any conversions at all.
  96.  
  97. Cancelling and Quitting
  98.    You may cancel any on-going operation by pressing the Cancel button. 
  99. Some host computers do not recognize the cancel command and will therefore
  100. continue the current operation until it is completed.  In that case your
  101. only options are to close the connection (by pressing Close Connection) or
  102. quitting from Fetch by choosing the Quit command from the File menu.
  103.  
  104. Why Tranfer Files?
  105.  
  106. There are two reasons to transfer files between a Macintosh and another
  107. computer.  One is to use the other computer as a holding place for
  108. Macintosh files.  This sort of use can be termed "archiving."  In this case
  109. it is not important for the file to be in a format understood by the other
  110. computers, since it will only be transferred back to a Macintosh.  It is
  111. important to be able to retrieve the file exactly as it was saved.  Fetch
  112. supports three file formats that are suitable for archiving Macintosh
  113. files: MacBinary II, AppleSingle and BinHex.  A file stored in any of these
  114. formats can be reconstructed without any loss of information (for instance
  115. the file type, icon, and original name will be preserved).
  116.  
  117. This sort of file transfer can be used to distribute software over a large
  118. area.  There are several large archives of Macintosh programs on the
  119. Internet, most notably the Info-Mac archives on sumex-aim.stanford.edu. 
  120. These archives allow anyone to retrieve files and typically store the files
  121. in MacBinary II or BinHex format.
  122.  
  123. The other reason to transfer files between different computers is so that
  124. they can be used by programs on each machine.  Due to the peculiarities of
  125. the Macintosh and its software there are few files that can be shared with
  126. other computers this way.  The most common type is the text file (see the
  127. "Glossary" topic for a definition of text file).  Most computers have
  128. programs that use text files and most Macintosh word processors allow you
  129. to save documents as text.  Fetch allows you to move text files to and from
  130. other computers, and offers the option of word-wrapping (see "Wrapped Text"
  131. and "Filled Paragraphs" under "Reference").
  132.  
  133. There are a few kinds of non-text files that can be used on a Macintosh and
  134. other computers.  Examples include compressed text files (created with the
  135. Unix  compress program or MacCompress) and files created with tar or
  136. MacTar.  These files can be transferred to a Macintosh with the Binary
  137. files option and transferred to other computers in the "Raw Data" format
  138. (see "Raw Data" under "Reference").
  139.  
  140. A Fetch Tutorial
  141.  
  142. The following help items walk you through the process of connecting to a
  143. remote computer, navigating around its directories, and moving a file to
  144. and from your Macintosh.  This tutorial assumes that you are familiar with
  145. the Macintosh.  Some terms will be defined as we go along, others are
  146. defined under the "Glossary" help topic.
  147.  
  148. Connecting and Signing on
  149.  
  150. When you first open Fetch you are presented with the sign-on dialog box; at
  151. other times you can press the Open Connection... button in order to see
  152. that dialog.  The sign-on dialog has fields for entering four pieces of
  153. information: 
  154.  
  155.      the name of the machine you wish to transfer files with (or "host
  156. name")
  157.      the name of your account on that machine (or "user id")
  158.      the password for that account
  159.      the name of the starting directory (optional)
  160.  
  161. The sign-on dialog also contains a shortcut mechanism for filling in some
  162. or all of these fields.  To the right of the word "Shortcuts" there is an
  163. icon representing a pop-up menu.  
  164.  
  165. Example: Press on the icon to use the menu and select the item titled
  166. "Dartvax."  (Dartvax is a Unix  computer in the Kiewit Computation Center
  167. at Dartmouth College).  When you release the mouse the machine name, user
  168. id, and starting directory fields will be filled in.  Note that the user id
  169. is "anonymous."  Many machines, including Dartvax, allow any user to
  170. transfer files with it as a guest, without specifying a password.  You may
  171. then click the OK button to initiate the connection.
  172.  
  173. Finding Files and Directories
  174.  
  175. Most computers divide their files among directories, which are equivalent
  176. to folders on the Macintosh.  In order to get a file you should first go to
  177. the proper directory.  Fetch displays the name of the current directory
  178. above the list on the left side of the window.  The list contains the names
  179. of the files and sub-directories in the current directory.
  180.  
  181. Example: 
  182.  
  183. If you have signed on to Dartvax your current directory should be "pub",
  184. and there should be some files and folders visible in the file list. 
  185. However there are few interesting files in this directory, so you will have
  186. to change the current directory.
  187.  
  188. You can change directory in several ways.  The simplest is to double-click
  189. on the name of a sub-directory in the list.  You can try this by
  190. double-clicking on the name "mac" in the current file list.  The current
  191. directory will change to "mac" and the file list will show the names in
  192. that sub-directory.  If you click on the name of the current directory you
  193. will see a pop-up menu showing the current directory and its ancestors, in
  194. this case "mac," "pub," and "/."  Choosing one of these takes us back to
  195. that directory.
  196.  
  197. Getting a File
  198.  
  199. You should now be in the directory titled "mac" (its complete pathname is
  200. "/pub/mac"). This directory holds Macintosh-related files for downloading. 
  201. One of the files should be a StuffIt! archive containing this version of
  202. Fetch, Fetch_2.1.sit.hqx.
  203.  
  204. In order to move "Fetch_2.1.sit.hqx" from Dartvax to your Macintosh you
  205. should double-click its name.  Alternatively you may select its name and
  206. press either Return, Enter, or the Get File... button.  You will be
  207. prompted for a name to save these files under; if you click OK the files
  208. will quickly be saved on your disk.  They will be complete with their own
  209. icons and ready to be used.
  210.  
  211. Putting a File
  212.  
  213. [Note: Users outside Dartmouth should not put files on Dartvax; please use
  214. a local system.]
  215.  
  216. Dartvax has a special directory where users may drop off files for others
  217. to download; the full name of this directory is "/pub/dropoff."  To get to
  218. this directory from /pub/mac you should choose "pub" from the pop-up menu
  219. above the file list.  Then double-click on  "dropoff" to enter that
  220. directory.
  221.  
  222. To put a file onto Dartvax click on the Put File... button.  You will be
  223. prompted to select the file you wish to send; since this is just a tutorial
  224. you can pick any file you wish, though you probably want to avoid very
  225. large files.  You will then be asked to provide a name to give the file on
  226. Dartvax.  This dialog box also gives you a chance to pick a file format
  227. >From a pop-up menu.  Fetch will usually pick an appropriate name and format
  228. so you can simply press the OK button.
  229.  
  230. The file will be transferred to Dartvax and you will be able to watch its
  231. progress in the status panel on the right side of the Fetch window.  When
  232. the transfer is complete the name of the file you put will appear in the
  233. file name list.  Since we do not want to clutter this directory you should
  234. select that name and choose Delete directory or file... from the Remote
  235. menu.
  236.  
  237. Congratulations -- you have just transferred files to and from your
  238. Macintosh!  You can learn more about Fetch by consulting the help topics
  239. under "Reference."  Please send mail to Fetch@dartmouth.edu if you have any
  240. comments, questions, or criticisms.
  241.  
  242. Reference
  243.  
  244. The following topics offer more in-depth information about Fetch and its
  245. capabilities.  There is roughly one topic for each button, menu item, and
  246. supported file format.  If you can not find some topic here please send
  247. electronic mail to Fetch@dartmouth.edu.  We appreciate your input.
  248.  
  249. AppleSingle
  250.  
  251. AppleSingle is Apple's official format for representing a Macintosh file on
  252. other types of machines.  Macintosh files on A/UX (Apple's Unix) systems
  253. are usually stored in AppleSingle format.  AppleSingle files have no
  254. distinguishing filename suffix, so it is usually necessary to select the
  255. Binary button in order to download AppleSingle files.
  256.  
  257. Fetch and get and put files in AppleSingle format.  Automatic conversion of
  258. AppleSingle files can be turned on and off in the Preferences dialog box.
  259.  
  260. Automatic/Text/Binary
  261.  
  262. FTP (the protocol which Fetch uses to transfer files) divides files into
  263. two categories: text files and binary (or image) files.  Furthermore, the
  264. Macintosh uses complex files that can only be represented on other
  265. computers with special formats.  In order for a file transfer to work these
  266. issues must be worked out.  Fetch has three buttons that control the way a
  267. file is retrieved: they are titled Automatic, Text, and Binary.  It would
  268. be convenient if Fetch could always tell what sort of file it was getting
  269. and treat it in the appropriate way; unfortunately Fetch is not that smart.
  270.  So some of the time you will have to specify what sort of file you are
  271. getting.  The three possible settings are explained below.
  272.  
  273. Automatic
  274.    Fetch starts out with the Automatic button selected, and this setting
  275. will be the right one most of the time.  When this button is selected Fetch
  276. tries to interpret the name of the file you are getting.  For instance,
  277. most BinHex files end in "hqx," and most GIF (Graphics Interchange Format)
  278. files end in "gif."  When the Automatic button is selected these clues lead
  279. Fetch to download "hqx" files as text files (and ignore the non-BinHex
  280. part) and download "gif" files as binary files (with the right icon to be
  281. opened by a popular GIF viewing program).  These clues are managed by the
  282. Suffix Mapping... menu command (see the "Suffix Mapping" help topic).
  283.    Some file names will not offer any clues, and in that case Fetch will
  284. download the files as text files.
  285.    When Fetch believes a file is in BinHex format it discards all
  286. non-BinHex data and only allows you to save the converted file.  This is a
  287. problem if you want the other data or if the file is only part, and not the
  288. first part, of a complete BinHex file (see Multi-Part BinHex Files).  
  289.    When Fetch thinks a file is text it prompts you for a name to give it
  290. and allows you to have it converted to filled paragraphs (see the "Filled
  291. Paragraphs" topic).  The file will be of type TEXT and its file icon can be
  292. set in the Preferences dialog box.  Fetch will detect the beginning of a
  293. BinHex file inside a text file and offer to convert the BinHex information;
  294. you have the option of declining this conversion by pressing the Don't
  295. Convert button.
  296.    When Fetch thinks a file is binary information it first checks to see if
  297. it is in MacBinary II, AppleSingle, MacBinary I or MacHost format.  If it
  298. is, it will be saved in its original state; otherwise you will be prompted
  299. to supply the type and creator of the file.  A pop-up menu with a few
  300. popular types is available.
  301.    The Automatic setting will do the wrong thing if you have a binary file
  302. with a name that does not use a standard ending (e.g. "bin", "Z", "sit",
  303. "gif", "tar"), a text file with an ending usually used for binary files, or
  304. a non-BinHex file with a "hqx" ending to its name.  For these situations
  305. you must use one of the other two settings.
  306.  
  307. Note: There is one notable exception to these rules for Automatic mode.  If
  308. Fetch determines that the server machine is a Macintosh running the
  309. Macintosh Operating System (i.e. not A/UX or some other Unix) it will try
  310. to transfer all files in MacBinary mode.  This way all files will appear
  311. exactly as they do on the server machine, except that StuffIt! archives may
  312. be expanded.
  313.  
  314. Text
  315.   This setting tells Fetch that the file in question is a text file (or a
  316. BinHex file, which is one kind of text file).  Since the Automatic setting
  317. treats mysterious files as text files this setting is rarely necessary. 
  318. If, however, a text file has the sort of name usually associated with
  319. binary files (i.e. ending in "bin", "Z", "sit", "gif", or "tar") you should
  320. choose this setting to override the automatic behavior.  Likewise if a
  321. filename ends in "hqx" but does not refer to a complete BinHex file or the
  322. first part of a complete BinHex file you should choose this setting.
  323.  
  324. Binary
  325.    This setting is for getting binary (i.e. non-text) files, specifically
  326. those files whose names do not identify them as being binary files.  If you
  327. know that a file is not a text file (e.g. it is in MacBinary or AppleSingle
  328. format) choosing this setting will help ensure the proper treatment.  When
  329. this button is set the file will be checked to see if it is in MacBinary,
  330. AppleSingle or MacHost format.  If it is then it will be saved just in its
  331. original state; otherwise you will be prompted for the type and creator of
  332. the file.  A pop-up menu with a few popular types is available; more can be
  333. added in the "Suffix Mapping" dialog.
  334.  
  335. BinHex
  336.  
  337. BinHex (sometimes called BinHex4) is a format for representing a Macintosh
  338. file in text form.  The Macintosh file is converted to a series of lines,
  339. each made up of letters, numbers, and punctuation.  Because BinHex files
  340. are simply text they can be sent through most electronic mail systems and
  341. stored on most computers.  However the conversion to text makes the file
  342. larger, so it takes longer to transmit a file in BinHex format than if the
  343. file was represented some other way.  The suffix ".hqx" usually indicates a
  344. BinHex format file.
  345.  
  346. Fetch can get and put files in BinHex format.  Conversion of BinHex format
  347. files can be turned on and off in the Preferences dialog box.  For
  348. information on BinHex files in multiple parts, see the Multi-Part BinHex
  349. Files entry.
  350.  
  351. Cancel
  352.  
  353. If a time-consuming operation is in progress the Cancel button will appear
  354. at the bottom of the status pane, on the right side of the window.  You can
  355. cancel the current operation by pressing this button or typing Cmd-.  Once
  356. you have done so the button will go away and the Status line will read
  357. "Cancelling ."
  358.  
  359. Most computers support the cancel command and with these machines it will
  360. only take a few seconds.  But some machines ignore the command and insist
  361. on completing the current operation.  In these cases the status line will
  362. read "Cancelling " for quite a while.  The only ways to quickly exit from
  363. this situation are to close the connection or quit from Fetch.
  364.  
  365. Change Directory
  366.  
  367. The Change Directory command is found in the Directories menu.  It allows
  368. you to specify the current directory by typing its name rather than by
  369. moving to it one step at a time.  This is useful if you know the full name
  370. of the directory you wish to see and it is several steps away from the
  371. current one.
  372.  
  373. Close Connection
  374.  
  375. The Close Connection button is available whenever you are connected to
  376. another computer or in the process of connecting.  You may press this
  377. button even while file tranfers or other operations are taking place, so it
  378. is an escape hatch if things do not seem to be working.  When this button
  379. is pressed Fetch severs its connection to the other computer and allows you
  380. to open a new connection.
  381.  
  382. Create host directory
  383.  
  384. This menu command creates a new directory on the remote computer.  You will
  385. be prompted for a name to give the directory; unless you specify otherwise
  386. the directory will be a sub-directory of the current one.  You should only
  387. use this command if you have the appropriate privileges and the remote
  388. computer supports directories.  If either of these conditions are not met
  389. you will see an error message.
  390.  
  391. Delete directory or file
  392.  
  393. This menu command allows you to delete files and directories on the host
  394. computer.  If you select a name from the file list and choose this command
  395. you will be asked for confirmation before the file is deleted.  If you have
  396. selected more than one file and give confirmation, all the files will be
  397. deleted.  If you have not selected a file you will be asked for the name of
  398. the file to delete and then it will be deleted.  Note that you must have
  399. the necessary privileges to delete the file or files in question. 
  400. Otherwise you will see an error message and the file or files will remain
  401. unchanged.
  402.  
  403. If you select a directory and choose this command Fetch will delete the
  404. directory's contents before deleting the directory itself.
  405.  
  406. Directory Menu
  407.  
  408. There are two menus to make moving between directories more convenient:
  409.  
  410.     There is a pop-up menu above the file list on the left side of the
  411. Fetch window.  The title of this menu is the name of the current directory,
  412. or "<unknown directory>" if Fetch was unable to determine the name of the
  413. current directory.  This menu includes the current directory and all its
  414. ancestors, i.e. the directories that the current directory is in.  Choosing
  415. one of these directory names makes it the current directory and changes the
  416. file list.  If you choose the current directory Fetch will refresh the file
  417. list.
  418.  
  419.     The Directories menu in the menu bar includes the names of every
  420. directory on the remote computer that Fetch has visited since opening the
  421. connection.  Choosing one of these directory names makes it the current
  422. directory and changes the file list.
  423.  
  424. Note for experienced users: Fetch remembers the file list from the
  425. directories it visits for a period of time (you can adjust that period in
  426. the Preferences dialog box).  This makes returning to visited directories a
  427. quicker operation.  If you would like to have the file list reloaded from
  428. the remote computer instead of from Fetch's memory you can hold down the
  429. option key when you choose a directory name from the pop-up menu.
  430.  
  431. Edit Shortcuts
  432.  
  433. The shortcut pop-up menu in the sign-on dialog box is a convenient way to
  434. specify frequently used host machines.  The menu comes pre-configured with
  435. a few common destinations, but you can customize it to include others
  436. and/or to include your own name and password.  The Edit Shortcuts command
  437. in the Fetch menu brings up a list of the current shortcuts with buttons
  438. for creating new shortcuts, changing existing ones, and removing ones that
  439. are no longer wanted.  The changes you make will be saved to the Fetch
  440. Preferences file, and so will be available whenever you run Fetch from that
  441. machine.  The shortcut marked with a checkmark is special -- it is the
  442. "default" shortcut and will be chosen automatically the first time you open
  443. a connection.  To change the default shortcut, select another shortcut and
  444. press the Make Default button.
  445.  
  446. NOTE: If you save a password as part of a shortcut that password will be no
  447. more secure than the disk it is saved on.  Be certain that others do not
  448. have access to your system disk before saving a shortcut that includes a
  449. password.
  450.  
  451. File List
  452.  
  453. The file list is the list of file and directory names on the left side of
  454. the Fetch window.  It works much like the file list in the standard
  455. Macintosh "Open" dialog box.  Clicking on a name selects it, and many
  456. operations (Get file, Delete file or directory, Rename host file, etc.)
  457. operate on the selected name. Holding down the Command key allows you to
  458. select multiple individual filenames, and holding down the Shift key while
  459. clicking selects a range of filenames. You can also select a filename by
  460. typing the first few letters of its name or using the up and down arrow
  461. keys to step through the list.  Double clicking on a name prompts Fetch to
  462. change directory to the selected name.  If the name refers to a file the
  463. change directory command should fail, and Fetch will then download the
  464. file.  Typing Return or Enter is equivalent to double-clicking.
  465.  
  466. Fetch displays a small icon next to each name.  Files and directories are
  467. designated with the standard file and folder icons.  If Fetch can not
  468. determine whether the name refers to a file or folder an icon showing both
  469. is displayed.  If the name refers to a Unix symbolic link (an alias for a
  470. file or directory in a different place) it is displayed in italics (just as
  471. the Finder displays the names of System 7.0 aliases on the Macintosh).
  472.  
  473. You may choose to have Fetch display the size and date-modified for each
  474. file.  This has the side effect of displaying names in a smaller font (to
  475. make room for the additional information).  If a file name can not be
  476. displayed in full selecting it will display as much of the name as possible
  477. (rather than displaying the size and date).
  478.  
  479. Note for experienced users: Pressing down arrow while holding down the
  480. Command key makes the selected directory name the current directory;
  481. pressing Cmd-up arrow moves to the parent directory.  Users with Apple
  482. Extended Keyboards can use the home, end, page up, and page down keys to
  483. scroll the file list.
  484.  
  485. Filled Paragraphs
  486.  
  487. When Fetch prompts you for a name to give a retrieved text file it also
  488. displays a check box titled Convert to Filled Paragraphs.  If this box is
  489. checked many of the line-endings of the file will be removed.  This will
  490. have the effect of converting many short lines into a few long ones, namely
  491. one line per paragraph.  This is the format preferred by Macintosh word
  492. processors, since it allows them to set the line-endings according to the
  493. current margin or window size.
  494.  
  495. This option is only appropriate if the text in question is made up of
  496. paragraphs.  Tables, computer programs, and other more exotic text files
  497. may be garbled by this conversion.  Therefore it is usually best not to set
  498. this option.
  499.  
  500. Find
  501.  
  502. Fetch can search for information in any of its windows with the Find
  503. command.  When the Fetch window is frontmost Find searches through the
  504. displayed file names for the desired text.  When a text window (including
  505. the Fetch Transcript window) is in front Find searches the displayed text. 
  506. When the Fetch Help window is frontmost Find searches through all the help
  507. topics.
  508.  
  509. FTP
  510.  
  511. FTP stands for File Transfer Protocol, and is a set of ground rules (a
  512. "protocol") that allows two computers to exchange files over a network. 
  513. FTP was developed in the 1970s by users of the Advanced Research Projects
  514. Agency network, or Arpanet.  FTP is the official file transfer mechanism of
  515. the Internet (Arpanet's larger successor) and therefore is supported by
  516. hundreds of thousands of machines.
  517.  
  518. Fetch implements one part of FTP, the "client" side.  Therefore it can
  519. communicate with any connected machine that has a "server" program.  Some
  520. of Fetch's features will not be available on certain servers -- this is
  521. because the other machine does not support the feature (e.g. not all
  522. machines have sub-directories) or because the server program does not
  523. implement the complete FTP specification.
  524.  
  525. Get Directories and Files
  526.  
  527. The Get Directories and Files command is used to download multiple files
  528. and/or directories with one command.  You can select the files or
  529. directories you wish to download in the file list; if none are selected you
  530. will prompted for a file or directory name.  Then you will be prompted for
  531. the folder in which to save the files and directories on your Macintosh
  532. disk.
  533.  
  534. The names of the downloaded files will be set automatically, based on the
  535. names that the files have on the remote computer.  All format conversions
  536. will also be performed automatically, according to the settings in the
  537. Preferences dialog.
  538.  
  539. The progress of the file transfer, including the name of the file being
  540. transferred, is shown in the Status panel.  You can cancel the transfer by
  541. pressing the Cancel button.
  542.  
  543. Help
  544.  
  545. The Fetch Help menu command opens the Fetch Help window (this window) and
  546. brings it to the front.  You can choose help topics by clicking on the them
  547. and scroll through the help information with the scroll bar on the right. 
  548. You can copy information from this window and print the current topic. 
  549. Help is only available when the Fetch Help file can be found (it should be
  550. placed in the same folder as Fetch or in the System Folder).
  551.  
  552. Balloon help is also available for most of the menus and buttons in Fetch
  553. if you are running System 7.0.
  554.  
  555. The Help window can be closed by clicking on its close box or typing Cmd-W.
  556.  
  557.  
  558. MacBinary II
  559.  
  560. MacBinary II (sometimes simply called MacBinary) is a format for
  561. representing all the information in a Macintosh file in one binary file. 
  562. It is useful for storing a Macintosh file on a non-Macintosh system for
  563. later retrieval.  Unlike BinHex, MacBinary II is a compact format but can
  564. not be passed through most electronic mail systems.  MacBinary II files
  565. typically have names ending in ".bin".
  566.  
  567. Fetch can get and put files in MacBinary II format.  Fetch can also get
  568. files in MacBinary I format (and earlier version of the MacBinary
  569. standard).  Automatic conversion of MacBinary I and MacBinary II files can
  570. be turned on and off in the Preferences dialog box.
  571.  
  572. Some FTP servers (notably NCSA Telnet, InterCon System Corp's TCP/Connect
  573. II, and Peter Lewis's FTPd) recognize MacBinary format.  If Fetch
  574. determines that it is connected to one of these servers it will try to use
  575. MacBinary II for all transfers.
  576.  
  577. MacHost
  578.  
  579. MacHost (also known as Dtmft) is a format used by DarTerminal for
  580. representing Macintosh files on non-Macintosh systems.  It is similar to
  581. MacBinary II but only used at Dartmouth.  Fetch can get files in MacHost
  582. format and recognizes them automatically if the Binary option is selected.
  583.  
  584. Automatic conversion of MacHost format files can be turned off in the
  585. Preferences dialog box.
  586.  
  587. MacTCP
  588.  
  589. MacTCP is a product from Apple Computer, Inc. that allows Macintosh
  590. software use the TCP/IP protocols.  Fetch will use MacTCP if it is
  591. installed; otherwise it will use Dartmouth's own KSP protocol and a special
  592. network gateway.  A message in the About Fetch... dialog box indicates
  593. whether MacTCP or KSP is currently being used.
  594.  
  595. If you have configured MacTCP incorrectly Fetch will not be able to connect
  596. or transfer files.  You should either fix the configuration problem or
  597. remove MacTCP and reboot; then Fetch will use KSP (assuming you are at
  598. Dartmouth).
  599.  
  600. MacTCP is available from the Apple Programmer's and Developer's
  601. Association.  The current version is 1.1, and a number of problems have
  602. been observed with earlier versions so it is important to get the latest
  603. version.
  604.  
  605. Multi-Part BinHex Files
  606.  
  607. Some archives (notably the Info-Mac archives at sumex-aim) break large
  608. BinHex files into several pieces, with names such as file-name-part1.hqx,
  609. file-name-part2.hqx, etc.  As long as all the parts are in alphabetical
  610. order, Fetch will treat a request to get the first part as a request to get
  611. the entire file.  Fetch will continue to download host files until the
  612. local file is complete.
  613.  
  614. If the parts are not in alphabetical order you will want to turn off BinHex
  615. conversion in the Preferences dialog box.  Then you can download each part
  616. separately, and piece them back together using a text editor or a special
  617. utility.
  618.  
  619. Open Connection
  620.  
  621. The Open Connection button and menu command bring up the sign-on dialog. 
  622. There you should enter the name or IP number of the machine you would like
  623. to connect to, the name of your account (i.e. the user id), that account's
  624. password, and (optionally) the directory you would like to start with.  If
  625. the account name is omitted the name "anonymous" will be assumed.  If the
  626. password is omitted the default password set in Preferences will be used.
  627.  
  628. You can fill in some or all of these fields by choosing an item from the
  629. Shortcut pop-up menu.  Click on the icon at the bottom of the sign-on
  630. dialog and the menu will pop-up.  It includes the names of several Internet
  631. archives.
  632.  
  633. Open Shortcut
  634.  
  635. The Open Shortcut menu lists available shortcuts and allows you to connect
  636. to one of the listed machines with one command.  Fetch only supports one
  637. connection at a time, so if you are currently connected you will be asked
  638. if you want to close the current connection.  You can add, remove, and
  639. change shortcuts with the Edit Shortcuts command.
  640.  
  641. Post-Processing
  642.  
  643. Fetch can automatically "pass-off" downloaded files to other applications;
  644. this feature is called post-processing, and is configured in the
  645. Post-Processing dialog.  [Note: Post-processing requires System 7.0].  In
  646. that dialog you can create a list of post-processing actions.  An action
  647. consists of two pieces of information: the kind of file that the action
  648. applies to, and the application that this kind of file should be opened
  649. with.  The kind of file is specified by type/creator codes, and the
  650. application by its signature code.  For instance, one action could specify
  651. files with the type code of "TEXT" and the creator code of "ttxt", and the
  652. application signature of "MSWD."  This would mean that TeachText files
  653. (which have type "TEXT" and creator "ttxt") should be automatically opened
  654. with MicroSoft Word (which has the signature "MSWD").  Alternatively, an
  655. action could specify a type of "TEXT" and a creator of "****"; the special
  656. code "****" matches anything, so this action would apply to all files of
  657. type "TEXT" (i.e. all text files).  Finally, the application signature can
  658. be left blank.  In this case the file will be opened by the application
  659. that typically opens it, just as if you double-clicked on the file in the
  660. Finder.
  661.  
  662. The codes that Fetch uses to identify files and applications are rather
  663. cryptic, so Fetch provides an alternative means for entering them.  The
  664. "Choose Example..." and "Choose Application..." buttons allow you to select
  665. the kind of file or application you are interested in, leaving Fetch to
  666. extract the necessary codes.
  667.  
  668. Post-processing actions can be enabled and disabled.  This allows you to
  669. define actions and turn them off temporarily, without having to re-enter
  670. them later.  Fetch comes with several post-processing actions defined but
  671. disabled; they give some examples of how this feature can be used.
  672.  
  673. Preferences
  674.  
  675. The Preferences menu item brings up a dialog that allows you to configure
  676. the way Fetch operates.  The settings made in this dialog are saved in a
  677. file called "Fetch Preferences" in the current system folder.
  678.  
  679. The following can be adjusted in the Preferences dialog:
  680.  
  681. General Preferences:
  682.  
  683. Default password -- The text entered here will be used as your password
  684. whenever you connect as "anonymous."  It is customary to supply your e-mail
  685. address in this case, so we recommend that you enter your e-mail address
  686. here.
  687.  
  688. Display server messages -- Some FTP servers display special information in
  689. the client-server dialog, such as hours of operation, use restrictions, and
  690. information about the files on the server.  If this box is checked Fetch
  691. will display these messages in a separate window; otherwise they can be
  692. viewed by examining the Fetch Transcript window.
  693.  
  694. Keep connection active -- If this box is checked Fetch will regularly send
  695. commands to the remote computer.  Some computers terminate connections
  696. after a certain period of idleness (usually five to fifteen minutes), and
  697. having Fetch send commands regularly evades this policy.  Note that it is
  698. very impolite to keep a connection open to a public-access FTP server for a
  699. long period; many computers limit the total number of connections and your
  700. connection may prevent others from using the service.
  701.  
  702. Show file sizes and dates -- If this box is checked Fetch will attempt to
  703. display file sizes and dates-last-modified in the file list.  This is
  704. usually only possible if the remote host is a Unix  machine or a Macintosh
  705. running Peter Lewis's FTPd server.  The file names, sizes, and dates will
  706. all be displayed in Geneva 9, in order to fit longer names in the given
  707. space.   If a name is truncated to make room for the size and date you can
  708. select it to show only the name.
  709.  
  710. Downloading Preferences:
  711.  
  712. Download folder -- If this box is checked you will be prompted to choose a
  713. folder for saving downloaded files.  From that point on Fetch will save
  714. downloaded files in the download folder without any further prompting.  To
  715. disable this feature uncheck the download folder checkbox.
  716.  
  717. Edit text files with -- This pop-up menu allows you to choose which
  718. editor's icon will be put on text files retrieved by Fetch.  Thus you can
  719. have your favorite editor start up when you double-click on the icon of the
  720. retrieved file.  If your favorite editor is not found in the menu please
  721. send an electronic note to Fetch@dartmouth.edu (or edit Fetch's TXTs
  722. resource with ResEdit).
  723.  
  724. Default binary type/creator -- The type/creator codes entered here will be
  725. used for raw binary files that do not have a type/creator assigned in the
  726. Suffix Mapping dialog.  This can be useful if you are downloading many
  727. binary files that do not have a common suffix.
  728.  
  729. Uploading Preferences:
  730.  
  731. Add file format suffixes -- If this box is checked Fetch will add suffixes
  732. to the suggested names of files put on the remote computer.  So if the file
  733. is being sent in Text format Fetch will suggest a suffix of ".txt"; if it
  734. is in BinHex format Fetch will suggest ".hqx"; and if it is MacBinary II
  735. format Fetch will append ".bin" to the suggested name.  These suffixes are
  736. useful when Fetch tries to determine the type of a file when it comes time
  737. to retrieve it, and so this box it checked by default.  You may want to
  738. uncheck it if the system you are connected to requires very short file
  739. names.
  740.  
  741. Word wrap margin -- This value will be used as the word-wrapping margin if
  742. you put a file in the "Wrapped Text" format.  Lines longer than this value
  743. will be broken at word boundaries into shorter lines.
  744.  
  745. Format Preferences:
  746.  
  747. Recognize and Interpret -- These checkboxes determine whether Fetch will
  748. automatically recognize and convert downloaded files in the given formats
  749. (StuffIt!, BinHex4, MacHost, MacBinary I & II, and AppleSingle).  If you
  750. have trouble downloading a file in one of these formats you may want to
  751. turn off the conversion and convert the file with another tool.
  752.  
  753. Miscellaneous Preferences:
  754.  
  755. Refresh file lists older than n minutes -- Fetch remembers file lists from
  756. directories you have visited.  This value controls how long such a list
  757. will be remembered.  If you would like to have quicker performance you can
  758. increase the value; if you want to make sure that the displayed file list
  759. is up to date you can choose a smaller value.
  760.  
  761. Use "TYPE I" to retrieve binary files -- Check this box if you want Fetch
  762. to use the "TYPE I" format for binary transfers; this is necessary for
  763. proper operation with some IBM mainframe servers, but can cause problems
  764. with machines that do not use 8-bit bytes (such as TOPS-20 systems).
  765.  
  766. Omit file names beginning with a period -- Check this box if you do not
  767. want Fetch to display names that begin with a period in its file list. 
  768. This can reduce the clutter when connecting to Unix accounts.
  769.  
  770. Translate ISO characters -- Check this box if you would like Fetch to
  771. translate 8-bit ISO characters in text files and file listings to the Mac
  772. equivalents, using the 'taBL' resources in Fetch.
  773.  
  774. Put File
  775.  
  776. The Put File button is used to transfer a file from your Macintosh to the
  777. host computer.  When you press the button you will be prompted for the file
  778. you wish to send.  Then you will see a dialog box that lets you set the
  779. name the file will be given on the other computer and the format it will be
  780. stored in.  Be sure to pick a name that will be acceptable to the other
  781. machine (most systems require file names that are shorter than Macintosh
  782. file names and forbid the use of certain characters).  Note that if a file
  783. of the name you specify already exists on the other computer it will be
  784. overwritten without warning.
  785.  
  786. The formats you can use when putting a file are Text, Wrapped Text,
  787. MacBinary II, Raw Data, BinHex, and AppleSingle.  The first two are only
  788. available when putting a text file, but the other four are always
  789. available.  Fetch assumes that you will usually want to save text files as
  790. Text, and other files in MacBinary II format.  See the help topics for each
  791. format for more information.
  792.  
  793. The progress of the file transfer is shown in the Status panel.  You can
  794. cancel the transfer by pressing the Cancel button.
  795.  
  796. You can upload multiple files and/or folders by pressing the Put File
  797. button with the Option key down.  For information see the "Put Folders and
  798. Files" help topic.
  799.  
  800. Put Folders and Files
  801.  
  802. The Put Folders and Files command is used to upload multiple files and/or
  803. folders with one command.  You will be prompted for the files and folders
  804. you wish to send.  Then you will see a dialog box that lets you choose the
  805. formats to be used: one format for all the text files being uploaded, and
  806. one format for all other files.  The names of the uploaded files will be
  807. set automatically, based on the names that the files have on your
  808. Macintosh.
  809.  
  810. If you choose to upload a folder Fetch will create a directory on the
  811. remote computer and put the contents of the Macintosh folder in that
  812. directory.  If the folder includes other folders, they too will be created.
  813.  If the remote computer already has directories with the names of the
  814. Macintosh folders those directories will be used.
  815.  
  816. Uploading of folders will not work with remote computers that do not
  817. support sub-directories (e.g. CMS).
  818.  
  819. The progress of the file transfer, including the name of the file being
  820. transferred, is shown in the Status panel.  You can cancel the transfer by
  821. pressing the Cancel button.
  822.  
  823. Quit
  824.  
  825. The Quit menu command closes the current connection and quits the program. 
  826.  Any on-going file transfer or other operation will be cancelled.
  827.  
  828. Raw Data
  829.  
  830. Raw Data is one of the formats available for putting files on another
  831. computer.  If this format is chosen the data part of the Macintosh file
  832. will be sent without any interpretation or conversion.  Some Macintosh
  833. programs create files with all their information in the data part (e.g.
  834. Stuffit!, MicroSoft Excel, MicroSoft Word).  In these cases using the Raw
  835. Data format is a simple way to transfer files.  However, if the file
  836. includes a resource part that part will be lost.  In any case the file type
  837. and icon will not be preserved.  So the Raw Data format should only be used
  838. if the file is strictly a data file that can be used by some other computer
  839. (e.g. an IBM PC running the PC version of Excel).  If the file will be
  840. retrieved by a Macintosh either MacBinary II or BinHex format should be
  841. chosen.
  842.  
  843. Rename File
  844.  
  845. This menu item allows you to change the name of a file on the remote
  846. computer.  If a file is currently selected you will be prompted for the new
  847. name; otherwise you will be prompted for the current name and a new name. 
  848. Try to choose a name that will be acceptable to the other computer: most
  849. systems have file name length limits and do not allow certain characters. 
  850. If you specify an improper name you will get an error message.
  851.  
  852. Send FTP Command...
  853.  
  854. Most file transfer tasks can be handled with Fetch's regular buttons and
  855. menu items.  But some file transfer servers implement non-standard
  856. commands, or require use of standard commands in non-standard situations. 
  857. If these cases you can send an arbitrary FTP command with the Send FTP
  858. Command menu item.  It prompts you for a command and passes it along to the
  859. other computer without interpretation.  The other computer's response to
  860. the command will be presented in a dialog box.
  861.  
  862. If you enter a complex command (such as one that starts a file-transfer) it
  863. will almost certainly not work and you may have to close the connection.
  864.  
  865. After the command is sent Fetch will refresh the file list, since your
  866. command may have changed the current directory.
  867.  
  868. Status Panel
  869.  
  870. The area on the right side of the Fetch window is the Status panel.  It
  871. contains information about what Fetch is doing at any given time.  If a
  872. file transfer is in progress it displays the name, format, and approximate
  873. size of the file being transferred, the amount of data that has been
  874. transferred so far, and the average speed of the transfer so far.  If any
  875. of these fields are missing it is because the information is unavailable. 
  876. At the bottom of the status panel there is the Cancel button (if an
  877. operation is in progress) and Fetch's version number.
  878.  
  879. StuffIt!
  880.  
  881. StuffIt! is a popular shareware archiving program that allows users to
  882. combine multiple files and folders into one compressed file.  The StuffIt!
  883. format has become a common way to keep Macintosh files on FTP servers,
  884. since the compressed files take less room.  Fetch can automatically
  885. recognize StuffIt! archives and uncompress them as they are downloaded.
  886.  
  887. Fetch can not uncompress encrypted archives, or archives created by
  888. StuffIt!'s commercial successor, StuffIt! Deluxe.
  889.  
  890. "Un-stuffing" can be turned on and off in the Preferences dialog box.
  891.  
  892. Suffix Mapping
  893.  
  894. When the Automatic button is selected, Fetch looks for standard filename
  895. suffixes in order to decide whether a file is a text file or a binary file.
  896.  You can modify the list of recognized suffixes with the Suffix Mapping
  897. command.  When the command is given a dialog box is displayed, showing all
  898. the current suffix mappings.  
  899.  
  900. A suffix mapping associates a suffix (such as ".hqx") with a file type
  901. (either Text, Binary, or BinHex) and optionally with type/creator codes. 
  902. The "Text" type means that files with the associated suffix should be
  903. downloaded as text files; similarly, the "Binary" type means that the files
  904. should be downloaded as binary files.  The BinHex type means that the file
  905. should be downloaded as text (since BinHex files are a kind of text file)
  906. but that non-BinHex material should be ignored.  If a type/creator pair has
  907. been specified text or raw binary files will be given that type and
  908. creator.  For instance, a file with the ".Z" suffix is usually given the
  909. type/creator pair of LZIV/ZIVM (the codes used by MacCompress), since ".Z"
  910. is the standard ending for compressed files and MacCompress is a program
  911. for reading such files.  
  912.  
  913. Suffix mappings are only in force when the Automatic button is selected. 
  914. And information in the file overrides the application specified in the
  915. suffix mapping: if a file is in BinHex, MacBinary, MacHost or AppleSingle
  916. format, it will include information about the application it belongs to.
  917.  
  918. View File
  919.  
  920. Use this command to view text files (such as "README" files) without
  921. leaving Fetch.  Fetch will download the selected text file and display it
  922. in a separate window.  These text windows support tabs and large files (up
  923. to the limit of available memory).  You can search for information in text
  924. windows with the Find command, print them, and save them as text files. 
  925. The font and tab width can be changed with the Set Font and Size command.
  926.  
  927. View File List
  928.  
  929. Use this command to view the file list for the current directory in a
  930. separate text window.  This listing will often include information (such as
  931. file permissions) that Fetch can not display in its own file list.  You can
  932. search for information in text windows with the Find command, print them,
  933. and save them as text files.  The font and tab width can be changed with
  934. the Set Font and Size command.
  935.  
  936. Wrapped Text
  937.  
  938. Wrapped Text is a format that can be chosen when putting text files on
  939. another computer.  Most Macintosh editors store text files with line-ending
  940. characters only at the end of each paragraph.  That way line-endings can be
  941. recalculated whenever the user changes the margins or resizes the window. 
  942. However this yields files with what appear to be very long lines, too long
  943. for many other computers.  In order to make these files usable on the other
  944. system Fetch offers the option of word-wrapping text files as they are
  945. sent.  If this format is chosen no line will be allowed to exceed a certain
  946. margin (set in the Preferences dialog).  If a line is initially longer than
  947. this limit it will be broken on a word boundary so that individual words
  948. are kept intact.
  949.  
  950. Troubleshooting
  951.  
  952. The file list includes other information besides the file name, and the Get
  953. File button doesn't work.
  954.  
  955. Try refreshing the file list by choosing the current directory from the
  956. directory pop-up menu; that will usually fix this problem.  Otherwise you
  957. can hold down the option key when you press the Get File button and type in
  958. the file's name by hand.
  959.  
  960. I can't connect to ftp.apple.com with Fetch but I have no problem
  961. connecting from a Unix machine.
  962.  
  963. The server at ftp.apple.com requires that its clients be assigned an
  964. official domain name.  Your network administrator may not have assigned
  965. names to the addresses used by Macintoshes running MacTCP; that would cause
  966. connection attempts from your Mac to fail while a Unix machine succeeds. 
  967. Your network administrator can resolve this problem by assigning names to
  968. those addresses.
  969.  
  970. The files I get don't have the right icon.
  971.  
  972. This problem can be caused by a number of factors.  First be sure that you
  973. are using the right settings -- if you've tried the Automatic setting try
  974. Binary.  It may also be helpful to read the "Automatic/Text/Binary" help
  975. topic under "Reference."  If you are using System 4.2 and Finder 6.0 you
  976. should upgrade since that system version has a bug that causes files to
  977. lose their icons.  If you use MultiFinder you should try saving the file to
  978. a folder that is not currently open in the Finder.  The Finder's Get
  979. Info... command sometimes fixes incorrect icons under MultiFinder.  If all
  980. else fails send mail to Fetch@dartmouth.
  981.  
  982. I get the message "This is not a proper BinHex format file."
  983.  
  984. This means that Fetch could not successfully de-binhex the file.  You
  985. should try unchecking the BinHex4 Format button in Preferences and
  986. downloading again (see the "Preferences" help topic under "Reference"). 
  987. Then try to de-binhex the file with either BinHex4 or Stuffit!, two
  988. Macintosh utilities.  If they succeed please send a note to
  989. Fetch@dartmouth, since this indicates that Fetch has a bug.  Otherwise the
  990. problem may be that the BinHex file is incomplete.  If it has other pieces
  991. you will have to get them the same way and assemble them on your Macintosh
  992. before running BinHex4 or Stuffit!.  Finally, the file may just be
  993. corrupted.  In that case contact the source and ask for a new copy.
  994.  
  995. I get the message "This is not a proper MacBinary II file."
  996.  
  997. This message, and other ones about MacBinary I, AppleSingle, StuffIt! and
  998. MacHost format files, mean that the file has been corrupted in some way. 
  999. Contact the source of the file to get a new copy.  If the file was created
  1000. by Fetch send a report to Fetch@dartmouth.edu so we can try to find the
  1001. bug.
  1002.  
  1003. The Cancel button doesn't work when I'm connected to a VMS Vax.
  1004.  
  1005. We have observed problems with Cancel on VMS and CMS systems.  We're
  1006. working on these problems and in the meantime you can cancel a transfer by
  1007. closing the connection altogether.
  1008.  
  1009. Fetch can't seem to connect to hosts while NCSA Telnet is running.
  1010.  
  1011. Some MacTCP versions of NCSA Telnet monopolizes the name-lookup service, so
  1012. while it is running other programs that use MacTCP (such as Fetch) can't
  1013. connect to other machines by name.  You can work around the problem by
  1014. quitting from NCSA Telnet or entering the host's IP address in the Open
  1015. Connection... dialog box.  Newer versions of NCSA Telnet may not have this
  1016. problem.
  1017.  
  1018. Glossary of Terms
  1019.  
  1020. anonymous FTP -- the process of connecting to a remote computer that does
  1021. not require any identification or password.  In this case the user name
  1022. used is either blank or "anonymous" and the password is optional.  Several
  1023. archives of Macintosh software are available to all by anonymous FTP.
  1024.  
  1025. binary file -- a file that may contain any characters in any format; not a
  1026. text file.  Files in MacBinary II format or MacHost format are binary
  1027. files.
  1028.  
  1029. directory -- a collection of files and sub-directories, equivalent to
  1030. Macintosh folders.  Sub-directories are directories within some other
  1031. directory; the enclosing directory is known as the parent directory.  Most
  1032. systems have a notion of the current directory, the directory whose files
  1033. your are viewing at that time.  Not all systems have directories, and some
  1034. systems do not permit sub-directories.
  1035.  
  1036. download -- the operation of moving a file from some other computer to your
  1037. own.
  1038.  
  1039. host -- the remote computer you are connected to.  This computer runs a
  1040. program that accepts your connections, and therefore can be seen as your
  1041. host.  Most host computers are minicomputers and mainframes, but a
  1042. microcomputer can also act as a host.
  1043.  
  1044. Internet -- a collection of networks (including NSFnet, Milnet, and others)
  1045. linking universities, commercial sites, and military bases around the
  1046. world.  All Internet machines are required to support FTP for file
  1047. transfer, and are therefore accessible to Fetch.  Dartmouth is connected to
  1048. the Internet via NEARnet.
  1049.  
  1050. IP number -- a type of computer address of the form
  1051. number.number.number.number (e.g. 128.170.48.4).  Usually you will refer to
  1052. machines by their names (e.g. "Dartvax") but Fetch can also connect to
  1053. machines with just their numeric address.
  1054.  
  1055. text file -- a file containing lines of letters, numbers, and punctuation. 
  1056. Most word processors can create text files and some editors (such as
  1057. TeachText and BBEdit) only create text files.  A non-text file is a binary
  1058. file.
  1059.  
  1060. TCP/IP -- a protocol suite developed for the Department of Defense, and
  1061. used by many types of computers (particularly machines running the Unix 
  1062. operating system).  FTP, the protocol used by Fetch, is part of the TCP/IP
  1063. family of protocols.  Fetch uses TCP/IP services in one of two ways: with
  1064. the KSP protocol and a translating gateway (such as Dartmouth's
  1065. AppleTalk-IP gateway), or with Apple's MacTCP product.
  1066.  
  1067. upload -- the operation of moving a file from your computer to some other
  1068. one.
  1069.  
  1070. If you would like to see other terms defined send a note to
  1071. Fetch@dartmouth.edu.
  1072.  
  1073. Release Notes
  1074.  
  1075. This help file should be used with version 2.1 of Fetch.  
  1076.  
  1077. This version has the following new features and bug fixes:
  1078.  
  1079. Since 2.0.6:
  1080.  
  1081.   There are new commands to view files and file lists in text windows.
  1082.   Fetch can optionally display size and date-last-modified information for
  1083. files on most Unix servers.
  1084.   Fetch windows can be resized, and Fetch remembers their position between
  1085. sessions.
  1086.   Fetch Help can be copied and printed.
  1087.   Fetch can be configured to automatically open certain kinds of files, for
  1088. instance compressed archives, with the appropriate applications.
  1089.   Fetch can optionally save downloaded files to a special folder, without
  1090. prompting you each time.
  1091.   Fetch now supports Balloon Help and the required Apple Events.
  1092.   The directory pop-up menu is now more Mac-like, showing just the
  1093. ancestors of the current directory.
  1094.   The Delete command now works with directories that have files or
  1095. sub-directories in them.
  1096.   Fetch will optionally display informational messages from the host.
  1097.   The network transcript can be conveniently viewed in a separate window.
  1098.   Fetch will now optionally translate between ISO and Mac character sets.
  1099.   Many minor features were added and many bugs were fixed.
  1100.  
  1101. Since 2.0.5:
  1102.  
  1103.   Changed About box to permit free distribution, updated help.
  1104.  
  1105. Since 2.0.4:
  1106.  
  1107.   Fixed a bug with certain Unix servers that caused dates to show up in the
  1108. file list.
  1109.   Always shows icons (if only the file-or-directory icon).
  1110.   Use condensed type to fit more of long file names in the file list.
  1111.  
  1112. Since 2.0.3:
  1113.  
  1114.   Fixed a bug that caused certain commands to fail if Fetch was run on a
  1115. system besides System 7.0.
  1116.  
  1117. Since 2.0.2:
  1118.  
  1119.   Fixed a problem with the FTP server on Northstar IBM RTs.
  1120.   Added an icon for names that might be files or directories.
  1121.   Started displaying the names of Unix links in italics.
  1122.   Fixed a bug that prevented use of the empty password.
  1123.   Changed the Get File button to only download files (and not try to change
  1124. directory first).  Return, Enter, and double-clicking still try to change
  1125. directory before downloading.
  1126.  
  1127. Since 2.0.1:
  1128.  
  1129.   Put in explicit support for the NCSA Telnet and TCP/Connect FTP servers.
  1130.   Fixed a problem with the mac.archive.umich.edu FTP server.
  1131.   Fixed a rare bug in BinHex decoding and another in StuffIt! expansion.
  1132.   Fixed a bug with putting a System 7.0 alias to MacTCP in the Control
  1133. Panels folder.
  1134.  
  1135. Since 2.0:
  1136.  
  1137.   Fixed a bug that required MacTCP to be installed in both the System
  1138. Folder and the Control Panels folder under 7.0b4.
  1139.   Fixed a bug that caused problems with spaces in Unix filenames.
  1140.   Improved the algorithm for detecting BinHex lines.
  1141.  
  1142. Since 1.1.1:
  1143.  
  1144.    Multiple files and folder hierarchies can be uploaded and downloaded.
  1145.   StuffIt! archives can be automatically uncompressed.
  1146.   The file list identifies files and directories with the familiar
  1147. Macintosh icons for Unix, VMS, and CMS FTP servers.
  1148.   Fetch can be customized to recognize certain file name suffixes and
  1149. download matching files in the proper mode.
  1150.   Support for uploading and downloading files in AppleSingle format was
  1151. added.
  1152.    Support for downloading files in MacBinary I format was added.
  1153.    Interpretation of various file formats can be disabled in the
  1154. Preferences dialog box.
  1155.      Fetch can be told to keep connections alive (by regularly sending
  1156. "do-nothing" commands to the server).
  1157.      Users can send arbitrary FTP commands to the FTP server (such as the
  1158. command specifying mini-disk passwords on CMS systems).
  1159.    Performance has been improved.
  1160.  
  1161. Credits
  1162.  
  1163. Fetch was written by Jim Matthews.
  1164.  
  1165. Thanks to:
  1166.  
  1167.     Phil Koch for the idea of an FTP DA and for writing the gateway that
  1168. made it feasible. 
  1169.     Rich Brown and Paul Merchant for the KSP driver.
  1170.     David Gelhar for an FTP server I don't have to kludge around.
  1171.     Carl Pedersen for the idea of an "Automatic" button.
  1172.     Richard Nelson, for the new icon and "running-dog" animation.
  1173.     Andre Pirard and Alain Fontaine, for help making Fetch a better
  1174. international citizen.
  1175.     All the Dartmouth testers, especially Rick Damon, Espen Koht and Andy
  1176. Williams, who found such interesting files for Fetch to choke on.
  1177.     All the Internet testers, who found even more bugs and suggested great
  1178. features.
  1179.     And to Daniel, for being Daniel.
  1180.  
  1181.  
  1182.  
  1183.  
  1184.