---------------------------------------------------
FAR 
---------------------------------------------------
Copyright (c) 1996-1999 The Helpware Group
Web Site:  http://www.helpware.net/
Email:     support@helpware.net
---------------------------------------------------

FAR started off life as a multi-file "Find And Replace" program.  It now includes
a variety of multi-file and Html tools including quick and simple generation of
MS Html Help. 
                                 
We mainly use it to creating Html Help from large FrontPage webs. Also to do
global search and replace across multiple Html files in our FrontPage webs. I
hope you find FAR as useful as we have. 
  
---------------------------------------------------
                               
FAR Features 

Drop a web site onto far. FAR can filter out FrontPage special directories
and other unwanted files and folders. 
Quickly create Html Help - Compressed (CHM) or Uncompressed. 
Report and copy all files modified between two dates. 
Simple and complex Search and Replace across all list files. 
Zip up the files in the list to a PKZIP compatible zip file. 
Copy all files in the list to a new location. 

---------------------------------------------------

FAR Installation

Unzip FAR_inst.exe and run to install. 

---------------------------------------------------

FAR Status

Freeware by Robert Chandler, Helpware Group. Freely distributable.

---------------------------------------------------

FAR History

    V1.0.0 26-Sep-96 - Original
    <SNIP> ... see below
    V2.0.1 12-Feb-99
         o numerous tidy ups and bug fixes.
         o Moved from Freeware to Shareware. Download is the full working version.
         o FAR can now operate in batch mode
         o Add toolbar. Added menu Hotkeys.
         o New "Add files dialog" as an alternative to drag and drop.
    V2.0.2 26-Feb-99
         o Extended Batch mode so it can now execute other programs
           ie. FAR can run a number of FAR batches, .EXEs, .BATs all in sequence
         o Can now specify low ASCII chars like CR & LF & TAB in Find and Replace.
           To do this use the form $#13$, $#10$, $#9$ etc in find and replace strings.
           Warning when searching LF CR characters you may need to switch
           "Ignore CR & LF Chars" and "Ignore Multi Spaces" OFF.
         o Reassigned menu Hot Keys. DEL, Ctrl+Z, Ctrl+C menu hot keys were stopping
           edit fields from working correctly - Fixed.
         o Search and replace special strings $F$ and $#nnn$, now work any time
           (not only when Advanced mode is actived in the Advanced Find and Replace dialog)
         o Changed Find Quiz dialog - Can now display CR LF TAB chars as well as other
           unseen "Low Ascii Characters".
           - Now displays full path of current file.
           - Now has syntax highliting for HTML files.
         o Make other Search settings available to Batch mode operation
            DosUnix=, IgnoreMultiSpace=, IgnoreCRLF=
         o Reorganize online help - Both uncompressed and compressed help available
         o Added "Options | Preferences" dialog - Set preferred text editor.
    V2.0.3 26-Feb-99
         o Open a HHP file - Open Dialog now starts in base dir if drop files present.
         o Find/Replace prompt dialog - Current filename was not being updated.
    V2.0.4 11-Mar-99
         o New - Add dialog to setup media path for Real Video or Real Audio files
           so you can use your own file uploader.
         o Add Registration dialog. Easier than sending our a registration file.
           Some mail servers were truncating the file to 8/3 format.
         o Impoved add files dialog. Added Autoselect button to select Web files
           and folders for you. Also dialog will remember the last folder better.
         o Preferences dialog now allows you to create program shortcuts.
           Also called during installation.
         o Fix - problem with advance Find and Replace - $A$, $B$, $C$ replacements
           were broken because of code rework in 2.0.2. Now works OK.
         o Fix - After a HHC.EXE compile FAR would sometimes show the old log file
           again because the new one had not been flushed to disk.
    V2.0.5 09-Apr-99
         o Fix - Param $A$, $B$, $C$ sometimes being caught in a loop because
           string pointer not moved on enough OR a replacement string of nil found.
         o $A$, $B$, $C$ strings were being modified - now OK.
         o Advanced Find and Replace was saving field string and losing trailing and
           leading space chars. - Fixed.
         o When converting a string containing 2_SPACES to 1_SPACE it was missing some
           occurrences. This happens in Ignore mult-space find and replace - Fixed.
         o Hit compile button - now get warning if CHM is open / in use.
         o Fix TOC and merge files - can now include merged files into TOC file
           correctly unlike Workshop which displays include items one step to the
           left so that merged items can not be placed in TOC level.
         o Export File List - Now makes sure it opens the output file as in the
           text viewer no matter what the extension.
         o FAR could not be used with HH installed - would report HHCTRL.OCX not found. Fixed.
         o Fixed bug where sometimes the Command line compiles would not work.
           If the name was already a shortname it would not work.
    V2.1.1 20-Mar-99
         o "File > Export File List" - now programable.
           Create simple text report of filenames OR Complex batch files.
           XTGOLD - Batch command. Alt+B - take all tagged items.
           Add access from toolbar.
         o FAR was checking for server write access via writing a temp file
           in the root folder. - Now checks base folder.
         o Graphical editor - Saves/Loads TOC and HHC files. Workshop replacement.
           Drag and drop entire sections. Works with merged files correctly.
         o Various Optimizations - processes very large numbers of files even quicker.
         o FAR takes HHP, HHK, HHC Files as command line params
         o Add Help > Check Web for Update
         o Check box to stop FAR checking for new versions of itself on the web
    V2.1.2/3
         o Remove the Hide to Tray. from File menu.
         o Add explorer shell menus. Right click .HHP and .HHC and select "Open with FAR".
           Also default launch program for Far .TOC far is now FAR.
         o Add File System Tab to Toc Editor
         o Added single instance support via ddeeec for the shell.
           ie. Open .hhp, .hhc, .toc files will not open a second instance of FAR.
         o Drop file onto TOC editor
    V2.1.4 26/May/1999
         o TOC Editor - When making changes in text mode FAR will prompt you to reload
           if you change the file while out side FAR.
         o Ignore all DDE Callbacks except the Connect and Execute calls.
         o No longer have to deal with FAR .TOC files
           -- Create HHC command - No creates .toc file in the background then creates
              the .hhc file.
           -- Users who have master TOC files in .toc format can load the toc in
              FAR TOC editor and save as .hhc if necessary.
         o FAR now supports all .hhc file options. When moving between .hhc and .toc
           formats no information is lost.
         o If a invalid files are found in the [FILES] list of the HHP then
           offer to delete them.
         o Move icon search and replace from the Create HH Window to the Edit TOC window.

    ---------------------------------------------------------------------------------

