/usr/share/gtk-doc/html/libanjuta/page-block.html is in libanjuta-dev 2:3.22.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Anjuta Developers Reference Manual: Wizard pages</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Anjuta Developers Reference Manual">
<link rel="up" href="project-wizard-format.html" title="New Project Wizard format">
<link rel="prev" href="header-block.html" title="Wizard header">
<link rel="next" href="content-block.html" title="Wizard content">
<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="project-wizard-format.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="header-block.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="content-block.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="page-block"></a>Wizard pages</h2></div></div></div>
<p>
This block defines all properties use by the project
and the corresponding graphical interface. These properties
are grouped in pages. Each page is read and transform with
autogen one by one taking in account the value of all properties
already defined in previous pages. This allows you
to generate pages according to the user inputs on the previous one.
</p>
<p>
<span class="emphasis"><em>page</em></span>
</p>
<pre class="programlisting">
<page name=name _label=label _description=description >
<property>
...
</page>
</pre>
<p>
</p>
<p>
It represents one page block and contains a set of properties.
</p>
<p>
</p>
<p>
name is the name of the page, currently unused.
</p>
<p>
</p>
<p>
label is the title of the page, it is a translatable
attribute.
</p>
<p>
</p>
<p>
description is a translatable sub title for the project page.
</p>
<p>
</p>
<p>
<span class="emphasis"><em>property</em></span>
</p>
<pre class="programlisting">
<property type=hidden|boolean|integer|string|list|directory|file|icon|package
name = name _label=label [_description=description] [default=default]
[mandatory=yes|no] [exist=yes|no] [summary=yes|no] >
[<item>]
...
</property>
</pre>
<p>
</p>
<p>
This is one of the most important element. A property
correspond to an entry widget to get the user choice
and a variable in the autogen definition file used to
control the generation of the project.
</p>
<p>
</p>
<p>
The type attribute define the kind of property. The following
types are defined
</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term">hidden</span></p></td>
<td><p>
This is the only property that does
not correspond to any widget. This
is useful to defined additional
autogen variables using only
name and default attributes. As this
value cannot be changed by the user
the default attribute defined the
value of the property.
</p></td>
</tr>
<tr>
<td><p><span class="term">boolean</span></p></td>
<td><p>
This correspond to a boolean variable.
It is represented by a toggle button. The
value is 1 if the user select Yes, and 0
if the user select No.
</p></td>
</tr>
<tr>
<td><p><span class="term">integer</span></p></td>
<td><p>
This correspond to a integer number. It
is represented by a spin button. The
value is the corresponding number.
</p></td>
</tr>
<tr>
<td><p><span class="term">string</span></p></td>
<td><p>
This is a string value represented by
an entry box. The value is the text
of this entry box.
</p></td>
</tr>
<tr>
<td><p><span class="term">list</span></p></td>
<td><p>
This property takes its value in
a list of values and is represented
by a list box. All the values
are defined with child item
element defined below. The value of
the property is defined by the name
attribute of the corresponding item.
</p></td>
</tr>
<tr>
<td><p><span class="term">directory</span></p></td>
<td><p>
This property get a directory selected
by the user. The directory could be
inexistent, see the exist attribute for
more information. It looks like a string
property with a Browse button.
</p></td>
</tr>
<tr>
<td><p><span class="term">file</span></p></td>
<td><p>
This property get a file selected
by the user. It is very similar to
the directory property.
</p></td>
</tr>
<tr>
<td><p><span class="term">icon</span></p></td>
<td><p>
This property is quite similar to the
file property and allow you to select
an icon. The property value will be
the name of the file containing the icon.
</p></td>
</tr>
<tr>
<td><p><span class="term">package</span></p></td>
<td><p>
This property is similar to the file
property and allow you to select a
pkg-config package. It displays an entry
box, that you can fill directly, with a
button allowing to display all
installed packages and select one.
The property value will be
the name of the package.
</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
<p>
</p>
<p>
name is the name of the autogen variable corresponding
to this property.
</p>
<p>
</p>
<p>
label is a translatable label that appears near the entry
widget.
</p>
<p>
</p>
<p>
description is a translatable description that appears
as a tips of the entry widget.
</p>
<p>
</p>
<p>
default is the default value of the property. If none is
specified the property is empty.
</p>
<p>
</p>
<p>
minimum is the minimum value for an integer property.
If none is specified the minimum value is 0.
</p>
<p>
</p>
<p>
maximum is the maximum value for an integer property.
If none is specified the maximum value is 10000.
</p>
<p>
</p>
<p>
step is the increment step when clicking on the arrow buttons or
using the cursor key, you can always write another value in the
allowed range.
If none is specified the value is incremented or decremented by 1.
</p>
<p>
</p>
<p>
mandatory allow you to define if an empty value is
acceptable, by default it is allowed. If you set it to
yes and the user does not enter a value, he will get an
error message and cannot go further.
</p>
<p>
</p>
<p>
exist allow to check if a file or a directory
corresponding to the value of the property exist. If exist
is set to no, a warning message is displayed if the file or
the directory exist. Moreover the value of the default
property is tested and a number is automatically added at the end
to avoid the warning message if necessary.
By default or if exist is set to yes,
no check is made.
</p>
<p>
</p>
<p>
summary defined if the property and its value should
appears at the end of the wizard. This happens if the
attribute is set to yes, by default or if it is set to no
the property is not displayed.
</p>
<p>
</p>
<p>
<span class="emphasis"><em>item</em></span>
</p>
<pre class="programlisting">
<item _name=name [_label=label] />
</pre>
<p>
</p>
<p>
This element is used to defined item of a list property.
</p>
<p>
</p>
<p>
name is the name of the item, the property variable will be
set with this value if the item is selected.
</p>
<p>
</p>
<p>
label is an optional translatable name for this item.
This label will be used translated in the graphical
interface, typically a list box. If it does not exist
the value of the name attribute is used.
</p>
<p>
</p>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.21</div>
</body>
</html>
|