slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: fixes for the help command's docs

Browse Source
This commit is contained in:
Simon Michael 2016-04-14 19:22:21 -07:00
parent bace208e98
commit 990294f53e
3 changed files with 127 additions and 116 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
hledger/doc/commands.m4.md
View File

@ -236,23 +236,22 @@ Total:
}}) }})
## help ## help
Show detailed help (the main hledger man pages). Show detailed help.
The long `--help` flag displays the hledger man page, as fixed-width text. The `help` command can display any of the main [hledger man pages](/docs.html), as fixed-width text.
The `help` command can display any of the main hledger man pages. (Unlike `hledger --help`, which displays only the hledger man page.)
Run `hledger help` with no arguments to see a list of topics. Run it with no arguments to list available topics (their names are shortened for easier typing),
These correspond to the [man pages](/docs.html), shortened for easy typing. and run `hledger help TOPIC` to select one.
Run `hledger help TOPIC` to view that topic. The output may be long, so you may wish to pipe it into a pager.
You may wish to pipe the output into a pager for easier viewing.
_col3_({{
_shell_({{ _shell_({{
$ hledger help $ hledger help
Please choose a topic, eg: hledger help ui Please choose a topic, eg: hledger help ui
Topics: cli, ui, web, api, journal, csv, timeclock, timedot Topics: cli, ui, web, api, journal, csv, timeclock, timedot
}}), }})
_shell_({{ _shell_({{
$ hledger help cli $ hledger help cli | less
hledger(1) hledger User Manuals hledger(1) hledger(1) hledger User Manuals hledger(1)
@ -262,8 +261,9 @@ NAME
hledger - a command-line accounting tool hledger - a command-line accounting tool
SYNOPSIS SYNOPSIS
... hledger [-f FILE] COMMAND [OPTIONS] [CMDARGS]
}}) hledger [-f FILE] ADDONCMD -- [OPTIONS] [CMDARGS]
:
}}) }})
## incomestatement ## incomestatement

32
hledger/doc/hledger.1
View File

@ -1299,21 +1299,27 @@ Total:
.fi .fi
.SS help .SS help
.PP .PP
Show detailed help (the main hledger man pages). Show detailed help.
.PP .PP
The long \f[C]\-\-help\f[] flag displays the hledger man page, as The \f[C]help\f[] command can display any of the main hledger man pages,
fixed\-width text. as fixed\-width text.
The \f[C]help\f[] command can display any of the main hledger man pages. (Unlike \f[C]hledger\ \-\-help\f[], which displays only the hledger man
Run \f[C]hledger\ help\f[] with no arguments to see a list of topics. page.) Run it with no arguments to list available topics (their names
These correspond to the man pages, shortened for easy typing. are shortened for easier typing), and run \f[C]hledger\ help\ TOPIC\f[]
Run \f[C]hledger\ help\ TOPIC\f[] to view that topic. to select one.
You may wish to pipe the output into a pager for easier viewing. The output may be long, so you may wish to pipe it into a pager.
.PP
\f[C]{.shell\ .clear}\ $\ hledger\ help\ Please\ choose\ a\ topic,\ eg:\ hledger\ help\ ui\ Topics:\ cli,\ ui,\ web,\ api,\ journal,\ csv,\ timeclock,\ timedot\f[],
.IP .IP
.nf .nf
\f[C] \f[C]
$\ hledger\ help\ cli $\ hledger\ help
Please\ choose\ a\ topic,\ eg:\ hledger\ help\ ui
Topics:\ cli,\ ui,\ web,\ api,\ journal,\ csv,\ timeclock,\ timedot
\f[]
.fi
.IP
.nf
\f[C]
$\ hledger\ help\ cli\ |\ less
hledger(1)\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ hledger\ User\ Manuals\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ hledger(1) hledger(1)\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ hledger\ User\ Manuals\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ hledger(1)
@ -1323,7 +1329,9 @@ NAME
\ \ \ \ \ \ \ hledger\ \-\ a\ command\-line\ accounting\ tool \ \ \ \ \ \ \ hledger\ \-\ a\ command\-line\ accounting\ tool
SYNOPSIS SYNOPSIS
\&... \ \ \ \ \ \ \ hledger\ [\-f\ FILE]\ COMMAND\ [OPTIONS]\ [CMDARGS]
\ \ \ \ \ \ \ hledger\ [\-f\ FILE]\ ADDONCMD\ \-\-\ [OPTIONS]\ [CMDARGS]
:
\f[] \f[]
.fi .fi
.SS incomestatement .SS incomestatement

