slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: download: describe installer better

Browse Source
This commit is contained in:
Simon Michael 2017-12-22 06:41:32 -08:00
parent 0fbf0b1cb3
commit b1a7921239
1 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
site/download.md
View File

@ -35,24 +35,27 @@ but they can be out of date or incomplete.
## B. I want to build the latest release ## B. I want to build the latest release
The latest release (see [release notes](release-notes.html)) is a good choice. The latest release is a good choice. Check the [release notes](release-notes.html) to see what's in it.
On POSIX systems (mac/linux/freebsd..), use our new hassle-free installer On POSIX systems (mac/linux/freebsd..), the hassle-free
to get the current release of hledger and related tools. [hledger-install.sh](https://github.com/simonmichael/hledger/tree/master/hledger-install) script is the most reliable install method.
Here's the more secure way: It will use stack or cabal, installing stack if needed, and build the current release of hledger and addon tools,
installing everything in $HOME/.local/bin (or $HOME/.cabal/bin).
This is like doing a manual stack/cabal install, but more automated and robust.
Here's how to run the installer:
**`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)*
and here's the less secure, more convenient way: and here's the more convenient but less secure way:
**`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`**
Note this could take significant time (minutes to hours), memory (~2G), Note, building haskell apps can take significant time (minutes to hours), memory (~2G),
and disk space (up to a gigabyte) depending on your connection, and disk space (up to a gigabyte in $HOME/.stack, though you can delete that afterward).
machine and past cabal/stack installations. You can kill and rerun it without losing progress. You can kill and restart the installer without losing progress.
If the installer fails, please help improve it by [reporting](docs.html#helpfeedback) the full output. If it fails, please help us improve it by [reporting the full output](docs.html#helpfeedback).
Or, you can install manually (all systems): Or, you can install manually (all systems):