home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / webster / !Webster / Docs / bugs < prev    next >
Text File  |  1995-07-09  |  6KB  |  84 lines

  1. <HTML><HEAD><title>Webster's Bugs</title>
  2. </HEAD><BODY>
  3. <center>
  4. <A HREF="author.html"><IMG WIDTH=67 HEIGHT=39 ALT="Prev" SRC="ToPrev"></A> <a HREF="../!Help.html#index"><IMG WIDTH=67 HEIGHT=39 ALT="Index" SRC="ToIndex"></a> <a HREF="caches.html"><IMG WIDTH=67 HEIGHT=39 ALT="Next" SRC="ToNext"></a><BR>
  5. <h1>Webster's Bugs</h1>
  6. </center>
  7.  
  8. This text only applies to version <a href="Versions/011.html">0.11</a>.
  9.  
  10. <H2><a NAME="known">Known Bugs</a></H2>
  11. <ul>
  12. <LI>You can not follow link that are more than 220 characters long. They should be displayed correctly, but the full value of the link is not stored so you can not follow them. (This should be fixed in 0.11)
  13. <li>Changing modes reassigns the fonts, if necessary. However they will not be displayed correctly until the page is redisplayed. (i.e. reloaded or another page is displayed) Neither Will switching between Normal and MultiSync font definitions occur.
  14. <li>If Fetches are done using KA9Q, there is no way of telling KA9Q to abort a fetch. (This is a problem with KA9Q rather than Webster)
  15. <li>Decoding HTML is still rather slow on an A310. Although the compiled version is two or three time faster.
  16. <li>Formatting is not always correct
  17.   <ul>
  18.   <li>Single spaces may be added or ommitted, particularly just before or after a <a href="codes.html">tag</a>.
  19.   <LI>Lack of tables causes lots of problems. (I hope to fix this in 0.11).
  20.   </ul>
  21. <li>If the program crashes, Font handles are not closed and RISC OS may run out! 
  22. <em>Useful note</em> The leading numbers on the *FontList command are font handles, so you can close unused handles by calling '<code>SYS"Font_LoseFont",<var>handle</var></code>' from basic.
  23. <LI>The error <quote>Unrecoverable error in runtime system: free failed, (heap overwritten)</quote> sometimes occurs. This is from <a href="gif2spr.html">gif2spr</a> and is due to a corrupt GIF file which the supplied version of gif2spr can not cope with. (Neither will most other RISC OS GIF decoders!)
  24. <LI>The FTP fetcher does not work very well as TCPIP v2.04 does not always produce prompts when commands finish. (I am told this has been reported)
  25. <LI>The Default <quote>External Viewers</quote> will not work until it has created the necessary files. This should now be done automatically, but you may wish to change the default actions. See the <a href="extview.html">External Viewers</a> file for details.
  26. </ul>
  27.  
  28. <H2><a name="Reporting">Reporting Bugs</a></h2>
  29. Before you report something first make sure you are running the latest version of webster.
  30. The latest version can currently be found at <a href="ftp://ftp.demon.co.uk/pub/archimedes/developers/">ftp://ftp.demon.co.uk/pub/archimedes/developers/</a> as <quote>webster<var>???</var>.arc</quote>. Where <var>???</var> is the version number. (You may find Webster in other places but this is where I upload it to) You may also find a file called <quote>webster<var>???</var>fix.arc</quote>, this is a set of fixes for a particular version.
  31. <P>
  32. If you are using the latest version before reporting the problem as a bug there are some things you should try...
  33. <P>
  34. <ul>
  35. <LI>Reload the page. If this works there may be problems with the Fetcher or TCPIP that you are using.
  36. <LI>Make sure the error is from Webster. All Websters error boxes have Webster in the title. If an HTML page appears that contains an error code this will be from the remote HTTP server not Webster.
  37. <LI>Make sure TCPIP is not having problems (Search for error messages etc.). This is unlikely, but it could be having problems with your connection.
  38. <LI>Use the <quote>Task Window</quote> to ensure you have not run out of memory.
  39. </ul>
  40.  
  41. <h3><a name="stuck">When Webster gets stuck!</a></h3>
  42. <ol>
  43. <li>Try Holding down the <kbd>ALT</kbd> key. In most cases this should get Webster to unwind all the loops and stop drawing the page.
  44. <LI>If this works do the <a href="#UnReproducable">UnReproducable or Intermitant</a> action below, then..
  45. <LI>Try reproducing the problem by reloading the page.
  46. </ol>
  47.  
  48. <h3>For Reproducable problems</h3>
  49. <ol>
  50. <LI><a name="debug">Turn Debuging</a> on by changing the line in the <a href="../Messages">Messages file</a> that says <quote>DEBUG:0</quote> to say <quote>DEBUG:2</quote>
  51. <LI>Re-run Webster and reload the page.
  52. <LI>Look at the Source file and work out where the decoding goes wrong. (I you can that is!) extract this piece and see if it fails on its own. You may need to extract right from the beginning, in which case the problem is not where you first though it was!
  53. <LI>Mail me the information stated <a href="#whattomail">below</a>.
  54. </ol>
  55.  
  56. <h3>For <a name="UnReproducable">UnReproducable</a> or Intermitant problems</h3>
  57.  <h4>If Webster is still running</h4>
  58.  <OL>
  59.  <LI>If Webster appears 'stuck' try the action <a href="#stuck">above</a>
  60.  <li>Hold the <kbd>Shift</kbd> key down and click with Adjust on Websters iconbar icon.
  61.  <LI>Mail me the result and the information stated <a href="#whattomail">below</a>.
  62.  </ol>
  63.  
  64.  <h4>If Webster is not running.</h4>
  65.  <ol>
  66.  <LI>Note down anything on screen and anything else you can think of!
  67.  <LI>If this kind of thing happens a lot, try running with Debuging turned on (See <a href="#debug">Above</a>) Unfortunately this is slower and will corrupt the top few lines of the screen.
  68.  <LI>Mail me the result and the information stated <a href="#whattomail">below</a>.
  69.  </ol>
  70.  
  71. <h3><a name="whattomail">What to mail in bug reports</a></h3>
  72. Mail <a href="mailto:ajp@wg.icl.co.uk#Webster 0.10 Bug">me</a> the following as plain text.
  73. <ul>
  74. <li>The last 20 lines from the trace file (Or the result of one of the actions above).
  75. <LI>If no images are involved, the section of the source where the failure occurs. (or all of it if you can't work out where that is)
  76. <LI>The URL of the page that fails. (Vital if the page needs images)
  77. <LI>A description of what the failure look like. (Error messages, description of whats wrong with the format etc.)
  78. <LI>The internal error code produced (If any)
  79. </ul>
  80.  
  81. Please send bug reports to the <a HREF="author.html">Author</a>, or fix the problem and just send the fix <img align=middle src="smiley">.
  82. <hr><address><a href="author.html>Andrew Pullan</a>, 11th June 1995</address>
  83. </BODY></HTML>
  84.