close: fix and document some newline issues

[ci skip]
This commit is contained in:
Simon Michael 2019-01-22 14:10:37 -08:00
parent 2f2b68f1cd
commit ede41af4c8
2 changed files with 15 additions and 9 deletions

View File

@ -1,11 +1,8 @@
close, equity close, equity
Prints a "closing balances" transaction and an "opening balances" transaction
Prints a "closing balances" transaction and an "opening balances" transaction,
that bring account balances to and from zero, respectively. that bring account balances to and from zero, respectively.
Useful for, eg: Useful for bringing asset/liability balances forward into a new journal file,
or for closing out revenues/expenses to retained earnings at the end of a period.
- bringing asset/liability balances forward into a new journal file
- closing out revenues/expenses to retained earnings at the end of a period
_FLAGS_ _FLAGS_

View File

@ -11,12 +11,21 @@ It has some special features:
as space or comma-separated words. as space or comma-separated words.
- A line containing just _FLAGS_ will be replaced in --help output by - A line containing just _FLAGS_ will be replaced in --help output by
the command's flags list. If there's no such line, the flags will be the command's flags list. Lines above _FLAGS_ are known as the short help.
displayed at the end. In the manual, no flags list is shown. If there's no such line, the flags will be displayed at the end.
In the manual, no flags list is shown.
- Markdown can be used to influence the appearance of the manuals, - Markdown can be used to influence the appearance of the manuals,
especially the html version. But the markup will also appear especially the html version. But the markup will also appear
uninterpreted in the --help output, so use sparingly. uninterpreted in the --help output, so use sparingly.
- GHC (and ghcid etc.) won't notice changes in this file; - Use only one newline on the first line (or cmdargs will display the
short help with two newlines after each line). This also means
cmdargs will strip out any blank lines, which prevents use of some
markdown features.
- Keep the width of short help lines to 76 characters or less, or
cmdargs will insert newlines.
- GHC, stack, cabal, ghcid etc. won't notice changes in this file;
you have to also touch the .hs file. you have to also touch the .hs file.