home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / DB / DB018.ZIP / DLOG.DOC next >
Text File  |  1991-03-14  |  17KB  |  414 lines
  1. Diskalog - Version 2.32                                                Page 1
  2. ------------------------------------------------------------------------------
  3.  
  4.  
  5.  
  6.                                  DISKALOG
  7.  
  8.                                Version 2.32
  9.  
  10.  
  11.  
  12.  
  13. Purpose:
  14.  
  15.     DISKALOG is a tool that allows the user to add descriptions and comments
  16. (up to sixty-seven characters in length) to each file name (including direc-
  17. tories) on a disk in a mini "shell" environment.
  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.32       Bytes free: 245,323   Total: 362,496   Files: 7
  44.   Date: 05-14-1990    Directory: B:\*.*                 Volume: MISC_DATA
  45.  
  46. A_ARCER .COM  1651 04/20/86 12:02 ..RA Archives and compresses any size file
  47. BCKUP   .EXE 23404 07/07/86 17:27 ..RA Backs up one or more files
  48. BROWN_R .EST  1725 05/23/86 14:30 H.RA Cost estimate quoted to Richard Brown
  49. CHECKIT .EXE  9680 03/01/86 10:21 ..R. Scans the disk and checks for errors
  50. COMMAND .COM 23612 03/21/86 12:03 ..RA Starts the DOS command processor
  51. PCSTRING.$$$  8234 04/11/86 12:00 H.R. 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. Diskalog - Version 2.32                                                Page 2
  59. ------------------------------------------------------------------------------
  60.  
  61.  
  62. Requirements/limitations:
  63.  
  64.     DISKALOG will run on IBM PC's (and true compatibles) using DOS 2.0 and
  65. above and a minimum 128K RAM.  The number of file listings that can be
  66. displayed depend upon several things.  250 file listings, each with a FULL
  67. 67 CHARACTER DESCRIPTION, is the approximate limit for the current version.
  68. If no user added descriptions have been added to any file listing, then the
  69. file listing limit is in the range of 500 files.
  70.  
  71.  
  72. To begin:
  73.  
  74.     At the DOS prompt, type ---> DLOG   then press <ENTER/RETURN>
  75.  
  76.     The above command will load DISKALOG and will instruct the program
  77. to read the default drive.  If the user wishes to load DISKALOG but
  78. read a directory other than the one on the default drive, then add the
  79. pathname after "DLOG", for example ---> DLOG B:  <ENTER>, or
  80. ---> DLOG C:\DOS  <ENTER>, or ---> DLOG A:\BASIC\  <ENTER>.
  81.  
  82.     With a DISK.LOG file on the screen you can begin adding your
  83. descriptions and notes to each file listing.  Simply type your comments
  84. within the highlighted bar area, and press <RETURN> when you wish to go
  85. on to the next comment.
  86.  
  87.  
  88. Cursor movement within a DISK.LOG file:
  89.  
  90.     When a DISK.LOG file has been displayed you can move the highlighted
  91. marker bar in the following ways:
  92.  
  93.     UP ARROW: Moves the highlighted bar up one position.  If at the top of
  94. the page, the marker bar moves to the bottom of the page.
  95.  
  96.     DOWN ARROW: Moves the highlighted bar down one position.  If at the
  97. bottom of the page, the marker bar moves to the top of the page.
  98.  
  99.     PAGE UP: If the bar is not at the top of the list, then <PG UP> will bring
  100. the bar up to the top of the page.  If the bar was already at the top of
  101. the page, then <PG UP> will display the previous page (if one exists).  There
  102. are twenty listings capable of being displayed on each "page".
  103.  
  104.     PAGE DOWN: If the bar is not at the bottom of the page, then <PG DN> will
  105. bring the bar down to the bottom of the page.  If the bar was already at
  106. the bottom of the page, then <PG DN> will display the next page (if one
  107. exists).
  108.  
  109.    CTRL + PAGE UP: Will move the marker bar to the very first page.
  110.  
  111.    CTRL + PAGE DOWN: Will move the marker bar to the last page.
  112.  
  113. Diskalog - Version 2.32                                                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.     An expanded description line can be toggled from 40 characters to
  132. 67 characters, and vice versa, by pressing the <SHIFT-TAB> key.
  133.  
  134.     When you have completed your description, then press <ENTER/RETURN>.
  135. This will tell DISKALOG that you are done with that particular description
  136. and are ready to continue.  The highlighted bar will then advance on to
  137. the next file/line.
  138.  
  139.  
  140. Shell:
  141.  
  142.     If you wish to leave DISKALOG temporarily, press <ALT-S> for shell
  143. to DOS.  <ALT-S> will permit the user to shell out to DOS (if the
  144. COMMAND.COM file is on the default disk, or COMSPEC is set to indicate
  145. COMMAND.COM's location).  To return to DISKALOG, enter "EXIT" at the DOS
  146. prompt.  You will then reenter DISKALOG where you left off.
  147.  
  148.     Besides access to an operating "shell" through <ALT-S>, eight other
  149. functions are available.
  150.  
  151.   <ALT-B> - Will run the utility program "BROWSE"* with the highlighted file.
  152.  
  153.   <ALT-C> - Will move up/down the directory tree to the highlighted directory
  154.             and resets the screen display to reflect that directory's files.
  155.             The user can move UP the directory tree by using <ALT-C> while
  156.             the highlighted bar is over "." or ".." directory listings.
  157.  
  158.   <ALT-D> - Will delete the highlighted file or directory and remove it from
  159.             the screen list.
  160.  
  161.   <ALT-L> - Will run the utility program "LIST"* with the highlighted file.
  162.  
  163.   <ALT-M> - Will prompt for a new subdirectory name and then make/create it.
  164.  
  165.   <ALT-R> - Will prompt for a new file name to rename the existing file by,
  166.             then will update list.
  167.  
  168. Diskalog - Version 2.32                                                Page 4
  169. ------------------------------------------------------------------------------
  170.  
  171.  
  172.   <ALT-T> - Will perform a DOS "TYPE" command with the highlighted file.
  173.             (This is only useful if the file to view is a text file.)
  174.  
  175.   <ALT-X> - Will run the .EXE, .COM, .BAT file that is currently highlighted.
  176.             Parameters can be passed by two methods: 1) manual entry - after
  177.             the <ALT-X> key combination, type in the parameters on the request
  178.             line at the prompt, or 2) automatic - any characters that are
  179.             found within { } brackets in the file description line will be
  180.             transferred to the parameter line automatically after the <ALT-X>
  181.             key combination.  An example of the "automatic" parameter passing
  182.             follows:
  183.  
  184. UNZIP   .COM  25634 05/14/88 14:30 ...A Restore archived files {-A}
  185. WP      .EXE 231321 12/21/89 12:00 ..RA Word Perfect word processing {/M ALTI}
  186.  
  187.             If the <ALT-X> entry is input while the highlighted bar is over
  188.             WP.EXE above, then at the parameter line "/M ALTI" will appear
  189.             automatically, because it was included in the file description
  190.             enclosed in { } brackets.
  191.  
  192.  
  193.      * These programs are available from most shareware/public domain
  194. distributors and are not a part of the DISKALOG package.   They are well
  195. worth obtaining.
  196.  
  197.  
  198. Main Menu:
  199.  
  200.     Access to the Main Menu is available by pressing <ESC>.  The bottom
  201. line of the screen will then display five options:
  202.  
  203.        N - New file (cancel the current DISK.LOG file on the screen and
  204.            begin a new one)
  205.  
  206.        P - Print file (print the complete current DISK.LOG file)
  207.  
  208.        Q - Quit (terminate DISKALOG and return to DOS)
  209.  
  210.        R - Return (return to viewing/editing the current DISK.LOG file)
  211.  
  212.        S - Save file (save the complete current DISK.LOG file)
  213.  
  214.  
  215. Diskalog - Version 2.32                                                Page 5
  216. ------------------------------------------------------------------------------
  217.  
  218.    IMPORTANT NOTE: The entries/descriptions that the user adds will NOT be
  219. saved unless the user selects "S" from the Main Menu line.  DISKALOG does
  220. NOT automatically save your work, although it will remind you if you have
  221. made any changes without saving your work!  Remember, the user must initiate
  222. a "S"ave!
  223.  
  224.  
  225. Printer options:
  226.  
  227.     If your printer is capable of printing in a condensed mode (15 or more
  228. characters per inch) you might be interested in creating a .PTR file.
  229. Or if you are using a printer port besides "LPT1:" creating a .PTR file will
  230. be necessary in order to perform printer operations.
  231.  
  232.     Before DISKALOG performs its first print job it looks on the default
  233. drive/directory for a file named "DLOG.PTR".  If "DLOG.PTR" exists, then
  234. DISKALOG will load it and use its data to perform subsequent print jobs.
  235. "DLOG.PTR" can be created in a number of ways.  Any line editor will work
  236. (see your DOS disk for EDLIN) or see examples of COPY CON DLOG.PTR below.
  237.  
  238.     Although one can externally set many printers for a condensed character
  239. pitch, there is a benefit in creating a "DLOG.PTR" file.  Besides not
  240. having to remember to set your printer pitch each time, if a "DLOG.PTR" file
  241. exists DISKALOG will create a printout in a handy 5" by 5" (approx.) format
  242. with (cut along dashed line) borders.  This printout format is only available
  243. IF a "DLOG.PTR" file exists and the proper printer parameter codes have been
  244. entered into it!
  245.  
  246.     DISKALOG, if it finds a "DLOG.PTR" file, expects it to be in the following
  247. sequential format...
  248.  
  249. Printer port
  250. Escape code number
  251. Escape code number
  252. Escape code number
  253.   "     "     "
  254.   "     "     "
  255.   "     "     "
  256. Escape code number
  257. EOF marker
  258.  
  259. Diskalog - Version 2.32                                                Page 6
  260. ------------------------------------------------------------------------------
  261.  
  262.  
  263.     The easiest way to create such a "DLOG.PTR" file is the following.  At the
  264. DOS prompt, type the following...
  265.  
  266. COPY CON DLOG.PTR     <press ENTER>
  267. LPT1:                 <press ENTER>
  268. 15                    <press ENTER>
  269.                       <press F6 key>
  270.                       <press ENTER>
  271.  
  272.     Valid printer ports are LPT1: LPT2: COM1: COM2: (don't forget the
  273. colon).  It will be necessary when entering printer escape codes to have your
  274. printer manual at hand.  Enter only the ASCII value after the escape code
  275. Chr$(27) or ESC.  For instance, according to the owner's manual, a Hewlett
  276. Packard Deskjet Plus printer must receive the following escape code to print
  277. in condensed type:
  278.  
  279.                     ESC (s16.67H
  280.  
  281.     In order to create the correct "DLOG.PTR" file for the HP Deskjet + you
  282. must enter each character following the ESC with its corresponding ASCII value.
  283.  
  284.                                    ESC (  s  1  6  .  6  7  H
  285.  
  286. COPY CON DLOG.PTR     <press ENTER>    |  |  |  |  |  |  |  |
  287. LPT1:                 <press ENTER>    |  |  |  |  |  |  |  |
  288. 40                    <press ENTER> ---/  |  |  |  |  |  |  |
  289. 115                   <press ENTER> ------/  |  |  |  |  |  |
  290. 49                    <press ENTER> ---------/  |  |  |  |  |
  291. 54                    <press ENTER> ------------/  |  |  |  |
  292. 46                    <press ENTER> ---------------/  |  |  |
  293. 54                    <press ENTER> ------------------/  |  |
  294. 55                    <press ENTER> ---------------------/  |
  295. 72                    <press ENTER> ------------------------/
  296.                       <press F6 key>
  297.                       <press ENTER>
  298.  
  299.     Here's another example.  If your printer manual says that ESC Chr$(15)
  300. must be sent to the printer to enable condensed print, then the appropriate
  301. "DLOG.PTR" file would be created thusly...
  302.  
  303. COPY CON DLOG.PTR     <press ENTER>
  304. LPT1:                 <press ENTER>
  305. 15                    <press ENTER>
  306.                       <press F6>
  307.                       <press ENTER>
  308.  
  309.     If you have problems creating a "DLOG.PTR" file, contact the program
  310. author with a SELF-ADDRESSED STAMPED ENVELOPE and a copy of your printer
  311. manual's printer codes.
  312.  
  313. Diskalog - Version 2.32                                                Page 7
  314. ------------------------------------------------------------------------------
  315.  
  316.  
  317. Shareware concept:
  318.  
  319.     DISKALOG is being distributed under the shareware concept.  DISKALOG is
  320. NOT free software.  The user is permitted a trial period in which to evaluate
  321. this program.  If you find DISKALOG of use, then you are asked to register
  322. your copy.  Registration is $7.00.  Registration entitles the user to the
  323. latest copy of DISKALOG and permission to continue using the program.
  324.  
  325.     Very important note: A registered copy does NOT have screen delays, nor
  326. does it have the annoying registration reminders at the end of the program
  327. or on the printouts!
  328.  
  329.  
  330. Distribution guidelines:
  331.  
  332.     Whether you decide DISKALOG is useful or not, you are free to distribute
  333. DISKALOG as long as you abide to all of the following guidelines:
  334.  
  335.   1) DISKALOG (DLOG.EXE) must be distributed unaltered.
  336.  
  337.   2) Distribution of DLOG.DOC (this text file) must accompany each copy
  338.      of the program, and must not be altered.
  339.  
  340.   3) You may not sell DISKALOG.
  341.  
  342.   4) Shareware/Public domain vendors and BBS can distribute DISKALOG
  343.      ONLY AFTER receiving written permission from the program author.
  344.  
  345.   5) Shareware/Public domain distributors of "X-rated/Adult" software are
  346.      denied permission to distribute DISKALOG.
  347.  
  348.  
  349. Disclaimer:
  350.  
  351.     DISKALOG is provided to the user on an "as is" basis without warranty of
  352. any kind, expressed or implied.  The program author will not be liable for any
  353. direct, indirect, incidental or consequential damages resulting from the use
  354. of this program.  Your use of this program constitutes your agreement to this
  355. disclaimer and your release of the author from any form of liability or
  356. litigation.
  357.  
  358. Diskalog - Version 2.32                                                Page 8
  359. ------------------------------------------------------------------------------
  360.  
  361.  
  362.                            DISKALOG REGISTRATION:
  363.  
  364.  
  365.       I am enclosing $7.00 in order to register my copy of DISKALOG.
  366.         I understand that this registration fee entitles me to use
  367.            DISKALOG, and that I will be sent the latest version*.
  368.  
  369.  
  370.        Name __________________________________________________________
  371.  
  372.        Address _______________________________________________________
  373.  
  374.        City ______________________ State _______ Zip Code ____________
  375.  
  376.  
  377.        Indicate disk format desired:  ____ 5.25" 360K   ____ 3.5" 720K
  378.  
  379.  
  380.                     I obtained my copy of DISKALOG 2.32
  381.                          from the following source:
  382.  
  383.        Shareware distributor (name and address): _____________________
  384.  
  385.        _______________________________________________________________
  386.  
  387.        Bulletin board: _____________________  Other: _________________
  388.  
  389.  
  390.  
  391.                Suggestions as to how to make DISKALOG better:
  392.  
  393.        _______________________________________________________________
  394.  
  395.        _______________________________________________________________
  396.  
  397.        _______________________________________________________________
  398.  
  399.        _______________________________________________________________
  400.  
  401.  
  402.  
  403.                       Please make U.S. funds payable to:
  404.  
  405.                               Philip P. Kapusta
  406.                                 P.O. Box 5423
  407.                              Falmouth, Va. 22403
  408.                                     U.S.A.
  409.  
  410.                                 (SAV18703EON)
  411.  
  412.           *Note: Registered copies are personalized and do not have
  413.                       registration reminders or delays.
  414.