home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT218.ZIP / ULCASE10.ZIP / ULCASE.DOC < prev    next >
Text File  |  1991-03-17  |  9KB  |  191 lines
  1.  
  2.                                      ULCase
  3.  
  4.                                   Copyright 1991
  5.  
  6.                                   Paul Robinson
  7.                                 Cushman Publishers
  8.                                 7720 Brandeis Way
  9.                               Springfield, VA 22153
  10.                                 FAX (703) 455-2027
  11.                                     Version 1.0
  12.  
  13. ULCase is Shareware, not in the Public Domain.  You are granted, at no
  14. charge, the right to determine the suitability of this software for your
  15. needs.  If you do find ULCase suitable and make use of it, you are
  16. expected to register with the author.  Registration will remove the
  17. shareware notice screen and the most recent version will be sent to you.
  18.  
  19. The registered version of ULCase gives the user the ability to edit and
  20. use a dictionary of nouns that are exceptions to standard
  21. capitalization.  Names like MacDonald, LaCroix, and deGrazia as well
  22. acronyms like AAA, TWA, UPS can be added to the dictionary.
  23.  
  24. DISCLAMER OF WARRANTY
  25.  
  26. DUE TO THE LARGE NUMBER OF HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH
  27. THIS PROGRAM MAY BE PLACED, NO WARRANTY OF FITNESS FOR A PARTICULAR
  28. PURPOSE IS OFFERED.  THOROUGHLY TEST THIS PROGRAM WITH NON-CRITICAL DATA
  29. BEFORE RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK OF USING
  30. THIS PROGRAM.  THE SELLER'S MAXIMUM LIABILITY WILL BE LIMITED TO REFUND
  31. OF THE PURCHASE PRICE OR PROGRAM REPLACEMENT.
  32.  
  33. NOTICE:
  34.  
  35. ULCASE CANNOT BE BUNDLED WITH OTHER SOFTWARE, HARDWARE OR EQUIPMENT AS A
  36. PACKAGE DEAL.  SHAREWARE DEALERS MAY CHARGE A TOKEN FEE NOT TO EXCEED
  37. $5.00 (US) FOR REPRODUCTION AND DISTRIBUTION EXPENSES.
  38.  
  39. To register ULCase 1.0 please complete this form and send it along with
  40. a check payable in US funds on a US bank for $25.00 to:
  41.  
  42.                 Cushman Publishers
  43.                 7720 Brandeis Way
  44.                 Springfield, VA 22513
  45.  
  46.         Name:___________________________________________________
  47.  
  48.  
  49.         Address:_________________________________________________
  50.  
  51.                 _________________________________________________
  52.  
  53.                 _________________________________________________
  54.  
  55.            Orders outside the United States add (s&h)    $ 5.00
  56.  
  57.                             Total enclosed:   ___________________
  58.  
  59.         Disk size  ______  5 1/4"       ______ 3 1/2"
  60.  
  61. Where did you get this program? ___________________________________________
  62.  
  63. ___________________________________________________________________________
  64.  
  65.  
  66.  
  67. ULCase is written in Turbo C.  ULCase can accept ASCII input up to 1024
  68. characters per line.  Designed primarily as a tool to convert ASCII
  69. mailing lists into proper case, ULCase has five separate functions.
  70.  
  71.         NOTE:  When converting a file, ULCase will create a new file
  72.         containing the converted information.  ULCase will not write
  73.         over your original file. ULCase will not accept as the destination
  74.     file name, the source file name if they reside in the same sub-
  75.     directory.   As the default destination file name, ULCase will 
  76.     assign to the converted file the original file name with the 
  77.     extension "cvt" unless you specifically rename the destination 
  78.     file something else. ULCase will write the destination file to 
  79.     the same sub-directory as the original file provided the names 
  80.     are not the same.  Because of space considerations, we recommend 
  81.     that your original source file be on a hard drive and not a floppy.
  82.  
  83.         ULCase will run either from a floppy or a hard drive.  However,
  84.         the file NOUN.DIC MUST reside in the same sub-directory as the
  85.         executable file ULCASE10.EXE. Both files must be in the
  86.         "current" directory.  Even though the Shareware version
  87.         of ULCase only uses one entry from the file NOUN.DIC, it is
  88.         essential that NOUN.DIC reside in the same sub-directory as
  89.         ULCASE10.EXE.  If the file NOUN.DIC becomes corrupted in any
  90.         way, another file can be created with any text editor if saved
  91.         in the ASCII mode.  Be sure that any replacement file is
  92.         properly named and in the correct sub-directory.
  93.  
  94.         1.  ULCase will read an ASCII file, converting first letter of
  95.         each sentence into a capital letter and the remaining ones into
  96.         lowercase letters.  ULCase defines a sentence as any group of
  97.         letters or characters that end with either a period space [. ],
  98.         a question mark space [? ] or an exclamation mark space [! ].
  99.  
  100.         2.  ULCase has a search and replace function.  NOTE:  ULCase does
  101.         NOT have a text editor, but the search and replace function was
  102.         included for those times when a fast means of replacing a
  103.         character string is needed.  Since ULCase operates in a text
  104.         mode, ULCase will not search for, nor replace with, any control
  105.         codes (i.e. including hard or soft carriage returns). We have
  106.         not tried all combinations of ASCII codes below ASCII 32
  107.         or above ASCII 127. The search for and replacement with any ASCII
  108.         codes below ASCII 32 is not recommended.
  109.  
  110.         3.  ULCase  will convert an ASCII mailing list into initial caps
  111.         and lower case for each group of letters found.  Hyphenated
  112.         names like Smith-Jones will convert properly, as will multiple
  113.         initials such as L.L. Bean.  Names that start with "Mc" will
  114.         have the third letter capitalized (McNeil, for example).  Names
  115.         with an apostrophe will have the letter following the apostrophe
  116.         capitalized (O'Neil), possessive cases like Men's and
  117.         contractions that end with " 't " are excluded.
  118.         All fifty states, the District of Columbia, Puerto Rico, the
  119.         Virgin Islands, and Guam will be converted to their two letter
  120.         uppercase abbreviation if the two letter abbreviation is used.
  121.         The acronym USA will remain capitalized.  The 10 Canadian provences,
  122.     Northwest Territiries and Yukon Territory will also convert as 
  123.     will Canadian Zip codes. 
  124.  
  125.                 Please note that there is no spelling checker.  The
  126.                 names must be properly spelled, regardless of case.
  127.  
  128.         The REGISTERED version of ULCase has a noun dictionary that can
  129.         be edited to include the user's requirements for names like
  130.         "MacDonald".  There are too many variations of "Mac" to
  131.         automatically convert the letter following "Mac" to upper case.
  132.         To allow the UNREGISTERED user to experience this dictionary
  133.         usage, one name only from the dictionary will be checked against 
  134.     the ASCII file being converted.  Since this file can be edited,
  135.         we suggest that the UNREGISTERED user place their favorite name
  136.         exception as the only name in the NOUN.DCT file and give it a try.
  137.  
  138.                 REMEMBER: ULCase defines a name as any collection of
  139.                 letters and numbers followed by a space.  While ULCase
  140.                 will ignore [.',"/-\*%s<SPACE>] as delimiters, if your
  141.                 mailing list has other delimiters immediately
  142.                 preceeding a name, that name will not be capitalized.
  143.                 Canadian zip codes will convert properly.
  144.  
  145.                 For example, if your list included a name that read as
  146.                 [^JOHN JONES] ULCase would return [^john Jones] to the
  147.                 destination file.
  148.  
  149.         4.  ULCase will read an ASCII file and convert the entire
  150.         destination file to lower case letters.
  151.  
  152.         5.  ULCase will read an ASCII file and convert the entire
  153.         destination file to upper case letters.
  154.  
  155. ULCase is menu driven and easy to use.  If a file cannot be opened for
  156. any reason, you will get an error message and be returned to the main
  157. menu.  Once loaded, ULCase requires approximately 34,000 bytes of free
  158. RAM to operate, so it should run on most machines.
  159.  
  160. For those who want to enter ULCase from the command line, there are two
  161. usages:
  162.  
  163.         ulcase [path:source filename] [path:destination file name]
  164.  
  165.         This will allow the user to specify a destination path and
  166.         destination filename separate from the default.  Verification
  167.         of the destination filename you specified will still be requested.
  168.  
  169.         ulcase [path:source filename]
  170.  
  171.         This will allow the user to quickly start from the DOS prompt.
  172.         Verification of the default destination file name will still be
  173.         requested.
  174.  
  175. The letter combinations "AL", "DE", "LA", and "MS" have more than one usage.
  176. ULCase will convert those letter combinations in the following order of
  177. precedence.
  178.  
  179.     1.  Whatever is contained in the NOUN.DCT file. (i.e. "de" if so
  180.         included.)
  181.  
  182.     2.  As "AL", "DE", "LA" and "MS" if a number following the letter 
  183.             combination is not more than two (2) spaces from the last letter.
  184.         (i.e. "al 31245" would be "AL 31245", "ms  53214" would be 
  185.         "MS  53214" but "ms    43215" would be "Ms    43215", provided 
  186.         there was no definition in the file "NOUN.DCT".)
  187.  
  188.     3.  As "Al", "De", "La", and "Ms" by default. 
  189.  
  190.  
  191.