home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / MUD29A.ZIP / MUD.DOC < prev    next >
Text File  |  1993-12-11  |  11KB  |  219 lines
  1.         MUD REGISTERED USERS RECEIVE:
  2.         
  3.             1. The latest version.
  4.             2. Any releases issued to correct bugs found in your version.
  5.             3. Telephone support.
  6.             4. A 30 day money back, satisfaction guarantee.
  7.             5. Notification of the next new feature release of MUD.
  8.         
  9.         As a registered user, you may reach us in the following ways:
  10.         
  11.             1. Write:       John W. Hansen
  12.                             211 Covington Square Drive
  13.                             Cary, NC 27513
  14.         
  15.             2. Voice mail:  1-919-460-5858 (East coast)
  16.         
  17.             3. BBS:         MMS      1-919-772-7654
  18.                             Micro Message Service
  19.               Leave message to John Hansen.
  20.               Search for the latest version of MUD on MMS
  21.  
  22.         
  23.         Registration Information
  24.         
  25.         This  is the SHAREWARE version of MUD.  You may register this
  26.         version for $10.00.  If you register you will receive a serialized 
  27.         and personalized copy.  
  28.         
  29.         Please make any checks payable to:
  30.            John Hansen
  31.            211 Covington Square Drive
  32.            Cary, NC 27513
  33.  
  34.         We appreciate your registration, and hope that MUD is of continu-
  35.         ing  value  to you in the future.  If you discover bugs  in  MUD, 
  36.         please  tell us; if you are satisfied with MUD, please tell  your 
  37.         friends  and  associates, and pass on to them your  copy  of  the 
  38.         SHAREWARE version of MUD.
  39.         
  40.         Legal disclaimer:
  41.  
  42.         JD Enterprises and its affiliated individuals hereby disclaim 
  43.         all  warranties  relating to this software,  whether  express  or 
  44.         implied,  including without limitation any implied warranties  of 
  45.         merchantability or fitness for a particular purpose.  We will not 
  46.         be liable for any special, incidental, consequential, indirect or 
  47.         similar damages due to loss of data or any other reason, even  if 
  48.         we or an agent of JD Enterprises has been  advised  of the
  49.         possibility of such damages.  In no event shall our liability 
  50.         for any damages ever exceed the price paid for the license to use 
  51.         software, regardless of the form of the claim.  The person  using 
  52.         the software bears all risk as to the quality and performance  of 
  53.         the software.
  54.         
  55.         
  56.         Software License
  57.         
  58.         The software license agreement is shown below.
  59.         
  60.         MUD - Mac/Unix DOS translator 2.9a
  61.         Copyright 1992, 1993 JD Enterprises
  62.         All rights reserved.
  63.  
  64.         You are free to use MUD on any single computer, provided:
  65.          - no fee is charged for its use
  66.          - it is not modified in any way
  67.  
  68.         You  are free to distribute the SHAREWARE version of MUD on  your
  69.         distribution disk provided
  70.          - no fee is charged for its use, copying or distribution
  71.          - it is not modified in any way
  72.         
  73.  
  74.         Using MUD
  75.         
  76.         Using MUD is as simple as typing MUD at the DOS command prompt.        
  77.         A menu will appear and you will be prompted to enter information.
  78.         MUD allows you to convert straight ASCII text file to various
  79.         file formats. The menu screen below shows the file formats and
  80.         the conversions that can be performed.
  81.  
  82.         1 - DOS -> Mac  format|  change CR/LF-> CR   |  hex 0D0A-> 0D
  83.         2 - DOS -> UNIX format|  change CR/LF-> LF   |  hex 0D0A-> 0A
  84.         3 - UNIX-> DOS  format|  change LF   -> CR/LF|  hex 0A  -> 0D0A
  85.         4 - UNIX-> Mac  format|  change LF   -> CR   |  hex 0A  -> 0D
  86.         5 - Mac -> UNIX format|  change CR   -> LF   |  hex 0D  -> 0A
  87.         6 - Mac -> DOS  format|  change CR   -> CR/LF|  hex 0D  -> 0D0A
  88.         
  89.         7 - Search and Replace function on both text or binary files
  90.         8 - Strip graphics characters (8 bit to 7 bit conversion)
  91.         9 - Remove blank lines (2 0D0A's in a row) for DOS file type only
  92.         B - Convert tabs to blank spaces
  93.         T - Convert blanks to tab (limited to 20 per tab)
  94.         
  95.         A - Convert ASCII to EBCDIC
  96.         E - Convert EBCDIC to ASCII       
  97.         
  98.         Q - QUIT
  99.         H - Help
  100.        
  101.  
  102.         What MUD will allow you to do is convert from one set of files to
  103.         the other.
  104.  
  105.         MUD will also do a character global search and replace. The
  106.         search and replace string is limited to 128 total characters
  107.         at one time. This means that the character string you want to
  108.         search for cannot exceed 128 characters or the replace string
  109.         cannot exceed 128 characters. This will work on text and binary
  110.         files. If you use it on BINARY files make sure you make a backup
  111.         of the file you are working on as the SEARCH and REPLACE may
  112.         end up being a SEARCH and DESTROY. If you are confident working
  113.         against a binary file make sure you replace the exact number
  114.         of characters you are searching for. In many cases if you add
  115.         or delete characters you will corrupt the file. 
  116.         
  117.         As an example:
  118.         We can change DOS 5.0's EDIT.COM to default to *.* instead of
  119.         *.TXT when asking to open a file. The program that controls this
  120.         is QBASIC.EXE. By running MUD against QBASIC.EXE and doing a
  121.         search and replace we would respond to the following prompts as:
  122.          
  123.              Find    : *.TXT
  124.              Replace : *.*         note: add two blank spaces after 2nd *
  125.  
  126.         In the REPLACE section we would have entered "*.*  ". Notice the
  127.         two blank spaces after the second *. This must be done in order
  128.         to perserve the same file size. If this is not done EDIT.COM
  129.         will hang your system and force a warm reboot.
  130.  
  131.         You can enter unprintable characters at the FIND and REPLACE
  132.         prompts simply by entering their decimal equivalent on the
  133.         numeric keypad (if you have one). You must enter them from
  134.         the keypad and not the numbers above the QWERTY keys.
  135.  
  136.         Example:
  137.  
  138.         Suppose you want to replace all ESCAPE characters in a file
  139.         with a NULL character. The ESCAPE character is represented
  140.         in the ASCII table as 027 decimal. The NULL character is 
  141.         represented as 000 decimal. By doing this you are effectively
  142.         removing the ESCAPE character from the file. This is how
  143.         it can be done.
  144.  
  145.         1. Invoke MUD
  146.         2. Select menu item 7
  147.         3. Enter name of file to be changed 
  148.         4. Enter name of new file (can be the same file name)
  149.         5. At the "FIND :" prompt you will enter the ESCAPE character
  150.            by holding down the ALT key and type the decimal
  151.            number of the ESCAPE character on the numeric keypad
  152.            as "027", then release the ALT key. The cursor should not
  153.            have moved at this point.
  154.         6. Hit the ENTER key to complete the FIND
  155.         7. At the "REPLACE :" prompt you will hold down the ALT key 
  156.            again and then on the numeric keypad enter "000" and release 
  157.            the ALT key. Again the cursor will not have moved and you can
  158.            hit the ENTER key to complete the replace procedure.
  159.         8. The number of replacements will be displayed at bottom
  160.            of the screen.
  161.  
  162.         Alternatively you could have just hit the ENTER key at the
  163.         REPLACE prompt without entering anything and that would have
  164.         removed all DEC 027 ESCAPE characters and make no replacement. 
  165.         The 'Remove blank lines (2 0D0A's in a row) for DOS file type only' 
  166.         option is specific to DOS file types only and only works when two
  167.         carriage returns are next to each other. If you have a CR and then 
  168.         the next line a couple of spaces and again a CR so it appears to
  169.         have a blank line this will not work because you really do not have
  170.         a blank line - you have a line with 2 spaces, though of course they
  171.         do not show on screen.
  172.         
  173.         The Macintosh environment uses numerous special characters. 
  174.         These characters have a Hex value of 128 or greater and are seen by
  175.         most text editors or wordprocessors as garbage. Use the 8 bit to
  176.         7 bit conversion option (8). This will strip out any characters that
  177.         have these unusual or undesired characteristics. This option
  178.         is most useful to remove characters such as ëï╟┼─╜, etc. When a 
  179.         MAC file moves to DOS a curly quote may look like ╜. This option
  180.         will remove them. NOTE: The ╜ is not replaced with '.
  181.         
  182.         Converting spaces to tabs and tabs to spaces may be necessary for 
  183.         certain programs. It is also useful for conserving space as you 
  184.         save 7 bytes when using tabs instead of spaces.
  185.         
  186.         The EBCDIC to ASCII and ASCII to EBCDIC conversion is generally done 
  187.         by whatever program does the download, but sometimes you may receive a
  188.         file in the wrong format and there is no easy way to convert it. When 
  189.         the EBCDIC data file is moved down insure that it has correct blocking
  190.         (mainframe talk for correct placement of CR\LF at end of every line). 
  191.         This is normally done when the file is moved down.
  192.         
  193.         Thank you for registering this product if you are a registered
  194.         user and if you are not, please consider doing so.
  195.  
  196.         John Hansen
  197.         
  198.         ------------------->>>>>>>>  cut here  <<<<<<<<-----------------------
  199.         
  200.         MUD version 2.9a registration information:
  201.  
  202.         Name:_________________________________________________________________
  203.         
  204.         Address:______________________________________________________________
  205.         
  206.         Address:______________________________________________________________
  207.         
  208.         City:____________________  State:_____  ZIP:__________________________
  209.         
  210.         Format of disk:____5.25 low   ____5.25 high   ____3.5 low   ____3.5 hi
  211.         
  212.         Where did you receive MUD from?_______________________________________
  213.         
  214.         Comments:_____________________________________________________________
  215.         
  216.         ______________________________________________________________________
  217.         
  218.         ______________________________________________________________________
  219.