summaryrefslogtreecommitdiff
path: root/etc/nationaldays/README
Side-by-side diff
Diffstat (limited to 'etc/nationaldays/README') (more/less context) (show whitespace changes)
-rw-r--r--etc/nationaldays/README52
1 files changed, 29 insertions, 23 deletions
diff --git a/etc/nationaldays/README b/etc/nationaldays/README
index 71af75b..6a1cbb5 100644
--- a/etc/nationaldays/README
+++ b/etc/nationaldays/README
@@ -1,48 +1,54 @@
-Config files for the nationalholiday plugin
+Entry files for the nationalholiday plugin
-Format is simple:
-Standard-xml file.
-It must always enclosed by
+The format is simple. It is a standard xml file. So all tags must closed. A
+handy tool for checking closed tags is the xmllint utility provided by
+libxml2.
+
+Each xml file is enclosed by:
<nationaldays>
...
</nationaldays>
-then a short description tag.
+Each <nationaldays> tag should be follwed by a short description tag:
<description value="german holidays"/>
-for example. It should be used later on.
-
-then a list of holidays follows, encapsulated with
+The description will probably be used later on. Follow the description with
+the <entries> enclosure:
<entries>
...
</entries>
-A non-floating holiday entry has the form
-<entry date="M-D" name="description of holiday"/>
+Insert your holidays in either fixed or floating format. A fixed holiday entry
+has the form:
+<entry name="description of holiday" date="M-D" />
-floating holidays:
+A floating holiday entry has the form:
<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:
+The calc entries may have the following tags:
+date - A short date (without Year!) in the form M-D or the special string
+ "easter"
+offset - A signed integer. This will added (or substracted) after all other
+ calculations are made.
+weekday - The day of week as in "monday', "tuesday", "wednesday", "thursday",
+ "friday", "saturday" or "sunday".
+dayofmonth - Used in combination with weekday tag. You can use "first",
+ "second", "third", "fourth" or "last".
+month - Used in combination with weekday and/or dayofmonth eg. "january",
+ "february" and so on.
+datedep - Used in combination with date and/or weekday, may "before" or "after".
+
+example calculation entry:
<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.
+this will calculate sunday before christmas eve or christmas eve itself if it is a sunday.
-see german.xml for futher examples.
+see german.xml or any of the .xml files in this directory for futher examples.