[Crystaldoc-main] News and upcoming updates to crystaldoc
Status: Alpha
Brought to you by:
vknecht
From: Vincent K. <vi...@ie...> - 2005-07-07 18:22:35
|
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 |