close: fix and document some newline issues
[ci skip]
This commit is contained in:
parent
2f2b68f1cd
commit
ede41af4c8
@ -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_
|
||||||
|
|
||||||
|
|||||||
@ -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.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user