home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / povdoc2.zip / Readme.doc < prev   
Text File  |  1997-11-05  |  4KB  |  74 lines
  1. =============CONTENTS======================
  2. 1) Why I did this
  3. 2) About this document
  4. 3) Check out the Hyper-Doc function!
  5. 4) Installing the file for optimum usage
  6. ===========================================
  7.  
  8. ********* Why I did this ******************
  9.  
  10. This document was converted from HTML to IPF for use with OS/2
  11. versions of POV-Ray, or windoze users who have the reader.
  12.  
  13. I did this for several reasons.
  14. 1) Browsers are just not as snappy I like.
  15. 2) I didn't like the 'too close to text' layout of the HTML docs.
  16. 3) I find text documents entirely to tedious to absorb.
  17. 4) IPF may have fallen behind HTML but it is still an excellent hypertext engine.
  18.  
  19. ********** About this document *************
  20.  
  21. This document was converted with two Rexx scripts.  One converts HTML to IPF and 
  22. the other creates the Hyper-Doc panels.  There was very little actual editing, 
  23. mainly just refining my scripts.  (over 700 lines combined)  The resulting IPF 
  24. tagged file is over 21,000 lines.
  25.  
  26. If you use the install script provided from the same directory as the file
  27. it will automatically launch the Hyper-Doc panel.  You can launch any panel this
  28. way, although you may need quotes around the panel name.
  29.  
  30. Developers can derive the res numbers from the section numbers and the HyperDoc
  31. panel tags can be revealed by pulling the four digit number from the file name
  32. after you double click on the notepad.
  33.  
  34. The document you see here is the official POV-Ray HTML docs in a brand new suit, 
  35. nothing more.  If you like them great, if not then please realize that I have 
  36. received nada, nothing, no deniro, zero, zippo, nuts, not one smacker, no money
  37. for this.  As such I do not intend to devote time to further enhancing this 
  38. document unless new docs arrive, in which case I'm way ahead of the game.  Should
  39. you be aware of a major document revision I would be happy to process it at my
  40. convenience.
  41.  
  42. Hey, have a great day.  Why not?  You're using OS/2.
  43.  
  44. Find my e-mail in Appendix E.
  45.  
  46. This software is free to use and falls under all POV-ray copyrights, restrictions
  47. etc...  For legal purposes this is the POV-ray documentation and may not be sold
  48. without appropriate permissions, theirs and mine.
  49.  
  50. ********* Check out the Hyper-Doc function! *****************
  51.  
  52. Using the install command file provided will place the Hyper-Doc panel on your 
  53. parameter line after the file name.  Try this out and see if it isn't a zippier,
  54. more connected way to use IPF.  I like to always have my directory structure at 
  55. hand when I study and I don't like to lose my place when I do lots of hyper-text 
  56. jumps.  Enter Hyper-Doc!  The most outstanding INF files I've ever seen were IBM's
  57. programming documentation, and the DR-REXX INF file.  I've taken the IBM style and 
  58. left the file essentially vanilla otherwise.  Use it either way.  I have a Rexx
  59. script that will convert IPF files to Hyper-Doc IPF and it adds very little overhead.
  60.  
  61. ********* Installing the file for optimum usage *************
  62.  
  63. Unzip the .INF and .CMD files to the directory of your choice and run install.cmd.
  64. This will give you the advantage of coming up to the Hyper-Doc windows.
  65. You may find these easier to navagate, however you can close them and use 
  66. the bland vanilla INF. 
  67.  
  68. If you decide you don't like the Hyper-Doc windows or would like to come up
  69. on a different panel simply change the parameters to reflect your choice.
  70. ie: remove 'Hyper-Doc' or replace it with another panel name.
  71. This is a little known feature of the Information Presentation Facility.
  72.  
  73. Enjoy
  74. Eric Laffoon