pinc Software
 Deutsche Seiten
 

logo 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:

  1. 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.
  2. 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.
  3. Use this row for the text itself. If you use "m" as an option, it will be rendered in another colour.
  4. This row has a special meaning, its contents will be regarded as options.

    As I wrote this, there exist the following:

    OptionStands forDescription
    mmarked highlight a date
    hhold show entry independent from its date. If such an item has no valid date, it will be shown at the end of the list.
    bbefore 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.
    aafter like before, but this is for entries of the past.
    sseparator a line will be rendered above this entry.
    ttime 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.
    rremember if the date expires it will be marked with an exclamation mark for every day (max. 3).
    eexactly the date will be shown exactly in the specified minute and no longer.
    oonce the date will be visible for one day only.

  5. 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