home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PRETTY.HZP / PRETTY.HLP
Encoding:
Text File  |  1991-11-18  |  4.9 KB  |  109 lines
  1. ;
  2.                                  PRETTY.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                5k (38)   5CD5  3.1        Gene Pizzetta 10/91      Z3COM15
  6.  
  7.   1- Syntax/Options  2- Configuration  3- Notes                               
  8.  
  9.  
  10.    PRETTY is a  Z-System source code case formatter to standardize the case of
  11. opcodes and labels in Z80 and 8080 assembly files.
  12.  
  13.    Original (vs 1.0, 03/23/86) by Carroll R. Bryan III.
  14. :1
  15.  
  16.     Syntax   PRETTY {dir:}infile {dir:}{outfile} {{/}options}
  17.  
  18.    If a  DIR  or  DU  specification is not  given,  the current  drive/user is
  19. assumed.   If no  outfile  name is given,  it  will  have the same name as the
  20. infile.   If a file exists with the  same  name  as  the  outfile,  it will be
  21. renamed to a filetype of BAK.  Any existing BAK file will be lost.
  22.  Options - 1/2   
  23.  
  24.    A slash is not required if the options  are  the third token on the command
  25. line.
  26.  
  27.      I    Intel mnemonics.  This option forces the use of the 
  28.           extended Intel opcodes table.  The contents of the 
  29.           source file are not checked or verified.
  30.  
  31.      Z    Zilog mnemonics.  This option forces the use of the 
  32.           Zilog opcodes table.  The contents of the source file 
  33.           are not checked or verified.
  34.  
  35.      Q    Toggle quiet mode.  If the quiet flag is set, or if 
  36.           PRETTY is configured to default to quiet mode, this 
  37.           option will toggle quiet mode off.  Otherwise, it will 
  38.           toggle quiet mode on.
  39.  
  40.      O    Make opcodes upper-case.  Recognized opcodes and 
  41.           pseudo-ops are translated to upper-case.  If upper-case 
  42.           is the default, this option will cause translation to 
  43.           lower-case.
  44.  Options - 2/2 
  45.  
  46.      Lo   Set label case.  Case of labels and unrecognized 
  47.           opcodes is set according to the immediately following 
  48.           ("o") parameter:
  49.           U    upper-case.
  50.           L    lower-case.
  51.           A    leave as-is.
  52.  
  53.    If no  I  or  Z  option is given, PRETTY checks the first 16K of the source 
  54. file for a LD, MOV, MVI, or  LXI instruction and uses the opcode table for the
  55. first matching instruction found.  If no matching instruction is found, PRETTY
  56. defaults to Zilog or Intel mnemonics, depending on its configuration.
  57.  
  58.    If it is running under ZSDOS or ZDDOS, PRETTY will transfer the create date
  59. stamp from the source file to the new file.   If the source file has no create
  60. date, the source file's modify date will be used.
  61.  
  62.    On error, such as an invalid directory or a file not found, PRETTY sets the
  63. program error flag appropriately and invokes the error handler on error.
  64. :2
  65.  Configuration 
  66.  
  67.    Using  ZCNFG  and  the  accompanying  PRETTYnn.CFG  file,  PRETTY  can   be
  68. configured to make opcodes  upper-  or  lower-case,  and to make labels upper-
  69. case, lower-case, or to leave them as it finds them.   Although  rarely,  some
  70. files will have no LD,  MOV,  MVI, or LXI opcodes in the first 16K, especially
  71. files with long  preambles.   In  such  a  case  PRETTY  will  revert  to  its
  72. configured default, which can also be changed with ZCNFG.  In addition, PRETTY
  73. can be configured to default to quiet mode.
  74.  
  75.    If you do not change the name of the CFG  file,  ZCNFG will be able to find
  76. it automatically, even if you change the name of PRETTY.
  77. :3 
  78.  PRETTY Notes - 1/2 
  79.  
  80.    a. Vs 3.1 updates (09/19/91, Gene Pizzetta):
  81.       - While using PRETTY to make  somebody  else's  source  code readable, I
  82.         decided the cases  of  labels  and  opcodes  should  be  command  line
  83.         options, so I did that.
  84.       - Fixed a bug that sometimes caused the output file to be written to the
  85.         wrong directory.  
  86.       - Several tweeks of the code were made for greater efficiency.  
  87.       - A few SLR and ZMAC pseudo-ops were added to the tables.
  88.  
  89.    b. Vs 3.0 updates (11/17/90, Gene Pizzetta):
  90.       - Now a ZCPR3 utility.  
  91.       - Made code relocatable and added library routines.  
  92.       - Made casing for labels and opcodes configurable with ZCNFG.  
  93.       - Added quiet option.  
  94.       - Changed L option to I for Intel.  
  95.       - Added some missing opcodes to tables  (especially several for extended
  96.         Intel) and removed superfluous ones.  (Now should  be  compatible with
  97.         ZMAC, SLRZ80, SLRMAC, MAC, RMAC, and M80 source.) 
  98.       - Default opcode table configurable.  
  99.  PRETTY Notes - 2/2 
  100.  
  101.       - Corrected bug in DU display  (displayed  "A" for user 10,  "B" for 11,
  102.         etc.).  
  103.       - Simplified and expanded usage screen.  
  104.       - Now always preserves a file with the same name as the outfile as a BAK
  105.         file.  
  106.       - Now preserves create date stamps under ZSDOS.  
  107.       - Set program error flag and invokes error handler on error.  
  108.       - Normal verbose display cut from full-screen to a single line.
  109.