summaryrefslogtreecommitdiff
path: root/etc
authoralwin <alwin>2005-03-21 14:44:12 (UTC)
committer alwin <alwin>2005-03-21 14:44:12 (UTC)
commit54544753b85aed7e6406c728d47640c389b7d755 (patch) (side-by-side diff)
tree12969359ca3a26de232520eddcd038af2ad4cd69 /etc
parentf196df5163669bae8bdc9e70c1500b278fc49e6d (diff)
downloadopie-54544753b85aed7e6406c728d47640c389b7d755.zip
opie-54544753b85aed7e6406c728d47640c389b7d755.tar.gz
opie-54544753b85aed7e6406c728d47640c389b7d755.tar.bz2
more doc
Diffstat (limited to 'etc') (more/less context) (ignore whitespace changes)
-rw-r--r--etc/nationaldays/README31
1 files changed, 28 insertions, 3 deletions
diff --git a/etc/nationaldays/README b/etc/nationaldays/README
index a65236f..71af75b 100644
--- a/etc/nationaldays/README
+++ b/etc/nationaldays/README
@@ -3,21 +3,46 @@ Config files for the nationalholiday plugin
Format is simple:
Standard-xml file.
It must always enclosed by
<nationaldays>
...
</nationaldays>
then a short description tag.
<description value="german holidays"/>
for example. It should be used later on.
-then a list of non-floating holidays follows, encapsulated with
+then a list of holidays follows, encapsulated with
<entries>
...
</entries>
-Each entry has the form
+A non-floating holiday entry has the form
<entry date="M-D" name="description of holiday"/>
-floating holidays are not supported this moment.
+floating holidays:
+<entry name="<name>" type="floating">
+<calculation>
+ ... calc entries ..
+</calculation>
+</entry>
+
+The calcentries may following tags:
+
+date - a short date (without Year!) in form M-D or the string "easter"
+offset - integer. these days will added (or substracted) after all other calcs are made.
+weekday - the day of week as monday, tuesday and so on.
+dayofmoth - in combination with weekday you can say "first <weekday> of ..." or "second <weekday> of ..."
+month - monthname(!) eg. january, february and so on.
+datedep - dependy to "date", may "before" or "after".
+
+example:
+<calculation>
+ <weekday value="sunday"/>
+ <datedep value="before"/>
+ <date value="12-24"/>
+</calculation>
+
+these will calculate sunday before christmaseve or christmas eve itself if it is a sunday.
+
+see german.xml for futher examples.