From e958eb5bcfc9feccbda7c0841b05939506143ad8 Mon Sep 17 00:00:00 2001
From: matthew_swift <matthew_swift@localhost>
Date: Fri, 16 Nov 2007 10:47:40 +0000
Subject: [PATCH] Advanced properties phase 1: tag advanced properties and perform various clean-up to the XML definitions:

---
 opends/src/admin/defn/org/opends/server/admin/std/BackendConfiguration.xml |  152 ++++++++++++++++++++++----------------------------
 1 files changed, 67 insertions(+), 85 deletions(-)

diff --git a/opends/src/admin/defn/org/opends/server/admin/std/BackendConfiguration.xml b/opends/src/admin/defn/org/opends/server/admin/std/BackendConfiguration.xml
index 0f896b3..cf90798 100644
--- a/opends/src/admin/defn/org/opends/server/admin/std/BackendConfiguration.xml
+++ b/opends/src/admin/defn/org/opends/server/admin/std/BackendConfiguration.xml
@@ -1,60 +1,58 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
- ! CDDL HEADER START
- !
- ! The contents of this file are subject to the terms of the
- ! Common Development and Distribution License, Version 1.0 only
- ! (the "License").  You may not use this file except in compliance
- ! with the License.
- !
- ! You can obtain a copy of the license at
- ! trunk/opends/resource/legal-notices/OpenDS.LICENSE
- ! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
- ! See the License for the specific language governing permissions
- ! and limitations under the License.
- !
- ! When distributing Covered Code, include this CDDL HEADER in each
- ! file and include the License file at
- ! trunk/opends/resource/legal-notices/OpenDS.LICENSE.  If applicable,
- ! add the following below this CDDL HEADER, with the fields enclosed
- ! by brackets "[]" replaced with your own identifying information:
- !      Portions Copyright [yyyy] [name of copyright owner]
- !
- ! CDDL HEADER END
- !
- !
- !      Portions Copyright 2007 Sun Microsystems, Inc.
- ! -->
-
-<adm:managed-object
-     name="backend"
-     plural-name="backends"
-     package="org.opends.server.admin.std"
-     xmlns:adm="http://www.opends.org/admin"
-     xmlns:ldap="http://www.opends.org/admin-ldap">
+  ! CDDL HEADER START
+  !
+  ! The contents of this file are subject to the terms of the
+  ! Common Development and Distribution License, Version 1.0 only
+  ! (the "License").  You may not use this file except in compliance
+  ! with the License.
+  !
+  ! You can obtain a copy of the license at
+  ! trunk/opends/resource/legal-notices/OpenDS.LICENSE
+  ! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
+  ! See the License for the specific language governing permissions
+  ! and limitations under the License.
+  !
+  ! When distributing Covered Code, include this CDDL HEADER in each
+  ! file and include the License file at
+  ! trunk/opends/resource/legal-notices/OpenDS.LICENSE.  If applicable,
+  ! add the following below this CDDL HEADER, with the fields enclosed
+  ! by brackets "[]" replaced with your own identifying information:
+  !      Portions Copyright [yyyy] [name of copyright owner]
+  !
+  ! CDDL HEADER END
+  !
+  !
+  !      Portions Copyright 2007 Sun Microsystems, Inc.
+  ! -->
+<adm:managed-object name="backend" plural-name="backends"
+  package="org.opends.server.admin.std"
+  xmlns:adm="http://www.opends.org/admin"
+  xmlns:ldap="http://www.opends.org/admin-ldap">
   <adm:synopsis>
-    <adm:user-friendly-plural-name/> are responsible for providing access
-    to the underlying data presented by the server. The data may be stored
-    locally (e.g., in an embedded database), remotely (e.g., in an
-    external system), or generated on the fly (e.g., calculated from other
-    information that is available).
+    <adm:user-friendly-plural-name />
+    are responsible for providing access to the underlying data
+    presented by the server.
   </adm:synopsis>
-  <adm:tag name="database"/>
+  <adm:description>
+    The data may be stored locally (e.g., in an embedded database),
+    remotely (e.g., in an external system), or generated on the fly
+    (e.g., calculated from other information that is available).
+  </adm:description>
+  <adm:tag name="database" />
   <adm:profile name="ldap">
     <ldap:object-class>
       <ldap:name>ds-cfg-backend</ldap:name>
       <ldap:superior>top</ldap:superior>
     </ldap:object-class>
   </adm:profile>
-  <adm:property name="enabled"
-    mandatory="true"
-    multi-valued="false">
+  <adm:property name="enabled" mandatory="true">
     <adm:synopsis>
       Indicates whether the backend is enabled for use in the server.
     </adm:synopsis>
     <adm:description>
