hosts/etc/README.md

1.9 KiB

Installation instructions

Homebrew

Installing via Homebrew with brew install xwmx/taps/hosts will also install the completion scripts. The extra steps to install hosts completion scripts outlined below are not needed.

A one-time setup might be needed to enable completion for all Homebrew programs.

npm

Installing via npm should install the completion scripts. If completion isn't working, try the instructions below.

Scripts

hosts includes scripts for installing and uninstalling completions.

These scripts will try to determine the completion installation locations from your environment. If completion doesn't work, you might need to try installing manually.

Manual Installation

bash

Linux

On a current Linux OS (in a non-minimal installation), bash completion should be available.

Place the completion script in /etc/bash_completion.d/:

sudo curl -L https://raw.githubusercontent.com/xwmx/hosts/master/hosts-completion.bash -o /etc/bash_completion.d/hosts

macOS

If you aren't installing with homebrew, source the completion script in .bash_profile:

if [[ -f /path/to/hosts-completion.bash ]]
then
  source /path/to/hosts-completion.bash
fi

zsh

Place the completion script in your /path/to/zsh/completion (typically ~/.zsh/completion/):

$ mkdir -p ~/.zsh/completion
$ curl -L https://raw.githubusercontent.com/xwmx/hosts/master/hosts-completion.zsh > ~/.zsh/completion/_hosts

Include the directory in your $fpath by adding in ~/.zshrc:

fpath=(~/.zsh/completion $fpath)

Make sure compinit is loaded or do it by adding in ~/.zshrc:

autoload -Uz compinit && compinit -i

Then reload your shell:

exec $SHELL -l