doc: ANNOUNCE
This commit is contained in:
		
							parent
							
								
									948badd48c
								
							
						
					
					
						commit
						971139c62a
					
				
							
								
								
									
										105
									
								
								doc/ANNOUNCE
									
									
									
									
									
								
							
							
						
						
									
										105
									
								
								doc/ANNOUNCE
									
									
									
									
									
								
							| @ -1,90 +1,73 @@ | |||||||
| hledger (http://hledger.org) is a reliable, cross-platform program for | hledger (http://hledger.org) is a friendly, robust, cross-platform | ||||||
| tracking money, time or other commodities, using double-entry | program for tracking money, time or other commodities, using | ||||||
| accounting and simple plain text file formats. It provides | double-entry accounting, simple plain text file formats, and | ||||||
| command-line, curses and web interfaces, and aims to be a pleasant and | command-line, curses or web UIs. | ||||||
| practical tool for personal, business or institutional use. |  | ||||||
| 
 | 
 | ||||||
| I'm pleased to announce hledger 1.9. The version jump signals some | I'm very pleased to announce hledger 1.10, including work by release | ||||||
| noteworthy changes still landing (normal-positive reports, budget | contributors: | ||||||
| reporting) which are a kind of preview of 2.0. The next major release, |  | ||||||
| on 2018/06/30, will be hledger 2.0. Thank you to release contributors: |  | ||||||
| 
 | 
 | ||||||
| Eli Flanagan, | Alex Chen, | ||||||
|  | Everett Hildenbrandt, | ||||||
|  | Jakub Zárybnický, | ||||||
|  | Nolan Darilek, | ||||||
|  | Dmitry Astapov, | ||||||
|  | Jacob Weisz, | ||||||
| Peter Simons, | Peter Simons, | ||||||
| Christoph Nicolai, | Stephen Morgan, | ||||||
| agander, | Pavlo Kerestey, | ||||||
| M Parker, | Trevor Riles, | ||||||
| Moritz Kiefer, | Léo Gaspard, | ||||||
| Mykola Orliuk. | Mykola Orliuk, | ||||||
|  | Wad, | ||||||
|  | Nana Amfo. | ||||||
| 
 | 
 | ||||||
| Highlights: | 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. | ||||||
| 
 | 
 | ||||||
| * the "financial statement" commands bs/bse/cf/is now show all normal | Please see http://hledger.org/release-notes#hledger-1.10 for the changes  | ||||||
| balances as positive numbers, producing more conventional financial | (as soon as I can get to those; until then, the package changelogs): | ||||||
| reports which are easier to share with others.  (experimental) |  | ||||||
| 
 | 
 | ||||||
| * bal/bs/bse/cf/is can now generate HTML reports | 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 | ||||||
| 
 | 
 | ||||||
| * account codes can be used to customize account sorting |  | ||||||
| 
 | 
 | ||||||
| * numbers in scientific E-notation are supported, eg in journal and CSV data |  | ||||||
| 
 | 
 | ||||||
| * budget report improvements | How to get started: | ||||||
| 
 | ------------------- | ||||||
| * general report cleanups |  | ||||||
| 
 |  | ||||||
| More at http://hledger.org/release-notes#hledger-1.9 . |  | ||||||
| 
 |  | ||||||
| Get started: |  | ||||||
| ------------ |  | ||||||
| 
 | 
 | ||||||
| See http://hledger.org/download for all install methods. | See http://hledger.org/download for all install methods. | ||||||
| Often, to get the latest release you will need to build it.   |  | ||||||
| Here are some ways to do that: |  | ||||||
| 
 | 
 | ||||||
| Using the hledger-install script, which requires only bash and will | One of the easiest is the hledger-install script, which requires only | ||||||
| build and install the hledger tools in $HOME/.local/bin/. | bash and will build and install the hledger tools in $HOME/.local/bin/: | ||||||
| (Note: building haskell apps can take significant time, memory, and |  | ||||||
| disk space, especially the first time.  You can kill and restart the |  | ||||||
| installer without losing progress.  If it fails, please help us |  | ||||||
| improve it by reporting the full output): |  | ||||||
| 
 | 
 | ||||||
| $ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | $ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | ||||||
| $ less hledger-install.sh # (do security review) | $ less hledger-install.sh # (do security review) | ||||||
| $ bash hledger-install.sh # (add -v for more detail; use bash -x to show commands being run) | $ bash hledger-install.sh # (add -v for more detail; use bash -x to show commands being run) | ||||||
| 
 | 
 | ||||||
| Using hledger-install the more convenient, less secure way: | or (insecure): | ||||||
| 
 | 
 | ||||||
| $ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash | $ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash | ||||||
| 
 | 
 | ||||||
| Using stack: | After installation, ensure $HOME/.local/bin is in your $PATH, and try some commands: | ||||||
| 
 |  | ||||||
| $ stack install hledger-lib-1.9 hledger-1.9  # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9 |  | ||||||
| 
 |  | ||||||
| Using cabal: |  | ||||||
| 
 |  | ||||||
| $ cabal update |  | ||||||
| $ cabal install hledger-1.9  # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9 |  | ||||||
| 
 |  | ||||||
| After installation, ensure $HOME/.local/bin is in your $PATH.  |  | ||||||
| Now try some commands: |  | ||||||
| 
 | 
 | ||||||
| $ hledger -h            # quick help | $ hledger -h            # quick help | ||||||
| $ hledger help          # list built-in manuals | $ hledger help          # list built-in manuals | ||||||
| $ hledger add           # record some transactions | $ hledger add           # record some transactions | ||||||
| $ hledger               # list available commands | $ hledger               # list available commands | ||||||
| 
 | 
 | ||||||
| Now perhaps work through the tutorial at  | Next, I encourage you to at least skim the tutorials and docs at | ||||||
| https://github.com/simonmichael/hledger/wiki/hledger-basics-tutorial. | http://hledger.org. | ||||||
| Or review the fine documents at http://hledger.org and |  | ||||||
| http://plaintextaccounting.org. Or say hello and ask questions in the  |  | ||||||
| #hledger IRC channel on Freenode: http://irc.hledger.org. |  | ||||||
| 
 | 
 | ||||||
| Get involved: | 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 | New users and contributors are always welcome! Give feedback, report | ||||||
| bugs, send pull requests, write about it, etc.  And if you have been | bugs, send pull requests, write, evangelise, donate. | ||||||
| finding hledger useful, consider becoming a sponsor or donor to help | 
 | ||||||
| to sustain and accelerate our progress (see home page). | 
 | ||||||
|  | Best! | ||||||
|  | -Simon | ||||||
|  | |||||||
| @ -81,11 +81,11 @@ Jacob Weisz, | |||||||
| Peter Simons, | Peter Simons, | ||||||
| Stephen Morgan, | Stephen Morgan, | ||||||
| Pavlo Kerestey, | Pavlo Kerestey, | ||||||
| trevorriles, | Trevor Riles, | ||||||
| Léo Gaspard, | Léo Gaspard, | ||||||
| Mykola Orliuk, | Mykola Orliuk, | ||||||
| Wad, | Wad, | ||||||
| Aerex. | Nana Amfo. | ||||||
| 
 | 
 | ||||||
| <!--   [project](#project-wide-changes-for-1.10) --> | <!--   [project](#project-wide-changes-for-1.10) --> | ||||||
| <!-- | [hledger-install](#hledger-install.sh-1.10) --> | <!-- | [hledger-install](#hledger-install.sh-1.10) --> | ||||||
|  | |||||||
		Loading…
	
		Reference in New Issue
	
	Block a user