root / pykota / tags / 1.24HotFix3 / NEWS @ 2915

Revision 2915, 78.7 kB (checked in by jerome, 18 years ago)

3rd HotFix? ready

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1# $Id$
2
3PyKota - Print Quotas for CUPS and LPRng
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
22PyKota NEWS :
23       
24    - 1.24HotFix3 (2006-06-03) :
25   
26        - Fixed minor issues with pkipplib's usage.
27       
28        - Fixed MySQL schema to workaround some "features"...
29       
30        - Introduced the 'askconfirmation' directive to interact with
31          the end user through any script (pknotify is recommended)
32          and see if he really wants to print when knowing the cost
33          of the job.
34         
35        - Now uses pkipplib if present to directly retrieve the job
36          information from the CUPS server over IPP.
37         
38        - Added a lock to ensure that a single cupspykota backend
39          is processing datas for a particular print queue at any
40          given time.
41         
42        - Now exports more environment variables for the subprocesses.
43         
44        - Fixed some problems with DateTime objects.
45       
46        - Added support for PySNMP v4.x in addition to 3.4.x.
47       
48        - Make the MySQL schema work with old releases of MySQL.
49       
50        - Fixed several character encoding problems.
51         
52        - Ensures that the denied banners counter is properly initialized
53          with relationnal databases.
54         
55    - 1.24 (2006-04-08) :
56   
57        - Improved documentation and packaging stuff.
58       
59    - 1.24beta (2006-03-26) :
60   
61        - Finalized the pknotify command.
62       
63        - Updated the messages catalogs for translations.
64       
65    - 1.24alpha18 (2006-03-15) :
66   
67        - Now uses MIME encapsulation for email messages to avoid
68          some problems with 8 bits messages being rejected.
69         
70    - 1.24alpha17 (2006-03-06) :
71   
72        - Fixed a major problem in the PostgreSQL backend.
73       
74        - pknotify can now check a remote user's name and password.
75       
76    - 1.24alpha16 (2006-03-02) :
77   
78        - Introduced the pknotify command line tool to dialog
79          with remote PyKotIcon applications.
80         
81    - 1.24alpha15 (2006-03-02) :
82       
83        - optimized pkbcodes, pkprinters and pkusers using edpykota as
84          the model.
85       
86        - 'edpykota --list' and 'pkusers --list' are now authorized
87          to mere mortal users, but the list is restricted to informations
88          about the current user.
89       
90        - Extended the functionnality of the 'onbackenderror' directive to
91          allow for configurable retries.
92         
93    - 1.24alpha14 :
94   
95        - Finished optimizations in edpykota and fixed some minor
96          problems with LDAP.
97         
98    - 1.24alpha13 :
99   
100        - Introduced the pkusers command line tool to manage users and 
101          users groups. This command doesn't deal with print quota entries,
102          which continue to be managed through the edpykota command line
103          tool.
104         
105        - Major rewrite and incompatible changes to command line options
106          in edpykota. This command now only deals with print quota
107          entries. Printers, users (or users groups) now have to be created
108          first using pkprinters or pkusers.
109         
110    - 1.24alpha12 :
111   
112        - Introduced the 'duplicatesdelay' directive to specify after
113          which duration two duplicate jobs are not considered duplicate
114          jobs anymore.
115         
116        - Introduced the 'balancezero' directive to specify any value 
117          as the balance limit instead of 0.0. This can allow admins to
118          give a few free credits to users, for example.
119         
120    - 1.24alpha11 :
121   
122        - Huge speed improvements when modifying billing codes and
123          printers.
124       
125        - Both pkbcodes and pkprinters now display the percent done
126          for all actions.
127         
128        - The pkinvoice invoice generator command line utility is now
129          included.
130         
131    - 1.24alpha10 :   
132   
133        - Huge speed improvements when deleting users, printers, and
134          billing codes.
135         
136    - 1.24alpha9 :
137   
138        - Preliminary support for MySQL, thanks to Matt Hyclak.
139       
140    - 1.24alpha8 :
141   
142        - The 'preaccounter' configuration directive was introduced to control
143          which parser to use for precomputation of the job's size. When unset,
144          the internal parser is used just like it was previously. See
145          conf/pykota.conf.sample for more details.
146         
147        - Now subprocesses launched through the overwrite_jobticket directive
148          can also output 'CANCEL', to represent the user's own choice to
149          cancel the print job.
150         
151    - 1.24alpha7 :
152     
153        - pkbanner now handles new print limiting modes correctly.
154       
155        - The cupspykota backend wrapper now accepts to be interrupted
156          with a kill -INT. This causes an immediate and clean abort
157          of the current print job.
158         
159        - Matt Hyclak contributed the possibility to store the printing
160          history in a MySQL database. See the contributed/ directory
161          for details.
162         
163        - Added 2006 to the copyright's years.
164       
165    - 1.24alpha6 :
166   
167        - Fixed internal SNMP and PJL handling code for very fast
168          printers : PyKota didn't see them going from 'idle'
169          to 'printing' to 'idle' again.
170         
171        - Now waitprinter.sh accepts SNMP version number and
172          community name as arguments, thanks to Brandon
173          Holbrook.
174         
175        - Now command line errors and Ctrl+C repectively cause
176          PyKota commands to exit with status -2 and -3.
177         
178    - 1.24alpha5 :
179   
180        - All command line tools now accept -A | --arguments filename.args
181          as a way to bypass the shell's maximal command line size :
182          just put each argument on a line by itself in a file, and
183          pass the file's name as the -A | --arguments command line
184          option's argument. For now this won't be documented in
185          commands' helps.
186         
187        - dumpykota can now dump the complete database in XML
188          format.
189         
190    - 1.24alpha4 :
191   
192        - Added support for the SQLite3 backend.
193          See pykota/initscripts/sqlite/README.sqlite
194       
195    - 1.24alpha3 :
196   
197        - Fix for mailandpopup.sh : smbstatus can't be run setuid,
198          so we regain priviledges before running an external
199          mailto directive.
200       
201    - 1.24alpha2 :
202   
203        - Introduce the "onbackenderror" directive in pykota.conf, to
204          control if the user must be charged or not whenever a real
205          CUPS backend fails. The default value is 'nocharge'.
206          Set it to 'charge' if you think your users can cause a CUPS
207          backend to fail.
208         
209        - Now mark original backends related problems as such in the
210          printing history. Modified printquota.cgi and pykota.css
211          to make them be more visible.
212         
213    - 1.24alpha1 :
214   
215        - Fixed a problem which caused backend errors to be ignored.
216       
217        - The sample LDIF file now contains the two necessary user
218          entries to have an LDAP PyKota Admin and an LDAP PyKota
219          ReadOnly user. The sample configuration files were updated
220          to contain the default passwords used in the LDIF file.
221         
222        - dumpykota is now more strict when checking arguments.   
223       
224    - 1.23 :
225   
226        - Many minor bug fixes and code cleaning.
227       
228        - Improved documentation.
229       
230        - Added Polish translation.
231       
232        - Improved French and Swedish translations.
233       
234    - 1.23beta :
235   
236        - Now the mailto directive is honored in all cases where the job is
237          denied or a warning has to be issued, and the correct reason
238          can be sent back to the user.
239         
240        - The PYKOTAREASON environment variable, if defined, contains the 
241          textual reason why the job was denied or a warning has to be
242          issued.
243       
244    - 1.23alpha31 :
245   
246        - Added support for --maxjobsize, --passthrough and --nopassthrough
247          in pkprinters. These modes are now also honored when printing.
248         
249        - Allows the admin to restrict the number of print queues which will
250          be treated by pkturnkey by passing queues' names as additionnal
251          arguments on pkturnkey's command line.
252         
253        - pkturnkey now supersedes pkhint with the help of the -c | --doconf
254          command line option.   
255         
256    - 1.23alpha30 :
257   
258        - Database changes : you MUST use upgrade-to-1.23.sql again if you
259          use PostgreSQL, or copy the new schema and restart your LDAP
260          server if you use LDAP.
261         
262        - The -C | --comment command line switch was added to edpykota to 
263          attach textual information to modifications done to a user's
264          account balance.
265         
266        - The -l | --limitby command line switch to edpykota was modified 
267          to allow 'noquota', 'nochange', and 'noprint'. See the edpykota
268          command's help or manual page for details.
269         
270        - The -i | --ingroups command line switch to repykota allows 
271          PyKota Administrators to only lists members of the specified
272          group or groups (separated with commas).
273         
274        - The -I | --increase command line switch to edpykota allows
275          to increase or decrease page limits.
276         
277        - Added the precomputed job's size and price to the history
278          for controlling purpose.
279       
280    - 1.23alpha29 :
281   
282        - Fixed a small problem with billing codes.
283       
284        - Exports some environment variables earlier, to render the script
285          launched by the overwrite_jobticket directive more powerful.
286         
287        - Now autopykota also creates print quota entries for the user on the
288          printers groups the current printer is a member of.
289         
290    - 1.23alpha28 :
291   
292        - Added users groups management to pkturnkey.
293       
294        - Fixed umask in setup script.
295       
296    - 1.23alpha27 :
297   
298        - Replaced the --dryrun command line option by the --force
299          command line option in pkturnkey, with exactly the opposite
300          effect (for security reasons).
301         
302    - 1.23alpha26 :
303   
304        - Allows parametrized pjl and snmp hardware accounting methods,
305          to be able to respectively set the TCP port and the SNMP
306          community.
307         
308    - 1.23alpha25 :
309   
310        - Added a --dryrun command line switch to pkturnkey.
311       
312        - Improved pkturnkey's general usability.
313       
314        - Added a manpage for pkturnkey.
315       
316    - 1.23alpha24 :
317   
318        - Allows different databases to be used depending on the
319          user's rights. This allows PyKota admins to directly
320          use a master LDAP server for read+write, while letting
321          normal users using the replicas for readonly access.
322          NB : using different storage backends is also possible,
323          but you're on your own there.
324         
325    - 1.23alpha23 :
326   
327        - Fixed a problem with banner accounting.
328   
329        - Introduction of the new 'pkturnkey' command line tool.
330       
331    - 1.23alpha22 :
332   
333        - The cupspykota backend was almost entirely rewritten from scratch.
334          It's now much more readable, maintainable, etc...
335         
336        - LPRng support is OFFICIALLY dropped for now. LPRng users are 
337          advised to download earlier releases or purchase the
338          PyKota v1.22HotFix1 Official release. LPRng support
339          MIGHT be re-added later.
340       
341    - 1.23alpha21 :
342     
343        - Fix for IPP requests which contain more than a single
344          job-originating-host-name attribute.
345         
346    - 1.23alpha20 :
347   
348        - Added the overwrite_jobticket directive. See pykota.conf.sample
349          for how to use it.
350         
351    - 1.23alpha19 :
352   
353        - Fixed an LDAP filtering problem when managing billing codes.
354       
355        - Added the unknown_billingcode directive. See pykota.conf.sample
356          for how to use it.
357       
358    - 1.23alpha18 :
359     
360        - Added the dump_bfd.php contribution.
361       
362        - Several fixes in the internal PJL accounter.
363       
364        - Now autopykota doesn't create unneeded print quota entries anymore.
365       
366        - Increased the timeout in the PJL hardware accounting code to
367          accomodate some printers (HP5000 at least).
368         
369    - 1.23alpha17 :
370   
371        - pkpgcounter is now distributed separately only. This
372          means that people must now download and install pkpgcounter
373          v1.56 or higher prior to being able to run PyKota.
374         
375        - Removed all the autoconf/automake stuff which was outdated 
376          and confusing.
377         
378    - 1.23alpha16 :
379     
380        - Extracted the GPL blurb from all commands' help, and use
381          a static version only once. This saves space big time, and
382          eases future translations.
383         
384    - 1.23alpha15 :
385   
386        - pkbcodes now works with the PostgreSQL backend.
387          NB : PLEASE RUN upgrade-to-1.23.sql AGAIN !!!
388       
389    - 1.23alpha14 :
390   
391        - Logs a warning when the user/group doesn't exist when running
392          edpykota.
393         
394    - 1.23alpha13 :
395   
396        - Minor fix for user groups because of latest database changes.
397       
398    - 1.23alpha12 :
399   
400        - Big database changes, use the migration scripts !
401       
402    - 1.23alpha11 :
403   
404        - Small fix to the PCL3/4/5 parser for some drivers.
405       
406    - 1.23alpha10 :
407   
408        - Fixed a bad exception name in cupspykota when parsing IPP messages.
409       
410        - Improved the IPP messages module : it can now generate IPP messages
411          in addition to parsing them.
412       
413    - 1.23alpha9 :   
414   
415        - The denyduplicates directive now accepts a command line as an
416          argument beside yes/no. The command is launched and must
417          print either ALLOW or DENY to its standard output. Then the
418          job gets allowed or denied by PyKota.
419          This will allow user interaction in the near future.
420         
421        - Introduced the new 'striptitle' directive to remove ugly prefixes
422          from print job's titles whenever a new print job is submitted.
423         
424        - Fixed internal SNMP accounter for printers which only have a life time
425          page counter, and not a volatile page counter.
426         
427    - 1.23alpha8 :
428   
429        - The data dumper can now summarize payments and history with the
430          help of the --sum command line option (or checkbox in the CGI).
431         
432        - The message used when the job's filename, title and options are
433          hidden because of the privacy directive is now translated at
434          retrieval time, instead of at saving time.
435         
436        - Minor fix in the LDAP backend code. 
437         
438    - 1.23alpha7 :
439   
440        - Improvements to the internal PJL and SNMP accounter : now should
441          support more printers and waste less time.
442         
443    - 1.23alpha6 :
444   
445        - The data dumper's start= and end= date filtering options now
446          accept a positive or negative offset to be added to the special
447          keywords 'yesterday', 'today', 'now', 'tomorrow'.
448          e.g. : dumpykota --data history start=yesterday-5 end=today
449         
450    - 1.23alpha5 :
451   
452        - The data dumper's start= and end= date filtering options now accept
453          the special keywords 'yesterday', 'today', 'now' and 'tomorrow'.
454         
455    - 1.23alpha4 :
456   
457        - The data dumper now accept start= and end= to specify the starting
458          and ending dates to dump the history.
459         
460    - 1.23alpha3 :
461   
462        - The destination link for the logo used in CGI scripts is
463          configurable.
464         
465        - Data dumper improved : it's faster and now datas are correctly
466          escaped.
467       
468        - The URL to the logo displayed in the CGI scripts is configurable.
469       
470    - 1.23alpha2 :
471   
472        - Fixed edpykota --prototype with balance.
473       
474        - Major rewrite of the IPP message parsing code to definitely
475          fix the job-originating-hostname IPP attribute problem.
476       
477    - 1.23alpha1 :   
478   
479        - Sets current username to the user CUPS runs as instead of "root"
480          when printing test pages from CUPS' web interface (because
481          the username is empty in this case).
482         
483        - Fix for strange values in job-originating-hostname
484       
485    - 1.22 :
486   
487        - Big improvements to the documentation.
488       
489    - 1.22beta :
490   
491        - Improved stability in pykotme and pykotme.cgi.
492       
493        - Fixed a permission problem in pykotme and pykosd.
494       
495        - Fixed an inconsitency between SQL and LDAP backends'
496          behavior in edpykota.
497         
498        - Improved stability and allowed tracebacks in CGI scripts.
499       
500        - Improved pykotme.cgi
501         
502    - 1.22alpha8 :
503   
504        - Fixed history retrieval for nonexisting printers or users.
505       
506        - Clicking on the billing code in printquota.cgi's job history
507          now shows all jobs matching this billing code.
508         
509        - Fixed the dump in CUPS' page_log format which didn't
510          dump the oldest entry.
511         
512        - The data dumper now accepts billingcode= and hostname= as
513          filters when dumping the job history.
514         
515        - The job billing code if present is now saved into the database,
516          and exported to subprocesses as the PYKOTAJOBBILLING environment
517          variable.
518         
519        - Ctrl+C now makes PyKota commands exit without a traceback.
520       
521        - Fixed an i18n problem with Python 2.1
522       
523    - 1.22alpha7 :
524   
525        - Fixed some problems with the retrieval of the history from LDAP.
526       
527    - 1.22alpha6 :
528   
529        - Early errors now produce meaningful error messages (finally !)
530       
531    - 1.22alpha5 :
532       
533        - SNMP and PJL improvements with regard to PowerSave / StandBy.
534       
535    - 1.22alpha4 :
536   
537        - Fixed charset problem under MacOSX.
538       
539        - Allows pkbanner to accept more info to display on its
540          command line.
541         
542    - 1.22alpha3 :
543   
544        - Fixes some case related problems with some LDAP backends.
545       
546        - Fixes some problem for printers which directly go from
547          "idle" to "warmup" and never to "printing" before
548          returning to "idle".
549         
550        - Some permissions settings may have prevented cupspykota
551          from parsing cupsd.conf, this is now fixed.
552         
553    - 1.22alpha2 :
554   
555        - Introduction of the web enabled print quote generator.
556       
557        - Fixed a potential race condition when several backend
558          wrappers were present in CUPS' backend directory.
559         
560        - Fixed dumpykota's output in CUPS' page_log format to better
561          match CUPS format.
562         
563    - 1.22alpha1 :
564   
565        - Import into Subversion.
566       
567    - 1.21 :
568   
569        - Improved documentation.
570       
571        - Improved dependencies checker.
572       
573        - Updated some translation files.
574       
575    - 1.21beta2 :
576   
577        - Fixed an LPRng specific bug.
578       
579        - Several improvements on stability issues with manually modified
580          LDAP trees.
581         
582        - Documentation improvements. 
583       
584    - 1.21beta :
585   
586        - Prepared translation files for next release.
587       
588    - 1.21alpha27 :
589   
590        - Allows software() (no arguments) to the software accounting
591          directive. This saves a lot of CPU since the job is not
592          parsed again : the precomputed size is used directly in this
593          case.
594         
595        - epykota's --prototype option now works fine with accounts
596          limited by balance.
597         
598    - 1.21alpha26 :
599   
600        - Fixed the handling of the 'maxdenybanners' directive.
601       
602        - Introduced the 'denyduplicates' directive.
603       
604        - Fixed some database related glitches.
605       
606    - 1.21alpha25 :
607   
608        - The job's size is now always precomputed, even when
609          'enforcement' is not set to 'strict'.
610         
611        - Introduction of the new 'trustjobsize' configuration directive
612          to workaround some problematic printers. See the sample
613          configuration file for details.
614         
615    - 1.21alpha24 :
616   
617        - Big database structure changes. An upgrade script
618          is now included for PostgreSQL. LDAP users may just
619          want to copy the new schema in place.
620         
621        - edpykota now recognizes the -o | --overcharge command line
622          option to set an overcharging or undercharging factor
623          on each print job's cost for a particular user.
624         
625        - repykota's output format has changed an is not limited to 
626          80 characters wide anymore. People who used to parse
627          repykota's output in their own tools are strongly advised
628          to parse dumpykota's output instead.
629         
630        - Introduction of the new 'maxdenybanners' configuration directive
631          to allow up to N (the directive's value) deny banners to be
632          printed even if the print account is forbidden to print.
633         
634        - Better detection of the number of copies in the PostScript parser.
635       
636    - 1.21alpha23 :
637   
638        - Traditional Chinese translation added.
639   
640        - Several fixes and performance improvements with the LDAP backend.
641       
642    - 1.21alpha22 :
643   
644        - edpykota's --delete command line option doesn't consider
645          '*' to be the default argument anymore :-)
646         
647    - 1.21alpha21 :
648   
649        - dumpykota.cgi can now be run as a normal user as opposed to
650          a PyKota administrator. No read access to pykotadmin.conf is
651          necessary anymore. This CGI scripts now honors the REMOTE_USER
652          environment variable just like printquota.cgi does, see
653          the file cgi-bin/README for details.
654          The command line tool dumpykota must still be run by a PyKota
655          administrator.
656         
657        - Fix exception's name error due to a change in recent versions
658          of PygreSQL.   
659         
660    - 1.21alpha20 :
661         
662        - Big bug fix wrt the datelimit field which was never reset.
663         
664    - 1.21alpha19 :
665   
666        - Introduction of the new dumpykota.cgi CGI script, which
667          allows third party tools like phpPrintAnalyzer to be
668          interfaced in real time with PyKota. To use it you
669          may have to change your web server's configuration,
670          please see pykota/cgi-bin/README
671         
672    - 1.21alpha18 :
673   
674        - Now dumpykota can dump the job history into CUPS' page_log
675          format (even when the printing system is LPRng). This allows
676          people to use tools like PrintAnalyzer or phpPrintAnalyzer
677          (two completely different beasts) with PyKota.
678         
679    - 1.21alpha17 :
680     
681        - Fixed field type's name in XML dumps.
682       
683        - Now drops priviledges to user 'pykota' when launched as root
684          (directly or as a CUPS backend), if such an user exists.
685         
686        - Fixed PCL3/4/5 parser for some drivers' output.
687       
688    - 1.21alpha16 :
689   
690        - fixed several recently introduced bugs in LDAP backend code,
691          thanks to Matt Hyclak.
692         
693    - 1.21alpha15 :
694     
695        - Normalized field names between LDAP and PostgreSQL backends
696          in dumpykota's output.
697         
698        - dumpykota filtering capabilities are now supported within
699          the LDAP backend too.
700         
701    - 1.21alpha14 :
702   
703        - dumpykota now supports extended filtering possibilities
704          with the PostgreSQL backend (LDAP support will come soon).
705         
706    - 1.21alpha13 :
707   
708        - Added a --debug command line option to pkpgcounter, so
709          that people may see what really happens, and what will
710          be available in the future :-)
711         
712    - 1.21alpha12 :
713   
714        - Fixed a bug with non standard pkbanner command lines.
715       
716        - Now logs as errors the differences between precomputed and
717          computed job sizes. **CUPS only for now**
718         
719    - 1.21alpha11 :
720   
721        - Now user and group print quota entries can be stored directly
722          below the user or group with the LDAP backend, using them
723          as branches. Thanks to Stefan Wold for the patch.
724          See the sample configuration file for details.
725         
726        - TLS is now supported with the LDAP backend. Thanks to Stefan
727          Wold for the patch.
728          See the sample configuration file for details.
729         
730        - edpkota now accepts the -U | --used value command line argument
731          to preset the page counters to an initial value. Thanks to
732          Wilson Roberto Afonso and Matt Hyclak for the patch.
733         
734    - 1.21alpha10 :
735   
736        - Now automatically reconnects up to three times if the LDAP server
737          returned an error, possibly due to a timeout.
738         
739    - 1.21alpha9 :
740   
741        - Now searches the configuration files in 'pykota' system user's
742          home directory. The 'pykota' system user and group have
743          to be created by the system administrator, and given
744          sufficient permissions to PyKota's configuration files.
745         
746    - 1.21alpha8 :
747   
748        - Added the new reject_unknown directive to reject the
749          creation of user or groups which are unknown to the system.
750         
751    - 1.21alpha7 :
752   
753        - Introduction of the pkmail email gateway.
754       
755    - 1.21alpha6 :
756   
757        - Fix for LPRng filenames.
758       
759        - Added Turkish translation thanks to Baris Cicek.
760       
761    - 1.21alpha5 :
762   
763        - Improved ESC/P2 miniparser for Stylus Photo printers.
764       
765        - Implemented the --savetoner command line option to pkbanner.
766       
767        - Improved pkbanner's help and messages.
768       
769    - 1.21alpha4 :
770   
771        - Fixed job's data file detection code for LPRng.
772       
773        - Fixed a problem with PJL and PowerSave mode,
774          thanks to Wilson Roberto Afonso.
775       
776    - 1.21alpha3 :
777   
778        - PyKota can now generate its own banners, and either account
779          for them or not, depending on newly introduced directives
780          in pykota.conf
781          Thanks to Matt Hyclak for the patch.
782         
783    - 1.21alpha2 :
784   
785        - Installation script is now non interactive again, as it should
786          have stayed from the beginning. Dependencies checking can
787          be done by launching the checkdeps.py command.
788         
789    - 1.21alpha1 :
790   
791        - added an IPP messages miniparser. Extraction of the client
792          hostname is now considered to be fiable, at least until
793          the CUPS developpers change something...
794       
795    - 1.20 :
796   
797        - Version number changed.
798       
799    - 1.20beta :
800   
801        - Norwegian (Bokm� preliminary translation added.
802       
803        - German translation was finalized.
804       
805        - Greek translation was finalized.
806       
807        - For urgent legal reasons, a "privacy" directive has been added
808          to pykota.conf, to hide jobs' title, filename and options
809          in the history.
810         
811        - Minor changes in the debian directory.
812       
813    - 1.20alpha27 :
814   
815        - Fixed many problems with translation files. In particular
816          the Brazilian Portuguese translation file was incorrectly
817          installed into the french "breton" locale directory.
818         
819        - Finished French translation. 
820         
821    - 1.20alpha26 :
822   
823        - LPRng support code should now better detect network
824          printers' hostnames or IP addresses.
825         
826        - Fix for recently introduced bug in LPRng support.
827       
828        - Fix for incorrect locale setting when starting.
829       
830    - 1.20alpha25 :
831   
832        - pkprinters allows --list to normal users, but require user
833          to be a PyKota administrator when another command line
834          option is used.
835         
836        - pkhint doesn't use absolute path to search for helper commands
837          anymore.
838         
839        - Spanish translation ready for 1.20.   
840       
841    - 1.20alpha24 :
842   
843        - Now warnpykota only warns users limited by balance once.
844       
845        - Now warnpykota only warns users who have ever printed,
846          to not cause confusion to users who have just opened
847          their account.
848       
849        - Prepared help messages for translations.
850       
851    - 1.20alpha23 :
852   
853        - Add workaround for locale problem.
854       
855    - 1.20alpha22 :
856   
857        - Hopefully final fix for data encoding charset.
858       
859        - edpykota now refuse to work if the user is not a PyKota admin.
860       
861        - Fixes a recently introduced bug with users groups and PostgreSQL.
862       
863    - 1.20alpha21 :
864   
865        - Now dumpykota refuses to launch if the current user is not
866          a PyKota administrator (a PyKota administrator is an user
867          allowed to read the pykotadmin.conf file).
868         
869        - Now any PyKota administrator can use repykota and warnpykota
870          with additionnal arguments, not only the root user.
871         
872        - Improved documentation a bit.
873       
874    - 1.20alpha20 :
875   
876        - Reduced delay in internal SNMP and PJL_over_TCP handlers
877          from 2 to 1 second.
878       
879        - dumpykota can now output XML.
880       
881    - 1.20alpha19 :
882   
883        - Improved user groups and user groups quotas dumps in dumpykota.
884       
885        - Finished implementation of LDAP support in dumpykota.
886       
887        - The md5 sum of the job's datas is now available as an
888          hexadecimal digest in the PYKOTAMD5SUM environment variable.
889         
890        - The description, filename, title, and options fields
891          are now stored as UTF-8 strings in both LDAP and PostgreSQL.
892          Proper charset is used during extraction from the database.
893         
894    - 1.20alpha18 :
895   
896        - Experimental autopykota command to initialize user
897          account and quota entries on first print while not
898          resetting the balance value if not needed.
899         
900        - Added the new "winbind_separator" directive to strip
901          out the Samba/Winbind domain name while printing if
902          needed (Off by default).
903         
904    - 1.20alpha17 :
905   
906        - Added --hardreset command line option to edpykota.
907       
908        - Fixed problem with accented chars in title, filename
909          or options and LDAP backend.
910         
911    - 1.20alpha16 :
912   
913        - Internal handling of socket based PJL queries over
914          port tcp/9100 is now available with the magic
915          'pjl' value in the hardware accounter.
916         
917    - 1.20alpha15 :
918   
919        - LDAP pykotaAccountBalance objects were always created
920          attached to the pykotaUser objects. This is now
921          fixed and the value of balancebase in pykota.conf
922          is now correctly used.
923         
924    - 1.20alpha14 :
925   
926        - Belgian translations added (copy of the french ones).
927       
928        - External hardware accounter now loops until
929          a result can be read correctly.
930         
931        - pkhint now suggest the internal snmp handling instead
932          of the external one.
933         
934    - 1.20alpha13 :
935     
936        - Hardware accounter now accepts the special
937          'snmp' value, meaning ALL is done from main code
938          without launching any subprocess.
939          You need the http://pysnmp.sf.net Python module
940          for this to work (tested with v3.4.2)
941         
942        - Increased delay between two loops iterations 
943          to 2 seconds in waitprinter.sh to diminish
944          CPU load.
945         
946    - 1.20alpha12 :
947   
948        - waitprinter.sh rewritten from scratch to wait
949          for printer status stabilization.
950       
951    - 1.20alpha11 :
952   
953        - Generic data dumper 'dumpykota' introduced.
954          Works only with PostgreSQL backend for now.
955         
956    - 1.20alpha10 :
957   
958        - Added fix for incorrect job's size computation when
959          hardware accounting fails.
960         
961    - 1.20alpha9 :
962   
963        - Small fixes wrt subprocesses.
964       
965    - 1.20alpha8 :
966   
967        - Added full support of PCL3 : HP Deskjet printers are now
968          supported.
969       
970    - 1.20alpha7 :
971   
972        - First draft of PCL3GUI (Deskjet 640C for example) analyzer.
973          Needs more work, but no documentation is available.
974       
975    - 1.20alpha6 :
976     
977        - Improved mailandpopup.sh script.
978       
979        - Small fixes for LPRng.
980       
981        - Now exports PYKOTAPRINTERHOSTNAME for network printers'
982          hostname or IP address. Set to 'localhost' when not
983          meaningful.
984         
985        - Fixed issue with how mod_auth_ldap Apache modules
986          fills the REMOTE_USER environment variable.
987         
988        - Fixed a bug in LDAP user deletion code.
989       
990    - 1.20alpha5 :
991     
992        - Introduces the new configuration directive 'onaccountererror'
993          to specify what must be done whenever the software or
994          hardware accounter fails. Allowed values are 'continue' and
995          'stop' (default).
996         
997        - Minor fix in software accounter for a recently introduced
998          problem.
999         
1000    - 1.20alpha4 :
1001   
1002        - Added support for more ghostscript devices in ESC/P2
1003          analyzer : stcolor, st800, escp, escpc are now supported.
1004         
1005    - 1.20alpha3 :
1006       
1007        - Small improvement in PostScript parser to avoid being
1008          fooled by a change in number of copies :
1009          The user can't ask for 200 copies of page 1 and 1 copy
1010          of page 2 to fool PyKota anymore :
1011          this would have been accounted for as 1 copy only, but
1012          now the maximum value seen is used.
1013         
1014        - Relax checks for PCL5 header to accomodate some strange
1015          printer drivers.
1016         
1017        - Now hardware accounting method works like software
1018          accounting method wrt the subprocess' output.
1019         
1020        - Hardware and Software accounting stop the print queue 
1021          when the accounting subprocess didn't work. This will
1022          be configurable in the near future.
1023         
1024    - 1.20alpha2 :
1025   
1026        - Now software accounting method reads accounter's
1027          answer until a line with a single integer is
1028          obtained or until all of its output has been read.
1029          This should fix the problem some people have
1030          when strange locale related messages are sent
1031          when running subprocesses (Solaris only ?).
1032         
1033        - First version of ESC/P2 analyzer. Seems to work
1034          ok at least with 'epson', 'epsonc', 'eps9mid'
1035          and 'esp9high' ghostscript devices. Needs more
1036          work to correctly analyze other devices.
1037       
1038    - 1.20alpha1 :
1039   
1040        - Fixed problem with number of copies in PCLXL parser.
1041       
1042        - Fixed problem with number of copies in PCL5 parser,
1043          when number of copies was set outside of and before first
1044          page.
1045       
1046        - Added workaround for number of copies directly set in
1047          PostScript code.
1048         
1049        - Added german translation.
1050       
1051        - Fixed problem on first print for user group quota when
1052          "enforcement: strict" is used.
1053       
1054        - Fixed interpolation problem in french translation.
1055       
1056    - 1.19 :
1057   
1058        - Updated existing translations.   
1059       
1060        - Added final Thai and Greek translations.
1061       
1062        - Minor last minute bug fixes.
1063       
1064    - 1.19beta :
1065   
1066        - LPRng support for both software and hardware accounting seems
1067          to be OK.
1068         
1069        - Translation files fixed because of fuzzy matching problem. 
1070       
1071        - Fixed path to Swedish translation: 'sv' instead of 'se'.
1072       
1073        - Added first draft of Thai translation.
1074       
1075        - Fixed some minor bugs with Pychecker.
1076       
1077    - 1.19alpha35 :
1078   
1079        - Generic PDL analyzer now supports Binary PostScript documents
1080          in addition to DSC compliant ones.
1081       
1082    - 1.19alpha34 :
1083   
1084        - LPRng support : software accounting seems to work fine,
1085          but hardware accounting doesn't work yet.
1086   
1087    - 1.19alpha33 :
1088   
1089        - pykosd now accepts command line arguments. Enjoy !
1090          NB : due to a bug in xosd, you need xosd version 2.2.8
1091          or higher if you don't use the default C locale.
1092         
1093    - 1.19alpha32 :
1094   
1095        - Early (not working) version of the LPRng support rewrite.
1096       
1097        - Saner default configuration file.
1098       
1099    - 1.19alpha31 :
1100   
1101        - Fixed a double Python2.1 incompatibility with newer versions,
1102          which prevented the PCL5 and the PCLXL parsers to work with
1103          this older version of Python.
1104         
1105    - 1.19alpha30 :
1106   
1107        - Introduction of preliminary version of the pykosd command
1108       
1109        - Usernames, Groupnames and Printernames can now contain
1110          ANY character, expected '/' and '@'.
1111       
1112        - Integrated most of the Debian work from Sergio
1113          Gonz�z Gonz�z
1114         
1115    - 1.19alpha29 :
1116   
1117        - PCLXL parser should now correctly handle number of
1118          copies set for each page.
1119         
1120        - Added testsuite for generic PDL analyzer.
1121       
1122        - Typo fixed in PCLXL parser.
1123       
1124        - Correctly dispatches error messages depending on the
1125          situation : tools which can be run interactively will
1126          ALWAYS output their logs to stderr, excepted for
1127          their DEBUG messages, for which the "logger:"
1128          directive as set in pykota.conf will be honored.
1129          Tools which can't be run interactively will ALWAYS
1130          honor the "logger:" directive as set in pykota.conf
1131         
1132    - 1.19alpha28 :
1133   
1134        - The description field for printers can now be set,
1135          and is displayed in reports.
1136         
1137        - Fixed a small problem in SQL backend code.
1138         
1139        - Improved pkhint
1140       
1141        - First working PCL6 (aka PCLXL) parser !
1142          Doesn't handle copies yet.
1143       
1144    - 1.19alpha27 :
1145   
1146        - Additionnal 10% speed increase in PCL5 parser for GhostScript
1147          generated files (untested yet with other PCL files).
1148         
1149        - Reintroduced the use of mmap in PCL5 parser : this speedups
1150          PCL5 parsing by almost 4 times.
1151          This 4x with the 3x below give us in fact a twelvefold increase
1152          in performance for PCL5 parsing !
1153         
1154        - The Python accelerator Psyco is now used if available
1155          in the generic PDL parser : it speedups PCL5 parsing by
1156          almost three times automagically.
1157         
1158    - 1.19alpha26 :
1159   
1160        - Fixed PCL5 parser according to the sources of rastertohp.
1161       
1162        - Fixed number of copies handling in PCL5 parser : the number
1163          of copies could vary from page to page.
1164         
1165        - Added more debug information to PCLXL parser. 
1166       
1167    - 1.19alpha25 :
1168   
1169        - Added new "description" field to printers in both
1170          PostgreSQL and LDAP. No code to handle this yet.
1171         
1172        - Reversed the fix for power save mode in printers : 
1173          no paper or tray open would have caused people to
1174          be undercharged.
1175         
1176        - Preliminary version of MySQL initialization script.
1177         
1178    - 1.19alpha24 :
1179   
1180        - Native PDF parsing code now works perfectly with
1181          Python 2.1 and above, and is way faster than before.
1182          GhostScript is not used anymore to convert PDF to PS,
1183          because PDF is parsed directly.
1184         
1185    - 1.19alpha23 :
1186   
1187        - Fixed waitprinter.sh wrt PowerSave mode and some
1188          printers. Thanks to Ryan Suarez.
1189       
1190        - Smart PDL analyzer now recognizes PDF too : two
1191          PDF parsing methods are used : a native one which
1192          is very fast but requires Python 2.3 or above, and
1193          a slower one which uses Ghostscript. PyKota detects
1194          automatically which method to use depending on your
1195          version of Python.
1196       
1197        - All tracebacks now include PyKota's version number.
1198         
1199    - 1.19alpha22 :
1200   
1201        - Ensures that the file pointer for job's data is
1202          reset to the start of the job's datas after the
1203          job's size pre-computation phase.
1204         
1205        - Improved PostScript detection code for bad drivers
1206          which don't correctly switch languages between PJL
1207          and PS.
1208       
1209        - Even better debugging code.
1210       
1211    - 1.19alpha21 :
1212   
1213        - Additionnal check.
1214       
1215    - 1.19alpha20 :
1216   
1217        - More complete logging messages wrt accounters.
1218       
1219        - Now catches early failures occuring when the configuration
1220          files are parsed.
1221       
1222    - 1.19alpha19 :
1223   
1224        - Fixed over-verbose exits when displaying help
1225          or version.
1226         
1227        - Extended some PATH in the shell scripts 
1228       
1229        - Deleting an user now also deletes his payments history.
1230       
1231        - Doesn't explicitely ignore SIGCHLD anymore. This seems to
1232          cause problems.
1233
1234    - 1.19alpha18 :
1235   
1236        - History of payments is now stored in the database, and
1237          updated each time an user's balance is modified with
1238          edpykota --balance. This history represents each time
1239          the user was given some positive or negative credit,
1240          but doesn't reflect price paid for jobs, which appear
1241          in the jobs history instead.
1242         
1243        - Jobs history web reports now include the job's size in
1244          bytes. Also columns were reordered to render the report
1245          more easily readable.
1246         
1247    - 1.19alpha17 :
1248   
1249        - Mysterious bug (program exited unexpectedly without leaving
1250          any log message) which occured once in a while when
1251          cancelling jobs should be fixed now.
1252         
1253        - New 'crashrecipient' directive. Disabled by 
1254          default. See sample configuration file to see how
1255          to activate it. It is suggested that you activate it.
1256         
1257        - New PYKOTAJOBSIZEBYTES environment variable exported, 
1258          which contains the job's size in bytes. Empty jobs
1259          are now denied. This value is now stored in the job
1260          history (but not yet displayed from the web interface)
1261         
1262        - Preliminary work on payments storage : the PostgreSQL 
1263          and LDAP schemas should be OK now, but no code is written
1264          yet to support this functionnality.
1265         
1266    - 1.19alpha16 :
1267   
1268        - the newuser and newgroup LDAP specific directives now accept
1269          a second parameter to attach(), "fail" or "warn". If no entry
1270          is found to attach PyKota attributes to, and "fail" was used,
1271          then action is aborted and program exits in error. If "warn"
1272          is used, a new entry is created but a warning message is logged.
1273         
1274        - The job's originating hostname is now stored in the database,
1275          and exported as PYKOTAJOBORIGINATINGHOSTNAME in the environment.
1276       
1277    - 1.19alpha15 :
1278   
1279        - The old pykota filter is now removed. This means that
1280          currently PyKota doesn't support LPRng anymore, but
1281          LPRng support will be re-added, improved, in the near future.
1282         
1283    - 1.19alpha14 :
1284   
1285        - PYKOTAPRECOMPUTEDJOBSIZE and PYKOTAPRECOMPUTEDJOBPRICE
1286          are now exported as environment variables.
1287         
1288        - Heavy CPU usage is now completely fixed it seems, by
1289          introducing some 0.01 second sleeping when nothing to do.
1290         
1291        - Pre-computation of the job's size is now only
1292          done when enforcement is "STRICT", this saves
1293          CPU for people who don't want to use this new
1294          feature.
1295         
1296        - New 'enforcement' directive which accepts either
1297          STRICT or LAXIST. See sample configuration file
1298          for details.
1299         
1300    - 1.19alpha13 :
1301   
1302        - Get back to an old version of the polling loop which
1303          worked fine, but non-optimally. Will be optimized
1304          as time permits.
1305         
1306    - 1.19alpha12 :
1307   
1308        - Job's size is now precomputed unconditionnally using
1309          the generic PDL analyzer.
1310          NB : This value is not yet used to pre-allow/deny the
1311          job.
1312       
1313    - 1.19alpha11 :
1314   
1315        - The pykota filter is now completely deprecated and
1316          can't be used anymore. LPRng users MUST download
1317          an older version of PyKota. CUPS users MUST use
1318          cupspykota. Better support for LPRng will come
1319          in the near future.
1320         
1321    - 1.19alpha10 :
1322   
1323        - pykotme now uses generic PDL Analyzer directly instead
1324          of spawning a new process.
1325         
1326        - Improvements to generic PDL Analyzer.
1327       
1328        - 25% Speedup in PCL parser. Getting more of the Python version
1329          will probably be difficult, since the completely table driven
1330          parser I wrote is slower than the original algorithm. Then,
1331          the original algorithm is still used for now.
1332          Probable that more speed could be achieved using mmap, at the
1333          expense of severe memory consumption.
1334       
1335        - configuration simplifications : the "accounter" directive's
1336          'hardware' arguments now accepts what was in the "requester"
1337          directive as it's content. The "requester" directive is not
1338          supported anymore. See sample configuration file for details.
1339       
1340    - 1.19alpha9 :
1341       
1342        - pkpgcounter is now just a wrapper around the PDLAnalyzer class
1343       
1344        - pykotaOptions LDAP attribute now accepts non-ascii characters
1345          too.
1346         
1347        - First try at cupspykota main loop rewrite
1348       
1349    - 1.19alpha8 :
1350   
1351        - 'querying' accounting method is now called 'hardware'
1352       
1353        - 'external' accounting method is now called 'software'
1354       
1355        - 'stupid' accounting method doesn't exist anymore
1356       
1357        - 'snmp' requester doesn't exist anymore
1358       
1359        - code simplifications in external requester
1360       
1361    - 1.19alpha7 :
1362     
1363        - Database schema change (both LDAP and PostgreSQL) to
1364          allow storage of the job-originating-hostname attribute.
1365          An SQL upgrade script is present. The code is not yet
1366          capable of setting/retrieving this attribute. Support
1367          for this functionnality will be added in the future.
1368         
1369    - 1.19alpha6 :
1370   
1371        - problems connecting to SMTP servers are now catched.
1372       
1373        - pykotme now uses pkpgcounter to compute the size of the
1374          job. This modification adds PCL5 and soon PCLXL (PCL6)
1375          support. You can now get quotes for PCL in addition to
1376          PostScript.
1377         
1378        - pkpgcounter now includes first try at PCLXL parser. 
1379          It is currently disabled until it's finished.
1380         
1381    - 1.19alpha5 :
1382   
1383        - cupspykota polling loop fix for MacOSX (at least)
1384       
1385        - logging subsystem now logs PID too, to ease diagnosing
1386          problems under heavy load.
1387         
1388        - pkpgcounter enhancements.
1389       
1390        - pkprinters --skipexisting now tells pkprinters to not
1391          modify existing printers when --add is used.
1392          pkprinters logs a warning message whenever --add is
1393          used and a printer already exists.
1394         
1395        - LDAP schema now allows accented chars in pykotaFileName
1396          and pykotaTitle attributes.
1397       
1398    - 1.19alpha4 :
1399   
1400        - a bad copy&paste prevented pkpgcounter to work at all, this
1401          is now fixed.
1402         
1403        - improved PCL support in pkpgcounter, with the use of
1404          HP PCL/PJL Reference Set
1405          PCL5 Printer Language Technical Quick Reference Guide
1406       
1407        - pkpgcounter now uses mmap to speed things up : duration
1408          is halved with the sample 87 pages PCL document I use for
1409          testing.
1410         
1411    - 1.19alpha3 :
1412   
1413        - pkprinters now accepts the --list command line argument
1414          to list informations about printers.
1415         
1416    - 1.19alpha2 :
1417   
1418        - pkpgcounter is now included as a smart external
1419          accounter which can handle both PostScript and PCL.
1420         
1421    - 1.19alpha1 :
1422   
1423        - PYKOTALIMITBY environment variable is now exported too.
1424       
1425        - Inclusion of Michele Baldessari's work on autotools.
1426       
1427    - 1.18 :
1428   
1429        - Improved documentation
1430       
1431    - 1.18beta2 :
1432     
1433        - Fix for raw jobs with cupspykota
1434       
1435    - 1.18beta :
1436   
1437        - Small fix for new waitprinter.sh script
1438       
1439        - Better tracebacks on error conditions
1440       
1441        - Improved translations
1442       
1443        - Improved documentation
1444       
1445    - 1.18alpha15 :
1446
1447        - waitprinter.sh replaced by a new and possibly faster
1448          and more powerful one.
1449   
1450        - Names can now begin with a digit.
1451       
1452        - Stability improvement for quotas set on printers groups.
1453       
1454    - 1.18alpha14 :
1455   
1456        - Catches more (all ?) problems with SMTP servers instead
1457          of breaking.
1458         
1459        - Italian translation added.
1460       
1461    - 1.18alpha13 :
1462   
1463        - Pre and Post hooks are now available in the pykota
1464          filter as well.
1465         
1466        - The pykota filter doesn't check last user's quota
1467          anymore when delayed hardware accounting is used :
1468          this will be done anyway the next time the last
1469          user will print again. This saves some database
1470          queries which are unneeded.
1471       
1472    - 1.18alpha12 :
1473   
1474        - Pre and Post hooks to external commands with many
1475          many environment variables available are useable
1476          from the cupspykota backend.
1477          See sample configuration file for details and help.
1478         
1479    - 1.18alpha11 :
1480   
1481        - Hopefully final fix wrt groups (users and printers)
1482       
1483    - 1.18alpha10 :
1484   
1485        - Fixed nested printer groups accounting.
1486       
1487        - Fixed user groups + printer groups problem.
1488       
1489    - 1.18alpha9 :
1490   
1491        - Fix for LDAP problem when job price was 0.
1492       
1493        - Fix for empty user groups with LDAP.
1494       
1495        - Preliminary version of the snmpprinterstatus command added.
1496       
1497    - 1.18alpha8 :
1498   
1499        - Don't retrieve data when not needed.
1500          This avoids many database queries.
1501       
1502    - 1.18alpha7 :
1503   
1504        - New experimental ldapcache directive to improve
1505          LDAP caching.
1506         
1507    - 1.18alpha6 :
1508       
1509        - New configuration directive added : maildomain
1510          to specify the domain to send mail to when user
1511          email address is not set in PyKota database.
1512         
1513        - More complete email message headers. 
1514         
1515    - 1.18alpha5 :
1516   
1517        - Debian packaging specific files, contributed by
1518          Peter Hawkins are now included in the project's tree.
1519         
1520        - Preliminary work on future low-level LDAP caching to speed
1521          up modifications (at least).
1522         
1523    - 1.18alpha4 :
1524   
1525        - Applied some of the modifications suggested by
1526          Peter Hawkins, for better Debian integration.
1527          Most notably cupspykota, pykota, and the shell
1528          scripts are now installed into /usr/share/pykota
1529          instead of into /usr/bin
1530          BEWARE : double check that your symbolic link
1531          to cupspykota is correct, and that your pykota.conf
1532          file use correct path for the shell scripts like
1533          waitprinter.sh and al.
1534         
1535        - pkhint command added, to help in configuring correct
1536          accounting method for PyKota.
1537         
1538    - 1.18alpha3 :
1539   
1540        - Fixed a rare bug in cupspykota backend which gave
1541          incorrect "CUPS backend died abnormally" messages.
1542       
1543    - 1.18alpha2 :
1544   
1545        - Added the pkprinters command line tool to manage printers
1546          exclusively.
1547       
1548    - 1.18alpha1 :
1549   
1550        - Preliminary work on Relationnal Database Independance.
1551       
1552        - Sample report made from OpenOffice.org added as PDF and SXC.
1553       
1554    - 1.17 :
1555   
1556        - Finalized release.
1557       
1558    - 1.17alpha2 :
1559   
1560        - Fix stupid software accounting bug in the CUPS backend.
1561       
1562    - 1.17alpha1 :
1563   
1564        - User/Group deletion code in edpykota rewritten.
1565       
1566    - 1.16 :
1567   
1568        - Preliminary documentation on how to use OpenOffice.org
1569          to create personnalized reports for PyKota + PostgreSQL.
1570         
1571        - Spanish installation guide for CUPS+PyKota+PostgreSQL
1572          added to the documentation. Doesn't yet document v1.16
1573          though.
1574       
1575        - Portuguese Portuguese translation replaces Brazilian
1576          Portuguese Translation. Brazilian portuguese
1577          translation is still available under the 'br' locale.
1578       
1579    - 1.16beta3 :
1580   
1581        - Swedish translation added.
1582       
1583        - Small fix in documentation.
1584       
1585    - 1.16beta2 :
1586   
1587        - Small fix for job cancelling code while job already
1588          printing in CUPS backend.
1589         
1590        - Big fix wrt printing policies for unknown users. 
1591       
1592    - 1.16beta1 :
1593   
1594        - Manpages upgraded.
1595       
1596    - 1.16alpha26 :
1597   
1598        - Job price is now computed like this :
1599       
1600          SUM((NbPages * PricePerPage) + PricePerJob)
1601         
1602          For current printer and all the printers groups it is
1603          a member of, if any.
1604         
1605          This may be difficult to grasp, but offers unprecedented
1606          flexibility.
1607         
1608    - 1.16alpha25 :
1609   
1610        - Email address can be set at user creation time,
1611          using the following syntax :
1612         
1613            $ edpykota --add username/email@yourdomain.com
1614       
1615    - 1.16alpha24 :
1616   
1617        - CGI script now can show the printing history.
1618       
1619        - Bug wrt number of copies should be fixed.
1620       
1621        - Major code refactoring => It is now possible to
1622          automatically add printers on first print.
1623       
1624    - 1.16alpha23 :
1625   
1626        - Fixed potential accuracy problem if a user printed on
1627          several printers at the very same time.
1628       
1629    - 1.16alpha22 :
1630   
1631        - edpykota now allows adding printers to printer groups
1632       
1633    - 1.16alpha21 :
1634   
1635        - Allows the dot in user and printer names.
1636       
1637        - Printer groups are now cached too.
1638       
1639    - 1.16alpha20 :
1640   
1641        - Fixed several small bugs with the help of PyChecker.
1642       
1643    - 1.16alpha19 :
1644     
1645        - Fixed a bug in PostgreSQL backend's code.
1646       
1647    - 1.16alpha18 :
1648   
1649        - Initial code for printer groups support. Printer groups have
1650          to be added with external tools like psql or gq for example.
1651          Printer groups seems to work fine with users. Untested with user
1652          groups for now.
1653
1654        - Several minor visual problems fixed in reports.
1655       
1656        - Fixed a bug in LDAP date handling.
1657       
1658        - Fix for LDAP problem with some combination of OpenLDAP + Python-LDAP
1659          + some particular settings.
1660         
1661        - mailandpopup.sh shell script added. See sample configuration file
1662          for details.
1663       
1664        - Several environment variables are now exported when executing
1665          external commands (accounters, requesters, mailers) :
1666           
1667            PYKOTAUSERNAME => user who is printing
1668            PYKOTAPRINTERNAME => printer on which the job is being sent
1669            PYKOTATITLE => Job's title
1670            PYKOTAFILENAME => Job's filename
1671            PYKOTACOPIES => number of copies asked
1672            PYKOTAOPTIONS => print command options (-o with CUPS)
1673         
1674    - 1.16alpha17 :
1675   
1676        - Added portugues translation.
1677       
1678        - Major code refactoring in accounters.
1679       
1680    - 1.16alpha16 :
1681   
1682        - Code refactoring, and addition of a real HTML reporter, to
1683          have nice looking and useful web based reports (in the future).
1684       
1685        - Added utolower configuration option to convert all usernames
1686          to lowercase during printing.
1687         
1688    - 1.15alpha15 :
1689   
1690        - Now includes the papwaitprinter.sh shell script to wait for
1691          AppleTalk enabled printers.
1692         
1693    - 1.16alpha14 :
1694   
1695        - Now printing on a printer not defined in the Quota Storage,
1696          results in the job being cancelled or stopped, depending
1697          on the printing system.
1698         
1699    - 1.16alpha13 :
1700   
1701        - Small bugfix wrt Python v2.1
1702       
1703        - If username is an empty string, user root is assumed.
1704       
1705        - 'postgresql' is not recognized anymore as a storage backend,
1706          you have to use 'pgstorage' instead. 'postgresql' used to
1707          be supported for compatibility with very old PyKota versions,
1708          this is not the case anymore.
1709         
1710    - 1.16alpha12 :
1711   
1712        - Job price added to job history, to keep accounting correct
1713          if a printer price per page or per job is modified and the
1714          history is not reset : the history would have given a false
1715          amount of money charged before the printer's prices were
1716          modified, this addition solves the problem.
1717         
1718    - 1.16alpha11 :
1719   
1720        - Some preliminary modifications to the database structure for
1721          PostgreSQL and OpenLDAP. A script to upgrade a PostgreSQL
1722          database is now provided. LDAP attributes now support
1723          eq, pres and sub indexes.
1724         
1725        - Job history now contains additional informations : 
1726          number of copies, filename, title and print options.
1727         
1728    - 1.16alpha10 :
1729       
1730        - Some modifications done to external policy handling.
1731          See sample configuration file for details.
1732   
1733        - Spanish translation added.
1734       
1735    - 1.16alpha9 :
1736   
1737        - mailto can be set to external(...) to warn users above
1738          quota with any command of your choice (e.g. linpopup).
1739          Several parameters are available, see sample configuration
1740          file for details.
1741         
1742    - 1.16alpha8 :
1743   
1744        - Now cupspykota transmits SIGTERMS to the original 
1745          backend when the user deletes a job being processed.
1746         
1747        - The documentation is now licensed under the terms of the
1748          GNU GPL too.
1749         
1750    - 1.16alpha7 :
1751   
1752        - The CUPS backend is now fully functionnal (it seems).
1753       
1754        - From now on, the use of the pykota filter with CUPS
1755          is deprecated. The pykota filter still has to be
1756          used with LPRng though.
1757       
1758    - 1.16alpha6 :
1759   
1760        - Bug fixed : when edpykota was used to add a printer
1761          with no user or group name, a bad user/group name "*" was
1762          added to the database.
1763         
1764    - 1.16alpha5 :
1765   
1766        - New CUPS backend supports device enumeration !
1767          This means that NO manual CUPS configuration has to
1768          be done. All can now be done from CUPS web interface.
1769       
1770    - 1.16alpha4 :
1771   
1772        - New CUPS backend added.
1773       
1774    - 1.16alpha3 :
1775       
1776        - Minimal FAQ document added.
1777       
1778    - 1.16alpha2 :
1779   
1780        - CGI script now partially supports browser's language preference
1781       
1782    - 1.16alpha1 :
1783   
1784        - Ensures that the LDAP connection is really closed at end.
1785       
1786        - More complete error messages in case of LDAP operation failure.
1787       
1788    - 1.15 :
1789     
1790        - Documentation improved.
1791       
1792    - 1.15beta :
1793   
1794        - Command line tools now accept multiple printer
1795          names or wildcards, separated with commas.
1796         
1797    - 1.15alpha9 :
1798   
1799        - External policy can be used to auto-add unknown users
1800          and any other interesting things you may want to do.
1801          WARNING : You can't auto-add printers for now.
1802          They have to be created manually before.
1803          Look at sample configuration file for examples.
1804         
1805    - 1.15alpha8 :
1806   
1807        - Job history can be disabled if needed.
1808          This feature may be useful for people who use the LDAP
1809          backend and don't want their LDAP tree to grow out of
1810          control.
1811       
1812    - 1.15alpha7 :
1813   
1814        - More work done on caching wrt groups.
1815       
1816    - 1.15alpha6 :
1817   
1818        - Performance bottleneck with LDAP solved.
1819       
1820    - 1.15alpha5 :
1821   
1822        - Caching mechanism for all database queries.
1823
1824    - 1.15alpha4 :
1825   
1826        - Problem with Python 2.3 fixed. Needs some definitive
1827          modification.
1828         
1829    - 1.15alpha3 :
1830   
1831        - CGI script now tries to restrict view when the
1832          REMOTE_USER environment variable is set. This allows
1833          people to protect its use with .htaccess files.
1834          When unprotected, or if REMOTE_USER is 'root', then
1835          unrestricted access is granted.
1836          NB : REMOTE_USER is automatically set by the web server
1837          (e.g. Apache) when a page with restricted access is viewed.
1838         
1839    - 1.15alpha2 :
1840   
1841        - Better detection of LPRng.
1842       
1843        - Outputs a warning if printing system is unknown.
1844       
1845    - 1.15alpha1 :
1846   
1847        - Bug fix in SQL code.
1848       
1849    - 1.14 :
1850   
1851        - The PostgreSQL database connection is now always closed before
1852          exit. The LDAP database connection too, but it didn't suffer
1853          from the problem anyway, AFAICT.
1854       
1855    - 1.14beta2 :
1856   
1857        - An LDAP-specific configuration field was introduced, usermail.
1858          Use it to specify which LDAP attribute contains a valid email
1859          address for the user. See sample configuration file for
1860          details.
1861       
1862    - 1.14beta :
1863   
1864        - Two new LDAP-specific configuration fields were introduced,
1865          newuser and newgroup. Use them to specify if you want to add
1866          quota information to existing entries or elsewhere.
1867          See sample configuration file for details.
1868         
1869    - 1.14alpha9 :
1870   
1871        - Documentation improved.
1872       
1873        - pykotme now also prints the user's account balance value
1874          if the user is registered in the Quota Storage and his
1875          limiting factor is "balance".
1876         
1877    - 1.14alpha8 :
1878   
1879        - bin/waitprinter.sh is now included to wait for
1880          SNMP enabled printers to be idle again before
1881          asking for their internal page counter.
1882          See sample configuration file for details.
1883         
1884    - 1.14alpha7 :
1885   
1886        - edpykota now doesn't check if the user/group is above
1887          quota. The check is only done at print time. This
1888          prevents the sending of email messages when creating
1889          user quotas if quota is already reached at creation
1890          time.
1891         
1892    - 1.14alpha6 :
1893   
1894        - Configuration file split and moved to /etc/pykota/pykota.conf
1895          and /etc/pykota/pykotadmin.conf to prevent simple users to
1896          have Read/Write access to the Quota Database.
1897          Don't forget to :
1898         
1899                $ chmod 640 /etc/pykota/pykotadmin.conf
1900               
1901        - storageuser and storageuserpw configuration fields reintroduced
1902          for the same reason.
1903         
1904        - Code cleaning for future implementation of email addresses
1905          support in the PostgreSQL and LDAP backends.
1906         
1907    - 1.14alpha5 :
1908       
1909        - Big bug fixed when changing the prices for a printer
1910       
1911    - 1.14alpha4 :
1912   
1913        - When adding an user, the user itself and its account balance
1914          are now added in the same LDAP entry. Before they were added
1915          as two different LDAP entries.
1916         
1917    - 1.14alpha3 :
1918   
1919        - Email field added to PostgreSQL database. An upgrade script
1920          is included in initscripts/postgresql.
1921       
1922    - 1.14alpha2 :
1923   
1924        - Typo fixed when using the --prototype option to edpykota
1925       
1926    - 1.14alpha1 :
1927   
1928        - Poor man's treshold included : users with a low account
1929          balance (below 1.0 by default, configurable) are sent
1930          a warning message.
1931         
1932        - All warning messages to users are now configurable. 
1933          NB : Warning messages to the administrator are not.
1934       
1935    - 1.13 :
1936   
1937        - Some small fixes wrt group handling.
1938       
1939        - The whole module code was passed through PyChecker and
1940          several small code inconsistencies were fixed,
1941          as well as a bug in the groups code.
1942         
1943    - 1.13alpha1 :
1944   
1945        - Bug fix wrt LDAP.
1946       
1947    - 1.12 :
1948   
1949        - More complete test added in edpykota.
1950       
1951    - 1.12alpha2 :
1952   
1953        - The previous bug fix was incomplete. This is corrected.
1954       
1955    - 1.12alpha1 :
1956   
1957        - Small bug fix.
1958       
1959    - 1.11 :
1960   
1961        - Now includes the pykotme command line tool, to produce
1962          printing quotes for users.
1963         
1964    - 1.10 :
1965   
1966        - Bug fixed wrt quota reports when print limiting is by
1967          account balance.
1968         
1969    - 1.09 :
1970   
1971        - Translations finalized.
1972       
1973        - Manpages updated.
1974       
1975        - Installation documentation improved wrt LDAP support.
1976       
1977    - 1.09beta2 :
1978   
1979        - The CGI script for quota reports works again, and
1980          is much more powerful.
1981       
1982    - 1.09beta :
1983   
1984        - edpykota finalized
1985       
1986    - 1.09alpha2 :
1987   
1988        - LDAP schema modified a bit. Please upgrade.
1989       
1990        - LDAP backend works !
1991       
1992        - repykota and warnpykota allow the root user to pass
1993          users or groups names on the command line. Users
1994          and groups names may contain wildcards.
1995         
1996        - repykota and warnpykota only reports or warns the
1997          current user when launched by non-root users.
1998         
1999        - Minor bug fixes. 
2000   
2001    - 1.09alpha1 :
2002   
2003        - More work on LDAP storage backend. Many options
2004          were added to /etc/pykota.conf to give some
2005          hints to the LDAP storage backend.
2006         
2007        - Severe database access optimizations were done by
2008          rewriting most of the Quota Storage backends drivers.
2009     
2010    - 1.08 :
2011   
2012        - Major bug fix wrt LPRng support for remote jobs.
2013       
2014        - Major bug fix wrt increase/decrease account balances.
2015       
2016    - 1.08alpha8 :
2017   
2018        - Code refactoring.
2019       
2020        - A single user/password pair is used to connect
2021          to the database backend. The storageuser configuration
2022          field, and its associated passwords storageuserpw, are
2023          not used anymore.
2024         
2025        - You can now set PyKota in debug mode, see sample configuration 
2026          file for details.
2027          WARNING : only Quota Storage backend queries are logged in
2028          debug mode, for now.
2029       
2030    - 1.08alpha7 :
2031   
2032        - Very latest LDAP schema.
2033       
2034        - Code enhancement wrt easy pluggability of PyKota attributes
2035          and object classes into an existing LDAP directory.
2036       
2037    - 1.08alpha6 :
2038   
2039        - Minor bug corrections
2040       
2041        - More work on LDAP : new schema
2042       
2043    - 1.08alpha5 :
2044   
2045        - More good work on LDAP storage.
2046          repykota now works reasonably well with the sample LDAP directory.
2047       
2048    - 1.08alpha4 :
2049   
2050        - LDAP schema included.
2051          THIS IS JUST FOR PEOPLE TO DISCUSS ABOUT THIS.
2052          LDAP SUPPORT DOESN'T WORK YET, AND THE SCHEMA
2053          MAY CHANGE IN THE FUTURE. PLEASE TELL US
2054          WHAT YOU THINK ABOUT THIS SCHEMA ON THE
2055          MAILING LIST.
2056         
2057    - 1.08alpha3 :
2058   
2059        - External accounting methods were partly rewritten :
2060         
2061          - No more "broken pipe" should happen.
2062         
2063          - They now take care of the number of copies
2064            This may be unneeded though, if the postscript
2065            file already does this, because this would
2066            overcharge users (number of copies counted
2067            two times). NEEDS MORE TESTING.
2068           
2069          - The sample configuration file now contains 
2070            an external accounting method example which should
2071            work with all DSC compliant Postscript files.
2072           
2073        - Some small bugs were fixed.   
2074       
2075    - 1.08alpha2 :
2076   
2077        - Now works with net-snmp v5.0 and above.
2078          It already worked, but the sample configuration
2079          file didn't contain appropriate values...
2080       
2081    - 1.07 : Release of the Shame !
2082   
2083        - The external accounting methods driver was left out of
2084          the CVS tree. Nobody could use it since it wasn't included !
2085         
2086    - 1.06 :
2087   
2088        - Severe bug fixed : if you had a printer in
2089          power saving state which couldn't answer immediately,
2090          a bug was triggered.
2091          It was caused by a bad copy/paste which
2092          forgot to import a Python module at run time.
2093         
2094    - 1.05 :
2095   
2096        - External accounters are finally available !
2097          This means that you can plug any page accounting
2098          method you like by setting the appropriate
2099          'accounter' field in /etc/pykota.conf
2100          See the sample conf/pykota.conf.sample to
2101          learn how to do.
2102         
2103          NB : Both 'external' and 'stupid' accounting methods
2104               account a job size just before *this* job is
2105               sent to the printer.
2106               The original 'querying' method accounts a job
2107               size just before *the next* job is sent to
2108               the printer.
2109       
2110    - 1.05alpha3 :
2111   
2112        - A 'stupid' and unreliable accounting method was
2113          implemented to serve as an example on how to
2114          do this sort of things. This method only counts
2115          the 'showpage' statements in the input data.
2116          See sample configuration file for details.
2117          Pluggable accounting methods work, but I advise
2118          you TO NOT USE THIS ONE WHICH IS JUST AN EXAMPLE.
2119          It is not reliable enough to be used.
2120          Use the 'querying' accounting method instead.
2121         
2122    - 1.05alpha2 :
2123   
2124        - Pluggable accounting methods.
2125       
2126        - Better error handling.
2127       
2128    - 1.05alpha1 :
2129   
2130        - SECURITY file added to help improve PyKota's security.
2131       
2132        - Extracting the printer's internal page counter is now
2133          tried several times, waiting several seconds between
2134          two tries. This lets the time to warm up for some printers
2135          which don't answer when they are sleeping (my Apple
2136          LaserWriter 16/600 PS is in this case, maybe others too)
2137         
2138        - Small display bug fixed in repykota
2139         
2140    - 1.04 :
2141   
2142        - Default print policy for users/groups unknown from
2143          the print quota system is now DENY instead of ALLOW,
2144          since ALLOW can generate inaccurate results
2145          (incorrect job sizes charged to the wrong persons)
2146         
2147        - LPRng support works !
2148       
2149        - A bug was introduced some time ago wrt printers' default
2150          policy for unknown users. It is now corrected.
2151       
2152        - repykota now displays prices per job and per page for each
2153          printer, if they are defined.
2154         
2155        - Minor display bug fixed in repykota.
2156       
2157        - Problem when running repykota with an empty database was fixed.
2158       
2159    - 1.03 :
2160   
2161        - Upgrade script included for earlier versions.
2162          Please look inside the initscripts subdirectory.
2163          THE DATABASE SCHEMA HAS CHANGED, PLEASE UPGRADE.
2164         
2165        - repykota now reports account balances too.
2166       
2167        - PyKota now has a nice logo, see the logos
2168          subdirectory.
2169       
2170        - Manual pages were finally updated.
2171       
2172        - Group quotas seem to work now !
2173       
2174        - The new database schema allows to keep an history of all
2175          jobs as well as charge users per page and/or per job,
2176          and track users' account balance.
2177         
2178        - edpykota now accepts much more command line options to 
2179          use the new functionnalities. See edpykota --help for
2180          details.
2181         
2182        - The installation script now allows to install the sample
2183          configuration file during first installation.
2184         
2185        - More group quota code works, but still not finished. 
2186       
2187        - The CGI script displays a link to PyKota's website.
2188       
2189        - The job history is now kept, this will allow per-period
2190          reports in the future.
2191         
2192        - After having modified the quota for an user with edpykota,
2193          a quota check is done to eventually warn the user/admin about
2194          a quota which is too low to print.
2195         
2196        - A workaround is provided for HP Printers : their internal
2197          page counter is only saved to NVRAM in a 10 increment, so
2198          if you switch them off and then on, the reported page counter
2199          may be lower than the real number of pages printed.
2200          See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
2201          We unconditionnally set the last job's page count to
2202          abs(int((10 - abs(lastcounter(snmp) - lastcounter(storage)) / 2))
2203          in this case.
2204          For a more accurate accounting, never switch your HP printers
2205          off.
2206         
2207        - A fix is provided for printers which only have a volatile 
2208          page counter (reset to 0 every time you switch the printer on)
2209          This should allow PyKota to work reasonably fine with HP Laserjet
2210          4L/5L/6L, not perfect, but better than nothing.
2211          See http://web.mit.edu/source/third/lprng/doc/LPRng-HOWTO-15.html
2212          For a more accurate accounting, never switch your HP printers
2213          off. This is untested, please report any problem.
2214         
2215        - A bug was fixed when edpykota --add was used with users who already
2216          had a quota on the specified printer.
2217         
2218        - A small display bug in repykota was introduced in preliminary
2219          1.03 versions, and fixed later on.
2220         
2221        - Some minor bugs which happened in rare situations were fixed.
2222       
2223        - Support for AppleTalk printers was added, see sample configuration
2224          file for details.
2225         
2226        - Users and group printing can now be controlled (limited) either by 
2227          print quota or by account balance.
2228       
2229    - 1.02 :
2230   
2231        - The installation script now checks for software availability
2232          and in case a software is missing asks the user if he
2233          wants to continue with the installation or abort it.
2234         
2235        - The configuration file pykota.conf is now expected to be
2236          found in /etc instead of in /etc/cups
2237          The installation script prompts the user to see if he
2238          wants to move an old configuration file to the new location
2239          if needed.
2240         
2241        - Improved documentation.
2242       
2243        - You can now set the tcp/ip port on which the Quota Storage
2244          Server is listening, see sample configuration file for details.
2245       
2246        - Better general error handling.
2247       
2248        - Upgrade script for pre 1.01 PostgreSQL database schema is now
2249          included as well.
2250       
2251    - 1.01 :
2252   
2253        - The configuration file now accepts an option   
2254          to choose the recipient(s) of the email messages :
2255         
2256            - DevNull means no one will receive them.
2257            - User means only the user will receive them.
2258            - Admin means only the admin will receive them.
2259            - Both means the User and the Admin will receive them.
2260           
2261        - The configuration file now uses hard-coded default values
2262          when an option is not set. See sample configuration file
2263          for details.
2264         
2265        - Manual pages are included since 1.00, but I forgot to   
2266          add this information to this file.
2267         
2268        - Redistribution terms for the official package have 
2269          softened and are now fully GPL compatible :
2270          unrestricted modification is now allowed even for
2271          the version number.
2272         
2273    - 1.00 :
2274   
2275        - edpykota now accepts a --noquota option. This
2276          disable quota checking while still doing page
2277          accounting. This is really useful for people
2278          who don't want to limit their users but want
2279          to know how much pages they print.
2280         
2281        - Some untested scripts were added to retrieve
2282          the life time page counter of non-SNMP printers.
2283         
2284        - Every directory now has a specific README file. 
2285       
2286    - 0.99 :
2287   
2288        - Under some circumstances while the user wasn't allowed
2289          to print, he didn't receive any email message. It is
2290          now fixed.
2291         
2292        - When an user wasn't allowed to print, the quota for
2293          the previous user wasn't updated. This is now fixed.
2294         
2295    - 0.98 :
2296   
2297        - Correctly handle the case where the printer is switched off.
2298       
2299        - Small bug wrt syslog fixed.
2300       
2301    - 0.97 :
2302   
2303        - edpykota accepts wildcards on its command line for users/groups too
2304          if the --add option is not set, e.g. :
2305         
2306              $ edpykota --printer lp --softlimit 50 --hardlimit 100 "jer*"
2307             
2308        - If no user name is passed at all, then a default wildcard of "*"
2309          which means apply the command on ALL users for this printer is used.
2310         
2311        - Small bug fixes.
2312       
2313    - 0.96 :
2314
2315        - Options requester, policy, admin, adminmail and gracedelay can now
2316          be set either globally or per printer. The printer option has
2317          priority if both are defined.
2318
2319        - More powerful configuration parser.
2320       
2321        - If all options are defined globally, there's no need to
2322          define a section for each printer in the configuration
2323          file anymore. Just define a [global] section and it's ok.
2324
2325    - 0.95 :
2326
2327        - External requesters for printers finally added.
2328
2329        - Full internationalization (english and french are supported)
2330 
2331        - More complete quota usage report
2332
2333        - CGI script to access to the quota usage report
2334
2335        - Several bugs fixed.
2336
2337
2338    - 0.9 :
2339
2340        - First public version
Note: See TracBrowser for help on using the browser.