summaryrefslogtreecommitdiff
path: root/doc/Ledger.scriv/158.rtfd/TXT.rtf
blob: 8abfef5e2e0a25554ee1949f8be50baad47f1d6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
{\rtf1\ansi\ansicpg1252\cocoartf949\cocoasubrtf460
{\fonttbl\f0\fmodern\fcharset0 Courier;}
{\colortbl;\red255\green255\blue255;}
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\sl264\slmult1\ql\qnatural\pardirnatural

\f0\fs28 \cf0 While the @command\{balance\} command can be very handy for checking\
account totals, by far the most powerful of Ledger's reporting tools\
is the @command\{register\} command.  In fact, internally both commands\
use the same logic, but report the results differently:\
@command\{balance\} shows the summary totals, while @command\{register\}\
reports each posting and how it contributes to that total.\
\
Paradoxically, the most basic form of @command\{register\} is almost\
never used, since it displays every posting:\
\
@example\
ledger reg\
@end example\
\
@command\{reg\} is a short-hand for @command\{register\}.  This command\
reports:\
\
@smallexample\
2004/05/01 Checking balance     Assets:Bank:Checking      $1,000.00    $1,000.00\
                                Equity:Opening Balan..   $-1,000.00            0\
2004/05/01 Investment balance   Assets:Brokerage            50 AAPL      50 AAPL\
                                Equity:Opening Balan..   $-1,500.00   $-1,500.00\
                                                                         50 AAPL\
2004/05/14 Pay day              Assets:Bank:Checking        $500.00   $-1,000.00\
                                                                         50 AAPL\
                                Income:Salary              $-500.00   $-1,500.00\
                                                                         50 AAPL\
2004/05/27 Book Store           Expenses:Books               $20.00   $-1,480.00\
                                                                         50 AAPL\
                                Liabilities:MasterCard      $-20.00   $-1,500.00\
                                                                         50 AAPL\
                                (Liabilities:Taxes)          $-2.00   $-1,502.00\
                                                                         50 AAPL\
2004/05/27 Credit card company  Liabilities:MasterCard       $20.00   $-1,482.00\
                                                                         50 AAPL\
                                Assets:Bank:Checking        $-20.00   $-1,502.00\
                                                                         50 AAPL\
@end smallexample\
\
This rather verbose output shows every account posting in\
@file\{sample.dat\}, and how it affects the running total.  The final\
total is identical to what we saw with the plain @command\{balance\}\
command.  To see how things really balance, we can use @samp\{--real\
-B\}, just as we did with @command\{balance\}:\
\
@example\
ledger --real -B reg\
@end example\
\
Reports:\
\
@smallexample\
2004/05/01 Checking balance     Assets:Bank:Checking      $1,000.00    $1,000.00\
                                Equity:Opening Balan..   $-1,000.00            0\
2004/05/01 Investment balance   Assets:Brokerage          $1,500.00    $1,500.00\
                                Equity:Opening Balan..   $-1,500.00            0\
2004/05/14 Pay day              Assets:Bank:Checking        $500.00      $500.00\
                                Income:Salary              $-500.00            0\
2004/05/27 Book Store           Expenses:Books               $20.00       $20.00\
                                Liabilities:MasterCard      $-20.00            0\
2004/05/27 Credit card company  Liabilities:MasterCard       $20.00       $20.00\
                                Assets:Bank:Checking        $-20.00            0\
@end smallexample\
\
Here we see that everything balances to zero in the end, as it must.}