meillo@1: .TH bday 1
meillo@1: .SH NAME
meillo@18: bday \- inform about upcoming birthdays and anniversaries
meillo@10: 
meillo@10: 
meillo@10: 
meillo@1: .SH SYNOPSIS
meillo@17: .BR bday\  [ -w
meillo@1: .IR defwarn ]
meillo@1: 
meillo@10: 
meillo@10: 
meillo@1: .SH DESCRIPTION
meillo@1: The 
meillo@1: .B bday
meillo@18: command reads standard input which gives a list of birthdays and anniversaries.
meillo@18: It produces a list of events which are coming up within the next few weeks.
meillo@1: 
meillo@10: 
meillo@10: 
meillo@1: .SH OPTIONS
meillo@1: 
meillo@1: .TP
meillo@17: .BI -w\  warn
meillo@1: Warn
meillo@1: .I warn
meillo@1: days in advance, for entries that have no
meillo@17: .B #w
meillo@18: flag.
meillo@10: If this switch is not specified, it defaults to 14 days.
meillo@10: 
meillo@1: 
meillo@1: 
meillo@1: .SH FILE FORMAT
meillo@1: 
meillo@10: Each line beginning with a hash sign,
meillo@1: .RB ` # ',
meillo@3: is a comment and will be ignored.
meillo@1: 
meillo@17: Any other line specifies a date, optional modifiers, and the
meillo@17: name of a person or event.
meillo@17: The date has to be in ISO 8601 date format (YYYY-MM-DD).
meillo@17: The optional modifiers are words, starting with a hash symbol (#).
meillo@1: .TP
meillo@17: Without a modifier, the entry is a birthday.
meillo@17: The year, if given, should be when the person was born.
meillo@17: A line designated as a birthday will produce output like
meillo@17: .B In 3 days:  Erin has a birthday.
meillo@17: .PP
meillo@17: The modifiers are:
meillo@1: .TP
meillo@17: .B #ann
meillo@1: This line is an anniversary. The year, if given, should be the year in which the thing happened, producing output like
meillo@17: .B  Tomorrow:  Pen exploded 3 years ago
meillo@1: given a line such as
meillo@17: .BR "1993-09-12 #ann Pen exploded" .
meillo@1: .TP
meillo@17: .BI #w n
meillo@1: Warn
meillo@1: .I n
meillo@10: days in advance of the date, rather than the default of 14 days or the number given with the
meillo@17: .B -w
meillo@1: flag.
meillo@1: 
meillo@1: 
meillo@1: 
meillo@1: .SH EXAMPLE
meillo@1: 
meillo@17: 1974-04-25 Joe Blow
meillo@1: 
meillo@1: 
meillo@1: 
meillo@1: .SH SEE ALSO
meillo@1: 
meillo@10: .BR birthday (1),\  cal (1)
meillo@10: 
meillo@10: 
meillo@1: 
meillo@1: .SH BUGS
meillo@1: The program cannot warn more than one year in advance of anything.
meillo@1: 
meillo@10: 
meillo@10: 
meillo@1: .SH CREDITS
meillo@1: 
meillo@17: This Program is heavily based on birthday. But without all non
meillo@17: essential stuff. Nevertheless, much thanks for birthday, Andy!
meillo@1: 
meillo@10: 
meillo@10: 
meillo@1: .SH AUTHOR
meillo@17: markus schnalke <meillo@marmaro.de>
meillo@17: and Andy Mortimer <andy.mortimer@zetnet.co.uk>