
   !Help for !Format+

   This program has two independent parts -

   1) a text-formatting part. The appropriate window will open when you
      first run the program or click <Select> on the Icon-Bar icon.

   2) a text-utilities part.  The appropriate window will open when you
      click <Adjust> on the Icon-Bar icon.

   Further details appear below.

   After  making  your choices in either window you can then start  the
   processing by just dragging your text file to that window.

   When the program has finished a 'Save Box' will appear. An extra '+'
   is  automatically added to the end of the original filename, but you
   can alter this and choose whatever name you wish before dragging the
   textfile icon to your chosen destination. 

   Clicking <Menu> on the iconbar icon displays a standard menu, except
   that  the  use of a 'SaveBox' can be toggled On/Off. If this is  Off
   (unticked)  then no SaveBox window will appear and the original text
   file will be overwritten. (Default = On)

   ====================================================================


   1) Text-formatting.

   Given  a  textfile  which  is  already  formatted  it  is  sometimes
   desirable  to re-format it to a different width. However doing  this
   directly  can often mess things up. A solution to this problem is to
   unformat  the textfile first and then to re-format it to the desired
   line width.
   !Format+  tries  to accomplish this using a global process  (i.e  it
   acts  on  the  whole textfile at once), which is a  bit  crude,  but
   nevertheless  the  results can often be quite satisfactory  in  most
   cases.  !Format+ will do a global 'unformat' automatically (which is
   invisible to the user) before doing the actual formatting.

   (Note  that  using  <Ctrl>+F6 in !Edit is not a global  process  and
   therefore  gives you more control over which particular sections  of
   the  file you wish to Unformat/Format.  To unformat within !Edit you
   should  first use a  format width  of  99999999, and then  re-format
   using the format width of your choice.) 


   Clicking <Select> on the iconbar icon displays a window where -

   a) Format line width
     - the format line width (in characters) can be set.

   b) Preserve line width
     - the  minimum  line width (in characters) can be set-  i.e  lines
   equal  to or shorter than this width will be preserved and only  the
   longer  lines  will  be  processed. This is  useful  for  preserving
   titles, headings etc, which may look odd otherwise.

   c) Justify
     - You can also choose between 'Left' or 'Full' justification.

   d) Strip all leading spaces
     - Some text files have leading spaces on each line which  prevents
   any  formatting  taking  place  (<Ctrl>+F6 in !Edit  does  not  work
   either!).   Ticking  the 'Strip leading spaces ?'  option  overcomes
   this problem. Note however that this is also a global action, and is
   done  automatically before the actual unformatting/formatting  takes
   place.
      
   e) Strip multiple spaces
     - This  program  uses extra spaces between words when  doing  full
   justification.  If  subsequently  you wish to  reformat  the  fully-
   justified  text  back to left-justified text then you  should  strip
   these extra internal spaces back to just a single space. This option
   provides  exactly that facility i.e it reduces all internal multiple
   spaces to just a single space.


   2) Text-utilities.

   Clicking  <Adjust>  on the iconbar icon displays a window with  just
   four options. These are self explanatory.

   a) 'Strip all leading spaces'.

   b) 'Create a margin of n spaces' - with n to be set by the user.
      (n can take values only between 1 and 40 inclusive - default=5) 
   
   c) 'Cut all CR (Carriage Returns)'
       Some text files display (in !Edit) unnecessary CR codes (=[0d]).

   d) 'Cut all TAB (=[09]) characters' from the text.
       You can always expand them within !Edit if you wish to keep them.

   Note: these simple utilities do NOT do any formatting.


   The defaults are as follows :

   Menu:   SaveBox = On

   Text-formatting:
   Format line width = 80,
   Preserve lines <= 60,
   Justification = 'Left'
   Strip leading spaces = Off
   Strip multiple spaces = Off

   Text-utilities:  
   Strip leading spaces = On
   Create a Margin = Off  (default=5)
   Cut all CR (Carriage Returns) = Off
   Cut all TAB characters = Off

   Copyright -  R.A.Swetman.

