summaryrefslogtreecommitdiff
path: root/desktop/test/deployment/options/readme.txt
blob: 9879a72ceffac7a12aa2cdcec1d1cad25fc7f90d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
Important: The hander 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 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).
================================================================================

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 Lables 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 relation ship 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.