;
                                 PRETTY.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               5k (38)   5CD5  3.1        Gene Pizzetta 10/91      Z3COM15

  1- Syntax/Options  2- Configuration  3- Notes                               


   PRETTY is a  Z-System source code case formatter to standardize the case of
opcodes and labels in Z80 and 8080 assembly files.

   Original (vs 1.0, 03/23/86) by Carroll R. Bryan III.
:1

    Syntax   PRETTY {dir:}infile {dir:}{outfile} {{/}options}

   If a  DIR  or  DU  specification is not  given,  the current  drive/user is
assumed.   If no  outfile  name is given,  it  will  have the same name as the
infile.   If a file exists with the  same  name  as  the  outfile,  it will be
renamed to a filetype of BAK.  Any existing BAK file will be lost.
 Options - 1/2   

   A slash is not required if the options  are  the third token on the command
line.

     I    Intel mnemonics.  This option forces the use of the 
          extended Intel opcodes table.  The contents of the 
          source file are not checked or verified.

     Z    Zilog mnemonics.  This option forces the use of the 
          Zilog opcodes table.  The contents of the source file 
          are not checked or verified.

     Q    Toggle quiet mode.  If the quiet flag is set, or if 
          PRETTY is configured to default to quiet mode, this 
          option will toggle quiet mode off.  Otherwise, it will 
          toggle quiet mode on.

     O    Make opcodes upper-case.  Recognized opcodes and 
          pseudo-ops are translated to upper-case.  If upper-case 
          is the default, this option will cause translation to 
          lower-case.
 Options - 2/2 

     Lo   Set label case.  Case of labels and unrecognized 
          opcodes is set according to the immediately following 
          ("o") parameter:
          U    upper-case.
          L    lower-case.
          A    leave as-is.

   If no  I  or  Z  option is given, PRETTY checks the first 16K of the source 
file for a LD, MOV, MVI, or  LXI instruction and uses the opcode table for the
first matching instruction found.  If no matching instruction is found, PRETTY
defaults to Zilog or Intel mnemonics, depending on its configuration.

   If it is running under ZSDOS or ZDDOS, PRETTY will transfer the create date
stamp from the source file to the new file.   If the source file has no create
date, the source file's modify date will be used.

   On error, such as an invalid directory or a file not found, PRETTY sets the
program error flag appropriately and invokes the error handler on error.
:2
 Configuration 

   Using  ZCNFG  and  the  accompanying  PRETTYnn.CFG  file,  PRETTY  can   be
configured to make opcodes  upper-  or  lower-case,  and to make labels upper-
case, lower-case, or to leave them as it finds them.   Although  rarely,  some
files will have no LD,  MOV,  MVI, or LXI opcodes in the first 16K, especially
files with long  preambles.   In  such  a  case  PRETTY  will  revert  to  its
configured default, which can also be changed with ZCNFG.  In addition, PRETTY
can be configured to default to quiet mode.

   If you do not change the name of the CFG  file,  ZCNFG will be able to find
it automatically, even if you change the name of PRETTY.
:3 
 PRETTY Notes - 1/2 

   a. Vs 3.1 updates (09/19/91, Gene Pizzetta):
      - While using PRETTY to make  somebody  else's  source  code readable, I
        decided the cases  of  labels  and  opcodes  should  be  command  line
        options, so I did that.
      - Fixed a bug that sometimes caused the output file to be written to the
        wrong directory.  
      - Several tweeks of the code were made for greater efficiency.  
      - A few SLR and ZMAC pseudo-ops were added to the tables.

   b. Vs 3.0 updates (11/17/90, Gene Pizzetta):
      - Now a ZCPR3 utility.  
      - Made code relocatable and added library routines.  
      - Made casing for labels and opcodes configurable with ZCNFG.  
      - Added quiet option.  
      - Changed L option to I for Intel.  
      - Added some missing opcodes to tables  (especially several for extended
        Intel) and removed superfluous ones.  (Now should  be  compatible with
        ZMAC, SLRZ80, SLRMAC, MAC, RMAC, and M80 source.) 
      - Default opcode table configurable.  
 PRETTY Notes - 2/2 

      - Corrected bug in DU display  (displayed  "A" for user 10,  "B" for 11,
        etc.).  
      - Simplified and expanded usage screen.  
      - Now always preserves a file with the same name as the outfile as a BAK
        file.  
      - Now preserves create date stamps under ZSDOS.  
      - Set program error flag and invokes error handler on error.  
      - Normal verbose display cut from full-screen to a single line.
