From a32aaf5392f222c120e00eb556897d435993c8e2 Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sun, 20 Nov 2011 09:29:09 +0100 Subject: Update ::Result documentation --- lib/Travel/Status/DE/VRR/Result.pm | 69 +++++++++++++++++++++++++++----------- 1 file changed, 50 insertions(+), 19 deletions(-) diff --git a/lib/Travel/Status/DE/VRR/Result.pm b/lib/Travel/Status/DE/VRR/Result.pm index fb67e0a..f65cfb1 100644 --- a/lib/Travel/Status/DE/VRR/Result.pm +++ b/lib/Travel/Status/DE/VRR/Result.pm @@ -53,11 +53,31 @@ line number and destination. =head2 ACCESSORS +"Actual" in the description means that the delay (if available) is already +included in the calculation, "Scheduled" means it isn't. + =over +=item $departure->countdown + +Actual time in minutes from now until the tram/bus/train will depart. + +If delay information is available, it is already included. + +=item $departure->date + +Actual departure date (DD.MM.YYYY). + +=item $departure->delay + +Expected delay from scheduled departure time in minutes. + +Note that this is only available for DB trains, in other cases it will always +return 0. + =item $departure->destination -The tram/bus/train destination. +Destination name. =item $departure->info @@ -69,40 +89,51 @@ news related to the line's schedule. The name/number of the line. -=item $departure->platform +=item $departure->lineref -The departure platform. Note that this is prefixed by either "Bstg." (for -tram/bus departures) or "Gleis" (for trains). +Travel::Status::DE::VRR::Line(3pm) object describing the departing line in +detail. -=item $departure->time +=item $departure->platform -The departure time as string in "HH:MM" format. +Departure platform number. -=back +=item $departure->platform_db -=head2 INTERNAL +true if the platform number is operated by DB ("Gleis x"), false ("Bstg. x") +otherwise. -=over +Unfortunately, there is no distinction between tram and bus platforms yet, +which also may have the same numbers. -=item $departure = Travel::Status::DE::VRR::Result->new(I<%data>) +=item $departure->sched_date -Returns a new Travel::Status::DE::VRR::Result object. You should not need to -call this. +Scheduled departure date (DD.MM.YYYY). -Required I: +=item $departure->sched_time -=over +Scheduled departure time (HH:MM). -=item B => I +=item $departure->time -=item B => I +Actual departure time (HH:MM). -=item B => I +=item $departure->type -=item B