GNOME Bugzilla – Bug 439974
[patch] english documentation enhancements
Last modified: 2009-01-31 19:46:40 UTC
Documentation Section: None Nothing in xml doc about shapes, Nothing about color selector dialog box Correct version: Adding shapes doc (xml formatted version of "shapes" text from /doc) documentation of color selector dialog box "hardcopies" makefile to build postscript, indexed pdf and html versions Other information: patch and figures attachments joined. Need someone to captures dialog box and color selector figures, both in png and encapsuled postscript format (current versions of these figures are in French, sorry :/)
Created attachment 88493 [details] [review] svn diff -x '-u' => english doc patch png figures uploaded in other attachments
Created attachment 88494 [details] color selector box capture needs to be replaced by an English version
Created attachment 88495 [details] preferences box capture needs to be replaced by an English version
Created attachment 88497 [details] [review] svn diff -x "-u" => English doc patch corrected some xml typos from previous patch which caused openjade to fails
Created attachment 88498 [details] doc/en/README.hardcopies just describes requirements and how to build html, postscript and pdf versions
Created attachment 88499 [details] doc/en/graphics/line_props.png replacement of line_props.png capture (the other one is completely unusable for pdf output, don't now why)
Created attachment 88670 [details] color selector in English.
Created attachment 88673 [details] preferences dialog in English
Created attachment 88675 [details] Color selector in English (eps).
Created attachment 88676 [details] Preferences dialog in English (eps)
Created attachment 88699 [details] [review] svn diff -x "-u" => English doc patch re-numbered chapters, integrated Jeremys's captures, added dia-cmdline.xml to xml_files in Makefile.am added README.hardcopies to the diff Note you need to add manually the two png captures from Jeremy (thanks!) in doc/en/graphics, and replace line_props.png by attachment 88499 [details]
Created attachment 88774 [details] [review] svn diff -x "-u" => English doc patch re-formating of custom-shapes chapter
Created attachment 88819 [details] [review] svn diff -x "-u" => English doc patch using xsltproc for html transformation (rendering problem with jw for <litterallayout>)
Hi Thomas, excellent work! Trying to apply the patch, I'm missing dia-cmdline.xml. Could you attach it? Do I have to commit the EPS files?
Hi Steffen, about dia-cmdline: dia-cmdline is created on-the-fly from dia.dbk via the sed script (see Makefile.am). This allows future up-to-date man page included in the manual. Feel free to check-up Makefile.am about postscripts: I added these ones because of conversion loosing quality (especially for inside text). Conversion is done for the other ones, so we don't need to include every postscript version of the figures, just that onces. Postscripts are needed for postscript output: make -f hardcopies.makefile dia.ps do the job fine... about hardcopies.makefile: This works fine, but I wish someones includes it's features to the main Makefile template (in top of source tree). I don't know enough automake to do this myself :) Cheers, Thomas
Lars has applied this patch recently. Thanks!
If I understood correctly the below included the last chunk: 2009-01-31 Hans Breuer <hans@breuer.org> [ Huge documentation update from Mark Dexter, bug #455400, hope I didn't break anything during merge. ] * doc/en/*.xml doc/en/graphics/*.png : 1. major edits to the following XML files: usage-quickstart.xml, usage-canvas.xml, usage-objects.xml, usage-objects-basic.xml, usage-objects-special.xml, usage-objects-selecting.xml. Added documentation for items not previously documented (e.g., Diagram Tree, Sheets and Objects, etc.) and expanded other documentation. 2. Added 78 screenshots (for a total of 82). 3. Minor edit to authors.xml. (Still need to fix broken links and bad e-mails). 4. Updated images. These changes obsolete the following bugs: #347209, #439974, #144128.