/software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data/with a name of the form
Y1-Y2E.g. for the 2010-2011 vacation year, that's
2010-2011
./.template
that can be used for this.
Note that the "Holiday" entry has to be filled in.
And vacation time that has been carried forward from the previous
vacation year has to be recorded in the "Carried Forward" field
(it's just a copy of the "Carry Forward" field from the previous year's file).
For each person, there is a stanza describing days away, and reason, as well as some other data.
The general form of absence dates is:
where Day is of the formReason: Year: Month: Day,...,Day
where h means a half-day absence, and the commented a or p refer to the morning (A.M.) or afternoon (P.M.). e.g.<number>[h[(a)|(p)]]
means away the afternoon of the 20th, and all day the 21st.Vacation Dates: 2009: Jul: 20h(p),21
There is a template in ./.ReadMe
showing all possible headings,
and provides some details about the fields.
Comments may be appended to any line by
enclosing the comments in parentheses "()".
The fields:
Total Used:may be left blank, as they can be computed from the absence dates. See
Total Left:
Total Days Sick:
./.Readme
for details.
If they are non-empty, make sure that they are accurate.
Although not critical, indentation is currently done with a single tab per column, rather than spaces.
Once the file has been updated, run `make` in the containing directory to update the data in ./vacation-staff, which is included by the WWW page ./index.shtml. E.g.
cd .. make
Let cscf-staff@cs know who's away.
ssh www.cs cd /software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data co -l 2010-2011 vi 2010-2011 ... ci -u 2010-2011 cd .. make
The illness history of staff isn't considered public, so the contents of the "away" files are private. Write access is controlled by membership in group "mgmt". Read access is controlled by group "cscf-abs".
On linux.cs and www.cs there is a command to report on absences; it's called `absences`. E.g.
linux.cs% absences | align 2014-2015 Trevor 39.8 Ed 13.5 Adrian 10 Clayton 8.5 Fraser 7.5 Dan 5 Ronaldo 4 Lawrence 3.5 Phil 3 Dave 2 Isaac 2 Guoxiang 1 Gord 0 Lori 0 Mike 0 Omar 0 Stephen 0 Bill 0 Daniel -3.5
It defaults to time left to take. Use `absences -v -h` for various options.
Because it exists, one needn't use these fields:
in the data.Total Left - use `absences left` Total Used - use `absences planned` Total Days Sick - use `absences illness`
There's also
vacation-left-mail
that's used to send reminder mail.
And a few other things in
/software/absences/maintenance/