index.docbook

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book SYSTEM "gnc-gui-C.dtd">
<!--
      (Do not remove this comment block.)
  Template Maintained by the GNOME Documentation Project:
	  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
<!--
      (Do not remove this comment block.)
  Version: 3.903
  Last modified: 1 June 2020
  Maintainers:
        Gnucash Development Team <gnucash-devel@gnucash.org>
  Translators:
               (translators put your name and email here)
-->
<book id="index" lang="en"
      xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <bookinfo>
    <title>&app; Tutorial and Concepts Guide</title>
    <subtitle>The Didactical Documentation</subtitle>
    <edition>v&manrevision;</edition>
    <titleabbrev>&appname; Guide &manrevision;</titleabbrev>
    <copyright>
      <year>2009-2022</year> <holder>&appname; Documentation Team</holder>
    </copyright>

    <copyright>
      <year>2010-2011</year> <holder>Yawar Amin</holder>
    </copyright>

    <copyright>
      <year>2010</year> <holder>Tom Bullock</holder>
    </copyright>

    <copyright>
      <year>2010-2011</year> <holder>Cristian Marchi</holder>
    </copyright>

    <copyright>
      <year>2006</year> <holder>Chris Lyttle</holder>
    </copyright>

    <copyright>
      <year>2003-2004</year> <holder>Jon Lapham</holder>
    </copyright>

    <copyright>
      <year>2002</year> <holder>Chris Lyttle</holder>
    </copyright>

    <copyright>
      <year>2001</year> <holder>Carol Champagne and Chris Lyttle</holder>
    </copyright>

<!-- translators: uncomment this:
  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
-->

    <publisher>
      <publishername>The &appname; Documentation Team</publishername>
