@database GoFetch!.guide @Width 80 @Node Main "GoFetch!.guide" ,ad8888ba, d8"' `"8b d8' 88 ,adPPYba, 88 88888 a8" "8a Y8, 88 8b d8 Y8a. .a88 "8a, ,a8" `"Y88888P" `"YbbdP"' 88888888888 88 88 88 ,d 88 88 88 88 88 88 88aaaaa ,adPPYba, MM88MMM ,adPPYba, 88,dPPYba, 88 88""""" a8P_____88 88 a8" "" 88P' "8a 88 88 8PP""""""" 88 8b 88 88 "" 88 "8b, ,aa 88, "8a, ,aa 88 88 aa 88 `"Ybbd8"' "Y888 `"Ybbd8"' 88 88 88 Go Fetch! 1.0 (c) 1999 Ian Chapman Written for Zeus Developments An FTP/HTTP Client designed to download a queue of files in the background. This version of Go Fetch! is shareware, all features are enabled except HTTP which requires a KeyFile. Please see the section on registering. @{" Introduction " Link "Introduction"} @{" Features " Link "Features" } @{" Requirements " Link "Requirements"} @{" Installation " Link "Installation"} @{" Menus " Link "Menus" } @{" Main Window " Link "Main Window" } @{" Add Window " Link "Add Window" } @{" Edit Window " Link "Edit Window" } @{" Transfer Window" Link "Trans Win" } @{" Arexx Commands " Link "Arexx" } @{" Arexx Scripts " Link "Scripts" } @{" Tool Types " Link "Tool Types" } @{" Bug Reports " Link "Bug Reports" } @{" History " Link "History" } @{" Future " Link "Future" } @{" Mailing List " Link "Mailing List"} @{" FAQ " Link "faq" } @{" Legal " Link "Legal" } @{" Other Products " Link "Products" } @{" Registering " Link "prereg" } @{" Contact " Link "Contact" } @endnode @node "Introduction" "Introduction to Go Fetch!" @{u}Introduction@{uu} Go Fetch! is a specialised FTP and HTTP client, designed to take the pain out of downloading lots of files, or very large files. By supplying a simple queue of files, Go Fetch! will happily just sit in the background and download them for you, whilst you get on with other tasks like browsing the web. Scenario 1: There's a large file on an FTP server you really want, but it's 25MB in size. You aren't really keen on leaving your machine connected to download a file that large, because of your phone bill. Well, simply add it to the queue of files in Go Fetch! and whenever you go online for whatever reason, Go Fetch! will download some more of the file each time, until you've got the file. Scenario 2: There's lots of files on an FTP/HTTP site you want, but they are spread across different directories. You don't want to have to wait until each file has finished downloading before getting the next. Well, simply add them to Go Fetch! and they will all be downloaded while you get on with other tasks. @endnode @node "Features" "Features of Go Fetch!" @{u}Features@{uu} - Uses MUI GUI. - No additional MCCs needed. - Extensive AREXX Support. - Supports FTP and HTTP (Registered Users Only) - File Resuming. (FTP only in Version 1.0) - File Comments. - Site Directory. - Profile History. - CPS Counter - Integration with your favourite web programs. - Bubble Help. - Online Help. - Context Sensitive Help. - RFC 959 and basic 1945 Compliancy. - Uses Fire & Forget technology. - Log File - Iconification - Mini Log which can open on any public screen. @endnode @node "Requirements" "Requirements" @{u}Requirements@{uu} - MUI 3.7 or higher - AmigaOS 3.0 or higher - BSD Socket compatible TCP/IP Stack (E.g. Miami, Genesis, Termite etc) - Minimum of 512K RAM Free. - reqtools.library V38 or higher (Included in distribution) Testing Go Fetch! has only been tested with Miami, Miami Deluxe and Termite TCP/IP stacks, however it should work with any BSD Socket compatible TCP/IP stack. The following stacks are BSD Socket compatible. AmiTCP AS255r2 Genesis Miami Miami Deluxe Termite TCP @{u}Machines Used For Testing@{uu} A4000T Amiga OS 3.1 and OS 3.5 74MB RAM Cyberstorm Mk 1 060@50Mhz Cybervision 64/3D running Cybergraphics Cybervision Scandoubler Ariadne II Ethernet Card GVP HC+8 SCSI Card Buddha IDE Card A4000T Amiga OS 3.1 and OS 3.5 154MB RAM Cyberstorm PPC 604e@233Mhz + 060@50Mhz Cybervision PPC running Cybergraphics Ariadne II Ethernet Card GVP HC+8 SCSI Card A4000 Desktop Amiga OS 3.0 16MB RAM Commodore A3630 030@25Mhz Cybervision 64/3D running Piccaso 96 A1200 Amiga OS 3.0 6MB RAM Apollo 1220 020@28Mhz A2000 Amiga OS 3.1 and 3.5 4 MB RAM Commodore 2020 (020@14)+MMU+68881 @endnode @node "Installation" "How to install" @{u}Installation@{uu} There are two installation scripts available, please make sure you use the correct one. Install_GoFetch!3x - For Amiga OS 3.0 or greater (Including OS 3.5). Install_GoFetch!35 - For Amiga OS 3.5 Only @endnode @node "Menus" "Menus" @{u}Menus@{uu} Project Menu ************ @{b}About...@{ub} (ShortCut: Amiga ?) Returns some basic information about Go Fetch!, including what it does, its current version, and the author. @{b}About MUI...@{ub} Returns some basic information about your MUI system @{b}MUI Settings@{ub} Allows you to configure your MUI settings, specifically for Go Fetch! @{b}Keyfile Info@{ub} Displays information contained within your keyfile. @{b}Iconify@{ub} (Shortcut: Amiga I) Iconifies Go Fetch! (hides the GUI) and an App Icon will appear on your workbench screen. To open the GUI again, double click on the App Icon. @{b}Quit@{ub} (Shortcut: Amiga Q) Quits Go Fetch! and frees any resources. @endnode @node "Main Window" "Go Fetch! - Main Window" @{u}Main Window@{uu} @{b}General@{ub} 1. Pressing TAB will cycle through all the gadgets. Pressing return will activate the currently highlighted gadget. 2. Holding the mouse over a gadget for a short period of time will display a helo bubble containing a brief description of the gadgets function. 3. Press help in Go Fetch! to display information about the currently selected window. @{b}MAIN PAGE@{ub} @{b}Top List View - Profile List@{ub} This contains a list of all the profiles you have added to Go Fetch!. Only the basic information is shown here, including the protocol the profile uses. @{b}Add Button@{ub} (Shortcut: A) Pressing this button will display the add window, allowing you to add a new profile to Go Fetch!. The new profile will be added at the bottom of the list. @{b}Edit Button@{ub} (Shortcut: E) Allows you to edit the information for the currently selected profile in the profile listview. @{b}Delete Button@{ub} (Shortcut: D) Pressing this button will delete the currently seleced profile. No confirmation action is displayed, so the effect is immediate. @{b}Stop Button@{ub} (Shortcut: S) This button is normally only available in the connected state. Pressing it will abort any transfers in operation and stop Go Fetch! from moving onto the next profile. @{b}Go Button@{ub} (Shortcut: G) This button will tell Go Fetch! to start running through all your profiles and begin downloading the files. Once Go Fetch! has successfully downloaded a file in a profile, that profile is automatically deleted and Go Fetch! moves onto the next. @{b}Quit Button@{ub} (Shortcut: Q) This button simply quits Go Fetch! @{b}Bottom List View - Log@{ub} This displays any commands being sent to an FTP/HTTP server, any messages received from an FTP/HTTP server or any information from Go Fetch! itself. Information displayed from Go Fetch! itself, is in bold and preceeded with the hash (#) symbol. Any text sent to the log using an AREXX script is in bold and preceeded with "#RX:" @{b}Save Log Button@{ub} (Shortcut: V) Saves all the text in Log Listview as a log file with the name gofetch.log. A filerequester opens, asking you where you would like to save the file. @{b}MiniLog Popup Button@{ub} Shows or hides the Minilog. The Minilog provides brief information on what Go Fetch! is currently doing, which allows the user to see at a glance what is going on. The Minilog can be opened on any public screen which to allow monitoring of Go Fetch! from another screen. @{b}Clear Log Button@{ub} (Shortcut: C) Clears all the text in the Log Listview. @{b}PROFILE HISTORY PAGE@{ub} @{b}Profile History Listview@{ub} All profiles deleted by Go Fetch! during a file transfer session are displayed here, including the profiles status. @{b}Clear History@{ub} Clears all profiles from the history listview. @{b}PREFERENCES PAGE@{ub} This now replaces the tooltypes used in earlier versions of Go Fetch! Any tooltypes set will be ignored. @{b}Anonymous Password@{ub} This is default password used for connecting to FTP servers anonymously. Convention dictates that this should usually be your E-Mail address. If no preferences are found, then the default is nobody@nobody.com. @{b}Default Download Directory@{ub} The default location to download files, for both FTP and HTTP transfers. If no preferences are found, then the default is RAM: @{b}MiniLog Screen@{ub} The public screen name of a screen on which the Go Fetch! Minilog Window should open. If the screen is closed when the Minilog Window is opened, it will be displayed on the systems default public screen. (Usually Workbench). If no preference file is found, then the default screen is Workbench. @{b}Beep On Completed File Transfer@{ub} When selected Go Fetch! will beep, or play the system sample upon completion of a file transfer. @{b}Save Prefs@{ub} Saves the current preferences. @endnode @node "Add Window" "Go Fetch! - Add Window" @{u}Add Window@{uu} @{b}General@{ub} 1. Pressing TAB will cycle through all the gadgets. Pressing return will activate the currently highlighted gadget. 2. Holding the mouse over a gadget for a short period of time will display a helo bubble containing a brief description of the gadgets function. 3. Press help in Go Fetch! to display information about the currently selected window. @{b}FTP PAGE@{ub} Use this tab, to add a new FTP profile. @{b}Site@{ub} The URL of the site you want to enter. This can either be a standard text URL such as ftp.whatever.com or the site IP address. Do not include any path information or filename here. @{b}Add Site Button (Right Arrow)@{ub} Pressing this button will add the site currently in the site text box, into the site directory. Please note, permanent changes to the site directory will only be made, once the add window has been closed. @{b}Popup Site Directory Button@{ub} Pressing this will display the site directory. If the site directory is currently displayed, pressing it again will hide the site directory. The site directory is intended as a covenient 'database' to add URLs which you commonly use to prevent you from typing them in. @{b}Site Listview (If Displayed)@{ub} This displays all the URLs, currently in the site directory. Double clicking on any URL in the site directory will put that URL into the Site Text Box. @{b}Delete Site from Directory Button (If Displayed, ShortCut D:)@{ub} Pressing this button, will delete the currently selected URL from the site directory. Please note, permanent changes to the sited irectory will only be made, once the add window has closed. @{b}Port Textbox@{ub} The FTP port of the site you want to access. This is almost always 21 so you should have rare occasion to change it. If you don't know what this is for then you probably won't ever need to change it. @{b}Username Textbox@{ub} The login name you need to use to log into the site, or anonymous if Anon Login is ticked. @{b}Anon Login CheckMark@{ub} For many FTP sites, you don't need a specialised account to access their files because they allow anonymous login. If you don't have an account on the FTP site, tick this box to perform an anonymous login. Username will contain anonymous and password will contain the default anonymous password you specified as a Tool Type. This is usually your E-Mail address. @{b}Password TextBox@{ub} This is the password you need to login into the site. If Anon Login is ticked, it will contain your default anonymous password. @{b}Remote Path Textbox@{ub} This should contain the path/location of the file on the remote FTP server. Remember, most FTP servers are UNIX systems, so the path should be case correct too. For example, /pub/system is not the same as /PUB/system . @{b}Filename Textbox@{ub} This contains the complete filename of the file you wish to download. Remember, most FTP servers are UNIX systems, so the filename should be case correct. For example, gofetch.lha is not the same as GoFetch.lha . @{b}Download Textbox@{ub} This contains the path where you want to download the file to. @{b}File Icon@{ub} Pressing this will bring up a file requestor asking where you want to download files to. Once a directory has been chosen, the path will automatically be entered into the Download Textbox. @{b}OK Button@{ub} Pressing this will add the new FTP profile to Go Fetch!. It will appear at the bottom of the profile listview. @{b}Cancel Button@{ub} Pressing this will discard the current profile and close the Add Window. @{b}HTTP PAGE@{ub} (Active only for registered users) Use this tab to add a new HTTP profile. @{b}Site@{ub} Complete URL including the path and filename. For example, www.whatever.com/files/myfile.lha. DO NOT prefix it with HTTP:// @{b}Port@{ub} The HTTP port of the site you want to access. The default HTTP port is 80, and you should have rare occasion to change it. If you don't know what this is for, then you probably won't need to change it. @{b}Download@{ub} The location in which to save the file. @{b}File Icon@{ub} Pressing this will open a file requestor and allow you to choose a location. The location is automatically entered into the Download textbox. @{b}OK@{ub} Pressing OK will add the current HTTP profile to the profile listview and close the add window. The profile is automatically saved. @{b}Cancel@{ub} Pressing cancel will discard the HTTP profile and close the add window. @endnode @node "Edit Window" "Go Fetch! - Edit Window" @{u}Edit Window@{uu} @{b}General@{ub} 1. Pressing TAB will cycle through all the gadgets. Pressing return will activate the currently highlighted gadget. 2. Holding the mouse over a gadget for a short period of time will display a helo bubble containing a brief description of the gadgets function. 3. Press help in Go Fetch! to display information about the currently selected window. @{b}FTP PAGE@{ub} If the current profile you are editing is an FTP profile, then all the gadgets in the HTTP TAB will be ghosted. @{b}Site Textbox@{ub} The URL of the site you want to enter. This can either be a standard text URL such as ftp.whatever.com or the site IP address. @{b}Add Site Button (Right Arrow)@{ub} Pressing this button will add the site currently in the site text box, into the site directory. Please note, permanent changes to the site directory will only be made, once the edit window has been closed. @{b}Popup Site Directory Button@{ub} Pressing this will display the site directory. If the site directory is currently displayed, pressing it again will hide the site directory. The site directory is intended as a covenient 'database' to add URLs which you commonly use to prevent you from typing them in. @{b}Site Listview (If Displayed)@{ub} This displays all the URLs, currently in the site directory. Double clicking on any URL in the site directory will put that URL into the Site Text Box. @{b}Delete Site from Directory Button (If Displayed, ShortCut D)@{ub} Pressing this button, will delete the currently selected URL from the site directory. Please note, permanent changes to the sited irectory will only be made, once the edit window has closed. @{b}Port Textbox@{ub} The FTP port of the site you want to access. This is almost always 21 so you should have rare occasion to change it. If you don't know what this is for then you probably won't ever need to change it. @{b}Username Textbox@{ub} The login name you need to use to log into the site, or anonymous if Anon Login is ticked. @{b}Anon Login CheckMark@{ub} For many FTP sites, you don't need a specialised account to access their files because they allow anonymous login. If you don't have an account on the FTP site, tick this box to perform an anonymous login. Username will contain anonymous and password will contain the default anonymous password you specified as a Tool Type. This is usually your E-Mail address. @{b}Password TextBox@{ub} This is the password you need to login into the site. If Anon Login is ticked, it will contain your default anonymous password. @{b}Remote Path Textbox@{ub} This should contain the path/location of the file on the remote FTP server. Remember, most FTP servers are UNIX systems, so the path should be case correct too. For example, /pub/system is not the same as /PUB/system . @{b}Filename Textbox@{ub} This contains the complete filename of the file you wish to download. Remember, most FTP servers are UNIX systems, so the filename should be case correct. For example, gofetch.lha is not the same as GoFetch.lha . @{b}Download Textbox@{ub} This contains the path where you want to download the file to. @{b}File Icon@{ub} Pressing this will bring up a file requestor asking where you want to download files to. Once a directory has been chosen, the path will automatically be entered into the Download Textbox. @{b}OK Button@{ub} Pressing this will make the necessary changes to the selected profile. @{b}Cancel Button@{ub} Pressing this will discard any changes and close the edit window. @{b}HTTP PAGE@{ub} (Active Only for Registered Users) If the current profile you are editing is an HTTP profile, then all gadgets in the FTP TAB will be ghosted. @{b}Site@{ub} Complete URL including the path and filename. For example, www.whatever.com/files/myfile.lha. DO NOT prefix it with HTTP:// @{b}Port@{ub} The HTTP port of the site you want to access. The default HTTP port is 80, and you should have rare occasion to change it. If you don't know what this is for, then you probably won't need to change it. @{b}Download@{ub} The location in which to save the file. @{b}File Icon@{ub} Pressing this will open a file requestor and allow you to choose a location. The location is automatically entered into the Download textbox. @{b}OK@{ub} Pressing OK will save the changes to the HTTP profile and close the edit window @{b}Cancel@{ub} Pressing cancel will discard any changes and close the edit window. @endnode @node "Trans Win" "Go Fetch! - Transfer Window" @{u}Transfer Window@{uu} @{b}Transfer Gauge@{ub} This displays how much of the file you have received so far in Kilobytes, as well as the percentage received. @{b}CPS Rate@{ub} This displays your CPS rate, aka the speed of the transfer. Go Fetch! takes a sample every five seconds and calculates the average cps rate over those five seconds. @{b}Abort Button@{ub} (Shortcut: A) Pressing this will abort the current file transfer, Go Fetch! will close the connection, then continue onto the next profile. @{b}Stop Button (On Main Window)@{ub} Pressing this will abort the current connection, Go Fetch! will close the connection to the server, and NOT continue with any of the other profiles. @endnode @node "Arexx" "Go Fetch! - Arexx Commands" @{u}Arexx Commands@{uu} For examples of how to use AREXX with Go Fetch!, please see included AREXX scripts. AREXX PORT: GOFETCH These returncodes apply to all Arexx Commands -4 = Command received wrong number of parameters -3 = Command received parameter of wrong type -2 = Out of Memory (except where stated) @{b}Command:@{ub} addanonprofile @{b}Parameters:@{ub} SITE/A,PORT/A,REMOTEPATH/A,FILENAME/A,DOWNLOADDIR/A @{b}ReturnCodes:@{ub} 0 = Success @{b}Description:@{ub} Adds a new FTP profile to Go Fetch!. The profile will perform an anonymous login, using your default anonymous password. The profile is automatically saved. @{b}Command:@{ub} addhttpprofile @{b}Parameters:@{ub} SITE/A,PORT/A,DOWNLOADDIR/A @{b}ReturnCodes:@{ub} 0 = success -5 = Go Fetch! is not registered. @{b}Description:@{ub} Adds a new HTTP profile to Go Fetch!. SITE should contain a complete URL including path and filename, for example, www.whatever.com/files/file.lha. The profile is automatically saved. Note: Requires registered version of Go Fetch! @{u}(See: addprofile, edithttpprofile@{uu} @{b}Command:@{ub} addprofile @{b}Parameters:@{ub} SITE/A,PORT/A,USERNAME/A,PASSWORD/A,REMOTEPATH/A,FILENAME/A,DOWNLOADDIR/A @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Adds a new FTP profile to Go Fetch!. The profile will perform a named login, using the login name and password you specify. The profile is automatically saved. @{u}(See: editprofile, addhttpprofile)@{uu} @{b}Command:@{ub} addsite @{b}Parameters:@{ub} SITE/A @{b}ReturnCodes:@{ub} 0 = Success -1 = Failed, could not open site directory file. -2 = Failed, Add or Edit window was open. @{b}Description:@{ub} Adds an FTP URL to the site directory. This should be the domain only and not include any path details of filename details. You cannot add a site, if the Add or Edit Window is open. @{b}Command:@{ub} annotate @{b}Parameters:@{ub} TEXT/A @{b}ReturnCodes:@{ub} 0 = Success @{b}Description:@{ub} Writes directly to the Go Fetch! log listview. This can be useful in cases where AREXX scripts need to give any output. Please note that any strings longer than 74 characters will be truncated. All strings sent using annotate will appear in bold and are prefixed with "#RX:". Special codes can be inserted into the text to provide special formatting, each code used will count as 1 character. These are: (The Escape Character (Ascii 27, $1B) can be displayed in most text editors by pressing CTRL [) ESCu - Underline ESCb - Bold ESCi - Italics ESCn - Set back to normal. ESC - Where X is a colour between 2 and 9. Note: NO OTHER Escape Sequences should be used. @{b}Command:@{ub} clearhistory @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description@{ub} Clears the profile history. @{b}Command:@{ub} clearlog @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Clears the Go Fetch! log listview. @{b}Command:@{ub} deleteprofile @{b}Parameters:@{ub} PROFILE/N @{b}ReturnCodes:@{ub} 0 = success -1 = Profile doesn't exist. @{b}Description:@{ub} Deletes the profile passed by the profile number. Please note that profiles are are numbered starting at 0. For example if there are 8 profiles in Go Fetch! then they are numbered from 0 to 7. Warning: Under no circumstances should you pass a negative profile number. @{u}(See: profiles)@{uu} @{b}Command:@{ub} dlstatus @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = In Unconnected State 1 = In Connected State (But Not Downloading) 2 = Downloading FTP File. 3 = Downloading HTTP File. @{b}Description:@{ub} Tells you what state Go Fetch! is currently in. @{b}Command@{ub} edithttpprofile @{b}Parameters:@{ub} PROFILE/N,SITE/A,PORT/A,DOWNLOADDIR/A @{b}ReturnCodes:@{ub} 0 = success -1 = Profile Doesn't Exist -5 = Go Fetch! isn't registered. @{b}Description:@{ub} Edits the currently chosen profile. Please note that profiles are numbered from 0 onwards, for example if there are 8 profiles in Go Fetch! then they are numbered 0 to 7. The edited profile is automatically saved, and the profile listview is updated to reflect the changes. Note: Requires Registered version of Go Fetch! Warning: Under no circumstances should you pass a negative profile number. Warning: DO NOT use this command to edit an FTP profile. It may cause adverse effects. Use the command returnprotocol to check first. @{u}(See: profiles, addhttpprofile, editprofile, returnprotocol)@{uu} @{b}Command:@{ub} editprofile @{b}Parameters:@{ub} PROFILE/N,SITE/A,PORT/A,USERNAME/A,PASSWORD/A,REMOTEPATH/A,FILENAME/A,DOWNLOADDIR/A @{b}ReturnCodes:@{ub} 0 = success -1 = Profile doesn't exist. @{b}Description:@{ub} Edits the currently chosen profile. Please note that profiles are numbered from 0 onwards, for example if there are 8 profiles in Go Fetch! then they are numbered 0 to 7. The edited profile is automatically saved, and the profile listview is updated to reflect the changes. Warning: Under no circumstances should you pass a negative profile number. Warning: DO NOT use this command to edit an HTTP profile. It may cause adverse effects. Use the command returnprotocol to check first. @{u}(See: profiles, addprofile, edithttpprofile, returnprotocol)@{uu} @{b}Command:@{ub} getanon @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}ReturnString:@{uÿÿ Default Anonymous Password @{b}Description:@{ub} Returns the users default anonymous password, as set in the preferences. @{b}Command:@{ub} getdownloadpath @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}ReturnString:@{ub} Default Download Directory @{b}Description:@{ub} Returns the users default download directory, as set in the preferences. @{b}Command:@{ub} gofetch @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = Success @{b}Description:@{ub} Simulates the GO button. Go Fetch! will start downloading files and working through the profiles. @{b}Command:@{ub} iconify @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Iconifies Go Fetch! @{u}(See: uniconify, iconifystatus)@{uu} @{b}Command:@{ub} iconifystatus @{b}Parameres:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = uniconified 1 = iconified @{b}Description:@{ub} Returns whether Go Fetch is iconified. @{u}(See: iconify, uniconify)@{uu} @{b}Command:@{ub} lockgui @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Locks the Go Fetch! main window from receiving user input. This command is nested, therefore if you tell the window to lock twice, you must also tell it to unlock twice. Warning: Use with caution. Misuse could lock the user out of the program permanently. @{u}(See: unlockgui)@{uu} @{b}Command:@{ub} openaddwindow @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Opens the profile add window, simulates the user pressing the ADD button. Warning: This command will return success (0), regardless of whether the window opened or not. Be prepared for it. @{b}Command:@{ub} openeditwindow @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Opens the edit window, simulates the user pressing the EDIT button. Please note that the edit window will not open if a profile isn't active. Warning: This command will return success (0), regardless of whether the window opened or not. Be prepared for it. @{u}(See: setactiveprofile, profiles)@{uu} @{b}Command:@{ub} profiles @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} Number of Profiles @{b}Description:@{ub} Returns the number of profiles in Go Fetch!. For example, if there are 8 profiles in Go Fetch!, then this command will return 8. @{b}Command:@{ub} quitgofetch @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Quits Go Fetch! @{b}Command:@{ub} registered @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = Not Registered. 1 = Registered @{b}Description:@{ub} Returns whether Go Fetch! has been registered or not. This may be required as AREXX commands relating to HTTP are for registered users only. This may extend to new commands in the future. @{b}Command:@{ub} release @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} Release Number @{b}Description:@{ub} Returns the release number of Go Fetch!. Each public release of Go Fetch! will have it's release number incremented by 1, independant of the program version. @{b}Command:@{ub} reloadprofiles @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Forces Go Fetch! to reload the profiles from the profiles file. This has no real practical use because Go Fetch! automatically updates the profiles whenever an addition or edit is made. This command may be useful to those who feel confident enough to edit the profiles file directly, however this is highly unadvised. @{b}Command:@{ub} returnprotocol @{b}Parameters:@{ub} PROFILE/N @{b}ReturnCodes:@{ub} 0 = Profile is an FTP Profile 1 = Profile is an HTTP Profile @{b}Description:@{ub} Returns the protocol a profile is set to use. Please note, profiles are numbered from 0 onwards. For example, if there are 8 profiles, then they will be numbered 0 to 7. Warning: Under no circumstances should you pass a negative profile number. @{u}(See: edithttpprofile, editprofile)@{uu} @{b}Command:@{ub} savelog @{b}Parameters:@{ub} PATH/A @{b}ReturnCodes:@{ub} 0 = success -1 = Unable to save logfile. Check your path. @{b}Description:@{ub} Saves the Go Fetch! log with a filename of gofetch.log at the chosen path. @{b}Command:@{ub} setactiveprofile @{b}Parameters:@{ub} PROFILE/N @{b}ReturnCodes:@{ub} 0 = success -1 = Profile doesn't exist @{b}Description:@{ub} Highlights the profile entry in the profile listview passed by the profile number. Please note that profiles are numbered starting at 0. For example if there are 8 profiles in Go Fetch! then they are numbered from 0 to 7. Warning: Under no circumstances should you pass a negative profile number. @{u}(See: profiles)@{uu} @{b}Command:@{ub} setminilog @{b}Parameters:@{ub} STATUS/N @{b}ReturnCodes:@{ub} 0 = success -1 = Failure, window is already open/closed @{b}Description:@{ub} If STATUS is 1 (actually =>1) then it will try to open the minilog window. If STATUS is 0 (actually <=0) then it will try to close the minilog window. @{b}Command:@{ub} stop @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Aborts the current file transfer, and stop Go Fetch! from moving onto the next profile. @{b}Command:@{ub} uninconify @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Uniconifies Go Fetch! @{u}(See: iconify)@{uu} @{b}Command:@{ub} unlockgui @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Unlocks the Go Fetch! main window to allow user input after the lockgui command has been issued. This command is nested, therefore if you tell the window to lock twice, you must also tell it to unlock twice. @{u}(See: lockgui)@{uu} @{b}Command:@{ub} windowopen @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = No Windows Open 1 = Add Window Open 2 = Edit Window Open @{b}Description:@{ub} Returns whether any windows are currently open (Add, Edit). @{b}Standard MUI Arexx Commands@{ub} @{b}Command:@{ub} HELP @{b}Parameters:@{ub} FILE/A @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Lists GO Fetch Arexx Commands into the file specified. @{b}Command:@{ub} HIDE @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Iconifies Go Fetch! @{b}Command:@{ub} INFO @{b}Parameters:@{ub} ITEM/A @{b}ReturnCodes:@{ub} 0 = success Returns requested string in result. @{b}Description:@{ub} Where ITEM is: TITLE = Title of Application AUTHOR = Author of Application COPYRIGHT = Copyright Message DESCRIPTION = Description of Go Fetch VERSION = Current Version BASE = Name of AREXX Port SCREEN = Name of public screen @{b}Command:@{ub} QUIT @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Quits Go Fetch! @{b}Command:@{ub} SHOW @{b}Parameters:@{ub} NONE @{b}ReturnCodes:@{ub} 0 = success @{b}Description:@{ub} Uniconfies Go Fetch! @endnode @node "Scripts" "Arexx Scripts" @{u}Arexx Scripts@{uu} These scripts are designed to integrate Go Fetch with other applications, for example Aweb-II which allows you to automatically create profiles. Scripts for the other browsers such as Voyager and IBrowse as soon as they have decent AREXX ports. If you have any AREXX scripts which integrate Go Fetch! into other software, please feel free to E-Mail me them and you'll receive a FREE keyfile for future versions of Go Fetch! Please note that any submitted AREXX scripts will be distributed with future versions of Go Fetch!. Upon submitting the author gives their permission for Ian Chapman and Zeus Developments to distribute and modify the code. Any modifcations would be commented as so in the source. The original author will have full credits in the source. @{b}The Script(s)@{ub} @{" browser.rexx " Link "browser.rexx" } by Marc Bradshaw @{" StartGoFetch.miami " Link "startgofetch.miami" } by Marc/Ian @{" StopGoFetch.miami " Link "startgofetch.miami" } by Marc/Ian @{" AmFTPtoGoFetch.rexx" Link "amftptogofetch.rexx" } by Mike King @{" YAMtoGoFetch.rexx " LINK "yamtogofetch.rexx" } by Mike Cardwell @{" GoFetch.thor " LINK "gofetch.thor" } by Neil Bothwick @{" GoFetch.br " LINK "gofetch.br" } by Neil Bothwick @{" AminetFetch.rexx " LINK "aminetfetch.rexx" } by Olivier Fabre @{" AminetExtract.rexx " LINK "aminetextract.rexx" } by Olivier Fabre @{" batch2gofetch.rexx " LINK "batch2gofetch.rexx" } by Stephen Bridges @{" yam2gofetch.rexx " LINK "yam2gofetch.rexx" } by Stephen Bridges @endnode @node browser.rexx "browser.rexx" @{b}browser.rexx@{ub} Notes: This script has only been tested on Aweb-II version 3.0 and the AWeb version supplied with AmigaOS 3.5 and therefore I cannot guarantee it's compatibility with different versions. The installation procedure may differ depending on your version of Aweb. There are two ways in which you can use the script within Aweb. For maximum flexibility you probably want to use both. @{b}Use: Method 1@{ub} @{b}Installation in Aweb via the AREXX Menu@{ub}. Method 1 uses the AREXX script in the AREXX menu of Aweb. This allows you to mark text (as if you were doing a copy & paste) and selecting the AREXX script from the menu, it will automatically create a new profile. 1. Open Settings Menu 2. Choose GUI Settings 3. Select the AREXX tab. 4. Press ADD and fill in the following fields. Title = Send to Go Fetch! Macro = AWEBSEL PATH n.b. the PATH argument is optional, if GoFetch! is in the command path then the script will find it, if not you must specify its path here. @{b}Use: Method 2@{ub} @{b}Installation in Aweb via PopUp Menus@{ub} Method 2 uses the AREXX script in a popup menu. This allows you to press the right mouse button over a link and send the link to Go Fetch! and a profile will be created for you. 1. Open Settings Menu 2. Choose GUI Settings 4. Select PopUp TAB 3. Press ADD and fill in the following fields Type = Link Popup Menu Title = Send to Go Fetch! Command = RUN URL %u PATH n.b. the PATH argument is optional here as above. @{b}Use from the command line@{ub} rx browser.rexx [AWEBSEL | URL ] [TO ] [PATH ] [?] ? - Request This Help Text AWEBSEL - if run from aweb, grabs selected text as url should not be used with the URL keyword URL - the url to add as a profile should not be used with the AWEBSEL keyword TO - direcroty to download to if not supplied the default as defined in GoFetch! will be used. PATH - GoFetch! Path The Path to the GoFetch! executable if not supplied the script will search the current command path for GoFetch! For Example: rx browser.rexx URL ftp://site.com/dir/anotherdir/file.lha rx browser.rexx URL ftp://me@secret@site.com/yetanotherdir/kewl.txt Path SYS:Internet/GoFetch!/GoFetch! rx browser.rexx URL ftp://site.com/file.lha TO Ram: If Go Fetch! is not running when the script is called, it will attempt to start Go Fetch! for you, by checking in the standard command path. You MUST make sure that GoFetch! is in the command path or you have specified the path to the GoFetch! Executable using the PATH option if you want this feature to work. @{b}Return Codes@{ub} Browser.rexx returns the following values. 0 = Success 1 = Go Fetch! is not running and could not be started 2 = Go Fetch! is not running and couldn't be located. 3 = Go Fetch! is not running and the user chose not to start it. 4 = Unsupported Protocol (Eg trying to use HTTP/FILE/GOPHER etc) 5 = Invalid URL -ve = Add Profile return value -4 = Wrong number of parameters passed to Go Fetch! -3 = Parameter of wrong type passed to Go Fetch! @endnode @node startgofetch.miami "startgofetch.miami" @{b}StartGoFetch.miami@{ub} & @{b}StopGoFetch.miami@{ub} These scripts are designed to automatically start and stop GO Fetch! when you go online. If the AREXX script finds profiles contained within Go Fetch! it will tell Go Fetch! to GO, otherwise it will Quit Go Fetch!. When you go offline, the AREXX scripts tells Go Fetch! to Stop and Quit. @{b}Miami Deluxe (DX) Installation@{ub} 1. Choose Interfaces. 2. Highlight the interface you want to use Go Fetch! with when you go online. 3. Press Edit 4. Press Events 5. Change "Active Offline" to the location of the StopGoFetch.miami script 6. Change the script type to AREXX 7. Repeat this for "Passive Offline" 8. Change "Online" to the location of the StartGoFetch.miami script, followed by the location of your Go Fetch! executable. 9. Change the script type to AREXX 10. Press OK and Save your settings. @{b}Miami Installation@{ub} 1. Choose Events 2. Change "Active Offline" to the location of the StopGoFetch.miami script 3. Change the script type to AREXX 4. Repeat this for "Passive Offline" 5. Change "Online" to the location of the StartGoFetch.miami script, followed by the location of your Go Fetch! executanle 6. Change the script type to AREXX 7. Save your settings. @endnode @node amftptogofetch.rexx "amftptogofetch.rexx" @{b}AmFTPtoGoFetch.rexx@{ub} by Mike King This script reads in a batch file from amFTP and adds each entry from it into GoFetch! Profiles so that GoFetch! can be used to download the files. Usage: You must have a profile in Amftp for the site you want to download all the files from. Logon to that site from amftp and save a batch list of all the files you want to download. Name the Batch list the EXACT name as the Profile used in amftp's default batch directory. Then Run this script using the batch list filename as the argument. Example: Save a batch of files from aminet into a file name AMINET in amftp's batches/ directory. Then run the script Batch->GoFetch AMINET Program: The program Uses the argument to load the file from amftp's batch directory. It always uses the batch directory. Then it starts reading files from batch list. It finds the profile in amftp that matches the filename to get all the conenction information from. Then it creates a directory structure for the files in your download location that matches the deepest directory name from the site. This keeps everything organised. Then it adds all the files as profiles into GoFetch! NOTE: You will need to alter the paths in this file if you want it to automatically startup GoFetch! and amftp when needed. @endnode @node "Tool Types" "Tool Types" @{u}Tool Types@{uu} From version 1.0, the Tooltypes are no longer used. Please use the preferences page within Go Fetch! to choose your settings. @endnode @node "Bug Reports" "Bug Reports" @{u}Bug Reports@{uu} Go Fetch! has been extensively tested, however if you discover a bug, please submit a bug report and include the following information Machine Machine Description (Including Model, Processor, RAM, Cards, etc) AmigaOS Version TCP/IP Stack you are using (Including version) Any Enforcer/Cyberguard/Segtracker/Mungwall output A good clear desciption of the bug. If possible, a log file created from Go Fetch! Details on the FTP site you were using, and the file you were tring to download. Send bug reports to ian.chapman@bleach.demon.co.uk @endnode @node "History" "Program History" @{u}History@{uu} Thanks to all those who have registered and sent it suggestions & Bug Fixes. @{b}Version 0.9b@{ub} First Public Beta Release @{b}Version 0.95b@{ub} Second Public Beta Release @{b}Bug Fixes:@{ub} -Now Snapshots Transfer Window. -Now Snapshots Add Window -Now Snapshots Edit Window -Anon Checkmark is now set if profile is anonymous -Changed timeout to 25 seconds (was 40) -Fixed continuous downloading. Previously it would not continue onto the next profile if the main window was not selected. This was due to a quirk in MUI. -Moved location of profiles file to the program directory. This might resolve conflicts with HappyENV. -Fixed RC 421 Problem. Previously if Go Fetch! received a code 421 on login, it would send QUIT then get stuck in a Busy Loop. @{i}(Jostein Klemmetsrud)@{ui} @{b}New Features:@{ub} -Adds comments to downloaded files. -Added Site Directory @{b}New Arexx Commands@{ub} addanonprofile addsite gofetch stop windowopen @{b}New ARexx Scripts@{ub} StartGF.miami StopGF.miami AmFTPtoGoFetch.rexx browser.rexx - UPDATED @{b}Version 0.97b@{ub} Internal Release Only @{b} Version 1.0@{ub} First Shareware Release @{b}Bug Fixes:@{ub} - Now REALLY snapshots the windows. The problem was due to a pointer being passed instead of a unique identifier, so consequently MUI would usually forget the window positions. - FTP routines are a little more robust, should fix the problem with War FTP of logging out prematurely. @{b}New Features@{ub} - Added basic HTTP support (Registered Users Only) - Added a Minilog window which can be opened on any public screen. Provides brief information on what Go Fetch! is doing. - Added preferences tab. (Replaces Tooltypes) - Added profile history tab which records the status of used profiles. - Improved GUI look. - CPS Counter @{b}New Arexx Commands@{ub} addhttpprofile annotate clearhistory edithttpprofile returnprotocol registered setminilog @{b}New Arexx Scripts@{ub} AmFTPtoGoFetch.rexx (Mike King) AminetExtract.rexx (Olivier Fabre) AminetFetch.rexx (Olivier Fabre) batch2gofetch.rexx (Stephen Bridges) GoFetch.br (Neil Bothwick) GoFetch.thor (Neil Bothwick) yam2gofetch,rexx (Stephen Bridges) YAMtoGoFetch.rexx (Mike Cardwell) @endnode @node "Future" "Future" @{u}Future@{uu} I would like to add the following features to future versions of Go Fetch! If you have any additional suggestions, then please feel free to E-Mail me. - Resume for HTTP sites that support it. - Multiple Simultaneous Downloading (Downloading from several sites at the same time) - Bandwidth Setting (Set a maximum bandwidth Go Fetch! should use) - Locale Support - Keep connection alive if the next file is on the same server - Profile Reorganisation @endnode @node "Legal" "Legal" @{u}Legal@{uu} ZEUS DEVELOPMENTS AND IAN CHAPMAN MAKE NO REPRESENTATIONS OR WARRANTIES IN ANY FORM WITH RESPECT TO ANY SOFTWARE IN THE "GO FETCH!" PACKAGE AND SPECIFICALLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTIES WITH REGARDS TO THE MERCHANTABILITY, TITLE OR FITNESS FOR A PARTICULAR PURPOSE, EXCEPT WHERE REQUIRED UNDER THE LAWS OF THE UNITED KINGDOM OF GREAT BRITAIN AND NORTHERN IRELAND. IAN CHAPMAN RESERVES THE RIGHT TO MODIFY, REPLACE, EXCLUDE OR DISCONTINUE ANY AND ALL PARTS OF THE "GO FETCH!" PACKAGE AT ANY TIME, WITHOUT OBLIGATION OR PRIOR NOTIFICATION TO ANY PERSON(S) OR ENTITY. IAN CHAPMAN OR ZEUS DEVELOPMENTS WILL IN NO WAY BE LIABLE TO YOU FOR DAMAGES ARISING OUT OF THE USE OR MISUSE OF THE PROGRAM AND RELATED FILES (INCLUDING, BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY ANY PERSON(S) OR ENTITY, OR DAMAGE TO HARDWARE), EVEN IF ANY PERSON(S) OR ENITY HAVE BEEN ADVISED OF SUCH DAMAGES. ALL TRADEMARKS ARE RECOGNISED AS BELONGING TO THEIR RESPECTIVE OWNERS. THE FOLLOWING LICENSE APPLIES TO THE PRODUCT "GO FETCH!" AND RELATED FILES IN THE "GO FETCH!" PACKAGE, WRITTEN BY IAN CHAPMAN FOR ZEUS DEVELOPMENTS. * You may only distribute verbatim copies of the original distribution as released by Ian Chapman and/or Zeus Developments. All executables, documentation, examples and related files must be intact. The only exception is that the entire original distribution may be compressed in another form, providing it is fully intact. Ian Chapman reserves the right to disallow the use of any and all parts of the distribution by any person(s) or entity, * You may not modify any binary or documentation contained within the package, except for purposes of compression. Disassembling, decompiling, re-sourcing or otherwise reverse engineering the program is strictly prohibited. * By the use and distribution of any part of the distribution, you agree to the license in full. * "Go Fetch!" and any "Go Fetch!" distribution may not be sold, or re-sold without written permission from Ian Chapman. * For use of the "Go Fetch!" program and distribution, outside of this license agreement, permission must be obtained from Ian Chapman. * Go Fetch! may not be used in any commercial distributions or enterprises without witten permission. The exceptions to this are the inclusion on any Aminet CD's or Magazine Coverdisks and CoverCDs. * The duplication or distribution of keyfiles is strictly prohibited, however one duplicate is allowed for backup purposes only. Keyfiles may not be sold, resold or transferred to any person(s) or entity without written permission. * FREE keyfiles remain the property of Ian Chapman and the right to use those keyfiles main be withdrawn by Ian Chapman, at any time without reason or explanation of any kind, to any person(s) or entity. @endnode @node "Contact" "Contacting the Author" @{u}Contact@{uu} E-Mail: ian.chapman@bleach.demon.co.uk Fidonet: 2:256/607.11 Go Fetch! Web Site www.bleach.demon.co.uk/gofetch/ Zeus Developments Web Site www.bleach.demon.co.uk/zeus/ Big Book of Amiga Hardware Webpages www.amigaworld.freeserve.co.uk @endnode @node "yamtogofetch.rexx" "yamtogofetch.rexx" @{b}YAMtoGoFetch.rexx@{ub} by Mike Cardwell To integrate with YAM. 1.) Go to Configuration in the Settings menu. 2.) Select "ARexx" 3.) Scroll to the bottom, and click on "When double-clicking an url" 4.) Select Arexx from the pull down menu. 5.) Type in the full path of Yam-GoFetch (Including the filename) 6.) Both tick boxes want to be unselected 7.) Fill in requested information below Now. When double clicking an ftp:// url, the download information will be sent to GoFetch. It will only work with URL's ending with a filename. Please see the AREXX script for additional information. @endnode @node "gofetch.thor" "gofetch.thor" @{b}GoFetch.thor@{ub} by Neil Bothwick Designed for use in the E-Mail/Fidonet Package THOR. Runs GoFetch.br for the current system Can be called from the Arexx menu or as a system exit event Please see the AREXX script for additional information. @endnode @node "gofetch.br" "gofetch.br" @{b}GoFetch.br@{ub} by Neil Bothwick GoFetch.br will transfer files selected for download in THOR from the Events editor to the GoFetch! profiles list. Usage: GoFetch.br SystemName/A If you want to do the transfer from within THOR, run GoFetch.thor from the Arexx menu or as the system Exit command. GoFetch.thor simply determines the current system name and passes it to GeFetch.br. Installation involves copying both scripts to Thor/rexx, editing the GFPath variable to point to your copy of GoFetch! and setting FetchReadme to 1 if you want GoFetch! to get the Aminet readme files too For additional information, please see the AREXX script. @endnode @node "aminetfetch.rexx" "aminetfetch.rexx" @{b}AminetFetch.rexx@{ub} by Olivier Fabre Insert all files listed in an Aminet INDEX or RECENT file into GoFetch! profiles list. GoFetch! will be run if necessary. Template : FILE=F,GETREADMES=GR/T,LOCALDIRS=LDS/T,AMINETSERVER=AS/K,AMINETPATH=AP/K, LOCALDIR=LD/K,GOFETCH=GF/K FILE Name of the file containing the list of files to be downloaded from Aminet (default : "AMINET_EXTRACTED"). Format of this file : ... GETREADMES/T YES/ON : Download readme files (default). NO/OFF : Download only the main file. LOCALDIRS/T YES/ON : Recreate the Aminet tree locally (default). NO/OFF : Put all files in the same directory (LocalDir). AMINETSERVER/K Your favourite Aminet server (default : "de.aminet.net"). AMINETPATH/K Path to Aminet on the server (default : "/pub/aminet/"). This shouldn't need to be changed. LOCALDIR/K Where to put the downloaded files (default : "DOWNLOAD:"). GOFETCH/K GoFetch! location (default : "NET:GoFetch!/GoFetch!"). Required : RexxDOSSupport.library (Copyright (C) 1994-1997 by hartmut Goebel) (Aminet:util/rexx/rexxdossupport.lha) For additional information, please see the AREXX script. @endnode @node "aminetextract.rexx" "aminetextract.rexx" @{b}AminetExtract.rexx@{ub} by Olivier Fabre Extract selected lines out of an Aminet INDEX based on date and/or type Template : IF=INDEXFILE,EF=EXTRACTFILE,FW=FIRSTWEEK/N,LW=LASTWEEK/N,NT=NOTYPE/S,T=TYPE/M INDEXFILE INDEX file name. Default : "INDEX". EXTRACTFILE Destination file name. Default : "AMINET_EXTRACTED". FIRSTWEEK/N Oldest week, numbered from 0 (current week) to x (x weeks old). Default : 52 LASTWEEK/N More recent week, numbered from 0 (current week) to x (x weeks old). Default : 0 NB : "current week" means "the week the INDEX file was created" of course... TYPE/M The type of files to extract, in the form "dir/subdir" or "dir". Default : all types. NOTYPE/S If set, the files of the given type will NOT be included in the list. Requires : RexxDOSSupport.library (Copyright (C) 1994-1997 by hartmut Goebel) (Aminet:util/rexx/rexxdossupport.lha) For additional information, please see the AREXX script. @endnode @node "yam2gofetch.rexx" "yam2gofetch.rexx" @{b}yam2gofetch.rexx@{ub} by Stephen Bridges Is a script to batch download files from Aminet Recent files. It was written to work from Yam using Aminet Recent e-mails but any Recent file will work. As Yam has it's own built in text clipping (to the clipboard) it is simplier to use from within Yam. Powersnap or the Snap facility within MCP is required to paste the clipped text into the requester. It is best to clip the text in, as the script relies on the spacing between the file name and the path to determine if the text is a valid path and file. The script then makes up a batchfile which is sent to the profile list in GoFetch!. Or the batchfile can be saved for later use with @{"Batch2GoFetch!.rexx" link "batch2gofetch.rexx"@}. @{b}Requirements@{ub} @{fg fill}PowerSnap@{fg text} Aminet.....util/cdity/PowerSnap22a.lha @{fg fill}rexxreqtools.library@{fg text} Aminet.....util/rexx/RexxReqTools.lha @{fg fill}reqtools.library@{fg text} Aminet.....util/libs/ReqToolsUser.lha @{b}Adjustment@{ub} Change the paths to suit your set-up. @{fg shine}gofetch_path = 'AmiTCP:GoFetch/GoFetch!'@{fg text} Line 21 @{fg shine}miami_path = 'AmiTCP:Miami/Miami'@{fg text} Line 22 @{fg shine}settings = 'Miami:Miami.default'@{fg text} Line 23 Enter the name of your nearest Aminet server aand the path to the site. @{fg shine}site = 'ftp.demon.co.uk'@{fg text} Line 25 @{fg shine}dir_address = '/pub/mirrors/aminet/'@{fg text} Line 26 Set the path to the where you want the batchfile saved. @{fg shine}batch_path = 'Yam:gofetch.batch'@{fg text} Line 28 @{b}Yam Setup@{ub} Just enter it as one of Yams Arexx scripts in the configuration, without "open window" and "wait for termination". @endnode @node "batch2gofetch.rexx" "batch2gofetch.rexx" @{b}batch2gofetch.rexx@{ub} by Stephen Bridges Is a script to batch download files from Aminet from a file built up by @{"Yam2GoFetch!.rexx" link "yam2gofetch.rexx"@}. @{b}Requirements@{ub} @{fg fill}rexxreqtools.library@{fg text} Aminet.....util/rexx/RexxReqTools.lha @{fg fill}reqtools.library@{fg text} Aminet.....util/libs/ReqToolsUser.lha @{b}Adjustments@{ub} Change the paths to suit your set-up. @{fg shine}gofetch_path = 'AmiTCP:GoFetch/GoFetch!'@{fg text} Line 22 @{fg shine}miami_path = 'AmiTCP:Miami/Miami'@{fg text} Line 23 @{fg shine}settings = 'Miami:Miami.default'@{fg text} Line 24 Enter the name of your nearest Aminet server. @{fg shine}site = 'ftp.demon.co.uk'@{fg text} Line 25 Set the path to the batchfile the same as you set it in @{"Yam2GoFetch!.rexx" link "yam2gofetch.rexx"@}. @{fg shine}batch_file = 'Yam:gofetch.batch'@{fg text} Line 27 @endnode @node "Products" "Products" @{u}Other Products @{uu} Other products from Zeus Developments include: Zeus BBS - Verison 1.2 An Amiga BBS package SlamMail A Fidonet Mailer & Tosser @endnode @node "prereg" "prereg" @{u}Registering@{uu} Payments may be made by cash or cheque in the following currencies. Please make cheques payable to Zeus Developments and send to the address shown below. Australia = @{b}$@{ub}24.00 Austria = @{b}Sch@{ub}120.00 Belgium = @{b}Fr@{ub}613.00 Canada = @{b}$@{ub}23.00 Denmark = @{b}Kr@{ub}113.00 France = @{b}Fr@{ub}100.00 Germany = @{b}DM@{ub}30.00 Greece = @{b}Dr@{ub}5010 Italy = @{b}Lir@{ub}30000.00 Japan = @{b}Y@{ub}1610.00 New Zeland = @{b}$@{ub}30.00 Norway = @{b}Kr@{ub}123.00 Poland = @{b}Z@{ub}60.00 Portugal = @{b}Esc@{ub}3045.00 Republic of Ireland = @{b}£@{ub}12.00 Spain = @{b}Pst@{ub}2527.00 Sweden = @{b}Kr@{ub}130.00 United Kingdom = @{b}£@{ub}8.00 United States = @{b}$@{ub}16.00 Zeus Developments 12 Burnbeck Place, Heighington, Newton Aycliffe Co Durham. DL5 6RW England, UK. @{b}Registration Form for Go Fetch!@{ub} I would like to register Go Fetch! at the registration price of £8ukp, (or equivalent price in my local currency). Name: __________________________________________________ Address:________________________________________________ ________________________________________________ ________________________________________________ ________________________________________________ Post/ZIP Code___________________________________________ Country_________________________________________________ Your E-Mail Address:____________________________________ (Your keyfile will be sent to this address) Signature_______________________________________________ (If handwritten) @endnode @node "Mailing List" "Mailing List" @{u}Mailing List@{uu} If you would like to subscribe to the Go Fetch! mailing list to discuss Go Fetch! with other users and the author, or to receive information on new updates, please follow these instructions:. NB This List Server is still under construction, it may not always behave itself. Mailing List Subscription Address: GoFetch@bleach.demon.co.uk Permitted Languages: English Commands should be sent in the @{b}SUBJECT@{ub} like of messages to the above address. Mail with commands in the subject will @{b}NOT@{ub} be sent to the rest of the list. Mailing List Commands: @{b}Subscribe@{ub} Adds the senders E-Mail address to the list. If you are already subscribed then Rhyme will ignore this command and pass the mail onto the rest of the list @{b}Remove@{ub} Removes the sender from the list. @{b}MUST@{ub} be the only word in the subject @{b}ListUsers@{ub} Replies with the list of people on the list @{b}Help@{ub} Sends the current Help File for the list. @{b}MUST@{ub} be the only word in the subject. @{u}Problems should be sent to dbny@bleach.demon.co.uk@{uu} @endnode @node faq "faq" @{b}FAQ@{ub} Q1. Go Fetch! says it can't open the preferences or profiles file, even though it exists in the right location, why? A1. You may be running a background disk compression utility such as DiskExpander or stacker. Some disk compression utilities to not allow files to be created in READWITE mode. Please install it on an uncompressed partition. Q2. Are you going to add an FTP browser type window? A2. Probably not, as this would be turning Go Fetch! into a conventional FTP client which is not my intention. Q3. How do I create an FTP profile from a complete URL? (e.g.ftp://www.whatever.com/pub/file.lha) A3. Use the supplied AREXX script called browser.rexx. See @{" Arexx Scripts " Link "Scripts" } Q4. I'm currently using Miami or Miami DX and sometimes I get the error message "Error associated with the bind command". Why? A4. The short answer is, I don't know at the moment, but I'm working on it. A quick fix is to quit your TCP/IP stack and restart it or waiting a minute or so before continuing with any profiles. Q5. Will Go Fetch! have locale support? A5. Yes Q6. I had a partially downloaded file, but Go Fetch! did not resume, why? A6. The server containing the file does NOT support file resuming. Q7. There's a file on a web site I want, but Go Fetch! says it isn't there, even though my web browser does, why? A7. Version 1.0 of Go Fetch! does not support HTTP re-direction. It will in the next release. Q8. I like Go Fetch! so much, can I give you a lifetimes supply of FREE beer? A8. Of Course! :) @endnode