home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / changetxt / !ChangeTxt / !Help < prev    next >
Encoding:
Text File  |  1996-12-09  |  7.6 KB  |  215 lines
  1.                              ChangeTxt v2.1 26/10/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.    - ArcWeb compatible. Automatically converts files downloaded from the
  34.      Internet.
  35.  
  36. An unregistered version only supports mapping between DOS and Acorn,
  37. character set and line terminator mapping, multitasking and ArcWeb support. 
  38.  
  39. For details on registration see the end of this file.
  40.  
  41. Using ChangeTxt
  42. ===============
  43.  
  44. To launch ChangeTxt, just double-click on the !ChangeTxt icon which will 
  45. then appear on the right hand side of the icon bar.
  46.  
  47. To view the ChangeTxt dialog click on the !ChangeTxt icon on the icon bar.
  48.  
  49. The ChangeTxt dialog is described below from the top of dialog down.
  50.  
  51. Conversions
  52. ============
  53.  
  54.    Character set - if ticked, the source characters are mapped onto the
  55.                    destination character set. e.g. • will map to •
  56.                    Otherwise without character set mapping a • may map to ¢
  57.                    Any character that cannot be mapped will be translated to
  58.                    a ?
  59.  
  60.    Termination - if ticked then the source format line terminators are converted to
  61.                  the appropriate target format line terminators, otherwise no
  62.                  conversion of the line terminators is performed;
  63.  
  64.    Strip codes - if ticked then all control code characters are stripped from
  65.                  the destination file. Control code characters are the
  66.                  non-printable characters in the range of 0-31 ASCII, but
  67.                  not including the destination format line terminators nor the
  68.                  tab character;
  69.  
  70.    Expand tabs - if ticked then any tab characters to be written to the destination
  71.                  file are converted to a number of spaces as specified in the
  72.                  spaces writable icon.
  73.  
  74.  
  75. Below the conversion options are two pop-up menus separated by an arrow.
  76. The pop-up menu to the left of the arrow is the source format. The pop-up
  77. menu to the right of the arrow is the destination format.
  78.  
  79. The source and destination menus allow the user to specify one of the following
  80. formats as either source or destination: Mac, DOS, Acorn, OS/2
  81.  
  82. Any mapping combination is allowed except to itself, so you will not be allowed
  83. to map DOS to DOS.
  84.  
  85. The source menu has an additional item, Guess. When Guess is selected, ChangeTxt
  86. will examine the contents of the source file in an attempt to identify the source
  87. format. It will then convert the file to the selected destination format. As OS/2 
  88. and DOS text files are similar, any conflict on guessing will default to DOS.
  89.  
  90. Status
  91. ======
  92.  
  93. During conversion, the window displays the name of the file currently being 
  94. converted.
  95.  
  96. Below this a red bar shows the progress of the file being converted.
  97.  
  98. Below this a green bar shows the progress through a batch of files.
  99.  
  100. Drop files here
  101. ===============
  102.  
  103. To perform a conversion, drag the file to be converted onto the window.
  104. A save dialog is presented which is used to give the destination path for 
  105. the converted file. If multiple files are dragged onto the window then a 
  106. destination directory is acquired. The converted file names are then the same 
  107. as the original file names, but placed in the given directory.
  108.  
  109. The conversion of the text files occurs in background. More files can be 
  110. selected for conversion while current conversions are taking place. ChangeTxt
  111. remembers the conversion mapping associated with each file, so different jobs
  112. can have different mappings.
  113.  
  114. Conversion can be aborted by clicking on the abort button in the window.
  115. Aborting terminates all currently identified conversions. Abortion is 
  116. automatic if the window is closed or the program is quitted.
  117.  
  118.  
  119. ArcWeb Support
  120. ==============
  121.  
  122. ChangeTxt can now be used alongside the ArcWeb browser to automatically convert foreign
  123. text file formats to Acorn format before viewing. Conversion of the foreign file formats
  124. is performed using the standard ChangeTxt dialog options. ChangeTxt can also be instructed
  125. to terminate when ArcWeb terminates, so it can be placed in the WebHelper folder along with
  126. the other helpers.
  127.  
  128.  
  129. Icon Bar Menu
  130. =============
  131.  
  132.         Info             -> displays the standard information dialog plus
  133.                             registration details
  134.         Report           -> displays the file conversion report window
  135.         Quit with ArcWeb -> if ticked then ChangeTxt will quit when ArcWeb quits
  136.         Save preferences -> saves the current dialog options and 'Quit with ArcWeb' state
  137.                             to a 'prefs' file internal to ChangeTxt. These preferences are
  138.                             automatically loaded when ChangeTxt is next started. Only
  139.                             available if registered
  140.         Quit             -> quits the ChangeTxt application
  141.  
  142.  
  143. Dialog Menu
  144. ===========
  145.  
  146. The dialog menu contains a subset of the Icon Bar Menu options.
  147.  
  148. Limitations
  149. ===========
  150.  
  151. ChangeTxt has not been tested under RISC OS 2.
  152.  
  153. Registration
  154. ============
  155.  
  156. ChangeTxt uses a registration system which uses a key to enable full 
  157. functionality of the application. Without the key then ChangeTxt will 
  158. only allow a subset of its features to be used.
  159.  
  160. If you wish to register and use all of ChangeTxt's features then send
  161. your name and address, along with a cheque for £10 (£30 for commercial users)
  162. sterling to the address below.
  163.  
  164. In return we will send you a key which will enable all ChangeTxt's features.
  165. The key belongs to you and will ensure that you will be able to fully use 
  166. any future versions of ChangeTxt.
  167.  
  168. As a registered user you may have any number of copies as your name
  169. will appear in the program information dialog. You can also send us
  170. a disc with your key for the latest version, which we will return to you.
  171.  
  172. You can also download the latest copy of ChangeTxt from our website:
  173.  
  174. http://www.ehorizon.demon.co.uk
  175.  
  176. Point of Contact
  177. ================
  178.  
  179. If you have any technical queries/suggestions then please write to Darryl Sims, at either:
  180.  
  181. Arcade: “Darryl Sims” (0181 654 2212/0181 655 4412)
  182.  
  183. or
  184.  
  185. 27 Killewarren Way
  186. Orpington
  187. Kent
  188. BR5 4DH
  189.  
  190. or dsims@ehorizon.demon.co.uk
  191.  
  192. For registration please send a cheque or postal order made payable to Paul Gee
  193. at the address below. Please remember to include your return address or e-mail
  194. address so we can return your registration key.
  195.  
  196. The Event Horizon
  197. Kilmarth
  198. Stick Hill
  199. Edenbridge
  200. Kent
  201. TN8 5NL
  202.  
  203. e-mail: pgee@ehorizon.demon.co.uk
  204.  
  205. © The Event Horizon, All Rights Reserved 1996.
  206.  
  207. History
  208. =======
  209.  
  210. v2.1 - Fixed erroneous behaviour whenever a file is dragged to the icon bar before the
  211.        conversion dialog has been opened.
  212.        Fixed failure of the registered mappings to respond to all of the dialog options.
  213.        Added preferences option.
  214.        Added ArcWeb browser support so ChangeTxt can act as a helper.
  215.