home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / masdir43.lzh / SDLSETUP.DOC < prev    next >
Text File  |  1989-05-17  |  10KB  |  225 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      * * *
  8.      SDLSETUP.BAT - DOCUMENTATION - Copyright(c) 1987,88,89 Bob Stephan
  9.      * * *
  10.      You will be able to browse through the SDLSETUP documentation
  11.      at your own pace.  Just use the keys on the cursor pad to turn
  12.      the pages as you read.  Note the reminder at the top of the
  13.      screen, and remember that you can exit at any time by pressing
  14.      Esc.
  15.      * * *
  16.      SDLSETUP will not modify any of your original files.  Only
  17.      SDL.COM will be affected.  In particular, your CONFIG.SYS and
  18.      AUTOEXEC.BAT will not be touched.
  19.  
  20.  
  21.     (Press the PgDn key to continue)
  22.  
  23.  
  24.  
  25. Documentation for SDLSETUP.BAT for SDL Version 4.3, April 1989
  26. Copyright(c) 1987, 1988, 1989 Bob Stephan
  27.  
  28. SDLSETUP is a handy program to customize many of the options of
  29. SDL, the Sorted Directory and disk Label printing program.  It requires
  30. only that you answer a series of questions with single keystroke
  31. responses and, if desired, input new titles to appear in the top 2 lines
  32. of the display.
  33.  
  34. To run SDLSETUP establish a working disk or directory (a RAM disk will
  35. be fastest, a directory on a hard disk next, and a floppy can be
  36. quite slow).  Enter the following command to copy the necessary
  37. files from the MASDIR diskette to your working area.  Assume that the
  38. MASDIR diskette is in drive B: and the working area is the current
  39. directory on drive C:.  Then just enter
  40.  
  41.     COPY B:SDL*.* C:
  42.  
  43. You can add the path after C: if you so desire, or just issue this
  44. command after changing to the working disk or directory.  You can use
  45. MAKEWORK to help you do this if you like.  Enter MAKEWORK at the DOS prompt.
  46.  
  47. All of the questions in SDLSETUP are self-explanatory and should cause
  48. no confusion.  A few of them are explained in a little more detail
  49. here.  If you have any questions, read on, and then if you still have
  50. questions after running SDLSETUP please contact me.
  51. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  52. SDLSETUP
  53. * * *
  54. MESSAGE: Checking system resources. Please wait.
  55.  
  56. At this point SDLSETUP is looking for the DOS DEBUG external
  57. command.  If it is not found you will see the message "Bad command
  58. or file name".  This will be followed by a beep and the following:
  59. * * *
  60. The message "Bad command or file name" that you just saw means
  61. that a system file is not available to SDLSETUP.
  62. This program requires access to the DOS external command file
  63. DEBUG.COM.  It must be in this directory on this disk or in
  64. one of the directories on your path, which is
  65. PATH=              (REM: your current path will be displayed here).
  66. Please correct the problem and run SDLSETUP again.
  67.  
  68. (REM: This will be followed by an exit back to DOS for corrective action.
  69.       But if DEBUG is found, SDLSETUP will check for the presence of other
  70.       files.  Depending on what is found you may see some of the following
  71.       messages.  If you don't see them, then all is well.)
  72.  
  73. (REM: One user reported a problem during this portion of the setup
  74.       program, and it turned out that he was running a RAM resident
  75.       program named DOSEDIT.  This appeared to interfere with the
  76.       redirected input to DEBUG.  The solution was just to boot the
  77.       computer without DOSEDIT temporarily while running SDLSETUP.)
  78.  
  79. Next the presence of required files will be verified. If any needed files
  80. are not present, you will see ...
  81. * * *
  82. The following files must be in this current directory on this disk:
  83. SDL.COM
  84. SDL_GET.EXE
  85. SDLTITLE.COM         (REM: Except for the shareware version)
  86. SDLSETUP.BAT
  87. SDLPARMS.BAT
  88. SDLNOTOG.BAT
  89. SDLFINIS.BAT
  90. SDLDEBUG.BAT
  91.  
  92. Next the DOS version will be checked.  If it is found to be
  93.       version 2.x you will see the following message.  Please see
  94.       the note at the end of this DOC file.
  95.  
  96. * * *
  97. If you have any difficulty running SDLSETUP under DOS 2.x,
  98. please see SDLSETUP.DOC.
  99. * * *
  100. Setting the More or Pause default...
  101.  
  102. Pausing refers to both intermediate pauses if the directory is
  103. more than one page (screen), and the pause at the end to allow
  104. you to select a new option.  This is merely personal preference, but
  105. pausing is a good idea, and it allows you to select new options.
  106.  
  107. * * *
  108. Setting the Hdr default...
  109.  
  110. The first two lines of the header contain my copyright notice
  111. and the reminder line, as well as the volume label.  If you use
  112. SDL mostly for directories on the your hard disk drive, you may
  113. have no need for the first two lines as a rule.   This permits 2
  114. more rows of files to be shown on the screen.  The directory
  115. name will still be shown, and you can restore the title lines
  116. for any display with the /H option. Later during SDLSETUP you will be
  117. given the opportunity to change the default titles in these two lines.
  118. * * *
  119. Additional defaults will be explained and prompted for.  They should be
  120. self-explanatory, but if you have any questions see the rest of the
  121. MASDIR documentation.
  122. * * *
  123. Setting the sleeve Insert eject default...
  124.  
  125. A half page saves paper if you print many Inserts.  Then if you
  126. print an even number of inserts your TOF setting will not be changed,
  127. but if you print an odd number your printer will be left at the middle
  128. of a page.  If you prefer to always use a full page for a sleeve Insert,
  129. you can set that here.
  130.  
  131. * * *
  132. Installing your own default title lines...
  133.  
  134. If you answer N you are finished, and SDLSETUP will call DEBUG
  135. to make the changes you have requested.  If you answer Y,
  136. another program, SDLTITLE.COM, will be called to ask you for the
  137. titles you want.  The first line title can be 44 characters long
  138. and the second line can be 79 characters long.  If you want to
  139. change only one, just press ENTER for the other.  Whenever you
  140. just press ENTER, the original title will be used.  If you want
  141. to blank out a title completely, just enter one or more spaces.
  142. If you want to have your own titles on the first two lines you will
  143. have to enter them both even though you may just be changing one of
  144. them from a previous setting.
  145.  
  146. To restore the original titles, simply press ENTER at each prompt.
  147. Setting your own titles or restoring the original titles
  148. eliminates the highlighting of the key characters in the reminder
  149. line and allows all lines of the directory display to be redirected
  150. to a file if desired.
  151.  
  152. After the titles the program will run to completion.  The only problem
  153. that can arise is no access to DEBUG.  In that case you will see the
  154. following message.
  155.  
  156. Bad command or file name
  157. Using the DOS DEBUG command appears to have failed!
  158. You may not have a path to DEBUG.  Please check the
  159. directories on your path for the existence of DEBUG.COM.
  160. If you can establish a path to DEBUG or copy DEBUG.COM
  161. to this working area, you can install the changes you
  162. have made by entering SDLDEBUG.
  163.  
  164. If you see this message, please make DEBUG available from
  165. your version of DOS and run SDLSETUP again.  In fact, if you have
  166. gotten this far you can take a short cut and run SDLDEBUG after you
  167. have made DEBUG available.  That will finish up the changes.
  168.  
  169. (CAUTION: Do NOT run SDLDEBUG if there has been any other error
  170. or interruption.  In that case it is safer to start over again,
  171. but see the NOTE below.  SDLDEBUG uses redirection and if the
  172. input file SDLSETUP.TXT has not been completed, it can cause a
  173. hangup that will require a reboot.)
  174.  
  175. If everything completed normally you will see the message...
  176.  
  177. SDL.COM has been modified.
  178. Don't forget to COPY your new version of SDL.COM
  179. to the disk and/or directory with your other DOS
  180. commands and utilities.
  181. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  182. That's all there is to it, so enjoy using SDL with your own configuration.
  183.  
  184. SDLSETUP creates two working files named SDLSETUP.TXT and
  185. SDLTITLE.TXT.  These files will be erased when SDLSETUP is
  186. finished with its work.
  187.  
  188. NOTE:  I have run into an occasional problem running SDLSETUP
  189. under DOS 2.1.  Generally it works fine, and I can detect no
  190. problems under DOS 3 or later, but if you see either of the
  191. messages "EXEC failure" or "File creation error" please let
  192. me know.  You might try increasing the "FILES=" value in your
  193. CONFIG.SYS file and reboot.  A remote possibility is that the
  194. directory is full, so you might try running it on a different
  195. drive or in a different directory.  You can also run CHKDSK to
  196. see if there are any other conditions that might cause the error.
  197. This seems to be caused by a problem with DOS 2.1 in the number
  198. of open files it thinks it has.  One method that some have used
  199. successfully to work around this is to make only one or two changes
  200. to the defaults on each invocation of SDLSETUP.  If this works, you
  201. will have to reboot your computer before you can run SDLSETUP again.
  202. This may be tedious, but it is one way to use SDLSETUP with DOS 2.1.
  203. Be sure to use the Esc key to skip the sections in which you are
  204. not making changes.
  205.  
  206. This problem is apparently caused by a bug or deficiency in DOS
  207. 2.1, but I have included another work-around for it.  If you see
  208. either of the above messages, AND if SDLSETUP has finished all
  209. of its questions through the ones about changing the titles, then
  210. reboot with Ctrl-Alt-Del and get back to the drive and directory
  211. in which you were running SDLSETUP.  (If you are working on a RAM
  212. disk, copy your work to a permanent disk first.) One or two of the
  213. .TXT files named above should be in that directory (2 if you changed
  214. titles, otherwise only the first one).  If you see SDLSETUP.TXT
  215. you can run SDLDEBUG, the last batch file in the series.  This
  216. should install your changes and clean up after itself.
  217. See the CAUTION above about other types of problems.  I apologize
  218. for any inconvenience, but it is a problem beyond my control.
  219.  
  220. As a last resort, run SDLSETUP on a machine that is running
  221. DOS 3.0 or later.  Then copy the resulting SDL.COM to your
  222. machine.  Good luck!
  223.  
  224.         Now, if you want to exit, remember to press Esc.
  225.