Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MTA_VE55.ZIP / MTMDOCEN.DOC < prev next >

Wrap

Text File | 1991-09-01 | 28.2 KB | 645 lines

╔══════════════════════════════ ┌─────────────────┐ ║ MTM Make Them Modified │ D.I.S.P. │────┐ ║ │ │░░░░│ ╟────────────────────────────── │ │░░░░│ ║ (c) 1991 Robert W.van Hoeven │ Dutch │░░░░│ ╟────────────────────────────── │ Independent │░░░░│ ║ Release : 14.55 │ ShareWare │░░░░│ ║ Rel.Date: 1th September 1991 │ Programmer│░░░░│ ╠══════════════════════════════ └─────────────────┘░░░░│ ║ | │░░░░░░░░░░░░░░░░░│ ║ │ MTM.EXE | └─────────────────┘ ║ │ | ┌─────┐ | ║ │ | │░░░░░│ | ║ │ | └──┬──┘ | ║ │ Lines starting with '│' are | ┌────┴────┐ | ║ │ changes to release 14.51 !! ------││││││ ═══│------- ║ └─────────┘ ╠═══════════════════════════════ ║ 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 Licence 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 licence 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 licence 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 licence); - 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; - Support on MTA, when used in a non-commercial environment, is available by means of written letters or by entering the inter- national echomaol area DISP; - 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 licence agreements; - It is forbidden to modify, adapt, translate, reverse engineer, de- compile and/or disassemble the software in the MTA-package. Patching the medium at places that carry the software is seen as a program change and is also forbidden. It is forbidden to create a so called 'bypass' to skip the original introduction screens and delay. Also it is forbidden to use such a 'bypass' unless supplied by the author (Robert W. van Hoeven) himself; - Performing any of the illegal actions as stated in the previous lines, is a theft and no fair play to the author and, more important, to the registered users; - Bulletin Board Systems that distribute the MTA package can convert the WHOLE package to any archive-system they like but all original files must be included in the new archive. The MTA-package on the Bulletin Board can contain at the most 2 extra files. These files can only be a commercial for that Bulletin Board and/or validation data that is presented as a service to all users and shall have no other functions; - After the normal trial period of 30 days, you must register the soft- ware (see REGISTER.MTA) or you must remove it from your PC; - 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 at the DISP-HQ on node 2:512/100. MTA is also distributed thru a number of DISP support nodes. You can obtain MTA in four different ways: - Logging on at DISP-HQ or a support node │ See the file SUPPORT.MTA for a full list of nodes; - Logging on to a SDS node MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20 and so on) and majors (14.01, 15.01 and so on) are submitted to the SDS distribution point in Holland; - 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 or (better) 2:512/100.5; - 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 archives; - Add headers to archives; - 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. 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; /DELAV Force MTM to delete files even if the source archive is AV protected; /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 capable in reworking encrypted files. In this case, all supplied files must have the same password. You can supply the password to MTM with the /IOP command-line option. MTM will use this password on ALL files it will work on in this run. MTM 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 the file SUPPORT.MTA for a full list of beta-testers; 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 ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.05 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Added ARJ support. ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.06 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Fixed ARJ support and upgraded to ARJ's version 0.14alpha; ■ Forgot to change the chapter on encryption. MTM can work on encrypted files although the documentation of both 14.01 and 14.05 forgot to mention this fact ! ■ Added some new (and faster) code, though the difference will not be noticed I think. ■ MTM can now work on ARJ comments. ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.07 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Improved the ARJ detection algorithm; ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.10 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Added HYPER detection algorithm; ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.20 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Converted to Turbo Pascal 6.0, OPRO 1.10 and Powertools 5.10; ■ Added /DELAV option to force delete of files inside a ZIP-file even if that ZIP-file is AV-protected. This can cause the original AV code to reject the archive. ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.30 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Added support for LHARC 2.03 files; ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.35 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Nothing changed ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.40 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ When no extension was given, MTM would do nothing. Now .* is added when a mask is without extension and *.* is added when no masks at all were supplied; ■ The drive/path of the last filemask is taken as the directory to work on. You can use either this method or /W; ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.45 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Nothing changed ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.50 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Nothing changed ┌───────┬─────────────────────────────────────────────────────────────┐ │ 14.55 │ Minor Release │ └───────┴─────────────────────────────────────────────────────────────┘ ■ Fixed a bug in the support for the newer LHARC (LHA) formats. These were detected in MTA but not in MTM; ■ Added support for ZOO high-compressed formats (ZOO 2.10). MTM will now detect them; MTM is tested with PKWare PKPAK release 3.61, PKWare ZIP release 1.10, │NoGate PAK release 2.51, ARC release 6.02 and ZOO release 2.10, DWC │release 5.10, LHarc release 1.13c/d/213, LARC release 3.33, ARJ version │2.20 and HYPER version 25. 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 ARJ is a trademark of Robert K. Jung HYPER is a trademark of Peter Sawatzki and Klaus Peter Nischke 4Dos is a trademark of Rex Conn and JP software MTM is written in Turbo Pascal 6.0, with help of the Turbo Debugger 2.0 │and makes extensive use of Object Professional 1.12 and OPCFI V 9.25. Also a licensed commercial version of Strg 6.1 was used and the TP 6.0 SYSTEM.TPU was replaced with a licensed commercial version of SYS60a. Turbo Pascal is a trademark of Borland International Turbo Debugger is a trademark of Borland International Object Professional is a trademark of TurboPower Inc. OPCFI is a trademark of Robert W. van Hoeven SYS60 is a trademark of Eagle Performance Software STRG61 is a trademark of Eagle Performance Software Sorry for my usage of the English language, it's not my native language so this can happen.