Using LDAP in Sylpheed Mini-HOWTO
--------------------------------- 

0. Configuring Sylpheed with LDAP support

To configure Sylpheed with LDAP support, use the following configure option:

   ./configure --enable-ldap

1. Adding a new server

The first step to use LDAP within Sylpheed is to add an LDAP server. For
this, go Tools menu in main window and open the Addressbook. Once the Addressbook
is opened, go to File menu and select 'New server'. A nice message dialog
will pop up where you must fill in the following fields (Basic tab):

  * Name - the nickname of the server for your addressbook.
  * Hostname - name or IP address of your server.
  * Port - defaulted to 389, change it only if you know the server is 
    running in a different port.

When you have completed these, press the 'Check Server' button, and if all goes ok the
status line will reflect the successful connection and the 'Search Base'
field will be filled with some strings.

2. Advanced settings

In the Extended tab of the dialog you can fill the following fields:

  * Search Criteria - the data to be matched in your search. You
    should refer to more advanced LDAP documents on the syntax used for
    specifying search criteria. 
    A Reset button allows to put back the default contents of this field.
  * Bind DN - bind distinguished name (that is not subject to access 
    control or administrative limit restrictions for operations on the 
    server)
  * Bind Password - associated password for the DN.
  * Timeout (secs) - the number of seconds Sylpheed will wait before
    considering the query has failed.
  * Maximum Entries - the maximum number of entries that will be accepted
    as result of the query (the rest will be discarded and not listed).

3. Using an LDAP server

Once you have successfully defined one or more servers you will probably
want to use them. Nothing is more easy:

  * In the Addressbook tree select the server that you want to be queried
  * fill in the 'Name' field on the right (over the buttons)
  * press the 'Lookup' button

If there is somebody in the server that matches your query their addresses
and aliases will appear in the list (over the name field)

4. Changing configuration of a defined server

  * Select the server on the Addressbook tree
  * right-click, select 'Edit' and the configuration dialog will appear.  
  * change the values in Basic or Extended tabs to reflect your new   
    configuration  
  * press the OK button to save. 

5. More info

   http://www.openldap.org

6. Disclaimer

  Use this information at your own risk. The author isn't a LDAP expert
  neither a Sylpheed expert. 

  Sylpheed is Free Software in development, so specified procedures,
  labels or option names may change without warning. If you're using 
  a localized version of Sylpheed check the label names first.

  Feel free to send corrections or additions to this document, all will
 benefit of your help.

7. Credits 
-- 
  Ricardo Mones Lastra - mones@aic.uniovi.es
  Centro de Inteligencia Artificial, Universidad de Oviedo en Gijon
  33271 Asturias, SPAIN. - http://www.aic.uniovi.es/mones