Enjoy :-)~
  The Helpware Group


Tips & Tricks:
1. HtmlHelp Filenames:
      Don't use filenames, dirnames and bookmarks containing spaces other special chars.
      MS Frontpage and HtmlHelp like to do the following translation at the most 
      inappropriate moments.
      o changes '&' chars to "&amp;"  (frontpage)
      o changes spaces to %20         (hhc table of contents)
      - Even inside a link!!
      eg. The file "Safety&haz.htm" was converted to Safety&amp;haz.htm
          and all the links to that document broke!
      eg. The hhc link "My_file.htm#second item" was used as "My_file.htm#second%20item"
      Its a bit haphazard. Bookmarks are normally no problem with HH 1.2
      but if a link fails, then the first thing you should try is replace the spaces
      with underscores.
2. Given the above restrictions for Frontpage users. Make sure you check the
   "Strip Underscores from TOC labels" option when generating a TOC.
3. When generating a TOC file using FAR...
   If you want a TOC folder to pick up a file link automatically then
   make a web file in the web folder the same name as the folder.
   eg. folder "Special" contains and will link to a file "Special\Special.htm"
   Also... The file "SpecialHome.htm" would also work. (ie. html filenames ending in "Home")
4. Always use Language = 0x409 English (United States);
   //anything else in HH1.1 and FTS does not work
5. If the path to the CHM contains % or # chars then the CHM will not display correctly.
6. Frontpage files with stupid names like "file.htm_image.gif" will crash HHW 1.1 (1.2?).
7. Using a HHW STP list crashes some CHMs when you click on the Index tab (HH 1.2)
8. CHM Multi-page print ignores any CSS you may be using (HH1.1, 1.2).
9. HHW 1.2 Bug. How to make a window remember its screen position.
   TP1=,"Help.hhc",,"Index.htm",,,,,,0x63520,222,0x305e,[0,0,800,600],0xb0000,,
   TP2=,"Help.hhc",,"Index.htm",,,,,,0x23520,222,0x305e,[0,0,800,600],0xb0000,,
   TP1 will remember, TP2 wont. ie. Set the 0x40000 bit to remember.
   I'm sure future version of HH Workshop will fix this.
10. Visit http://www.helpmaster.com maintained by Josef Becker

    ---------------------------------------------------------------------------------

Full version info.


    V1.0.0  26-Sep-96 - Original
    V1.0.1  31-Oct-98 - Clean up code, add ZIP and Copy List support
    V1.0.2  13-Nov-98 - Now supports HH 1.2
    V1.0.3  20-Nov-98
       - TOC generation was only looking into the first 12 lines to extract the html 
         <title> tag. Now looks into first 30 lines.
       - TOC generation fixed. Root folders containing no html files were sometimes ignored.
    V1.0.4  04-Dec-98
       - Advanced Find - $A,$B,$C sub strings now found using Ignore Multi-Space, 
         Ignore CR LF options.
       - Strip Html Tags Dialog - List now fills and checkbox states now work correctly.
       - Added menu item to HHCreate window "Create TOC from HHC" for those who want to 
         convert an existing project.
       - Advance Search sub params $A,$B,$C,$F - now $A$,$B$ as '$A$' is less common string.
       - Advanced Search was always adding a CRLF to the end of the Replace Text - Fixed.
    V1.0.5  04-Jan-99
       - Create HH Window
         o On window open - If no files in FAR file list, show the import HHP files dialog
         o Burry our inhouse "Special Page" to the File menu under "Additional Tools".
         o Fix for HH1.2 bug - Add "Remember Window position" checkbox
           Fixes a bug in HHW 1.2 where you can not tell a HH window to remember is postion.
    V1.0.6  21-Jan-99
         o Now does HH command line compile. With HH 1.2 this appears to be more stable than
           compiles executed from HH Workshop.
         o General clean up of the "Create Html Help" window.
    V1.0.7  3-Feb-99
         o Update Html Help window. Add Shipping List for uncompressed sites.
         o Hit Esc key to abort Find and Replace loops
         o HH Window now creates a basic Java Sites
         o Rearrange main menu slightly



