[coyotos-dev] OSDoc: migrating .xhtml->.ohtml

[Jonathan S. Shapiro]

In order to support MathML, the next generation of OSDoc needs to
emit .xhtml files.

Today, OSDoc assumes that .xhtml files are *input* which should be
transformed to provide things like the site navigation header and
sidebar. In hindsight, this was pretty stupid. While the files actually
*are* valid .xhtml, I failed to anticipate the need to treat .xhtml as
an output file extension, and I should have.

I have already made the following changes in the bitc/ and coyotos/ doc
trees. Updating from those trees will handle everything that you need to
do.

If you are using OSDoc elsewhere, you will want to make the following
changes:

1. In your Makefile(s), add a variable OSDOC_OHTML_SRC=... wherever you
already have OSDOC_XHTML_SRC. In the definition of that variable,
replace all occurrences of .xhtml with .ohtml.

2. After doing this, rename all of your .xhtml files to .ohtml.


Oh. The OSDoc repository has now moved from .../osdoc to .../osdoc/trunk

shap