Re: [jazzplusplus-devel] SF.net SVN: jazzplusplus: [595] trunk/jazz/src/HelpFiles/jazz.tex

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

DM = D.B. Moore
DM> Note: this has been quietly BCC'd to Pete's verizon
DM> account 'cos I believe he's missing mail, thank you
DM> not verizon....

I'm using my gmail account so I should be getting everything.  It's 
Thursday afternoon and I'm just getting around to working on Jazz++.

So much for the "week of Jazz++ code" ;-)

CM = Commit Mesasage
CM>> Subject: SF.net SVN: jazzplusplus: [595]
CM>> trunk/jazz/src/HelpFiles/jazz.tex
CM>> Date: Wed, 11 Jun 2008 08:01:59 -0700
CM>>
CM>> Revision: 595
CM>> http://jazzplusplus.svn.sourceforge.net/jazzplusplus/?rev=595&view=rev
CM>> Author: pstieber
CM>> Date: 2008-06-11 08:01:58 -0700 (Wed, 11 Jun 2008)
CM>>
CM>> Log Message:
CM>> -----------
CM>> 1. Made Donald B. Moore the primary author.
CM>> 2. Changed the date from May to June.
CM>>
CM>> Modified Paths:
CM>> --------------
CM>> trunk/jazz/src/HelpFiles/jazz.tex

DM> Well, I'm sure I'm chuffed by this recognition,
DM> however I'm not sure whether I've yet done
DM> enough to deserve such accolade

You have...  Better than a Gold Star Eh... ;-)

DM> - thanks Pete, I'll attempt to live up to
DM> the honor!
DM>
DM> Firstly here, I readily admit my knowledge of
DM> tex/latex is infantile - I've never actually worked
DM> with the suite at all, however I do understand it's
DM> purpose in life. Ergo, the jazz.tex file itself
DM> forms my own learning curve and personal mountain
DM> to climb -- like any studious fellow, as I stumble
DM> across things I do not know, I do the RTFM thang.
DM> That said, the more of this I do the more I come
DM> away scratching my head a bit -- not about
DM> what I'm reading, but more regarding jazz.tex
DM> itself.
DM>
DM> I think mainly here what I'm after is a bit of
DM> guidance regarding how to treat jazz.tex -- this
DM> is like saying "I can swim, but I'm in the middle
DM> of this big pool of water...a couple of pointers
DM> on how to get to land would be nice"
DM> I should quickly explain what I'm doing here...
DM>
DM> If for no other reason than it being immediately
DM> easy to meld tex2rtf into the fold, I use 'Kile'
DM> to edit the jazz.tex file. The 'quickbuild'
DM> function I've configured to use tex2rtf with the
DM> same invocation that Makefile defines.  This seems
DM> to work just fine for html generation, however I
DM> noticed last night PDF generation was broken -- this
DM> will be my fault.
DM>
DM> That in itself doesn't bother me right now -- my
DM> thinking here is that provided the html manual
DM> generation always works, it self supports the
DM> website content as well as jazz++ documentation
DM> overall...ie; everyone has a web-browser. Somewhere
DM> during my climb up the mountain side, I'll go "doh!"
DM> as it occurs to me how to fix PDF generation
DM> again...I'll get there, I like a challenge...
DM>
DM> Now...one thing that troubles me, is the way the
DM> above  tex/latex  app 'Kile', or 'TexMaker', and
DM> one or two other such editors, howl about tex
DM> syntax or formatting issues within jazz.tex
DM> itself -- again, some of this may well be my fault
DM> again, however I noticed the same complaints are
DM> generated by older versions (all I tried, including
DM> those I'd never touched) and that led me to the
DM> Dr. Spock raised single eyebrow expression...
DM>
DM> When you mention the issue with /U UL and such
DM> with tex2rtf, am I right in concluding that a lot
DM> of error issues I am seeing are so related to
DM> 'deprecated' style usage? For example...what I'm
DM> finding is \urlref or such is now \url (if I'm
DM> right?)

\urlref is specific to tex2rtf.  Look online for tex2rtf help.  I'm 
confused about what program is complaining.

DM> and for whatever reason the editor was
DM> auto-suggesting me to use \underline{ } ...which
DM> of course tex2rtf gets wrong, so instead of...

Well, I fixed the \underline issue in tex2rtf, so you need to update it, 
rebuild it, and reinstall it.  You may want to stay away from 
underlining in an HTML doc because links are underlined too.

DM> So I've removed those tics for now so the html still
DM> looks sane. Knowing very little, I don't want to fall
DM> into the trap of reading the latest and greatest tex/latex
DM> documentation, when I need to restrict the format
DM> of the jazz.tex file to the 'older' feature set
DM> supported by tex2rtf.  Perhaps if tex2rtf did become
DM> it's own separate project one day, these sorts of
DM> issues would be top-of-the-list of things todo.....
DM> however, if I need keep jazz.tex correct to an older
DM> guideline, it'd be handy to know exactly where that
DM> line is.

I'm not sure myself at this point.  Let's tackle them one at a time.

DM> PS: My son rather suddenly (although not altogether
DM> unexpectedly) moved out of home yesterday,
DM> venturing out on his current life ambitions of
DM> getting some 'real world experience' as it were,
DM> away from the regiment of academic study. For
DM> myself, this is a moment long visualized that
DM> one can never really prepare themselves for,
DM> and unlike most folks this is a juncture in life
DM> I reach alone, without the wife/mother/partner
DM> being any part of the current picture.
DM>
DM> The actual experience has turned out to leave me
DM> feeling somewhat dazed and confused, although he
DM> did say in parting that I was welcome to use his
DM> his winXP box while he was gone.

How old is he?  He may be back (with laundry) sooner than you think ;-)

He might notice a copy of TortioseSVN loaded on his Windows XP box ;-)

Pete