-      If a backend is not enabled, then its contents will not be accessible
-      when processing operations.
+      If a backend is not enabled, then its contents will not be
+      accessible when processing operations.
     </adm:description>
     <adm:syntax>
       <adm:boolean />
@@ -65,20 +63,13 @@
       </ldap:attribute>
     </adm:profile>
   </adm:property>
-  <adm:property name="java-class"
-    mandatory="true"
-    multi-valued="false">
+  <adm:property name="java-class" mandatory="true">
     <adm:synopsis>
       The fully-qualified name of the Java class that provides the
       backend implementation.
     </adm:synopsis>
-    <adm:description>
-      The specified class must be a subclass of the
-      org.opends.server.api.Backend superclass.  The backend must be disabled
-      and re-enabled for changes to the handler class to take effect.
-    </adm:description>
     <adm:requires-admin-action>
-      <adm:component-restart/>
+      <adm:component-restart />
     </adm:requires-admin-action>
     <adm:syntax>
       <adm:java-class>
@@ -91,8 +82,7 @@
       </ldap:attribute>
     </adm:profile>
   </adm:property>
-  <adm:property name="backend-id" mandatory="true" read-only="true"
-    multi-valued="false">
+  <adm:property name="backend-id" mandatory="true" read-only="true">
     <adm:synopsis>
       Provides a name that will be used to identify the associated
       backend.
@@ -109,27 +99,20 @@
       </ldap:attribute>
     </adm:profile>
   </adm:property>
-  <adm:property name="writability-mode"
-    mandatory="true"
-    multi-valued="false">
+  <adm:property name="writability-mode" mandatory="true">
     <adm:synopsis>
-      Specifies the behavior that the backend should use when processing write
-      operations.
+      Specifies the behavior that the backend should use when processing
+      write operations.
     </adm:synopsis>
-    <adm:description>
-      A value of "enabled" will allow write operations to be
-      performed in that backend (if the requested operation is valid, the user
-      has permission to perform the operation, the backend supports that type
-      of write operation, and the global writability mode property is also
-      enabled).  A value of "disabled" will cause all write attempts to
-      fail, and a value of "internal-only" will cause external write attempts
-      to fail but will allow writes by replication and internal operations.
-    </adm:description>
     <adm:syntax>
       <adm:enumeration>
         <adm:value name="enabled">
           <adm:synopsis>
-            Allows write operations to be performed in that backend.
+            Allows write operations to be performed in that backend (if
+            the requested operation is valid, the user has permission to
+            perform the operation, the backend supports that type of
+            write operation, and the global writability mode property is
+            also enabled).
           </adm:synopsis>
         </adm:value>
         <adm:value name="disabled">
@@ -151,29 +134,28 @@
       </ldap:attribute>
     </adm:profile>
   </adm:property>
-  <adm:property name="base-dn"
-    mandatory="true"
-    multi-valued="true">
+  <adm:property name="base-dn" mandatory="true" multi-valued="true">
     <adm:synopsis>
-      Specifies the base DN(s) for the data that the backend will handle.
+      Specifies the base DN(s) for the data that the backend will
+      handle.
     </adm:synopsis>
     <adm:description>
-      A single backend may be responsible for one or more base DNs.  Note
-      that no two backends may have the same base DN, although one backend
-      may have a base DN that is below a base DN provided by another
-      backend (similar to the use of sub-suffixes in the Sun Java System
-      Directory Server).  Note that if any of the base DNs is subordinate
-      to a base DN for another backend, then all base DNs for that backend
-      must be subordinate to that same base DN.
+      A single backend may be responsible for one or more base DNs. Note
+      that no two backends may have the same base DN, although one
+      backend may have a base DN that is below a base DN provided by
+      another backend (similar to the use of sub-suffixes in the Sun
+      Java System Directory Server). Note that if any of the base DNs is
+      subordinate to a base DN for another backend, then all base DNs
+      for that backend must be subordinate to that same base DN.
     </adm:description>
     <adm:requires-admin-action>
-      <adm:other>
+      <adm:none>
         <adm:synopsis>
-          No administrative action is required by default, although some action
-          may be required on a per-backend basis before the new base DN may
-          be used.
+          No administrative action is required by default, although some
+          action may be required on a per-backend basis before the new
+          base DN may be used.
         </adm:synopsis>
-      </adm:other>
+      </adm:none>
     </adm:requires-admin-action>
     <adm:syntax>
       <adm:dn />

--
Gitblit v1.10.0