Re: [jazzplusplus-devel] Tex2RTF for online documentation building

[D.B. M. <db...@ho...>]

----------------------------------------
> Date: Sun, 11 May 2008 21:38:40 -0700



> You correctly surmised that a tex2rtf binary is not included with a 
> wxWidgets distribution.  It is considered a utility that is not required 
> to use wxWidgets.  It was used to generate the documentation for 
> wxWidgets itself, but I believe that will not be the case for future 
> versions (2.9.* and 3.*) of wxWidgets.
> 
> It was lucky for you that you attempted to build tex2rtf from a stock 
> build.  Given the options we use to build wxWidgets for use with Jazz++, 
> you would have run into trouble with the non-stock build of tex2rtf.  We 
> use the stl in our wxWidgets build, and tex2rtf is not compatible with 
> the stl build of wxWidgets.
> 
> I have created a patched tex2rtf, that does build with our wxWidgets 
> options.  I submitted it to the wxWidgets sourceforge patch manager 
> (number 1755801) quite a while ago, but the patch caused a problem with 
> the stock build.
> 
> I guess I have the following options...
> 
> 1. Since wxWidgets is switching to a different documentation build 
> system, I could try submitting the patch again, but the process will 
> take up a lot of my Jazz++ development time.
> 2. I could create a fork of tex2rtf in our development tree so I could 
> change it in any way I like.  This is my favorite option at this point.
> 3. I could make binaries available for download.  I don't like this idea 
> because there might be some platforms I have difficulty generating and 
> testing a binary on.

Yeah...don't do option 3, it's perilous considering how many platforms
are out there. When we get around to doing binary packages, the 
documentation will have already been built and included there - this
infers the source tree compiles the documentation. If there's a future
wherein jazz++ is supposed to compile from source tarball release
on a package-managed system against a *stock* wxwidgets tree,
the only way that's going to happen is if tex2rtf is available, and
by the sounds of it this might not be the case. 

Do we know of anything else dependent on tex2rtf in the real world?

I like option 2.  - it neatly gets around all this conjecture by being
part of the jazz++ tree, and offers the most flexibility overall (without
need to rework things already done). 
> 
> I do like tex2rtf's capabilities, and I do want to use it for online 
> HTML help.  What do you all think?
> 

It generates correct HTML, it's quick, and you've a history with it.
In my country, we have a saying - "When you're on a good thing -
stick to it!" -- I believe that idiom applies here.  (-;
 
Regards,

Donald B


> -------------------------------------------------------------------------
> This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
> Don't miss this year's exciting event. There's still time to save $100. 
> Use priority code J8TL2D2. 
> http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
> _______________________________________________
> jazzplusplus-devel mailing list
> jaz...@li...
> https://lists.sourceforge.net/lists/listinfo/jazzplusplus-devel

_________________________________________________________________
It's simple! Sell your car for just $30 at CarPoint.com.au
http://a.ninemsn.com.au/b.aspx?URL=http%3A%2F%2Fsecure%2Dau%2Eimrworldwide%2Ecom%2Fcgi%2Dbin%2Fa%2Fci%5F450304%2Fet%5F2%2Fcg%5F801459%2Fpi%5F1004813%2Fai%5F859641&_t=762955845&_r=tig_OCT07&_m=EXT