2006-03-12 Mattias Holmlund
Version 0.7
Add NoUpdate option.
Remove Verbose output for HEAD requests.
2005-05-30 Mattias Holmlund
Version 0.6
Handle invalid cache-directories.
Create the cache directory if it doesn't exist.
Store the headers Content-Type, Content-Length, Content-Encoding,
Content-Range and Last-Modified in the cache and restore them
when returning a cached response.
Fix bug in ETag cache handling.
1.62
- interface to libxml2's pull-parser XML::LibXML::Reader
(initiated by Heiko Klein)
- make error messages intended to the user report the line of the
application call rather than that of the internal XS call
- XML::LibXML::Attr->serializeContent added (convenience function)
- fix getAttributeNode etc. w.r.t. #FIXED attributes (as well as some
cases with old buggy libxml2 versions)
- warn if runtime libxml2 is older than the one used at the compile time
- if compiled against libxml2 >= 2.6.27, new parse_html_* implementation is used
allowing encoding and other options to be passed to the parser
- DOM-compliant nodeNames: #comment, #text, #cdata, #document, #document-fragment
- toString on empty text node returns empty string, not undef
- cloneNode copies attributes on an element as required by the DOM spec
0.15 08 Feb 2007 Grant McLean
- Fixed handling of entities in attribute values
- Cleaned up some benign warnings
0.14 23 Apr 2006 Matt Sergeant
- Fixed CDATA section parsing (Uwe Voelker)
- Fix Makefile.PL for VMS
- Support calling set_handler() mid-parse
- Fix for when random modules overload UNIVERSAL::AUTOLOAD()
- Fix case when ParserDetails.ini isn't being updated but we are doing an
upgrade.
0.13 24 Oct 2005 Matt Sergeant
- Complete re-write of XML::SAX::PurePerl for performance
- Support Encoding & XMLVersion in DocumentLocator interface
- A few conformance tweaks to match perl SAX 2.1.
2007-01-21 Tim Jenness
--- RELEASE 0.18 CPAN ---
* Temp.pm: Provide "cmp" overloading so File::Temp object can
be compared to filename directly. (Rafael Garcia-Suarez)
* Temp.pm: Remove umask control (was not thread-safe)
(thanks to Peter Dintelmann, Gisle Aas)
* t/cmp.t: New test file
0.10
Better implementation of _common_prefix_length
by Tassilo von Parseval
0.11
Require a more recent Test::Builder::Tester,
since tests fail with 1.03.
1.18 Wed 25 Oct 2006 - Adam Kennedy
- Changing to a production version for final release
- No other changes of any kind
1.17_05 Tue 19 Sep 2006 - Adam Kennedy
- Seperated the classes from the main file into seperate packages.
- Merged the Zip.pod into the main Zip.pm file.
- Applied default Perl::Tidy to all of the source files, to improve
the readability and maintainability of the files.
- Added license in Makefile.PL
- Added some additional entries to the realclean files
File::Which is a portable implementation (in Perl) of `which', and
can be used to get the absolute filename of an executable program
installed somewhere in your PATH, or just check for its existence.
It includes the command-line utility `pwhich' which has the same
function as `which'.
2005-10-26 Gisle Aas
Release 2.09
Simplified and reworked documentation.
Unicode::CharName::uname() did not work for chars > 0xFFFF.
2005-10-25 Gisle Aas
Release 2.08
Unicode::String now provide utf16le() and utf32le() constructors.
Corresponding methods also available.
Unicode::CharName updated with Unicode 4.1 data.
1.4 Sun Nov 7 09:30:29 GMT 2004
- More fixes from the fantastic Mr Thurn
1.3 Fri Oct 15 16:24:47 BST 2004
- Fixes from Martin Thurn
1.2 Wed Sep 8 16:32:28 BST 2004
- Fix UK template layout
1.1 Wed Jun 2 09:57:59 BST 2004
- Changes to US template layout
1.0 Tue Dec 16 14:55:15 2003
- switch to using Template::Extract
- add more fields
- cleanup
0.9 Tue Feb 11 12:30:16 2003
- set User Agent again to fix weirdness
- ASIN format has changed
0.85 Fri Oct 25 17:43:12 2002
- Fix some minor bugs
0.8 Mon Aug 36 10:25:33 2002
- Amazon changed the layout of their .com pages
so this heroic patch from the mysteriously
named Artimage fixes it. Actually he fixed it ages
ago it's just I was too slack to apply it and figure out
some stuff.
0.7 Wed Feb 27 13:10:56 2002
- there was some cruft creeping in if it was a DVD.
All fixed now :)
0.66 Tue Dec 18 17:28:54 2001
- fixed mistake in amazonwish documentation about where
your settings are saved.
[Changes for 0.40 - 2005-09-17]
* Support for capturing matched regular expressions into variables,
Contributed by "woremacx". For example, this captures an nonempty
header text into the "heading" variable:
<h2>[% heading =~ /((?!<\/h2).+?)/ %]</h2>
[Changes for 0.39 - 2005-07-15]
* Allow passing Template::Parser options directly into
Template::Extract->new(). Suggested by brian d foy.
* Factored out the parser into Template::Extract::Parser to
allow use of alternate parsers with the PARSE_CLASS class method.
[Changes for 0.38 - 2004-10-25]
* Fix test failure with pre-5.8.4's regex optimizer.
Reported by CPAN testers.
[Changes for 0.37 - 2004-10-20]
* Move under SVK for version management.
* If the template ends with a capturing variable, make it
greedy instead of nongreedy, so it won't always match the
empty string. Reported by LTJake on IRC.
[Changes for 0.36 - 2004-02-16]
* Separate the compilation and run parts into two
modules, for ease of deployment (::Run may be put
on a machine without TT2) and marginally faster
execution. Suggested by Bruno De Fraine.
[Changes for 0.35 - 2004-01-09]
* Fixes regression caused by newer TT2 versions,
which adds the extra "#line" directives into the
regular expressions. Spotted by Yi-Ming Cao
and Sam Smith.
* Implement suggestion from Luis Oliveira: embedded
non-capturing regexes, such as [% /\s*/ %].
* Add implicit optional newlines around [% FOREACH %]
blocks, so it can intuitively work.
[Changes for 0.33 - 2003-12-13]
* Adds MANIFEST.SKIP that takes care of Module::Build
files, so older versions of Module::Build/MakeMaker
won't trip Module::Signature over. Thanks to CPAN
smoker Jost Krieger for the report.
[Changes for 0.32 - 2003-12-13]
* Improved build intrastructure, suggested by Mark Fowler,
to automatically check and download nmake.exe on Windows,
as well as supporting a Module::Build-compatible Build.PL.
* Clarify documents; add links to Simon and Mark's articles.
[Changes for 0.31 - 2003-10-21]
* New flag $EXACT to control whether partial documents
should match. (defaults to 0 for backward compatibility)
* Tatsuhiko Miyagawa pointed out that [% FOREACH %] blocks
fail to match prematurely because it can match zero times.
Now outermost foreach blocks must match at least once.
[Changes for 0.30 - 2003-10-20]
* This module is no longer experimental. :)
* Russell Matbouli reports that extract did not properly
set \%values. Fixed.
* [% SET key = "value" %] now works inside FOREACHs.
* [% SET nested.key = "value" %] now works.
* Much more robust validating code inside FOREACHs.
* Refactored the common context walking code from "get",
"set" and "validate" into _ext, and improved readability.
0.54 Sun May 1 2005
- Minor changes to render-clock example
- Add new Host types from X11R6.7
- Fix handle_input_for bug reported by Rich Williams
0.55 Thu Jan 19 2006
- Fix spurious error on zero-length .Xauthority field in
X11::Auth (reported independently by Cyril Bouthors and
Anthony DeStefano)
0.56 Sun Oct 8 2006
- Fix infinite loop regression in robust_req in 0.54 caused by
handle_input change (found by Scott Smedley)
Changes in this release (0.5.45)
tv_grab_hr :new grabber for Croatia
tv_grab_ch_bluewin :new grabber for Switzerland (replaces tv_grab_ch)
tv_check :add a duplicate check for shows on multiple ReplayTV units
tv_grab_br_net :misc fixes
tv_grab_de_tvtoday :improved category and sub-title recognition
tv_grab_dk :Only critical warnings when running with --quiet
tv_grab_ee :misc fixes
tv_grab_fi :default --days now 14 (all available).
tv_grab_fr :added --perdays option, now default grab mode
tv_grab_huro :misc fixes
tv_grab_il :misc fixes (plus now in xmltv.exe)
tv_grab_na_dd :fixes for "invalid start time". Don't return shows before starttime.
tv_grab_na_icons :misc fixes
tv_grab_no :misc fixes
tv_grab_re :misc fixes
tv_imdb :misc fixes
And lots of bugfixes and polish.
Changes in this release (0.5.44)
Additional work to provide a more consistent behaviour from all
grabbers
and a way for grabbers to express what they support. See
http://membled.com/twiki/bin/view/Main/XmltvCapabilities
tv_grab_it : New channels added
tv_grab_br : Fixed to deal with data source changes
tv_grab_br_net : lots of improvements
tv_grab_na_icons : fixed to deal with data source changes
tv_grab_za : add proxy server support
tv_grab_se_swedb : new grabber for Sweden
tv_grab_es_laguiatv : new alternative grabber for Spain
tv_grab_ch : remove grabber ( blocked by data source )
And lots of bugfixes and polish.
* Changes in this release (0.5.43)
More consistent behaviour from all grabbers and a way for grabbers to
express what they support. See
http://membled.com/twiki/bin/view/Main/XmltvCapabilities
A testing framework that tests the behaviour of grabbers and their
output.
A new tool for testing a grabber, tv_validate_grabber.
A new tool for testing that a file is in a valid xmltv format,
tv_validate_file.
A new tool for listing all grabbers installed on the system,
tv_find_grabbers.
See http://membled.com/twiki/bin/view/Main/HowtoUseGrabbers
tv_grab_ch: Filter data to match --days and --offset.
tv_grab_de_tvtoday: Updated after site changes. Fixed unicode problems.
Filter data to match --days and --offset.
tv_grab_br: Updated to match site-changes.
tv_grab_br_net: New grabber for Brazil (NET cable).
tv_grab_fi: Grab data from telkku.com.
tv_grab_fr: Updated to match site-changes. Return more data for
programmes.
Filter data to match --days and --offset.
tv_grab_huro: Updated to match site-changes.
tv_grab_na_dd: Use numeric time-offset for UTC.
tv_grab_nl: Updated to match site-changes.
tv_grab_no: Better xmltvids. Bugfixes.
tv_grab_pt: Ignore channels with invalid xmltvids.
tv_grab_re: Updated to match site-changes. Implement proper xmltvids.
Misc. fixes.
tv_grab_se_swedb: Implement configuration API.
tv_grab_uk_rt: Updated channel ids.
Filter data to match --days and --offset.
tv_grab_il: New Grabber for Isreal ( and use numberic TimeZones )
And lots of bugfixes and polish.
1.11
- Skip %V test on Win32
1.10
- Number of bug fixes from RT
- (maintenance by Ricardo SIGNES)
- avoid warning in _mktime (bug #19677)
1.09
- (patches from Ricardo SIGNES)
- Tests largely moved to Test::More (from Test.pm)
- Time::Piece should now be safely subclassable
1.9706 [2007-02-25]
- with bleadperl in VMS the HiRes.t overrun the maximum number
of deferred signals because the libc SIGALRM was not strong
enough to interrupt select(), and select() got restarted every
time, solution is to use POSIX::SigAction if available.
A fix from Craig Berry (not 100% there, but helps).
- allow for more measuring noise for ualarm() tests 35..37
1.9705 [2007-02-06]
- nanosleep() and clock_nanosleep() detection and use were
quite broken; in Linux -lrt needed; fixes from Zefram
- [internal] slightly cleaner building of $DEFINE in Makefile.PL,
should avoid double/conflicting -D flags
1.9704 [2007-01-01]
- allow 10% of slop in test #14 (testing difference between
CORE::time() and Time::HiRes::time()), there seem to be often
transient failures from Perl smoke builds on this test
- small pod tweaks
1.9703 [2006-12-08]
- use int main(int argc, char **argv) consistently in Makefile.PL,
should help with
[rt.cpan.org #23868] nanosleep not detected under Mac OS 10.3.9 starting with Time::HiRes 1.96
- if someone still has the locale-broken Perl 5.8.0,
suggest that they upgrade their Perl
1.9702 [2006-12-06]
- restore the -DATLEASTFIVEOHOHFIVE, Win32 needed it still
1.9701 [2006-12-04]
- upgrade to ppport.h 3.10_02
- remove the -DATLEASTFIVEOHOHFIVE
- use the ppport.h PL_ppaddr, PL_statcache, PL_laststatval
- use the ppport.h aTHXR for calling Perl stat()
- switch into four-digit version since 2.0 is coming up
awfully fast but not feeling like a major rewrite
1.97 [2006-11-30]
- 1.95 broke building in Win32 (since pp_stat is not exported),
figured out how to call an op directly in 5.005 (use Perl_ppaddr
instead of PL_ppaddr)
- backport to Perl 5.004_05 (requires using statcache
and laststatval instead of PL_statcache and PL_laststatval)
(also checked to work in 5.005_04, 5.6.1, and 5.8.8 with threads)
1.96 [2006-11-30]
- 1.95 broke builds for threaded Perls, rt.cpan.org tickets:
[rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
[rt.cpan.org #23712] Time-HiRes 1.95 Fails make on AIX 5.2 with Perl 5.8.8
[rt.cpan.org #23730] Time::HiRes 1.95 fails make on MacOS X 10.3.9/perl 5.8.8
- use main() prototype consistently in Makefile.PL
1.95 [2006-11-29]
- integrate core change #29180: Silence VC++ compiler warnings
from Steve Hay
- do not use PL_ppaddr in stat() because that is not available
in Perl 5.005_04
- regenerate fallback/*.inc for older Perls without
ExtUtils::Constant because of d_hires_stat, resolves
[rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
- Make Makefile.PL more defensive against false PERL_CORE
1.94 [2006-10-16]
- file timestamps oddities seen: the atime and mtime
can be out of sync (modify first and read second can leave
atime < mtime) and mtime can be subsecond while atime is not.
So make the test more forgiving.
1.93 [2006-10-15]
- the ualarm() tests (34-37) assumed that ualarm(N)
could never alarm in less than N seconds, widened
the acceptable relative range to 0.9..1.5. Addresses
[rt.cpan.org #22090] and [rt.cpan.org #22091].
- skip the stat() tests in cygwin and win32, because
if run on FAT the timestamp granularity is only 2 seconds.
Any good way to detect (cygwin or win32) whether we are
being run on NTFS or anywhere with better timestamps?
Addresses [rt.cpan.org #22089] and [rt.cpan.org #22098].
1.92 [2006-10-13]
- scan for subsecond resolution timestamps in struct stat,
some known possibilities:
(1) struct timespec st_atimespec;
st_atimespec.tv_nsec;
(2) time_t st_atime;
long st_atimensec;
(3) time_t st_atime;
int st_atime_n;
(4) timestruc_t st_atim;
st_atim.tv_nsec
(5) time_t st_atime;
int st_uatime;
If something like this is found, one can do
use Time::HiRes;
my @stat = Time::HiRes::stat();
or even override the standard stat():
use Time::HiRes qw(stat);
to get the stat() timestamps
my ($atime, $mtime, $ctime) = @stat[8, 9, 10];
with subsecond resolution (assuming both the operating
system and the filesystem support that kind of thing).
Contributions for more systems (especially non-UNIX,
e.g. but not limited to: Win32, VMS, OS/2) gladly accepted.
(also more UNIX variants welcome: HP-UX? IRIX?)
Thanks to H.Merijn Brand, John Peacock, and Craig
Berry for brave beta testing.
1.91 [2006-09-29]
- ualarm() in SuSE 10.1 was overflowing after ~4.2 seconds,
possibly due to a glibc bug/feature (suspected overflow at
2**32 microseconds?), workaround by using the setitimer()
implementation of ualarm() if either useconds or
interval > 999_999 (this case seems to vary between systems:
are useconds more than 999_999 for ualarm() defined or not)
Added more ualarm() tests to catch various overflow points,
hopefully no problems in various platforms.
(The problem report by Mark Seger and Jon Paul Sullivan of HP.)
1.90 [2006-08-22]
- tweak still needed for Const64(), from Jerry Hedden
- get a freshly generated ppport.h
- update Copyright years
1.89 [2006-08-22]
- Const64() already appends an 'LL' (or i64), so provide LL and i64
forms for the IV_1E[679] (effects Win32 and Cygwin), reported by
Jerry Hedden.
- the Changes entry for 1.88 talked about [IN]V_1[679],
missing the 'E'.
1.88 [2006-08-21]
- clean up the g++ warnings in HiRes.xs, all of them
about mixing integer and floating point, introduce
constants IV_1E[679] and NV_1E[679]
0.36
[ BUG FIXES ]
- For infinity, use 100 ** 1000 instead of 100 ** 100 ** 100. This may
fix the problems with infinity on some platforms (or may
not). Suggested by Bjorn Tackmann. See RT #17390, #19626, and
#22392.
- Require DateTime::TimeZone 0.59, which includes a similar fix.
0.35 2006-10-22
[ ENHANCEMENTS ]
- Added several new methods for getting locale-based data, era_abbr(),
era_name(), quarter_abbr(), and quarter_name(). The era() method
returns the same data as era_abbr(), but is deprecated.
0.34 2006-08-11
[ BUG FIXES ]
- DateTime's code to fall back to the pure Perl implementation was
broken in most cases, making it fairly useless. Reported by Adam
Kennedy and Brendan Gibson.
- Under Perl 5.6.2 (and presumably 5.6.x), some of the tests
mysteriously failed. I tracked this down to a weird interaction
between DateTime's string overloading and
Test::Builder->cmp_ok(). See RT 19626.
0.33 2006-08-09 (the "Asia/Kaohsiung" release)
[ ENHANCEMENTS ]
- Attempting to do an overloaded operation (add, subtract, compare)
with an inappropriate argument (like $dt + 1) gives a more useful
error message.
[ BUG FIXES ]
- The fixes in 0.30 for subtract_datetime() crossing a DST change had
a bug. When subtracting two dates, both occurring on a DST change
date, but where the dates did not cross the change, the answer was
off by an hour. Reported by Chris Prather. See RT 20697.
- Borrowed a tweak from version.pm's Makefile.PL to make compiler
detection work with MSVC.
0.32 2006-07-24
[ BUG FIXES ]
- Change how C compiler detection is done in the Makefile.PL so it
does not rely on having make on the system. The new way should work
on (most?) Unix and Win32 systems. Suggested by David Golden. See RT
18969.
0.31 2006-05-21
[ ENHANCEMENTS ]
- Switched some uses of die() to Carp::croak(), where
appropriate. This should make error messages more useful in many
cases. Based on a suggestion by Max Maischein. See RT tickets 11692
& 18728.
[ BUG FIXES ]
- Removed all uses of UNIVERSAL::isa and UNIVERSAL::can as functions.
- Tweaked 20infinite.t test to give more useful output for some
failures, though it probably doesn't fix them. See RT 17390.
0.33 2007-01-06
- Based on CLDR 1.4.1.
- Some locales had am/pm names like "HASH(...)" because of a bug in
the script to generate the locale modules.
0.32 2006-11-20
- A bug in the STORABLE_freeze method in this class caused major test
failures for DT::Calendar::Chinese, which is used by
DT::Calendar::Japanese.
- Do better checking of locale names passed to DT::Locale->load(), so
we catch undef early before it causes a bunch of warnings.
0.3101 2006-10-23
- Fixed a test failure when DateTime::Locale is installed on a system
where DateTime.pm has never been installed.
- Fixed a test failure in bleadperl. RT Ticket #22515. Reported by
Steve Peters.
0.31 2006-10-22
- Added era_name() and era_abbreviation() methods for the use of
DateTime.pm.
0.30 2006-10-22
- Now using the CLDR data instead of ICU. This isn't a big change,
since the ICU data was derived from the CLDR data anyway.
- Based on CLDR 1.4.
* BACKWARDS INCOMPATIBILITY - Integrated the ISO639-2 aliases into
DateTime::LocaleCatalog, and removed
DateTime::Locale::Alias::ISO639_2.
- The data now include both abbreviated and long forms for eras. The
eras() method continues to return the abbreviated forms, but this is
deprecated. Use era_abbreviations() or era_names() instead.
- Added a STORABLE_attach method for integration with newer versions
of Storable which provide better support for singletons.
- The narrow versions of days and months was not available for most
locales, even though every locale should provide at least the
default values for these items.
0.62 2007-02-26
- This release is based on version 2007c of the Olson database.
0.6101 2007-02-18
- Fixes a major bug in 0.61. Passing "local" as a time zone new to
DateTime::TimeZone->new() caused a fatal error.
0.61 2007-02-18
- Lots of internal changes in the code used to determine a system's
local time zone.
- As a result, we now have a much better method for doing this on
Windows systems, by looking at the registry. See
DateTime::TimeZone::Local::Win32 for details.
0.60 2007-02-13
- This release is based on version 2007b of the Olson database.
0.59 2007-01-18
- When trying to find the local timezone for a machine based on
/etc/localtime, ignore /usr/share/zoneinfo/posixrules. This fixes a
bug seen on FreeBSD 6.2. Reported by . RT #24026.
- For infinity, use 100 ** 1000 instead of 100 ** 100 ** 100. This may
fix the problems with infinity on some platforms (or may
not). Suggested by Bjorn Tackmann.
0.58 2007-01-08
- This release is based on version 2007a of the Olson database.
0.57 2006-11-27
- This release is based on version 2006p of the Olson database.
0.56 2006-11-16
- Really fix the sorting of names_in_country(). Patch by Tatsuhiko
Miyagawa.
- Allow names like "JST-9" and "GMT+0" in $ENV{TZ} when trying to find
the local time zone. Reported by Tatsuhiko Miyagawa.
0.55 2006-11-06
- This release is based on version 2006o of the Olson database.
0.54 2006-10-25
- Got rid of the STORABLE_attach methods. This was causing bugs when
trying to freeze/thaw a DateTime.pm object, and I realized that
because of how the DT::TimeZone internals work, there's not much
gained by using STORABLE_attach instead of STORABLE_freeze. Even
with STORABLE_freeze, the core data structures for a timezone are
still shared.
0.53 2006-10-24
- Freezing and thawing a DT::TimeZone::OffsetOnly object was broken in
0.52 (and probably earlier versions as well). Reported by Tatsuhiko
Miyagawa.
- Freezing and thawing a DT::TimeZone::Floating object was also broken.
0.52 2006-10-22
- The names_in_country() method no longer sorts the zone
names. Instead, it returns them in order from most- to
least-populated.
- Added a STORABLE_attach method for integration with newer versions
of Storable which provide better support for singletons.
- Made offset_as_seconds() and offset_as_string() work as class
methods, since the docs say they should. Reported by Tatsuhiko
Miyagawa.
0.51 2006-10-13
- Added two new catalog-related functions, countries() and
names_in_country(). Using these functions allows you to map ISO3066
country codes to the time zones used in that country. Based on code
by Tatsuhiko Miyagawa.
0.50 2006-10-10
- This release is based on version 2006n of the Olson database.
0.49 2006-10-02
- This release is based on version 2006m of the Olson database.
0.48 2006-09-18
- This release is based on version 2006l of the Olson database.
- Fix finding of local time zone when there is a $SIG{__DIE__} handler
in effect. The handler broke the internal use of exceptions in one
of DateTime::TimeZone::Local's methods. Reported by JD Hedden. RT
#20982.
0.47 2006-08-22
- This release is based on version 2006j of the Olson database.
- Added a link to Asia/Tokyo for the "JST-9" timezone. According to
Kenichi Ishigaki this is a TZ env var setting commonly used in
Japan.
- Some links in the Olson data pointed to other links, or pointed to
non-existent zone names. These have been fixed so that all links
resolve to valid zones, and this is now part of the test suite.
0.46 2006-05-08
- This release is based on version 2006g of the Olson database.
0.45 2006-05-01
- This release is based on version 2006f of the Olson database.
1.17 - Thu Feb 22 13:20:23 2007
* Updated to Sourceforge's SVN repository
* Dist conforms to META 1.2 spec
* No feature changes, so no big hurry to upgrade
1.16 - Tue Aug 29 17:43:16 2006
* Added an experimental feature to grab file names from additional
files. Just specify which other files to grab file names from:
;include names_in_this_file.txt
See the docs for get_t_files().
* This is an experimental feature. This feature is experimental.
Revision history for Perl extension Module::Build.
- On some systems (haven't identified the actual problem yet)
$ENV{PERL5LIB} can grow to enormous enough sizes that we can't
launch any more subprocesses because the environment table is full.
This is the now-infamous "Couldn't run Build.PL: Argument list too
long" error. Now we detect such situations and trim the directory
list to only include directories that actually exist, listed only
once each. Not the ideal solution, but it should work.
- Silence a warning in M::B::ModuleInfo that happens when the author
is using the "$VERSION = eval $VERSION" idiom.
- When running the 'testcover' action, do "cover --delete" if any of
the test files have changed (we already did so if any of the code
under test has changed). [Suggested by Chris Dolan, RT #23584]
- Fixed a broken link in the documentation about PREFIX. [Spotted by
David Steinbrunner]
- Changes to do_system() & friends on VMS to get system calls working
much better there. [Craig Berry]
- Added the "pardist" target which creates a PAR binary distribution
akin to a PPM distribution. [Steffen Mueller]
- Added the Interix platform as a Unix variant. [Stephen Hartland]
- Improved the error message we emit when a distribution contains XS
files but the user has no C compiler. [Suggested by Andreas Koenig]
0.2805_01 Thu Sep 7 21:57:29 CDT 2006
- Because of a weird behavior of YAML::Node, any distribution that
used version.pm objects to define their versions was generating the
wrong syntax for the versions in their META.yml file. They will
now appear as strings like v3.42.1 or similar, including the
leading v.
- Upgraded to version 0.67 of version.pm. [John Peacock]
- Added a contrib/ directory with a bash completion function for M::B
actions and switches. [Julian Mehnle]
- When we eval() the embedded version.pm code we will now die() if
the eval() was unsuccessful, rather than continuing blindly on and
dying mysteriously later.
- Added a 'retest' action that lets users run the current regression
tests on a previously-installed version of a distribution.
* Instead of storing an entire dump of the Config.pm hash in the
_build/ directory upon startup, we now just store any overrides the
user or author has specified. Note that if you were doing anything
you weren't supposed to be doing, like poking around in the
internals of $buld->{config}, your code might break, so I've put
the asterisk of incompatibility on this one just to cover my
tuchus. [Idea originally by Randy Sims]
- Made copying files via copy_if_modified() a little less chatty.
0.2805 Sat Jul 29 22:01:24 CDT 2006
- We now embed a copy of version.pm right in the
Module::Build::Version source code, with John Peacock's blessing,
in case the user has a rough time installing version.pm. This
helps alleviate troubles people were still having with working out
a seemingly circular dependency (even though version.pm now ships
with a standard Makefile.PL too). A version.pm >= 0.661 installed
on the system will take precedence over our bundled one. [John
Peacock]
- Fix some test warnings (or failures?) related to version.pm
numification. [John Peacock]
- The top-level 'version' entry in META.yml files we'd generated was
in the wrong format (it was being treated as a version.pm object
rather than a serialized copy) due to a weird YAML::Node issue.
Fixed.
- Don't 'use base qw(version)' anymore in our M::B::Version wrapper,
just set @ISA directly, because some people have reported that the
'use base' line is croaking.
- Added an 'allow_mb_mismatch' parameter to suppress the startup
check that ensures the version of M::B currently running is the
same as the one initially used to run the Build.PL. Use with
caution.
- Module::Build::ModuleInfo will no longer detect things that look
like $VERSION assignments after an __END__ or __DATA__ token.
- Updated documentation to mention the new mailing list on perl.org
rather than the old one on sourceforge.
0.2804 Sun Jul 16 16:41:25 CDT 2006
- Added 'use version;' in Module::Build::Version, because some
versions of base.pm won't automatically load version.pm when we do
'use base qw/version/;'. [Spotted by Erik Tank]
0.2803 Sat Jul 15 08:26:34 CDT 2006
- The META.yml file in the last release was all screwed up, so the
distribution wasn't indexed properly. Fixed in this release.
0.2802 Fri Jul 14 22:40:34 CDT 2006
- Added reliance on version.pm, which means we should deal much
better with the wide range of version specifications one finds on
CPAN. This is made possible by recent releases of version.pm that
give the user a pure-perl option, so installing version.pm
shouldn't be too onerous for most users. [John Peacock]
- We should be accepting the default when we're in unattended mode,
not acting dumb and ignoring both the default and the [empty]
answer from the user. Fixed. [Spotted by Nik Clayton]
0.2801 Sun May 21 00:07:40 CDT 2006
- Module::Build::Compat's emulation of INC is incorrectly prepending
a -I to the value of INC. This is incorrect because there should
already be a -I on the value. I.E. it's "perl Makefile.PL INC=-Ifoo"
not "perl Makefile.PL INC=foo" so Compat should not prefix a -I.
[Michael Schwern]
- Native batch scripts under Windows should not be converted by
pl2bat. [Spotted by Ron Savage]
- Tweaked the way we determine whether a file is executable on Unix.
We use this determination to decide whether to make it executable
during installation. [Julian Mehnle]
- Replaced a vestigial 'next' with 'return' now that the code is in a
subroutine (htmlify_pods()), not a loop. [Ron Savage]
- Fixed a guaranteed failure in t/signature.t when TEST_SIGNATURE was
set. [Eric R. Meyers]
- Fixed a test failure that occurred when testing or installing in
unattended mode - the code to test whether unattended mode and
attended mode are working properly was assuming that we started out
in attended mode. [Steve Peters]
- Improved our stand-in YAML generator that we use to generate
META.yaml when authors don't have a copy of YAML.pm installed on
their machine. It was unable to handle things like embedded
newlines in the data, now it has a much more extensive escaping
mechanism. [Stephen Adkins]
- Revised the docs for --prefix and PREFIX. [Michael Schwern]
0.28 Thu Apr 27 22:25:00 CDT 2006
- When y_n() or prompt() are called without a default value and the
build seems to be unattended (e.g. in automatic CPAN testing), we
now die() with an error message rather than silently returning
undef for prompt(), or looping indefinitely for y_n().
- When searching for '.modulebuildrc', return the first HOME-like
directory that actually contains the file instead of the first
existing directory. Document the search locations and the order
searched. [Spotted by David Golden]
- Split the API documentation out of Module::Build::Authoring into
its own document: Module::Build::API.
- We should not emit a warning if a Module::Build subclass is
required in a Makefile.PL that is not bundled in the current
distribution; it may be installed on the user's system. [Spotted by
Tyler MacDonald]
- copy_if_modified() now preserves the executable bit of the source
file. [Spotted by Julian Mehnle]
- Fixed compatibility of our screen-scraping the Test::Harness output
so we can recognize the most recent Test::Harness version. [Steve
Hay]
- Backing out a requirement added in 0.27_06 on the method y_n()
to always include a default. This behavior would cause existing
build scripts to start failing. We now fail with a missing default
only when $ENV{PERL_MM_USE_DEFAULT} is set because there is no
reasonable default.
- Make install_types() method smarter with respect to custom install
types.
- Add documentation for the install_base_relpaths() and
prefix_relpaths() methods. Improved their usage for a public API,
and added tests.
0.27_10 Tue Mar 28 22:50:50 CST 2006
- Added the create_packlist property, default true, which controls
whether packlist files will be written during installation. This
was already part of Module::Build 0.2609, but for some reason we've
forgotten it in the 0.27_xx series. [Spotted by Steve Kirkup]
- Document the versions of Module::Build where each feature, action,
constructor argument, and method was first publicly documented.
- More fixes for find_perl_interpreter() to work with BSD flavored
UNIX: Ensure we always return absolute paths; throw an exception
upon failure to find correct interperter; document everything.
- We now include our own YAML.pm work-alike that we can use when the
real YAML isn't installed. We might soon even start using it when
YAML is installed, because the YAML API and dependency chain have
been changing in unfavorable ways lately. [Stephen Adkins]
- Fixed some shell-argument-quoting issues on VMS. In the process,
we have added some support for avoiding tripping over
shell-argument-quoting issues on other platforms too. [Initial
patch by Craig A. Berry]
0.27_09 Sat Mar 11 22:48:54 EST 2006
- Fixed find_perl_interpreter() so we can find the perl executable
when running from uninstalled perl even when $^X contains a
relative path. [Yitzchak Scott-Thoennes]
- Fixed warning message where we were printing the wrong field names.
[Chris Dolan]
- Added a 'testpodcoverage' action that runs a POD coverage check for
all modules in the distribution. [Yanick Champoux]
- Added a Cookbook example of subclassing to modify an action. [Dylan
Martin and David Golden]
- When building HTML documentation, we were opening the POD file and
not checking whether the open succeeded, which of course caused
problems down the line if it failed. Now we do "or die(...)" like
everywhere else. [Spotted by Joerg Braun]
0.27_08 Fri Mar 3 21:22:41 CST 2006
- Due to shell quoting issues and differences in syntax between
various flavors of Windows, the code for the 'pl2bat' utility
distributed with Perl has been incorporated into M::B::P::Windows.
[Thanks to Dr Bean and Ron Savage for help testing and isolating
the problem.]
- Modify add_build_element() so that it only adds elements if they
don't already exist. [David Wheeler]
- Fixed a bug in the 'pass-through' Makefile.PL in which we would die
if CPAN::Shell->install returned false, but apparently this return
value is unreliable. Now we only die if the module is actually
unavailable after installation.
- Fixed testing problems on VMS related to non-case-preserving
filesystems. We now bundle Tie::CPHash in the distribution (just
for testing purposes, it doesn't get installed) to help with
this. [Craig Berry and Yitzchak Scott-Thoennes]
- We incorrectly documented the 'dynamic_config' flag in the META.yml
file as having a default value of false, but according to the
META.yml spec (which, for heaven's sake, we wrote) its default
value is true. Fixed. [Spotted by Adam Kennedy]
- The have_c_compiler() method was dying if the ExtUtils::CBuilder
module wasn't around, which is obviously an unhelpful thing to do.
Now it just returns false. [Spotted by John Peacock]
- Fix detection of $VERSION expressions that are not
assignments. [Spotted by Chris Dolan]
- Obfuscate one of our constructs that uses a $VERSION variable,
because it was getting picked up by ExtUtils::MakeMaker's
version-finder. [Spotted by Randal Schwartz]
- The config_data script for querying and/or setting a module's
config data was forgetting to call write() after setting config
values (though setting feature values was working fine).
Fixed. [Brian Duggan]
- On Windows, remove the pl2bat generated 'Build.bat' script without
the annoying "The batch file cannot be found." error. [Solution
provided by RazTK and foxidrive on newsgroup alt.msdos.batch]
- Our version comparisons should now work correctly with modules that
use version.pm to delcare their versions (e.g. "our $VERSION =
version->new('1.0.0')"). [John Peacock and Ron Savage]
- We now create a Build.bat script on versions of Windows where it
makes sense. [Yves]
- Fixed the verbiage around choosing the correct make-alike on
different platforms to suggest using 'perl -V:make'. [Suggested by
anonymous user]
0.27_07 Wed Feb 1 20:07:45 CST 2006
- The notes() method now returns the new value when called with two
arguments, just like when it's called with one argument. [Tyler
MacDonald]
- The notes() method now distinguishes among the values undef, 0, and
the empty string, where previously it didn't. [Tyler MacDonald]
- We now unshift(@INC) rather than push(@INC) for the directory where
a build subclass lives, so that we're sure to pick up the right
version and not some already-installed version. [perlmonkey]
- The SIGNATURE file for version 0.27_06 (and I'm sure for lots of
versions before that too!) was messed up, since we were modifying
some files after signing. This has been band-aided for the time
being by signing twice. [Reported by Chris Dolan]
0.27_06 Mon Jan 23 21:44:54 CST 2006
- Fixed an undefined-variable warning when building the META.yml file
and the author hasn't used the 'module_name' mechanism. [Chris Dolan]
- We should now work with recent (> 0.49) versions of YAML.pm when
creating the META.yml file. [Yitzchak Scott-Thoennes]
- The y_n() method now requires the default parameter, and the
prompt() and y_n() methods have been improved with respect to
how they behave/detect when there is no user to ask. We're now
more consistent with MakeMaker, including respecting the
PERL_MM_USE_DEFAULT environment variable. [Tyler MacDonald and
Yitzchak Scott-Thoennes]
- When building a README file using Pod::Text, work around a bug in
Pod::Text 3.01, which expects Pod::Simple::parse_file to take input
and output filehandles when it actually only takes an input
filehandle. [Yitzchak Scott-Thoennes]
0.27_05 Thu Jan 12 17:39:21 CST 2006
- In t/common.pl, we were attempting to let the user's installed
Test::More take precedence over ours, but getting thwarted by all
the test scripts' loading Test::More beforehand. Fixed. [Spotted
by Yitzchak Scott-Thoennes]
- In various test scripts, we were outputting some strings that
weren't strictly conformant with Test::Harness's expected input,
though it didn't actually cause problems. Now we're more
conformant, though not yet strict. [Spotted by Yitzchak
Scott-Thoennes]
0.27_04 Fri Dec 23 10:43:34 CST 2005
- Removed experimental feature that extended the prerequisite system
to apply ('requires', 'recommends', and 'conflicts') prereqs to all
actions. Most of the internal extensiblity has been retained so
that prereq types can easily be added, more selectively.
- Added a 'prereq_report' action that shows the user a well-formatted
list of all prerequisites, the versions required, and the versions
actually installed. [David Wheeler]
- Clarified the directory name that's created during the 'distdir'
action. [Suggested by Tyler MacDonald]
- Fixed a bug when creating the META.yml file without the help of
YAML.pm - some common strings weren't quoted & escaped properly.
Now only some uncommon ones are. [Spotted by Joshua ben Jore]
- Fixed a bug in which an "UNINST=1" argument specified to a
passthrough Makefile's "make install" wasn't actually seen by
Module::Build.
- Rather than dying when the Build script is run from the wrong
directory, it now simply chdir()s into the right directory and
keeps going. [Suggested by Dominique Quatravaux]
- Added an "Examples on CPAN" section to the cookbook, with an
initial entry pointing to John Peacock's SVN-Notify-Mirror
distribution.
- Add an invoked_action() method to return the name of the original
action invoked by the user.
- Add 'meta-spec' field to the generated META.yml file, including the
version of the specification followed by the current Module::Build
and the url where the specification can be found.
- Introduced two actions, 'html' & 'manpages', that generate
documentation for POD when the respective feature is enabled. The
actions will generate the documents even if there is no set place
to install to. However, if the actions are invoked as a dependency
of another action (e.g. build), the documentation will only be
built when there is a default or user-specified place to install to.
- Added support for environment variable, 'MODULEBUILDRC', which can
be used to specify the full path to an option file to use instead
of the default location of ~/.modulebuildrc. A special undocumented
setting of 'NONE' tells Module::Build not to load any user settings,
so tests can be run without tainting from user options.
- Documented and improved preliminary support for more Getopt::Long
style options are supported, including boolean options (--verbose,
--no-verbose), and use of hyphens in option names in addition to
underscores.
- The option to disable/enable reading of the ~/.modulebuildrc file
is changed from 'skip_rcfile' to 'use_rcfile'
- Allow the 'distmeta' action to continue when 'MANIFEST' is missing,
omitting the generation of the 'provieds' field. [Steven Schubiger]
- Fixed some failing regex from generated MANIFEST.SKIP file.
- Fixed an edge case in $VERSION parsing where we thought a package()
declaration was happening but it wasn't. [David Golden]
- Added docs for the install_destination() and install_types() methods.
0.27_03 (Beta for 0.28) Mon Oct 10 11:19:23 EDT 2005
- We now use ExtUtils::CBuilder to do all compiling of C code (for
example, when compiling XS modules). (This change actually
occurred in 0.27_01, but it was mistakenly omitted from the Changes
file.)
- Fixed an issue on Win32 (and other case-tolerant
non-case-preserving systems, possibly like VMS?) in which the
current working directory would sometimes be reported with
different case, fooling us into thinking that we were in the wrong
directory. [David Golden]
- The extra_compiler_flags setting was not actually being passed
along to ExtUtils::CBuilder so it could pass it along to the
compiler. Now it is.
- The synonyms 'scripts' and 'prereq' for 'script_files' and
'requires' were broken in a previous version (0.27_01, probably),
but now they're fixed. [David Golden]
- Previously, we assumed that any custom subclass of Module::Build
was located in _build/lib/. This is only true if the author used
the subclass() method, though. We now use %INC to find where the
custom subclass really is, so that we can "use lib" it. We also
issue a warning if it seems to be outside the build directory.
[Spotted by Peter Tandler]
- Added a URL for each license type that we know about, which will
appear as resources=>license: in the generated META.yml file.
- If the user passes a no_index parameter to our constructor, we now
pass that through when building the META.yml file. [Richard
Soderberg, RT #9603]
- A few more status messages can now be suppressed by using 'quiet'
mode. [Dave Rolsky]
- Added some more entries to the default MANIFEST.SKIP file. [Chris
Dolan]
- Our POD parser will now accept "AUTHORS" as well as "AUTHOR" when
looking for the author list in a module. [David Wheeler]
- When looking for the POD to auto-generate a README file, or for the
AUTHOR or ABSTRACT for the distribution, we now also look for a
*.pod with the same name as the *.pm file specified by
'version_from'. [David Golden]
- The recommended dependency on ExtUtils::ParseXS has been moved into
the "C_support" auto_feature.
- When building XS files, we now pass the -DVERSION and -DXS_VERSION
flags to the compiler. [Spotted by Jerry Hedden]
- If a distribution has XS files and Module::Build has not been
configured with the "C_support" feature, we now issue a
warning. [Suggested by Jerry Hedden]
- Added a dir_contains() method.
- Some versions of MakeMaker, CPANPLUS, and/or PAUSE thought that a
certain line of our code was declaring a $VERSION when we didn't
intend to. The line has been obscurified so they won't think that
anymore. [Jos Boumans, RT #14226]
- Added the Apache, MIT, and Mozilla licenses to the list of licenses
that this module knows about. [Bob Ippolito]
- Fixed a pretty significant typo in the documentation for
auto_features. [Spotted by Jonas B. Nielsen]
- In order to aid people who want to do customization of the META.yml
file, we've added a "metafile" property that can then be easily
overridden in subclasses, changed do_create_meta_yml() to
do_create_metafile(), and split out the code that actually
generates the YAML into a new method, write_metafile(). [David
Wheeler]
- Fixed a couple of non-helpful behaviors with extra_compiler_flags
and extra_linker_flags. These will automatically be run through
split_like_shell() when given to new() as strings.
- When the user doesn't have ExtUtils::ParseXS installed and we use
the old 'xsubpp', the displayed command line for creating the .c
file from the .xs file was missing its newline. Now it's got it.
0.27_02 (Beta for 0.28) Fri Jul 15 07:34:58 CDT 2005
- Provided initial support for the --prefix installation parameter,
which acts like MakeMaker's PREFIX. It is still highly recommended
NOT to use it when you could reasonably use --install_base or
--install_path or --install_dest, but that's just because the way
--prefix is designed is weird and unpredictable. Ultimately the
choice rests with the installing user. [Patches by Michael Schwern
and Rob Kinyon]
- Fixed a bug in subclass() which prevented people from using it to
subclass subclasses of Module::Build. [Chris Dolan]
- Added a 'pure_install' action, which for the time being is
identical to the 'install' action. [Jos Boumans]
- Fixed a POD error in an L<http://...> tag. [Offer Kaye]
- Note several options for automatically creating a new module dev
tree. [Suggested by Eric Wilhelm]
- Removed some hard-coded references to File::Spec::Unix in the
creation of HTML docs, which should help that code work in more
places, and help people not to panic when they look at it. [Spotted
by Yves]
- We now use Pod::Readme by default (instead of Pod::Text) to
generate the README file when the 'create_readme' option is used.
If Pod::Readme is not installed, we will still fall back to using
Pod::Text. [Robert Rothenberg]
- The values of the "prefix", "install_base", "install_path", and
"install_dest" parameters can now begin with "~" or "~user", and
we'll de-tilde-ify them by using glob().
- The (optional) auto-creation of the README and Makefile.PL files
have been moved from the 'distdir' action to the 'distmeta'
action. [David Golden]
- When looking for a .modulebuildrc file, we now use a fancier method
of trying to find the home directory, because $ENV{HOME} isn't a
very cross-platform variable. [Robert Rothenberg]
- We now memoize the output of the internal _default_INC() method,
since it uses backticks and might be kind of slow.
- When processing XS files, we now look for a typemap in lib/ as well
as using the system's default typemap. [John Peacock]
- The DESTDIR, PREFIX, and INSTALL_BASE arguments to "make install"
are now supported for pass-through Makefiles (they've been
supported for quite a while as arguments to "perl
Makefile.PL"). [Requested by Guillaume Rousse]
- Test::Harness has changed its output format in recent versions,
which threw off one of our tests. We now allow for this different
format. [Reported by Scott Godin]
- Fixed an issue that prevented Module::Build from upgrading itself
using its own API (which is how CPANPLUS uses it). There are still
some issues with this solution, however. See ticket #13169 in
rt.cpan.org. [Reported by Jos Boumans]
- Fixed a fatal error that occurred when a distribution's author
could not be determined from its POD nor from the call to
Module::Build->new() in its Build.PL. See ticket #12318 in
rt.cpan.org. [Reported by Jos Boumans]
- Apparently on Windows and cygwin it's not possible to use the "-pi"
switch to perl without a backup extension, so now we use ".bak" and
remove the backup file when we're done. Thus the "dist" action for
Module::Build itself can now be run on those platforms. [Yitzchak
Scott-Thoennes]
- Improved the handling of auto_features in the config_data access
script. [Yitzchak Scott-Thoennes]
0.27_01 (Beta for 0.28) Fri Apr 15 21:12:57 CDT 2005
Backward-incompatible (but better) changes:
* When using the 'install_base' option to choose a directory for
installing everything, perl modules now go into lib/perl5/ instead
of just lib/. It seems this is more consistent with people's
expectations, and the way I had it before was a bit peculiar to the
way I like things in my own home directory. [Michael Schwern]
* When the user is using the 'install_base' option, scripts will now
be installed by default in $install_base/bin/ rather than
$install_base/script/ . [Jan Hudec and Michael Schwern]
Major changes:
- The auto_features mechanism will now re-evaluate dependencies every
time feature() is called for an auto-feature, rather than freezing
the success/failure value during 'perl Build.PL' and using that
value for all eternity (or module update, whichever comes first).
This applies to both $build->feature() and
FooModule::ConfigData->feature() calls. [Requested by many]
- Added the meta_add and meta_merge mechanisms, which let the module
author add/merge arbitrary entries into the META.yml file.
- Now reads per-action default options from '$ENV{HOME}/.modulebuildrc'
if it exists. Command line options override anything set in the rc file.
- We now use ExtUtils::CBuilder to do all compiling of C code (for
example, when compiling XS modules).
- The creation of Unix man pages is no longer a strict necessity - it
has now been turned into an 'auto-feature' contingent on the
presence of Pod::Man and a location specified for man pages to go.
- A user-specified 'install_path' setting will now take precedence
over an 'install_base' setting. This allows the user to use
'install_base' to set the base for all elements in one go, and then
use 'install_path' to override specific paths or add paths for
additional kinds of targets.
- Split the main documentation from 'Module/Build.pm' into two
sections. The user level documentation and overview remains in
'Module/Build.pm', while a new document,
'Module/Build/Authoring.pod', has been created for module authors.
Minor changes:
- new_from_context() was losing its arguments in some cases (and not
because of inadequate training in forensic debate) - we now pass its
arguments directly to the Build.PL script rather than merging them
in afterwards.
- Let resume() return an object blessed into the appropriate class
if the user has provided a subclass, as specified by the
'build_class' property. This allows current() and new_from_context()
to behave more like factory methods returning objects of the correct
class based on context. [Ray Zimmerman]
- Refactored methods relating to parsing perl module files for
package, version, and pod data into a new class:
Module::Build::ModuleInfo. It should not be considered part of
Module::Build's API, because we may split it out entirely as a
separate CPAN module that we depend on.
- Added new method Module::Build::prepare_metadata() for authors to
override in order to add custom fields to META.yml.
- We now use Test::More for our regression tests. If the user
doesn't have it installed, we include a copy in t/lib/ that we can
use during testing.
- When copying files in the 'distdir' action, set permissions to match
the original files. [Julian Mehnle]
- When adding files like META.yml to the MANIFEST, we now tell the
user we're doing so by printing one of the "Added to MANIFEST: ..."
lines. [Ron Savage]
- Added a runtime_params() method, which lets a module author see
which parameters were overridden by the user on the command line
(or in whatever paradigm the user originally invoked Module::Build
from). [David Wheeler]
- Added the current_action() method, which, surprisingly, returns the
name of the currently running action. [David Wheeler]
- Added docs for run_perl_script().
- Added some stuff to the docs about why PREFIX is unsupported, and
what to use instead. [Steve Purkis]
- The simple get/set accessor methods for all the 'parameters' like
verbose(), license(), etc. now have auto-generated documentation in
Module/Build.pm.
- Created a Cookbook entry for 'Adding new elements to the install
process'
- We now add META.yml to the MANIFEST when META.yml is created, not
when MANIFEST is created. [Spotted by Ron Savage]
- Added some additional patterns to the suggested MANIFEST.SKIP
contents, and changed the docs so that we encourage the user to use
the MANIFEST.SKIP. [Ron Savage]
- Eliminated a redundant recipe from the Cookbook, now that there are
some more extensive recipes on how to add stuff to the
build/install sequences.
- Eliminated an undefined-variable warning when testing under perl 5.005
- When building HTML documentation, 'html_backlink' and 'html_css'
properties are now first-class properties, so they can be set from
the command line. [Suggested by Sagar R. Shah]
- Have script_files default to everything in bin. I believe this is
the least surprising behavior. [Suggested by Michael Schwern]
- If script_files is given a directory, consider each file in that
directory tree as a script to be installed. This avoids having to
remember to add to the script_files list every time you add a
program. [Suggested by Michael Schwern]
- We now only load Pod::Man when we actually need to build man pages.
- We now make Test::Harness use our carefully-selected path to a perl
executable regardless of Test::Harness's version. Previously we
let it figure stuff out for itself if it was a reasonably modern
version, but it's safer to make sure we're using the same perl
everywhere.
#------------------------------------------------------------------------
# Version 2.15 - 26th May 2006
#------------------------------------------------------------------------
Chomping Options
----------------
* Added the CHOMP_GREEDY option and '~' chomping flag. Changed
CHOMP_COLLAPSE to greedily chomp all whitespace (including multiple
newlines) and replace it with a single space. Previously it only
chomped one line. Renamed the CHOMP_ALL option to CHOMP_ONE which
makes more sense. CHOMP_ALL is still provided as an alias for
CHOMP_ONE for backwards compatibility. Thanks to Paul Seamons for
doing all the hard work on this.
http://tt2.org/pipermail/templates/2006-February/thread.html#8354
* Added code to the replace text virtual method to use a faster and
simpler implementation if the replacement text doesn't contain any
back references. Thanks to Josh Rosenbaum for all his efforts on
this.
http://tt2.org/pipermail/templates/2006-February/008344.html
Stash
-----
* Changed various tests for private/hidden variables (starting '_'
or '.') to use a regex defined in the $PRIVATE package variable in
Template::Stash. This can be redefined or undefined. Note that
the XS Stash only looks to see if $PRIVATE is defined or not, and
currently hard-codes the regex.
Plugins
-------
* Changed the Image plugin tag() method to call the name() method
instead of accessing the name directly, making it easier for
subclasses to provide an alternate name. Thanks to Cees Hek for
his patch.
http://tt2.org/pipermail/templates/2006-February/008423.html
* Change the AUTOLOAD regex in the Table plugin to be more robust.
http://tt2.org/pipermail/templates/2006-May/008602.html
Documentation
-------------
* Added the Template::Toolkit documentation pointing people to
the right place.
* Updated the Template::Stash::XS documentation to remove the
"experimental" description and tidy things up a bit.
#========================================================================
# Version 1.64 Date: 2007/01/02 (Adam Kennedy)
#========================================================================
* Bug fix to prevent crashing for users with no home directory
* Increase File::HomeDir dep to 0.61 which supports no home directory
cases properly.
#========================================================================
# Version 1.63 Date: 2006/08/03 (Adam Kennedy)
#========================================================================
* Unified version numbers and removed repository magic
* Removed "use warnings" to get the Perl version dependency back to 5.005
* Removed "use base Exporter" which doesn't always work
* Use File::HomeDir to find $HOME instead of doing it ourself, sorta
* Fixed a POD bug in AppConfig::Sys and added a 99_pod.t test
* Added a LICENSE file
Originally packaged by Bartosz Kuzma.
File::HomeDir is a module for dealing with issues relating to the location
of directories for various purposes that are "owned" by a user, and to solve
these problems consistently across a wide variety of platforms.
Version 5.8 09.10.2006
+ Stop testing that ->VERSION is a specific thing. I'm not sure why
that was ever tested in the first place.
Version 5.7 02.10.2006
+ Stop PAUSE from attempting to index DB package.
Version 5.6 02.10.2006
+ Fixed test to predefined croak/confess/cluck/carp functions don't
break tests.
+ Use Object::Deadly even saner.
+ Use named lexicals in diag().
+ Skip testing import of carp/croak/cluck/confess if they existed
prior to loading Carp::Clan.
+ Use exists &foo/defined &foo instead of symbol table hackery.
+ Remove all the symbol table hackery that had notes about avoiding
symrefs. That's dumb. It's better to be clear and have symrefs
than have unreadble code w/o symrefs.
+ Remove gratituous & sigil on function calls.
+ Changed f() so it accepts 1st parameter of carp/cluck/confess/croak
instead of 1/2/3/4.
+ Renamed files.
Version 5.5 02.10.2006
+ Change 01_..._carp.t to use Object::Deadly only if it is 0.08+
+ Changed wording of the O::D request in Makefile.PL
+ Allowed everything to be perltidied.
Although this is a maintenance release, there are some new features in
Krita (new filters and a smudge paint operation) and Kexi (a new User
Mode to deploy Kexi applications). Many bugs were fixed.
0.52, released Jan 22, 2007
Belatedly update the SVN::Web installation to note that Subversion
1.4.0 or above is now required to use SVN::Web.
0.51, released Jan 15, 2007
C<reposparent> functionality was inadvertently broken in 0.50. This
release fixes that. This was rt#24377 reported by Christoph Buescher
<Christoph.Buescher@fiducia.de>.
0.50, released Jan 12, 2007
SVN::Web now supports accessing repositories that are B<not> on the same
host as the SVN::Web installation. Repositories can be accessed using
the I<file:///>, I<http://>, and I<svn://> protocols.
A mechanism for configuring which actions are available on each page has
been introduced. See L<SVN::Web/"Action menu configuration"> for more.
A new action, L<SVN::Web::Blame> has been introduced. This generates
output that shows the Subversion annotation/blame information for a
file.
Diff output (from L<SVN::Web::Diff> and L<SVN::Web::Revision>) is now
generated by Subversion, rather than SVN::Web. This makes diff
generation much faster, and much less memory intensive. However, it
has meant that the I<context> option is no longer available.
There are several small tweaks to the diff and revision output.
Refactoring and rewriting has meant that L<Digest::MD5>, L<Text::Diff>,
and L<Text::Diff::HTML> are no longer prequisites.
A bug has been fixed in RSS generation. The contents of the
<description> element are now wrapped in CDATA markers to ensure that
any embedded markup is preserved.
There is now support for keeping localisation files in arbitrary
directories, configured by the C<language_dirs> configuration option.
This makes it simpler to maintain your own localisation files outside
of SVN::Web, and makes it easier to integrate third party actions in
to an SVN::Web installation.
See L<SVN::Web/Languages> and L<SVN::Web::I18N> for more details.
The Template::Toolkit C<log_msg> meta-filter has been replaced with a
Template::Toolkit MACRO, defined in F<_log_msg>. The effect is the
same, but this approach affords more flexibility (e.g., having
different log message filters per repository).
The log template now supports rudimentary 'paging' through the log
messages. I<Proper> paging support requires new functionality in
Subversion. Selecting the number of log messages to show per page
is also more straightforward.
L<SVN::Web::Revision> supports a C<max_diff_size> configuration option
to cope with revisions which may generate huge diffs.
The configuration file (F<config.yaml>) must contain a C<version> key,
otherwise a fatal error is generated.
Most extraneous whitespace is now removed from the templates when output
is being produced.
Documentation bug rt#22282, reported by Andrew Sterling Hanenkamp
<sterling@hanenkamp.com>, has been fixed.
0.49, released Aug 23, 2006
SVN::Web now properly supports Apache 2 / mod_perl 2. In addition, the
test suite contains tests that work under Apache 2, and ensure that
future changes should not introduce regressions in this functionality.
File::Spec is now used when constructing filesystem paths, instead of
assuming that the directory separator is F</>. This should allow the
use of native paths on Windows, e.g. F<< C:\path\to\svnweb >>.
A bug in the mod_perl handler meant that the [% script %] directive
wasn't generating fully qualified links. This resulted in links in
the RSS feed being relative. This is now fixed. Reported by
Dietrich Streifert <dietrich.streifert@visionet.de>.
When testing the generated F<httpd.conf> includes an explicit
C<ServerName> directive, removing a warning on some hosts. Reported
in rt#20170 by <fiajro@cy.ath.cx>.
Set permissions on the temporary directories when running tests as
root. Otherwise they fail. Reported in rt#20170 by
<fiajro@cy.ath.cx>.
Fix a bug encounted on Solaris. SVN::Core::time_from_cstring() was
returning negative numbers.
The questions that are asked when running C<< perl Build.PL >> can now
be answered and/or skipped by passing command line options to F<Build.PL>.
Run C<< perldoc Build.PL >> for the documentation options.
Paths to Apache modules are no longer hardcoded in F<conf/httpd.tt>.
C<apxs> is used to retrieve the value of the Apache library directory.
In addition, the name of the mod_perl .so file is now configurable, as
different systems call it different things.
Included documentation on using SVN::Web with the IIS web server.
Submitted by Tom Hukins <tom@eborcom.com> in rt#20341.
A bug in the author's testing environment meant that 0.48 shipped with
templates that generated HTML that was not strictly valid. This, and
the templates, have been fixed.
0.48, released Jun 28, 2006
The interface localisation can now be selected. The interface has always
been localised, but the mechanism for choosing it has been badly exposed.
SVN::Web now supports two configuration options (C<languages> and
C<default_language>) to specify the language selection.
In addition, the available configured languages are also exposed through
the (C<trac>) user interface, and the user can choose from the list of
available localisation. Their choice is saved in a cookie.
Generation of RSS feeds is now done using a template, instead of using
L<XML::RSS>. This removes a dependency on XML:RSS, and should make it
easier to customise the content of the RSS feed should you desire.
This fixes rt#18169, reported by Mike Ellery <mikee@s2technologies.com>.
RSS feeds are now autodiscoverable in modern browsers.
The formatting of timestamps is now configurable using
L<POSIX/strftime>. You can choose how timestamps are formatted, and
they can be displayed in UTC (the Subversion default), the server's
local timezone, or the timezone of your choice. See L<SVN::Web/"Time
and date formatting"> for details.
This fixes rt#18806, reported by Mike Ellery <mikee@s2technologies.com>.
Worked around a bug in Subversion where repository paths that were
specified with a tailing slash would trigger an assertion. This fixes
rt#19273, reported by Michael Schwern <MSCHWERN@cpan.org>.
Fixed a bug where the C<directory_umask> cache backend option was not being
treated as an octal number. This fixes rt#19272, reported by
Michael Schwern <MSCHWERN@cpan.org>.
The L<SVN::Web::Revision> action now show's the repository's youngest
revision if no C<rev> parameter is provided.
Fixed a bug in L<SVN::Web::Revision>. Revisions that contain files that
were copied from another file, modified, and then committed will now be
displayed properly instead of generating an error.
The documentation for L<SVN::Web> includes an example configuration for
Apache and FastCGI, contributed by Robert Spier <rspier@pobox.com>.
Made extensive changes to the test suite. Include tests that exercise
SVN::Web when running under C<svnweb-server>, as a CGI script, and as an
Apache mod_perl1 handler. These tests are optional -- the installer
is prompted at C<perl Build.PL> time whether to run these tests, and
to provide the information the tests need (such as the port to run on).
0.47, released May 6, 2006
Implement support for caching the results of the actions, using any of
the L<Cache::Cache> family of modules. In tests (see
F<t/benchmark.t>) this can yield a 20% or greater speed benefit. See
L<SVN::Web/"Data cache"> for details of how to enable the cache and
configure cache related options.
Support Subversion repo directories and files that have spaces or other
characters that should be URI escaped in their names. Fixes rt#19093,
reported by <gbloice@gmail.com>.
Commented out the references to L<Template::Plugin::Clickable> and
L<Template::Plugin::Clickable::Email> in the config file that is
generated by C<svnweb-install>. This stops log files filling up with
warnings if they're not present. The lines remain, commented out, as
a suggestion for users.
Improved the modperl2 support, fixing rt#19004, rt#18437, and rt#18346
(Garrison Hoffman <garrison@codefix.net>, <cpan@rickster.com>,
Thomas Nagel <me@thomasnagel.com>).
0.46, released Mar 9, 2006
Fixed a bug in C<svnweb-server>. The L<CGI> module is now always used
when running under this server, instead of L<CGI::Fast>. This should
fix problems if you are trying to use C<svnweb-server> on a host with
L<CGI::Fast> installed.
0.45, released Mar 8, 2006
Fixed a bug that broke mod_perl support.
0.44, released Mar 8, 2006
When browsing the repository the F<trac> templates now include age
of the file, expressed as {seconds, minutes, hours, days, weeks,
months, years} since the file was last modified.
The C<revision>, C<log>, C<view>, and C<rss> actions are much more
conservative with memory when processing commits that changed a large
number of files. Fixes rt#17359, reported by Dietrich Streifert
<dietrich.streifert@visionet.de>.
Included support for running under mod_perl2 as well as mod_perl1. Fixes
rt#17085 and rt#17350. Based on a patch from Garrison Hoffman
<garrison@codefix.net>.
Fixed a bug when running under mod_perl -- the HTTP headers were not
being sent. Some browsers could cope with this, others just displayed
the raw HTML. Reported by Dominic Mitchell <dom@happygiraffe.net>.
Entering a revision number that does not exist will now generate a
localised error message. Fixes rt#17822, reported by
<gk5885@kickstyle.net>
The L<SVN::Web::Revision> action will now not show diffs between
file revisions if either revision of the file has a non-text MIME type.
Fixes rt#17625, reported by Mike Ellery <mikee@s2technologies.com>.
Fixed some bugs in C<svnweb-server>. Option parsing works properly,
fixing rt#17347 (reported by <miyagawa@cpan.org>) and the
C<--net-server> option is now honoured.
C<svnweb-install> should now work if any directories in the install path
contain regexp metacharacters in the filename. Fixes rt#17282, reported by
<CORION@cpan.org>. It also emits warnings if copying files or making
directories during the install process fails, fixing rt#17283.
0.43, released Jan 25, 2006
Fix a syntax error in the config file generated by svnweb-install.
Fix the instructions and code for running under mod_perl.
When viewing an HTML diff, include a link to the plain text equivalent.
Showing diffs when viewing a revision is now optional, but defaults to on.
Require Exception::Class 1.22 or above. Versions below lack the necessary
C<caught()> syntax.
Improve the installation and configuration documentation.
Include C<svnweb-server>, a simple web server to make it easier for people
to get started with SVN::Web.
0.42, released Dec 16, 2005
Throw exceptions instead of die()ing on almost all errors. Catch the
exceptions and generate much friendlier error messages. Error messages
are now easy to localise.
When viewing a diff, the I<trac> templates show the two revision numbers
being compared, and include a link allowing the user to reverse the order
of the diff.
The syntax for specifying permitted actions, and the classes that implement
them, has changed. See L<UPDATING> for more information. This mechanism
also allows for easy configuration of per-action options.
A (partial) French localisation has been supplied by Cyril Brulebois.
Any C<svn:externals> properties that are set on a directory are now shown
when browsing that directory.
When viewing a file's revision log, you can now select two arbitrary
revisions and get a diff showing the changes between those revisions.
Fixes rt#15813.
If you only have one repository configured then the C<list> action can be
configured to immediately redirect to browsing that repository, saving the
user from having to click through an intermediate page. See L<SVN::Web::List>
for more information.
changes since 1.1.12:
2006-11-26
* Steven Grimm <sgrimm@facebook.com>: Performance improvements:
Dynamic sizing of hashtable to reduce collisions on very large
caches and conserve memory on small caches.
Only reposition items in the LRU queue once a minute, to reduce
overhead of accessing extremely frequently-used items.
Stop listening for new connections until an existing one closes
if we run out of available file descriptors.
Command parser refactoring: Add a single-pass tokenizer to cut
down on string scanning. Split the command processing into
separate functions for easier profiling and better readability.
Pass key lengths along with the keys in all API functions that
need keys, to avoid needing to call strlen() repeatedly.
2006-11-13
* Iain Wade <iwade@optusnet.com.au>: Fix for UDP responses on
non-"get" commands.
2006-10-13
* Steven Grimm <sgrimm@facebook.com>: New faster hash function.
2006-09-20
* don't listen on UDP by default; more clear message when UDP port
in use
2006-09-09
* release 1.2.0 (along with 1.1.13, which is the more tested branch)
2006-09-02
* Nathan Neulinger <nneul@umr.edu>: fix breakage in expiration code
causing expiration times to not be processed correctly.
2006-08-21
* Nathan Neulinger <nneul@umr.edu>: fix incompatabilities with
unix domain socket support and the UDP code and clean up stale
sockets
2006-08-20
* Nathan Neulinger <nneul@umr.edu>: unix domain socket support
2006-05-03
* Steven Grimm <sgrimm@facebook.com>: big bunch of changes:
big CPU reduction work, UDP-based interface, increased memory
efficiency. (intertwined patch, committed all together)
<http://lists.danga.com/pipermail/memcached/2006-May/002164.html>
or see svn commit logs
2005-08-09
* Elizabeth Mattijsen <liz@dijkmat.nl>: needed a way to flush all
memcached backend servers, but not at exactly the same time (to
reduce load peaks), I've added some simple functionality to the
memcached protocol in the "flush_all" command that allows you to
specify a time at which the flush will actually occur (instead of
always at the moment the "flush_all" command is received).
2005-05-25
* patch from Peter van Dijk <peter@nextgear.nl> to make
stderr unbuffered, for running under daemontools
- configure script already has provision for different compiler inline
directives, just not every file was using it.
- u_intXX_t types need to be fixed in installed event.h too.
Changes to previous version in easytag-devel (1.99.13):
2.0 - February 21th, 2007 :
===========================
* Added buttons in toolbar to search files, to search in cddb and to write
playlist,
* Added in the cddb window the option to match lines with the Levenshtein
algorithm,
* Fixed crash when no audio player is defined and problem of checking in the
preferences window,
* Added automatically removing of APE tag in a MP3 file,
* Improved decoding of Arabic characters,
* Added French Users Guide (Than to Emmanuel Brun),
* Swedish translation updated (thanks to Anders Strömer),
* Brazilian Portuguese translation updated (thanks to doutor.zero),
* Czech translation updated (thanks to Zbynek Mrkvicka),
* German translation updated (thanks to Götz Waschk),
* Italian translation updated (thanks to Costantino Ceoldo),
* Japanese translation updated (thanks to Takeshi Aihana),
* French translation updated and typo fixed (thanks to Emmanuel Brun).
Windows version :
* Fixed autocompletion of year when a partial one was entered,
* Fixed crash when no audio player selected in preferences window,
* Improved detection of the locale.
1.03 15 November 1999
- Changed the name of the directory for the distribution, ie
Msgcat-version/ instead of Msgcat/.
1.02 15 November 1999
- XPG4 says that the fields in the message catalog must be separated
by one blank, not many. Corrected this in the sample file.
[Changes for 0.55 - 2006-07-29]
* ANDK submitted a patch to fix versioning problem when
the user elects to install Crypt::OpenPGP.
* Major refactoring of the Makefile.PL to ease the installation process.
[Changes for 0.54 - 2006-05-12]
* Fixed a long-standing bug where differing end-of-line conventions
could cause bogus comparisons in signature checks.
* Fixed another long-standing bug where CRLF text files were hashed
into different digests under Unix and Dosish platforms. Now it's
consistently hashed as if it's been normalized to LF.
* Optional dependencies are no longer installed-by-default.
[Changes for 0.53 - 2006-01-31]
* The explicit call to "readline(D)" didn't compile on earlier perls which
demanded either "readline(*D)" or "<D>" -- I elected the latter form.
Reported by: Matthew Persic
* Update my author key to reflect revoked past uids.
[Changes for 0.52 - 2006-01-19]
* POD and source code cleanup; no functional changes.
* Updated my author key to reflect my new name and identity.
* Upgrade to the latest Module::Install to fix Cygwin
installation problems.
Reported by: Lyle Ziegelmiller
[Changes for 0.51 - 2006-01-02]
* Even more flexible CRLF handling for SIGNATURE files,
Contributed by: Andreas Koenig.
[Changes for 0.50 - 2005-08-21]
* Add support for to SHA-256, requested by Mark Shelor in light
of the recent SHA1 attacks. SHA1 is still the default, but
you can now override this by settings MODULE_SIGNATURE_CIPHER
environment variable to SHA256.
[Changes for 0.45 - 2005-08-09]
* Andreas Koenig ported out that "Import GPG keys?" was asked
far too many times during autoinstall.
Changes in v2.01 - msouth
Fri Aug 19 23:40:24 EDT 2005
----------------------------
* Changed versioning format to leading zero after the
dot to make more minor versions possible this time
* Integration of Math::MatrixReal::Ext1 0.07
* merged new_from_cols and new_from_rows into one private
function which is called by wrappers with the old
names
* added tests to exercise all of the known failure modes
in new_from_{rows,cols} calls
* Fixes for POD
* added a much needed =over 4 to the start of the POD
* removed tabs
* reformatted indentation of the all of the code to 4 space
indent (from a mixture of tabs, 8 space, 4 space, and 2 space)
Changes in v1.9 - leto
Wed May 15 03:19:34 EST 2002
----------------------------
* as_yacas() function added
* t/yacas.t created
* Fixed issue with infinity norm and Irix, thanks to
Allen Smith <easmith@beatrice.rutgers.edu> and the CPAN testers
Changes in v1.8 -- leto
Sat Mar 23 00:13:48 EST 2002
----------------------------
* as_matlab() function added
* as_scilab() function added
* t/matlab.t created
* is_row_vector() function added
* is_col_vector() function added
* t/isrowcol.t created
* norm_p() function added
* norm_frobenius () function added
* t/vecnorm.t created
Changes in v1.7 -- leto
Fri Mar 15 13:09:49 EST 2002
---------------------------
* each() and each_diag() are now one-based for consistency
* removed _trace() comments
* as_latex() function created
* t/latex.t created
* t/bool.t created
* t/periodic.t created
* t/rank.t created
* new_from_string() shouldn't care about the case of the scientific E
notation (pointed out by Jim Bowery <jim_bowery@hotmail.com>)
* t/scinotation.t created
* is_idempotent() function added
* is_periodic() function added
* rank_LR() function added
* make is_orthogonal return 0 instead of croak when matrix
is not quadratic
Changes in v1.6 -- leto
Sat Feb 16 09:46:51 EST 2002
-------------------------
* is_skew_symmetric() function added
* fixed logic error is sym_eigenvalues ( didn't notice if not square! )
* spectral_radius() function added
* is_binary() function added
* is_LR() function added
* t/spectral.t created
* t/binary.t created
* t/is_LR.t created
* t/gramian.t created
* is_skew_symmetric() tests added to t/symmetric.t
* is_gramian() function added
Changes in v1.5 -- leto
Sat Jan 12 04:20:48 EST 2002
-------------------------
* t/inverse.t test 6 was numerically instable, commented out
I ran it 10000 times and got values from 1e-2 to 1e-16,
this caused the test to randomly fail, because it checked
that the value was less than 1e-10
I did not notice this problem because my default perl install
has USE_LONG_DOUBLE
* changed epsilon to be 1e-8 in funcs.pl ( was 1e-10)
Changes in v1.4 -- leto
Jan 10 2002
--------------------------
* Steffen Beyer gave maintainer-ship to Jonathan Leto
* exponent() function added
* trace() function added
* "**" and "**=" overloaded to exponent()
* $matrix ** -1 is now a quick way to compute the inverse, if it exists
* new_from_rows and new_from_cols integrated from Math::MatrixReal::Ext1
* is_diagonal() function added
* is_tridiagonal() function added
* each() function added
* each_diag() function added
* put functions used by all the test scripts into funcs.pl instead
of all of them having copy+paste code
* t/inverse.t created
* t/diag.t created
* t/exponent.t created
* t/trace.t created
* t/ext1.t created
* some documentation spelling errors corrected
* perl operators exp(),sin(),cos() overloaded
only works with diagonal matrices for now
* new_diag() function added
* is_upper_triangular() function added
* is_lower_triangular() function added
* t/triang.t created
* t/det.t created
* inverse() function added
* det() function added
should be much faster for diagonal and triangular matrices
* tri_diagonalize() tri_eigenvalues() and now do real tridiag check, as per TODO
* t/minor.t created
* t/cofactor.t created
* t/adjoint.t created
* t/quadratic.t created
* norm_sum() function added
* t/norm.t created
* check if $rows and $cols are integers in new()
* t/condition.t created
* t/product.t created
* eigenvalues() function added
* t/eigen_NxN.t - added test for eigenvalues()
* swap_row() function added
* swap_col() function added
* t/swap.t created
* t/orthogonal.t created
* is_orthogonal() function added
