[Openmcl-devel] New documentation strangeness

[Andrew P. Lentvorski, Jr.]

Thanks for all the hard work on the documentation.  I have started
looking at the threading section.

I bumped into some strangeness with the interlinks.  From the
source:

<a href="Doc/ch02s01.html#id868187">

Firefox seems to be choking on that hyperlink; specifically it is 
looking
for a file that includes #id868187 on the end.

The issues seems to be this line in ch02s01.html:

<a name="id868187">

I think that needs to be id="id868187" unless you explicitly specify
to use the old HTML standards.

Since, you are actually seem to want XHTML though, the files are
missing several of the required initial XML directives:

<?xml version="1.0" encoding="UTF-8"?>

as well as the <!DOCTYPE> directive required for XHTML.

As I tend to forget these things all the time, I make lots of use of
the free validator at the w3c:

http://validator.w3.org/

Thanks for all the work on the docs,
-a