home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsc / changetxt / !ChangeTxt / !Help < prev    next >
Encoding:
Text File  |  1996-08-20  |  6.1 KB  |  180 lines
  1.                              ChangeTxt v2.0 27/7/96
  2.                              =======================
  3.  
  4.  
  5. Overview
  6. ========
  7.  
  8. ChangeTxt converts text files between Acorn, PC and Macintosh platforms.
  9. A registered version of ChangeTxt supports the following features:
  10.  
  11.    - Line terminator mapping. i.e <CR> to <LF>, etc.
  12.  
  13.    - Character set mapping between Acorn, DOS, OS/2 & Macintosh 
  14.      platforms. So a bullet '•' will still look like a '•' even
  15.      if it has a different ASCII value between character sets.
  16.  
  17.    - Strips invisible characters. Expands tabs.
  18.  
  19.    - Provides direct conversions between platforms:
  20.      Acorn to Mac, Dos, OS/2
  21.      Dos to Acorn, Mac , OS/2
  22.      Mac to Acorn, DOS, OS/2
  23.      OS/2 to Mac, Acorn, DOS
  24.  
  25.    - Guess platform type. ChangeTxt will examine the contents of a text
  26.      file and automatically choose a source platform to map to your
  27.      destination platform.
  28.  
  29.    - Fully multitasking. All file conversions are performed in
  30.      background. Allows multiple files to be converted, even add files
  31.      with a different mapping during conversion.
  32.  
  33. An unregistered version only supports mapping between DOS and Acorn,
  34. character set and line terminator mapping and multitasking. 
  35.  
  36. For details on registration see the end of this file.
  37.  
  38. Using ChangeTxt
  39. ===============
  40.  
  41. To launch ChangeTxt, just double-click on the !ChangeTxt icon which will 
  42. then appear on the right hand side of the icon bar.
  43.  
  44. To view the ChangeTxt dialog click on the !ChangeTxt icon on the icon bar.
  45.  
  46. The ChangeTxt dialog is described below from the top of dialog down.
  47.  
  48. Conversions
  49. ============
  50.  
  51.    Character set - if ticked, the source characters are mapped onto the
  52.                    destination character set. e.g. • will map to •
  53.                    Otherwise without character set mapping a • may map to ¢
  54.                    Any character that cannot be mapped will be translated to
  55.                    a ?
  56.  
  57.    Termination - if ticked then the source format line terminators are converted to
  58.                  the appropriate target format line terminators, otherwise no
  59.                  conversion of the line terminators is performed;
  60.  
  61.    Strip codes - if ticked then all control code characters are stripped from
  62.                  the destination file. Control code characters are the
  63.                  non-printable characters in the range of 0-31 ASCII, but
  64.                  not including the destination format line terminators nor the
  65.                  tab character;
  66.  
  67.    Expand tabs - if ticked then any tab characters to be written to the destination
  68.                  file are converted to a number of spaces as specified in the
  69.                  spaces writable icon.
  70.  
  71.  
  72. Below the conversion options are two pop-up menus seperated by an arrow.
  73. The pop-up menu to the left of the arrow is the source format. The pop-up
  74. menu to the right of the arrow is the destination format.
  75.  
  76. The source and destination menus allow the user to specify one of the following
  77. formats as either source or destination: Mac, DOS, Acorn, OS/2
  78.  
  79. Any mapping combination is allowed except to itself, so you will not be allowed
  80. to map DOS to DOS.
  81.  
  82. The source menu has an additional item, Guess. When Guess is selected, ChangeTxt
  83. will examine the contents of the source file in an attempt to identify the source
  84. format. It will then convert the file to the selected destination format. As OS/2 
  85. and DOS text files are similar, any conflict on guessing will default to DOS.
  86.  
  87. Status
  88. ======
  89.  
  90. During conversion, the window displays the name of the file currently being 
  91. converted.
  92.  
  93. Below this a red bar shows the progress of the file being converted.
  94.  
  95. Below this a green bar shows the progress through a batch of files.
  96.  
  97. Drop files here
  98. ===============
  99.  
  100. To perform a conversion, drag the file to be converted onto the window.
  101. A save dialog is presented which is used to give the destination path for 
  102. the converted file. If multiple files are dragged onto the window then a 
  103. destination directory is acquired. The converted file names are then the same 
  104. as the original file names, but placed in the given directory.
  105.  
  106. The conversion of the text files occurs in background. More files can be 
  107. selected for conversion while current conversions are taking place. ChangeTxt
  108. remembers the conversion mapping associated with each file, so different jobs
  109. can have different mappings.
  110.  
  111. Conversion can be aborted by clicking on the abort button in the window.
  112. Aborting terminates all currently identified conversions. Abortion is 
  113. automatic if the window is closed or the program is quitted.
  114.  
  115.  
  116.  
  117. Icon Bar Menu
  118. =============
  119.  
  120.         Info   -> displays the standard information dialog plus
  121.                   registration details
  122.         Report -> displays the file conversion report window
  123.         Quit   -> quits the ChangeTxt application
  124.  
  125.  
  126. Limitations
  127. ===========
  128.  
  129. ChangeTxt has not been tested under RISC OS 2.
  130.  
  131. Registration
  132. ============
  133.  
  134. ChangeTxt uses a registration system which uses a key to enable full 
  135. functionality of the application. Without the key the ChangeTxt will 
  136. only allow a subset of its features to be used.
  137.  
  138. If you wish to register and use all of ChangeTxt's features then send
  139. your name and address, along with a cheque for £10 (£30 for commercial users)
  140. sterling to the address below.
  141.  
  142. In return we will send you a key which will enable all ChangeTxt's features.
  143. The key belongs to you and will ensure that you will be able to fully use 
  144. any future versions of ChangeTxt.
  145.  
  146. As a registered user you may have any number of copies as your name
  147. will appear in the program information dialog. You can also send us
  148. a disc with  your key for the latest version, which we will return to you.
  149.  
  150. Point of Contact
  151. ================
  152.  
  153. If you have any technical queries/suggestions then please write to Darryl Sims, at either:
  154.  
  155. Arcade: “Darryl Sims” (0181 654 2212/0181 655 4412)
  156.  
  157. or
  158.  
  159. 27 Killewarren Way
  160. Orpington
  161. Kent
  162. BR5 4DH
  163.  
  164. or darrylsims@arcade.demon.co.uk
  165.  
  166. For registration please send a cheque or postal order made payable to Paul Gee
  167. at the address below. Please remember to include your return address or e-mail
  168. address so we can return your registration key.
  169.  
  170. The Event Horizon
  171. Kilmarth
  172. Stick Hill
  173. Edenbridge
  174. Kent
  175. TN8 5NL
  176.  
  177. e-mail: paulgee@arcade.demon.co.uk
  178.  
  179. © The Event Horizon, All Rights Reserved 1996.
  180.