This directory contains a number of documents that can be used to test
certain features of XmHTML. The XmHTML version number at which a certain
document can be displayed is used to see if something gets broken in
subsequent releases.

HTML comments
-------------
The document comments.html contains a few examples of good and bad HTML
comments. Starting from XmHTML 1.0.18, every comment should be removed
properly and three warnings will be generated.

Frames
------
The frame?.html documents contain a number of different frame configurations.

Documents frame.html to frame4.html should be displayed successfully by
example_2 starting from XmHTML version 1.0.15.
The document frame5.html does *not* get displayed correctly with XmHTML
version 1.0.15.

Images
------
The document png.html contains two png images.

Should be displayed succesfully by example_2.c starting from XmHTML
version 1.0.13

Animations
----------
The documents animation1.html and animation2.html both contain an animation
made up of the xpm images located in this directory. animation1.html contains
a two animations while animation2.html contains three and some text to test the
scrolling behaviour of animations.

Should be displayed succesfully by example_2.c starting from XmHTML
version 1.0.10

Animation3.html contains an animated gif. Should be displayed succesfully by
example_2.c starting from XmHTML version 1.0.11

Imagemap testing
----------------
The document image-map.html contains the image black.jpg and a client-side
imagemap. When DEBUG has been defined during compilation, the selection
areas will be drawn onto this image. The document itself contains four
different areas: poly, circle, rect and default. One of these areas (a rect) 
has the nohref attribute set while the other ones reference a html page with
the name of their shape. Run with example_2 to see the names of the urls
referenced by the respective areas.

Should be displayed succesfully starting from XmHTML version 1.0.9

Font Consistency/Word glueing
-----------------------------
The document font-stuff.html contains some bogus text with different
mixed font styles and word glueing.

Should be displayed succesfully starting from XmHTML version 1.0.8

Face specification
------------------
The document face.html contains a number of font elements with a 
face tag. The following face values/combinations are tested and shows
the way XmHTML deals with the face tag:

arial (always fails unless you have installed this m$-windoze font);
helvetica (standard 75dpi and 100dpi iso8859-i);
New Century Schoolbook (standard 75dpi and 100dpi iso8859-1);

and combinations of bold and italic to show the XmHTML font handling scheme.

This document should be displayed successfully starting from XmHTML version 
1.0.7.

SGML Shorttags
--------------
(Original documents found at: http://www.absurd.org/dark_side/)

The following pages test XmHTML's ability to deal with SGML shorttags:

	dark_side.html
	empty.html
	empty1.html
	null_end.html
	null_end1.html
	unclosed.html
	unclosed1.html

These documents should be displayed successfully starting from XmHTML version 
1.0.6.

Cyrillic Font handling
----------------------
(Original document found at:
http://www.relcom.ru/koi/Russification/WinNetscape/test1251.html)

The following document contains some russian text:
	cyrillic.html

and can be used to test XmHTML's ability to deal with cyrillic fonts.

To test it, you will need to have a cyrillic font installed and tell XmHTML to 
use this font by setting the XmNcharset resource. Setting this resource alone 
will display the russian text, but you can achieve better results by also 
setting the XmNfontfamily and XmNfontFamilyFixed resources.

For the koi8 cyrillic font, the best results can be achieved by setting the
aforementioned resources to the following values:

*XmHTML*charset: koi8-*
*XmHTML*fontFamily: cronyx-times-*-*
*XmHTML*fontFamilyFixed: cronyx-fixed-*-*

This document should be displayed successfully starting from XmHTML version 
1.0.7.

Starting from example_2, XmHTML version 1.0.21, the document should be
displayed in russian automatically if you have the koi8 font installed.

Japanese Font Handling
----------------------
[No pages available, maybe someone can send me some?
 The new XmHTML font specification should work properly with japanese fonts
 too.]

To test it, you will need to have a japanese font installed and tell XmHTML to 
use this font by setting the XmNcharset resource. Setting this resource alone 
will display the japanese text, but you can achieve better results by also 
setting the XmNfontfamily and XmNfontFamilyFixed resources.

*XmHTML*charset: [tbd]
*XmHTML*fontFamily: [tbd]
*XmHTML*fontFamilyFixed: [tbd]

This document should be displayed successfully starting from XmHTML version 
1.0.7.

