[jazzplusplus-devel] Patch - Documentation - jazz.tex | htdocs

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

Greetings,

This patch adds more content to jazz.tex including a
section on soundfonts, and platform non specific
hardware considerations. some tips and tricks. Also
the preliminary content of the new FAQ area has been
added, and I'll add more to this as time allows.

If anyone can post the rpm package name for the
Mandriva SDK meta-package, that'd help me...if
you know the equivalent package name in Ubuntu,
same applies. Same applies for name of alsalib-devel
rpm packages. It'd save me a little time.. ;-) Entirely
optional of course, coding comes first...

Made an interesting discovery about jazz.tex entirely
by coincidence. I added an 'Appendix' subsection,
and naturally enough I appened this to the 'bottom'
 or 'end' of the jazz.tex file. This ends up exposed
in the user manual in entirely the wrong location.
In fact, if one doesn't have jazz.tex open in front
of them, finding the appendix in the freshly generated
HTML is quite an egghunt ;-)

And it suddenly dawned on me that the 'physical'
layout of jazz.tex in no way whatsoever resembles
the visually -presented- layout one ends up reading,
and even coders here will gel with how wacky that
make it working with stuff like this...I'll need think
about fixing this, because it makes a pain out of an
otherwise well streamlined system so far....

Pete, ....further to that hereabove, there's no
actual placeholder for FAQ content in jazz.tex yet,
indeed...I don't think there's an appropriate section
there yet for the placeholders to live in....however,
it's useful enough exposure (for devel purposes) to
park this text in htdocs FAQ for now - user FAQ
stuff will follow on later obviously. When it's all in
jazz.tex, we can rework/link-out htdocs/faq when that
happens easy enough

Also..recognize that I have to draw 'some line' regarding
considerations of along the lines of  "what's the least
capable PC around today that users are going to try
running Jazz++ (and softsynths)  with" -- really, I don't
know this answer. I think about people in far flung places,
perhaps still running sub-1gHz PC's with P! or P!! or K6/7
CPUs trying to use Jazz++ -- technically, I can test back
to these hardware specs 'coz I still have working examples
but I am going to?....not today...

This is reflected in the content, although most people
will never need it on current, new hardwares. My line is
currently drawn somewhere back near i686 MMX @ 800mHz...


See attached file :- 20080523-htdocs-docs-updates.patch.gz


This patch;

Adds initial content to new FAQ website area
Added following item to jazz.tex ;
Soundfont section
Common system considerations (CPU, RAM, usage tips)
Appendix subsection (currently empty)

Some formatting corrections, text changed/rearraged in some places.




Regards,

Donald B




_________________________________________________________________
Be part of history. Take part in Australia's first e-mail archive with Email Australia.
http://emailaustralia.ninemsn.com.au