root / pykota / trunk / NEWS @ 2896

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

Changed date.

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