Re: [jazzplusplus-devel] online help build system update

[Pete S. <pst...@gm...>]

DM> Pete -- I've posted this reply to
DM> jazzplusplus-user as well, just to help
DM> remove any confusion generated there.

That's fine.  I'm going to stick with the developer list.

PS>>>> You will need certain tools available to make this
PS>>>> work. For the HTML help you will need the tex2rtf
PS>>>> code that is provided with wxWidgets.

DM>>> I did forget to mention that 'tex2rtf' doesn't
DM>>> seem to get built here as part of the wx-2.8.7
DM>>> build instructions. I have no idea if that's an
DM>>> expected result (it may well be)....

PS>> If you don't have tex2rtf, how did you build the
PS>> HTML help?

DM> Sorry, I should have been a bit clearer about this.
DM> Here's the detail ;

I'm going to start a new thread concerning tex2rtf on the developer list 
and copy some of your post to that thread.

PS>>>> For PDF generation, you will need a LaTeX
PS>>>> installation and the pdflatex converter.

DM>>> Using tetex under linux (which supplies the tool
DM>>> 'pdftex'), jazz.pdf generation also works fine.
DM>>> The tool 'pdftex' is also maintained separately
DM>>> (http://www.pdftex.org) and seems more current
DM>>> than the version shipping with tetex.
DM>>>
DM>>> Both versions work.

PS>> Maybe I can check for existence of pdflatex or
PS>> pdftex in the build system.

DM> Yeah, I think you'll have to. AFAICT 'pdflatex'
DM> is not specific to linux -

I'm not sure what you mean by "specific to Linux".  It's part of my 
Fedora 8 install.  It came with the tetex-latex-3.0-44.9.fc8.x86_64 
package.  I determined this using...

rpm -qf /usr/bin/pdflatex
tetex-latex-3.0-44.9.fc8.x86_64

pfdtex is also on the system.

rpm -qf /usr/bin/pdftex
tetex-3.0-44.9.fc8.x86_64

DM> the equivalence is 'pdftex' to the best of
DM> my knowledge. It probably make sense to
DM> include a check in configure for both these
DM> tool sets (including tex2rtf), and like other
DM> projects I've seen issue a warning at the end
DM> of configure 'documentation will not be built
DM> - please install <> if you wish to build a
DM> local copy of the documentation'
DM> ....blabla...

I think that's what we'll do...  Require tex2rtf since it is used for 
online help, but make the PDF build optional via --enable-pdfdocs.  If 
the developer uses --enable-pdfdocs, we'll check for a pdflatex install.

DM> I should also point out, although the 'tetex'
DM> distribution does include it's own (working)
DM> version of 'pdftex', the variant downloaded from
DM> http://www.pdftex.org is meant to replace the one
DM> distributed in tetex.

DM>>> I just need to clarify something here -- when you say;
DM>>>
DM>>> 'in your svn working'
DM>>>
DM>>> I construe this as ;
DM>>>
DM>>> 'in your svn working directory'
DM>>>
DM>>> Is that correct?

PS>> Yes. Sorry about the missing noun and the
PS>> related confusion. I just committed a fix
PS>> for this one. You update your web source
PS>> tree (i.e. your svn web working directory)
PS>> and svn will merge the changes with any
PS>> you have made.

DM> I should have patches for the rest of the
DM> web docs sorted over the next few days.

Excellent!  I'll be looking for them.

Next, I'm going to start that tex2rtf thread.

Pete