Adding upstream version 1:7.0.4.upstream/1%7.0.4upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

17 files changed, 663 insertions, 0 deletions

diff --git a/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/MANIFEST.MF b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/MANIFEST.MF
new file mode 100644
index 000000000..fba55a6e0
--- /dev/null
+++ b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/MANIFEST.MF
@@ -0,0 +1,2 @@
+RegistrationClassName: com.sun.star.comp.extensionoptions.OptionsEventHandler
+
diff --git a/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/OptionsEventHandler.java b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/OptionsEventHandler.java
new file mode 100644
index 000000000..b360f470b
--- /dev/null
+++ b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/OptionsEventHandler.java
@@ -0,0 +1,417 @@
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ *   Licensed to the Apache Software Foundation (ASF) under one or more
+ *   contributor license agreements. See the NOTICE file distributed
+ *   with this work for additional information regarding copyright
+ *   ownership. The ASF licenses this file to you under the Apache
+ *   License, Version 2.0 (the "License"); you may not use this file
+ *   except in compliance with the License. You may obtain a copy of
+ *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+package com.sun.star.comp.extensionoptions;
+
+import com.sun.star.configuration.theDefaultProvider;
+import com.sun.star.lib.uno.helper.Factory;
+import com.sun.star.lib.uno.helper.WeakBase;
+import com.sun.star.lang.XSingleComponentFactory;
+import com.sun.star.lang.XMultiServiceFactory;
+import com.sun.star.lang.WrappedTargetException;
+import com.sun.star.lang.XServiceInfo;
+import com.sun.star.uno.UnoRuntime;
+import com.sun.star.uno.AnyConverter;
+import com.sun.star.uno.XComponentContext;
+import com.sun.star.uno.Exception;
+import com.sun.star.registry.XRegistryKey;
+import com.sun.star.awt.XContainerWindowEventHandler;
+import com.sun.star.awt.XControl;
+import com.sun.star.awt.XControlModel;
+import com.sun.star.awt.XControlContainer;
+import com.sun.star.container.XNameAccess;
+import com.sun.star.beans.NamedValue;
+import com.sun.star.beans.XPropertySet;
+import com.sun.star.util.XChangesBatch;
+
+/** A handler which supports multiple options pages which all
+ *  have the same controls.
+ */
+public class OptionsEventHandler {
+
+    public static class _OptionsEventHandler extends WeakBase
+        implements XServiceInfo, XContainerWindowEventHandler {
+
+        private static final String __serviceName =
+        "com.sun.star.comp.extensionoptions.OptionsEventHandler";
+
+        private final XComponentContext m_cmpCtx;
+
+        private XNameAccess m_xAccessLeaves;
+
+        /**Names of supported options pages.
+         */
+        private final String[] m_arWindowNames = {
+            "Writer1", "Writer2", "Writer3", "Calc1", "Calc2", "Calc3",
+            "Draw1", "Draw2", "Draw3", "Node1_1", "Node1_2", "Node1_3",
+            "Node2_1", "Node2_2", "Node2_3", "Node3_1", "Node3_2", "Node3_3"};
+
+        /**Names of the controls which are supported by this handler. All these
+         *controls must have a "Text" property.
+         */
+        private final String[] m_arStringControls = {
+            "String0", "String1", "String2", "String3", "String4"};
+
+        public _OptionsEventHandler(XComponentContext xCompContext) {
+                m_cmpCtx = xCompContext;
+
+            //Create the com.sun.star.configuration.ConfigurationUpdateAccess
+            //for the registry node which contains the data for our option
+            //pages.
+            XMultiServiceFactory xConfig = theDefaultProvider.get(m_cmpCtx);
+
+            //One argument for creating the ConfigurationUpdateAccess is the "nodepath".
+            //Our nodepath point to the node of which the direct subnodes represent the
+            //different options pages.
+            Object[] args = new Object[1];
+            args[0] = new NamedValue(
+                "nodepath",
+                "/org.openoffice.desktop.deployment.options.ExtensionData/Leaves");
+
+            //We get the com.sun.star.container.XNameAccess from the instance of
+            //ConfigurationUpdateAccess and save it for later use.
+            try {
+                m_xAccessLeaves = UnoRuntime.queryInterface(
+                    XNameAccess.class, xConfig.createInstanceWithArguments(
+                        "com.sun.star.configuration.ConfigurationUpdateAccess", args));
+
+            } catch (com.sun.star.uno.Exception e) {
+                e.printStackTrace();
+                return;
+            }
+        }
+
+        /** This method returns an array of all supported service names.
+         * @return Array of supported service names.
+         */
+        public String[] getSupportedServiceNames() {
+            return getServiceNames();
+        }
+
+        /** This method is a simple helper function to used in the
+         * static component initialisation functions as well as in
+         * getSupportedServiceNames.
+         */
+        private static String[] getServiceNames() {
+            String[] sSupportedServiceNames = { __serviceName };
+            return sSupportedServiceNames;
+        }
+
+        /** This method returns true, if the given service will be
+         * supported by the component.
+         * @param sServiceName Service name.
+         * @return True, if the given service name will be supported.
+         */
+        public boolean supportsService( String sServiceName ) {
+            return sServiceName.equals( __serviceName );
+        }
+
+        /** Return the class name of the component.
+         * @return Class name of the component.
+         */
+        public String getImplementationName() {
+            return  _OptionsEventHandler.class.getName();
+        }
+
+        //XContainerWindowEventHandler
+        public boolean callHandlerMethod(com.sun.star.awt.XWindow aWindow,
+                                        Object aEventObject, String sMethod)
+            throws WrappedTargetException {
+            if (sMethod.equals("external_event") ){
+                try {
+                    return handleExternalEvent(aWindow, aEventObject);
+                } catch (com.sun.star.uno.Exception e) {
+                    throw new WrappedTargetException(e, sMethod, this, e);
+                }
+            }
+
+            return true;
+        }
+
+        //XContainerWindowEventHandler
+        public String[] getSupportedMethodNames() {
+            return new String[] {"external_event"};
+        }
+
+        private boolean handleExternalEvent(com.sun.star.awt.XWindow aWindow, Object aEventObject)
+            throws com.sun.star.uno.Exception {
+            try {
+                String sMethod = AnyConverter.toString(aEventObject);
+                if (sMethod.equals("ok")) {
+                    saveData(aWindow);
+                } else if (sMethod.equals("back") || sMethod.equals("initialize")) {
+                    loadData(aWindow);
+                }
+            } catch (com.sun.star.lang.IllegalArgumentException ex) {
+                throw new com.sun.star.lang.IllegalArgumentException(ex,
+                    "Method external_event requires a string in the event object argument.",
+                    this, (short) -1);
+            }
+
+            return true;
+        }
+
+        private void saveData(com.sun.star.awt.XWindow aWindow)
+            throws com.sun.star.lang.IllegalArgumentException,
+            com.sun.star.uno.Exception {
+
+            //Determine the name of the options page. This serves two purposes. First, if this
+            //options page is supported by this handler and second we use the name two locate
+            //the corresponding data in the registry.
+            String sWindowName = getWindowName(aWindow);
+            if (sWindowName == null)
+                throw new com.sun.star.lang.IllegalArgumentException(
+                    "This window is not supported by this handler", this, (short) -1);
+
+            //To access the separate controls of the window we need to obtain the
+            //XControlContainer from the window implementation
+            XControlContainer xContainer = UnoRuntime.queryInterface(
+                XControlContainer.class, aWindow);
+            if (xContainer == null)
+                throw new com.sun.star.uno.Exception(
+                    "Could not get XControlContainer from window.", this);
+
+            //This is an implementation which will be used for several options pages
+            //which all have the same controls. m_arStringControls is an array which
+            //contains the names.
+            for (int i = 0; i < m_arStringControls.length; i++) {
+
+                //To obtain the data from the controls we need to get their model.
+                //First get the respective control from the XControlContainer.
+                XControl xControl = xContainer.getControl(m_arStringControls[i]);
+
+                //This generic handler and the corresponding registry schema support
+                //up to five text controls. However, if an options page does not use all
+                //five controls then we will not complain here.
+                if (xControl == null)
+                    continue;
+
+                //From the control we get the model, which in turn supports the
+                //XPropertySet interface, which we finally use to get the data from
+                //the control.
+                XPropertySet xProp = UnoRuntime.queryInterface(
+                    XPropertySet.class, xControl.getModel());
+
+                if (xProp == null)
+                    throw new com.sun.star.uno.Exception(
+                        "Could not get XPropertySet from control.", this);
+                //Get the "Text" property.
+                Object aText = xProp.getPropertyValue("Text");
+                String sValue = null;
+
+                //The value is still contained in a com.sun.star.uno.Any - so convert it.
+                try {
+                    sValue = AnyConverter.toString(aText);
+                } catch (com.sun.star.lang.IllegalArgumentException ex) {
+                    throw new com.sun.star.lang.IllegalArgumentException(ex,
+                        "Wrong property type.", this, (short) -1);
+                }
+
+                //Now we have the actual string value of the control. What we need now is
+                //the XPropertySet of the respective property in the registry, so that we
+                //can store the value.
+                //To access the registry we have previously created a service instance
+                //of com.sun.star.configuration.ConfigurationUpdateAccess which supports
+                //com.sun.star.container.XNameAccess. The XNameAccess is used to get the
+                //particular registry node which represents this options page.
+                //Fortunately the name of the window is the same as the registry node.
+                XPropertySet xLeaf = UnoRuntime.queryInterface(
+                    XPropertySet.class, m_xAccessLeaves.getByName(sWindowName));
+                if (xLeaf == null)
+                    throw new  com.sun.star.uno.Exception(
+                        "XPropertySet not supported.", this);
+
+                //Finally we can set the value
+                xLeaf.setPropertyValue(m_arStringControls[i], sValue);
+            }
+
+            //Committing the changes will cause or changes to be written to the registry.
+            XChangesBatch xUpdateCommit =
+                UnoRuntime.queryInterface(XChangesBatch.class, m_xAccessLeaves);
+            xUpdateCommit.commitChanges();
+        }
+
+        private void loadData(com.sun.star.awt.XWindow aWindow)
+            throws com.sun.star.uno.Exception {
+
+            //Determine the name of the window. This serves two purposes. First, if this
+            //window is supported by this handler and second we use the name two locate
+            //the corresponding data in the registry.
+            String sWindowName = getWindowName(aWindow);
+            if (sWindowName == null)
+                throw new com.sun.star.lang.IllegalArgumentException(
+                    "The window is not supported by this handler", this, (short) -1);
+
+            //To access the separate controls of the window we need to obtain the
+            //XControlContainer from window implementation
+            XControlContainer xContainer = UnoRuntime.queryInterface(
+                XControlContainer.class, aWindow);
+            if (xContainer == null)
+                throw new com.sun.star.uno.Exception(
+                    "Could not get XControlContainer from window.", this);
+
+            //This is an implementation which will be used for several options pages
+            //which all have the same controls. m_arStringControls is an array which
+            //contains the names.
+            for (int i = 0; i < m_arStringControls.length; i++) {
+
+                //load the values from the registry
+                //To access the registry we have previously created a service instance
+                //of com.sun.star.configuration.ConfigurationUpdateAccess which supports
+                //com.sun.star.container.XNameAccess. We obtain now the section
+                //of the registry which is assigned to this options page.
+                XPropertySet xLeaf = UnoRuntime.queryInterface(
+                    XPropertySet.class, m_xAccessLeaves.getByName(sWindowName));
+                if (xLeaf == null)
+                    throw new  com.sun.star.uno.Exception(
+                        "XPropertySet not supported.", this);
+
+                //The properties in the registry have the same name as the respective
+                //controls. We use the names now to obtain the property values.
+                Object aValue = xLeaf.getPropertyValue(m_arStringControls[i]);
+
+                //Now that we have the value we need to set it at the corresponding
+                //control in the window. The XControlContainer, which we obtained earlier
+                //is the means to get hold of all the controls.
+                XControl xControl = xContainer.getControl(m_arStringControls[i]);
+
+                //This generic handler and the corresponding registry schema support
+                //up to five text controls. However, if an options page does not use all
+                //five controls then we will not complain here.
+                if (xControl == null)
+                    continue;
+
+                //From the control we get the model, which in turn supports the
+                //XPropertySet interface, which we finally use to set the data at the
+                //control
+                XPropertySet xProp = UnoRuntime.queryInterface(
+                    XPropertySet.class, xControl.getModel());
+
+                if (xProp == null)
+                    throw new com.sun.star.uno.Exception(
+                        "Could not get XPropertySet from control.", this);
+
+                //This handler supports only text controls, which are named "Pattern Field"
+                //in the dialog editor. We set the "Text" property.
+                xProp.setPropertyValue("Text", aValue);
+            }
+        }
+
+        //Checks if the name property of the window is one of the supported names and returns
+        //always a valid string or null
+        private String getWindowName(com.sun.star.awt.XWindow aWindow)
+            throws com.sun.star.uno.Exception {
+
+            if (aWindow == null)
+                throw new com.sun.star.lang.IllegalArgumentException(
+                    "Method external_event requires that a window is passed as argument",
+                    this, (short) -1);
+
+            //We need to get the control model of the window. Therefore the first step is
+            //to query for it.
+            XControl xControlDlg = UnoRuntime.queryInterface(
+                XControl.class, aWindow);
+
+            if (xControlDlg == null)
+                throw new com.sun.star.uno.Exception(
+                    "Cannot obtain XControl from XWindow in method external_event.");
+            //Now get model
+            XControlModel xModelDlg = xControlDlg.getModel();
+
+            if (xModelDlg == null)
+                throw new com.sun.star.uno.Exception(
+                    "Cannot obtain XControlModel from XWindow in method external_event.", this);
+            //The model itself does not provide any information except that its
+            //implementation supports XPropertySet which is used to access the data.
+            XPropertySet xPropDlg = UnoRuntime.queryInterface(
+                XPropertySet.class, xModelDlg);
+            if (xPropDlg == null)
+                throw new com.sun.star.uno.Exception(
+                    "Cannot obtain XPropertySet from window in method external_event.", this);
+
+            //Get the "Name" property of the window
+            Object aWindowName = xPropDlg.getPropertyValue("Name");
+
+            //Get the string from the returned com.sun.star.uno.Any
+            String sName = null;
+            try {
+                sName = AnyConverter.toString(aWindowName);
+            } catch (com.sun.star.lang.IllegalArgumentException ex) {
+                throw new com.sun.star.uno.Exception(ex,
+                    "Name - property of window is not a string.", this);
+            }
+
+            //Eventually we can check if we this handler can "handle" this options page.
+            //The class has a member m_arWindowNames which contains all names of windows
+            //for which it is intended
+            for (int i = 0; i < m_arWindowNames.length; i++) {
+                if (m_arWindowNames[i].equals(sName)) {
+                    return sName;
+                }
+            }
+            return null;
+        }
+    }
+
+
+    /**
+     * Gives a factory for creating the service.
+     * This method is called by the <code>JavaLoader</code>
+     * <p>
+     * @return  returns a <code>XSingleComponentFactory</code> for creating
+     *          the component
+     * @param   sImplName the name of the implementation for which a
+     *          service is desired
+     * @see     com.sun.star.comp.loader.JavaLoader
+     */
+    public static XSingleComponentFactory __getComponentFactory(String sImplName)
+    {
+        XSingleComponentFactory xFactory = null;
+
+        if ( sImplName.equals( _OptionsEventHandler.class.getName() ) )
+            xFactory = Factory.createComponentFactory(_OptionsEventHandler.class,
+                                             _OptionsEventHandler.getServiceNames());
+
+        return xFactory;
+    }
+
+    /**
+     * Writes the service information into the given registry key.
+     * This method is called by the <code>JavaLoader</code>
+     * <p>
+     * @return  returns true if the operation succeeded
+     * @param   regKey the registryKey
+     * @see     com.sun.star.comp.loader.JavaLoader
+     */
+    public static boolean __writeRegistryServiceInfo(XRegistryKey regKey) {
+        return Factory.writeRegistryServiceInfo(_OptionsEventHandler.class.getName(),
+                                                _OptionsEventHandler.getServiceNames(),
+                                                regKey);
+    }
+
+    /** This method is a member of the interface for initializing an object
+     * directly after its creation.
+     * @param object This array of arbitrary objects will be passed to the
+     * component after its creation.
+     * @throws Exception Every exception will not be handled, but will be
+     * passed to the caller.
+     */
+    public void initialize( Object[] object )
+        throws com.sun.star.uno.Exception {
+    }
+
+}
diff --git a/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/makefile.mk b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/makefile.mk
new file mode 100644
index 000000000..4174e3bd7
--- /dev/null
+++ b/desktop/test/deployment/options/handler/com/sun/star/comp/extensionoptions/makefile.mk
@@ -0,0 +1,44 @@
+#
+# This file is part of the LibreOffice project.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# This file incorporates work covered by the following license notice:
+#
+#   Licensed to the Apache Software Foundation (ASF) under one or more
+#   contributor license agreements. See the NOTICE file distributed
+#   with this work for additional information regarding copyright
+#   ownership. The ASF licenses this file to you under the Apache
+#   License, Version 2.0 (the "License"); you may not use this file
+#   except in compliance with the License. You may obtain a copy of
+#   the License at http://www.apache.org/licenses/LICENSE-2.0 .
+#
+
+PRJ		= ..$/..$/..$/..$/..$/..$/..$/..$/..
+PRJNAME = desktop
+PACKAGE = com$/sun$/star$/comp$/extensionoptions
+TARGET  = options
+
+# --- Settings -----------------------------------------------------
+
+.INCLUDE : settings.mk
+
+JARFILES = ridl.jar jurt.jar unoil.jar juh.jar
+
+
+JARTARGET = extensionoptions.jar
+JARCOMPRESS 	= TRUE
+CUSTOMMANIFESTFILE = MANIFEST.MF
+JARCLASSDIRS=com
+
+
+# --- Files --------------------------------------------------------
+
+JAVAFILES = OptionsEventHandler.java
+
+# --- Targets ------------------------------------------------------
+
+.INCLUDE :  target.mk
+
diff --git a/desktop/test/deployment/options/leaf1.oxt b/desktop/test/deployment/options/leaf1.oxt
new file mode 100644
index 000000000..9c3ff8698
--- /dev/null
+++ b/desktop/test/deployment/options/leaf1.oxt
diff --git a/desktop/test/deployment/options/leaf1mod.oxt b/desktop/test/deployment/options/leaf1mod.oxt
new file mode 100644
index 000000000..d5d9fe689
--- /dev/null
+++ b/desktop/test/deployment/options/leaf1mod.oxt
diff --git a/desktop/test/deployment/options/leaf2.oxt b/desktop/test/deployment/options/leaf2.oxt
new file mode 100644
index 000000000..b95628900
--- /dev/null
+++ b/desktop/test/deployment/options/leaf2.oxt
diff --git a/desktop/test/deployment/options/leaves1.oxt b/desktop/test/deployment/options/leaves1.oxt
new file mode 100644
index 000000000..037389a01
--- /dev/null
+++ b/desktop/test/deployment/options/leaves1.oxt
diff --git a/desktop/test/deployment/options/leaves2.oxt b/desktop/test/deployment/options/leaves2.oxt
new file mode 100644
index 000000000..531b38566
--- /dev/null
+++ b/desktop/test/deployment/options/leaves2.oxt
diff --git a/desktop/test/deployment/options/leaves3.oxt b/desktop/test/deployment/options/leaves3.oxt
new file mode 100644
index 000000000..f5bb0f226
--- /dev/null
+++ b/desktop/test/deployment/options/leaves3.oxt
diff --git a/desktop/test/deployment/options/modules1.oxt b/desktop/test/deployment/options/modules1.oxt
new file mode 100644
index 000000000..bae652ffb
--- /dev/null
+++ b/desktop/test/deployment/options/modules1.oxt
diff --git a/desktop/test/deployment/options/modules2.oxt b/desktop/test/deployment/options/modules2.oxt
new file mode 100644
index 000000000..d6d7956d4
--- /dev/null
+++ b/desktop/test/deployment/options/modules2.oxt
diff --git a/desktop/test/deployment/options/nodes1.oxt b/desktop/test/deployment/options/nodes1.oxt
new file mode 100644
index 000000000..b1dfa18d3
--- /dev/null
+++ b/desktop/test/deployment/options/nodes1.oxt
diff --git a/desktop/test/deployment/options/nodes2.oxt b/desktop/test/deployment/options/nodes2.oxt
new file mode 100644
index 000000000..a35cfaba9
--- /dev/null
+++ b/desktop/test/deployment/options/nodes2.oxt
diff --git a/desktop/test/deployment/options/nodes3.oxt b/desktop/test/deployment/options/nodes3.oxt
new file mode 100644
index 000000000..db0bc49da
--- /dev/null
+++ b/desktop/test/deployment/options/nodes3.oxt
diff --git a/desktop/test/deployment/options/nodes4.oxt b/desktop/test/deployment/options/nodes4.oxt
new file mode 100644
index 000000000..fe0550fdc
--- /dev/null
+++ b/desktop/test/deployment/options/nodes4.oxt
diff --git a/desktop/test/deployment/options/nodes5.oxt b/desktop/test/deployment/options/nodes5.oxt
new file mode 100644
index 000000000..893e9ee3e
--- /dev/null
+++ b/desktop/test/deployment/options/nodes5.oxt
diff --git a/desktop/test/deployment/options/readme.txt b/desktop/test/deployment/options/readme.txt
new file mode 100644
index 000000000..58274ece7
--- /dev/null
+++ b/desktop/test/deployment/options/readme.txt
@@ -0,0 +1,200 @@
+Important: The handler component extensionoptions.jar in the extensions may not
+contain exactly the same sources as the one build in the handler directory. To
+make sure that debugging works build the handler directory and put the
+extensionoptions.jar into the extension.
+
+
+
+leaf1.oxt: Defines a leaf under the node WriterNode
+================================================================================
+
+leaf1mod.oxt: Defines a leaf under the node WriterNode
+
+It has a duplicate entry in the manifest.xml (OptionsDialog.xcu). This would cause a DisposedException when uninstalling on OOo 3.0 and prevent the extension from being uninstalled. This is actually a bug of the extensions. However, the error is difficult to investigate. Therefore this was fixed to make OOo more robust (i96690).
+================================================================================
+
+leaf2.oxt: Defines a leaf under a node that has a name which requires special
+"xml encoding". The name is "My Writer's & Settings". The node is not assigned
+to a Module and the Node/AllModules property is not true. This is a typical
+scenario when a Node had been added to an existing Module and later the Module
+was removed. This is a situation which actually should not occur. In this case
+DO NOT show the Node in the OOo's options dialog, because it shows only nodes
+for a particular module and in this case the Module for the Node is unknown.
+In the Extension Manager's
+options dialog this Node can be shown because the Module is irrelevant.
+See also nodes5.oxt.
+================================================================================
+
+leaves1.oxt: multiple ordered leaves under available nodes. The leaves Labels are
+localized for en-US and de. The following leaves should appear:
+
+Writer:
+-leaves1 Writer 1 en-US
+-leaves1 Writer 2 en-US
+-leaves1 Writer 3 en-US
+
+Calc:
+-leaves1 Calc 3 en-US
+-leaves1 Calc 3 en-US
+-leaves1 Calc 3 en-US
+
+Draw:
+-leaves1 Draw 3 en-US
+-leaves1 Draw 3 en-US
+-leaves1 Draw 3 en-US
+
+If a german office is used then the strings contain "de" instead of "en-US".
+================================================================================
+
+leaves2.oxt: Same as leaves1.oxt. Use together with leaves1.oxt to test the
+grouping of leaves.
+================================================================================
+
+leaves3.oxt: Same as leaves1.oxt, but the leaves are not ordered.
+================================================================================
+
+nodes1.oxt: Defines one node which has AllModules set and which has
+no children. Therefore this node should not be displayed.
+================================================================================
+
+nodes2.oxt: Defines 3 nodes which use AllModules and which form an
+ordered group. Every node defines also 3 nodes which have a determined order.
+
+-nodes2 node 1 en-US
+     -nodes2 node 1 leaf 1 en-US
+     -nodes2 node 1 leaf 2 en-US
+     -nodes2 node 1 leaf 3 en-US
+
+-nodes2 node 2 en-US
+     -nodes2 node 2 leaf 1 en-US
+     -nodes2 node 2 leaf 2 en-US
+     -nodes2 node 2 leaf 3 en-US
+
+-nodes2 node 3 en-US
+     -nodes2 node 3 leaf 1 en-US
+     -nodes2 node 3 leaf 2 en-US
+     -nodes2 node 3 leaf 3 en-US
+
+================================================================================
+
+nodes3.oxt: Defines 3 nodes which are placed under different existing Modules.
+The nodes and there leaves are ordered.
+
+Context Writer:
+- nodes3 node 1
+        nodes3 node 1 leaf 1 en-US
+	nodes3 node 1 leaf 2 en-US
+	nodes3 node 1 leaf 3 en-US
+
+- nodes3 node 2
+        nodes3 node 2 leaf 1 en-US
+	nodes3 node 2 leaf 2 en-US
+	nodes3 node 2 leaf 3 en-US
+
+- nodes3 node 3
+        nodes3 node 3 leaf 1 en-US
+	nodes3 node 3 leaf 2 en-US
+	nodes3 node 3 leaf 3 en-US
+
+Context Calc:
+- nodes3 node 1
+        nodes3 node 1 leaf 1 en-US
+	nodes3 node 1 leaf 2 en-US
+	nodes3 node 1 leaf 3 en-US
+
+- nodes3 node 3
+        nodes3 node 3 leaf 1 en-US
+	nodes3 node 3 leaf 2 en-US
+	nodes3 node 3 leaf 3 en-US
+
+Context Draw:
+- nodes3 node 2
+        nodes3 node 2 leaf 1 en-US
+	nodes3 node 2 leaf 2 en-US
+	nodes3 node 2 leaf 3 en-US
+
+================================================================================
+
+nodes4.oxt: Same as nodes3.oxt. Use together with nodes3.txt to test the
+grouping of nodes.
+================================================================================
+
+nodes5.oxt: Defines a node which in turn defines 3 leaves. The Node
+is not assigned to a Module and the AllModule property is false (which is the
+default).This may happen when a node
+had been added to an already existing Module and then this Module was removed. For
+example, an extension adds a node to the "Writer  Module" and the
+next office update removes the "Writer Module" (which is rather inconceivable).
+Then the node and its leaves MUST NOT be displayed in OOo's options dialog,
+because the Module is not known. However, it can be displayed in the
+options dialog of the Extension Manager. See also the description for leaf2.oxt.
+================================================================================
+
+modules1.oxt: Defines two Modules and three Nodes. The Nodes may not
+be displayed in OOo's options dialog because there is currently no application
+which uses this Module. However the Nodes are displayed in the options dialog
+of the Extension Manager.
+There are three Nodes defined. The relationship is this:
+
+-module1
+	-node 1
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+ 	-node 2
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+	-node 3
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+
+-module2
+	-node1
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+	-node3
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+
+The options dialog of the Extension Manager shall display only three nodes:
+
+	-node 1
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+ 	-node 2
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+	-node 3
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+
+or
+
+	-node 1
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+ 	-node 3
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+	-node 2
+	      -leaf 1
+	      -leaf 2
+	      -leaf 3
+
+Since the order of Module|s is not defined, the dialog may display first the
+Nodes from module2 and then from module1. If a node is already displayed then
+it is not shown again.
+
+================================================================================
+
+modules2.oxt: Same as modules1, except that the order of nodes and leaves
+is not defined.