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 / CPM / PROGRAMS / WSTAR / PAIRX131.LBR / PAIRX131.DQC / PAIRX.DOC
Text File  |  2000-06-30  |  3KB  |  78 lines
  1. ;;06-30-85
  2.                          PAIRX.DOC v1.3
  3.  
  4. Eric Gans
  5. French Dep't UCLA
  6. Los Angeles, CA 90024
  7.  
  8. Version 1.31 2/21/86 
  9.      Calculates  BIOS CONOUT address so as to work with  Wordstar 
  10. "R" command.
  11.  
  12. Version 1.3 6/27/85
  13.      Allows  directing  error output to a .PXR file.   Outputs  a 
  14. [More] after 22 lines of console output.
  15.  
  16. Version 1.2 4/24/85
  17.      Adds  ^P  and  ^Y  to verified control  characters.
  18.  
  19. Version 1.1 4/13/85
  20.      Allows  console  input  of MAXLN = maximum number  of  lines 
  21. allowed  before control character is considered  unmatched.  (The 
  22. default MAXLN can still be changed at 102H).
  23.      Ignores  dot commands in line count for more  accurate  line 
  24. numbers.
  25.      Counts 256-line "pages" in non-doc files.
  26.  
  27. *****************************************************************
  28.  
  29.  PAIRX is an extended version of PAIR.COM that outputs (to a file 
  30. or  to  the console) page and line number for  unmatched  control 
  31. characters (^S,  ^B,  ^D, ^T, ^V, ^X, ^P, ^Y) in WS document mode 
  32. files. (For non-doc files, it will count one "page" for every 256 
  33. lines.)  What is or is not unmatched does not depend on the total 
  34. number  of  ^S or ^D in the file,  but on the maximum  number  of 
  35. lines  of  separation you allow.  You can enter  this  (one-digit 
  36. decimal)  number from the console after the  filename;  otherwise 
  37. the default will be used.  The original default is 1  (i.e.,  one 
  38. <CR>  is  permitted  between beginning and end of  an  underline, 
  39. etc.);  to  change this,  change the byte at 102H from 1  to  any 
  40. number from 0 to 9.* Setting it to 0, for example, would give you 
  41. an  error  message every time the beginning and end of  a  toggle 
  42. were  not  on the same line.  A single unmatched  character  will 
  43. produce an error message whatever your setting.
  44.  
  45.    *  This  can be done most easily using a disk utility like  my 
  46. SRW: 
  47. 1. srw fpairx.com <CR>
  48. 2. w2 <CR>
  49. 3. W2 = 1 >>? n <-- desired number <CR>
  50. 4. W <CR>
  51. 5. Save (Y/N)? y
  52. 6. e <CR>
  53.  
  54.   In DDT, follow the following steps:
  55. 1. ddt pairx.com <CR>
  56. 2. -s102 <CR>
  57. 3. 102  1  n <-- desired number <CR>
  58. 4. 103  xx  . <CR>
  59. 5. -^C 
  60. 6. save 6 pairx.com  
  61.  
  62.      Format:  pairx [d:]filenm [maxln][f]
  63.  
  64.      MAXLN must be a one-digit decimal number (0 - 9).   If it is 
  65. not entered, the default (found at 102H) will be used.
  66.  
  67.      The  "f" switch (v1.3) puts the error output in a file  with 
  68. type  .PXR.   If there are no errors,  no file is created.   This 
  69. facilitates  the use of PAIRX in batch files;  you can use IF  to 
  70. check for the existence of the .PXR file and abort processing  to 
  71. correct the errors.  If you use "f", the errors are not output to 
  72. the console, but you are told whether or not errors were found.
  73.  
  74.      Since page and line numbers are given, you can determine for 
  75. yourself  whether  the character found by the program  is  really 
  76. unmatched or just farther than usual from its mate.   To keep you 
  77. occupied, PAIRX outputs a running total of pages read.
  78.