doc: save 1.11 announcement
[ci skip]
This commit is contained in:
		
							parent
							
								
									9c0648b46a
								
							
						
					
					
						commit
						30e0768e86
					
				
							
								
								
									
										106
									
								
								doc/ANNOUNCE
									
									
									
									
									
								
							
							
						
						
									
										106
									
								
								doc/ANNOUNCE
									
									
									
									
									
								
							| @ -1,73 +1,53 @@ | ||||
| hledger (http://hledger.org) is a friendly, robust, cross-platform | ||||
| program for tracking money, time or other commodities, using | ||||
| double-entry accounting, simple plain text file formats, and | ||||
| command-line, curses or web UIs. | ||||
| Short announcement this quarter. Pleased to announce the release of hledger 1.11 on schedule!  | ||||
| 
 | ||||
| I'm very pleased to announce hledger 1.10, including work by release | ||||
| contributors: | ||||
| Thanks to release contributors Joseph Weston, Dmitry Astapov, Gaith Hallak, Jakub Zárybnický, Luca Molteni, and SpicyCat. | ||||
| 
 | ||||
| Alex Chen, | ||||
| Everett Hildenbrandt, | ||||
| Jakub Zárybnický, | ||||
| Nolan Darilek, | ||||
| Dmitry Astapov, | ||||
| Jacob Weisz, | ||||
| Peter Simons, | ||||
| Stephen Morgan, | ||||
| Pavlo Kerestey, | ||||
| Trevor Riles, | ||||
| Léo Gaspard, | ||||
| Mykola Orliuk, | ||||
| Wad, | ||||
| Nana Amfo. | ||||
| stack users will need to get a copy of hledger source and do stack install from there, due to the recent GHC 8.6 release. cabal install hledger-1.11 should work normally.  | ||||
| 
 | ||||
| You'll note this is not 2.0 as previously planned - we will spend a | ||||
| bit more time on that.  The next major release is expected to be on | ||||
| 2018/09/30. | ||||
| From http://hledger.org/release-notes.html#hledger-1.11 : | ||||
| 
 | ||||
| Please see http://hledger.org/release-notes#hledger-1.10 for the changes  | ||||
| (as soon as I can get to those; until then, the package changelogs): | ||||
| hledger 1.11 | ||||
| 
 | ||||
| http://hackage.haskell.org/package/hledger-1.10/changelog | ||||
| http://hackage.haskell.org/package/hledger-ui-1.10/changelog | ||||
| http://hackage.haskell.org/package/hledger-web-1.10/changelog | ||||
| http://hackage.haskell.org/package/hledger-api-1.10/changelog | ||||
| http://hackage.haskell.org/package/hledger-lib-1.10/changelog | ||||
| - The default display order of accounts is now influenced by the order of account directives. Accounts declared by account directives are displayed first (top-most), in declaration order, followed by undeclared accounts in alphabetical order. Numeric account codes are no longer used, and are ignored and considered deprecated. | ||||
| 
 | ||||
| - So if your accounts are displaying in a weird order after upgrading, and you want them alphabetical like before, just sort your account directives alphabetically. | ||||
| 
 | ||||
| - Account sorting (by name, by declaration, by amount) is now more robust and supported consistently by all commands (accounts, balance, bs..) in all modes (tree & flat, tabular & non-tabular). | ||||
| 
 | ||||
| - close: new –opening/–closing flags to print only the opening or closing transaction | ||||
| 
 | ||||
| - files: a new command to list included files | ||||
| 
 | ||||
| - prices: query arguments are now supported. Prices can be filtered by date, and postings providing transaction prices can also be filtered. | ||||
| 
 | ||||
| - rewrite: help clarifies relation to print –auto (#745) | ||||
| 
 | ||||
| - roi: a new command to compute return on investment, based on hledger-irr | ||||
| 
 | ||||
| - test: has more verbose output, more informative failure messages, and no longer tries to read the journal | ||||
| 
 | ||||
| - csv: We use a more robust CSV lib (cassava) and now support non-comma separators, eg –separator ‘;’ (experimental, this flag will probably become a CSV rule) (#829) | ||||
| 
 | ||||
| - csv: interpolated field names in values are now properly case insensitive, so this works: | ||||
| 
 | ||||
| - fields …,Transaction_Date,… date %Transaction_Date | ||||
| 
 | ||||
| - journal: D (default commodity) directives no longer break multiplier amounts in transaction modifiers (AKA automated postings) (#860) | ||||
| 
 | ||||
| - journal: “Automated Postings” have been renamed to “Transaction Modifiers”. | ||||
| 
 | ||||
| - journal: transaction comments in transaction modifier rules are now parsed correctly. (#745) | ||||
| 
 | ||||
| - journal: when include files form a cycle, we give an error instead of hanging. | ||||
| 
 | ||||
| - upper-case day/month names in period expressions no longer give an error (#847, #852) | ||||
| 
 | ||||
| 
 | ||||
| Corrections: | ||||
| 
 | ||||
| How to get started: | ||||
| ------------------- | ||||
| - http://hledger.org has been updated with the latest install methods. | ||||
| 
 | ||||
| See http://hledger.org/download for all install methods. | ||||
| - hledger-install.sh now ensures a new-enough stack. | ||||
| 
 | ||||
| One of the easiest is the hledger-install script, which requires only | ||||
| bash and will build and install the hledger tools in $HOME/.local/bin/: | ||||
| 
 | ||||
| $ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | ||||
| $ less hledger-install.sh  # do security review | ||||
| $ bash hledger-install.sh | ||||
| 
 | ||||
| or (insecure; add -x flag to bash to see commands that were run): | ||||
| 
 | ||||
| $ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash | ||||
| 
 | ||||
| After installation, ensure $HOME/.local/bin is in your $PATH, and try some commands: | ||||
| 
 | ||||
| $ hledger -h            # quick help | ||||
| $ hledger help          # list built-in manuals | ||||
| $ hledger add           # record some transactions | ||||
| $ hledger               # list available commands | ||||
| 
 | ||||
| Next, I encourage you to at least skim the tutorials and docs at | ||||
| http://hledger.org. | ||||
| 
 | ||||
| Say hello and ask questions in the #hledger IRC channel on Freenode: | ||||
| http://irc.hledger.org. | ||||
| 
 | ||||
| New users and contributors are always welcome! Give feedback, report | ||||
| bugs, send pull requests, write, evangelise, help sustain us by donating. | ||||
| 
 | ||||
| 
 | ||||
| Best! | ||||
| -Simon | ||||
| - stack users don't need to fetch hledger source, but do need to specify an extra dep on the command line, eg like so:  | ||||
| stack install --resolver=lts-12 cassava-megaparsec-1.0.0 hledger-lib-1.11 hledger-1.11 hledger-ui-1.11 hledger-web-1.11 hledger-api-1.11 | ||||
|  | ||||
		Loading…
	
		Reference in New Issue
	
	Block a user