readme.txt
1Important: The hander component extensionoptions.jar in the extensions may not
2contain exactly the same sources as the one build in the handler directory. To
3make sure that debugging works build the handler directory and put the
4extensionoptions.jar into the extension.
5
6
7
8leaf1.oxt: Defines a leaf under the node WriterNode
9================================================================================
10
11leaf1mod.oxt: Defines a leaf under the node WriterNode
12
13It has a douplicate 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).
14================================================================================
15
16leaf2.oxt: Defines a leaf under a node that has a name which requires special
17"xml encoding". The name is "My Writer's & Settings". The node is not assigned
18to a Module and the Node/AllModules property is not true. This is a typical
19scenario when a Node had been added to an existing Module and later the Module
20was removed. This is a situation which actually should not occur. In this case
21DO NOT show the Node in the OOo's options dialog, because it shows only nodes
22for a particular module and in this case the Module for the Node is unknown.
23In the Extension Manager's
24options dialog this Node can be shown because the Module is irrelevant.
25See also nodes5.oxt.
26================================================================================
27
28leaves1.oxt: multiple ordered leaves under available nodes. The leaves Lables are
29localized for en-US and de. The following leaves should appear:
30
31Writer:
32-leaves1 Writer 1 en-US
33-leaves1 Writer 2 en-US
34-leaves1 Writer 3 en-US
35
36Calc:
37-leaves1 Calc 3 en-US
38-leaves1 Calc 3 en-US
39-leaves1 Calc 3 en-US
40
41Draw:
42-leaves1 Draw 3 en-US
43-leaves1 Draw 3 en-US
44-leaves1 Draw 3 en-US
45
46If a german office is used then the strings contain "de" instead of "en-US".
47================================================================================
48
49leaves2.oxt: Same as leaves1.oxt. Use together with leaves1.oxt to test the
50grouping of leaves.
51================================================================================
52
53leaves3.oxt: Same as leaves1.oxt, but the leaves are not ordered.
54================================================================================
55
56nodes1.oxt: Defines one node which has AllModules set and which has
57no children. Therefore this node should not be displayed.
58================================================================================
59
60nodes2.oxt: Defines 3 nodes which use AllModules and which form an
61ordered group. Every node defines also 3 nodes which have a determined order.
62
63-nodes2 node 1 en-US
64 -nodes2 node 1 leaf 1 en-US
65 -nodes2 node 1 leaf 2 en-US
66 -nodes2 node 1 leaf 3 en-US
67
68-nodes2 node 2 en-US
69 -nodes2 node 2 leaf 1 en-US
70 -nodes2 node 2 leaf 2 en-US
71 -nodes2 node 2 leaf 3 en-US
72
73-nodes2 node 3 en-US
74 -nodes2 node 3 leaf 1 en-US
75 -nodes2 node 3 leaf 2 en-US
76 -nodes2 node 3 leaf 3 en-US
77
78================================================================================
79
80nodes3.oxt: Defines 3 nodes which are placed under different existing Modules.
81The nodes and there leaves are ordered.
82
83Context Writer:
84- nodes3 node 1
85 nodes3 node 1 leaf 1 en-US
86 nodes3 node 1 leaf 2 en-US
87 nodes3 node 1 leaf 3 en-US
88
89- nodes3 node 2
90 nodes3 node 2 leaf 1 en-US
91 nodes3 node 2 leaf 2 en-US
92 nodes3 node 2 leaf 3 en-US
93
94- nodes3 node 3
95 nodes3 node 3 leaf 1 en-US
96 nodes3 node 3 leaf 2 en-US
97 nodes3 node 3 leaf 3 en-US
98
99Context Calc:
100- nodes3 node 1
101 nodes3 node 1 leaf 1 en-US
102 nodes3 node 1 leaf 2 en-US
103 nodes3 node 1 leaf 3 en-US
104
105- nodes3 node 3
106 nodes3 node 3 leaf 1 en-US
107 nodes3 node 3 leaf 2 en-US
108 nodes3 node 3 leaf 3 en-US
109
110Context Draw:
111- nodes3 node 2
112 nodes3 node 2 leaf 1 en-US
113 nodes3 node 2 leaf 2 en-US
114 nodes3 node 2 leaf 3 en-US
115
116================================================================================
117
118nodes4.oxt: Same as nodes3.oxt. Use together with nodes3.txt to test the
119grouping of nodes.
120================================================================================
121
122nodes5.oxt: Defines a node which in turn defines 3 leaves. The Node
123is not assigned to a Module and the AllModule property is false (which is the
124default).This may happen when a node
125had been added to an already existing Module and then this Module was removed. For
126example, an extension adds a node to the "Writer Module" and the
127next office update removes the "Writer Module" (which is rather inconceivable).
128Then the node and its leaves MUST NOT be displayed in OOo's options dialog,
129because the Module is not known. However, it can be displayed in the
130options dialog of the Extension Manager. See also the description for leaf2.oxt.
131================================================================================
132
133modules1.oxt: Defines two Modules and three Nodes. The Nodes may not
134be displayed in OOo's options dialog because there is currently no application
135which uses this Module. However the Nodes are displayed in the options dialog
136of the Extension Manager.
137There are three Nodes defined. The relation ship is this:
138
139-module1
140 -node 1
141 -leaf 1
142 -leaf 2
143 -leaf 3
144 -node 2
145 -leaf 1
146 -leaf 2
147 -leaf 3
148 -node 3
149 -leaf 1
150 -leaf 2
151 -leaf 3
152
153-module2
154 -node1
155 -leaf 1
156 -leaf 2
157 -leaf 3
158 -node3
159 -leaf 1
160 -leaf 2
161 -leaf 3
162
163The options dialog of the Extension Manager shall display only three nodes:
164
165 -node 1
166 -leaf 1
167 -leaf 2
168 -leaf 3
169 -node 2
170 -leaf 1
171 -leaf 2
172 -leaf 3
173 -node 3
174 -leaf 1
175 -leaf 2
176 -leaf 3
177
178or
179
180 -node 1
181 -leaf 1
182 -leaf 2
183 -leaf 3
184 -node 3
185 -leaf 1
186 -leaf 2
187 -leaf 3
188 -node 2
189 -leaf 1
190 -leaf 2
191 -leaf 3
192
193Since the order of Module|s is not defined, the dialog may display first the
194Nodes from module2 and then from module1. If a node is already displayed then
195it is not shown again.
196
197================================================================================
198
199modules2.oxt: Same as modules1, except that the order of nodes and leaves
200is not defined.
201