home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT143.ZIP / DLOG.DOC next >
Text File  |  1990-08-31  |  15KB  |  388 lines
  1. Diskalog - Version 2.0                                                 Page 1
  2. ------------------------------------------------------------------------------
  3.  
  4.  
  5.  
  6.                                  DISKALOG
  7.  
  8.                                 Version 2.0
  9.  
  10.  
  11.  
  12.  
  13. Purpose:
  14.  
  15.     DISKALOG is a tool that allows the user to add descriptions and comments
  16. (up to forty characters in length) to each file name (including directories)
  17. on a disk.
  18.  
  19.     For instance, in DOS, the "DIR" command will result in the following
  20. directory listing:
  21.  
  22.  
  23.                    Volume in drive B is EXAMPLES
  24.                    Directory of B:\
  25.  
  26.                    BROWN_R  EST   1725  5-23-86   2:30p
  27.                    COMMAND  COM  23612  3-21-86  12:03p
  28.                    TELCOM   COM   1523 12-23-86  11:34p
  29.                    CHECKIT  EXE   9680  3-01-86  10:21p
  30.                    PCSTRING $$$   8234  4-11-86  12:00p
  31.                    BCKUP    EXE  23404  7-07-86   5:27p
  32.                    A_ARCER  COM   1651  4-20-86  12:02p
  33.                           7 file(s)  245323 bytes free
  34.  
  35.  
  36.     Not bad for DOS' DIR command.  But if you don't have an excellent
  37. memory, how do you keep track of what each file does?  Or what are the
  38. contents of each file?  This is where DISKALOG can help.
  39.  
  40.     For instance, the above directory listing after being DISKALOGed can
  41. become this...
  42.  
  43.   DISKALOG 2.0        Bytes free: 245,323   Total: 362,496   Files: 7
  44.   Date: 05-14-1990    Directory: B:\*.*
  45.  
  46. A_ARCER .COM   1651  4-20-86  12:02   Archives and compresses any size file
  47. BCKUP   .EXE  23404  7-07-86  17:27   Backs up one or more files
  48. BROWN_R .EST   1725  5-23-86  14:30   Cost estimate quoted to Richard Brown
  49. CHECKIT .EXE   9680  3-01-86  10:21   Scans the disk and checks for errors
  50. COMMAND .COM  23612  3-21-86  12:03   Starts the DOS command processor
  51. PCSTRING.$$$   8234  4-11-86  12:00   Spill file created during error
  52. TELCOM  .COM   1523 12-23-86  11:34   Telecommunications file transfer
  53.  
  54.                                       |___________________________________|
  55.                                                         |
  56.                                              User added descriptions
  57.  
  58.  
  59. Diskalog - Version 2.0                                                 Page 2
  60. ------------------------------------------------------------------------------
  61.  
  62.  
  63. Requirements:
  64.  
  65.     DISKALOG will run on IBM PC's (and true compatibles) using DOS 2.0 and
  66. above.
  67.  
  68.  
  69.  
  70. To begin:
  71.  
  72.     At the DOS prompt, type ---> DLOG   then press <ENTER/RETURN>
  73.  
  74.     The above command will load DISKALOG and will instruct the program
  75. to read the default drive.  If the user wishes to load DISKALOG but
  76. read a directory other than the one on the default drive, then add the
  77. pathname after "DLOG", for example ---> DLOG B:  <ENTER>, or
  78. ---> DLOG C:\DOS  <ENTER>, or ---> DLOG A:\BASIC\  <ENTER>.
  79.  
  80.  
  81.     With a DISK.LOG file on the screen you can begin adding your
  82. descriptions and notes to each file listing.  Simply type your comments
  83. within the highlighted bar area, and press <RETURN> when you wish to go
  84. on to the next comment.
  85.  
  86.  
  87. Cursor movement within a DISK.LOG file:
  88.  
  89.     When a DISK.LOG file has been displayed you can move the highlighted
  90. marker bar in the following ways:
  91.  
  92.     UP ARROW: Moves the highlighted bar up one position.  If at the top of
  93. the page, the marker bar moves to the bottom of the page.
  94.  
  95.     DOWN ARROW: Moves the highlighted bar down one position.  If at the
  96. bottom of the page, the marker bar moves to the top of the page.
  97.  
  98.     PAGE UP: If the bar is not at the top of the list, then <PG UP> will bring
  99. the bar up to the top of the page.  If the bar was already at the top of
  100. the page, then <PG UP> will display the previous page (if one exists).  There
  101. are twenty listings capable of being displayed on each "page".
  102.  
  103.     PAGE DOWN: If the bar is not at the bottom of the page, then <PG DN> will
  104. bring the bar down to the bottom of the page.  If the bar was already at
  105. the bottom of the page, then <PG DN> will display the next page (if one
  106. exists).
  107.  
  108.    CTRL + PAGE UP: Will move the marker bar to the very first page.
  109.  
  110.    CTRL + PAGE DOWN: Will move the marker bar to the last page.
  111.  
  112.  
  113. Diskalog - Version 2.0                                                 Page 3
  114. ------------------------------------------------------------------------------
  115.  
  116.  
  117. Entering descriptions, comments, notes:
  118.  
  119.     As previously noted, to add a description to any file listing simply
  120. begin typing text while the highlighted marker bar is next to the listing
  121. you wish to add a comment to.  As you type, your note will be displayed
  122. within the highlighted bar.
  123.  
  124.     While in this highlighted area, the <LEFT ARROW>, <RIGHT ARROW>,
  125. <DEL>, <INS>, <BACKSPACE> keys will be available for editing your work.
  126. <CTRL+END> will erase/clear the current description from the cursor position
  127. to the end of the line.  <CTRL+HOME> will undo a <CTRL+END> deletion.
  128. <CTRL+LEFT ARROW> and <CTRL+RIGHT ARROW> will move the cursor to the next
  129. word (left and right respectively).
  130.  
  131.     When you have completed your description, then press <ENTER/RETURN>.
  132. This will tell DISKALOG that you are done with that particular description
  133. and are ready to continue.  The highlighted bar will then advance on to
  134. the next file/line.
  135.  
  136.  
  137. Shell:
  138.  
  139.     If you wish to leave DISKALOG temporarily, press <ALT+S> for shell
  140. to DOS.  <ALT+S> will permit the user to shell out to DOS (if the
  141. COMMAND.COM file is in your search path - else copy COMMAND.COM from
  142. your DOS disk to the drive/disk where DLOG.EXE is located).  To return
  143. to DISKALOG, enter "EXIT" at the DOS prompt.  You will then reenter
  144. DISKALOG where you left off.
  145.  
  146.     Besides access to an operating "shell" through <ALT+S>, six other
  147. "shell" functions are available.
  148.  
  149.   <ALT+B> - Will run the utility program "BROWSE"* with the highlighted file.
  150.  
  151.   <ALT+D> - Will delete the highlighted file and remove it from the list.
  152.  
  153.   <ALT+L> - Will run the utility program "LIST"* with the highlighted file.
  154.  
  155.   <ALT+N> - Will prompt for a new file name to rename the existing file by,
  156.             then will update list.
  157.  
  158.   <ALT+R> - Will run the .EXE or .COM file that is currently highlighted.
  159.  
  160.   <ALT+T> - Will perform a DOS "TYPE" command with the highlighted file.
  161.             (This is only useful if the file to view is a text file.)
  162.  
  163.   * These programs are available from most shareware/public domain
  164. distributors and are not a part of the DISKALOG package.   They are well
  165. worth obtaining, nonetheless.
  166.  
  167.  
  168. Diskalog - Version 2.0                                                 Page 4
  169. ------------------------------------------------------------------------------
  170.  
  171.  
  172. Main Menu:
  173.  
  174.     Access to the Main Menu is available by pressing <ESC>.  The the bottom
  175. line of the screen will then display five options:
  176.  
  177.        N - New file (cancel the current DISK.LOG file on the screen and
  178.            begin a new one)
  179.  
  180.        P - Print file (print the complete current DISK.LOG file)
  181.  
  182.        R - Return (return to viewing/editing the current DISK.LOG file)
  183.  
  184.        S - Save file (save the complete current DISK.LOG file)
  185.  
  186.        ESC - Exit/Quit (terminate DISKALOG and return to DOS)
  187.  
  188.  
  189.    IMPORTANT NOTE: The entries/descriptions that the user adds will NOT be
  190. saved unless the user selects "S" from the Main Menu line.  DISKALOG does
  191. NOT automatically save your work!  The user must initiate a "S"ave!
  192.  
  193.  
  194. Printer options:
  195.  
  196.     If your printer is capable of printing in a condensed mode (15 or more
  197. characters per inch) you might be interested in creating a .PTR file.
  198. Or if you are using a printer port besides "LPT1:" creating a .PTR file will
  199. be necessary in order to perform printer operations.
  200.  
  201.     Before DISKALOG peforms its first print job it looks on the default
  202. drive/directory for a file named "DLOG.PTR".  If "DLOG.PTR" exists, then
  203. DISKALOG will load it and use its data to perform subsequent print jobs.
  204. "DLOG.PTR" can be created in a number of ways.  Any line editor will work
  205. (see your DOS disk for EDLIN) or see examples of COPY CON DLOG.PTR below.
  206.  
  207.     Although one can externally set many printers for a condensed character
  208. pitch, there is a benefit in creating a "DLOG.PTR" file.  Besides not
  209. having to remember to set your printer pitch each time, if a "DLOG.PTR" file
  210. exists DISKALOG will create a printout in a handy 5" by 5" (approx.) format
  211. with (cut along dashed line) borders.  This printout format is only available
  212. IF a "DLOG.PTR" file exists and the proper printer parameter codes have been
  213. entered into it!
  214.  
  215.     DISKALOG, if it finds a "DLOG.PTR" file, expects it to be in the following
  216. sequential format...
  217.  
  218. Printer port
  219. Escape code number
  220. Escape code number
  221. Escape code number
  222.   "     "     "
  223.   "     "     "
  224.   "     "     "
  225. Escape code number
  226. EOF marker
  227.  
  228.  
  229. Diskalog - Version 2.0                                                 Page 5
  230. ------------------------------------------------------------------------------
  231.  
  232.  
  233.     The easiest way to create such a "DLOG.PTR" file is the following.  At the
  234. DOS prompt, type the following...
  235.  
  236. COPY CON DLOG.PTR     <press ENTER>
  237. LPT1:                 <press ENTER>
  238. 15                    <press ENTER>
  239.                       <press F6>
  240.                       <press ENTER>
  241.  
  242.     Valid printer ports are LPT1: LPT2: COM1: COM2: (don't forget the
  243. colon).  It will be necessary when entering printer escape codes to have your
  244. printer manual at hand.  Enter only the ASCII value after the escape code
  245. Chr$(27) or ESC.  For instance, a Hewlett Packard Deskjet Plus printer must
  246. receive the following escape code to print in condensed type:
  247.  
  248.                     ESC (s16.67H
  249.  
  250.     In order to create the correct "DLOG.PTR" file for the HP Deskjet + you
  251. must enter each character following the ESC with its corresponding ASCII value.
  252.  
  253.                                    ESC (  s  1  6  .  6  7  H
  254.  
  255. COPY CON DLOG.PTR     <press ENTER>    |  |  |  |  |  |  |  |
  256. LPT1:                 <press ENTER>    |  |  |  |  |  |  |  |
  257. 40                    <press ENTER> ---/  |  |  |  |  |  |  |
  258. 115                   <press ENTER> ------/  |  |  |  |  |  |
  259. 49                    <press ENTER> ---------/  |  |  |  |  |
  260. 54                    <press ENTER> ------------/  |  |  |  |
  261. 46                    <press ENTER> ---------------/  |  |  |
  262. 54                    <press ENTER> ------------------/  |  |
  263. 55                    <press ENTER> ---------------------/  |
  264. 72                    <press ENTER> ------------------------/
  265.                       <press F6>
  266.                       <press ENTER>
  267.  
  268.     Here's another example.  If your printer manual says that ESC Chr$(15)
  269. must be sent to the printer to enable condensed print, then the appropriate
  270. "DLOG.PTR" file would be created thusly...
  271.  
  272. COPY CON DLOG.PTR     <press ENTER>
  273. LPT1:                 <press ENTER>
  274. 15                    <press ENTER>
  275.                       <press F6>
  276.                       <press ENTER>
  277.  
  278.     If you have problems creating a "DLOG.PTR" file, contact the program
  279. author with a self-addressed stamped envelope and a copy of your printer
  280. manual's printer codes.
  281.  
  282.  
  283. Diskalog - Version 2.0                                                 Page 6
  284. ------------------------------------------------------------------------------
  285.  
  286.  
  287. Shareware concept:
  288.  
  289.     DISKALOG is being distributed under the shareware concept.  DISKALOG is
  290. not free software.  The user is permitted a trial period in which to evaluate
  291. this program.  If you find DISKALOG of use, then you are asked to register
  292. your copy.  Registration is $5.00.  Registration entitles the user to the
  293. latest copy of DISKALOG.  (Note: Registered copies do not have the
  294. registration reminder at the end of the program or on the printouts).
  295.  
  296.  
  297. Distribution guidelines:
  298.  
  299.     Whether you decide DISKALOG is useful or not, you are free to distribute
  300. DISKALOG as long as you abide to all of the following guidelines:
  301.  
  302.   1) DISKALOG (DLOG.EXE) must be distributed unaltered.
  303.  
  304.   2) Distribution of DLOG.DOC (this text file) must accompany each copy
  305.      of the program.
  306.  
  307.   3) You may not sell DISKALOG.
  308.  
  309.   4) Shareware/Public domain libraries are permitted reimbursement for
  310.      their services, (not to exceed $5.00 for a 5.25" format).
  311.  
  312.   5) Shareware/Public domain distributors of "X-rated/Adult" software are
  313.      denied permission to distribute DISKALOG.
  314.  
  315.  
  316. Disclaimer:
  317.  
  318.     DISKALOG is provided to the user on an "as is" basis without warranty of
  319. any kind, expressed or implied.  The program author will not be liable for any
  320. direct, indirect, incidental or consequental damages resulting from the use
  321. of this program.  Your use of this program constitutes your agreement to this
  322. disclaimer and your release of the author from any form of liability or
  323. litigation.
  324.  
  325.  
  326. Diskalog - Version 2.0                                                 Page 7
  327. ------------------------------------------------------------------------------
  328.  
  329.  
  330.                            DISKALOG REGISTRATION:
  331.  
  332.  
  333.  
  334.  
  335.       I am enclosing $5.00 in order to register my copy of DISKALOG.
  336.         I understand that this registration fee entitles me to use
  337.                 DISKALOG, and that I will be sent the latest
  338.                   version in 5.25" 360K format. *(See note)
  339.  
  340.  
  341.  
  342.        Name __________________________________________________________
  343.  
  344.        Address _______________________________________________________
  345.  
  346.        City ______________________ State _______ Zip Code ____________
  347.  
  348.  
  349.  
  350.  
  351.                      I obtained my copy of DISKALOG 2.0
  352.                           from the following source:
  353.  
  354.  
  355.        Shareware distributor (name and address): _____________________
  356.  
  357.        _______________________________________________________________
  358.  
  359.        Bulletin board: _____________________  Other: _________________
  360.  
  361.  
  362.  
  363.                Suggestions as to how to make DISKALOG better:
  364.  
  365.        _______________________________________________________________
  366.  
  367.        _______________________________________________________________
  368.  
  369.        _______________________________________________________________
  370.  
  371.        _______________________________________________________________
  372.  
  373.        _______________________________________________________________
  374.  
  375.  
  376.  
  377.                         Please make funds payable to:
  378.  
  379.                               Philip P. Kapusta
  380.                                 P.O. Box 5423
  381.                              Falmouth, Va. 22403
  382.                                     U.S.A.
  383.  
  384.                                 (SAV18703EON)
  385.  
  386.           *Note: Registered copies are personalized and do not have
  387.                       registration reminders or delays.
  388.