home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dosutils / appath11.arj / APPATH.DOC next >
Encoding:
Text File  |  1991-06-15  |  11.6 KB  |  293 lines
  1.                     ╔═══════════════════════════════════════╗
  2.                     ║                                       ║
  3.                     ║     ▓█▀█ ▓█▀█ ▓█▀█ ▓█▀█ ▓███ ▓█ █     ║
  4.                     ║     ▓█▄█ ▓█▄█ ▓█▄█ ▓█▄█  ▓█  ▓█▄█     ║
  5.                     ║     ▓█ █ ▓█   ▓█   ▓█ █  ▓█  ▓█ █     ║
  6.                     ║                                       ║
  7.                     ║             version  1.10             ║
  8.                     ╚╤═════════════════════════════════════╤╝
  9.                      │Copyright (C) 1991 by TRI-SYSTEMS co.│
  10.                      │       - ALL RIGHTS RESERVED -       │
  11.                      │     Written by Johan Zwiekhorst     │
  12.                      └─────────────────────────────────────┘
  13.  
  14.  
  15.                        T A B L E   O F   C O N T E N T S
  16.                        *********************************
  17.  
  18.       1. LEGAL STUFF
  19.          The no-nonsense licence statement
  20.          Warranty
  21.          Contact
  22.          Payment
  23.          What you should have received
  24.  
  25.       2. INTRODUCTION
  26.          Note about the environment
  27.  
  28.       3. USAGE
  29.  
  30.       4. REVISION HISTORY
  31.  
  32. ═══════════════════════════════════════════════════════════════════════════════
  33.  
  34.  
  35.       ╒════════════════╕
  36.       │ 1. LEGAL STUFF │
  37.       ╘════════════════╛
  38.  
  39.       This software is copyrighted (C) 1988 by Johan Zwiekhorst.
  40.       This software is copyrighted (C) 1991 by TRI-SYSTEMS co., hereafter
  41.       called the Owner. All Rights Reserved.
  42.       The software was written by Johan Zwiekhorst, hereafter called the
  43.       Author.
  44.  
  45.       The No-Nonsense Licence Statement
  46.       =================================
  47.       This software and everything enclosed with it are protected by both
  48.       Belgian copyright law and international treaty provisions.
  49.       It is called "freeware".
  50.  
  51.       FREEWARE software may be used, copied and distributed freely for
  52.       NONCOMMERCIAL use only IF:
  53.       ▀▀▀▀▀▀▀▀▀▀▀▀▀
  54.  
  55.               NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION.
  56.  
  57.               IT IS NOT MODIFIED IN ANY WAY.
  58.  
  59.       It may be distributed ONLY in it's original, unmodified compressed
  60.       package file.                                ~~~~~~~~~~
  61.  
  62.       This means you may not add comments to the compressed package file
  63.       (also known as an archive file or simply an archive), nor may you
  64.       delete files from or add files to the archive file, UNLESS YOU HAVE
  65.       A WRITTEN PERMISSION TO DO SO.
  66.  
  67.       Converting the archive file to another compression method or
  68.       another archive file format is allowed, provided that the above
  69.       conditions are met.
  70.  
  71.       The original package as released by me is in Yoshi's LZH archive
  72.       format. (See below for what you should have received.)
  73.       In order to extract the files from an LZH archive, you will need
  74.       to get the file LHA***.EXE, where '***' stands for the version
  75.       number of the program LHA.  At the time this is written, the
  76.       latest version is 2.12, so look for LHA212.EXE.
  77.       Note, that recompressing the archive will nearly always result
  78.       in a bigger archive.
  79.  
  80.       The use of FREEWARE software is prohibited in a governmental
  81.       or commercial situation. In these cases, this software must be
  82.       purchased and a Commercial Licence Statement will then be provided
  83.       for.  You may write to TRI-SYSTEMS at the address below for more
  84.       information.
  85.  
  86.       Warranty
  87.       ========
  88.       This software is provided AS IS without any warranty, expressed or
  89.       implied, including but not limited to fitness for a particular
  90.       purpose.
  91.       IN NO EVENT SHALL THE AUTHOR/OWNER OF THIS PRODUCT BE LIABLE FOR
  92.       ANY DIRECT OR CONSEQUENTIAL LOSS OR DAMAGES WHICH MAY HAVE ARISEN
  93.       FROM THE USE OF THIS PRODUCT.
  94.       If your local law does not permit any of the statements made above,
  95.       or if you do not agree with any of them yourself, THEN YOU ARE NOT
  96.       LICENCED TO USE THIS PROGRAM!
  97.  
  98.       Contact
  99.       =======
  100.       The Author can be reached via electronic mail at phone number
  101.       +32-11-762626.
  102.       This is the Tripod BBS.  Network addresses:
  103.  
  104.       FIDOnet         2:292/100
  105.       SIGnet         27:332/0
  106.       Turbo-DataNet  77:8320/100
  107.  
  108.       The Owner can be contacted at the following address:
  109.  
  110.       TRI-SYSTEMS co.
  111.       Langstraat 89
  112.       3630 MAASMECHELEN (Belgium)
  113.       Phone +32-11-764905 during office hours, Central European Time.
  114.  
  115.       Payment
  116.       =======
  117.       If you would like to use this product in a commercial or
  118.       governmental situation, please contact TRI-SYSTEMS at the address
  119.       above. You will then learn the price of the product and a
  120.       Commercial Licence Statement will be made available to you.
  121.  
  122.       For all others, this product is free, as mentioned before.
  123.       But if you would like to support the author and encourage him to
  124.       write more useful software, you're welcome to pay some money.
  125.       You may pay whatever you feel the product is worth to you.
  126.       Note that this kind of freeware products is developed entirely in
  127.       the author's leisure time and he receives absolutely no
  128.       compensation for it, apart from what you as a user would pay him.
  129.  
  130.       If you pay at least U.S. $15 (BEF 500, NLG 30, DEM 25), you will
  131.       receive, when available, a 5.25" or 3.5" floppy diskette with the
  132.       next version.  Please specify which.
  133.       Immediately after receiving your payment, I will send you
  134.       an acknowledgement and a list of the latest versions of all
  135.       freeware I wrote. Payments to the author can be sent in cash to the
  136.       address mentioned above or transferred to one of the following bank
  137.       accounts:
  138.       Bank Brussel Lambert (Belgium) - account number 335-0076382-89
  139.       Rabobank (Holland)             - account number 1059.19.519
  140.  
  141.       ***NOTE THAT THIS IS FOR NON-COMMERCIAL SITUATIONS ONLY!
  142.  
  143.       For all payments made: please specify NAME and VERSION NUMBER of
  144.       the product!
  145.  
  146.  
  147.       What you should have received:
  148.       ==============================
  149.  
  150.       You should have received the file
  151.  
  152.       APPATH11.LZH ·· 7626 bytes
  153.  
  154.       with the following contents:
  155.  
  156.       ┌──────────┐  ┌─────┐ ┌─────────────────────────┐
  157.       │ filename │  │bytes│ │ description             │
  158.       └══════════┘  └═════┘ └═════════════════════════┘
  159.       APPATH  .DOC   11921  This documentation.
  160.       APPATH  .EXE    2953  The program file.           CRC/32 = f6f2b88e
  161.  
  162.       You may also use the program VALIDATE from McAfee Associates for
  163.       the purpose of checking the authenticity of the program file(s).
  164.       It should produce the following:
  165.  
  166.                 File Name:  appath.exe
  167.                      Size:  2,953
  168.                      Date:  6-15-1991
  169.       File Authentication:
  170.             Check Method 1 - D7FF
  171.             Check Method 2 - 19E0
  172.  
  173.  
  174.  
  175.       ╒═════════════════╕
  176.       │ 2. INTRODUCTION │
  177.       ╘═════════════════╛
  178.  
  179.       This program will append directories to your system PATH, hence the
  180.       name ApPATH.
  181.  
  182.       Normally, the only way to append to an existing PATH was to make a
  183.       batch file which said:
  184.  
  185.                 PATH %PATH%;%1 ...
  186.  
  187.       But when that batch file was executed, DOS fills in the original
  188.       PATH and you would get a 'Bad command or filename' error when the
  189.       total number of characters would exceed 128 characters.
  190.  
  191.       ApPATH does allow you to create a system PATH of more than 128
  192.       characters, but you will have to watch out that you stay within the
  193.       size of your current environment.  See section 3 - USAGE for more
  194.       details on how to use ApPATH.
  195.  
  196.       Notes about the environment.
  197.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  198.       DOS will choke if you try to expand your path beyond the current
  199.       environment size.
  200.       Normally, the environment is 160 bytes by default, which is not
  201.       enough for most applications using environment variables.
  202.       It will most certainly not be enough if you plan to expand your
  203.       path extensively.
  204.       This can be remedied by specifying the environment size desired in
  205.       the system's CONFIG.SYS as follows:
  206.  
  207.                 SHELL=C:\COMMAND.COM /E:# /P
  208.  
  209.       Make this the first line in your CONFIG.SYS and fill in the desired
  210.       number of bytes for '#', i.e. /E:4096 will yield an enviroment size
  211.       of 4 K-bytes. The absolute maximum you can specify is 32768 bytes,
  212.       while the minimum is the default size of 160 bytes.
  213.  
  214.       ATTENTION: DOS versions 3.10 will require the number of paragraphs
  215.       instead of the number of bytes for '#'. A paragraph is 16 bytes
  216.       long, so one should specify /E:256 for a 4K environment when using
  217.       DOS 3.10. In this case, the minimum would be 10 paragraphs
  218.       (default), and the maximum 2048 paragraphs.
  219.  
  220.       An environment size of 1024 bytes (64 paragraphs) should be more
  221.       than sufficient for most purposes.
  222.  
  223.       IMPORTANT: DOS versions 3.00 and below do NOT support the /E
  224.       switch. See your DOS manual for more details.
  225.       If your DOS version does not support the /E switch, you can either
  226.       change to a DOS version which does, or use one of the many patches
  227.       available for increasing the DOS default environment size.
  228.       Using such a patch with a DOS version which does support the /E
  229.       switch is obsolete and therefore not recommended.
  230.  
  231.       Last remark: if you have set your environment size big enough, it
  232.       is possible to include every directory in your path and thus
  233.       create a path which would take about half your screen to display.
  234.  
  235.       REMEMBER, HOWEVER, THAT LARGER PATHS TAKE MORE TIME FOR DOS TO
  236.       SEARCH THROUGH! So don't make your path longer than you have to.
  237.  
  238.  
  239.  
  240.       ╒══════════╕
  241.       │ 3. USAGE │
  242.       ╘══════════╛
  243.  
  244.       Command line syntax is:
  245.  
  246.                         APPATH [;][dir][;dir][;dir][...]
  247.  
  248.       where [dir] designates a directory to be appended to the PATH.
  249.       The square brackets indicate that the parameter is optional and
  250.       should themselves not be typed.
  251.  
  252.       If no parameters at all are specified, the program will show you
  253.       the current system PATH, as typing PATH without parameters would
  254.       also do.
  255.  
  256.       ApPATH assumes you already have typed in a PATH. It will append
  257.       the path specification you type after the 'ApPATH' program name to
  258.       the existing PATH. There's no need to begin with a ';'.
  259.       If it's not there, ApPATH will insert it for you.
  260.  
  261.       Remember, that DOS does not allow you to type more than 128
  262.       characters a time! So, if you want to append a lot to the existing
  263.       PATH, you can use multiple ApPATH commands.
  264.  
  265.       Example:       PATH C:\;C:\DOS
  266.                      ApPATH C:\UTILS;C:\PASCAL
  267.                      ApPATH C:\TEST
  268.  
  269.       Typing PATH «Enter» will now show you:
  270.  
  271.       PATH=C:\;C:\DOS;C:\UTILS;C:\PASCAL;C:\TEST
  272.  
  273.       That's all there is to it.
  274.  
  275.  
  276.  
  277.       ╒═════════════════════╕
  278.       │ 4. REVISION HISTORY │
  279.       ╘═════════════════════╛
  280.  
  281.       Ver.      Comment
  282.       ~~~~      ~~~~~~~
  283.       1.10    - ApPATH had problems detecting the end of the enviroment space
  284.                 under generic MS-DOS 3.30.  I wonder why it took so long
  285.                 before someone reported this to me?
  286.                 Thanks to Gary Gordon of 1:343/65@fidonet.org for reporting
  287.                 this bug.
  288.                 ApPATH will now also work correctly with MS-DOS 5.00.
  289.       1.00.01 - ApPATH was recompiled with Turbo Pascal v5.5 and
  290.                 compressed with the Japanese DIET program.
  291.       1.00    - Base version (Turbo Pascal v4.0).
  292. _______________________________________________________________________(eof)__
  293.