home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / teach241.zip / TWCAI6.CHP < prev    next >
Text File  |  1992-12-08  |  7KB  |  178 lines
  1. #OFF
  2. %
  3. #EF
  4. #T15,1,Working with the Renumbering Utility
  5. |JUMP START|     |REFERENCE MANUAL|    |NUMAID|      |RENUMBER|    |ABOUT|
  6. #HH,1,5,80,1,1,0
  7. #R7
  8.                    ╥─┐        ┬       ╓┐          ╓─┐ ∞      ╓─┐
  9.                    ╟┬┘ ╓╖ ╓┐ ╓┤ ╖┌    ╫  ╓┐ ╥┐    ╙─┐ ╥ ╙╥┘   ╓┘
  10.                    ╨└┘ ╙─ ╙┴ ╙┴ ╙┤    ╨  ╙┘ ╨     ╙─┘ ╨ ╜ └   ∞
  11.                                 ╙┘
  12.                    ╥─┐              ╥        ∞          ╥  ╥  ╥
  13.                    ╟┬┘ ╓╖ ╥┐ ╖┌ ╥┬┐ ╟┐ ╓╖ ╥┐ ╥ ╥┐ ╓┐    ║ ─╫─ ╨
  14.                    ╨└┘ ╙─ ╨└ ╙┴ ╨ ┴ ╨┘ ╙─ ╨  ╨ ╨└ ╙┤    ╨  ╙┘ ∞
  15.                                                   ╙┘
  16.  
  17.  
  18.                                    Preview
  19.             ~b~Y~I┌────────────────────────────────────────────────────┐~z
  20.             ~b~Y~I│ Chapter 6 discusses the numbering utility.  It is  │~z
  21.             ~b~Y~I│ supplemented by help screens within the utility    │~z
  22.             ~b~Y~I│ and is short.   About 10 screens.                  │~z
  23.             ~b~Y~I└────────────────────────────────────────────────────┘~z
  24. #NE
  25. #HH,1,24,80,1,1,0
  26. #HF,1,25,80,25,176,1,0
  27. #WH
  28.  
  29. %
  30. #EF
  31. #T15,1,Working with the Renumbering Utility
  32.                   |RENUMBER|     |NUMAID|     |CAITEST FILE|
  33. #HH,1,5,80,1,1,0
  34. #R6
  35.  
  36.  ▄█▀▀▀▀▀█▄ .∙      Except for one's knowledge and writing skills the succcess
  37. ▐█▐─ô═ô─▌█▌∙.        of a CAITest is based on the correct sequencing of
  38.  └┤   ┌┘ .∙         a simple text file.
  39.   │█▀▀▀█│
  40.   └┬███┬┘          You know from studying the templates that each question
  41. ▒▒▒▒ ■ ▒▒▒▒          starts with a number that must be in the first five
  42.                      spaces.  Any number but ~C~I0~Y~I works.
  43.  
  44.     The renumbering utility renumbers a file.  Once renumbered the
  45. file is easier to edit.  However, if you don't need it ~W~Ithere is no
  46. technical reason to renumber a file~Y~I.
  47.  
  48.     Now, I'll say that in another way~F...~F
  49. #HH,1,24,80,1,1,0
  50. #HF,1,25,80,25,176,1,0
  51. #WP,H
  52.  
  53. %
  54. #EF
  55. #T15,1,Working with the Renumbering Utility
  56.                       |RENUMBER|     |NUMAID|    |QCODE|
  57. #HH,1,5,80,1,1,0
  58. #R9
  59.  ▄█▀▀▀▀▀█▄ .∙
  60. ▐█▐─ô═ô─▌█▌∙.      ~W~ICAITeach~Y~I depends on the ~C~IQCode~Y~I much more than the
  61.  └┤    ┌┘ .∙
  62.   │█▀▀▀█│            the line number.
  63.   └┬███┬┘
  64. ▒▒▒▒ ■ ▒▒▒▒        The program, ~W~ICAITeach~Y~I, counts the questions based on sets
  65.                      of 16.  It never checks line one for a particular number.
  66.  
  67.     ~S~W~IThe Renumbering Utility is an editing aid that helps us keep the
  68. template lines in sets of 16, and it checks to make sure.~s~Y~I
  69.  
  70.     The Renumbering Utility reads line 1 of each template, and compares it
  71. with a calculated number.  If it does not find the calculated number it
  72. stops and displays an error message.
  73. #HH,1,24,80,1,1,0
  74. #HF,1,25,80,25,176,1,0
  75. #WP,H
  76.  
  77. %
  78. #EF
  79. #T15,1,Working with the Renumbering Utility
  80.                             |NUMAID|     |RENUMBER|
  81. #HH,1,5,80,1,1,0
  82. #R10
  83.  ▄█▀▀▀▀▀█▄ .∙      OK.  How do you run it?
  84. ▐█▐─ô═ô─▌█▌∙.
  85.  └┤   ┌┘ .∙       The renumbering utility is the file ~W~I{RENUM.EXE~Y~I.
  86.   │█▀▀▀█│            It is menu driven and contains two help screens.
  87.   └┬███┬┘
  88. ▒▒▒▒ ■ ▒▒▒▒        To run it enter: ~W~I{RENUM~Y~I.  Answer the prompt
  89.                      or abort.
  90.  
  91.     What I'll do is show you an error, and a success screen.  Be sure and read
  92. the ~C~IMerging Chapter~Y~I for information of ~C~Iinvisible lines~Y~I, and the two
  93. ~C~IHelp~Y~I screens when you run ~W~I{RENUM~Y~I the first time.
  94.  
  95.   Here's the way an error looks~F...~F
  96.  
  97. #HH,1,24,80,1,1,0
  98. #HF,1,25,80,25,176,1,0
  99. #WP,H
  100.  
  101. %
  102. #EF
  103. #T15,1,Working with the Renumbering Utility
  104.                          |NUMAID|          |RENUMBER|
  105. #HH,1,5,80,1,1,0
  106.  
  107.     ~W~I{RENUM~Y~I generated the following ~W~Ierror~Y~I message, commented below.
  108.  
  109.       ~C~I┌────────────────────────────────────────────────────────────────┐
  110.       │ ▓░░░▓  Error, no action taken with {DEMO.CHP          ▓░░░▓    │
  111.       │ ▓░E░▓  Examine Number Line of Question 1              ▓░E░▓    │
  112.       │ ▓░R░▓  Starts with a1                                 ▓░R░▓    │
  113.       │ ▓░R░▓  Should start with 1                            ▓░R░▓    │
  114.       │ ▓░░░▓  Correct in Editor and return.                  ▓░░░▓    │
  115.       └────────────────────────────────────────────────────────────────┘~Y~I
  116.  
  117.         1. I entered ~W~I{RENUM~Y~I, and answered the prompt with ~W~I{DEMO.CHP~Y~I,
  118.            the name of the file to be renumbered.  Then, I got the error.
  119.         2. The error message tells me that ~W~I{RENUM~Y~I did nothing because
  120.            it found ~C~Ia1~Y~I at the start of question 1, and it expected
  121.            to find ~C~I1~Y~I there.
  122.         3. It advises me to correct the error by replacing ~C~Ia1~Y~I with ~C~I1~Y~I.
  123.  
  124.         ~W~INext, a success story~F...~F~Y~I
  125.  
  126. #HH,1,24,80,1,1,0
  127. #HF,1,25,80,25,176,1,0
  128. #WP,H
  129.  
  130.  
  131. %
  132. #EF
  133. #T15,1,Working with the Renumbering Utility
  134.                             |NUMAID|     |RENUMBER|
  135. #HH,1,5,80,1,1,0
  136. #R8
  137.     ~W~I{RENUM~Y~I generated the following ~W~Isuccess~Y~I message, commented below.
  138.  
  139.       ~C~I┌───────────────────────────────────────────────────────────────┐
  140.       │ ░░░░░░  No problems detected with {DEMO.CHP           ░░░░░░  │
  141.       │ ░ OK ░  Your old file was copied to RENUM.$$$.        ░ OK ░  │
  142.       │ ░αααα░  Questions in file: 21                         ░αααα░  │
  143.       │ ░αααα░  RENUM.$$$ is erased each time CAIRenum runs.  ░αααα░  │
  144.       │ ░αααα░  Checks/Renumbers in CAI Format.  See Manual.  ░αααα░  │
  145.       │ ░░░░░░  {LINE is a precheck for CAITeach - Pro users. ░░░░░░  │
  146.       │                                                               │
  147.       │ Normal exit to DOS                                            │
  148.       └───────────────────────────────────────────────────────────────┘~Y~I
  149.  
  150.     ~W~I{RENUM~Y~I renumbered 21 questions, wrote the old file to ~W~I{RENUM.$$$~Y~I.  The
  151.     reference to ~W~I{LINE~Y~I is a utility available with ~W~ICAITeach - Pro~Y~I.
  152.  
  153. #HH,1,24,80,1,1,0
  154. #HF,1,25,80,25,176,1,0
  155. #WP,H
  156.  
  157.  
  158. %
  159. #EF
  160. #T15,1,Working with the Renumbering Utility
  161. |JUMP START|    |NUMAID|     |RENUMBER|     |ABOUT|
  162. #HH,1,5,80,1,1,0
  163. #R8
  164.  
  165.  ▄█▀▀▀▀▀█▄ .∙      Other messages, such as ~C~INo file found~Y~I, are
  166. ▐█▐─ô═ô─▌█▌∙.        trapped.  ~C~I~FKnow~F you can handle that~Y~I.
  167.  └┤    ┌┘ .∙
  168.   │█▀▀▀█│          Certainly recommend you read both Help Screens.
  169.   └┬███┬┘
  170. ▒▒▒▒ ■ ▒▒▒▒        This concludes my discussion on the ~C~IRenumbering Utility~Y~I.
  171.                      Obviously, not perfect but it traps many errors.
  172.  
  173.                    But it's simple to run, and has its ~C~IHelp~Y~I.
  174. #HH,1,24,80,1,1,0
  175. #HF,1,25,80,25,176,1,0
  176. #WP,H
  177. #X
  178.