From eff310b0e6f9e3e0aec21df3de41778b8b163f70 Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sun, 20 Nov 2011 09:16:31 +0100 Subject: Travel::Status::DE::VRR::Line documentation --- lib/Travel/Status/DE/VRR/Line.pm | 57 +++++++++++++++++--------------------- lib/Travel/Status/DE/VRR/Result.pm | 2 +- 2 files changed, 27 insertions(+), 32 deletions(-) (limited to 'lib') diff --git a/lib/Travel/Status/DE/VRR/Line.pm b/lib/Travel/Status/DE/VRR/Line.pm index 9abe473..64ad56b 100644 --- a/lib/Travel/Status/DE/VRR/Line.pm +++ b/lib/Travel/Status/DE/VRR/Line.pm @@ -43,7 +43,10 @@ version 0.02 =head1 DESCRIPTION -FIXME +Travel::Status::DE::VRR::Line describes a tram/bus/train line departing at the +stop requested by Travel::Status::DE::VRR. Note that it only covers one +direction, so in most cases, you get two Travel::Status::DE::VRR::Line objects +per actual line. =head1 METHODS @@ -51,53 +54,45 @@ FIXME =over -=item $departure->destination +=item $line->direction -The tram/bus/train destination. +Direction of the line. Name of either the destination stop or one on the way. -=item $departure->info +=item $line->name -Additional information related to the departure (string). If departures for -an address were requested, this is the stop name, otherwise it may be recent -news related to the line's schedule. +Name of the line, e.g. "U11", "SB15", "107". -=item $departure->line +=item $line->operator -The name/number of the line. +Operator of the line, as in the local transit company responsible for it. -=item $departure->platform +=item $line->route -The departure platform. Note that this is prefixed by either "Bstg." (for -tram/bus departures) or "Gleis" (for trains). +Partial route of the line (as string), usually start and destination with two +stops in between. -=item $departure->time +Note that start means the actual start of the line, the stop requested by +Travel::Status::DE::VRR::Line may not even be included in this listing. -The departure time as string in "HH:MM" format. +=item $line->type -=back - -=head2 INTERNAL +Type of the line. Observed values so far are "Bus", "NE", "StraEenbahn", +"U-Bahn". -=over +=item $line->valid -=item $departure = Travel::Status::DE::VRR::Result->new(I<%data>) +When / how long above information is valid. -Returns a new Travel::Status::DE::VRR::Result object. You should not need to -call this. +=back -Required I: +=head2 INTERNAL =over -=item B => I - -=item B => I - -=item B => I +=item $line = Travel::Status::DE::VRR::Line->new(I<%data>) -=item B