diff options
author | thdox <thdox@free.fr> | 2013-04-30 22:23:15 +0200 |
---|---|---|
committer | thdox <thdox@free.fr> | 2013-04-30 22:23:15 +0200 |
commit | 4ab2aa0574d425d3ac149d9fb52c1966a0b91235 (patch) | |
tree | 77f9f95f49df78b60e5de9c5d5783985d7f3c3b9 /doc | |
parent | f4bca599d749115dd280701710ba87e68aa77676 (diff) | |
download | fork-ledger-4ab2aa0574d425d3ac149d9fb52c1966a0b91235.tar.gz fork-ledger-4ab2aa0574d425d3ac149d9fb52c1966a0b91235.tar.bz2 fork-ledger-4ab2aa0574d425d3ac149d9fb52c1966a0b91235.zip |
Fix typos and alignment (fill-paragraph)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ledger-mode.texi | 104 |
1 files changed, 53 insertions, 51 deletions
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 |