REMINDER(1) REMINDER(1)
LOCAL
NAME
reminder
SYNOPSIS
reminder [-ukdate] [-usdate] [-days n] [--help] [--verbose] [--version]
filename...
DESCRIPTION
Reminder is a program to remind you of important dates. It simply
reads in files which are given on the command line and compares
today's date with the dates supplied in the files. If it finds any
dates within a specified number of days from today it will print a
reminder message for each one.
The input file is very simple, it contains any dates that you need
reminding of. One date per line. Any lines beginning with # are
treated as comments and are ignored. Examples are given below:
# This is a comment
1, 1, $New Year's day
12, 25, $Christmas day
# This is another comment
The first number is the month, second number is the day, the remainder
is used as a description. You must preceed the description with the $
character. If no description is given then "Mystery" is used instead.
I find it useful to put reminder ~/.reminder in my startup script so
that it gets run every time I login. Then I have a file called
.reminder in my home directory and fill it with all my relatives'
birthdays, etc.
OPTIONS
-ukdate
Specifies that British date format (day/month/year) be used for all
output. This does not alter the order used in the input files
however. This is the default.
-usdate
Specifies that US date format (month/day/year) be used for all output.
This does not alter the order used in the input files however.
-days n
Specifies the number of days warning to be given for all dates in the
input files. n must be a number between 1 and 365 (inclusive). The
default number is 10 days.
--help
Displays usage information.
- 1 - Formatted: November 17, 2025
REMINDER(1) REMINDER(1)
LOCAL
--verbose
Instructs the program to display more information as it executes to
allow the user to see what it is doing.
--version
Displays the version number of the program.
VERSION
This manual page refers to reminder v1.02 (26/05/1996).
BUGS AND LIMITATIONS
No bugs known at present, if you find any please report them to the
author, see below.
There is currently a limit of 255 characters on the length of an input
line.
TODO
Remove the limit of 255 characters on the length of an input line.
Add the ability to specify a date like 'every Friday' or 'the first of
every month' using wildcards, for example.
AUTHOR
Charles O. Gamble
gambcl@cogamble.demon.co.uk
CharlesGamble@bcs.org.uk
- 2 - Formatted: November 17, 2025