Clean up and refresh iTerm sub pages (sb2nov#212)

Author: simeg

iTerm/ack.md

@@ -1,13 +1,14 @@
 # `ack`
 
-`ack` is a search tool designed for code. It's built to be a replacement for `grep` with higher speed and more options.
+`ack` is a search tool designed for code. It's built to be a replacement for
+`grep` with higher speed and more options.
 
 ## Installation
 
 To install the latest version, use homebrew.
 
 ```bash
-brew install ack
+$ brew install ack
 ```
 
 ## Why use `ack` over `grep`
@@ -20,24 +21,28 @@ brew install ack
 ## Usage
 
 ```bash
-ack [OPTION]... PATTERN [FILES OR DIRECTORIES]
+$ ack [OPTION]... PATTERN [FILES OR DIRECTORIES]
 ```
 
-Let's say you want to find all JavaScript files that are using the module `pancakes` in your project, with `ack` it's as easy as
+Let's say you want to find all JavaScript files that are using the module
+`pancakes` in your project, with `ack` it's as easy as
 ```sh
-ack --js pancakes
+$ ack --js pancakes
 ```
 
 Or you may want to find all files that _does not_ contain the word _brew_
 ```bash
-ack -L brew
+$ ack -L brew
 ```
 
 ## Customization
 
-You can customize `ack` to behave the way you want it to, this configuration is stored in `/.ackrc`.
+You can customize `ack` to behave the way you want it to, this configuration i
+s stored in `/.ackrc`.
 
-For example, you can add a custom type to use as a flag when searching. The following configuration will allow you to only search in `.md`, `.mkd` and `.markdown` files using the `--markdown` flag.
+For example, you can add a custom type to use as a flag when searching. The
+following configuration will allow you to only search in `.md`, `.mkd` and
+`.markdown` files using the `--markdown` flag.
 ```bash
 --type-set=markdown=.md,.mkd,.markdown
 ```
@@ -51,7 +56,7 @@ You can also tell ack to always sort and use colors in the result.
 To see what configuration `ack` uses you can use the `dump` flag.
 
 ```bash
-ack --dump
+$ ack --dump
 ```
 
 ## Alternatives to `ack`

iTerm/fzf.md

@@ -1,53 +1,57 @@
 # `fzf`
 
-[`fzf`](https://github.com/junegunn/fzf) is a general-purpose command-line fuzzy finder.
-
-## Why use `fzf`
-
- - Speed
- - Rich feature set
- - Highly customizable
+[`fzf`](https://github.com/junegunn/fzf) is a general-purpose command-line
+fuzzy finder. On it's own it's not very useful but when combined with other
+tools it becomes super powerful.
 
 ## Installation
 
-Use [homebrew](http://sourabhbajaj.com/mac-setup/Homebrew/README.html) to install `fzf`:
-
-    brew install fzf
-
-If you want to use shell extensions:
-
-    /usr/local/opt/fzf/install
-
-which are:
-
- - Key bindings (`CTRL-T`, `CTRL-R`, and `ALT-C`) (available for bash, zsh and fish)
- - Fuzzy auto-completion (available for bash and zsh)
+Use [homebrew](http://sourabhbajaj.com/mac-setup/Homebrew/README.html) to
+install `fzf`:
 
-## Usage
+    $ brew install fzf
 
-### Fuzzy completion
+If you want to use shell extensions (better shell integration):
 
->hit tab (↹) after:
+    $ /usr/local/opt/fzf/install
 
-#### File search
+which gives you:
 
-    vim **
+ - Key bindings (`CTRL-T`, `CTRL-R`, and `ALT-C`) (available for _bash_, _zsh_
+ and _fish_)
+ - Fuzzy auto-completion (available for _bash_ and _zsh_)
 
-or
+## Example Usages
 
-    subl **
+Add any of these functions to your shell configuration file and apply the
+changes to try them out. Or just paste the function in your terminal if you
+just want to try it out without saving it.
 
-#### Host name search
+```sh
+# fd - cd to selected directory
+fd() {
+  local dir
+  dir=$(find ${1:-.} -path '*/\.*' -prune \
+                  -o -type d -print 2> /dev/null | fzf +m) &&
+  cd "$dir"
+}
+```
 
-    ssh **
+```sh
+# fh - search in your command history and execute selected command
+fh() {
+  eval $( ([ -n "$ZSH_NAME" ] && fc -l 1 || history) | fzf +s --tac | sed 's/ *[0-9]* *//')
+}
+```
 
->**Note**: for more fuzzy search things head over [official repo](https://github.com/junegunn/fzf#fuzzy-completion-for-bash-and-zsh)
+**For more fuzzy search examples see the
+[official repo](https://github.com/junegunn/fzf#fuzzy-completion-for-bash-and-zsh).**
 
-### Chrome history from CLI
+### Chrome history from your terminal
 
->**Note**: original [blog post](https://junegunn.kr/2015/04/browsing-chrome-history-with-fzf/)
+**Note**: original [blog post](https://junegunn.kr/2015/04/browsing-chrome-history-with-fzf/)
 
-Open up shell config (most likely `~/.zshrc` or command `zshconfig`) and add following function:
+Open up your shell config and add following function:
 
 ```sh
 # ch - browse chrome history
@@ -66,4 +70,5 @@ ch() {
 }
 ```
 
->**Note**: Ensure that path to `History` file is correct; read more information on [StackOverflow](https://stackoverflow.com/a/16742333/1564365)
+**Note**: Ensure that path to `History` file is correct; read more information
+on [StackOverflow](https://stackoverflow.com/a/16742333/1564365).

iTerm/tree.md

@@ -7,7 +7,7 @@
 To install the latest version, use homebrew:
 
 ```bash
-brew install tree
+$ brew install tree
 ```
 
 ## Usage
@@ -42,7 +42,7 @@ Running `tree` will produce output like this:
 To limit the recursion you can pass an `-L` flag and specify the maximum depth `tree` will use when searching.
 
 ```bash
-tree -L 1
+$ tree -L 1
 ```
 will output: