[kmymoney/5.0] doc: doc: use more entities

Pino Toscano null at kde.org
Sat Apr 6 07:34:35 BST 2019


Git commit dae72c5e5ed7867bb54a42f42339c895a77b5cb9 by Pino Toscano.
Committed on 06/04/2019 at 06:33.
Pushed by pino into branch '5.0'.

doc: use more entities

M  +6    -6    doc/details-impexp-csv.docbook
M  +5    -5    doc/details-impexp.docbook
M  +2    -2    doc/details-investments.docbook
M  +6    -6    doc/details-ledgers.docbook
M  +2    -2    doc/details-reports.docbook
M  +1    -1    doc/details-widgets.docbook
M  +3    -3    doc/firsttime.docbook
M  +5    -5    doc/installation.docbook
M  +2    -2    doc/makemostof.docbook
M  +2    -2    doc/reference.docbook
M  +2    -2    doc/whatsnew.docbook

https://commits.kde.org/kmymoney/dae72c5e5ed7867bb54a42f42339c895a77b5cb9

diff --git a/doc/details-impexp-csv.docbook b/doc/details-impexp-csv.docbook
index 854c6e8ba..60f03fd5a 100644
--- a/doc/details-impexp-csv.docbook
+++ b/doc/details-impexp-csv.docbook
@@ -271,7 +271,7 @@
 <listitem>
 <para>
   The <guilabel>Type/Action</guilabel> selector is to identify the column which
-  contains the action type, such as Buy, Sell, Dividend, etc.
+  contains the action type, such as Buy, Sell, Dividend, &etc;
 </para>
 </listitem>
 
@@ -475,14 +475,14 @@
 <para>
   If you have more that one transaction referring to the same security, you can
   edit all of them at once, using multi-select.  For instance, to add a symbol for
-  several lines, press and hold the <keysym>CTL</keysym> key, and in the symbol column,
-  select each transaction.  While still holding the <keysym>CTL</keysym> key,
+  several lines, press and hold the &Ctrl; key, and in the symbol column,
+  select each transaction.  While still holding the &Ctrl; key,
   all those symbol cells should still be selected, so click on one and enter the
   symbol.  Click inside the window but outside that column, or hit
-  <keysym>Enter</keysym> (not <guilabel>OK</guilabel>).  Now that those
+  &Enter; (not <guilabel>OK</guilabel>).  Now that those
   transactions all have the same symbol, double click one detail entry and edit
   the security name as you wish.  Click elsewhere on the window (or
-  <keysym>Enter</keysym>) to accept the edit, which will then change all
+  &Enter;) to accept the edit, which will then change all
   those entries.  The remaining entries will show the symbols picked up from the
   transactions in the import file.
 </para>
@@ -589,7 +589,7 @@
   the plugin will validate the column contents to ensure they match the action
   type.  For instance, if a quantity appears but no price or amount, it is
   assumed that the transaction can be only an Add or Remove Shares.  Or, if
-  there is an amount but no quantity or price, then a Dividend is assumed, etc..
+  there is an amount but no quantity or price, then a Dividend is assumed, &etc;.
 </para>
 
 <para>
diff --git a/doc/details-impexp.docbook b/doc/details-impexp.docbook
index 6ec8fc2f6..07f750035 100644
--- a/doc/details-impexp.docbook
+++ b/doc/details-impexp.docbook
@@ -31,7 +31,7 @@
   <listitem><para>import of 'multi-book' files</para></listitem>
   <listitem><para>import into an existing &kmymoney; file</para></listitem>
   <listitem><para>import of small-business specific features (Employees,
-    Invoices, etc.)</para></listitem>
+    Invoices, &etc;)</para></listitem>
   <listitem><para>export to GnuCash files.</para></listitem>
 </itemizedlist>
 
@@ -196,7 +196,7 @@
   As with GnuCash, data is entered in the form of transactions, each generally
   consisting of 2 or more split entries. In fact, valid GnuCash transactions
   will always contain at least 2 splits, and to conform to GnuCash's
