home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast.iso / pcmag / dirmag2.zip / MANUAL < prev    next >
Text File  |  1988-09-01  |  42KB  |  991 lines

  1.  
  2.  
  3.  
  4.                                      Table of Contents
  5.          
  6.                Read this first . . . . . . . . . . . . . . . .  1
  7.  
  8.                String Searches  . . . . . . . . . . . . . . . . 3
  9.          
  10.                DIRMAGIC Overview  . . . . . . . . . . . . . . . 4
  11.          
  12.                Command Set  . . . . . . . . . . . . . . . . . . 6
  13.                        Enter Key
  14.                        F1  Copy                 F2  Delete
  15.                        F3  Rename               F4  Move
  16.                        F5  Clear marks          F6  Mark free
  17.                        F7  Sort Name            F8  Sort Ext.
  18.                        F9  Sort Size            F10 Sort daTe
  19.          
  20.                Alternate Command Set  . . . . . . . . . . . . . 10
  21.                        Alt-F1 Copy/V            Alt-F2 Confirm
  22.                        Alt-F3 Protect           Alt-F4 Sort
  23.                        Alt-F5 HighBit           Alt-F6 Attributes
  24.                        Alt-F7 File search       Alt-F8 New path
  25.          
  26.                Error Messages . . . . . . . . . . . . . . . . . 13
  27.          
  28.                DINSTALL . . . . . . . . . . . . . . . . . . . . 13
  29.          
  30.                DM . . . . . . . . . . . . . . . . . . . . . . . 14
  31.  
  32.                PRMANUAL . . . . . . . . . . . . . . . . . . . . 15
  33.              
  34.  
  35.                       ==== IMPORTANT:  READ THIS FIRST ====
  36.  
  37.         Okay, nobody likes manuals.  But this one's short, and you should 
  38.         at least skim it to learn how powerful DIRMAGIC really is.  
  39.  
  40.         If you think you can figure it all out from the onscreen menu, at 
  41.         least note a few critical points:
  42.  
  43.         The most important is that DIRMAGIC is really a pair of 
  44.         files -- the muscular DIRMAGIC.COM file handler itself 
  45.         plus a subdirectory manager called DM.COM.  You can run 
  46.         DIRMAGIC as a standalone program (by typing DIRMAGIC), 
  47.         but it's much more capable when you start the whole 
  48.         process off by running DM first.  Then, when DM is 
  49.         active, you can summon DIRMAGIC just by pressing F10.
  50.  
  51.         Here are the other key points:
  52.  
  53.         First, DIRMAGIC is designed to let you use the function keys (as 
  54.         well as the Enter key and Esc key) to give you total control over 
  55.         DOS.  But it does so many things that that we couldn't cram them 
  56.         all onto the ten basic function keys.  To use the ones listed in 
  57.         the lower part of the menu you have to hold down the Alt key and 
  58.         then press the specific function key.
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.         Second, install the program properly by running DINSTALL.  This 
  72.         lets you pick the screen colors (on a color system) and change a 
  73.         few important settings.  It will take just a few seconds, but 
  74.         it's worth it.  
  75.  
  76.         Note that DINSTALL will modify the program file only if it's 
  77.         named DIRMAGIC.COM.  And the DM F10 key will load DIRMAGIC.COM 
  78.         only if you haven't changed its filename.  Don't try renaming 
  79.         DIRMAGIC.COM to something like D.COM to make it easier to 
  80.         execute.  The easiest way to run it is by loading DM first and 
  81.         then pressing F10.
  82.  
  83.         But if you really do want to give it a shorter name, make a copy 
  84.         of it called something like D.COM each time you install or 
  85.         reinstall it.  The program itself is so small that an additional 
  86.         copy of it won't take up very much room.
  87.  
  88.         Third, you can run the program one of two ways.  You could enter 
  89.         just:
  90.  
  91.              DIRMAGIC 
  92.  
  93.         by itself just to run the file-handling part of the program.  But 
  94.         there's a much better way.
  95.  
  96.         Make sure you have both the DM.COM and DIRMAGIC.COM programs on 
  97.         your disk, and type:
  98.  
  99.              DM /G
  100.  
  101.         (The /G stands for Go.)  This will load the directory-manager 
  102.         part of the program into memory, and will let you jump around 
  103.         from one subdirectory to another, see how many files are in each 
  104.         directory and how much space they take up, create or delete or 
  105.         rename subdirectories, and do tricks with the file attributes in 
  106.         them.
  107.  
  108.         When DM is loaded, you can run DIRMAGIC by making sure the 
  109.         highlighted DM bar is on the subdirectory you want to examine, 
  110.         and then pressing the F10 key.  If this doesn't summon DIRMAGIC, 
  111.         make sure you have a DIRMAGIC.COM on your disk and that it's in a 
  112.         place where DM.COM can find it.
  113.  
  114.         You can run DM each time you need it (which takes a few seconds 
  115.         since DM has to read in the directory structure from your disk), 
  116.         or you can install it in memory so that typing DM at the DOS 
  117.         prompt will pop up an instant map of your subdirectory structure 
  118.         (which is far faster).  To run the program WITHOUT installing it 
  119.         in memory, type just:
  120.  
  121.              DM
  122.  
  123.         To install it in memory and have it remain active, type:
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.              DM /G
  137.  
  138.         If you want to install it each time you boot up your system, so 
  139.         that it remains lurking in memory just waiting to spring into 
  140.         action whenever you enter DM at the DOS prompt, include the 
  141.         following line in your AUTOEXEC.BAT file:
  142.  
  143.              DM /I
  144.  
  145.         (The /I stands for Install.)  If you keep DIRMAGIC.COM and DM.COM 
  146.         in your \UTILITY subdirectory, you'd modify the line to:
  147.  
  148.              \UTILITY\DM /I
  149.  
  150.  
  151.                             ==== String Searches ====
  152.  
  153.         One feature of DIRMAGIC isn't mentioned in the onscreen menu.  To 
  154.         view the contents of any file, use DIRMAGIC's moving bar to 
  155.         highlight the filename, then press the Enter key.  Once you're 
  156.         viewing a file, you can scan through it for up to 30 characters 
  157.         of text, by typing F (or Ctrl-QF).  But you have to be viewing a 
  158.         file to search for text inside it.  
  159.  
  160.         When you are viewing a file and you type F -- or the equivalent 
  161.         Ctrl-QF, which should be familiar to WordStar and SideKick users; 
  162.         or the equivalent F7 -- the top of the screen will clear and 
  163.         DIRMAGIC will display the last search string, if any.
  164.  
  165.         (Of course, the first time you enter this command, the top of the 
  166.         screen will be blank.)
  167.  
  168.         You can either reuse the last search string by pressing Enter, or 
  169.         type in a new string.  Any existing string will vanish instantly 
  170.         if you enter a new character.  You can edit the current string by 
  171.         backspacing or pressing the End key then appending to the string.  
  172.  
  173.         Once you've entered a string, DIRMAGIC will ask you for the 
  174.         search options G, W, or U:
  175.  
  176.              G -- (global) lets you search the entire document 
  177.                   regardless of the current viewing page.
  178.  
  179.              W -- (whole words only) skips matches embedded in words.
  180.                   For instance, this finds "port" but not "important."
  181.  
  182.              U -- (upper/lower case) finds all matches regardless of 
  183.                   case.  For instance, this finds "PC" and "pc."
  184.  
  185.         You can skip the options by pressing the Enter key, and the 
  186.         search will begin.
  187.  
  188.         If it finds a match, it positions the line with the match at the 
  189.         top of the screen and places the cursor placed under the first 
  190.         character.  You may repeat the search operation by pressing Ctrl-
  191.  
  192.  
  193.                                         3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.         L, or F8, or just plain L.  You can quickly search through 
  203.         multiple files for the same search string by pulling up each 
  204.         individual file for viewing and typing L.  
  205.  
  206.  
  207.                            ==== DIRMAGIC Overview ====
  208.  
  209.         Just enter DIRMAGIC, and faster than you can say PC COMPUTING 
  210.         you'll see a sorted directory listing in the same format as the 
  211.         DOS DIR command on the left side of the screen.  In the 40
  212.         columns to the right of the listing will be a menu chock full of 
  213.         powerful file functions.
  214.  
  215.         You can flip through the directory by using the keypad cursor up 
  216.         and cursor down keys to move the highlighted bar.  Park the bar 
  217.         on a file of interest and tap the appropriate function key and 
  218.         DIRMAGIC will either display the file for viewing, copy it, move 
  219.         it, delete it, rename it or change the file's attributes.  You 
  220.         can even sort the directory in four different ways.  
  221.  
  222.         DIRMAGIC also offers a filename-initial search feature that will 
  223.         quickly navigate you to a specific file.  For example, pressing P 
  224.         will take you to the first file that starts with the letter P.  
  225.         Another press of P and you will arrive instantaneously at the 
  226.         next P file.  A beep indicates that no more files start with the 
  227.         letter you entered.  
  228.  
  229.         To call up a directory for viewing simply tell DIRMAGIC the path 
  230.         and, if any, the sort priority.
  231.  
  232.             DIRMAGIC [d:][directory][/N][/E][/S][/D][/T][/O][/R][/F]
  233.          
  234.             N = Sort by name         E = Sort by extension
  235.             S = Sort by size         D = Sort by date
  236.             T = Sort by date         O = Original order (no sort)
  237.             R = Reverse all sorts    F = Files only (no directories)
  238.  
  239.         This may look intimidating but that's just because DIRMAGIC 
  240.         offers lots of options.  To use DIRMAGIC in the current 
  241.         directory, just type:
  242.  
  243.              DIRMAGIC 
  244.  
  245.         and the listing for the default directory will appear.  Add a 
  246.         drive and/or directory if you want to examine a directory other 
  247.         than the default.  
  248.  
  249.         The switch characters like /N and /E tell DIRMAGIC the way you 
  250.         want it to sort your directory.  DIRMAGIC defaults to sorting by 
  251.         filename, which alphabetizes the listing.  (You can change the 
  252.         defaults; see DINSTALL below.)  
  253.  
  254.         Don't worry if you can't remember the switches.  All the sorting 
  255.         functions except O and F appear in DIRMAGIC's menu.
  256.  
  257.  
  258.  
  259.                                         4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.         Unlike the DOS DIR command that scrolls off your screen forever, 
  269.         DIRMAGIC gives you complete control over the directory listing 
  270.         display:  
  271.  
  272.              Up-arrow and down-arrow keys scroll the highlight bar one 
  273.              line at a time.
  274.  
  275.              PgUp and PgDn keys flip to the next screenful of the 21 
  276.              filenames that DIRMAGIC displays at any one time.  (DIRMAGIC  
  277.              also supports EGA 43-line mode, listing 39 files at a time.)  
  278.  
  279.              Home and End keys take you to the beginning and end of the 
  280.              directory.  
  281.  
  282.              Ctrl-PgUp and Ctrl-PgDn take you to the top and bottom of 
  283.              the current screenful of filenames.
  284.  
  285.              Tab key scoots you down the listing of filenames seven hops 
  286.              at a press.  
  287.  
  288.              Shift-Tab will move you up the listing seven files at a 
  289.              time.  
  290.  
  291.         WordStar users will feel at home with the Ctrl-letter function 
  292.         keys.  They give you the option of pressing: 
  293.  
  294.              Ctrl-V -- to View a file
  295.  
  296.              Ctrl-C -- to Copy a file
  297.  
  298.              Ctrl-D -- to Delete a file
  299.  
  300.              Ctrl-M -- to Move a file
  301.  
  302.              Ctrl-R -- to Rename a file
  303.  
  304.              Ctrl-W -- to toggle the WordStar high bit on and off
  305.  
  306.              Ctrl-N -- to sort by Name
  307.  
  308.              Ctrl-E -- to sort by Extension
  309.  
  310.              Ctrl-S -- to sort by Size
  311.  
  312.              Ctrl-T -- to sort by daTe
  313.  
  314.         To use these, hold down the Ctrl key and press the letter for the 
  315.         appropriate function.  
  316.  
  317.         The Copy, Delete, Rename, and Move functions work directly while 
  318.         you're viewing a file.  For example, if while you view a file and 
  319.         decide on the spot that you want to delete it, you don't have to 
  320.         return to the main menu.  Instead, just press F2 (or Ctrl-D) and 
  321.         you will be automatically returned to the menu's confirm deletion 
  322.         prompt.  This assumes the Confirm toggle is ON.  If this toggle 
  323.  
  324.  
  325.                                         5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.         is set to OFF, DIRMAGIC will not pause before deletion.
  335.  
  336.         At any time if you wish to abort a process, just press the Esc 
  337.         key.  Pressing Esc while in the listing window will exit DIRMAGIC 
  338.         and return you to the DOS prompt.  
  339.  
  340.         If you press any key while copying files, DIRMAGIC will screech 
  341.         to a halt and abort the copying process.  If there is not enough 
  342.         disk space for a marked file, DIRMAGIC skips it and checks to see 
  343.         if the next one will fit.  This will continue until all marked 
  344.         files are checked for their size, optimizing the use of target 
  345.         disk space.  When DIRMAGIC copies a file successfully it turns 
  346.         the arrow at the left edge of the screen next to the filename 
  347.         into an asterisk.  
  348.  
  349.         DIRMAGIC observes all the DOS file handling rules.  You can't 
  350.         mark, copy, move, or delete hidden files (or directories) and you 
  351.         can't delete read-only files.  You can't copy a file over itself 
  352.         or over a read-only file.  And you can't move a file to a 
  353.         directory that contains a file of the same name.  You probably 
  354.         won't want to use DIRMAGIC to copy files between the two logical 
  355.         drives A: and B: if you have only one physical floppy drive, 
  356.         since the constant swapping of source and target diskettes will 
  357.         drive you up the wall.  In this case either use the DOS XCOPY 
  358.         program, or copy all of the target floppy files to a temporary 
  359.         directory on drive C: and then use DIRMAGIC to copy them back 
  360.         selectively to the target diskette in drive A:.
  361.  
  362.         DIRMAGIC uses all 80 columns of your screen to display files.  It 
  363.         keeps displaying one line until it either encounters a carriage 
  364.         return or gets to the last column of the screen.  DIRMAGIC won't 
  365.         try to outguess you by implementing a different kind of word wrap 
  366.         or taking a stab at the default margins of your word processor.  
  367.         Standard ASCII text files with margins of 80 columns or less will 
  368.         look just as you'd expect, but text files from word processors 
  369.         that either omit carriage returns, or format the text within 
  370.         specified margins, will not display in the same format in which 
  371.         they were created.  
  372.  
  373.         Also, if your word processor prefaces your document files with 
  374.         control codes for something like page formatting, these will 
  375.         appear as gibberish before the text.  The variety of algorithms 
  376.         used by word processors to format text makes it impossible for 
  377.         DIRMAGIC to display all documents in their original form.  This, 
  378.         however, should present no major distraction.  The text will 
  379.         still be quite readable.  If you choose to view an executable 
  380.         file, however, unless it contains some embedded text strings such 
  381.         as a copyright notice or error messages, it all will be 
  382.         gibberish.  You might find it interesting to look for all the 
  383.         command strings in COMMAND.COM.
  384.  
  385.  
  386.                               ==== Command Set ====
  387.  
  388.                                     Enter Key
  389.  
  390.  
  391.                                         6
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.         One of the most useful DIRMAGIC functions is its ability to let 
  402.         you view any file.  Just highlight a filename and press the Enter 
  403.         key and DIRMAGIC will instantly let you scan through the file.
  404.  
  405.         Once you're viewing the file, use the arrow keys to browse 
  406.         through it.  The up and down arrow keys scroll the file one line 
  407.         at a time.  PgUp and PgDn move to the previous or next page.  
  408.         Both Ctrl-PgUp and Home take you to the top of the file and Ctrl-
  409.         PgDn or End take you to the bottom of the file.  When you're done 
  410.         viewing, press the Enter key one more time, or press Esc to exit 
  411.         to the menu.  
  412.  
  413.         As it should in all applications, pressing Esc takes you back one 
  414.         step in all the modules of DIRMAGIC.  Pressing Esc from the 
  415.         directory listing will return you to DOS.  This lets you jump in 
  416.         and out of files with a minimum of keystrokes -- and assures that 
  417.         you'll never again have to resort to the DOS TYPE command or, for 
  418.         that matter, be bothered with typing the name of the file.
  419.  
  420.         Pressing the Enter key when the highlighted bar is on a 
  421.         subdirectory will change (CHDIR) to that directory and return you 
  422.         to the DOS prompt.
  423.  
  424.         Typing Ctrl-Enter while the highlighted bar is on a subdirectory 
  425.         will display that directory.  Pressing Ctrl-Enter when a dot 
  426.         entry (.. <DIR>) is highlighted will load the parent directory.
  427.  
  428.         Pressing Ctrl-Enter when you've highlighted an executable 
  429.         filename will run the file if it has an extension of EXE or COM.  
  430.         When the executable program is finished you will be returned to 
  431.         DIRMAGIC.  Some programs merely print some sort of output and 
  432.         then exit, leaving the output on the screen.  With these programs 
  433.         you can have DIRMAGIC pause before erasing the output by holding 
  434.         down one of the Shift keys while pressing Ctrl-Enter.  Any 
  435.         keypress after an appropriate pause will return you to DIRMAGIC.
  436.  
  437.         [See also Alt-F5 HighBit.]
  438.  
  439.  
  440.                               +/- (Plus/Minus) Keys
  441.  
  442.         Pressing the plus key will place a little right-arrow character 
  443.         in front of a highlighted filename and move the bar down one line 
  444.         so you can mark the next file.  By marking several files you can 
  445.         "tag" or gang together commands and execute them in one gulp.  
  446.         For example, by marking several files before pressing F1 Copy, 
  447.         you can copy a group of selected files to one destination.  
  448.         Pressing the minus key will erase any marks that may have been 
  449.         attached to a filename by mistake.  A shifted plus or minus will 
  450.         move the highlight bar in the opposite direction (up the listing) 
  451.         after placing or erasing the mark at the present position.
  452.  
  453.  
  454.                                      F1 Copy
  455.  
  456.  
  457.                                         7
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.         Press F1 and DIRMAGIC will prompt you for the destination of 
  468.         either the highlighted file or the marked files.  If no files are 
  469.         marked, the highlighted file will be copied.  If you want the 
  470.         files to retain their normal names (the most frequent case) just 
  471.         give DIRMAGIC a path.  Enter the path and/or filename, press 
  472.         Enter and the copy will be made.  DIRMAGIC will let you know if 
  473.         the operation was successful by placing an asterisk in front of 
  474.         the source filename in the listing.  
  475.  
  476.         You can enter any legal combination of path and filename, or omit 
  477.         a destination path, just as with the DOS COPY command.  If you 
  478.         want the name of the copy to be the same, you need only enter the 
  479.         directory or specify the drive for the copy.  If you press the 
  480.         Enter key without typing in any specification, DIRMAGIC will 
  481.         attempt to copy the file to the default directory and drive -- 
  482.         the active drive and directory when you entered DIRMAGIC at the 
  483.         DOS prompt.  Note that this may or may not be the same as the 
  484.         drive and directory you told DIRMAGIC to display.  
  485.  
  486.         DIRMAGIC's Copy command follows all the same rules as the DOS 
  487.         COPY command.  If you aren't sure about what you're doing, or are 
  488.         trying something complex, first change to the directory you're 
  489.         going to copy to before you enter into DIRMAGIC, or include the 
  490.         complete path as the destination entry.  You can add the familiar 
  491.         *.* to the end of the path but it's not necessary.  
  492.  
  493.         Note:  Be very careful not to specify a single filename if you 
  494.         are copying a block of marked files or all the files will be 
  495.         copied over the same target file.  You can enter a filespec such 
  496.         as *.BAK to make backup copies.  The global ? character is also 
  497.         acceptable.  You can also copy a file to the printer.  Just enter 
  498.         as the destination PRN.
  499.  
  500.         [See also Alt-F1 Copy/V and Alt-F3 Protect.]
  501.  
  502.  
  503.                                     F2 Delete
  504.  
  505.         If you decide that you want to wipe out a file, press F2 Delete.  
  506.         If the Alt-F2 Confirm feature is ON (it is by default) before 
  507.         deleting the highlighted file or block of marked files, DIRMAGIC 
  508.         displays a verification warning, giving you a chance to abort 
  509.         just in case you made a typing mistake and hit the F2 key in 
  510.         error.  To continue with the deletion, press Y.  Or press N or 
  511.         Esc to abort the process.  When a file is successfully deleted, 
  512.         DIRMAGIC tidies up the listing by removing the filename.  And it 
  513.         adjusts the file count and number of bytes free at the bottom of 
  514.         the screen.
  515.  
  516.         [See also Alt-F2 Confirm.]
  517.  
  518.  
  519.                                     F3 Rename
  520.  
  521.  
  522.  
  523.                                         8
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.         When you press F3, DIRMAGIC prompts you for a new name for the 
  533.         file you've highlighted.  Your response cannot contain the path 
  534.         characters : or \ or the wild card characters ? or *.  Once you 
  535.         have entered the desired new name, press Enter, and if you have 
  536.         given the file a valid name, the new name will replace the old in 
  537.         the directory listing.  If you pressed F3 and wish to change your 
  538.         mind in midstream, press Esc.
  539.  
  540.  
  541.                                      F4 Move
  542.  
  543.         F4, which moves a file to another directory, is extremely useful 
  544.         if you use one directory as a dumping ground for files and later 
  545.         move them to their proper places.  The F3 Move function operates 
  546.         in the same manner as F1 Copy, prompting you for the new home of 
  547.         a highlighted file or a group of marked files.  
  548.  
  549.         If able, DIRMAGIC will move the file or files to the destination 
  550.         directory you indicate.  Confirmation of a successful move is the 
  551.         same as when you delete a file; the name will be removed from the 
  552.         directory listing.  Don't panic.  Your file is not lost; it's in 
  553.         the new directory.  DIRMAGIC moves files across drives by first 
  554.         copying the file as if you had pressed F1 Copy.  It will then 
  555.         delete the source file only if the copy operation succeeded. 
  556.  
  557.         You can rename a file that you're moving simply by tacking on the 
  558.         new name to the end of the destination path.  Actually, if the 
  559.         source and destination are in the same drive, all that happens is 
  560.         that the directory entry is changed.  Since this leaves the 
  561.         actual physical data alone it's very fast and easy.  This also 
  562.         lets you move files around on a full disk.  You can trick 
  563.         DIRMAGIC into renaming a file and leaving it in the current 
  564.         directory by telling it to move the file to the source directory 
  565.         with the new name.  DIRMAGIC will appear confused, since it will 
  566.         remove the old name from the listing without replacing it with 
  567.         the new one.  Your file, however, is safe.
  568.  
  569.  
  570.                          F5 Clear Marks and F6 Mark All
  571.  
  572.         F5 will clear all marks (both arrows and asterisks) attached to 
  573.         filenames and F6 will mark all blank or non-marked filenames for 
  574.         gang-tagging operations.  F6 will not mark files that have a 
  575.         confirmation asterisk in front of them.  
  576.  
  577.         The F6 Mark All lets you split up a directory into two 
  578.         different target disks or directories.  Mark the files destined 
  579.         to go to the first directory and copy them.  All the arrow marks 
  580.         will turn to asterisks after completion.  A press of F6 will then 
  581.         mark all the rest of the files and you will instantly be ready to 
  582.         copy the balance of the files to the other destination.  If your 
  583.         copying needs are simpler than that, you can, of course, use F6 
  584.         as a Mark All function to copy all files of a directory.
  585.  
  586.         Suppose you need to copy all the files in a hard disk directory 
  587.  
  588.  
  589.                                         9
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.         to diskettes but they won't all fit on one flopoy.  First mark 
  599.         all the files by pressing F6, then press F1 and indicate that the 
  600.         target is drive A:.  DIRMAGIC will copy all the marked files that 
  601.         will fit on the diskette, and will turn these files' arrow marks 
  602.         to asterisks.  Next, insert a blank diskette in drive A: and 
  603.         press F1 again and DIRMAGIC will try to copy all the files not 
  604.         copied the first time.  You can continue this process until all 
  605.         the files are marked with asterisks, indicating all have been 
  606.         copied to diskette.
  607.  
  608.                                   F7 Sort Name   
  609.                                   F8 Sort Ext.   
  610.                                   F9 Sort Size   
  611.                                   F10 Sort daTe
  612.  
  613.         The last four functions of DIRMAGIC control the different ways 
  614.         you can sort the directory listing -- by Name, by Extension, by 
  615.         Size, and by DaTe.  Unlike the DOS SORT.COM, the Date sort 
  616.         correctly handles the old problem of sorting by year as well as 
  617.         month, date, and finally time.  
  618.  
  619.         You would use the F8, Sort by Extension, for example, if you
  620.         were just interested in your BAK files.  The Sort functions can 
  621.         be used in combination with other functions.  If you want to see 
  622.         all your COM files sorted by size, press F9, Sort by Size and 
  623.         then F8, Sort by Extension.
  624.  
  625.         [Also see Alt-F4 Sort.]
  626.  
  627.          
  628.                          ==== Alternate Command Set ====
  629.  
  630.                                   Alt-F1 Copy/V
  631.  
  632.         Alt-F1 Verify function does the same as the /V switch does with 
  633.         the DOS COPY command.  Alt-F1 toggles whether or not verify is ON 
  634.         or OFF.  All that verify does is check to see if the file can be 
  635.         read after writing; as with the DOS /V switch it doesn't do a 
  636.         byte-by-byte comparison.  It simply checks whether DOS can read 
  637.         the newly copied data without an error.  And just as with DOS, 
  638.         the Verify switch command defaults to OFF because reading the 
  639.         data a second time to verify it obviously takes longer than 
  640.         omitting this step.  Today's disks are so reliable that you 
  641.         should probably leave Verify OFF.  The function was provided for 
  642.         those who sleep better with the /V switch.
  643.  
  644.  
  645.                                  Alt-F2 Confirm
  646.  
  647.         Alt-F2 Confirm works with F2 Copy, controlling whether or not 
  648.         DIRMAGIC warns you before it deletes a file.  By default, the 
  649.         Confirm switch is displayed as ON, so that you will be warned 
  650.         before any deletion.  However, if you feel confident about your 
  651.         typing abilities and have a lot of purging to do and don't want 
  652.         to be bothered with the extra Y confirmation keystroke that comes 
  653.  
  654.  
  655.                                        10
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.         with every deletion request, press Alt-F2 and OFF will be 
  665.         displayed next to Confirm.  Alt-F2 is a toggle so you can turn 
  666.         the Confirm function back on with another tap.  Warning: If you 
  667.         turn Confirm OFF and you press F2, the deletion is instantaneous.  
  668.         You will be given no second chance.
  669.  
  670.  
  671.                                  Alt-F3 Protect
  672.  
  673.         DOS lets you blithely copy old files over new ones.  DIRMAGIC is 
  674.         smart enough to avoid this.  
  675.  
  676.         You can use Alt-F3 to enable or disable protection in copying 
  677.         over existing files with the F1 Copy function.  The default is 
  678.         OFF, which lets you copy over files just as you can with the DOS 
  679.         COPY command.  But if you toggle Protection ON you will be given 
  680.         the choice to continue copying or abort if the target file 
  681.         already exists.
  682.  
  683.  
  684.                                    Alt-F4 Sort
  685.  
  686.         DIRMAGIC defaults to doing all directory sorts in ascending 
  687.         order, from A to Z.  F4 will toggle the sorting order from 
  688.         Ascending to Descending.  You can also change the default sorting 
  689.         order to Descending with the /R switch.
  690.  
  691.  
  692.                                  Alt-F5 HighBit
  693.  
  694.         WordStar and some other word processors set the high bit of an 
  695.         ASCII character on to control page formatting.  This will cause a 
  696.         normal text character to be displayed as a high bit graphics 
  697.         character.  DIRMAGIC by default strips this high bit so text 
  698.         files controlled in this manner will look normal when you view 
  699.         them.  However, if the file you wish to view has graphics 
  700.         characters you want displayed as graphics characters, press F6 
  701.         and the ON next to WordStar will be toggled OFF and DIRMAGIC will 
  702.         leave the high bit alone.  The WordStar toggle does the same 
  703.         thing as the Ctrl-QG in SideKick's Notepad.
  704.  
  705.  
  706.                                 Alt-F6 Attributes
  707.  
  708.         At the right edge of the directory listing you'll see the 
  709.         letter(s) H, S, R, or A beside any files that have an attribute of 
  710.         Hidden, System, Read-only, or Archive.  Alt-F6 will let you change 
  711.         three of these attributes -- H, R, and A.  Press Alt-F6 and 
  712.         DIRMAGIC will prompt you to enter the change in attribute(s) of 
  713.         the highlighted file or group of marked files.  
  714.  
  715.         To add an attribute, preface the attribute with a plus sign.  To 
  716.         remove an attribute preface it with a minus sign.  
  717.  
  718.         For example, to remove the archive attribute so the DOS BACKUP or 
  719.  
  720.  
  721.                                        11
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.         XCOPY commands won't back up a file, enter -A.  If you don't 
  731.         preface the attribute with either a plus or minus, DIRMAGIC will 
  732.         assume you wish to add the attribute.  Making a file read-only 
  733.         with +R prevents you or anyone else from accidentally deleting it 
  734.         or changing it or copying another file over it.  
  735.  
  736.         You can also change the attribute of directories.  Hiding a 
  737.         directory with a +H is an easy way to keep the files of a 
  738.         sensitive directory from easy reach of probing eyes.  Of course, 
  739.         if the intruder is familiar with DIRMAGIC, the protection scheme 
  740.         will be defeated, since DIRMAGIC will list the hidden directory.
  741.  
  742.  
  743.                                Alt-F7 File Search
  744.  
  745.         Press Alt-F7 and DIRMAGIC will ask for the name of a file to 
  746.         locate.  Enter a filename and DIRMAGIC will begin a diskwide 
  747.         search of the default drive (the one you logged DIRMAGIC onto at 
  748.         the DOS prompt) for that file.  Add a drive request to search a 
  749.         drive other than the default.  You can narrow down the search by 
  750.         adding a path.  For example, if the default drive is C: and you 
  751.         wish to look for MYFILE in the \BIN directory on A:, you would 
  752.         enter:
  753.  
  754.              A:\BIN\MYFILE
  755.  
  756.         You can use any combination of the wildcard global characters (* 
  757.         and ?) in the filename.  For example, to find all the files 
  758.         related to a file called THISFILE on the C drive, you would 
  759.         enter:
  760.  
  761.              THISFILE.*
  762.  
  763.         DIRMAGIC will clear the directory listing on the left side of the 
  764.         screen and list the directory and filename of all, if any, 
  765.         matching files.  You can stop the search at any time by pressing 
  766.         Esc.  The list of matches will pause if it fills the screen.  
  767.         Pressing any key will continue the search.
  768.  
  769.         When the search ends, if DIRMAGIC found a match it will give you 
  770.         the opportunity to load the directory in which the file was 
  771.         found.  If you press Y, the directory will be loaded and listed 
  772.         and the highlight bar will automatically be placed on the 
  773.         filename of interest.  Press either N or Esc to cancel the 
  774.         loading operation.
  775.  
  776.  
  777.                                  Alt-F8 New path
  778.  
  779.         Pressing Alt-F8 lets you load a new directory without leaving 
  780.         DIRMAGIC.  You will be prompted for a new path to list.  You can 
  781.         enter a drive/directory and any switch character just as if you 
  782.         were at the DOS prompt and starting DIRMAGIC.
  783.  
  784.  
  785.  
  786.  
  787.                                        12
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                             ==== Error Messages ====
  797.  
  798.         Requires 128K free RAM
  799.             DIRMAGIC requires 128K bytes of elbow room.  The load module 
  800.             is a small 8K for fast loading.  The balance of the 120K is 
  801.             used for buffering the directory listing, buffering a file 
  802.             for viewing, and buffering the fast file-copying operation.
  803.  
  804.         Invalid directory
  805.             DIRMAGIC could not find the directory requested to load.  If 
  806.             the default directory is other than the root, be sure to type
  807.             a complete path.  DIRMAGIC uses the default directory of 
  808.             the current drive rather than the currently loaded directory 
  809.             for all copying, moving, and PATH loading.  To avoid 
  810.             confusion, either load DIRMAGIC from the root directory or 
  811.             use a complete path for DIRMAGIC function arguments.
  812.  
  813.         Too many files
  814.             DIRMAGIC has room to buffer approximately 500 files.  It's 
  815.             recommended that you break directories larger than this into 
  816.             smaller directories.
  817.  
  818.         Not enough disk space
  819.             There was not enough room to copy or move your file.
  820.  
  821.         Error reading drive
  822.             You probably left a drive door open.  Insert a diskette, 
  823.             close the door, and press (R)etry to recover.  Press (Q)uit 
  824.             to abort and return to DOS.
  825.  
  826.         Error writing to printer
  827.             The printer is probably off or out of paper.  To recover, 
  828.             follow the same steps as in the above drive error.
  829.  
  830.          
  831.                                ==== DINSTALL ====
  832.  
  833.         DINSTALL will let you change the defaults of DIRMAGIC.  You don't 
  834.         have to be in the same directory as DIRMAGIC to change the 
  835.         defaults but you do have to be on the same drive.  If DIRMAGIC is 
  836.         not in the current directory, DINSTALL will do a diskwide search.  
  837.         Once it finds DIRMAGIC.COM, it will let you reconfigure the 
  838.         default settings of DIRMAGIC's Alt-key functions.
  839.  
  840.         For example, you might want DIRMAGIC to sort the directory 
  841.         listing by date in descending order so the most recently updated 
  842.         files will appear at the top of the list.  Instead of loading 
  843.         DIRMAGIC each time with /D/R (sort by date in reverse order) 
  844.         or having to change the defaults later with F10 Sort by daTe 
  845.         and Alt-F4 Sort Descending, change the defaults permanently with 
  846.         DINSTALL.  When you are satisfied with the changes, press Esc and 
  847.         DINSTALL will ask if you wish to write your changes to disk.
  848.  
  849.         DIRMAGIC will display and modify colors only in mode 3.  If you 
  850.         have a color monitor or a monochrome monitor with a color 
  851.  
  852.  
  853.                                        13
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.         graphics adapter and DINSTALL will not let you change the default 
  863.         colors (the options will not appear in the menu), you are in a 
  864.         mode other than color.  To change to mode 3, enter the DOS mode 
  865.         command MODE CO80.  You cannot change the colors on a monochrome 
  866.         adapter.
  867.  
  868.         F7 - F10 will let you change the colors.  Shift F7 - F10 will 
  869.         change the colors in reverse order. 
  870.  
  871.         Remember that DINSTALL will modify the program file only if it's 
  872.         named DIRMAGIC.COM.  And the DM F10 key will load DIRMAGIC only 
  873.         if you haven't changed its name from DIRMAGIC.COM.  Don't try 
  874.         renaming DIRMAGIC.COM to something like D.COM to make it easier 
  875.         to execute.  The easiest way to run it is by loading DM first and 
  876.         then pressing F10.
  877.  
  878.         But if you really do want to give it a shorter name, make a copy 
  879.         of it called something like D.COM each time you install or 
  880.         reinstall it.  The program itself is so small that an additional 
  881.         copy of it won't take up very much room.
  882.  
  883.  
  884.                                   ==== DM ====
  885.  
  886.         DM makes it a snap to create, remove, rename, hide, and unhide 
  887.         subdirectories and jump from one to another.  It can set and 
  888.         reset the read-only and archive bits of all files in a directory, 
  889.         and will report the file count and space taken up by all the 
  890.         files.  It can also run the main DIRMAGIC.COM program to handle 
  891.         individual files.
  892.  
  893.         You may run DM directly from the DOS prompt each time you want to 
  894.         use it, simply by typing:
  895.  
  896.              DM
  897.  
  898.         Or you can install it in memory so it leaps instantly into action 
  899.         every subsequent time you enter RN while in DOS.  To install it 
  900.         in memory and then immediately run it, type:
  901.  
  902.              DM /G
  903.  
  904.         If you want to load the map of subdirectories and the DM command 
  905.         into memory when you boot up, but you don't want to run it right 
  906.         away, add a line to your AUTOEXEC.BAT that says:
  907.  
  908.              DM /I
  909.  
  910.         All of these examples assume that DM.COM is either in the root 
  911.         directory (which it shouldn't be) or is in a subdirectory that 
  912.         your PATH knows about (which it should be).
  913.  
  914.         If no drive (d:) is specified, the current drive is assumed.
  915.  
  916.         You should load DM before SideKick and any other uninstallable 
  917.  
  918.  
  919.                                        14
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.         memory-resident programs.  DM cannot be deinstalled without 
  929.         rebooting.  It requires 128K of RAM and can grab a few more K on 
  930.         file-packed disks.  You can't summon DM from within another
  931.         application by pressing a hotkey; it can be popped up only at the 
  932.         DOS prompt.  Pressing Esc terminates DM's operations.
  933.                 
  934.         When you first run DM.COM, you'll see an alphabetized directory 
  935.         tree with the current listing highlighted and a menu listing the 
  936.         function keys used for its various directory services.  You can 
  937.         move the highlighted directory bar one entry at a time by the up 
  938.         and down arrow keys, and in larger increments with the Ctrl-PgUp 
  939.         and Ctrl-PgDn, PgUp and PgDn, and the Home and End keys.  Use the 
  940.         highlighted bar to identify the subdirectory you want to work on.
  941.  
  942.         When renaming (F2) and creating (F3) directories, do not enter 
  943.         a backslash (\) character.  However, be sure to include it when 
  944.         you add up the characters to see if the new path is shorter than 
  945.         the maximum DOS path length of 63 characters.  
  946.  
  947.         Note: F2 (Rename Directory) requires DOS 3.x.
  948.  
  949.         If you select and confirm RMDIR (F4), DM will delete all files 
  950.         within the directory (unless they are marked read-only) before 
  951.         removing the directory.  
  952.  
  953.         Hide/Unhide (F5) affects the directory name only, not the 
  954.         individual files inside it.  
  955.  
  956.         F6 and F7 (mark/unmark as read-only and set/reset the archive 
  957.         bit) toggle these bits on all files within the directory.  
  958.  
  959.         F8 updates the directory database if changes are made outside DM.  
  960.  
  961.         F9 displays a file count and tells how much space is allocated to 
  962.         a directory's files.  
  963.  
  964.         F10 calls DIRMAGIC.COM.
  965.  
  966.  
  967.                                ==== PRMANUAL ====
  968.  
  969.         If you want to print out a copy of this manual, and your printer 
  970.         is set to handle pages that are 66 lines long, just turn your 
  971.         printer on and type:
  972.              
  973.              PRMANUAL
  974.  
  975.         This will print out a copy of the manual (which has to be named 
  976.         MANUAL).
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.                                        15
  986.  
  987.  
  988.  
  989.  
  990.  
  991.