install target custom

README.md

@@ -47,6 +47,7 @@ Other targets:
 
     make clean          # remove solo and solo-static
     make install        # install to $(PREFIX)/bin, default /usr/local/bin
+    make installdir     # print the directory install would use
     make uninstall      # remove the installed binaries
     make static-deps    # build the static curl and c-ares archives, see below
 
@@ -131,6 +132,24 @@ two problem archives are built from source here.
 
 Remember to put `~/.local/bin` on your `PATH` if you install there.
 
+`install` takes any location you name, so nothing has to be patched to install
+somewhere unusual:
+
+    make install BINDIR=/opt/solo/bin   # an explicit directory
+    make install DIR=/opt/solo/bin      # the same, spelled in one macro
+    make install DIR=~/.local/bin       # a leading ~ is expanded by the shell
+    make install DIR="$HOME/bin"        # spaces in the path are fine
+    make install INSTALL="install -C"   # a different install program
+    make installdir DIR=/opt/solo/bin   # prints /opt/solo/bin, installs nothing
+
+`DIR` wins over `BINDIR`, and `DESTDIR` is prepended to either, so
+`make install DESTDIR=/tmp/pkg DIR=/usr/bin` stages into `/tmp/pkg/usr/bin`.
+`make uninstall` resolves the location the same way, so pass the same macros to
+undo an install: `make uninstall DIR=~/.local/bin`.
+
+`solo-static` is installed alongside `solo` when it has been built
+(`make static`). To install only that one, use `make install-static`.
+
 ## Run
 
     ./solo