<address>
         <email>gnucash-devel@gnucash.org</email>
       </address>
    </publisher>

    <xi:include href="legal.xml" />

    <authorgroup>
      <author>
        <surname>The &appname; Documentation Team</surname>
      </author>
    </authorgroup>

    <revhistory>
      <revision>
        <revnumber>&appname; Tutorial and Concepts Guide 4.13</revnumber>
        <date>18 December 2022</date>
        <revdescription>
          <para role="author">Multiple authors</para>
          <para role="publisher">&appname; Documentation Team</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>&appname; Tutorial and Concepts Guide 4.12</revnumber>
        <date>25 September 2022</date>
        <revdescription>
          <para role="author">Multiple authors</para>
          <para role="publisher">&appname; Documentation Team</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>&appname; Tutorial and Concepts Guide 4.11</revnumber>
        <date>26 June 2022</date>
        <revdescription>
          <para role="author">Multiple authors</para>
          <para role="publisher">&appname; Documentation Team</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>&appname; Tutorial and Concepts Guide 4.10</revnumber>
        <date>27 March 2022</date>
        <revdescription>
          <para role="author">Multiple authors</para>
          <para role="publisher">&appname; Documentation Team</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>&appname; Tutorial and Concepts Guide 4.9</revnumber>
        <date>19 December 2021</date>
        <revdescription>
          <para role="author">Multiple authors</para>
          <para role="publisher">&appname; Documentation Team</para>
        </revdescription>
      </revision>
      <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.8</revnumber>
      <date>28 September 2021</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision>
      <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.7</revnumber>
      <date>26 September 2021</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision>
      <revision><revnumber>&appname; Tutorial and Concepts Guide 4.6</revnumber>
      <date>27 June 2021</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision><revision><revnumber>&appname; Tutorial and Concepts Guide 4.5</revnumber>
      <date>28 March 2021</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision>
      <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.4</revnumber>
      <date>28 December 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.3</revnumber>
      <date>27 December 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.2</revnumber>
      <date>27 September 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.1</revnumber>
      <date>26 July2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide 4.0</revnumber>
      <date>28 June 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.11</revnumber>
      <date>28 June 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.903</revnumber>
      <date>1 June 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.10</revnumber>
      <date>11 April 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.9</revnumber>
      <date>29 March 2020</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.8</revnumber>
      <date>29 December 2019</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.7</revnumber>
      <date>9 September 2019</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.6</revnumber>
      <date>30 June 2019</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.5</revnumber>
      <date>31 March 2019</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.3</revnumber>
      <date>30 September 2018</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.2</revnumber>
      <date>24 June 2018</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.1</revnumber>
      <date>28 April 2018</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v3.0</revnumber>
      <date>1 April 2018</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.20</revnumber>
      <date>1 April 2018</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.19</revnumber>
      <date>16 December 2017</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.18</revnumber>
      <date>24 September 2017</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.17</revnumber>
      <date>2 July 2017 2017</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.16</revnumber>
      <date>26 March 2017</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.15</revnumber>
      <date>18 December 2016</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.11</revnumber>
      <date>11 January 2016</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.10</revnumber>
      <date>20 December 2015</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.8</revnumber>
      <date>27 September 2015</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.7</revnumber>
      <date>28 June 2015</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.3</revnumber>
      <date>30 March 2014</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.2</revnumber>
      <date>2 March 2014</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.1</revnumber>
      <date>26 January 2014</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.6.0</revnumber>
      <date>29 December 2013</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.4.2</revnumber>
      <date>17 November 2012</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.4.1</revnumber>
      <date>1 July 2011</date>
      <revdescription>
        <para role="author">Multiple authors
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.3.16</revnumber>
      <date>November 7, 2010</date>
      <revdescription>
        <para role="author">Jon Lapham
        </para>

        <para role="author">Bengt Thuree
        </para>

        <para role="author">Dave Herman
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v2.0.0</revnumber>
      <date>July 9, 2006</date>
      <revdescription>
        <para role="author">Jon Lapham
        </para>

        <para role="author">Bengt Thuree
        </para>

        <para role="author">Dave Herman
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v1.8.3</revnumber>
      <date>Aug 2003</date>
      <revdescription>
        <para role="author">Jon Lapham
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v1.8.2</revnumber>
      <date>Aug 2003</date>
      <revdescription>
        <para role="author">Jon Lapham
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v1.8.1</revnumber>
      <date>May 2003</date>
      <revdescription>
        <para role="author">Chris Lyttle
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; Tutorial and Concepts Guide v1.8.0</revnumber>
      <date>Jan 2003</date>
      <revdescription>
        <para role="author">Chris Lyttle
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; User Guide v1.6.5</revnumber> <date>June
      2002</date>
      <revdescription>
        <para role="author">Chris Lyttle
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision> <revision> <revnumber>&appname; User Guide v1.6.0</revnumber> <date>October
      2001</date>
      <revdescription>
        <para role="author">Carol Champagne
        </para>

        <para role="publisher">&appname; Documentation Team
        </para>
      </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>
      This Guide contains a tutorial for using &vers-stable; and describes the concepts behind
      &appname;.
    </releaseinfo>

    <legalnotice>
      <title>Feedback</title>

      <para>To report a bug or make a suggestion regarding the program or this documentation, follow the
        instructions at the <ulink url="&url-bug-wiki;">Bugzilla page of the &appname; wiki</ulink>
        and use the <ulink url="&url-bug-start;">&appname; Bug Tracking System</ulink>. At first you
        want to <ulink url="&url-bug-browse;">browse</ulink> or
        <ulink url="&url-bug-search;">search</ulink> it for already existing bugs. Select the
        product <emphasis>&appname;</emphasis> for the program or <emphasis>Documentation</emphasis>
        for any parts of this documentation.
      </para>
