home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 1998 August / apc381.iso / workshop / os2 / ftpbrows / readme.txt < prev   
Encoding:
Text File  |  1997-07-23  |  22.6 KB  |  489 lines
  1. FTP Browser readme
  2. ==================
  3.  
  4.  
  5.    This file contains the following sections:
  6.  
  7.     What is FTP Browser?
  8.     System requirements
  9.     Feature list
  10.     Features that may not be obvious
  11.     Solutions to common problems
  12.     Changes for this release
  13.     Legal disclaimer
  14.     Availability and support
  15.     Installation procedure
  16.     Changes in previous releases
  17.  
  18. =====================================================================
  19. What is FTP Browser?
  20. =====================================================================
  21.  
  22. FTP Browser is a powerful and intuitive FTP solution for OS/2
  23. Warp that features drag and drop, server to server and directory
  24. tree transfers accross a variety of hosts.
  25.  
  26. Please, feel free to use this shareware version of FTP Browser to
  27. evaluate its functionality as long as you agree to the legal
  28. disclaimer. Should you continue to use this product beyond the
  29. 30-day trial period, please select "Registration information" from
  30. the site manager's help menu.
  31.  
  32. Registration for FTP Browser is only $29.00 in US funds.
  33.  
  34. Thank you for your interest in FTP Browser.
  35.  
  36. =====================================================================
  37. System requirements
  38. =====================================================================
  39.  
  40. Your system must meet the following minimal requirements in order to
  41. install and use FTP Browser: 
  42.  
  43.      OS/2 Warp version 3 or 4
  44.  
  45.           Presentation Manager
  46.           TCP/IP
  47.  
  48.      2 Mb free disk space
  49.  
  50. =====================================================================
  51. Feature list
  52. =====================================================================
  53.  
  54. The following features will surely enhance your FTP experience:
  55.  
  56.      FTP site manager that stores sites in folders
  57.      References to site objects on the desktop
  58.      Drag and drop enabled for transfers, queueing, site
  59.       manipulation and more
  60.      Local file manager
  61.      Quick connect feature to test new sites
  62.      Ping feature to test site responsiveness before connecting
  63.      Unlimited number of simultaneous connections to the same site
  64.      Multiple and simultaneous transfers to the same site
  65.      Graphical file transfer display
  66.      Host redialing for busy sites
  67.      Seamless reconnects for lost connections
  68.      Automatically resume interrupted transfers
  69.      Resume partially transferred files
  70.      Transfer queue for storing items to transfer
  71.      Recursive directory tree transfers and deletes
  72.      Server to server tree and file transfers
  73.      Tree synchronize feature for maintaining identical trees on
  74.       local and remote systems
  75.      Recursive directory tree search feature for finding files
  76.      Archive content and text file viewer
  77.      Configurable file associations for viewing downloaded files
  78.      Classical and transparent proxy firewall support
  79.      Firewall support for travelling (laptop) users
  80.      Configurable directory lisiting cache
  81.      "Quick paths" allow access to frequently accessed directories
  82.      Parent directory button to quickly move up one directory
  83.      Communications log with save to file option
  84.      Hooks for command file execution after file transfers
  85.      Download information optionally written to file EAs
  86.      File list filter
  87.      Hover help for all toolbars
  88.      Warp 4's tabbed notebook style
  89.      Drag and drop color and font configurability
  90.  
  91. =====================================================================
  92. Features that may not be obvious
  93. =====================================================================
  94.  
  95. - To move a site to a new folder, drag and drop the site over
  96.   the target folder. To copy a site hold down the control key
  97.   while dropping the site over the target folder.
  98. - To create a reference to a site on the desktop, drag and
  99.   drop the site in any desktop folder. Double clicking the
  100.   new site reference object will open the FTP window for that
  101.   site, bypassing the site manager.
  102. - To connect to a site double click the site name. To connect
  103.   to every site within a folder, double click the folder name.
  104. - To be prompted for a site address or password, simply
  105.   leave these fields empty in the properties notebook.
  106. - To start FTP Browser from another application and
  107.   automatically connect to a FTP site refer to the "command line
  108.   arguments" section of the FTP Browser manual.
  109. - To transfer files and directories, simply drag objects from
  110.   or into the FTP window.
  111. - To view a file using the defined associations, double click
  112.   the file name in the FTP window. If the file's extension
  113.   matches that of a defined association it will be viewed using
  114.   the defined external application. For example, double clicking
  115.   on a ZIP file will display the contents of the archive. Any
  116.   file for which there is no association is assumed to be a text
  117.   file and will be displayed in the built-in text viewer window.
  118.   Associations can be defined in the configure options notebook.
  119. - To resume an interrupted file transfer, simply start the
  120.   transfer again and select append from the file transfer
  121.   prompt.
  122. - To transfer files and directories from one site to another,
  123.   simply drag objects from one FTP window to the other.
  124. - To recursively delete directories on a site, make your
  125.   selection then select delete.
  126. - To synchronize directory trees between your system and a
  127.   remote system, both the local and remote directory fields
  128.   must changed to the directories that are to be synchronized.
  129. - To filter the file list add the filter string to the end of
  130.   the remote directory. For example, the following remote
  131.   directory would only list ZIP files: /os2/incoming/*.zip
  132.   To remove the filter refresh the directory.
  133. - To change the font and color of a window, simply drag and
  134.   drop them to the window. All changes will be saved.
  135. - if you would like to move FTP Browser to another location use
  136.   the move function in the install program. Refer to the install
  137.   help for more information.
  138.  
  139. =====================================================================
  140. Solutions to common problems
  141. =====================================================================
  142.  
  143. - if there is a problem getting a list of files from a Windows 
  144.   for Workgroups/95/NT FTP server, try changing the site type
  145.   in the site's properties notebook to DOS.
  146. - if there is a problem connecting to sites on the internet through
  147.   a firewall/proxy server, make sure that the "located behind
  148.   firewall" check box is not checked. It should only be checked
  149.   for sites within (local to) your LAN.
  150. - if a site does not allow fully qualified path names when changing
  151.   or listing a directory, the file list will be empty even though
  152.   there are files. If this is the case then disable "fully qualify
  153.   directory changes and listings" on the preferences page of the
  154.   site's properties notebook.
  155. - if you are having problems connecting through a firewall or
  156.   connecting to a specific site, view the communications window
  157.   and select save. Send this text file along with a description of
  158.   the problem in an e-mail message to the address listed under
  159.   support.
  160. - if FTP Browser is slow accessing data files or creating a lot
  161.   of disk activity, try using the install program to clean your
  162.   data files. Refer to the install help for more information.
  163. - when closing the FTP window, it is normal if it takes up to 5
  164.   seconds to shut down.
  165.  
  166. =====================================================================
  167. Changes for this release
  168. =====================================================================
  169.  
  170. 1. The active data connection setting not functioning properly.
  171.  
  172. 2. The notebook that should occupy the bottom half of the FTP
  173. window is not visible on Warp3 systems.
  174.  
  175. 2. When opening a site from a desktop reference object, the site's
  176. directory list would never appear and cause an endless loop that would
  177. constantly read from your hard drive.
  178.  
  179. 3. The "No auxiliary connection" message would consistently appear on
  180. any OS/2 system without multimedia installed when the user attempted to
  181. download/upload. The process that is responsible for transfers requires
  182. an OS/2 multimedia file called "mdm.dll". As a temporary work around I
  183. have disabled the multimedia sound support that optionally plays after
  184. transfers.
  185.  
  186. =====================================================================
  187. Legal disclaimer
  188. =====================================================================
  189.  
  190. FTP Browser is provided "as-is" without any warranties (or
  191. conditions), expressed or implied with respect to the software,
  192. including the implied warranties (or conditions) of merchantability
  193. and fitness for a particular purpose.  The entire risk arising out
  194. of use or performance of the program remains with you.  In no event,
  195. will Jason Rushton be liable for any lost profits, lost savings,
  196. incidental or indirect damages or other economic consequential 
  197. damages, even if Jason Rushton has been advised of the possibility
  198. of such damages.  In addition, Jason Rushton will not be liable for
  199. any damages claimed on you based on any third party claim. 
  200.  
  201. FTP Browser, Copyright (c) 1996 Jason Rushton 
  202.  
  203. =====================================================================
  204. Availability and support
  205. =====================================================================
  206.  
  207. If you have questions, suggestions or bug reports, use any of the
  208. following contact methods.  Registered users will receive first
  209. priority, although I will surely make an effort to respond to 
  210. unregistered users as well. 
  211.  
  212.    Internet mail 
  213.       rushton@netcom.ca 
  214.        
  215.    Regular mail 
  216.       Jason Rushton 
  217.       81 Calais Street 
  218.       Whitby, Ontario 
  219.       Canada, L1N 5M3 
  220.   
  221. The latest version of FTP Browser will always be available for
  222. download from the following internet FTP archives, WWW pages and
  223. internet BBSs:
  224.  
  225.    ftp.cdrom.com     /.4/os2/internet
  226.    hobbes.nmsu.edu   /os2/internet
  227.    ftp.bmtmicro.com  /bmtmicro
  228.    http://www.bmtmicro.com/catalog/0internet.html
  229.    ftp.leo.org       /pub/comp/os/os2/tcpip/ftp
  230.    os2.musthave.com  /OS2
  231.    http://www.os2ss.com/internet/ftp/
  232.    bbs.os2bbs.com    Area #35
  233.  
  234. =====================================================================
  235. Installation
  236. =====================================================================
  237.  
  238. To install FTP Browser:
  239.  
  240. 1. Unzip the compressed file into a temporary directory.
  241. 2. Make this directory the current directory.
  242. 3. Run INSTALL.EXE to install the application.
  243.  
  244. =====================================================================
  245. Changes in previous releases
  246. =====================================================================
  247.  
  248. v1.7
  249.  
  250. - added a clean button that will clean out FTP Browser's
  251.   data files. This is recommended for users who have upgraded
  252.   from a previous release. This feature removes all unused
  253.   data and reorganizes the data files for efficiency when
  254.   FTP Browser accesses them.
  255. - added a move button that will relocate an FTP Browser
  256.   installation to another path.
  257. - fixed some minor bugs.
  258. - changed the FTP Browser logo (again).
  259. - added the ability to have one level of child folders.
  260. - added a quick connect feature to connect to sites not
  261.   frequently visited.
  262. - to create a site entry in the site manager for a site
  263.   that you have connected to using the quick connect, select
  264.   "save site properties". You will be prompted for the name
  265.   of the new site.
  266. - added a feature that writes the properties of all sites
  267.   to a text file.
  268.  
  269. - added an auxiliary connection setting to the site properties
  270.   notebook.
  271. - added an auxiliary connection setting to the set default
  272.   window.
  273. - added a setting to the site properties notebook that hides
  274.   the local file list and directory.
  275. - added a setting to the site properties notebook that
  276.   will enables the conversion of all uploaded file names
  277.   to lowercase characters.
  278. - moved the enable active data connections setting to the
  279.   site properties notebook so that it can be configured
  280.   independently of each site.
  281.  
  282. - added a setting to the options notebook that specifies
  283.   whether the queue, log or quick path pages should be the
  284.   first in the new FTP window notebook.
  285. - added a network thread priority setting to the options
  286.   notebook so that very fast transfers will not dominate
  287.   your CPU. This setting resides on the network page.
  288. - added a setting for enabling/disabling the system beep
  289.   at the end of transfers. In addition there is now a field
  290.   for specifying a sound file to play at the end of transfers.
  291. - users are now prompted before connecting to all sites in
  292.   a folder in case it was not intended.
  293. - added the ability to drag and drop sites to the desktop to
  294.   create site reference objects.
  295. - added a status area to the bottom of the site manager window,
  296.   which displays the status of the site manager, the number
  297.   of open FTP windows and the number of transfers running.
  298. - added spacers between unrelated toolbar buttons.
  299. - the delete key can now be used to delete folders and sites
  300.   provided the respective container has the focus. You will be
  301.   prompted to confirm to the deletion.
  302. - refreshed the menu layout and key accelerators.
  303. - fixed a bug in the context menu interface.
  304. - improved the layout of the data files holding many of FTP
  305.   Browser's settings. FTP Browser should now operate more quickly
  306.   when reading from these files, at the expense of resetting
  307.   some options to their default values.
  308. - changed all threads to an idle priority.
  309. - reduced fragmentation when dynamically allocating memory.
  310. - updated help system.
  311. - changed the FTP Browser logo (again).
  312. - enhanced the command line arguments for FTPBROWS.EXE. Refer
  313.   to the new command line argument section of the help.
  314. - added context menus all over the place.
  315. - added a local file list which functions in the same way as
  316.   the site list. It is drag and drop enabled and multi-threaded.
  317. - moved the previous dir and open folder toolbar buttons
  318.   back beside the their respective dir entry fields.
  319. - added a notebook to the bottom of the window that conatins
  320.   pages for the queue, log and quick path windows.
  321. - added to splitbars, one between the site and new local file
  322.   listings, and one between the status area and the new
  323.   notebook.
  324. - added a toolbar button that incremently adjusts the vertical
  325.   splitbar betweem the site and local listings.
  326. - added a feature that prompts for a file name of a zero
  327.   length file that will be created on the site. This is useful
  328.   for sending messages as files to the site administrator.
  329. - added a feature that opens the properties notebook in the
  330.   manager for the connected site. This saves the user from
  331.   having to search for the site in the site manager, although
  332.   the folder that contains the site must be open in the site
  333.   manager.
  334. - the last sort performed on the site list and local list
  335.   is now remembered the next time the FTP window is opened.
  336.   If no sort is performed or default is selected from the
  337.   sort menu, the default sort attribute is used.
  338. - added an auxiliary connection status area that displays
  339.   information about transfers and deleted files only.
  340. - replaced the local directory field with a drop down list
  341.   that contains all the local drives on the system.
  342. - added new "download as" and "upload as" features that
  343.   prompt the user for the target file name of each file
  344.   to be transferred.
  345. - added an "apply action to all existing files" setting
  346.   to the transfer prompt that appears when transferring
  347.   a file that already exists on the target system.
  348. - during queue transfers the user is now prompted when the
  349.   file exists.
  350. - added a local file name prompt when the file name contains
  351.   illegal characters.
  352. - added an option to the synchronize feature which allows
  353.   files to be included if they are older than a specified date.
  354. - added a file search feature which will recursively search
  355.   site directory trees for a file name. This file name can
  356.   include a "*" as a wild card and the search can be limited to
  357.   include only files that are newer than a specified date.
  358. - added a file rename feature.
  359. - added a site command feature which allows the user to manually
  360.   send commands to the site.
  361. - added a connect/disconnect feature so that the FTP window can
  362.   remain open while the connection is closed.
  363. - added the ability to save the queue to a file when closing the
  364.   site and load the queue when opening the site.
  365. - the site list now contains a field that displays the site file
  366.   permissions if available.
  367. - added the ability to save the all files to be transferred to a
  368.   file list when the transfer fails and load this list into the
  369.   queue when opening the site.
  370. - added the ability to start multiple, simultaneous transfers
  371.   from one FTP window through auxiliary connections.
  372. - it is now possible to change directories, change the transfer
  373.   mode, send site commands, rename files and create directories
  374.   while any number of file transfers are in progress.
  375. - each auxiliary connection has its own transfer status window,
  376.   text viewer, synchronize list and search facility.
  377. - auxiliary connections are also used to delete site files
  378.   and perform server to server transfers. This means that it is
  379.   now possible to perform multiple, server to server transfers
  380.   simultaneously using the same FTP window.
  381. - it is now possible to close the FTP window without affecting
  382.   any number of file transfers, site file deletes or server to
  383.   server transfers.
  384. - when aborting transfers the auxiliary connection will quickly
  385.   disconnect and then reconnect to fix many of the previous
  386.   problems with many sites not properly reacting to an abort.
  387. - added a reconnect button to the transfer window, which will
  388.   quickly disconnect, reconnect and then resume the transfer.
  389.   This can be useful if you feel the site has forgotten about
  390.   your transfer or your ISP has hung up on you.
  391. - enhanced command line argument support to accept a username,
  392.   password, port#, account name and site type.
  393. - added a toolbar button that cycles through a splitbar
  394.   position of 50%, 75% and 25%.
  395. - added spacers between unrelated toolbar buttons.
  396. - the delete key can now be used to delete site and local
  397.   files, queue items, quick paths, synchronize list items and
  398.   search items provided the respective container has the focus.
  399. - refreshed the menu layout, key accelerators and toolbar.
  400. - fixed a bug in the context menu interface.
  401. - fixed a bug in with the storing of quick paths that caused
  402.   them to be truncated to a certain length.
  403. - fixed minor bugs in the synchronize feature.
  404. - changed all threads to an run at the priority set in the
  405.   site manager's options notebook.
  406. - updated help system.
  407. - reduced fragmentation when dynamically allocating memory.
  408.  
  409. v1.6
  410. - added a menu item to the site manager window for creating a
  411.   desktop icon that references a site. Click this icon to directly
  412.   connect to the site.
  413. - added menu items to the site manager window for cascading, tiling
  414.   or closing all open FTP windows. Cascade and tile use the size of
  415.   the top-left-most window for determining the size of the others.
  416. - changing certain options and site properties are now reflected
  417.   immediately if the there are open FTP windows.
  418. - updated all toolbar buttons with a consistant graphic scheme.
  419. - replaced some infrequently used toolbar buttons with more
  420.   frequently used ones.
  421. - added a setting to the site properties notebook for turning off
  422.   fully qualified directory names, because some sites do not like the
  423.   LIST command fully qualified.
  424.   NOTE: turning off fully qualified pathnames prevents recursive
  425.         directory tree transfers etc.
  426. - added a setting in the site properties notebook for converting
  427.   uploaded file names to FAT (8.3) format.
  428. - fixed the deletion of sites from the site manager window which
  429.   was causing a memory leak.
  430. - fixed the site manager splitbar, so that the sizing pointer
  431.   (left-right arrow) is displayed while moving the splitbar.
  432. - enhanced transfer status window updates, which are now performed
  433.   in a seperate thread. It was found that updating the status
  434.   from within the transfer thread degraded transfer performance
  435.   by as much as 50% with extremely fast transfers (30kbs+).
  436. - added a list of files to transfer to the transfer status window.
  437. - added an elapsed transfer time field to the transfer status win.
  438. - multiple FTP windows are now cascaded instead of opening on top
  439.   of each other.
  440. - changed the following FTP window dialogues to windows for improved
  441.   functionality:
  442.       Connect status, Transfer status, Transfer queue, Quick path
  443.       Communications log, Synchronize
  444. - added help to many of the remaining (modal) dialogues.
  445. - added a select all function to the FTP window directory menu.
  446. - enhanced file transfer code which now allows a user selectable
  447.   action when a file exist condition occurs during a recursive
  448.   tree transfer.
  449. - enhanced the file transfer prompt with a manually rename file
  450.   option and changed the old rename option button to "unique".
  451. - added column titles to the FTP window file list, transfer queue,
  452.   and synchronize list.
  453. - enabled the remote directory field to accept filter strings.
  454. - synchronize feature now compares file names without case
  455.   sensitivity and also compares file sizes in determining
  456.   which files to synchronize.
  457. - fixed a bug during file transfers of > 40MB which caused the
  458.   percent and progress indicators to reset to 0.
  459. - improved server to server transfer code, now more robust in
  460.   dealing with transfer failures.
  461. - FTP window now displays on top after a successful connection.
  462.  
  463. v1.55
  464. - added a directory tree synchronize feature, which lists and
  465.   recursively transfes missing files between your a system and a
  466.   remote site
  467. - enhanced the informational messages displayed in the status area
  468.   and the connect window
  469. - added a "how do I ..." section the help system
  470. - added a similar "Features that may not be obvious" section to this
  471.   readme file.
  472. - added an switch that can toggle between active and passive data
  473.   connections
  474. - added the ability to start an FTP session from the command line
  475.   (or your another application) by specifying an ftp site address
  476.   eg. ftpbrows ftp.cdrom.com
  477. - added an option to not display the local and remote dir fields in
  478.   the FTP window
  479.  
  480. - fixed a bug which confused FTP Browser when informational messages
  481.   posted by some sites contained an extra new line character.
  482.   A dash as the first character of the password is no longer needed
  483.   for Hobbes. (Directory -> Synchronize)
  484. - fixed a bug in the passive data connection code
  485. - fixed a small GUI flaw in the status area
  486. - fixed the display of binary/ascii transfer mode
  487. - many GUI and network code optimizations
  488. - reduction in memory requirements and increased performance
  489.