From 1668c74036ad15b2e1ab3c1a6975cf13068142ae Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 00:13:16 +0200 Subject: Add description for --time-colon --- doc/ledger3.texi | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index cd1b59a8..93b9e885 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -5435,7 +5435,11 @@ it will issue a warning giving you the file and line number of the problem. @item --time-colon -FIX THIS ENTRY @c FIXME thdox +The --time-colon option will display the value for a seconds based +commodity as real hours and minutes. + +For example 8100 seconds by default will be displayed as 2.25 whereas +with the --time-colon option they will be displayed as 2:15. @item --value-expr @var{FIXME} FIX THIS ENTRY @c FIXME thdox -- cgit v1.2.3 From f5ece775afea3c6584f8c76207c7f7ac7f38ba27 Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 00:37:34 +0200 Subject: Add description for --unrealized-gains and --unrealized-losses --- doc/ledger3.texi | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 93b9e885..9db5d015 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -6084,11 +6084,16 @@ Use only uncleared transactions in calculations and reports. @item --unrealized FIX THIS ENTRY -@item --unrealized-gains @var{FIXME} -FIX THIS ENTRY +@item --unrealized-gains @var{STR} +@itemx --unrealized-losses @var{STR} +These options allow the user to specify what accounts names should be +used for these two types of accounts. They are optional, and default +to: -@item --unrealized-losses @var{FIXME} -FIX THIS ENTRY +--unrealized-gains "Equity:Unrealized Gains" +--unrealized-losses "Equity:Unrealized Losses" + +These are intended to be set in one's @file{~/.ledgerrc} file. @item --unround Perform all calculations without rounding and display results to full -- cgit v1.2.3 From b2e63df0e69f3585b6b9563b9f1ef695d2bae20f Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 00:38:08 +0200 Subject: Add description for /dev/stdin as input file --- doc/ledger3.texi | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 9db5d015..5fedbde5 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -6138,7 +6138,8 @@ are using. @item --file @var{FILE} @itemx -f @var{FILE} -Read @file{FILE} as a ledger file. This command may be used multiple +Read @file{FILE} as a ledger file. @var{FILE} can be @samp{-} that is +a synonym of @samp{/dev/stdin}. This command may be used multiple times. Typically, the environment variable @env{LEDGER_FILE} is set, rather than using this command-line option. -- cgit v1.2.3 From f20e16cc4ad4fb13fdd89a0e01696b0887229984 Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 21:10:12 +0200 Subject: Adjust of blank lines between keywords and sections M-x fill-paragraph at column 72 M-x delete-trailing-whitespace And some other minor fixes --- doc/ledger-mode.texi | 335 ++++++++++++++++++++++++++++----------------------- 1 file changed, 182 insertions(+), 153 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 151876a9..73f343ce 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -1,7 +1,12 @@ \input texinfo @c -*-texinfo-*- + @setfilename ledger-mode.info @settitle Ledger: Command-Line Accounting +@c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with +@c a prefix arg). This updates the node pointers, which texinfmt.el +@c needs. + @dircategory Major Modes @copying Copyright (c) 2013, Craig Earls. All rights reserved. @@ -10,28 +15,28 @@ Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -- Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. +- Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. -- Neither the name of New Artisans LLC nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +- Neither the name of New Artisans LLC nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS +IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @end copying @documentencoding UTF-8 @@ -40,7 +45,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @finalout @end iftex - @titlepage @title Ledger Mode @subtitle Emacs Support For Version 3.0 of Ledger @@ -54,40 +58,44 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @contents @ifnottex + @node Top, Copying, (dir), (dir) @top Overview + Ledger is a command line accounting tool that provides double-entry accounting based on a text journal. It provides no bells or whistles, -and returns the user to the days before user interfaces were even a -1twinkling in their father's CRT. +and returns the user to the days before user interfaces were even +a 1twinkling in their father's CRT. Ledger Mode assists you in maintaining input files for Ledger, running reports and much more... -@c @insertcopying + @end ifnottex @menu -* Copying:: -* Introduction to Ledger Mode:: -* The Ledger Buffer:: -* The Reconcile Buffer:: -* The Report Buffer:: -* Customizing Ledger-mode:: -* Generating Ledger Regression Tests:: -* Embedding Example results in Ledger Documentation:: -* Hacking Ledger-mode:: +* Copying:: +* Introduction to Ledger Mode:: +* The Ledger Buffer:: +* The Reconcile Buffer:: +* The Report Buffer:: +* Customizing Ledger-mode:: +* Generating Ledger Regression Tests:: +* Embedding Example results in Ledger Documentation:: +* Hacking Ledger-mode:: @end menu @node Copying, Introduction to Ledger Mode, Top, Top @chapter Copying + @insertcopying @node Introduction to Ledger Mode, The Ledger Buffer, Copying, Top @chapter Introduction to Ledger Mode + @menu -* Quick Installation:: -* Menus:: -* Quick Demo:: +* Quick Installation:: +* Menus:: +* Quick Demo:: @end menu @node Quick Installation, Menus, Introduction to Ledger Mode, Introduction to Ledger Mode @@ -95,15 +103,15 @@ reports and much more... The Emacs lisp source for Ledger-mode is included with the source distribution of Ledger. It is entirely included in the @file{lisp} -subdirectory. To use ledger mode include the following in your Emacs -initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, -@file{~/.Aquamacs/Preferences.el} +subdirectory. To use ledger mode, include the following in your Emacs +initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, or +@file{~/.Aquamacs/Preferences.el} -@smallexample +@lisp (add-to-list 'load-path (expand-file-name "/path/to/ledger/source/lisp/")) (load "ldg-new") (add-to-list 'auto-mode-alist '("\\.ledger$" . ledger-mode)) -@end smallexample +@end lisp This sets up Emacs to automatically recognize files that end with @file{.ledger} and start Ledger mode. Nothing else should be required @@ -125,10 +133,10 @@ highlighted. At this point you could manually edit transactions and run Ledger from a convenient command line. @menu -* Quick Add:: -* Reconciliation:: -* Reports:: -* Narrowing:: +* Quick Add:: +* Reconciliation:: +* Reports:: +* Narrowing:: @end menu @node Quick Add, Reconciliation, Quick Demo, Quick Demo @@ -169,8 +177,8 @@ commodity, this can be easily changed in the customization variables. @xref{Ledger-mode Customization}. You now see a list of uncleared transactions in a buffer below the -@file{demo.ledger} buffer. Touching the space bar will mark a -transaction as pending and display the current cleared (and pending) +@file{demo.ledger} buffer. Touching the space bar will mark +a transaction as pending and display the current cleared (and pending) balance, along with the difference remaining to meet your target. Clear the first three transactions, and you will see the difference to target reach $0. End the reconciliation by typing @code{C-c C-c}. This saves @@ -193,28 +201,30 @@ type @code{C-c C-c}. Ledger mode will take you directly to that transaction in the @file{demo.ledger} buffer. Another built-in report is the balance report. In the -@file{demo.ledger} buffer, type @code{C-c C-o C-r}. When prompted for a -report to run, type @code{bal}, and a balance report of all accounts +@file{demo.ledger} buffer, type @code{C-c C-o C-r}. When prompted for +a report to run, type @code{bal}, and a balance report of all accounts will be shown. @node Narrowing, , Reports, Quick Demo @subsection Narrowing -A ledger file can get very large. It can be helpful to collapse the buffer -to display only the transactions you are interested in. Ledger-mode -copies the @code{occur} mode functionality. Typing @code{C-c C-f} and -entering any regex in the mini-buffer will show only transactions that -match the regex. The regex can be on any field, or amount. +A ledger file can get very large. It can be helpful to collapse the +buffer to display only the transactions you are interested in. +Ledger-mode copies the @code{occur} mode functionality. Typing +@code{C-c C-f} and entering any regex in the mini-buffer will show only +transactions that match the regex. The regex can be on any field, or +amount. @node The Ledger Buffer, The Reconcile Buffer, Introduction to Ledger Mode, Top @chapter The Ledger Buffer + @menu -* Adding Transactions:: -* Editing Amounts:: -* Marking Transactions:: -* Deleting Transactions:: -* Sorting Transactions:: -* Narrowing Transactions:: +* Adding Transactions:: +* Editing Amounts:: +* Marking Transactions:: +* Deleting Transactions:: +* Sorting Transactions:: +* Narrowing Transactions:: @end menu @node Adding Transactions, Editing Amounts, The Ledger Buffer, The Ledger Buffer @@ -234,11 +244,12 @@ the column specified by @code{ledger-post-amount-alignment-column}, which defaults to 52. @xref{Ledger Post Customization Group}. @menu -* Quick Balance Display:: +* Quick Balance Display:: @end menu @node Quick Balance Display, , Adding Transactions, Adding Transactions @subsection Quick Balance Display + You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, and type @code{C-C C-P}. The minibuffer will ask you to verify the name @@ -247,27 +258,29 @@ balance of the account will be displayed in the minibuffer. @node Editing Amounts, Marking Transactions, Adding Transactions, The Ledger Buffer @section Editing Amounts + GNU Calc is a very powerful Reverse Polish Notation calculator built into all recent version of Emacs. Ledger-mode makes it easy to calculate values for amount by integrating GNU Calc. With the point -anywhere in the same line as a posting, typing @code{C-c C-b} will -bring up the Calc buffer, and push the current amount for the posting -onto the top of the Calc stack. Perform any calculations you need to -arrive at the final value, then type @code{y} to yank the value at the -top of stack back into the ledger buffer. Note: GNU Calc does not -directly support commas as decimal separators. Ledger mode will -translate values from decimal-comma format to decimal-period format for -use in Calc, but it cannot intercept the value being yanked form the -Calc stack, so decimal-comma users will have to manually replace the -period with a comma. - +anywhere in the same line as a posting, typing @code{C-c C-b} will bring +up the Calc buffer, and push the current amount for the posting onto the +top of the Calc stack. Perform any calculations you need to arrive at +the final value, then type @code{y} to yank the value at the top of +stack back into the ledger buffer. Note: GNU Calc does not directly +support commas as decimal separators. Ledger mode will translate values +from decimal-comma format to decimal-period format for use in Calc, but +it cannot intercept the value being yanked form the Calc stack, so +decimal-comma users will have to manually replace the period with +a comma. @node Marking Transactions, Deleting Transactions, Editing Amounts, The Ledger Buffer @section Marking Transactions + Ledger considers transaction or posting to be in one of three states: uncleared, cleared, and pending. For calculation Ledger ignores these states unless specifically instructed to use them. Ledger-mode assigns some additional meaning to the states: + @itemize @item Uncleared. No state. This is equivalent to sticking a check in the mail. It has @@ -277,12 +290,13 @@ your account balance. You bank may call these transactions 'pending', but Ledger-mode uses a slightly different meaning. @item Pending. Ledger-mode's reconciliation function see pending transactions as an -intermediate step in reconciling an account. When doing a -reconciliation (@pxref{Reconciliation}), marking a transaction as +intermediate step in reconciling an account. When doing +a reconciliation (@pxref{Reconciliation}), marking a transaction as pending means that you have seen the transaction finally recorded by the recipient, but you have not completely reconciled the account. @item Cleared. -The transaction has been completely recognized by all parties to the transaction. +The transaction has been completely recognized by all parties to the +transaction. @end itemize Clearing complete transactions is done by typing @code{C-c C-e} with @@ -292,6 +306,7 @@ while in a posting. This places an asterisk prior to the posting. @node Deleting Transactions, Sorting Transactions, Marking Transactions, The Ledger Buffer @section Deleting Transactions + Along with normal buffer editing methods to delete text, Ledger mode provides an easy way to delete the transaction under point: @code{C-c C-d}. The advantage to using this method is that the complete @@ -307,8 +322,8 @@ can help bring order to chaos. Ledger sort (@code{C-c C-s}) will sort all of the transactions in a region by date. Ledger-mode isn't particularly smart about handling dates and it simply sorts the transactions using the string at the beginning of the transaction. So, -you should use the preferred ISO 8601 standard date format @code{YYYY/MM/DD} -which easily sorts. +you should use the preferred ISO 8601 standard date format +@code{YYYY/MM/DD} which easily sorts. Note, there is a menu entry to sort the entire buffer. Special transactions like automated transaction, will be moved in the sorting @@ -316,7 +331,8 @@ process and may not function correctly afterwards. For this reason there is no key sequence. You can limit the allowed sort region by using embedded Ledger-mode -markup within your ledger. For exmaple +markup within your ledger. For exmaple + @smallexample <<< information to not sort >>> @@ -328,6 +344,7 @@ markup within your ledger. For exmaple <<< information to not sort >>> @end smallexample + You can use menu entries to insert start and end markers. These functions will automatically delete old markers and put new new marker at point. @@ -335,8 +352,8 @@ at point. @node Narrowing Transactions, , Sorting Transactions, The Ledger Buffer @section Narrowing Transactions -Often you will want to run Ledger register reports just to look at a -specific set of transactions. If you don't need the running total +Often you will want to run Ledger register reports just to look at +a specific set of transactions. If you don't need the running total calculation handled by Ledger, Ledger-mode provides a rapid way of narrowing what is displayed in the buffer in a way that is simpler than the Ledger register command. @@ -347,8 +364,8 @@ regular expression can match on any part of the transaction. If you want to find all transactions whose amount ends in .37, you can do that ( I don't know why, but hey, whatever ever floats you aerostat). -Using @code{C-c C-f} or the @code{Hide Xacts} menu entry, enter a -regular expression in the minibuffer. Ledger-mode will hide all other +Using @code{C-c C-f} or the @code{Hide Xacts} menu entry, enter +a regular expression in the minibuffer. Ledger-mode will hide all other transactions. For details of the regular expression syntax, see @ref{(emacs)Regexps, Syntax of Regular Expressions} or @ref{(elisp)Regular Expressions, Regular Expressions}. A few examples @@ -367,20 +384,21 @@ Show only transactions with payees or accounts or comments containing `auto' Show only transcations with any line ending with `harley' @end table -To show back all transactions simply invoke @code{Hide Xacts} or @code{C-c -C-f} again. +To show back all transactions simply invoke @code{Hide Xacts} or +@code{C-c C-f} again. @node The Reconcile Buffer, The Report Buffer, The Ledger Buffer, Top @chapter The Reconcile Buffer + @menu -* Basics of Reconciliation:: -* Starting a Reconciliation:: -* Mark Transactions Pending:: -* Edit Transactions During Reconciliation:: -* Finalize Reconciliation:: -* Adding and Deleting Transactions during Reconciliation:: -* Changing Reconciliation Account:: -* Changing Reconciliation Target:: +* Basics of Reconciliation:: +* Starting a Reconciliation:: +* Mark Transactions Pending:: +* Edit Transactions During Reconciliation:: +* Finalize Reconciliation:: +* Adding and Deleting Transactions during Reconciliation:: +* Changing Reconciliation Account:: +* Changing Reconciliation Target:: @end menu @node Basics of Reconciliation, Starting a Reconciliation, The Reconcile Buffer, The Reconcile Buffer @@ -398,7 +416,7 @@ money has actually made it to you. After an account has been reconciled you have verified that all the transactions in that account have been correctly recorded and all -parties agree. +parties agree. @node Starting a Reconciliation, Mark Transactions Pending, Basics of Reconciliation, The Reconcile Buffer @section Starting a Reconciliation @@ -414,12 +432,12 @@ account you wish to reconcile in the mini-buffer. Ledger-mode is not particular about what you enter for the account. You can leave it blank and Reconcile Mode will show you ALL uncleared transactions. After you enter the account enter the target amount. Ledger expects you to enter -an amount with a commodity. It assumes initially that you are using $ -(USD) as your default commodity. If you are working in a different +an amount with a commodity. It assumes initially that you are using +$ (USD) as your default commodity. If you are working in a different currency you can change the default in variable @code{ledger-reconcile-default-commodity} to whatever you need. If you work in multiple commodities simply enter the commoditized amount (for -example @code{340 VSDX}, for 340 shares of VSDX). +example @code{340 VSDX}, for 340 shares of VSDX). Ledger-mode reconcile cannot currently reconcile accounts that have multiple commodities, such as brokerage accounts. You may use @@ -431,14 +449,14 @@ not display the complete list of commodities. The @file{*Reconcile*} buffer will show all the uncleared transactions that meet the criteria set in the regex. By default uncleared -transactions are shown in red. When you have verified that a -transaction has been correctly and completely recorded by the opposing +transactions are shown in red. When you have verified that +a transaction has been correctly and completely recorded by the opposing party, mark the transaction as pending using the space bar. Continue this process until you agree with the opposing party and the difference from your target is zero. @node Edit Transactions During Reconciliation, Finalize Reconciliation, Mark Transactions Pending, The Reconcile Buffer -@section Edit Transactions during Reconciliation +@section Edit Transactions during Reconciliation If you find errors during reconciliation. You can visit the transaction under point in the @file{*Reconcile*} buffer by hitting the @code{enter} @@ -478,23 +496,25 @@ the ledger buffer are left in that state when the account is switched. If for some reason during reconciliation your target amount changes, type @code{t} and enter the new target value. - @node The Report Buffer, Customizing Ledger-mode, The Reconcile Buffer, Top @chapter The Report Buffer + @menu -* Running Basic Reports:: -* Adding and Editing Reports:: -* Reversing Report Order:: +* Running Basic Reports:: +* Adding and Editing Reports:: +* Reversing Report Order:: @end menu @node Running Basic Reports, Adding and Editing Reports, The Report Buffer, The Report Buffer @section Running Reports + The real power behind Ledger is in its amazing reporting capability. Ledger-mode provides easy facility to run reports directly from Emacs. It has four reports built-in and facilities for adding custom reports. Typing @code{C-c C-o C-r} or using menu @code{Ledger Run Report} prompt for the name of a saved report. The built-in reports are: + @table @samp @item bal Produce a balance reports of all accounts. @@ -508,12 +528,12 @@ Prompt for an account, the produce a register report of all transaction involving that account. @end table - @node Adding and Editing Reports, Reversing Report Order, Running Basic Reports, The Report Buffer @section Adding and Editing Reports + @menu -* Expansion Formats:: -* Make Report Transactions Active:: +* Expansion Formats:: +* Make Report Transactions Active:: @end menu If you type a report name that Ledger-mode doesn't recognize it will @@ -529,11 +549,11 @@ the report will be run, but it will not be permanently saved. If you want to save it, type @code{S} in the @file{*Ledger Report*} buffer you will have the option to give it a new name, or overwrite the old report. -Deleting reports is accomplished by typing @code{C-c C-o C-e} Edit Reports -in the ledger buffer, or typing @code{e} in the @file{*Ledger Report*} -buffer. This takes you to the Emacs customization window for the -@code{ledger-reports} variable. Use the widgets to delete the report -you want removed. +Deleting reports is accomplished by typing @code{C-c C-o C-e} Edit +Reports in the ledger buffer, or typing @code{e} in the @file{*Ledger +Report*} buffer. This takes you to the Emacs customization window for +the @code{ledger-reports} variable. Use the widgets to delete the +report you want removed. @node Expansion Formats, Make Report Transactions Active, Adding and Editing Reports, Adding and Editing Reports @subsection Expansion Formats @@ -560,6 +580,7 @@ You can use these expansion values in your ledger report commands. For example, if you wanted to specify a register report the displayed transactions from a user-determined account with a particular meta-data tag value, you specify the following command line: + @smallexample ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" @end smallexample @@ -571,9 +592,9 @@ ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" In a large register report it is convenient to be able to jump to the source transaction. Ledger-mode will automatically include source -information in every register file that doesn't contain a -@code{--subtotal} option. It does this by adding a -@code{--prepend-format='%(filename):%(beg_line):'} to the register +information in every register file that doesn't contain +a @code{--subtotal} option. It does this by adding +a @code{--prepend-format='%(filename):%(beg_line):'} to the register report command-line you specify. You should never have to see this, but if there is an error in your ledger output this additional information may not get stripped out of the visible report. @@ -581,21 +602,21 @@ may not get stripped out of the visible report. @node Reversing Report Order, , Adding and Editing Reports, The Report Buffer @section Reversing Report Order -Often, banks show their online transaction histories with the most recent -transaction at the top. Ledger itself cannot do a sensible ledger -report in reverse chronological order, if you sort on reverse date the -calculation will also run in the opposite direction. If you want to -compare a ledger register report to a bank report with the most recent -transactions at the top, type R in the @file{*Ledger Report*} buffer and -it will reverse the order of the transactions and maintain the proper -mathematical sense. - +Often, banks show their online transaction histories with the most +recent transaction at the top. Ledger itself cannot do a sensible +ledger report in reverse chronological order, if you sort on reverse +date the calculation will also run in the opposite direction. If you +want to compare a ledger register report to a bank report with the most +recent transactions at the top, type R in the @file{*Ledger Report*} +buffer and it will reverse the order of the transactions and maintain +the proper mathematical sense. @node Customizing Ledger-mode, Generating Ledger Regression Tests, The Report Buffer, Top @chapter Customizing Ledger-mode + @menu -* Ledger-mode Customization:: -* Customization Variables:: +* Ledger-mode Customization:: +* Customization Variables:: @end menu @node Ledger-mode Customization, Customization Variables, Customizing Ledger-mode, Customizing Ledger-mode @@ -613,25 +634,28 @@ for Ledger under the data options. Alternately you can choose @section Customization Variables @menu -* Ledger Customization Group:: -* Ledger Reconcile Customization Group:: -* Ledger Report Customization Group:: -* Ledger Faces Customization Group:: -* Ledger Post Customization Group:: -* Ledger Exec Customization Group:: -* Ledger Test Customization Group:: -* Ledger Texi Customization Group:: +* Ledger Customization Group:: +* Ledger Reconcile Customization Group:: +* Ledger Report Customization Group:: +* Ledger Faces Customization Group:: +* Ledger Post Customization Group:: +* Ledger Exec Customization Group:: +* Ledger Test Customization Group:: +* Ledger Texi Customization Group:: @end menu @node Ledger Customization Group, Ledger Reconcile Customization Group, Customization Variables, Customization Variables @subsection Ledger Customization Group + @table @code @item ledger-occur-use-face-shown - If non-nil, use a custom face for xacts shown in `ledger-occur' mode using @code{ledger-occur-xact-face}. +If non-nil, use a custom face for xacts shown in `ledger-occur' mode +using @code{ledger-occur-xact-face}. @item ledger-clear-whole-transactions - If non-nil, clear whole transactions, not individual postings. +If non-nil, clear whole transactions, not individual postings. @item ledger-highlight-xact-under-point - If non-nil, highlight xact under point using @code{ledger-font-highlight-face}. +If non-nil, highlight xact under point using +@code{ledger-font-highlight-face}. @end table @node Ledger Reconcile Customization Group, Ledger Report Customization Group, Ledger Customization Group, Customization Variables @@ -642,19 +666,19 @@ for Ledger under the data options. Alternately you can choose The default commodity for use in target calculations in ledger reconcile. Defaults to $ (USD) @item ledger-recon-buffer-name - Name to use for reconciliation window. +Name to use for reconciliation window. @item ledger-narrow-on-reconcile - If non-nil, limit transactions shown in main buffer to those matching the - reconcile regex. +If non-nil, limit transactions shown in main buffer to those matching +the reconcile regex. @item ledger-buffer-tracks-reconcile-buffer - If non-nil, then when the cursor is moved to a new xact in the recon - window. +If non-nil, then when the cursor is moved to a new xact in the recon +window. @item ledger-reconcile-force-window-bottom - If non-nil, make the reconcile window appear along the bottom of the - register window and resize. +If non-nil, make the reconcile window appear along the bottom of the +register window and resize. @item ledger-reconcile-toggle-to-pending - If non-nil, then toggle between uncleared and pending (@code{!}). If false - toggle between uncleared and cleared (@code{*}) +If non-nil, then toggle between uncleared and pending (@code{!}). If +false toggle between uncleared and cleared (@code{*}) @end table @node Ledger Report Customization Group, Ledger Faces Customization Group, Ledger Reconcile Customization Group, Customization Variables @@ -662,15 +686,17 @@ reconcile. Defaults to $ (USD) @table @code @item ledger-reports - Definition of reports to run. +Definition of reports to run. @item ledger-report-format-specifiers - An alist mapping ledger report format specifiers to implementing functions. +An alist mapping ledger report format specifiers to implementing +functions. @end table - @node Ledger Faces Customization Group, Ledger Post Customization Group, Ledger Report Customization Group, Customization Variables -@subsection Ledger Faces Customization Group +@subsection Ledger Faces Customization Group + Ledger Faces : Ledger mode highlighting + @table @code @item ledger-font-uncleared-face Default face for Ledger @@ -688,7 +714,6 @@ Face for Ledger accounts Face for cleared Ledger accounts @item ledger-font-posting-account-pending-face Face for Ledger pending accounts - @item ledger-font-posting-amount-face Face for Ledger amounts @item ledger-occur-narrowed-face @@ -709,9 +734,10 @@ Default face for pending (!) transactions in the reconcile window @node Ledger Post Customization Group, Ledger Exec Customization Group, Ledger Faces Customization Group, Customization Variables @subsection Ledger Post Customization Group -Ledger Post : -@table @code +Ledger Post : + +@table @code @item ledger-post-auto-adjust-amounts If non-nil, then automatically align amounts to column specified in @code{ledger-post-amount-alignment-column} @@ -736,24 +762,26 @@ Path to the ledger executable. Location of the ledger initialization file. nil if you don't have one @end table - @node Ledger Test Customization Group, Ledger Texi Customization Group, Ledger Exec Customization Group, Customization Variables @subsection Ledger Test Customization Group + @table @code @item ledger-source-directory - Directory where the Ledger sources are located. +Directory where the Ledger sources are located. @item ledger-test-binary - Directory where the debug binary. +Directory where the debug binary. @end table @node Ledger Texi Customization Group, , Ledger Test Customization Group, Customization Variables @subsection Ledger Texi Customization Group @table @code -@item ledger-texi-sample-doc-path -Location for sample data to be used in texi tests, defaults to @file{~/ledger/doc/sample.dat} -@item ledger-texi-normalization-args -texi normalization for producing ledger output, defaults to ``@code{--args-only --columns 80}'' +@item ledger-texi-sample-doc-path +Location for sample data to be used in texi tests, defaults to +@file{~/ledger/doc/sample.dat} +@item ledger-texi-normalization-args +texi normalization for producing ledger output, defaults to +``@code{--args-only --columns 80}'' @end table @node Generating Ledger Regression Tests, Embedding Example results in Ledger Documentation, Customizing Ledger-mode, Top @@ -770,4 +798,5 @@ Work in Progress. @chapter Hacking Ledger-mode Work in Progress. + @bye -- cgit v1.2.3 From 2c5d3757813b8545db81e3c0a80253a44983c6bf Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 21:18:04 +0200 Subject: Add indexes --- doc/ledger-mode.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 73f343ce..a798e4a2 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -799,4 +799,14 @@ Work in Progress. Work in Progress. +@node Concept Index +@unnumbered Concept Index + +@printindex cp + +@node Command Index +@unnumbered Command Index + +@printindex fn + @bye -- cgit v1.2.3 From dfe1c4995bba51ab1ed0f8ebb5a754b39f83acfd Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 21:18:33 +0200 Subject: Moved from @smallexample to @example --- doc/ledger-mode.texi | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index a798e4a2..463d5a22 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -331,9 +331,9 @@ process and may not function correctly afterwards. For this reason there is no key sequence. You can limit the allowed sort region by using embedded Ledger-mode -markup within your ledger. For exmaple +markup within your ledger. For example: -@smallexample +@example <<< information to not sort >>> ; Ledger-mode: Start sort @@ -343,7 +343,7 @@ markup within your ledger. For exmaple ; Ledger-mode: End sort <<< information to not sort >>> -@end smallexample +@end example You can use menu entries to insert start and end markers. These functions will automatically delete old markers and put new new marker @@ -581,9 +581,9 @@ example, if you wanted to specify a register report the displayed transactions from a user-determined account with a particular meta-data tag value, you specify the following command line: -@smallexample +@example ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" -@end smallexample +@end example @noindent Note how the double-quotes are escaped with back-slashes. -- cgit v1.2.3 From bb2a52cfa2ed20897659d73f48b0b7df62e92d0c Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 21:23:48 +0200 Subject: Fix consistency of "Ledger-mode" spelling --- doc/ledger-mode.texi | 44 +++++++++++++++++++++++--------------------- 1 file changed, 23 insertions(+), 21 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 463d5a22..e517af20 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -67,14 +67,14 @@ accounting based on a text journal. It provides no bells or whistles, and returns the user to the days before user interfaces were even a 1twinkling in their father's CRT. -Ledger Mode assists you in maintaining input files for Ledger, running +Ledger-mode assists you in maintaining input files for Ledger, running reports and much more... @end ifnottex @menu * Copying:: -* Introduction to Ledger Mode:: +* Introduction to Ledger-mode:: * The Ledger Buffer:: * The Reconcile Buffer:: * The Report Buffer:: @@ -82,15 +82,17 @@ reports and much more... * Generating Ledger Regression Tests:: * Embedding Example results in Ledger Documentation:: * Hacking Ledger-mode:: +* Concept Index:: +* Command Index:: @end menu -@node Copying, Introduction to Ledger Mode, Top, Top +@node Copying, Introduction to Ledger-mode, Top, Top @chapter Copying @insertcopying -@node Introduction to Ledger Mode, The Ledger Buffer, Copying, Top -@chapter Introduction to Ledger Mode +@node Introduction to Ledger-mode, The Ledger Buffer, Copying, Top +@chapter Introduction to Ledger-mode @menu * Quick Installation:: @@ -98,12 +100,12 @@ reports and much more... * Quick Demo:: @end menu -@node Quick Installation, Menus, Introduction to Ledger Mode, Introduction to Ledger Mode +@node Quick Installation, Menus, Introduction to Ledger-mode, Introduction to Ledger-mode @section Quick Installation The Emacs lisp source for Ledger-mode is included with the source distribution of Ledger. It is entirely included in the @file{lisp} -subdirectory. To use ledger mode, include the following in your Emacs +subdirectory. To use Ledger-mode, include the following in your Emacs initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, or @file{~/.Aquamacs/Preferences.el} @@ -114,17 +116,17 @@ initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, or @end lisp This sets up Emacs to automatically recognize files that end with -@file{.ledger} and start Ledger mode. Nothing else should be required +@file{.ledger} and start Ledger-mode. Nothing else should be required as long as the ledger command line utility is properly installed. -@node Menus, Quick Demo, Quick Installation, Introduction to Ledger Mode +@node Menus, Quick Demo, Quick Installation, Introduction to Ledger-mode @section Menus The vast majority of Ledger-mode functionality is available from the Emacs menu system. The keystrokes are shown in the menu to help you learn the faster keyboard methods. -@node Quick Demo, , Menus, Introduction to Ledger Mode +@node Quick Demo, , Menus, Introduction to Ledger-mode @section Quick Demo Load the demo file @file{demo.ledger} from the Ledger source @@ -154,7 +156,7 @@ search for a Payee that has the same beginning and copy the rest of the transaction to you new entry. Additionally you can use the ledger xact command, by typing @code{C-c -C-a} then typing a close match to the payee. Ledger mode will call +C-a} then typing a close match to the payee. Ledger-mode will call @code{ledger xact} with the data you enter and place the transaction in the proper chronological place in the ledger. @@ -163,7 +165,7 @@ the proper chronological place in the ledger. The biggest task of maintaining a ledger is ensuring the it matches the outside world. This process is called reconciliation (@pxref{Basics of -Reconciliation}) and can be quite onerous. Ledger mode attempts to make +Reconciliation}) and can be quite onerous. Ledger-mode attempts to make it as painless as possible. In the @file{demo.ledger} buffer type @code{C-c C-r}. Emacs will prompt @@ -197,7 +199,7 @@ and you can add any report you need @xref{Adding and Editing Reports}. In the mini-buffer type @code{account}. When prompted for an account type @code{checking}. In another buffer you will see a Ledger register report. You can move around the buffer, with the point on a transaction, -type @code{C-c C-c}. Ledger mode will take you directly to that +type @code{C-c C-c}. Ledger-mode will take you directly to that transaction in the @file{demo.ledger} buffer. Another built-in report is the balance report. In the @@ -215,7 +217,7 @@ Ledger-mode copies the @code{occur} mode functionality. Typing transactions that match the regex. The regex can be on any field, or amount. -@node The Ledger Buffer, The Reconcile Buffer, Introduction to Ledger Mode, Top +@node The Ledger Buffer, The Reconcile Buffer, Introduction to Ledger-mode, Top @chapter The Ledger Buffer @menu @@ -237,7 +239,7 @@ payees and accounts. Included files are not currently included in the completion scan. Repeatedly hitting @code{TAB} will cycle through the possible completions. -Ledger mode can also help you keep your amounts in alignment. Setting +Ledger-mode can also help you keep your amounts in alignment. Setting @code{ledger-post-auto-adjust-amounts} to true tells Ledger-mode to automatically place any amounts such that their last digit is aligned to the column specified by @code{ledger-post-amount-alignment-column}, @@ -267,7 +269,7 @@ up the Calc buffer, and push the current amount for the posting onto the top of the Calc stack. Perform any calculations you need to arrive at the final value, then type @code{y} to yank the value at the top of stack back into the ledger buffer. Note: GNU Calc does not directly -support commas as decimal separators. Ledger mode will translate values +support commas as decimal separators. Ledger-mode will translate values from decimal-comma format to decimal-period format for use in Calc, but it cannot intercept the value being yanked form the Calc stack, so decimal-comma users will have to manually replace the period with @@ -307,7 +309,7 @@ while in a posting. This places an asterisk prior to the posting. @node Deleting Transactions, Sorting Transactions, Marking Transactions, The Ledger Buffer @section Deleting Transactions -Along with normal buffer editing methods to delete text, Ledger mode +Along with normal buffer editing methods to delete text, Ledger-mode provides an easy way to delete the transaction under point: @code{C-c C-d}. The advantage to using this method is that the complete transaction operation is in the undo buffer. @@ -695,7 +697,7 @@ functions. @node Ledger Faces Customization Group, Ledger Post Customization Group, Ledger Report Customization Group, Customization Variables @subsection Ledger Faces Customization Group -Ledger Faces : Ledger mode highlighting +Ledger Faces : Ledger-mode highlighting @table @code @item ledger-font-uncleared-face @@ -794,17 +796,17 @@ Work in Progress. Work in Progress. -@node Hacking Ledger-mode, , Embedding Example results in Ledger Documentation, Top +@node Hacking Ledger-mode, Concept Index, Embedding Example results in Ledger Documentation, Top @chapter Hacking Ledger-mode Work in Progress. -@node Concept Index +@node Concept Index, Command Index, Hacking Ledger-mode, Top @unnumbered Concept Index @printindex cp -@node Command Index +@node Command Index, , Concept Index, Top @unnumbered Command Index @printindex fn -- cgit v1.2.3 From f4bca599d749115dd280701710ba87e68aa77676 Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 22:11:20 +0200 Subject: Move keyboard shortcuts to @kbd{} Move sample to @samp{} Move menu entries to @samp{} Move Ledger-mode variables to @options{} Move single characters to @samp{} Also use @emph{} --- doc/ledger-mode.texi | 242 ++++++++++++++++++++++++++------------------------- 1 file changed, 122 insertions(+), 120 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index e517af20..02798003 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -144,67 +144,67 @@ Ledger from a convenient command line. @node Quick Add, Reconciliation, Quick Demo, Quick Demo @subsection Quick Add -As simple as the ledger transaction format is, it can still be daunting +As simple as the Ledger transaction format is, it can still be daunting to add many transactions manually. Ledger provides two way to add transactions with minimal typing. Both are based on the idea that most transactions are repetitions of earlier transactions. In the @file{demo.ledger} buffer enter a date using the correct format. Then type the first few characters of another payee in the -@file{demo.ledger} buffer. Type @code{C-c TAB}. Ledger-mode will +@file{demo.ledger} buffer. Type @kbd{C-c TAB}. Ledger-mode will search for a Payee that has the same beginning and copy the rest of the transaction to you new entry. -Additionally you can use the ledger xact command, by typing @code{C-c +Additionally you can use the ledger xact command, by typing @kbd{C-c C-a} then typing a close match to the payee. Ledger-mode will call -@code{ledger xact} with the data you enter and place the transaction in -the proper chronological place in the ledger. +@command{ledger xact} with the data you enter and place the transaction +in the proper chronological place in the ledger. @node Reconciliation, Reports, Quick Add, Quick Demo @subsection Reconciliation -The biggest task of maintaining a ledger is ensuring the it matches the +The biggest task of maintaining a ledger is ensuring that it matches the outside world. This process is called reconciliation (@pxref{Basics of Reconciliation}) and can be quite onerous. Ledger-mode attempts to make it as painless as possible. -In the @file{demo.ledger} buffer type @code{C-c C-r}. Emacs will prompt -for an account to reconcile in the mini-buffer. Enter @code{Checking}. +In the @file{demo.ledger} buffer type @kbd{C-c C-r}. Emacs will prompt +for an account to reconcile in the mini-buffer. Enter @samp{Checking}. Emacs will then prompt for a target value. The target value is the amount you want the cleared transactions in the buffer to total. Normally this would be the ending value from your bank statement, or the -latest value in your on-line transaction summary. Enter @code{1710}. -Note that Ledger-mode assumes your are using $ (USD) as your default -commodity, this can be easily changed in the customization +latest value in your on-line transaction summary. Enter @samp{1710}. +Note that Ledger-mode assumes your are using @samp{$} (USD) as your +default commodity, this can be easily changed in the customization variables. @xref{Ledger-mode Customization}. You now see a list of uncleared transactions in a buffer below the -@file{demo.ledger} buffer. Touching the space bar will mark +@file{demo.ledger} buffer. Touching the @kbd{SPC} bar will mark a transaction as pending and display the current cleared (and pending) balance, along with the difference remaining to meet your target. Clear the first three transactions, and you will see the difference to target -reach $0. End the reconciliation by typing @code{C-c C-c}. This saves -the demo.ledger buffer and marks the transactions and finally cleared. -Type @code{q} to close out the reconciliation buffer. +reach @samp{$0}. End the reconciliation by typing @kbd{C-c C-c}. This +saves the @file{demo.ledger} buffer and marks the transactions and finally +cleared. Type @kbd{q} to close out the reconciliation buffer. @node Reports, Narrowing, Reconciliation, Quick Demo @subsection Reports The real power of Ledger is in it reporting capabilities. Reports can be run and displayed in a separate Emacs buffer. In the -@file{demo.ledger} buffer, type @code{C-c C-o C-r}. In the mini-buffer +@file{demo.ledger} buffer, type @kbd{C-c C-o C-r}. In the mini-buffer Emacs will prompt for a report name. There are a few built-in reports, and you can add any report you need @xref{Adding and Editing Reports}. -In the mini-buffer type @code{account}. When prompted for an account -type @code{checking}. In another buffer you will see a Ledger register +In the mini-buffer type @samp{account}. When prompted for an account +type @samp{checking}. In another buffer you will see a Ledger register report. You can move around the buffer, with the point on a transaction, -type @code{C-c C-c}. Ledger-mode will take you directly to that +type @kbd{C-c C-c}. Ledger-mode will take you directly to that transaction in the @file{demo.ledger} buffer. Another built-in report is the balance report. In the -@file{demo.ledger} buffer, type @code{C-c C-o C-r}. When prompted for -a report to run, type @code{bal}, and a balance report of all accounts +@file{demo.ledger} buffer, type @kbd{C-c C-o C-r}. When prompted for +a report to run, type @samp{bal}, and a balance report of all accounts will be shown. @node Narrowing, , Reports, Quick Demo @@ -212,8 +212,8 @@ will be shown. A ledger file can get very large. It can be helpful to collapse the buffer to display only the transactions you are interested in. -Ledger-mode copies the @code{occur} mode functionality. Typing -@code{C-c C-f} and entering any regex in the mini-buffer will show only +Ledger-mode copies the @command{occur} mode functionality. Typing +@kbd{C-c C-f} and entering any regex in the mini-buffer will show only transactions that match the regex. The regex can be on any field, or amount. @@ -233,17 +233,17 @@ amount. @section Adding Transactions Beyond the two ways of quickly adding transactions (@pxref{Quick Add}) -Ledger-mode assists you by providing robust @code{TAB} completion for +Ledger-mode assists you by providing robust @kbd{TAB} completion for payees and accounts. Ledger-mode will scan the existing buffer for payees and accounts. Included files are not currently included in the -completion scan. Repeatedly hitting @code{TAB} will cycle through the +completion scan. Repeatedly hitting @kbd{TAB} will cycle through the possible completions. Ledger-mode can also help you keep your amounts in alignment. Setting -@code{ledger-post-auto-adjust-amounts} to true tells Ledger-mode to +@option{ledger-post-auto-adjust-amounts} to true tells Ledger-mode to automatically place any amounts such that their last digit is aligned to -the column specified by @code{ledger-post-amount-alignment-column}, -which defaults to 52. @xref{Ledger Post Customization Group}. +the column specified by @option{ledger-post-amount-alignment-column}, +which defaults to @samp{52}. @xref{Ledger Post Customization Group}. @menu * Quick Balance Display:: @@ -254,8 +254,8 @@ which defaults to 52. @xref{Ledger Post Customization Group}. You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, -and type @code{C-C C-P}. The minibuffer will ask you to verify the name -of the account you want, if it is already correct hit return, then the +and type @kbd{C-C C-P}. The minibuffer will ask you to verify the name +of the account you want, if it is already correct hit @kbd{RET}, then the balance of the account will be displayed in the minibuffer. @node Editing Amounts, Marking Transactions, Adding Transactions, The Ledger Buffer @@ -264,10 +264,10 @@ balance of the account will be displayed in the minibuffer. GNU Calc is a very powerful Reverse Polish Notation calculator built into all recent version of Emacs. Ledger-mode makes it easy to calculate values for amount by integrating GNU Calc. With the point -anywhere in the same line as a posting, typing @code{C-c C-b} will bring +anywhere in the same line as a posting, typing @kbd{C-c C-b} will bring up the Calc buffer, and push the current amount for the posting onto the top of the Calc stack. Perform any calculations you need to arrive at -the final value, then type @code{y} to yank the value at the top of +the final value, then type @kbd{y} to yank the value at the top of stack back into the ledger buffer. Note: GNU Calc does not directly support commas as decimal separators. Ledger-mode will translate values from decimal-comma format to decimal-period format for use in Calc, but @@ -288,7 +288,7 @@ some additional meaning to the states: No state. This is equivalent to sticking a check in the mail. It has been obligated, but not been cashed by the recipient. It could also apply to credit/debit card transactions that have not been cleared into -your account balance. You bank may call these transactions 'pending', +your account balance. You bank may call these transactions ``pending'', but Ledger-mode uses a slightly different meaning. @item Pending. Ledger-mode's reconciliation function see pending transactions as an @@ -301,16 +301,16 @@ The transaction has been completely recognized by all parties to the transaction. @end itemize -Clearing complete transactions is done by typing @code{C-c C-e} with -point in a transaction. This places an asterisk (@code{*}) after the -date. Clearing individual postings is done by typing @code{C-c C-c} +Clearing complete transactions is done by typing @kbd{C-c C-e} with +point in a transaction. This places an asterisk @samp{*} after the +date. Clearing individual postings is done by typing @kbd{C-c C-c} while in a posting. This places an asterisk prior to the posting. @node Deleting Transactions, Sorting Transactions, Marking Transactions, The Ledger Buffer @section Deleting Transactions Along with normal buffer editing methods to delete text, Ledger-mode -provides an easy way to delete the transaction under point: @code{C-c +provides an easy way to delete the transaction under point: @kbd{C-c C-d}. The advantage to using this method is that the complete transaction operation is in the undo buffer. @@ -320,12 +320,12 @@ transaction operation is in the undo buffer. As you operating on the Ledger files, they may become disorganized. For the most part, Ledger doesn't care, but our human brains prefer a bit of order. Sorting the transactions in a buffer into chronological order -can help bring order to chaos. Ledger sort (@code{C-c C-s}) will sort +can help bring order to chaos. Ledger sort @kbd{C-c C-s} will sort all of the transactions in a region by date. Ledger-mode isn't particularly smart about handling dates and it simply sorts the transactions using the string at the beginning of the transaction. So, you should use the preferred ISO 8601 standard date format -@code{YYYY/MM/DD} which easily sorts. +@samp{YYYY/MM/DD} which easily sorts. Note, there is a menu entry to sort the entire buffer. Special transactions like automated transaction, will be moved in the sorting @@ -361,12 +361,12 @@ narrowing what is displayed in the buffer in a way that is simpler than the Ledger register command. Based on the Emacs Occur mode by Alexey Veretennikov, Ledger-occur hides -all transactions that do NOT meet a specific regular expression. The -regular expression can match on any part of the transaction. If you -want to find all transactions whose amount ends in .37, you can do that -( I don't know why, but hey, whatever ever floats you aerostat). +all transactions that do @emph{not} meet a specific regular expression. +The regular expression can match on any part of the transaction. If you +want to find all transactions whose amount ends in @samp{.37}, you can +do that (I don't know why, but hey, whatever ever floats you aerostat). -Using @code{C-c C-f} or the @code{Hide Xacts} menu entry, enter +Using @kbd{C-c C-f} or the @samp{Hide Xacts} menu entry, enter a regular expression in the minibuffer. Ledger-mode will hide all other transactions. For details of the regular expression syntax, see @ref{(emacs)Regexps, Syntax of Regular Expressions} or @@ -375,19 +375,21 @@ using the @file{demo.ledger} are given here: @table @samp @item Groceries -Show only transactions that have a posting to the `Groceries' account. +Show only transactions that have a posting to the @samp{Groceries} +account. @item ^2011/01 Show only transactions occurring in January of 2011. @item ^2011/.*/25 Show only transactions occurring on the 25th of the month in 2011 @item auto -Show only transactions with payees or accounts or comments containing `auto' +Show only transactions with payees or accounts or comments containing +@samp{auto} @item harley$ -Show only transcations with any line ending with `harley' +Show only transactions with any line ending with @samp{harley} @end table -To show back all transactions simply invoke @code{Hide Xacts} or -@code{C-c C-f} again. +To show back all transactions simply invoke @samp{Hide Xacts} or +@kbd{C-c C-f} again. @node The Reconcile Buffer, The Report Buffer, The Ledger Buffer, Top @chapter The Reconcile Buffer @@ -409,12 +411,12 @@ To show back all transactions simply invoke @code{Hide Xacts} or Even in this relatively modern era, financial transactions do not happen instantaneously, unless you are paying cash. When you swipe your debit card the money may take several days to actually come out of your -account, or a check may take several days to ``clear''. That is the -root of the difference between ``obligating'' funds and ``expending'' -funds. Obligation says you have agreed to pay it, the expenditure -doesn't happen until the money actually leaves your account. Or in the -case of receiving payment, you have an account receivable until the -money has actually made it to you. +account, or a check may take several days to @emph{clear}. That is the +root of the difference between @dfn{obligating} funds and +@dfn{expending} funds. Obligation says you have agreed to pay it, the +expenditure doesn't happen until the money actually leaves your +account. Or in the case of receiving payment, you have an account +receivable until the money has actually made it to you. After an account has been reconciled you have verified that all the transactions in that account have been correctly recorded and all @@ -429,17 +431,17 @@ about. You can get this from a monthly statement, or from checking your online transaction history. It also helps immensely to know the final cleared balance you are aiming for. -Use menu @code{Reconcile Account} or @code{C-c C-r} and enter the -account you wish to reconcile in the mini-buffer. Ledger-mode is not -particular about what you enter for the account. You can leave it blank -and Reconcile Mode will show you ALL uncleared transactions. After you -enter the account enter the target amount. Ledger expects you to enter -an amount with a commodity. It assumes initially that you are using -$ (USD) as your default commodity. If you are working in a different -currency you can change the default in variable -@code{ledger-reconcile-default-commodity} to whatever you need. If you -work in multiple commodities simply enter the commoditized amount (for -example @code{340 VSDX}, for 340 shares of VSDX). +Use menu @samp{Reconcile Account} or @kbd{C-c C-r} and enter the account +you wish to reconcile in the mini-buffer. Ledger-mode is not particular +about what you enter for the account. You can leave it blank and +Reconcile Mode will show you @emph{all} uncleared transactions. After +you enter the account enter the target amount. Ledger expects you to +enter an amount with a commodity. It assumes initially that you are +using @samp{$} (USD) as your default commodity. If you are working in +a different currency you can change the default in variable +@option{ledger-reconcile-default-commodity} to whatever you need. If +you work in multiple commodities simply enter the commoditized amount +(for example @samp{340 VSDX}, for 340 shares of VSDX). Ledger-mode reconcile cannot currently reconcile accounts that have multiple commodities, such as brokerage accounts. You may use @@ -453,7 +455,7 @@ The @file{*Reconcile*} buffer will show all the uncleared transactions that meet the criteria set in the regex. By default uncleared transactions are shown in red. When you have verified that a transaction has been correctly and completely recorded by the opposing -party, mark the transaction as pending using the space bar. Continue +party, mark the transaction as pending using the @kbd{SPC} bar. Continue this process until you agree with the opposing party and the difference from your target is zero. @@ -461,7 +463,7 @@ from your target is zero. @section Edit Transactions during Reconciliation If you find errors during reconciliation. You can visit the transaction -under point in the @file{*Reconcile*} buffer by hitting the @code{enter} +under point in the @file{*Reconcile*} buffer by hitting the @kbd{RET} key. This will take you to the transaction in the Ledger buffer. When you have finished editing the transaction saving the buffer will automatically return you to the @file{*Reconcile*} buffer and you can @@ -471,24 +473,24 @@ mark the transaction if appropriate. @section Finalize Reconciliation Once you have marked all transactions as pending and the cleared balance -is correct. Finish the reconciliation by typing @code{C-c C-c}. This +is correct. Finish the reconciliation by typing @kbd{C-c C-c}. This marks all pending transaction as cleared and saves the ledger buffer. @node Adding and Deleting Transactions during Reconciliation, Changing Reconciliation Account, Finalize Reconciliation, The Reconcile Buffer @section Adding and Deleting Transactions during Reconciliation While reconciling, you may find new transactions that need to be entered -into your ledger. Simply type @code{a} to bring up the quick add for +into your ledger. Simply type @kbd{a} to bring up the quick add for the ledger buffer. -Typing @code{d} will delete the transaction under point in the +Typing @kbd{d} will delete the transaction under point in the @file{*Reconcile*} buffer from the ledger buffer. @node Changing Reconciliation Account, Changing Reconciliation Target, Adding and Deleting Transactions during Reconciliation, The Reconcile Buffer @section Changing Reconciliation Account You can conveniently switch the account being reconciled by typing -@code{g}, and entering a new account to reconcile. This simply restarts +@kbd{g}, and entering a new account to reconcile. This simply restarts the reconcile process. Any transactions that were marked `pending' in the ledger buffer are left in that state when the account is switched. @@ -496,7 +498,7 @@ the ledger buffer are left in that state when the account is switched. @section Changing Reconciliation Target If for some reason during reconciliation your target amount changes, -type @code{t} and enter the new target value. +type @kbd{t} and enter the new target value. @node The Report Buffer, Customizing Ledger-mode, The Reconcile Buffer, Top @chapter The Report Buffer @@ -514,7 +516,7 @@ The real power behind Ledger is in its amazing reporting capability. Ledger-mode provides easy facility to run reports directly from Emacs. It has four reports built-in and facilities for adding custom reports. -Typing @code{C-c C-o C-r} or using menu @code{Ledger Run Report} prompt +Typing @kbd{C-c C-o C-r} or using menu @samp{Ledger Run Report} prompt for the name of a saved report. The built-in reports are: @table @samp @@ -523,11 +525,11 @@ Produce a balance reports of all accounts. @item reg Produce a register report of all transactions. @item payee -Prompt for a payee, the produce a register report of all transaction +Prompt for a payee, then produce a register report of all transactions involving that payee. @item account -Prompt for an account, the produce a register report of all transaction -involving that account. +Prompt for an account, then produce a register report of all +transactions involving that account. @end table @node Adding and Editing Reports, Reversing Report Order, Running Basic Reports, The Report Buffer @@ -545,29 +547,29 @@ time. There are two ways to edit the command line for a report. The first is to provide a prefix argument to the run-report command. For example, -type @code{M-1 C-c C-o C-r}. This will prompt you for the report name, -then present the report command line to be edited. When you hit enter, +type @kbd{M-1 C-c C-o C-r}. This will prompt you for the report name, +then present the report command line to be edited. When you hit @kbd{RET}, the report will be run, but it will not be permanently saved. If you -want to save it, type @code{S} in the @file{*Ledger Report*} buffer you +want to save it, type @kbd{S} in the @file{*Ledger Report*} buffer you will have the option to give it a new name, or overwrite the old report. -Deleting reports is accomplished by typing @code{C-c C-o C-e} Edit -Reports in the ledger buffer, or typing @code{e} in the @file{*Ledger +Deleting reports is accomplished by typing @kbd{C-c C-o C-e} Edit +Reports in the ledger buffer, or typing @kbd{e} in the @file{*Ledger Report*} buffer. This takes you to the Emacs customization window for -the @code{ledger-reports} variable. Use the widgets to delete the +the @option{ledger-reports} variable. Use the widgets to delete the report you want removed. @node Expansion Formats, Make Report Transactions Active, Adding and Editing Reports, Adding and Editing Reports @subsection Expansion Formats -It is sometime convenient to leave room to customize a report without +It is sometimes convenient to leave room to customize a report without saving the command line every time. For example running a register report for a specific account, enter at runtime by the user. The -built-in report @file{account} does exactly that, using a variable +built-in report @samp{account} does exactly that, using a variable expansion to prompt the user for the account to use. There are four variable that can be expanded to run a report: -@table @samp +@table @option @item ledger-file Returns the file to be operated on. @item payee @@ -587,7 +589,7 @@ tag value, you specify the following command line: ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" @end example -@noindent Note how the double-quotes are escaped with back-slashes. +Note how the double-quotes are escaped with back-slashes. @node Make Report Transactions Active, , Expansion Formats, Adding and Editing Reports @subsection Make Report Transactions Active @@ -595,8 +597,8 @@ ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" In a large register report it is convenient to be able to jump to the source transaction. Ledger-mode will automatically include source information in every register file that doesn't contain -a @code{--subtotal} option. It does this by adding -a @code{--prepend-format='%(filename):%(beg_line):'} to the register +a @option{--subtotal} option. It does this by adding +@option{--prepend-format='%(filename):%(beg_line):'} to the register report command-line you specify. You should never have to see this, but if there is an error in your ledger output this additional information may not get stripped out of the visible report. @@ -609,9 +611,9 @@ recent transaction at the top. Ledger itself cannot do a sensible ledger report in reverse chronological order, if you sort on reverse date the calculation will also run in the opposite direction. If you want to compare a ledger register report to a bank report with the most -recent transactions at the top, type R in the @file{*Ledger Report*} -buffer and it will reverse the order of the transactions and maintain -the proper mathematical sense. +recent transactions at the top, type @kbd{R} in the @file{*Ledger +Report*} buffer and it will reverse the order of the transactions and +maintain the proper mathematical sense. @node Customizing Ledger-mode, Generating Ledger Regression Tests, The Report Buffer, Top @chapter Customizing Ledger-mode @@ -630,7 +632,7 @@ specified in your Emacs initialization file. The complete list of options is shown below. To change the option using the Emacs customization menu, simply chose customize in the Options menu and look for Ledger under the data options. Alternately you can choose -``Customize Specific Group'' and enter ``Ledger'' as the group. +@samp{Customize Specific Group} and enter @samp{Ledger} as the group. @node Customization Variables, , Ledger-mode Customization, Customizing Ledger-mode @section Customization Variables @@ -649,24 +651,24 @@ for Ledger under the data options. Alternately you can choose @node Ledger Customization Group, Ledger Reconcile Customization Group, Customization Variables, Customization Variables @subsection Ledger Customization Group -@table @code +@table @option @item ledger-occur-use-face-shown -If non-nil, use a custom face for xacts shown in `ledger-occur' mode -using @code{ledger-occur-xact-face}. +If non-nil, use a custom face for xacts shown in @option{ledger-occur} +mode using @option{ledger-occur-xact-face}. @item ledger-clear-whole-transactions If non-nil, clear whole transactions, not individual postings. @item ledger-highlight-xact-under-point If non-nil, highlight xact under point using -@code{ledger-font-highlight-face}. +@option{ledger-font-highlight-face}. @end table @node Ledger Reconcile Customization Group, Ledger Report Customization Group, Ledger Customization Group, Customization Variables @subsection Ledger Reconcile Customization Group -@table @code +@table @option @item ledger-reconcile-default-commodity The default commodity for use in target calculations in ledger -reconcile. Defaults to $ (USD) +reconcile. Defaults to @samp{$} (USD). @item ledger-recon-buffer-name Name to use for reconciliation window. @item ledger-narrow-on-reconcile @@ -679,14 +681,14 @@ window. If non-nil, make the reconcile window appear along the bottom of the register window and resize. @item ledger-reconcile-toggle-to-pending -If non-nil, then toggle between uncleared and pending (@code{!}). If -false toggle between uncleared and cleared (@code{*}) +If non-nil, then toggle between uncleared and pending @samp{!}. If +false toggle between uncleared and cleared @samp{*}. @end table @node Ledger Report Customization Group, Ledger Faces Customization Group, Ledger Reconcile Customization Group, Customization Variables @subsection Ledger Report Customization Group -@table @code +@table @option @item ledger-reports Definition of reports to run. @item ledger-report-format-specifiers @@ -697,17 +699,17 @@ functions. @node Ledger Faces Customization Group, Ledger Post Customization Group, Ledger Report Customization Group, Customization Variables @subsection Ledger Faces Customization Group -Ledger Faces : Ledger-mode highlighting +Ledger Faces: Ledger-mode highlighting -@table @code +@table @option @item ledger-font-uncleared-face Default face for Ledger @item ledger-font-cleared-face -Default face for cleared (*) transactions +Default face for cleared @samp{*} transactions @item ledger-font-highlight-face Default face for transaction under point @item ledger-font-pending-face -Default face for pending (!) transactions +Default face for pending @samp{!} transactions @item ledger-font-other-face Default face for other transactions @item ledger-font-posting-account-face @@ -727,47 +729,47 @@ Face for Ledger comments @item ledger-font-reconciler-uncleared-face Default face for uncleared transactions in the reconcile window @item ledger-font-reconciler-cleared-face -Default face for cleared (*) transactions in the reconcile window +Default face for cleared @samp{*} transactions in the reconcile window @item ledger-font-reconciler-pending-face -Default face for pending (!) transactions in the reconcile window +Default face for pending @samp{!} transactions in the reconcile window @item ledger-font-report-clickable-face -Default face for pending (!) transactions in the reconcile window +FIXME @end table @node Ledger Post Customization Group, Ledger Exec Customization Group, Ledger Faces Customization Group, Customization Variables @subsection Ledger Post Customization Group -Ledger Post : +Ledger Post: -@table @code +@table @option @item ledger-post-auto-adjust-amounts If non-nil, then automatically align amounts to column specified in -@code{ledger-post-amount-alignment-column} +@option{ledger-post-amount-alignment-column} @item ledger-post-amount-alignment-column The column Ledger-mode uses to align amounts @item ledger-default-acct-transaction-indent Default indentation for account transactions in an entry. @item ledger-post-use-completion-engine -Which completion engine to use, iswitchb, ido, or built-in +Which completion engine to use: @var{iswitchb}, @var{ido}, or built-in. @item ledger-post-use-ido @end table @node Ledger Exec Customization Group, Ledger Test Customization Group, Ledger Post Customization Group, Customization Variables @subsection Ledger Exec Customization Group -Ledger Exec : Interface to the Ledger command-line accounting program. +Ledger Exec: Interface to the Ledger command-line accounting program. -@table @code +@table @option @item ledger-binary-path Path to the ledger executable. @item ledger-init-file-name -Location of the ledger initialization file. nil if you don't have one +Location of the ledger initialization file. nil if you don't have one. @end table @node Ledger Test Customization Group, Ledger Texi Customization Group, Ledger Exec Customization Group, Customization Variables @subsection Ledger Test Customization Group -@table @code +@table @option @item ledger-source-directory Directory where the Ledger sources are located. @item ledger-test-binary @@ -777,13 +779,13 @@ Directory where the debug binary. @node Ledger Texi Customization Group, , Ledger Test Customization Group, Customization Variables @subsection Ledger Texi Customization Group -@table @code +@table @option @item ledger-texi-sample-doc-path Location for sample data to be used in texi tests, defaults to -@file{~/ledger/doc/sample.dat} +@file{~/ledger/doc/sample.dat}. @item ledger-texi-normalization-args texi normalization for producing ledger output, defaults to -``@code{--args-only --columns 80}'' +@samp{--args-only --columns 80}. @end table @node Generating Ledger Regression Tests, Embedding Example results in Ledger Documentation, Customizing Ledger-mode, Top -- cgit v1.2.3 From 4ab2aa0574d425d3ac149d9fb52c1966a0b91235 Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 22:23:15 +0200 Subject: Fix typos and alignment (fill-paragraph) --- doc/ledger-mode.texi | 104 ++++++++++++++++++++++++++------------------------- 1 file changed, 53 insertions(+), 51 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 02798003..23467b03 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -107,12 +107,13 @@ The Emacs lisp source for Ledger-mode is included with the source distribution of Ledger. It is entirely included in the @file{lisp} subdirectory. To use Ledger-mode, include the following in your Emacs initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, or -@file{~/.Aquamacs/Preferences.el} +@file{~/.Aquamacs/Preferences.el}). @lisp -(add-to-list 'load-path (expand-file-name "/path/to/ledger/source/lisp/")) +(add-to-list ’load-path + (expand-file-name "/path/to/ledger/source/lisp/")) (load "ldg-new") -(add-to-list 'auto-mode-alist '("\\.ledger$" . ledger-mode)) +(add-to-list ’auto-mode-alist ’("\\.ledger$" . ledger-mode)) @end lisp This sets up Emacs to automatically recognize files that end with @@ -184,8 +185,8 @@ a transaction as pending and display the current cleared (and pending) balance, along with the difference remaining to meet your target. Clear the first three transactions, and you will see the difference to target reach @samp{$0}. End the reconciliation by typing @kbd{C-c C-c}. This -saves the @file{demo.ledger} buffer and marks the transactions and finally -cleared. Type @kbd{q} to close out the reconciliation buffer. +saves the @file{demo.ledger} buffer and marks the transactions and +finally cleared. Type @kbd{q} to close out the reconciliation buffer. @node Reports, Narrowing, Reconciliation, Quick Demo @subsection Reports @@ -255,8 +256,8 @@ which defaults to @samp{52}. @xref{Ledger Post Customization Group}. You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, and type @kbd{C-C C-P}. The minibuffer will ask you to verify the name -of the account you want, if it is already correct hit @kbd{RET}, then the -balance of the account will be displayed in the minibuffer. +of the account you want, if it is already correct hit @kbd{RET}, then +the balance of the account will be displayed in the minibuffer. @node Editing Amounts, Marking Transactions, Adding Transactions, The Ledger Buffer @section Editing Amounts @@ -267,11 +268,11 @@ calculate values for amount by integrating GNU Calc. With the point anywhere in the same line as a posting, typing @kbd{C-c C-b} will bring up the Calc buffer, and push the current amount for the posting onto the top of the Calc stack. Perform any calculations you need to arrive at -the final value, then type @kbd{y} to yank the value at the top of -stack back into the ledger buffer. Note: GNU Calc does not directly -support commas as decimal separators. Ledger-mode will translate values -from decimal-comma format to decimal-period format for use in Calc, but -it cannot intercept the value being yanked form the Calc stack, so +the final value, then type @kbd{y} to yank the value at the top of stack +back into the ledger buffer. Note: GNU Calc does not directly support +commas as decimal separators. Ledger-mode will translate values from +decimal-comma format to decimal-period format for use in Calc, but it +cannot intercept the value being yanked form the Calc stack, so decimal-comma users will have to manually replace the period with a comma. @@ -320,12 +321,12 @@ transaction operation is in the undo buffer. As you operating on the Ledger files, they may become disorganized. For the most part, Ledger doesn't care, but our human brains prefer a bit of order. Sorting the transactions in a buffer into chronological order -can help bring order to chaos. Ledger sort @kbd{C-c C-s} will sort -all of the transactions in a region by date. Ledger-mode isn't -particularly smart about handling dates and it simply sorts the -transactions using the string at the beginning of the transaction. So, -you should use the preferred ISO 8601 standard date format -@samp{YYYY/MM/DD} which easily sorts. +can help bring order to chaos. Ledger sort @kbd{C-c C-s} will sort all +of the transactions in a region by date. Ledger-mode isn't particularly +smart about handling dates and it simply sorts the transactions using +the string at the beginning of the transaction. So, you should use the +preferred ISO 8601 standard date format @samp{YYYY/MM/DD} which easily +sorts. Note, there is a menu entry to sort the entire buffer. Special transactions like automated transaction, will be moved in the sorting @@ -366,8 +367,8 @@ The regular expression can match on any part of the transaction. If you want to find all transactions whose amount ends in @samp{.37}, you can do that (I don't know why, but hey, whatever ever floats you aerostat). -Using @kbd{C-c C-f} or the @samp{Hide Xacts} menu entry, enter -a regular expression in the minibuffer. Ledger-mode will hide all other +Using @kbd{C-c C-f} or the @samp{Hide Xacts} menu entry, enter a regular +expression in the minibuffer. Ledger-mode will hide all other transactions. For details of the regular expression syntax, see @ref{(emacs)Regexps, Syntax of Regular Expressions} or @ref{(elisp)Regular Expressions, Regular Expressions}. A few examples @@ -380,12 +381,12 @@ account. @item ^2011/01 Show only transactions occurring in January of 2011. @item ^2011/.*/25 -Show only transactions occurring on the 25th of the month in 2011 +Show only transactions occurring on the 25th of the month in 2011. @item auto -Show only transactions with payees or accounts or comments containing +Show only transactions with payees or accounts or comments containing. @samp{auto} @item harley$ -Show only transactions with any line ending with @samp{harley} +Show only transactions with any line ending with @samp{harley}. @end table To show back all transactions simply invoke @samp{Hide Xacts} or @@ -412,8 +413,8 @@ Even in this relatively modern era, financial transactions do not happen instantaneously, unless you are paying cash. When you swipe your debit card the money may take several days to actually come out of your account, or a check may take several days to @emph{clear}. That is the -root of the difference between @dfn{obligating} funds and -@dfn{expending} funds. Obligation says you have agreed to pay it, the +root of the difference between @emph{obligating} funds and +@emph{expending} funds. Obligation says you have agreed to pay it, the expenditure doesn't happen until the money actually leaves your account. Or in the case of receiving payment, you have an account receivable until the money has actually made it to you. @@ -455,9 +456,9 @@ The @file{*Reconcile*} buffer will show all the uncleared transactions that meet the criteria set in the regex. By default uncleared transactions are shown in red. When you have verified that a transaction has been correctly and completely recorded by the opposing -party, mark the transaction as pending using the @kbd{SPC} bar. Continue -this process until you agree with the opposing party and the difference -from your target is zero. +party, mark the transaction as pending using the @kbd{SPC} bar. +Continue this process until you agree with the opposing party and the +difference from your target is zero. @node Edit Transactions During Reconciliation, Finalize Reconciliation, Mark Transactions Pending, The Reconcile Buffer @section Edit Transactions during Reconciliation @@ -480,8 +481,8 @@ marks all pending transaction as cleared and saves the ledger buffer. @section Adding and Deleting Transactions during Reconciliation While reconciling, you may find new transactions that need to be entered -into your ledger. Simply type @kbd{a} to bring up the quick add for -the ledger buffer. +into your ledger. Simply type @kbd{a} to bring up the quick add for the +ledger buffer. Typing @kbd{d} will delete the transaction under point in the @file{*Reconcile*} buffer from the ledger buffer. @@ -548,10 +549,11 @@ time. There are two ways to edit the command line for a report. The first is to provide a prefix argument to the run-report command. For example, type @kbd{M-1 C-c C-o C-r}. This will prompt you for the report name, -then present the report command line to be edited. When you hit @kbd{RET}, -the report will be run, but it will not be permanently saved. If you -want to save it, type @kbd{S} in the @file{*Ledger Report*} buffer you -will have the option to give it a new name, or overwrite the old report. +then present the report command line to be edited. When you hit +@kbd{RET}, the report will be run, but it will not be permanently saved. +If you want to save it, type @kbd{S} in the @file{*Ledger Report*} +buffer you will have the option to give it a new name, or overwrite the +old report. Deleting reports is accomplished by typing @kbd{C-c C-o C-e} Edit Reports in the ledger buffer, or typing @kbd{e} in the @file{*Ledger @@ -703,35 +705,35 @@ Ledger Faces: Ledger-mode highlighting @table @option @item ledger-font-uncleared-face -Default face for Ledger +Default face for Ledger. @item ledger-font-cleared-face -Default face for cleared @samp{*} transactions +Default face for cleared @samp{*} transactions. @item ledger-font-highlight-face -Default face for transaction under point +Default face for transaction under point. @item ledger-font-pending-face -Default face for pending @samp{!} transactions +Default face for pending @samp{!} transactions. @item ledger-font-other-face -Default face for other transactions +Default face for other transactions. @item ledger-font-posting-account-face -Face for Ledger accounts +Face for Ledger accounts. @item ledger-font-posting-account-cleared-face -Face for cleared Ledger accounts +Face for cleared Ledger accounts. @item ledger-font-posting-account-pending-face -Face for Ledger pending accounts +Face for Ledger pending accounts. @item ledger-font-posting-amount-face -Face for Ledger amounts +Face for Ledger amounts. @item ledger-occur-narrowed-face -Default face for Ledger occur mode hidden transactions +Default face for Ledger occur mode hidden transactions. @item ledger-occur-xact-face -Default face for Ledger occur mode shown transactions +Default face for Ledger occur mode shown transactions. @item ledger-font-comment-face -Face for Ledger comments +Face for Ledger comments. @item ledger-font-reconciler-uncleared-face -Default face for uncleared transactions in the reconcile window +Default face for uncleared transactions in the reconcile window. @item ledger-font-reconciler-cleared-face -Default face for cleared @samp{*} transactions in the reconcile window +Default face for cleared @samp{*} transactions in the reconcile window. @item ledger-font-reconciler-pending-face -Default face for pending @samp{!} transactions in the reconcile window +Default face for pending @samp{!} transactions in the reconcile window. @item ledger-font-report-clickable-face FIXME @end table @@ -744,9 +746,9 @@ Ledger Post: @table @option @item ledger-post-auto-adjust-amounts If non-nil, then automatically align amounts to column specified in -@option{ledger-post-amount-alignment-column} +@option{ledger-post-amount-alignment-column}. @item ledger-post-amount-alignment-column -The column Ledger-mode uses to align amounts +The column Ledger-mode uses to align amounts. @item ledger-default-acct-transaction-indent Default indentation for account transactions in an entry. @item ledger-post-use-completion-engine -- cgit v1.2.3 From 6e83db2ab174eb0e3dc0189f42ea061aa9515ba1 Mon Sep 17 00:00:00 2001 From: thdox Date: Tue, 30 Apr 2013 22:27:17 +0200 Subject: Fix "Overfull \hbox" error appearing when generating pdf through pdfTeX --- doc/ledger-mode.texi | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 23467b03..4ee4524a 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -588,7 +588,8 @@ transactions from a user-determined account with a particular meta-data tag value, you specify the following command line: @example -ledger -f %(ledger-file) reg %(account) --limit \"tag('my-tag') =~/%(value)/\" +ledger -f %(ledger-file) reg %(account) \ + --limit \"tag('my-tag') =~/%(value)/\" @end example Note how the double-quotes are escaped with back-slashes. -- cgit v1.2.3 From eab7b577804923ff5d62aa37b08d9b22e9ccbcc9 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 00:05:31 +0200 Subject: Added Command & Variable Index Added Keystroke Index --- doc/ledger-mode.texi | 95 ++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 69 insertions(+), 26 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 4ee4524a..1f6ac9be 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -83,7 +83,8 @@ reports and much more... * Embedding Example results in Ledger Documentation:: * Hacking Ledger-mode:: * Concept Index:: -* Command Index:: +* Command & Variable Index:: +* Keystroke Index:: @end menu @node Copying, Introduction to Ledger-mode, Top, Top @@ -111,7 +112,7 @@ initialization file (@file{~/.emacs}, @file{~/.emacs.d/init.el}, or @lisp (add-to-list ’load-path - (expand-file-name "/path/to/ledger/source/lisp/")) + (expand-file-name "/path/to/ledger/source/lisp/")) (load "ldg-new") (add-to-list ’auto-mode-alist ’("\\.ledger$" . ledger-mode)) @end lisp @@ -144,6 +145,8 @@ Ledger from a convenient command line. @node Quick Add, Reconciliation, Quick Demo, Quick Demo @subsection Quick Add +@kindex C-c TAB +@kindex C-c C-a As simple as the Ledger transaction format is, it can still be daunting to add many transactions manually. Ledger provides two way to add @@ -163,6 +166,10 @@ in the proper chronological place in the ledger. @node Reconciliation, Reports, Quick Add, Quick Demo @subsection Reconciliation +@kindex C-c C-r +@kindex SPC +@kindex C-c C-c +@kindex q The biggest task of maintaining a ledger is ensuring that it matches the outside world. This process is called reconciliation (@pxref{Basics of @@ -190,6 +197,8 @@ finally cleared. Type @kbd{q} to close out the reconciliation buffer. @node Reports, Narrowing, Reconciliation, Quick Demo @subsection Reports +@kindex C-c C-o C-r +@kindex C-c C-c The real power of Ledger is in it reporting capabilities. Reports can be run and displayed in a separate Emacs buffer. In the @@ -210,6 +219,7 @@ will be shown. @node Narrowing, , Reports, Quick Demo @subsection Narrowing +@kindex C-c C-f A ledger file can get very large. It can be helpful to collapse the buffer to display only the transactions you are interested in. @@ -232,6 +242,9 @@ amount. @node Adding Transactions, Editing Amounts, The Ledger Buffer, The Ledger Buffer @section Adding Transactions +@findex ledger-post-auto-adjust-amounts +@findex ledger-post-amount-alignment-column +@kindex TAB Beyond the two ways of quickly adding transactions (@pxref{Quick Add}) Ledger-mode assists you by providing robust @kbd{TAB} completion for @@ -252,15 +265,18 @@ which defaults to @samp{52}. @xref{Ledger Post Customization Group}. @node Quick Balance Display, , Adding Transactions, Adding Transactions @subsection Quick Balance Display +@kindex C-c C-p You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, -and type @kbd{C-C C-P}. The minibuffer will ask you to verify the name +and type @kbd{C-c C-p}. The minibuffer will ask you to verify the name of the account you want, if it is already correct hit @kbd{RET}, then the balance of the account will be displayed in the minibuffer. @node Editing Amounts, Marking Transactions, Adding Transactions, The Ledger Buffer @section Editing Amounts +@kindex C-c C-b +@kindex y GNU Calc is a very powerful Reverse Polish Notation calculator built into all recent version of Emacs. Ledger-mode makes it easy to @@ -302,6 +318,9 @@ The transaction has been completely recognized by all parties to the transaction. @end itemize +@kindex C-c C-e +@kindex C-c C-c + Clearing complete transactions is done by typing @kbd{C-c C-e} with point in a transaction. This places an asterisk @samp{*} after the date. Clearing individual postings is done by typing @kbd{C-c C-c} @@ -309,6 +328,7 @@ while in a posting. This places an asterisk prior to the posting. @node Deleting Transactions, Sorting Transactions, Marking Transactions, The Ledger Buffer @section Deleting Transactions +@kindex C-c C-d Along with normal buffer editing methods to delete text, Ledger-mode provides an easy way to delete the transaction under point: @kbd{C-c @@ -317,6 +337,7 @@ transaction operation is in the undo buffer. @node Sorting Transactions, Narrowing Transactions, Deleting Transactions, The Ledger Buffer @section Sorting Transactions +@kindex C-c C-s As you operating on the Ledger files, they may become disorganized. For the most part, Ledger doesn't care, but our human brains prefer a bit of @@ -354,6 +375,7 @@ at point. @node Narrowing Transactions, , Sorting Transactions, The Ledger Buffer @section Narrowing Transactions +@kindex C-c C-f Often you will want to run Ledger register reports just to look at a specific set of transactions. If you don't need the running total @@ -425,6 +447,8 @@ parties agree. @node Starting a Reconciliation, Mark Transactions Pending, Basics of Reconciliation, The Reconcile Buffer @section Starting a Reconciliation +@findex ledger-reconcile-default-commodity +@kindex C-c C-r To start reconciling an account you must have a target, both the transactions that you know about and the transactions the bank knows @@ -451,6 +475,7 @@ not display the complete list of commodities. @node Mark Transactions Pending, Edit Transactions During Reconciliation, Starting a Reconciliation, The Reconcile Buffer @section Mark Transactions Pending +@kindex SPC The @file{*Reconcile*} buffer will show all the uncleared transactions that meet the criteria set in the regex. By default uncleared @@ -462,6 +487,8 @@ difference from your target is zero. @node Edit Transactions During Reconciliation, Finalize Reconciliation, Mark Transactions Pending, The Reconcile Buffer @section Edit Transactions during Reconciliation +@kindex RET +@kindex C-c C-c If you find errors during reconciliation. You can visit the transaction under point in the @file{*Reconcile*} buffer by hitting the @kbd{RET} @@ -479,6 +506,8 @@ marks all pending transaction as cleared and saves the ledger buffer. @node Adding and Deleting Transactions during Reconciliation, Changing Reconciliation Account, Finalize Reconciliation, The Reconcile Buffer @section Adding and Deleting Transactions during Reconciliation +@kindex a +@kindex d While reconciling, you may find new transactions that need to be entered into your ledger. Simply type @kbd{a} to bring up the quick add for the @@ -489,6 +518,7 @@ Typing @kbd{d} will delete the transaction under point in the @node Changing Reconciliation Account, Changing Reconciliation Target, Adding and Deleting Transactions during Reconciliation, The Reconcile Buffer @section Changing Reconciliation Account +@kindex g You can conveniently switch the account being reconciled by typing @kbd{g}, and entering a new account to reconcile. This simply restarts @@ -497,6 +527,7 @@ the ledger buffer are left in that state when the account is switched. @node Changing Reconciliation Target, , Changing Reconciliation Account, The Reconcile Buffer @section Changing Reconciliation Target +@kindex t If for some reason during reconciliation your target amount changes, type @kbd{t} and enter the new target value. @@ -512,6 +543,7 @@ type @kbd{t} and enter the new target value. @node Running Basic Reports, Adding and Editing Reports, The Report Buffer, The Report Buffer @section Running Reports +@kindex C-c C-o C-r The real power behind Ledger is in its amazing reporting capability. Ledger-mode provides easy facility to run reports directly from Emacs. @@ -520,7 +552,7 @@ It has four reports built-in and facilities for adding custom reports. Typing @kbd{C-c C-o C-r} or using menu @samp{Ledger Run Report} prompt for the name of a saved report. The built-in reports are: -@table @samp +@table @var @item bal Produce a balance reports of all accounts. @item reg @@ -535,6 +567,11 @@ transactions involving that account. @node Adding and Editing Reports, Reversing Report Order, Running Basic Reports, The Report Buffer @section Adding and Editing Reports +@findex ledger-reports +@kindex M-1 C-c C-o C-r +@kindex S +@kindex C-c C-o C-e +@kindex e @menu * Expansion Formats:: @@ -567,11 +604,11 @@ report you want removed. It is sometimes convenient to leave room to customize a report without saving the command line every time. For example running a register report for a specific account, enter at runtime by the user. The -built-in report @samp{account} does exactly that, using a variable +built-in report @var{account} does exactly that, using a variable expansion to prompt the user for the account to use. There are four -variable that can be expanded to run a report: +variables that can be expanded to run a report: -@table @option +@table @var @item ledger-file Returns the file to be operated on. @item payee @@ -608,6 +645,7 @@ may not get stripped out of the visible report. @node Reversing Report Order, , Adding and Editing Reports, The Report Buffer @section Reversing Report Order +@kindex R Often, banks show their online transaction histories with the most recent transaction at the top. Ledger itself cannot do a sensible @@ -654,7 +692,7 @@ for Ledger under the data options. Alternately you can choose @node Ledger Customization Group, Ledger Reconcile Customization Group, Customization Variables, Customization Variables @subsection Ledger Customization Group -@table @option +@ftable @option @item ledger-occur-use-face-shown If non-nil, use a custom face for xacts shown in @option{ledger-occur} mode using @option{ledger-occur-xact-face}. @@ -663,12 +701,12 @@ If non-nil, clear whole transactions, not individual postings. @item ledger-highlight-xact-under-point If non-nil, highlight xact under point using @option{ledger-font-highlight-face}. -@end table +@end ftable @node Ledger Reconcile Customization Group, Ledger Report Customization Group, Ledger Customization Group, Customization Variables @subsection Ledger Reconcile Customization Group -@table @option +@ftable @option @item ledger-reconcile-default-commodity The default commodity for use in target calculations in ledger reconcile. Defaults to @samp{$} (USD). @@ -686,25 +724,25 @@ register window and resize. @item ledger-reconcile-toggle-to-pending If non-nil, then toggle between uncleared and pending @samp{!}. If false toggle between uncleared and cleared @samp{*}. -@end table +@end ftable @node Ledger Report Customization Group, Ledger Faces Customization Group, Ledger Reconcile Customization Group, Customization Variables @subsection Ledger Report Customization Group -@table @option +@ftable @option @item ledger-reports Definition of reports to run. @item ledger-report-format-specifiers An alist mapping ledger report format specifiers to implementing functions. -@end table +@end ftable @node Ledger Faces Customization Group, Ledger Post Customization Group, Ledger Report Customization Group, Customization Variables @subsection Ledger Faces Customization Group Ledger Faces: Ledger-mode highlighting -@table @option +@ftable @option @item ledger-font-uncleared-face Default face for Ledger. @item ledger-font-cleared-face @@ -737,14 +775,14 @@ Default face for cleared @samp{*} transactions in the reconcile window. Default face for pending @samp{!} transactions in the reconcile window. @item ledger-font-report-clickable-face FIXME -@end table +@end ftable @node Ledger Post Customization Group, Ledger Exec Customization Group, Ledger Faces Customization Group, Customization Variables @subsection Ledger Post Customization Group Ledger Post: -@table @option +@ftable @option @item ledger-post-auto-adjust-amounts If non-nil, then automatically align amounts to column specified in @option{ledger-post-amount-alignment-column}. @@ -755,41 +793,41 @@ Default indentation for account transactions in an entry. @item ledger-post-use-completion-engine Which completion engine to use: @var{iswitchb}, @var{ido}, or built-in. @item ledger-post-use-ido -@end table +@end ftable @node Ledger Exec Customization Group, Ledger Test Customization Group, Ledger Post Customization Group, Customization Variables @subsection Ledger Exec Customization Group Ledger Exec: Interface to the Ledger command-line accounting program. -@table @option +@ftable @option @item ledger-binary-path Path to the ledger executable. @item ledger-init-file-name Location of the ledger initialization file. nil if you don't have one. -@end table +@end ftable @node Ledger Test Customization Group, Ledger Texi Customization Group, Ledger Exec Customization Group, Customization Variables @subsection Ledger Test Customization Group -@table @option +@ftable @option @item ledger-source-directory Directory where the Ledger sources are located. @item ledger-test-binary Directory where the debug binary. -@end table +@end ftable @node Ledger Texi Customization Group, , Ledger Test Customization Group, Customization Variables @subsection Ledger Texi Customization Group -@table @option +@ftable @option @item ledger-texi-sample-doc-path Location for sample data to be used in texi tests, defaults to @file{~/ledger/doc/sample.dat}. @item ledger-texi-normalization-args texi normalization for producing ledger output, defaults to @samp{--args-only --columns 80}. -@end table +@end ftable @node Generating Ledger Regression Tests, Embedding Example results in Ledger Documentation, Customizing Ledger-mode, Top @chapter Generating Ledger Regression Tests @@ -806,14 +844,19 @@ Work in Progress. Work in Progress. -@node Concept Index, Command Index, Hacking Ledger-mode, Top +@node Concept Index, Command & Variable Index, Hacking Ledger-mode, Top @unnumbered Concept Index @printindex cp -@node Command Index, , Concept Index, Top -@unnumbered Command Index +@node Command & Variable Index, Keystroke Index, Concept Index, Top +@unnumbered Command & Variable Index @printindex fn +@node Keystroke Index, , Command & Variable Index, Top +@unnumbered Keystroke Index + +@printindex ky + @bye -- cgit v1.2.3 From 07e852c7d08d629df03e18841bf4395b929813e7 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 00:25:00 +0200 Subject: Adding concepts (@cindex) to fill Concept Index --- doc/ledger-mode.texi | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 1f6ac9be..3e0cd4fa 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -103,6 +103,7 @@ reports and much more... @node Quick Installation, Menus, Introduction to Ledger-mode, Introduction to Ledger-mode @section Quick Installation +@cindex installation The Emacs lisp source for Ledger-mode is included with the source distribution of Ledger. It is entirely included in the @file{lisp} @@ -123,6 +124,7 @@ as long as the ledger command line utility is properly installed. @node Menus, Quick Demo, Quick Installation, Introduction to Ledger-mode @section Menus +@cindex menu The vast majority of Ledger-mode functionality is available from the Emacs menu system. The keystrokes are shown in the menu to help you @@ -130,6 +132,7 @@ learn the faster keyboard methods. @node Quick Demo, , Menus, Introduction to Ledger-mode @section Quick Demo +@cindex demo Load the demo file @file{demo.ledger} from the Ledger source @file{test/input} directory. The ledger will be loaded and font @@ -245,6 +248,7 @@ amount. @findex ledger-post-auto-adjust-amounts @findex ledger-post-amount-alignment-column @kindex TAB +@cindex transaction, adding Beyond the two ways of quickly adding transactions (@pxref{Quick Add}) Ledger-mode assists you by providing robust @kbd{TAB} completion for @@ -266,6 +270,7 @@ which defaults to @samp{52}. @xref{Ledger Post Customization Group}. @node Quick Balance Display, , Adding Transactions, Adding Transactions @subsection Quick Balance Display @kindex C-c C-p +@cindex balance You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, @@ -277,6 +282,8 @@ the balance of the account will be displayed in the minibuffer. @section Editing Amounts @kindex C-c C-b @kindex y +@cindex calc +@cindex transaction, editing amounts GNU Calc is a very powerful Reverse Polish Notation calculator built into all recent version of Emacs. Ledger-mode makes it easy to @@ -294,6 +301,10 @@ a comma. @node Marking Transactions, Deleting Transactions, Editing Amounts, The Ledger Buffer @section Marking Transactions +@cindex transaction, marking +@cindex uncleared +@cindex pending +@cindex cleared Ledger considers transaction or posting to be in one of three states: uncleared, cleared, and pending. For calculation Ledger ignores these @@ -329,6 +340,7 @@ while in a posting. This places an asterisk prior to the posting. @node Deleting Transactions, Sorting Transactions, Marking Transactions, The Ledger Buffer @section Deleting Transactions @kindex C-c C-d +@cindex transaction, deleting Along with normal buffer editing methods to delete text, Ledger-mode provides an easy way to delete the transaction under point: @kbd{C-c @@ -338,6 +350,7 @@ transaction operation is in the undo buffer. @node Sorting Transactions, Narrowing Transactions, Deleting Transactions, The Ledger Buffer @section Sorting Transactions @kindex C-c C-s +@cindex transaction, sorting As you operating on the Ledger files, they may become disorganized. For the most part, Ledger doesn't care, but our human brains prefer a bit of @@ -376,6 +389,8 @@ at point. @node Narrowing Transactions, , Sorting Transactions, The Ledger Buffer @section Narrowing Transactions @kindex C-c C-f +@cindex transaction, narrowing +@cindex transaction, display filtering Often you will want to run Ledger register reports just to look at a specific set of transactions. If you don't need the running total @@ -430,6 +445,7 @@ To show back all transactions simply invoke @samp{Hide Xacts} or @node Basics of Reconciliation, Starting a Reconciliation, The Reconcile Buffer, The Reconcile Buffer @section Basics of Reconciliation +@cindex reconciliation, basics Even in this relatively modern era, financial transactions do not happen instantaneously, unless you are paying cash. When you swipe your debit @@ -449,6 +465,7 @@ parties agree. @section Starting a Reconciliation @findex ledger-reconcile-default-commodity @kindex C-c C-r +@cindex reconciliation, starting To start reconciling an account you must have a target, both the transactions that you know about and the transactions the bank knows @@ -476,6 +493,7 @@ not display the complete list of commodities. @node Mark Transactions Pending, Edit Transactions During Reconciliation, Starting a Reconciliation, The Reconcile Buffer @section Mark Transactions Pending @kindex SPC +@cindex reconciliation, transaction marking The @file{*Reconcile*} buffer will show all the uncleared transactions that meet the criteria set in the regex. By default uncleared @@ -489,6 +507,7 @@ difference from your target is zero. @section Edit Transactions during Reconciliation @kindex RET @kindex C-c C-c +@cindex reconciliation, transaction editing If you find errors during reconciliation. You can visit the transaction under point in the @file{*Reconcile*} buffer by hitting the @kbd{RET} @@ -499,6 +518,7 @@ mark the transaction if appropriate. @node Finalize Reconciliation, Adding and Deleting Transactions during Reconciliation, Edit Transactions During Reconciliation, The Reconcile Buffer @section Finalize Reconciliation +@cindex reconciliation, finalizing Once you have marked all transactions as pending and the cleared balance is correct. Finish the reconciliation by typing @kbd{C-c C-c}. This @@ -508,6 +528,7 @@ marks all pending transaction as cleared and saves the ledger buffer. @section Adding and Deleting Transactions during Reconciliation @kindex a @kindex d +@cindex reconciliation, transaction adding and deleting While reconciling, you may find new transactions that need to be entered into your ledger. Simply type @kbd{a} to bring up the quick add for the @@ -519,6 +540,7 @@ Typing @kbd{d} will delete the transaction under point in the @node Changing Reconciliation Account, Changing Reconciliation Target, Adding and Deleting Transactions during Reconciliation, The Reconcile Buffer @section Changing Reconciliation Account @kindex g +@cindex reconciliation, account changing You can conveniently switch the account being reconciled by typing @kbd{g}, and entering a new account to reconcile. This simply restarts @@ -528,6 +550,7 @@ the ledger buffer are left in that state when the account is switched. @node Changing Reconciliation Target, , Changing Reconciliation Account, The Reconcile Buffer @section Changing Reconciliation Target @kindex t +@cindex reconciliation, target changing If for some reason during reconciliation your target amount changes, type @kbd{t} and enter the new target value. @@ -544,6 +567,7 @@ type @kbd{t} and enter the new target value. @node Running Basic Reports, Adding and Editing Reports, The Report Buffer, The Report Buffer @section Running Reports @kindex C-c C-o C-r +@cindex report, running The real power behind Ledger is in its amazing reporting capability. Ledger-mode provides easy facility to run reports directly from Emacs. @@ -572,6 +596,7 @@ transactions involving that account. @kindex S @kindex C-c C-o C-e @kindex e +@cindex report, adding and editing @menu * Expansion Formats:: @@ -600,6 +625,7 @@ report you want removed. @node Expansion Formats, Make Report Transactions Active, Adding and Editing Reports, Adding and Editing Reports @subsection Expansion Formats +@cindex report, custom variable It is sometimes convenient to leave room to customize a report without saving the command line every time. For example running a register @@ -633,6 +659,7 @@ Note how the double-quotes are escaped with back-slashes. @node Make Report Transactions Active, , Expansion Formats, Adding and Editing Reports @subsection Make Report Transactions Active +@cindex report, custom command In a large register report it is convenient to be able to jump to the source transaction. Ledger-mode will automatically include source @@ -646,6 +673,7 @@ may not get stripped out of the visible report. @node Reversing Report Order, , Adding and Editing Reports, The Report Buffer @section Reversing Report Order @kindex R +@cindex report, order reversing Often, banks show their online transaction histories with the most recent transaction at the top. Ledger itself cannot do a sensible @@ -691,6 +719,7 @@ for Ledger under the data options. Alternately you can choose @node Ledger Customization Group, Ledger Reconcile Customization Group, Customization Variables, Customization Variables @subsection Ledger Customization Group +@cindex customization, ledger-mode @ftable @option @item ledger-occur-use-face-shown @@ -705,6 +734,7 @@ If non-nil, highlight xact under point using @node Ledger Reconcile Customization Group, Ledger Report Customization Group, Ledger Customization Group, Customization Variables @subsection Ledger Reconcile Customization Group +@cindex customization, reconcile @ftable @option @item ledger-reconcile-default-commodity @@ -728,6 +758,7 @@ false toggle between uncleared and cleared @samp{*}. @node Ledger Report Customization Group, Ledger Faces Customization Group, Ledger Reconcile Customization Group, Customization Variables @subsection Ledger Report Customization Group +@cindex customization, report @ftable @option @item ledger-reports @@ -739,6 +770,7 @@ functions. @node Ledger Faces Customization Group, Ledger Post Customization Group, Ledger Report Customization Group, Customization Variables @subsection Ledger Faces Customization Group +@cindex customization, faces Ledger Faces: Ledger-mode highlighting @@ -779,6 +811,7 @@ FIXME @node Ledger Post Customization Group, Ledger Exec Customization Group, Ledger Faces Customization Group, Customization Variables @subsection Ledger Post Customization Group +@cindex customization, post Ledger Post: @@ -797,6 +830,7 @@ Which completion engine to use: @var{iswitchb}, @var{ido}, or built-in. @node Ledger Exec Customization Group, Ledger Test Customization Group, Ledger Post Customization Group, Customization Variables @subsection Ledger Exec Customization Group +@cindex customization, executable Ledger Exec: Interface to the Ledger command-line accounting program. @@ -809,6 +843,7 @@ Location of the ledger initialization file. nil if you don't have one. @node Ledger Test Customization Group, Ledger Texi Customization Group, Ledger Exec Customization Group, Customization Variables @subsection Ledger Test Customization Group +@cindex customization, test @ftable @option @item ledger-source-directory @@ -819,6 +854,7 @@ Directory where the debug binary. @node Ledger Texi Customization Group, , Ledger Test Customization Group, Customization Variables @subsection Ledger Texi Customization Group +@cindex customization, texi @ftable @option @item ledger-texi-sample-doc-path -- cgit v1.2.3 From ca4e8d66f9a4b98a417bdc5c2586390f5e90dd99 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 00:29:01 +0200 Subject: Minor fix --- doc/ledger-mode.texi | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 3e0cd4fa..fed395ac 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -617,11 +617,11 @@ If you want to save it, type @kbd{S} in the @file{*Ledger Report*} buffer you will have the option to give it a new name, or overwrite the old report. -Deleting reports is accomplished by typing @kbd{C-c C-o C-e} Edit -Reports in the ledger buffer, or typing @kbd{e} in the @file{*Ledger -Report*} buffer. This takes you to the Emacs customization window for -the @option{ledger-reports} variable. Use the widgets to delete the -report you want removed. +Deleting reports is accomplished by typing @kbd{C-c C-o C-e} or using +@samp{Edit Reports} menu in the ledger buffer, or typing @kbd{e} in the +@file{*Ledger Report*} buffer. This takes you to the Emacs +customization window for the @option{ledger-reports} variable. Use the +widgets to delete the report you want removed. @node Expansion Formats, Make Report Transactions Active, Adding and Editing Reports, Adding and Editing Reports @subsection Expansion Formats -- cgit v1.2.3 From 38277eb6ada7aabe362f2106c8c7f19fcd8fe6c9 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 11:33:15 +0200 Subject: Minor fixes --- doc/ledger-mode.texi | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index fed395ac..8a59b370 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -620,8 +620,8 @@ old report. Deleting reports is accomplished by typing @kbd{C-c C-o C-e} or using @samp{Edit Reports} menu in the ledger buffer, or typing @kbd{e} in the @file{*Ledger Report*} buffer. This takes you to the Emacs -customization window for the @option{ledger-reports} variable. Use the -widgets to delete the report you want removed. +customization window for the Ledger Reports variables. Use the widgets +to delete the report you want removed. @node Expansion Formats, Make Report Transactions Active, Adding and Editing Reports, Adding and Editing Reports @subsection Expansion Formats @@ -642,6 +642,7 @@ Prompts for a payee. @item account Prompt for an account. @item value +@c FIXME : is it 'value' or 'tag' for @item above? Prompt for a tag value. @end table -- cgit v1.2.3 From 0c011b94e5c146e355ba1c1417b09377f9666643 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 12:03:06 +0200 Subject: Fix "copying" section to use best practises like in LaTeX, GDB or Texinfo manuals --- doc/ledger-mode.texi | 48 +++++++++++++++++++++++----------------------- doc/ledger3.texi | 54 +++++++++++++++++++++++++--------------------------- 2 files changed, 50 insertions(+), 52 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 8a59b370..4c5e809d 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -7,24 +7,26 @@ @c a prefix arg). This updates the node pointers, which texinfmt.el @c needs. -@dircategory Major Modes @copying -Copyright (c) 2013, Craig Earls. All rights reserved. +Copyright @copyright{} 2013, Craig Earls. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -- Redistributions of source code must retain the above copyright notice, - this list of conditions and the following disclaimer. - -- Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -- Neither the name of New Artisans LLC nor the names of its contributors - may be used to endorse or promote products derived from this software - without specific prior written permission. +@itemize +@item +Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. +@item +Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. +@item +Neither the name of New Artisans LLC nor the names of its contributors +may be used to endorse or promote products derived from this software +without specific prior written permission. +@end itemize THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED @@ -39,6 +41,11 @@ NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @end copying +@dircategory Major Modes +@direntry +* Ledger Mode: (ledger-mode). Command-Line Accounting +@end direntry + @documentencoding UTF-8 @iftex @@ -49,17 +56,16 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @title Ledger Mode @subtitle Emacs Support For Version 3.0 of Ledger @author Craig Earls +@page +@vskip 0pt plus 1filll +@insertcopying @end titlepage -@direntry -* Ledger Mode: (ledger-mode). Command-Line Accounting -@end direntry - @contents @ifnottex -@node Top, Copying, (dir), (dir) +@node Top, Introduction to Ledger-mode, (dir), (dir) @top Overview Ledger is a command line accounting tool that provides double-entry @@ -73,7 +79,6 @@ reports and much more... @end ifnottex @menu -* Copying:: * Introduction to Ledger-mode:: * The Ledger Buffer:: * The Reconcile Buffer:: @@ -87,12 +92,7 @@ reports and much more... * Keystroke Index:: @end menu -@node Copying, Introduction to Ledger-mode, Top, Top -@chapter Copying - -@insertcopying - -@node Introduction to Ledger-mode, The Ledger Buffer, Copying, Top +@node Introduction to Ledger-mode, The Ledger Buffer, Top, Top @chapter Introduction to Ledger-mode @menu diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 5fedbde5..a71686ce 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -7,24 +7,26 @@ @c a prefix arg). This updates the node pointers, which texinfmt.el @c needs. -@dircategory User Applications @copying -Copyright (c) 2003-2013, John Wiegley. All rights reserved. +Copyright @copyright{} 2003-2013, John Wiegley. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -- Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - -- Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -- Neither the name of New Artisans LLC nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +@itemize +@item +Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. +@item +Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. +@item +Neither the name of New Artisans LLC nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. +@end itemize THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -39,6 +41,11 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @end copying +@dircategory User Applications +@direntry +* Ledger3: (ledger3). Command-Line Accounting +@end direntry + @documentencoding UTF-8 @iftex @@ -49,27 +56,26 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. @title Ledger: Command-Line Accounting @subtitle For Version 3.0 of Ledger @author John Wiegley +@page +@vskip 0pt plus 1filll +@insertcopying @end titlepage -@direntry -* Ledger3: (ledger3). Command-Line Accounting -@end direntry - @contents @ifnottex -@node Top, Copying, (dir), (dir) +@node Top, Introduction to Ledger, (dir), (dir) @top Overview + Ledger is a command line accounting tool that provides double-entry accounting based on a text journal. It provides no bells or whistles, and returns the user to the days before user interfaces were even a twinkling in their father's CRT. -@c @insertcopying + @end ifnottex @menu -* Copying:: * Introduction to Ledger:: * Ledger Tutorial:: * Principles of Accounting:: @@ -91,15 +97,7 @@ twinkling in their father's CRT. * Command Index:: @end menu -@node Copying, Introduction to Ledger, Top, Top -@chapter Copying - -@insertcopying - -This license can also be obtained from the command-line by executing -@code{ledger --license} - -@node Introduction to Ledger, Ledger Tutorial, Copying, Top +@node Introduction to Ledger, Ledger Tutorial, Top, Top @chapter Introduction to Ledger @menu -- cgit v1.2.3 From 2353507e9fed92a1f73bc248882f40d2faccf64e Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 15:24:49 +0200 Subject: Added Copying Transaction section Consistency of Minibuffer spelling Improved Add Transaction section Renamed xact to transaction Renamed old menu entry from "Hide Xacts" to "Narrow to Regex" Calc surrounded with @command --- doc/ledger-mode.texi | 108 +++++++++++++++++++++++++++++---------------------- 1 file changed, 61 insertions(+), 47 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 4c5e809d..66028d51 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -162,10 +162,11 @@ format. Then type the first few characters of another payee in the search for a Payee that has the same beginning and copy the rest of the transaction to you new entry. -Additionally you can use the ledger xact command, by typing @kbd{C-c -C-a} then typing a close match to the payee. Ledger-mode will call -@command{ledger xact} with the data you enter and place the transaction -in the proper chronological place in the ledger. +Additionally you can use the ledger @command{xact} command, by either +typing @kbd{C-c C-a} or using @samp{Add Transaction} menu entry. Then +typing a close match to the payee. Ledger-mode will call @command{ledger +xact} with the data you enter and place the transaction in the proper +chronological place in the ledger. @node Reconciliation, Reports, Quick Add, Quick Demo @subsection Reconciliation @@ -180,7 +181,7 @@ Reconciliation}) and can be quite onerous. Ledger-mode attempts to make it as painless as possible. In the @file{demo.ledger} buffer type @kbd{C-c C-r}. Emacs will prompt -for an account to reconcile in the mini-buffer. Enter @samp{Checking}. +for an account to reconcile in the Minibuffer. Enter @samp{Checking}. Emacs will then prompt for a target value. The target value is the amount you want the cleared transactions in the buffer to total. Normally this would be the ending value from your bank statement, or the @@ -205,11 +206,11 @@ finally cleared. Type @kbd{q} to close out the reconciliation buffer. The real power of Ledger is in it reporting capabilities. Reports can be run and displayed in a separate Emacs buffer. In the -@file{demo.ledger} buffer, type @kbd{C-c C-o C-r}. In the mini-buffer +@file{demo.ledger} buffer, type @kbd{C-c C-o C-r}. In the Minibuffer Emacs will prompt for a report name. There are a few built-in reports, and you can add any report you need @xref{Adding and Editing Reports}. -In the mini-buffer type @samp{account}. When prompted for an account +In the Minibuffer type @samp{account}. When prompted for an account type @samp{checking}. In another buffer you will see a Ledger register report. You can move around the buffer, with the point on a transaction, type @kbd{C-c C-c}. Ledger-mode will take you directly to that @@ -227,7 +228,7 @@ will be shown. A ledger file can get very large. It can be helpful to collapse the buffer to display only the transactions you are interested in. Ledger-mode copies the @command{occur} mode functionality. Typing -@kbd{C-c C-f} and entering any regex in the mini-buffer will show only +@kbd{C-c C-f} and entering any regex in the Minibuffer will show only transactions that match the regex. The regex can be on any field, or amount. @@ -236,6 +237,7 @@ amount. @menu * Adding Transactions:: +* Copying Transactions:: * Editing Amounts:: * Marking Transactions:: * Deleting Transactions:: @@ -243,7 +245,7 @@ amount. * Narrowing Transactions:: @end menu -@node Adding Transactions, Editing Amounts, The Ledger Buffer, The Ledger Buffer +@node Adding Transactions, Copying Transactions, The Ledger Buffer, The Ledger Buffer @section Adding Transactions @findex ledger-post-auto-adjust-amounts @findex ledger-post-amount-alignment-column @@ -274,30 +276,42 @@ which defaults to @samp{52}. @xref{Ledger Post Customization Group}. You will often want to quickly check the balance of an account. The easiest way it to position point on the account you are interested in, -and type @kbd{C-c C-p}. The minibuffer will ask you to verify the name +and type @kbd{C-c C-p}. The Minibuffer will ask you to verify the name of the account you want, if it is already correct hit @kbd{RET}, then -the balance of the account will be displayed in the minibuffer. +the balance of the account will be displayed in the Minibuffer. -@node Editing Amounts, Marking Transactions, Adding Transactions, The Ledger Buffer +@node Copying Transactions, Editing Amounts, Adding Transactions, The Ledger Buffer +@section Copying Transactions +@kindex C-c C-k +@cindex transaction, copying + +An easy way to copy a transaction is to type @kbd{C-c C-k} or menu entry +@samp{Copy Trans at Point}. You will be prompted the new date for the +copied transaction, and after having confirmed with @kbd{RET}, new +transaction will be inserted at @emph{date} position in buffer. + +@node Editing Amounts, Marking Transactions, Copying Transactions, The Ledger Buffer @section Editing Amounts @kindex C-c C-b @kindex y -@cindex calc +@cindex Calc +@cindex GNU Emacs Calculator @cindex transaction, editing amounts -GNU Calc is a very powerful Reverse Polish Notation calculator built -into all recent version of Emacs. Ledger-mode makes it easy to -calculate values for amount by integrating GNU Calc. With the point -anywhere in the same line as a posting, typing @kbd{C-c C-b} will bring -up the Calc buffer, and push the current amount for the posting onto the -top of the Calc stack. Perform any calculations you need to arrive at -the final value, then type @kbd{y} to yank the value at the top of stack -back into the ledger buffer. Note: GNU Calc does not directly support -commas as decimal separators. Ledger-mode will translate values from -decimal-comma format to decimal-period format for use in Calc, but it -cannot intercept the value being yanked form the Calc stack, so -decimal-comma users will have to manually replace the period with -a comma. +GNU Emacs Calculator, aka @samp{Calc}, is a very powerful Reverse Polish +Notation calculator built into all recent version of Emacs. Ledger-mode +makes it easy to calculate values for amount by integrating +@command{Calc}. With the point anywhere in the same line as a posting, +typing @kbd{C-c C-b} will bring up the @file{Calc} buffer, and push the +current amount for the posting onto the top of the @command{Calc} stack. +Perform any calculations you need to arrive at the final value, then +type @kbd{y} to yank the value at the top of stack back into the ledger +buffer. Note: @command{Calc} does not directly support commas as +decimal separators. Ledger-mode will translate values from +decimal-comma format to decimal-period format for use in @command{Calc}, +but it cannot intercept the value being yanked form the @command{Calc} +stack, so decimal-comma users will have to manually replace the period +with a comma. @node Marking Transactions, Deleting Transactions, Editing Amounts, The Ledger Buffer @section Marking Transactions @@ -375,7 +389,7 @@ markup within your ledger. For example: ; Ledger-mode: Start sort -<<< xacts to sort >>> +<<< transactions to sort >>> ; Ledger-mode: End sort @@ -404,8 +418,8 @@ The regular expression can match on any part of the transaction. If you want to find all transactions whose amount ends in @samp{.37}, you can do that (I don't know why, but hey, whatever ever floats you aerostat). -Using @kbd{C-c C-f} or the @samp{Hide Xacts} menu entry, enter a regular -expression in the minibuffer. Ledger-mode will hide all other +Using @kbd{C-c C-f} or the @samp{Narrow to Regex} menu entry, enter +a regular expression in the Minibuffer. Ledger-mode will hide all other transactions. For details of the regular expression syntax, see @ref{(emacs)Regexps, Syntax of Regular Expressions} or @ref{(elisp)Regular Expressions, Regular Expressions}. A few examples @@ -426,7 +440,7 @@ Show only transactions with payees or accounts or comments containing. Show only transactions with any line ending with @samp{harley}. @end table -To show back all transactions simply invoke @samp{Hide Xacts} or +To show back all transactions simply invoke @samp{Narrow to Regex} or @kbd{C-c C-f} again. @node The Reconcile Buffer, The Report Buffer, The Ledger Buffer, Top @@ -470,20 +484,20 @@ parties agree. To start reconciling an account you must have a target, both the transactions that you know about and the transactions the bank knows about. You can get this from a monthly statement, or from checking your -online transaction history. It also helps immensely to know the final +on-line transaction history. It also helps immensely to know the final cleared balance you are aiming for. Use menu @samp{Reconcile Account} or @kbd{C-c C-r} and enter the account -you wish to reconcile in the mini-buffer. Ledger-mode is not particular +you wish to reconcile in the Minibuffer. Ledger-mode is not particular about what you enter for the account. You can leave it blank and -Reconcile Mode will show you @emph{all} uncleared transactions. After -you enter the account enter the target amount. Ledger expects you to -enter an amount with a commodity. It assumes initially that you are -using @samp{$} (USD) as your default commodity. If you are working in -a different currency you can change the default in variable -@option{ledger-reconcile-default-commodity} to whatever you need. If -you work in multiple commodities simply enter the commoditized amount -(for example @samp{340 VSDX}, for 340 shares of VSDX). +@file{*Reconcile*} buffer will show you @emph{all} uncleared +transactions. After you enter the account enter the target amount. +Ledger expects you to enter an amount with a commodity. It assumes +initially that you are using @samp{$} (USD) as your default commodity. +If you are working in a different currency you can change the default in +variable @option{ledger-reconcile-default-commodity} to whatever you +need. If you work in multiple commodities simply enter the commoditized +amount (for example @samp{340 VSDX}, for 340 shares of VSDX). Ledger-mode reconcile cannot currently reconcile accounts that have multiple commodities, such as brokerage accounts. You may use @@ -676,7 +690,7 @@ may not get stripped out of the visible report. @kindex R @cindex report, order reversing -Often, banks show their online transaction histories with the most +Often, banks show their on-line transaction histories with the most recent transaction at the top. Ledger itself cannot do a sensible ledger report in reverse chronological order, if you sort on reverse date the calculation will also run in the opposite direction. If you @@ -724,12 +738,12 @@ for Ledger under the data options. Alternately you can choose @ftable @option @item ledger-occur-use-face-shown -If non-nil, use a custom face for xacts shown in @option{ledger-occur} -mode using @option{ledger-occur-xact-face}. +If non-nil, use a custom face for transactions shown in +@option{ledger-occur} mode using @option{ledger-occur-xact-face}. @item ledger-clear-whole-transactions If non-nil, clear whole transactions, not individual postings. @item ledger-highlight-xact-under-point -If non-nil, highlight xact under point using +If non-nil, highlight transaction under point using @option{ledger-font-highlight-face}. @end ftable @@ -742,13 +756,13 @@ If non-nil, highlight xact under point using The default commodity for use in target calculations in ledger reconcile. Defaults to @samp{$} (USD). @item ledger-recon-buffer-name -Name to use for reconciliation window. +Name to use for reconciliation buffer. Defaults to @file{*Reconcile*}. @item ledger-narrow-on-reconcile If non-nil, limit transactions shown in main buffer to those matching the reconcile regex. @item ledger-buffer-tracks-reconcile-buffer -If non-nil, then when the cursor is moved to a new xact in the recon -window. +If non-nil, then when the cursor is moved to a new transaction in the +reconcile window. @item ledger-reconcile-force-window-bottom If non-nil, make the reconcile window appear along the bottom of the register window and resize. -- cgit v1.2.3 From ae69ae5c643e9cb020018bbbd41e9ca85e292922 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 15:25:32 +0200 Subject: Consistency on regex spelling --- doc/ledger3.texi | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index a71686ce..5e5cd5ff 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -1936,7 +1936,7 @@ the alias to be used in place of the full account name anywhere that account names are allowed. The @code{payee} sub-directive, which can occur multiple times, -provides regexps that identify the account if that payee is +provides regexes that identify the account if that payee is encountered and an account within its transaction ends in the name "Unknown". Example: @@ -2169,7 +2169,7 @@ payee KFC alias KENTUCKY FRIED CHICKEN @end smallexample -The @code{alias} directive provides a regexp which, if it matches +The @code{alias} directive provides a regex which, if it matches a parsed payee, the declared payee name is substituted: @smallexample @@ -4038,7 +4038,7 @@ part of the balance. @findex balance The @command{balance} command reports the current balance of all -accounts. It accepts a list of optional regexps, which confine the +accounts. It accepts a list of optional regexes, which confine the balance report to the matching accounts. If an account contains multiple types of commodities, each commodity's total is reported separately. @@ -4056,8 +4056,8 @@ balances for an account, such as when @ref{Archiving Previous Years}. @findex register The @command{register} command displays all the postings occurring -in a single account, line by line. The account regexp must be -specified as the only argument to this command. If any regexps occur +in a single account, line by line. The account regex must be +specified as the only argument to this command. If any regexes occur after the required account name, the register will contain only those postings that match. Very useful for hunting down a particular posting. @@ -4080,7 +4080,7 @@ order to plot either the amount or total column, respectively. The @command{print} command prints out ledger transactions in a textual format that can be parsed by Ledger. They will be properly formatted, and output in the most economic form possible. The ``print'' command -also takes a list of optional regexps, which will cause only those +also takes a list of optional regexes, which will cause only those postings which match in some way to be printed. The @command{print} command can be a handy way to clean up a ledger @@ -4197,7 +4197,7 @@ is from the file above. The @code{convert} command accepts three options, the most important ones are @code{--invert} which inverts the amount field, and -@code{--account @var{NAME}} which you can use to specify the account to +@code{--account @var{STR}} which you can use to specify the account to balance against and @code{--rich-data}. When using the rich-data switch additional metadata is stored as tags. There is, for example, a UUID field. If an entry with the same UUID tag is already included @@ -7276,27 +7276,27 @@ A plain integer represents a commodity-less amount. An amount in braces can be any kind of amount supported by ledger, with or without a commodity. Use this for decimal values. -@item /REGEXP/ -@itemx W/REGEXP/ +@item /REGEX/ +@itemx W/REGEX/ A regular expression that matches against an account's full name. If a posting, this will match against the account affected by the posting. -@item //REGEXP/ -@itemx p/REGEXP/ +@item //REGEX/ +@itemx p/REGEX/ A regular expression that matches against a transaction's payee name. -@item ///REGEXP/ -@itemx w/REGEXP/ +@item ///REGEX/ +@itemx w/REGEX/ A regular expression that matches against an account's base name. If a posting, this will match against the account affected by the posting. -@item c/REGEXP/ +@item c/REGEX/ A regular expression that matches against the transaction code (the text that occurs between parentheses before the payee name). -@item e/REGEXP/ +@item e/REGEX/ A regular expression that matches against a posting's note, or comment field. -- cgit v1.2.3 From 81ca614ec6431cbe79bb3b09fc4e5abb8e67fa6b Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 16:00:28 +0200 Subject: Add description for menu items related to Sort --- doc/ledger-mode.texi | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index 66028d51..ab47120d 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -369,17 +369,17 @@ transaction operation is in the undo buffer. As you operating on the Ledger files, they may become disorganized. For the most part, Ledger doesn't care, but our human brains prefer a bit of order. Sorting the transactions in a buffer into chronological order -can help bring order to chaos. Ledger sort @kbd{C-c C-s} will sort all -of the transactions in a region by date. Ledger-mode isn't particularly -smart about handling dates and it simply sorts the transactions using -the string at the beginning of the transaction. So, you should use the -preferred ISO 8601 standard date format @samp{YYYY/MM/DD} which easily -sorts. - -Note, there is a menu entry to sort the entire buffer. Special -transactions like automated transaction, will be moved in the sorting -process and may not function correctly afterwards. For this reason -there is no key sequence. +can help bring order to chaos. Either using @samp{Sort Region} menu +entry or typing @kbd{C-c C-s} will sort all of the transactions in +a region by date. Ledger-mode isn't particularly smart about handling +dates and it simply sorts the transactions using the string at the +beginning of the transaction. So, you should use the preferred ISO 8601 +standard date format @samp{YYYY/MM/DD} which easily sorts. + +Note, there is a menu entry @samp{Sort Buffer} to sort the entire +buffer. Special transactions like automated transaction, will be moved +in the sorting process and may not function correctly afterwards. For +this reason there is no key sequence. You can limit the allowed sort region by using embedded Ledger-mode markup within your ledger. For example: @@ -396,9 +396,9 @@ markup within your ledger. For example: <<< information to not sort >>> @end example -You can use menu entries to insert start and end markers. These -functions will automatically delete old markers and put new new marker -at point. +You can use menu entries @samp{Mark Sort Beginning} to insert start and +@samp{Mark Sort End} to insert end markers. These functions will +automatically delete old markers and put new new marker at point. @node Narrowing Transactions, , Sorting Transactions, The Ledger Buffer @section Narrowing Transactions -- cgit v1.2.3 From d681b1fb83fe30e1bbbf9f6e4d4ebc2fa9860f91 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 16:01:09 +0200 Subject: Add TODO keyword where there are still menu entries to describe --- doc/ledger-mode.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'doc') diff --git a/doc/ledger-mode.texi b/doc/ledger-mode.texi index ab47120d..a5d77b1f 100644 --- a/doc/ledger-mode.texi +++ b/doc/ledger-mode.texi @@ -245,6 +245,13 @@ amount. * Narrowing Transactions:: @end menu +@c TODO +@c Describe also: +@c - Align Region +@c - Set effective date C-c C-t +@c - Set Year C-c C-t +@c - Set Month C-c RET + @node Adding Transactions, Copying Transactions, The Ledger Buffer, The Ledger Buffer @section Adding Transactions @findex ledger-post-auto-adjust-amounts @@ -578,6 +585,12 @@ type @kbd{t} and enter the new target value. * Reversing Report Order:: @end menu +@c TODO Describe also: +@c - Goto Report C-c C-o C-g +@c - Re-run Report C-c C-o C-a +@c - Save Report C-c C-o C-s +@c - Kill Report C-c C-o C-k + @node Running Basic Reports, Adding and Editing Reports, The Report Buffer, The Report Buffer @section Running Reports @kindex C-c C-o C-r -- cgit v1.2.3 From 8171165a6c9f2484f666d729f8dd6f25c247e102 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 16:28:11 +0200 Subject: For consistency, do not put on same @item two options that are different (even if very close in purpose). --- doc/ledger3.texi | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 5e5cd5ff..738205ac 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -6083,15 +6083,14 @@ Use only uncleared transactions in calculations and reports. FIX THIS ENTRY @item --unrealized-gains @var{STR} -@itemx --unrealized-losses @var{STR} -These options allow the user to specify what accounts names should be -used for these two types of accounts. They are optional, and default -to: - ---unrealized-gains "Equity:Unrealized Gains" ---unrealized-losses "Equity:Unrealized Losses" +Allow the user to specify what account name should be used for +unrealized gains. Defaults to @samp{"Equity:Unrealized Gains"}. +Often set in one's @file{~/.ledgerrc} file to change default. -These are intended to be set in one's @file{~/.ledgerrc} file. +@itemx --unrealized-losses @var{STR} +Allow the user to specify what account name should be used for +unrealized gains. Defaults to @samp{"Equity:Unrealized Losses"}. +Often set in one's @file{~/.ledgerrc} file to change default. @item --unround Perform all calculations without rounding and display results to full -- cgit v1.2.3 From 0509bb136a7fc187ac504786b95aace3171244d7 Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 16:29:00 +0200 Subject: Add @var{FORMAT_STRING} where missing --- doc/ledger3.texi | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 738205ac..1b7edb2f 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -6618,7 +6618,7 @@ updating the price-db file. The best way is to have your price download script maintain this file. The format of the file can be changed by telling ledger to use the -@code{--pricedb-format} you define. +@code{--pricedb-format @var{FORMAT_STRING}} you define. @item --price-exp @var{INT} @itemx -L @var{INT} @@ -7386,15 +7386,15 @@ Return value rounded to n digits. Does not affect formatting. @section Format String Basics @findex --format @var{FORMAT_STRING} @findex -F @var{FORMAT_STRING} -@findex --balance-format -@findex --budget-format -@findex --cleared-format -@findex --csv-format -@findex --plot-amount-format -@findex --plot-total-format -@findex --pricedb-format -@findex --prices-format -@findex --register-format +@findex --balance-format @var{FORMAT_STRING} +@findex --budget-format @var{FORMAT_STRING} +@findex --cleared-format @var{FORMAT_STRING} +@findex --csv-format @var{FORMAT_STRING} +@findex --plot-amount-format @var{FORMAT_STRING} +@findex --plot-total-format @var{FORMAT_STRING} +@findex --pricedb-format @var{FORMAT_STRING} +@findex --prices-format @var{FORMAT_STRING} +@findex --register-format @var{FORMAT_STRING} Format strings may be used to change the output format of reports. They are specified by passing a formatting string to the @code{-F @@ -7557,9 +7557,9 @@ same format string is used for all postings. @findex --balance-format @var{FORMAT_STRING} @findex --format @var{FORMAT_STRING} -As an example of how flexible the @code{--format} strings can be, the -default balance format looks like this (the various functions are -described later): +As an example of how flexible the @code{--format @var{FORMAT_STRING}} +strings can be, the default balance format looks like this (the +various functions are described later): @smallexample "%(justify(scrub(display_total), 20, -1, true, color))" -- cgit v1.2.3 From e19693e7e933696ea4cfd51ce0709de3ce7361ce Mon Sep 17 00:00:00 2001 From: thdox Date: Wed, 1 May 2013 18:58:18 +0200 Subject: M-x delete-trailing-whitespace --- doc/ledger3.texi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/ledger3.texi b/doc/ledger3.texi index 1b7edb2f..482be6ba 100644 --- a/doc/ledger3.texi +++ b/doc/ledger3.texi @@ -1519,7 +1519,7 @@ commodity name must be enclosed in double quotes @samp{"}: 1999/06/09 ! Achat Actif:SG PEE STK 49.957 "Arcancia Équilibre 454" Actif:SG PEE STK $-234.90 - + 2000/12/08 ! Achat Actif:SG PEE STK 215.796 "Arcancia Équilibre 455" Actif:SG PEE STK $-10742.54 @@ -4996,7 +4996,7 @@ Generate transactions based on previous postings @subsection Basic Options @ftable @code -@item --help +@item --help @itemx -h Print summary of all options -- cgit v1.2.3