;
                                 PRETTY.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               5k (35)   AB6F  1.0        Gene Pizzetta 11/90      Z3COM15

  1- Syntax/Options  2- Configuration                                         


   PRETTY is a  Z-System utility to standardize the case of opcodes and labels
in Z80 and 8080 source code.
: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.
 Options - 2/2 

   If no 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.
