Context Navigation

NEWS

Revision 2899, 78.6 kB (checked in by jerome, 18 years ago)
1.24HotFix2 seems to be ready for packaging.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`

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

Note: See TracBrowser for help on using the browser.

Download in other formats:

Original Format