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 / BEEHIVE / UTILITYS / BOX1.ARC / BOX.DOC < prev    next >
Text File  |  1988-03-06  |  4KB  |  131 lines
  1. Program Name : BOX-PC.COM for MS-DOS (8088, 8086, etc.)
  2.                BOX-CPM.COM for CP/M systems (Z-80 req'd) 
  3. Source File  : BOX.PAS
  4. Compiler     : Turbo Pascal V 3.0
  5. Oper. System : CP/M or MS-DOS
  6. Version/date : 1.0  3/19/87
  7. Author       : Loring Chien
  8.  
  9. BOX.COM is a short program I threw together to take a Text file
  10. and create a new file with a Box around the text.
  11.  
  12. An Example of the output is :
  13.  
  14. +-----------------------+
  15. |                       |
  16. |      BOXDEMO.TXT      |
  17. |                       |
  18. | This is a demo of the |
  19. | BOX.COM program.      |
  20. |                       |
  21. |      Courtesy of      |
  22. |      Loring Chien     |
  23. |   6519 La Mora Drive  |
  24. |  Houston, Texas 77083 |
  25. |                       |
  26. +-----------------------+
  27.  
  28. The input file was:
  29.  
  30. BOXDEMO.TXT
  31.  
  32. .LJ
  33. This is a demo of the
  34. BOX.COM program.
  35.  
  36. .CE
  37. Courtesy of
  38. Loring Chien
  39. 6519 La Mora Drive
  40. Houston, Texas 77083
  41.  
  42.  
  43. This program was "tossed" together because I felt a need
  44. for an easy method to "box" text - for announcements, 
  45. program comment sections, and repetitive print statements
  46. in source code.  I find normal text editors fine for 
  47. creating the text, but woefully inadequate when putting 
  48. the box around it.  First you have to pad spaces at the 
  49. end of the line, insert the box characters, and center
  50. anything you want centered.  When you decide you need to edit
  51. it, you are always fixing up the margins since the editor does 
  52. not know how to wrap the box characters.  Then you find
  53. that it is too large or too small and you want to change the
  54. size of the box.  There is no end of frustration.
  55.  
  56. With this program all you need to do is edit the text sans
  57. box and submit it to the BOX program.  To change things,
  58. just edit the original file, and rerun BOX, at which time
  59. you can change the size and BOX style.  BOX will take
  60. care of centering or justification, as requested.
  61.  
  62. Three commands are accepted, .CE, .RJ, and .LJ.  in the
  63. input text.  The .CE command causes subsequent lines to
  64. be centered horizontally in the box.  This is the default.
  65. The .RJ and .LJ commands cause text to be right justified
  66. or left justified, respectively. Each command is in effect
  67. until another command is given.  They may not be used
  68. together, nor does BOX fill or wrap any lines.  The
  69. commands must have the dot appear in column one, and
  70. nothing else is allowed in the line.
  71.  
  72. You will be asked for the input file name, default file
  73. type is ".TXT".  You will then be asked if the file is a
  74. Wordstar document-mode file, if so, soft-carriage
  75. returns and spaces will be converted to hard ones and
  76. Soft-hyphens will be removed if not at the end of a line.
  77.  
  78. You will be asked for a output filename, the default
  79. is the same name as the input file, except with a file-
  80. type of ".BOX".
  81.  
  82. Options available are for auto-sizing the box (one space
  83. on both ends of the longest line), or specifying a box
  84. of a certain column width.
  85.  
  86. You also have the choice between a box made of -,|, and +
  87. (line box, type 1), made of asterisks (type 2), made of
  88. IBM-PC graphic lines (types 3 & 4) or a custom box by
  89. specifying all elements (Top, sides, and four corners)
  90. in type 5.  You will also be asked if you want to supply
  91. prefix and postfix strings (strings which are appended
  92. to the beginning or end of each line of the box).
  93.  
  94. Prefix and Postfix strings are very useful. As an example,
  95. consider:
  96. Prefix is    Writeln ('
  97. Postfix is   ');
  98. then boxed text will be produced which can be inserted into
  99. a Pascal program for screen display.
  100.  
  101. For BASIC,
  102. Prefix is    PRINT "
  103. PostFix is   "
  104. to achieve the same thing.
  105.  
  106. In addition, spaces in a prefix can be used to center
  107. the box, or comment delimiters can be used to make
  108. pretty comments for a program, i.e.
  109. Prefix is    /
  110. Postfix is   /
  111. can make a box like
  112.    /**********/
  113.    /*        */
  114.    /*        */
  115.    /*        */
  116.    /**********/
  117. when Asterisks are used for all three characters.
  118.  
  119. Finally, when the program is done, you can review
  120. the output if you wish; you are asked before the
  121. program exits.
  122.  
  123. For some really neat-looking stuff, try boxing
  124. text, and then boxing the results to get a double
  125. box.
  126.  
  127. Future possible enhancements include making it
  128. take input and output file names from the command
  129. line (in which case default sizing and BOX type
  130. will be used).
  131.