<!-- Translators may also add here a feedback address for translations. -->
    </legalnotice>
  </bookinfo>

  <preface id="authors">
    <title>About the Authors</title>

    <para>The &appname; Documentation Team is a self-designated group of &app; users and developers who have
      volunteered to write this documentation for the benefit of the broader user base. People who
      are interested in joining this group are encouraged to express their interest on the &appname;
      lists (<email>gnucash-users</email> and <email>gnucash-devel</email>) for further direction.
    </para>

    <para>Contributors on the team so far have been:
      <author>
        <firstname>Yawar</firstname> <surname>Amin</surname>
      </author>
      ,
      <author>
        <firstname>J. Alex</firstname> <surname>Aycinena</surname>
      </author>
      ,
      <author>
        <firstname>Tom</firstname> <surname>Bullock</surname>
      </author>
      ,
      <author>
        <firstname>Carol</firstname> <surname>Champagne</surname>
      </author>
      ,
      <author>
        <firstname>Frank</firstname> <othername role='mi'>H.</othername>
        <surname>Ellenberger</surname>
      </author>
      ,
      <author>
        <firstname>Mike</firstname> <surname>Evans</surname>
      </author>
      ,
      <author>
        <firstname>Chris</firstname> <surname>Good</surname>
      </author>
      ,
      <author>
        <firstname>Dave</firstname> <surname>Herman</surname>
      </author>
      ,
      <author>
        <firstname>Geert</firstname> <surname>Janssens</surname>
      </author>
      ,
      <author>
        <firstname>Jon</firstname> <surname>Lapham</surname>
      </author>
      ,
      <author>
        <firstname>Chris</firstname> <surname>Lyttle</surname>
      </author>
      ,
      <author>
        <firstname>Cristian</firstname> <surname>Marchi</surname>
      </author>
      ,
      <author>
        <firstname>John</firstname> <surname>Ralls</surname>
      </author>
      ,
      <author>
        <firstname>Robert</firstname> <surname>Ratliff</surname>
      </author>
      ,
      <author>
        <firstname>Christian</firstname> <surname>Stimming</surname>
      </author>
      ,
      <author>
        <firstname>David</firstname> <surname>T.</surname>
      </author>
      , and
      <author>
        <firstname>Bengt</firstname> <surname>Thuree</surname>
      </author>
      .
    </para>
<!-- This is the appropriate place for other contributors: translators,
  maintainers,  etc. Commented out by default.
  Note: Do not use the addess tag, if you do not want to be contacted
        with user questions over decades. -->
<!-- 
  <para>This - still incomplete - translation was created by the
    Latin &appname; translation team, which included until now
    <othercredit role="translator">
      <firstname>Latin</firstname>
      <surname>Translator 1</surname>
      <affiliation>
        <orgname>Latin &appname; Translation Team</orgname>
        <address> <email>translator@gnome.org</email> </address>
      </affiliation>
      <contrib>Latin translation</contrib>
    </othercredit>.
  </para>
-->
  </preface>

    <xi:include href="ch_oview.xml" />

  <part id="part.getting_started">
    <title>The Basic Knowledge</title>

    <xi:include href="ch_basics.xml" />

    <xi:include href="ch_importing.xml" />

    <xi:include href="ch_configuring.xml" />
  </part>

  <part id="part.managing_personal">
    <title>The Common Usage</title>

    <xi:include href="ch_cbook.xml" />

    <xi:include href="ch_expenses.xml" />

    <xi:include href="ch_cc.xml" />

    <xi:include href="ch_loans.xml" />

    <xi:include href="ch_invest.xml" />

    <xi:include href="ch_reports.xml" />

    <xi:include href="ch_capgain.xml" />

    <xi:include href="ch_currency.xml" />
  </part>

  <part id="part.managing_business">
    <title>The Advanced Features</title>

    <xi:include href="ch_bus_features.xml" />

    <xi:include href="ch_budgets.xml" />

    <xi:include href="ch_oth_assets.xml" />

    <xi:include href="ch_dep.xml" />

    <xi:include href="ch_python_bindings.xml" />

    <xi:include href="ch_import_business_data.xml" />
  </part>

  <part id="part.appendices">
    <title>Appendices</title>

    <xi:include href="gnc-glossary.xml" />

    <xi:include href="appendixa.xml" />

    <xi:include href="appendixd.xml" />

    <xi:include href="fdl-appendix.xml" />
  </part>
</book>