;doc: update command help

This commit is contained in:
Simon Michael 2023-04-07 09:52:31 -10:00
parent 2bdba319b1
commit c2288f8143

View File

@ -12,12 +12,20 @@ It can be useful when offline, or when you prefer the terminal to a web
browser, or when the appropriate hledger manual or viewing tools are not browser, or when the appropriate hledger manual or viewing tools are not
installed on your system. installed on your system.
By default it chooses the best viewer found in $PATH (preferring info By default it chooses the best viewer found in $PATH, trying (in this
since the hledger manual is large). You can select a particular viewer order): info, man, $PAGER, less, more. You can force the use of info,
with the -i, -m, or -p flags. man, or a pager with the -i, -m, or -p flags, If no viewer can be found,
or the command is run non-interactively, it just prints the manual to
stdout.
If using info, note that version 6 or greater is needed for TOPIC
lookup. If you are on mac you will likely have info 4.8, and should
consider installing a newer version, eg with brew install texinfo
(#1770).
Examples Examples
$ hledger help --help # show how the help command works $ hledger help --help # show how the help command works
$ hledger help # show the hledger manual with info, man or $PAGER $ hledger help # show the hledger manual with info, man or $PAGER
$ hledger help journal # show the journal topic in the hledger manual $ hledger help journal # show the journal topic in the hledger manual
$ hledger help -m journal # show it with man, even if info is installed