home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dosutils / dosed360.arj / DOSED.DOC < prev   
Text File  |  1991-03-09  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.        DOSED.COM     (DOS EDitor)                         [v1.0: 15/3-1989]
  5.        =========     ============
  6.  
  7.  
  8.  
  9.        Resident program (about 2800 bytes) that gives extended operations
  10.        on the DOS commandline. The three new functions are:
  11.  
  12.            * Editing
  13.            * History, recall previous commands
  14.            * Filename completion
  15.  
  16.  
  17.        DOSED can be distributed freely. There exists no warranty, and the
  18.        author shall not be liable for any loss of data due to using this
  19.        program. DOSED is written by
  20.  
  21.            Sverre H. Huseby
  22.            Frankendalsvn. 21
  23.            N - 3250 Larvik
  24.            Norway
  25.  
  26.            sverrehu@ifi.uio.no
  27.  
  28.  
  29.  
  30.  
  31.  
  32.        Editing
  33.        -------
  34.  
  35.        With DOSED it is possible to edit the current commandline using
  36.        the following keys:
  37.  
  38.            Special keys     | Ctrl-keys | Meaning
  39.            -----------------+-----------+--------------------------------
  40.            Left arrow       | Ctrl-S    | Move character left
  41.            Right arrow      | Ctrl-D    | Move character right
  42.            Ctrl-left arrow  | Ctrl-A    | Move word left
  43.            Ctrl-right arrow | Ctrl-F    | Move word right
  44.            Home             |           | Move to beginning of line
  45.            End              |           | Move to end of line
  46.            Ins              | Ctrl-V    | Toggle insert mode
  47.            Del              | Ctrl-G    | Delete character under cursor
  48.            BackSpace        | Ctrl-H    | Delete character left of cursor
  49.  
  50.        When insertmode is default (on or off, specified by the /I-switch),
  51.        the cursor is a normal underline. When toggled to not default, the
  52.        cursor is turned into a block.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.        History
  59.        -------
  60.  
  61.        Previous commands can be recalled using the following keys:
  62.  
  63.            Special keys     | Ctrl-keys | Meaning
  64.            -----------------+-----------+--------------------------------
  65.            Up arrow / F3    | Ctrl-E    | Recall previous command
  66.            Down arrow       | Ctrl-X    | Recall "next" command in the
  67.                             |           | circular buffer.
  68.            F1               |           | Recall previous command and
  69.                             |           | move to beginning of the line.
  70.  
  71.        The historybuffer is a circular buffer of 512 bytes, in which all
  72.        commands longer than 2 characters are stored.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.        Filename completion
  79.        -------------------
  80.  
  81.        When pressing Tab or Ctrl-I, DOSED will try to complete the filename
  82.        immediately to the left of the cursor. As an example, assume you
  83.        want to look at a file called README.TXT. (The underline character
  84.        symbolises the cursor, and should not be typed in.) You write
  85.  
  86.            TYPE R_
  87.  
  88.        an press Tab just after the R. If no more files starts with an R,
  89.        DOSED completes the filename and gives you the line
  90.  
  91.            TYPE README.TXT _
  92.  
  93.        A blank is added after the filename, to let you enter more
  94.        parameters.
  95.  
  96.        Now assume there was a file called RESTORE.COM in the same directory.
  97.        DOSED wouldn't know whether you wanted README.TXT or RESTORE.COM
  98.        since both starts with an R, so it completes as much as possible:
  99.  
  100.            TYPE RE_
  101.  
  102.        No blank is added, since the filename isn't complete. To get
  103.        README.TXT, you should type an A, and press Tab again.
  104.  
  105.            TYPE REA_
  106.  
  107.        This time DOSED knows the only file starting with REA is README.TXT,
  108.        and fully completes the filename.
  109.  
  110.            TYPE README.TXT _
  111.  
  112.        There's one more thing: If the file you want happens to be a
  113.        directory, DOSED appends a backslash (\) assuming you will enter a
  114.        more accurate path. As an example, assume our file README.TXT is
  115.        in a directory called \TOOLS, and that no other directories starts
  116.        with a T. You write
  117.  
  118.            TYPE \T_
  119.  
  120.        and press Tab. DOSED completes to
  121.  
  122.            TYPE \TOOLS\_
  123.  
  124.        Now you type an R, and press Tab again:
  125.  
  126.            TYPE \TOOLS\R_
  127.  
  128.        and DOSED faithfully completes the line to
  129.  
  130.            TYPE \TOOLS\README.TXT _
  131.  
  132.        (assuming no other file in \TOOLS starts with an R.)
  133.  
  134.  
  135.  
  136.  
  137.  
  138.        Starting DOSED
  139.        --------------
  140.  
  141.        DOSED can be started with or without parameters. If no parameters
  142.        are given, the program is activated with default insertmode set to
  143.        off. That means characters are overwritten as you type.
  144.  
  145.        Legal parameters are:
  146.  
  147.            OFF : Deactivates the program. It is not removed from memory,
  148.                  and can be reactivated with DOSED.
  149.  
  150.            /I  : Sets default insertmode to on.
  151.  
  152.            /Q  : Quiet. Only the identification line is displayed.
  153.                  For use in batchfiles.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.        Attention
  160.        ---------
  161.  
  162.        Be aware of the following:
  163.  
  164.            * Control-characters are no longer displayed as ^X, but rather
  165.              as the matching character in IBM's ASCII-table.
  166.  
  167.            * The normal commandline editing using the functionkeys are no
  168.              longer supported.
  169.  
  170.            * Commandlines shorter than 3 characters are not stored in
  171.              the historybuffer.
  172.  
  173.            * DOSED will only work when the keyboard is read using INT 21h,
  174.              function 0Ah. This is the methode used by COMMAND.COM.
  175.              Other shell-programs (like 4DOS) uses their own inputroutines,
  176.              causing DOSED to be inactive.
  177.  
  178.            * DOSED might cause problems when used with other programs that
  179.              reprogram INT 21h, function 0Ah. Try starting them in a
  180.              different order, and see if that works better.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.        Finally
  187.        -------
  188.  
  189.        If you decide to use DOSED, thanks! I would be glad to hear from
  190.        you if you find any bugs, or just to know that one more person uses
  191.        my program.
  192.  
  193.        And... please ignore my poor English. Hope you understand anyway!
  194.  
  195.  
  196.  
  197.                                                    Sverre.
  198.  
  199.