KEY:
[1] Toolbar
[2] Server Dialogue
[3] Local File List
[4] Remote File List
[5] General Information
[6] Transfer Options
[7] Load Queue
3.1.1 Hosts This will bring up the Hosts window where you can maintain your bookmarks and choose a remote FTP site to connect to ( see Section 7 ).
3.1.2 Queue Display Use this to toggle whether the Queue Window is displayed or hidden.
3.1.3 Clipboard This copies the Server Dialogue ( [2] ) to the clipboard. You may then paste the Server Dialogue text into your favourite editor.
3.1.4 Options Here you may set the default program Options ( see Section 5 ). You should set these options before doing too much work in Hefty FTP.
3.1.5 Schedule This is used to maintain the queue schedule ( see Section 6 ). You may set the queue to start and stop at chosen times.
3.1.6 File Types Here you may define how Hefty FTP sets the Mac type and creator for downloaded files ( see Section 6 ).
3.1.7 Reload Local File List Press this to update the local file listing.
3.1.8 Download Use this as one method to download files. Select one or many files or folders in the Remote File List ( [4] ), and press this to place them in the queue for download. The local destination folder is the one showing in the Local File List ( [3] ).
Alternatively you may drag the selected files/folders from the Remote File List and drop them
i) on the Local File List
ii) on the Load Queue graphic ( [7] )
iii) on the Queue List in the Queue Screen ( see Section 4 )
3.1.9 Upload Use this as one method to upload files. Select one or many files or folders in the Local File List ( [3] ), and press this to place them in the queue for upload. The remote destination folder is the one showing in the Remote File List ( [4] ).
Alternatively you may drag the selected files/folders from the Local File List and drop them
i) on the Remote File List
ii) on the Load Queue graphic [7]
iii) on the Queue List in the Queue Screen ( see Section 4 )
3.1.10 Reload This will reload the current remote folder listing. Sometimes, if you are connected to a slow site or you are on a bad dialup line, this can be useful to redisplay the listing if a communications fault occurs.
3.1.11 New Remote Folder Use this to create a new remote folder. It will be created ( access permitting ) in the folder showing in the Remote File List. You will be prompted for a name - do NOT enter the path, just the name of the new folder.
3.1.12 Rename Remote File/Folder To rename a remote file or folder, select it in the Remote File List and press this button. You will be prompted for a new name - do NOT enter the path, just the name.
3.1.13 View Remote File To view a remote file select it in the Remote File List and press this button. Note that the file is transferred for ASCII display, and binary data will show garbage. You may only view files less than 100k in size.
3.1.14 Enter Manual Command This function allows you to enter a manual FTP command which is sent "as is" to the remote server. The response will be shown in the Server Dialogue field. Note that NO further processing will take place. If you have, for example, used a manual command to change directory, you would need to press the Reload button to process the listing for display.
3.1.15 Delete Remote File/Folder To delete remote files or folders, select them in the Remote File List and press this button. You will be asked to confirm the operation. In most cases non-empty folders will not be deleted - you should clear them out first.
3.1.16 Disconnect This disconnects you from the remote host. Note that only the connection in the main window is cut - any queue transfer connections are not affected.
3.1.17 STOP!! Pressing this attempts to stop or abort the current FTP operation in the main screen.
3.1.18 Reconnect If you have connected to a site, and then disconnected, this button allows you to reconnect. You will be shown the last remote folder that had been displayed prior to disconnecting. This is useful for "getting back to where you were".
This field lets you see the dialogue between Hefty FTP and the remote server.
Lines prefixed "*" are Hefty FTP commentary.
Lines prefixed ">" show what is sent to the server.
Lines prefixed "<" show incoming data from the server.
You should recognise this! The Local File List shows the volumes, folders and files on your Mac. To navigate amongst volumes you may choose a volume from the popup menu at top left of the list. To change folder, double click on the new folder in the File/Folder list. To go to any previously viewed folder within a volume, you may choose it from the popup menu to the right of the popup menu showning the volumes. If you are not in the top folder of a volume you may double-click the "up-arrow" displayed in the listing to navigate back up the folder chain. Your location on your Mac is stored on program close, so that you will be placed in the same folder when you start Hefty FTP again.
To upload files and folders, select them in this list and drag-and-drop the selection on the Remote File List, Load Queue graphic at bottom right, or the Queue List in the Queue Screen.
Note that the local size shown is the sum of the Data Fork and Resource Fork sizes. If, say, you upload in binary mode a graphic of type ".gif" that has a Mac resource fork containing a specialised icon, the remote file size will appear shorter than the local one. For such a file this is not a problem.
This shows the remote folder list when you are connected to an FTP server. Navigation is similar to the Local File List. Files and folders are shown as such, but all links are shown as linked folders ( since one does not know if they are files or folders ). Link handling is explained in section 3.10 below.
To download files and folders, select them in this list and drag-and-drop the selection on the Local File List, Load Queue graphic at bottom right, or the Queue List in the Queue Screen.
Shown here are:
* The number of local files appearing in the Local File List
* The number of remote files appearing in the Remote File List if connected
* The number of bytes transferred during the last remote folder listing transmission ( incremented as the transfer is in progress )
* The left pair of chasing-arrows displays when the queue is running
* The right pair of chasing arrows displays when the main connection is busy
This applies to both uploads and downloads. Check this if you wish subfolders of any folders loaded into the queue to also be transferred. Leave it unchecked to get only the files in the loaded folder.
Choose the order in which you wish to see the files displayed. This applies to both the local and remote listings, and is effective only when a new folder is displayed. The options are self-explanatory except for "None" which means display in the order received ( this is the quickest option ).
This applies to both uploads and downloads. Overwrite means that no attempt is made to resume, and files are overwritten. If you choose to resume, an attempt will be made to resume the transfer. Please be aware that NOT ALL FTP/HTTP servers support resuming, and in such cases the files will be overwritten.
Select the mode of transfer for the files you are loading in the queue. Note that this parameter is applied as the files are put in the queue and that subsequent change to this parameter will NOT affect items already loaded into the queue.
* ASCII mode causes translation of the end-of-line character(s) in text files, and thus should be used for known text files, and known text files ONLY. No Mac resource fork data is transmitted - only the text data. Ascii transfers are ALWAYS overwritten because the local and remote ( double ) translations make it impossible to resume.
* BINARY mode sends/receives the file "as-is" with no translation of any sort. For files with Resource Forks, only the Data Fork is transmitted.
* BEST GUESS mode takes a shot at guessing the best mode. For downloads files with ".txt", ".html", and ".htm" extensions are treated as ascii, other as binary. For uploads use is made of the REALbasic function to determine the file type - text files are sent as ascii, others as binary.
* MACBINARY mode will convert the file to be uploaded to a MacBinary temporary file prior to transmission, and the extension ".bin" will be added to the file name. For downloads ordinary Binary mode is used. Use this to upload files whose Resource Forks you wish to retain. Note that at this stage Hefty FTP does not do a direct Mac-to-Mac MacBinary transmission, although files are converted to MacBinary for upload.
This animated graphic can be used as a place to drop files or URLs for uploads/downloads. You may drop FTP and HTTP URLs from external programs here too, provided that they are properly formed file URLs that point to specific files ( ie: they do not end with "/" ).
Many of the main screen functions are mirrored in the menus, and the menus can be used in place of the normal controls.
Strange as it may seem, one of the most difficult design problems for Hefty FTP was a strategy for aliases. At least one other Mac FTP client will upload a Mac alias record "as is" to a Unix host, which is not very productive! Some notes on Hefty FTP and aliases then:
* In the Local File List aliases are shown under their alias names, and are shown as folders or files depending on the type of object the alias refers to. Double-clicking on a folder alias will take you to that folder.
* If you drag a file alias into the queue for uploading, the real file ( not the alias ) will be uploaded under ITS name not the name of the alias.
* If you drag a folder alias into the queue for uploading, the real folder ( not the alias ) will be uploaded to your chosen destination under ITS name.
* If you drag a folder into the queue, and some of the items in that folder are aliases, the above rules still apply.
* No checking is done for circular references - be careful!
* Dead aliases ( where the real file/folder has been deleted or removed ) are not processed.
A link is a remote alias, and the issue is that one is not sure whether a link is a file or a folder alias. Some notes on Hefty FTP and links:
* In the main window only known files may be Viewed by pressing the View toolbar button - not links.
* If you drag a link into the queue for download, Hefty FTP will first attempt to retrieve it as a file. If that fails, Hefty FTP will load it as a folder. So in most cases there is no need to be concerned - Hefty FTP will process it correctly.
* If you double-click on a link in the Remote File List ( ie: you think it is a folder ), Hefty FTP will attempt to treat it as a folder and load the listing. If this fails you will get an error displayed, and the current folder listing will be reloaded.
Last updated by DocGen on Monday, November 20, 2000 at 8:01:31 am