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

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

D.B. Moore wrote:
DM> Apologies for not observing 'PCYMTNQREAIYR'
DM> previously..fixed..

No problem.  Happens all of the time.  Thanks for fixing it.

PS>> Donald or anyone else wishing to help with
PS>> documentation,
PS>>
PS>> If you update your subversion source tree, I have
PS>> modified the jazz/doc directory.  If you have
PS>> checked out the entire subversion repository so
PS>> you can create patches for the web content, the path
PS>> to the documentation directory is
PS>> jazzplusplus/trunk/jazz/doc.  On my x86_64 Fedora 8
PS>> box, if I run "make" in the referenced directory, it
PS>> will generate HTML help files you can view with your
PS>> favorite web browser and a jazz.pdf file.
PS>>
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.
PS>>
PS>> For PDF generation, you will need a LaTeX
PS>> installation and the pdflatex converter.
PS>>
PS>> If you have trouble with either of these build, you
PS>> can perform them separately by using
PS>>
PS>> make html
PS>>
PS>> for HTML help generation or
PS>>
PS>> make pdf
PS>>
PS>> for PDF file generation.
PS>>
PS>> Keep in mind I'm discussing and working on the build
PS>> process, not the content of the help.  The screen
PS>> shots used in the docs are from an old Jazz++ build
PS>> and it looks like the Motif Window manager (mwm) was
PS>> used.

DM> ....and possibly Lesstif widgets were used for linux
DM> builds IIRC

Yes, LessTif is the "open source" Motif (http://www.lesstif.org/).

PS>> They should be replaced.  I'm hoping the image format
PS>> (Portable Network Graphics or PNG -
PS>> http://www.libpng.org/pub/png/) will stick.
PS>>
PS>> I'll be counting on you to fix up the content;-)
PS>> Before I help you with that, let's see if you can
PS>> build the docs in either of the formats described
PS>> above.  Let me know and I enjoyed your "biography post".

DM> Manual (separate) generation of HTML docs works fine.

Excellent!  Then you have a working tex2rtf!

DM> I'll need grab & install 'pdflatex' to checkout the
DM> PDF build.  I'll do a full 'inline' build
DM> of the tree a bit later and check all is
DM> working as expected.

Would you like me to send you the current PDF file in a private email?

DM> Glad my bio-post wasn't too far off topic ;-)

Considering the amount of traffic on these lists (almost none) any post 
related to Jazz++ is welcome.

PS>> BTW, It appears my service provider (verizon.net)
PS>> is blocking email from the Jazz++ lists, so I may
PS>> end up replying using some other email account...
PS>> What a pain.

DM> Indeed...why on earth would they do that?

I don't know, but thank goodness for gmail.

Since you can build the HTML help using "make html" feel free to start 
editing jazz.tex and send me patches.  Replacement screen shots are 
welcome too.  We may end up with different sets of screen shots for each 
platform and I can change the Makefile to build the docs for different 
platforms.  I'm going to make one commit to jazz.tex before I go to bed, 
but after that it's "open season" for you.

I would prefer many smaller patches than one big patch, and please 
include a note summarizing the changes you made.  I'll use this in 
commit message and give you credit.  The first change you should make is 
make yourself a coauthor.  I changed the original author names because 
they have been out of the picture for over 8 years.  The commit messages 
will look like...

"Applied a patch provided by Donald B. Moore.
Your description here.
A description of anything I changed here."

I see you signed up for the jazzplusplus-updates list.  Excellent!

Looking forward to your web content and documentation patches.

TIA,
Pete