home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug060.arc / CPM#006.LBR / DBPRETTY.DOC < prev    next >
Encoding:
Text File  |  1979-12-31  |  2.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4.              PRETTY - FORMATTING PROGRAM FOR dBASE II COMMAND FILES
  5.  
  6.                                        by
  7.  
  8.                                   Joel Shapiro
  9.  
  10.                                  August 13, 1984
  11.  
  12.         The  capability  of  formatting  a  dBASE  command  file  so  all 
  13.         structured  operations can be matched has proven to be helpful in 
  14.         understanding and troubleshooting my programs.
  15.  
  16.         Adam  B.  Green demonstrates and provides code for such a program 
  17.         in  his "Advanced dBASE II User's Guide" but the program lacks  a 
  18.         few features and,  most important,  is extremely slow.  I hope my 
  19.         version of the program takes care of both problems.
  20.  
  21.         The  purpose of this program is,  using a dBASE II  command  file 
  22.         (CMD) as a source, provide a file with the same program formatted 
  23.         in  a  special  manner.  Specifically,  the  program  formats  as 
  24.         follows:
  25.  
  26.         All  REMARK  lines  denoted with an asterisk (*) are  printed  in 
  27.         lower case.
  28.  
  29.         Lines between DO WHILE, DO CASE, IF and their terminators; ENDDO, 
  30.         ENDCASE and ENDIF are indented three (3) additional spaces.
  31.  
  32.         All characters except those between single quotes,  double quotes 
  33.         and brackets are capitalized.
  34.  
  35.         Lines  between TEXT and ENDTEXT keywords are printed  exactly  as 
  36.         they appear in the file.
  37.  
  38.         The  program  is  written  in  BASIC/Z,  a  compiled  basic  from 
  39.         System/z,  Inc. and is provided in object code only. All run-time 
  40.         code is contained in the COM file. To use, type: PRETTY <CR>.
  41.  
  42.         When requested,  enter the filename and drive.  You don't have to 
  43.         add the filetype as the program expects to find a CMD file.
  44.  
  45.         You  will  the  be asked to select a command file or  print  file 
  46.         output.  Selecting a command file will cause the formatted output 
  47.         to  be written to a file of the type  ????????.NEW.  Selecting  a 
  48.         print  file output will provide a file of the type  ????????.PRN. 
  49.         Additionally,  line  numbers  are added to each line in  the  PRN 
  50.         file.
  51.  
  52.         No provision has been made to split lines longer than a formatted 
  53.         screen  or  printer  line  width.  I suggest you  use  lines  not 
  54.         exceeding  60%  (48 characters for an 80  column  screen/printer) 
  55.         which should format correctly.
  56.  
  57.         Output  files can be printed directly or enhanced with your  word 
  58.         processor.
  59.  
  60.         Joel Shapiro
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                         1
  67.