summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
authorP. J. McDermott <pjm@nac.net>2012-01-20 01:29:53 (EST)
committer P. J. McDermott <pjm@nac.net>2012-01-20 01:29:53 (EST)
commit7a7ea92b9643f99c8c240a61b4a55ea7f40a0a78 (patch)
treed06ba7c418937ba31237a837c97c4e0a6315779a /INSTALL
parentdbfbbca94935b0fdbec3bf20dc78863e69597ed9 (diff)
Write installation documentation.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL37
1 files changed, 37 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..3dc4618
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,37 @@
+BASIC INSTALLATION
+==================
+
+This software package uses a build system similar to one generated by GNU
+Autoconf and Automake.
+
+The 'configure' shell script attempts to find certain system dependencies (e.g.
+a shell interpreter) and configure the package to be built and installed on the
+system. Upon successful dependency resolution and configuration, the script
+generates a 'Makefile' in your current working directory.
+
+The simplest way to configure, build, and install this package is:
+ 1. Run the 'configure' script from the source directory or any other directory.
+ For example, from the source directory you can run './configure'.
+ 2. Run 'make' to build the package. (Currently this does nothing, but this may
+ change in the future.)
+ 3. Run 'make install' to install the package. You will probably need superuser
+ privileges to install files into your system.
+
+To uninstall the package, you can run 'make uninstall'.
+
+
+OPTIONS
+=======
+
+The 'configure' script accepts certain command-line options to control package
+building and installation. Run the script with the '--help' option for more
+information.
+
+
+MACROS
+======
+
+The macro 'DESTDIR' affects the root directory into which the 'Makefile'
+installs the package. For example, you can install the package into a
+filesystem hierarchy under a directory named 'dest' in the current directory by
+running 'make DESTDIR=dest install'.