r45539 - in /trunk/libdate-calc-perl/debian: NEWS changelog
carnil-guest at users.alioth.debian.org
carnil-guest at users.alioth.debian.org
Thu Oct 8 20:28:33 UTC 2009
Author: carnil-guest
Date: Thu Oct 8 20:28:28 2009
New Revision: 45539
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=45539
Log:
Add debian/NEWS to refer to the backwards compatibility notes for new
upstream version.
Added:
trunk/libdate-calc-perl/debian/NEWS
Modified:
trunk/libdate-calc-perl/debian/changelog
Added: trunk/libdate-calc-perl/debian/NEWS
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libdate-calc-perl/debian/NEWS?rev=45539&op=file
==============================================================================
--- trunk/libdate-calc-perl/debian/NEWS (added)
+++ trunk/libdate-calc-perl/debian/NEWS Thu Oct 8 20:28:28 2009
@@ -1,0 +1,55 @@
+libdate-calc-perl (6.0-1) unstable; urgency=low
+
+ In version 6.0 of Date::Calc the interface to DateCalc.c has changed. Thus
+ check for details `/usr/share/doc/lidate-calc-perl/README.txt.gz'.
+
+ Backward compatibility:
+ -----------------------
+
+ Module "Date::Calc" should be 100% backward compatible, meaning
+ that no changes to existing code using reasonably recent versions
+ of "Date::Calc" should be necessary (consult the changes history
+ in file "CHANGES.txt" for possible incompatible changes between
+ versions).
+
+ Note that when you pass an invalid language number to any of the
+ affected functions, you will get the previous behaviour, in which
+ a global variable (set by the function "Language()") determines
+ the language to be used.
+
+ Note again that this new language parameter in the affected functions
+ is optional; omitting it gives you the previous behaviour with the
+ global variable as well (this is where the compatibility with existing
+ code stems from).
+
+ When using the C library "DateCalc.c", where omitting a parameter
+ is not an option, passing a zero for the language is therefore the
+ recommended way to guarantee backward compatibility and to keep
+ changes to existing code to a minimum.
+
+ Modules "Date::Calc::Object" and "Date::Calendar::Year" should be
+ backward compatible as well (modules "Date::Calendar" and
+ "Date::Calendar::Profiles" have not been changed).
+
+ However, because the global variable (the one set by the function
+ "Language()") is not set temporarily anymore by language-dependent
+ methods and overridden operators (and restituted at the end, very
+ similar to the "local" operator in Perl), you might perceive
+ differences if your existing code relied on these implementation
+ details (some test cases in the test suite of this package tested
+ this and had therefore to be changed).
+
+ The advantage to be gained by all this is that now, all modules
+ in this package should be thread-safe and safe to be used by
+ several concurrently executed modules, as long as you do not
+ set the language using the global function "Language()" or the
+ CLASS method "language()" (and as long as you do not use any
+ other global setting, for that matter), but EXCLUSIVELY by
+ passing the language parameter to all functions individually
+ and by using the OBJECT method "language()".
+
+ By exclusively using local settings, you are also making your
+ code invulnerable against other, concurrent modules which still
+ use global settings.
+
+ -- Salvatore Bonaccorso <salvatore.bonaccorso at gmail.com> Thu, 08 Oct 2009 22:28:18 +0200
Modified: trunk/libdate-calc-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libdate-calc-perl/debian/changelog?rev=45539&op=diff
==============================================================================
--- trunk/libdate-calc-perl/debian/changelog (original)
+++ trunk/libdate-calc-perl/debian/changelog Thu Oct 8 20:28:28 2009
@@ -1,8 +1,10 @@
libdate-calc-perl (6.0-1) UNRELEASED; urgency=low
* New upstream release
-
- -- Salvatore Bonaccorso <salvatore.bonaccorso at gmail.com> Thu, 08 Oct 2009 22:19:07 +0200
+ * Add debian/NEWS to refer to the backwards compatibility notes for new
+ upstream version.
+
+ -- Salvatore Bonaccorso <salvatore.bonaccorso at gmail.com> Thu, 08 Oct 2009 22:27:15 +0200
libdate-calc-perl (5.8-1) unstable; urgency=low
More information about the Pkg-perl-cvs-commits
mailing list