home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / u.lbr / UNJUST.HZP / UNJUST.HLP
Encoding:
Text File  |  1991-11-18  |  5.1 KB  |  104 lines
  1. ;
  2.                                  UNJUST.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (27)   0D9B  1.3        Gene Pizzetta 11/90      Z3COM23
  6.  
  7.   1- Syntax/Options  2- Usage  3- Configuration  4- Notes                     
  8.  
  9.  
  10.    UNJUST is  a  ZCPR3 utility that  replaces  multiple  white-space character
  11. strings in text files with a single space.  It removes all soft spaces and tab
  12. characters.   It enforces two spaces after periods and removes all white-space
  13. at the beginning and (optionally) end of lines.   Under ZDDOS and ZSDOS create
  14. date stamps are preserved.  Vs 1.0 (9/22/90) by Gene Pizzetta.
  15. :1
  16.     Syntax   UNJUST {dir:}infile {dir:}{outfile} {{/}options}
  17.  
  18.    An infile name is required.   If no outfile name is given, it will have the
  19. same name as the infile.   If a file exists with the same name as the outfile,
  20. it will be renamed to filetype of BAK.   Filenames beginning with a slash must
  21. be preceded by a DU specification.
  22.  
  23.    Options   A preceding slash is necessary only if a second file 
  24.              specification is not given.
  25.  
  26.      Q    Toggles quiet mode.  Quiet mode is set by the ZCPR3 
  27.           quiet flag or by a configuration byte (see 
  28.           Configuration).  Option Q toggles the current mode.
  29.  
  30.      T    Leaves a single trailing space (except two spaces after 
  31.           a period, question mark, or exclamation point) at the 
  32.           end of lines that have existing trailing spaces.
  33. :2
  34.  Usage - 1/2 
  35.  
  36.    UNJUST replaces strings of hard and soft spaces and tabs with a single hard
  37. space (20h),  except that white-space strings after a period,  question marks,
  38. and exclamation points are reduced to two hard spaces.   (If those punctuation
  39. marks had no space after them in the  original file,  no space will be added.)
  40. Leading spaces on  a  line  are  eliminated  completely.   Trailing spaces are
  41. eliminated by default,  but the T option  allows  leaving spaces at the end of
  42. the line (which is desirable for ZDE and WordStar document files).
  43.  
  44.    Blocks of text delimited by a  special tag character will be copied without
  45. changes.  The tag character, as distributed, is ^P, but it can be changed (see
  46. Configuration section).
  47.  
  48.    Under ZDDOS and ZSDOS file create dates  are preserved.   If the input file
  49. has no create date,  the old  modification date will become the create date of
  50. the output file.   If the input file  has  neither a create nor a modification
  51. date, the output file will have the current date.
  52.  Usage - 2/2 
  53.  
  54.    To unjustify a document,  first scan the  document  with your favorite text
  55. editor to see if there are any sections,  such as charts and tables,  in which
  56. you want the spacing preserved.   Mark the beginning and end of those sections
  57. with the tag character (^P, unless you change it).   Then run the file through
  58. UNJUST.   UNJUST will automatically  remove the  tag  characters, but the text
  59. between them will be unchanged.
  60.  
  61.    You may then edit the  file  with  WordStar.   You  will  have to re-center
  62. titles and you will still have to remove hard carriage returns with ^^.
  63.  
  64.    On error UNJUST will set the program error flag to standard codes as listed
  65. in Z34ERR.LIB and invoke the error handler, if one is running.
  66. :3
  67.  Configuration 
  68.  
  69.    UNJUST is configured using the accompanying UNJUSTnn.CFG file and the ZCNFG
  70. utility.  Do not rename the CFG file, so ZCNFG will always be able to find it, 
  71. even if you change the name of UNJUST.
  72.  
  73.    UNJUST will run fine "out of the box", but if you wish you can use ZCNFG to
  74. make quiet mode the default,  to preserve trailing spaces as the default,  and
  75. to select a new tag character.   The  current  quiet  mode  and trailing space
  76. status, and the tag character are reflected on the usage screen.
  77. :4
  78.  UNJUST Notes - 1/2 
  79.  
  80.    a. Vs 1.3 updates (11/28/90, Gene Pizzetta):
  81.       - Corrected bug which  caused  UNJUST to  occasionally try to rename the
  82.         output file in the wrong directory.
  83.  
  84.    b. Vs 1.2 updates (11/23/90, Gene Pizzetta):
  85.       - Increased size of input buffer and made several other changes to speed
  86.         up processing.  
  87.       - Now removes trailing spaces.  
  88.       - T option  allows  leaving  a  single  trailing  space  on  lines where
  89.         trailing spaces already exist (for ZDE compatibility).
  90.       - Also now  enforces  two  spaces  after  question marks and exclamation
  91.         points.  
  92.       - Now properly handles files that do not end with a ^Z.  
  93.       - Corrected bug that caused two sectors of ^Z's to be added to a file if
  94.         it ended exactly on a sector boundary.  
  95.       - Implemented several suggestions to improve the code.
  96.  UNJUST Notes - 2/2 
  97.  
  98.    b. Vs 1.1 updates (10/5/90, Gene Pizzetta):
  99.       - Corrected bugs that caused unpredictable destination for outfile if no
  100.         filespec was given and a jump to the  wrong error routine if the input
  101.         file was not found.  
  102.       - Now checks for sufficient TPA space.  
  103.       - Several other code optimizations
  104.