-  double-entry bookkeeping standard, these must be in monetary balance (i.e.,
+  double-entry bookkeeping standard, these must be in monetary balance (&ie;,
   they must balance out to zero). &kmymoney; encourages, but does not enforce,
   this standard, but any imported transaction which is not balanced will be
   marked in the ledger view as having a problem.
@@ -461,13 +461,13 @@
 
 <para>
   If your native language is written in letters or symbols which are different
-  from those used in the 'Latin' languages (i.e., generally Western European),
+  from those used in the 'Latin' languages (&ie;, generally Western European),
   these are represented in a special fashion ('encoded') in your GnuCash file.
   If these letters are not displayed correctly on your screen, then they must be
   decoded.  Currently, it is often not possible to detect accurately which form
   of decoding must be used, so you may need to set this option and select an
   entry from the list.  In general, the first item in the list will be that
-  which is considered appropriate for your locale (i.e., the country and
+  which is considered appropriate for your locale (&ie;, the country and
   language which was selected as native when your operating system was
   installed), so this should be tried first.  Since the import process does not
   overwrite your GnuCash file, you are free to experiment with any of these
@@ -968,7 +968,7 @@
   still variations, depending on the specific implementation used by any
   institution.  OFX files may have an extension of <quote>OFX</quote> or
   <quote>QFX</quote> (upper or lower case); this does not imply any particular
-  difference in the content.  The specification is based on XML, so the files
+  difference in the content.  The specification is based on &XML;, so the files
   can be read in any text editor, but as whitespace is not relevant to the
   content itself, some implementations do not use any, making it very hard for a
   human to read.
diff --git a/doc/details-investments.docbook b/doc/details-investments.docbook
index 0756fd904..e10a55993 100644
--- a/doc/details-investments.docbook
+++ b/doc/details-investments.docbook
@@ -119,7 +119,7 @@
 
 <para>
   The first thing you'll be asked to enter is the type of investment, whether
-  it's a stock, bond, etc.
+  it's a stock, bond, &etc;
 </para>
 
 <para>
@@ -640,7 +640,7 @@
 <para>
   Certain common features that are normally found with investments are not yet
   implemented in &kmymoney;.  These include: Derivatives (options, futures,
-  etc), capital gains, and tax reporting for investments.
+  &etc;), capital gains, and tax reporting for investments.
 </para>
 </sect1>
 </chapter>
diff --git a/doc/details-ledgers.docbook b/doc/details-ledgers.docbook
index bdde5ec84..936506cb7 100644
--- a/doc/details-ledgers.docbook
+++ b/doc/details-ledgers.docbook
@@ -117,7 +117,7 @@
   You can also change transaction properties or even create new transactions
   directly in the list.  In the transactions list, the default order of
   transactions is sorted by date with the most recent transaction on the bottom.
-  Clicking the Right Mouse Button on the header of the transaction list brings
+  Clicking the &RMB; on the header of the transaction list brings
   up a dialog box that will allow  the ability to change the sort order of the
   transactions. For instructions on how to change the default sort order, see the <link
   linkend="details.settings.register.sorting">Sorting tab</link> section of the
@@ -410,9 +410,9 @@
 <para>	
   To enter a new transaction into the register you can now either click on an
   empty entry, press <keycombo
-  action="simul">&Ctrl;<keycap>Ins</keycap></keycombo>, or click
-  <guibutton>New</guibutton> at the foot of the window. The <keycap>Up</keycap>
-  and <keycap>Down</keycap> arrow keys let you navigate through the list.  After
+  action="simul">&Ctrl;&Ins;</keycombo>, or click
+  <guibutton>New</guibutton> at the foot of the window. The &Up;
+  and &Down; arrow keys let you navigate through the list.  After
   pressing &Enter; or double clicking on an entry, the transaction list displays
   the fields required to enter the transaction and waits for input.
 </para>
@@ -426,7 +426,7 @@
 <para>
   In case the option <guilabel>Use Enter to move between fields</guilabel> is
   selected, the &Enter; key moves to the next field just as the
-  <keycap>TAB</keycap> key except for the last entry field where it saves the
+  	 key except for the last entry field where it saves the
   data.
 </para>
 
@@ -458,7 +458,7 @@
 <para>
   In the split editor screen, double-click an empty line to enter a new
   sub-transaction or press <keycombo
-  action="simul">&Ctrl;<keycap>Ins</keycap></keycombo>. Specify the category,
+  action="simul">&Ctrl;&Ins;</keycombo>. Specify the category,
   add an (optional) memo, and enter the amount. To save this part of the split,
   press the green check mark under the category. To cancel, press the red cross.
 </para> 
diff --git a/doc/details-reports.docbook b/doc/details-reports.docbook
index 482e143eb..1191f293c 100644
--- a/doc/details-reports.docbook
+++ b/doc/details-reports.docbook
@@ -91,7 +91,7 @@
   <listitem><para>Investment Holdings by Account:  Shows the current shares,
     price, and value for each account.</para></listitem>
   <listitem><para>Investment Holdings by Type:  Same as the previous report, but
-    organizes the accounts by type (Stock, Mutual Fund, etc)</para></listitem>
+    organizes the accounts by type (Stock, Mutual Fund, &etc;)</para></listitem>
   <listitem><para>Investment Performance by Account: Shows the annualized
     performance over any period of time.  This performs a cash flow analysis of
     all money coming into and going out of the account.  As a result, this is a
@@ -99,7 +99,7 @@
     doing.</para></listitem>
   <listitem><para>Investment Performance by Type:  Same as the previous report,
     but organizes the accounts by type (Stock, Mutual Fund,
-    etc)</para></listitem>
+    &etc;)</para></listitem>
 </itemizedlist>
 
 <para>
