docs: add chart to manual

This commit is contained in:
Simon Michael 2010-02-04 21:29:33 +00:00
parent 79880de744
commit 7ebb3dfec1

62
MANUAL
View File

@ -77,6 +77,7 @@ account name or transaction description. Here are some commands to try
hledger histogram # transactions per day, or other interval hledger histogram # transactions per day, or other interval
hledger ui # curses ui, if installed with -fvty hledger ui # curses ui, if installed with -fvty
hledger web # web ui, if installed with -fweb hledger web # web ui, if installed with -fweb
hledger chart # make a balance chart, if installed with -fchart
hledger -f new.ledger add # record transactions from the command line hledger -f new.ledger add # record transactions from the command line
Reference Reference
@ -113,6 +114,7 @@ Here is the command-line help::
stats - show various statistics for a ledger stats - show various statistics for a ledger
ui - run a simple text-based UI ui - run a simple text-based UI
web - run a simple web-based UI web - run a simple web-based UI
chart - generate a balances pie chart
test - run self-tests test - run self-tests
PATTERNS are regular expressions which filter by account name. PATTERNS are regular expressions which filter by account name.
@ -122,31 +124,34 @@ Here is the command-line help::
DATES can be y/m/d or ledger-style smart dates like "last month". DATES can be y/m/d or ledger-style smart dates like "last month".
Options: Options:
-f FILE --file=FILE use a different ledger/timelog file; - means stdin -f FILE --file=FILE use a different ledger/timelog file; - means stdin
-b DATE --begin=DATE report on transactions on or after this date --no-new-accounts don't allow to create new accounts
-e DATE --end=DATE report on transactions before this date -b DATE --begin=DATE report on transactions on or after this date
-p EXPR --period=EXPR report on transactions during the specified period -e DATE --end=DATE report on transactions before this date
and/or with the specified reporting interval -p EXPR --period=EXPR report on transactions during the specified period
-C --cleared report only on cleared transactions and/or with the specified reporting interval
-U --uncleared report only on uncleared transactions -C --cleared report only on cleared transactions
-B --cost, --basis report cost of commodities -U --uncleared report only on uncleared transactions
--depth=N hide accounts/transactions deeper than this -B --cost, --basis report cost of commodities
-d EXPR --display=EXPR show only transactions matching EXPR (where --depth=N hide accounts/transactions deeper than this
EXPR is 'dOP[DATE]' and OP is <, <=, =, >=, >) -d EXPR --display=EXPR show only transactions matching EXPR (where
--effective use transactions' effective dates, if any EXPR is 'dOP[DATE]' and OP is <, <=, =, >=, >)
-E --empty show empty/zero things which are normally elided --effective use transactions' effective dates, if any
-R --real report only on real (non-virtual) transactions -E --empty show empty/zero things which are normally elided
--no-total balance report: hide the final total -R --real report only on real (non-virtual) transactions
-W --weekly register report: show weekly summary --no-total balance report: hide the final total
-M --monthly register report: show monthly summary -W --weekly register report: show weekly summary
-Q --quarterly register report: show quarterly summary -M --monthly register report: show monthly summary
-Y --yearly register report: show yearly summary -Q --quarterly register report: show quarterly summary
-h --help show this help -Y --yearly register report: show yearly summary
-V --version show version information -h --help show this help
-v --verbose show verbose test output -V --version show version information
--binary-filename show the download filename for this hledger build -v --verbose show verbose test output
--debug show extra debug output; implies verbose --binary-filename show the download filename for this hledger build
--debug-no-ui run ui commands with no output --debug show extra debug output; implies verbose
--debug-no-ui run ui commands with no output
-o FILE --output=FILE chart: output filename (default: hledger.png)
--size=WIDTHxHEIGHT chart: image size (default: 1024x1024)
File format File format
........... ...........
@ -225,6 +230,13 @@ balance
The balance command displays accounts and their balances. The balance command displays accounts and their balances.
chart
'''''
The chart command generates a pie chart image for your account balances.
The image will have filename "hledger.png" (or use -o/--output) and
dimensions 1024x1024 (or use --size=WIDTHxHEIGHT).
histogram histogram
''''''''' '''''''''