directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From akaras...@apache.org
Subject svn commit: r111861 - /incubator/directory/eve/trunk/xdocs/plugin.xml
Date Tue, 14 Dec 2004 19:12:43 GMT
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>

Mime
View raw message