<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter SYSTEM "gnc-gui-de.dtd">
<!-- (Do not remove this comment block.)
  Version: 5.1
  Last modified: January 20th 2017
       modified: December 7th 2009
       modified: May 13th 2007
       modified: November 28th 2006
       modified: August 12th 2006
       modified: February 28th 2005
  Maintainers:
    Alex Aycinena <alex.aycinena@gmail.com>
    Chris Lyttle <chris@wilddev.net>
    Neil Williams <linux@codehelp.co.uk>
  Author:
    Chris Lyttle <chris@wilddev.net>
  Translators:
    Christian Wehling <christian.wehling@web.de>
-->
<chapter id="Reports">
  <title>Berichte und Diagramme</title>

  <abstract>
    <para>Berichte und Diagramme geben &app; die Möglichkeit, einen Überblick über Finanzdaten auf
      verschiedene Weise zu präsentieren. Dies kann von einer einfachen Zusammenfassung der
      Kontosummen bis hin zu einer erweiterten Portfolioansicht reichen. In diesem Kapitel werden
      die wichtigsten &app;-Berichte erläutert und wie sie für Ihre Zwecke angepasst werden
      können.
    </para>
  </abstract>

  <sect1 id="report-intro">
    <title>Einführung</title>

    <para>Um einen Bericht aufzurufen oder ein grafisches Diagramm auszuführen, wählen Sie im Menü &gm.rep;
      entweder einen vorgefertigten Bericht aus, oder klicken Sie auf &mc.rep.saved-rep-conf;, um
      einen Bericht auszuwählen, den Sie zuvor konfiguriert und gespeichert haben.
    </para>

    <para>Sobald der Bericht geöffnet ist, klicken Sie in der <emphasis>Werkzeugleiste</emphasis> auf die
      Schaltfläche <guibutton>Optionen</guibutton>, um den Bericht an Ihre Anforderungen
      anzupassen, zum Beispiel um das Berichtsdatum festzulegen oder Konten auszuwählen.
    </para>

    <tip>
      <para>Werden Sie bei den vorgefertigten Berichten nicht fündig, können Sie möglicherweise mit Hilfe von
        &mc.ed.find; den <xref linkend="tool-find-txn" />-Assistenten verwenden, der Ihnen dabei
        hilft, eine Reihe von Buchungen auszuwählen. Diese können Sie dann mit &mc.rep.acct-rep;
        auswerten. Eine weitere Formatierung oder Analyse kann durch Kopieren und Einfügen des
        Berichts in eine Tabellenkalkulation erfolgen.
      </para>
    </tip>

    <sect2 id="report-saving">
      <title>Speichern einer Berichtskonfiguration</title>

      <para>Um die Konfiguration eines Berichtes für eine künftige Verwendung zu speichern, gehen Sie bei
        geöffnetem Bericht im Menü zu &mc.ed.rep-opt;, wählen die Registerkarte
        <guilabel>Allgemein</guilabel> und ändern den <guilabel>Berichtsname</guilabel> in einen
        aussagekräftigen, eindeutigen Namen. Verwechseln Sie dies nicht mit dem
        <guilabel>Berichtstitel</guilabel>, der am Anfang eines Berichts gedruckt wird.
      </para>

      <para>Mit den Menüeinträgen &mc.rep.save-conf; und &mc.rep.save-conf-as; können Sie Ihre angepassten
        Berichtsoptionen in einer Datei unterhalb Ihres Home-Verzeichnis speichern.
