sfos/ledger
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

updated NEWS file

Browse source
This commit is contained in:
John Wiegley 2004-08-21 16:38:12 -04:00
parent c1e5119e97
commit 6050099c26
1 changed files with 42 additions and 127 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

169
NEWS
View file

@ -1,67 +1,62 @@
Ledger NEWS Ledger NEWS
* 2.0 * 2.0
- The code base was rewritten for clarity and consistency. It is now - The code base was rewritten for clarity and consistency. It is now
simpler, more robust, and faster. simpler internally, more robust, and much faster.
- The most significant feature addition in this version is the use of - The most significant feature added are "value expressions". They
"value expressions". These are now used in many places to indicate are used in several places to indicate what to display, sorting
what to display, the sorting order, and even the output format. order, output format, etc. Logic and math operators are supported,
as well as a few functions. See the documentation for more info.
A value expression is a simple string that uses one letter codes to
indicate transaction, entry and account details. Logic and math
operators are supported, as well as a few useful functions. See the
README.
- If the environment variable LEDGER (or LEDGER_FILE) is used, a - If the environment variable LEDGER (or LEDGER_FILE) is used, a
binary cache of that ledger will be kept in ~/.ledger (or binary cache of that ledger is now kept in ~/.ledger (or
LEDGER_CACHE), to speed up later queries of the same data. This LEDGER_CACHE), to speed up later queries of the same data. This
happens only when "-f" or "--file" is not used. happens only when "-f" or "--file" is not used.
- New options: - New options:
"-o FILE" outputs data to the given FILE. If "-", the output is the "-o FILE" outputs data to FILE. If "-", output goes to stdout.
same as the default (stdout).
-j and -J options replace previous -G (gnuplot) option. -j reports -j and -J options replace the previous -G (gnuplot) option. -j
the values column in a way gnuplot can consume, and -J reports the reports the values column in a way gnuplot can consume, and -J, the
totals column. An example can be found in scripts/report. totals column. An example is in scripts/report.
"-y DATEFMT" changes the date format used in register reports. The "-y DATEFMT" changes the date format used for register reports. The
default is "%Y/%m/%d". default is "%Y/%m/%d".
-Y and -W print yearly and weekly subtotals, just as the -M option -Y and -W print yearly and weekly subtotals, just as -M prints
printed monthly subtotals in the previous version. monthly subtotals. --dow shows cumulative totals for each day of
-w shows cumulative totals for each of the days of the week. the week.
"-z INTERVAL" allows more flexible interval reporting. The "-z INTERVAL" allows for more flexible interval reporting. The
sublanguage used will probably mature over time, but for now it sublanguage used will likely mature over time, but for now it
supports expression like: supports expression like:
monthly monthly
every week every week
every 3 quarters every 3 quarters
weekly from 12/20 weekly from 12/20
monthly in 2003
-O shows base values (this is the default, and old behavior) -O shows base values (this is the default, and old, behavior)
-B shows basis cost of commodities -B shows basis cost of commodities
-V show market value of commodities -V shows the market value of commodities
-G reports net gain/loss (shows commodity changes only) -G reports net gain/loss
-A reports average value (arithmetic mean) -A reports average value (arithmetic mean)
-D reports deviation from the average value -D reports deviation from the average
-X reports the trend (average rate of change) -X reports the trend (average rate of change)
-Z reports the trend, with older values affecting the trend less -Z reports the trend, with older values affecting the trend less
- Regexps specified after the command name now apply to account names - Regexps given directly after the command name now apply to account
only. To search on a payee, use "--" to separate the two kinds of names only. To search on a payee, use "--" to separate the two
regexps. For example, to find a payee named "John" within all kinds of regexps. For example, to find a payee named "John" within
Expenses accounts, use: all Expenses accounts, use:
ledger register expenses -- john ledger register expenses -- john
FYI: The above command is identical (and internally converted) to: Note: The above command is identical (and internally converted) to:
ledger -l "/expenses/|//john/" register ledger -l "/expenses/|//john/" register
@ -71,25 +66,27 @@
!include FILE !include FILE
@@ @@
All entries specified within the "@ ACCOUNT/@@" range will be added Entries specified within "@ ACCOUNT/@@" will affect only that
under that account. account.
- Register reports now show the account being changed. Use the -r - Register reports now show only the account affected by default. Use
option to see "other accounts" -- or the account the credit/debit "-r" to see "related accounts" -- the account the transfer came from
came from. (This was the old behavior in 1.x, but can lead to or went to. (This was the old behavior in 1.x, but leads to
confusing reports when viewing accounts with subaccounts.) The -r confusing reports when viewing reports within subaccounts.) The
option also works for balance reports, where it will show all the "-r" option also works with balance reports, where it shows all
account totals related to your query. amounts related to your query.
- Automated transactions now use a single value expression as a - Automated transactions now use value expressions as their predicate.
predicate. This means the new syntax is: The new syntax is:
= VALUE-EXPR = VALUE-EXPR
TRANSACTIONS... TRANSACTIONS...
Only one VALUE-EXPR is supported, compared to the multiple account Only one VALUE-EXPR is supported, compared to the multiple account
regexps supported before. By using a VALUE-EXPR as a predicate, regexps supported before. However, since value expression allow for
matching may now be much more comprehensive and selective. logic chaining, there is no loss in functionality. Also, by using a
VALUE-EXPR as a predicate, matching may be much more comprehensive
and selective.
- The use of "+" and "-" in ledger files (to specify permanent - The use of "+" and "-" in ledger files (to specify permanent
regexps) has been removed. regexps) has been removed.
@ -97,90 +94,8 @@
- -l now takes a value expression as the "calculation predicate". - -l now takes a value expression as the "calculation predicate".
To mimic the old behavior of "-l \$100", use: -d "AT<{\$100}" To mimic the old behavior of "-l \$100", use: -d "AT<{\$100}"
- The -S flag takes a value expression string, which yields the value - The -S flag now takes a value expression as the sorting criteria.
that will be sorted on. To sort on the amount, use -S T (balance) or -S t (register).
----------------------------------------------------------------------
- Value expressions are now supported, where the totals reported can
be changed using -t and -T and an expression string composed of:
a amount
B current balance
T amount total (B + a)
c cost
C cost total
v market value(amount, date)
V total market value(amount total, date)
g net gain (v - c)
G total net gain (V - C)
d date (in seconds past the epoch)
i index (within the report)
o item age = date - report begin date
w item newness = report end date - date
b report begin date
e report end date
P(x,y) market price of x at time y (i.e., V = p(A,d))
Mx total arthmetic of x (x/n)
Bx deviation = a - x
Ax absolute (positive) value of x
{x} parse x as a ledger amount
/s/ 1 if full account name matches s
in precedence order:
-?[0-9]*.[0-9]+ numerical constants
binary operators: * /
binary operators: + -
comparison operators: = < <= > >=
logical operators: ! & |
(x) parenthetical grouping
The standard reports are therefore implemented as:
-O == -t a -T A
-B == -t c -T C
-V == -t c -T V
-G == -t g -T G
-A == -t a -T MA
-D == -t a -T DMA
-T == -t a -T MDMA
-W == -t a -T MD(MA*(d-b/e-b))
-X == -t a -T a+MD(MA*(d-b/e-b))
- User-specified format strings are supported with a -F option. The
strings are very much like printf format strings, with the following
syntax for each substitution:
%?-m.MX
Each part of the above except for X is optional, and means:
? field is blank if reporting on a "subsequent line" (within
the register report, when viewing splits)
- left justify field (default is right)
m minimum width of the field
. indicates that a maximum width is being specified
M maximum width of the field; values are truncated to fit
And where X may be any one of:
% self-insert
d same as %[%Y/%m/%d]
[datefmt] pass 'datefmt' to strftime for the entry
p the payee
a the custom account name (report dependent)
n the real account name (balance report only)
N full account name (balance report only)
t whatever the specified value expression is
T whatever the specified total expression is
(expr) insert an arbitrary style expression
The default format for the register and balance reports are:
%?10d %?-.20p %-.22a %12.66t %12.80T
%20T %-a
* 1.7 * 1.7