--- Begin Message ---
- To: submit@bugs.debian.org
- Subject: [PATCH] libweather-com-perl: Helping to update to packaging format 3.0
- From: jari.aalto@cante.net
- Date: Sat, 28 Apr 2012 09:27:18 +0300
- Message-id: <87bomc1id5.fsf@test20.cante.net>
Package: libweather-com-perl
Severity: wishlist
Tags: patch
Hi,
The dpatch patch management system has been deprecated for some time. The
Lintian currently flags use of dpatch packages as an error. The new 3.0
packaging format is an improved version which, among other things, contains
patch management built-in. For more information, see:
http://wiki.debian.org/Projects/DebSrc3.0
I had some free time; see attached patch to migrate to new package
format. Note that all files in debian/patches/* are canocalized to
*.patch.
Note:
In-line chnages to origial sources were moved to patch 05.
Let me know if there is anything that needs adjusting or if it is ok
to upload this version in a NMU in case you are working on other
issues needing attention.
Thanks,
Jari
>From e4240bcb1ee89d9211fca2d1471ff493c26e9a3c Mon Sep 17 00:00:00 2001
From: Jari Aalto <jari.aalto@cante.net>
Date: Sat, 28 Apr 2012 09:24:05 +0300
Subject: [PATCH] format-3.0
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
Changes | 7 +-
MANIFEST | 2 +-
META.yml | 2 +-
Makefile.PL | 4 +-
debian/changelog | 12 +
debian/compat | 2 +-
debian/control | 5 +-
debian/copyright | 2 +-
debian/patches/00list | 1 -
debian/patches/05-debian-local-changes.patch | 474 ++++++++++++++++++++
debian/patches/{10_links.dpatch => 10-links.patch} | 8 +-
debian/patches/series | 2 +
debian/rules | 22 +-
debian/source/format | 1 +
lib/Weather/Com.pod | 396 ----------------
15 files changed, 513 insertions(+), 427 deletions(-)
delete mode 100644 debian/patches/00list
create mode 100644 debian/patches/05-debian-local-changes.patch
rename debian/patches/{10_links.dpatch => 10-links.patch} (76%)
create mode 100644 debian/patches/series
create mode 100644 debian/source/format
delete mode 100644 lib/Weather/Com.pod
diff --git a/Changes b/Changes
index 7ac8c10..8cbc439 100644
--- a/Changes
+++ b/Changes
@@ -1,5 +1,8 @@
Revision history for Perl extension Weather::Com.
-$Revision: 1.22 $
+$Revision: 1.23 $
+
+0.5.3 Thu Nov 22 20:00 2007
+ - FIXED BUG #30869: Cannot install via CPAN shell
0.5.2 Mon Jul 09 21:39 2007
- FIXED BUG #26126: Timeout did not work due to typo
@@ -77,7 +80,7 @@ $Revision: 1.22 $
So we'll get some structure in it. This will be usefull if one wants
to write some other caching package, we than can tell it
Weather::Com::Cached::MySQL for example, etc.
- - added automated version information (using the CVS $Revision: 1.22 $ tag)
+ - added automated version information (using the CVS $Revision: 1.23 $ tag)
to all packages
- added consistency checking for paramters passed to Weather::Com
- Weather::Com now only accepts paths to put the cache in if it is
diff --git a/MANIFEST b/MANIFEST
index 3899601..3edb2dd 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -5,7 +5,7 @@ INSTALL
MANIFEST
README
TODO
-lib/Weather/Com.pod
+lib/Weather/Com.pm
lib/Weather/Com/AirPressure.pm
lib/Weather/Com/Base.pm
lib/Weather/Com/Cached.pm
diff --git a/META.yml b/META.yml
index 45b2390..3c73fbd 100644
--- a/META.yml
+++ b/META.yml
@@ -1,7 +1,7 @@
# http://module-build.sourceforge.net/META-spec.html
#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
name: Weather-Com
-version: 0.5.2
+version: 0.5.3
version_from:
installdirs: site
requires:
diff --git a/Makefile.PL b/Makefile.PL
index 73e3507..d31e744 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -5,7 +5,7 @@ use ExtUtils::MakeMaker;
# the contents of the Makefile that is written.
WriteMakefile(
NAME => 'Weather::Com',
- VERSION => '0.5.2', # sets $VERSION
+ VERSION => '0.5.3', # sets $VERSION
PREREQ_PM => {
Data::Dumper => "",
Locale::Maketext => "",
@@ -21,7 +21,7 @@ WriteMakefile(
? ## Add these new keywords supported since 5.005
(
ABSTRACT_FROM =>
- 'lib/Weather/Com.pod', # retrieve abstract from module
+ 'lib/Weather/Com.pm', # retrieve abstract from module
AUTHOR => 'Thomas Schnuecker <thomas@schnuecker.de>'
)
: ()
diff --git a/debian/changelog b/debian/changelog
index 1666531..35fc0c9 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,15 @@
+libweather-com-perl (0.5.3-2.1) unstable; urgency=low
+
+ * Non-maintainer upload.
+ * Remove deprecated dpatch and upgrade to packaging format "3.0 quilt".
+ * Update to Standards-Version to 3.9.3 and debhelper to 9.
+ * Add build-arch and build-indep targets; use dh_prep in rules file.
+ * Patch 05: new, in-line changes to original sources.
+ * Fix copyright-refers-to-symlink-license (Lintian).
+ * Fix no-homepage-field (Lintian).
+
+ -- Jari Aalto <jari.aalto@cante.net> Sat, 28 Apr 2012 09:18:47 +0300
+
libweather-com-perl (0.5.3-2) unstable; urgency=low
* Acknoledged NMU.
diff --git a/debian/compat b/debian/compat
index b8626c4..ec63514 100644
--- a/debian/compat
+++ b/debian/compat
@@ -1 +1 @@
-4
+9
diff --git a/debian/control b/debian/control
index b5e0996..78360bd 100644
--- a/debian/control
+++ b/debian/control
@@ -2,9 +2,10 @@ Source: libweather-com-perl
Section: perl
Priority: optional
Build-Depends-Indep: perl (>= 5.8.0), libwww-perl, libxml-simple-perl, libtime-format-perl
-Build-Depends: debhelper (>= 4.0.2), dpatch (>= 2)
+Build-Depends: debhelper (>= 9)
Maintainer: Christoph Haas <haas@debian.org>
-Standards-Version: 3.7.3
+Standards-Version: 3.9.3
+Homepage: http://search.cpan.org/~schnueck/Weather-Com
Package: libweather-com-perl
Architecture: all
diff --git a/debian/copyright b/debian/copyright
index 787234c..14603fa 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -8,7 +8,7 @@ it under the same terms as Perl itself.
Perl is distributed under your choice of the GNU General Public License or
the Artistic License. On Debian GNU/Linux systems, the complete text of the
-GNU General Public License can be found in `/usr/share/common-licenses/GPL'
+GNU General Public License can be found in `/usr/share/common-licenses/GPL-2'
and the Artistic Licence in `/usr/share/common-licenses/Artistic'.
The data provided by weather.com and made accessible by this OO
diff --git a/debian/patches/00list b/debian/patches/00list
deleted file mode 100644
index 0faa74c..0000000
--- a/debian/patches/00list
+++ /dev/null
@@ -1 +0,0 @@
-10_links.dpatch
diff --git a/debian/patches/05-debian-local-changes.patch b/debian/patches/05-debian-local-changes.patch
new file mode 100644
index 0000000..b0bd49e
--- /dev/null
+++ b/debian/patches/05-debian-local-changes.patch
@@ -0,0 +1,474 @@
+diff --git a/Changes b/Changes
+index 8cbc439..7ac8c10 100644
+--- a/Changes
++++ b/Changes
+@@ -1,8 +1,5 @@
+ Revision history for Perl extension Weather::Com.
+-$Revision: 1.23 $
+-
+-0.5.3 Thu Nov 22 20:00 2007
+- - FIXED BUG #30869: Cannot install via CPAN shell
++$Revision: 1.22 $
+
+ 0.5.2 Mon Jul 09 21:39 2007
+ - FIXED BUG #26126: Timeout did not work due to typo
+@@ -80,7 +77,7 @@ $Revision: 1.23 $
+ So we'll get some structure in it. This will be usefull if one wants
+ to write some other caching package, we than can tell it
+ Weather::Com::Cached::MySQL for example, etc.
+- - added automated version information (using the CVS $Revision: 1.23 $ tag)
++ - added automated version information (using the CVS $Revision: 1.22 $ tag)
+ to all packages
+ - added consistency checking for paramters passed to Weather::Com
+ - Weather::Com now only accepts paths to put the cache in if it is
+diff --git a/MANIFEST b/MANIFEST
+index 3edb2dd..3899601 100644
+--- a/MANIFEST
++++ b/MANIFEST
+@@ -5,7 +5,7 @@ INSTALL
+ MANIFEST
+ README
+ TODO
+-lib/Weather/Com.pm
++lib/Weather/Com.pod
+ lib/Weather/Com/AirPressure.pm
+ lib/Weather/Com/Base.pm
+ lib/Weather/Com/Cached.pm
+diff --git a/META.yml b/META.yml
+index 3c73fbd..45b2390 100644
+--- a/META.yml
++++ b/META.yml
+@@ -1,7 +1,7 @@
+ # http://module-build.sourceforge.net/META-spec.html
+ #XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
+ name: Weather-Com
+-version: 0.5.3
++version: 0.5.2
+ version_from:
+ installdirs: site
+ requires:
+diff --git a/Makefile.PL b/Makefile.PL
+index d31e744..73e3507 100644
+--- a/Makefile.PL
++++ b/Makefile.PL
+@@ -5,7 +5,7 @@ use ExtUtils::MakeMaker;
+ # the contents of the Makefile that is written.
+ WriteMakefile(
+ NAME => 'Weather::Com',
+- VERSION => '0.5.3', # sets $VERSION
++ VERSION => '0.5.2', # sets $VERSION
+ PREREQ_PM => {
+ Data::Dumper => "",
+ Locale::Maketext => "",
+@@ -21,7 +21,7 @@ WriteMakefile(
+ ? ## Add these new keywords supported since 5.005
+ (
+ ABSTRACT_FROM =>
+- 'lib/Weather/Com.pm', # retrieve abstract from module
++ 'lib/Weather/Com.pod', # retrieve abstract from module
+ AUTHOR => 'Thomas Schnuecker <thomas@schnuecker.de>'
+ )
+ : ()
+diff --git a/lib/Weather/Com.pod b/lib/Weather/Com.pod
+new file mode 100644
+index 0000000..8a1b5ad
+--- /dev/null
++++ b/lib/Weather/Com.pod
+@@ -0,0 +1,396 @@
++package Weather::Com;
++
++our $VERSION = sprintf "%d.%03d", q$Revision: 1.14 $ =~ /(\d+)/g;
++
++1;
++
++__END__
++
++=pod
++
++=head1 NAME
++
++Weather::Com - fetching weather information from I<weather.com>
++
++=head1 SYNOPSIS
++
++ #!/usr/bin/perl -w
++ use Weather::Com::Finder;
++
++ # you have to fill in your ids from weather.com here
++ my $PartnerId = 'somepartnerid';
++ my $LicenseKey = 'mylicense';
++
++ my %weatherargs = (
++ 'partner_id' => $PartnerId,
++ 'license' => $LicenseKey,
++ 'language' => 'de',
++ );
++
++ my $weather_finder = Weather::Com::Finder->new(%weatherargs);
++
++ my @locations = $weather_finder->find('Heidelberg');
++
++ foreach my $location (@locations) {
++ print "Found weather for city: ", $location->name(), "\n";
++ print "Current Conditions are ",
++ $location->current_conditions()->description(), "\n";
++ }
++
++=head1 DESCRIPTION
++
++I<Weather::Com> provides three interfaces to access weather
++information from I<weather.com>.
++
++Except from the main high level interface, there is also
++a simple, very easy to use one called I<Weather::Com::Simple>.
++And if you want, you can also use the low level
++interface that is the basis for the two high level interfaces,
++directly (I<Weather::Com::Cached> or even I<Weather::Com::Base>).
++
++Please refer to the POD of these modules directly for detailed
++information.
++
++The data provided by I<weather.com> and made accessible by this OO
++interface can be used for free under special terms. Please have a look
++at the application programming guide of I<weather.com>
++L<http://www.weather.com/services/xmloap.html>
++
++=head1 LOCALIZATION
++
++Weather-Com uses I<Locale::Maketext> for the l10n. Foreach language there
++has to be package I<Weather::Com::L10N::[langcode]> (e.g. I<Weather::Com::L10N::de>).
++
++Localization is new with version 0.4 of Weather-Com. Therefore, there are not too
++many languages supported, yet. If one wants to create such a language definition package
++for a language that is not part of this module, please do the following:
++
++=over 4
++
++=item 1.
++
++check my homepage to verify that the language package has not been created by someone
++else, yet (L<http://www.schnuecker.org/index.php?weather-com>).
++
++=item 2.
++
++contact me to verify if anybody else already is already translating into this language
++
++=item 3.
++
++just do it and send me your new language package. It then will be first put onto my
++website for download and then it will be part of the next release.
++
++=back
++
++=head2 Dynamic Language Support
++
++With version 0.5 of Weather-Com I have introduced a new feature called
++I<dynamic language support>.
++
++The language for all textual attributes that usually are translated in your default
++language you chose while creating your C<Weather::Com::Finder> instance can now
++dynamically be changed on a I<per-method-call basis>.
++
++Have a look at this example:
++
++ #!/usr/bin/perl -w
++ use Weather::Com::Finder;
++
++ # you have to fill in your ids from weather.com here
++ my $PartnerId = 'somepartnerid';
++ my $LicenseKey = 'mylicense';
++
++ my %weatherargs = (
++ 'partner_id' => $PartnerId,
++ 'license' => $LicenseKey,
++ 'language' => 'en',
++ );
++
++ my $weather_finder = Weather::Com::Finder->new(%weatherargs);
++
++ my @locations = $weather_finder->find('Heidelberg');
++
++ foreach my $location (@locations) {
++ print "Found weather for city: ", $location->name(), "\n";
++ print "Current Conditions are ",
++ $location->current_conditions()->description(), "\n";
++
++ # HERE WE USE DYNAMIC LANGUAGE SUPPORT
++ print "That is in German: ",
++ $location->current_conditions()->description('de'), "\n";
++ }
++
++As you can see in this example, you can provide a language tag to
++a method that returns textual information.
++
++If you want to find out if the I<dynamic language support> is already
++implemented for a specific attribute of one Weather-Com class, have
++a look at the corresponding packages POD.
++
++=head1 TUTORIAL
++
++The usual way to use the I<Weather::Com> module would be to instantiate
++a I<Weather::Com::Finder> that allows you to search for a location
++by a search string or postal code or whatever I<weather.com> may
++understand.
++
++The finder returns an arrayref or an array of locations (depending on
++how you call the C<find()> method). Each location is an object of
++I<Weather::Com::Location>.
++
++The locations consist of location specific data,
++a I<Weather::Com::CurrentConditions> object, a I<Weather::Com::Forecast>
++object and a I<Weather::Com::Units> object.
++
++=head2 Configuration parameters
++
++You will need a configuration hash to instantiate a I<Weather::Com::Finder>
++object. Except of the I<partner_id> and the I<license> all parameters are
++optional and have sensible defaults.
++
++ use Weather::Com::Finder;
++
++ my %config = (
++ partner_id => 'somepartnerid', # mandatory
++ license => 'somelicensekey' # mandatory
++ language => 'de',
++ units => 's',
++ cache => '/tmp/weather',
++ timeout => 300,
++ debug => 1,
++ proxy => 'http://some.proxy.de:8080',
++ proxy_user => 'myaccount',
++ proxy_pass => 'myproxy_pass'
++ );
++
++The valid parameters are:
++
++=over 4
++
++=item partner_id => 'somepartnerid'
++
++To be allowed to fetch weather information from I<weather.com> you need to
++register (free of charge) to get a so called I<Partner Id> and a
++I<License Key>.
++
++=item license => 'somelicensekey'
++
++See I<partner_id>.
++
++=item language => 'somelanguagecode'
++
++I<weather.com> returns some textual data to describe the weather
++conditions, uv index, moon phase, wind direction, etc.
++
++If one specifies a valid language as configuration parameter, this
++textual descriptions are translated into that language. If one specifies
++a language for that there's no translation, the objects will return the
++english texts.
++
++=item cache => '/any/path'
++
++Maybe you want to define a special path to put the cache files into.
++The cache directory defaults to ".".
++
++=item units => s | m
++
++This parameter defines whether to fetch information in metric (m) or
++US (s) format.
++
++Defaults to 'm'.
++
++=item timeout => some integer (in seconds)
++
++The timeout for I<LWP::UserAgent> to get an HTTP request done usually is set to
++180s. If you need a longer timeout or for some reasons a shorter one you can
++set this here.
++
++Defaults to 180 seconds.
++
++=item debug => 0 | 1
++
++Set debugging on/off.
++
++Defaults to 0 (off).
++
++=item proxy => 'none' | 'http://some.proxy.de:8080'
++
++Usually no proxy is used by the I<LWP::UserAgent> module used to communicate
++with I<weather.com>. If you want to use an HTTP proxy you can specify one here.
++
++=item proxy_user => undef | 'myuser'
++
++If specified, this parameter is provided to the proxy for authentication
++purposes.
++
++Defaults to I<undef>.
++
++=item proxy_pass => undef | 'mypassword'
++
++If specified, this parameter is provided to the proxy for authentication
++purposes.
++
++Defaults to I<undef>.
++
++=back
++
++=head2 Weather::Com::Finder
++
++Usually one would start by searching for a location. This is done by
++instantiating a I<Weather::Com::Finder> object providing all necessary
++information about the I<weather.com> license, the proxy if one is needed,
++etc.
++
++ my $finder = Weather::Com::Finder->new(%config);
++
++Then you call the finders C<find()> method to search for locations whose
++name or whose postal code matches against the searchstring. The finder then
++returns an array (or arrayref) of I<Weather::Com::Location> objects.
++
++ # if you want an array of locations:
++ my @locations = $finder->find('Heidelberg');
++
++ # or if you prefer an arrayref:
++ my $locations = $finder->find('Heidelberg');
++
++For further information please refer to L<Weather::Com::Finder>.
++
++=head2 Weather::Com::Location
++
++The I<Weather::Com::Location> object contains information about the location
++itself (longitude, latitude, current local time, etc.), a I<Weather::Com::Units>
++object that contains all information about the units of messures currently used with
++this location, and a I<Weather::Com::CurrentConditions> object containing the
++current weather conditions of the location.
++
++ foreach my $location (@locations) {
++ print "Found location with name: ", $location->name(), "\n";
++ print "The longitude of this location is: ", $location->longitude(), "\n";
++ }
++
++All information in the I<Weather::Com::Location> object is updated with each single
++call of one of its methods corresponding to the caching rules implemented in
++I<Weather::Com::Cached>.
++
++For detailed information about the I<Weather::Com::Location> class please refer to
++L<Weather::Com::Location>.
++
++=head2 Weather::Com::Units
++
++The units class provides all units of measure corresponding to the data of the
++location object. You'll get an instance of this class by calling the C<units()>
++method of your location object.
++
++For detailed information about the I<Weather::Com::Units> class please refer to
++L<Weather::Com::Units>.
++
++=head2 Weather::Com::CurrentConditions
++
++Each location has a I<Weather::Com::CurrentConditions> object accessible via
++its C<current_conditions()> method.
++
++ my $conditions = $location->current_conditions();
++ print "Current temperature is ", $conditions->temperature(), "°C\n";
++ print "but it feels like ", $conditions->windchill(), "°C!\n";
++
++Anytime you call a method of your I<Weather::Com::CurrentConditions> object,
++its data is refreshed automatically if needed according to the caching rules.
++
++For detailed information about this class please refer to
++L<Weather::Com::CurrentConditions>.
++
++=head2 Weather::Com::Forecast
++
++Each location has a I<Weather::Com::Forecast> object to access weather
++forecasts. I<weather.com> provides up to 9 days of forecast - or 10 days
++if one wants to count day 0 which is I<today> in most cases.
++
++ my $forecast = $location->forecast();
++ print "Max. temperature tomorrow will be ", $forecast->day(1)->high(), "°C\n";
++
++Any time you call a method of your I<Weather::Com::Forecast> object, forecast data
++is updated if necessary.
++
++For detailed information about this class please refer to
++L<Weather::Com::Forecast>.
++
++=head2 Other classes
++
++There are a some other classes that are used to represent groups of
++weather data like wind (speed, direction, etc.), UV index, air pressure, etc.
++
++Objects of these classes belong to objects of class I<Weather::Com::CurrentConditions> or
++I<Weather::Com::Forecast> that will be introduced with the next release. These
++objects data will only refresh when you call the corresponding method of the parent object.
++
++For detailed information about these classes please refer to their own POD.
++
++Classes available with this version are:
++
++=head3 Weather::Com::AirPressure
++
++Provides access to the barometric pressure data.
++
++For detailed information about this class please refer to
++L<Weather::Com::AirPressure>.
++
++=head3 Weather::Com::UVIndex
++
++Provides access to the uv index of the parent object.
++
++For detailed information about this class please refer to
++L<Weather::Com::UVIndex>.
++
++=head3 Weather::Com::Wind
++
++Provides access to wind speed, maximum gust, direction in degrees, etc.
++
++=head1 EXTENSIONS
++
++If you plan to extend these module, e.g. with some other caching mechanisms,
++please contact me. Perhaps we can add your stuff to this module.
++
++=head1 SEE ALSO
++
++=head2 Detailed documentation of the main interface
++
++L<Weather::Com::Finder>, L<Weather::Com::Location>, L<Weather::Com::Units>,
++L<Weather::Com::CurrentConditions>, L<Weather::Com::AirPressure>,
++L<Weather::Com::UVIndex>, L<Weather::Com::Wind>
++
++=head2 Detailed documentation of the I<Simple> API
++
++L<Weather::Com::Simple>
++
++=head2 Detailed documentation of the low level interface
++
++L<Weather::Com::Cached> and L<Weather::Com::Base>
++
++=head1 BUGS/SUPPORT/PRE-RELEASES
++
++If you want to report a bug, please use the CPAN bug reporting tool.
++
++If you have any question, suggestion, feature request, etc. please use the
++CPAN forum.
++
++If you are looking for fixes, pre-releases, etc. have a look at my website
++L<http://www.schnuecker.org/index.php?weather-com>.
++
++=head1 AUTHOR
++
++Thomas Schnuecker, E<lt>thomas@schnuecker.deE<gt>
++
++=head1 COPYRIGHT AND LICENSE
++
++Copyright (C) 2004-2007 by Thomas Schnuecker
++
++This library is free software; you can redistribute it and/or modify
++it under the same terms as Perl itself.
++
++The data provided by I<weather.com> and made accessible by this OO
++interface can be used for free under special terms.
++Please have a look at the application programming guide of
++I<weather.com> (L<http://www.weather.com/services/xmloap.html>)
++
++=cut
+\ No newline at end of file
diff --git a/debian/patches/10_links.dpatch b/debian/patches/10-links.patch
similarity index 76%
rename from debian/patches/10_links.dpatch
rename to debian/patches/10-links.patch
index c9a7958..9b509c5 100644
--- a/debian/patches/10_links.dpatch
+++ b/debian/patches/10-links.patch
@@ -1,10 +1,6 @@
-#! /bin/sh /usr/share/dpatch/dpatch-run
-## 10_links.dpatch by Christoph Haas <haas@debian.org>
-##
-## All lines beginning with `## DP:' are a description of the patch.
-## DP: No description.
+From: Christoph Haas <haas@debian.org>
+Subject: Enable LINKS
-@DPATCH@
diff -urNad libweather-com-perl-0.5.3~/lib/Weather/Com/Base.pm libweather-com-perl-0.5.3/lib/Weather/Com/Base.pm
--- libweather-com-perl-0.5.3~/lib/Weather/Com/Base.pm 2007-07-09 21:57:24.000000000 +0200
+++ libweather-com-perl-0.5.3/lib/Weather/Com/Base.pm 2008-05-29 20:44:06.000000000 +0200
diff --git a/debian/patches/series b/debian/patches/series
new file mode 100644
index 0000000..225743c
--- /dev/null
+++ b/debian/patches/series
@@ -0,0 +1,2 @@
+05-debian-local-changes.patch
+10-links.patch
diff --git a/debian/rules b/debian/rules
index 02ece5a..aac1d49 100755
--- a/debian/rules
+++ b/debian/rules
@@ -15,7 +15,11 @@ endif
TMP =$(CURDIR)/debian/$(PACKAGE)
-build: build-stamp patch
+
+build-arch: build
+build-indep: build
+
+build: build-stamp
build-stamp:
dh_testdir
@@ -25,7 +29,7 @@ build-stamp:
touch build-stamp
-clean: clean1 unpatch
+clean: clean1
clean1:
dh_testdir
dh_testroot
@@ -40,7 +44,7 @@ install: build install-stamp
install-stamp:
dh_testdir
dh_testroot
- dh_clean -k
+ dh_prep
# Add commands to install the package into debian/$PACKAGE_NAME here
$(MAKE) test
@@ -71,16 +75,6 @@ binary-indep: build install
dh_md5sums
dh_builddeb
-patch: patch-stamp
-patch-stamp:
- dpatch apply-all
- dpatch cat-all >patch-stamp
- touch patch-stamp
-
-unpatch:
- dpatch deapply-all
- rm -rf patch-stamp debian/patched
-
binary: binary-indep binary-arch
-.PHONY: build clean binary-indep binary-arch binary patch unpatch
+.PHONY: build clean binary-indep binary-arch binary
diff --git a/debian/source/format b/debian/source/format
new file mode 100644
index 0000000..163aaf8
--- /dev/null
+++ b/debian/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/lib/Weather/Com.pod b/lib/Weather/Com.pod
deleted file mode 100644
index 8a1b5ad..0000000
--- a/lib/Weather/Com.pod
+++ /dev/null
@@ -1,396 +0,0 @@
-package Weather::Com;
-
-our $VERSION = sprintf "%d.%03d", q$Revision: 1.14 $ =~ /(\d+)/g;
-
-1;
-
-__END__
-
-=pod
-
-=head1 NAME
-
-Weather::Com - fetching weather information from I<weather.com>
-
-=head1 SYNOPSIS
-
- #!/usr/bin/perl -w
- use Weather::Com::Finder;
-
- # you have to fill in your ids from weather.com here
- my $PartnerId = 'somepartnerid';
- my $LicenseKey = 'mylicense';
-
- my %weatherargs = (
- 'partner_id' => $PartnerId,
- 'license' => $LicenseKey,
- 'language' => 'de',
- );
-
- my $weather_finder = Weather::Com::Finder->new(%weatherargs);
-
- my @locations = $weather_finder->find('Heidelberg');
-
- foreach my $location (@locations) {
- print "Found weather for city: ", $location->name(), "\n";
- print "Current Conditions are ",
- $location->current_conditions()->description(), "\n";
- }
-
-=head1 DESCRIPTION
-
-I<Weather::Com> provides three interfaces to access weather
-information from I<weather.com>.
-
-Except from the main high level interface, there is also
-a simple, very easy to use one called I<Weather::Com::Simple>.
-And if you want, you can also use the low level
-interface that is the basis for the two high level interfaces,
-directly (I<Weather::Com::Cached> or even I<Weather::Com::Base>).
-
-Please refer to the POD of these modules directly for detailed
-information.
-
-The data provided by I<weather.com> and made accessible by this OO
-interface can be used for free under special terms. Please have a look
-at the application programming guide of I<weather.com>
-L<http://www.weather.com/services/xmloap.html>
-
-=head1 LOCALIZATION
-
-Weather-Com uses I<Locale::Maketext> for the l10n. Foreach language there
-has to be package I<Weather::Com::L10N::[langcode]> (e.g. I<Weather::Com::L10N::de>).
-
-Localization is new with version 0.4 of Weather-Com. Therefore, there are not too
-many languages supported, yet. If one wants to create such a language definition package
-for a language that is not part of this module, please do the following:
-
-=over 4
-
-=item 1.
-
-check my homepage to verify that the language package has not been created by someone
-else, yet (L<http://www.schnuecker.org/index.php?weather-com>).
-
-=item 2.
-
-contact me to verify if anybody else already is already translating into this language
-
-=item 3.
-
-just do it and send me your new language package. It then will be first put onto my
-website for download and then it will be part of the next release.
-
-=back
-
-=head2 Dynamic Language Support
-
-With version 0.5 of Weather-Com I have introduced a new feature called
-I<dynamic language support>.
-
-The language for all textual attributes that usually are translated in your default
-language you chose while creating your C<Weather::Com::Finder> instance can now
-dynamically be changed on a I<per-method-call basis>.
-
-Have a look at this example:
-
- #!/usr/bin/perl -w
- use Weather::Com::Finder;
-
- # you have to fill in your ids from weather.com here
- my $PartnerId = 'somepartnerid';
- my $LicenseKey = 'mylicense';
-
- my %weatherargs = (
- 'partner_id' => $PartnerId,
- 'license' => $LicenseKey,
- 'language' => 'en',
- );
-
- my $weather_finder = Weather::Com::Finder->new(%weatherargs);
-
- my @locations = $weather_finder->find('Heidelberg');
-
- foreach my $location (@locations) {
- print "Found weather for city: ", $location->name(), "\n";
- print "Current Conditions are ",
- $location->current_conditions()->description(), "\n";
-
- # HERE WE USE DYNAMIC LANGUAGE SUPPORT
- print "That is in German: ",
- $location->current_conditions()->description('de'), "\n";
- }
-
-As you can see in this example, you can provide a language tag to
-a method that returns textual information.
-
-If you want to find out if the I<dynamic language support> is already
-implemented for a specific attribute of one Weather-Com class, have
-a look at the corresponding packages POD.
-
-=head1 TUTORIAL
-
-The usual way to use the I<Weather::Com> module would be to instantiate
-a I<Weather::Com::Finder> that allows you to search for a location
-by a search string or postal code or whatever I<weather.com> may
-understand.
-
-The finder returns an arrayref or an array of locations (depending on
-how you call the C<find()> method). Each location is an object of
-I<Weather::Com::Location>.
-
-The locations consist of location specific data,
-a I<Weather::Com::CurrentConditions> object, a I<Weather::Com::Forecast>
-object and a I<Weather::Com::Units> object.
-
-=head2 Configuration parameters
-
-You will need a configuration hash to instantiate a I<Weather::Com::Finder>
-object. Except of the I<partner_id> and the I<license> all parameters are
-optional and have sensible defaults.
-
- use Weather::Com::Finder;
-
- my %config = (
- partner_id => 'somepartnerid', # mandatory
- license => 'somelicensekey' # mandatory
- language => 'de',
- units => 's',
- cache => '/tmp/weather',
- timeout => 300,
- debug => 1,
- proxy => 'http://some.proxy.de:8080',
- proxy_user => 'myaccount',
- proxy_pass => 'myproxy_pass'
- );
-
-The valid parameters are:
-
-=over 4
-
-=item partner_id => 'somepartnerid'
-
-To be allowed to fetch weather information from I<weather.com> you need to
-register (free of charge) to get a so called I<Partner Id> and a
-I<License Key>.
-
-=item license => 'somelicensekey'
-
-See I<partner_id>.
-
-=item language => 'somelanguagecode'
-
-I<weather.com> returns some textual data to describe the weather
-conditions, uv index, moon phase, wind direction, etc.
-
-If one specifies a valid language as configuration parameter, this
-textual descriptions are translated into that language. If one specifies
-a language for that there's no translation, the objects will return the
-english texts.
-
-=item cache => '/any/path'
-
-Maybe you want to define a special path to put the cache files into.
-The cache directory defaults to ".".
-
-=item units => s | m
-
-This parameter defines whether to fetch information in metric (m) or
-US (s) format.
-
-Defaults to 'm'.
-
-=item timeout => some integer (in seconds)
-
-The timeout for I<LWP::UserAgent> to get an HTTP request done usually is set to
-180s. If you need a longer timeout or for some reasons a shorter one you can
-set this here.
-
-Defaults to 180 seconds.
-
-=item debug => 0 | 1
-
-Set debugging on/off.
-
-Defaults to 0 (off).
-
-=item proxy => 'none' | 'http://some.proxy.de:8080'
-
-Usually no proxy is used by the I<LWP::UserAgent> module used to communicate
-with I<weather.com>. If you want to use an HTTP proxy you can specify one here.
-
-=item proxy_user => undef | 'myuser'
-
-If specified, this parameter is provided to the proxy for authentication
-purposes.
-
-Defaults to I<undef>.
-
-=item proxy_pass => undef | 'mypassword'
-
-If specified, this parameter is provided to the proxy for authentication
-purposes.
-
-Defaults to I<undef>.
-
-=back
-
-=head2 Weather::Com::Finder
-
-Usually one would start by searching for a location. This is done by
-instantiating a I<Weather::Com::Finder> object providing all necessary
-information about the I<weather.com> license, the proxy if one is needed,
-etc.
-
- my $finder = Weather::Com::Finder->new(%config);
-
-Then you call the finders C<find()> method to search for locations whose
-name or whose postal code matches against the searchstring. The finder then
-returns an array (or arrayref) of I<Weather::Com::Location> objects.
-
- # if you want an array of locations:
- my @locations = $finder->find('Heidelberg');
-
- # or if you prefer an arrayref:
- my $locations = $finder->find('Heidelberg');
-
-For further information please refer to L<Weather::Com::Finder>.
-
-=head2 Weather::Com::Location
-
-The I<Weather::Com::Location> object contains information about the location
-itself (longitude, latitude, current local time, etc.), a I<Weather::Com::Units>
-object that contains all information about the units of messures currently used with
-this location, and a I<Weather::Com::CurrentConditions> object containing the
-current weather conditions of the location.
-
- foreach my $location (@locations) {
- print "Found location with name: ", $location->name(), "\n";
- print "The longitude of this location is: ", $location->longitude(), "\n";
- }
-
-All information in the I<Weather::Com::Location> object is updated with each single
-call of one of its methods corresponding to the caching rules implemented in
-I<Weather::Com::Cached>.
-
-For detailed information about the I<Weather::Com::Location> class please refer to
-L<Weather::Com::Location>.
-
-=head2 Weather::Com::Units
-
-The units class provides all units of measure corresponding to the data of the
-location object. You'll get an instance of this class by calling the C<units()>
-method of your location object.
-
-For detailed information about the I<Weather::Com::Units> class please refer to
-L<Weather::Com::Units>.
-
-=head2 Weather::Com::CurrentConditions
-
-Each location has a I<Weather::Com::CurrentConditions> object accessible via
-its C<current_conditions()> method.
-
- my $conditions = $location->current_conditions();
- print "Current temperature is ", $conditions->temperature(), "°C\n";
- print "but it feels like ", $conditions->windchill(), "°C!\n";
-
-Anytime you call a method of your I<Weather::Com::CurrentConditions> object,
-its data is refreshed automatically if needed according to the caching rules.
-
-For detailed information about this class please refer to
-L<Weather::Com::CurrentConditions>.
-
-=head2 Weather::Com::Forecast
-
-Each location has a I<Weather::Com::Forecast> object to access weather
-forecasts. I<weather.com> provides up to 9 days of forecast - or 10 days
-if one wants to count day 0 which is I<today> in most cases.
-
- my $forecast = $location->forecast();
- print "Max. temperature tomorrow will be ", $forecast->day(1)->high(), "°C\n";
-
-Any time you call a method of your I<Weather::Com::Forecast> object, forecast data
-is updated if necessary.
-
-For detailed information about this class please refer to
-L<Weather::Com::Forecast>.
-
-=head2 Other classes
-
-There are a some other classes that are used to represent groups of
-weather data like wind (speed, direction, etc.), UV index, air pressure, etc.
-
-Objects of these classes belong to objects of class I<Weather::Com::CurrentConditions> or
-I<Weather::Com::Forecast> that will be introduced with the next release. These
-objects data will only refresh when you call the corresponding method of the parent object.
-
-For detailed information about these classes please refer to their own POD.
-
-Classes available with this version are:
-
-=head3 Weather::Com::AirPressure
-
-Provides access to the barometric pressure data.
-
-For detailed information about this class please refer to
-L<Weather::Com::AirPressure>.
-
-=head3 Weather::Com::UVIndex
-
-Provides access to the uv index of the parent object.
-
-For detailed information about this class please refer to
-L<Weather::Com::UVIndex>.
-
-=head3 Weather::Com::Wind
-
-Provides access to wind speed, maximum gust, direction in degrees, etc.
-
-=head1 EXTENSIONS
-
-If you plan to extend these module, e.g. with some other caching mechanisms,
-please contact me. Perhaps we can add your stuff to this module.
-
-=head1 SEE ALSO
-
-=head2 Detailed documentation of the main interface
-
-L<Weather::Com::Finder>, L<Weather::Com::Location>, L<Weather::Com::Units>,
-L<Weather::Com::CurrentConditions>, L<Weather::Com::AirPressure>,
-L<Weather::Com::UVIndex>, L<Weather::Com::Wind>
-
-=head2 Detailed documentation of the I<Simple> API
-
-L<Weather::Com::Simple>
-
-=head2 Detailed documentation of the low level interface
-
-L<Weather::Com::Cached> and L<Weather::Com::Base>
-
-=head1 BUGS/SUPPORT/PRE-RELEASES
-
-If you want to report a bug, please use the CPAN bug reporting tool.
-
-If you have any question, suggestion, feature request, etc. please use the
-CPAN forum.
-
-If you are looking for fixes, pre-releases, etc. have a look at my website
-L<http://www.schnuecker.org/index.php?weather-com>.
-
-=head1 AUTHOR
-
-Thomas Schnuecker, E<lt>thomas@schnuecker.deE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright (C) 2004-2007 by Thomas Schnuecker
-
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
-
-The data provided by I<weather.com> and made accessible by this OO
-interface can be used for free under special terms.
-Please have a look at the application programming guide of
-I<weather.com> (L<http://www.weather.com/services/xmloap.html>)
-
-=cut
\ No newline at end of file
--
1.7.10
--- End Message ---