Cleaned up build autotools and docs.

- not tracking autotools-generated files; people building
  from source should have autotools installed already
- added autogen.sh
- updated build notes

.gitignore

-# Ignore artifacts generated during configure.
+# Ignore autogen.sh generated artifacts
+Makefile.in
+aclocal.m4
+configure
+config.h.in
+autom4te.cache
 
-src/.deps/
-src/Makefile
-src/config.h
-src/config.status
-src/man/Makefile
-src/scripts/Makefile
-src/src/Makefile
-src/src/.deps
-src/stamp-h1
\ No newline at end of file
+# Devs should be configuring and building in the ./build directory
+build/

INSTALL

-===============================================================================
- logkeys keylogger - instalation instructions
-===============================================================================
+logkeys keylogger - installation instructions
+=============================================
 
 Provided your GNU/Linux distribution doesn't include logkeys package
 in its repositories, manual installation of logkeys from source is as
 easy as cloning this repo or [downloading a zip of the
 source](https://github.com/kernc/logkeys/archive/master.zip),
-unzipping, and building:
+unzipping, configuring, and building.
 
-    $ unzip logkeys-master.zip
-    $ cd logkeys-master/build
+Prerequisites
+-------------
+
+You need autotools to build the code from source:
+
+    apt-get update
+    apt-get install -y autotools
+
+Build and Install
+-----------------
+
+    $ unzip logkeys-master.zip     # or use git clone
+    $ cd logkeys-master
+
+    $ ./autogen.sh     # generate files for build
+    $ cd build         # keeps the root and src dirs clean
     $ ../configure
+
     $ make
     $ su               # get root to install in system
     $ make install     # installs binaries, manuals and scripts
 
 To uninstall logkeys, remove accompanying scripts and manuals:
 
-    # make uninstall    # in the same src dir
+    $ make uninstall    # in the same build dir
 
 See README file for usage instructions, troubleshooting and other notes.
+
+Cleaning after a build
+----------------------
+
+`autogen.sh` and `configure` generate many files which are ignored by
+git.  All of these files can be removed from the project, e.g. to
+force a clean build, with the following:
+
+    git clean -xdf

README.md

@@ -8,29 +8,10 @@ just seems to work. It relies on event interface of the Linux input subsystem.
 Once completely set, it logs all common character and function keys, while also
 being fully aware of Shift and AltGr key modifiers.
 
-
 Installation
 ------------
 
-Provided your GNU/Linux distribution doesn't include logkeys package
-in its repositories, manual installation of logkeys from source is as
-easy as cloning this repo or [downloading a zip of the
-source](https://github.com/kernc/logkeys/archive/master.zip),
-unzipping, and building:
-
-    $ unzip logkeys-master.zip
-    $ cd logkeys-master/build
-    $ ../configure
-    $ make
-    $ su               # get root to install in system
-    $ make install     # installs binaries, manuals and scripts
-
-To uninstall logkeys, remove accompanying scripts and manuals:
-
-    $ make uninstall    # in the same src dir
-
-A copy of these instructions is in the accompanying INSTALL file.
-
+See [INSTALL](./INSTALL) for installation/build notes.
 
 Usage how-to
 ------------

autogen.sh

+#! /bin/sh
+set -e
+
+# Use this script to bootstrap your build AFTER checking it out from
+# source control. You should not have to use it for anything else.
+
+# Runs autoconf, autoheader, aclocal, automake, autopoint, libtoolize
+echo
+echo "Regenerating autotools files ..."
+aclocal \
+&& autoheader \
+&& automake --add-missing \
+&& autoconf
+
+echo "... done.  Now please do the following:"
+echo
+echo "   cd build; ../configure; make; su; make install"
+echo

config.h.in

-/* config.h.in.  Generated from configure.ac by autoheader.  */
-
-/* Holds path to dumpkeys executable */
-#undef EXE_DUMPKEYS
-
-/* Holds path to grep executable */
-#undef EXE_GREP
-
-/* Holds path to ps executable */
-#undef EXE_PS
-
-/* Define to 1 if you have the `atoi' function. */
-#undef HAVE_ATOI
-
-/* Define to 1 if you have the <cassert> header file. */
-#undef HAVE_CASSERT
-
-/* Define to 1 if you have the <cerrno> header file. */
-#undef HAVE_CERRNO
-
-/* Define to 1 if you have the `close' function. */
-#undef HAVE_CLOSE
-
-/* Define to 1 if you have the <csignal> header file. */
-#undef HAVE_CSIGNAL
-
-/* Define to 1 if you have the <cstdio> header file. */
-#undef HAVE_CSTDIO
-
-/* Define to 1 if you have the <cstdlib> header file. */
-#undef HAVE_CSTDLIB
-
-/* Define to 1 if you have the <cstring> header file. */
-#undef HAVE_CSTRING
-
-/* Define to 1 if you have the <cwchar> header file. */
-#undef HAVE_CWCHAR
-
-/* Define to 1 if you have the `error' function. */
-#undef HAVE_ERROR
-
-/* Define to 1 if you have the `error_at_line' function. */
-#undef HAVE_ERROR_AT_LINE
-
-/* Define to 1 if you have the <error.h> header file. */
-#undef HAVE_ERROR_H
-
-/* Define to 1 if you have the `exit' function. */
-#undef HAVE_EXIT
-
-/* Define to 1 if you have the `fclose' function. */
-#undef HAVE_FCLOSE
-
-/* Define to 1 if you have the `feof' function. */
-#undef HAVE_FEOF
-
-/* Define to 1 if you have the `fflush' function. */
-#undef HAVE_FFLUSH
-
-/* Define to 1 if you have the `fgets' function. */
-#undef HAVE_FGETS
-
-/* Define to 1 if you have the `fgetws' function. */
-#undef HAVE_FGETWS
-
-/* Define to 1 if you have the `flock' function. */
-#undef HAVE_FLOCK
-
-/* Define to 1 if you have the `fopen' function. */
-#undef HAVE_FOPEN
-
-/* Define to 1 if you have the `fork' function. */
-#undef HAVE_FORK
-
-/* Define to 1 if you have the `fprintf' function. */
-#undef HAVE_FPRINTF
-
-/* Define to 1 if you have the `freopen' function. */
-#undef HAVE_FREOPEN
-
-/* Define to 1 if you have the `fscanf' function. */
-#undef HAVE_FSCANF
-
-/* Define to 1 if you have the `geteuid' function. */
-#undef HAVE_GETEUID
-
-/* Define to 1 if you have the `getgid' function. */
-#undef HAVE_GETGID
-
-/* Define to 1 if you have the <getopt.h> header file. */
-#undef HAVE_GETOPT_H
-
-/* Define to 1 if you have the `getopt_long' function. */
-#undef HAVE_GETOPT_LONG
-
-/* Define to 1 if you have the `getpid' function. */
-#undef HAVE_GETPID
-
-/* Define to 1 if you have the `getuid' function. */
-#undef HAVE_GETUID
-
-/* Define to 1 if you have the <inttypes.h> header file. */
-#undef HAVE_INTTYPES_H
-
-/* Define to 1 if you have the `kill' function. */
-#undef HAVE_KILL
-
-/* Define to 1 if you have the <linux/input.h> header file. */
-#undef HAVE_LINUX_INPUT_H
-
-/* Define to 1 if you have the `localtime' function. */
-#undef HAVE_LOCALTIME
-
-/* Define to 1 if you have the <memory.h> header file. */
-#undef HAVE_MEMORY_H
-
-/* Define to 1 if you have the `memset' function. */
-#undef HAVE_MEMSET
-
-/* Define to 1 if you have the `on_exit' function. */
-#undef HAVE_ON_EXIT
-
-/* Define to 1 if you have the `open' function. */
-#undef HAVE_OPEN
-
-/* Define to 1 if you have the `pclose' function. */
-#undef HAVE_PCLOSE
-
-/* Define to 1 if you have the `popen' function. */
-#undef HAVE_POPEN
-
-/* Define to 1 if you have the `read' function. */
-#undef HAVE_READ
-
-/* Define to 1 if you have the `remove' function. */
-#undef HAVE_REMOVE
-
-/* Define to 1 if you have the `setegid' function. */
-#undef HAVE_SETEGID
-
-/* Define to 1 if you have the `seteuid' function. */
-#undef HAVE_SETEUID
-
-/* Define to 1 if you have the `setlocale' function. */
-#undef HAVE_SETLOCALE
-
-/* Define to 1 if you have the `setsid' function. */
-#undef HAVE_SETSID
-
-/* Define to 1 if you have the `sigaction' function. */
-#undef HAVE_SIGACTION
-
-/* Define to 1 if you have the `sscanf' function. */
-#undef HAVE_SSCANF
-
-/* Define to 1 if you have the <sstream> header file. */
-#undef HAVE_SSTREAM
-
-/* Define to 1 if stdbool.h conforms to C99. */
-#undef HAVE_STDBOOL_H
-
-/* Define to 1 if you have the <stdint.h> header file. */
-#undef HAVE_STDINT_H
-
-/* Define to 1 if you have the <stdlib.h> header file. */
-#undef HAVE_STDLIB_H
-
-/* Define to 1 if you have the `strcat' function. */
-#undef HAVE_STRCAT
-
-/* Define to 1 if you have the `strcpy' function. */
-#undef HAVE_STRCPY
-
-/* Define to 1 if you have the `strerror' function. */
-#undef HAVE_STRERROR
-
-/* Define to 1 if you have the `strftime' function. */
-#undef HAVE_STRFTIME
-
-/* Define to 1 if you have the <strings.h> header file. */
-#undef HAVE_STRINGS_H
-
-/* Define to 1 if you have the <string.h> header file. */
-#undef HAVE_STRING_H
-
-/* Define to 1 if you have the `strlen' function. */
-#undef HAVE_STRLEN
-
-/* Define to 1 if you have the `strncat' function. */
-#undef HAVE_STRNCAT
-
-/* Define to 1 if you have the `swscanf' function. */
-#undef HAVE_SWSCANF
-
-/* Define to 1 if you have the <sys/file.h> header file. */
-#undef HAVE_SYS_FILE_H
-
-/* Define to 1 if you have the <sys/stat.h> header file. */
-#undef HAVE_SYS_STAT_H
-
-/* Define to 1 if you have the <sys/types.h> header file. */
-#undef HAVE_SYS_TYPES_H
-
-/* Define to 1 if you have the `time' function. */
-#undef HAVE_TIME
-
-/* Define to 1 if you have the `umask' function. */
-#undef HAVE_UMASK
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#undef HAVE_UNISTD_H
-
-/* Define to 1 if you have the `vfork' function. */
-#undef HAVE_VFORK
-
-/* Define to 1 if you have the <vfork.h> header file. */
-#undef HAVE_VFORK_H
-
-/* Define to 1 if you have the `wcscpy' function. */
-#undef HAVE_WCSCPY
-
-/* Define to 1 if you have the `wcslen' function. */
-#undef HAVE_WCSLEN
-
-/* Define to 1 if `fork' works. */
-#undef HAVE_WORKING_FORK
-
-/* Define to 1 if `vfork' works. */
-#undef HAVE_WORKING_VFORK
-
-/* Define to 1 if you have the `write' function. */
-#undef HAVE_WRITE
-
-/* Define to 1 if the system has the type `_Bool'. */
-#undef HAVE__BOOL
-
-/* Name of package */
-#undef PACKAGE
-
-/* Define to the address where bug reports for this package should be sent. */
-#undef PACKAGE_BUGREPORT
-
-/* Define to the full name of this package. */
-#undef PACKAGE_NAME
-
-/* Define to the full name and version of this package. */
-#undef PACKAGE_STRING
-
-/* Define to the one symbol short name of this package. */
-#undef PACKAGE_TARNAME
-
-/* Define to the home page for this package. */
-#undef PACKAGE_URL
-
-/* Define to the version of this package. */
-#undef PACKAGE_VERSION
-
-/* Define to 1 if you have the ANSI C header files. */
-#undef STDC_HEADERS
-
-/* Version number of package */
-#undef VERSION
-
-/* Define to `__inline__' or `__inline' if that's what the C compiler
-   calls it, or to nothing if 'inline' is not supported under any name.  */
-#ifndef __cplusplus
-#undef inline
-#endif
-
-/* Define to `int' if <sys/types.h> does not define. */
-#undef pid_t
-
-/* Define to `unsigned int' if <sys/types.h> does not define. */
-#undef size_t
-
-/* Define as `fork' if `vfork' does not work. */
-#undef vfork