home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / dos / 004 / dosed.doc < prev   
Text File  |  1991-05-04  |  7KB  |  212 lines
  1.  
  2.  
  3.  
  4.        DOSED.COM     (DOS EDitor)                         [v1.0: 15/3-1989]
  5.        =========     ============
  6.  
  7.  
  8.  
  9.        Resident program (about 2700 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.            Bjoelsengt. 17
  23.            N-0468 Oslo
  24.            Norway
  25.  
  26.            Internet: 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.            Esc              | Ctrl-Y    | Clear line
  50.  
  51.        When insertmode is default (on or off, specified by the /I-switch),
  52.        the cursor is a normal underline. When toggled to not default, the
  53.        cursor is turned into a block.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.        History
  60.        -------
  61.  
  62.        Previous commands can be recalled using the following keys:
  63.  
  64.            Special keys     | Ctrl-keys | Meaning
  65.            -----------------+-----------+--------------------------------
  66.            Up arrow / F3    | Ctrl-E    | Recall previous command
  67.            Down arrow       | Ctrl-X    | Recall "next" command in the
  68.                             |           | circular buffer.
  69.            F1               |           | Recall previous command and
  70.                             |           | move to beginning of the line.
  71.  
  72.        The historybuffer is a circular buffer of 512 bytes, in which all
  73.        commands longer than 2 characters are stored.
  74.  
  75.  
  76.  
  77.  
  78.  
  79.        Filename completion
  80.        -------------------
  81.  
  82.        When pressing Tab or Ctrl-I, DOSED will try to complete the filename
  83.        immediately to the left of the cursor. As an example, assume you
  84.        want to look at a file called README.TXT. (The underline character
  85.        symbolises the cursor, and should not be typed in.) You write
  86.  
  87.            TYPE R_
  88.  
  89.        an press Tab just after the R. If no more files starts with an R,
  90.        DOSED completes the filename and gives you the line
  91.  
  92.            TYPE README.TXT _
  93.  
  94.        A blank is added after the filename, to let you enter more
  95.        parameters.
  96.  
  97.        Now assume there was a file called RESTORE.COM in the same directory.
  98.        DOSED wouldn't know whether you wanted README.TXT or RESTORE.COM
  99.        since both starts with an R, so it completes as much as possible:
  100.  
  101.            TYPE RE_
  102.  
  103.        No blank is added, since the filename isn't complete. To get
  104.        README.TXT, you should type an A, and press Tab again.
  105.  
  106.            TYPE REA_
  107.  
  108.        This time DOSED knows the only file starting with REA is README.TXT,
  109.        and fully completes the filename.
  110.  
  111.            TYPE README.TXT _
  112.  
  113.        There's one more thing: If the file you want happens to be a
  114.        directory, DOSED appends a backslash (\) assuming you will enter a
  115.        more accurate path. As an example, assume our file README.TXT is
  116.        in a directory called \TOOLS, and that no other directories starts
  117.        with a T. You write
  118.  
  119.            TYPE \T_
  120.  
  121.        and press Tab. DOSED completes to
  122.  
  123.            TYPE \TOOLS\_
  124.  
  125.        Now you type an R, and press Tab again:
  126.  
  127.            TYPE \TOOLS\R_
  128.  
  129.        and DOSED faithfully completes the line to
  130.  
  131.            TYPE \TOOLS\README.TXT _
  132.  
  133.        (assuming no other file in \TOOLS starts with an R.)
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        Starting DOSED
  140.        --------------
  141.  
  142.        DOSED can be started with or without parameters. If no parameters
  143.        are given, the program is activated with default insertmode set to
  144.        off. That means characters are overwritten as you type.
  145.  
  146.        Legal parameters are:
  147.  
  148.            /?   :
  149.            /H   : Show short help.
  150.  
  151.            /I   : Set default insertmode to ON.
  152.  
  153.            /Q   : Quiet - Supress messages. Must be the 1st parameter.
  154.                   For use in batchfiles.
  155.  
  156.            /OFF : Deactivate the program. It is not removed from memory,
  157.                   and can be reactivated with DOSED.
  158.  
  159.            /U   : Uninstall if possible. No later TSR must have hooked
  160.                   the vector for INT 21h.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.        Attention
  167.        ---------
  168.  
  169.        Be aware of the following:
  170.  
  171.            * Control-characters are no longer displayed as ^X, but rather
  172.              as the matching character in IBM's ASCII-table.
  173.  
  174.            * The normal commandline editing using the functionkeys are no
  175.              longer supported.
  176.  
  177.            * Commandlines shorter than 3 characters are not stored in
  178.              the historybuffer.
  179.  
  180.            * DOSED will only work when the keyboard is read using INT 21h,
  181.              function 0Ah. This is the methode used by COMMAND.COM.
  182.              Other shell-programs (like 4DOS) uses their own inputroutines,
  183.              causing DOSED to be inactive.
  184.  
  185.            * DOSED might cause problems when used with other programs that
  186.              reprogram INT 21h, function 0Ah. Try starting them in a
  187.              different order, and see if that works better.
  188.              As a rule of thumb: DOSED should be started first, since it
  189.              won't give control to any earlier programs!
  190.  
  191.            * The environment-block is freed to save memory. This makes it
  192.              impossible for memory mapping programs to find the name of
  193.              DOSED.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.        Finally
  200.        -------
  201.  
  202.        If you decide to use DOSED, thanks! I would be glad to hear from
  203.        you if you find any bugs, or just to know that one more person uses
  204.        my program.
  205.  
  206.        And... please ignore my poor English. Hope you understand anyway!
  207.  
  208.  
  209.  
  210.                                                    Sverre.
  211.  
  212.