root / pkpgcounter / trunk / README @ 235

Revision 235, 3.0 kB (checked in by jerome, 19 years ago)

Finished to move files around.
Removed any unneeded reference to the library's name.

  • 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 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=============================================================================
96
97Please e-mail bugs to : alet@librelogiciel.com (Jerome Alet)
Note: See TracBrowser for help on using the browser.