hosts/Readme.md

# Hosts

A command line program with shortcuts for managing hosts file entries.

## Usage

    Usage:
      hosts add <ip> <hostname>
      hosts remove <hostname>
      hosts list [enabled | disabled | <search string>]
      hosts show ( <ip> | <hostname> | <search string> )
      hosts disable ( <ip> | <hostname> | <search term> )
      hosts enable ( <ip> | <hostname> | <search term> )
      hosts edit
      hosts file

For full usage, run:

    hosts help

or

    hosts help <command name>

## Acknowledgements

Based on prior work by:

- https://github.com/nddrylliog
  - https://gist.github.com/nddrylliog/1368532
- https://github.com/dfeyer
  - https://gist.github.com/dfeyer/1369760

Original idea and interface (since changed) via:

https://github.com/macmade/host-manager
Add initial Readme with basic information. 2015-03-17 00:05:46 +00:00			`# Hosts`

Expand Readme slightly. 2015-03-17 03:13:19 +00:00			`A command line program with shortcuts for managing hosts file entries.`
Add initial Readme with basic information. 2015-03-17 00:05:46 +00:00
			`## Usage`

			`Usage:`
Clarify usage information 2015-03-17 00:26:58 +00:00			`hosts add <ip> <hostname>`
			`hosts remove <hostname>`
Add 'enabled' and 'disabled' options to `list` These return records that have the status specified in the option. 2015-03-19 00:04:39 +00:00			`hosts list [enabled \| disabled \| <search string>]`
Add `show` command and use that for `list` searches Displaying a record pair for a hostname or IP address is likely a common operation, and using the `show` name makes it clear what the primary function of the command is. Since record pairs are very simple, the easiest way to allow both hostname and ip address arguments is to use grep, which also provides general search-like functionality. In order to avoid doubling this functionality, use the `show` command in the `list` command for search. 2015-03-18 23:07:49 +00:00			`hosts show ( <ip> \| <hostname> \| <search string> )`
Add `disable` and `enable` commands These commands make it possible to disable records without fully removing them. To 'disable' a record, it simply is commented out with the following pattern `#disabled: ` prepended to the line. 2015-03-18 22:49:21 +00:00			`hosts disable ( <ip> \| <hostname> \| <search term> )`
			`hosts enable ( <ip> \| <hostname> \| <search term> )`
Add `edit` command `edit` open the hosts file in the editor specified in the $EDITOR environment variable. 2015-03-17 00:38:06 +00:00			`hosts edit`
Add `hosts file` command to Readme. 2015-03-17 02:56:16 +00:00			`hosts file`
Add acknowledgements sections for script and Readme 2015-03-17 00:19:17 +00:00
Expand Readme slightly. 2015-03-17 03:13:19 +00:00			`For full usage, run:`

			`hosts help`

			`or`

			`hosts help <command name>`

Add acknowledgements sections for script and Readme 2015-03-17 00:19:17 +00:00			`## Acknowledgements`

			`Based on prior work by:`

			`- https://github.com/nddrylliog`
			`- https://gist.github.com/nddrylliog/1368532`
			`- https://github.com/dfeyer`
			`- https://gist.github.com/dfeyer/1369760`

			`Original idea and interface (since changed) via:`

			`https://github.com/macmade/host-manager`