home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / textutil / csvtotext / !CSVtoText / !Help < prev    next >
Encoding:
Text File  |  1992-06-14  |  7.4 KB  |  193 lines
  1.                                  CSV to Text (Public Domain version)
  2.                                  ===========
  3.  
  4. This document was last updated on: 14-Jun-92
  5.  
  6. Copyright
  7. =========
  8.  
  9. All aspects of this application are © copyright Architype Software 1992.
  10.  
  11.  
  12. Using CSVtoText
  13. ===============
  14.  
  15. This application, as its name suggests, takes a CSV file and processes it to
  16. produce a text file.  Using the application couldn’t be easier, just drop a
  17. CSV file onto the iconbar icon and the main window will be displayed (if it
  18. is not already open).  Update the filename to save the text file as and
  19. either press <RETURN> (if the caret is in the writable icon), click on the
  20. OK button, or drag the text file icon to a filer window (or other
  21. appropriate application window or icon).
  22.  
  23. The main window that appears is divided into two areas.  The left hand area
  24. shows the option settings which will affect the way the CSV file is
  25. processed to produce the text file.  The right hand area is a standard save
  26. dialogue box, which allows a specific filename to entered, etc.
  27.  
  28.  
  29. Configuration
  30. =============
  31.  
  32. To allow control over how a CSV file is acted upon, there are a number of
  33. configuration options available.  These affect the default destination
  34. filename (see the section ‘Filename’) and how the CSV file is processed to
  35. produce the text file (see the section ‘Options’).
  36.  
  37. Note: All the options are set to off and cannot be turned on in this Public
  38. Domain version.  The leafname can be edited though, but cannot be saved.
  39.  
  40. Filename
  41. --------
  42.  
  43. There are two options which allow control over the way the source filename
  44. is processed to produce the destination filename:
  45.  
  46. ‘Set leafname to:’  - If this option is on then the leafname in the writable
  47.                       icon (to the right of the option) will replace the
  48.                       leafname from the source filename.
  49.  
  50. ‘Use leafname only’ - If this option is on then only the leafname is used
  51.                       for the destination filename.
  52.  
  53. Note: The leafname can be edited at all times.  If there is no text in the
  54. writable icon when either ‘OK’ or ‘Save’ is selected, then the leafname
  55. ‘TextFile’ will be inserted automatically.  The leafname will be used by
  56. default in the save window writable icon (on the main window display) in two
  57. circumstances:
  58.  
  59.  1. The source filename is ‘<Wimp$Scrap>’, caused by dragging a CSV file
  60.     from another application onto this application’s iconbar icon.
  61.  
  62.  2. The destination filename is set to ‘<Wimp$Scrap>’, caused by dragging
  63.     the save text icon onto another application’s window (and not a filer
  64.     window).
  65.  
  66. In the table below, the source filename is ‘adfs:...CSVfile’ and the
  67. leafname for the option ‘Set leafname to:’ is ‘TextFile’.
  68.  
  69. ‘Set leafname to:’  ‘Use leafname only’  Destination filename
  70. ------------------  -------------------  --------------------
  71. Off                 Off                  adfs:...CSVfile
  72. On                  Off                  adfs:...TextFile
  73. Off                 On                   CSVfile
  74. On                  On                   TextFile
  75.  
  76. Options
  77. -------
  78.  
  79. ‘Lines output/record’    - With this option is off, the value chosen for the
  80.                            minimum number is calculated as the number of
  81.                            fields selected for output (and will be auto-
  82.                            matically updated if ‘Output selected fields’ is
  83.                            updated.
  84.  
  85. ‘Ignore blank fields’    - With this option is off, all fields, blank or
  86.                            not, will be output to the text file, and so
  87.                            there may be blank lines in the output text
  88.                            between fields of the same record.
  89.  
  90. ‘Output field names’     - With this option is off, the field names are not
  91.                            output to the text file at the start of each
  92.                            field line.
  93.  
  94. ‘Output selected fields’ - With this option is off, all the fields will be
  95.                            output.
  96.  
  97.  
  98. RISC OS 3 features
  99. ==================
  100.  
  101. The main window can be iconized onto the Pinboard by clicking on the
  102. window’s close icon whilst holding down the SHIFT key.
  103.  
  104. When dragging the text file icon, the icon itself can be dragged (using
  105. the module DragASprite).  You will need to type the following line before
  106. it will take affect: *FX 162,28,2
  107.  
  108. The pointer will change to a menu icon when moved over the menu button on
  109. the main window.
  110.  
  111.  
  112. Limitations
  113. ===========
  114.  
  115. The first line of the CSV file must be the field names.  This information is
  116. required to build the field menu and to calculate the number of fields per
  117. record.  If the CSV file doesn’t have this line, add one manually using a
  118. suitable text editor before using the file with this application.
  119.  
  120. The CSV file must use commas (‘,’) as the field separator.  (It wouldn’t be
  121. a Comma Separated Value file otherwise!)
  122.  
  123. The maximum number of fields in a CSV file which can be processed is 10. 
  124.  
  125. The maximum value which can be set for ‘Lines output/record’ is 49.
  126.  
  127. The conversion of the CSV file works by reading in the source CSV file
  128. whilst writing to the destination text file.  This means that the
  129. destination filename MUST be different from the source filename.  It is,
  130. however, possible to drag a CSV file from an application onto CSVtoText and
  131. then drag the text file icon onto another application, as CSVtoText uses its
  132. own scrap file (in the same directory as the normal scrap file) when storing
  133. the CSV file.  This scrap file is automatically deleted when CSVtoText is
  134. quit by one of the normal procedures.
  135.  
  136.  
  137. End User Licence Conditions
  138. ===========================
  139.  
  140. ‘Software’ refers to the code for all versions of !CSVtoText and related
  141. software.
  142.  
  143. ‘User’ refers to the person or organisation who has purchased the software.
  144.  
  145. The conditions of use are:
  146.  
  147.   1. This Public Domain version of the Software has been placed into the
  148.      public domain.  It may be freely copied and distributed for non-profit
  149.      making purposes (a small charge to cover cost of distribution is
  150.      allowed, however), so long as the code is not altered (apart from
  151.      customising !Run/!Boot files) and this text file remains present and
  152.      unaltered.
  153.  
  154.   2. No part of the Software may be included within programs, public domain
  155.      or otherwise, written by the User.
  156.  
  157.   3. No liability will be accepted by the author or Architype Software for
  158.      the suitability of the Software for any purpose, or for any loss due to
  159.      the use or mis-use of the Software.
  160.  
  161. If you would like to purchase the full version of !CSVtoText, which has all
  162. the options available (see the !Help_1-01 text file for full details), the
  163. cost is as follows:
  164.  
  165.  'A' : Businesses, Secondary schools, and higher education establishments.
  166.  
  167.  'B' : Home users and Primary/Infant/Junior schools.
  168.  
  169. Price each:  less than 10 copies     10 or more copies
  170.              -------------------     -----------------
  171.    'A' :          £9.00                   £6.00
  172.    'B' :          £5.00                   £3.00
  173.  
  174. When purchasing multiple copies, please supply addresses of each site for
  175. registration purposes.
  176.  
  177. If purchasing 10 or more copies, you will receive 1 copy of the software
  178. and a licence to distribute the software to those sites named.
  179.  
  180. Please make all cheques payable to Architype Software.
  181.  
  182. Note that the above prices include P&P and that Architype Software is not
  183. registered for VAT.
  184.  
  185. Send all orders, or any queries/suggestions to:
  186.  
  187.  Architype Software
  188.   54 Parkes Hall Road
  189.    Woodsetton
  190.     Dudley
  191.      West Midlands
  192.       DY1 3SR
  193.