<!-- FIXME by adding the content of the wiki page 'Configuration Locations' to the manual e.g. appendix -->
        Der genaue Speicherort hängt von Ihrem Betriebssystem, der &app;-Version und der
        Berichtsversion ab. Die Details sind im &app;-Wiki unter
        <ulink url="&url-wiki;Configuration_Locations#GNC_DATA_HOME">GNC_DATA_HOME</ulink>
        beschrieben. Die Konfigurationen Ihrer Berichte sind in der Datei
        <filename>GNC_DATA_HOME/saved-reports-<replaceable>version</replaceable> </filename>
        gespeichert.
      </para>

      <para>Nachdem Sie eine Berichtskonfiguration gespeichert haben, und an den Berichtsoptionen noch weitere
        Anpassungen vorgenommen haben, können Sie die Änderungen mit dem Befehl &mc.rep.save-conf;
        speichern. Möchten Sie die Berichtskonfiguration unter einen neuen Namen speichern,
        verwenden Sie stattdessen den Menüeintrag &mc.rep.save-conf-as;.
      </para>

      <para>Ihr benutzerdefinierter Bericht steht im Menü unter &mc.rep.saved-rep-conf; zur Verfügung, und
        kann auch in einem &mc.rep.mul-col.cus-mul-col; eingebunden werden.
      </para>
    </sect2>

    <sect2 id="report-working">
      <title>Arbeiten mit gespeicherten Berichtskonfigurationen</title>

      <para>Die Auswahl von &mc.rep.saved-rep-conf; öffnet ein Dialogfenster mit einer Liste Ihrer
        <emphasis>Gespeicherten Berichtskonfigurationen</emphasis>. <emphasis>Gespeicherte
        Berichtskonfigurationen</emphasis> bedeutet in diesem Zusammenhang die Menge der
        benutzerdefinierten Einstellungen für Standardberichte.
      </para>

      <figure pgwide="1">
        <title>Gespeicherte Berichtskonfigurationen</title>

        <screenshot>
          <screeninfo>630x376</screeninfo>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/Report_Saved_Config.png" srccredit="Christian Wehling" />
            </imageobject>
          </mediaobject>
        </screenshot>
      </figure>

      <para>Das Fenster <emphasis>Gespeicherte Berichtskonfigurationen</emphasis> listet jede Ihrer
        gespeicherten Berichtskonfigurationen und weist jeweils 3 kleine Schaltflächen am Ende
        jeder Zeile auf, mit deren Hilfe Sie diese Aktionen für die markierte Berichtskonfiguration
        durchführen Können:
      </para>

      <itemizedlist>
        <listitem>
          <para>Laden (und Ausführen) der Berichtskonfiguration. Ein Doppelklick auf einen Eintrag in der Liste
            führt ebenfalls diese Aktion aus.
          </para>
        </listitem>

        <listitem>
          <para>Name der Berichtskonfiguration bearbeiten. Damit kann eine Berichtskonfiguration umbenannt werden.
          </para>
        </listitem>

        <listitem>
          <para>Löschen der Berichtskonfiguration.
          </para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>

  <sect1 id="report-config">
    <title>Berichte konfigurieren</title>

    <para>Die in &app; vorhandenen Berichte enthalten viele Möglichkeiten zur Konfiguration, mit denen Sie
      die Berichte an Ihre Bedürfnisse anpassen können. Führen Sie zunächst den Originalbericht
      aus und rufen dann im Menü &mc.ed.rep-opt; den Dialog mit den Berichtsoptionen auf.
    </para>

    <sect2 id="report-opt-btns">
      <title>Schaltflächen für Berichtsoptionen</title>

      <para>Mit Hilfe dieser drei Schaltflächen haben Sie die Möglichkeit die Änderungen anzuwenden und den
        Dialog zu schließen.
      </para>

      <glosslist>
        <glossentry>
          <glossterm>OK</glossterm>
          <glossdef>
            <para>Übernimmt die Änderungen, generiert den Bericht neu und schließt das Optionsfenster.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Anwenden</glossterm>
          <glossdef>
            <para>Mit Betätigen der Schaltfläche <guibutton>Anwenden</guibutton> werden die Änderungen übernommen,
              der Bericht neu generiert und das Optionsfenster bleibt für mögliche weitere
              Anpassungen offen. Die beiden Schaltflächen <guibutton>Anwenden</guibutton> und
              <guibutton>OK</guibutton> werden erst dann erneut aktiv, sobald Sie weitere
              Änderungen vorgenommen haben.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Schließen</glossterm>
          <glossdef>
            <para>Das Optionsfenster wird geschlossen, ohne die zuvor vorgenommenen Änderungen anzuwenden.
            </para>
          </glossdef>
        </glossentry>
      </glosslist>

      <figure pgwide="1">
        <title>Dialog für Berichtsoptionen</title>

        <screenshot>
          <screeninfo>952x532</screeninfo>

          <mediaobject>
            <imageobject role="html">
              <imagedata fileref="figures/Report_Options_Dialog.png" srccredit="Christian Wehling" width="&img-w;" />
            </imageobject>

            <imageobject role="fo">
              <imagedata fileref="figures/Report_Options_Dialog.png" srccredit="Christian Wehling" />
            </imageobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="report-common">
      <title>Gebräuchliche Berichtsoptionen</title>

      <note>
        <para>Da jeder einzelne Bericht eine Vielzahl an unterschiedlichen Optionen beinhaltet, wird hier nur
          beispielhaft auf gängige Einstellmöglichkeiten eingegangen, die bei den meisten
          Berichten genutzt werden.
        </para>
      </note>

      <glosslist>
        <glossentry>
          <glossterm>Berichtsname</glossterm>
          <glossdef>
            <para>Legen Sie den Titel des Berichts fest. Dies wird auch verwendet, um den Bericht zur späteren
              Verwendung zu drucken.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Datumsoptionen</glossterm>
          <glossdef>
            <para>In Berichten wird in der Regel entweder ein einzelnes Datum oder ein Datumsbereich für den Bericht
              angegeben. Datumsangaben können auf zwei Arten festgelegt werden, entweder direkt
              (mit dem Datumsselektor) oder durch Auswahl eines relativen Datums aus der
              Auswahlliste. Mit relativen Datumsangaben können Sie ein Datum z.B. wie
              <guilabel>Anfang dieses Jahres</guilabel> oder <guilabel>Heute</guilabel> angeben.
              <tip>
                <para>Wenn Sie beabsichtigen, eine Berichtskonfiguration zu speichern, sollten Sie in den Berichtsoptionen
                  ein benanntes Datum, wie z. B. <emphasis>Heute</emphasis> wählen, damit bei
                  künftiger Verwendung der Berichte das aktuelle Tagesdatum verwendet wird.
                </para>
              </tip>

              <tip>
                <para>Führen Sie einen Bericht häufig mit einem Datum am Anfang oder Ende einer Buchhaltungsperiode aus,
                  legen Sie das Anfangs- und Enddatum in &mc.ed.pref; auf dem Reiter
                  <guilabel>Buchführungsperioden</guilabel> fest und wählen dann im Bericht die
                  entsprechenden Optionen für das Berichtsdatum. Siehe
                  <xref linkend="prefs-accounting-period" />.
                </para>
              </tip>
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Schrittgröße</glossterm>
          <glossdef>
            <para>Diese Option wird in Balkendiagrammen verwendet, um das Intervall festzulegen, das jeder Balken
              darstellt. Typische Werte sind <quote>Ein Tag</quote>, <quote>Zwei Wochen</quote>,
              <quote>Ein Monat</quote> und <quote>Ein Jahr</quote>.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Konten</glossterm>
          <glossdef>
            <para>Wählen Sie die entsprechenden Konten aus, die in dem Bericht berücksichtigt werden sollen.
              Beachten Sie, dass in einigen Berichten nur bestimmte Arten von Konten ausgewählt
              werden können. So können zum Beispiel in einem Kostendiagramm nur Aufwandskonten
              ausgewählt werden.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Lange Kontennamen anzeigen</glossterm>
          <glossdef>
            <para>Mit dieser Option können Sie entweder kurze Kontonamen (z.B. Miete) oder lange Kontonamen (z.B.
              Aufwendungen:Miete) in den Zwischensummen und Zwischenüberschriften anzeigen.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Unterkonten auswählen</glossterm>
          <glossdef>
            <para>Zusammenfassende Berichte verfügen in der Regel über die Option <guilabel>Unterkonten
              auswählen</guilabel>, die gewährleistet, dass alle Unterkonten im dem Bericht
              einbezogen werden, wenn das übergeordnete Konto ausgewählt ist.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Verschachtelungstiefe Unterkonten</glossterm>
          <glossdef>
            <para>Mit dieser Option können Sie auswählen, auf wie vielen Ebenen der Bericht Unterkonten anzeigt.
              Wenn die Unterkonten tiefer gehen als ausgewählt, wird ein Gesamtwert für alle
              Unterkonten berechnet und in eine Gesamtsumme einbezogen. Um sicherzustellen, dass
              jedes ausgewählte Konto einzeln angezeigt wird, wählen Sie
              <guibutton>Alle</guibutton>.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Stilvorlage</glossterm>
          <glossdef>
            <para>Stilvorlagen steuern die Darstellung von Berichten. Es stehen mehrere Stilvorlagen zur Verfügung:
              <itemizedlist>
                <listitem>
                  <para>CSS-basierte Stilvorlage
                  </para>
                </listitem>

                <listitem>
                  <para>Voreinstellung
                  </para>
                </listitem>

                <listitem>
                  <para>Einfach
                  </para>
                </listitem>

                <listitem>
                  <para>Fußzeile
                  </para>
                </listitem>

                <listitem>
                  <para>Vor- oder Nachspann
                  </para>
                </listitem>

                <listitem>
                  <para>Bunt
                  </para>
                </listitem>
              </itemizedlist>
              Sie können jede dieser Vorlagen aus dem Menü &mc.ed.css; anpassen. Dies wird in
              <xref linkend="change-style" /> beschrieben.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Diagrammgröße</glossterm>
          <glossdef>
            <para>Für Berichte mit grafischen Elementen gibt es die Möglichkeit, die Einstellungen für die
              Diagrammbreite und -höhe anzupassen. Sie können hier eine prozentuale Angabe in
              Bezug auf die Fenstergröße vorgeben, oder die Größe auch fest in Pixeln
              einstellen.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Währung des Berichts</glossterm>
          <glossdef>
            <para>Wählen Sie die Währung, die zur Anzeige des Berichts verwendet werden soll, aus der Liste aus. Im
              Allgemeinen werden die Werte zur Anzeige in diese Währung umgerechnet.
              <tip>
                <para>Die Standard-Berichtswährung wird in &mc.ed.pref; auf dem Reiter <xref linkend="prefs-reports" />
                  definiert.
                </para>
              </tip>
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Preisberechnungsquelle</glossterm>
          <glossdef>
            <para>Wählen Sie aus, wie die Preise für Wertpapiere und Währungen für diesen Bericht ermittelt
              werden. Wählen Sie zwischen:
              <glosslist>
                <glossentry>
                  <glossterm>Am nächsten zum Berichtsdatum</glossterm>
                  <glossdef>
                    <para>(Standard für die meisten Berichte) Ein Preis, der aus der Kursdatenbank für das Datum abgerufen
                      wird, das dem Datum des Berichts am nächsten liegt.
                    </para>
                  </glossdef>
                </glossentry>

                <glossentry>
                  <glossterm>Zuletzt bis zum Berichtsdatum</glossterm>
                  <glossdef>
                    <para>Der Preis aus der Kursdatenbank, der als letzter <emphasis>vor</emphasis> dem Datum des Berichts
                      liegt.
                    </para>
                  </glossdef>
                </glossentry>

                <glossentry>
                  <glossterm>Neuester</glossterm>
                  <glossdef>
                    <para>Der letzte Preis in der Kursdatenbank.
                    </para>
                  </glossdef>
                </glossentry>

                <glossentry>
                  <glossterm>Durchschnittliche Kosten …</glossterm>
                  <glossdef>
                    <para>Der betragsgewichtete <emphasis>Netto</emphasis>-Durchschnitt aus <emphasis>allen</emphasis>
                      Teilbuchungen <emphasis>unabhängig vom Konto</emphasis>.
                      Gewinn-/Verlustbuchungsteile <emphasis>werden</emphasis> in die Berechnung
                      miteinbezogen.
                    </para>
                  </glossdef>
                </glossentry>

                <glossentry>
                  <glossterm>Gewichteter Durchschnitt …</glossterm>
                  <glossdef>
                    <para>Der <emphasis>brutto</emphasis> betragsgewichtete Durchschnittspreis <emphasis>aller</emphasis>
                      Teilbuchungen <emphasis>unabhängig vom Konto</emphasis>.
                      Gewinn-/Verlustbuchungsteile <emphasis>werden nicht</emphasis> in der
                      Berechnung berücksichtigt.
                    </para>
                  </glossdef>
                </glossentry>
              </glosslist>
              Weitere Informationen zu Durchschnittskosten und gewichtetem Durchschnitt finden Sie
              im Kapitel <ulink url="&url-docs-de;guide/chapter_invest.html">Kapitalanlagen</ulink>
              in den &app;-Kurs und Konzepte.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Beträge anzeigen</glossterm>
          <glossdef>
            <para>Wenn diese Option ausgewählt ist, werden Gesamtbeträge in der Legende des Diagramms angezeigt.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Maximale Anzahl Segmente</glossterm>
          <glossdef>
            <para>Steuert die maximale Anzahl der in einem Tortendiagramm angezeigten Segmente - die übrigen Konten
              werden in einem Segment mit der Bezeichnung <emphasis>Andere</emphasis>
              zusammengefasst.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Maximale Anzahl Balken</glossterm>
          <glossdef>
            <para>Steuert die maximale Anzahl der in einem Balkendiagramm angezeigten Balken.
            </para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm>Spalten anzeigen</glossterm>
          <glossdef>
            <para>Wählen Sie die in dem Bericht anzuzeigenden Spalten aus der Auflistung aus. Diese Auswahl kommt
              hauptsächlich bei geschäftlichen Berichten zur Anwendung.
            </para>
          </glossdef>
        </glossentry>
      </glosslist>
    </sect2>
  </sect1>

  <sect1 id="report-classes">
    <title>Reports Listed By Class</title>

    <para>&untranslated;
    </para>

    <para>&app; 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, the Future Scheduled Transactions Summary,
        and the Transaction Report and also the reports in the Sample &amp; Custom menu.
      </para>

      <sect3>
        <title>Account Summary</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Future Scheduled Transactions Summary</title>

        <para></para>
      </sect3>

      <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>

        <sect4 id="report-txrpt-opts">
          <title>Report Options</title>

          <figure>
            <title><emphasis>Transaction Report, Report Options</emphasis></title>

            <screenshot id="TxRptOpt_Screen">
              <mediaobject>
                <imageobject role="html">
                  <imagedata fileref="figures/TxRptOpt_Screen.png"
                     srccredit="Geert Janssens" width="&img-w;"/>
                </imageobject>

                <imageobject role="fo">
                  <imagedata fileref="figures/TxRptOpt_Screen.png"
                     srccredit="Geert Janssens"/>
                </imageobject>

                <caption>
                  <para>This is an image of the <emphasis>Transaction Report, Report Options, Display tab.</emphasis>
                  </para>
                </caption>
              </mediaobject>
            </screenshot>
          </figure>

          <itemizedlist>
            <listitem>
              <para><emphasis>Accounts tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Accounts</guilabel>: Select one or more accounts to be reported.
                  </para>

                  <para>There are 4 buttons to aid account selection
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Select All
                          </entry>

                          <entry>
                            Select all accounts
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Clear All
                          </entry>

                          <entry>
                            Clear the selection and unselect all accounts
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Select Children
                          </entry>

                          <entry>
                            Select all descendants of selected account
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Select Default
                          </entry>

                          <entry>
                            Select the default account selection
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show Hidden Accounts</guilabel>: Show accounts that have been marked hidden.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Filter By</guilabel>: Optionally select accounts to be either included or excluded
                    depending on Filter type
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show Hidden Accounts</guilabel>: Show accounts that have been marked hidden in the Filter
                    By list of accounts
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Filter Type</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            None
                          </entry>

                          <entry>
                            Do not do any filtering
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Include Transactions to/from Filter Accounts
                          </entry>

                          <entry>
                            Include Transactions to/from Filter Accounts only
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Exclude Transactions to/from Filter Accounts
                          </entry>

                          <entry>
                            Exclude Transactions to/from all Filter Accounts
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Reset defaults button</guilabel>: Reset all values to their defaults
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>Display tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Date</guilabel> refers to the 'posted date' i.e. effective date of a transaction.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Reconciled Date</guilabel> refers to the 'date of reconciliation' of a transaction.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Num</guilabel> is commonly used for check numbers.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Description</guilabel> is a description of the transaction
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Memo</guilabel> is the memo field of a transaction. This can be used as a secondary
                    description of a transaction.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Notes</guilabel>: Display the notes if the memo is unavailable
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Account Name</guilabel> will print the account name containing the transaction.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Use Full Account Name</guilabel> if the account name is enabled, this option will display
                    the full account name hierarchy.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Account Code</guilabel> this refers to the 'account code' related to the account.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Detail Level</guilabel>
                    <footnote id='report-fn-v3-dl'>
                      <para>Before &app; 3.0 <emphasis>Detail Level</emphasis> was called <emphasis>Style</emphasis> on the
                        General tab.
                      </para>
                    </footnote>
                    : One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Single
                          </entry>

                          <entry>
                            Display 1 line per transaction,
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Multi-Line
                          </entry>

                          <entry>
                            Display a transaction header and 1 line per split.
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>

                  <para>If <emphasis>Detail Level</emphasis> is <emphasis>Multi-Line</emphasis>, check boxes <emphasis>Other
                    Account Name</emphasis> and <emphasis>Use Full Other Account Name</emphasis> are
                    automatically deselected and disabled, and the <emphasis>Transfer</emphasis>
                    column is not reported.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Other Account Name</guilabel>: For multi-split transactions, this parameter should be
                    unticked. See below for more details.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Use Full Other Account Name</guilabel> will enable display of full corresponding account
                    name.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Other Account Code</guilabel> will enable display of corresponding account code.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Shares</guilabel>: Display number of shares
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Price</guilabel>: Display share prices
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Amount</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            None
                          </entry>

                          <entry>
                            Do not display Amount
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Single
                          </entry>

                          <entry>
                            Single column display
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Double
                          </entry>

                          <entry>
                            Two column display
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Subtotal Table</guilabel> will add a summary table for the various subtotals generated in
                    the report. It lists the same subtotals generated in tabular form.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Running Balance</guilabel> refers to the running balance of the account holding the
                    transaction.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Totals</guilabel> will add a 'Grand Total' line adding all transactions in the report.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Sign Reverses</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Global Preference
                          </entry>

                          <entry>
                            Use reversing option specified in global preference.
                          </entry>
                        </row>

                        <row>
                          <entry>
                            None
                          </entry>

                          <entry>
                            Do not display signs reversed
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Credit Accounts
                          </entry>

                          <entry>
                            Reverse amount display for Liability, Payable, Equity, Credit Card and
                            Income accounts
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Income and Expense
                          </entry>

                          <entry>
                            Reverse amount display for Income and Expense accounts
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Reset defaults button</guilabel> Reset all values to their defaults
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>Filter tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Account Name Filter</guilabel> will include only selected accounts containing the
                    substring. Alternatively, if the next option is checked, the account name filter
                    will be matched according to full POSIX regular expressions.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Use regular expressions for account name filter</guilabel> toggles regular expressions for
                    account name filter.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Transaction Filter</guilabel> will include only transactions which contain this substring
                    in the description, notes, or memo. Alternatively if the next option is checked,
                    the filter will be matched using full POSIX regular expressions.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Use regular expressions for transaction filter</guilabel> toggles regular expressions for
                    the transaction filter.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Reconcile Status</guilabel>
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            All
                          </entry>

                          <entry>
                            Show all transactions
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Unreconciled
                          </entry>

                          <entry>
                            Unreconciled only
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Cleared
                          </entry>

                          <entry>
                            Cleared only
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Reconciled
                          </entry>

                          <entry>
                            Reconciled only
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Void Transactions</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Non-void only
                          </entry>

                          <entry>
                            Show only non-voided transactions
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Void only
                          </entry>

                          <entry>
                            Show only voided transactions
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Both
                          </entry>

                          <entry>
                            Show both and include voided transactions in totals
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Closing transactions</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Excluding closing transactions
                          </entry>

                          <entry>
                            Show only regular transactions
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Show both closing and regular transactions
                          </entry>

                          <entry>
                            Show both regular and closing transactions
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Show closing transactions only
                          </entry>

                          <entry>
                            Show closing transactions only
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Reset defaults button</guilabel>: Reset all values to their defaults
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>General tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Report name</guilabel>: Enter a descriptive name for this report
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Stylesheet</guilabel>: Select Default, Easy, Footer or Technicolor
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Start Date</guilabel>: Enter or select a specific Start Date
                  </para>

                  <para>or select one of the following named start date options which will be used to determine the start
                    date each time the report is run
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Today
                          </entry>

                          <entry>
                            The current date
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of this month
                          </entry>

                          <entry>
                            First day of the current month
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of previous month
                          </entry>

                          <entry>
                            First day of the previous month
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of current quarter
                          </entry>

                          <entry>
                            First day of the current quarterly accounting period
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of previous quarter
                          </entry>

                          <entry>
                            First day of the previous quarterly accounting period
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of this year
                          </entry>

                          <entry>
                            First day of the current calendar year
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of previous year
                          </entry>

                          <entry>
                            First day of the previous calendar year
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Start of accounting period
                          </entry>

                          <entry>
                            First day of the accounting period as defined in the global preferences
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>End Date</guilabel>: Enter or select a specific End Date,
                  </para>

                  <para>or select one of the following named end date options which will be used to determine the end date
                    each time the report is run
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Today
                          </entry>

                          <entry>
                            The current date
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of this month
                          </entry>

                          <entry>
                            Last day of the current month
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of previous month
                          </entry>

                          <entry>
                            Last day of the previous month
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of current quarter
                          </entry>

                          <entry>
                            Last day of the current quarterly accounting period
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of previous quarter
                          </entry>

                          <entry>
                            Last day of the previous quarterly accounting period
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of this year
                          </entry>

                          <entry>
                            Last day of the current calendar year
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of previous year
                          </entry>

                          <entry>
                            Last day of the previous calendar year
                          </entry>
                        </row>

                        <row>
                          <entry>
                            End of accounting period
                          </entry>

                          <entry>
                            Last day of the accounting period as defined in the global preferences
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Detail Level</guilabel><footnoteref linkend='report-fn-v3-dl'/>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Single
                          </entry>

                          <entry>
                            Display 1 line
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Multi-Line
                          </entry>

                          <entry>
                            Display N lines
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Common Currency</guilabel>: Convert all transactions into a common currency
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Report's currency</guilabel>: Select the currency to display values
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show original currency amount</guilabel> Also show original currency amounts
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Table for Exporting</guilabel>: Formats the table for cut &amp; paste exporting with extra
                    cells
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Add options summary</guilabel>: Adds an informative text describing options that were
                    changed by user. This is mainly useful for troubleshooting reports.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Reset defaults button</guilabel>: Reset all values to their defaults
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>Sorting tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Primary Key</guilabel>: Primary Sort Key. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            None
                          </entry>

                          <entry>
                            Do not sort
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Account Name
                          </entry>

                          <entry>
                            Sort and subtotal by account name
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Account Code
                          </entry>

                          <entry>
                            Sort and subtotal by account code
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Date
                          </entry>

                          <entry>
                            Sort by date
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Reconciled Date
                          </entry>

                          <entry>
                            Sort by the reconciled date
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Reconciled Status
                          </entry>

                          <entry>
                            Sort by the reconciled status
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Register Order
                          </entry>

                          <entry>
                            Sort as within the register
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Other Account Name
                          </entry>

                          <entry>
                            Sort by account transferred from/to's name
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Other Account Code
                          </entry>

                          <entry>
                            Sort by account transferred from/to's code
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Amount
                          </entry>

                          <entry>
                            Sort by amount
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Description
                          </entry>

                          <entry>
                            Sort by description
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Number
                          </entry>

                          <entry>
                            Sort by check/transaction number
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Memo
                          </entry>

                          <entry>
                            Sort by memo
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Primary Subtotal</guilabel>: Subtotal according to the primary key
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Primary Subtotal for Date Key</guilabel>: Do a date subtotal. Only configurable if primary
                    key is date or reconciled date. One of None, weekly, monthly, quarterly or
                    yearly
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Primary Sort Order</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Ascending
                          </entry>

                          <entry>
                            Smallest to largest, earliest to latest
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Descending
                          </entry>

                          <entry>
                            Largest to smallest, latest to earliest
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Secondary Key</guilabel>: Secondary Sort Key. Same options as Primary Key
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Secondary Subtotal</guilabel>: Subtotal according to the secondary key
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Secondary Subtotal for Date Key</guilabel>: Do a date subtotal. Only configurable if
                    primary key is date or reconciled date. One of None, weekly, monthly, quarterly
                    or yearly
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Secondary Sort Order</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Ascending
                          </entry>

                          <entry>
                            Smallest to largest, earliest to latest
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Descending
                          </entry>

                          <entry>
                            Largest to smallest, latest to earliest
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show Full Account Name</guilabel>: Show the full account name for subtotals and subtitles
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show Account Code</guilabel>: Show the account code for subtotals and subtitles
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show Account Description</guilabel>: Show the account description for subtitles
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show Informal Debit/Credit Headers</guilabel>: Show informal names for debit/credit in the
                    subtitles. This requires that subtotal is enabled, and the primary or sortkey is
                    account or account code.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Add indenting columns</guilabel>: Add columns to align transactions within the same
                    grouping together, and can be useful to highlight groups.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show subtotals only (hide transactional data)</guilabel>: Will hide transactions. This may
                    be useful for reports whereby only subtotals are required.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Reset defaults button</guilabel>: Reset all values to their defaults
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>
        </sect4>

        <sect4 id="report-txrpt-splits">
          <title>Displaying Split Account Details</title>

          <para>This is controled by the <emphasis>Detail Level</emphasis><footnoteref linkend='report-fn-v3-dl'/>
            option on the Display tab.
          </para>

          <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
            <orderedlist numeration="loweralpha" spacing="compact">
              <listitem>
                <para>the other <replaceable>account name</replaceable> if there's only one other split in the transaction
                  or
                </para>
              </listitem>

              <listitem>
                <para><computeroutput>Split</computeroutput> if there are multiple other splits in the transaction. You
                  can't display multiple "other" account names in one line. There's just no room for
                  it.
                </para>
              </listitem>
            </orderedlist>
          </para>

          <para>In the case of <emphasis>Multi-Line</emphasis> mode, this report uses a completely different
            concept. For each transaction, every split (both the split in this account and the
            split(s) in the other account(s) !) is printed on a separate line. And every split
            really means every split: both the split which belongs in the account being reported and
            the split(s) in the other account(s) that balance the transaction. So even the most
            basic transaction, with only two splits (this account and other account) will print two
            lines in multiline mode.
          </para>

          <para>For a simple transaction like this
          </para>

          <informaltable>
            <tgroup cols="4">
              <tbody>
                <row>
                  <entry>
                    <emphasis>Description</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Account</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Debit</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Credit</emphasis>
                  </entry>
                </row>

                <row>
                  <entry>
                    Cheques Received
                  </entry>

                  <entry></entry>

                  <entry></entry>

                  <entry></entry>
                </row>

                <row>
                  <entry>
                    Multiple Payers
                  </entry>

                  <entry>
                    Income Account
                  </entry>

                  <entry></entry>

                  <entry>
                    £30.00
                  </entry>
                </row>

                <row>
                  <entry></entry>

                  <entry>
                    Bank Account
                  </entry>

                  <entry>
                    £30.00
                  </entry>

                  <entry></entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>

          <para>then on a Transaction Report for the bank account the details appear pretty much as above.
          </para>

          <para>For clarity of the accounts, you might enter transactions with multiple splits referring to the same
            account. For example, the above transaction might well be entered like this
          </para>

          <informaltable>
            <tgroup cols="4">
              <tbody>
                <row>
                  <entry>
                    <emphasis>Description</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Account</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Debit</emphasis>
                  </entry>

                  <entry>
                    <emphasis>Credit</emphasis>
                  </entry>
                </row>

                <row>
                  <entry>
                    Cheques Received
                  </entry>

                  <entry></entry>

                  <entry></entry>

                  <entry></entry>
                </row>

                <row>
                  <entry>
                    First Payer
                  </entry>

                  <entry>
                    Income Account
                  </entry>

                  <entry></entry>

                  <entry>
                    £10.00
                  </entry>
                </row>

                <row>
                  <entry>
                    Second Payer
                  </entry>

                  <entry>
                    Income Account
                  </entry>

                  <entry></entry>

                  <entry>
                    £20.00
                  </entry>
                </row>

                <row>
                  <entry></entry>

                  <entry>
                    Bank Account
                  </entry>

                  <entry>
                    £30.00
                  </entry>

                  <entry></entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>

          <para>When this transaction is printed on the bank account's Transaction Report in
            <emphasis>Single</emphasis> line mode, then under <emphasis>other account</emphasis> it
            simply prints the word <emphasis>split</emphasis> instead of the account name.
          </para>

          <para>To display the additional split detail, you need to set <emphasis>Single/Multi-Line</emphasis> to
            <emphasis>Multi-Line</emphasis> and then tick <emphasis>Display</emphasis> ->
            <emphasis>Account Name</emphasis>. Do <emphasis>not</emphasis> tick
            <emphasis>Display</emphasis>-><emphasis>Other Account Name</emphasis>.
          </para>

          <para>You can choose whether or not to turn off the full account name using <emphasis>Display</emphasis>
            -> <emphasis>Use Full Account Name.</emphasis>
          </para>

          <para><emphasis>Use Full Other Account Name</emphasis> has no effect in <emphasis>Multi-Line</emphasis>
            mode.
          </para>
        </sect4>
      </sect3>
    </sect2>

    <sect2 id="report-assets">
      <title>Assets &amp; Liabilities</title>

      <para>The Assets &amp; Liabilities reports includes the Balance Sheet report, Investment reports and the
        Net Worth report.
      </para>

      <itemizedlist>
        <listitem>
          <para>Advanced Portfolio:
          </para>

          <para>Columns
          </para>

          <itemizedlist>
            <listitem>
              <para><guilabel>Account</guilabel>: Stock Account
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Symbol</guilabel>: Ticker Symbol/Abbreviation as defined in the Security Editor. A report
                option can suppress this column.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Listing</guilabel>: Type as defined in the Security Editor. A report option can suppress
                this column.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Shares</guilabel>: Number of shares (quantity). A report option sets how many decimal
                places to show. A report option can suppress this column.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Price</guilabel>: Unit market price as at report date. A report option can suppress this
                column.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Basis</guilabel>: Cost of all shares acquired by any means, including brokerage fees if
                the option to include them is checked. Report option <emphasis>Basis calculation
                method</emphasis> can be set to Average, LIFO or FIFO.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Value</guilabel>: Number of shares * Unit market price as at report date
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Money In</guilabel>: Sum of the cost of stock purchased, excluding stock acquired as part
                of a Dividend Reinvestment Plan. I.e. External money used to purchase shares.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Money Out</guilabel>: Money from selling shares or a spin off transaction.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Realized Gain</guilabel>: Money received for selling shares minus basis for shares sold,
                minus brokerage fees for the sale if the option to include them in basis is checked.
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Unrealized Gain</guilabel>: Value less Basis for unsold shares
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Total Gain</guilabel>: Realized Gain + Unrealized Gain
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Rate of Gain</guilabel>: Total Gain / Money In * 100 (from &app; 2.6.1 onwards)
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Income</guilabel>: Total of all income transactions associated with a stock account.
              </para>

              <note>
                <para>To include income from dividends which are not reinvested (if there is no split to the stock account
                  in the income transaction, the report has no way of associating the income with a
                  particular stock) :
                </para>

                <para>Ensure there is a dummy transaction split to the stock account with quantity 0, price 1 and value 0
                  in the dividend transaction. Enter the dummy stock split with no values in the
                  dividend account and it will create the transaction with price 1 even though you
                  cannot see the Price column in that register.
                </para>

                <para>In GnuCash 2.6.6, this report was modified to simplify the recording of dividend and interest
                  payments. With this change it may not be necessary to include the dummy stock
                  split in the transaction. The report will find income (and expense) transactions
                  that are in the parent account of the stock account being reported on. This is
                  done by looking in the parent account for transactions that have exactly two
                  splits (not counting trading account splits) where the other split is to an income
                  or expense account with the same name as the stock's account.
                </para>

                <para>For example given an account structure like
