home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / infhtm9b.zip / inf-html.INF (.txt) < prev    next >
OS/2 Help File  |  1995-05-28  |  124KB  |  819 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Overview ΓòÉΓòÉΓòÉ
  3.  
  4.  This section takes a fairly simplistic look at the Inf-HTML package. 
  5.  
  6.  
  7. ΓòÉΓòÉΓòÉ 1.1. General info and Pretty Pictures! ΓòÉΓòÉΓòÉ
  8.  
  9. Inf-HTML is a package of programs written by Peter Childs (that's me) to allow 
  10. people to place the information contained within Os/2 Inf/Hlp files on the WWW 
  11. (World Wide Web). 
  12.  
  13. Inf-HTML is still in testing. It has been around for awhile but the INF file 
  14. format can get confusing and is not documented. 
  15.  
  16. If you find something that is broken (that shouldn't be) drop me a line with 
  17. lots of details.  Preferably enough info to be able to reproduce the fault. 
  18.  
  19.                                 Pretty Picture's!
  20.  
  21. NOTE. All these pictures where taken from buildlevel 0001 and as such the 
  22. "look" of Inf-HTML may be different from these pictures. 
  23.  
  24. Below is a standard Table of Contents from a Os/2 INF file displayed with 
  25. WebExplorer (small font).  In this case the INF file is the Object REXX 
  26. reference and I am running the Os/2 build of Inf-HTML with os2httpd. 
  27.  
  28. Although I use "buttons" which are graphical I have optimised these so they are 
  29. transparent, and 16 colour.  This cuts down the bandwidth required. Below are 
  30. the sizes (in bytes! not kilo-bytes) of the GIF's. 
  31.  
  32.  218  about.gif
  33.  290  ftp.gif
  34.  276  idx.gif
  35.  510  inf-html.gif
  36.  185  next.gif
  37.  179  previous.gif
  38.  237  srch.gif
  39.  181  to.gif
  40.  224  toc.gif
  41.  
  42. Below is an article from a UserGroup publication being displayed with 
  43. WebExplorer.  It shows that graphics support is possible but currently is a 
  44. real hastle and a lot of work. 
  45.  
  46. Below is an article from the Os/2 Command Reference.  While I don't advocate 
  47. putting Os/2 manuals online (due to copyright restrictions) I have this example 
  48. here to show that Inf-HTML can handle line-diagrams with mapping of 
  49. IBM-ExtASCII to ISO-Latin and plain punctuation. 
  50.  
  51. Just to prove it isn't a fluke and works with browsers other than WebExplorer, 
  52. here is NetScape for Windows 1.1N (16-bit) running under Win-Os/2 looking at 
  53. the same document above. 
  54.  
  55. That's it for the pictures! 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 1.2. What is it exactly? ΓòÉΓòÉΓòÉ
  59.  
  60. The Inf-HTML "package" consists of three executables and assorted support 
  61. files. 
  62.  
  63.      INF-HTML executable 
  64.  
  65.            is a executable that is called by a WWW server (such as NCSA's 
  66.            httpd) with parameters containing information about an Os/2 Inf or 
  67.            Hlp file.  It then returns the requested information in HTML format. 
  68.            This allows direct access to the info in Os/2 Inf/Hlp files in a "on 
  69.            request" conversion method. 
  70.  
  71.      INF-FILE executable 
  72.  
  73.            is new to the Inf-HTML package (from version 0.7 onward) and uses 
  74.            the same "engine" code to basically convert a Os/2 Inf or Hlp file 
  75.            to a set of Html files.  These files can then be used independently 
  76.            of any executables etc. (and therefore platform independent) 
  77.            This executable can be used with Rony Flatscher's ih2rex package to 
  78.            turn a whole INF file, or portion, into a single HTML file suitable 
  79.            for printing etc. 
  80.  
  81.      DEBG executable 
  82.  
  83.            was developed primarily by me as an extension to the INF-HTML 
  84.            executable to allow the display of large amounts of internal info. 
  85.            This is to help "see" where any problems occur.  If you are 
  86.            interested in the file format of Inf or Hlp files, or want to know 
  87.            more how Inf-HTML works, try it out. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 1.3. Where do I get it, and for what platforms? ΓòÉΓòÉΓòÉ
  91.  
  92. Try 
  93.  ╨╛ http://www.apanix.apana.org.au/~pjchilds ╨┐ 
  94. for the latest info on availbility of Inf-HTML etc. 
  95.  
  96. Currently there are builds done on Os/2 with GCC's EMX 0.9a rev34, a build on 
  97. Linux (1.2.8) with GCC, and a build on SunOS with GCC.  I have also had a 
  98. successful build on a IBM RS/6000. 
  99.  
  100. The Os/2 executables and support files should be on hobbes... for the other 
  101. stuff try the above website.  If you want it for a platform not listed about 
  102. then mail me and we'll talk ;-) 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ 1.4. Copyright etc.. ΓòÉΓòÉΓòÉ
  106.  
  107. I wrote it and it's mine (naaaa..) but anyone can use it if they want. If it 
  108. breaks you own both bits.  If it breaks your computer you still own all the 
  109. bits and its not my fault.  Don't use it on a mission critical system 'cause I 
  110. don't want some hospital computer dying (and patients etc) due to my program. 
  111.  
  112. You can't sell this program, or charge for its use.  If someone is charging you 
  113. for access to information provided by this program (ie on a cost per page) then 
  114. email me and well fix them ;-) 
  115.  
  116. These programs are email-ware, which means if you use it then send me some 
  117. email on what for... If you maintain some Web pages using it then I'd really 
  118. like a URL.  Developing and maintaining code is a big headache at times so some 
  119. mail that others are finding it useful is a great incentive to keep working on 
  120. it.  If you have lots of money to spare, or are a company and want to feel good 
  121. about support software development, I will take any cash or cheques ;-)  You 
  122. can mail these (or a postcard) to 
  123.  
  124.  Peter Childs
  125.  30 Renfrew Drive
  126.  Hawthorndene
  127.  5051 SA
  128.  
  129. Use and enjoy!  If you want something fixed drop me a line and let me know. 
  130. I'll make any easy changes if I think they are good...  Version 0.8b was 
  131. basically a response to mail about display problems.  0.9alpha+ is in response 
  132. to requests for ISO-Latin support, and bugs reported by users. If you know a 
  133. better way to do something that I've hacked then tell me and I'll steal your 
  134. idea (thanks!). 
  135.  
  136.  
  137. ΓòÉΓòÉΓòÉ 2. Usage ΓòÉΓòÉΓòÉ
  138.  
  139.  Inf-HTML can be thought of as a package executable and support files.  This is 
  140. a bit of a problem when I talk about Inf-HTML (as a package) and the Inf-HTML 
  141. executable.  If you have difficulty in working out which one I am talking about 
  142. then I quote from someones sig... 
  143.  
  144. It was hard to write, it should be hard to use!
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 2.1. Inf-HTML ΓòÉΓòÉΓòÉ
  148.  
  149. *REMEMBER* Inf-HTML is for making INF files accessable via the WWW and runs 
  150. interactively via a WebServer (such as NCSA's httpd).  You need to have access 
  151. to the /cgi-bin or /bin directory for you WebServer! 
  152.  
  153. Setting up a WebServer and other basic file management issues are beyond the 
  154. scope of this document. 
  155.  
  156.  
  157.                                    Os2 Systems
  158.  
  159. OK.  Put the INF-HTML.EXE file in some directory that you want to put it in. 
  160. Then put the READINF.CMD file in your /os2httpd/cgi-bin directory (assuming 
  161. your running os2httpd).  Edit READINF.CMD to reference the INF-HTML.EXE file. 
  162.  
  163. Next!  Create a directory in your /os2httpd/doc directory (or your document 
  164. root directory) called inf-html.  Copy all the files from the Support directory 
  165. into this directory...  This should be several GIF files, and a few HTML 
  166. files... 
  167.  
  168. Finished.  To test it out (assuming that your WebServer is running) try a 
  169.  
  170.     http://your.webserver.name/cgi-bin/readinf.cmd?build
  171.  
  172. If it doesn't work think why!  What error's are you getting back... is it 
  173. accessable, are your paths set right... 
  174.  
  175. If you are using GoServe rather than Os2httpd I don't know if the above will 
  176. work but I guess you can figure it out ;-) 
  177.  
  178.  
  179.                                   Other Systems
  180.  
  181. OK.  Make sure you have the right build for your system... try executing 
  182. inf-html build and see if it works and gives you some info. 
  183.  
  184. Place this executable file (ie inf-html) in your WebServers /bin or /cgi-bin 
  185. directory... if you need to chmod it make sure you do! 
  186.  
  187. Create a directory in the document root called inf-html and put all the files 
  188. from the Support directory in there.  Make sure to chmod the directory and 
  189. files if need be! 
  190.  
  191. If you don't like your support directory in that location mail be and I will 
  192. build you an executable with the path in the right place... sorry for not 
  193. releasing source yet but it needs more work ;-) 
  194.  
  195. Finished.  To test it out (assuming that your WebServer is running) try a 
  196.  
  197.      http://your.webserver.name/cgi-bin/readinf.cmd?build
  198.  
  199. If it doesn't work think why!  What error's are you getting back... is it 
  200. accessable, are your paths set right... 
  201.  
  202.  
  203.                         It's installed, how do I use it?
  204.  
  205. To put a INF file online just include the correct reference in any HTML 
  206. document. 
  207.  
  208. For Os/2 systems use 
  209.  
  210.   http://webserver/cgi-bin/readinf.cmd?x:^path^name^filename.inf+toc
  211.  
  212. where x is the drive and the path is seperated by ^'s rather than \'s. 
  213.  
  214. For Other systems use 
  215.  
  216.   http://webserver/cgi-bin/inf-html?/path/and/filename.inf+toc
  217.  
  218. and make sure the file is world-readable (and the directories it's in etc..) 
  219.  
  220.  
  221.                           Other things I want to know.
  222.  
  223. Making files FTP'able. 
  224.  
  225. If you put a file in the same location as the INF file you are accessing, with 
  226. the same name but .ftp appended(and world readable), the contents of this file 
  227. will be treated as a URL for that files location. 
  228.  
  229. For example if you had a file called fred.inf that was in some directory and 
  230. you created another file in that directory called fred.inf.ftp with the text 
  231.  
  232.   ftp://some.site/morestuff/fred.zip
  233.  
  234.  in it then when accessing that file through Inf-HTML a FTP icon will appear 
  235. with the above URL. 
  236.  
  237. Adding stuff at the bottom. 
  238.  
  239. If you put a file in the same location as the INF file you are accessing, with 
  240. the same name but .html appended(and world readable), the contents of this file 
  241. will be inserted after at the bottom of every INF-HTML access of that document. 
  242.  
  243. For example if you had a file called fred.inf that was in some directory and 
  244. you created another file in that directory called fred.inf.html with the text 
  245.  
  246.   <p>Back to <a href="~fred/Welcome.html">My Page</a></p>
  247.  
  248.  in it then when accessing that file through Inf-HTML that text will appear 
  249. with at the bottom of each access. 
  250.  
  251.  
  252.                                  Search engine?
  253.  
  254. The search engine partially works in the current build.  The Table of Contents 
  255. and Index search are enabled and work fine, but the Article text one isn't 
  256. enabled and doesn't work.  It should be fixed and running soon. 
  257.  
  258.  
  259.                                  Bitmap Support?
  260.  
  261. No!  I haven't been able to get IBM to tell me about the compression scheme 
  262. they use on the files (and it ain't RLE!).  I have the bitmap headers, the 
  263. colour tables, and the compressed data - but I can't uncompress it!  If you 
  264. want to have a go mail me and I'll tell you more specifics. 
  265.  
  266.  
  267.                                    More depth?
  268.  
  269. Just to pad out the understanding there are five commands inf-html understands 
  270. generally in the format 
  271.  inf-html <filename.inf> <command> <arguements> 
  272.  
  273.      command = toc 
  274.  
  275.            Display the Table of Contents for <filename.inf>.  Arguements are 
  276.            added to allow expansion of Headings with sub-headings.  Don't worry 
  277.            about those arguements, you shouldn't need to add any - they just 
  278.            refer a to heading's numbers. 
  279.  
  280.      command = tocopen 
  281.  
  282.            Display the fully expanded Table of Contents for <filename.inf>. No 
  283.            arguements taken. 
  284.  
  285.      command = idx 
  286.  
  287.            Display the Index for <filename.inf>.  No arguements are taken. 
  288.  
  289.      command = text 
  290.  
  291.            Display the article corresponding to <arguement>.  No other 
  292.            arguements are taken. 
  293.  
  294.      command = build 
  295.  
  296.            No filename or arguements allowed. Displays build level information 
  297.            on the executable. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 2.2. Inf-FILE ΓòÉΓòÉΓòÉ
  301.  
  302. The Inf-FILE executable is part of the Inf-HTML package and allows batch 
  303. conversion of an INF file to a series of HTML files.  You MUST have HPFS to use 
  304. this program on Os/2. 
  305.  
  306. Put the inf-file.exe somewhere in your path to be able to use it. 
  307.  
  308.  
  309.                                    Converting
  310.  
  311. Create a clean directory and copy into it the INF file you wish to convert. 
  312.  
  313. Change into this directory and execute the following commands. 
  314.  
  315.  inf-file <filename.inf> toc <path to support files>
  316.  inf-file <filename.inf> idx <path to support files>
  317.  inf-file <filename.inf> text <path to support files>
  318.  
  319. where <filename.inf> is the file you are interested in converting and <path to 
  320. support files> is a location on the web server of the file in the Support 
  321. directory (ie. gifs and html files). 
  322.  
  323. an example of <path to support files> would be say 
  324.  
  325.       /~fred/inf-html/
  326.  
  327. (note the trailing slash) or 
  328.  
  329.       /somedir/anotherdir/
  330.  
  331. The file is now converted into a series of HTML files.  You can place these 
  332. html files (together) in the location you wish.  Don't forget to place the 
  333. support files in the spot you nominated too!  When you are finished check that 
  334. you have chmod'd any files/directories that you should have. 
  335.  
  336. The you should add a link in to the Table of Contents file which should be 
  337. named something like 
  338.  
  339.    myinffile.1.toc.html
  340.  
  341.  
  342.                                The ih2rex package
  343.  
  344. This great little set of REXX programs will let you combine the sets of HTML 
  345. files produced above into a single HTML file (you could use this to print INF 
  346. files...) 
  347.  
  348. Rony Flatscher wrote these REXX programs and you should find enough 
  349. documentation within the ih2rex.zip file to use it.  If you can't get it to 
  350. work you could try emailing Rony or me but you have better tried hard ;-) 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 2.3. Debg ΓòÉΓòÉΓòÉ
  354.  
  355. Debg is a build of the inf-html executable with *lots* of extra output for 
  356. debugging purposes... I have included it for the overly keen (or silly). 
  357.  
  358. Basically it outputs good stuff like command-line parameters, info about the 
  359. internal structure (number of words in the dictionary, number of table of 
  360. contents entries, number of index entries, number of slots, etc...) 
  361.  
  362. It then gives a basic ASCII-Art view of the file structure layout.... like 
  363.  
  364. +---------------         0
  365. | Header
  366. +---------------         155
  367.  
  368. +---------------         0      (Size - 155)
  369. | Images
  370. |
  371.  
  372. +---------------         155
  373. | TOC Strings
  374. +---------------         1470
  375.  
  376. +---------------         0
  377. | Index
  378. +---------------         0
  379.  
  380. +---------------         1630
  381. | NLS Table
  382. +---------------         1712
  383.  
  384. +---------------         1954
  385. | Dictionary
  386. +---------------         13470
  387.  
  388. +---------------         42786
  389. | Search Table
  390. +---------------         50286
  391.  
  392. +---------------         50286
  393. | Ext Data Block
  394. +---------------         50350
  395.  
  396. After that all bets are off ;-)  If you specified the toc action it will go 
  397. through all the debug info for all the table of contents entries.  If you 
  398. specified the text action it will load the whole dictionary (yuck) and then 
  399. output heaps of info on the article. 
  400.  
  401.  
  402.                               How would this help?
  403.  
  404. I don't know about helping you but it sure helps me!  If you couldn't get 
  405. inf-html to work (ie error messages from inf-html) you could place debg.exe 
  406. where inf-html was (ie replace the reference or copy debg over inf-html) and 
  407. check what was going on. 
  408.  
  409.  
  410. ΓòÉΓòÉΓòÉ 2.4. Inf-TeX ΓòÉΓòÉΓòÉ
  411.  
  412. Just because it never got released that's no reason to doubt that this mystical 
  413. program ever existed... in fact here is a really small, unreadable 
  414. (unrecognizable?) bitmap of a page proceed by Inf-TeX! 
  415.  
  416. Unfortunately Inf-TeX has been shelved unless I get some signs of interest.  It 
  417. wasn't in a usable state (not what I would call usable!) as it had a bad bug in 
  418. margin support that caused lists to cascade... I guess I could fix this but I 
  419. can't do everything! Inf-TeX was pushed to one side.  If I get enough interest 
  420. I will do some more work on this... 
  421.  
  422.  
  423. ΓòÉΓòÉΓòÉ 3. Bugs... ΓòÉΓòÉΓòÉ
  424.  
  425.  BUGS 
  426.  
  427.  
  428. Number, Status  Date, Source, Description / Action pending
  429. ==============  ===========================================
  430. 1    Open   27-05-95
  431.         Display of certain articles does not do "automatic"
  432.         links - example is belowzro.inf.  Article #11 contains
  433.         a non-visible link to article ???.
  434.  
  435.         Run debg, identify/isolate/fix.
  436.  
  437. 2    Open   27-05-95
  438.         Correlation between "set left margin to current" and
  439.         "set left margin to *N* + indent" is not the same,
  440.  
  441.         Locate example, check spaces indented, leftm set to ?,
  442.         degb if ness, fix.
  443.  
  444. 3    Open   Underlining does will run around indents.  Also spaces??
  445.  
  446. 4    Closed  Support for :lines., :elines. needed right-margin
  447.         checking removed as it was causing extra CR's.
  448.  
  449. 5    Closed  Port for SUN doesn't work... defined extra routines to
  450.         read in words, doubles, and shuffle bytes.
  451.  
  452. 6    Closed  Port for SUN dies on certain files... trace error to
  453.         malloc() not calling brk() for stack expansion...
  454.         error traced to corrupted stack due to static allocation of
  455.         tocentry struct size.  Fixed 25-5-95.
  456.  
  457. 7    Open   25-5-95
  458.         Support for color, and fonts not implemented well.
  459.  
  460.         Study smallinf.c from hobbes, identify and get font
  461.         table - monospaced fonts??  Check HTML specs for possible
  462.         future support for color/fonts.
  463.  
  464. 8    Open   25-5-95
  465.         URL's not auto-identified.
  466.  
  467. 999   Closed  00-00-00 END OF FILE
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ 4. History ΓòÉΓòÉΓòÉ
  471.  
  472.  Below is a roughly list of this programs progress, changes, etc.  Official 
  473. build levels and documentation of each change did not occur until v0.9b. 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ 4.1. 0.1a ΓòÉΓòÉΓòÉ
  477.  
  478. First closed alpha 
  479.  
  480.      Support for Table of Contents display 
  481.  
  482.      Support for basic displaying of articles with no support for styles, 
  483.       links, margins, etc.  Pretty shocking. 
  484.  
  485.      Real rough coding 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 4.2. 0.2a ΓòÉΓòÉΓòÉ
  489.  
  490. Decision was made for a rewrite to be done. 
  491.  
  492.      Much better error control and reporting.  Structured in such a was that 
  493.       any errors will display a message, free all allocated memory, and exit. 
  494.  
  495.      More modularisation of code.  Full commenting.  Better structure. 
  496.  
  497.      More comprehensive support for control codes.  Styles implemented - bold, 
  498.       underlined, italic, and monospaced examples. 
  499.  
  500.      Kludging introduced for left margin. 
  501.  
  502.      Graphic buttons introduced. 
  503.  
  504.      All support files now must be located in the /inf-html/ directory. 
  505.  
  506.      Debug mode seperated from main code.  Cleaned up and improved. 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 4.3. 0.5b 10-12-94 ΓòÉΓòÉΓòÉ
  510.  
  511. Well I thought... if MicroSoft can skip 4 major revision numbers and then 
  512. release a worse product than before why can't I ;-) 
  513.  
  514. First public release... in initial beta testing 
  515.  
  516.      Name change from html-inf to inf-html. 
  517.  
  518.      Kludged support for inline graphics inclusion. 
  519.  
  520.      Look ahead on word wrap to prevent large entries sticking out and looking 
  521.       bad. 
  522.  
  523.      Improved layout control to stop line breaks occuring when they shouldn't 
  524.       have and to be there when they should. 
  525.  
  526.      Support for really large articles that are larger that one slot.  This 
  527.       has not been extensively tested...  I added 3 lines of code to do this 
  528.       and it works fine on the 2 articles I tested it on. 
  529.  
  530.      Major bug fix - incorrect titles on articles and links failing. 
  531.  
  532.            This has improved inf-html to the stage where I am prepared to 
  533.            release it for public beta. 
  534.  
  535.      Basic documentation included/being written (grin). 
  536.  
  537.      Support for another type of in-line linking added. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 4.4. 0.6b 16-12-94 ΓòÉΓòÉΓòÉ
  541.  
  542. Second public release... beta testing continues.. 
  543.  
  544.      Changed the way Table of Contents displays. (all in plain text rather 
  545.       than using heading levels which looked un-nice with WE 0.92mt onward) 
  546.  
  547.      Included graphics are now transparent - including Inf-HTML, Team Os/2, 
  548.       and Dos inline graphics. 
  549.  
  550.      Document title changed to reflect content instead of always 
  551.         file - x:/.../myfile..inf 
  552.       If displaying a Table of contents heading is 
  553.         Inf-HTML: (doc title) 
  554.       If displaying an article heading is 
  555.          Inf-HTML: (article heading) 
  556.       This produces much better WebMaps. 
  557.  
  558.      Changed some (hopefully all) references to inline images to include 
  559.       alternate text for text-mode WWW browsers. 
  560.  
  561.      A change from WE 0.9 to WE 0.93 meant that IBM Extended ASCII characters 
  562.       used in line-diagrams (for example the Os/2 CmdRef.inf) would no longer 
  563.       display properly.  Changes to code mean that (hopefully) &, <, and > 
  564.       symbols should display. IBM Ext ASCII (from 169 to 218) has been remapped 
  565.       to +, -, or |. 
  566.  
  567.      Dictionary debugging added to articles using 
  568.         readinf.cmd?<filename>+text+<article#>+2 
  569.       This will show when character remapping has occured (from what to what). 
  570.  
  571.      Index's supported if in the file.  This hasn't been extensivly tested but 
  572.       it looks like it works. 
  573.  
  574.  
  575. ΓòÉΓòÉΓòÉ 4.5. 0.7 Not Publicly Released ΓòÉΓòÉΓòÉ
  576.  
  577.      BUGFIX... due to my pathetically shallow knowledge of batch programming I 
  578.       had the file readinf.cmd (when I bothered to include it!) containing a 
  579.       line as such... 
  580.         x:/path/inf-html.exe %1 %2 %3 %4 %5 %6 %7 %8 %9 %10 %11 
  581.       for which arguments 10 and 11 are interpreted as 1 with a 0 after it... 
  582.       I searched the code, using a debugger, for hours to figure out why some 
  583.       TOC's were not being displayed properly... arrr... 
  584.  
  585.      Code rehaul / cleanup to try and move from Borland C to ANSI C for 
  586.       portability reasons. 
  587.  
  588.      A "Conversion" executable was developed using precompiler instructions. 
  589.       This changed a Inf/Hlp file into a series of Html files. 
  590.  
  591.      Table of Contents display with unordered lists. 
  592.  
  593.      Due to ongoing problems with the way lynx interperets <pre> (ie. adds a 
  594.       carriage return) a decision was made to rewrite the article display code 
  595.       to be fully monospaced. 
  596.  
  597.  
  598. ΓòÉΓòÉΓòÉ 4.6. 0.8b 26-12-94 ΓòÉΓòÉΓòÉ
  599.  
  600. Third public beta release.... onward, upward, forward! 
  601.  
  602.      A complete re-write and overhaul from the ground up.  Expect some new 
  603.       bugs due to this. 
  604.  
  605.      Now makes extensive use of pre-compiler statements to support the 
  606.       generation of INF-FILE, and DEBUG, from the same engine.  Seperated into 
  607.       multiple source files for better management. 
  608.  
  609.      A semi-proper command line parser was added to stop really dumb things 
  610.       causing SYS Errors. 
  611.  
  612.      Displays all articles with mono-spaced.  A much better (although more 
  613.       complex, probably slower, and maybe bug filled) word wrap engine 
  614.       developed (on Christmas Eve) which was a BIG code headache! 
  615.  
  616.      Centered graphics are displayed with <center> that is supported by 
  617.       WebExplorer and NetScape. 
  618.  
  619.      No more little arrow graphics, or [to]. 
  620.  
  621.      Tested for display with IBM WebExplorer v0.95, NetScape v1.0 for Windows, 
  622.       and Lynx. 
  623.  
  624.      BUGFIX - Multi-TOC articles did not reset "space=true" which caused some 
  625.       interesting results.  This should not be reset if in the middle of a 
  626.       preformatted example. 
  627.  
  628.      BUGFIX (hopefully) - If two spaces occured after a fullstop at the end of 
  629.       a line the next line was indented a space. 
  630.  
  631.  
  632. ΓòÉΓòÉΓòÉ 4.7. 0.9alpha 12-94 to 05-95 ΓòÉΓòÉΓòÉ
  633.  
  634. Internal (limited release) .... onward, upward, downward, back to alpha... 
  635.  
  636.      Code included so IBM-Extended ASCII is converted to ISO-Latin HTML. This 
  637.       could cause things to be slower with inf-html, but inf-file shouldn't be 
  638.       noticably slower. 
  639.  
  640.      Rough support included for :lines., :elines. This BUG was causing some 
  641.       strange wrap arounds. 
  642.  
  643.      BUG FIX - support for :lines., :elines. had not been added to some of the 
  644.       code that checks right margin width - resulting in extra <CR>'s. 
  645.  
  646.      A BUG with a code translated.  New paragraphs should reset "space=true" 
  647.       except when in monospaced examples. 
  648.  
  649.      Another BUG - monospaced is not a style (like bold) and hence 
  650.       monospaced+bold can exist.  Previous release had changes in style killing 
  651.       the monospaced behaviour and causing formatting problems. 
  652.  
  653.      BUG FIX - If a space forced and "space=true" another was not added. 
  654.       Caused alignment problems in objrexx.inf 
  655.  
  656.      BUG FIX - Removed old hack code relating to before I knew about the item 
  657.       above as it was killing spaces and causing output problems. 
  658.  
  659.      I am not happy with this release, hence the alpha, as I need to go back 
  660.       and do a rewrite with what I now know ;-) 
  661.  
  662.      FIX?? - HTML is "supposed" to be independent of viewers but I have 
  663.       changed a few things to make some viewers work better (and probably stuff 
  664.       others up! 
  665.  
  666.         -  I have removed mapping of ":" to "&colon;" as Lynx and NetScape 
  667.            0.9 didn't like it. 
  668.  
  669.         -  To get proper spacing with end-of-paragraph codes I have used 
  670.            "\n<pre>\n<pre>"  This works with WebExplorer 1.01 and NetScape 0.9 
  671.            but I know that it will cause lots of excess space in Lynx! 
  672.  
  673.      Inclusion of the great REXX utilities by Rony Flatscher - ih2rex.zip. 
  674.       Rony helped a lot with bug reports (most of the above) which we worked 
  675.       through. 
  676.  
  677.      Since I am planning to do a *much* better rewrite I am waiting for HTML+ 
  678.       to come out as a RFC and some acceptance before I start work.  This work 
  679.       is just to patch up some serious bugs. 
  680.  
  681.      Work on Portability.  Rewrite of code that reads in structure due to word 
  682.       alignment in GCC for Os/2 and GCC on Suns.  Rewrite of code that does 
  683.       fread's so if words or doubles are read on Suns then bytes are shuffled. 
  684.  
  685.      Code more platform independent.  Removed last hard coded structure sizes 
  686.       that was causing stack corruption on Suns. 
  687.  
  688.      Compiler shift to GCC for Os/2.  Builds successful with GCC on a Sun, GCC 
  689.       on Linux (1.2.8), GCC on Os/2 (EMX's 0.9 rev34). and GCC on a RS/6000. 
  690.  
  691.      New icons.  Added stub for search engine (not finished).  Added support 
  692.       for FTP'able files (see docs). 
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ 4.8. 0.9b (from 26-5-95) ΓòÉΓòÉΓòÉ
  696.  
  697. Build 0001 26-5-95 not-released, used on apanix.apana.org.au. 
  698.  
  699.      Version numbers changed. Support for build information which can be 
  700.       queried like follows, and returns information about the build level and 
  701.       platform. 
  702.  
  703.             >inf-html build
  704.             Content-type: text/plain
  705.  
  706.  
  707.             Inf-HTML build information
  708.             Release 0.9b
  709.             Build Level 0003
  710.             Os/2 build
  711.                     EMX ver - 0.9a
  712.                     Rev - 34
  713.                     OsVer 20.30
  714.             Author contact: pjchilds@apanix.apana.org.au
  715.  
  716.  Build 0002 26-5-95 not-released, used on apanix.apana.org.au. 
  717.  
  718.      Added two new icon functions - AllTocOpen, and close.  New gif's open.gif 
  719.       and close.gif.  Function initiated with a call to 
  720.  
  721.                 .inf-html <file> tocopen
  722.  
  723.  Build 0003 27-5-95 not-released, local build, apanix build, mailed to Rony for 
  724.  testing with ih2rex package. 
  725.  
  726.      Added changes for bug found in display of CATSMEOW.INF - right margin 
  727.       support not implemented properly. 
  728.  
  729.      Added feature - if a file called <filename>.html is found (ie 
  730.       warpfaq3.inf.html) it will be inserted at the bottom of each document. 
  731.  
  732.      All the help files rewritten.  INF file for Usage etc, and three smallish 
  733.       HTML files in the support directory that are for support (ie User Info). 
  734.  
  735.  Build 0004 28-5-95 released - put on hobbes as infhtm9b.zip 
  736.  
  737.      Change made to stop terminal error during byteskipping with Mellisa Woo's 
  738.       Stupid Tricks.  Byteskiping can have a 0 byte's to skip. 
  739.  
  740.      Search engine not called properly from within text, index articles. Fixed 
  741.  
  742.      Added search engine for Table of Contents entries. 
  743.  
  744.      Added search engine for Index entries. 
  745.  
  746.      NOTE - still no article search support. 
  747.  
  748.  Build ?? 
  749.  
  750.      changes... 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 5. Credits ΓòÉΓòÉΓòÉ
  754.  
  755. Well I suppose I better thank people here... 
  756.  
  757. Sim for support and encouragement ;-) 
  758.  
  759. Miff for being a Silicon Grease Monkey. 
  760.  
  761. Adrian for his constant great work with apanix. 
  762.  
  763. Rony for lots of bug reports and his killer ih2rex package. 
  764.  
  765. Carl Hauser and Marcus Groeber for their work with the INF file format! Without 
  766. the info2a document from hobbes I would have never got started. 
  767.  
  768. Jon for the WarpPharmacy... 500+ hits a day helps beta test ;-) 
  769.  
  770. Andy for a quick reply on a bitmap format question. 
  771.  
  772. The IBM'ers that have tried to help out! 
  773.  
  774. Anyone else I have forgotten that deserves some thanks.... 
  775.  
  776.  Thanks! 
  777.  
  778.  
  779. ΓòÉΓòÉΓòÉ 5.1. About the Author ΓòÉΓòÉΓòÉ
  780.  
  781. About Me 
  782.  
  783. Hi, I'm nearly 20 and are currently studing Computer Science at Flinders 
  784. University in South Australia.  Last year I studied Mechnical Engineering at 
  785. Adelaide University, and the year before I was serving full time in the 
  786. Australian Army under the Ready Reserve Scheme with 111 AD Bty (Lt). 
  787.  
  788. My interests are my girlfriend, Os/2, good books, image compression scheme's 
  789. used in INF files (grin), the outdoors, and sleep (of which I don't seem to get 
  790. enough). 
  791.  
  792. I would like to eventually get a job in a IT area, support, programming, 
  793. networking, etc....  So if you have a job going I'll take it ;-) 
  794.  
  795.  I am also a member of the Developer's Assistance Program... although it hasn't 
  796. provided much assistance ;-)  It does, however, provide me with access the the 
  797. Developer's Connection CD's which are just full of stuff of interest... and the 
  798. great Developer's Connection News! 
  799.  
  800. The Inf-HTML package was developed on several platforms using lots of different 
  801. tools including... 
  802.  
  803.      EPM v6.02 
  804.  
  805.      Emacs for Os/2 
  806.  
  807.      EMX's GCC 0.9 rev 34 and Borland's C++ for Os/2 1, 1.01, and 1.5 
  808.  
  809.      The IPFC compiler... 
  810.  
  811.      Frankie Fan's Os2Httpd v1.04 port 
  812.  
  813.      Os/2 2.1, 2.11 + fixes... 
  814.  
  815.      Warp Red Gamma, Warp Blue Gamma (wasn't that full of holes!) 
  816.  
  817.      Warp v3 without Windows + fixpatch 5 and 7 
  818.  
  819.  Peter Childs (pjchilds@apanix.apana.org.au)