gnucash-docs master: Multiple changes pushed
Frank H. Ellenberger
fell at code.gnucash.org
Tue Jan 26 19:27:21 EST 2016
Updated via https://github.com/Gnucash/gnucash-docs/commit/4d5307a6 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/fd63aab3 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/24242b56 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/948b447b (commit)
via https://github.com/Gnucash/gnucash-docs/commit/68c4accf (commit)
via https://github.com/Gnucash/gnucash-docs/commit/5b406970 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/506fc583 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/77011fa2 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/27459473 (commit)
commit 4d5307a640be024afd18900b6e6624399c3b509c
Merge: 2745947 fd63aab
Author: fell <f.ellenberger at online.de>
Date: Wed Jan 27 01:25:05 2016 +0100
Merge branch 'maint'
Conflicts:
help/C/Help_ch_Reports.xml
diff --cc help/C/Help_ch_Reports.xml
index e01aaa3,d930e29..2989052
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@@ -337,13 -609,13 +614,13 @@@
</itemizedlist>
</listitem>
</itemizedlist>
- </sect3>
+ </sect4>
- <sect3 id="report-txrpt-splits">
+ <sect4 id="report-txrpt-splits">
<title>Displaying Split Account Details</title>
- <para>This is controled by the <emphasis>Style</emphasis> option on the General tab.</para>
+ <para>This is controled by the <emphasis>Detail Level</emphasis> option on the Display tab.</para>
<note>
- <para>In stable version 2.8.0 this option will be renamed to <emphasis>Detail Level</emphasis> on the Display tab.</para>
+ <para>In stable versions before 2.8.0 this option was called <emphasis>Style</emphasis> on the General tab.</para>
</note>
<para>In <emphasis>Single</emphasis> line mode, there's only one line per transaction. So you can have
the account name on one side of the equation and
commit fd63aab350ec64ca86ef065a5f41b75c745b1c56
Author: Chris Good <chris.good at ozemail.com.au>
Date: Tue Jan 26 21:19:34 2016 +0100
Add format token lli in Help Counters Book Options Tab - Bug
728722
diff --git a/help/C/Help_ch_Business.xml b/help/C/Help_ch_Business.xml
index 7e57cbc..153bd7f 100644
--- a/help/C/Help_ch_Business.xml
+++ b/help/C/Help_ch_Business.xml
@@ -40,9 +40,7 @@
<title>Initial Setup</title>
<para>To set up <application>&app;</application> to handle accounts receivable and accounts payable
- for a company four preliminary things must be done. The first is to build an appropriate
- Account Hierarchy. The second is set up tax tables. The third is to register the company in
- <application>&app;</application>. The fourth is to set up billing terms.
+ for a company the following preliminary steps must be done.
</para>
<sect2 id="busnss-setupacct2">
@@ -152,6 +150,16 @@
</para>
</sect2>
+ <sect2 id="busnss-setup-cntrs">
+ <title>Counters</title>
+
+ <para>Define the format and last used numbers of codes such as customer,
+ invoice, vendor, bill, employee, expense voucher, job number and
+ order.
+ See <xref linkend="counters-book-options" />.
+ </para>
+ </sect2>
+
<sect2 id="busnss_setup_pref">
<title>Business Preferences</title>
<para>Set options on the Business tab of the <application>&app;</application> preferences, which is
diff --git a/help/C/Help_ch_Customize.xml b/help/C/Help_ch_Customize.xml
index 2d3df67..00979a8 100644
--- a/help/C/Help_ch_Customize.xml
+++ b/help/C/Help_ch_Customize.xml
@@ -1493,11 +1493,15 @@
printing of the number. For example, to put the literal "C - " in front
of the customer number, you would put "C - %li" (without the quotes;
"li" on Unix, "I64i" on Windows) in the customer format string field.
- If the value in the customer number field was 5, the next cutomer added
+ If the value in the customer number field was 5, the next customer added
would be assigned the number "C - 6". As another example, if you wanted
the number to be printed with leading zeros and 5 characters wide, you
would enter "C - %05li" and the next customer number would be assigned
the number "C - 00006".</para>
+
+ <note><para>On some versions of Unix, for example Fedora 18 32-bit, it is necessary to use
+ "lli" instead of "li". Fedora 22 64-bit needs "li".</para>
+ </note>
</sect2>
</sect1>
commit 24242b56a0e7b2fac867e3f6d7568ec87e60d102
Author: fell <f.ellenberger at online.de>
Date: Tue Jan 26 18:58:44 2016 +0100
Remove obsolete version number from README
diff --git a/README b/README
index 0f02b63..15ecca4 100644
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
############################################################
- GnuCash Docs 2.5.x README file.
+ GnuCash Docs README file
------------------------------------------------------------
This is the docs module for GnuCash. The docs can be accessed
commit 948b447b0c3b41e4a5a9719412f4f756c8d9d7e4
Author: John Ralls <jralls at ceridwen.us>
Date: Tue Jan 26 09:05:47 2016 -0800
Remove build product accidentally committed.
diff --git a/guide/ja/fop.xconf b/guide/ja/fop.xconf
deleted file mode 100644
index b100c87..0000000
--- a/guide/ja/fop.xconf
+++ /dev/null
@@ -1,439 +0,0 @@
-<?xml version="1.0"?>
-<fop version="1.0">
- <font-base>/home/pedro/Programas/GnucashGit/gnucash-docs</font-base>
-
- <!-- Source resolution in dpi (dots/pixels per inch) for determining the size of pixels in SVG and bitmap images, default: 72dpi -->
- <source-resolution>72</source-resolution>
- <!-- Target resolution in dpi (dots/pixels per inch) for specifying the target resolution for generated bitmaps, default: 72dpi -->
- <target-resolution>72</target-resolution>
-
- <!-- page-height and page-width, A4 for Japanese -->
- <default-page-settings height="297mm" width="210mm"/>
-
- <!-- Information for specific renderers -->
- <!-- Uses renderer mime type for renderers -->
- <renderers>
- <renderer mime="application/pdf">
- <filterList>
- <!-- provides compression using zlib flate (default is on) -->
- <value>flate</value>
- </filterList>
-
- <fonts>
- <!-- embedded fonts -->
- <!--
- This information must exactly match the font specified
- in the fo file. Otherwise it will use a default font.
-
- For example,
- <fo:inline font-family="Arial" font-weight="bold" font-style="normal">
- Arial-normal-normal font
- </fo:inline>
- for the font triplet specified by:
- <font-triplet name="Arial" style="normal" weight="bold"/>
-
- If you do not want to embed the font in the pdf document
- then do not include the "embed-url" attribute.
- The font will be needed where the document is viewed
- for it to be displayed properly.
-
- possible styles: normal | italic | oblique | backslant
- possible weights: normal | bold | 100 | 200 | 300 | 400
- | 500 | 600 | 700 | 800 | 900
- (normal = 400, bold = 700)
- -->
- <font kerning="yes" embed-url="fonts/ume-tmo3.ttf">
- <font-triplet name="serif" style="normal" weight="normal"/>
- </font>
- <font kerning="yes" embed-url="fonts/ume-tmo3.ttf">
- <font-triplet name="serif" style="normal" weight="bold" />
- <font-triplet name="sans-serif" style="normal" weight="normal"/>
- <font-triplet name="sans-serif" style="normal" weight="bold" />
-
- <font-triplet name="serif" style="italic" weight="normal"/>
- <font-triplet name="serif" style="italic" weight="bold" />
- <font-triplet name="sans-serif" style="italic" weight="normal"/>
- <font-triplet name="sans-serif" style="italic" weight="bold" />
- </font>
- </fonts>
-
- <!-- This option lets you specify additional options on an XML handler -->
- <xml-handler namespace="http://www.w3.org/2000/svg">
- <stroke-text>true</stroke-text>
- </xml-handler>
-
- </renderer>
-
- <renderer mime="application/x-afp">
- <!--
- The bit depth and type of images produced
- (this is the default setting)
- -->
- <images mode="b+w" bits-per-pixel="8"/>
- <renderer-resolution>240</renderer-resolution>
- <resource-group-file>resources.afp</resource-group-file>
-
- <fonts>
- <!--
- Below is an example using raster font configuration using FOP builtin base-14 font metrics.
- for Times Roman, Helvetica and Courier.
-
- Depending on AFP raster and outline font availability on your installation you will
- most likely need to modify the configuration provided below.
-
- See http://xmlgraphics.apache.org/fop/trunk/output.html#afp-configuration
- for details of FOP configuration for AFP
- -->
-
- <!-- Times Roman -->
- <font>
- <afp-font name="Times Roman" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0N20060" base14-font="TimesRoman"/>
- <afp-raster-font size="7" characterset="C0N20070" base14-font="TimesRoman"/>
- <afp-raster-font size="8" characterset="C0N20080" base14-font="TimesRoman"/>
- <afp-raster-font size="9" characterset="C0N20090" base14-font="TimesRoman"/>
- <afp-raster-font size="10" characterset="C0N20000" base14-font="TimesRoman"/>
- <afp-raster-font size="11" characterset="C0N200A0" base14-font="TimesRoman"/>
- <afp-raster-font size="12" characterset="C0N200B0" base14-font="TimesRoman"/>
- <afp-raster-font size="14" characterset="C0N200D0" base14-font="TimesRoman"/>
- <afp-raster-font size="16" characterset="C0N200F0" base14-font="TimesRoman"/>
- <afp-raster-font size="18" characterset="C0N200H0" base14-font="TimesRoman"/>
- <afp-raster-font size="20" characterset="C0N200J0" base14-font="TimesRoman"/>
- <afp-raster-font size="24" characterset="C0N200N0" base14-font="TimesRoman"/>
- <afp-raster-font size="30" characterset="C0N200T0" base14-font="TimesRoman"/>
- <afp-raster-font size="36" characterset="C0N200Z0" base14-font="TimesRoman"/>
- </afp-font>
- <font-triplet name="Times" style="normal" weight="normal"/>
- <font-triplet name="TimesRoman" style="normal" weight="normal"/>
- <font-triplet name="Times Roman" style="normal" weight="normal"/>
- <font-triplet name="Times-Roman" style="normal" weight="normal"/>
- <font-triplet name="Times New Roman" style="normal" weight="normal"/>
- <font-triplet name="TimesNewRoman" style="normal" weight="normal"/>
- <font-triplet name="serif" style="normal" weight="normal"/>
- </font>
-
- <!-- Times Roman Italic -->
- <font>
- <afp-font name="Times Roman Italic" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0N30060" base14-font="TimesItalic"/>
- <afp-raster-font size="7" characterset="C0N30070" base14-font="TimesItalic"/>
- <afp-raster-font size="8" characterset="C0N30080" base14-font="TimesItalic"/>
- <afp-raster-font size="9" characterset="C0N30090" base14-font="TimesItalic"/>
- <afp-raster-font size="10" characterset="C0N30000" base14-font="TimesItalic"/>
- <afp-raster-font size="11" characterset="C0N300A0" base14-font="TimesItalic"/>
- <afp-raster-font size="12" characterset="C0N300B0" base14-font="TimesItalic"/>
- <afp-raster-font size="14" characterset="C0N300D0" base14-font="TimesItalic"/>
- <afp-raster-font size="16" characterset="C0N300F0" base14-font="TimesItalic"/>
- <afp-raster-font size="18" characterset="C0N300H0" base14-font="TimesItalic"/>
- <afp-raster-font size="20" characterset="C0N300J0" base14-font="TimesItalic"/>
- <afp-raster-font size="24" characterset="C0N300N0" base14-font="TimesItalic"/>
- <afp-raster-font size="30" characterset="C0N300T0" base14-font="TimesItalic"/>
- <afp-raster-font size="36" characterset="C0N300Z0" base14-font="TimesItalic"/>
- </afp-font>
- <font-triplet name="Times" style="italic" weight="normal"/>
- <font-triplet name="TimesRoman" style="italic" weight="normal"/>
- <font-triplet name="Times Roman" style="italic" weight="normal"/>
- <font-triplet name="Times-Roman" style="italic" weight="normal"/>
- <font-triplet name="Times New Roman" style="italic" weight="normal"/>
- <font-triplet name="TimesNewRoman" style="italic" weight="normal"/>
- <font-triplet name="serif" style="italic" weight="normal"/>
- </font>
-
- <!-- Times Roman Bold -->
- <font>
- <afp-font name="Times Roman Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0N40060" base14-font="TimesBold"/>
- <afp-raster-font size="7" characterset="C0N40070" base14-font="TimesBold"/>
- <afp-raster-font size="8" characterset="C0N40080" base14-font="TimesBold"/>
- <afp-raster-font size="9" characterset="C0N40090" base14-font="TimesBold"/>
- <afp-raster-font size="10" characterset="C0N40000" base14-font="TimesBold"/>
- <afp-raster-font size="11" characterset="C0N400A0" base14-font="TimesBold"/>
- <afp-raster-font size="12" characterset="C0N400B0" base14-font="TimesBold"/>
- <afp-raster-font size="14" characterset="C0N400D0" base14-font="TimesBold"/>
- <afp-raster-font size="16" characterset="C0N400F0" base14-font="TimesBold"/>
- <afp-raster-font size="18" characterset="C0N400H0" base14-font="TimesBold"/>
- <afp-raster-font size="20" characterset="C0N400J0" base14-font="TimesBold"/>
- <afp-raster-font size="24" characterset="C0N400N0" base14-font="TimesBold"/>
- <afp-raster-font size="30" characterset="C0N400T0" base14-font="TimesBold"/>
- <afp-raster-font size="36" characterset="C0N400Z0" base14-font="TimesBold"/>
- </afp-font>
- <font-triplet name="Times" style="normal" weight="bold"/>
- <font-triplet name="TimesRoman" style="normal" weight="bold"/>
- <font-triplet name="Times Roman" style="normal" weight="bold"/>
- <font-triplet name="Times-Roman" style="normal" weight="bold"/>
- <font-triplet name="Times New Roman" style="normal" weight="bold"/>
- <font-triplet name="TimesNewRoman" style="normal" weight="bold"/>
- <font-triplet name="serif" style="normal" weight="bold"/>
- </font>
-
- <!-- Times Roman Italic Bold -->
- <font>
- <afp-font name="Times Roman Italic Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0N50060" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="7" characterset="C0N50070" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="8" characterset="C0N50080" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="9" characterset="C0N50090" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="10" characterset="C0N50000" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="11" characterset="C0N500A0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="12" characterset="C0N500B0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="14" characterset="C0N500D0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="16" characterset="C0N500F0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="18" characterset="C0N500H0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="20" characterset="C0N500J0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="24" characterset="C0N500N0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="30" characterset="C0N500T0" base14-font="TimesBoldItalic"/>
- <afp-raster-font size="36" characterset="C0N500Z0" base14-font="TimesBoldItalic"/>
- </afp-font>
- <font-triplet name="Times" style="italic" weight="bold"/>
- <font-triplet name="TimesRoman" style="italic" weight="bold"/>
- <font-triplet name="Times Roman" style="italic" weight="bold"/>
- <font-triplet name="Times-Roman" style="italic" weight="bold"/>
- <font-triplet name="Times New Roman" style="italic" weight="bold"/>
- <font-triplet name="TimesNewRoman" style="italic" weight="bold"/>
- <font-triplet name="serif" style="italic" weight="bold"/>
- </font>
-
- <!-- Helvetica -->
- <font>
- <afp-font name="Helvetica" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0H20060" base14-font="Helvetica"/>
- <afp-raster-font size="7" characterset="C0H20070" base14-font="Helvetica"/>
- <afp-raster-font size="8" characterset="C0H20080" base14-font="Helvetica"/>
- <afp-raster-font size="9" characterset="C0H20090" base14-font="Helvetica"/>
- <afp-raster-font size="10" characterset="C0H20000" base14-font="Helvetica"/>
- <afp-raster-font size="11" characterset="C0H200A0" base14-font="Helvetica"/>
- <afp-raster-font size="12" characterset="C0H200B0" base14-font="Helvetica"/>
- <afp-raster-font size="14" characterset="C0H200D0" base14-font="Helvetica"/>
- <afp-raster-font size="16" characterset="C0H200F0" base14-font="Helvetica"/>
- <afp-raster-font size="18" characterset="C0H200H0" base14-font="Helvetica"/>
- <afp-raster-font size="20" characterset="C0H200J0" base14-font="Helvetica"/>
- <afp-raster-font size="24" characterset="C0H200N0" base14-font="Helvetica"/>
- <afp-raster-font size="30" characterset="C0H200T0" base14-font="Helvetica"/>
- <afp-raster-font size="36" characterset="C0H200Z0" base14-font="Helvetica"/>
- </afp-font>
- <font-triplet name="Helvetica" style="normal" weight="normal"/>
- <font-triplet name="Arial" style="normal" weight="normal"/>
- <font-triplet name="sans-serif" style="normal" weight="normal"/>
- <font-triplet name="any" style="normal" weight="normal"/>
- </font>
-
- <!-- Helvetica Italic -->
- <font>
- <afp-font name="Helvetica Italic" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0H30060" base14-font="HelveticaOblique"/>
- <afp-raster-font size="7" characterset="C0H30070" base14-font="HelveticaOblique"/>
- <afp-raster-font size="8" characterset="C0H30080" base14-font="HelveticaOblique"/>
- <afp-raster-font size="9" characterset="C0H30090" base14-font="HelveticaOblique"/>
- <afp-raster-font size="10" characterset="C0H30000" base14-font="HelveticaOblique"/>
- <afp-raster-font size="11" characterset="C0H300A0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="12" characterset="C0H300B0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="14" characterset="C0H300D0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="16" characterset="C0H300F0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="18" characterset="C0H300H0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="20" characterset="C0H300J0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="24" characterset="C0H300N0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="30" characterset="C0H300T0" base14-font="HelveticaOblique"/>
- <afp-raster-font size="36" characterset="C0H300Z0" base14-font="HelveticaOblique"/>
- </afp-font>
- <font-triplet name="Helvetica" style="italic" weight="normal"/>
- <font-triplet name="Arial" style="italic" weight="normal"/>
- <font-triplet name="sans-serif" style="italic" weight="normal"/>
- </font>
-
- <!-- Helvetica (Semi) Bold -->
- <font>
- <afp-font name="Helvetica (Semi) Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0H40060" base14-font="HelveticaBold"/>
- <afp-raster-font size="7" characterset="C0H40070" base14-font="HelveticaBold"/>
- <afp-raster-font size="8" characterset="C0H40080" base14-font="HelveticaBold"/>
- <afp-raster-font size="9" characterset="C0H40090" base14-font="HelveticaBold"/>
- <afp-raster-font size="10" characterset="C0H40000" base14-font="HelveticaBold"/>
- <afp-raster-font size="11" characterset="C0H400A0" base14-font="HelveticaBold"/>
- <afp-raster-font size="12" characterset="C0H400B0" base14-font="HelveticaBold"/>
- <afp-raster-font size="14" characterset="C0H400D0" base14-font="HelveticaBold"/>
- <afp-raster-font size="16" characterset="C0H400F0" base14-font="HelveticaBold"/>
- <afp-raster-font size="18" characterset="C0H400H0" base14-font="HelveticaBold"/>
- <afp-raster-font size="20" characterset="C0H400J0" base14-font="HelveticaBold"/>
- <afp-raster-font size="24" characterset="C0H400N0" base14-font="HelveticaBold"/>
- <afp-raster-font size="30" characterset="C0H400T0" base14-font="HelveticaBold"/>
- <afp-raster-font size="36" characterset="C0H400Z0" base14-font="HelveticaBold"/>
- </afp-font>
- <font-triplet name="Helvetica" style="normal" weight="bold"/>
- <font-triplet name="Arial" style="normal" weight="bold"/>
- <font-triplet name="sans-serif" style="normal" weight="bold"/>
- </font>
-
- <!-- Helvetica Italic (Semi) Bold -->
- <font>
- <afp-font name="Helvetica Italic (Semi) Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0H50060" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="7" characterset="C0H50070" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="8" characterset="C0H50080" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="9" characterset="C0H50090" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="10" characterset="C0H50000" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="11" characterset="C0H500A0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="12" characterset="C0H500B0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="14" characterset="C0H500D0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="16" characterset="C0H500F0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="18" characterset="C0H500H0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="20" characterset="C0H500J0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="24" characterset="C0H500N0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="30" characterset="C0H500T0" base14-font="HelveticaBoldOblique"/>
- <afp-raster-font size="36" characterset="C0H500Z0" base14-font="HelveticaBoldOblique"/>
- </afp-font>
- <font-triplet name="Helvetica" style="italic" weight="bold"/>
- <font-triplet name="Arial" style="italic" weight="bold"/>
- <font-triplet name="sans-serif" style="italic" weight="bold"/>
- </font>
-
- <!-- Courier -->
- <font>
- <afp-font name="Courier" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0420060" base14-font="Courier"/>
- <afp-raster-font size="7" characterset="C0420070" base14-font="Courier"/>
- <afp-raster-font size="8" characterset="C0420080" base14-font="Courier"/>
- <afp-raster-font size="9" characterset="C0420090" base14-font="Courier"/>
- <afp-raster-font size="10" characterset="C0420000" base14-font="Courier"/>
- <afp-raster-font size="11" characterset="C04200A0" base14-font="Courier"/>
- <afp-raster-font size="12" characterset="C04200B0" base14-font="Courier"/>
- <afp-raster-font size="14" characterset="C04200D0" base14-font="Courier"/>
- <afp-raster-font size="16" characterset="C04200F0" base14-font="Courier"/>
- <afp-raster-font size="18" characterset="C04200H0" base14-font="Courier"/>
- <afp-raster-font size="20" characterset="C04200J0" base14-font="Courier"/>
- <afp-raster-font size="24" characterset="C04200N0" base14-font="Courier"/>
- <afp-raster-font size="30" characterset="C04200T0" base14-font="Courier"/>
- <afp-raster-font size="36" characterset="C04200Z0" base14-font="Courier"/>
- </afp-font>
- <font-triplet name="Courier" style="normal" weight="normal"/>
- <font-triplet name="monospace" style="normal" weight="normal"/>
- </font>
-
- <!-- Courier Italic -->
- <font>
- <afp-font name="Courier Italic" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0430060" base14-font="CourierOblique"/>
- <afp-raster-font size="7" characterset="C0430070" base14-font="CourierOblique"/>
- <afp-raster-font size="8" characterset="C0430080" base14-font="CourierOblique"/>
- <afp-raster-font size="9" characterset="C0430090" base14-font="CourierOblique"/>
- <afp-raster-font size="10" characterset="C0430000" base14-font="CourierOblique"/>
- <afp-raster-font size="11" characterset="C04300A0" base14-font="CourierOblique"/>
- <afp-raster-font size="12" characterset="C04300B0" base14-font="CourierOblique"/>
- <afp-raster-font size="14" characterset="C04300D0" base14-font="CourierOblique"/>
- <afp-raster-font size="16" characterset="C04300F0" base14-font="CourierOblique"/>
- <afp-raster-font size="18" characterset="C04300H0" base14-font="CourierOblique"/>
- <afp-raster-font size="20" characterset="C04300J0" base14-font="CourierOblique"/>
- <afp-raster-font size="24" characterset="C04300N0" base14-font="CourierOblique"/>
- <afp-raster-font size="30" characterset="C04300T0" base14-font="CourierOblique"/>
- <afp-raster-font size="36" characterset="C04300Z0" base14-font="CourierOblique"/>
- </afp-font>
- <font-triplet name="Courier" style="italic" weight="normal"/>
- <font-triplet name="monospace" style="italic" weight="normal"/>
- </font>
-
- <!-- Courier Bold -->
- <font>
- <afp-font name="Courier Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0440060" base14-font="CourierBold"/>
- <afp-raster-font size="7" characterset="C0440070" base14-font="CourierBold"/>
- <afp-raster-font size="8" characterset="C0440080" base14-font="CourierBold"/>
- <afp-raster-font size="9" characterset="C0440090" base14-font="CourierBold"/>
- <afp-raster-font size="10" characterset="C0440000" base14-font="CourierBold"/>
- <afp-raster-font size="11" characterset="C04400A0" base14-font="CourierBold"/>
- <afp-raster-font size="12" characterset="C04400B0" base14-font="CourierBold"/>
- <afp-raster-font size="14" characterset="C04400D0" base14-font="CourierBold"/>
- <afp-raster-font size="16" characterset="C04400F0" base14-font="CourierBold"/>
- <afp-raster-font size="18" characterset="C04400H0" base14-font="CourierBold"/>
- <afp-raster-font size="20" characterset="C04400J0" base14-font="CourierBold"/>
- <afp-raster-font size="24" characterset="C04400N0" base14-font="CourierBold"/>
- <afp-raster-font size="30" characterset="C04400T0" base14-font="CourierBold"/>
- <afp-raster-font size="36" characterset="C04400Z0" base14-font="CourierBold"/>
- </afp-font>
- <font-triplet name="Courier" style="normal" weight="bold"/>
- <font-triplet name="monospace" style="normal" weight="bold"/>
- </font>
-
- <!-- Courier Italic Bold -->
- <font>
- <afp-font name="Courier Italic Bold" type="raster" codepage="T1V10500" encoding="Cp500">
- <afp-raster-font size="6" characterset="C0450060" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="7" characterset="C0450070" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="8" characterset="C0450080" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="9" characterset="C0450090" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="10" characterset="C0450000" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="11" characterset="C04500A0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="12" characterset="C04500B0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="14" characterset="C04500D0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="16" characterset="C04500F0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="18" characterset="C04500H0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="20" characterset="C04500J0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="24" characterset="C04500N0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="30" characterset="C04500T0" base14-font="CourierBoldOblique"/>
- <afp-raster-font size="36" characterset="C04500Z0" base14-font="CourierBoldOblique"/>
- </afp-font>
- <font-triplet name="Courier" style="italic" weight="bold"/>
- <font-triplet name="monospace" style="italic" weight="bold"/>
- </font>
-
- <!--
- Configure double-byte (CID Keyed font (Type 0)) AFP fonts with type="CIDKeyed".
-
- example:
- <font>
- <afp-font type="CIDKeyed" encoding="UnicodeBigUnmarked"
- codepage="T1120000" characterset="CZJHMNU"
- base-uri="fonts" />
- <font-triplet name="J-Heisei Mincho" style="normal" weight="normal" />
- </font>
- -->
-
-
- </fonts>
- </renderer>
-
- <renderer mime="application/postscript">
- <!-- This option forces the PS renderer to rotate landscape pages -->
- <!--auto-rotate-landscape>true</auto-rotate-landscape-->
-
- <!-- This option lets you specify additional options on an XML handler -->
- <!--xml-handler namespace="http://www.w3.org/2000/svg">
- <stroke-text>false</stroke-text>
- </xml-handler-->
- </renderer>
-
- <renderer mime="application/vnd.hp-PCL">
- </renderer>
-
- <!-- MIF does not have a renderer
- <renderer mime="application/vnd.mif">
- </renderer>
- -->
-
- <renderer mime="image/svg+xml">
- <format type="paginated"/>
- <link value="true"/>
- <strokeText value="true"/>
- </renderer>
-
- <renderer mime="application/awt">
- </renderer>
-
- <renderer mime="image/png">
- <!--transparent-page-background>true</transparent-page-background-->
- </renderer>
-
- <renderer mime="image/tiff">
- <!--transparent-page-background>true</transparent-page-background-->
- <!--compression>CCITT T.6</compression-->
- </renderer>
-
- <renderer mime="text/xml">
- </renderer>
-
- <!-- RTF does not have a renderer
- <renderer mime="text/rtf">
- </renderer>
- -->
-
- </renderers>
-
-</fop>
commit 68c4accf3d5e282310449813bc349f705b7afb90
Author: fell <f.ellenberger at online.de>
Date: Tue Jan 26 10:38:41 2016 +0100
Minor improvements of commit 5b40697
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index bdc2482..d930e29 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -49,13 +49,14 @@
should choose a named report date option such as <emphasis>Today
</emphasis>rather than enter a specific date so it is not necessary to
enter a specific date again in future reports.</para>
+ </tip>
- <para>If you often run a report with a date as at the start or end of an
+ <tip><para>If you often run a report with a date as at the start or end of an
accounting period, set the accounting period start and end dates in
<menuchoice><guimenu>Edit</guimenu><guisubmenu>Preferences</guisubmenu>
<guimenuitem>Accounting Period</guimenuitem></menuchoice> then select
appropriate report date options.
- See <xref linkend="prefs-accounting-period" />
+ See <xref linkend="prefs-accounting-period" />.
</para>
</tip>
@@ -200,13 +201,13 @@
Relative dates allow you to specify dates like <guilabel>Beginning of this year</guilabel> or
<guilabel>Today</guilabel>.</para>
- <para>If you often run a report with a date as at the start or end
+ <tip><para>If you often run a report with a date as at the start or end
of an accounting period, set the accounting period start and end
dates in <menuchoice><guimenu>Edit</guimenu><guisubmenu>
Preferences</guisubmenu><guimenuitem>Accounting Period
</guimenuitem></menuchoice> then select appropriate report date
- options. See <xref linkend="prefs-accounting-period" />
- </para>
+ options. See <xref linkend="prefs-accounting-period" />.</para>
+ </tip>
</listitem>
@@ -246,7 +247,7 @@
<guilabel>Footer</guilabel> and <guilabel>Technicolor</guilabel>.
You can customize each of these from the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Style
Sheets...</guimenuitem></menuchoice> menu item.
- This is described in the Changing Style Sheets section. <xref linkend="change-style"></xref></para>
+ This is described in the <xref linkend="change-style"></xref><!--Changing Style Sheets--> section.</para>
</listitem>
<listitem>
@@ -260,7 +261,7 @@
<para>The default Report Currency is defined in <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem>
- </menuchoice> Reports tab. See <xref linkend="prefs-reports" />
+ </menuchoice> Reports tab. See <xref linkend="prefs-reports" />.
</para>
</listitem>
commit 5b406970927371df9419ede00400ee453d3870b7
Author: Chris Good <chris.good at ozemail.com.au>
Date: Tue Jan 26 09:51:28 2016 +0100
Add links to where common report preferences are set - Bug
649283
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index 0daf5c4..bdc2482 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -21,7 +21,7 @@
<chapter id="Reports">
<title>Reports And Charts</title>
- <note><para>This section is a <quote>work in process</quote>. All of the material has not been reviewed for V2.0.
+ <note><para>This section is a <quote>work in process</quote>. Some of the material has not been reviewed for V2.0.
While it may not be strictly accurate, it is at least a "guide".</para></note>
<sect1 id="report-intro">
@@ -55,6 +55,7 @@
<menuchoice><guimenu>Edit</guimenu><guisubmenu>Preferences</guisubmenu>
<guimenuitem>Accounting Period</guimenuitem></menuchoice> then select
appropriate report date options.
+ See <xref linkend="prefs-accounting-period" />
</para>
</tip>
@@ -198,6 +199,15 @@
(using the date selector), or by selecting a relative date from the menu.
Relative dates allow you to specify dates like <guilabel>Beginning of this year</guilabel> or
<guilabel>Today</guilabel>.</para>
+
+ <para>If you often run a report with a date as at the start or end
+ of an accounting period, set the accounting period start and end
+ dates in <menuchoice><guimenu>Edit</guimenu><guisubmenu>
+ Preferences</guisubmenu><guimenuitem>Accounting Period
+ </guimenuitem></menuchoice> then select appropriate report date
+ options. See <xref linkend="prefs-accounting-period" />
+ </para>
+
</listitem>
<listitem>
@@ -247,6 +257,11 @@
<listitem>
<para>Report Currency: Select the report currency. Generally, values will be
converted to this currency for display.</para>
+
+ <para>The default Report Currency is defined in <menuchoice>
+ <guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem>
+ </menuchoice> Reports tab. See <xref linkend="prefs-reports" />
+ </para>
</listitem>
<listitem>
commit 506fc583e625e46b57e5bf6e2c598c3aec11cf54
Author: Chris Good <chris.good at ozemail.com.au>
Date: Tue Jan 26 08:34:51 2016 +0100
Update instructions for updating quote prices by cron - Bug
639776
diff --git a/help/C/Help_ch_Account-Actions.xml b/help/C/Help_ch_Account-Actions.xml
index f126ed9..293d460 100644
--- a/help/C/Help_ch_Account-Actions.xml
+++ b/help/C/Help_ch_Account-Actions.xml
@@ -444,7 +444,8 @@
another. It’s called often something like <quote>perl-Finance-Quote</quote>.</para></listitem>
<listitem><para><guilabel>Windows:</guilabel> <application>Finance::Quote</application> on Windows requires perl
- to be installed already. If you haven’t done so, you should first install ActivePerl.</para>
+ to be installed already. If you haven’t done so, you should first install ActivePerl, or more recently,
+ Strawberry Perl.</para>
<para>The Windows installer from the <application>&app;</application> home page comes with a small helper program to
install <application>Finance::Quote</application> for you. You can find it in the Start Menu under the <application>&app;</application>
@@ -480,7 +481,9 @@
<note>
<para>If you feel uncomfortable about performing any of these steps, please either email the <application>&app;</application>-user
mailing list (<email>gnucash-user at gnucash.org</email>) for help or come to the <application>&app;</application> IRC channel on
- irc.gnome.org. You can also leave out this step and manually update your stock prices.</para>
+ irc.gnome.org. More information is available on the <application>&app;</application> Wiki FAQ for example
+ <ulink url="http://wiki.gnucash.org/wiki/FAQ#Q:_How_do_I_fix_a_.22system_error.22_or_.22unknown_error.22_when_getting_stock_quotes.3F" />
+ You can also leave out this step and manually update your stock prices.</para>
</note>
</listitem>
@@ -557,7 +560,7 @@
</itemizedlist>
<para>If you wish to update price quotes from the command line, you can do so by
- the following command;</para>
+ the following command:</para>
<para><userinput>gnucash --add-price-quotes <gnucash-file-name></userinput>
</para>
@@ -570,12 +573,18 @@
in the list of recently opened file; the first item, numbered 1, is the name of the currently
open file.</para>
- <para>This can be automated by creating a crontab entry. For example, to update your file every Friday
+ <para>This can be automated in Mac OSX by creating a crontab entry. For example, to update your file every Friday
evening (18:00) after markets close (modify the time accordingly for your time zone), you could add
the following to your personal crontab:</para>
- <para>0 18 * * 5 gnucash --add-price-quotes $HOME/gnucash-filename > /dev/null 2>&1</para>
-
+ <para><userinput>0 18 * * 5 /path/to/gnucash --add-price-quotes /path/to/gnucash-filename > /dev/null 2>&1'</userinput></para>
+
+ <para>For Linux, which needs dbus, usually started by the desktop
+ manager, to communicate with dconf or gconf:</para>
+
+ <para><userinput>0 18 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; /path/to/gnucash
+ --add-price-quotes /path/to/gnucash-filename > /dev/null 2>&1'</userinput></para>
+
<para>Remember that Mutual Fund <quote>prices</quote> are really <quote>Net Asset Value</quote>
and require several hours after the exchange closes before being available. If NAVs are downloaded before
the current days NAVs are determined, yesterday’s NAVs are retrieved.</para>
commit 77011fa2329f28d070d3bd203f6e8fa811a1f0a8
Author: Chris Good <chris.good at ozemail.com.au>
Date: Mon Jan 25 23:47:11 2016 +0100
Explain buttons in Report Options dialog - Bug 649283
Add extra info about running and saving reports
Order reports like the reports menu
Add missing reports
Refer to Charts instead of Graphs
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index 0b40348..0daf5c4 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -21,28 +21,289 @@
<chapter id="Reports">
<title>Reports And Charts</title>
- <note><para>This section is a <quote>work in process</quote> all of the material has not been reviewed for V2.0.
+ <note><para>This section is a <quote>work in process</quote>. All of the material has not been reviewed for V2.0.
While it may not be strictly accurate, it is at least a "guide".</para></note>
+ <sect1 id="report-intro">
+ <title>Introduction</title>
+
<para>Reports and Charts give <application>&app;</application> the ability to present an overview of financial
data in various ways. This can range from a simple summary of account totals to an
advanced portfolio view. This section will present an explanation of the main <application>&app;</application>
reports and how to adjust them.</para>
- <para><application>&app;</application> has classified the main types of reports into four major classes. These
- are all available under the Reports menu.</para>
+ <para>To run a report or chart, click on the <menuchoice><guimenu>Reports
+ </guimenu></menuchoice> menu, then either select
+ a report (it will open with standard options), or click on <guibutton>
+ Saved Report Configuration</guibutton> to select a report you have
+ previously configured and saved.
+ </para>
+
+ <para>Once the report has opened, click on the <guibutton>Options
+ </guibutton> toolbar button to
+ configure the report as needed, for example to set the report date or
+ select accounts.
+ </para>
+
+ <tip><para>If you intend to save a report configuration, you
+ should choose a named report date option such as <emphasis>Today
+ </emphasis>rather than enter a specific date so it is not necessary to
+ enter a specific date again in future reports.</para>
+
+ <para>If you often run a report with a date as at the start or end of an
+ accounting period, set the accounting period start and end dates in
+ <menuchoice><guimenu>Edit</guimenu><guisubmenu>Preferences</guisubmenu>
+ <guimenuitem>Accounting Period</guimenuitem></menuchoice> then select
+ appropriate report date options.
+ </para>
+ </tip>
+
+ <para>After you have configured a report, you can save the configuration for
+ future use by clicking either the <guibutton>Save Report Configuration
+ </guibutton> or <guibutton>Save Report Configuration As...</guibutton>
+ button.
+ </para>
+
+ <sect2 id="report-saving">
+ <title>Saving a Report Configuration</title>
+
+ <para>To save a report configuration for future use, while the required
+ report tab is selected, go to the report options, select the
+ <emphasis>General</emphasis> tab and change the <emphasis>Report Name
+ </emphasis> to a meaningful unique name. Do not confuse this with the
+ <emphasis>Report Title</emphasis> which prints at the top of a report.
+ </para>
+
+ <para>Click the <guibutton>Save Report Configuration</guibutton> or
+ <guibutton>Save Report Configuration As...</guibutton> button. This will
+ store your customized report options in a file in your home directory.
+ E.g. Linux: <emphasis>~/.gnucash/saved-reports-[versioninfo]</emphasis>
+ </para>
+
+ <para>The first time you save a report with a name that has not already
+ been saved, you can use either the <guibutton>Save Report Configuration
+ </guibutton> or the <guibutton>Save Report Configuration As...
+ </guibutton> button. You can modify the report name before saving it.
+ </para>
+
+ <para>After a report configuration for a specific name has been saved, the
+ <guibutton>Save Report Configuration</guibutton> button will immediately
+ update the saved report configuration without giving the opportunity to
+ save the configuration with a new name. Use the <guibutton>Save Report
+ Configuration As...</guibutton> button to save the current report
+ configuration with a new name.
+ </para>
+
+ <para>After your customized report has been saved, it is available for use
+ by the <menuchoice><guimenu>Reports</guimenu><guimenuitem>Saved Report
+ Configurations</guimenuitem></menuchoice> menu and it will also be listed
+ when starting <menuchoice><guimenu>Reports</guimenu><guisubmenu>Sample
+ & Custom</guisubmenu><guimenuitem>Custom Multicolumn Report
+ </guimenuitem></menuchoice>.
+ </para>
+
+ </sect2>
+
+ <sect2 id="report-working">
+ <title>Working with Saved Report Configurations</title>
+
+ <para>Selecting <menuchoice><guimenu>Reports</guimenu><guimenuitem>Saved
+ Report Configurations</guimenuitem></menuchoice> will open a dialog
+ window with a list of the <emphasis>Saved Report Configurations
+ </emphasis> you have previously created. In this
+ context <emphasis>Saved Report Configurations</emphasis> means the set of
+ customized settings for standard reports.
+ </para>
+
+ <para>The <emphasis>Saved Report Configurations</emphasis> window lists
+ each of your previously saved report configurations, and 3 small buttons
+ at the end of each. These buttons perform the following actions
+ </para>
+
+ <itemizedlist>
+ <listitem><para>Load (and run) report configuration. Double clicking a
+ report configuration also performs this action.</para>
+ </listitem>
+
+ <listitem><para>Edit report configuration name. This enables a report
+ configuration to be renamed.</para>
+ </listitem>
+
+ <listitem><para>Delete report configuration.</para>
+ </listitem>
+
+ </itemizedlist>
+
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="report-config">
+ <title>Configuring Reports and Charts</title>
+
+ <para><application>&app;</application> reports have many configuration
+ options. First, run the original report itself. Then,
+ access the report options with the <guibutton>Options</guibutton>
+ button on the toolbar.</para>
+
+ <note> <para>Check changed Graphic Engine Options</para></note>
+
+ <sect2 id="report-opt-btns">
+ <title>Report Options Buttons</title>
+
+ <para>After modifying report options, either</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Click the <guibutton>OK</guibutton> button to apply the changes,
+ regenerate the report and
+ close the options window.</para>
+
+ <para>or</para>
+ </listitem>
+
+ <listitem>
+ <para>Click the <guibutton>Apply</guibutton> button to apply the
+ changes, regenerate the report and leave the options window open for
+ possible further changes. In this case, both the <guibutton>Apply
+ </guibutton> and <guibutton>OK</guibutton> buttons will be disabled,
+ indicating changes have been applied, until further changes are made.
+ </para>
+
+ <para>or</para>
+ </listitem>
+
+ <listitem>
+ <para>Click the <guibutton>Cancel</guibutton> button to close the
+ options window without applying any unapplied changes.</para>
+ </listitem>
+ </itemizedlist>
+
+ </sect2>
+
+ <sect2 id="report-common">
+ <title>Common Report Options</title>
+
+ <para>Many reports share similar options. Some common ones include:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Report Name: Set the title of the report. This is also used to print the
+ report for later viewing.</para>
+ </listitem>
+
+ <listitem>
+ <para>Date Options: Reports typically specify either a single date, or a date
+ range, for the report. Dates can be specified in two ways, either directly
+ (using the date selector), or by selecting a relative date from the menu.
+ Relative dates allow you to specify dates like <guilabel>Beginning of this year</guilabel> or
+ <guilabel>Today</guilabel>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Step Size: This option is used on bar charts to determine the interval which
+ each bar represents. Typical values are daily, weekly, monthly, and yearly.</para>
+ </listitem>
+
+ <listitem>
+ <para>Accounts: Select the appropriate accounts for the report. Note that in some
+ reports only certain types of accounts can be selected. For example, an expense
+ piechart only allows expense accounts to be selected. </para>
+ </listitem>
+
+ <listitem>
+ <para>Show Long Account Names: This option allows displaying either short account
+ names (for example, Power) or long account names (for example, Utilities:Power).
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Include Subaccounts?: Summary reports typically have an include all
+ subaccounts option, which if selected ensures that all subaccounts are included
+ if the parent account is.</para>
+ </listitem>
+
+ <listitem>
+ <para>Depth: This option allows the selection of how many levels the report
+ displays subaccounts. If the subaccounts go deeper than selected, an overall value
+ for all the subaccounts is calculated and included in a total. To make sure every
+ account selected is individually displayed, select <guibutton>All</guibutton>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Style Sheet: Select a Style Sheet. Style sheets control how reports are
+ displayed. At the moment, there are four style sheets: <guilabel>Default</guilabel>, <guilabel>Easy</guilabel>,
+ <guilabel>Footer</guilabel> and <guilabel>Technicolor</guilabel>.
+ You can customize each of these from the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Style
+ Sheets...</guimenuitem></menuchoice> menu item.
+ This is described in the Changing Style Sheets section. <xref linkend="change-style"></xref></para>
+ </listitem>
+
+ <listitem>
+ <para>Plot Dimensions: There are width and height options for most charts, which
+ specify the displayed dimensions (in pixels).</para>
+ </listitem>
+
+ <listitem>
+ <para>Report Currency: Select the report currency. Generally, values will be
+ converted to this currency for display.</para>
+ </listitem>
+
+ <listitem>
+ <para>Price Source: Select how stock and currency prices are calculated in this
+ report. Choose between a weighted average of prices over all transactions, prices
+ at current values, or prices at the time of the report date.</para>
+ </listitem>
- <sect1 id="report-general">
+ <listitem>
+ <para>Totals: Charts display totals in the chart legend if this option is selected.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Maximum Slices: Controls the maximum number of slices displayed in a
+ piechart - other accounts will be placed in a slice marked Other. </para>
+ </listitem>
+
+ <listitem>
+ <para>Maximum Bars: Controls the maximum number of bars displayed in a barchart.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Display Columns: Choose columns to show from the register.</para>
+ </listitem>
+ </itemizedlist>
+
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="report-classes">
+ <title>Reports Listed By Class</title>
+
+ <para><application>&app;</application> has classified the main types of
+ reports into major classes. These
+ are all available under the Reports menu.</para>
+
+ <sect2 id="report-general">
<title>General Reports</title>
- <para>The General Reports include the Account Summary Report, Custom Reports, the Tax Schedule Report and <acronym>TXF</acronym> Export, and the Transaction Report and also the reports in the Sample & Custom menu.</para>
+ <para>The General Reports include the Account Summary Report, the Future
+ Scheduled Transactions Summary, the Tax Schedule Report and <acronym>
+ TXF</acronym> Export, and the Transaction Report and also the reports in the Sample & Custom menu.</para>
- <sect2>
+ <sect3>
<title>Account Summary</title>
<para> </para>
- </sect2>
+ </sect3>
+
+ <sect3>
+ <title>Future Scheduled Transactions Summary</title>
+ <para> </para>
+ </sect3>
- <sect2 id="report-taxreport">
+ <sect3 id="report-taxreport">
<title>Tax Schedule Report and <acronym>TXF</acronym> Export</title>
<para>The tax schedule report lists all taxable income and deductible expense amounts used in the preparation of US Income Tax returns. The purpose of the report is to provide a complete audit trail for these amounts. The report is intended to be used by a tax payer to manually prepare his or her own tax return, or alternatively, to be provided to a tax preparer for that purpose. The report can also be used to generate an export of all tax related income and expenses to a <acronym>TXF</acronym> (Tax eXchange Format) file (this is in addition to exporting to the <acronym>HTML</acronym> format that all reports allow). The <acronym>TXF</acronym> file can be imported into tax filing programs such as TaxCut or TurboTax. The report should be run, inspected carefully for errors or omissions, and then corrections made to transactions, report settings, currency conversion rates or the account structure as needed. This process should be repeated as often as needed until all the amounts on the report are correct before a final version is used and saved along with the tax returns.</para>
@@ -57,16 +318,16 @@
also must set the <acronym>TXF</acronym> category of each tax related account. The Income Tax
Information dialog is described in the <xref linkend="set-tax-options"></xref> section.</para></note>
- </sect2>
+ </sect3>
- <sect2>
+ <sect3>
<title>Transaction Report</title>
<para>This report lists transactions in selected accounts during a specified financial period. Two fields may be optionally
used for sorting and totalling.
</para>
- <sect3 id="report-txrpt-opts">
+ <sect4 id="report-txrpt-opts">
<title>Report Options</title>
<figure>
@@ -332,9 +593,9 @@
</itemizedlist>
</listitem>
</itemizedlist>
- </sect3>
+ </sect4>
- <sect3 id="report-txrpt-splits">
+ <sect4 id="report-txrpt-splits">
<title>Displaying Split Account Details</title>
<para>This is controled by the <emphasis>Style</emphasis> option on the General tab.</para>
<note>
@@ -415,38 +676,17 @@
<para><emphasis>Use Full Other Account Name</emphasis> has no effect in <emphasis>Multi-Line</emphasis> mode.</para>
- </sect3>
-
- </sect2>
-
- <sect2>
- <title>Welcome Sample Report</title>
- <para> </para>
- </sect2>
-
- <sect2>
- <title>Custom Multicolumn Report</title>
- <para>This report is used to place multiple reports
- into a single report window to examine a set of financial information at a glance.
- </para>
- </sect2>
-
- <sect2>
- <title>Sample Graphs</title>
- <para> </para>
- </sect2>
+ </sect4>
- <sect2>
- <title>Sample Report with Examples</title>
- <para> </para>
- </sect2>
-
- </sect1>
+ </sect3>
+
+ </sect2>
- <sect1 id="report-assets">
+ <sect2 id="report-assets">
<title>Assets & Liabilities</title>
- <para>The Assets & Liabilities reports includes the Balance Sheet report, Investment reports and the Net Worth report.</para>
+ <para>The Assets & Liabilities reports includes the Balance Sheet
+ report, Investment reports and the Net Worth report.</para>
<itemizedlist>
@@ -535,7 +775,7 @@
</itemizedlist>
- <para>Common report options are described in <xref linkend="report-custom"/></para>
+ <para>Common report options are described in <xref linkend="report-config"/></para>
<para>Report Specific Options</para>
@@ -679,7 +919,7 @@
</listitem>
<listitem>
- <para>General Journal:</para>
+ <para>Balance Sheet using eguile-gnc:</para>
</listitem>
<listitem>
@@ -687,6 +927,10 @@
</listitem>
<listitem>
+ <para>General Ledger:</para>
+ </listitem>
+
+ <listitem>
<para>Investment Portfolio: This report summarizes the value of the stocks in
the current portfolio.</para>
</listitem>
@@ -713,67 +957,10 @@
<para>Price Scatterplot:</para>
</listitem>
</itemizedlist>
- </sect1>
-
- <sect1 id="report-income">
- <title>Income & Expense</title>
-
- <para>The Income & Expense reports includes the Cash Flow and Income Statement reports.</para>
-
- <itemizedlist>
- <listitem>
- <para>Budget Report:</para>
- </listitem>
-
- <listitem>
- <para>Cash Flow:</para>
- </listitem>
-
- <listitem>
- <para>Equity Statement:</para>
- </listitem>
-
- <listitem>
- <para>Expense Barchart:</para>
- </listitem>
-
- <listitem>
- <para>Expense Piechart:</para>
- </listitem>
-
- <listitem>
- <para>Expense vs Day of Week:</para>
- </listitem>
-
- <listitem>
- <para>Income Barchart:</para>
- </listitem>
- <listitem>
- <para>Income & Expense Chart:</para>
- </listitem>
+ </sect2>
- <listitem>
- <para>Income Statement: This report summarizes sources of income and expenditure.
- (This report was called Profit & Loss in gnucash-1.8.)</para>
- </listitem>
-
- <listitem>
- <para>Income Statement:</para>
- </listitem>
-
- <listitem>
- <para>Income vs Day of Week:</para>
- </listitem>
-
- <listitem>
- <para>Trial Balance: This report summarizes sources of income and expenditure.</para>
- </listitem>
- </itemizedlist>
-
- </sect1>
-
- <sect1 id="report-biz">
+ <sect2 id="report-biz">
<title>Business Reports</title>
<para>The Business Reports includes Customer and Vendor Reports and Printable
@@ -785,6 +972,10 @@
</listitem>
<listitem>
+ <para>Customer Summary:</para>
+ </listitem>
+
+ <listitem>
<para>Easy Invoice:</para>
</listitem>
@@ -797,6 +988,10 @@
</listitem>
<listitem>
+ <para>Job Report:</para>
+ </listitem>
+
+ <listitem>
<para>Payable Aging:</para>
</listitem>
@@ -809,123 +1004,169 @@
</listitem>
<listitem>
+ <para>Tax Invoice:</para>
+ </listitem>
+
+ <listitem>
<para>Vendor Report:</para>
</listitem>
</itemizedlist>
- </sect1>
-
- <sect1 id="report-custom">
- <title>Customizing Reports and Graphs</title>
+ </sect2>
- <para><application>&app;</application> reports have many options
- for customization. First, run the original report itself. Then,
- access the report options with the <guibutton>Options</guibutton>
- button on the toolbar.</para>
+ <sect2 id="report-income">
+ <title>Income & Expense</title>
- <note> <para>Check changed Graphic Engine Options and describe Saving Customized Reports</para></note>
-<!--
- suggest how to save report options E.g. Choose definite options when you
- want to see an Income Statement, so you want to save them for future and
- not to choose all the time.
+ <para>The Income & Expense reports includes the Cash Flow and Income Statement reports.</para>
- File -> Add Report (in 2.0.5).
- But first, you must change the title of the report in the options. -->
+ <itemizedlist>
+ <listitem>
+ <para>Cash Flow:</para>
+ </listitem>
- <para>Many reports share similar sorts of options. Some common ones include:</para>
+ <listitem>
+ <para>Equity Statement:</para>
+ </listitem>
- <itemizedlist>
- <listitem>
- <para>Report Name: Set the title of the report. This is also used to print the
- report for later viewing.</para>
- </listitem>
+ <listitem>
+ <para>Expense Barchart:</para>
+ </listitem>
- <listitem>
- <para>Date Options: Reports typically specify either a single date, or a date
- range, for the report. Dates can be specified in two ways, either directly
- (using the date selector), or by selecting a relative date from the menu.
- Relative dates allow you to specify dates like <guilabel>Beginning of this year</guilabel> or
- <guilabel>Today</guilabel>.</para>
- </listitem>
+ <listitem>
+ <para>Expense Piechart:</para>
+ </listitem>
- <listitem>
- <para>Step Size: This option is used on bar charts to determine the interval which
- each bar represents. Typical values are daily, weekly, monthly, and yearly.</para>
- </listitem>
+ <listitem>
+ <para>Expense vs Day of Week:</para>
+ </listitem>
- <listitem>
- <para>Accounts: Select the appropriate accounts for the report. Note that in some
- reports only certain types of accounts can be selected. For example, an expense
- piechart only allows expense accounts to be selected. </para>
- </listitem>
+ <listitem>
+ <para>Income & Expense Chart:</para>
+ </listitem>
- <listitem>
- <para>Show Long Account Names: This option allows displaying either short account
- names (for example, Power) or long account names (for example, Utilities:Power).
- </para>
- </listitem>
+ <listitem>
+ <para>Income Barchart:</para>
+ </listitem>
- <listitem>
- <para>Include Subaccounts?: Summary reports typically have an include all
- subaccounts option, which if selected ensures that all subaccounts are included
- if the parent account is.</para>
- </listitem>
+ <listitem>
+ <para>Income Piechart:</para>
+ </listitem>
- <listitem>
- <para>Depth: This option allows the selection of how many levels the report
- displays subaccounts. If the subaccounts go deeper than selected, an overall value
- for all the subaccounts is calculated and included in a total. To make sure every
- account selected is individually displayed, select <guibutton>All</guibutton>.</para>
- </listitem>
+ <listitem>
+ <para>Income Statement: This report summarizes sources of income and expenditure.
+ (This report was called Profit & Loss in gnucash-1.8.)</para>
+ </listitem>
- <listitem>
- <para>Style Sheet: Select a Style Sheet. Style sheets control how reports are
- displayed. At the moment, there are four style sheets: <guilabel>Default</guilabel>, <guilabel>Easy</guilabel>,
- <guilabel>Footer</guilabel> and <guilabel>Technicolor</guilabel>.
- You can customize each of these from the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Style
- Sheets...</guimenuitem></menuchoice> menu item.
- This is described in the Changing Style Sheets section. <xref linkend="change-style"></xref></para>
- </listitem>
+ <listitem>
+ <para>Income vs Day of Week:</para>
+ </listitem>
- <listitem>
- <para>Plot Dimensions: There are width and height options for most graphs, which
- specify the displayed dimensions (in pixels).</para>
- </listitem>
+ <listitem>
+ <para>Profit & Loss: This is the same report as the Income Statement but with a different title.</para>
+ </listitem>
- <listitem>
- <para>Report Currency: Select the report currency. Generally, values will be
- converted to this currency for display.</para>
- </listitem>
+ <listitem>
+ <para>Trial Balance: This report summarizes sources of income and expenditure.</para>
+ </listitem>
+ </itemizedlist>
- <listitem>
- <para>Price Source: Select how stock and currency prices are calculated in this
- report. Choose between a weighted average of prices over all transactions, prices
- at current values, or prices at the time of the report date.</para>
- </listitem>
+ </sect2>
+
+ <sect2 id="report-sample">
+ <title>Sample & Custom</title>
- <listitem>
- <para>Totals: Charts display totals in the chart legend if this option is selected.
- </para>
- </listitem>
+ <sect3>
+ <title>Welcome Sample Report</title>
+ <para> </para>
+ </sect3>
- <listitem>
- <para>Maximum Slices: Controls the maximum number of slices displayed in a
- piechart - other accounts will be placed in a slice marked Other. </para>
- </listitem>
+ <sect3>
+ <title>Custom Multicolumn Report</title>
+ <para>This report is used to place multiple reports
+ into a single report window to examine a set of financial information at a glance.
+ </para>
+ </sect3>
- <listitem>
- <para>Maximum Bars: Controls the maximum number of bars displayed in a barchart.
- </para>
- </listitem>
+ <sect3>
+ <title>Sample Report with Examples</title>
+ <para> </para>
+ </sect3>
- <listitem>
- <para>Display Columns: Choose columns to show from the register.</para>
- </listitem>
- </itemizedlist>
- </sect1>
+ </sect2>
+ <sect2 id="report-budget">
+ <title>Budget</title>
+
+ <sect3>
+ <title>Budget Balance Sheet</title>
+ <para> </para>
+ </sect3>
+
+ <sect3>
+ <title>Budget Barchart</title>
+ <para> </para>
+ </sect3>
+
+ <sect3>
+ <title>Budget Flow</title>
+ <para> </para>
+ </sect3>
+
+ <sect3>
+ <title>Budget Income Statement</title>
+ <para> </para>
+ </sect3>
+
+ <sect3>
+ <title>Budget Profit & Loss</title>
+ <para> </para>
+ </sect3>
+
+ <sect3>
+ <title>Budget Report</title>
+ <para>This report is used to compare budgeted and real amounts for selected accounts. It allows you to review how well you follow the budget.</para>
+ <para>The report is generated as a table in which each row represents an account and each set of columns shows the <emphasis>budgeted amount</emphasis>, the <emphasis>real amount</emphasis>, and the <emphasis>difference</emphasis> between them for each report period.</para>
+ <para>Each entry in the <emphasis>real amount</emphasis> column is the sum of all the splits in the row's account over the column's period. For example, if the report is set up for monthly periods, the column is for May, and the row is for Expences:Groceries, then the value will be the sum of all Expenses:Groceries splits for that May.</para>
+ <para>The report supports selecting a range of periods instead all of them. Periods that are out of range can be included in report as the consolidated columns around the selected range. This allows you to focus on particular periods, for example the current one, and is especially useful for budgets with many periods. For example, if you have a 12 period budget you can make a 3 column report with the format "(all periods before columns set) (current period columns set) (all periods after columns set)" that is easily fits on the screen and allows you to match values with account names.</para>
+ <para><emphasis>Budget report options</emphasis></para>
+ <para>
+ <note><para>Here we describe only options that are specific for the Budget Report. You can find information about standard parameters in <xref linkend="report-config"/>.</para> </note>
+ <itemizedlist>
+ <listitem><para><emphasis>Show budget</emphasis> - include the budgeted values for the period</para></listitem>
+ <listitem><para><emphasis>Show actual</emphasis> - include the real values for the period</para></listitem>
+ <listitem><para><emphasis>Show difference</emphasis> - include the difference between budgeted and real values for the period. Enabling this option does not force including budgeted and actual values in report</para></listitem>
+ <listitem><para><emphasis>Show Column with totals</emphasis> - Adds a final column set containing budgeted, real value, and difference columns summing those values across all periods of the report.</para></listitem>
+ <listitem><para><emphasis>Rollup budget amounts to parent</emphasis> - not used in report, can be deleted or should be fixed</para></listitem>
+ <listitem><para><emphasis>Include accounts with zero total balances and budget values</emphasis> - enables display of accounts with no budget or splits in any period.</para></listitem>
+ <listitem><para><emphasis>Budget</emphasis> - Select the budget to use for report generation</para></listitem>
+ <listitem><para><emphasis>Report for range of budget periods</emphasis> - Enables reporting on a subset of the budget by selecting a beginning and an ending period.</para></listitem>
+ <listitem><para><emphasis>Range start</emphasis> - a combobox with a list of variants how to select start period:
+ <orderedlist>
+ <listitem><para><emphasis>First</emphasis> - select first budget period</para></listitem>
+ <listitem><para><emphasis>Previous</emphasis> - select previous period.</para></listitem>
+ <listitem><para><emphasis>Current</emphasis> - select current period.</para></listitem>
+ <listitem><para><emphasis>Next</emphasis> - select next period.</para></listitem>
+ <listitem><para><emphasis>Last</emphasis> - select last budget period</para></listitem>
+ <listitem><para><emphasis>Manual</emphasis> - enables spinbox where you can select exact period</para></listitem>
+ </orderedlist></para>
+ <note><para>The <emphasis>current</emphasis>, <emphasis>previous</emphasis>, and <emphasis>next</emphasis> options select the period based on the date on which the report is run, with <emphasis>current</emphasis> being the period in which the date falls, <emphasis>previous</emphasis> being the one before that, and <emphasis>next</emphasis> the period after. If the current date falls outside the date range covered by the budget, the <emphasis>first</emphasis> or <emphasis>last</emphasis> period will be used as appropriate.</para></note>
+ </listitem>
+ <listitem><para><emphasis>Exact start period</emphasis> - options for select exact start period, enabled only if range start option is set to <emphasis>Manual</emphasis></para></listitem>
+ <listitem><para><emphasis>Range end</emphasis> - a combobox with a list of variants how to select end period. Values are the same as in <emphasis>Range start</emphasis> options</para></listitem>
+ <listitem><para><emphasis>Exact end period</emphasis> - the same as <emphasis>Exact start period</emphasis> but for the end of range</para></listitem>
+ <listitem><para><emphasis>Include collapsed periods before selected</emphasis> - if on, then includes in report all budget periods, that are before selected period range, as a single consolidated column set</para></listitem>
+ <listitem><para><emphasis>Include collapsed periods after selected</emphasis> - if on, then includes in report all budget periods, that are after selected period range, as a single consolidated column set.</para></listitem>
+ </itemizedlist>
+ </para>
+
+ </sect3>
+
+ </sect2>
+
+ </sect1>
+
<sect1 id="report-print">
- <title>Printing or Exporting Reports and Graphs</title>
+ <title>Printing or Exporting Reports and Charts</title>
<note><para> Verify !!! How customize printing with Gnome?</para></note>
@@ -933,7 +1174,8 @@
Print <application>&app;</application> Document dialog is accessed from the <guibutton>Print</guibutton> button on the <emphasis>Toolbar</emphasis> or
go to <menuchoice><guimenu>File</guimenu><guimenuitem>Print</guimenuitem></menuchoice> in the menu. To Export a report to a web page (<acronym>HTML</acronym>) select
the <guibutton>Export</guibutton> button on the <emphasis>Toolbar</emphasis> and type in a file name.</para>
-
+
+ <para>Most reports, being presented in HTML, can also be copied and pasted into a spreadsheet.</para>
<para>The Print <application>&app;</application> Document dialog is used to select which Printer to send the
print job to or to print to a File. It also contains a Preview button to view the
@@ -947,7 +1189,7 @@
</sect1>
<sect1 id="report-create">
- <title>Creating Reports and Graphs</title>
+ <title>Creating Reports and Charts</title>
<note><para>This section may need updating !!!</para> </note>
Summary of changes:
README | 2 +-
help/C/Help_ch_Account-Actions.xml | 21 +-
help/C/Help_ch_Business.xml | 14 +-
help/C/Help_ch_Customize.xml | 6 +-
help/C/Help_ch_Reports.xml | 682 ++++++++++++++++++++++++-------------
5 files changed, 485 insertions(+), 240 deletions(-)
More information about the gnucash-changes
mailing list