Reminder 2.2 SE
===============

This small application manages addresses (incl. telephone/fax
number and eMail account) and future dates. Every entry can be
associated with a date (e.g. birthday of a person or a point in
time of a date) and an individual pre-warning period.

If you start the program when an entry reaches the pre-warning
period a window pops up and reminds you for that. The program even
reminds you on outdated entries if it wasn't called on the date
associated with the entry.

If the program is started with the parameter /CHECK it only opens
if a date or a pre-warning period is reached. Otherwise the program
finishes itself without opening a window. This option is very
useful if you want to call the application from the autostart
folder or by an application scheduler.

If the program is started with the parameter /TRAY a tray icon is
displayed. Simply double click on this icon if you want to open the
application. Use the parameter /CHECK together with /TRAY if you
want the program to do an alarm check at midnight (when the date
changes). This combination of both parameters might be useful if
your pc runs continously for days without any shutdown or startup.

(De)Installation:
-----------------
The program does not need an installation. Copy all the files to a
folder and then open the executable reminder.exe. If you open the
program for the first time it asks you to choose a language
(English or German). Check the checkbox if you want the program to
create shortcuts on the desktop. One of these shortcuts calls the
program with the parameter /CHECK; if you move this shortcut to the
startup folder the program will be executed automatically on
startup or login. You can also create a shortcut in the startup
folder via the menu item "Edit::Create Startup Shortcut".
To uninstall the program simply delete the program folder and all
the shortcuts that were created by the program.

Upgrade:
--------
If you have installed a previous version of the program then simply
copy the new files over the old ones. But take care that you do not
overwrite or delete the files reminder.csv and reminder.bak! It is
recommended to make a backup of the folder before you overwrite its
old content with the new one.
Note: If you run the program as Server and Client in a network you
must first upgrade each Client before you upgrade the Server.

Syntax and Parameters: 
----------------------
reminder.exe [/check] [/pin] [/tray] [[drive:][path]filename]
The program keeps its data in a file named reminder.csv. Use
[[drive:][path]filename] if you want the program to work with
another CSV file.

If you enter a date it must match one of the following formats:
[D]D.[M]M.[[YY]YY]	 e.g. 11.06.03 or 6.12.2001 or 25.11. (EU)
[M]M/[D]D[/[YY]YY]	 e.g. 06/11/03 or 12/6/2001 or 11/24  (US)
[-|(-|[YY]YY)-][M]M-[D]D e.g. 03-06-11 or 2001-12-6 or 11-24
			 or -03-06-11 or --11-24        (ISO 8601)
Note:	If you enter 11/28 or 11/28/18 or 11/28/1918 the program
	assumes that the date lays in the past and it reminds you
	every year for that date. You must enter 11/28/2018 if you
	want to be warned for the date in the year 2018	for the
	first time. You must choose a pre-warning period if you
	want the application to remind you for a date!

Buttons:
--------
[Delete]	deletes the selected entry in the list. You must
		select an entry before you can press this button.
[Add] / [Copy]	adds an entry to the list. Before pressing this
		button you must either select an existing entry	or
		enter the data for the new entry in the edit fields
		(in the lower panel).
[Edit]		modifies the marked entry in the list with the data
		you entered to the edit fields.
[Clear] / [New]	clears all data in the edit fields and unlocks the
		list.
[!]		searches the list for the entry with the nearest
		date in future and marks it.
[<]		marks the entry with the previous date in the list.
[>]		marks the entry with the next date in the list.

What you also should know:
--------------------------
- The list (and all the controls in the upper panel) will be locked
  if you enter data to the edit fields in the lower panel. Either
  press [Edit], [Add]/[Copy] or [New]/[Clear] to unlock the list.
- The application can be used as a bookmark manager. If the menu
  item "Edit::Open URL by Double Click" is checked then a double
  click on an item in the list opens the URL that was entered in
  the field "eMail / Homepage:" with the default browser. The URL
  should start with one of the following prefixes: "ftp:", "http:",
  "https:", "mailto:" or "file:".
- If you save the database while the menu item "Edit::Backup to
  Recycle Bin" is checked then old versions of the CSV file are
  moved to Recyle Bin.
- You can group the entries into categories. For each entry you
  can either select an existing category name from the field
  "Category:" or enter a new category name into the field.
