;doc: update command help txt files

[ci skip]

hledger/Hledger/Cli/Commands/Add.txt

@@ -60,3 +60,7 @@ Save this transaction to the journal ? [y]:
 Saved.
 Starting the next transaction (. or ctrl-D/ctrl-C to quit)
 Date [2015/05/22]: <CTRL-D> $
+
+On Microsoft Windows, the add command makes sure that no part of the
+file path ends with a period, as it can cause data loss on that platform
+(cf #1056).

hledger/Hledger/Cli/Commands/Balance.txt

@@ -220,6 +220,9 @@ information:
     ----------------------++-------------------------------------
                           ||           0           0           0 
 
+Note that --cumulative or --historical/-H disable --row-total/-T, since
+summing end balances generally does not make sense.
+
 Multicolumn balance reports display accounts in flat mode by default; to
 see the hierarchy, use --tree.
 

hledger/Hledger/Cli/Commands/Balancesheet.txt

@@ -35,7 +35,9 @@ With a reporting interval, multiple columns will be shown, one for each
 report period. As with multicolumn balance reports, you can alter the
 report mode with --change/--cumulative/--historical. Normally
 balancesheet shows historical ending balances, which is what you need
-for a balance sheet; note this means it ignores report begin dates.
+for a balance sheet; note this means it ignores report begin dates (and
+-T/--row-total, since summing end balances generally does not make
+sense).
 
 This command also supports output destination and output format
 selection.

hledger/Hledger/Cli/Commands/Close.txt

@@ -41,6 +41,10 @@ balance assertions will depend on these flags. Likewise, if you run this
 command with --auto, the balance assertions will probably always require
 --auto.
 
+When account balances have cost information (transaction prices), the
+closing/opening transactions will preserve it, so that eg balance -B
+reports will not be affected.
+
 Examples:
 
 Carrying asset/liability balances into a new file for 2019, all from

hledger/Hledger/Cli/Commands/Descriptions.txt

@@ -1,5 +1,4 @@
-descriptions
+descriptions Show descriptions.
-Show descriptions.
 
 _FLAGS_
 

hledger/Hledger/Cli/Commands/Import.txt

@@ -18,7 +18,7 @@ see only uncategorised transactions:
 
 $ hledger import --dry ... | hledger -f- print unknown --ignore-assertions
 
-Importing balance assignments:
+Importing balance assignments
 
 Entries added by import will have their posting amounts made explicit
 (like hledger print -x). This means that any balance assignments in

hledger/Hledger/Cli/Commands/Notes.txt

@@ -1,5 +1,4 @@
-notes
+notes Show notes.
-Show notes.
 
 _FLAGS_
 

hledger/Hledger/Cli/Commands/Payees.txt

@@ -1,5 +1,4 @@
-payees
+payees Show payee names.
-Show payee names.
 
 _FLAGS_
 

hledger/Hledger/Cli/Commands/Rewrite.txt

@@ -13,9 +13,9 @@ transaction's first posting amount.
 
 Examples:
 
-hledger-rewrite.hs ^income --add-posting '(liabilities:tax)  *.33  ; income tax' --add-posting '(reserve:gifts)  $100'
+$ hledger-rewrite.hs ^income --add-posting '(liabilities:tax)  *.33  ; income tax' --add-posting '(reserve:gifts)  $100'
-hledger-rewrite.hs expenses:gifts --add-posting '(reserve:gifts)  *-1"'
+$ hledger-rewrite.hs expenses:gifts --add-posting '(reserve:gifts)  *-1"'
-hledger-rewrite.hs -f rewrites.hledger
+$ hledger-rewrite.hs -f rewrites.hledger
 
 rewrites.hledger may consist of entries like:
 

hledger/Hledger/Cli/Commands/Tags.txt

@@ -2,6 +2,7 @@ tags
 List all the tag names used in the journal. With a TAGREGEX argument,
 only tag names matching the regular expression (case insensitive) are
 shown. With QUERY arguments, only transactions matching the query are
-considered.
+considered. With --values flag, the tags' unique values are listed
+instead.
 
 _FLAGS_