descriptions, notes, payees: fix/improve help and comments

hledger/Hledger/Cli/Commands/Descriptions.hs

@@ -1,6 +1,6 @@
 {-|
 
-The @descriptions@ command lists allpayees seen in transactions.
+The @descriptions@ command lists all unique descriptions seen in transactions, sorted alphabetically.
 
 -}
 

hledger/Hledger/Cli/Commands/Descriptions.md

@@ -1,12 +1,13 @@
-descriptions
-Show descriptions.
+descriptions\
+List the unique descriptions that appear in transactions.
 
 _FLAGS
 
-This command lists all descriptions that appear in transactions.
-
-Examples:
+This command lists the unique descriptions that appear in transactions,
+in alphabetic order.
+You can add a query to select a subset of transactions.
 
+Example:
 ```shell
 $ hledger descriptions
 Store Name

hledger/Hledger/Cli/Commands/Descriptions.txt

@@ -1,10 +1,13 @@
-descriptions Show descriptions.
+descriptions
+List the unique descriptions that appear in transactions.
 
 _FLAGS
 
-This command lists all descriptions that appear in transactions.
+This command lists the unique descriptions that appear in transactions,
+in alphabetic order. You can add a query to select a subset of
+transactions.
 
-Examples:
+Example:
 
 $ hledger descriptions
 Store Name

hledger/Hledger/Cli/Commands/Notes.hs

@@ -1,6 +1,6 @@
 {-|
 
-The @notes@ command lists allpayees seen in transactions.
+The @notes@ command lists all unique notes (description part after a |) seen in transactions, sorted alphabetically.
 
 -}
 

hledger/Hledger/Cli/Commands/Notes.md

@@ -1,12 +1,15 @@
-notes
-Show notes.
+notes\
+List the unique notes that appear in transactions.
 
 _FLAGS
 
-This command lists all notes that appear in transactions.
-
-Examples:
+This command lists the unique notes that appear in transactions,
+in alphabetic order.
+You can add a query to select a subset of transactions.
+The note is the part of the transaction description after a | character
+(or if there is no |, the whole description).
 
+Example:
 ```shell
 $ hledger notes
 Petrol

hledger/Hledger/Cli/Commands/Notes.txt

@@ -1,10 +1,14 @@
-notes Show notes.
+notes
+List the unique notes that appear in transactions.
 
 _FLAGS
 
-This command lists all notes that appear in transactions.
+This command lists the unique notes that appear in transactions, in
+alphabetic order. You can add a query to select a subset of
+transactions. The note is the part of the transaction description after
+a | character (or if there is no |, the whole description).
 
-Examples:
+Example:
 
 $ hledger notes
 Petrol

hledger/Hledger/Cli/Commands/Payees.hs

@@ -1,6 +1,6 @@
 {-|
 
-The @payees@ command lists allpayees seen in transactions.
+The @payees@ command lists all unique payees (description part before a |) seen in transactions, sorted alphabetically.
 
 -}
 

hledger/Hledger/Cli/Commands/Payees.md

@@ -1,12 +1,15 @@
-payees
-Show payee names.
+payees\
+List the unique payee/payer names that appear in transactions.
 
 _FLAGS
 
-This command lists all payee names that appear in transactions.
-
-Examples:
+This command lists the unique payee/payer names that appear in transactions,
+in alphabetic order. 
+You can add a query to select a subset of transactions.
+The payee/payer is the part of the transaction description before a | character
+(or if there is no |, the whole description).
 
+Example:
 ```shell
 $ hledger payees
 Store Name

hledger/Hledger/Cli/Commands/Payees.txt

@@ -1,10 +1,15 @@
-payees Show payee names.
+payees
+List the unique payee/payer names that appear in transactions.
 
 _FLAGS
 
-This command lists all payee names that appear in transactions.
+This command lists the unique payee/payer names that appear in
+transactions, in alphabetic order. You can add a query to select a
+subset of transactions. The payee/payer is the part of the transaction
+description before a | character (or if there is no |, the whole
+description).
 
-Examples:
+Example:
 
 $ hledger payees
 Store Name