summaryrefslogtreecommitdiff
path: root/bin/db-iris
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2021-07-19 20:44:55 +0200
committerDaniel Friesel <derf@finalrewind.org>2021-07-19 20:44:55 +0200
commit4c84bd3a9e64eb773fa623bbce18f8a849b3f83e (patch)
treedc2ea711bded0a75f6cf8141cd8de75991af6d2a /bin/db-iris
parente8bce258d962df29b9244be802a6c5bcc51ada30 (diff)
update db-iris(1)
Diffstat (limited to 'bin/db-iris')
-rwxr-xr-xbin/db-iris38
1 files changed, 26 insertions, 12 deletions
diff --git a/bin/db-iris b/bin/db-iris
index 4bcbbfb..ad7ab9b 100755
--- a/bin/db-iris
+++ b/bin/db-iris
@@ -581,17 +581,31 @@ version 1.57
db-iris is an interface to the DeutscheBahn departure monitor
available at L<https://iris.noncd.db.de/wbt/js/index.html>.
-It requests all departures at I<station> and lists them on stdout, similar to
-the big departure screens installed at most main stations. I<station> can be
-a DS100 station code (such as "EE"), a normal station name
-(such as "Essen Hbf" or "Dortmund UniversitE<auml>t"), or an IBNR / european station
-number (such as 8000098). If no exact match is found, B<db-iris> will try to
-find station names similar to I<station>.
-
-An exclamation mark (C<< ! >>) next to a destination indicates that at least
-one stop on the train's route has been canceled. Use B<-oc> to see the canceled
-stops. An exclamation mark next to a platform indicates that it is not the
-scheduled one.
+It requests all trains departing from (or arriving at) I<station> in the next
+two hours and lists them on stdout. I<station> can be a DS100 station code
+(such as "EE"), a normal station name (such as "Essen Hbf" or "Dortmund
+UniversitE<auml>t"), or an IBNR / european station number (such as 8000098). If
+no exact match is found, B<db-iris> will try to find station names similar to
+I<station>.
+
+By default, db-iris shows the following data for each train:
+
+=over
+
+=item * scheduled departure time (see also B<-ot>, B<-r>).
+
+=item * delay in minutes, cancellation, or a question mark (C<< ? >>)
+indicating that no real-time data is available.
+
+=item * train line or number.
+
+=item * destination (see also B<-or>). An exclamation mark (C<< ! >>)
+indicates that at least one stop has been cancelled (see B<-oc>).
+
+=item * platform. An exclamation mark (C<< ! >>) indicates that it is not
+the scheduled one.
+
+=back
=head1 OPTIONS
@@ -630,7 +644,7 @@ in backwards-incompatible ways anytime.
=item B<-l>, B<--lookahead> I<int>
Do not return results which are more than I<int> minutes in the future.
-Defaults to 240 (4 hours).
+Defaults to 120 (2 hours).
Note that this is only an upper limit, not a guarantee to get every train
with a departure in less than I<int> minutes. This guarantee holds only for