home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / JSAGE / ZSUS / PROGPACK / PRETTY30.LBR / PRETTY30.DZC / PRETTY30.DOC
Text File  |  1990-11-17  |  3KB  |  76 lines
  1.  
  2.                              PRETTY
  3.                            Version 3.0
  4.  
  5.                           Gene Pizzetta
  6.                         November 17, 1990
  7.  
  8.  
  9. PRETTY is a Z-System utility to standardize the case of opcodes 
  10. and labels in Z-80 and 8080 source code.
  11.  
  12. USAGE:
  13.  
  14.      PRETTY {dir:}infile {dir:}{outfile} {{/}options}
  15.  
  16. If a DIR or DU specification is not given, the current drive/user 
  17. is assumed.  If no outfile name is given, it will have the same 
  18. name as the infile.  If a file exists with the same name as the 
  19. outfile, it will be renamed to a filetype of BAK.  Any existing 
  20. BAK file will be lost.
  21.  
  22. OPTIONS:  A slash is not required if the options are the third 
  23. token on the command line.
  24.  
  25.      I    Intel mnemonics.  This option forces the use of the 
  26.           extended Intel opcodes table.  The contents of the 
  27.           source file are not checked or verified.
  28.  
  29.      Z    Zilog mnemonics.  This option forces the use of the 
  30.           Zilog opcodes table.  The contents of the source file 
  31.           are not checked or verified.
  32.  
  33.      Q    Toggle quiet mode.  If the quiet flag is set, or if 
  34.           PRETTY is configured to default to quiet mode, this 
  35.           option will toggle quiet mode off.  Otherwise, it will 
  36.           toggle quiet mode on.
  37.  
  38. If no option is given, PRETTY checks the first 16K of the source 
  39. file for a LD, MOV, MVI, or LXI instruction and uses the opcode 
  40. table for the first matching instruction found.  If no matching 
  41. instruction is found, PRETTY defaults to Zilog or Intel 
  42. mnemonics, depending on its configuration.
  43.  
  44. If it is running under ZSDOS or ZDDOS, PRETTY will transfer the 
  45. create date stamp from the source file to the new file.  If the 
  46. source file has no create date, the source file's modify date 
  47. will be used.
  48.  
  49. On error, such as an invalid directory or a file not found, 
  50. PRETTY sets the program error flag appropriately and invokes the 
  51. error handler on error.
  52.  
  53. CONFIGURATION:  Using ZCNFG and the accompanying PRETTYnn.CFG 
  54. file, PRETTY can be configured to make opcodes upper- or lower- 
  55. case, and to make labels upper-case, lower-case, or to leave them 
  56. as it finds them.  Although rarely, some files will have no LD, 
  57. MOV, MVI, or LXI opcodes in the first 16K, especially files with 
  58. long preambles.  In such a case PRETTY will revert to its 
  59. configured default, which can also be changed with ZCNFG.  In 
  60. addition, PRETTY can be configured to default to quiet mode.
  61.  
  62. If you do not change the name of the CFG file, ZCNFG will be able 
  63. to find it automatically, even if you change the name of PRETTY.
  64.  
  65.  
  66. I'm very interested in your bug reports and your suggestions for 
  67. improvements.
  68.  
  69. Gene Pizzetta
  70. 481 Revere St.
  71. Revere, MA 02151
  72.  
  73. Voice:  (617) 284-0891
  74. Newton Centre Z-Node:  (617) 965-7259
  75. Ladera Z-Node Central:  (213) 670-9465
  76.