chore(README): move EXAMPLES to downgrade(8)

Author: pbrisbin

README.md

@@ -13,79 +13,7 @@ Install via the [AUR](https://aur.archlinux.org/packages/downgrade/).
 
 ## Usage
 
-```
-Usage: downgrade [option...] <pkg> [pkg...] [-- pacman_option...]
-
-Options:
-  --pacman        <command>
-                  pacman command to use, defaults to "pacman"
-  --pacman-conf   <path>
-                  pacman configuration file, defaults to "/etc/pacman.conf"
-  --pacman-cache  <path>
-                  pacman cache directory,
-                  default value(s) taken from pacman configuration file,
-                  or otherwise defaults to "/var/cache/pacman/pkg"
-  --pacman-log    <path>
-                  pacman log file,
-                  default value taken from pacman configuration file,
-                  or otherwise defaults to "/var/log/pacman.log"
-  --maxdepth      <integer>
-                  maximum depth to search for cached packages, defaults to 1
-  --ala-url       <url>
-                  location of ALA server, defaults to "https://archive.archlinux.org"
-  --ala-only      only use ALA server
-  --cached-only   only use cached packages
-  --ignore        <prompt|always|never>
-                  whether to add packages to IgnorePkg
-  --latest        pick latest matching version
-  --oldest        pick oldest matching version
-  --prefer-cache  do not query ala if a matching package was found in cache
-  --version       show downgrade version
-  -h, --help      show help script
-
-Note:
-  Options after the -- characters will be treated as pacman options.
-  See downgrade(8) for details.
-```
-
-Downgrade packages checking both local cache and the
-[A.L.A.](https://wiki.archlinux.org/index.php/Arch_Linux_Archive), which is the
-default behavior:
-
-```
-# downgrade foo bar
-```
-
-Downgrade packages, specifying multiple cache directories:
-
-```
-# downgrade --pacman-cache /path/to/cache --pacman-cache /path/to/other/cache foo bar
-```
-
-Downgrade a package with any of the following version-filtering operators `=`,
-`==`, `=~`, `<=`, `>=`, `<` and `>`:
-
-```
-# downgrade 'foo=1.0.0-1' 'bar>=1.2.1-1' 'baz=~^1.2'
-```
-
-Downgrade a package, looking in only local cache:
-
-```
-# downgrade --cached-only foo
-```
-
-Downgrade a package, looking in only the A.L.A.:
-
-```
-# downgrade --ala-only foo
-```
-
-Noninteractively downgrade foo to 1.0.0-1
-
-```
-# downgrade --latest --prefer-cache --ignore never 'foo=1.0.0-1'
-```
+See [downgrade(8)](https://archlinux-downgrade.github.io/downgrade/downgrade.8).
 
 ## Configuration
 

doc/downgrade.8.ronn

@@ -106,6 +106,33 @@ on the ALA.
   * `-h`, `--help`:
     Show help script.
 
+## EXAMPLES
+
+Downgrade packages checking both local cache and the A.L.A, which is the default
+behavior:
+
+    # downgrade foo bar
+
+Downgrade packages, specifying multiple cache directories:
+
+    # downgrade --pacman-cache /path/to/cache --pacman-cache /path/to/other/cache foo bar
+
+Downgrade a package with version-filtering:
+
+    # downgrade 'foo=1.0.0-1' 'bar>=1.2.1-1' 'baz=~^1.2'
+
+Downgrade a package, looking in only local cache:
+
+    # downgrade --cached-only foo
+
+Downgrade a package, looking in only the A.L.A.:
+
+    # downgrade --ala-only foo
+
+Non-interactively downgrade `foo` to `1.0.0-1`
+
+    # downgrade --latest --prefer-cache --ignore never 'foo=1.0.0-1'
+
 ## CONFIGURATION FILE
 
 Command-line options can be set persistently in