home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac_os2 / cfgsrt12.zip / CFGSORT.TXT < prev    next >
Text File  |  1996-05-15  |  6KB  |  180 lines
  1.  
  2.  
  3.  
  4.                                CONFIGSORT 1.2
  5.  
  6.                        By Philip A. O'Malley (C)1996
  7.  
  8.  
  9. 1.1 INTRODUCTION
  10.  
  11.     The heart of an OS/2 system  is its config.sys file. Unfortunately, this
  12. file starts out  as  an  organizational  mess  and  gets  worse  as numerous
  13. applications modify it. Enter ConfigSort.
  14.  
  15.     ConfigSort will take a  config.sys  file  and  convert it into something
  16. substantially more functional.  Additionally,  ConfigSort  also  knows about
  17. multiple entries belonging to certain  applications  and will group any such
  18. entries into sections at the end of the file with a helpful comment.
  19.  
  20.     The difference is quite astounding, as I'm sure you'll agree. :)
  21.  
  22.  
  23. 2.1 REQUIREMENTS
  24.  
  25.     ConfigSort is a REXX program which  has  been compiled using RxCls. As a
  26. consequence you must have REXX installed, which  comes as a standard part of
  27. the OS/2 3.0 distribution.
  28.  
  29.     Additionally, the RXEXTRAS.DLL is also needed as ConfigSort uses some of
  30. the functions contained in that  library.  It  should be placed somehwere in
  31. the LIBPATH. "/OS2/DLL" is usually a good place.
  32.  
  33.  
  34. 2.2 LICENCE FOR USE
  35.  
  36.     ConfigSort is an original program, copyrighted to the author. It may not
  37. be modified in any shape or form.  It can be freely distributed providing no
  38. charge is made beyond those to cover media expenses and the like.
  39.  
  40.     ConfigSort is provided "as  is"  and  any  damage,  actual or perceived,
  41. caused by the program is not the  liability  of  the author. Your use of the
  42. program signifies your acceptance of these conditions.
  43.  
  44.     If you have no problems with the above, then onwards... :)
  45.  
  46.  
  47. 3.1 USAGE AND SYNTAX
  48.  
  49.     ConfigSort is command-line driven. All options are invoked, or prefixed,
  50. by keywords and are:
  51.  
  52.  1. /IN <FQFN>
  53.  
  54.     This specifies the fully-qualified file  name  of the config.sys file to
  55.     be processed. This is the only required keyword.
  56.  
  57.  2. /OUT <FQFN>
  58.  
  59.     This specifies an output file for ConfigSort to write to.
  60.  
  61.     If this keyword is not specified then the original /IN file is backed-up
  62.     with a .bak extension and then overwritten.
  63.  
  64.  3. /NOAPPS
  65.  
  66.     By default, multiple entries made by  an  application are grouped into a
  67.     section at the end of the file. This keyword disables this facility.
  68.  
  69.  4. /NOSORT
  70.  
  71.     By default, all SET statements  are  sorted into descending alphabetical
  72.     order. This keyword disables this facility.
  73.  
  74.  5. /NOUPPER
  75.  
  76.     By default, all lines are turned  upper-case. This keyword disables this
  77.     facility.
  78.  
  79.  
  80. 3.2 EXAMPLES
  81.  
  82.     This section is just intended  to  visualise  the above into something a
  83. little more tangible. Three examples of syntax are shown below:
  84.  
  85.  1. PROCESS "F:\CONFIG.SYS" (AND BACKUP TO F:\CONFIG.BAK)
  86.  
  87.     cfgsort /in f:\config.sys
  88.  
  89.  2. PROCESS "F:\CONFIG.SYS" AND OUTPUT TO "F:\CONFIG.NEW"
  90.  
  91.     cfgsort /in f:\config.sys /out f:\config.new
  92.  
  93.  3. PROCESS "F:\CONFIG.SYS" WITH ALL OPTIONS OFF
  94.  
  95.     cfgsort /in f:\config.sys /noapps /nosort /noupper
  96.  
  97.  
  98. 3.3 KNOWN APPLICATIONS
  99.  
  100.     Currently, ConfigSort knows about the following applications:
  101.  
  102.         1.  IBM DualStor.
  103.         2.  IBM MPTS (basic support).
  104.         3.  IBM TCP/IP v2.0 (Bonuspak IAK).
  105.         4.  IBM TCP/IP v3.0 (Warp Connect).
  106.         5.  IBM WebExplorer 1.1b
  107.         6.  SIO Serial drivers.
  108.         7.  SUBST/2
  109.  
  110.     NB. 2.  The knowlage of Multi-Protocol Transport Services, found in Warp
  111.             Connect, is basic  at  best.  It  comprises  the dial-up support
  112.             drivers for TCP/IP 3.0. As  I  don't  run  a LAN based system, I
  113.             can't include support for this area of MPTS.
  114.  
  115.  
  116. 4.1 VERSION HISTORY
  117.  
  118.     1.2  14/05/96
  119.  
  120.          + Added the /NOUPPER option. Previously ConfigSort changed the case
  121.            of the config.sys to uppercase  without option, which could cause
  122.            problems with ANSI sequences for command prompts, etc.
  123.  
  124.          + Added support for the  IBM  WebExplorer  1.1b SET statements into
  125.            the network sections.
  126.  
  127.     1.11 28/04/96
  128.  
  129.          = Added IFCONFIG.EXE to the TCP/IP applications sorting. This was
  130.            an oversight and caused problems for some people.
  131.  
  132.     1.1  16/04/96
  133.  
  134.          - Removed the /SORT option. Previously it shuffled REM'd entries to
  135.            the bottom of a configuration  section,  but as some drivers have
  136.            to be loaded in a correct  order,  for example the sound drivers,
  137.            unREMing those lines later caused  problems  if the correct order
  138.            couldn't be remembered. Thus,  I  decided  that  it could be more
  139.            trouble than it was worth, so it's now gone...
  140.  
  141.          + SET statements are now sorted into descending alphabetical order.
  142.  
  143.          + Added the /NOSORT  option.  This  stops  all  SET statements from
  144.            being sorted.
  145.  
  146.          - An oversight in the  docs  saying  that  the RXEXTRAS.DLL came as
  147.            part of the  OS/2  distribution.  Apologies  to  those  who, as a
  148.            result, couldn't get the program to actually run. :(
  149.  
  150.          - A bug was introduced into 1.0 at the last moment due to brainfade
  151.            on my part and no subsequent testing. Basically ConfigSort didn't
  152.            strip out it's own REM statements which caused them to accumulate
  153.            when a saved file was reprocessed. Minor but annoying.
  154.  
  155.     1.0  05/04/96
  156.  
  157.            First public release.
  158.  
  159.  
  160. 5.1 AFTERWORD
  161.  
  162.     ConfigSort was written as nothing else satisfied my requirements. It has
  163. been tested extensively and  doesn't  appear  to  have  any obvious or major
  164. flaws. It doesn't appear to have any minor ones either. ;)
  165.  
  166.     However, it is very much a program  in early development and could still
  167. be "fleshed out"  considerably  in  terms  of  capabilities and applications
  168. knowlage, which I intend to do when time permits.
  169.  
  170.  
  171. 5.2 CONTACTS
  172.  
  173.     Any suggestions or comments would be  very  welcome. I'm available for a
  174. chat at the following addresses:
  175.  
  176.     email   : phil.omalley@zetnet.co.uk
  177.     fidonet : "Phil O'Malley" at 2:250/107.96
  178.  
  179. Phil O'Malley, May 14th 1996.
  180.