|
| 1 | + |
| 2 | +# OpenPrinting libppd v2.0.0 Installation Guide |
| 3 | +------------------------------------------------------------ |
| 4 | + |
| 5 | +## Overview |
| 6 | + |
| 7 | +This guide provides instructions for compiling and installing OpenPrinting libppd version 2.0.0 from source code. For more details, refer to "README.md" and for a change log, see "CHANGES.md". |
| 8 | + |
| 9 | +### Before You Begin |
| 10 | + |
| 11 | +#### Prerequisites |
| 12 | +- ANSI-compliant C and C++ compilers (tested with several versions of GCC) |
| 13 | +- make program and POSIX-compliant shell (/bin/sh) |
| 14 | +- GNU make recommended (especially for BSD users) |
| 15 | + |
| 16 | +#### Dependencies |
| 17 | +- libcups of CUPS 2.2.2 or newer |
| 18 | +- libcupsfilters 2.0.0 or newer |
| 19 | + |
| 20 | +### Compiling the GIT Repository Code |
| 21 | +- libppd GIT repository does not include a pre-built configure script. |
| 22 | +- Run GNU autoconf (2.65 or higher) to create it: |
| 23 | + ``` |
| 24 | + ./autogen.sh |
| 25 | + ``` |
| 26 | + |
| 27 | +### Configuration |
| 28 | +- Use the "configure" script in the main directory: |
| 29 | + ``` |
| 30 | + ./configure |
| 31 | + ``` |
| 32 | +- Default installation path is "/usr". |
| 33 | +- For custom installation path, use the "--prefix" option: |
| 34 | + ``` |
| 35 | + ./configure --prefix=/some/directory |
| 36 | + ``` |
| 37 | +- Use `./configure --help` for all configuration options. |
| 38 | +- Set environment variables for libraries in non-default locations. |
| 39 | + |
| 40 | +### Building the Software |
| 41 | +- Run `make` (or `gmake` for BSD systems) to build the software. |
| 42 | + |
| 43 | +### Installing the Software |
| 44 | +- After building, install the software with: |
| 45 | + ``` |
| 46 | + make install |
| 47 | + ``` |
| 48 | +- For BSD systems: |
| 49 | + ``` |
| 50 | + gmake install |
| 51 | + ``` |
| 52 | + |
| 53 | +### Packaging for Operating System Distributions |
| 54 | +- libppd is for retro-fitting legacy CUPS drivers using PPD files. |
| 55 | +- Needed if Printer Applications are installed as classic packages (RPM, DEB). |
| 56 | +- Not required for Printer Application Snaps or for modern IPP printers only. |
| 57 | + |
| 58 | +## Installing Required Tools |
| 59 | + |
| 60 | +### For Debian/Ubuntu-based Systems |
| 61 | +- Install C and C++ compilers, make, autoconf: |
| 62 | + ``` |
| 63 | + sudo apt-get install build-essential autoconf |
| 64 | + ``` |
| 65 | +- Install libcups and libcupsfilters |
| 66 | + |
| 67 | +### For Red Hat/Fedora-based Systems |
| 68 | +- Install C and C++ compilers, make, autoconf: |
| 69 | + ``` |
| 70 | + sudo dnf install gcc gcc-c++ make autoconf |
| 71 | + ``` |
| 72 | +- Install libcups and libcupsfilters: |
| 73 | + |
| 74 | +Note: The above commands are for common Linux distributions. For other operating systems or distributions, refer to respective package management instructions. |
0 commit comments