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

;doc: demote COMMON TASKS subheadings

Browse Source
This commit is contained in:
Simon Michael 2025-10-24 09:45:32 -10:00
parent e3736fddde
commit b67555bdb7
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
hledger/hledger.m4.md
View File

@ -6787,7 +6787,7 @@ _commands_
Here are some quick examples of how to do some basic tasks with hledger. Here are some quick examples of how to do some basic tasks with hledger.
# Getting help ## Getting help
Here's how to list commands and view options and command docs: Here's how to list commands and view options and command docs:
@ -6808,7 +6808,7 @@ $ hledger help --help # find out more about the help command
To view manuals and introductory docs on the web, visit <https://hledger.org>. To view manuals and introductory docs on the web, visit <https://hledger.org>.
Chat and mail list support and discussion archives can be found at <https://hledger.org/support>. Chat and mail list support and discussion archives can be found at <https://hledger.org/support>.
# Constructing command lines ## Constructing command lines
hledger has a flexible command line interface. hledger has a flexible command line interface.
We strive to keep it simple and ergonomic, but if you run into one of We strive to keep it simple and ergonomic, but if you run into one of
@ -6821,7 +6821,7 @@ here are some tips that might help:
- if needed, also add a backslash to hide regular expression metacharacters from the shell - if needed, also add a backslash to hide regular expression metacharacters from the shell
- to see how a misbehaving command line is being parsed, add `--debug=2`. - to see how a misbehaving command line is being parsed, add `--debug=2`.
# Starting a journal file ## Starting a journal file
hledger looks for your accounting data in a journal file, `$HOME/.hledger.journal` by default: hledger looks for your accounting data in a journal file, `$HOME/.hledger.journal` by default:
```cli ```cli
@ -6856,7 +6856,7 @@ Commodities : 0 ()
Market prices : 0 () Market prices : 0 ()
``` ```
# Setting LEDGER_FILE ## Setting LEDGER_FILE
How to set `LEDGER_FILE` permanently depends on your setup: How to set `LEDGER_FILE` permanently depends on your setup:
@ -6895,7 +6895,7 @@ or try running these commands in a powershell window
When correctly configured, in a new terminal window `$env:LEDGER_FILE` will show the file path, When correctly configured, in a new terminal window `$env:LEDGER_FILE` will show the file path,
and so will `hledger files`. and so will `hledger files`.
# Setting opening balances ## Setting opening balances
Pick a starting date for which you can look up the balances of some Pick a starting date for which you can look up the balances of some
real-world assets (bank accounts, wallet..) and liabilities (credit cards..). real-world assets (bank accounts, wallet..) and liabilities (credit cards..).
@ -6971,7 +6971,7 @@ If you're using version control, this could be a good time to commit the journal
$ git commit -m 'initial balances' 2023.journal $ git commit -m 'initial balances' 2023.journal
``` ```
# Recording transactions ## Recording transactions
As you spend or receive money, you can record these transactions As you spend or receive money, you can record these transactions
using one of the methods above (text editor, hledger add) using one of the methods above (text editor, hledger add)
@ -6995,7 +6995,7 @@ and hledger.org for more ideas:
assets:bank:checking $1000 assets:bank:checking $1000
``` ```
# Reconciling ## Reconciling
Periodically you should reconcile - compare your hledger-reported balances Periodically you should reconcile - compare your hledger-reported balances
against external sources of truth, like bank statements or your bank's website - against external sources of truth, like bank statements or your bank's website -
@ -7047,7 +7047,7 @@ If you're using version control, this can be another good time to commit:
$ git commit -m 'txns' 2023.journal $ git commit -m 'txns' 2023.journal
``` ```
# Reporting ## Reporting
Here are some basic reports. Here are some basic reports.
@ -7195,7 +7195,7 @@ $ hledger activity -W
2023-01-06 **** 2023-01-06 ****
2023-01-13 **** 2023-01-13 ****
``` ```
# Migrating to a new file ## Migrating to a new file
At the end of the year, you may want to continue your journal in a new file, At the end of the year, you may want to continue your journal in a new file,
so that old transactions don't slow down or clutter your reports, so that old transactions don't slow down or clutter your reports,