+If you have a ``.bdf`` file from `birthday reminder`__ or `birthday reminder 3`__,
+you can use it with *bdrem*.
+
+Configure your source as follows::
+
+ $source = array('Bdf', '/path/to/birthday.bdf');
+
+__ http://cweiske.de/birthday.htm
+__ http://cweiske.de/birthday3.htm
+
+
+CSV file
+========
+Comma separated value files can be used with bdrem.
+They should at least contain a column with the name, and one with the date.
+
+Simple configuration if you use the default settings::
+
+ $source = array(
+ 'Csv',
+ '/path/to/file.csv'
+ );
+
+Complex configuration::
+
+ $source = array(
+ 'Csv',
+ array(
+ 'filename' => '/path/to/file.csv',
+ 'columns' => array(
+ 'name' => 0,
+ 'event' => 1,
+ 'date' => 2
+ ),
+ 'firstLineIsHeader' => true,
+ 'defaultEvent' => 'Birthday',
+ 'separator' => ',',
+ )
+ );
+
+Configuration options
+---------------------
+``columns``
+ Determines the position of the name, event and date columns.
+ ``0`` is the first column.
+ You can use ``false`` to disable a column; helpful if there is no
+ ``event`` column.
+
+ Default:
+
+ ``array('name' => 0, 'event' => 1, 'date' => 2)``
+
+``defaultEvent``
+ Text to use as event if there is no event column.
+
+ Defaults to ``Birthday``
+
+``firstLineIsHeader``
+ If the first line in the CSV is column header data
+
+ Defaults to ``true``
+
+``separator``
+ How columns are separated.
+
+ Defaults to ``,``
+
+
+LDAP server
+===========
+*bdrem* can read birthdays and other events from persons in an LDAP server.
+It is known to work fine with ``evolutionPerson`` objects.
+Attributes ``birthDate`` and ``anniversary`` are read.
+
+Configure it as follows::
+
+ $source = array(
+ 'Ldap',
+ array(
+ 'host' => 'ldap.example.org',
+ 'basedn' => 'ou=adressbuch,dc=example,dc=org',
+ 'binddn' => 'cn=FIXME,ou=users,dc=example,dc=org',
+ 'bindpw' => 'FIXME'
+ )
+ );
+
+
+SQL database
+============
+Events can be fetched from any SQL database supported by PHP's
+PDO extension - MySQL, SQLite, PostgreSQL and so on.
+
+You may configure every little detail of your database::
+
+ $source = array(
+ 'Sql',
+ array(
+ 'dsn' => 'mysql:dbname=bdrem;host=127.0.0.1',
+ 'user' => 'FIXME',
+ 'password' => 'FIXME',
+ 'table' => 'contacts',
+ 'fields' => array(
+ 'date' => array(
+ //column name => event title
+ 'c_birthday' => 'Birthday'
+ ),
+ //column with name, or array with column names
+ 'name' => array('c_name'),
+ //sprintf-compatible name formatting instruction
+ 'nameFormat' => '%s',
+ )
+ )
+ );
+
+
+MS SQL server
+-------------