r20218 - gnucash-docs/trunk/guide/C - More markups.

Cristian Marchi cmarchi at code.gnucash.org
Tue Feb 1 13:58:55 EST 2011


Author: cmarchi
Date: 2011-02-01 13:58:55 -0500 (Tue, 01 Feb 2011)
New Revision: 20218
Trac: http://svn.gnucash.org/trac/changeset/20218

Modified:
   gnucash-docs/trunk/guide/C/appendixa.xml
   gnucash-docs/trunk/guide/C/appendixb.xml
   gnucash-docs/trunk/guide/C/appendixc.xml
   gnucash-docs/trunk/guide/C/appendixd.xml
   gnucash-docs/trunk/guide/C/ch_basics.xml
   gnucash-docs/trunk/guide/C/ch_budgets.xml
   gnucash-docs/trunk/guide/C/ch_bus_pay.xml
   gnucash-docs/trunk/guide/C/ch_currency.xml
   gnucash-docs/trunk/guide/C/ch_invest.xml
   gnucash-docs/trunk/guide/C/ch_loans.xml
Log:
More markups.

Modified: gnucash-docs/trunk/guide/C/appendixa.xml
===================================================================
--- gnucash-docs/trunk/guide/C/appendixa.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/appendixa.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -61,7 +61,7 @@
   <listitem>
   <para>Copy the <application>&app;</application> to a working file.  Modify the working file&rsquo;s
 &lt;gnc-v2&gt; tag to read something like what&rsquo;s below.  Note that you can
-pretty much put anything you want in the '="..."' part; I used the URL
+pretty much put anything you want in the <quote>="..."</quote> part; I used the URL
 because it&rsquo;s traditional (if such can be said about such a young
 technology!).</para>
   <literallayout>
@@ -90,7 +90,7 @@
   </listitem>
   <listitem>
   <para>Create an <acronym>XSLT</acronym> stylesheet containing the transformation your desire,