diff --git a/doc/details-widgets.docbook b/doc/details-widgets.docbook
index b889ee2c6..27d08404d 100644
--- a/doc/details-widgets.docbook
+++ b/doc/details-widgets.docbook
@@ -80,7 +80,7 @@
   At the bottom of the datepicker widget, there are a button, a text edit field,
   and a combo box. Pressing the button selects today's date in the
   datepicker. The text field can be used to enter a specific date. Pressing the
-  <keycap>RETURN</keycap> key shows that date in the datepicker widget.  The
+  &Enter; key shows that date in the datepicker widget.  The
   combo box allows the user to select a specific week, and continue to pick a
   date from there.
 </para>
diff --git a/doc/firsttime.docbook b/doc/firsttime.docbook
index 4556795b8..0e80a8d86 100644
--- a/doc/firsttime.docbook
+++ b/doc/firsttime.docbook
@@ -51,7 +51,7 @@
 </note>
 
 <para>
-  All tips have been extracted from the Frequently Asked Questions list (FAQ)
+  All tips have been extracted from the Frequently Asked Questions list (&FAQ;)
   that provides more detailed help and can be found on the project <ulink
   url="http://www.kmymoney.org/faq.php">website</ulink> and in <link
   linkend="faq">this manual</link>.
@@ -68,7 +68,7 @@
     this manual.  Many details, such as fonts, colors, and icons, can be
     customized, either using the
     <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
-    &kmymoney;...</guimenuitem></menuchoice> dialog or the KDE System Settings
+    &kmymoney;...</guimenuitem></menuchoice> dialog or the &kde; &systemsettings;
     application, depending on your operating system.
   </para>
 </note>
@@ -484,7 +484,7 @@
   Choose the appropriate country and account template(s). Each template provides
   a different set of categories for organizing your finances. Multiple
   templates, even from different countries, can be selected using a combination
-  of &Ctrl; and &Shift; together with the left mouse button.  The account
+  of &Ctrl; and &Shift; together with the &LMB;.  The account
   hierarchy to be setup will be shown in a preview part of the wizard. In case
   you cannot find a template that suits your needs, don't select a template at
   this time, and you can manually set up categories later.
diff --git a/doc/installation.docbook b/doc/installation.docbook
index b7f43d6f8..7f903ef94 100644
--- a/doc/installation.docbook
+++ b/doc/installation.docbook
@@ -30,7 +30,7 @@
 </para>
 
 <para>
