Skip to content

Commit

Permalink
Use more explicit installation summary
Browse files Browse the repository at this point in the history
  • Loading branch information
mounaiban committed Aug 14, 2022
1 parent bc9fd92 commit 2e71897
Showing 1 changed file with 24 additions and 31 deletions.
55 changes: 24 additions & 31 deletions INSTALL.git
Original file line number Diff line number Diff line change
@@ -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

0 comments on commit 2e71897

Please sign in to comment.