-or obtain one that&rsquo;s already written (AFAIK, there aren&rsquo;t any, but I'm
+or obtain one that&rsquo;s already written (AFAIK, there aren&rsquo;t any, but I&rsquo;m
 working on a <acronym>CSV</acronym> one).</para>
   </listitem>
   <listitem>

Modified: gnucash-docs/trunk/guide/C/appendixb.xml
===================================================================
--- gnucash-docs/trunk/guide/C/appendixb.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/appendixb.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -59,7 +59,7 @@
       <sect2 id="appendixb_general_multuser">
         <title>Q: Can multiple people access the same datafile in <application>&app;</application>?</title>
         <para>A: You can have multiple people with access to the same datafile, but they cannot use the data file simultaneously.</para>
-        <para>To setup multi-person access, all the people must have read/write access to the directory containing the file (to read the other&rsquo;s created files, and to create new files).  One way to do this is by creating a user group and setting the data directory to be owned by the shared group and set to mode 2775. The '2' makes the directory setgid which copies the permissions to all files.</para>
+        <para>To setup multi-person access, all the people must have read/write access to the directory containing the file (to read the other&rsquo;s created files, and to create new files).  One way to do this is by creating a user group and setting the data directory to be owned by the shared group and set to mode 2775. The <quote>2</quote> makes the directory setgid which copies the permissions to all files.</para>
       </sect2>
 
       <sect2 id="appendixb_general_WhyC">

Modified: gnucash-docs/trunk/guide/C/appendixc.xml
===================================================================
--- gnucash-docs/trunk/guide/C/appendixc.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/appendixc.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -55,7 +55,7 @@
 <para>Add all the (Box n -part)  together to get the whole (Box n)
 The VAT shows you liability - if its negative they owe you.</para>
 
-<para>Capital Equipment (Box 7 - part) and (Box 6 - part) is the value of all *additions* (purchases) made over the VAT return period - not the absolute value, nor the difference in value unless that difference is wholly due to new purchases. Depreciation, losses (e.g a write off of faulty item) and other reductions in capital value are not included. If you sell a capital item then that sale and its VAT is recorded under Income. The asset is 'converted to cash', so the 'net of VAT' increase in your bank account, when the invoice is payed, is matched by a decrease in capital.</para>
+<para>Capital Equipment (Box 7 - part) and (Box 6 - part) is the value of all *additions* (purchases) made over the VAT return period - not the absolute value, nor the difference in value unless that difference is wholly due to new purchases. Depreciation, losses (e.g a write off of faulty item) and other reductions in capital value are not included. If you sell a capital item then that sale and its VAT is recorded under Income. The asset is <quote>converted to cash</quote>, so the <quote>net of VAT</quote> increase in your bank account, when the invoice is payed, is matched by a decrease in capital.</para>
 
 <literallayout>
 Bank Accounts [B]

Modified: gnucash-docs/trunk/guide/C/appendixd.xml
===================================================================
--- gnucash-docs/trunk/guide/C/appendixd.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/appendixd.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -18,7 +18,7 @@
       <sect2 id="check_format_overview">
         <title>Overview</title>
         <para>The check format file is used to tell <application>&app;</application> how to print a check or checks onto a page of paper.  This file first describes the overall layout of a page (number of checks, orientation, etc) and then describes the layout of the specific items on a single check.  The file is organized as a typical Key/Value file used by many Linux applications.  Keys/values pairs are grouped into sections that begin with the group name enclosed in square brackets.</para>
-        <para><application>&app;</application> looks for check format files in two different locations when you bring up the check printing dialog.  The first location is typically /usr/share/gnucash/checks, where check files distributed with the application can be found.  The second location is the user private ~/.gnucash/checks directory.  Users may add check formats at any time (even while <application>&app;</application> is running) simply by dropping a new *.chk file in this directory.  The next time the check printing dialog is opened the new check format will appear in the list of available check formats.</para>
+        <para><application>&app;</application> looks for check format files in two different locations when you bring up the check printing dialog.  The first location is typically <filename class="directory">/usr/share/gnucash/checks</filename>, where check files distributed with the application can be found.  The second location is the user private <filename class="directory">~/.gnucash/checks</filename> directory.  Users may add check formats at any time (even while <application>&app;</application> is running) simply by dropping a new *.chk file in this directory.  The next time the check printing dialog is opened the new check format will appear in the list of available check formats.</para>
         <note>
           <para>Printing functions differently depending on the version of GTK that is installed on your system.  When <application>&app;</application> is using a version of GTK prior to 2.10 all offsets are measured from the lower left corner of the page or check.  When using GTK 2.10 or later, all offsets are measured from the upper left corner of the page or check.</para>
         </note>
@@ -97,7 +97,7 @@
                   <entry>Blocking_Chars</entry>
                   <entry>boolean</entry>
                   <entry>optional</entry>
-                  <entry>If supplied, this is the default used when printing all <emphasis>TEXT</emphasis> items on this check.  When set to true, will print '***' before and after each text field on the check.  Blocking characters are printed to protect check fields from alteration.  For example, the amount field may be printed as ***100.00***</entry>
+                  <entry>If supplied, this is the default used when printing all <emphasis>TEXT</emphasis> items on this check.  When set to true, will print <emphasis>***</emphasis> before and after each text field on the check.  Blocking characters are printed to protect check fields from alteration.  For example, the amount field may be printed as <emphasis>***100.00***</emphasis></entry>
                 </row>
                 <row>
                   <entry>DateFormat</entry>
@@ -216,7 +216,7 @@
                   <entry>Filename_<emphasis>n</emphasis></entry>
                   <entry>string</entry>
                   <entry>optional</entry>
-                  <entry>This field is only used when the item type is <emphasis>PICTURE</emphasis>. It specifies the filename of the image that should be printed on the check.  The string may specify either an absolute path name or as a relative path name.  If a relative path name is specified, <application>&app;</application> first looks in in the application check format folder (typically /usr/share/gnucash/checks) for the image file, and if it isn&rsquo;t found there then it looks in the user private ~/.gnucash/checks directory for the image.  This field is only recognized when using gtk version 2.10 or later.</entry>
+                  <entry>This field is only used when the item type is <emphasis>PICTURE</emphasis>. It specifies the filename of the image that should be printed on the check.  The string may specify either an absolute path name or as a relative path name.  If a relative path name is specified, <application>&app;</application> first looks in in the application check format folder (typically <filename class="directory">/usr/share/gnucash/checks</filename>) for the image file, and if it isn&rsquo;t found there then it looks in the user private <filename class="directory">~/.gnucash/checks</filename> directory for the image.  This field is only recognized when using gtk version 2.10 or later.</entry>
                 </row>
                 <row>
                   <entry>Blocking_Chars_<emphasis>n</emphasis></entry>
@@ -404,7 +404,7 @@
       </sect2>
       <sect2 id="check_format_notes">
         <title>Creating Check Format Files</title>
-        <para>Creating your own check format file is a fairly simple task.  The easiest way to start is to copy an existing check format file from the application directory (typically /usr/share/gnucash/checks) to the directory ~/.gnucash/checks.  Make sure to change the guid so the new file will be accepted by gnucash, and change the title to something descriptive.  Then change or add individual item fields as necessary.  You can also create a new check file by clicking the <guibutton>Save Format</guibutton> button on the <guilabel>Custom format</guilabel> page of the check printing dialog.</para>
+        <para>Creating your own check format file is a fairly simple task.  The easiest way to start is to copy an existing check format file from the application directory (typically <filename class="directory">/usr/share/gnucash/checks</filename>) to the directory <filename class="directory">~/.gnucash/checks</filename>.  Make sure to change the guid so the new file will be accepted by gnucash, and change the title to something descriptive.  Then change or add individual item fields as necessary.  You can also create a new check file by clicking the <guibutton>Save Format</guibutton> button on the <guilabel>Custom format</guilabel> page of the check printing dialog.</para>
         <note>
           <para>Key names are case sensitive.  If you&rsquo;re having problems with a check format file, ensure that all key names have capital letters as documented above.</para>
         </note>

Modified: gnucash-docs/trunk/guide/C/ch_basics.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_basics.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_basics.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -861,7 +861,7 @@
 
       <para>You should also delete any <filename>.LCK</filename> and <filename>.LNK</filename> files that you see after
       closing <application>&app;</application>. If you decide to back up your data file to another
-      disk manually, it's enough to back up the main data file - not the <filename>.YYYYMMDDHHMMSS.gnucash</filename>
+      disk manually, it&rsquo;s enough to back up the main data file - not the <filename>.YYYYMMDDHHMMSS.gnucash</filename>
       backup files.</para>
 
       <note>

Modified: gnucash-docs/trunk/guide/C/ch_budgets.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_budgets.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_budgets.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -156,8 +156,8 @@
     <para>If you have past transactions recorded in <application>&app;</application>, the
     second way is to let <application>&app;</application> estimate the budget values by looking
     at those transactions.  First, select the accounts you want
-    <application>&app;</application> to estimate.  Then click on the 'Estimate' <emphasis>Toolbar</emphasis> button.
-    In the Estimate Budget Values dialog, select the date past which
+    <application>&app;</application> to estimate.  Then click on the <guibutton>Estimate</guibutton> <emphasis>Toolbar</emphasis> button.
+    In the <guilabel>Estimate Budget Values</guilabel> dialog, select the date past which
     <application>&app;</application> should look for past transactions.  <application>&app;</application> will start at
     that date and look forward for the duration of your budget.  For
     example, if you are making an annual budget, and you select

Modified: gnucash-docs/trunk/guide/C/ch_bus_pay.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_bus_pay.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_bus_pay.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -45,7 +45,7 @@
   </literallayout>
 
   <note>
-  <para>Resist the temptation to create per-employee sub-accounts to track individual salaries.  Creating a sub-account for each employee leads to unmanageably large lists of accounts.  Imagine the account structure after a few years of employees coming and going.  It is much simpler to keep all of your employees' payroll records within a single account (Expenses:Salaries for example) and use reports to view per-employee information.</para>
+  <para>Resist the temptation to create per-employee sub-accounts to track individual salaries.  Creating a sub-account for each employee leads to unmanageably large lists of accounts.  Imagine the account structure after a few years of employees coming and going.  It is much simpler to keep all of your employees&rsquo; payroll records within a single account (<emphasis>Expenses:Salaries</emphasis> for example) and use reports to view per-employee information.</para>
   </note>
   </para>
 

Modified: gnucash-docs/trunk/guide/C/ch_currency.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_currency.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_currency.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -151,11 +151,11 @@
       <para>Let&rsquo;s say for example that you want to track RewardMiles,
       which count how many loyalty points you&rsquo;ve earned by buying
       from a certain group of businesses. The account which tracks your
-      RewardMiles will be Assets:Other:LoyaltyGroupRewardMiles.</para>
+      RewardMiles will be <emphasis>Assets:Other:LoyaltyGroupRewardMiles</emphasis>.</para>
 
       <para>The first method is to define a new security, of type FUND,
       called RewardMiles. This is pretty straightforward&ndash;when you
-      create the new LoyaltyGroupRewardMiles account, just set the account
+      create the new <emphasis>LoyaltyGroupRewardMiles</emphasis> account, just set the account
       type to <guilabel>Stock</guilabel> or <guilabel>Mutual
       Fund</guilabel>, click the <guibutton>Select...</guibutton> button
       next to the <guilabel>Security/currency:</guilabel> box, and click
@@ -522,9 +522,8 @@
 
       <para>You find the boat, and since it&rsquo;s a bargain at JMD 509,000 you
       decide to buy it. To record this transaction in <application>&app;</application>, you will need
-      to enter a simple transaction in Assets:Current Assets:Jamaican Bank
-      withdrawing 509,000 and transferring it to Assets:Fixed
-      Assets:Boat</para>
+      to enter a simple transaction in <emphasis>Assets:Current Assets:Jamaican Bank</emphasis>
+      withdrawing 509,000 and transferring it to <emphasis>Assets:Fixed Assets:Boat</emphasis></para>
 
       <screenshot id="currency_purchase_AfterBoat.png">
         <mediaobject>
@@ -634,13 +633,13 @@
       </screenshot>
 
       <para>If you have not moved some money (HKD 50,000) into the brokerage&rsquo;s
-      cash account (Assets:Investments:Brokerage Account:Boom:Bank), do so
+      cash account (<emphasis>Assets:Investments:Brokerage Account:Boom:Bank</emphasis>), do so
       now, either using the Equity (HKD) account, or an existing bank account
       (Currency Transfer).</para>
 
       <para>Let&rsquo;s assume that stock price is HKD 3 per share. To record the
       purchase, open the brokerage&rsquo;s HKD cash account
-      (Assets:Investments:Brokerage Account:Boom:Bank), and enter
+      (<emphasis>Assets:Investments:Brokerage Account:Boom:Bank</emphasis>), and enter
       the following:</para>
 <literallayout>
 Buy Stocks
@@ -704,7 +703,7 @@
          When doing it that way, the stock is assumed to be priced
          in the currency of the stock account&rsquo;s parent.</para>
         <para>In this example, the stock account&rsquo;s parent
-         (Assets:Investments:Brokerage Account:Boom) is denominated in HKD.
+         (<emphasis>Assets:Investments:Brokerage Account:Boom</emphasis>) is denominated in HKD.
          Since this is same currency as the stock price, the purchase
          can be safely entered in the stock account&rsquo;s register.</para>
       </note>
@@ -753,7 +752,7 @@
       <title>Purchasing a currency investment</title>
 
       <para>A typical purchase order might be something like this, seen from
-      the Assets:Investments:Currency:Bank.</para>
+      the <emphasis>Assets:Investments:Currency:Bank</emphasis>.</para>
 
       <para><table>
           <title>Buying a currency with a Split Transaction Scheme</title>
@@ -817,7 +816,7 @@
       the income profit (setting the amount to 0).</para>
 
       <para>In short, a selling Currency transaction should look something
-      like below, seen again from the Assets:Investments:Currency:Bank.</para>
+      like below, seen again from the <emphasis>Assets:Investments:Currency:Bank</emphasis>.</para>
 
       <table>
         <title>Selling a currency with a Split Transaction Scheme</title>

Modified: gnucash-docs/trunk/guide/C/ch_invest.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_invest.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_invest.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -824,7 +824,7 @@
       <emphasis>Assets:Bank ABC</emphasis> account.</para>
 
       <para>Now you will purchase $5000 of IBM stock, with a commission of $100.  First 
-      step will be to create the stock account for IBM.  The existing Expense:Commission
+      step will be to create the stock account for IBM.  The existing <emphasis>Expense:Commission</emphasis>
       account will be used.  If you wish to track commissions to the individual stock
       an additional sub-account would be necessary.</para>
 
@@ -1008,7 +1008,7 @@
 	<application>&app;</application>. It will open a Terminal
 	window and run a script for you which will ask lots of
 	questions. Accept the default for each unless you know what
-	you're doing.</para>
+	you&rsquo;re doing.</para>
         
         <para><emphasis role="strong">Linux:</emphasis> 
 	<itemizedlist>

Modified: gnucash-docs/trunk/guide/C/ch_loans.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_loans.xml	2011-01-31 20:07:00 UTC (rev 20217)
+++ gnucash-docs/trunk/guide/C/ch_loans.xml	2011-02-01 18:58:55 UTC (rev 20218)
@@ -315,7 +315,7 @@
         <note>
           <para>NOTE: in the equations below for the financial transaction,
           all interest rates are the effective interest rate, ieff. For the
-          sake of brevity, the symbol will be shortened to just 'i'.</para>
+          sake of brevity, the symbol will be shortened to just <quote>i</quote>.</para>
         </note>
       </sect3>
 



More information about the gnucash-changes mailing list