home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 126-150 / scopedisk128 / m2du522 / du.tutor < prev    next >
Text File  |  1992-10-27  |  8KB  |  184 lines
  1. # THIS FILE WILL WORK AS A Du.hist file, but it is primarily
  2. # designed as a TUTORIAL. - Greg Browne 04/14/90
  3. #
  4. # Du.hist files have 3 types of lines.
  5. #
  6. #  1) COMMENTS
  7. #      Du.Hist files may have comments for clarification.  Comments are lines
  8. #      which start with either # or ; AND have a <SPACE> as second character.
  9. #
  10. ;      **********************************
  11. ;      STARTUP IS FASTER WITHOUT COMMENTS  <<<<<<<<<******
  12. ;      **********************************
  13. ;
  14. #
  15. #  2) "R" gadget 'history items.
  16. #      The FIRST 20 lines NOT starting with a # or ; sign are assumed by
  17. #      the program to be "R" gadget history items. (INCLUDING BLANK LINES).
  18. #
  19. #      THE "R" history is now 20 items long.
  20. #      A group of items is shown as an example below, AFTER the description
  21. #      of Replacement Commands.
  22. #
  23. #
  24. #  3) Replacement Commands
  25. #     IF the character DIRECTLY after the # or ; is one of the following,
  26. #     the balance of the line will be considered a possible command line.
  27. #     (These may also be changed in the program - see a discussion at the
  28. #     end of this file for how that works)
  29. #
  30. #     COMMANDS ARE:  S T P E A O R 0..8 B C Z L (case insensitive)
  31. #
  32. #     format: #Cwhatever it may be
  33. #              |  |
  34. #              |  actual command to be used. May be the entire line or
  35. #              |                                   part, as specified below.
  36. #              Character indicating which command
  37. #                 (spaces between the character and the command are removed)
  38. #
  39. #Sc:SuperShow
  40. #   (S)how program name - ENTIRE BALANCE OF LINE IS USED
  41. #   if no name given or no #S included, Du's puny internal show is used
  42. #   The internal routine is ALWAYS available by using the RIGHT mousebutton.
  43. #
  44. #Tc:ppmore
  45. #   (T)YPE/HTYPE external program name - ENTIRE BALANCE OF LINE IS USED
  46. #   if no name given or no #T included, Du's internal routines are used.
  47. #   The internal routines are ALWAYS available by using RIGHT mousebutton.
  48. #
  49. #Pc:sprint
  50. #   (P)RINT/HPRINT external program name - ENTIRE BALANCE OF LINE IS USED
  51. #   if no name given or no #P included, Du's internal routines are used
  52. #   The internal routines are ALWAYS available by using RIGHT mousebutton.
  53. #
  54. #e c:Emacs
  55. #   (E)ditor program name - ENTIRE BALANCE OF LINE IS USED
  56. #   if no name given or no #E included, Du chooses "dme" as editor.
  57. #   Note that all leading spaces on command names are stripped off, so this
  58. #   IS a valid line.
  59. #
  60. #Edme
  61. #   However I like "dme" so I'll put it back in place for now.  SEE HOW THE
  62. #   LATEST ITEM ALWAYS TAKES PRECEDENCE when the same command is used twice.
  63. #
  64. #Aram:
  65. #   (A)ccess directory on startup - ENTIRE BALANCE OF LINE IS USED
  66. #   This can be ANY valid path - just used ram: for less mess.
  67. #   if no name given or no #A included, Du chooses ram: from WB
  68. #   or the current directory from CLI. STARTUP ONLY!!
  69. #
  70. #ofile  VALID LINE - Changes Outname choice 3 from SER: to file
  71. #   (O)utput device alternate name. This replaces the "SER:" output device
  72. #   on the PRT:/PAR:/SER: gadget.
  73. #   Only 4 characters following "O" are used (AFTER removing leading spaces).
  74. #
  75. #Rrun
  76. #   (R)un command to use. ENTIRE BALANCE OF LINE IS USED.
  77. #   This replaces "run >nil: <nil:" for the DO gadget's last or only pass.
  78. #   NOTE THAT with 1.3 the default above REALLY discards as it is supposed
  79. #   to.  Somehow it still put output to CON: window before. If you want
  80. #   CON window output to be seen, use 'run <NIL:' or 'run' for this command.
  81. #
  82. #
  83. #  SPECIAL - DEVICE NAME Replacement [0..8]
  84. #   These will replace the device gadgets above the filewindow.
  85. #   Left to right  [df0 = 0  ram = 8]
  86. #   Again only 4 characters maximum are used.
  87. #   shorter devices MAY be used (such as c: or l:)
  88. #2  ff1:     THIS LINE IS VALID (leading spaces ALWAYS removed first)
  89. #6rad:       SO IS THIS         (remember only 4 characters are examined)
  90. # 6ff0:      THIS IS NOT        (there is a space BEFORE the 6)
  91. #
  92. #
  93. #   Finally, the miscellaneous commands
  94. #B
  95. #   (B)ottom half if interlaced screen. NO TRAILING LETTERS.
  96. #   Tells the program to relocate to the bottom half of the screen if it
  97. #   detects an interlaced screen when starting up.
  98. #
  99. #C
  100. #   (C)lose up window to start.  If this is found, the window will go
  101. #   immediately into the shrink mode on startup and sit at the top edge
  102. #   of the window (sorry, no optional positioning yet - but you can move
  103. #   it by dragging).
  104. #
  105. #Z  (allow siZing gadget)  Until I figure out how to automatically determine
  106. #   that a 3000 is in use, I must allow a way to include or exclude the
  107. #   sizing gadget (the 3000 puts a slider bar in the right area where I
  108. #   have gadgets.  To have your window allow sizing, include the #Z command.
  109. #
  110. #L  (start in inter"L"ace mode).  This starts the program on a custom
  111. #   interlaced screen with about 35 files per window.  Toggle on/off is
  112. #   available as RIGHT mouse on the "SIZES/DATES" toggle gadget.  THIS TAKES
  113. #   PRECEDENCE OVER THE #C command above if both are in a Du.hist file.
  114. #
  115. # =====================================================
  116. #
  117. # OTHER SECOND LETTERS are ignored
  118. # NOTE, HOWEVER, that the previous line COULD NOT leave the first space out
  119. # or the interpreter will see that line as an "O" command and replace the
  120. # "file" inserted above with "THER".
  121. ;
  122. ;
  123. # Now follow the real "R" gadget Items I use most.  They can be grouped
  124. # or interspersed with commands and comments and will be picked up properly.
  125. # The next line is blank on purpose - makes R-00 a blank item.
  126.  
  127. NewZap
  128. katz
  129. diskx x
  130. PPack
  131. ppmore
  132. mash
  133. mash -d
  134. SPref
  135. Pprefs
  136. execute
  137.  
  138.  
  139.  
  140. zoo a: {D}/DuZooFiles {S}/*
  141. lharc e
  142. lharc v
  143. lharc a
  144. zoo -e
  145. QS
  146.  
  147. #---------------------------- THE END ---------------------------------------
  148. # EVERYTHING past the 20th history item is IGNORED, so put your commands
  149. # earlier in the file. After it reads the 20th item (if there is one),
  150. # it closes the file and quits cold.  That means these lines will not even be
  151. # looked at by the program, since there are 20 lines of history above here.
  152. #----------------------------------------------------------------------------
  153. #                      WHERE TO PUT THIS FILE
  154. #
  155. # Du.hist will be looked for FIRST in current directory then in S: and the
  156. # first one found will be used. If neither found, the program will initialize
  157. # all histories as empty ("").  REMEMBER, a file in the current directory
  158. # will take presidence over s:Du.hist
  159. #----------------------------------------------------------------------------
  160. #                    REPLACING Du.hist AT STARTUP
  161. #
  162. #  If started from the CLI, you may add a single argument to the line, and
  163. #  the program will attempt to use it as a history file name.  If that file
  164. #  does not exist either in the current directory, or in S:, the program
  165. #  will NOT try to read any history file (i.e. it will NOT revert to Du.hist)
  166. ;
  167. ;
  168. ;      MISCELLANEOUS - READING A NEW Du.hist "ON-THE-FLY".
  169. ;
  170. ; ANY file can be read from within the program as a Du.hist file.
  171. ;   Put the name of the file in the "R" gadget WITHOUT A LEADING #, and click
  172. ;   the RIGHT mousebutton on the "R"  beside the gadget.  The file will be
  173. ;   read like Du.hist. Only as many "R" items as are in the new file will be
  174. ;   replaced. Any beyond that will be unchanged. Also, the #A command will
  175. ;   not be useful from this mode.
  176. ;
  177. #      MISCELLANEOUS - USING REPLACEMENT COMMANDS "ON-THE-FLY".
  178. #
  179. # YOU MAY CHANGE any of the # commands (except #A) from within the program).
  180. #   Put the complete command (including the # or ;) in the "R" gadget and
  181. #   click the RIGHT mousebutton on "R".  The program will read that line as
  182. #   though it were a command (easy change of Showname, Editor, Devices, etc).
  183. # EOF============================EOF
  184.