diff --git a/hledger-lib/hledger_journal.m4.md b/hledger-lib/hledger_journal.m4.md
index d1ca1bae1..d2a337aa0 100644
--- a/hledger-lib/hledger_journal.m4.md
+++ b/hledger-lib/hledger_journal.m4.md
@@ -911,11 +911,14 @@ expenses
 Undeclared accounts, if any, are displayed last, in alphabetical order.
 
 Note that sorting is done at each level of the account tree (within each group of sibling accounts under the same parent).
-This directive:
+And currently, this directive:
 ```journal
 account other:zoo
 ``` 
 would influence the position of `zoo` among `other`'s subaccounts, but not the position of `other` among the top-level accounts.
+This means:
+- you will sometimes declare parent accounts (eg `account other` above) that you don't intend to post to, just to customize their display order
+- sibling accounts stay together (you couldn't display `x:y` in between `a:b` and `a:c`). 
 
 ### Rewriting accounts