home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 40 / q40.d81 / t.remarkable < prev    next >
Text File  |  2022-08-28  |  7KB  |  132 lines
  1.  
  2.  
  3.                             REMARKABLE DIRECTORY
  4.  
  5.                       Program and Text by David Zammat
  6.  
  7.     This C-128 program provides disk directory listings with remarks for
  8. each filename in the directory. It helps you avoid hunting around for paper
  9. notes explaining what is on the disks and stores all the commented
  10. directories on one master disk called "dirmaster". The program will work on
  11. any drive, numbered 8 through 30, and supports CMD native mode
  12. directories.
  13.  
  14.     To run Remarkable Directory (RD), first format a disk with the name
  15. "dirmaster" and copy the files REMARKABLE, CONTROL80, RDFONT, and EDSCREEN
  16. to it. Then insert the disk in an active drive and run REMARKABLE using
  17. your 80 column monitor. Because of the nature of this utility, it does not
  18. return to LOADSTAR. A function key menu appears showing several options.
  19.  
  20.  
  21.  CREATING A REMARKABLE DIRECTORY FILE
  22.  ------------------------------------
  23.  
  24.     The first option to use is the creation of a RD file for a disk, or the
  25. updating of a previously created RD file for the disk. The disk can be
  26. "dirmaster" as well as any other disk. Insert the disk in the drive and
  27. press F2. Follow the instructions on the screen. The disk directory is read
  28. and displayed in four columns; a maximum of 87 filenames, plus a "Blocks
  29. free" line, are shown. The program can read up to 200 filenames but only
  30. the first 87 are displayed.
  31.  
  32.     You are then asked to place the "dirmaster" disk in the drive. If no
  33. previous RD file exists for the disk to be commented, a new RD file for the
  34. disk is created and stored on the "dirmaster" disk. If a RD file already
  35. exists, it is updated to correspond with the current directory of the disk
  36. being analyzed.
  37.  
  38.     The RD file for a disk named "diskname" will have the name
  39. "rd-diskname", truncated to 16 characters if needed.
  40.  
  41.     If the RD file is newly created, it will include a field for the disk
  42. name, a field for each filename on the disk followed by a remarks field
  43. containing the text "New Directory", and a field for "Blocks free".
  44.  
  45.     If the RD file is an update of a previously created file, it will have
  46. a field for the disk name, a field for each current filename followed by a
  47. field for remarks, and a field for "Blocks free". If a new file was saved
  48. on the disk, it will be added to the RD file with the remark "New file". If
  49. a file was deleted, it will be removed from the RD file. If a filename is
  50. the same as in the previous RD file, it will have the same remarks, except
  51. that if the previous remark was "New Directory" or "New file" the new
  52. remark will be "Archived file".
  53.  
  54.     When the RD file is constructed, an edit screen is shown and then the
  55. RD file is saved on  the "dirmaster" disk. The screen shows scrolling
  56. windows listing the filenames in the RD file and the remarks text for each
  57. filename. The windows are scrolled by the UP or DOWN cursor keys on the top
  58. row or bottom row of the keyboard. You can now edit the remarks for each
  59. filename. Select a filename by scrolling until the arrow points to the
  60. filename in the window at the top of the screen. The filename and its
  61. remarks will appear in the center window of the three windows at the bottom
  62. of the screen.  Press E and the remark will appear within quote marks and a
  63. question mark will appear at the beginning of the line.
  64.  
  65.     This question mark is from a BASIC Input statement. Type your remark
  66. following the first quote mark and (optionally) end it with a quote mark.
  67. Do not enter any other quote marks. You can include print control
  68. characters such as reversed/normal, text color, and character set, just as
  69. if the text between the quote marks were to be printed on the screen by a
  70. BASIC Print statement. (Do not use cursor up, cursor down, home, or clear
  71. characters.) To enter a control character, enter insert mode by inserting a
  72. space (type shift-INST) where the control character is to go, then type the
  73. control character. The text can be up to 156 characters (nearly two screen
  74. lines) in length. When you are at the end of the first screen line of text,
  75. do not go to the second line by pressing the CRSR RIGHT key; press a
  76. different character key or the SPACE BAR. When you have finished entering
  77. your remarks, input the text by pressing RETURN. The quote marks will
  78. disappear and the text will be displayed according to the print control
  79. characters. This is how the remarks will appear when the RD file is
  80. listed.
  81.  
  82.     Now edit the remarks for any other filenames you choose. Be sure to
  83. press RETURN when done with each filename. Press U and the RD file with the
  84. edited remarks will be saved on the disk, which should be the "dirmaster"
  85. disk. If you wish, you can save the RD file on another disk by inserting
  86. the disk in the drive and pressing U again.
  87.  
  88.     When one or more RD files are saved on the "dirmaster" disk, a RD file
  89. for the "dirmaster" disk itself can be made by placing it in the drive and
  90. pressing F2. This RD file will be named "rd-dirmaster" and will contain
  91. names of RD files for disks whose RD files were saved on "dirmaster". I
  92. hope that's clear. For each RD filename you can edit a remark that explains
  93. what is on the source disk.
  94.  
  95.     Press Q to return from the edit screen to the menu screen.
  96.  
  97.  
  98.  LISTING A REMARKABLE DIRECTORY FILE
  99.  -----------------------------------
  100.  
  101.     To display a RD file, place a disk containing one or more RD files in
  102. the drive and press F3. A disk directory will be shown that is unusual in
  103. that the filetypes do not appear. This is convenient if a file is going to
  104. be loaded or run (in which case F3 will not be properly functional if its
  105. definition is changed). Also, a colon is inserted at the beginning of each
  106. directory line. This will prevent accidental corruption of the program in
  107. case the RETURN key is pressed while the cursor is on a directory line. A
  108. "syntax error" will be generated instead. To continue, just press F3 again.
  109. The listing and/or scrolling can be stopped at any time by pressing
  110. RUN/STOP.
  111.  
  112.     Now select a RD file (its filename begins with "rd-") by placing the
  113. cursor on its directory line, and press F1. The RD file will be listed,
  114. showing the disk name, each filename in the RD file, the remarks for the
  115. filename, and the blocks free line. The listing pauses at each line to
  116. allow reading the text. The pause can be controlled by the NO-SCROLL key
  117. (or CTRL if the computer has JiffyDOS). The listing will be stopped by the
  118. RUN/STOP key, and you will then be given a choice of repeating the listing
  119. or returning to the menu screen.
  120.  
  121.  
  122.  LISTING ALL REMARKABLE DIRECTORY FILES ON A DISK
  123.  ------------------------------------------------
  124.  
  125.     To list all the RD files on the "dirmaster" or other disk, place the
  126. disk in the drive and press F5. All the RD files on the disk will be
  127. listed, one after the other. The listing runs as described in the previous
  128. paragraph.
  129.  
  130.                  \\\\\ R - Run    RETURN - Menu \\\\\
  131.                                                                            
  132.