gnucash-docs maint: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Thu Feb 4 23:26:26 EST 2021
Updated via https://github.com/Gnucash/gnucash-docs/commit/cad4c52f (commit)
via https://github.com/Gnucash/gnucash-docs/commit/b196754d (commit)
from https://github.com/Gnucash/gnucash-docs/commit/4e075f93 (commit)
commit cad4c52f1eb412ff221297c9bf331916de1b03fe
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Fri Feb 5 05:25:13 2021 +0100
Update links about tax report …
diff --git a/help/C/Help_ch_Account-Actions.xml b/help/C/Help_ch_Account-Actions.xml
index 51f7b19..ee6a4f3 100644
--- a/help/C/Help_ch_Account-Actions.xml
+++ b/help/C/Help_ch_Account-Actions.xml
@@ -389,7 +389,7 @@
flagged to be included in the Tax Schedule Report. This flag is only displayed on the <guilabel>Edit
Account</guilabel> dialog and is set in the <guilabel>Income Tax Information</guilabel> dialog
(<menuchoice><guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem></menuchoice>).
- See the Tax Schedule Report and <acronym>TXF</acronym> Export section in Reports Chapter (<xref linkend="report-general"></xref>).</para>
+ For related reports see the examples like <guilabel>Tax Schedule Report and TXF Export</guilabel> in (<xref linkend="report-regional"/>).</para>
<para>The <guilabel>Placeholder</guilabel> check-box sets an account to read-only status and
prevents the addition of transaction data to the account.</para>
diff --git a/help/C/Help_ch_Customize.xml b/help/C/Help_ch_Customize.xml
index 20ecd18..2aadbbf 100644
--- a/help/C/Help_ch_Customize.xml
+++ b/help/C/Help_ch_Customize.xml
@@ -2345,8 +2345,10 @@
<sect1 id="set-tax-options">
<title>Setting Tax Report Options</title>
- <abstract><para>The tax report can be used to prepare online tax reports in the
- USA.</para></abstract>
+ <abstract><para>The tax report can be used to prepare online tax reports for
+ specific countries, see <xref linkend="report-regional"/>.
+ Currently US and partial DE are supported.</para>
+ </abstract>
<note><title>Localization</title>
<para>Before it can be used in other regions, one needs to provide a
@@ -2357,95 +2359,81 @@
<!-- Translators: you can stop here to translate. After you created or got a
localized taxtable describe the options, which your report requires. -->
- <para>The Income Tax Information dialog is used to set Tax Report Options.
+ <para>The <guilabel>Income Tax Information</guilabel> dialog is used to set Tax Report Options.
The settings on accounts in this dialog are used by the <acronym>TXF</acronym> Export function
in reports to select the accounts for export. To access this dialog go to
- <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Tax Report Options</guimenuitem></menuchoice>.</para>
+ <menuchoice><guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Ta<accel>x</accel> Report Options</guimenuitem></menuchoice>.</para>
- <para>If the Income Tax features are used, it is strongly recommended that
+ <tip><para>If the Income Tax features are used, it is strongly recommended that
the <guilabel>Tax Info</guilabel> column be made visible on the accounts tab (click large
downward-pointing arrow and select <guilabel>Tax Info</guilabel> check box). The <guilabel>Tax Info</guilabel>
column will display the Form/Schedule and tax category (e.g., <guilabel>Schedule D
Dividend, cap gain distrib.</guilabel>) assigned to an account, if any. Alternatively,
it will display the following error messages which can be corrected through
- <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Tax Report Options</guimenuitem></menuchoice></para>
-
- <itemizedlist>
+ <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Tax Report Options</guimenuitem></menuchoice>:
+ <itemizedlist spacing="compact">
<listitem>
<para>Tax-related but has no tax code</para>
</listitem>
-
<listitem>
<para>Tax entity type not specified</para>
</listitem>
-
<listitem>
<para>Tax type "tax_type": invalid code "code" for account type"</para>
</listitem>
-
<listitem>
<para>Not tax-related; tax type "tax_type": invalid code "code" for
account type</para>
</listitem>
-
<listitem>
<para>Invalid code "code" for tax type "tax_type"</para>
</listitem>
-
<listitem>
<para>Not tax-related; invalid code "code" for tax type "tax_type"</para>
</listitem>
-
<listitem>
<para>No form: code "code", tax type "tax_type"</para>
</listitem>
-
<listitem>
<para>Not tax-related; no form: code "code", tax type "tax_type"</para>
</listitem>
-
<listitem>
<para>No description: form "form", code "code", tax type "tax_type"</para>
</listitem>
-
<listitem>
<para>Not tax-related; no description: form "form", code "code", tax
type "tax_type"</para>
</listitem>
-
<listitem>
<para>Not tax-related; "form"("copy") "desc" (code "code", tax type
"tax_type")</para>
</listitem>
</itemizedlist>
+ </para></tip>
<para>The Income Tax Identity must be set in order to assign codes to
individual accounts. Click <guibutton>Edit</guibutton> to set the identity. The Tax Name is
optional. If entered, it will be printed at the top of the report. A
<guilabel>Type</guilabel> must be selected in order to activate the tax category
- selections. The choices are:</para>
-
- <itemizedlist>
- <listitem>
- <para>Individual, Joint, etc. - Files US Form 1040 Tax Return </para>
- </listitem>
-
- <listitem>
- <para>Partnership - Files US Form 1065 Tax Return</para>
- </listitem>
-
- <listitem>
- <para>Corporation - Files US Form 1120 Tax Return</para>
- </listitem>
-
- <listitem>
- <para>S Corporation - Files US Form 1120S Tax Return</para>
- </listitem>
-
- <listitem>
- <para>None - No Income Tax Options Provided</para>
- </listitem>
- </itemizedlist>
+ selections. The choices are:
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Individual, Joint, etc. - Files US Form 1040 Tax Return </para>
+ </listitem>
+ <listitem>
+ <para>Partnership - Files US Form 1065 Tax Return</para>
+ </listitem>
+ <listitem>
+ <para>Corporation - Files US Form 1120 Tax Return</para>
+ </listitem>
+ <listitem>
+ <para>S Corporation - Files US Form 1120S Tax Return</para>
+ </listitem>
+ <listitem>
+ <para>None - No Income Tax Options Provided</para>
+ </listitem>
+ </itemizedlist>
+ </para>
<para>While the Income Tax Entity Type can be changed after tax categories
have been assigned to accounts, you should be cautioned that you will need
@@ -2660,7 +2648,7 @@
</sect1>
<sect1 id="chang-lang">
- <title>Changing the Language</title>
+ <title>Changing the Language or Region</title>
<para>The language of the &app; user interface is not modifiable
directly from the program’s preferences.</para>
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index b28f2a2..2b2d90a 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -444,7 +444,7 @@
<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 stable version 3.0 <emphasis>Detail Level</emphasis>
+ <para>Before &app; 3.0 <emphasis>Detail Level</emphasis>
was called <emphasis>Style</emphasis> on the General tab.</para>
</footnote>: One of</para>
<informaltable>
@@ -1653,6 +1653,13 @@ Income (type INCOME)
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
+ <menuchoice><guimenu><accel>E</accel>dit</guimenu><guimenuitem>Ta<accel>x</accel> Report Options</guimenuitem></menuchoice>.
+ 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>
@@ -1661,14 +1668,8 @@ Income (type INCOME)
<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>
-
- <note><para>For this to work, the user has to segregate taxable and non taxable
- income to different accounts, as well as deductible and non deductible expenses.
- The Income Tax Information dialog is used for this. To access the Income Tax
- Information dialog go to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem></menuchoice>. The user
- also must set the <acronym>TXF</acronym> category of each tax related account. The Income Tax
- Information dialog is described in the <xref linkend="set-tax-options"></xref> section.</para></note>
</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>
commit b196754d0fb3587f2213e6763cc0726f836450ad
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Fri Feb 5 01:12:38 2021 +0100
New section "Country Specific Reports"
Moved US:TXF, added de:ElStEr
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index 47b4801..b28f2a2 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -329,8 +329,7 @@
<title>General Reports</title>
<para>The General Reports include the Account Summary Report, the Future
- Scheduled Transactions Summary, the Tax Schedule Report and <acronym>
- TXF</acronym> Export, and the Transaction Report and also the reports in the Sample & Custom menu.</para>
+ Scheduled Transactions Summary, and the Transaction Report and also the reports in the Sample & Custom menu.</para>
<sect3>
<title>Account Summary</title>
@@ -342,23 +341,6 @@
<para> </para>
</sect3>
- <sect3 id="report-taxreport">
- <title>Tax Schedule Report and <acronym>TXF</acronym> Export</title>
- <para>The tax schedule report lists all taxable income and deductible expense amounts used in the preparation of US Income Tax returns. The purpose of the report is to provide a complete audit trail for these amounts. The report is intended to be used by a tax payer to manually prepare his or her own tax return, or alternatively, to be provided to a tax preparer for that purpose. The report can also be used to generate an export of all tax related income and expenses to a <acronym>TXF</acronym> (Tax eXchange Format) file (this is in addition to exporting to the <acronym>HTML</acronym> format that all reports allow). The <acronym>TXF</acronym> file can be imported into tax filing programs such as TaxCut or TurboTax. The report should be run, inspected carefully for errors or omissions, and then corrections made to transactions, report settings, currency conversion rates or the account structure as needed. This process should be repeated as often as needed until all the amounts on the report are correct before a final version is used and saved along with the tax returns.</para>
-
- <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>
-
- <note><para>For this to work, the user has to segregate taxable and non taxable
- income to different accounts, as well as deductible and non deductible expenses.
- The Income Tax Information dialog is used for this. To access the Income Tax
- Information dialog go to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem></menuchoice>. The user
- also must set the <acronym>TXF</acronym> category of each tax related account. The Income Tax
- Information dialog is described in the <xref linkend="set-tax-options"></xref> section.</para></note>
-
- </sect3>
-
<sect3>
<title>Transaction Report</title>
@@ -720,7 +702,7 @@
<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">
+ <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.
@@ -1515,7 +1497,6 @@ Income (type INCOME)
<title>Vendor Report</title>
<para> </para>
</sect3>
-
</sect2>
<sect2 id="report-income">
@@ -1666,7 +1647,36 @@ Income (type INCOME)
</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>
+ <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>
+
+ <note><para>For this to work, the user has to segregate taxable and non taxable
+ income to different accounts, as well as deductible and non deductible expenses.
+ The Income Tax Information dialog is used for this. To access the Income Tax
+ Information dialog go to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem></menuchoice>. The user
+ also must set the <acronym>TXF</acronym> category of each tax related account. The Income Tax
+ Information dialog is described in the <xref linkend="set-tax-options"></xref> section.</para></note>
+ </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">
Summary of changes:
help/C/Help_ch_Account-Actions.xml | 2 +-
help/C/Help_ch_Customize.xml | 72 ++++++++++++++++----------------------
help/C/Help_ch_Reports.xml | 55 +++++++++++++++++------------
3 files changed, 64 insertions(+), 65 deletions(-)
More information about the gnucash-changes
mailing list