home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / D_MA.ZIP / D.DOC next >
Text File  |  1993-07-08  |  18KB  |  521 lines
  1.  
  2.  
  3.  
  4.                                     D Ver. 1.2
  5.                         Copyright (c) 1991-1993 Mike Albert
  6.                                      July 1993
  7.  
  8.  
  9.  
  10.      1   INTRODUCTION
  11.  
  12.      D lets you manipulate directories, files, and archives in an intuitive
  13.      and direct way.  You can use D right now without reading more if you
  14.      wish.  Just type:
  15.              D
  16.  
  17.      at the MS-DOS prompt.  You can press the Alt key to see additional
  18.      functions, and "?" for a summary of what different keys do in different
  19.      contexts.  To make sure you don't miss some handy features (e.g.
  20.      recalling previous prompt responses, locating a particular file) you'll
  21.      want to come back and scan the documentation after trying D out.
  22.  
  23.      D can be used on any IBM-compatible computer.  Any display adapter that
  24.      provides 80 character lines, including those with more than 25 lines per
  25.      screen, will work correctly.  D runs under MS-DOS versions 3.0 and
  26.      later.  The amount of memory required is dependent on the directory
  27.      size; 150K is fine for normal directories, while 250K is sufficient for
  28.      really large ones.
  29.  
  30.      D invokes PKARC and PKZIP (and PKXARC and PKUNZIP) to access archives.
  31.      D has been tested successfully with PKARC version 3.6, and with PKZIP
  32.      versions 1.1, 1.93, and 2.04G.  Other versions of PKARC and PKZIP should
  33.      work even though I haven't had the opportunity to test them.
  34.  
  35.      D invokes other programs to list and edit files.  It has been tested
  36.      with Buerg's list.exe ver. 6.4a, QEdit ver. 2.1, Brief ver. 3.0, and the
  37.      MS-DOS 5.0 edit program.  Other editors and listers should work as well.
  38.  
  39.  
  40.  
  41.      2   OPERATION
  42.  
  43.      To view the current directory type:
  44.              D
  45.  
  46.      To view a specific directory type:
  47.              D  path
  48.  
  49.      where path identifies a directory to be viewed.
  50.  
  51.      By default, D looks for a program named LIST to list files and EDIT to
  52.      edit files.  The list program is invoked when you position to a file and
  53.      press Enter, and the edit program is invoked when you press Alt-F2.  D
  54.      first looks in the directory where D itself was found, and then searches
  55.      directories on the search path until it's successful.
  56.  
  57.      If you want D to use a different program for listing or editing files,
  58.      you can specify the program via an environment variable.  The variable
  59.      DLIST identifies the list program, and DEDIT specifies the editing
  60.      program.  Any display or edit program that can be invoked with the name
  61.      of the file to process on the command line can be used.  E.g. to use
  62.      Brief to edit your files when you press Alt-F1, enter the MS-DOS
  63.      command:
  64.           set dedit=b
  65.  
  66.                                        - 1 -
  67.  
  68.  
  69.      or
  70.           set dedit=c:\brief\b.exe
  71.  
  72.      (assuming b.exe is in the directory c:\brief) at the MS-DOS prompt
  73.      before running D.
  74.  
  75.      Note that you can invoke an editor to list if you desire.  Note also
  76.      that D swaps itself out of memory for the edit (Alt-F2) operation, but
  77.      not for the list (Enter) operation.
  78.  
  79.      The following pages summarize how to perform various operations using D.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                       - 2 -
  132.  
  133.  
  134.      - - - - - - - - - - - - - - - Navigation - - - - - - - - - - - - - - -
  135.  
  136.      To:                       Do this:
  137.      ---------------------     ------------------
  138.  
  139.      Position to a file        Type the file or directory name
  140.      or directory                 - or -
  141.                                Press the up and down arrows, PgUp, PgDn,
  142.                                   Ctrl-PgUp, Ctrl-PgDn, Home, and End keys
  143.                                   as needed
  144.  
  145.      Position to the next      Type "." plus the extension, e.g. ".exe"
  146.      file with a specific
  147.      extension
  148.  
  149.      View a drive              Type the drive, e.g. "D:" and press Enter
  150.                                   - or -
  151.                                Press Alt-F9
  152.                                Type the drive, e.g. "D:" and press Enter
  153.  
  154.      View a directory          Position to the directory
  155.                                Press Enter
  156.                                   - or -
  157.                                Type the path name, e.g. "C:\MSDOS" or "\UTIL"
  158.                                   or "..\TEST" and press Enter
  159.                                   - or -
  160.                                Press Alt-F10 to view the directory tree
  161.                                Position to the directory
  162.                                Press Enter
  163.                                   - or -
  164.                                Press Alt-F9
  165.                                Type the path, e.g. "D:\WORK" and press Enter
  166.  
  167.      View a directory tree     Press Alt-F10
  168.                                Type the drive, e.g. "D:" and press Enter
  169.  
  170.      Sort the file list        Press: F7 to sort by name
  171.                                       F8 to sort by extension
  172.                                       F9 to sort by length
  173.                                       F10 to sort by date and time
  174.                                       Alt-F6 to reverse the current ordering
  175.  
  176.      Backout                   Press Esc to view previously viewed directory
  177.                                   - or -
  178.                                Press Alt-X to exit
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                       - 3 -
  197.  
  198.  
  199.      - - - - - - - - - - - - - - Basic Operations - - - - - - - - - - - - -
  200.  
  201.      To:                       Do this:
  202.      ---------------------     ------------------
  203.  
  204.      View the contents of      Position to the file
  205.      a file                    Press Enter
  206.  
  207.      View the contents of      Position to the ARC or ZIP file
  208.      an ARC or ZIP archive     Press Enter
  209.  
  210.      Run a program             Position to the .exe, .com, or .bat file
  211.                                Press Ctrl-Enter
  212.  
  213.      Copy files                Position to the file to copy, or mark multiple
  214.                                   files to copy
  215.                                Press F1
  216.                                Type the target path name, e.g. "D:\UTIL" or
  217.                                   "*.NEW" and press Enter
  218.  
  219.      Delete files              Position to the file or directory to delete,
  220.      or directories               or mark multiple files or directories to
  221.                                   delete
  222.                                Press F2
  223.  
  224.      Rename files or           Position to the file or directory to rename,
  225.      directories                  or mark multiple files or directories to
  226.                                   rename
  227.                                Press F3
  228.                                Type the new file name, e.g. "NEWPROG.C" or
  229.                                   "*.OLD" and press Enter
  230.  
  231.      Move files                Position to the file to move, or mark multiple
  232.                                   files to move
  233.                                Press F4
  234.                                Type the new file directory, e.g. "D:\UTIL" or
  235.                                   "..\BACKUPS\*.??1" and press Enter
  236.  
  237.      Edit a file               Position to the file
  238.                                Press Alt-F2
  239.  
  240.      Mark a file               Position to the file
  241.                                Press keypad "+"
  242.                                   - or -
  243.                                Position to an unmarked file
  244.                                Press " "
  245.  
  246.      Mark multiple files       Press F5
  247.                                Press "A" to mark all files, or
  248.                                  press "J" to mark files that have an "*", or
  249.                                  press "B" to mark files that have a blank
  250.  
  251.      Unmark a file             Position to the file
  252.                                Press keypad "-"
  253.                                   - or -
  254.                                Position to a marked file
  255.                                Press " "
  256.  
  257.      Unmark all files          Press F6
  258.  
  259.  
  260.  
  261.                                       - 4 -
  262.  
  263.  
  264.      - - - - - - - - - - - - - Advanced Operations - - - - - - - - - - - -
  265.  
  266.      To:                       Do this:
  267.      ---------------------     ------------------
  268.  
  269.      Add files to an ARC       Position to the file to be added, or mark the
  270.      or ZIP archive               files to be added
  271.                                Press Alt-F1
  272.                                Type the archive name, e.g. "BACKUPS.ZIP" or
  273.                                   "D:\DB\BACKUPS.ZIP" and press Enter
  274.  
  275.      Set file attributes       Position to the file or directory to be
  276.                                   changed, or mark the files or directories
  277.                                   to be changed
  278.                                Press Alt-F3
  279.                                Type "+" followed by attributes to set (e.g.
  280.                                   "+RA") or "-" followed by attributes to
  281.                                   clear (e.g. "-H").  "H" indicates hidden,
  282.                                   "R" indicates read only, "A" indicates
  283.                                   archive, and "S" indicates system.
  284.                                Press Enter
  285.  
  286.      Set file date and time    Position to the file or directory to be
  287.                                   changed, or mark the files or directories
  288.                                   to be changed
  289.                                Press Alt-F4
  290.                                Type the date and time in the form "mm-dd-yy
  291.                                   hh:mmx" where mm is month (1-12), dd is day
  292.                                   of month (1-31), yy is last 2 digits of
  293.                                   year, hh is the hour of the day (1-12), mm
  294.                                   is minutes within the hour (0-59), and x is
  295.                                   "a" to indicate AM or "p" to indicate PM.
  296.                                   E.g. "4-23-92 7:20p".
  297.                                Press Enter
  298.  
  299.      Temporarily re-enter DOS  Press Alt-F5
  300.                                Enter desired MS-DOS commands
  301.                                Type "exit" and press enter
  302.  
  303.      Show free space on drive  Press Alt-F7
  304.                                Type the drive, e.g. "D:" and press Enter
  305.  
  306.      Make a directory          Press Alt-F8
  307.                                Type the directory name, e.g. "TEMP" or
  308.                                   "..\NEW" or "\MSDOS\BACKUP", and press
  309.                                   Enter
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                       - 5 -
  327.  
  328.  
  329.      - - - - - - - - - - - - Operations at Prompts - - - - - - - - - - - -
  330.  
  331.      To:                       Do this:
  332.      ---------------------     ------------------
  333.  
  334.      Abort the operation       Press Esc
  335.  
  336.      View previous prompt      Press up and down arrows as needed
  337.      responses
  338.  
  339.      Toggle between insert     Press Ins
  340.      and overwrite mode
  341.  
  342.      Clear current response    Press Esc
  343.  
  344.  
  345.  
  346.      - - - - - - - - - - - - - Combined Operations - - - - - - - - - - - -
  347.  
  348.      To:                       Do this:
  349.      ---------------------     ------------------
  350.  
  351.      Look at files             Press F10
  352.      recently changed          Press End
  353.  
  354.      Look at large files       Press F9
  355.                                Press End
  356.  
  357.      Look at files with a      Press F7
  358.      specific extension        Type "." plus the extension, e.g. ".exe"
  359.  
  360.      Sort with multiple        Sort (via F7, F8, F9, F10 and Alt-F6) on minor
  361.      criteria                     order
  362.                                Sort again on major order
  363.                                E.g. to group files with the same extension
  364.                                   together and sort within each extension by
  365.                                   date,
  366.                                      Press F10 (to sort by date)
  367.                                      Press F8 (to sort by extension)
  368.  
  369.  
  370.  
  371.      3   LICENSING, WARRANTY, and REGISTRATION
  372.  
  373.      D is distributed as shareware.  I encourage you to try D and share it
  374.      with friends as long as:
  375.  
  376.          The D program and this documentation file are not modified and are
  377.          distributed together.
  378.  
  379.          D is not provided as a part of any other product.
  380.  
  381.          No fees, beyond a reasonable fee for media, duplication, or
  382.          downloading costs, are charged.
  383.  
  384.          D is not used for commercial, government, or business purposes
  385.          without registration.  Each registration is for a single person or a
  386.          single computer.
  387.  
  388.      If you find D useful and decide to use it regularly, you are required to
  389.      register.  All registration payments will be donated to Oxfam America,
  390.  
  391.                                       - 6 -
  392.  
  393.  
  394.      an international development and disaster relief agency.  It's a worthy
  395.      charity that I've been supporting for many years.  For more information
  396.      on Oxfam see section 4.
  397.  
  398.      When you register you get the satisfaction of saving lives in Africa,
  399.      Asia, and South America, and encourage me to produce more software at
  400.      reasonable prices.  You also get the following benefits:
  401.  
  402.          I'll send you a copy of D that does not display the initial start-up
  403.          screen.  This copy will be registered to you, and will display your
  404.          name at the bottom when it starts.  I'll also include current
  405.          versions of other shareware I produce.
  406.  
  407.          I'll answer any questions you have on D and its use.  You can
  408.          contact me at the address shown below or via CompuServe mail.
  409.  
  410.          If any important bugs are found I will notify you.
  411.  
  412.          I'll make an attempt (but can't guarantee) to fix any problems you
  413.          find.
  414.  
  415.      Registration is $25.  Please make your check payable to Oxfam America -
  416.      I'll send your checks to Oxfam and record your registration information.
  417.      I'll also accept original canceled checks or receipts from Oxfam that
  418.      list you as the donor.  Please send payments, registration information,
  419.      and any other correspondence to:
  420.  
  421.                   Mike Albert
  422.                   P. O. Box 535
  423.                   Bedford, MA   01730
  424.  
  425.      I can also be reached via CompuServe mail; my userid is [70325,1134].
  426.  
  427.      Anyone can order the latest version of D directly from me for a fee of
  428.      $5.00.  Just send the order (make sure it contains your mailing address)
  429.      with your check to the above address.  You'll receive a 5 1/4 inch 360Kb
  430.      floppy disk containing the executable and documentation files.  If you
  431.      need other formats (5 1/4 inch 1.2Mb or 3 1/2 inch 720Kb or 1.44Mb) I
  432.      can provide them.  I'll also include other shareware products I produce.
  433.      If you live outside North America, please send extra money for the
  434.      increased postage.
  435.  
  436.      I welcome all comments and suggestions concerning D.  I'd like to know
  437.      how you are using D, where you obtained it, and what problems, bugs, or
  438.      weaknesses you find.  If you tell me about enhancements or changes
  439.      you're interested in, I'll make an effort to provide them.
  440.  
  441.      This program is provided "as is" without warranty of any kind, either
  442.      express or implied, but not limited to the implied warranties of
  443.      merchantability or fitness for a particular purpose.  The entire risk as
  444.      to the results and performance of the program is assumed by the user.
  445.      Should the program prove defective, the user assumes the entire cost of
  446.      all necessary servicing, repair, or correction.
  447.  
  448.  
  449.  
  450.      4   OXFAM AMERICA
  451.  
  452.      As stated in Oxfam literature,
  453.  
  454.  
  455.  
  456.                                       - 7 -
  457.  
  458.  
  459.           "Oxfam America is an international agency that funds self-help
  460.           development projects and disaster relief in poor countries in
  461.           Africa, Asia, and Latin America, and also prepares and distributes
  462.           educational materials for people in the United States on the issues
  463.           of development and hunger.  The name "Oxfam" comes from the Oxford
  464.           Committee for Famine Relief, founded in England in 1942.  Oxfam
  465.           America, based in Boston, was formed in 1970, and is one of seven
  466.           autonomous Oxfams around the world (Great Britain, Australia,
  467.           Belgium, Canada, Quebec, Hong Kong and the United States).  Oxfam
  468.           is a nonsectarian, nonprofit agency that neither seeks or accepts
  469.           U.S. government funds.  All contributions are tax-deductible to the
  470.           extent permitted by law."
  471.  
  472.      For more information, you can phone Oxfam at 617-482-1211, or write to
  473.      them at:
  474.  
  475.                   Oxfam America
  476.                   26 West Street
  477.                   Boston, MA  02111-1206
  478.  
  479.  
  480.  
  481.      5   D REVISION HISTORY
  482.  
  483.  
  484.           D version 1.2 - 7/08/93
  485.  
  486.                Added use of right and left arrow keys to move through a file
  487.                name in the file name list.
  488.  
  489.                Added up and down "more" indicators on file display.
  490.  
  491.                Added space key to toggle file mark on file display.
  492.  
  493.                Fixed minor problems.
  494.  
  495.  
  496.           D version 1.1 - 4/16/93
  497.  
  498.                Added environment variables DLIST and DEDIT to specify list
  499.                and edit programs.
  500.  
  501.                Tested operation with PKZIP version 2.04g.
  502.  
  503.                Fixed minor problems.
  504.  
  505.  
  506.           D version 1.0 - 9/25/92
  507.  
  508.                Initial release of D.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.                                       - 8 -