| |
theScheduler 1.1.0 (28.1.2003)
Copyright ©2000-2003 pinc Software. All Rights Reserved
Making a Schedule file
All dates and other things you want "theScheduler" to view are listed
in a schedule file, in a special way which lets it may work with it.
This file is placed in ~/config/settings/ under the name Scheduler_settings.
If you change this file during the runtime of theScheduler, it will reload
and evaluate it automatically. If its window was closed at this time, it
opens again showing all recent changes.
A few notes:
- there are 5 columns, the first one is considered as a date, the 2nd as
a time, the 4th as options and the last one as a shell command
- a '#' at the beginning of a line marks as a commentary
- empty lines are over-read
- use '|' to separate the columns
Let's have a look at a sample line:
4.2. | 12:15 | Pizza is getting cold | m | alert "Are you hungry?" "Yes" "No"
The '|' separates the different columns. Only the 3rd one has no special meaning,
the last two columns are optional.
So let me describe the different columns and its special qualities:
- This is considered as a date like: d.m.y
You don't have to write the year - the current will be chosen in this
case. If you only use 2 digits to represent the year, it will
automatically be completed (add 1900 or 2000, if it is >75 years in
the past).
You also can omit the month - in this case it will be set to the current
month or the one after this one; depending on wether it is already in
the future or not.
Furthermore, you may write "dayX" or "day=X" with 0<X<8, every week-day
beginning with sunday. Alternatively, you can write its abbreviations
"sun", "mon", "tue", ... or its German pendants ("mo", "di", ...).
If you set this field to "day", it's considered to be a daily item.
It's possible to set a period right after a date: ":x" means a date
every x days.
If no date can be recognised, the text will be displayed directly and the
date of the entry above will be taken.
- You should use this row for times, but it is up to you. If you
enter a time which fits in "hour:min" it will be parsed and used if you
select the "t" option below (no a.m./p.m., 24 hours per day only).
If this row exists, its content will be displayed centered.
- Use this row for the text itself. If you use "m" as an option,
it will be rendered in another colour.
- This row has a special meaning, its contents will be regarded
as options.
As I wrote this, there exist the following:
Option | Stands for | Description |
m | marked |
highlight a date |
h | hold |
show entry independent from its date. If such an item has
no valid date, it will be shown at the end of the list.
|
b | before |
this lets you see entries which are dated beyond the specified
range. With bX or b=X with 0 < X < 65536 you may set the maximum
days between today and then.
|
a | after |
like before, but this is for entries of the past.
|
s | separator |
a line will be rendered above this entry.
|
t | time |
notifies you X minutes before the given time is reached and every
following minute (with tX or t=X). If a sound
is specified it will be played louder and louder.
|
r | remember |
if the date expires it will be marked with an exclamation
mark for every day (max. 3).
|
e | exactly |
the date will be shown exactly in the specified minute and no longer.
|
o | once |
the date will be visible for one day only.
|
- The whole column will be interpreted as a shell command which is executed
at the specified time (2nd column) as long as this one is correct.
Have a look at the example files:
../examples/Scheduler_settings.english
Copyright ©2000-2003 pinc Software. All Rights Reserved
|