-  Although work has begun porting &kmymoney; to the new KDE Frameworks 5, this is
+  Although work has begun porting &kmymoney; to the new &kf5-full;, this is
   still very early, and not yet usable.  Hopefully it will be available in the
   5.0 version, which we expect to release in early 2015.  Until then, if you are
   specifically interested in following this work, you should subscribe to the
@@ -73,7 +73,7 @@
   installation issues will be available on the <ulink
   url="http://www.kmymoney.org">&kmymoney; home page</ulink>.  That page will
   also have links to tarballs of recent versions as well as instructions for
-  obtaining the source from &kde; Git, in case you want to compile the latest,
+  obtaining the source from &kde; &git;, in case you want to compile the latest,
   development version.
 </para>
 
@@ -89,7 +89,7 @@
   On the other hand, if you want to see the current state of development, to
   check out a recent bug fix or new feature, you can download a tarball which is
   a snapshot of the development repository.  You can also check the source
-  directly out of the repository.  The version 4.x source is in &kde; Git.  (The
+  directly out of the repository.  The version 4.x source is in &kde; &git;.  (The
   version 1.0.x source was in SourceForge cvs, but it is no longer being
   developed or supported at all.)  Instructions for access are on the project
   home page.
@@ -97,7 +97,7 @@
 
 <warning>
  <para>
-   The code in the Git repository and in development snapshots is under active
+   The code in the &git; repository and in development snapshots is under active
    development: it may have bugs, it may crash, and it may mess up or lose data.
    If you use it, be absolutely sure to make adequate backups.  Unless you have
    a good reason to use this, stick to a stable released version.
@@ -157,7 +157,7 @@
 </para></important>
 
 <para>
-  If you have compiled the source from git, and want to update to the latest
+  If you have compiled the source from &git;, and want to update to the latest
   revision, most of the time you can do the following:
 </para>
 
diff --git a/doc/makemostof.docbook b/doc/makemostof.docbook
index 53329d188..c572ab710 100644
--- a/doc/makemostof.docbook
+++ b/doc/makemostof.docbook
@@ -200,7 +200,7 @@
     <term>Asset</term>
     <listitem>
       <para>
-        Property, collections, etc.
+        Property, collections, &etc;.
       </para>
     </listitem>
   </varlistentry>
@@ -229,7 +229,7 @@
     <term>Loan</term>
     <listitem>
       <para>
-        Loans made to you, mortgages, etc.
+        Loans made to you, mortgages, &etc;.
       </para>
     </listitem>
   </varlistentry>
diff --git a/doc/reference.docbook b/doc/reference.docbook
index cec7089a3..49aadb6fe 100644
--- a/doc/reference.docbook
+++ b/doc/reference.docbook
@@ -576,7 +576,7 @@
     <term><menuchoice>
       <shortcut>
         <keycombo>
-          &Ctrl;&Alt;<keycap>Space</keycap>
+          &Ctrl;&Alt;&Space;
         </keycombo>
       </shortcut>
       <guimenu>Transaction</guimenu>
@@ -592,7 +592,7 @@
     <term><menuchoice>
       <shortcut>
         <keycombo>
-          &Ctrl;&Shift;<keycap>Space</keycap>
+          &Ctrl;&Shift;&Space;
         </keycombo>
       </shortcut>
       <guimenu>Transaction</guimenu>
diff --git a/doc/whatsnew.docbook b/doc/whatsnew.docbook
index fb8fa311e..2e4c5fd82 100644
--- a/doc/whatsnew.docbook
+++ b/doc/whatsnew.docbook
@@ -15,8 +15,8 @@
 
 <para>
 
-  The largest amount of work has gone towards basing this version on KDE
-  Frameworks.  Many of the underlying libraries used by the application have
+  The largest amount of work has gone towards basing this version on
+  &kde-frameworks;.  Many of the underlying libraries used by the application have
   been reorganized and improved, but most of that is behind the scenes, and not
   directly visible to the end user.  Some of the general look and feel may have
   changed, but the basic functionality of the program remains the same, aside


More information about the kde-doc-english mailing list