From 2e71897c1c5e4939bf6ce412e6efaf6e30f6b76d Mon Sep 17 00:00:00 2001
From: mounaiban <29518031+mounaiban@users.noreply.github.com>
Date: Mon, 15 Aug 2022 06:19:17 +1000
Subject: [PATCH] Use more explicit installation summary

---
 INSTALL.git | 55 +++++++++++++++++++++++------------------------------
 1 file changed, 24 insertions(+), 31 deletions(-)

diff --git a/INSTALL.git b/INSTALL.git
index 9126afc..f809947 100644
--- a/INSTALL.git
+++ b/INSTALL.git
@@ -1,38 +1,31 @@
-# Building and Installing captdriver
+Building and Installing Captdriver From Git: TL;DR Version
 
-This software must be manually installed. The steps are fundamentally
-as follows:
+git clone https://github.com/mounaiban/captdriver.git captdriver
+cd captdriver
+aclocal
+autoconf
+automake --add-missing
+./configure
+make
+make ppd
+# the following commands must be run with superuser privileges
+make install
+cp -p /usr/local/bin/rastertocapt $(cups-config --serverbin)/filter/
+lpadmin -p $PRINTER_NAME -v $PRINTER_URI -P $PPD_FILE -E
+lpadmin -d $PRINTER_NAME
 
-1. Clone, download and extract the captdriver source to a designated
-   directory.
 
-2. Generate the required build files.
+** Notes **
 
-3. Run the generated configuration script `./configure` and initiate
-   the build process with `make`.
+The exact installation commands on your system may differ from the
+above example. For detailed instructions (and what to use in place of
+`$PRINTER_URI`), check out Mounaiban's Captdriver Wiki at:
 
-4. Install the driver on your operating system. The build process
-   produces a single binary named `rastertocapt`, which must be 
-   copied to the `filter/` directoy the CUPS directory.
+https://github.com/mounaiban/captdriver/wiki/Building-and-Installing-captdriver%3A-A-Unified-Guide
 
-   * *PROTIP*: Reveal the CUPS directory with `cups-config --serverbin`
+For security reasons, `rastertocapt` must be approprately locked down
+or it will not work; it must be owned by the `root` user
+with read-and-execute-only permissions to all other users. Please see
+this issue on the original repo for details:
 
-   * *PROTIP*: For security reasons, CUPS will only run filters that
-     are locked down: owned by the `root` user with read-and-execute-only
-     permissions to all other users. See this message on
-     [Issue #7](https://github.com/agalakhov/captdriver/issues/7#issuecomment-604221791) for details.
-
-5. Compile the PPD file, to introduce your printer to the CUPS 
-   daemon.
-
-6. Configure the CUPS daemon to use you printer. There are several
-   ways to achieve this.
-
-Detailed instructions are not included in this document, as the
-exact procedure will vary between operating systems, and depending
-on the approach which you take to install the driver.
-
-For detailed instructions, please see Mounaiban's captdriver Wiki
-at https://github.com/mounaiban/captdriver/wiki
-
-[wiki]: http://github.com/mounaiban/captdriver/wiki "Mounaiban's captdriver Project Wiki."
+https://github.com/agalakhov/captdriver/issues/7#issuecomment-604221791