home *** CD-ROM | disk | FTP | other *** search
/ CICA 1995 May / cica_0595_4.zip / cica_0595_4 / UTIL / WINCMD78 / README.TXT < prev    next >
Text File  |  1995-02-12  |  14KB  |  328 lines
  1.                         README FILE FOR WCL
  2.                         ------------------
  3. *********
  4. * NOTE: *
  5. *********
  6.  
  7.        PLEASE READ ALL OF THIS DOCUMENTATION BEFORE USING WCL. Also,
  8.        WCL is VERY customisable through entries in WCL.INI. That file
  9.        contains a lot of comments on the customisation features.
  10.  
  11.        PLEASE READ WCL.INI, and HISTORY.TXT before using WCL - otherwise
  12.        you will be missing some of its greatest benefits.
  13.  
  14.  
  15. README
  16. ------
  17. The Windows Command Line Processor (WCL) is a program that presents a
  18. fully featured DOS-like command line interface for Microsoft's
  19. Windows 3.1x and IBM's Win-OS/2. For Windows users, it is the best way
  20. of avoiding the dreaded "MSDOS PROMPT", while still having the benefit
  21. of a command prompt, and all the benefits of the Windows environment.
  22. For OS/2 users, it is one of the easiest ways of starting "seamless"
  23. Windows sessions, and in all cases, it is always a *far* better option
  24. than using Program Manager's "File, Run" menu, or opening the "MSDOS
  25. PROMPT"
  26.  
  27. WCL basically simulates the DOS "C:\> prompt", but from within Windows
  28. or Win-OS/2. The WCL main Window is a small, unobtrusive window which
  29. defaults to the top left corner of the screen. It occupies very litte
  30. screen space, meaning that most of the rest of the screen is visible.
  31.  
  32. You can then run Windows and DOS programs by typing their names and
  33. pressing <ENTER>, just as you would do at the DOS command line.
  34. If you are running OS/2 version 2.1, then you can also run OS/2
  35. programs from within WCL. OS/2 users should please NOTE that WCL
  36. will only run DOS and OS/2 programs under OS/2 as well as the Program
  37. Manager will run them, since WCL uses the same API calls to run programs
  38. as the Program Manager. Some OS/2 programs will not run at all, if run
  39. from a Win-OS/2 session, and some DOS programs behave quite strangely
  40. if run from Win-OS/2.
  41.  
  42. WCL is a neat, fast, and effective way for multi-tasking under Windows,
  43. and Win-OS/2, and can replace the Program Manager as your Windows or
  44. Win-OS/2 Shell. It also supports most of the internal DOS commands
  45. (e.g., COPY, DIR, CD, MD, DEL, REN, ATTRIB, DATE, TIME, SET, etc.)
  46. through built-in technology.
  47.  
  48. This file only contains instructions as to how to setup WCL. Full
  49. documentation is contained in the on-line help, which is available
  50. if you type "HELP" at the WCL command prompt.
  51.  
  52. Please read WCL.INI, and the on-line help, especially the
  53. section titled "LEGAL STUFF" ** BEFORE ** attempting to use WCL.
  54.  
  55.  
  56. Files
  57. -----
  58. The WCL package contains the following files;
  59.  
  60. Essential Files
  61. ---------------
  62.    1.  WCL.EXE         (WCL main executable)
  63.    2.  BIGWCL.EXE      (WCL main executable)
  64.    3.  BWCC.DLL        (Custom Control library needed by all the executables)
  65.    4.  GENDLL1.DLL     (binary LIB file needed by all the executables)
  66.    5.  WCLCODE.DLL     (binary LIB file needed by all the executables)
  67.    6.  WCLCODE2.DLL    (binary LIB file needed by all the executables)
  68.    7.  WCLSHAR1.WXX    (binary LIB file needed by all the executables)
  69.    8.  WCLSHAR2.WXX    (binary LIB file needed by all the executables)
  70.    9.  WCLCFG.EXE      (configuration program for WCL)
  71.    10. WCL.INI         (initialization file for WCL. Please read it!)
  72.    11. WCL.HLP         (WCL help file)
  73.    12. FILES.WCL       (long descriptions of files are kept here)
  74.    13. MENU-S.WCL      (user menus for WCL.EXE)
  75.    14. MENU-B.WCL      (user menus for BIGWCL.EXE)
  76.    15. KEYS.WCL        (file for assigning commands to function keys)
  77.    16. WCL.SUM         (an alphabetical list of internal commands)
  78.    17. REGISTER.TXT    (form for REGISTRATION requests)
  79.    18. ORDER.FRM       (fill-in form for ordering a registered copy)
  80.  
  81. Non-Essential Files
  82. -------------------
  83.    19. INSTALL.EXE     (WCL installation program)
  84.    20. INSTALL2.EX_    (part of the installation program)
  85.    21. WINSTALL.INF    (information file for the installation program)
  86.    22. WINSTALL.HLP    (ON-LINE HELP file for the installation program)
  87.    23. WINSTALC.DLL    (binary LIB file for the installation program)
  88.    24. WINSTALP.DLL    (binary LIB file for the installation program)
  89.    25. SETUPWCL.CBF    (sample WCL script file)
  90.    26. README.TXT      (this file)
  91.    27. HISTORY.TXT     (file that shows changes between WCL versions)
  92.    28. FAQ.WCL         (WCL Frequently Asked Questions list)
  93.    29. WCL_EXT.ZIP     (documentation for WCL interface for user defined
  94.                         extensions)
  95.  
  96. Bonus Programs supplied with THE OPTIONAL EXTRA ONLY
  97. ----------------------------------------------------
  98.    30. EXITWIN.EXE     (exits Windows without fuss or question)
  99.    31. RUNWIN.EXE      (shuts down and restarts Windows without fuss)
  100.  
  101.  
  102.    Note: BIGWCL.EXE is now needed for proper running of WCL. The
  103.    library file WCLDLL.EXE has been merged with BIGWCL.EXE
  104.  
  105.    **************
  106.    * Note also: *
  107.    **************
  108.          The initialization file WCL.INI contains a lot of settings which
  109.          will determine the attributes of the main windows of both WCL.EXE
  110.          and BIGWCL.EXE. I have designed the program to be highly
  111.          customizable by these settings.
  112.  
  113.          It is important that you read this file, as it contains a lot of
  114.          information/comments on particular settings. Feel free to
  115.          experiment with the settings. You can call up this file into the
  116.          Windows NOTEPAD by typing "CHG2" at the WCL prompt.
  117.  
  118.          For those who are a bit wary of making manual entries in INI
  119.          files, I have supplied a configuration program (WCLCFG.EXE).
  120.          Most of the entries in WCL.INI can be set from this program.
  121.  
  122.          It is also important to read HISTORY.TXT to see full details of
  123.          the new features that have been implemented. This is essential
  124.          even if you are a new user, since the information in the file
  125.          can also serve as a feature summary.
  126.  
  127.  
  128. Setting up WCL
  129. --------------
  130. There are two methods of installing WCL;
  131.  
  132.   1. You may install WCL by simply copying the "essential files"
  133.      listed above onto your hard disk, preferably into a separate
  134.      directory. If you use this method, then you need to create
  135.      Program Manager items for WCL.EXE and BIGWCL.EXE.
  136.  
  137.      You may need to add the WCL directory to the "path" statement
  138.      in your AUTOEXEC.BAT file, or alternatively, to move BWCC.DLL
  139.      into a directory that is in the "path" statement.
  140.  
  141.  2. You may run the optional installation program (INSTALL.EXE).
  142.     What this installation program does is;
  143.        [a] install the "essential files" into a directory specified
  144.            by you
  145.        [b] optionally that directory to the "path" statement in your
  146.            AUTOEXEC.BAT file. This will be needed to allow Windows
  147.            to locate the library file BWCC.DLL and the other DLLs
  148.        [c] optionally create a Program Manager group for WCL and
  149.            Program Manager items for WCL.EXE and BIGWCL.EXE
  150.  
  151.     To run the installation program, take the following steps;
  152.        1. Select "File, Run" from within Program Manager, and type
  153.           "A:INSTALL" (if your installation diskette is in floppy drive
  154.           "A:" If you are installing from another drive/directory, then
  155.            substitute it for the "A:")
  156.  
  157.       2.   When the installation program loads, click on the check
  158.            box titled "Click here to create Program Manager Item",
  159.            if you want the installation program to create a Program
  160.            Manager Group/Item for WCL. If you want to do this manually,
  161.            then you can leave the check box unselected.
  162.  
  163.       3.   To start the installation, click on the button labelled
  164.            "Start Install". When you do this, you will be presented
  165.            with a dialog box which indicates the directory that you
  166.            are installing FROM (source directory), and the default
  167.            target directory (i.e., the directory that you want to install
  168.            the program to). You can edit the TARGET directory if you do
  169.            not like the default.
  170.  
  171.       4.   When satisfied with the source and target directories,
  172.            click on the button labelled "Install Now". If you want
  173.            to go back to the beginning, click on the button labelled
  174.            "Abort".
  175.  
  176.  
  177.       When the installation is finished, the install program will
  178.       volunteer to add the new program path to the "PATH" statement
  179.       in your AUTOEXEC.BAT. You will be invited to confirm or skip
  180.       this process.
  181.  
  182.  
  183. If you want WCL to load each time you start Windows, you can put
  184. "WCL.EXE" on the "run=" or "load=" lines in your WIN.INI file,
  185. or put it in your STARTUP group.
  186.  
  187.  
  188.  ------------
  189.  REGISTRATION
  190.  ------------
  191.  This program is published under the SHAREWARE principle. This means that
  192.  users are entitled to use it for an evaluation period of 30 days. If you
  193.  wish to continue using it after this evaluation period, you are requested
  194.  to please REGISTER your copy, or DELETE the program from your disks.
  195.  
  196.  Please look in REGISTER.TXT or in the on-line help for details of my
  197.  world wide REGISTRATION SITES (you will probably find one that is local
  198.  to you). PLEASE PRINT OUT ORDER.FRM, or the REGISTRATION FORM in the
  199.  on-line help.
  200.  
  201. *******************
  202.  REGISTRATION FEE:
  203. *******************
  204.  
  205.    STANDARD REGISTRATION
  206.    ---------------------
  207.    ú18.00    (U.K. STERLING)
  208.    $26.00    (U.S.)
  209.    $30.00    (Canadian): British Columbia residents should add 7% Sales Tax
  210.    $40.00    (Australian)
  211.    Kr170.00  (Danish)
  212.  
  213.    On payment of this fee, you will receive a serial number, and a
  214.    registration code which you will use to convert your copy into a
  215.    registered version, and which you can also use to FREELY register
  216.    subsequent shareware releases, until the next MAJOR release.
  217.  
  218.    OPTIONAL EXTRA
  219.    --------------
  220.    If you would prefer to be sent the most current version of WCL
  221.    (instead of just a serial number and code), this can be done. Please
  222.    see the file REGISTER.TXT for details of the extra charges applicable.
  223.  
  224.  
  225.    Registration provides the following benefits:
  226.    ---------------------------------------------
  227.  
  228.    1. When you register your copy of WCL, you will be sent a SERIAL
  229.       NUMBER and a code which you will apply to your copy to convert
  230.       it into a registered version. This will;
  231.  
  232.       [a] remove all registration reminders - no more conscience-pricking
  233.           nagging messages!
  234.  
  235.       [b] register your copy of WCL to you - you will become an officially
  236.           registered user of WCL, and your registration details will be
  237.           written into the executables.
  238.  
  239.       [c] enable you to freely register all subsequent releases up
  240.           to the next major upgrade, without reference to me, and WITHOUT
  241.           ANY CHARGE (minor upgrades are numbered in .01 increments, while
  242.           major upgrades are number in .10 increments: MAJOR upgrades
  243.           require a 50% upgrade fee).
  244.  
  245.       [d] Basically, you should feel free to obtain and apply the code to
  246.           all subsequent shareware releases, until the registration code
  247.           which you will receive stops working. That will be the signal
  248.           that you now need to pay the upgrade fee.
  249.  
  250.       [e] when you type "VER", you will see your SERIAL NUMBER, and
  251.           your NAME (as the registeree) - this is the information that
  252.           you must use to register subsequent releases.
  253.  
  254.    2. Support for the program
  255.    3. A clear conscience
  256.    4. The satisfaction of being an honest person
  257.  
  258.    AND,
  259.  
  260.    IF YOU REGISTER WITH THE OPTIONAL EXTRA;
  261.    ----------------------------------------
  262.     1. If requested, a wordprocessed copy of the on-line help in Windows
  263.        WRITE format. Note that this file is NOT well formatted. It is
  264.        just a direct dump of the WCL.HLP help file into a format that
  265.        can be read by Windows WRITE. This is useful if you want printed
  266.        documentation, as you can then just print out the file.
  267.  
  268.     2. Complimentary copies of some of my Windows utilities, namely;
  269.  
  270.         [a] EXITWIN.EXE (click on the icon of this program, and you
  271.                          quit Windows - no fuss, no warnings, no
  272.                          questions)
  273.         [b] RUNWIN.EXE  (click on the icon of this program, and Windows
  274.                          is shut down and restarted again - useful for
  275.                          those occasions when you need to reboot Windows,
  276.                          e.g. you have just installed a new device driver,
  277.                          or something has corruped Windows, and you want
  278.                          to restart it).
  279.  
  280.  *****
  281.  NOTE:
  282.  *****
  283.  Please note that there is NO printed manual. What I can provide in
  284.  lieu of this is the on-line help (WCL.HLP) in a wordprocessor file
  285.  format, for those who take the OPTIONAL EXTRA registration, and
  286.  request it (see above).
  287.  
  288.  
  289.        Please send payment to:
  290.  
  291.                 Dr. A. Olowofoyeku
  292.                 57 Baddeley Green Lane
  293.                 Baddeley Green
  294.                 Stoke-on-Trent
  295.                 STAFFS ST2 7JL
  296.                 England.
  297.  
  298.                 Internet:
  299.                    laa12@keele.ac.uk
  300.                    chief@mep.com
  301.               
  302.                 Compuserve:
  303.                    100415,3414
  304.  
  305.         OR
  306.  
  307.         to your local REGISTRATION SITE,
  308.  
  309.     OR
  310.  
  311.         GO SWREG (on Compuserve; SWREG ID 3445 (for standard registration)
  312.            or 3429 (for "optional extra"))
  313.  
  314. NOTE: Please write "WCL REGISTRATION" clearly on the envelope. Failure
  315. to do so will result in your order being delayed.
  316.  
  317.  
  318. ************************************************************************
  319. NOTE:
  320. WCL has an UNZIP command, which is based on freeware Borland Pascal
  321. source code produced by the internet group INFO-ZIP. The Pascal source
  322. is freely distributable, and any user of WCL can obtain a copy from me,
  323. on payment of 5 Pounds Sterling (Note: U.K. funds ONLY) to cover the
  324. costs of copying, shipping, and handling. Note that the source code
  325. itself is FREE.
  326.  
  327. ************************************************************************
  328.