<screen>Assets (type ASSET)
  Broker (type ASSET)
    Widget Stock (type STOCK)
Income (type INCOME)
  Dividends (type INCOME)
    Widget Stock (type INCOME)</screen>
                </para>

                <para>A transaction that debits the "Assets:Broker" account and credits the "Income:Dividends:Widget
                  Stock" account will count as income even though it doesn't have a split with
                  account "Assets:Broker:Widget Stock".
                </para>

                <para>This only works if the parent account ("Assets:Broker" in this case) is a Bank or Asset account and
                  the Income/Expense account has the same name as the stock account. It won't double
                  count transactions that have a dummy split since they won't have exactly two split
                  transactions.
                </para>

                <para>It will not work if the income or expense account split is to a subaccount of the account with the
                  same name as the stock account i.e. "Income:Dividends:Widget Stock:Franked"
                </para>
              </note>
            </listitem>

            <listitem>
              <para><guilabel>Brokerage Fees</guilabel>: Brokerage Fees
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Total Return</guilabel>: Total Gain + Income
              </para>
            </listitem>

            <listitem>
              <para><guilabel>Rate of Return</guilabel>: Total Return / Money In * 100
              </para>
            </listitem>
          </itemizedlist>

          <para>Common report options are described in <xref linkend="report-config"/>
          </para>

          <para>Report Specific Options
          </para>

          <itemizedlist>
