home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MKMU100.ZIP / MKMU.DOC < prev    next >
Encoding:
Text File  |  1993-08-15  |  7.6 KB  |  228 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.   ╔═══════════════════════════╦═══════════════════════════════════════════╗
  14.   ║ Mythical Kingdom Software ║         <<MK Message Utilities>>          ║
  15.   ║      ▄ ▄         ▄ ▄      ║    Squish, Jam, *.Msg, Hudson, and Ezy    ║
  16.   ║      ███  ▐▀ ▐▀  ███      ║                                           ║
  17.   ║      ███████████████      ║        Copyright 1993 by Mark May         ║
  18.   ║      ██████░░░██████      ║            All Rights Reserved            ║
  19.   ║  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  ║                                           ║
  20.   ╚═══════════════════════════╩═══════════════════════════════════════════╝
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.         The products mentioned in this documentation are trademarks
  30.                           of their individual owners.
  31.  
  32.         "JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner,
  33.                                Mats Birch, Mats Wallin.
  34.                                ALL RIGHTS RESERVED."
  35.  
  36.  
  37.  
  38.  
  39.  
  40.   ──────────────────────────[    Documentation     ]────────────────────────
  41.  
  42.     The documentation for these utilities is somewhat limited.  These
  43.     programs were originally intended as examples of how to use the
  44.     MK Message Source routines (TP OOP source to access various message
  45.     base formats).
  46.  
  47.     I decided to release them in executable form as well, though since it
  48.     seemed that they would be useful to others as well.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.   ──────────────────────────[  Utilities Included  ]────────────────────────
  56.  
  57.  
  58.     MsgExprt - Exports a message area to a text file
  59.  
  60.     Example: MsgExprt Out.Txt H007C:\RA\Msg
  61.  
  62.     This utility will export messages from the various message base
  63.     formats into a text file.  It requires two command line paramaters.  The
  64.     first is the name of the text file to use for output.  The second is the
  65.     message area identifier of the message base to be exported.  Message
  66.     Area Identifiers are described in a section below.
  67.  
  68.  
  69.                          -----------------------
  70.  
  71.     MsgImprt - Imports a text file into a message base.
  72.  
  73.     Example: MsgImprt MK.Log /TMark_May /P /E /ASC:\Msg\Logs /SBBS_Log
  74.  
  75.     An application like this could be used to import log files or other
  76.     information into your message base.  To use it you give it
  77.     a command line paramater of the text file to use and various options,
  78.     the options must be preceeded by either a '/' or a '-'.  You can also
  79.     embed options in the text file by starting a line with a percent % sign
  80.     followed by the option.  The following options are supported:
  81.  
  82.     /FFrom_Name               /TTo_Name            /SSubject_Of_Message
  83.     /AMsgAreaId               /DDestAddress        /OOrigAddress
  84.     /P (private)              /E (Erase file afterward)
  85.  
  86.  
  87.                          -----------------------
  88.  
  89.     MKMsgCvt - Converts (copies) messages from one msg base to another
  90.  
  91.     Example: MKMsgCvt H007C:\RA\Msg SC:\Msg\General
  92.  
  93.     This application allows you to quickly convert a message base from
  94.     one format to another.  It displays a "banner" screen as it converts,
  95.     to show its progress.  An application like this could be useful when
  96.     converting to a new message base format.
  97.  
  98.  
  99.  
  100.  
  101.   ──────────────────────────[  Message Area Id's  ]────────────────────────
  102.  
  103.     To identify message areas, I use something I call a MsgAreaId.  It
  104.     identifies both the type of message base and the path/area that it
  105.     is in.  With a MsgAreaId, a program can open the message base without
  106.     needing to look up anything in the BBS config files.  I encourage others
  107.     to adopt them as well, so that people who use your program can get
  108.     used to a common way of specifying the message areas.
  109.  
  110.     Message area identifiers have the following formats:
  111.  
  112.     Squish:  S followed by the path\filename of the message area
  113.        Example:  SC:\Max\Msg\Muffin
  114.  
  115.     Hudson   H followed by a 3 digit area number follow by the msg base path
  116.        Example:  H007C:\Quick\MsgBase\
  117.  
  118.     Fido(*.Msg) F followed by the message path
  119.        Example:  FD:\FD\Mail\
  120.  
  121.     JAM J followed by the path\filename of the message area
  122.        Example: JC:\RA2\MSG\RA_UTIL
  123.  
  124.     Ezycom E followed by the 4 digit area number followed by the msg base path
  125.        Example: E0001F:\EZY\MSG
  126.  
  127.  
  128.  
  129.   ───────────────────────────[  PRODUCT SUPPORT  ]─────────────────────────
  130.  
  131.  
  132.     Help or suggestions can be submitted in a variety of ways.
  133.  
  134.     *  Through the FidoNet EchoMail MK Conference (AreaTag MK).
  135.         -   This is a product support area for all Mythical Kingdom
  136.         -   Software.
  137.  
  138.     *  If the MK Echo is not available in your area, it is available from
  139.        the following addresses:
  140.  
  141.        1:110/290       1:3625/457       1:151/1000       1:151/1003
  142.  
  143.     *  Through RIME (RelayNet) at address ->MYTHKING.
  144.  
  145.     *  Via NetMail to Mark May (Author) at address 1:110/290.
  146.         -   You will have to poll for your reply after two days due to the
  147.         -   product being free.  An answer should be waiting for you by
  148.         -   then.  If you do not receive a reply within 5 days, please
  149.         -   re-send your message.  If you don't pick up your reply, it will
  150.         -   be deleted in a week or two.
  151.  
  152.     *  Call the Mythical Kingdom Tech BBS directly:
  153.         -   DataLine : 513-237-7737 (9600 Baud HST/V32)
  154.             (note that this may get switched to a non-HST v32bis modem)
  155.  
  156.     *  Or, mail your questions/suggestions to:
  157.  
  158.             Mark May
  159.             Mythical Kingdom Software
  160.             P.O. Box 24808
  161.             Huber Heights, OH  45424
  162.  
  163.   ───────────────────────[  WARRANTY AND DISCLAIMER  ]─────────────────────
  164.  
  165.         The only thing the author can guarantee is that MKMU will take up
  166.     space on your hard drive.  Beyond that, you use the program at your own
  167.     risk.   MKMU has been tested in many different environments with no
  168.     damage, loss of data, or compromised security, and we cannot guarantee
  169.     how it will work in your environment.  The author will not be held
  170.     responsible for any damage to your system.
  171.  
  172.  
  173.  
  174.  
  175.   ────────────────────────────[  REGISTRATION  ]───────────────────────────
  176.  
  177.         A registration fee is not required for these programs.
  178.     If you are a shareware author, consider sending me a registered
  179.     version of your program in exchange for your use of this program.
  180.  
  181.  
  182.         If you wish to contact me about the MK Message Utilities,
  183.     you may use the form below.  I'll use the responses I get as a
  184.     gauge of the number of people using it, to allocate my time
  185.     between my various projects.
  186.  
  187.  
  188.         Registration Information:                  MKMU  v1.00
  189.  
  190.  
  191.         Name:         ____________________________________________
  192.  
  193.         Address:      ____________________________________________
  194.  
  195.                       ____________________________________________
  196.  
  197.         City, ST Zip  ____________________________________________
  198.  
  199.  
  200.         BBS Name:     ____________________________________________
  201.  
  202.  
  203.         BBS Phone Number  (     )        -
  204.  
  205.  
  206.         Applicable NetWork Address(es) (IE: FidoNet, Etc.)
  207.  
  208.         __________________________________________________________
  209.  
  210.         __________________________________________________________
  211.  
  212.  
  213.         Any suggestions or comments ______________________________
  214.  
  215.         __________________________________________________________
  216.  
  217.         __________________________________________________________
  218.  
  219.  
  220.         Registrations should be mailed to:
  221.  
  222.               Mark May
  223.               Mythical Kingdom Software
  224.               P.O. Box 24808
  225.               Huber Heights, OH  45424
  226.  
  227.  
  228.