[Nobug] Docu updated

[Christian Thaeter]

benny.lyons at uniserv.com wrote:
> Evening all, 
> I've carried out primarily minor modifications to the documention.  
> I'm just after pushing these changes up to devel:/refs/heads/benny
> for anyone wishing to have a look (pulled from devel).  I think 
> the changes are so slight they can simply be merged into master or 
> devel without serious loss of sleep during the night. I've more or 
> less proof read and corrected up to the section on Macros on p 27
> of the pdf.  I still have to run through the new stuff ... updates 
> later on in the week.
> 
> I was glancing through the pdf, looks really nice, although still
> a little bit to do.  Are the style sheets already in devel, i.e., 
> if I make doc, will I get the new format?  I've got an old Etch 
> I can use, is the Latex installation ok to use there?

We dont do any stylesheet transformation anymore, initially I was going
over docbook with a2x and dblatex which produced quite ugly docs which
would depend on stylesheets for the transformation. Now with the config
Andreas started we use a latex backend from asciidoc directly, this uses
the KOMAscript book class and is configured by doc/latex.conf . This
puts a little more burden on us configuring this but I know this better
than the xslt cruft and of couse you see the results which are much more
pleasant.

Thanks for your patch, I merged it already, except reverting the hunk
about NOBUG_INIT() i want to have this mandatory for the time being and
decide on this later (there are some corner cases involved, what if a
library starts a thread before main() for example ...) possibly this all
needs some even more lax definition.


	Christian


> 
> 
> Benny
> 
> -----Original Message-----
> From: nobug-bounces at lists.pipapo.org
> [mailto:nobug-bounces at lists.pipapo.org] On Behalf Of Christian Thaeter
> Sent: Sunday, August 08, 2010 7:31 PM
> To: nobug at lists.pipapo.org
> Cc: General Discussion about Lumiera
> Subject: [Nobug] NoBug reference manual PDF generation
> 
> Andreas send me a (unfinished) patch for latex generation which I merged
> now, included now. A first rough result:
>  http://lumiera.org/nobug_manual.pdf
> 
> Thanks to Andreas for his initial work..
> 
> Quite much to do but looks already a lot better than the dblatex
> generated stuff I had first. Note that I am doing this under
> debian/queeze now, the toolchain under debian/lenny led to more
> problems.
> 
> Andreas told me that asciidoc deprecated an old table syntax in favor
> for a new syntax. We agreed that we follow this and update all tables to
> use the new syntax. Then the Latex macros for tables need only to be
> implemented for this new table styles.
> 
> I pushed current work to the 'devel' branch and focusing on fixing
> things there. The PDF above will be updated continously as far I make
> some progress. Anyone who wants to help, please merge and work on base
> of my 'devel' branch and push things to the mob repository or ask me for
> an account for your own repository on the server.
> 
> Note to the Lumierans, I'm going to make this PDF generation for NoBug
> also the base style for uWiki and the Lumiera documentation later.
> 
> 	Christian
> _______________________________________________
> Nobug mailing list
> Nobug at lists.pipapo.org
> http://lists.pipapo.org/cgi-bin/mailman/listinfo/nobug