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