home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / ptxt10.arc / PTXT10.DOC (.txt) < prev    next >
ProText Document  |  1993-03-28  |  4KB  |  70 lines
  1. PTXT10 is a program which provides a way of printing text as if it
  2. were a CP/M transient command.  You NEED WordStar to make use of
  3. this program !  The principal used is as follows:  The program is
  4. assembled to form a .COM file.  Then the =>.COM<= file is edited
  5. using WORDSTAR in either document or non-document mode and the
  6. desired text is inserted at the end of the .COM file at the
  7. indicated location.  (Ignore the garbage in front of the indicated
  8. position; it is the program's assembly language and SHOULD NOT BE
  9. CHANGED.)
  10. If you have already generated some desired text with WordStar, you
  11. can just ^KR the desired file into the .COM file at the indicated
  12. location, but I usually enter WordStar using the final name of the
  13. file and then read in FIRST the .COM file and THEN the desired text
  14. file at the indicated location.
  15. FOR EXAMPLE, to generate a USER.COM file that explains to the
  16. uninitiated users of the bulletin board that under ZCPR, you don't
  17. use the USER command (i.e. a sort of dedicated mini help file), I
  18. will enter WordStar editing the file USER.COM.  This is of course a
  19. NEW FILE.  Then I read in PTXT10.COM using ^KR, then place the
  20. cursor at the beginning of the line with the ending ^@'s as
  21. indicated by the message in the .COM file just read in, and read in
  22. my text file that will tell the user about User Areas.
  23. Note that only the ^@ (or binary 0 or null) and the ^Z (or CP/M EOF
  24. marker, 1A hex) can NOT be entered into the text portion of the
  25. resulting .COM file.  Note that you do not have to edit the TEXT
  26. file with WordStar, but you MUST use WordStar to insert the text
  27. into the .COM file.  (All other editors that I am familiar with will
  28. mask off the high-bits of the program code, thus trashing the .COM
  29. file !)  Note that you can put any control characters other than ^@
  30. (a binary 0) and ^Z (CP/M's End-of-File indicator) into the file.
  31. Bytes with the High-bit set will have the high-bit masked off before
  32. printing. Thus either WordStar document mode files or other ASCII
  33. files with no high-bits can be used for text.
  34. Paged output is provided by inserting an ASCII Form Feed (0C hex or
  35. ^L) into the file.  This is possible with most editors.  With
  36. WordStar, for example, you prefix you desired control character with
  37. a Control-P; to enter a ^L then, you enter ^P^L and only the
  38. control-L will be put into the file.
  39. The text output will scroll continuously until you press a Control-S
  40. which will pause the scroll or until you reach a page break (^L).
  41. The program will also respond to Control-C, Control-K, or Control-X
  42. during scrolling by aborting back to CP/M.  If you pause the scroll
  43. with a Control-S, you can only restart it with a Control-S or a
  44. Control-Q.  The Control-C/K/X aborts will also work while the scroll
  45. is paused with Control-S.
  46. This program was inspired by a need of such a program and by the
  47. more crude version of TEXT50.ASM (which has a potential system
  48. crashing bug in that it fails to set up a local stack).  I do not
  49. recommend TEXT50.ASM (or earlier versions of TEXT) for Bulletin
  50. Board use as the failure to set up a local stack can cause a crash
  51. under certain circumstanses.  In addition, TEXTxx requires that you
  52. reserve some character(s) for special purposes.  That is not
  53. necessary with PTXT10.  Only the CP/M EOF (which you can't enter
  54. from WordStar anyway) and the ASCII Null (which you can't enter from
  55. WordStar either and which is the text string terminator) are
  56. reserved with this program.  Note that this version is somewhat
  57. crude for Bulletin Board use -- one really should have the program
  58. determine from the user data the screen size and then adjust it's
  59. text display dynamically to the user's screen size.  Since I rarely
  60. use the program for multipage displays, I did not add this feature.
  61. If you regularly use this program in place of a version of HELP.COM,
  62. (which is a far more sophisticated and useful program for multipage
  63. displays, tree-indexed displays, etc.) you might want to add this
  64. feature.
  65. Note that this file is included in a PTXT-printing form as PTXTDEMO.COM.
  66. You can display all this text just by typing PTXTDEMO<cr>.  Note
  67. that this program only adds 256 bytes to the size of the text you
  68. wish to display, so it is a very efficient way to get text displayed
  69. on a terminal with very little overhead.
  70.