r19615 - gnucash-docs/trunk/help/C - Update help manual to reflect partial support of capital gains for US Income Tax reporting and TXF exporting for code 673.
J. Alex Aycinena
alex.aycinena at code.gnucash.org
Mon Sep 27 00:58:09 EDT 2010
Author: alex.aycinena
Date: 2010-09-27 00:58:09 -0400 (Mon, 27 Sep 2010)
New Revision: 19615
Trac: http://svn.gnucash.org/trac/changeset/19615
Modified:
gnucash-docs/trunk/help/C/Help_ch_Customize.xml
gnucash-docs/trunk/help/C/Help_txf-categories.xml
Log:
Update help manual to reflect partial support of capital gains for US Income Tax reporting and TXF exporting for code 673.
Modified: gnucash-docs/trunk/help/C/Help_ch_Customize.xml
===================================================================
--- gnucash-docs/trunk/help/C/Help_ch_Customize.xml 2010-09-27 04:19:24 UTC (rev 19614)
+++ gnucash-docs/trunk/help/C/Help_ch_Customize.xml 2010-09-27 04:58:09 UTC (rev 19615)
@@ -1,7 +1,8 @@
<!--
(Do not remove this comment block.)
Version: 2.0.1
- Last modified: December 7th 2009
+ Last modified: September 26th 2010
+ modified: December 7th 2009
modified: August 2nd 2008
modified: March 21th 2007
modified: August 2nd 2006
@@ -864,7 +865,7 @@
<sect1 id="change-style">
<title>Changing Style Sheets</title>
- <para>GnuCash has three default style sheets for web-page reports. These style sheets can
+ <para>GnuCash has four default style sheets for web-page reports. These style sheets can
be altered by using the HTML Style Sheets editor. To access the editor go to <guimenu>Edit ->
Style Sheets...</guimenu></para>
@@ -883,26 +884,84 @@
<sect2 id="style-default">
<title>Default Style Sheet</title>
- <para>The Default Style Sheet has two tabs to alter the appearance of reports utilizing
- it, General and Tables. </para>
+ <para>The Default Style Sheet has four tabs to alter the appearance of
+ reports utilizing it, Colors, Fonts, General and Tables. </para>
+ <sect3 id="style-def-color">
+ <title>Colors Tab</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the
+ color picker to choose a color that will be applied to alternate
+ table rows.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
+ <sect3 id="style-def-fonts">
+ <title>Fonts Tab</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Title:</guilabel> Select the font and size for
+ Titles.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Account Link:</guilabel> Select the font and size
+ for Account Links.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Cell:</guilabel> Select the font and size
+ for Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Negative Values in Red:</guilabel> Select to have
+ negative values displayed in red.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Cell:</guilabel> Select the font and size
+ for Text Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Number Cell:</guilabel> Select the font and
+ size for Total Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Label Cell:</guilabel> Select the font and
+ size for Total Label Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Centered Label Cell:</guilabel> Select the font and
+ size for Centered Label Cells.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
<sect3 id="style-def-general">
<title>General Tab</title>
<itemizedlist>
<listitem>
- <para><guilabel>Background Color:</guilabel> Opens the color picker to choose
- a new color.</para>
+ <para><guilabel>Background Color:</guilabel> Opens the color picker
+ to choose a new background color.</para>
</listitem>
<listitem>
- <para><guilabel>Background Pixmap:</guilabel> Use the Browse button to select a
- picture to use as the background in reports.</para>
+ <para><guilabel>Background Pixmap:</guilabel> Use the Browse button
+ to select a picture to use as the background in reports.</para>
</listitem>
<listitem>
- <para><guilabel>Enable Links:</guilabel> Select this to enable blue hyperlinks
- in reports.</para>
+ <para><guilabel>Enable Links:</guilabel> Select this to enable
+ blue hyperlinks in reports.</para>
</listitem>
</itemizedlist>
</sect3>
@@ -917,13 +976,13 @@
</listitem>
<listitem>
- <para><guilabel>Table cell padding:</guilabel> Sets the padding between table
- cells</para>
+ <para><guilabel>Table cell padding:</guilabel> Sets the space
+ between table cell edges and content</para>
</listitem>
<listitem>
- <para><guilabel>Table border width:</guilabel> Sets the width of the borders on
- tables.</para>
+ <para><guilabel>Table border width:</guilabel> Sets the width of
+ the borders on tables.</para>
</listitem>
</itemizedlist>
@@ -933,61 +992,115 @@
<sect2 id="style-easy">
<title>Easy Style Sheet</title>
- <para>The Easy Style Sheet has four tabs to alter the appearance of reports, Colors,
- General, Images and Tables.</para>
+ <para>The Easy Style Sheet has five tabs to alter the appearance of
+ reports: Colors, Fonts, General, Images and Tables.</para>
<sect3 id="style-easy-colors">
<title>Colors</title>
<itemizedlist>
<listitem>
- <para><guilabel>Background Color:</guilabel> Opens the color picker to choose a
- new color.</para>
+ <para><guilabel>Background Color:</guilabel> Opens the color picker
+ to choose a new background color.</para>
</listitem>
<listitem>
- <para><guilabel>Text Color:</guilabel> Opens the color picker to choose a new
- color.</para>
+ <para><guilabel>Text Color:</guilabel> Opens the color picker to
+ choose a new text color.</para>
</listitem>
<listitem>
- <para><guilabel>Link Color:</guilabel> Opens the color picker to choose a new
- color.</para>
+ <para><guilabel>Text Cell Color:</guilabel> Opens the color picker
+ to choose a new text cell color.</para>
</listitem>
<listitem>
- <para><guilabel>Table Cell Color:</guilabel> Opens the color picker to choose a
- new color.</para>
+ <para><guilabel>Link Color:</guilabel> Opens the color picker to
+ choose a new link color.</para>
</listitem>
<listitem>
- <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the color picker to
- choose a new color.</para>
+ <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the
+ color picker to choose a new color for alternate table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Subheading/Subtotal Cell Color:</guilabel> Opens the color picker
- to choose a new color.</para>
+ <para><guilabel>Subheading/Subtotal Cell Color:</guilabel> Opens
+ the color picker to choose a new color for subheading/subtotal
+ table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Sub-subheading/total Cell Color:</guilabel> Opens the color
- picker to choose a new color.</para>
+ <para><guilabel>Sub-subheading/total Cell Color:</guilabel> Opens
+ the color picker to choose a new color for sub-subheading/total
+ table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Grand Total Cell Color:</guilabel> Opens the color picker to
- choose a new color.</para>
+ <para><guilabel>Grand Total Cell Color:</guilabel> Opens the color
+ picker to choose a new color for grand total rows.</para>
</listitem>
</itemizedlist>
</sect3>
+ <sect3 id="style-easy-fonts">
+ <title>Fonts</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Title:</guilabel> Select the font and size for
+ Titles.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Account Link:</guilabel> Select the font and size
+ for Account Links.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Cell:</guilabel> Select the font and size
+ for Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Negative Values in Red:</guilabel> Select to have
+ negative values displayed in red.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Header:</guilabel> Select the font and size
+ for Number Header table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Cell:</guilabel> Select the font and size
+ for Text Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Number Cell:</guilabel> Select the font and
+ size for Total Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Label Cell:</guilabel> Select the font and
+ size for Total Label Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Centered Label Cell:</guilabel> Select the font and
+ size for Centered Label Cells.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
<sect3 id="style-easy-general">
<title>General</title>
<itemizedlist>
<listitem>
- <para><guilabel>Preparer:</guilabel> Name of the person preparing the report.
+ <para><guilabel>Preparer:</guilabel> Name of the person preparing
+ the report.
</para>
</listitem>
@@ -1047,8 +1160,8 @@
</listitem>
<listitem>
- <para><guilabel>Table cell padding:</guilabel> Sets the padding between table
- cells</para>
+ <para><guilabel>Table cell padding:</guilabel> Sets the space
+ between table cell edges and contents</para>
</listitem>
<listitem>
@@ -1059,59 +1172,300 @@
</sect3>
</sect2>
+ <sect2 id="style-footer">
+ <title>Footer Style Sheet</title>
+
+ <para>The Footer Style Sheet has the same five tabs to alter the
+ appearance of reports as the Easy Style Sheets: Colors, Fonts, General,
+ Images and Tables.</para>
+
+ <sect3 id="style-footer-colors">
+ <title>Colors</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Background Color:</guilabel> Opens the color picker
+ to choose a new background color.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Color:</guilabel> Opens the color picker to
+ choose a new text color.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Cell Color:</guilabel> Opens the color picker
+ to choose a new text cell color.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Link Color:</guilabel> Opens the color picker to
+ choose a new link color.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the
+ color picker to choose a new color for alternate table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Subheading/Subtotal Cell Color:</guilabel> Opens
+ the color picker to choose a new color for subheading/subtotal
+ table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Sub-subheading/total Cell Color:</guilabel> Opens
+ the color picker to choose a new color for sub-subheading/total
+ table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Grand Total Cell Color:</guilabel> Opens the color
+ picker to choose a new color for grand total rows.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
+ <sect3 id="style-footer-fonts">
+ <title>Fonts</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Title:</guilabel> Select the font and size for
+ Titles.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Account Link:</guilabel> Select the font and size
+ for Account Links.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Cell:</guilabel> Select the font and size
+ for Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Negative Values in Red:</guilabel> Select to have
+ negative values displayed in red.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Header:</guilabel> Select the font and size
+ for Number Header table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Cell:</guilabel> Select the font and size
+ for Text Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Number Cell:</guilabel> Select the font and
+ size for Total Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Label Cell:</guilabel> Select the font and
+ size for Total Label Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Centered Label Cell:</guilabel> Select the font and
+ size for Centered Label Cells.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
+ <sect3 id="style-footer-general">
+ <title>General</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Preparer:</guilabel> Name of the person preparing
+ the report.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Prepared for:</guilabel> Name of Organization or Company the
+ report is prepared for.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Show preparer info:</guilabel> Show the Preparer information in
+ the report.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Enable Links:</guilabel> Select this to enable blue hyperlinks
+ in reports.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Footer:</guilabel> Text to be included in report
+ footer.</para>
+ </listitem>
+
+ </itemizedlist>
+ </sect3>
+
+ <sect3 id="style-footer-images">
+ <title>Images</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Background Tile:</guilabel> Use the Browse button to select a
+ picture to use as the background in reports. The "Clear" button will clear the
+ selection.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Heading Banner:</guilabel> Use the Browse button to select a
+ picture to use as the heading in reports. The "Clear" button will clear the
+ selection.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Heading Alignment:</guilabel> Select from pull-down list; Left,
+ Right, Center, to specify the alignment of the banner at top of report(s).</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Logo:</guilabel> Use the Browse button to select a picture to
+ use as the logo in reports. The "Clear" button will clear the selection.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
+ <sect3 id="style-footer-tables">
+ <title>Tables</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Table cell spacing:</guilabel> Sets the space between table
+ cells</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Table cell padding:</guilabel> Sets the space
+ between table cell edges and contents</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Table border width:</guilabel> Sets the width of
+ the borders on tables.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+ </sect2>
+
<sect2 id="style-technicolor">
<title>Technicolor Style Sheet</title>
- <para>The Technicolor Style Sheet has four tabs to alter the appearance of reports,
- Colors, General, Images and Tables.</para>
+ <para>The Technicolor Style Sheet has has five tabs to alter the
+ appearance of reports: Colors, Fonts, General, Images and Tables.</para>
<sect3 id="style-tech-colors">
<title>Colors</title>
<itemizedlist>
<listitem>
- <para><guilabel>Background Color:</guilabel> Opens the color picker to choose a
- new color.</para>
+ <para><guilabel>Background Color:</guilabel> Opens the color picker
+ to choose a new background color.</para>
</listitem>
<listitem>
- <para><guilabel>Text Color:</guilabel> Opens the color picker to choose a new
- color.</para>
+ <para><guilabel>Text Color:</guilabel> Opens the color picker to
+ choose a new text color.</para>
</listitem>
<listitem>
- <para><guilabel>Link Color:</guilabel> Opens the color picker to choose a new
- color.</para>
+ <para><guilabel>Text Cell Color:</guilabel> Opens the color picker
+ to choose a new text cell color.</para>
</listitem>
<listitem>
- <para><guilabel>Table Cell Color:</guilabel> Opens the color picker to choose a
- new color.</para>
+ <para><guilabel>Link Color:</guilabel> Opens the color picker to
+ choose a new link color.</para>
</listitem>
<listitem>
- <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the color picker to
- choose a new color.
- </para>
+ <para><guilabel>Alternate Table Cell Color:</guilabel> Opens the
+ color picker to choose a new color for alternate table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Subheading/Subtotal Cell Color:</guilabel> Opens the color picker
- to choose a new color.</para>
+ <para><guilabel>Subheading/Subtotal Cell Color:</guilabel> Opens
+ the color picker to choose a new color for subheading/subtotal
+ table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Sub-subheading/total Cell Color:</guilabel> Opens the color
- picker to choose a new color.</para>
+ <para><guilabel>Sub-subheading/total Cell Color:</guilabel> Opens
+ the color picker to choose a new color for sub-subheading/total
+ table rows.</para>
</listitem>
<listitem>
- <para><guilabel>Grand Total Cell Color:</guilabel> Opens the color picker to
- choose a new color for the grand total cell.</para>
+ <para><guilabel>Grand Total Cell Color:</guilabel> Opens the color
+ picker to choose a new color for grand total rows.</para>
</listitem>
</itemizedlist>
</sect3>
+ <sect3 id="style-tech-fonts">
+ <title>Fonts</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Title:</guilabel> Select the font and size for
+ Titles.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Account Link:</guilabel> Select the font and size
+ for Account Links.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Cell:</guilabel> Select the font and size
+ for Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Negative Values in Red:</guilabel> Select to have
+ negative values displayed in red.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Number Header:</guilabel> Select the font and size
+ for Number Header table rows.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Text Cell:</guilabel> Select the font and size
+ for Text Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Number Cell:</guilabel> Select the font and
+ size for Total Number Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Total Label Cell:</guilabel> Select the font and
+ size for Total Label Cells.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Centered Label Cell:</guilabel> Select the font and
+ size for Centered Label Cells.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+
<sect3 id="style-tech-general">
<title>General</title>
@@ -1177,8 +1531,8 @@
</listitem>
<listitem>
- <para><guilabel>Table cell padding:</guilabel> Sets the padding between table
- cells</para>
+ <para><guilabel>Table cell padding:</guilabel> Sets the space
+ between table cell edges and cell contents</para>
</listitem>
<listitem>
@@ -1194,15 +1548,18 @@
<sect1 id="set-tax-options">
<title>Setting Tax Report Options</title>
- <para>The Income Tax Information dialog is used to set Tax Report Options. The settings
- on accounts in this dialog are used by the TXF Export function in reports to select the
- accounts for export. To access this dialog go to Edit -> Tax Report Options.</para>
+ <para>The Income Tax Information dialog is used to set Tax Report Options.
+ The settings on accounts in this dialog are used by the TXF Export function
+ in reports to select the accounts for export. To access this dialog go to
+ Edit -> Tax Report Options.</para>
- <para>If the Income Tax features are used, it is strongly recommended that the 'Tax Info'
- column be made visible on the accounts tab (click large downward-pointing arrow and
- select 'Tax Info' checkbox). The 'Tax Info' column will display the Form/Schedule and
- tax category assigned to an account, if any. Alternatively, it will display the following
- error messages which can be corrected through Edit -> Tax Report Options:</para>
+ <para>If the Income Tax features are used, it is strongly recommended that
+ the 'Tax Info' column be made visible on the accounts tab (click large
+ downward-pointing arrow and select 'Tax Info' check box). The 'Tax Info'
+ column will display the Form/Schedule and tax category (e.g., 'Schedule D
+ Dividend, cap gain distrib.') assigned to an account, if any. Alternatively,
+ it will display the following error messages which can be corrected through
+ Edit -> Tax Report Options:</para>
<itemizedlist>
<listitem>
@@ -1218,7 +1575,8 @@
</listitem>
<listitem>
- <para>Not tax-related; tax type "tax_type": invalid code "code" for account type</para>
+ <para>Not tax-related; tax type "tax_type": invalid code "code" for
+ account type</para>
</listitem>
<listitem>
@@ -1242,17 +1600,20 @@
</listitem>
<listitem>
- <para>Not tax-related; no description: form "form", code "code", tax type "tax_type"</para>
+ <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>
+ <para>Not tax-related; "form"("copy") "desc" (code "code", tax type
+ "tax_type")</para>
</listitem>
</itemizedlist>
- <para>The Income Tax Identity must be set in order to assign codes to individual accounts.
- Click 'Edit' to set the identity. The Tax Name is optional. If entered, it will be printed
- at the top of the report. A 'type' must be selected in order to activate the tax category
+ <para>The Income Tax Identity must be set in order to assign codes to
+ individual accounts. Click 'Edit' to set the identity. The Tax Name is
+ optional. If entered, it will be printed at the top of the report. A
+ 'type' must be selected in order to activate the tax category
selections. The choices are:</para>
<itemizedlist>
@@ -1277,54 +1638,82 @@
</listitem>
</itemizedlist>
- <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 to manually change
- each one if you do so, which could be quite tedious. The tax categories are unique for
- each Income Tax Entity Type, so changing the type will make all previously assigned
- categories invalid. It is assumed that each gnucash file is for only one type of tax
- entity. You should not keep, for example, personal and partnership accounts mixed in
- one gnucash file if you plan to use the Income Tax Reporting features.</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
+ to manually change each one if you do so, which could be quite tedious.
+ The tax categories are unique for each Income Tax Entity Type, so changing
+ the type will make all previously assigned categories invalid. It is assumed
+ (and highly recommended) that each GnuCash file is for only one tax entity
+ and this is where you specify its type of tax entity. You should not keep,
+ for example, personal and partnership accounts mixed in one GnuCash file
+ if you plan to use the Income Tax Reporting features.</para>
- <para>A given TXF code can be assigned to multiple accounts. The Tax Schedule Report will
- combine accounts by code and generate a detailed TXF record for each account and a
- summary TXF record for the total as calculated by the report. For codes for which
- the "Payer Name Source" is not grayed, the payer on the TXF record will be based on
- what is specified here, either the account name of the account or the account name
- of the account's parent account. This feature is typically used for interest accounts
- or stocks or mutual funds that pay dividends where the individual payees are shown on
- the tax schedule. Some tax Forms/Schedules need to have multiple copies filed under
- some circumstances (for example, Schedule C if a taxpayer and spouse have seperate
- businesses). For tax categories on these Forms/Schedules, the 'Copy Number' is not
- greyed out and can be used to segregate accounts by copy number.</para>
+ <para>A given TXF code can be assigned to multiple accounts. The Tax Schedule
+ Report will combine accounts by code and generate a detailed TXF record for
+ each account and a summary TXF record for the total as calculated by the
+ report.</para>
+ <para>For codes for which the "Payer Name Source" is not grayed, the payer
+ on the TXF record will be based on what is specified here, either the
+ account name of the account or the account name of the account's parent
+ account. This feature is typically used for interest accounts or stocks or
+ mutual funds that pay dividends where the individual payees are shown on
+ the tax schedule. For example, if the parent account's name is the name of
+ your broker and the sub-account's names are the names of individual stocks
+ that pay dividends and the name on the 1099-DIV received is that of the
+ broker, in order to match that name, you would select 'Parent Account';
+ the total dividends from the broker would be exported and, if you had
+ several brokers, there would be an amount exported and a subtotal for each
+ broker, along with each brokers name. Alternatively, if you had a parent
+ account named 'Directly Held', for example, and below it sub-accounts for
+ one or more stocks, you would receive a 1099-DIV from the issuer of each
+ stock separately and, in order to match that name, you would select
+ 'Current Account'; the total dividends from each stock would be exported
+ and, if you had several stocks, there would be an amount exported and a
+ subtotal for each stock, along with each stock's name as the payer.</para>
+
+ <para>Some tax Forms/Schedules need to have multiple copies filed under
+ some circumstances (for example, Schedule C if a taxpayer and spouse have
+ separate businesses). For tax categories on these Forms/Schedules, the
+ 'Copy Number' is not grayed out and can be used to segregate accounts by
+ copy number.</para>
+
<itemizedlist>
<listitem>
- <para>Accounts: This pane contains the list of accounts. Select an account to set a
- TXF category. If no account is selected nothing is changed. If multiple accounts
- are selected, all of the accounts will be set to the selected item. </para>
+ <para>Accounts: This pane contains the list of accounts. Select an
+ account to set a TXF category. If no account is selected nothing is
+ changed. If multiple accounts are selected, all of the accounts will
+ be set to the selected item. </para>
</listitem>
<listitem>
- <para>Tax Related: Select this check-box to add tax information to an account then
- select the TXF Category below.</para>
+ <para>Tax Related: Select this check-box to add tax information to an
+ account then select the TXF Category below. This setting is displayed
+ on the account edit dialogue but cannot be changed from there.</para>
</listitem>
<listitem>
- <para>TXF Categories: Select the desired one. A detailed description appears just
- below.</para>
+ <para>TXF Categories: Select the desired one. A detailed description
+ appears just below (if available, otherwise it says 'No help
+ available'), along with the TXF code for the category and information
+ about what line number on the form or schedule the amounts are
+ included in by tax year (used for detailed sort on report).</para>
</listitem>
<listitem>
- <para>Payer Name Source: A text description that is exported along with the value
- of the account. This is usually the name of a bank, stock, or mutual fund that pays
- dividends or interest. Occasionally, it is a description of a deduction.</para>
+ <para>Payer Name Source: Select an option to determine where the text
+ description that is exported along with the value of the account is
+ derived from, as described above. This is usually the name of a bank,
+ stock, or mutual fund that pays dividends or interest. Occasionally,
+ it is a description of a deduction.</para>
</listitem>
<listitem>
<para>Copy Number: A copy number that is exported along with the value
- of the account. This is used to segregate amounts between different copies of the
- same Form/Schedule that may need to be filed (e.g., Schedule C(1), Schedule C(2),
- etc.).</para>
+ of the account. This is used to segregate amounts between different
+ copies of the same Form/Schedule that may need to be filed (e.g.,
+ Schedule C(1), Schedule C(2), etc.). This is also used to sort the
+ report.</para>
</listitem>
</itemizedlist>
@@ -1354,9 +1743,10 @@
</listitem>
</itemizedlist>
- <para>Does not accept the date field and does not import the individual payment
- amounts, only the total. The date and individual payment amounts, only matter if you
- have to compute the penalty. (this may be a TurboTax enhancement) </para>
+ <para>Does not accept the date field and does not import the individual
+ payment amounts, only the total. The date and individual payment amounts,
+ only matter if you have to compute the penalty. (this may be a TurboTax
+ enhancement) </para>
<itemizedlist>
<listitem>
@@ -1372,7 +1762,7 @@
</listitem>
</itemizedlist>
- <para>Use Copy Number to seperate information from more than one job. </para>
+ <para>Use Copy Number to separate information from more than one job. </para>
<para>TurboTax 1999, 2000 </para>
@@ -1382,11 +1772,12 @@
</listitem>
</itemizedlist>
- <para>Does not accept the dates outside of the tax year. This is a problem for the
- last payment that is due Jan 15. GnuCash changes the the date of the last payment to
- Dec 31 for the export unless the "Do not use special date processing" option is
- selected in the report display tab. The user will have to adjust for this after import.
- The date only matters if you have to compute the penalty. </para>
+ <para>Does not accept the dates outside of the tax year. This is a problem
+ for the last payment that is due Jan 15. GnuCash changes the the date of
+ the last payment to Dec 31 for the export unless the "Do not use special
+ date processing" option is selected in the report options display tab.
+ The user will have to adjust for this after import. The date only
+ matters if you have to compute the penalty. </para>
<para>TXF Tax eXport Format </para>
@@ -1396,16 +1787,46 @@
</listitem>
</itemizedlist>
- <para>Codes can be assigned to multiple accounts and the amounts will be summed
- for all the accounts generating one detail TXF record per account and one summary TXF
- record for the sum. Codes that let you select "Payer Name Source" will generate a
- separate summary TXF account with each change in payer. Selecting the "Print TXF
- export parameters" option will cause the report to show to which codes this applies
- (Payer Name Source option Y) and, for the accounts assigned to those codes, the Name Source
- each account is set to and the TXF item number that will be assigned to each. A summary TXF
- record will be generated for each change in assigned item line number. These may not be
- handled the same by TaxCut and TurboTax.</para>
+ <para>Codes can be assigned to multiple accounts and the amounts will be
+ summed for all the accounts generating one detail TXF record per account
+ and one summary TXF record for the sum. Codes that let you select "Payer
+ Name Source" will generate a separate summary TXF account with each
+ change in payer. Selecting the "Print TXF export parameters" option will
+ cause the report to show to which codes this applies (Payer Name Source
+ option Y) and, for the accounts assigned to those codes, the Name Source
+ each account is set to and the TXF item number that will be assigned to
+ each. A summary TXF record will be generated for each change in assigned
+ item line number. These may not be handled the same by TaxCut and
+ TurboTax.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Code: N673 "Short/Long gain or loss"</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Short term or long term gain or loss from the sale of a security;
+ generates TXF output for only the date sold and sales amount, with the
+ date acquired and cost basis information left blank (to be separately
+ added in the tax software). The code can be assigned to either a short-,
+ long-, or mixed-term gain/loss income account and the security sales
+ transaction should be entered as illustrated in Section 8.7, Selling
+ Shares, of the GnuCash Tutorial and Concepts Guide. The report uses the
+ transaction split of the gain/loss account to find one or more other
+ splits in the same transaction with negative share quantities. For each
+ of these found, it generates a detailed TXF output record with the
+ quantity sold, the name of the security, the date sold, and the sales
+ amount. Note that if, for a given transaction, more than one transaction
+ split is to a gain/loss income account assigned to code 673, TXF output
+ data will be erroneously repeated. That is because the report will
+ fetch the same data, and re-output it, for each transaction split set
+ to a gain/loss income account within the same transaction. For this
+ reason, there should be no more than one gain/loss account entered per
+ transaction to use this tax reporting code properly. (Note that
+ no amounts are used from GnuCash's lot-tracking; a future enhancement
+ is expected to use this data to provide capital gain reporting).</para>
+
</sect2>
<sect2 id="txf-defs">
Modified: gnucash-docs/trunk/help/C/Help_txf-categories.xml
===================================================================
--- gnucash-docs/trunk/help/C/Help_txf-categories.xml 2010-09-27 04:19:24 UTC (rev 19614)
+++ gnucash-docs/trunk/help/C/Help_txf-categories.xml 2010-09-27 04:58:09 UTC (rev 19615)
@@ -271,13 +271,13 @@
<entry>Sometimes called long term capital gain distributions. These are from mutual funds, other regulated investment companies, or real estate investment trusts. These are reported on your monthly statements or Form 1099-DIV. Note: short term capital gain distributions are reported on Sched B as ordinary dividends</entry>
</row>
<row><entry><para><emphasis># Sched D \ </emphasis>N323</para><para>Long Term gain/loss - security</para></entry>
-<entry>Long term gain or loss from the sale of a security.</entry>
+<entry>Long term gain or loss from the sale of a security. Not yet implemented in GnuCash.</entry>
</row>
<row><entry><para><emphasis># Sched D \ </emphasis>N321</para><para>Short Term gain/loss - security</para></entry>
-<entry>Short term gain or loss from the sale of a security.</entry>
+<entry>Short term gain or loss from the sale of a security. Not yet implemented in GnuCash.</entry>
</row>
-<row><entry><para><emphasis># Sched D \ </emphasis>N810</para><para>Short/Long Term gain or loss</para></entry>
-<entry>Short term or long term gain or loss from the sale of capital assets other than securities.</entry>
+<row><entry><para><emphasis># Sched D \ </emphasis>N673</para><para>Short/Long Term gain or loss</para></entry>
+<entry>Short term or long term gain or loss from the sale of a security; for use when only the date sold and net sales amount are available and the date acquired and cost basis information is not available and will be separately added in the tax software.</entry>
</row>
<row><entry><para><emphasis>Help Sched E \ </emphasis>H325</para><para>Schedule E - rental and royalty income</para></entry>
<entry>Schedule E is used to report income or loss from rental real estate, royalties, and residual interest in REMIC's. Use a different copy for each rental or royalty. Use the Schedule K-1 categories for partnership rental income and loss amounts.</entry>
More information about the gnucash-changes
mailing list