# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1718396957 0
# Node ID a91fb88a57b2c1a97cb475b583b54af9fbb8b061
# Parent  829e082793d03703859ac11ba00086154a2b086e
add INSTALL document

diff -r 829e082793d0 -r a91fb88a57b2 INSTALL
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL	Fri Jun 14 20:29:17 2024 +0000
@@ -0,0 +1,23 @@
+New Themyscira Wireless software components, as well as sw components that sit
+between FreeCalypso and ThemWi realms like the present package, use configure
+scripts - you need to run ./configure before running 'make'.  However, our
+configure script is hand-coded, not Autotools/autohell, hence there is no
+autoreconf nonsense involved.
+
+Standard --prefix, --exec-prefix and --bindir options are supported for
+changing the installation directory for the compiled binaries; the default
+prefix is /usr/local, following general FOSS community conventions.
+
+Choice of install location
+==========================
+
+If you are a FreeCalypso user, if you are installing the present package for
+the purpose of using it together with FC host tools and/or FC SIM tools, and
+you like the approach of having all FC components neatly compartmented under
+/opt/freecalypso (with /opt/freecalypso/bin added to your PATH), you can put
+these SMS utitilies in the same place by running configure like this:
+
+./configure --prefix=/opt/freecalypso
+
+OTOH, if you are someone who does not like and has never liked the scheme of
+FC binaries residing in /opt/freecalypso/bin, you can install wherever you like.