home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / textutil / makecsv / !MakeCSV / !Help < prev    next >
Encoding:
Text File  |  1993-11-17  |  6.2 KB  |  160 lines
  1. !MakeCSV  Release 2   Copyright Justin Williams 1992,1993
  2.  
  3. The purpose of !MakeCSV is to take a text file, in normal format and
  4. convert it into a file in CSV format. 
  5.  
  6. Why would you want to do this ? 
  7.  
  8. Well, I had a list of names of files, with dates, and sizes. I wanted to
  9. sort them into size order using Pipedream, but could not because the info
  10. was all on the same line. It was all nicely columnised, but this didn't
  11. help  Pipedream. I had to do the conversion using Quattro Pro on the PC,
  12. and when a PC can do something my Archie can't I get annoyed. Hence this
  13. program was born.
  14.  
  15. Instructions :
  16.  
  17. Drag your text file onto the !MakeCSV icon (on the icon bar). A window
  18. will pop up showing the 1st 2 lines of the text file, and its guess at
  19. how you want the columns. Each set of ttt's or nnn's indicates a column,
  20. and the format. (text or numerical).  If you want to change this, just
  21. edit it. When it looks ok, then select the make CSV button and drag the
  22. CSV file icon to the filer window.
  23.  
  24. There are options to strip leading and trailing spaces. These are do as
  25. they say, and strip the leading or trailing spaces.
  26.  
  27. Thats it. Now for the copyright bit.
  28.  
  29. This program is not PD, but is Authorware. That means that I retain the
  30. copyright to it. You may distributed it to anybody you like, provided
  31. that all the files are included and that it remains unaltered.
  32.  
  33. It may be altered by you for your own personal use, but the altered
  34. version may not be distributed. Send it to me, I will give it a version
  35. number and give you the credit, and then make it available for general
  36. distribution.
  37.  
  38. If you find this program useful, please send in a donation of £1 to the 
  39. South African Archimedes User Group, or if getting hold of pounds is a 
  40. problem, then send a blank disc or two.
  41.  
  42. I ask that all users of this program register. Registration is FREE, and
  43. there are no advantages to registration, other than me knowing who is
  44. using my program. The donation is optional!
  45.  
  46.                                               
  47. Please note : I take all responsibility for any bugs in the program, but no
  48.               responsibility for any damage that they may cause. 
  49.  
  50. If you need to contact me to report any bugs etc, please write to :
  51.  
  52. Justin Williams
  53. PO Box 1051
  54. Wandsbeck
  55. 3631
  56. Natal
  57. South Africa
  58.  
  59. E-Mail : williamj@shrike.und.ac.za (Until January 1994)
  60.  
  61. 8 April 1993
  62.  
  63. Version 1.0
  64.  
  65. - first release
  66.  
  67. Version 2.1
  68.  
  69. - Alterations of the field icon now work correctly when multiple spaces
  70.     separate a field
  71. - Inter application transfers work (but the source file must be on disc!)
  72. - The leading/trailing space options have been enabled
  73. - The program is no longer public domain, but Authorware.
  74.  
  75. Version 2.2
  76.  
  77. - Fixed up the menus to work with Risc OS 3 
  78. - Increased the size of the view window to allow for 255 char widths
  79. - Compacted the source code using Risc OS 3's crunch command with all options
  80. - Reduced the slot size of the program to 48k
  81. - Released onto Newcastle
  82.  
  83. Version 2.3
  84.  
  85. - included option to allow end of line markers other than <return>. 
  86. - allowed the reading of fixed length records which have no end of record
  87.    marker eg. DBase files
  88.    - the record length limit of 255 characters makes the above feature near
  89.      to useless.
  90. - re-worked some small pieces of the code. No functional difference.
  91. - moved the icons in the main window around to make space for the new one
  92. - tested crunching with !BasCrnch2, is far more efficient than Basic's crunch
  93.   but, using Basic Crunch before !BasCrnch2 is even more efficient!
  94.  
  95. Original Size      : 11880
  96. Basic's Crunch     : 9179
  97. BasCrunch 1.02     : 5494
  98. Crunch + BasCrunch : 5323
  99. BasCrunch + Crunch : 5494
  100.  
  101. Interesting huh?
  102.  
  103. Version 2.3.1
  104.  
  105. - further reduced the slotsize of the program to 32k
  106.    - how are you supposed to determine the slotsize ???
  107. - removed a newly introduced bug which occurred with EOF when using non-13
  108.   end of line markers
  109. - placed close icon on save box. Window now in new format.                 
  110. - second release to Newcastle (first one had a corrupted template file)
  111.  
  112. Version 2.3.2
  113.  
  114. - removed the old menu system and introduced Petrov Software's system, this
  115.    is much superior, and doesn't need to be "kludged" to work under Risc OS 3
  116. - allow the user to press "RETURN" in the 'End of line' field to redo 
  117.    descriptor automatically without having to select it on the menu
  118. - had to introduce an exceptions list for variables to be crunched. The 
  119.    functions called by the menu handler must not be crunched!
  120.  
  121. Please note : the new features in this version are not fully functional and 
  122.               still need a bit of work. Converting plain text files to CSV
  123.               will work fine, but fixed length record files needs some 
  124.               refinement.
  125.  
  126. Version 2.4
  127.  
  128. - altered the template slightly to make space for the TSV option
  129. - can now have fields which are not seperate by spaces, simply use different
  130.    case eg. TTTTtttt will give two fields (text) of 4 chars each.
  131. - implemented the CSV and TSV choice option. The icon changes to suit the
  132.    type. (Is the TSV filetype supposed to be TEXT??)
  133. - removed the program version number from the template, is now filled in by
  134.    the program at RunTime
  135. - introduced an error box, pretty useless though as doesn't allow recovery
  136. - started using !Zap to edit the program. Is great, almost as good as the
  137.    old ArmBE. I still miss the LIST IF command of BASIC. The search command
  138.    could also be improved, but, it is the best BASIC editor around, better
  139.    than !DeskEdit. Try it see!
  140. - the error box now doesn't quit! Could result in infinite loops though, but
  141.    now the data isn't lost.
  142.  
  143. Version 2.5
  144.  
  145. - solid drags now work, and only when the CMOS bit is set. Doesn't bother to
  146.    check it is a Risc OS 3 machine, so Risc OS 2 machines with the bit set
  147.    will have a problem.
  148. - interactive help implemented, didn't do much for the code length, went from
  149.    around 5500 bytes to 7800 bytes. Anyway, if people is it it might be worth
  150.    it. I didn't increase the slot size, so if you have any problems, just
  151.    increase it to 48k.
  152.  
  153. Possible future enhancements :
  154.  
  155. - Allow the guess format option to be used on lines other than the 1st two
  156. - Allow the maximum input line length to be >255 characters
  157.     (will require major re-write though!)
  158. - Speed up the program
  159. - Make the window and icons re-size according to the file being converted
  160.