187
hledger/doc/hledger.1.txt
View File

@ -940,19 +940,20 @@ CCOOMMMMAANNDDSS
$-1 $-1
hheellpp hheellpp
Show detailed help (the main hledger man pages). Show detailed help.
The long --help flag displays the hledger man page, as fixed-width The help command can display any of the main hledger man pages, as
text. The help command can display any of the main hledger man pages. fixed-width text. (Unlike hledger --help, which displays only the
Run hledger help with no arguments to see a list of topics. These cor- hledger man page.) Run it with no arguments to list available topics
respond to the man pages, shortened for easy typing. Run (their names are shortened for easier typing), and run
hledger help TOPIC to view that topic. You may wish to pipe the output hledger help TOPIC to select one. The output may be long, so you may
into a pager for easier viewing. wish to pipe it into a pager.
{.shell .clear} $ hledger help Please choose a topic, eg: hledger help ui Top- $ hledger help
ics: cli, ui, web, api, journal, csv, timeclock, timedot, Please choose a topic, eg: hledger help ui
Topics: cli, ui, web, api, journal, csv, timeclock, timedot
$ hledger help cli $ hledger help cli | less
hledger(1) hledger User Manuals hledger(1) hledger(1) hledger User Manuals hledger(1)
@ -962,7 +963,9 @@ CCOOMMMMAANNDDSS
hledger - a command-line accounting tool hledger - a command-line accounting tool
SYNOPSIS SYNOPSIS
... hledger [-f FILE] COMMAND [OPTIONS] [CMDARGS]
hledger [-f FILE] ADDONCMD -- [OPTIONS] [CMDARGS]
:
iinnccoommeessttaatteemmeenntt iinnccoommeessttaatteemmeenntt
Show an income statement. Alias: is. Show an income statement. Alias: is.
@ -972,8 +975,8 @@ CCOOMMMMAANNDDSS
----ddrroopp==NN ----ddrroopp==NN
in flat mode: omit N leading account name parts in flat mode: omit N leading account name parts
This command displays a simple income statement. It currently assumes This command displays a simple income statement. It currently assumes
that you have top-level accounts named income (or revenue) and expense that you have top-level accounts named income (or revenue) and expense
(plural forms also allowed.) (plural forms also allowed.)
$ hledger incomestatement $ hledger incomestatement
@ -1001,7 +1004,7 @@ CCOOMMMMAANNDDSS
Show transactions from the journal. Show transactions from the journal.
--mm SSTTRR ----mmaattcchh==SSTTRR --mm SSTTRR ----mmaattcchh==SSTTRR
show the transaction whose description is most similar to STR, show the transaction whose description is most similar to STR,
and is most recent and is most recent
--oo FFIILLEE[[..FFMMTT]] ----oouuttppuutt--ffiillee==FFIILLEE[[..FFMMTT]] --oo FFIILLEE[[..FFMMTT]] ----oouuttppuutt--ffiillee==FFIILLEE[[..FFMMTT]]
@ -1011,12 +1014,12 @@ CCOOMMMMAANNDDSS
--OO FFMMTT ----oouuttppuutt--ffoorrmmaatt==FFMMTT --OO FFMMTT ----oouuttppuutt--ffoorrmmaatt==FFMMTT
select the output format. Supported formats: txt, csv. select the output format. Supported formats: txt, csv.
The print command displays full transactions from the journal file, The print command displays full transactions from the journal file,
tidily formatted and showing all amounts explicitly. The output of tidily formatted and showing all amounts explicitly. The output of
print is always a valid hledger journal, but it does always not pre- print is always a valid hledger journal, but it does always not pre-
serve all original content exactly (eg directives). serve all original content exactly (eg directives).
hledger's print command also shows all unit prices in effect, or (with hledger's print command also shows all unit prices in effect, or (with
-B/--cost) shows cost amounts. -B/--cost) shows cost amounts.
The print command also supports output destination and CSV output. The print command also supports output destination and CSV output.
@ -1050,14 +1053,14 @@ CCOOMMMMAANNDDSS
include prior postings in the running total include prior postings in the running total
--AA ----aavveerraaggee --AA ----aavveerraaggee
show a running average instead of the running total (implies show a running average instead of the running total (implies
--empty) --empty)
--rr ----rreellaatteedd --rr ----rreellaatteedd
show postings' siblings instead show postings' siblings instead
--ww NN ----wwiiddtthh==NN --ww NN ----wwiiddtthh==NN
set output width (default: terminal width or COLUMNS. -wN,M set output width (default: terminal width or COLUMNS. -wN,M
sets description width as well) sets description width as well)
--oo FFIILLEE[[..FFMMTT]] ----oouuttppuutt--ffiillee==FFIILLEE[[..FFMMTT]] --oo FFIILLEE[[..FFMMTT]] ----oouuttppuutt--ffiillee==FFIILLEE[[..FFMMTT]]
@ -1074,7 +1077,7 @@ CCOOMMMMAANNDDSS
2008/12/31 pay off assets:bank:checking $-1 0 2008/12/31 pay off assets:bank:checking $-1 0
The register command displays postings, one per line, and their running The register command displays postings, one per line, and their running
total. This is typically used with a query selecting a particular total. This is typically used with a query selecting a particular
account, to see that account's activity. account, to see that account's activity.
$ hledger register checking -b 2008/6 --historical $ hledger register checking -b 2008/6 --historical
@ -1082,18 +1085,18 @@ CCOOMMMMAANNDDSS
2008/06/02 save assets:bank:checking $-1 $1 2008/06/02 save assets:bank:checking $-1 $1
2008/12/31 pay off assets:bank:checking $-1 0 2008/12/31 pay off assets:bank:checking $-1 0
The --historical/-H flag adds the balance from any prior postings to The --historical/-H flag adds the balance from any prior postings to
the running total, to show the actual historical running balance. This the running total, to show the actual historical running balance. This
is useful when you want to see just the recent activity. is useful when you want to see just the recent activity.
The --depth option limits the amount of sub-account detail displayed. The --depth option limits the amount of sub-account detail displayed.
The --average/-A flag shows the running average posting amount instead The --average/-A flag shows the running average posting amount instead
of the running total (so, the final number displayed is the average for of the running total (so, the final number displayed is the average for
the whole report period). This flag implies --empty (see below). It the whole report period). This flag implies --empty (see below). It
works best when showing just one account and one commodity. works best when showing just one account and one commodity.
The --related/-r flag shows the _o_t_h_e_r postings in the transactions of The --related/-r flag shows the _o_t_h_e_r postings in the transactions of
the postings which would normally be shown. the postings which would normally be shown.
$ hledger register --monthly income $ hledger register --monthly income
@ -1119,28 +1122,28 @@ CCOOMMMMAANNDDSS
2008/06 assets $-1 0 2008/06 assets $-1 0
2008/12 assets $-1 $-1 2008/12 assets $-1 $-1
With a reporting interval, register shows summary postings, one per With a reporting interval, register shows summary postings, one per
interval, aggregating the postings to each account. interval, aggregating the postings to each account.
Periods with no activity, and summary postings with a zero amount, are Periods with no activity, and summary postings with a zero amount, are
not shown by default; use the --empty/-E flag to see them. not shown by default; use the --empty/-E flag to see them.
Often, you'll want to see just one line per interval. The --depth Often, you'll want to see just one line per interval. The --depth
option helps with this, causing subaccounts to be aggregated. option helps with this, causing subaccounts to be aggregated.
Note when using report intervals, if you specify start/end dates these Note when using report intervals, if you specify start/end dates these
will be adjusted outward if necessary to contain a whole number of will be adjusted outward if necessary to contain a whole number of
intervals. This ensures that the first and last intervals are full intervals. This ensures that the first and last intervals are full
length and comparable to the others in the report. length and comparable to the others in the report.
CCuussttoomm rreeggiisstteerr oouuttppuutt CCuussttoomm rreeggiisstteerr oouuttppuutt
register uses the full terminal width by default, except on windows. register uses the full terminal width by default, except on windows.
You can override this by setting the COLUMNS environment variable (not You can override this by setting the COLUMNS environment variable (not
a bash shell variable) or by using the --width/-w option. a bash shell variable) or by using the --width/-w option.
The description and account columns normally share the space equally The description and account columns normally share the space equally
(about half of (width - 40) each). You can adjust this by adding a (about half of (width - 40) each). You can adjust this by adding a
description width as part of --width's argument, comma-separated: description width as part of --width's argument, comma-separated:
--width W,D . Here's a diagram: --width W,D . Here's a diagram:
<--------------------------------- width (W) ----------------------------------> <--------------------------------- width (W) ---------------------------------->
@ -1156,7 +1159,7 @@ CCOOMMMMAANNDDSS
$ hledger reg -w 100,40 # set overall width 100, description width 40 $ hledger reg -w 100,40 # set overall width 100, description width 40
$ hledger reg -w $COLUMNS,40 # use terminal width, and set description width $ hledger reg -w $COLUMNS,40 # use terminal width, and set description width
The register command also supports the -o/--output-file and -O/--out- The register command also supports the -o/--output-file and -O/--out-
put-format options for controlling output destination and CSV output. put-format options for controlling output destination and CSV output.
ssttaattss ssttaattss
@ -1178,8 +1181,8 @@ CCOOMMMMAANNDDSS
Accounts : 8 (depth 3) Accounts : 8 (depth 3)
Commodities : 1 ($) Commodities : 1 ($)
The stats command displays summary information for the whole journal, The stats command displays summary information for the whole journal,
or a matched part of it. With a reporting interval, it shows a report or a matched part of it. With a reporting interval, it shows a report
for each report period. for each report period.
The stats command also supports -o/--output-file for controlling output The stats command also supports -o/--output-file for controlling output
@ -1191,37 +1194,37 @@ CCOOMMMMAANNDDSS
$ hledger test $ hledger test
Cases: 74 Tried: 74 Errors: 0 Failures: 0 Cases: 74 Tried: 74 Errors: 0 Failures: 0
This command runs hledger's built-in unit tests and displays a quick This command runs hledger's built-in unit tests and displays a quick
report. With a regular expression argument, it selects only tests with report. With a regular expression argument, it selects only tests with
matching names. It's mainly used in development, but it's also nice to matching names. It's mainly used in development, but it's also nice to
be able to check your hledger executable for smoke at any time. be able to check your hledger executable for smoke at any time.
AADDDD--OONN CCOOMMMMAANNDDSS AADDDD--OONN CCOOMMMMAANNDDSS
Add-on commands are executables in your PATH whose name starts with Add-on commands are executables in your PATH whose name starts with
hledger- and ends with any of these file extensions: none, hledger- and ends with any of these file extensions: none,
.hs,.lhs,.pl,.py,.rb,.rkt,.sh,.bat,.com,.exe. Also, an add-on's name .hs,.lhs,.pl,.py,.rb,.rkt,.sh,.bat,.com,.exe. Also, an add-on's name
may not be the same as any built-in command or alias. may not be the same as any built-in command or alias.
hledger will detect these and include them in the command list and let hledger will detect these and include them in the command list and let
you invoke them with hledger ADDONCMD. However there are some limita- you invoke them with hledger ADDONCMD. However there are some limita-
tions: tions:
+o Options appearing before ADDONCMD will be visible only to hledger and +o Options appearing before ADDONCMD will be visible only to hledger and
will not be passed to the add-on. Eg: hledger -h web shows hledger's will not be passed to the add-on. Eg: hledger -h web shows hledger's
usage, hledger web -h shows hledger-web's usage. usage, hledger web -h shows hledger-web's usage.
+o Options understood only by the add-on must go after a -- argument to +o Options understood only by the add-on must go after a -- argument to
hide them from hledger, which would otherwise reject them. Eg: hide them from hledger, which would otherwise reject them. Eg:
hledger web -- --server. hledger web -- --server.
Sometimes it may be more convenient to just run the add-on directly, Sometimes it may be more convenient to just run the add-on directly,
eg: hledger-web --server. eg: hledger-web --server.
Add-ons which are written in haskell can take advantage of the Add-ons which are written in haskell can take advantage of the
hledger-lib library for journal parsing, reporting, command-line hledger-lib library for journal parsing, reporting, command-line
options, etc. options, etc.
Here are some hledger add-ons available from Hackage, the extra direc- Here are some hledger add-ons available from Hackage, the extra direc-
tory in the hledger source, or elsewhere: tory in the hledger source, or elsewhere:
aappii aappii
@ -1279,11 +1282,11 @@ AADDDD--OONN CCOOMMMMAANNDDSS
WF:4303001832 -$6.00 WF:4303001832 -$6.00
[assets:business:bank:wf:bchecking:banking] $6.00 [assets:business:bank:wf:bchecking:banking] $6.00
ledger-autosync, which includes a hledger-autosync alias, downloads ledger-autosync, which includes a hledger-autosync alias, downloads
transactions from your bank(s) via OFX, and prints just the new ones as transactions from your bank(s) via OFX, and prints just the new ones as
journal entries which you can add to your journal. It can also operate journal entries which you can add to your journal. It can also operate
on .OFX files which you've downloaded manually. It can be a nice on .OFX files which you've downloaded manually. It can be a nice
alternative to hledger's built-in CSV reader, especially if your bank alternative to hledger's built-in CSV reader, especially if your bank
supports OFX download. supports OFX download.
ddiiffff ddiiffff
@ -1309,9 +1312,9 @@ AADDDD--OONN CCOOMMMMAANNDDSS
2015/02/02 2015/02/02
(acct:two) $2 (acct:two) $2
hledger-diff compares two journal files. Given an account name, it hledger-diff compares two journal files. Given an account name, it
prints out the transactions affecting that account which are in one prints out the transactions affecting that account which are in one
journal file but not in the other. This can be useful for reconciling journal file but not in the other. This can be useful for reconciling
existing journals with bank statements. existing journals with bank statements.
eeqquuiittyy eeqquuiittyy
@ -1338,14 +1341,14 @@ AADDDD--OONN CCOOMMMMAANNDDSS
equity:opening balances 0 equity:opening balances 0
This prints a journal entry which zeroes out the specified accounts (or This prints a journal entry which zeroes out the specified accounts (or
all accounts) with a transfer to/from "equity:closing balances" (like all accounts) with a transfer to/from "equity:closing balances" (like
Ledger's equity command). Also, it prints an similar entry with oppo- Ledger's equity command). Also, it prints an similar entry with oppo-
site sign for restoring the balances from "equity:opening balances". site sign for restoring the balances from "equity:opening balances".
These can be useful for ending one journal file and starting a new one, These can be useful for ending one journal file and starting a new one,
respectively. By zeroing your asset and liability accounts at the end respectively. By zeroing your asset and liability accounts at the end
of a file and restoring them at the start of the next one, you will see of a file and restoring them at the start of the next one, you will see
correct asset/liability balances whether you run hledger on just one correct asset/liability balances whether you run hledger on just one
file, or on several files concatenated with include. file, or on several files concatenated with include.
iinntteerreesstt iinntteerreesstt
@ -1426,11 +1429,11 @@ AADDDD--OONN CCOOMMMMAANNDDSS
Liabilities:Bank EUR 3700.00 Liabilities:Bank EUR 3700.00
hledger-interest computes interests for a given account. Using command hledger-interest computes interests for a given account. Using command
line flags, the program can be configured to use various schemes for line flags, the program can be configured to use various schemes for
day-counting, such as act/act, 30/360, 30E/360, and 30/360isda. Fur- day-counting, such as act/act, 30/360, 30E/360, and 30/360isda. Fur-
thermore, it supports a (small) number of interest schemes, i.e. thermore, it supports a (small) number of interest schemes, i.e.
annual interest with a fixed rate and the scheme mandated by the German annual interest with a fixed rate and the scheme mandated by the German
BGB288 (Basiszins f~A1/4r Verbrauchergesch~Aoxfte). See the package page BGB288 (Basiszins f~A1/4r Verbrauchergesch~Aoxfte). See the package page
for more. for more.
iirrrr iirrrr
@ -1488,11 +1491,11 @@ AADDDD--OONN CCOOMMMMAANNDDSS
2011/04/01 - 2011/05/01: 32.24% 2011/04/01 - 2011/05/01: 32.24%
2011/05/01 - 2011/06/01: 95.92% 2011/05/01 - 2011/06/01: 95.92%
hledger-irr computes the internal rate of return, also known as the hledger-irr computes the internal rate of return, also known as the
effective interest rate, of a given investment. After specifying what effective interest rate, of a given investment. After specifying what
account holds the investment, and what account stores the gains (or account holds the investment, and what account stores the gains (or
losses, or fees, or cost), it calculates the hypothetical annual rate losses, or fees, or cost), it calculates the hypothetical annual rate
of fixed rate investment that would have provided the exact same cash of fixed rate investment that would have provided the exact same cash
flow. See the package page for more. flow. See the package page for more.
pprriinntt--uunniiqquuee pprriinntt--uunniiqquuee
@ -1524,26 +1527,26 @@ AADDDD--OONN CCOOMMMMAANNDDSS
TTRROOUUBBLLEESSHHOOOOTTIINNGG TTRROOUUBBLLEESSHHOOOOTTIINNGG
RRuunn--ttiimmee pprroobblleemmss RRuunn--ttiimmee pprroobblleemmss
Here are some issues you might encounter when you run hledger (and Here are some issues you might encounter when you run hledger (and
remember you can also seek help from the IRC channel, mail list or bug remember you can also seek help from the IRC channel, mail list or bug
tracker): tracker):
SSuucccceessssffuullllyy iinnssttaalllleedd,, bbuutt ""NNoo ccoommmmaanndd ''hhlleeddggeerr'' ffoouunndd"" SSuucccceessssffuullllyy iinnssttaalllleedd,, bbuutt ""NNoo ccoommmmaanndd ''hhlleeddggeerr'' ffoouunndd""
stack and cabal install binaries into a special directory, which should stack and cabal install binaries into a special directory, which should
be added to your PATH environment variable. Eg on unix-like systems, be added to your PATH environment variable. Eg on unix-like systems,
that is ~/.local/bin and ~/.cabal/bin respectively. that is ~/.local/bin and ~/.cabal/bin respectively.
II sseett aa ccuussttoomm LLEEDDGGEERR__FFIILLEE,, bbuutt hhlleeddggeerr iiss ssttiillll uussiinngg tthhee ddeeffaauulltt ffiillee II sseett aa ccuussttoomm LLEEDDGGEERR__FFIILLEE,, bbuutt hhlleeddggeerr iiss ssttiillll uussiinngg tthhee ddeeffaauulltt ffiillee
LEDGER_FILE should be a real environment variable, not just a shell LEDGER_FILE should be a real environment variable, not just a shell
variable. The command env | grep LEDGER_FILE should show it. You may variable. The command env | grep LEDGER_FILE should show it. You may
need to use export. Here's an explanation. need to use export. Here's an explanation.
""IIlllleeggaall bbyyttee sseeqquueennccee"" oorr ""IInnvvaalliidd oorr iinnccoommpplleettee mmuullttiibbyyttee oorr wwiiddee ""IIlllleeggaall bbyyttee sseeqquueennccee"" oorr ""IInnvvaalliidd oorr iinnccoommpplleettee mmuullttiibbyyttee oorr wwiiddee
cchhaarraacctteerr"" eerrrroorrss cchhaarraacctteerr"" eerrrroorrss
In order to handle non-ascii letters and symbols (like ^A-L), hledger In order to handle non-ascii letters and symbols (like ^A-L), hledger
needs an appropriate locale. This is usually configured system-wide; needs an appropriate locale. This is usually configured system-wide;
you can also configure it temporarily. The locale may need to be one you can also configure it temporarily. The locale may need to be one
that supports UTF-8, if you built hledger with GHC < 7.2 (or possibly that supports UTF-8, if you built hledger with GHC < 7.2 (or possibly
always, I'm not sure yet). always, I'm not sure yet).
Here's an example of setting the locale temporarily, on ubuntu Here's an example of setting the locale temporarily, on ubuntu
@ -1562,7 +1565,7 @@ TTRROOUUBBLLEESSHHOOOOTTIINNGG
$ echo "export LANG=en_US.UTF-8" >>~/.bash_profile $ echo "export LANG=en_US.UTF-8" >>~/.bash_profile
$ bash --login $ bash --login
If we preferred to use eg fr_FR.utf8, we might have to install that If we preferred to use eg fr_FR.utf8, we might have to install that
first: first:
$ apt-get install language-pack-fr $ apt-get install language-pack-fr
@ -1583,31 +1586,31 @@ TTRROOUUBBLLEESSHHOOOOTTIINNGG
KKnnoowwnn lliimmiittaattiioonnss KKnnoowwnn lliimmiittaattiioonnss
CCoommmmaanndd lliinnee iinntteerrffaaccee CCoommmmaanndd lliinnee iinntteerrffaaccee
Add-on command options, unless they are also understood by the main Add-on command options, unless they are also understood by the main
hledger executable, must be written after --, like this: hledger executable, must be written after --, like this:
hledger web -- --server hledger web -- --server
DDiiffffeerreenncceess ffrroomm LLeeddggeerr DDiiffffeerreenncceess ffrroomm LLeeddggeerr
Not all of Ledger's journal file syntax is supported. See file format Not all of Ledger's journal file syntax is supported. See file format
differences. differences.
hledger is slower than Ledger, and uses more memory, on large data hledger is slower than Ledger, and uses more memory, on large data
files. files.
WWiinnddoowwss lliimmiittaattiioonnss WWiinnddoowwss lliimmiittaattiioonnss
In a windows CMD window, non-ascii characters and colours are not sup- In a windows CMD window, non-ascii characters and colours are not sup-
ported. ported.
In a windows Cygwin/MSYS/Mintty window, the tab key is not supported in In a windows Cygwin/MSYS/Mintty window, the tab key is not supported in
hledger add. hledger add.
EENNVVIIRROONNMMEENNTT EENNVVIIRROONNMMEENNTT
LLEEDDGGEERR__FFIILLEE sets the default journal file path. If not set, it is LLEEDDGGEERR__FFIILLEE sets the default journal file path. If not set, it is
~/.hledger.journal. ~/.hledger.journal.
CCOOLLUUMMNNSS sets the default width used by the register command (normally CCOOLLUUMMNNSS sets the default width used by the register command (normally
the full terminal width). the full terminal width).
FFIILLEESS FFIILLEESS
@ -1616,10 +1619,10 @@ FFIILLEESS
file. file.
BBUUGGSS BBUUGGSS
The need to precede options with -- when invoked from hledger is awk- The need to precede options with -- when invoked from hledger is awk-
ward. ward.
hledger can't render non-ascii characters when run from a Windows com- hledger can't render non-ascii characters when run from a Windows com-
mand prompt (up to Windows 7 at least). mand prompt (up to Windows 7 at least).
When input data contains non-ascii characters, a suitable system locale When input data contains non-ascii characters, a suitable system locale
@ -1629,7 +1632,7 @@ BBUUGGSS
RREEPPOORRTTIINNGG BBUUGGSS RREEPPOORRTTIINNGG BBUUGGSS
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
or hledger mail list) or hledger mail list)
@ -1643,7 +1646,7 @@ CCOOPPYYRRIIGGHHTT
SSEEEE AALLSSOO SSEEEE AALLSSOO
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1), hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time- hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
dot(5), ledger(1) dot(5), ledger(1)