Update ooo320-m1
[ooovba.git] / desktop / test / deployment / options / readme.txt
blob9879a72ceffac7a12aa2cdcec1d1cad25fc7f90d
1 Important: The hander component extensionoptions.jar in the extensions may not 
2 contain exactly the same sources as the one build in the handler directory. To
3 make sure that debugging works build the handler directory and put the 
4 extensionoptions.jar into the extension.
8 leaf1.oxt: Defines a leaf under the node WriterNode
9 ================================================================================
11 leaf1mod.oxt: Defines a leaf under the node WriterNode
13 It 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 ================================================================================
16 leaf2.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 
18 to a Module and the Node/AllModules property is not true. This is a typical 
19 scenario when a Node had been added to an existing Module and later the Module 
20 was removed. This is a situation which actually should not occur. In this case 
21 DO NOT show the Node in the OOo's options dialog, because it shows only nodes 
22 for a particular module and in this case the Module for the Node is unknown.
23 In the Extension Manager's 
24 options dialog this Node can be shown because the Module is irrelevant.
25 See also nodes5.oxt.
26 ================================================================================
28 leaves1.oxt: multiple ordered leaves under available nodes. The leaves Lables are 
29 localized for en-US and de. The following leaves should appear:
31 Writer:
32 -leaves1 Writer 1 en-US
33 -leaves1 Writer 2 en-US
34 -leaves1 Writer 3 en-US
36 Calc:
37 -leaves1 Calc 3 en-US
38 -leaves1 Calc 3 en-US
39 -leaves1 Calc 3 en-US
41 Draw:
42 -leaves1 Draw 3 en-US
43 -leaves1 Draw 3 en-US
44 -leaves1 Draw 3 en-US
46 If a german office is used then the strings contain "de" instead of "en-US".
47 ================================================================================
49 leaves2.oxt: Same as leaves1.oxt. Use together with leaves1.oxt to test the 
50 grouping of leaves.
51 ================================================================================
53 leaves3.oxt: Same as leaves1.oxt, but the leaves are not ordered.
54 ================================================================================
56 nodes1.oxt: Defines one node which has AllModules set and which has 
57 no children. Therefore this node should not be displayed.
58 ================================================================================
60 nodes2.oxt: Defines 3 nodes which use AllModules and which form an 
61 ordered group. Every node defines also 3 nodes which have a determined order.
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
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
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
78 ================================================================================
80 nodes3.oxt: Defines 3 nodes which are placed under different existing Modules. 
81 The nodes and there leaves are ordered.
83 Context 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
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
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
99 Context 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
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
110 Context 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
116 ================================================================================
118 nodes4.oxt: Same as nodes3.oxt. Use together with nodes3.txt to test the 
119 grouping of nodes.
120 ================================================================================
122 nodes5.oxt: Defines a node which in turn defines 3 leaves. The Node
123 is not assigned to a Module and the AllModule property is false (which is the 
124 default).This may happen when a node 
125 had been added to an already existing Module and then this Module was removed. For 
126 example, an extension adds a node to the "Writer  Module" and the 
127 next office update removes the "Writer Module" (which is rather inconceivable). 
128 Then the node and its leaves MUST NOT be displayed in OOo's options dialog, 
129 because the Module is not known. However, it can be displayed in the 
130 options dialog of the Extension Manager. See also the description for leaf2.oxt.
131 ================================================================================
133 modules1.oxt: Defines two Modules and three Nodes. The Nodes may not 
134 be displayed in OOo's options dialog because there is currently no application 
135 which uses this Module. However the Nodes are displayed in the options dialog 
136 of the Extension Manager.
137 There are three Nodes defined. The relation ship is this:
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
153 -module2
154         -node1
155               -leaf 1
156               -leaf 2
157               -leaf 3
158         -node3
159               -leaf 1
160               -leaf 2
161               -leaf 3
163 The options dialog of the Extension Manager shall display only three nodes:
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
178 or 
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
193 Since the order of Module|s is not defined, the dialog may display first the 
194 Nodes from module2 and then from module1. If a node is already displayed then 
195 it is not shown again.
197 ================================================================================
199 modules2.oxt: Same as modules1, except that the order of nodes and leaves 
200 is not defined.