diff --git a/hledger-lib/hledger_journal.m4.md b/hledger-lib/hledger_journal.m4.md
index b1e72d21b..3b31c17ff 100644
--- a/hledger-lib/hledger_journal.m4.md
+++ b/hledger-lib/hledger_journal.m4.md
@@ -826,10 +826,14 @@ account liabilities             2000
 account revenues                4000
 account expenses                6000
 ```
-This affects account display order in reports: 
-accounts with codes are listed before accounts without codes and in increasing code order,
-instead of listing all accounts alphabetically. 
-(*Note: currently not supported in the `balance` command's single-column mode.*)
+This affects how accounts are sorted in account and balance reports: 
+accounts with codes are listed before accounts without codes, and in increasing code order
+(instead of listing all accounts alphabetically). 
+Some current limitations:
+
+- in the `balance` command's single-column mode, account codes do not affect sort order
+- in flat mode reports, account codes on parent accounts do not affect the sort order of subaccounts.
+  (To work around this, declare account codes on the subaccounts as well.) 
 
 Account codes should be all numeric digits, unique, and separated from the account name by at least two spaces (since account names may contain single spaces). 
 By convention, often the first digit indicates the type of account,