← Back to branch summary

~ubuntu-branches/ubuntu/raring/hplip/raring

« back to all changes in this revision

Viewing changes to debian/local/pyppd/README.txt

  • Committer: Package Import Robot
  • Author(s): Mark Purcell
  • Date: 2012-10-06 15:03:44 UTC
  • mfrom: (1.6.1) (20.1.16 quantal)
  • Revision ID: package-import@ubuntu.com-20121006150344-2p3xz26br0t3hu2q
Tags: 3.12.10-1
http://bugs.debian.org/683033
http://bugs.debian.org/687129
* New upstream release
  - Fixes "Network scanning fails (Closes: #683033)
* quilt refresh hplip-syslog-fix-debug-messages-to-error.dpatch
* Fix "error in clean build env" updated debian/rules (Closes: #687129)

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/local/pyppd/README.txt
1
 
pyppd
2
 
=====
3
 
 
4
 
``pyppd`` is a CUPS PPD generator. It holds an compressed archive of PPDs, which
5
 
can be listed and retrieved only when needed by CUPS, saving disk space.
6
 
 
7
 
Instalation
8
 
-----------
9
 
 
10
 
To install ``pyppd``, you can use:
11
 
 
12
 
  # pip install pyppd
13
 
 
14
 
Or download the source package, uncompress, and run as root:
15
 
 
16
 
  # python setup.py install
17
 
 
18
 
It depends on Python 2.x (http://www.python.org) and XZ Utils
19
 
(http://tukaani.org/xz/).
20
 
 
21
 
Usage
22
 
-----
23
 
 
24
 
At first, you have to create a PPD archive. For such, put all PPDs (they might
25
 
be gzipped) you want to add in the archive inside a single folder (which can
26
 
have subfolders), then run:
27
 
 
28
 
  $ pyppd /path/to/your/ppd/folder
29
 
 
30
 
It'll create ``pyppd-ppdfile`` in your current folder. You can test it by
31
 
running:
32
 
 
33
 
  $ ./pyppd-ppdfile list
34
 
 
35
 
And, for reading a PPD from the archive, simply do:
36
 
 
37
 
  $ ./pyppd-ppdfile cat pyppd-ppdfile:MY-PPD-FILE.PPD
38
 
 
39
 
For CUPS to be able to use your newly-created archive, copy ``pyppd-ppdfile``
40
 
to ``/usr/lib/cups/driver/`` and you're done.
41
 
 
42
 
The generated ``pyppd-ppdfile`` can be arbitrarily renamed, so that more than
43
 
one packed repository can be installed on one system. This can be useful if
44
 
you need a better performance, be it in time or memory usage. Note that also
45
 
the PPD URIs will follow the new name:
46
 
 
47
 
  $ ./pyppd-ppdfile list
48
 
 
49
 
  pyppd-ppdfile:LasterStar/LaserStar-XX100.ppd
50
 
 
51
 
  $ mv pyppd-ppdfile laserstar
52
 
 
53
 
  $ ./laserstar list
54
 
 
55
 
  laserstar:LaserStar/LaserStar-XX100.ppd
56
 
 
57
 
Contributors
58
 
------------
59
 
 
60
 
* **Till Kamppeter** - Original idea, mentoring and feedback. User #0.
61
 
 
62
 
* **Hin-Tak Leung** - Lots of technical suggestions.
63
 
 
64
 
* **Flávio Ribeiro** and **Diógenes Fernandes** - Refactorings and general Python's best practices tips.
65
 
 
66
 
* **Google's OSPO** - Initial funding at GSoC 2010.