hstr/INSTALLATION.md
2018-05-23 10:50:22 +02:00

5.2 KiB

INSTALLATION

Install hh using distribution, from source code, on Ubuntu, Fedora/RHEL/CentOS/ScientificLinux, openSUSE, Debian/Mint, Gentoo, Arch Linux, Bash on Ubuntu on Windows (WSL), Cygwin or Mac OS.

UBUNTU

Install hh on Ubuntu - one-liner:

sudo add-apt-repository ppa:ultradvorka/ppa && sudo apt-get update && sudo apt-get install hh && hh --show-configuration >> ~/.bashrc

... or step by step:

sudo add-apt-repository ppa:ultradvorka/ppa
sudo apt-get update
sudo apt-get install hh

Optionally configure hh and check its man page.

FEDORA/RHEL/CENTOS

Install hh on Fedora, RHEL or CentOS:

sudo dnf|yum install hstr -y

Optionally configure hh and check its man page.

openSUSE

For openSUSE Leap 42.1 run the following as root:

zypper addrepo http://download.opensuse.org/repositories/home:tuw-e184/openSUSE_Leap_42.1/home:tuw-e184.repo
zypper refresh
zypper install hstr

INSTALLATION FROM SOURCE CODE

Clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Install hh using:

./configure && make && make install

Optionally configure hh and check its man page.

DISTRIBUTION INSTALLATION

Download latest distribution from project Releases section:

https://github.com/dvorka/hstr/releases

Expand the archive and install hh using:

./configure && make && make install

Optionally configure hh and check its man page.

DEBIAN/MINT

Either download and install .deb archive from releases section of the project:

dpkg -i hstr_1...deb

Alternatively use (not always up to date) PPA to install hh on Debian (Wheezy) or Mint (13) by registering the key:

wget www.clfh.de/frankh.asc
apt-key add frankh.asc

adding the repository:

deb http://www.clfh.de/debian wheezy main
deb-src http://www.clfh.de/debian wheezy main

and installing it:

apt-get update
apt-get install hh

Optionally configure hh:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.

GENTOO

hstr has been added to Portage, see this bug. To install hstr, emerge it like so:

emerge app-shells/hstr

and you should be all set.

ARCH LINUX

Download latest distribution from project Releases section:

https://github.com/dvorka/hstr/releases

Use PKGBUILD in the root of the distribution to build package using makepkg:

https://aur.archlinux.org/packages/hstr-git/

Install hh.

Optionally configure hh and check its man page.

MAC OS

You can either install hh from Homebrew:

brew install hh

or from the source code as described further in this section. First install MacPorts:

http://www.macports.org

And then install readline and ncurses:

port install readline
port install ncurses

Build and install (if using Homebrew):

autoreconf -fvi
./configure CFLAGS=-I$(brew --prefix)/opt/readline/include LDFLAGS=-L$(brew --prefix)/opt/readline/lib
make

Alternative if using MacPorts (macports.com/GitHub):

autoreconf -fvi
./configure CFLAGS=-I/opt/local/include/ LDFLAGS=-L/opt/local/lib
make

Optionally configure hh and check its man page.

WSL

To install hh on Bash on Ubuntu on Windows (WSL) clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Finish installation hh using:

./configure && make && make install

In order to get autocompletion on Cygwin you must configure hh using:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.

CYGWIN

To install hh on Cygwin clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Finish installation hh using:

./configure && make && make install

In order to get autocompletion on Cygwin you must configure hh using:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.