- Each category name can be used as filter for the items shown in
  the list. If you select the first (nameless) item from the field
  "Filter:" all entries are shown in the list.
- The entries in the list can be sorted by name, date or category.
  If you sort the entries by date only day and month are considered
  but the year is ignored.
- The list allows incremental searching. Simply click on a list
  item and enter some characters.
- The list allows multiple selection. By using this feature you can
  delete more than one item at the same time. Multiple selection is
  also useful if you want to export only the marked list items.
- If you select the export function from the menu for the first
  time the program generates a file named reminder.tpl which
  contains a template for the HTML output. By modifying its content
  you can customize the HTML output or generate files of other
  types (TXT, CSV, LaTeX, XHTML, XML, ...). The label ##--## is
  used to separate the header, the body and the footer of the
  template. In the header the labels ##::##, ##00## and ##01## are
  replaced by the date, the application's name and the path to the
  CSV file. The body will be repeated for each list item and the
  labels from ##00## to ##11## and ##??## are replaced by its
  details; you can use the label ##::## to enumerate the lines. The
  file reminder.tpl must contain the label ##//## if you want to
  enclose links in <a href=...>...</a>. If the file contains the
  label ##||## then line breaks in the comment field are replaced
  by <br>, otherwise they are replaced by spaces. If the menu item
  "Edit::Open File after Export" is checked then the exported file
  is automatically opened by the application associated with the
  file type.
- The program does not offer a print function. But you can use the
  export function to export the database to a file and then print
  its content by another application (e.g. Internet Explorer,
  Notepad, Microsoft Excel, ...).
- The alarm field must contain a value between 0 and 99 if you want
  the program to remind you for the date. In this case the date
  field must contain a valid date. The program will not remind you
  for a date if the alarm field is empty!
- If you doubleclick an item in the alarm window its details are
  displayed.

How to run the program as Server or Client in a network:
--------------------------------------------------------
The application can be installed as Server on a network drive and
as Client on single computers in the network. With the Server you
can manage addresses and dates that are for everyone of interest
(e.g. birthdays of employees). When the application is opened on a
Client it loads those dates from the Server. In addition every
Client can manage its own dates.
To establish the Server-Client-Communication you must install the
application on a common network drive first. Then the application
must be called with the parameter /pin. This generates a PIN file
named reminder.pin containing a number and a filename with path.
The application is now ready for use on the Server and you can
enter addresses and dates.
To install the application on the Clients you must copy all the
application files (including the generated PIN file) from the
Server to each Client. Before you start the application on a Client
you must check if the path mentioned in the PIN file is reachable
for the Client. Edit the path if necessary but don't change any
other part of the PIN file!
When you open the application on a Client the local PIN file is
read. A connection to the Server is opened and all the addresses
and dates that are for everyone of interest are loaded to the
Client. For each entry that was added/edited/deleted on the Server
a window pops up. By pressing [Yes] or [No] you can accept or skip
the changed entries. Press [Cancel] to accept all changes and to
skip the popup windows.
Note: Most network drives are available only for registered users
but not for the AT service of Windows NT. If you start the
application by the AT command of Windows NT the communication
between Client and Server may fail for this reason.

Disclaimer and Credits:
-----------------------
This program is FREEWARE. It is given away WITHOUT ANY WARRANTY.
So use it on your own risk. The author will not be liable for data
loss, damages, loss of profits or any kind of loss while using this
software. In no event will the author's liability exceed the amount
paid for the software product (... and you know you paid nothing
for it because it's freeware ;-). Don't use this program if you
can't agree with these terms.
The source code was written for Rapid-Q which you can download from
http://www.basicguru.com/rapidq/ . For better runtime stability it
is highly recommended to use the patched Rapid-Q Basic Library
Files available at http://www.angelfire.com/space/netcensus/ when
compiling the source code. Many thanks to Doctor Electron for his
excellent bug fix!
Permission is granted to copy parts of this source code to your own
private applications. But it is not allowed to publish (modified
versions of) this source code or executables based on (modified
versions of) this source code without permission of the copyright
holder.

Contact and Download Location:
------------------------------
http://mitglied.lycos.de/maweso/
mailto:martin.wehner@firemail.de
