In article <1766.962-29190-993886620-1179776826@seznam.cz>, =?us-ascii?Q?charlie=20chernohorsky?= <endlessoblivion@seznam.cz> writes:
hm, so we can leave out the interim step of enhancing hc to output xml, since once it proves possible to retain all important informations in xml, it'll be a run-just-once conversion.. i'd rather output src files from an xml using an xsl than vice versa..
Good point. I agree.
it should be easy to make an xsl produce helpdefs.h, as well as xhtml doc & help with embedded mathml..
Another good idea!
until fractint is able to consume the xml help source, there will be need for xml to src or hlp transformation..
Yes, currently the help code consumes the .hlp file. However, I don't like this .hlp file because it makes Windows users think "If I double click on this, I'll get the help for FractInt" and that doesn't work.
is the help still integrated in win32 executable?
No, I'm OK with having it be a separate file. I think the code is still there in an #ifdef, or I might have recently removed it. I don't like having #ifdef'ed blocks and I kill them if possible.
and is the help integrated in xfractint version?
Currently xfractint is only to the level of compiling and linking cleanly. It needs work done on its driver (actually, a "curses disk video" driver that doesn't need X11 and an X11 driver that's more like the Windows GDI driver). I don't even want to call it xfractint anymore as that introduces all kinds of #ifdefs all over the place just to change the name, but I'm only keeping the linux code compiling and linking at this point. When the structural changes are over, then the linux drivers will be coded.
or do they both use a standalone fractint.hlp?
That's the intent. I think the xfractint code path uses the standalone .hlp file.
I have some notes from Noel Giffin on converting the *.src files to HTML since he did it for the Spanky web site. If you want to start working on hc.cpp to enhance it for XML output, I can post his notes back to the list.
any additional insight over the help src format is welcome..
I know very little about it, but it appears to be described in hc.txt -- "The Direct3D Graphics Pipeline" -- DirectX 9 draft available for download <http://www.xmission.com/~legalize/book/download/index.html> Legalize Adulthood! <http://blogs.xmission.com/legalize/>