Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 0 additions & 109 deletions INSTALL

This file was deleted.

73 changes: 73 additions & 0 deletions INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# OpenPrinting libppd v2.0.0 Installation Guide


## Overview

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".

### Before You Begin

#### Prerequisites
- ANSI-compliant C and C++ compilers (tested with several versions of GCC)
- make program and POSIX-compliant shell (/bin/sh)
- GNU make recommended (especially for BSD users)

#### Dependencies
- libcups of CUPS 2.2.2 or newer
- libcupsfilters 2.0.0 or newer

### Compiling the GIT Repository Code
- libppd GIT repository does not include a pre-built configure script.
- Run GNU autoconf (2.65 or higher) to create it:
```
./autogen.sh
```

### Configuration
- Use the "configure" script in the main directory:
```
./configure
```
- Default installation path is "/usr".
- For custom installation path, use the "--prefix" option:
```
./configure --prefix=/some/directory
```
- Use `./configure --help` for all configuration options.
- Set environment variables for libraries in non-default locations.

### Building the Software
- Run `make` (or `gmake` for BSD systems) to build the software.

### Installing the Software
- After building, install the software with:
```
make install
```
- For BSD systems:
```
gmake install
```

### Packaging for Operating System Distributions
- libppd is for retro-fitting legacy CUPS drivers using PPD files.
- Needed if Printer Applications are installed as classic packages (RPM, DEB).
- Not required for Printer Application Snaps or for modern IPP printers only.

## Installing Required Tools

### For Debian/Ubuntu-based Systems
- Install C and C++ compilers, make, autoconf:
```
sudo apt-get install build-essential autoconf
```
- Install libcups and libcupsfilters

### For Red Hat/Fedora-based Systems
- Install C and C++ compilers, make, autoconf:
```
sudo dnf install gcc gcc-c++ make autoconf
```
- Install libcups and libcupsfilters:

Note: The above commands are for common Linux distributions. For other operating systems or distributions, refer to respective package management instructions.
2 changes: 1 addition & 1 deletion Makefile.am
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ doc_DATA = \
COPYING \
CHANGES.md \
CHANGES-1.x.md \
INSTALL \
INSTALL.md \
LICENSE \
NOTICE \
README.md \
Expand Down