From 86b289d3c0a5ac77af79e3929d03726d05fddf09 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@member.fsf.org>
Date: Mon, 7 Dec 2015 22:52:34 +0100
Subject: add installing
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>
---
 INSTALLING | 105 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 105 insertions(+)
 create mode 100644 INSTALLING

(limited to 'INSTALLING')

diff --git a/INSTALLING b/INSTALLING
new file mode 100644
index 0000000..ce0e1df
--- /dev/null
+++ b/INSTALLING
@@ -0,0 +1,105 @@
+For most users the following should be sufficient:
+
+	make
+	make install DESTDIR="pkg"  # install to ./pkg temporarily instead
+	                            # of to /, installed files can then be
+	                            # moved by root.
+
+Note however, `make install` will not run `install-info'
+to add the info manual to `info '(dir)'`. Distributors
+should postinstall and preuninstall commands:
+
+	infodir="usr/share/info"
+	
+	post_install() {
+	  install-info -- "${infodir}/scrotty.info" "${infodir}/dir"
+	}
+	
+	post_upgrade() {
+	  post_install "$1"
+	}
+	
+	pre_uninstall() {
+	  install-info --delete -- "${infodir}/scrotty.info" "${infodir}/dir"
+	}
+
+If you want to install absolutely everything, you can
+instead use the commands below:
+
+	make everything
+	make install-everything DESTDIR="pkg"
+
+Or if you only want to absolute basics:
+
+	make base
+	make install-base DESTDIR="pkg"
+
+
+────────────────────────────────────────────────────────────────────────────────
+INTERNATIONALISATION
+────────────────────────────────────────────────────────────────────────────────
+
+If you want to do not want internationalisation build and install
+with WITHOUT_GETTEXT=1. For example:
+
+	make base WITHOUT_GETTEXT=1
+	make install-base WITHOUT_GETTEXT=1 DESTDIR="pkg"
+
+You can also chose to restrict the locales to install:
+
+	make all LOCALES=sv
+	make install LOCALES=sv DESTDIR="pkg"
+
+
+────────────────────────────────────────────────────────────────────────────────
+CUSTOMISED COMPILATION
+────────────────────────────────────────────────────────────────────────────────
+
+If you do not have GCC, you may want to set WARN to an empty string:
+
+	make WARN=
+
+The makefile is configured to compile the C code with -O2, you can
+change this by setting OPTIMISE:
+
+	make OPTIMISE="-Og -g"
+
+If you want to build the package with another prefix the /usr, set
+PREFIX:
+
+	make PREFIX=/usr/local
+
+See the beginning of the Makefile for further file system hierarchy
+customisations. These changes, including PREFIX, should be used both
+when compiling and installing.
+
+
+────────────────────────────────────────────────────────────────────────────────
+CUSTOMISED INSTALLATION
+────────────────────────────────────────────────────────────────────────────────
+
+You can select freely what parts of the package to install and not
+to install. This rules are available:
+
+┌─────────────┬─────────────────────┬────────────────────────────────────────────┐
+│ COMPILATION │ INSTALLATION        │ DESCRIPTION                                │
+├─────────────┼─────────────────────┼────────────────────────────────────────────┤
+│ base        │ install-base        │ Install be basics:                         │
+│   cmd       │   install-cmd       │   Install the scrotty command.             │
+│             │   install-copyright │   Install legal documents:                 │
+│             │     install-copying │     Install copyright notice.              │
+│             │     install-license │     Install the GNU GPL version 3.         │
+│ doc         │ install-doc         │ Include all manuals:                       │
+│   info      │   install-info      │   Include info manual. (Texinfo)           │
+│   dvi       │   install-dvi       │   Include DVI manual. (Texinfo)            │
+│   pdf       │   install-pdf       │   Include PDF manual. (Texinfo)            │
+│   ps        │   install-ps        │   Include PostScript manual. (Texinfo)     │
+│   html      │   install-html      │   Include multifile HTML manual. (Texinfo) │
+│             │   install-man       │   Include man page.                        │
+│ locale      │ install-locale      │ Include locales.                           │
+└─────────────┴─────────────────────┴────────────────────────────────────────────┘
+
+install, install-everything, install-base, and install-cmd, have alternatives
+that installs a stripped binary: install-strip, install-everything-strip,
+install-base-strip, and install-cmd-strip, respectively.
+
-- 
cgit v1.2.3-70-g09d2