
 Help for !TextBasic:

 (1)  IconBar-icon: 
 
       <Select> opens the Main window.

       <Menu>   opens the iconbar-menu, containing the usual
                self-explanatory items 'Info', 'Help' and 'Quit'.

                    
 (2)  Main Window:

   a)'TEXT Output':
        
       When 'TEXT Output' is ticked the following options are available:-

       a) Line Numbers -  a listing with line numbers ,or not.

       b) Indented     -  a listing with indented structures, or not.

       c) Split lines  -  split multi-statement lines, or not. 
       
       Dragging a Basic file to the iconbar-icon (or window) will generate
       a TEXT (&FFF) file image of the Basic file.

   N.B ONLY a 'BASIC' (&FFB) file will be accepted as input for 'TEXT output'.

    
   b) 'BASIC Output':

       When 'BASIC Output' is ticked the following options are available:-

       a) 'SWI names/nos' - forces output either as SWI names or SWI numbers.
           When ticked SWI names will be output - otherwise SWI numbers.
           Having this ticked will make the program more readable but slower.
  
       b) 'Indented' - gives a listing with indented structures.

       c) 'Split lines' - will decompress (split lines) a compacted BASIC file.

       Dragging a text file (which is an image of a Basic file) to the iconbar-
       icon (or window) will regenerate the BASIC image (filetype &FFB) of that
       text file.

       Note: if the dragged text file is NOT a Basic-file image, then the
       resulting output will not, unsurprisingly, be a sensible 'BASIC' file.
 
       This option will also accept Basic (&FFB) files as input.
  


   A 'Savebox' will then open, so the user can save the 'new' file.

   The output files should be drag-dropped to a place of your choice.
   Their default names can be changed by the user.

_________________________________________________________________________________


     BEWARE! - 'UnPacked' files may not RUN properly - 

     2 common causes are :

     a) multi-statement "IF..." lines have been incorrectly split
        - the original "IF..." lines should be restored.

     b) ON ERROR lines may be split - these should also be restored.


     HINT:

         Load 'Unpacked' files into 'Edit'.  Use 'Find' within 'Edit'

         and do                Find:    DEF
                            Replace:    :$:$DEF

         and then 'End of file replace'. This will put two newline-feeds
         (each preceded by a ':') before each DEFPROC ... or DEFFN ... 
         (ensure that both 'Wildcarded expressions' and 'Case sensitive'
         are chosen i.e ON ). Then re-save the edited file. The result
         should be a bit more readable.

________________________________________________________________________________

 Note on LISTO n:

                 1              2              4              8
            Space after       Indent       Split-line       NO line
            line number     structures     at each ':'      numbers
 LISTO 1         x
 LISTO 3         x              x
 LISTO 12                                      x              x
 LISTO 14                       x              x              x

   Both LISTO 1 and LISTO 3 listings will have line-numbers.

   LISTO 14 format has indented structures and split-lines, but NOT
   line-numbers. This is useful for looking at 'compacted' programs.
   (LISTO 12 is similar but does not provide indented structures.)
   Any end-of-line ':' are all automatically removed.

________________________________________________________________________________

Copyright: R.A.Swetman
