MTMDOCEN.DOC

23.1 KB 6e9b3f851453fb59…
╔══════════════════════════════            ┌─────────────────┐
║ MTM       Make Them Modified             │    D.I.S.P.     │────┐
║                                          │                 │░░░░│
╟──────────────────────────────            │                 │░░░░│
║ (c) 1990  Robert W.van Hoeven            │ Dutch           │░░░░│
╟──────────────────────────────            │   Independent   │░░░░│
║ Release : 14.01                          │     ShareWare   │░░░░│
║ Rel.Date: 1th October 1990               │       Programmer│░░░░│
╠══════════════════════════════            └─────────────────┘░░░░│
║                                          |    │░░░░░░░░░░░░░░░░░│
║ │ MTM.EXE                                |    └─────────────────┘
║ │                                        |       ┌─────┐        |
║ │                                        |       │░░░░░│        |
║ │                                        |       └──┬──┘        |
║ │ Lines starting with '│' are            |     ┌────┴────┐      |
║ │ changes to release 13.01 !!            ------││││││ ═══│-------
║                                                └─────────┘
╠═══════════════════════════════
║ Address: Robert W. van Hoeven
║          PO. Box 131
║          1170 AC  Badhoevedorp
║          Nederland / Holland
╚═══════════════════════════════

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   0   │ Table of contents                                           │
 └───────┴─────────────────────────────────────────────────────────────┘

 1 ---- General information
  1.1   Copyrights and License Agreement
  1.2   Newer versions and contacting the author

 2 ---- Package description and requirements
  2.1   Preface
  2.2   Requirements
  2.3   History
  2.4   Introduction & specs

 3 ---- Installation description
  3.1   Installation
  3.2   Remarks on archives
  3.3   MTA/MTM.CTL
  3.4   MTM touching
  3.5   Screen control
  3.6   Aborting MTM

 4 ---- Runtime information
  4.1   Running MTM
  4.2   Examples
  4.3   (De)compressors
  4.4   Encryption and Authenticity

 5 ---- Version information and credits
  5.1   The BETA-team
  5.2   Credits
  5.3   Version history
  5.4   Copyright, Trademarks

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   1   │ General information                                         │
 └───────┴─────────────────────────────────────────────────────────────┘

 1.1 Copyrights and License Agreement
 ────────────────────────────────────

 - Users of the MTA-package must accept this disclaimer of warranty:

 - The MTA-package is supplied as is.  The author disclaims all
   warranties, expressed or implied, including, without limitation,
   the warranties of merchantability and of fitness for any purpose.
   The author assumes no liability for damages, direct or consequential,
   which may result from the use of the MTA-package;

 - The MTA-package is a "shareware program" and is provided at no charge
   to the user for evaluation.  Feel free to share it with your friends,
   but please do not give it away altered or as part of another system.
   The essence of "user-supported" software is to provide personal
   computer users with quality software without high prices, and yet to
   provide incentive for programmers to continue to develop new products.

 - If you find this program useful and find that you are using and
   continue the use of the MTA-package after a 30 days trial period,
   you must register the MTA-package as described below;

 - Non-commercial can get a license for the usage up to this release
   of the MTA-package for a small amount of money. Look into the
   details in REGISTER.MTA. Previous registered users will receive
   a big reduction to upgrade to the newer versions. These users
   should look into the details in UPGRADE.MTA.
   For Non-commercial users there is a POSSIBILITY to submit to one
   of the special contracts as explained in the file REGISTER.MTA.

 - Commercial usage of MTA will cost somewhat more. Also, a so called
   'closed' Bulletin Board System (a system where the user must pay
   direct to the SysOp to get full access) is has to pay more than
   a Non-commercial user. Both types of users should look into the
   details in REGISTER.MTA;

 - The registration of the MTA-package will license ONE copy for use on
   any computer at any one time, as long as the usage confirms to the
   type of registration you have done (so NON-commercial usage when you
   have a non-commercial license);

 - Anyone distributing the MTA-package for any kind of remuneration must
   first contact the Author at the address above for authorization.

 - You are encouraged to pass a copy of the MTA-package along to your
   friends for evaluation.  Please encourage them to register their
   copy if they find that they can use it;

 - When you are a non-commercial user of MTA and you are depending
   on the software, you can consider to pay a small amount of
   money for service. The terms for this option can be found in
   the file REGISTER.MTA.

 - Support on MTA, when used in a non-commercial environment, is
   available even when you don't enter a service contract, but the
   paid users (both commercial users and non-commercial users with
   a service contract) have higher priority;

 - Problems and suggestions can be entered in the FidoNet <tm> Echomail
   conference <tm> called DISP (international). Entering this echo does
   not exclude you of the duty to register the MTA-package, though users
   who evaluate the product can enter the echo for questions;

 - The MTA-package, all programs, the documentation and support-files is
   copyrighted 1990 by Robert W. van Hoeven, PO. Box 131, Badhoevedorp
   1170AC, Holland. All rights are reserved. You may copy this package
   for backup purposes. Also you may copy and share unmodified copies of
   the whole package, providing that the copyright notice is reproduced
   and included on all copies.
   Excluded from this statement are the support-files written by other
   authors. Please refer to the documentation of these programs for
   copyrights and license agreements;

 - Comments, suggestions and bug reports are welcome and will be answered
   as soon I have the time to do so. You can send me a letter of leave a
   NetMail <tm> message named to Rob Van.hoeven (mind the point) on node
   2:512/100 (RA Support, Monster, Holland, SysOp is Reinier de Groot).
   When you want to send me normal mail, address it to:
   Robert W. van Hoeven, PO. Box 131, 1171 AC Badhoevedorp, Holland;
   Also you can enter messages in the FidoNet <tm> DISP Echomail <tm>
   area;


 1.2 Newer versions and contacting the author
 ────────────────────────────────────────────────────────────────────────
 The newest version of MTA is always available on 2:512/100 (Remote
 Access Support). You can obtain MTA in three ways:

 - Logging on to 2:512/100.
   In this case you have the possibility to look at tons of inter-
   resting files with specialized area's for RA and so on. It is a
   so called 'closed' board. Peeking around will cost nothing, you
   must pay for full access. 2:512/100 is the real start of all
   DISP programs in the real world. DISP-HQ (2:512/100.5) is a board
   you cannot access, but my BOSS will always get the newest version
   first;

 - Logging on to your own BBS;
   Chances are, that you will find an older version (international
   users) because it will take some time for the new version to
   'bleed' thru the net;

 - Update service;
   You can enter a special update service (read REGISTER.MTA).


 If you think you have found problems in MTA, or in any other case,
 you wish to contact the author, you can send me:

 - A letter to the address you can find in the header of this file;
 - A NetMail <tm> message to Rob Van.hoeven (please mind the point
   between Van and Hoeven) at 2:512/100;
 - A Message in the FidoNet <tm> DISP echomail <tm> area;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   2   │ Package description and requirements                        │
 └───────┴─────────────────────────────────────────────────────────────┘


 2.1 Preface
 ────────────────────────────────────────────────────────────────────────
 Please notice the following:

 - MTM is a ShareWare product in every right way;
 - This means the software confirms to 'WYSIWYG' (What You See Is What
   You Get);
 - This program is in no way cripple ware;
 - The author can not be made responsible for damage of any kind, as a
 - This program only works when you have the right compressors available
   on your PC. It does not do any compression of it's own ! The program
   only interprets all the supported formats. I can not think of any
   problem with that, but if any of the authors/companies of the suppor-
   ted products has problems with this program, I will remove that piece
   of coding at once (although I could not find any quote like 'You may
   NOT call our program in program's of your own' in any of the doc's);


 2.2 Requirements
 ────────────────────────────────────────────────────────────────────────
 MTM requires:      - PC XT/AT/386
                    - At least 320K free memory
                    - DOS 3.xx (4.xx not tested)
                      (also tested under 4Dos);
                    - HDU optional


 2.3 History
 ────────────────────────────────────────────────────────────────────────
 MTM is a little (grin) 'quick and dirty' supplement to the 'good
 old' MTA program. This program is just for fun, but there are
 some BBS's who would now 'kiss dutch ground'.

 MTM is a simple archive manipulation program for BBS SysOp's. It can
 do the following:

 - Delete specific files from all archives (independent of the archive
   format);
 - Add specific files to all archives (independent of the archive
   format);
 - Remove headers from ZIP-files;
 - Add headers to ZIP-files from a file;
 - Add and remove MTA mark-strings to archives without repacking;

 Why should you want to use these options you ask. If you are in the
 habit of changing your headers and included files from time to time,
 this program is a simple way of doing all that work for you.

 The general scenario for using this program is:

 - You have tons of files, piled up in all your directories and you
   have included in any of these archives a file called U_READ.ME;
 - By accident you also use the 'standard' ZIP format and you have
   included headers to any of the files, telling the downloaders
   about your nice system and the service you give to them;
 - Now you want to change all the included files, because you have
   found a poor sucker who wants to play Co-sysop (grin again);
 - Also you would like to create an even bigger header, because your
   users are not reaching their 'Leech limit' fast enough (grin^3);
 - Picture Holland, 1990 (<tm> Golden Girls), you are gonna be busy
   a long while, deleting all files and changing this headers in all
   of your nice directories;
 - Now MTM comes around. While I suspect you already use MTA, the im-
   plementation of this 'product' is as easy as '......';
 - Include a few simple (eh?) statements in your MTA.CTL and run MTM
   in each and every directory you have and 'voila' all your files
   are altered to your needs.

 This scenario could also be played with MTA, but MTA wants (it is
 written for this function) to unpack and pack all your compressed
 files and will take up to 100^3 times the time MTM will take for
 this functions.

 So now you are confronted with this program and, as most of the MTA
 users will know, the rather strange DOX (in my case) for this file !

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   3   │ Installation description                                    │
 └───────┴─────────────────────────────────────────────────────────────┘


 3.1 Installation
 ────────────────────────────────────────────────────────────────────────
 Most users will (already) use MTA when they read this file, so we
 will make it as simple as could be. Users who do not know MTA al-
 ready are advised (mandatory) to read the MTA documentation first:

 - Copy MTM.EXE to the same directory you copied MTA to;
 - Leave all statements in MTA.CTL as is;

 If you want to make a separate environment for MTM, you can also
 make a copy of MTA.CTL under the name MTM.CTL and use this file
 for MTM-alike features. This should certainly be the case when you
 use a MTA version lower than 11.15 !
 MTM will first look for a MTM.CTL, when this file can not be retrieved,
 MTM will search for MTA.CTL. If both files are not available, it is
 time to read the installation section of MTA, because MTM works the
 same way.


 3.2 Remarks on archives
 ────────────────────────────────────────────────────────────────────────
 MTM will only support normal compressed files. The extensions can
 differ from the original extension (e.g. TEST.SDS can be TEST.PAK
 but renamed). Not normal compressed files are Self Extraction files
 (SFX). These will be ignored by MTM.


 3.3 MTA/MTM.CTL
 ────────────────────────────────────────────────────────────────────────
 MTM will use some of the MTA options. In general all special op-
 tions in MTA (exits, CRC, Virus, includes and so on) are not used
 but all XXXPath option are used. Also ZIPVersion and PAKVersion will be
│used. The same goes for AutoDescription, IncludeFile and ExcludeFile.

 MTM uses the following MTA statements for its functions:

 Includefile [file]
 --------------------------------------------
 Usage : [file] must contain a complete path to a filename, so drive,
         path and filename. This file will be added by MTM to every
         compressed file MTM will work on. These can be up to 255
         IncludeFile statements in the .CTL file. The files are only
         included with the /ADDFILES command-line option;

 Excludefile [file]
 --------------------------------------------
 Usage : [file] must filename (without drive and path). This file will
         be deleted from every compressed file MTM will work on.
         These can be up to 255 ExcludeFile statements in the .CTL
         file. The files are only deleted with the /DELFILES command-
         line option;


│AutoDescription [file]
 --------------------------------------------
 Usage : Look into the MTA documentation for this option. MTM will
         add the description in [file] to every ZIP file MTM will
         work on. The comment is only added when /ADDCOMMENT is in
         the command-line options;

 MarkHeader [string]
 --------------------------------------------
 See MTADOCEN.DOC for a description of this option. It is only used
 when /DELMARK or /ADDMARK is in the command-line options;


 MarkString [string]
 --------------------------------------------
 See MTADOCEN.DOC for a description of this option. It is only used
 when /DELMARK or /ADDMARK is in the command-line options;


 3.4 MTM touching
 ────────────────────────────────────────────────────────────────────────
 MTM will preserve the original file date/time. This is rather nice,
 because users will not see these files as new-files after you have
 converted them with MTM.


 3.5 Screen control
 ────────────────────────────────────────────────────────────────────────
 Look into the same chapter in MTA.DOC.


 3.6 Aborting MTM
 ────────────────────────────────────────────────────────────────────────
 MTM will convert a complete directory (all compressed files). There
 is only one way to abort MTM (in this release) and that is by means
 of the three-finger salute.



 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   4   │ Runtime Information                                         │
 └───────┴─────────────────────────────────────────────────────────────┘


 4.1 Running MTM
 ────────────────────────────────────────────────────────────────────────
 The calling syntax of MTM is:

 MTM [filemask] {filemask]..{filemask} [options]

 If no filemask is available, MTM will use '*.*' as the current
 filemask. You can include up to 255 filemasks.

 [options] are one or more (valid) command-line options. The following
 options are available:

 /DELMARK         Delete any current MTA mark-string;
 /ADDMARK         Add the new MTA-markstring to the selected files;

 /DELCOMMENT      Delete any ZIP-comment from the selected ZIP-archives;
 /ADDCOMMENT      Add a new ZIP-comment to the selected ZIP-archives
│                 (only if AutoDescription in MTA/MTM.CTL is availa-
                  ble);

 /DELFILE         Delete all files stated in the MTA/MTM.CTL ExcludeFile
                  option(s) from the selected archives;
 /ADDFILE         Add all files stated in the MTA/MTM.CTL IncludeFile
                  option(s) to the selected archives;

 /W{path}         Let MTM use {path}. If not supplied, MTM will use
                  the current directory;

│/IOPpassword     Supply a password for encrypted files;

 /?               Displays a short help-screen;


 4.2 Examples
 ────────────────────────────────────────────────────────────────────────
 - MTM *.ZIP *.PAK /DELCOMMENT /ADDMARK
   Delete any comment from ZIP/PAK files and add a mark-string;

 - MTM *.* /DELMARK /DELFILE /DELCOMMENT
   Cleans every file (ZIP/ZOO/PAK and so on) for comments, special
   files and mark-strings;

 - MTM *.* /DELMARK /ADDMARK
   This will delete ANY mark-string and add yours. If you select
   /ADDMARK, MTM will assume /DELMARK by default !!


 4.3 (De)compressors
 ────────────────────────────────────────────────────────────────────────
 Look into the same chapter in the MTA documentation.


 4.4 Encryption and Authenticity
 ────────────────────────────────────────────────────────────────────────
 MTM is NOT able (yet) to rework encrypted files (MTA can do this job
 for you) but it CAN handle PkWare's Authenticity Verification. If
 you try to delete a AV'ed file (with /DELFILE) than MTM will ignore
 this request and leaves the AV'ed file inside the archive.

 For further details on AV and Encryption you must look into the do-
 cumentation of MTA (MTADOCEN.DOC).

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   5   │ Version information and credits                             │
 └───────┴─────────────────────────────────────────────────────────────┘


 5.1 The BETA-team
 ────────────────────────────────────────────────────────────────────────
 See MTADOCEN.DOC


 5.2 Credits
 ────────────────────────────────────────────────────────────────────────
 See MTADOCEN.DOC


 5.3 Version history
 ────────────────────────────────────────────────────────────────────────
 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 12.01 │ Minor release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ MTM changed to Object Professional. Also some little internal
    fixes.

  ■ MTM would sometimes seem to hang when removing a comment from a
    ZIP-file. When you entered things would continue, but is in fact
    an error. This is fixed now;
    Reported by : Paul Bakker

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 12.05 │ Major release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ MTM now included the MTR option to include the MTA mark-string into
    the selected archives;
    Suggested by: Dirk Astrath

  ■ MTM will now be driven by command-line options. All MTM_xxx options
    in MTA.CTL are obsolete;
    Suggested by: Author

  ■ MTM can now use file-mask selection.
    Suggested by: Author

  ■ MTM could hang (seem to hang) in a DV alike environment. This is
    fixed (I hope);
    Suggested by: Adrie 'A3' van Lith

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 12.50 │ Major release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ MTM will ignore Encrypted files;
    Suggested by: Author

  ■ MTM will test if a deleted file inside a ZIP-file contains a AV
    code. In this case MTM will ignore the delete request;
    Suggested by: Author

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 12.51 │ Dummy release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ No changes;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 13.01 │ Major Release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Added registration and intro-screen;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 14.01 │ Major Release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Added support for encrypted files;
    Suggested by: Hanstheo Wolf

  ■ MTM could seem to hang on deletion of a file inside a ZIP. This
    was only the case when the filename started with a hyphen ('-').
    This is fixed.
    Suggested by: Hanstheo Wolf

  ■ Changed some statements in MTM (ZipAutoDescription) to the new
    MTA 'standard'.
    Suggested by: Author

  ■ Enhanced MTM to use any extended text-mode like 132xXX or 43/50
    lines mode.
    Suggested by: Author

  ■ MTM had some problems with the IncludeFile option. If you used
    a second option to add a renamed copy of the file in the ar-
    chive, MTM would fail. This is fixed.
    Suggested by: Hanstheo Wolf


 MTM is tested with PKWare PKPAK release 3.61, PKWare ZIP release 1.10,
│NoGate PAK release 2.50, ARC release 6.02 and ZOO release 2.01(X), DWC
 release 5.10, LHarc release 1.13c/d and LARC release 3.33.


 5.4 Copyrights, Trademarks
 ────────────────────────────────────────────────────────────────────────
 PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
 PAK           is a trademark of NoGate Consulting.
 ARC           is a trademark of SEA inc.
 ZOO           is a trademark of R. Dhesi.
 DWC           is a trademark of Dean W. Cooper
 LZH and LHarc are trademarks of Yoshi;
 LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
 4Dos          is a trademark of Rex Conn and JP software

 MTM is written in Turbo Pascal 5.5, with help of the Turbo Debugger 1.0
 and makes extensive use of Object Professional 1.02 and TxCFI V 8.11.
 Also included are some routines of Blaise's fine PowerTools Plus
 package (5.0).

 Turbo Pascal        is a trademark of Borland International
 Turbo Debugger      is a trademark of Borland International
 Object Professional is a trademark of TurboPower Inc.
 PowerTools Plus     is a trademark of Blaise Computing Inc.
 TxCFI               is a trademark of Robert W. van Hoeven

 Sorry for my usage of the English language, it's not my native language
 so this can happen.