root / pkpgcounter / trunk / README @ 328

Revision 303, 4.3 kB (checked in by jerome, 19 years ago)

Changed copyright years.
v1.74 is out

  • Property svn:keyword set to Auth Date Id Rev
  • Property svn:keywords set to Auth Date Id Rev
Line 
1# $Id$
2
3pkpgcounter : a generic Page Description Language parser
4
5(c) 2003, 2004, 2005, 2006 Jerome Alet <alet@librelogiciel.com>
6This program is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation; either version 2 of the License, or
9(at your option) any later version.
10
11This program is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with this program; if not, write to the Free Software
18Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19
20=============================================================================
21
22pkpgcounter is a generic Page Description Language parser.
23
24It can currently compute the number of pages in several types of files :
25
26        - PostScript (both DSC compliant and binary)
27       
28        - PDF
29       
30        - PCL3/4/5
31       
32        - PCLXL (aka PCL6)
33       
34        - ESC/P2
35       
36        - DVI
37       
38        - TIFF
39       
40        - OpenOffice.org Writer
41       
42        - OpenOffice.org Impress
43       
44When launched, pkpgcounter prints on its standard output a single
45integer representing the total number of pages in all the files
46which filenames you've passed on the command line.
47
48With no argument, or with a single dash in non-option arguments,
49pkpgcounter reads datas to parse from its standard input in addition
50to other non-options arguments which are treated as filenames
51representing the files to parse.
52
53In the future other possibilities will be added.       
54
55=============================================================================
56
57Installation :
58--------------
59
60  0 - Download pkpgcounter from :
61 
62        http://www.librelogiciel.com/software/pkpgcounter/action_Presentation
63       
64      and extract it : 
65     
66        $ tar -zxf pkpgcounter-x.yy.tar.gz
67       
68        where x.yy is pkpgcounter' version number.
69       
70  1 - Run the installation script :
71     
72        $ python setup.py install
73       
74      This will usually install the pkpgcounter into /usr/bin and 
75      the library into /usr/lib/python2.?/site-packages/pkpgpdls/
76       
77  2 - Use pkpgcounter :
78 
79      $ pkpgcounter file1.ps file2.pclxl ... <fileN.escp2
80     
81      pkpgcounter will display the total size in pages of all the files
82      passed on the command line.
83     
84  3 - That's all !   
85 
86=============================================================================
87
88Troubleshooting :
89-----------------
90
91  If pkpgcounter gives incorrect results to you, please make an incorrectly
92  parsed data file available to us on some website, and tell us which
93  driver was used.
94 
95  If pkpgcounter complain about your system lacking the Python Psyco module,
96  please consider installing it to speedup file parsing. However, don't forget
97  that Psyco currently only runs on the 32 bits x86 platform, so no need to
98  install it if you've got another system type.
99 
100=============================================================================
101
102The PCL3/4/5 parser included in pkpgcounter is a Python backport of an early
103release of the PCLCount software by Eduardo Gielamo Oliveira and Rodolfo Broco
104Manin.
105
106Although this IS NOT needed for pkpgcounter to work, you can download the
107original PCLCount software from :
108
109    http://www.fea.unicamp.br/pclcount/
110   
111Their software is distributed under either the terms of a BSD-like license,   
112or the terms of the GNU General Public License of the Free Software Foundation.
113   
114Over time both software evolved following different paths, and the accounting
115results they give may differ depending on the printer driver being used.
116We know that pkpgcounter's PCL3/4/5 parser sometimes is not accurate,
117and we are working on improving the situation. We currently don't know how
118PCLCount would behave with the same input files.
119
120pkpgcounter's PCLXL (aka PCL6) parser doesn't originate from PCLCount, but
121was written from scratch.
122
123=============================================================================
124
125Please e-mail bugs to : alet@librelogiciel.com (Jerome Alet)
Note: See TracBrowser for help on using the browser.