You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by ak...@apache.org on 2004/12/14 20:12:43 UTC
svn commit: r111861 - /incubator/directory/eve/trunk/xdocs/plugin.xml
Author: akarasulu
Date: Tue Dec 14 11:12:42 2004
New Revision: 111861
URL: http://svn.apache.org/viewcvs?view=rev&rev=111861
Log:
cleanup docos on eve plugin
Modified:
incubator/directory/eve/trunk/xdocs/plugin.xml
Modified: incubator/directory/eve/trunk/xdocs/plugin.xml
Url: http://svn.apache.org/viewcvs/incubator/directory/eve/trunk/xdocs/plugin.xml?view=diff&rev=111861&p1=incubator/directory/eve/trunk/xdocs/plugin.xml&r1=111860&p2=incubator/directory/eve/trunk/xdocs/plugin.xml&r2=111861
==============================================================================
--- incubator/directory/eve/trunk/xdocs/plugin.xml (original)
+++ incubator/directory/eve/trunk/xdocs/plugin.xml Tue Dec 14 11:12:42 2004
@@ -8,20 +8,36 @@
<body>
<section name="Maven Eve Plugin">
<p>
- Right now one of the primary functions of the plugin is to generates
- Eve class files for OpenLDAP schemas. These class files contain hard
- coded schema objects found in the OpenLDAP files. Why bother you may
- ask? Well the compiled hard coded files are loaded into the server
- as fast as you can. There's no need to have a parser hanging around
- and no need to have the schema files hanging around. Plus no one
- really edits finalized published schemas within RFCs since they do not
- change. So why keep this stuff in a human alterable form. Plus once
- the server comes online these schema objects can be altered through
- LDAP. The added stage of compiling a schema really is not that much
- of a big deal when you have a plugin to do it all for you. Plus there
- is the benefit of knowing if the schema is bad before it goes into the
- server.
- </p>
+ Currently the primary function of the plugin is to generates Eve class
+ files for OpenLDAP schemas. These class files contain hard coded schema
+ objects representing those found in the OpenLDAP files. Why bother you
+ may ask? There are a few reasons for this:
+ </p>
+
+ <ul>
+ <li>
+ Compiled hard coded files load into the server really fast in theory.
+ </li>
+ <li>
+ Published schemas never really change so why do they need to be in a
+ human readable form.
+ </li>
+ <li>
+ Eventually, schema changes made through LDAP will be preserved through
+ restarts.
+ </li>
+ <li>
+ Extra code generation phase is not that hard with a plugin tool.
+ </li>
+ <li>
+ Schema verification can occur before deploying schemas into the
+ server.
+ </li>
+ <li>
+ This was really easy for now but if people don't like it we can
+ change it.
+ </li>
+ </ul>
<subsection name="Properties">
<table>