home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / basic / library / pb / qbox10 / readutil.doc < prev   
Encoding:
Text File  |  1989-07-30  |  5.3 KB  |  126 lines
  1.  README v1.3  (C) Copyright 1989 by Rohit Gupta, Auckland, New Zealand.
  2.  ESC : Exit     SPACE : Next Page     ARROWS : Move Around
  3. .h ┌────────────────┐
  4. .h │  INTRODUCTION  │
  5. .h └────────────────┘
  6. README displays a help or message file on the screen.  It automatically
  7. determines the active screen mode and uses it to advantage.  It does not
  8. change screen modes.  Therefore, the information is presented in the best
  9. possible manner on the hercules, the cga or the ega.
  10.  
  11. .h ┌─────────────┐
  12. .h │  LICENSING  │
  13. .h └─────────────┘
  14. Why write another readme?  There are many similar programs around such as
  15. BORLAND's readme or the PUBLIC DOMAIN browse.  However, they are all copy-
  16. righted and are either expensive or not for sale.  That is you can not
  17. distribute them with your applications legally, unless you pay a prohibi-
  18. tive amount of money.  So here is my effort towards FREEWARE.  There is
  19. only one condition attached for use, distribution or sale :-
  20.  
  21. .i README.EXE must be distributed together with README.DOC, both of them  
  22. .i unmodified in any fashion.                                             
  23.  
  24. I do not want any royalties.  You can even make a profit on its distribu-
  25. tion.
  26.  
  27. .h ┌─────────────────────┐
  28. .h │  HOW TO USE README  │
  29. .h └─────────────────────┘
  30. In normal operation, README does not flash up any garbage (such as my name
  31. or a copyright message) to clutter up YOUR screen.  The default file is
  32. called README (without any extensions).  If this file is not found in the
  33. current drive and directory, then this documentation is displayed.  You can
  34. over-ride the default by typing in "README filename", where filename must
  35. include the extension desired.
  36.  
  37. .h ┌─────────────────────────────┐
  38. .h │  USERS VIEWPOINT OF README  │
  39. .h └─────────────────────────────┘
  40. As far as the end-user is concerned, he/she sees only what you want them to
  41. see.
  42.  
  43. .i Almost any key will page forward.      
  44. .i Up/Down Arrows will scroll one line.   
  45. .i Home will restart the file.            
  46. .i Page Up/Down will scroll a screenful.  
  47. .i Esc, X or Q exits.                     
  48.  
  49. .h ┌────────────────┐
  50. .h │  SHORTCOMINGS  │
  51. .h └────────────────┘
  52. Only 80 X 25 displays are catered for.  Any other configuration will not
  53. work properly.
  54.  
  55. The maximum text file size is limited to 600 K, providing that the total
  56. file fits in memory.
  57.  
  58. .h ┌────────────────────────────┐
  59. .h │  CREATION OF README FILES  │
  60. .h └────────────────────────────┘
  61. If you have only one file, then just call it "README.", otherwise use any
  62. legal file names.  The file is standard ascii text, create with any word-
  63. processor.  Only the first 76 characters of each line are displayed.
  64.  
  65. The very first line is the title, you can have any sort of text in the
  66. title line.  The second line is the menu, you can have any sort of text in
  67. the menu line.  Note README does not show its own title or menu, you must
  68. specify them.  Both these lines are displayed in yellow on blue on colour
  69. cards and inverse on mono cards.
  70.  
  71. There are a number of switches for video control, specified by two charac-
  72. ters at the beginning of the line (these 2 are not displayed and the next
  73. 76 characters are displayed on the screen) :-
  74.  
  75. .h.h This gives heading colour  (yel on blk in colour, high     in mono).
  76. .b.b This gives blinking colour (yel on red in colour, flashing in mono).
  77. .i.i This gives inverse colour  (wht on red in colour, inverse  in mono).
  78. .r.r This gives reverse colour  (yel on blu in colour, inverse  in mono).
  79. ..   Normal text                (cyn on blk in colour, low      in mono).
  80.  
  81. In addition, for those people who dont like this colour range, an extended
  82. version is available, in this case the first 6 characters are not displayed,
  83. the next 76 are.  The argument forms two attribute bytes, the first is used
  84. if a colour card is detected, the second is used if a mono card is detected.
  85. Each byte is made of two components (each being a hex digit 0-F), the first
  86. is the background colour and the second  the foreground colour.  For further
  87. elucidation, refer to documentation on colour cards :-
  88.  
  89. .c2E09.c2E09 This gives  (2E) yellow on light green in colour,  
  90. .c2E09       and         (09) highlit, underlined   in mono.    
  91.  
  92. Note :- High-bits generated by programs such as WORDSTAR (in document
  93.         mode) are not allowed in the file.  Results will be unpredictable.
  94.         Any printable character (20-FF) may be used.
  95.  
  96. Tip :- If your editor removes trailing blanks, add a ^H at the end of the
  97.        line to block colour text.  The doc file itself uses this technique.
  98.  
  99. .h ┌───────────┐
  100. .h │  UPDATES  │
  101. .h └───────────┘
  102. v1.0  First release, Major limitation was that back scrolling was  available
  103.       for one page only.
  104. v1.1  Scrolling now complete.  File size limited instead, to 600K or memory
  105.       whichever is smaller.
  106. v1.2  If length of title or menu is less than 10 characters, a default title
  107.       and / or menu is displayed.
  108. v1.3  Cursor is suppressed.
  109.       The new colour command was added to enable the finicky programmer to
  110.       select colour combinations.
  111.  
  112. .h ┌───────────────────┐
  113. .h │  CONTACT ADDRESS  │
  114. .h └───────────────────┘
  115. Any suggestions are welcome.
  116.  
  117. .r ┌───────────────────┐  
  118. .r │  Rohit Gupta      │  
  119. .r │  P.O.Box 1995,    │  
  120. .r │  Auckalnd - 1,    │  
  121. .r │  NEW ZEALAND.     │  
  122. .r └───────────────────┘  
  123.  
  124.  
  125. .hEND
  126.