Skip to content

Commit b83c93b

Browse files
Update INSTALL.md
1 parent 59a9429 commit b83c93b

File tree

2 files changed

+74
-109
lines changed

2 files changed

+74
-109
lines changed

INSTALL

Lines changed: 0 additions & 109 deletions
This file was deleted.

INSTALL.md

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
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

Comments
 (0)