summaryrefslogtreecommitdiff
path: root/doc/ledger3.texi
diff options
context:
space:
mode:
authorJohn Wiegley <johnw@newartisans.com>2014-02-26 16:06:52 -0600
committerJohn Wiegley <johnw@newartisans.com>2014-02-26 16:06:52 -0600
commiteddd03ed096fc97a9b4f252ebbef0dae84410240 (patch)
tree0e8ec4c444700fd996eefead32455ec7086bff08 /doc/ledger3.texi
parentbc08eed3cb1bdb4f67d1b77273f3254d0cf13be2 (diff)
parent75b0a5d8ff22abeac8c4f502154159f998ffbe99 (diff)
downloadfork-ledger-eddd03ed096fc97a9b4f252ebbef0dae84410240.tar.gz
fork-ledger-eddd03ed096fc97a9b4f252ebbef0dae84410240.tar.bz2
fork-ledger-eddd03ed096fc97a9b4f252ebbef0dae84410240.zip
Merge pull request #247 from ecraven/master
Adding support for recursive aliases.
Diffstat (limited to 'doc/ledger3.texi')
-rw-r--r--doc/ledger3.texi21
1 files changed, 20 insertions, 1 deletions
diff --git a/doc/ledger3.texi b/doc/ledger3.texi
index 4ab8f4fd..1a8fd9aa 100644
--- a/doc/ledger3.texi
+++ b/doc/ledger3.texi
@@ -2158,9 +2158,23 @@ alias Checking=Assets:Credit Union:Joint Checking Account
@end smallexample
The aliases are only in effect for transactions read in after the alias
-is defined and are effected by @code{account} directives that precede
+is defined and are affected by @code{account} directives that precede
them.
+With the option @option{--recursive-aliases}, aliases can refer to other aliases,
+the following example produces exactly the same transactions and account names
+as the preceding one:
+
+@smallexample
+alias Entertainment=Expenses:Entertainment
+alias Dining=Entertainment:Dining
+alias Checking=Assets:Credit Union:Joint Checking Account
+
+2011/11/30 ChopChop
+ Dining $10.00
+ Checking
+@end smallexample
+
@item assert
@c instance_t::assert_directive
An assertion can throw an error if a condition is not met during
@@ -5801,6 +5815,11 @@ correct, and if it finds a new account or commodity (same as
a misspelled commodity or account) it will issue a warning giving you
the file and line number of the problem.
+@item --recursive-aliases
+Normally, ledger only expands aliases once. With this option, ledger tries
+to expand the result of alias expansion recursively, until no more expansions
+apply.
+
@item --time-colon
The @option{--time-colon} option will display the value for a seconds
based commodity as real hours and minutes.