[185] | 1 | # $Id$ |
---|
| 2 | |
---|
| 3 | pkpgcounter : a generic Page Description Language parser |
---|
| 4 | |
---|
| 5 | (c) 2005 Jerome Alet <alet@librelogiciel.com> |
---|
| 6 | This program is free software; you can redistribute it and/or modify |
---|
| 7 | it under the terms of the GNU General Public License as published by |
---|
| 8 | the Free Software Foundation; either version 2 of the License, or |
---|
| 9 | (at your option) any later version. |
---|
| 10 | |
---|
| 11 | This program is distributed in the hope that it will be useful, |
---|
| 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 14 | GNU General Public License for more details. |
---|
| 15 | |
---|
| 16 | You should have received a copy of the GNU General Public License |
---|
| 17 | along with this program; if not, write to the Free Software |
---|
| 18 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. |
---|
| 19 | |
---|
| 20 | ============================================================================= |
---|
| 21 | |
---|
| 22 | pkpgcounter is a generic Page Description Language parser. |
---|
| 23 | |
---|
| 24 | It 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 | When launched, pkpgcounter prints on its standard output a single |
---|
| 37 | integer representing the total number of pages in all the files |
---|
| 38 | which filenames you've passed on the command line. |
---|
| 39 | |
---|
| 40 | With no argument, or with a single dash in non-option arguments, |
---|
| 41 | pkpgcounter reads datas to parse from its standard input in addition |
---|
| 42 | to other non-options arguments which are treated as filenames |
---|
| 43 | representing the files to parse. |
---|
| 44 | |
---|
| 45 | In the future other possibilities will be added. |
---|
| 46 | |
---|
| 47 | ============================================================================= |
---|
| 48 | |
---|
| 49 | Installation : |
---|
| 50 | -------------- |
---|
| 51 | |
---|
| 52 | 0 - Download pkpgcounter from : |
---|
| 53 | |
---|
| 54 | http://www.librelogiciel.com/software/pkpgcounter/action_Presentation |
---|
| 55 | |
---|
| 56 | and extract it : |
---|
| 57 | |
---|
| 58 | $ tar -zxf pkpgcounter-x.yy.tar.gz |
---|
| 59 | |
---|
| 60 | where x.yy is pkpgcounter' version number. |
---|
| 61 | |
---|
| 62 | 1 - Copy the 'pkpgcounter' command into a directory present in your PATH. |
---|
| 63 | for example : |
---|
| 64 | |
---|
| 65 | $ cp pkpgcounter /usr/bin |
---|
| 66 | |
---|
| 67 | 2 - Use pkpgcounter : |
---|
| 68 | |
---|
| 69 | $ pkpgcounter file1.ps file2.pclxl ... <fileN.escp2 |
---|
| 70 | |
---|
| 71 | pkpgcounter will display the total size in pages of all the files |
---|
| 72 | passed on the command line. |
---|
| 73 | |
---|
| 74 | 3 - That's all ! |
---|
| 75 | |
---|
| 76 | ============================================================================= |
---|
| 77 | |
---|
| 78 | Troubleshooting : |
---|
| 79 | ----------------- |
---|
| 80 | |
---|
| 81 | If pkpgcounter gives incorrect results to you, please make an incorrectly |
---|
| 82 | parsed data file available to us on some website, and tell us which |
---|
| 83 | driver was used. |
---|
| 84 | |
---|
| 85 | ============================================================================= |
---|
| 86 | |
---|
| 87 | Please e-mail bugs to : alet@librelogiciel.com (Jerome Alet) |
---|