
 Help for !Unpack.
 -----------------

 Why? - to unpack a compacted Basic file and make it more readable.

 How? - just drag your Basic file onto the iconbar icon and then drag
        the unpacked file to a filer window of your choice.

 Iconbar Menu:-

        Clicking with Mouse Adjust on the first eight items will make
       alternative/opposite choices available to the user, as follows :

 1)    "Unpack" means all the multi-statement lines will be split,
    or "Keep packed" means the lines will not be split up.

 2)    "SWI Names"    means SWI numbers will be converted to SWI names,
    or "SWI Numbers"  means SWI names will be converted to SWI numbers.

 3)    "Indented" means that structures in the listing will be indented, 
    or "Not Indented" means that structures will not be indented.

 4)    "Gaps at DEFs" means that DEFPROCs etc have extra gaps inserted,
    or "No-gap DEFs" means that no extra gaps will be inserted between.

         i.e the various DEFPROCs and DEFFNs will have extra empty
         lines inserted between them. The default number of gap lines
         is 2, but this can be changed by giving the system variable
         'gaps' your own value (1,2 or 3). This can be found within
         the !Run file of !UnPack.

        Note: to remove all 'gaps' run !Unpack with just 'Strip Empty'
              and 'Strip Blanks' ticked.

 5)    "Strip Empty" means that empty statements will be stripped out.
    or "Keep Empty" means that empty statements will be retained.


                      __________________________

 
 6)    "Strip REMs" will strip all REM statements (except the first).
    or "Keep REMs" will keep all the REM statements intact.

 7)    "Strip Blanks" will strip all blank lines.
    or "Keep Blanks" will retain all blank lines.

 8)    "Strip Spaces" will strip redundant spaces within statements.
    or "Keep Spaces" will retain these extra spaces.


 Note: 6),7) and 8) are provided as 'extras' to tidy some listings.

 Also note that any initial spaces on (non-indented) lines will always
 be automatically removed. 


 Note: 'Empty' lines start with 1 or more ':' and are blank thereafter.
       'Blank' lines are literally that - they contain nothing! 


       "Info", "Help", "Quit" are self-explanatory.

________________________________________________________________________

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

       Two common causes are :-

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

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

________________________________________________________________________

 Copyright:R.A.Swetman
