Hello !
As you may have noticed, CS documentation is being heavily restructured these
days. Also, recent updates related to documentation build process are
interesting, like:
- an updated texi2html
- the move of nodefix logic from a CS Jamfile to mk/docs.jam
- removal of runtexi2*.sh and cleaning/enhancement of build rules
I've quickly tested updating texi2html and docs.jam in crystaldoc and nothing
seems to be broken ;-) It even looks like issues with building other doc
formats (like dvi) are fixed.
I'm gonna tag the CVS repo some way (suggestions ?) then commit that in the
next few days.
Speaking of commits, I also set up a mailing list for them a few months ago,
and I'll activate the syncmail script soon, so we can see what's going on.
The ML page: https://lists.sourceforge.net/lists/listinfo/crystaldoc-cvs
So please use english for future commit comments ;-)
A new translation started a few months ago: German. Welcome Jan !
There was a volunteer for chinese too (hence the cn/ (which was a mistake of
mine) and zh/ directories), but it's delayed since Andy moved to USA.
It also looks like TexInfo format can't support such charsets...
Still, there are issues to resolve to get a clean build process:
- we lack a configure script so that tools are detected
- the pictures need to be copied somehow in the build directory before doc
build, especially for DVI output (they can be manually added afterward for
HTML)
- building on other OS than GNU/Linux
- any other I forgot ?
I'll try stripping CS autoconf stuff and add it to crystaldoc.
For the pictures, we probably just need a few tweaks in some jam file.
For other OS build, perhaps just adding macosx.jam and win32.jam will do...
The web site also need care, I guess I'll put SPIP (http://www.spip.net/) so
we can create articles in any language then translate them.
That is roughly sorted by priority order, please comment/make suggestions.
--
VK
|