home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / varia / htmless / htmless.doc < prev    next >
Text File  |  1977-12-31  |  7KB  |  240 lines

  1. *****************************************
  2. *        `HTMLess'  v 1.1        *
  3. *       An OriginalWare release by      *
  4. *    Troglobyte/Darkness © 1996    *
  5. *****************************************
  6.  
  7. Contents
  8. ========
  9.  
  10. 1. Introduction
  11. 2. History
  12. 3. Bugs
  13. 4. OriginalWare?
  14. 5. Also available...
  15. 6. Thanks
  16. 7. Credits
  17.  
  18. 1. Introduction
  19. ===============
  20.  
  21. HTMLess is just another utility to convert HTML files (Web pages) in a
  22. readable text format.The main features are:
  23.  
  24.  - Fast (written 100% in assembler) and small (only 10000 bytes long).
  25.  - CLI and Workbench usage.
  26.  - Admit filenames as CLI parameters (can be launched from a
  27.    DiskMaster/DirOpus type program to autoconvert HTML's).
  28.  - Output text could be formatted to easy reading.
  29.  - Can keep [href's] (like WWW adresses) in the output text.
  30.  - .HTML or .HTM filename suffix will be changed to .Text or .txt
  31.  - The program will report any kind of errors.
  32.  - Very easy to use...just try it.
  33.  - Great results (complex AI routines used *8).
  34.  - All non-ASCII chars are converted.
  35.  - HTML Lists converted to text lists.
  36.  - `HTMLess' is a wonderful name. 
  37.  - It's OriginalWare (OriginalWhat?) and it's only Amiga (Yeah!).
  38.  - No annoying requesters when starting/using/quitting program.
  39.  
  40.  
  41. Workbench usage:
  42.  
  43. Just launch the program and use the file requester to select the HTML file to
  44. load and to choose the name to save the text file.
  45. (Since v1.1 this `complex' option works *8)
  46.  
  47.  
  48. CLI usage:
  49.  
  50. Write just the options or the options and the filename (if not filename is
  51. given or if there is any kind of problem a file requester will be used).
  52. Options must be ahead of the file name and must be after a "-" char.
  53. Options can be together or alone (-c20h or -c -h20) and written in capital
  54. or small letters (-HC5, -hc5 or -hC5)
  55.  
  56. The available options are: 
  57.  -h & -H: if used "href's" will be removed.By default "href's" are included
  58.           in the output text betwen "[...]" chars.
  59.  -cXXXX : XXXX are 1 to 4 numbers (-c10,-c200,-c0080) to select the size of
  60.           the columns of the formated text (default size is 80 columns).
  61.       If the number is zero, text won't be formatted (-c0,-c0000)
  62.  
  63. Examples:
  64.  
  65. 1. HTMLess -hc80 File1.html
  66.    Results : A text file "File1.text" without [href's] and formated to 80
  67.              columns will be saved.
  68.  
  69. 2. HTMLess -h -c0040 File2.htm
  70.    Results : A text file "File2.txt" without [href's] and formated to 40
  71.              columns will be saved.
  72.  
  73. 3. HTMLess -c0 File3.txt
  74.    Results : A text file with the same name "File3.txt" with [href's] and
  75.    unformated text will be saved.
  76.  
  77. Common errors :
  78.  
  79. 1. Options must be after a "-" char always.
  80.    BAD: HTMLess -h c80 File1.html
  81.    OK : HTMLess -hc80 File1.html or HTMLess -h -c80 File1.html
  82.  
  83. 2. Options must be ahead of the filename.
  84.    BAD: HTMLess File1.htm -c20h
  85.    OK : HTMLess -c20h File1.htm
  86.    
  87.  
  88. The only requirement is the "ReqTools.library" by Nico Francois and by Magnus
  89. Holmgren who fortunately is continuing the development of the indispensable
  90. reqtools library.
  91.  
  92. If you need a custom version of this program (for a personal necessity);
  93. contact me and I will try to make a customized version for you (if it isn't
  94. to difficult or too much work).
  95.  
  96. If you think the sources (100% assembler) could be useful for you (to include
  97. in a program you are developing or for learning purposes) just contact me and
  98. ask for them.
  99.  
  100.  
  101. 2. History
  102. ==========
  103.  
  104. Version 1.0 ( 1.April.1996 ) :
  105.  - First official release.
  106.  
  107. Version 1.1 ( 5.April.1996 ) :
  108.  - Fixed Workbench icon bug (Sorry about that stupid icon type error).
  109.  - All non-ASCII chars are supported now.
  110.  - Improved conversion of HTML Lists (now are more readable).
  111.  - Some extra Line Feeds are removed (but not all, to make readable a lot
  112.    of not-very-standard HTML Web pages)
  113.  - A rarely Guru bug with small files fixed.
  114.  - Last char of the text isn't deleted now.
  115.  
  116.  
  117. ToDo List:
  118.  
  119.  - Fix all the bugs that will be discovered by users *8)
  120.  - Display improved formated Lists.
  121.  - More CLI options and ToolTypes support.
  122.  - Option to convert bold and italic tags as ANSI.
  123.  - Option to convert HTML to RTF text
  124.    (useful for a future use in a word processor)
  125.  
  126.  
  127. 3. Bugs
  128. =======
  129.  
  130. There isnt anymore KNOWN bugs at the moment in all the Amigas tested but...
  131.  
  132. If you find any bug or problem, contact me at the previous address.Please,
  133. send me a detailed report of the problem and of your Amiga computer if
  134. possible; thanks.
  135.  
  136. If you found the problem with a particular file, send me too a copy of
  137. the file.
  138.  
  139. Don't forget to tell me the current version of my program you are using.
  140.  
  141.  
  142. 4. OriginalWare ?
  143. =================
  144.  
  145. This  utility  is OriginalWare.That means if you like this program you must
  146. buy  an  original Amiga program or game, or send the money to the author of
  147. any ShareWare program or game you are using often.
  148. (This includes me, $5 or $10 will be welcome *8)
  149.  
  150. There  are  lots  of  great Amiga software like `DiskMaster', `Remind',
  151. `MultiCX', `Spot', `ReqTools.library', `Deluxe Galaga', `APlayer' and a
  152. lot more that you won't never regret to spend your money.
  153.  
  154. If you do this you support the Amiga, and if you support AMIGA you support
  155. US.
  156.  
  157. Support software authors and you will get more and better software.
  158.  
  159.  
  160. This program could be included in any PD compilation at a symbolic price.
  161.  
  162. Aminet and Fred Fish collections are specifically allowed to include it.
  163.  
  164.  To Magazines :
  165. You can give away this utility on your coverdisk, but please send me a copy
  166. of the magazine.
  167.  
  168.  
  169. 5. Also available...
  170. ====================
  171.  
  172. Others quality Amiga PD products available from me :
  173.  
  174. Aminet recent uploads :
  175.  
  176. HTMLess.lha   v1.1   text/misc     10K v1.1. Converts HTML files in text files.
  177. DarkSound.lha v2.2   util/boot   53K Changes Workbench Sounds at each boot.
  178. MagiCA64.lha  v1.1   misc/emu     6K Converts A64/64 files to MagiC64 format.  
  179. Progress.lha  v1.0   demo/intro  73K In Progress/Darkness.1st at Euskal Party
  180. Vector13.lha  v1.3   dev/misc    15K Draw and edit 2D vectors for demos/games
  181. TheRace5.lha  v1.5   game/2play  59K Great 100m Running game, 0-4 players.
  182.  
  183. Available soon:
  184.  
  185. ELF.lha       v1.0   text/misc         Erase Line Feeds.Use for Word Procesors.
  186. FormaText.lha v1.0   text/misc         Format texts to your chosen columns size 
  187.  
  188. All them are 100% written in pure assembler for speed and are very system 
  189. friendly in all types of Amiga computers (or that is what I hope *8).
  190.  
  191.  
  192. 6. Thanks to:
  193. =============
  194.  
  195. Philippe Duchenne for reporting some errors and interesting ideas.
  196. Otto Von Ruggins for the first bug report.
  197. David Cassidy for don't forget me *8) .
  198.  
  199. Hipnooxis for ALL the help and show me to use and respect the Amiga O.S.
  200.  
  201. Knackosoft/TRSI for being my best `invisible' friend.
  202.  
  203. To all the Amiga developers for all the new, fun and useful stuff.
  204.  
  205. To all the Amiga users worldwide for their trust in the Amiga.
  206.  
  207. To Amiga Technologies for continue the development of the Amiga.
  208.  
  209. To the Amiga...
  210.  
  211.  
  212. 7. Credits
  213. ==========
  214.  
  215. All code © 1996 by Troglobyte/Darkness.
  216.  
  217. Send us money ($), JOB offers, BUGS, comments, improvements, ideas, advices,
  218. suggestions, mags, complains, and nice  PD  stuff  (like Demos, Games or
  219. Utilities).
  220.  
  221.             M. Martin Vivaldi
  222.              Av. America 60
  223.               Madrid 28028
  224.                  SPAIN
  225.  
  226. Or NetMail me at :
  227.  
  228.  Internet : bitabit@servicom.es
  229.  
  230.  FidoNet  : 2:341/28.55        Manuel Martin
  231.  
  232.  AmigaNet : 39:192/1.29        Manuel Martin
  233.  
  234.  
  235. Remember:
  236.  
  237. Only Amiga make it possible... Only Amiga make it fun.
  238.  
  239.  
  240.