<!-- list of Tabs -->
            <listitem>
              <para>Accounts Tab
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Include accounts with no shares</guilabel>: Unchecked (default) or checked.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
<!-- end of Accounts Tab -->
            <listitem>
              <para>Display Tab
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Show ticker symbols</guilabel>: Checked (default) or unchecked. If unchecked, Symbol
                    column will be omitted.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show listings</guilabel>: Checked (default) or unchecked. If unchecked, Listing column
                    (source of shares price quotes) will be omitted.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show number of shares</guilabel>: Checked (default) or unchecked. If unchecked, Shares
                    column will be omitted.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Share decimal places</guilabel>: The number of decimal places to show in the number of
                    shares. Default is 2.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Show prices</guilabel>: Checked (default) or unchecked. If unchecked, Price column will be
                    omitted.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
<!-- end of Display Tab -->
            <listitem>
              <para>General Tab
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Price Source</guilabel>: Nearest in time (default) or Most Recent.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Basis calculation method</guilabel>: Average (default), FIFO or LIFO.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Set preference for price list data</guilabel>: Checked (default): Use price list data. If
                    there is no relevant price list data, transaction prices will be used and there
                    will be a warning. Unchecked: Get prices from stock transactions.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>How to report brokerage fees</guilabel>: Include in basis (default), Include in gain or
                    Ignore.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>
        </listitem>

        <listitem>
          <para>Asset Barchart:
          </para>

          <para>The Asset Barchart report displays bars that present the value of all assets in a &app; file over
            time. By default, the report shows all accounts in <emphasis>Accounts
            Receivable</emphasis>, <emphasis>Current Assets</emphasis>, <emphasis>Fixed
            Assets</emphasis>, <emphasis>Investments</emphasis> and Special Accounts (if they exist)
            and it displays monthly bars for the current financial period. This report provides a
            graphic view of the assets in the file over time.
          </para>

          <tip>
            <para>Like all the generic reports, the user can assign a title and save the report with it's selected
              options for re-use later.
            </para>
          </tip>

          <para>The display is in the form of either a stacked barchart or simple barchart with an option to display
            a table of the values.
          </para>

          <para>This report calculates and displays a default of 8 bars or up to 24 separate asset accounts value at
            the end of the day on several dates through a specified time period. The report
            automatically selects the most significant accounts to display with all other selected
            accounts summed as <emphasis>Other</emphasis>.
          </para>

          <para>The report exploits the outline structure of the chart of accounts to allow the user to select top
            level accounts and sub-accounts down to a user-selectable depth. Selected sub-accounts
            below the selected depth are automatically <emphasis>summed up</emphasis> into the next
            level when it is also selected. The default number of sub-account levels is 2, giving a
            summary view. Increasing the number of sub-levels increases the detail available to
            display. It is possible to un-select a higher level account and leave sub-accounts
            selected to force greater detail to appear in the report.
          </para>

          <para>By default the report includes all <emphasis>asset</emphasis> accounts and sub-accounts, as well as
            <emphasis>Imbalance</emphasis> and <emphasis>Orphan</emphasis> Special accounts in
            whatever currencies or commodities may be present. The report's base currency is the
            default currency of the &app; file but if the file has data for multiple currencies,
            then it can be changed to another currency.
          </para>

          <para>Since each account may be individually selected, the report can be designed to focus on a small
            subset of data such as current assets or investments.
          </para>

          <para>The overall interval of the report defaults to start at the start of the current accounting period
            and to end at the end of the current accounting period. Numerous other starting choices
            and ending choices are available.
          </para>

          <para>The first bar shows the selected values at the end of the day on the first date chosen. There are a
            number of choices for step size from <emphasis>day</emphasis> to
            <emphasis>year</emphasis> with the default being <emphasis>month</emphasis>. Note that
            if any step date would fall on the 29th, 30th or 31st in a month that does not have such
            a date the next interval will be 31 days later. For that step only the date will
            <emphasis>slip</emphasis> up to 3 days into the following month. This is true for
            releases at least through 2.4.13. Bug 639049 is open in Bugzilla to modify this
            behavior.
          </para>

          <para>Currently, there is no option to start the report on the last day of any period. There is also no
            option to show <emphasis>beginning</emphasis> balances or <emphasis>end of previous
            step</emphasis> balances. This makes it difficult to correlate this report to business
            quarterly reports, for example.
          </para>

          <para>The Net Worth linechart report, Liability barchart report and Net Worth barchart report are similar
            except for the graphic type and default account groups selected.
          </para>

          <para>Other features are customizable in a manner similar to other standard reports.
          </para>
        </listitem>

        <listitem>
          <para>Asset Piechart:
          </para>
        </listitem>

        <listitem>
          <para>Average Balance:
          </para>
        </listitem>

        <listitem>
          <para>Balance Sheet: This report summarizes assets, liabilities, and equity. When properly maintained,
            assets should equal the sum of liabilities and equity. If that is not the case, there is
            some kind of internal imbalance in the accounts.
          </para>
        </listitem>

        <listitem>
          <para>Balance Sheet using eguile-gnc:
          </para>
        </listitem>

        <listitem>
          <para>General Journal:
          </para>
        </listitem>

        <listitem id="investment-lots-report">
          <para>Investment Lots:
          </para>

          <figure id="fig-investlots" pgwide="1">
            <title>The Investment Lots Report</title>

            <screenshot id="InvestmentLotsScreenShot">
              <screeninfo>1720x982</screeninfo>

              <mediaobject>
                <imageobject role="html">
                  <imagedata fileref="figures/Report_Investment_Lots.png"
                             srccredit="Brent McBride" width="&img-w;"/>
                </imageobject>

                <imageobject role="fo">
                  <imagedata fileref="figures/Report_Investment_Lots.png"
                             srccredit="Brent McBride"/>
                </imageobject>
              </mediaobject>
            </screenshot>
          </figure>

          <abstract>
            <para>The Investment Lots report shows details about lots in a selected set of accounts of type
              <emphasis>Stock</emphasis> or <emphasis>Mutual Fund</emphasis>. It includes an
              optional <link linkend="investment-lots-report-chart">capital gains summary
              chart</link> and a <link linkend="investment-lots-report-columns">table</link> with
              columns for <link linkend="investment-lots-report-column-d">dates</link>,
              <link linkend="investment-lots-report-column-b">purchases</link>,
              <link linkend="investment-lots-report-column-s">sales</link>,
              <link linkend="investment-lots-report-column-e">end balances</link>, capital gains
              (<link linkend="investment-lots-report-column-r">realized</link> and
              <link linkend="investment-lots-report-column-r">unrealized</link>, short term and long
              term), and return on investment (ROI). It also performs optional lot
              <link linkend="investment-lots-report-options-val">validation checks</link>.
            </para>
          </abstract>

          <para>For information about lots in &app;, see:
            <itemizedlist>
              <listitem>
                <para><xref linkend="tool-lots-cap" />
                </para>

                <note>
                  <para>Lots can be used for both securities and invoices, but this report applies to securities.
                  </para>
                </note>
              </listitem>

              <listitem>
                <para>Tutorial and Concepts Guide
                </para>

                <itemizedlist>
                  <listitem>
                    <para><ulink url="&url-docs-C;guide/invest-sell1.html#invest-sellLots"> Selling Shares with Automatic
                      Calculation of Capital Gain or Loss Using Lots</ulink>
                    </para>
                  </listitem>

                  <listitem>
                    <para><ulink url="&url-docs-C;guide/rpt_standardrpts.html#rpt_investlots"> Investment Lots</ulink> report
                    </para>
                  </listitem>
                </itemizedlist>
              </listitem>

              <listitem>
                <para>Wiki: <ulink url="&url-wiki-lots;">Concept of Lots</ulink>
                </para>
              </listitem>
            </itemizedlist>
          </para>

          <para id="investment-lots-report-chart">Account lots gains chart: Summarizes the lot gains and losses of each account.
          </para>

          <para id="investment-lots-report-columns">Table Columns
          </para>

          <note>
            <para>Most of the columns can be hidden in the report
              <link linkend="investment-lots-report-options-columns">Column options</link>.
            </para>
          </note>

          <note>
            <para>The Amount columns are denominated in each account's commodity. But the Value, Basis, Price, and
              Gain columns are always denominated in the <guilabel>Report's currency</guilabel>,
              converted if necessary.
            </para>
          </note>

          <itemizedlist>
            <listitem  id="investment-lots-report-column-title">
              <para><guilabel>Lot Title</guilabel>
              </para>
            </listitem>

            <listitem id="investment-lots-report-column-guid">
              <para><guilabel>GUID</guilabel>: The lot's internal, globally unique identifier. This column is hidden by
                default, as it is probably not useful for most use cases. But it could come in handy
                for directly querying the &app; back end data store.
              </para>
            </listitem>

            <listitem id="investment-lots-report-column-d">
              <para>Date columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-opened">
                  <para><guilabel>Opened</guilabel>: The date on which the lot was opened. In a well-formed lot, this is the
                    transaction date of the first (and ideally only) purchase split.
                  </para>

                  <warning>
                    <para>Placing more than one purchase split into a single lot can make ambiguous the holding period,
                      preventing gains from being accurately grouped by short term and long term.
                    </para>
                  </warning>
                </listitem>

                <listitem id="investment-lots-report-column-closed">
                  <para><guilabel>Closed</guilabel>: The date on which the lot was closed, which is the transaction date of
                    the sale split that reduces the lot balance to zero. If the lot is still open on
                    the report end date, then <guilabel>Closed</guilabel> is blank.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-column-b">
              <para>Bought columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-ba">
                  <para><guilabel>Bought Amount</guilabel>: The total number of purchased shares.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-bv">
                  <para><guilabel>Bought Value (Basis)</guilabel>: The total purchase value of the
                    <link linkend="investment-lots-report-column-ba"><guilabel>Bought
                    Amount</guilabel></link>. This is the basis used for computing gains.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-bp">
                  <para><guilabel>Bought Average Price</guilabel>: The average price of each purchased share.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-column-s">
              <para>Sold columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-ss">
                  <para><guilabel>Sold Splits</guilabel>: The total number of sold splits.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-sa">
                  <para><guilabel>Sold Amount</guilabel>: The total number of sold shares.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-sb">
                  <para><guilabel>Sold Basis</guilabel>: The total basis (purchase value) of the
                    <link linkend="investment-lots-report-column-sa"><guilabel>Sold
                    Amount</guilabel></link>.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-sv">
                  <para><guilabel>Sold Value</guilabel>: The total value (sales proceeds) of the
                    <link linkend="investment-lots-report-column-sa"><guilabel>Sold
                    Amount</guilabel></link>.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-sp">
                  <para><guilabel>Sold Average Price</guilabel>: The average sale price of each sold share.
                  </para>
                </listitem>
              </itemizedlist>

              <note>
                <para>The <link linkend="investment-lots-report-column-sa"><guilabel>Sold Amount</guilabel></link>,
                  <link linkend="investment-lots-report-column-sb"><guilabel>Sold
                  Basis</guilabel></link>, and
                  <link linkend="investment-lots-report-column-sv"><guilabel>Sold
                  Value</guilabel></link> columns can be optionally split into short-term and
                  long-term columns (e.g. <guilabel>ST Sold Amount</guilabel> and <guilabel>LT Sold
                  Amount</guilabel> instead of
                  <link linkend="investment-lots-report-column-sa"><guilabel>Sold
                  Amount</guilabel></link>, etc.) via the
                  <link linkend="investment-lots-report-options-columns-gg"><guilabel>Group gains by
                  age (short term and long term)</guilabel></link> Columns option.
                </para>
              </note>
            </listitem>

            <listitem id="investment-lots-report-column-e">
              <para>End columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-ea">
                  <para><guilabel>End Amount</guilabel>: The number of shares in the lot on the end date.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-eb">
                  <para><guilabel>End Basis</guilabel>: The basis (purchase value) of the
                    <link linkend="investment-lots-report-column-ea"><guilabel>End
                    Amount</guilabel></link>.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-ev">
                  <para><guilabel>End Value</guilabel>: The value of the
                    <link linkend="investment-lots-report-column-ea"><guilabel>End
                    Amount</guilabel></link>, using the share end price from the <guilabel>Price
                    Source</guilabel> (e.g. the latest price on the end date).
                  </para>

                  <note>
                    <para>The end price used to compute the <link linkend="investment-lots-report-column-ev"><guilabel>End
                      Value</guilabel></link> is displayed between the account name and the lot
                      rows.
                    </para>
                  </note>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-column-r">
              <para>Realized gain columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-rg">
                  <para><guilabel>Realized Gain</guilabel>: The capital gains (or losses) realized on sold shares.
                    <link linkend="investment-lots-report-column-sv"><guilabel>Sold
                    Value</guilabel></link> minus
                    <link linkend="investment-lots-report-column-sb"><guilabel>Sold
                    Basis</guilabel></link>.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-rr">
                  <para><guilabel>Realized ROI</guilabel>: The realized return on investment.
                    <link linkend="investment-lots-report-column-rg"><guilabel>Realized
                    Gain</guilabel></link> divided by
                    <link linkend="investment-lots-report-column-sb"><guilabel>Sold
                    Basis</guilabel></link>, as a percentage.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-column-u">
              <para>Unrealized gain columns
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-column-ug">
                  <para><guilabel>Unrealized Gain</guilabel>: The capital gains (or losses) that would be realized if the
                    remaining shares were sold on the end date.
                    <link linkend="investment-lots-report-column-ev"><guilabel>End
                    Value</guilabel></link> minus
                    <link linkend="investment-lots-report-column-eb"><guilabel>End
                    Basis</guilabel></link>.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-column-ur">
                  <para><guilabel>Unrealized ROI</guilabel>: The unrealized return on investment.
                    <link linkend="investment-lots-report-column-ug"><guilabel>Unrealized
                    Gain</guilabel></link> divided by
                    <link linkend="investment-lots-report-column-eb"><guilabel>End
                    Basis</guilabel></link>, as a percentage.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>

          <note>
            <para>The realized and unrealized gain columns can be optionally split into short-term and long-term
              columns (e.g. <guilabel>ST Realized Gain</guilabel> and <guilabel>LT Realized
              Gain</guilabel> instead of
              <link linkend="investment-lots-report-column-rg"><guilabel>Realized
              Gain</guilabel></link>, etc.) via the
              <link linkend="investment-lots-report-options-columns-gg"><guilabel>Group gains by age
              (short term and long term)</guilabel></link> Columns option.
            </para>
          </note>

          <para id="investment-lots-report-options">Report Options
          </para>

          <itemizedlist>
            <listitem id="investment-lots-report-options-accounts">
              <para>Accounts tab
              </para>

              <para>These options control which accounts to include in the report, using a standard account selector.
                Selected accounts that are not of type <emphasis>Stock</emphasis> or
                <emphasis>Mutual Fund</emphasis> are ignored.
              </para>

              <tip>
                <para>Select only taxable accounts to scope the report to taxable capital gains.
                </para>
              </tip>

              <para>Additional options:
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-options-accounts-ns">
                  <para><guilabel>Include accounts with no shares</guilabel>: When disabled, accounts with an empty balance
                    on the report's end date are ignored. This can be useful when wanting to see
                    only unrealized gains.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-accounts-nl">
                  <para><guilabel>Include accounts with no lots</guilabel>: If some commodity accounts intentionally do not
                    use lots, then disabling this option is a convenient way to prevent such
                    accounts from cluttering the report.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-options-chart">
              <para>Chart tab
              </para>

              <para>These options control the <link linkend="investment-lots-report-chart"><guilabel>Account Lot
                Gains</guilabel></link> chart.
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-options-chart-sc">
                  <para><guilabel>Show Chart</guilabel>: The other chart options are ignored when this option is disabled.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-chart-ct">
                  <para><guilabel>Chart type</guilabel>
                  </para>

                  <informaltable>
                    <tgroup cols="1">
                      <tbody>
                        <row>
                          <entry>
                            <emphasis>Option </emphasis>
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Stacked Bar Chart (default)
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Bar Chart
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>

                  <para>The following chart examples each show the same four accounts that contain a mix of realized and
                    unrealized gains and losses, both short-term and long-term:
                  </para>

                  <figure id="fig-investlots-stackedbar" pgwide="1">
                    <title>The Investment Lots Report, Stacked Bar Chart</title>

                    <screenshot id="InvestmentLotsStackedBarChart">
                      <screeninfo>800x630</screeninfo>

                      <mediaobject>
                        <imageobject>
                          <imagedata fileref="figures/Report_Investment_Lots_StackedBar.png"
                                    srccredit="Brent McBride"/>
                        </imageobject>
                      </mediaobject>
                    </screenshot>
                  </figure>

                  <figure id="fig-investlots-bar" pgwide="1">
                    <title>The Investment Lots Report, Bar Chart</title>

                    <screenshot id="InvestmentLotsBarChart">
                      <screeninfo>800x667</screeninfo>

                      <mediaobject>
                        <imageobject>
                          <imagedata fileref="figures/Report_Investment_Lots_Bar.png"
                                    srccredit="Brent McBride"/>
                        </imageobject>
                      </mediaobject>
                    </screenshot>
                  </figure>
                </listitem>

                <listitem id="investment-lots-report-options-chart-cl">
                  <para><guilabel>Chart location</guilabel>
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            <emphasis>Option </emphasis>
                          </entry>

                          <entry>
                            <emphasis>Description </emphasis>
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Top (default)
                          </entry>

                          <entry>
                            Display the chart at the top of the report, above the table
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Bottom
                          </entry>

                          <entry>
                            Display the chart at the bottom of the report, below the table
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem id="investment-lots-report-options-chart-pwh">
                  <para><guilabel>Plot width</guilabel> and <guilabel>Plot height</guilabel>: Controls the chart's
                    dimensions.
                  </para>
                </listitem>
              </itemizedlist>

              <note>
                <para>The chart gain categories are controlled by the Columns tab's
                  <link linkend="investment-lots-report-options-columns-gains">Gains options</link>.
                </para>
              </note>
            </listitem>

            <listitem id="investment-lots-report-options-columns">
              <para>Columns tab
              </para>

              <para>These options control which table columns are visible.
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-options-columns-gd">
                  <para><link linkend="investment-lots-report-column-guid"><guilabel>Show lot guid column</guilabel></link>:
                    Disabled by default.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-columns-d">
                  <para><link linkend="investment-lots-report-column-d"><guilabel>Show date columns</guilabel></link>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-columns-b">
                  <para><link linkend="investment-lots-report-column-b"><guilabel>Show bought columns</guilabel></link>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-columns-s">
                  <para><link linkend="investment-lots-report-column-s"><guilabel>Show sold columns</guilabel></link>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-columns-e">
                  <para><link linkend="investment-lots-report-column-e"><guilabel>Show end columns</guilabel></link>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-columns-gains">
                  <para>Gains options
                  </para>

                  <note>
                    <para>These options impact both the table columns and the chart.
                    </para>
                  </note>

                  <itemizedlist>
                    <listitem id="investment-lots-report-options-columns-r">
                      <para><link linkend="investment-lots-report-column-r"><guilabel>Show realized gain
                        columns</guilabel></link>
                      </para>
                    </listitem>

                    <listitem id="investment-lots-report-options-columns-u">
                      <para><link linkend="investment-lots-report-column-u"><guilabel>Show unrealized gain
                        columns</guilabel></link>
                      </para>
                    </listitem>

                    <listitem id="investment-lots-report-options-columns-gg">
                      <para><guilabel>Group gains by age (short term and long term)</guilabel>: Different governments can have
                        different rules regarding how long shares must be held to qualify for
                        different tax treatment.
                      </para>

                      <informaltable>
                        <tgroup cols="2">
                          <tbody>
                            <row>
                              <entry>
                                <emphasis>Option </emphasis>
                              </entry>

                              <entry>
                                <emphasis>Description </emphasis>
                              </entry>
                            </row>

                            <row>
                              <entry>
                                No
                              </entry>

                              <entry>
                                Do not group gains by age
                              </entry>
                            </row>

                            <row>
                              <entry>
                                Gains Only (default)
                              </entry>

                              <entry>
                                Group gains by age
                              </entry>
                            </row>

                            <row>
                              <entry>
                                Gains and Sales
                              </entry>

                              <entry>
                                Also group the <link linkend="investment-lots-report-column-s">Sold
                                columns</link> by age
                              </entry>
                            </row>
                          </tbody>
                        </tgroup>
                      </informaltable>
                    </listitem>

                    <listitem id="investment-lots-report-options-columns-ga">
                      <para><guilabel>Long term gains age (years)</guilabel>: Shares held longer than this many years count as
                        long term. This option is ignored when the
                        <link linkend="investment-lots-report-options-columns-gg"><guilabel>Group
                        gains by age (short term and long term)</guilabel></link> option is
                        disabled. Default: 1 year.
                      </para>
                    </listitem>
                  </itemizedlist>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-options-display">
              <para>Display tab
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-options-display-an">
                  <para><guilabel>Show long account names</guilabel>: Controls which name to use for all accounts in the
                    report: long (fully-qualified) or short.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-display-mn">
                  <para><guilabel>Show mnemonic in amounts</guilabel>: Controls whether the currency mnemonic will be use
                    when reporting amounts. I.e. "123 RIO" versus just "123". This setting only
                    impacts amounts not values, which are always displayed in the <guilabel>Report's
                    currency</guilabel>, with its mnemonic.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-display-cl">
                  <para><guilabel>Include closed lots</guilabel>: Allows closed lots to be filtered out. This can be useful
                    when wanting to see only unrealized gains.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-display-bz">
                  <para><guilabel>Show blanks instead of zeros in table cells</guilabel>: This can make the report table
                    look less cluttered. Does not apply to <guilabel>Account Lots Total</guilabel>
                    and <guilabel>Grand Total</guilabel> rows.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-display-sr">
                  <para><guilabel>Show lot split rows</guilabel>: When enabled, rows for each of the bought and sold splits
                    pertaining to the lot (within the report's date window) will be displayed nested
                    under each lot row. Disabled by default.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem id="investment-lots-report-options-general">
              <para>General tab
              </para>

              <para>See <xref linkend="report-common"/>.
              </para>

              <note>
                <para>The <guilabel>Start date</guilabel> and <guilabel>End date</guilabel> options define the lot's date
                  window. Splits outside of this window are not included in the report. Except that
                  splits from before the <guilabel>Start date</guilabel> are counted only insofar as
                  needed to calculate the
                  <link linkend="investment-lots-report-column-sb"><guilabel>Sold
                  Basis</guilabel></link>,
                  <link linkend="investment-lots-report-column-eb"><guilabel>End
                  Basis</guilabel></link>, and
                  <link linkend="investment-lots-report-column-ea"><guilabel>End
                  Amount</guilabel></link> columns. But these splits are not included in the
                  report's other <link linkend="investment-lots-report-column-b">Bought
                  columns</link> and <link linkend="investment-lots-report-column-s">Sold
                  columns</link>, nor are they shown when the
                  <link linkend="investment-lots-report-options-display-sr"><guilabel>Show lot split
                  rows</guilabel></link> option is enabled.
                </para>
              </note>
            </listitem>

            <listitem id="investment-lots-report-options-val">
              <para>Validation tab
              </para>

              <para>These options control how lots and accounts are validated. The report shows optional validation
                warnings that help identify potential lot problems.
              </para>

              <itemizedlist>
                <listitem id="investment-lots-report-options-val-aw">
                  <para><guilabel>Include only accounts with warnings</guilabel>: Enable this option to see only accounts
                    that have one of more of the enabled warnings. This can be useful for quickly
                    validating that lots are well-formed, especially in combination with selecting
                    all accounts and all dates. Disabled by default.
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-mb">
                  <para><guilabel>Warn if a lot has more than one bought split</guilabel>: The Scrub operation only adds one
                    purchase per lot, but &app; does not stop a user from manually adding multiple
                    purchase splits to the same lot--even though this is arguably bad practice.
                    Having multiple purchase dates makes the holding period ambiguous. But if this
                    is desired, consider disabling both this warning and the Columns tab's
                    <link linkend="investment-lots-report-options-columns-gg"><guilabel>Group gains
                    by age (short term and long term) </guilabel></link> option. If the column
                    option is left enabled, then the report will use the date of the last purchase
                    split for determining the holding period, but continue to use the first purchase
                    date for the lot
                    <link linkend="investment-lots-report-column-opened"><guilabel>Opened</guilabel></link>
                    column.
                  </para>

                  <note>
                    <para>The last purchase date is used to calculate the holding period because long term gains often receive
                      favorable tax treatment, so it is probably worse to misidentify a gain as
                      long-term rather than as short-term. But better still is to not have more than
                      one purchase per lot, so the holding periods are unambiguous.
                    </para>
                  </note>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: Above lot has 2 bought splits. Consider separating them into their own
                    lots.</computeroutput>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-nb">
                  <para><guilabel>Warn if a lot's balance drops below zero</guilabel>: The Scrub operation will not create
                    negative lot balances. But &app; does not prevent users from manually creating
                    them. When this option is enabled, the report shows a warning if a lot's balance
                    becomes negative during the report date window.
                  </para>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: Above lot's balance is negative on 10/29/2022. Consider removing the
                    responsible sale split from the lot and then scrubbing.</computeroutput>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-bt">
                  <para><guilabel>Warn if a lot has a blank title</guilabel>: Disabled by default. Lot titles are optional.
                    Enabling this warning will flag lots with blank (empty or whitespace) titles.
                  </para>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: Above lot's title is blank.</computeroutput>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-rg">
                  <para><guilabel>Warn if the "Realized Gain/Loss" split(s) sum does not match the computed
                    gains</guilabel>: The report recomputes the gain/loss values from each sale,
                    compares them with the sum of the lot's generated <quote>Realized
                    Gain/Loss</quote> splits and warns if they do not match.
                  </para>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: Above lot's computed gain $(1,518.79) is not equal to the "Realized
                    Gain/Loss" split(s) sum $(1,518.80). Difference: $0.01</computeroutput>
                  </para>

                  <para><note>
                      <para>If a <quote>Realized Gain/Loss</quote> split is incorrect, it can often be repaired thus:
                      </para>

                      <orderedlist >
                        <listitem>
                          <para>Remove the sale split from the lot,
                          </para>
                        </listitem>

                        <listitem>
                          <para>Delete the bad <quote>Realized Gain/Loss</quote> split,
                          </para>
                        </listitem>

                        <listitem>
                          <para>Add the sale split back to the lot, to recreate the <quote>Realized Gain/Loss</quote> split, and
                          </para>
                        </listitem>

                        <listitem>
                          <para><guibutton>Reload</guibutton> this report and verify that the warning is gone.
                          </para>
                        </listitem>
                      </orderedlist>
                    </note>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-os">
                  <para><guilabel>Warn if a split is not assigned to a lot</guilabel>: Realized and unrealized gains cannot
                    be computed for splits that are not in a lot. This warning flags accounts
                    containing unassigned splits.
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            <emphasis>Option </emphasis>
                          </entry>

                          <entry>
                            <emphasis>Description </emphasis>
                          </entry>
                        </row>

                        <row>
                          <entry>
                            No
                          </entry>

                          <entry>
                            Warning disabled
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Count (default)
                          </entry>

                          <entry>
                            Warning message identifies the number of unassigned splits
                          </entry>
                        </row>

                        <row>
                          <entry>
                            List
                          </entry>

                          <entry>
                            Unassigned splits are listed after the warning message
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: 2 split(s) are not assigned to a lot. Do lots need to be
                    scrubbed?</computeroutput>
                  </para>
                </listitem>

                <listitem id="investment-lots-report-options-val-ab">
                  <para><guilabel>Warn if the account balance does not match the computed lots' end balance</guilabel>: This
                    is often another indication that the account has splits that are not included in
                    a lot.
                  </para>

                  <para>Example:
                  </para>

                  <para><computeroutput>Warning: End amount 236.5 RIO is not equal to actual account balance 234 RIO.
                    Difference: 2.5 RIO. Do lots need to be scrubbed?</computeroutput>
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>
        </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>

        <listitem>
          <para>Liability Barchart:
          </para>
        </listitem>

        <listitem>
          <para>Liability Piechart:
          </para>
        </listitem>

        <listitem>
          <para>Net Worth Barchart: Net worth is the difference between the value of assets or liabilities.
          </para>
        </listitem>

        <listitem>
          <para>Net Worth Linechart: Net worth plotted over time. Net worth is the difference between the value of
            assets or liabilities.
          </para>
        </listitem>

        <listitem>
          <para>Price Scatterplot:
          </para>
        </listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="report-biz">
      <title>Business Reports</title>

      <para>The Business Reports includes Customer and Vendor Reports and Printable Invoices as well as Aging
        reports.
      </para>

      <sect3>
        <title>Customer Report</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Customer Summary</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Easy Invoice</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Employee Report</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Fancy Invoice</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Job Report</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Payable Aging</title>

        <para>This report provides a listing of vendors and their aged outstanding balances. Vendors may be
          included if they have posted business transactions (e.g. invoices) for the selected
          accounts payable account. It shows their current balance, and how much they have due from
          invoices over time periods 0-30 days, 31-60 days, 61-90 days, and over 90 days. The report
          also contains links to each vendor and to their current vendor report.
        </para>

        <para>Optionally, vendor address details may be also shown.
        </para>

        <tip>
          <para>To export vendor address details, say in order to do a mail merge, select the optional vendor
            address details in the report options display tab, apply the options to regenerate the
            report, then copy and paste the report into a spreadsheet. Alternatively, the report can
            be exported to a .html file, then read into a spreadsheet.
          </para>
        </tip>

        <sect4 id="report-pay-aging-opts">
          <title>Report Options</title>

          <note>
            <para>See <xref linkend="report-common"/> in the <emphasis>Configuring Reports and Charts</emphasis>
              section of this help manual for more details of the common options.
            </para>
          </note>

          <itemizedlist>
            <listitem>
              <para><emphasis>General tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Report name</guilabel>: Enter a descriptive name for this report - see
                    <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Stylesheet</guilabel>: Select a style sheet for this report - see
                    <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>To</guilabel>: Select a date to report on or a named date. Transactions up to and
                    including the selected date will be used to calculate the outstanding aged
                    balances. See <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Report's currency</guilabel>: Select the currency to display the values in - see
                    <xref linkend="report-common"/>
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Price Source</guilabel>: Select the source of price information used for currency
                    conversion if needed. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Average Cost
                          </entry>

                          <entry>
                            The volume-weighted net average price of all exchanges.
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Weighted Average (default)
                          </entry>

                          <entry>
                            The volume-weighted gross average price of all exchanges up to the date
                            of the report
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Most recent
                          </entry>

                          <entry>
                            The most recent recorded price
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Nearest in time
                          </entry>

                          <entry>
                            The price recorded nearest in time to the report date
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show Multi-currency Totals</guilabel>: If not selected, all totals are shown in the report
                    currency.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Sort By</guilabel>: Sort companies by one of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Name (default)
                          </entry>

                          <entry>
                            Company name
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Total Owed
                          </entry>

                          <entry>
                            Total amount owed to company
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Bracket Total Owed
                          </entry>

                          <entry>
                            Amount owed in oldest bracket. If same, use next oldest
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Sort Order</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Ascending (default)
                          </entry>

                          <entry>
                            0 … 999,999.99, A … Z
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Descending
                          </entry>

                          <entry>
                            999,999.99 … 0, Z … A
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show zero balance items</guilabel>: Show companies even if they have a zero outstanding
                    balance.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Due or Post Date</guilabel>: Leading date. Which date to use to determine aging. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Due Date (default)
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Post Date
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Payable Account</guilabel>: The accounts payable account used to select vendors to be
                    reported. Vendors are included if they have a posted business transaction
                    (usually an invoice) on or before the report date and also meet the
                    <emphasis>Show zero balance items</emphasis> criteria.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>Display tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Address Name</guilabel>: Display vendor address name. This, and other fields, may be
                    useful if copying this report to a spreadsheet for use in a mail merge.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 1</guilabel>: Display address line 1.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 2</guilabel>: Display address line 2.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 3</guilabel>: Display address line 3.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 4</guilabel>: Display address line 4.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Phone</guilabel>: Display address phone number.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Fax</guilabel>: Display address fax number.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Email</guilabel>: Display email address.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Active</guilabel>: Display vendor active status.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>
        </sect4>
      </sect3>

      <sect3>
        <title>Printable Invoice</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Receivable Aging</title>

        <para>This report provides a listing of customers and their aged outstanding balances. Customers may be
          included if they have posted business transactions (e.g. invoices) for the selected
          accounts receivable account. It shows their current balance, and how much they have
          outstanding from invoices over time periods 0-30 days, 31-60 days, 61-90 days, and over 90
          days. The report also contains links to each customer and to their current customer
          report.
        </para>

        <para>Optionally, customer address details may be also shown.
        </para>

        <tip>
          <para>To export customer address details, say in order to do a mail merge, select the optional customer
            address details in the report options display tab, apply the options to regenerate the
            report, then copy and paste the report into a spreadsheet. Alternatively, the report can
            be exported to a .html file, then read into a spreadsheet.
          </para>
        </tip>

        <sect4 id="report-rec-aging-opts">
          <title>Report Options</title>

          <note>
            <para>See <xref linkend="report-common"/> in the <emphasis>Configuring Reports and Charts</emphasis>
              section of this help manual for more details of the common options.
            </para>
          </note>

          <itemizedlist>
            <listitem>
              <para><emphasis>General tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Report name</guilabel>: Enter a descriptive name for this report - see
                    <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Stylesheet</guilabel>: Select a style sheet for this report - see
                    <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>To</guilabel>: Select a date to report on or a named date. Transactions up to and
                    including the selected date will be used to calculate the outstanding aged
                    balances. See <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Report's currency</guilabel>: Select the currency to display the values in - see
                    <xref linkend="report-common"/>.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Price Source</guilabel>: Select the source of price information used for commodity
                    conversion if needed. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Average Cost
                          </entry>

                          <entry>
                            The volume-weighted net average price of all exchanges
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Weighted Average (default)
                          </entry>

                          <entry>
                            The volume-weighted gross average price of all exchanges
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Most recent
                          </entry>

                          <entry>
                            The most recent recorded price
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Nearest in time
                          </entry>

                          <entry>
                            The price recorded nearest in time to the report date
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show Multi-currency Totals</guilabel>: If not selected, all totals are shown in the report
                    currency.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Sort By</guilabel>: Sort companies by one of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Name (default)
                          </entry>

                          <entry>
                            Company name
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Total Owed
                          </entry>

                          <entry>
                            Total amount owed by company
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Bracket Total Owed
                          </entry>

                          <entry>
                            Amount owed in oldest bracket. If same, use next oldest
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Sort Order</guilabel>: One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Ascending (default)
                          </entry>

                          <entry>
                            0 … 999,999.99, A … Z
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Descending
                          </entry>

                          <entry>
                            999,999.99 … 0, Z … A
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Show zero balance items</guilabel>: Show companies even if they have a zero outstanding
                    balance.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Due or Post Date</guilabel>: Leading date. Which date to use to determine aging. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Due Date (default)
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Post Date
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Receivables Account</guilabel>: The accounts receivable account used to select customers
                    to be reported. Customers are included if they have a posted business
                    transaction (usually an invoice) on or before the report date and also meet the
                    <emphasis>Show zero balance items</emphasis> criteria.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>

            <listitem>
              <para><emphasis>Display tab</emphasis>
              </para>

              <itemizedlist>
                <listitem>
                  <para><guilabel>Address Source</guilabel>: Which customer address fields to display. One of
                  </para>

                  <informaltable>
                    <tgroup cols="2">
                      <tbody>
                        <row>
                          <entry>
                            Billing (default)
                          </entry>

                          <entry>
                            Address fields from billing address.
                          </entry>
                        </row>

                        <row>
                          <entry>
                            Shipping
                          </entry>

                          <entry>
                            Address fields from shipping address.
                          </entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
                </listitem>

                <listitem>
                  <para><guilabel>Address Name</guilabel>: Display customer address name. This, and other fields, may be
                    useful if copying this report to a spreadsheet for use in a mail merge.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 1</guilabel>: Display address line 1.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 2</guilabel>: Display address line 2.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 3</guilabel>: Display address line 3.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Address 4</guilabel>: Display address line 4.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Phone</guilabel>: Display address phone number.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Fax</guilabel>: Display address fax number.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Email</guilabel>: Display email address.
                  </para>
                </listitem>

                <listitem>
                  <para><guilabel>Active</guilabel>: Display vendor active status.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </itemizedlist>
        </sect4>
      </sect3>

      <sect3>
        <title>Tax Invoice</title>

        <para></para>
      </sect3>

      <sect3>
        <title>Vendor Report</title>

        <para></para>
      </sect3>
    </sect2>

    <sect2 id="report-income">
      <title>Income &amp; Expense</title>

      <para>The Income &amp; Expense reports includes the Cash Flow and Income Statement reports.
      </para>

      <itemizedlist>
        <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 &amp; Expense Chart:
          </para>
        </listitem>

        <listitem>
          <para>Income Barchart:
          </para>
        </listitem>

        <listitem>
          <para>Income Piechart:
          </para>
        </listitem>

        <listitem>
          <para>Income Statement: This report summarizes sources of income and expenditure. (This report was called
            Profit &amp; Loss in gnucash-1.8.)
          </para>
        </listitem>

        <listitem>
          <para>Income vs Day of Week:
          </para>
        </listitem>

        <listitem>
          <para>Profit &amp; Loss: This is the same report as the Income Statement but with a different title.
          </para>
        </listitem>

        <listitem>
          <para>Trial Balance: This report summarizes sources of income and expenditure.
          </para>
        </listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="report-sample">
      <title>Sample &amp; Custom</title>

      <sect3>
        <title>Sample Report</title>

        <para>Report illustrating basic techniques used to create GnuCash reports.
        </para>
      </sect3>

      <sect3>
        <title>Sample Graphs</title>

        <para>Sample Pie chart and Bar chart.
        </para>
      </sect3>

      <sect3>
        <title>Average Balance</title>

        <para>Bar chart with balance per month.
        </para>
      </sect3>

      <sect3>
        <title>Expenses vs. Day of Week</title>

        <para>Pie chart.
        </para>
      </sect3>

      <sect3>
        <title>Income vs. Day of Week</title>

        <para>Pie chart.
        </para>
      </sect3>
    </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 &amp; 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 Expenses: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 the 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 the 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 the 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 options to select the 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 the
                range start option is set to <emphasis>Manual</emphasis>
              </para>
            </listitem>

            <listitem>
              <para><emphasis>Range end</emphasis> - a combobox with a list of options to select the 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 the 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 the report
                all budget periods, that are after selected period range, as a single consolidated
                column set.
              </para>
            </listitem>
          </itemizedlist>
        </para>
      </sect3>
    </sect2>

    <sect2 id="report-regional">
      <title>Country Specific Reports</title>

      <highlights>
        <para>Some report are only useful in specific regions. Each tax authority has other requirements. The
          availability of this reports depend on your <ulink url="&url-wiki-locale;">Locale
          Settings</ulink>. As there is currently not more than one report per country they are
          merged into the <xref linkend="report-general"/>.
        </para>
      </highlights>

      <important>
        <para>To get useful data, the user has to segregate <emphasis>taxable</emphasis> and <emphasis>non
          taxable</emphasis> income into different accounts, as well as
          <emphasis>deductible</emphasis> and <emphasis>non deductible</emphasis> expenses. The user
          must also set the <guilabel>TXF category</guilabel> of each tax related account. This can
          be done by the <guimenuitem>Income Tax Information</guimenuitem> dialog, reachable by
          &mc.ed.tax-rep-opt; . Its usage is explained in <xref linkend="set-tax-options"></xref>.
        </para>
      </important>

      <sect3 id="report-taxreport">
        <title>US: Tax Schedule Report and <acronym>TXF</acronym> Export</title>

        <note>
          <para>This report is also visible, if no tax report for your region is available in &app;.
          </para>
        </note>

        <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>

        <para>For accounts specified in the report options (none = all) that are also flagged as
          <guilabel>Tax-related</guilabel>, all transactions for the time period selected (also in
          the report options) are included. The report sorts transactions by date within account
          providing subtotals by account within tax code within Form or Schedule line number.
          Support is also provided for multiple copies of and for sub-line items for selected
          Forms/Schedules. Optionally uses special date processing to include federal estimated tax
          payments after year end.
        </para>

        <para>All totals are in USD since this is the currency required for filing US Income Tax returns. Non-USD
          transaction amounts are converted to USD using the transaction conversion rate to USD, if
          available. If not, a conversion rate from the price database is used (either the date
          nearest the transaction date or nearest the report date as specified in the report
          options; if none is available, transaction amounts are converted to zero and the report
          provides a comment accordingly). A complete audit trail of conversions is provided.
        </para>
      </sect3>

      <sect3 id="report-taxreport-de">
        <title>DE: Steuer-Bericht und <acronym>ElStEr</acronym> Export</title>

        <note>
          <para>This report is only visible, if the language is set to <computeroutput>de |
            deutsch</computeroutput>.
          </para>
        </note>
<!-- Umsatzsteuer-Voranmeldung …
             siehe auch erweiterte Version in https://github.com/fellen/gnucash/tree/ESt -->
      </sect3>
    </sect2>
  </sect1>

  <sect1 id="report-print">
    <title>Drucken und Exportieren von Berichten</title>
<!--
    <note>
      <para>Verify !!! How customize printing with Gnome?
      </para>
    </note>
 -->
    <para>&app; ist in der Lage, Berichte zu drucken und in <acronym>HTML</acronym>-Seiten oder als
      <acronym>CSV</acronym>-Datei zu exportieren. Der Drucken-Dialog in &app; wird über
      &mc.fi.prin-rep; im Menü gestartet. Um einen Bericht in eine Webseite
      (<acronym>HTML</acronym>) oder ein <acronym>CSV</acronym>-Datei zu exportieren, wählen Sie
      die Option &mc.fi.exp.rep;, wählen das Zielformat und geben einen Dateinamen sowie einen
      Speicherort ein.
    </para>

    <para>Die meisten Berichte, die im HTML-Format vorliegen, können auch kopiert und in eine
      Tabellenkalkulation eingefügt werden.
    </para>

    <para>Der Drucken-Dialog in &app; wird verwendet, um den Drucker auszuwählen, an den der Druckauftrag
      gesendet werden soll, oder um den Bericht in eine Datei, z.B. im
      <acronym>PDF</acronym>-Format, zu drucken.
<!-- FIXME: In Ubuntu Linux, the "Preview" button does not exist. Is this still valid?
        It also contains a <guibutton>Preview</guibutton> button to view the document before printing.
        Er enthält auch eine Schaltfläche <guibutton>Vorschau</guibutton>, mit der Sie das Dokument vor dem Druck ansehen können.
       -->
      Betätigen Sie <guibutton>Drucken</guibutton> um den Auftrag an den ausgewählten Drucker zu
      senden oder <guibutton>Abbrechen</guibutton>, um den Drucken- Dialog zu verlassen.
    </para>

    <para>Aus einem geöffneten Kontenblatt haben Sie die Möglichkeit, mit &mc.rep.acct-rep; einen
      <guilabel>Kontenbericht</guilabel> zu drucken. Dieser listet die Buchungen des Kontos mit
      einer Gesamtsumme auf. Andere Berichte werden so gedruckt, wie sie auf dem Bildschirm
      dargestellt werden.
    </para>
  </sect1>

  <sect1 id="report-create">
    <title>Erstellen oder Ändern von Berichten</title>

    <para>Es ist möglich, bestehende Berichte zu ändern oder eigene Berichte zu schreiben, wenn die
      vorhandenen nicht Ihren Ansprüchen genügen. Dazu müssen Sie
      <application>Guile</application> kennen, die GNOME-Implementierung von
      <emphasis>Scheme</emphasis>, welches eine <acronym>LISP</acronym>-ähnliche Programmiersprache
      ist. Weiterhin ist es sinnvoll, eine Kopie des GnuCash-Quellcodes zur Verfügung zu haben.
    </para>

    <itemizedlist>
      <title>Einleitende Dateien im Quellcode</title>

      <listitem>
        <para><ulink url="&url-gh-gc-stable;gnucash/report/doc/report-html.txt">gnucash/report/doc/report-html.txt</ulink>
          beschreibt die <emphasis>Berichtsschnittstelle</emphasis>.
        </para>
      </listitem>

      <listitem>
        <para><ulink url="&url-gh-gc-stable;gnucash/report/reports/example/sample-report.scm">gnucash/report/reports/example/sample-report.scm</ulink>
          ist ein Beispiel, das verschiedene <emphasis>Arten von Optionen</emphasis> zeigt.
        </para>
      </listitem>
    </itemizedlist>

    <sect2 id="report-api">
      <title>Zugriff auf die &app;-Programmierschnittstelle (<acronym>API</acronym>)</title>

      <para>Um Informationen aus Ihrem &app; Buch für Ihren Bericht zu erhalten, ist es auch notwendig, auf
        Daten aus der &app; Engine zugreifen. Diese Bindung wird von <application>Swig</application>
        erzeugt und basiert auf einer Reihe von Scheme-Wrapper-Funktionen in
        <ulink url="&url-gh-gc-stable;bindings/guile"><filename class='directory'>bindings/guile</filename></ulink>.
        <footnote>
          <para><emphasis>Bis zur Version 2.0.5</emphasis> wurde <application>G-Wrap</application> verwendet und die
            Datei zur Bindung war <filename>src/g-wrap/gnc.html</filename>.
          </para>
        </footnote>
      </para>

      <tip>
        <para>Sehen Sie sich einige der anderen Berichte in
          <ulink url="&url-gh-gc-stable;gnucash/report/"><filename class='directory'>gnucash/report/</filename></ulink>
          an, um zu erfahren, wie sie verwendet werden.
        </para>

        <para>Einige Anwender haben im Wiki unter <ulink url="&url-wiki;Custom-Report" /> Ihre Erfahrungen
          zusammengetragen.
        </para>
      </tip>

      <para>Da die obige Datei nur die Syntax der Funktion enthält, können Sie die nächtliche
        <application>Doxygen</application>-generierte <acronym>API</acronym> Online-Dokumentation
        für den <ulink url="&url-doc-api-stable;">stable branch</ulink> verwenden,
        <footnote id='branch-future'>
          <para>Nach der Implementierung des ersten Features der nächsten <emphasis>größeren</emphasis> Release
            wird auch ein <ulink url="&url-doc-api-future;">future Zweig</ulink> erscheinen.
          </para>
        </footnote>
        um weitere Informationen über die Funktionen zu erhalten.
      </para>

      <para>Nachdem Sie eine <ulink url="&url-wiki;Building">Build-Umgebung</ulink> eingerichtet haben, können
        Sie sie auch lokal erzeugen, indem Sie
<screen>
# make users:
make doc
# ninja users:
ninja doc
</screen>
        in Ihrem Build-Verzeichnis ausführen und dann
        <filename><replaceable>BUILDDIR</replaceable>/libgnucash/doc/html/index.html</filename> mit
        Ihrem bevorzugten Browser öffnen.
      </para>
    </sect2>

    <sect2 id="report-render">
      <title>Darstellung des Berichts</title>

      <para>Gegenwärtig werden Berichte durch den Aufruf einer <acronym>HTML</acronym>-Generierungs-API
        erstellt, die einen <acronym>HTML</acronym>-Dialekt erzeugt und diesen mit einem
        <acronym>HTML</acronym>-Widget anzeigt. Dies hat seine Grenzen, insbesondere wenn es darum
        geht, Objekte genau auszurichten, wie es z. B. für den Druck auf vorgedruckte Rechnungen
        erforderlich sein könnte.
      </para>

      <para>Bitte lesen Sie auch <xref linkend="report-print"/>.
      </para>
    </sect2>
  </sect1>
</chapter>
