The Jargon File
Problems with the Web version
Known Bugs
I have encountered the following problems during the test of these pages.
As far as I know, these problems are not caused by these pages themselves,
but are bugs in the browsers (like Mosaic or MacWeb). I can do nothing to solve them - sorry.
- In
<PRE>formatted section, some browsers do not
handle escaped characters (they show & for the escaped ampersand
"&").
- These pages were originally created on a Macintosh, which means that
each line is terminated by a CR (ASCII 13) only. According to the standard,
this should be sufficient, but some browsers cannot handle this correctly
in
<PRE>formatted sections. Preformatted sections may
appear as a single, very wide, line. To solve this, change all CR
characters to a linefeed (ASCII 10) on a UNIX system, or a CR+LF if you
are using Windows or DOS.
- MacWeb version 1.0.0A2 does not scroll a new page to the correct
position when a link is made to a named anchor. This is a known bug. It
does not happen when the page is already in MacWeb's page buffer.
- The 4-letter HTML extension of the filenames make it difficult to
transfer the files to DOS or Windows. Yes, I know. Get a real computer.
Now seriously: the .HTML extension is what is normally used. I do not
know how DOS/Windows browsers handle a reference to a filename with a
4-letter extension. If the last letter of the extension is ignored, it should work.
I tried to use only 8-character filenames that should be acceptable to
any system. If any filename is longer than 8 characters (not counting the
extension) or contains characters that are illegal on your platform, please report
it to me.
Things To Do
There are some improvements I would like to make:
- Add links to named anchors when a a reference is made to a
certain sense of an item. (like: see "HACK",
sense 4)
- Improve formatting by adding
<CITE> and
<CODE> style annotations.
- Maybe add illustrations
Other suggestions are welcome.
Other Problems
Please report it to me if you encounter any of the following problems:
- Links that point to the wrong or nonexisting destination.
- Links in the file (indicated by words between "{" and "}" that have
not been annotated as hypertext links)
- Serious formatting errors (like forgetting to annotate text as
<PRE>formatted in HTML).
- Use of illegal characters (I tried to replace all occurences of
<, > and & in the text as well as all special characters like
ö, but I may have missed some.
Do not complain about any problems related to this web version to the
maintainers of the Jargon file - they are innocent.
