From b67555bdb78098c21178c55aa588df9ac5a924e5 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Fri, 24 Oct 2025 09:45:32 -1000 Subject: [PATCH] ;doc: demote COMMON TASKS subheadings --- hledger/hledger.m4.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md index b3949d5a9..959e18d7c 100644 --- a/hledger/hledger.m4.md +++ b/hledger/hledger.m4.md @@ -6787,7 +6787,7 @@ _commands_ 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: @@ -6808,7 +6808,7 @@ $ hledger help --help # find out more about the help command To view manuals and introductory docs on the web, visit . Chat and mail list support and discussion archives can be found at . -# Constructing command lines +## Constructing command lines hledger has a flexible command line interface. 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 - 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: ```cli @@ -6856,7 +6856,7 @@ Commodities : 0 () Market prices : 0 () ``` -# Setting LEDGER_FILE +## Setting LEDGER_FILE 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, 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 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 ``` -# Recording transactions +## Recording transactions As you spend or receive money, you can record these transactions using one of the methods above (text editor, hledger add) @@ -6995,7 +6995,7 @@ and hledger.org for more ideas: assets:bank:checking $1000 ``` -# Reconciling +## Reconciling Periodically you should reconcile - compare your hledger-reported balances 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 ``` -# Reporting +## Reporting Here are some basic reports. @@ -7195,7 +7195,7 @@ $ hledger activity -W 2023-01-06 **** 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, so that old transactions don't slow down or clutter your reports,