summaryrefslogtreecommitdiff
path: root/lib/WWW/Efa.pm
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2011-01-31 18:07:21 +0100
committerDaniel Friesel <derf@finalrewind.org>2011-01-31 18:07:21 +0100
commit5dc6d0789474de48cf38650cae648c2367477cf7 (patch)
treed3e97abb6e6bbfa6bf03ee6b8bef81d8a8eb8bd6 /lib/WWW/Efa.pm
parent2adc759bfe8879a569c89b045b6396cb46a01d77 (diff)
WWW::Efa documentation updates
Diffstat (limited to 'lib/WWW/Efa.pm')
-rw-r--r--lib/WWW/Efa.pm42
1 files changed, 40 insertions, 2 deletions
diff --git a/lib/WWW/Efa.pm b/lib/WWW/Efa.pm
index b52121a..39e8d7c 100644
--- a/lib/WWW/Efa.pm
+++ b/lib/WWW/Efa.pm
@@ -29,7 +29,12 @@ WWW::Efa - inofficial interface to the efa.vrr.de German itinerary service
=head1 DESCRIPTION
-Foo bar
+B<WWW::Efa> is a client for the efa.vrr.de web interface.
+You pass it the start/stop of your journey, maybe a time and a date and more
+details, and it returns the up-to-date scheduled connections between those two
+stops.
+
+It uses B<LWP::USerAgent> and B<XML::LibXML> for this.
=cut
@@ -537,7 +542,8 @@ sub submit {
=head2 $efa->parse()
-Parse the B<efa.vrr.de> reply
+Parse the B<efa.vrr.de> reply.
+Returns undef on success and a WWW::Efa::Error object upon failure.
=cut
@@ -614,6 +620,38 @@ sub check_no_connections {
}
}
+=head2 $efa->connections()
+
+Returns an array of connection elements. Each connection element is an
+arrayref of connection part, and each connecton part is a hash containing the
+following elements:
+
+=over
+
+=item * dep_time
+
+Departure time as a string in HH:MM format
+
+=item * dep_stop
+
+Departure stop, e.g. "Essen HBf"
+
+=item * train_line
+
+Name of the train line, e.g. "S-Bahn S6"
+
+=item * arr_time
+
+Arrival time as a string in HH:MM format
+
+=item * arr_stop
+
+Arrival stop, e.g. "Berlin HBf"
+
+=back
+
+=cut
+
sub connections {
my ($self) = @_;