home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / 4DOS / 4EDIT / 4EDIT.TXT < prev    next >
Text File  |  1993-12-01  |  14KB  |  429 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                  4EDIT USER'S GUIDE
  12.  
  13.                                    DECEMBER 1990
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                                     _______
  26.                                                ____|__     |               (tm)
  27.                                             --|       |    |-------------------
  28.                                               |   ____|__  |  Association of
  29.                                               |  |       |_|  Shareware
  30.                                               |__|   o   |    Professionals
  31.                                             -----|   |   |---------------------
  32.                                                  |___|___|    MEMBER
  33.  
  34.                                                           Iram J. Weinstein
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                       XD SYSTEMS
  49.                                     1014 SHIPMAN LANE
  50.                                     MCLEAN, VA 22101
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                CONTENTS
  59.  
  60.  
  61.  
  62.              Limited Warranty                                      1
  63.  
  64.              Background                                            2
  65.  
  66.              4EDIT Usage                                           2
  67.  
  68.              Regarding Registration                                3
  69.  
  70.              4EDIT Version History                                 4
  71.  
  72.              4ZIP/4UNZIP                                           5
  73.  
  74.              Software Registration Form and Order                  6
  75.  
  76.  
  77.  
  78.                           LIMITED WARRANTY
  79.  
  80.              XD Systems warrants the physical diskette enclosed herein
  81.         to be free of defects in materials and workmanship for a period
  82.         of 60 days from the date of purchase.  In the event of notification
  83.         within the warranty period of defects in material or workmanship,
  84.         XD Systems will replace the defective diskette.
  85.  
  86.              XD Systems specifically disclaims all other warranties,
  87.         express or implied, including but not limited to implied warranties
  88.         of merchantability and fitness for a particular purpose.  In no
  89.         event shall XD Systems be liable for any loss of profit or any
  90.         other commercial damage, including but not limited to special,
  91.         incidental, consequential or other damages arising out of the use,
  92.         the result of use, or inability to use this product.
  93.  
  94.         This program is produced by a member of the Association of
  95.         Shareware Professionals (ASP).  ASP wants to make sure that the
  96.         shareware principle works for you.  If you are unable to resolve a
  97.         shareware-related problem with an ASP member by contacting the
  98.         member directly, ASP may be able to help.  The ASP Ombudsman can
  99.         help you resolve a dispute or problem with an ASP member, but does
  100.         not provide technical support for members' products.  Please write
  101.         to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
  102.         a Compuserve message via easyplex to ASP Ombudsman 70007,3536
  103.  
  104.         4DOS is a trademark of J.P. Software.  PKZip and PKUnzip are
  105.         trademarks of PKWare.  4EDIT and all the files and document-
  106.         ation distributed with it are copyright 1990 by Iram J. Weinstein.
  107.         All rights reserved.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                   1
  136.  
  137.  
  138.                                 4EDIT User's Guide
  139.  
  140.                                Copyright (C) 1990
  141.                                  I. J. Weinstein
  142.  
  143.         A.BACKGROUND
  144.  
  145.              In 1988, I wrote and distributed a shareware program, XDIR,
  146.         which was one of the first DOS directory programs to attach a
  147.         comment to each file.  When I first saw 4DOS, I loved it, but
  148.         I wanted to have the same sort of full-screen editor for directory
  149.         comments (or, in 4DOS terms, Descriptions) that I had in XDIR.
  150.  
  151.              4EDIT provides this feature.  I think you will find it very
  152.         useful.  Its good practice to comment your files, and often its
  153.         handy to see the descriptions attached to other files, while you
  154.         are writing a new one.
  155.  
  156.              4EDIT reads the DESCRIPT.ION files produced by 4DOS and
  157.         allows you to modify them, or creates a new file if 4DOS has
  158.         not already provided one.  You should know that the DESCRIPT.ION
  159.         file is a hidden file.  You will not see it in the DOS directory
  160.         unless you change the file attribute or use the 4DOS DIR /h
  161.         option.
  162.  
  163.         B. 4EDIT USAGE
  164.  
  165.              4EDIT Usage is:
  166.  
  167.                 4EDIT [d:][path][filespec] [+ filespec] [+..]
  168.  
  169.              A directory display similar to that of SELECT will appear
  170.         showing all of the files meeting any of the filespecs. This
  171.         use of include lists is identical to the 4DOS 3.0 DIR and
  172.         SELECT usage.  Note that only the first argument in an include
  173.         list can have a pathname; subsequent arguments default to the
  174.         same path.
  175.  
  176.              You can cursor around the screen using <Up>, <Dn>, <PgUp>,
  177.         <PgDn>, <Ctrl-PgUp> and <Ctrl-PgDn>.  At any row, you can start
  178.         typing.  This will automatically start the EDIT mode, and a
  179.         cursor will appear.  Typing will start at the beginning of the
  180.         description in Insert mode.  The editor is WordStar compatible
  181.         and also supports the following:
  182.  
  183.          <Esc>                        Quit without saving
  184.          <Enter>                      End edit. Save changed Descriptions
  185.          <PgUp>                       Cursor back one screen
  186.          <PgDn>                       Cursor forward one screen
  187.          <Ctrl-PgUp>                  Cursor to top of first screen
  188.          <Ctrl-PgDn>                  Cursor to end of last screen
  189.          <Left>                       Cursor left one character
  190.          <Right>                      Cursor right one character
  191.          <CtrlLeft>                   Cursor left one word
  192.          <CtrlRight>                  Cursor right one word
  193.          <Home>                       Cursor to beginning of line
  194.          <End>                        Cursor to end of line
  195.                                    2
  196.  
  197.          <Del>                        Delete character at cursor
  198.          <Bksp>                       Delete character to left of cursor
  199.          <CtrlEnd>                    Delete to end of line
  200.          <CtrlY>,<CtrlX>              Delete entire line
  201.          <CtrlHome>                   Delete from beginning of line
  202.          <CtrlT>                      Delete word to right of cursor
  203.          <CtrlR>                      Restore original contents of line
  204.  
  205.          <Ins>                        Toggle INSERT on and off. Thin cursor
  206.                                       indicates overwrite mode; thicker
  207.                                       cursor indicates insert mode (default).
  208.  
  209.  
  210.         C. REGARDING REGISTRATION
  211.  
  212.              4EDIT is ShareWare. The law requires that if you use this
  213.         program, you must register and obtain a license for it.
  214.         The registration fee is $15.
  215.  
  216.              Registered users will be notified of upgrades to 4EDIT as
  217.         they are released, and will receive the latest version of the
  218.         program.  Online help is available through CompuServe, by
  219.         EasyPlex.  Help is also available by mail. I will try to answer
  220.         all letters within 48 hours. Non-registered users must include
  221.         a SASE for a reply. The degree of help available to non-registered
  222.         users is purely discretionary. Registrations and inquiries should
  223.         be sent to:
  224.  
  225.                                  Iram J. Weinstein
  226.                                  XD Systems
  227.                                  1014 Shipman Lane
  228.                                  McLean, VA 22101
  229.                                    Voice (703) 821-3215
  230.                                    CIS 70741,3711
  231.  
  232.              A registration form is included at the end of this manual.
  233.  
  234.              Commercial use of 4EDIT without payment of the registration
  235.         fee is prohibited. Site licenses are available for users with
  236.         multiple machines. Please contact me for information.
  237.  
  238.              The program and its associated documentation are the
  239.         copyrighted property of the author. Non-commercial users
  240.         are granted the right to use copy and share 4EDIT with the
  241.         following conditions:
  242.  
  243.              Shareware distributors and Users Groups may charge a
  244.         nominal fee for copying and distributing this program
  245.         and Bulletin Board Systems may likewise carry it. Any
  246.         distribution of 4EDIT must include without alteration only the
  247.         files 4EDIT.EXE and 4EDIT.TXT, unchanged.  Permission is
  248.         also given for electronic distribution of archived versions of
  249.         these files on electronic bulletin boards.
  250.  
  251.                                   3
  252.  
  253.  
  254.  
  255.         D. 4EDIT VERSION HISTORY
  256.  
  257.         Ver 0.90 (Beta Test) 12/01/89
  258.           This is the original release.  It used batch files to drive
  259.           4edit and could only run under 4DOS.
  260.  
  261.         Ver 0.91 (Beta Test) 12/20/89
  262.           4EDIT now stands alone, and can be run under DOS.
  263.  
  264.         Ver 0.92 (Beta Test) 1/18/90
  265.          Corrected error causing highlighted row to blink on some machines.
  266.          Modified so that EDIT function is always active.
  267.          Correct command line parser so that  C: ==> C:*.*
  268.          and ABC ==> ABC\*.* if ABC is a directory but ABC.* otherwise.
  269.  
  270.         Ver 0.93 (Beta Test) 2/04/90
  271.          This is mostly bug cleanup.
  272.          1. Entering the editor with a right arrow positioned the cursor
  273.          to the second character of an existing description, but to the
  274.          first character of an empty description.  Fixed to always go to
  275.          the first character position.
  276.          2. Cursor size in Insert mode made larger and easier to
  277.          distinguish from overstrike mode.
  278.          3. 4EDIT lost descriptions on some files in big directories. Now
  279.          fixed.
  280.          4. Use of wildcard symbols * and ? changed to match 4DOS extended
  281.          features.
  282.          5.Ver 0.92 tried to correct command line parser so that
  283.          C: ==> C:*.* and ABC ==> ABC\*.* if ABC is a directory but
  284.          ABC.* otherwise. Got it right this time!
  285.          6. The default state of the editor is insert mode.  This used to be
  286.          reset on each line.  Now 4EDIT remembers if you toggle insert mode
  287.          and starts the next line in the state you left it.
  288.  
  289.         Version 1.0  3/11/90
  290.          First public release
  291.  
  292.         Version 1.01  3/21/90
  293.          Minor changes in documentation.
  294.  
  295.         Version 1.02  4/01/90
  296.          Changed file access to run on networks reliably.
  297.          Added name and serial number on registered copies.
  298.  
  299.         Version 1.03  6/10/90
  300.         Modified to correct for 4DOS 3.0 quirk. Entries in DESCRIPT.ION
  301.         are sometimes delimited by LF instead of CRLF.  Earlier versions
  302.         of 4EDIT misread these lines.
  303.  
  304.  
  305.         Version 1.04 8/03/90
  306.         Added Error Messages for Drive unready and Disk write-protected.
  307.         4EDIT a: is now equivalent to 4EDIT a:*.*
  308.  
  309.  
  310.  
  311.  
  312.                                     4
  313.  
  314.  
  315.         Version 1.05 10/21/90
  316.         A problem with include lists that caused the same file to be selected
  317.         more than once has been corrected. For example, 4EDIT *.txt+4*.txt
  318.         would show the file 4zip.txt twice.
  319.  
  320.         Many users have complained about my use of ENTER to mean EXIT. So I
  321.         have changed the key usage as follows:
  322.  
  323.              F10    -  Exit 4EDIT, saving all Description changes.
  324.              ENTER  -  Same as cursor down
  325.              Esc    -  If current line has been edited, restore it to original.
  326.                        Otherwise, Exit 4Edit without saving changes.
  327.  
  328.         The cursor is now ON at all times.
  329.  
  330.         In addition, you can now copy the description from one line,
  331.         using CTRL-C, and paste it into another line, using CTRL-P.
  332.  
  333.         Version 1.06 12/02/90
  334.         4EDIT would hang up if used on a directory that contained
  335.         only subdirectories.  Now fixed.
  336.         
  337.      E. 4ZIP/4UNZIP
  338.  
  339.              Also take a look at 4ZIP and 4UNZIP.  These are also
  340.         utilities for use with 4DOS.  These programs are shells that
  341.         use the PKWare programs PKZIP and PKUNZIP.  They provide a
  342.         facility for ZIPping and UNZIPping selected files along with
  343.         the 4DOS directory comments.  Both provide a full screen SELECT
  344.         screen, allowing you to easily pick the files to enter or
  345.         remove from the ZIP file. The 4ZIP/4UNZIP package is shareware,
  346.         available on Bulletin Boards and from shareware distributors.
  347.         Registration is $15.  See the order form at the end of this
  348.         manual.
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.                                     5
  372.  
  373.  
  374.  
  375.                   SOFTWARE REGISTRATION FORM AND ORDER
  376.  
  377.  
  378.  
  379.  Check all that apply:
  380.  
  381.    [ ] 4EDIT registration            _____ @ $15.00
  382.  
  383.    [ ] 4ZIP/4UNZIP registration      _____ @ $15.00
  384.  
  385.        TOTAL ENCLOSED: $______
  386.  
  387.  
  388.              If you already have copies of the programs you are
  389.         ordering , where were they obtained?
  390.  
  391.     [ ]CompuServe [ ]Friend [ ]Employer [ ]BBS ______________________
  392.  
  393.     [ ]ShareWare Distributor ________________________________________
  394.  
  395.  
  396.   Payment is by check[ ] or money order[ ] (Sorry - no COD or charges)
  397.  
  398.  
  399.  
  400.         NAME    ___________________________________________
  401.  
  402.         COMPANY ___________________________________________
  403.  
  404.         ADDRESS ___________________________________________
  405.  
  406.         CITY    ___________________________________________
  407.  
  408.         STATE   __________________________ZIP _____________
  409.  
  410.  
  411.  
  412.         Send your registration form and payment to:
  413.  
  414.                        XD Systems
  415.                        1014 Shipman Lane
  416.                        McLean, VA 22101
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                                   6
  428.  
  429.