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