home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / egutil53.lbr / GTXT.DZC / GTXT.DOC
Encoding:
Text File  |  1988-07-12  |  3.3 KB  |  83 lines
  1. ;;02-23-85
  2.  
  3.                           GTXT.DOC v1.1
  4.                             06/18/85
  5.  
  6. Eric Gans
  7. French Department UCLA
  8. Los Angeles, CA 90024
  9.  
  10. Version 1.1 update:
  11. No  longer  messes up margin of tabbed files (v1.0  confused  the 
  12. BDOS  column  count - thanks to Irvin Block of Sea Cliff  NY  for 
  13. catching this.)
  14.  
  15.  
  16.      TXT.COM  is one of those great ideas every programmer wishes 
  17. he  had found for himself.  The idea of making a textfile into  a 
  18. COM file that requires just one command to print it on the screen 
  19. is both practical and elegant.
  20.  
  21.  The enclosed files GTXT11.COM, GTXT11.000, 0.DAT and COM.SUB are 
  22. more  tributes to the ingenuity of TXT than attempts  to  surpass 
  23. it. They nevertheless offer a couple of improvements.
  24.  
  25.  
  26. 1.  GTXT11.COM is my version of TXT.COM. It accepts the following 
  27. improvements of recent versions over the original: 
  28.  
  29. - exit via ^C (I didn't bother to offer other exit  options;  who
  30. needs them?)
  31.  
  32. - zeroes high bit to read (say) WS doc mode files
  33.  
  34. - allows  printing  of  control  characters using  "^"  (thus  ^Z 
  35. entered  in the text will blank the screen when the COM  file  is 
  36. run.)
  37.  
  38. - page breaks can be forced with "~"
  39.  
  40. In addition,  it takes the trouble to count the lines and issue a 
  41. "[More]"  every  23 lines without your having to add "~"  to  the 
  42. text;  when  you type a character the [More] is blanked  out  and 
  43. doesn't  waste a line on the screen.  Version 1.1 backspaces over 
  44. the [More] rather than doing a CR, which disturbs the BDOS column 
  45. count and puts tabs in the wrong column.  (This is more a bug  in 
  46. CP/M than in GTXT, but we have to work with CP/M, right?)
  47.  
  48.                               *****
  49.  
  50. 2.  GTXT11.000 is just GTXT11.COM with the 0 (=end) byte missing. 
  51. It  can be used like (G)TXT.COM:  you read it into the text  file 
  52. with  something  like ^KR in WS and find some way  of  putting  a 
  53. binary  0  at  the  end.  But its real purpose is  for  use  with 
  54. COM.SUB,  which  allows  you  to create a COM file  from  a  pre-
  55. existing text file with no editing whatsoever.  COM.SUB  contains 
  56. only one line:
  57.  
  58.      pip $1.com=gtxt.000,$1.$2,0.dat
  59.  
  60. The point of renaming GTXT is that since it is not a COM file PIP 
  61. will  cut it off after the EOF marker (1AH) and not put extra  (0 
  62. or other) bytes between it and the textfile you are COMing.   The 
  63. parameters $1 and $2 are, respectively, the filename and filetype 
  64. of your textfile.  They must be separated by a space.  0.DAT is a 
  65. 2-byte text file that contains a binary 0 followed by 1AH;  the 0 
  66. serves to mark the end of the read for the COM file you create. 
  67.  
  68. Example:  suppose you have a little textfile called BLRK.TXT that 
  69. you want to transform into a COM file.  Just enter:
  70.  
  71.      submit (GSUB is faster) com blrk txt
  72.  
  73. and  you  will  have  an executable  file  BLRK.COM  while  still 
  74. retaining the original BLRK.TXT.
  75.  
  76. All the features of GTXT.COM will be implemented. Just be careful 
  77. that you have no (apparent) control characters in your  text.  In 
  78. WS,  for instance, if you underline with ^PS an ^S will remain in 
  79. your  text.  This won't show up in the COM file (in  fact,  it'll 
  80. remove  the unsightly ^S's),  but what if it were ^Z or ^P (which 
  81. would toggle your printer)?
  82.  
  83.