This file is part of the LDAP Persistence API (LPA).

Copyright Trenton D. Adams <trent ought trentonadams daught ca

LPA is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.

LPA is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
License for more details.

You should have received a copy of the GNU Lesser General Public
License along with LPA.  If not, see <http://www.gnu.org/licenses/>.

See the COPYING file for more information.

There is no proper website or domain for this project as of yet.  Github 
is THE place to find it.  http://trentonadams.github.com/lpa/

Currently, the best way to get started, on understanding how this project
works, is to look at the unit tests, except the LDAPFactoryTest. They use most
of the "current" functionality available.

I use IDEA's TO-DO tracking.  TODOs are marked with the following...
TODO             - probably obsolete, and should be discontinued
FEATURE          - a good feature to have, but not necessarily core
REQUIRED_FEATURE - a required feature to truly have a "functional" end product
MINOR            - a minor issue to deal with, does not imply small
CRITICAL         - a very critical part of the system.
TEST             - something that needs a test case
DOC              - something that needs better documentation

I trust that all libraries that are needed can be resolved by maven.

So, let's try it out; copy and paste the following commands.

git clone git://github.com/TrentonAdams/lpa.git
cd lpa
mvn -Ptest install 

Popular google searches to catch:
 - ldap persistence
 - ldap persistence api
 - java ldap api
 - java ldap api example

ISSUES
When submitting issues, please include an example ldap entry, or multiple entries,
depending on what is needed to provide the functionality requested, or to fix
the bug suggested.  Also provide schema LDIF files, if you have some sort
of special LDAP schema.  Ultimately, please write a unit test demonstrating
the problem, if it is not trivial.  This can be done easily by forking LPA
from github

If you are a developer, you may create new issues from source comments, using
the format below.  Once you're finished, you may run the issue creation script.
Square brackets indicate optional elements.  Basically, the contents of the
new-issue below are simply in shell environment variable format, so that they
can be sourced inside of a shell script.  Labels are separated by spaces.

# new-issue{title="blah";label="critical[ persisting]";content="new issue"}

Thanks.