install: more doc tweaks, show installer's version
[ci skip]
This commit is contained in:
parent
9b6bad20a4
commit
fabcda2132
@ -9,12 +9,13 @@ usage() {
|
|||||||
cat <<HERE
|
cat <<HERE
|
||||||
hledger-install.sh [-f|--force] [-v|--verbose] [-s|--status] [--version] [-h|--help]
|
hledger-install.sh [-f|--force] [-v|--verbose] [-s|--status] [--version] [-h|--help]
|
||||||
|
|
||||||
Install the current release of hledger and related tools, as reliably and
|
Installs the current release of hledger and related tools as reliably and
|
||||||
quickly as possible, on any POSIX system, using cabal or stack.
|
quickly as possible on any POSIX system, using cabal (if installed and
|
||||||
|
stack is not) or stack (installing it when needed or if --force is used).
|
||||||
With --status, just lists the currently installed hledger tools.
|
With --status, just lists the currently installed hledger tools.
|
||||||
Usage:
|
Usage:
|
||||||
|
|
||||||
curl -sSLO http://hledger.org/hledger-install.sh
|
curl -sSLO http://hledger.org/hledger-install.sh # or wget -qO- ...
|
||||||
less hledger-install.sh # security review
|
less hledger-install.sh # security review
|
||||||
bash [-x] hledger-install.sh # to see commands being run, add -x
|
bash [-x] hledger-install.sh # to see commands being run, add -x
|
||||||
|
|
||||||
@ -22,9 +23,11 @@ or if you prefer convenience to security:
|
|||||||
|
|
||||||
curl -sSL http://hledger.org/hledger-install.sh | bash
|
curl -sSL http://hledger.org/hledger-install.sh | bash
|
||||||
|
|
||||||
or:
|
Once hledger is installed, if you keep hledger-install.sh in \$PATH
|
||||||
|
(and upgrade it periodically - currently this must be done manually):
|
||||||
|
|
||||||
wget -qO- http://hledger.org/hledger-install.sh | bash
|
hledger install # upgrades other hledger tools
|
||||||
|
hledger install -- -s # shows installation status
|
||||||
|
|
||||||
Version $VERSION, installs hledger $HLEDGER_VERSION
|
Version $VERSION, installs hledger $HLEDGER_VERSION
|
||||||
HERE
|
HERE
|
||||||
@ -705,7 +708,7 @@ trap cleanup_temp_dir EXIT
|
|||||||
|
|
||||||
# hledger routines
|
# hledger routines
|
||||||
|
|
||||||
# install stack if needed or always with --force, in $HOME/.local/bin
|
# install stack if needed, or always with --force, in $HOME/.local/bin
|
||||||
ensure_stack() {
|
ensure_stack() {
|
||||||
if ! $(has_stack) || [[ "$FORCE" == "true" ]] ; then
|
if ! $(has_stack) || [[ "$FORCE" == "true" ]] ; then
|
||||||
echo "Installing stack"
|
echo "Installing stack"
|
||||||
@ -725,7 +728,8 @@ cmd_location() {
|
|||||||
command -v "$1"
|
command -v "$1"
|
||||||
}
|
}
|
||||||
|
|
||||||
# Get the given command's version, or empty string if there's a problem.
|
# Get the given command's version, ie the first number in its --version output,
|
||||||
|
# or empty string if there's a problem.
|
||||||
cmd_version() {
|
cmd_version() {
|
||||||
(command "$1" --version 2>/dev/null | grep -E '[0-9]' | $SED -e 's/[^0-9]*([0-9][0-9.]*).*/\1/') || ""
|
(command "$1" --version 2>/dev/null | grep -E '[0-9]' | $SED -e 's/[^0-9]*([0-9][0-9.]*).*/\1/') || ""
|
||||||
}
|
}
|
||||||
@ -746,7 +750,7 @@ print_cmd_version() {
|
|||||||
|
|
||||||
# Show the installation status of the $HLEDGER_MAIN_TOOLS and $HLEDGER_OTHER_TOOLS.
|
# Show the installation status of the $HLEDGER_MAIN_TOOLS and $HLEDGER_OTHER_TOOLS.
|
||||||
print_hledger_versions() {
|
print_hledger_versions() {
|
||||||
for cmd in $HLEDGER_MAIN_TOOLS $HLEDGER_OTHER_TOOLS; do print_cmd_version $cmd; done
|
for cmd in $HLEDGER_MAIN_TOOLS $HLEDGER_OTHER_TOOLS $(basename $0) ; do print_cmd_version $cmd; done
|
||||||
}
|
}
|
||||||
|
|
||||||
# Run a command, but first log it with "Trying" prepended.
|
# Run a command, but first log it with "Trying" prepended.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user