home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / MTA_VF35.EXE / MTLDOCEN.DOC < prev    next >
Text File  |  1993-02-22  |  20KB  |  404 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTL       Make Them List/Log                  │    D.I.S.P.     │────┐
  3. ║                                               │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.35                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: February 22th, 1993                 │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTL.EXE                                     |    └─────────────────┘
  12. ║ │                                             |       ┌─────┐        |
  13. ║ │                                             |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ Lines starting with '│' are                 |     ┌────┴────┐      |
  16. ║ │ changes to release 15.30                    ------││││││ ═══│-------
  17. ║                                                     └─────────┘
  18. ╠═══════════════════════════════
  19. ║ Address: Robert W. van Hoeven
  20. ║          PO. Box 131
  21. ║          1170 AC  Badhoevedorp
  22. ║          Nederland / Holland
  23. ╚═══════════════════════════════
  24.  
  25.  ┌───────┬─────────────────────────────────────────────────────────────┐
  26.  │   0   │ Table of contents                                           │
  27.  └───────┴─────────────────────────────────────────────────────────────┘
  28.  
  29.  1 ---- General information
  30.   1.1   Copyrights and License Agreement
  31.   1.2   Newer versions and contacting the author
  32.  
  33.  2 ---- Package description and requirements
  34.   2.1   Preface
  35.   2.2   Requirements
  36.   2.3   Usage
  37.  
  38.  3 ---- Installation description
  39.   3.1   Installation
  40.   3.2   Remarks on archives
  41.   3.3   MTA.CTL
  42.  
  43.  4 ---- Runtime information
  44.   4.1   Running MTL
  45.  
  46.  5 ---- Version information and credits
  47.   5.1   The BETA-team
  48.   5.2   Credits
  49.   5.3   Version history
  50.   5.4   Copyright, Trademarks
  51.  
  52.  ┌───────┬─────────────────────────────────────────────────────────────┐
  53.  │   1   │ General information                                         │
  54.  └───────┴─────────────────────────────────────────────────────────────┘
  55.  
  56.  1.1 Copyrights and License Agreement
  57.  ────────────────────────────────────
  58.  
  59.  - Users of the MTA-package must accept this disclaimer of warranty:
  60.  
  61.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  62.    warranties, expressed or implied, including, without limitation,  the
  63.    warranties of merchantability  and of fitness  for any purpose.   The
  64.    author assumes  no liability  for damages,  direct or  consequential,
  65.    which may result from the use of the MTA-package;
  66.  
  67.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  68.    charge to the user for evaluation.   Feel free to share it with  your
  69.    friends,  but  please  do  not  give  it  away  altered or as part of
  70.    another  system.   The  essence  of  "user-supported"  software is to
  71.    provide personal  computer users  with quality  software without high
  72.    prices, and yet to provide  incentive for programmers to continue  to
  73.    develop new products.
  74.  
  75.  - If  you find  this program  useful and  find that  you are  using and
  76.    continue the  use of  the MTA-package  after a  30 days trial period,
  77.    you must register the MTA-package as described below;
  78.  
  79.  - Non-commercial can get a license for the usage up to this release  of
  80.    the MTA-package for  a small amount  of money. Look  into the details
  81.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  82.    reduction to upgrade to the  newer versions. These users should  look
  83.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  84.    a POSSIBILITY to submit to one of the special contracts as  explained
  85.    in the file REGISTER.MTA.
  86.  
  87.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  88.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  89.    direct to the  SysOp to get  full access) is  has to pay  more than a
  90.    Non-commercial  user.  Both  types  of  users  should  look  into the
  91.    details in REGISTER.MTA;
  92.  
  93.  - The registration of the MTA-package will license ONE copy for use  on
  94.    any computer at any  one time, as long  as the usage confirms  to the
  95.    type of registration you have done (so NON-commercial usage when  you
  96.    have a non-commercial license);
  97.  
  98.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  99.    must  first   contact  the   Author   at   the  address   above   for
  100.    authorization.
  101.  
  102.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  103.    your friends  for  evaluation.   Please  encourage  them to  register
  104.    their copy if they find that they can use it;
  105.  
  106.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  107.    available  by  means  of  written  letters  or by entering the inter-
  108.    national echomail area DISP;
  109.  
  110.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  111.    conference <tm> called DISP (international). Entering this echo  does
  112.    not  exclude  you  of  the  duty  to register the MTA-package, though
  113.    users who evaluate the product can enter the echo for questions;
  114.  
  115.  - The  MTA-package, all  programs, the  documentation and support-files
  116.    is  copyrighted  1990,93  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  117.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  118.    this  package  for  backup  purposes.  Also  you  may  copy and share
  119.    unmodified copies of the whole package, providing that the  copyright
  120.    notice    is    reproduced    and    included    on    all    copies.
  121.    Excluded from this statement  are the support-files written  by other
  122.    authors.  Please  refer  to  the  documentation of these programs for
  123.    copyrights and license agreements;
  124.  
  125.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  126.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  127.    Patching the medium at  places that carry the  software is seen as  a
  128.    program change and is also forbidden. It is forbidden to create a  so
  129.    called 'bypass' to skip the original introduction screens and  delay.
  130.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  131.    author (Robert W. van Hoeven) himself;
  132.  
  133.  - Performing  any  of  the  illegal  actions as stated in the previous
  134.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  135.    important, to the registered users;
  136.  
  137.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  138.    the WHOLE package  to any archive-system  they like but  all original
  139.    files must  be included  in the  new archive.  The MTA-package on the
  140.    Bulletin Board  can contain  at the  most 2  extra files. These files
  141.    can only be  a commercial for  that Bulletin Board  and/or validation
  142.    data that is presented  as a service to  all users and shall  have no
  143.    other functions;
  144.  
  145.  - After  the normal  trial period  of 30  days, you  must register  the
  146.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  147.  
  148.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  149.    answered as soon I have the time  to do so. You can send me  a letter
  150.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  151.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  152.    Reinier de Groot).  When you want to send me normal mail, address  it
  153.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  154.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  155.    Echomail <tm> area;
  156.  
  157.  
  158.  1.2 Newer versions and contacting the author
  159.  ───────────────────────────────────────────────────────────────────────
  160.  The newest version of  MTA is always available  at the DISP-HQ on  node
  161.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  162.  nodes.  There are three ways of obtaining newer versions of MTA:
  163.  
  164.  
  165.  - Logging on at DISP-HQ or a support node
  166.    Look into the file SUPPORT.MTA for a full list of support nodes;
  167.  
  168.  - Logging on to a SDS node
  169.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  170.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  171.    distribution point in Holland;
  172.  
  173.  - Logging on to your own BBS;
  174.    Chances  are,  that  you  will  find  an older version (international
  175.    users) because it will take some time for the new version to  'bleed'
  176.    thru the net;
  177.  
  178.  - Update service;
  179.    You can enter a special update service (read REGISTER.MTA).
  180.  
  181.  
  182.  If you think you have found problems in MTA, or in any other case,  you
  183.  wish to contact the author, you can send me:
  184.  
  185.  - A letter to the address you can find in the header of this file;
  186.  
  187.  - A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  188.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  189.  
  190.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  191.  
  192.  ┌───────┬─────────────────────────────────────────────────────────────┐
  193.  │   2   │ Package description and requirements                        │
  194.  └───────┴─────────────────────────────────────────────────────────────┘
  195.  
  196.  2.1 Preface
  197.  ───────────────────────────────────────────────────────────────────────
  198.  MTL  is  an  add-on  utility  for  MTA  and  is distributed in the same
  199.  release  archive  that   contains  MTA.  This   program  may)  NOT   be
  200.  distributed as a stand-alone package.
  201.  
  202.  
  203.  
  204.  2.2 Requirements
  205.  ───────────────────────────────────────────────────────────────────────
  206.  MTL requires:      - PC XT/AT/386
  207.                     - At least 300K free memory
  208.                     - DOS 3.xx (4.xx not tested)
  209.                       (also tested under 4Dos);
  210.                     - HDU optional
  211.                     - MTA's original CTL-alike file
  212.                     - MTA's logging files
  213.  
  214.  
  215.  2.3 Usage
  216.  ───────────────────────────────────────────────────────────────────────
  217.  MTL comes as an add-on to MTA. MTA can create a log-file (look into the
  218.  LogPath option in MTADOCEN.DOC) which contains all relevant information
  219.  from previous runs. This log-file can, in time, get very large. MTL is
  220.  written with two options in mind:
  221.  
  222.  1) MTL can compile the information in the MTA log-file into one screen
  223.     of usefull information. This information will show the number of
  224.     files converted up to now (splitting most of the popular archive
  225.     extensions) and the total reduction (growth) as a result of this
  226.     conversion;
  227.  
  228.  2) MTL can optionally strip redunant information from the log-file.
  229.     When you choose to compress the log, MTL will read ALL log-file
  230.     records and will create a new log-file, containing only a few
  231.     lines (between 1 and 20 lines). All other information is removed.
  232.     When you use a log-file that is accessed by other programs as well
  233.     (mailer, BBS program and so on), you must take care of this infor-
  234.     mation BEFORE you compress the log with MTL, otherwise all this
  235.     information is gone. When you compress the MTA-log, MTL will also
  236.     write a second log-file, containing the filenames of all files
  237.     that have been compressed with MTA and that had a negative reduction
  238.     (so they got bigger, not smaller). You can use this log to your own
  239.     needs and throw it away (MTA.NEG) after you have (or not have) taken
  240.     a look inside;
  241.  
  242.  MTL will also compress and clean the AV-log. This compress
  243.  is ALWAYS done (so if you reply 'N' to the compress question in MTL,
  244.  the AV-log will still be compressed). Compressing is done in one simple
  245.  way. All records with the same AV-code AND same AV-names will be
  246.  reduced to one record with the AV-code and the AV-name. After the com-
  247.  press, all records will be in ascending order. MTA will append new
  248.  records to this log, but with the next run of MTL, they will be sorted
  249.  in place (or removed when they are duplicate).
  250.  
  251.  ┌───────┬─────────────────────────────────────────────────────────────┐
  252.  │   3   │ Installation description                                    │
  253.  └───────┴─────────────────────────────────────────────────────────────┘
  254.  
  255.  
  256.  3.1 Installation
  257.  ───────────────────────────────────────────────────────────────────────
  258.  See the documentation for MTA (MTADOCEN.DOC).
  259.  
  260.  
  261.  3.2 Remarks on archives
  262.  ───────────────────────────────────────────────────────────────────────
  263.  MTL does not use any archivers. It will only process the MTA-log file.
  264.  
  265.  
  266.  3.3 MTA.CTL
  267.  ───────────────────────────────────────────────────────────────────────
  268.  MTL will use some  of the MTA options.  In general all special  options
  269.  in MTA (exits,  CRC, Virus, includes  and so on)  are not used  but all
  270.  logging option ARE used. MTL MUST find a file called MTA.CTL somewhere
  271.  in the DOS-path (later versions will fix this limitation). When you use
  272.  another name for the MTA.CTL alike file, you need to copy this file to
  273.  MTA.CTL, somewhere in the DOS-path to make MTL work.
  274.  
  275.  ┌───────┬─────────────────────────────────────────────────────────────┐
  276.  │   4   │ Runtime Information                                         │
  277.  └───────┴─────────────────────────────────────────────────────────────┘
  278.  
  279.  4.1 Running MTL
  280.  ───────────────────────────────────────────────────────────────────────
  281.  The calling syntax of MTL is:
  282.  
  283.  MTL {/BATCH}
  284.  
  285.  /BATCH  : If this option  is  supplied, MTL will  run unattended (batch
  286.            mode) and  no  questions  will  be asked. If the LOGTHRESHOLD
  287.            option  in  MTA.CTL is set, MTL will cleanup the MTA-log when
  288.            the total  size of the  log is greater than the value you did
  289.            supply with this option, MTL will  compress the log. MTL will
  290.            do give a warning  while  running  unattended but without the
  291.            LOGTHRESHOLD option in MTA.CTL.
  292.  
  293.  In unattended mode (/BATCH), MTL will  make  no noice (beeps and bells)
  294.  when registered.
  295.  
  296.  ┌───────┬─────────────────────────────────────────────────────────────┐
  297.  │   5   │ Version information and credits                             │
  298.  └───────┴─────────────────────────────────────────────────────────────┘
  299.  
  300.  5.1 The BETA-team
  301.  ───────────────────────────────────────────────────────────────────────
  302.  See the file SUPPORT.MTA for a full list of beta-testers;
  303.  
  304.  
  305.  5.2 Credits
  306.  ───────────────────────────────────────────────────────────────────────
  307.  See MTADOCEN.DOC
  308.  
  309.  
  310.  5.3 Version history
  311.  ───────────────────────────────────────────────────────────────────────
  312.  ┌───────┬─────────────────────────────────────────────────────────────┐
  313.  │ 15.05 │ Minor Release                                               │
  314.  └───────┴─────────────────────────────────────────────────────────────┘
  315.   ■ Added options to compress the MTA.AVS log (AV-log) if it is set in
  316.     the MTA.CTL alike file.
  317.  
  318.   ■ Fixed bug in the processing of the 'negative' log. The new log that
  319.     contains the negative reduced files did not display the name of the
  320.     file in question. This is fixed;
  321.  
  322.  ┌───────┬─────────────────────────────────────────────────────────────┐
  323.  │ 15.06 │ Version Release                                             │
  324.  └───────┴─────────────────────────────────────────────────────────────┘
  325.   ■ Only version number is changed;
  326.  
  327.  ┌───────┬─────────────────────────────────────────────────────────────┐
  328.  │ 15.07 │ Version Release                                             │
  329.  └───────┴─────────────────────────────────────────────────────────────┘
  330.   ■ Only version number is changed;
  331.  
  332.  ┌───────┬─────────────────────────────────────────────────────────────┐
  333.  │ 15.08 │ Version Release                                             │
  334.  └───────┴─────────────────────────────────────────────────────────────┘
  335.   ■ Only version number is changed;
  336.  
  337.  ┌───────┬─────────────────────────────────────────────────────────────┐
  338.  │ 15.10 │ Version Release                                             │
  339.  └───────┴─────────────────────────────────────────────────────────────┘
  340.   ■ Only version number is changed;
  341.  
  342.  ┌───────┬─────────────────────────────────────────────────────────────┐
  343.  │ 15.20 │ Version Release                                             │
  344.  └───────┴─────────────────────────────────────────────────────────────┘
  345.   ■ Changed the reports. LZS is moved to the group 'OTHER' and  replaced
  346.     by SQZ. The first compression of the LOG-file will add the remaining
  347.     LZS files to the 'OTHER' group;
  348.  
  349.  ┌───────┬────────────────────────────┐
  350.  │ 15.21 │ Bug release                │
  351.  └───────┴────────────────────────────┘
  352.   ■ Some  new  routines  caused a number of cosmetic bugs. These are now
  353.     fixed (registered users!!!). Also registered users should unpack the
  354.     supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
  355.     run the MTAREG.EXE file once;
  356.  
  357.  ┌───────┬────────────────────────────┐
  358.  │ 15.30 │ Major release              │
  359.  └───────┴────────────────────────────┘
  360.   ■ Added command-line parameter to run MTL in unattended mode while MTL
  361.     is reducing the log-files (/BATCH);
  362.  
  363.   ■ MTL will detect the LOGTHRESHOLD option in MTA.CTL. If MTL is run in
  364.     batch-mode, it will  only  reduce  the log-file if the total size of
  365.     this file is larger than the value supplied with LOGTHRESHOLD;
  366.  
  367.  
  368.  ┌───────┬────────────────────────────┐
  369.  │ 15.35 │ Minor release              │
  370.  └───────┴────────────────────────────┘
  371.   ■ Nothing changed in this version of this program.
  372.  
  373.  
  374.  5.4 Copyrights, Trademarks
  375.  ───────────────────────────────────────────────────────────────────────
  376.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  377.  SQZ           is a trademark of Jonas I Hammarberg.
  378.  PAK           is a trademark of NoGate Consulting.
  379.  ARC           is a trademark of SEA inc.
  380.  ZOO           is a trademark of R. Dhesi.
  381.  DWC           is a trademark of Dean W. Cooper
  382.  LZH and LHarc are trademarks of Yoshi;
  383.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  384.  ARJ           is a trademark of Robert K. Jung
  385.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  386.  4Dos          is a trademark of Rex Conn and JP software
  387.  
  388. │MTL is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
  389. │3.0 and  makes extensive  use of  Object Professional  1.20 and OPCFI V
  390. │16.10.    Some  routines   are  obtained   from  TurboPower's    Asynch
  391. │Professional  1.10.   Both  STRG  and  SYS  (6.1  and  6.0a, commercial
  392. │version) are included. Sources are edited with BRIEF 3.1;
  393.  
  394.  Borland Pascal      is a trademark  of Borland International
  395.  Turbo Debugger      is a trademark  of Borland International
  396.  Object Professional is a trademark  of TurboPower Inc.
  397.  Asynch Professional is a trademark  of TurboPower Inc.
  398. │Pascal+             is a trademark  of StonyBrook software Inc.
  399.  OPCFI               is a trademark  of Robert W. van Hoeven
  400.  STRG and SYS        are  trademarks of Eagle Performance Software
  401.  BRIEF               is a trademark  SolutionSystem
  402.  
  403.  [======================== END OF DOCUMENT ============================]
  404.