.TH bday 1
.SH NAME
bday \- inform about upcoming birthdays and anniversaries



.SH SYNOPSIS
.BR bday\  [ -w
.IR defwarn ]



.SH DESCRIPTION
The 
.B bday
command reads standard input which gives a list of birthdays and anniversaries.
It produces a list of events which are coming up within the next few weeks.



.SH OPTIONS

.TP
.BI -w\  warn
Warn
.I warn
days in advance, for entries that have no
.B #w
flag.
If this switch is not specified, it defaults to 14 days.



.SH FILE FORMAT

Each line beginning with a hash sign,
.RB ` # ',
is a comment and will be ignored.

Any other line specifies a date, optional modifiers, and the
name of a person or event.
The date has to be in ISO 8601 date format (YYYY-MM-DD).
The optional modifiers are words, starting with a hash symbol (#).
.TP
Without a modifier, the entry is a birthday.
The year, if given, should be when the person was born.
A line designated as a birthday will produce output like
.B In 3 days:  Erin has a birthday.
.PP
The modifiers are:
.TP
.B #ann
This line is an anniversary. The year, if given, should be the year in which the thing happened, producing output like
.B  Tomorrow:  Pen exploded 3 years ago
given a line such as
.BR "1993-09-12 #ann Pen exploded" .
.TP
.BI #w n
Warn
.I n
days in advance of the date, rather than the default of 14 days or the number given with the
.B -w
flag.



.SH EXAMPLE

1974-04-25 Joe Blow



.SH SEE ALSO

.BR birthday (1),\  cal (1)



.SH BUGS
The program cannot warn more than one year in advance of anything.



.SH CREDITS

This Program is heavily based on birthday. But without all non
essential stuff. Nevertheless, much thanks for birthday, Andy!



.SH AUTHOR
markus schnalke <meillo@marmaro.de>
and Andy Mortimer <andy.mortimer@zetnet.co.uk>