home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / neword15.zip / neworder.txt < prev   
Text File  |  1996-08-09  |  10KB  |  242 lines
  1.  
  2.  ┌──────────────────────────────────────────────────────────────────────────┐
  3.  └─────────────────────────── N E W O R D E R ──────────────────────────────┘
  4.  
  5.                    NEWORDER Version 1.5 - 09 August 1996
  6.  
  7.                 (C) Copyright 1995-1996, All Rights Reserved
  8.                      Serge Forget - 1:243/68@fidonet
  9.  
  10.           "Maximus" is a trademark of Scott J. Dudley - Lanius Corp.
  11.  
  12.  ┌──────────────────────────────────────────────────────────────────────────┐
  13.  └─ INTRODUCTION ───────────────────────────────────────────────────────────┘
  14.  
  15.    NEWORDER is a utility for Sysops using Maximus and Maximus/2 version 3.xx
  16.    ONLY, written by Scott J. Dudley - Lanius Corp.
  17.  
  18.    - Why I wrote NEWORDER?
  19.  
  20.      Simply because I got tired of renumbering my file and message areas
  21.      manually, everytime I added or deleted areas.  This is something that
  22.      happens often, with sysops joining or leaving numerous networks.  ;)
  23.  
  24.    - What it does?
  25.  
  26.      It renumbers either your MsgArea.ctl or FileArea.ctl files, after you
  27.      have managed to add, delete or reorganized your configuration files.
  28.      This is something that we, sysops, really like to do, fudging with our
  29.      configuration files.  ;)
  30.  
  31.  ┌──────────────────────────────────────────────────────────────────────────┐
  32.  └──────────────────────────────────────────────────────────────────────────┘
  33.  
  34.   *NEW:   NEWORDER now works with File and Message Divisions.  This allows
  35.           you to have each Division to start at 0, or 1, or whatever you
  36.           want.  So, after you run Silt(P), your File or Message area Menus
  37.           will give you a listing like:
  38.  
  39.           A.1
  40.           A.2
  41.           ...
  42.           ...
  43.  
  44.           B.1
  45.           B.2
  46.           ...
  47.           ...
  48.  
  49.           etc...
  50.  
  51.           To see what I mean, have a look at the sample MsgArea.CTL file
  52.           enclosed in this archive.
  53.  
  54.  ┌──────────────────────────────────────────────────────────────────────────┐
  55.  └──────────────────────────────────────────────────────────────────────────┘
  56.  
  57.           You can now add the initial value on the command line, like:
  58.           "NEWORDER FileArea.CTL 200"  (Without the quotes).  This will start
  59.           the renumbering of the areas from 200 and up.  Any "%#neworder xxx"
  60.           statements _WILL_ be ignored.
  61.  
  62.           Also, NEWORDER will make an automatic backup copy of your original
  63.           CTL file. ;)  There is no more *.new file, the output file is the
  64.           actual CTL file required, all you have to do is scan the file to
  65.           ensure that it is to your liking and run Silt(p).  ;)
  66.  
  67.           OR, you can use the folowing method:
  68.  
  69.           All that you have to do, is insert one line at the required
  70.           locations, using the keyword "%#neworder" (without the quotes) and
  71.           the starting value, just before the area that the renumbering
  72.           scheme should start, within your original *.CTL files, for example:
  73.  
  74.              %#neworder 1
  75.                  .
  76.                  .
  77.                  .
  78.                  .
  79.              %#neworder 100
  80.  
  81.              FileArea 23
  82.              ACS             Transient
  83.              Desc            (AD) DOS Desktop Programs
  84.              Download        e:\files003\AD-DOSDK\
  85.              Upload          d:\files002\sysop\
  86.              End FileArea
  87.  
  88.              FileArea 24
  89.              ACS             Transient
  90.              Desc            (AD) DOS Games
  91.              Download        d:\files002\AD-DOSGM\
  92.              Upload          d:\files002\sysop\
  93.              End FileArea
  94.  
  95.                .
  96.                .
  97.                .
  98.             %#neworder 200
  99.                .
  100.                .
  101.                .
  102.             etc.....
  103.  
  104.  
  105.         You get the idea.  ;)
  106.  
  107.  
  108.    With this method, whenever NEWORDER encounters this keyword (%#neworder),
  109.    it will reset the Area count to whatever you have chosen.
  110.  
  111.    For example: %#neworder 100 will start numbering areas from 100.
  112.  
  113.    Upon execution, the OUPUT file name will be *.CTL.  So, if you use
  114.    MsgArea.ctl as the input file to process, well, the output file name will
  115.    be MsgArea.CTL, with a backup copy named MsgArea.BAK.  NEWORDER WILL tell
  116.    you what the name of the output file will be.
  117.  
  118.  ┌──────────────────────────────────────────────────────────────────────────┐
  119.  └──────────────────────────────────────────────────────────────────────────┘
  120.  
  121.    Enter NEWORDER without any arguments to get the command line reminder.
  122.  
  123.    Also, when using the second method, if the area renumbering tally is
  124.    greater then a NEWORDER keyword, NEWORDER will barf and tell you on which
  125.    line, in your input CTL file, where there is a conflict.  In other words,
  126.    say you have selected a new renumbering count at a certain location, if
  127.    the last area of the previous group is higher then the new renumbering
  128.    number, NEWORDER will tell you.  All you will have to do in this situation,
  129.    is just to increment your new group starting number to a higher value.
  130.  
  131.    After executing NEWORDER:
  132.  
  133.    1-  When satisfied that NEWORDER has done it's job to your liking, delete
  134.        the file MTAG.* in your Maximus root directory.
  135.  
  136.    2-  Delete *.* in your \Max\olr\dats directory.
  137.  
  138.    3-  Run Silt(P) to rebuild your Farea & Marea files, and you are all set.
  139.  
  140.  
  141.    Garanties?  For this price?  You must be kidding!  There are none, niet,
  142.    null, aucune, nada....  All I can say is, it will occupy disk space, and
  143.    that it works here and it may not work for you, but then again it may.  ;)
  144.  
  145.    This program was compiled using Borland C++ v4.00, in a DOS "box" under
  146.    OS/2 WARP.
  147.  
  148.    This exe file has been compiled for 80386 systems, but should work just
  149.    fine with faster CPU's.  Memory requirements are minimal.
  150.  
  151.    Comments and suggestions are welcome.
  152.  
  153.    I hope that it will make your Maximus management easier, as it does
  154.    for me.
  155.  
  156.  ┌──────────────────────────────────────────────────────────────────────────┐
  157.  └─ COMMAND LINE CONTROLS ──────────────────────────────────────────────────┘
  158.  
  159.  
  160.     Syntax example:  NEWORDER FileArea.ctl
  161.                      NEWORDER FileArea.ctl 100
  162.  
  163.     Syntax example:  NEWORDER MsgArea.ctl
  164.                      NEWORDER MsgArea.ctl 200
  165.  
  166.  
  167.  ┌──────────────────────────────────────────────────────────────────────────┐
  168.  └─ ERROR LEVELS ───────────────────────────────────────────────────────────┘
  169.  
  170.  
  171.                         0 - Normal exit.
  172.                         1 - Input file not found exit.
  173.  
  174.  
  175.  ┌──────────────────────────────────────────────────────────────────────────┐
  176.  └─ DISTRIBUTION ───────────────────────────────────────────────────────────┘
  177.  
  178.     NEWORDER is FREEWARE for NON-commercial users.  You can use it, abuse it,
  179.     break it or what ever you like, but I retain ALL the rights to it.
  180.  
  181.     The lastest version of NEWORDER is always available from the author's
  182.     system (1:243/68), by File Requesting the MAGIC name of NEWORDER.
  183.  
  184.     Also, reverse engineering of any kind or type is prohibited.
  185.  
  186.     For commercial users, contact the author for details.
  187.  
  188.     The Author can be contacted by Fidonet Netmail at 1:243/68, and via the
  189.     following international echomail conferences: in the Maximus support
  190.     conference Muffin; MaxDev; Xenia; and OS2BBS.
  191.  
  192.  ┌──────────────────────────────────────────────────────────────────────────┐
  193.  └─ HISTORY or What's New ──────────────────────────────────────────────────┘
  194.  
  195.     * 09 August 1996 *
  196.  
  197.          - Version 1.5 is released by way of MaxFDN.
  198.          - Following a few requests, I have modified NEWORDER to work with
  199.            the File and Message Divisions, for those who use this nice
  200.            feature of Maximus.  See the sample MsgArea.CTL file enclosed in
  201.            this archive.
  202.  
  203.     * 03 July 1996 *
  204.  
  205.          - Version 1.4 is released by way of MaxFDN.
  206.          - Since I had some spare time, I implemented something that I wanted
  207.            to do since the first version, automatic backup file creation.  ;)
  208.            Now, all you have to do is run NEWORDER, scan the file for
  209.            correctness and run Silt(p).  See the instructions above.
  210.  
  211.     * 02 July 1996 *
  212.  
  213.          - Version 1.3 is release by way of MaxFDN.
  214.          - Following a few requests and suggestions, I have added an extra
  215.            command line parameter, where you can specify the value of the
  216.            initial file area number.  Of course, any %#neworder keyword
  217.            _WILL_ be ignored, since the command line value will have
  218.            priority.  In fact, you do not even have to use the "%#neworder"
  219.            keyword at all all.  <WG>
  220.  
  221.     * 03 March 1996 *
  222.  
  223.         - Version 1.2 is released, by way of SDSMAX.
  224.         - Code revision was required in order to get rid of an annoying
  225.           "Null pointer assignment" statement, after running NEWORDER. :(
  226.  
  227.     * 06 December 1995 *
  228.  
  229.         - Version 1.1 is released, by way of SDSMAX.
  230.         - Optimized code.
  231.         - Improved this documentation, some information was missing.
  232.         - Cosmetic changes.
  233.  
  234.     * 19 November 1995 *
  235.  
  236.         - NEWORDER version 1.00 is released, by way of the software
  237.           distribution network SDSMAX.
  238.  
  239.  ┌──────────────────────────────────────────────────────────────────────────┐
  240.  └──────────────────────────────────────────────────────────────────────────┘
  241.  
  242.