home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / BUERG / DD24.ZIP / DD.DOC < prev    next >
Encoding:
Text File  |  1990-01-11  |  9.4 KB  |  261 lines
  1. DoubleDir (DD.EXE)                 Release 2.4 (1/90)
  2.  
  3. Functions - Shows two directories side by side, sorted by name.
  4.         * Each directory can be paged (scrolled) separately.
  5.         * They can be printed side by side.
  6.         * Wildcards can be used, exactly like the DOS "dir" command.
  7.         * Various sort orders
  8.         * Indicates matching and differing files
  9.  
  10.         * Alters file attributes
  11.             * Copies files 
  12.         * Dumps files
  13.         * Erases files
  14.             * Finds files
  15.         * The choice of directories to examine can be changed
  16.           without exiting the program.
  17.         * The directories can be re-read to account for a change
  18.           of disk or file status.
  19.             * Makes and removes directories
  20.             * Runs external file browsers and editors
  21.         * Moves files between directories without copying them
  22.         * Renames files
  23.  
  24.             * Finds "text" or "data" in files
  25.  
  26.         * supports any number of screen lines
  27.             * with EGA, toggles 43-line mode
  28.             * with VGA, toggles 50-line mode
  29.         * DOS access without exiting
  30.         * supports ansi colors
  31.  
  32. Purpose   - Use to compare directories, as when moving files from floppy
  33.         to floppy (or directory to directory).    Allows execution
  34.         of file maintainence tasks without losing sight of the
  35.         directory.
  36.  
  37. Syntax      - dd [d:][\][path][filename] [d:][\][path][filename]
  38.  
  39. Examples  - dd
  40.  
  41.         dd a:*.asm b:*.com
  42.  
  43.         dd a:*.doc c:\mm\mydocs
  44.  
  45. There is a limit of 700 files per directory.
  46.  
  47. =============================================================================
  48.  
  49. GETTING AROUND
  50.  
  51. Default is to the current directory.
  52.  
  53. Note that the directory on the left BECOMES the current directory when 
  54. specified.  For example:
  55.  
  56.     C:\MYDIR>dd c:\dir1 d:\dir2
  57.  
  58. will CHANGE the DOS current directory to C:\DIR1.
  59.  
  60. A reverse video bar on the bottom of screen indicates which directory will
  61. scroll with the cursor keys.  Move the bar using Tab, Left, or Right.
  62.  
  63. Files with matching entries are marked with "║".  Files with the same name
  64. but differing sizes, dates, times, or attributes are marked with "═".
  65.  
  66. Hidden and Read-only files are shown by "<" and "■".  Cursor keys scroll
  67. the active directory.
  68.  
  69. Other keys: Tab, Left, Right    change active directory
  70.         F1    Help
  71.         F2    Re-read    disks.    
  72.         F9  Print both directories, side by side.
  73.         F10 Toggle 43/50 line display (EGA/VGA only)
  74.         Esc    exit to DOS
  75.         CR    Issue DOS command
  76.  
  77. ============================================================================
  78.  
  79. THE MENU
  80.  
  81. Select a function by pressing the CAPITAL letters of your choice:
  82. For example:
  83.  
  84. Attr  COpy  CD  Dump  Erase  Find  MD  Move  RD  REverse  Sort  View  Xdos
  85.  
  86. means press A for Attr, CO for copy, D for dump, RE for reverse, etc.
  87. Pressing Return    will give you a simulated DOS command prompt.  Pressing 
  88. Return at that prompt will restore the menu.
  89.  
  90. ============================================================================
  91.  
  92. THE FUNCTIONS
  93.  
  94.     GENERAL RULES: When you are asked for a filename, pressing Esc 
  95.         cancels the operation.  Pressing F3 restores the previous
  96.         entry (like in DOS).  So do PgUp and Up-arrow.
  97.  
  98.     *  Attrib will change the attribute of a file to Hidden, Readonly, or
  99.     Normal.  It will not affect the archive bit.  Pressing Return without
  100.     a filename will cancel.
  101.  
  102.     *  Dump will give one of four kinds of dumps:
  103.         1) 'Hex' gives a Hex dump (Ascii on the right side)
  104.  
  105.         2) 'Ascii' gives a 'raw' Ascii dump.  It's like saying
  106.            'copy filename con /b'.    Carriage return and other
  107.            special characters appear as graphics.
  108.  
  109.         3) 'Strings' shows printable strings only.    It will ask you
  110.         how many printable chacters in sequence should be considered
  111.         significant (the default is 2, the maximum is 9).
  112.  
  113.         4) 'Text' is like the DOS 'type' command, except it
  114.         also works for Wordstar-format files.
  115.  
  116.        Pressing Spacebar during a dump will pause it; then any key
  117.        will resume.  Pressing Esc during the dump will terminate it.
  118.  
  119.     *  ChDir will prompt you for directory names ('Left side' and
  120.         'Right side').    If you enter a name, it will read the
  121.         appropriate directory onto the side of the screen specified.
  122.         <CR> alone will leave the currently selected directory 
  123.         unchanged.  Note that the left side becomes the current 
  124.         working directory.
  125.  
  126.         This is also how you change the filespec, for
  127.         example, from *.exe to *.*, etc.
  128.  
  129.     *  Copy will prompt you for source and target names.  It accepts
  130.                 wildcards for source, but NOT for target.  The target 
  131.                 defaults to the current (left) directory.  Pressing Return
  132.                 without a source name will cancel.
  133.  
  134.     *  Erase will prompt you for a filename to erase.  It takes
  135.         wildcards.  If you try to erase a Readonly file, you will
  136.         get the message 'Access denied.'
  137.  
  138.     *  Find will prompt you: 'Data File Text'
  139.  
  140.                 * Selecting 'File' will prompt you for a filename to find.  
  141.                 It takes wildcards.  It will search all directories on the 
  142.                 drive specified (or the default drive).
  143.  
  144.                 * Selecting 'Text' will prompt you for a the text you
  145.                 wish to find, and the files to search (default is *.*).
  146.                 The line on which the data is found is displayed, and 
  147.                 Ctrl-Z in a file is considered an EOF mark.
  148.  
  149.                 * Selecting 'Data' will prompt you for a the data you
  150.                 wish to find, and the files to search (default is *.*).
  151.                 The found data is presented "raw" (like DumpAscii),
  152.                 and Ctrl-Z is not considered EOF.
  153.  
  154.         Pressing Spacebar during a Find will pause it; then any key
  155.         will resume.  Pressing Esc during a Find will terminate it.
  156.  
  157.         *  MD (Make Directory) works like DOS MkDir.
  158.  
  159.     *  Move will prompt you 'Source:' and 'Target:'.  It will move the 
  160.         file(s) you name to a new directory, and/or will rename it 
  161.         if you wish.  Example:
  162.  
  163.         Source: \foo2\*.*  Target: \foofiles
  164.  
  165.         or
  166.  
  167.         Source: \ribbet.doc  Target: \foofiles\ribbet.txt
  168.  
  169.     *  Sort gives four sort options: Date, Extension, Name, and
  170.         Size.  Extension is sorted first by extension and then
  171.         by Name.  The default is Name, ascending order (see Reverse).
  172.  
  173.         *  RD (Remove Directory) works like DOS RmDir.  It will not
  174.                 remove the current directory, nor will it remove a non-empty
  175.                 directory.
  176.  
  177.     *  Reverse inverts the current sorting sequence.  It works with all
  178.         sort forms.
  179.  
  180.         *  View is for viewing or editing files.  It looks for the
  181.                 environment variable DDVIEW, and then prompts you for
  182.                 a filename.  For example, I use a file browser called
  183.                 LIST.COM, so I have the line:
  184.  
  185.                 set ddview=list
  186.  
  187.                 in my AUTOEXEC.BAT file.  Thus LIST is invoked when I
  188.                 select View.  You can also use the name of an editor;
  189.                 in fact, you can use View to run any program you like,
  190.                 excepting TSRs, of course.
  191.  
  192.     *  Xdos    runs COMMAND.COM and clears the screen.  To return to
  193.         DoubleDir, issue the EXIT command.  DoubleDir will take
  194.         up less than 12k of memory.
  195.  
  196.     *  Help (F1) will show the help screen (really just a quick intro
  197.         for those who haven't yet read this manual).
  198.  
  199.     *  Re-read (F2) will reread the currently specified directories.
  200.         This allows you to change disks.  It is also useful when
  201.         you have asked for a file to be deleted, or an attribute
  202.         changed, as the display is not automatically updated after
  203.         those operations.
  204.  
  205.     *  Print (F9) prints the two directories side by side, just as they
  206.         appear on the screen.
  207.  
  208.     *  F10 toggles 43-line mode when an EGA is present and 50-line mode 
  209.         when a VGA is present.  It will not save other fonts.
  210.  
  211. ============================================================================
  212.  
  213. POSSIBLE CONFUSION
  214.  
  215.     You can specify related directories like in DOS:
  216.  
  217.     [ dd *.* ..\*.* ] will show the current directory and its parent.
  218.     If you CHANGE the left directory [CD], but not the right one, you 
  219.     may get a surprise when you press F2 (Re-read), because the right
  220.     directory will show the parent of the NEW current directory.  If 
  221.     the current directory is the root, you will get the message 'File
  222.     not found'.
  223.  
  224. ============================================================================
  225.  
  226. TRICKS AND TIPS
  227.  
  228. 1)  'Dump Strings' is mostly intended for finding error messages and
  229.     such in  compiled code.
  230.  
  231. 2)  A common use of the Re-read (F2) function is when looking for a
  232.     file on a group of diskettes.  For example, to find the
  233.     files FOO*.DOC:
  234.  
  235.     Type: CD
  236.     Response: 'Left Side: '     Type: c:foo*.doc<CR>
  237.     Response: 'Right Side: '    Type: a:foo*.doc<CR>
  238.  
  239.     Now just keep replacing floppies, hitting F2 each time.
  240.  
  241. ============================================================================
  242.  
  243. QUIRKS
  244.  
  245. 1)  The program requires DOS >= 2.0, but does not check.
  246.                  
  247. 2)  'Alter' resets the System attribute when making a System file 'Normal'.
  248.     This does not interfere with any known DOS function.
  249.  
  250. ============================================================================
  251.  
  252. The price of this program is $11.00 (see address below).
  253.  
  254. Thanks to those who have written with suggestions, they are always welcome.  
  255.  
  256. All rights reserved, not to be sold for profit.
  257.  
  258. (c) 1990 Eric Grunin
  259.      250 W.100 St.
  260.      NY, NY 10025
  261.