Make command line GNU-compatible

.gitignore

@@ -199,3 +199,7 @@ tests/Paket.Tests/NuGetConfig/PasswordConfig.xml
 paket.local
 dotnetcore
 .idea
+
+# For check-doc-links.sh.
+node_modules
+package-lock.json

Paket.sln

@@ -37,6 +37,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "content", "content", "{8E6D
 		docs\content\analyzers.md = docs\content\analyzers.md
 		docs\content\bootstrapper.md = docs\content\bootstrapper.md
 		docs\content\caches.md = docs\content\caches.md
+		docs\content\controlling-nuget-resolution.md = docs\content\controlling-nuget-resolution.md
 		docs\content\convert-from-nuget-tutorial.md = docs\content\convert-from-nuget-tutorial.md
 		docs\content\dependencies-file.md = docs\content\dependencies-file.md
 		docs\content\editor-support.md = docs\content\editor-support.md
@@ -49,13 +50,16 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "content", "content", "{8E6D
 		docs\content\http-dependencies.md = docs\content\http-dependencies.md
 		docs\content\index.md = docs\content\index.md
 		docs\content\installation.md = docs\content\installation.md
+		docs\content\license.md = docs\content\license.md
 		docs\content\local-file.md = docs\content\local-file.md
 		docs\content\lock-file.md = docs\content\lock-file.md
 		docs\content\nuget-dependencies.md = docs\content\nuget-dependencies.md
 		docs\content\paket-folder.md = docs\content\paket-folder.md
 		docs\content\paket.dependencies = docs\content\paket.dependencies
+		docs\content\paket.lock = docs\content\paket.lock
 		docs\content\reference-from-repl.fsx = docs\content\reference-from-repl.fsx
 		docs\content\references-files.md = docs\content\references-files.md
+		docs\content\release-notes.md = docs\content\release-notes.md
 		docs\content\resolver.fsx = docs\content\resolver.fsx
 		docs\content\template-files.md = docs\content\template-files.md
 		docs\content\testimonials.md = docs\content\testimonials.md
@@ -75,19 +79,22 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "commands", "commands", "{44
 	ProjectSection(SolutionItems) = preProject
 		docs\content\commands\add.md = docs\content\commands\add.md
 		docs\content\commands\auto-restore.md = docs\content\commands\auto-restore.md
-		docs\content\commands\clear-cache.md = docs\content\commands\clear-cache.md
 		docs\content\commands\config.md = docs\content\commands\config.md
 		docs\content\commands\convert-from-nuget.md = docs\content\commands\convert-from-nuget.md
 		docs\content\commands\find-package-versions.md = docs\content\commands\find-package-versions.md
 		docs\content\commands\find-packages.md = docs\content\commands\find-packages.md
 		docs\content\commands\find-refs.md = docs\content\commands\find-refs.md
 		docs\content\commands\generate-include-scripts.md = docs\content\commands\generate-include-scripts.md
+		docs\content\commands\generate-load-scripts.md = docs\content\commands\generate-load-scripts.md
+		docs\content\commands\install.md = docs\content\commands\install.md
 		docs\content\commands\outdated.md = docs\content\commands\outdated.md
 		docs\content\commands\pack.md = docs\content\commands\pack.md
 		docs\content\commands\remove.md = docs\content\commands\remove.md
+		docs\content\commands\restore.md = docs\content\commands\restore.md
 		docs\content\commands\show-installed-packages.md = docs\content\commands\show-installed-packages.md
 		docs\content\commands\simplify.md = docs\content\commands\simplify.md
 		docs\content\commands\update.md = docs\content\commands\update.md
+		docs\content\commands\why.md = docs\content\commands\why.md
 	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Paket.Bootstrapper.Tests", "tests\Paket.Bootstrapper.Tests\Paket.Bootstrapper.Tests.csproj", "{7C622582-E281-4EAB-AADA-B5893BB89B45}"

check-doc-links.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+set -e
+
+./build.sh GenerateDocs
+
+npm install http-server broken-link-checker
+node_modules/.bin/http-server docs/output --silent &
+printf 'Started web server PID %s\n' $!
+
+# Ignore errors to be able to kill the web server.
+node_modules/.bin/blc --get --recursive --filter-level 3 http://localhost:8080 || true
+
+[[ -n "$!" ]] && kill -9 $!

completion/.gitattributes

@@ -0,0 +1,3 @@
+* text=auto
+*.bash text=auto eol=lf
+*.zsh  text=auto eol=lf

completion/README.bash.md

@@ -0,0 +1,74 @@
+# Paket shell completion for [bash](https://www.gnu.org/software/bash/)
+
+## Installation
+
+### Download
+
+#### Option 1: Save the completion script to your home directory
+
+1. Download the
+   [`paket-completion.bash` file](https://raw.githubusercontent.com/fsprojects/Paket/master/completion/paket-completion.bash)
+   to a subdirectory of your home directory, preferably a directory with other
+   function files.
+1. `source` the file in your `~/.bashrc`.
+
+```sh
+$ target="$HOME/.bash-completions/paket-completion.bash"
+$ mkdir "$(dirname "$target")"
+$ curl --fail --location --proto-redir -all,https --output "$target" \
+  https://raw.githubusercontent.com/fsprojects/Paket/master/completion/paket-completion.bash
+```
+
+In your `~/.bashrc`:
+
+```sh
+source "$HOME/.bash-completions/paket-completion.bash"
+```
+
+#### Option 2: Save the completion script to `/etc/bash_completion.d/`
+
+1. Download the `paket-completion.bash` file to `/etc/bash_completion.d/`.
+1. Restart your shell.
+
+```sh
+$ target="/etc/bash_completion.d/paket-completion.bash"
+$ curl --fail --location --proto-redir -all,https --output "$target" \
+  https://raw.githubusercontent.com/fsprojects/Paket/master/completion/paket-completion.bash
+```
+
+### Updating an existing installation
+
+Just repeat the download from above.
+
+Alternatively the completion script comes bundled with the
+`paket-completion-update` function that will download the current
+`paket-completion.bash` to the same file as above, even if you changed its
+location after the initial download.
+
+**Please note:** The `paket-completion-update` function requires the completion
+script to be `source`d and `curl` to be installed.
+
+`paket-completion-update` supports an optional first parameter that allows you
+to override the default download root URL which is
+`https://raw.githubusercontent.com/fsprojects/Paket/master/completion`.
+
+### `paket` alias
+
+For easier consumption of Paket (without `paket.sh` or `paket.cmd`) it is
+advised to create an alias and always run Paket from the repository root.
+
+Also have a look at
+[Paket's magic mode](https://fsprojects.github.io/Paket/bootstrapper.html#Magic-mode).
+
+Somewhere in your `~/.bashrc`:
+
+```sh
+if [[ "$OS" != Windows* ]]; then
+  alias paket='mono ./.paket/paket.exe'
+else
+  alias paket='./.paket/paket.exe'
+fi
+
+# Complete the paket alias using the _paket function.
+complete -F _paket paket
+```

completion/README.md

@@ -0,0 +1,7 @@
+# Paket shell completion
+
+Currently we provide completion for the following shells:
+
+* [bash](README.bash.md) *-- currently only implements Paket subcommand
+  completion (e.g. `add`, `auto-restore`, ...)*
+* [zsh](README.zsh.md)