~ubuntu-branches/ubuntu/feisty/libgnome/feisty
» Revision
18
: doc/reference/html/libgnome-gnome-config.html
« back to all changes in this revision
Viewing changes to doc/reference/html/libgnome-gnome-config.html
- browse files at revision 18
- compare with another revision
- compare with revision 18
- download diff
- download tarball
- view history from revision 18
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2006-11-15 15:52:31 UTC
- mfrom: (1.1.10 upstream)
- Revision ID: james.westby@ubuntu.com-20061115155231-gbp2xt8ns20vf1vh
Tags: 2.17.0-0ubuntu1
* New upstream version:
- Enable a11y by default in devel releases
- Don't check for null before calling g_free/g_strdup
- Improve strings in error messages and other places
- GThread initialization fix
* debian/patches/08_dont_force_a11y_activation.patch:
- don't force a11y activation
* debian/patches/09_run_app_message_fix.patch:
- fixed with the new version
- Enable a11y by default in devel releases
- Don't check for null before calling g_free/g_strdup
- Improve strings in error messages and other places
- GThread initialization fix
* debian/patches/08_dont_force_a11y_activation.patch:
- don't force a11y activation
* debian/patches/09_run_app_message_fix.patch:
- fixed with the new version
- files added:
- debian/patches/08_dont_force_a11y_activation.patch
- files removed:
- debian/patches/09_run_app_message_fix.patch
- files modified:
- ChangeLog
added
removed
doc/reference/html/libgnome-gnome-config.html
5
5
<title>gnome-config</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
7
7
<link rel="start" href="index.html" title="GNOME Library Reference Manual">
8
<link rel="up" href="ch01s02.html" title="Configuration">
9
<link rel="prev" href="libgnome-gnome-gconf.html" title="gnome-gconf">
8
<link rel="up" href="ch06.html" title="Deprecated Modules">
9
<link rel="prev" href="ch06.html" title="Deprecated Modules">
10
10
<link rel="next" href="libgnome-gnome-i18n.html" title="gnome-i18n">
11
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="libgnome.html" title="GNOME Library (libgnome)">
13
<link rel="part" href="libgnome.html" title="Part I. GNOME Library (libgnome)">
14
<link rel="chapter" href="ch01.html" title="Initializing Applications and Starting Programs">
15
<link rel="chapter" href="ch02.html" title="Configuration">
16
<link rel="chapter" href="ch03.html" title="Displaying Help and External Info">
17
<link rel="chapter" href="ch04.html" title="Miscellaneous">
18
<link rel="chapter" href="ch05.html" title="Lower Level Interactions">
19
<link rel="chapter" href="ch06.html" title="Deprecated Modules">
20
<link rel="index" href="ix01.html" title="Index">
21
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
22
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
23
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
24
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
25
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
26
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
27
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
28
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
29
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
14
30
</head>
15
31
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
16
32
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
33
<tr valign="middle">
18
<td><a accesskey="p" href="libgnome-gnome-gconf.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
19
<td><a accesskey="u" href="ch01s02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
34
<td><a accesskey="p" href="ch06.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
35
<td><a accesskey="u" href="ch06.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
20
36
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
21
37
<th width="100%" align="center">GNOME Library Reference Manual</th>
22
38
<td><a accesskey="n" href="libgnome-gnome-i18n.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
39
</tr>
24
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2799145" class="shortcut">Top</a>
40
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2999091" class="shortcut">Top</a>
25
41
 | 
26
<a href="#id2800580" class="shortcut">Description</a></nobr></td></tr>
42
<a href="#id2999800" class="shortcut">Description</a></nobr></td></tr>
27
43
</table>
28
44
<div class="refentry" lang="en">
29
45
<a name="libgnome-gnome-config"></a><div class="titlepage"></div>
30
46
<div class="refnamediv"><table width="100%"><tr>
31
47
<td valign="top">
32
48
<h2>
33
<a name="id2799145"></a><span class="refentrytitle">gnome-config</span>
49
<a name="id2999091"></a><span class="refentrytitle">gnome-config</span>
34
50
</h2>
35
51
<p>gnome-config — Access to configuration files.</p>
36
52
</td>
98
114
99
115
void <a href="libgnome-gnome-config.html#gnome-config-drop-all">gnome_config_drop_all</a> (void);
100
116
<a
101
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
117
href="../glib/glib-Basic-Types.html#gboolean"
102
118
>gboolean</a> <a href="libgnome-gnome-config.html#gnome-config-sync">gnome_config_sync</a> (void);
103
119
#define <a href="libgnome-gnome-config.html#gnome-config-sync-file">gnome_config_sync_file</a> (path)
104
120
#define <a href="libgnome-gnome-config.html#gnome-config-private-sync-file">gnome_config_private_sync_file</a> (path)
121
137
</pre>
122
138
</div>
123
139
<div class="refsect1" lang="en">
124
<a name="id2800580"></a><h2>Description</h2>
140
<a name="id2999800"></a><h2>Description</h2>
125
141
<p>
126
142
This module provides a simple method of retrieving and storing configuration
127
143
data that resides in files. It also provides the ability to supply default
252
268
</p>
253
269
</div>
254
270
<div class="refsect1" lang="en">
255
<a name="id2800953"></a><h2>Details</h2>
271
<a name="id3000174"></a><h2>Details</h2>
256
272
<div class="refsect2" lang="en">
257
<a name="id2800963"></a><h3>
273
<a name="id3000184"></a><h3>
258
274
<a name="gnome-config-get-string"></a>gnome_config_get_string()</h3>
259
<a class="indexterm" name="id2800978"></a><pre class="programlisting">#define gnome_config_get_string(path)</pre>
275
<a class="indexterm" name="id3000200"></a><pre class="programlisting">#define gnome_config_get_string(path)</pre>
260
276
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
261
277
<h3 class="title">Warning</h3>
262
278
<p><code class="literal">gnome_config_get_string</code> is deprecated and should not be used in newly-written code.</p>
264
280
<p>
265
281
Retrieves the value of a configuration item as a string. This value should
266
282
be freed with <a
267
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
283
href="../glib/glib-Memory-Allocation.html#g-free"
268
284
><code class="function">g_free()</code></a> when no longer needed.</p>
269
285
<p>
270
286
273
289
<col align="left" valign="top">
274
290
<tbody>
275
291
<tr>
276
<td>
277
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
292
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
278
293
<td> A gnome configuration path to an item.
279
294
</td>
280
295
</tr>
281
296
<tr>
282
<td>
283
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
297
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
284
298
<td> The value of the configuration item as a string.
285
299
</td>
286
300
</tr>
289
303
</div>
290
304
<hr>
291
305
<div class="refsect2" lang="en">
292
<a name="id2801052"></a><h3>
306
<a name="id3000273"></a><h3>
293
307
<a name="gnome-config-get-string-with-default"></a>gnome_config_get_string_with_default()</h3>
294
<a class="indexterm" name="id2801068"></a><pre class="programlisting">#define gnome_config_get_string_with_default(path,def)</pre>
308
<a class="indexterm" name="id3000289"></a><pre class="programlisting">#define gnome_config_get_string_with_default(path,def)</pre>
295
309
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
296
310
<h3 class="title">Warning</h3>
297
311
<p><code class="literal">gnome_config_get_string_with_default</code> is deprecated and should not be used in newly-written code.</p>
299
313
<p>
300
314
Retrieves the value of a configuration item as a string. This value should
301
315
be freed with <a
302
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
316
href="../glib/glib-Memory-Allocation.html#g-free"
303
317
><code class="function">g_free()</code></a> when no longer needed.</p>
304
318
<p>
305
319
308
322
<col align="left" valign="top">
309
323
<tbody>
310
324
<tr>
311
<td>
312
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
325
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
313
326
<td> A gnome configuration path to an item.
314
327
</td>
315
328
</tr>
316
329
<tr>
317
<td>
318
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
330
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
319
331
<td> A pointer to a flag that will be set if the default value for the item
320
332
is returned.
321
333
</td>
322
334
</tr>
323
335
<tr>
324
<td>
325
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
336
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
326
337
<td> The value of the configuration item as a string, or <em class="parameter"><code>def</code></em> if the
327
338
configuration key does not exist.
328
339
</td>
332
343
</div>
333
344
<hr>
334
345
<div class="refsect2" lang="en">
335
<a name="id2801163"></a><h3>
346
<a name="id3000385"></a><h3>
336
347
<a name="gnome-config-get-translated-string"></a>gnome_config_get_translated_string()</h3>
337
<a class="indexterm" name="id2801180"></a><pre class="programlisting">#define gnome_config_get_translated_string(path)</pre>
348
<a class="indexterm" name="id3000401"></a><pre class="programlisting">#define gnome_config_get_translated_string(path)</pre>
338
349
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
339
350
<h3 class="title">Warning</h3>
340
351
<p><code class="literal">gnome_config_get_translated_string</code> is deprecated and should not be used in newly-written code.</p>
342
353
<p>
343
354
Retrieves the value of a configuration item as a string appropriate for the
344
355
current language. The returned value should be freed with <a
345
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
356
href="../glib/glib-Memory-Allocation.html#g-free"
346
357
><code class="function">g_free()</code></a> when no
347
358
longer needed.</p>
348
359
<p>
352
363
<col align="left" valign="top">
353
364
<tbody>
354
365
<tr>
355
<td>
356
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
366
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
357
367
<td> A gnome configuration path to an item.
358
368
</td>
359
369
</tr>
360
370
<tr>
361
<td>
362
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
371
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
363
372
<td> The value of the configuration item.
364
373
</td>
365
374
</tr>
368
377
</div>
369
378
<hr>
370
379
<div class="refsect2" lang="en">
371
<a name="id2801254"></a><h3>
380
<a name="id3000475"></a><h3>
372
381
<a name="gnome-config-get-translated-string-with-default"></a>gnome_config_get_translated_string_with_default()</h3>
373
<a class="indexterm" name="id2801271"></a><pre class="programlisting">#define gnome_config_get_translated_string_with_default(path,def)</pre>
382
<a class="indexterm" name="id3000492"></a><pre class="programlisting">#define gnome_config_get_translated_string_with_default(path,def)</pre>
374
383
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
375
384
<h3 class="title">Warning</h3>
376
385
<p><code class="literal">gnome_config_get_translated_string_with_default</code> is deprecated and should not be used in newly-written code.</p>
378
387
<p>
379
388
Retrieves the value of a configuration item as a string appropriate for the
380
389
current language. The returned value should be freed with <a
381
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
390
href="../glib/glib-Memory-Allocation.html#g-free"
382
391
><code class="function">g_free()</code></a> when no
383
392
longer needed.</p>
384
393
<p>
388
397
<col align="left" valign="top">
389
398
<tbody>
390
399
<tr>
391
<td>
392
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
400
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
393
401
<td> A gnome configuration path to an item.
394
402
</td>
395
403
</tr>
396
404
<tr>
397
<td>
398
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
405
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
399
406
<td> A pointer to a flag that will be set if the default value for the item
400
407
is returned.
401
408
</td>
402
409
</tr>
403
410
<tr>
404
<td>
405
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
411
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
406
412
<td> The value of the configuration item or <em class="parameter"><code>def</code></em> if the configuration
407
413
item does not exist.
408
414
</td>
412
418
</div>
413
419
<hr>
414
420
<div class="refsect2" lang="en">
415
<a name="id2801367"></a><h3>
421
<a name="id3000588"></a><h3>
416
422
<a name="gnome-config-private-get-string"></a>gnome_config_private_get_string()</h3>
417
<a class="indexterm" name="id2801383"></a><pre class="programlisting">#define gnome_config_private_get_string(path)</pre>
423
<a class="indexterm" name="id3000604"></a><pre class="programlisting">#define gnome_config_private_get_string(path)</pre>
418
424
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
419
425
<h3 class="title">Warning</h3>
420
426
<p><code class="literal">gnome_config_private_get_string</code> is deprecated and should not be used in newly-written code.</p>
423
429
Retrieves the value of a configuration item from the user's private
424
430
configuration directory as a string. This value should be freed with
425
431
<a
426
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
432
href="../glib/glib-Memory-Allocation.html#g-free"
427
433
><code class="function">g_free()</code></a> when no longer needed.</p>
428
434
<p>
429
435
432
438
<col align="left" valign="top">
433
439
<tbody>
434
440
<tr>
435
<td>
436
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
441
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
437
442
<td> A gnome configuration path to an item in the user-private namespace.
438
443
</td>
439
444
</tr>
440
445
<tr>
441
<td>
442
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
446
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
443
447
<td> The value of the configuration item as a string.
444
448
</td>
445
449
</tr>
448
452
</div>
449
453
<hr>
450
454
<div class="refsect2" lang="en">
451
<a name="id2801458"></a><h3>
455
<a name="id3000679"></a><h3>
452
456
<a name="gnome-config-private-get-string-with-default"></a>gnome_config_private_get_string_with_default()</h3>
453
<a class="indexterm" name="id2801474"></a><pre class="programlisting">#define gnome_config_private_get_string_with_default(path,def)</pre>
457
<a class="indexterm" name="id3000695"></a><pre class="programlisting">#define gnome_config_private_get_string_with_default(path,def)</pre>
454
458
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
455
459
<h3 class="title">Warning</h3>
456
460
<p><code class="literal">gnome_config_private_get_string_with_default</code> is deprecated and should not be used in newly-written code.</p>
459
463
Retrieves the value of a configuration item from the user's private
460
464
configuration directory as a string. This value should be freed with
461
465
<a
462
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
466
href="../glib/glib-Memory-Allocation.html#g-free"
463
467
><code class="function">g_free()</code></a> when no longer needed.</p>
464
468
<p>
465
469
468
472
<col align="left" valign="top">
469
473
<tbody>
470
474
<tr>
471
<td>
472
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
475
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
473
476
<td> A gnome configuration path to an item in the user-private namespace.
474
477
</td>
475
478
</tr>
476
479
<tr>
477
<td>
478
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
480
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
479
481
<td> A pointer to a flag that will be set if the default value for the item
480
482
is returned.
481
483
</td>
482
484
</tr>
483
485
<tr>
484
<td>
485
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
486
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
486
487
<td> The value of the configuration item as a string, or <em class="parameter"><code>def</code></em> if the
487
488
configuration key does not exist.
488
489
</td>
492
493
</div>
493
494
<hr>
494
495
<div class="refsect2" lang="en">
495
<a name="id2801571"></a><h3>
496
<a name="id3000792"></a><h3>
496
497
<a name="gnome-config-private-get-translated-string"></a>gnome_config_private_get_translated_string()</h3>
497
<a class="indexterm" name="id2801588"></a><pre class="programlisting">#define gnome_config_private_get_translated_string(path)</pre>
498
<a class="indexterm" name="id3000809"></a><pre class="programlisting">#define gnome_config_private_get_translated_string(path)</pre>
498
499
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
499
500
<h3 class="title">Warning</h3>
500
501
<p><code class="literal">gnome_config_private_get_translated_string</code> is deprecated and should not be used in newly-written code.</p>
502
503
<p>
503
504
Retrieves the value of a configuration item as a string appropriate for the
504
505
current language. The returned value should be freed with <a
505
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
506
href="../glib/glib-Memory-Allocation.html#g-free"
506
507
><code class="function">g_free()</code></a> when no
507
508
longer needed. The item is retrieved from the user's private configuration
508
509
storage area.</p>
513
514
<col align="left" valign="top">
514
515
<tbody>
515
516
<tr>
516
<td>
517
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
517
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
518
518
<td> A gnome configuration path to an item in the user-private namespace.
519
519
</td>
520
520
</tr>
521
521
<tr>
522
<td>
523
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
522
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
524
523
<td> The value of the configuration item.
525
524
</td>
526
525
</tr>
529
528
</div>
530
529
<hr>
531
530
<div class="refsect2" lang="en">
532
<a name="id2801664"></a><h3>
531
<a name="id3000885"></a><h3>
533
532
<a name="gnome-config-private-get-translated-string-with-default"></a>gnome_config_private_get_translated_string_with_default()</h3>
534
<a class="indexterm" name="id2801680"></a><pre class="programlisting">#define gnome_config_private_get_translated_string_with_default(path,def)</pre>
533
<a class="indexterm" name="id3000902"></a><pre class="programlisting">#define gnome_config_private_get_translated_string_with_default(path,def)</pre>
535
534
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
536
535
<h3 class="title">Warning</h3>
537
536
<p><code class="literal">gnome_config_private_get_translated_string_with_default</code> is deprecated and should not be used in newly-written code.</p>
539
538
<p>
540
539
Retrieves the value of a configuration item as a string appropriate for the
541
540
current language. The returned value should be freed with <a
542
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
541
href="../glib/glib-Memory-Allocation.html#g-free"
543
542
><code class="function">g_free()</code></a> when no
544
543
longer needed. The item is retrieved from the user's private configuration
545
544
storage area.</p>
550
549
<col align="left" valign="top">
551
550
<tbody>
552
551
<tr>
553
<td>
554
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
552
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
555
553
<td> A gnome configuration path to an item in the user-private namespace.
556
554
</td>
557
555
</tr>
558
556
<tr>
559
<td>
560
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
557
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
561
558
<td> A pointer to a flag that will be set if the default value for the item
562
559
is returned.
563
560
</td>
564
561
</tr>
565
562
<tr>
566
<td>
567
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
563
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
568
564
<td> The value of the configuration item or <em class="parameter"><code>def</code></em> if the configuration
569
565
item does not exist.
570
566
</td>
574
570
</div>
575
571
<hr>
576
572
<div class="refsect2" lang="en">
577
<a name="id2801779"></a><h3>
573
<a name="id3001001"></a><h3>
578
574
<a name="gnome-config-set-string"></a>gnome_config_set_string()</h3>
579
<a class="indexterm" name="id2801794"></a><pre class="programlisting">#define gnome_config_set_string(path,new_value)</pre>
575
<a class="indexterm" name="id3001016"></a><pre class="programlisting">#define gnome_config_set_string(path,new_value)</pre>
580
576
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
581
577
<h3 class="title">Warning</h3>
582
578
<p><code class="literal">gnome_config_set_string</code> is deprecated and should not be used in newly-written code.</p>
591
587
<col align="left" valign="top">
592
588
<tbody>
593
589
<tr>
594
<td>
595
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
590
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
596
591
<td> A gnome configuration path to a key.
597
592
</td>
598
593
</tr>
599
594
<tr>
600
<td>
601
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
595
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
602
596
<td> A string value to set.
603
597
</td>
604
598
</tr>
607
601
</div>
608
602
<hr>
609
603
<div class="refsect2" lang="en">
610
<a name="id2801871"></a><h3>
604
<a name="id3001093"></a><h3>
611
605
<a name="gnome-config-set-translated-string"></a>gnome_config_set_translated_string()</h3>
612
<a class="indexterm" name="id2801887"></a><pre class="programlisting">#define gnome_config_set_translated_string(path,value)</pre>
606
<a class="indexterm" name="id3001109"></a><pre class="programlisting">#define gnome_config_set_translated_string(path,value)</pre>
613
607
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
614
608
<h3 class="title">Warning</h3>
615
609
<p><code class="literal">gnome_config_set_translated_string</code> is deprecated and should not be used in newly-written code.</p>
625
619
<col align="left" valign="top">
626
620
<tbody>
627
621
<tr>
628
<td>
629
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
622
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
630
623
<td> A gnome configuration path to a key.
631
624
</td>
632
625
</tr>
633
626
<tr>
634
<td>
635
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
627
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
636
628
<td> A string value to set.
637
629
</td>
638
630
</tr>
641
633
</div>
642
634
<hr>
643
635
<div class="refsect2" lang="en">
644
<a name="id2801965"></a><h3>
636
<a name="id3001187"></a><h3>
645
637
<a name="gnome-config-private-set-string"></a>gnome_config_private_set_string()</h3>
646
<a class="indexterm" name="id2801981"></a><pre class="programlisting">#define gnome_config_private_set_string(path,new_value)</pre>
638
<a class="indexterm" name="id3001203"></a><pre class="programlisting">#define gnome_config_private_set_string(path,new_value)</pre>
647
639
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
648
640
<h3 class="title">Warning</h3>
649
641
<p><code class="literal">gnome_config_private_set_string</code> is deprecated and should not be used in newly-written code.</p>
659
651
<col align="left" valign="top">
660
652
<tbody>
661
653
<tr>
662
<td>
663
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
654
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
664
655
<td> A gnome configuration path to a key.
665
656
</td>
666
657
</tr>
667
658
<tr>
668
<td>
669
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
659
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
670
660
<td> A string value to set.
671
661
</td>
672
662
</tr>
675
665
</div>
676
666
<hr>
677
667
<div class="refsect2" lang="en">
678
<a name="id2802060"></a><h3>
668
<a name="id3001281"></a><h3>
679
669
<a name="gnome-config-private-set-translated-string"></a>gnome_config_private_set_translated_string()</h3>
680
<a class="indexterm" name="id2802076"></a><pre class="programlisting">#define gnome_config_private_set_translated_string(path,new_value)</pre>
670
<a class="indexterm" name="id3001298"></a><pre class="programlisting">#define gnome_config_private_set_translated_string(path,new_value)</pre>
681
671
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
682
672
<h3 class="title">Warning</h3>
683
673
<p><code class="literal">gnome_config_private_set_translated_string</code> is deprecated and should not be used in newly-written code.</p>
693
683
<col align="left" valign="top">
694
684
<tbody>
695
685
<tr>
696
<td>
697
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
686
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
698
687
<td> A gnome configuration path to a key.
699
688
</td>
700
689
</tr>
701
690
<tr>
702
<td>
703
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
691
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
704
692
<td> A string value to set.
705
693
</td>
706
694
</tr>
709
697
</div>
710
698
<hr>
711
699
<div class="refsect2" lang="en">
712
<a name="id2802156"></a><h3>
700
<a name="id3001378"></a><h3>
713
701
<a name="gnome-config-get-int"></a>gnome_config_get_int()</h3>
714
<a class="indexterm" name="id2802171"></a><pre class="programlisting">#define gnome_config_get_int(path)</pre>
702
<a class="indexterm" name="id3001393"></a><pre class="programlisting">#define gnome_config_get_int(path)</pre>
715
703
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
716
704
<h3 class="title">Warning</h3>
717
705
<p><code class="literal">gnome_config_get_int</code> is deprecated and should not be used in newly-written code.</p>
725
713
<col align="left" valign="top">
726
714
<tbody>
727
715
<tr>
728
<td>
729
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
716
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
730
717
<td> A gnome configuration path to an item.
731
718
</td>
732
719
</tr>
733
720
<tr>
734
<td>
735
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
721
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
736
722
<td> The value of a configuration item.
737
723
</td>
738
724
</tr>
741
727
</div>
742
728
<hr>
743
729
<div class="refsect2" lang="en">
744
<a name="id2802233"></a><h3>
730
<a name="id3001455"></a><h3>
745
731
<a name="gnome-config-get-int-with-default"></a>gnome_config_get_int_with_default()</h3>
746
<a class="indexterm" name="id2802249"></a><pre class="programlisting">#define gnome_config_get_int_with_default(path,def)</pre>
732
<a class="indexterm" name="id3001471"></a><pre class="programlisting">#define gnome_config_get_int_with_default(path,def)</pre>
747
733
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
748
734
<h3 class="title">Warning</h3>
749
735
<p><code class="literal">gnome_config_get_int_with_default</code> is deprecated and should not be used in newly-written code.</p>
757
743
<col align="left" valign="top">
758
744
<tbody>
759
745
<tr>
760
<td>
761
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
746
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
762
747
<td> A gnome configuration path to an item.
763
748
</td>
764
749
</tr>
765
750
<tr>
766
<td>
767
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
751
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
768
752
<td> A pointer to a flag that will be set if the default value for the item
769
753
is returned.
770
754
</td>
771
755
</tr>
772
756
<tr>
773
<td>
774
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
757
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
775
758
<td> The value of a configuration item as an integer or <em class="parameter"><code>def</code></em> if the
776
759
configuration item does not exist.
777
760
</td>
781
764
</div>
782
765
<hr>
783
766
<div class="refsect2" lang="en">
784
<a name="id2802332"></a><h3>
767
<a name="id3001555"></a><h3>
785
768
<a name="gnome-config-private-get-int"></a>gnome_config_private_get_int()</h3>
786
<a class="indexterm" name="id2802348"></a><pre class="programlisting">#define gnome_config_private_get_int(path)</pre>
769
<a class="indexterm" name="id3001570"></a><pre class="programlisting">#define gnome_config_private_get_int(path)</pre>
787
770
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
788
771
<h3 class="title">Warning</h3>
789
772
<p><code class="literal">gnome_config_private_get_int</code> is deprecated and should not be used in newly-written code.</p>
798
781
<col align="left" valign="top">
799
782
<tbody>
800
783
<tr>
801
<td>
802
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
784
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
803
785
<td> A gnome configuration path to an item in the user-private namespace.
804
786
</td>
805
787
</tr>
806
788
<tr>
807
<td>
808
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
789
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
809
790
<td> The value of a configuration item as an integer.
810
791
</td>
811
792
</tr>
814
795
</div>
815
796
<hr>
816
797
<div class="refsect2" lang="en">
817
<a name="id2802412"></a><h3>
798
<a name="id3001634"></a><h3>
818
799
<a name="gnome-config-private-get-int-with-default"></a>gnome_config_private_get_int_with_default()</h3>
819
<a class="indexterm" name="id2802428"></a><pre class="programlisting">#define gnome_config_private_get_int_with_default(path,def)</pre>
800
<a class="indexterm" name="id3001650"></a><pre class="programlisting">#define gnome_config_private_get_int_with_default(path,def)</pre>
820
801
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
821
802
<h3 class="title">Warning</h3>
822
803
<p><code class="literal">gnome_config_private_get_int_with_default</code> is deprecated and should not be used in newly-written code.</p>
831
812
<col align="left" valign="top">
832
813
<tbody>
833
814
<tr>
834
<td>
835
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
815
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
836
816
<td> A gnome configuration path to an item in the user-private namespace.
837
817
</td>
838
818
</tr>
839
819
<tr>
840
<td>
841
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
820
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
842
821
<td> A pointer to a flag that will be set if the default value for the item
843
822
is returned.
844
823
</td>
845
824
</tr>
846
825
<tr>
847
<td>
848
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
826
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
849
827
<td> The value of a configuration item as an integer or <em class="parameter"><code>def</code></em> if the
850
828
configuration item does not exist.
851
829
</td>
855
833
</div>
856
834
<hr>
857
835
<div class="refsect2" lang="en">
858
<a name="id2802513"></a><h3>
836
<a name="id3001736"></a><h3>
859
837
<a name="gnome-config-set-int"></a>gnome_config_set_int()</h3>
860
<a class="indexterm" name="id2802528"></a><pre class="programlisting">#define gnome_config_set_int(path,new_value)</pre>
838
<a class="indexterm" name="id3001751"></a><pre class="programlisting">#define gnome_config_set_int(path,new_value)</pre>
861
839
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
862
840
<h3 class="title">Warning</h3>
863
841
<p><code class="literal">gnome_config_set_int</code> is deprecated and should not be used in newly-written code.</p>
872
850
<col align="left" valign="top">
873
851
<tbody>
874
852
<tr>
875
<td>
876
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
853
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
877
854
<td> A gnome configuration path to a key.
878
855
</td>
879
856
</tr>
880
857
<tr>
881
<td>
882
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
858
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
883
859
<td> A int value to set.
884
860
</td>
885
861
</tr>
888
864
</div>
889
865
<hr>
890
866
<div class="refsect2" lang="en">
891
<a name="id2802605"></a><h3>
867
<a name="id3001828"></a><h3>
892
868
<a name="gnome-config-private-set-int"></a>gnome_config_private_set_int()</h3>
893
<a class="indexterm" name="id2802621"></a><pre class="programlisting">#define gnome_config_private_set_int(path,new_value)</pre>
869
<a class="indexterm" name="id3001844"></a><pre class="programlisting">#define gnome_config_private_set_int(path,new_value)</pre>
894
870
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
895
871
<h3 class="title">Warning</h3>
896
872
<p><code class="literal">gnome_config_private_set_int</code> is deprecated and should not be used in newly-written code.</p>
906
882
<col align="left" valign="top">
907
883
<tbody>
908
884
<tr>
909
<td>
910
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
885
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
911
886
<td> A gnome configuration path to a key.
912
887
</td>
913
888
</tr>
914
889
<tr>
915
<td>
916
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
890
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
917
891
<td> A int value to set.
918
892
</td>
919
893
</tr>
922
896
</div>
923
897
<hr>
924
898
<div class="refsect2" lang="en">
925
<a name="id2802700"></a><h3>
899
<a name="id3001923"></a><h3>
926
900
<a name="gnome-config-get-float"></a>gnome_config_get_float()</h3>
927
<a class="indexterm" name="id2802715"></a><pre class="programlisting">#define gnome_config_get_float(path)</pre>
901
<a class="indexterm" name="id3001938"></a><pre class="programlisting">#define gnome_config_get_float(path)</pre>
928
902
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
929
903
<h3 class="title">Warning</h3>
930
904
<p><code class="literal">gnome_config_get_float</code> is deprecated and should not be used in newly-written code.</p>
938
912
<col align="left" valign="top">
939
913
<tbody>
940
914
<tr>
941
<td>
942
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
915
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
943
916
<td> A gnome configuration path to an item.
944
917
</td>
945
918
</tr>
946
919
<tr>
947
<td>
948
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
920
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
949
921
<td> The value of a configuration item.
950
922
</td>
951
923
</tr>
954
926
</div>
955
927
<hr>
956
928
<div class="refsect2" lang="en">
957
<a name="id2802777"></a><h3>
929
<a name="id3002000"></a><h3>
958
930
<a name="gnome-config-get-float-with-default"></a>gnome_config_get_float_with_default()</h3>
959
<a class="indexterm" name="id2802794"></a><pre class="programlisting">#define gnome_config_get_float_with_default(path,def)</pre>
931
<a class="indexterm" name="id3002016"></a><pre class="programlisting">#define gnome_config_get_float_with_default(path,def)</pre>
960
932
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
961
933
<h3 class="title">Warning</h3>
962
934
<p><code class="literal">gnome_config_get_float_with_default</code> is deprecated and should not be used in newly-written code.</p>
970
942
<col align="left" valign="top">
971
943
<tbody>
972
944
<tr>
973
<td>
974
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
945
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
975
946
<td> A gnome configuration path to an item.
976
947
</td>
977
948
</tr>
978
949
<tr>
979
<td>
980
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
950
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
981
951
<td> A pointer to a flag that will be set if the default value for the item
982
952
is returned.
983
953
</td>
984
954
</tr>
985
955
<tr>
986
<td>
987
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
956
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
988
957
<td> The value of a configuration item as a floating-point
989
958
number or <em class="parameter"><code>def</code></em> if the configuration item does not exist.
990
959
</td>
994
963
</div>
995
964
<hr>
996
965
<div class="refsect2" lang="en">
997
<a name="id2802877"></a><h3>
966
<a name="id3002100"></a><h3>
998
967
<a name="gnome-config-private-get-float"></a>gnome_config_private_get_float()</h3>
999
<a class="indexterm" name="id2802893"></a><pre class="programlisting">#define gnome_config_private_get_float(path)</pre>
968
<a class="indexterm" name="id3002116"></a><pre class="programlisting">#define gnome_config_private_get_float(path)</pre>
1000
969
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1001
970
<h3 class="title">Warning</h3>
1002
971
<p><code class="literal">gnome_config_private_get_float</code> is deprecated and should not be used in newly-written code.</p>
1011
980
<col align="left" valign="top">
1012
981
<tbody>
1013
982
<tr>
1014
<td>
1015
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
983
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1016
984
<td> A gnome configuration path to an item in the user-private namespace.
1017
985
</td>
1018
986
</tr>
1019
987
<tr>
1020
<td>
1021
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
988
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1022
989
<td> The value of a configuration item as a floating-point
1023
990
number.
1024
991
</td>
1028
995
</div>
1029
996
<hr>
1030
997
<div class="refsect2" lang="en">
1031
<a name="id2802956"></a><h3>
998
<a name="id3002180"></a><h3>
1032
999
<a name="gnome-config-private-get-float-with-default"></a>gnome_config_private_get_float_with_default()</h3>
1033
<a class="indexterm" name="id2802974"></a><pre class="programlisting">#define gnome_config_private_get_float_with_default(path,def)</pre>
1000
<a class="indexterm" name="id3002197"></a><pre class="programlisting">#define gnome_config_private_get_float_with_default(path,def)</pre>
1034
1001
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1035
1002
<h3 class="title">Warning</h3>
1036
1003
<p><code class="literal">gnome_config_private_get_float_with_default</code> is deprecated and should not be used in newly-written code.</p>
1045
1012
<col align="left" valign="top">
1046
1013
<tbody>
1047
1014
<tr>
1048
<td>
1049
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1015
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1050
1016
<td> A gnome configuration path to an item in the user-private namespace.
1051
1017
</td>
1052
1018
</tr>
1053
1019
<tr>
1054
<td>
1055
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1020
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1056
1021
<td> A pointer to a flag that will be set if the default value for the item
1057
1022
is returned.
1058
1023
</td>
1059
1024
</tr>
1060
1025
<tr>
1061
<td>
1062
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1026
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1063
1027
<td> The value of a configuration item as a floating-point
1064
1028
number or <em class="parameter"><code>def</code></em> if the configuration item does not exist.
1065
1029
</td>
1069
1033
</div>
1070
1034
<hr>
1071
1035
<div class="refsect2" lang="en">
1072
<a name="id2803058"></a><h3>
1036
<a name="id3002282"></a><h3>
1073
1037
<a name="gnome-config-set-float"></a>gnome_config_set_float()</h3>
1074
<a class="indexterm" name="id2803074"></a><pre class="programlisting">#define gnome_config_set_float(path,new_value)</pre>
1038
<a class="indexterm" name="id3002297"></a><pre class="programlisting">#define gnome_config_set_float(path,new_value)</pre>
1075
1039
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1076
1040
<h3 class="title">Warning</h3>
1077
1041
<p><code class="literal">gnome_config_set_float</code> is deprecated and should not be used in newly-written code.</p>
1086
1050
<col align="left" valign="top">
1087
1051
<tbody>
1088
1052
<tr>
1089
<td>
1090
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1053
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1091
1054
<td> A gnome configuration path to a key.
1092
1055
</td>
1093
1056
</tr>
1094
1057
<tr>
1095
<td>
1096
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1058
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1097
1059
<td> A double value to set.
1098
1060
</td>
1099
1061
</tr>
1102
1064
</div>
1103
1065
<hr>
1104
1066
<div class="refsect2" lang="en">
1105
<a name="id2803151"></a><h3>
1067
<a name="id3002374"></a><h3>
1106
1068
<a name="gnome-config-private-set-float"></a>gnome_config_private_set_float()</h3>
1107
<a class="indexterm" name="id2803167"></a><pre class="programlisting">#define gnome_config_private_set_float(path,new_value)</pre>
1069
<a class="indexterm" name="id3002390"></a><pre class="programlisting">#define gnome_config_private_set_float(path,new_value)</pre>
1108
1070
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1109
1071
<h3 class="title">Warning</h3>
1110
1072
<p><code class="literal">gnome_config_private_set_float</code> is deprecated and should not be used in newly-written code.</p>
1120
1082
<col align="left" valign="top">
1121
1083
<tbody>
1122
1084
<tr>
1123
<td>
1124
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1085
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1125
1086
<td> A gnome configuration path to a key.
1126
1087
</td>
1127
1088
</tr>
1128
1089
<tr>
1129
<td>
1130
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1090
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1131
1091
<td> A double value to set.
1132
1092
</td>
1133
1093
</tr>
1136
1096
</div>
1137
1097
<hr>
1138
1098
<div class="refsect2" lang="en">
1139
<a name="id2803246"></a><h3>
1099
<a name="id3002469"></a><h3>
1140
1100
<a name="gnome-config-get-bool"></a>gnome_config_get_bool()</h3>
1141
<a class="indexterm" name="id2803261"></a><pre class="programlisting">#define gnome_config_get_bool(path)</pre>
1101
<a class="indexterm" name="id3002484"></a><pre class="programlisting">#define gnome_config_get_bool(path)</pre>
1142
1102
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1143
1103
<h3 class="title">Warning</h3>
1144
1104
<p><code class="literal">gnome_config_get_bool</code> is deprecated and should not be used in newly-written code.</p>
1152
1112
<col align="left" valign="top">
1153
1113
<tbody>
1154
1114
<tr>
1155
<td>
1156
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1115
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1157
1116
<td> A gnome configuration path to an item.
1158
1117
</td>
1159
1118
</tr>
1160
1119
<tr>
1161
<td>
1162
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1120
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1163
1121
<td> The value of a configuration item.
1164
1122
</td>
1165
1123
</tr>
1168
1126
</div>
1169
1127
<hr>
1170
1128
<div class="refsect2" lang="en">
1171
<a name="id2803323"></a><h3>
1129
<a name="id3002546"></a><h3>
1172
1130
<a name="gnome-config-get-bool-with-default"></a>gnome_config_get_bool_with_default()</h3>
1173
<a class="indexterm" name="id2803339"></a><pre class="programlisting">#define gnome_config_get_bool_with_default(path,def)</pre>
1131
<a class="indexterm" name="id3002562"></a><pre class="programlisting">#define gnome_config_get_bool_with_default(path,def)</pre>
1174
1132
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1175
1133
<h3 class="title">Warning</h3>
1176
1134
<p><code class="literal">gnome_config_get_bool_with_default</code> is deprecated and should not be used in newly-written code.</p>
1184
1142
<col align="left" valign="top">
1185
1143
<tbody>
1186
1144
<tr>
1187
<td>
1188
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1145
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1189
1146
<td> A gnome configuration path to an item.
1190
1147
</td>
1191
1148
</tr>
1192
1149
<tr>
1193
<td>
1194
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1150
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1195
1151
<td> A pointer to a flag that will be set if the default value for the item
1196
1152
is returned.
1197
1153
</td>
1198
1154
</tr>
1199
1155
<tr>
1200
<td>
1201
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1156
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1202
1157
<td> The value of a configuration item, or <em class="parameter"><code>def</code></em> if the
1203
1158
configuration item does not exist.
1204
1159
</td>
1208
1163
</div>
1209
1164
<hr>
1210
1165
<div class="refsect2" lang="en">
1211
<a name="id2803422"></a><h3>
1166
<a name="id3002645"></a><h3>
1212
1167
<a name="gnome-config-private-get-bool"></a>gnome_config_private_get_bool()</h3>
1213
<a class="indexterm" name="id2803438"></a><pre class="programlisting">#define gnome_config_private_get_bool(path)</pre>
1168
<a class="indexterm" name="id3002661"></a><pre class="programlisting">#define gnome_config_private_get_bool(path)</pre>
1214
1169
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1215
1170
<h3 class="title">Warning</h3>
1216
1171
<p><code class="literal">gnome_config_private_get_bool</code> is deprecated and should not be used in newly-written code.</p>
1224
1179
<col align="left" valign="top">
1225
1180
<tbody>
1226
1181
<tr>
1227
<td>
1228
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1182
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1229
1183
<td> A gnome configuration path to an item in the user-private namespace.
1230
1184
</td>
1231
1185
</tr>
1232
1186
<tr>
1233
<td>
1234
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1187
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1235
1188
<td> The value of a configuration item as a boolean.
1236
1189
</td>
1237
1190
</tr>
1240
1193
</div>
1241
1194
<hr>
1242
1195
<div class="refsect2" lang="en">
1243
<a name="id2803501"></a><h3>
1196
<a name="id3002725"></a><h3>
1244
1197
<a name="gnome-config-private-get-bool-with-default"></a>gnome_config_private_get_bool_with_default()</h3>
1245
<a class="indexterm" name="id2803518"></a><pre class="programlisting">#define gnome_config_private_get_bool_with_default(path,def)</pre>
1198
<a class="indexterm" name="id3002742"></a><pre class="programlisting">#define gnome_config_private_get_bool_with_default(path,def)</pre>
1246
1199
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1247
1200
<h3 class="title">Warning</h3>
1248
1201
<p><code class="literal">gnome_config_private_get_bool_with_default</code> is deprecated and should not be used in newly-written code.</p>
1256
1209
<col align="left" valign="top">
1257
1210
<tbody>
1258
1211
<tr>
1259
<td>
1260
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1212
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1261
1213
<td> A gnome configuration path to an item in the user-private namespace.
1262
1214
</td>
1263
1215
</tr>
1264
1216
<tr>
1265
<td>
1266
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1217
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1267
1218
<td> A pointer to a flag that will be set if the default value for the item
1268
1219
is returned.
1269
1220
</td>
1270
1221
</tr>
1271
1222
<tr>
1272
<td>
1273
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1223
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1274
1224
<td> The value of a configuration item as a boolean, or <em class="parameter"><code>def</code></em> if the
1275
1225
configuration item does not exist.
1276
1226
</td>
1280
1230
</div>
1281
1231
<hr>
1282
1232
<div class="refsect2" lang="en">
1283
<a name="id2803603"></a><h3>
1233
<a name="id3002826"></a><h3>
1284
1234
<a name="gnome-config-set-bool"></a>gnome_config_set_bool()</h3>
1285
<a class="indexterm" name="id2803618"></a><pre class="programlisting">#define gnome_config_set_bool(path,new_value)</pre>
1235
<a class="indexterm" name="id3002842"></a><pre class="programlisting">#define gnome_config_set_bool(path,new_value)</pre>
1286
1236
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1287
1237
<h3 class="title">Warning</h3>
1288
1238
<p><code class="literal">gnome_config_set_bool</code> is deprecated and should not be used in newly-written code.</p>
1297
1247
<col align="left" valign="top">
1298
1248
<tbody>
1299
1249
<tr>
1300
<td>
1301
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1250
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1302
1251
<td> A gnome configuration path to a key.
1303
1252
</td>
1304
1253
</tr>
1305
1254
<tr>
1306
<td>
1307
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1255
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1308
1256
<td> A boolean value to set.
1309
1257
</td>
1310
1258
</tr>
1313
1261
</div>
1314
1262
<hr>
1315
1263
<div class="refsect2" lang="en">
1316
<a name="id2803695"></a><h3>
1264
<a name="id3002919"></a><h3>
1317
1265
<a name="gnome-config-private-set-bool"></a>gnome_config_private_set_bool()</h3>
1318
<a class="indexterm" name="id2803711"></a><pre class="programlisting">#define gnome_config_private_set_bool(path,new_value)</pre>
1266
<a class="indexterm" name="id3002935"></a><pre class="programlisting">#define gnome_config_private_set_bool(path,new_value)</pre>
1319
1267
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1320
1268
<h3 class="title">Warning</h3>
1321
1269
<p><code class="literal">gnome_config_private_set_bool</code> is deprecated and should not be used in newly-written code.</p>
1330
1278
<col align="left" valign="top">
1331
1279
<tbody>
1332
1280
<tr>
1333
<td>
1334
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1281
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1335
1282
<td> A gnome configuration path to a key.
1336
1283
</td>
1337
1284
</tr>
1338
1285
<tr>
1339
<td>
1340
<span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1286
<td><span class="term"><em class="parameter"><code>new_value</code></em> :</span></td>
1341
1287
<td> A boolean value to set.
1342
1288
</td>
1343
1289
</tr>
1346
1292
</div>
1347
1293
<hr>
1348
1294
<div class="refsect2" lang="en">
1349
<a name="id2803790"></a><h3>
1295
<a name="id3003013"></a><h3>
1350
1296
<a name="gnome-config-get-vector"></a>gnome_config_get_vector()</h3>
1351
<a class="indexterm" name="id2803805"></a><pre class="programlisting">#define gnome_config_get_vector(path, argcp, argvp)</pre>
1297
<a class="indexterm" name="id3003029"></a><pre class="programlisting">#define gnome_config_get_vector(path, argcp, argvp)</pre>
1352
1298
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1353
1299
<h3 class="title">Warning</h3>
1354
1300
<p><code class="literal">gnome_config_get_vector</code> is deprecated and should not be used in newly-written code.</p>
1356
1302
<p>
1357
1303
Retrieves the value of a configuration item as a string array.
1358
1304
The returned vector should be freed with <a
1359
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
1305
href="../glib/glib-Memory-Allocation.html#g-free"
1360
1306
><code class="function">g_free()</code></a> when no longer needed.</p>
1361
1307
<p>
1362
1308
1365
1311
<col align="left" valign="top">
1366
1312
<tbody>
1367
1313
<tr>
1368
<td>
1369
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1314
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1370
1315
<td> A gnome configuration path to an item.
1371
1316
</td>
1372
1317
</tr>
1373
1318
<tr>
1374
<td>
1375
<span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1319
<td><span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1376
1320
<td> Number of elements in the vector.
1377
1321
</td>
1378
1322
</tr>
1379
1323
<tr>
1380
<td>
1381
<span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1324
<td><span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1382
1325
<td> Vector of strings.
1383
1326
</td>
1384
1327
</tr>
1387
1330
</div>
1388
1331
<hr>
1389
1332
<div class="refsect2" lang="en">
1390
<a name="id2803896"></a><h3>
1333
<a name="id3003120"></a><h3>
1391
1334
<a name="gnome-config-get-vector-with-default"></a>gnome_config_get_vector_with_default()</h3>
1392
<a class="indexterm" name="id2803912"></a><pre class="programlisting">#define gnome_config_get_vector_with_default(path, argcp, argvp, def)</pre>
1335
<a class="indexterm" name="id3003136"></a><pre class="programlisting">#define gnome_config_get_vector_with_default(path, argcp, argvp, def)</pre>
1393
1336
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1394
1337
<h3 class="title">Warning</h3>
1395
1338
<p><code class="literal">gnome_config_get_vector_with_default</code> is deprecated and should not be used in newly-written code.</p>
1397
1340
<p>
1398
1341
Retrieves the value of a configuration item as a string array.
1399
1342
The returned vector should be freed with <a
1400
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
1343
href="../glib/glib-Memory-Allocation.html#g-free"
1401
1344
><code class="function">g_free()</code></a> when no longer needed.</p>
1402
1345
<p>
1403
1346
1406
1349
<col align="left" valign="top">
1407
1350
<tbody>
1408
1351
<tr>
1409
<td>
1410
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1352
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1411
1353
<td> A gnome configuration path to an item.
1412
1354
</td>
1413
1355
</tr>
1414
1356
<tr>
1415
<td>
1416
<span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1357
<td><span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1417
1358
<td> Number of elements in the vector.
1418
1359
</td>
1419
1360
</tr>
1420
1361
<tr>
1421
<td>
1422
<span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1362
<td><span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1423
1363
<td> Vector of strings.
1424
1364
</td>
1425
1365
</tr>
1426
1366
<tr>
1427
<td>
1428
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1367
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1429
1368
<td> A pointer to a flag that will be set if the default value for the item
1430
1369
is returned.
1431
1370
</td>
1435
1374
</div>
1436
1375
<hr>
1437
1376
<div class="refsect2" lang="en">
1438
<a name="id2804019"></a><h3>
1377
<a name="id3003243"></a><h3>
1439
1378
<a name="gnome-config-private-get-vector"></a>gnome_config_private_get_vector()</h3>
1440
<a class="indexterm" name="id2804034"></a><pre class="programlisting">#define gnome_config_private_get_vector(path, argcp, argvp)</pre>
1379
<a class="indexterm" name="id3003258"></a><pre class="programlisting">#define gnome_config_private_get_vector(path, argcp, argvp)</pre>
1441
1380
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1442
1381
<h3 class="title">Warning</h3>
1443
1382
<p><code class="literal">gnome_config_private_get_vector</code> is deprecated and should not be used in newly-written code.</p>
1445
1384
<p>
1446
1385
Retrieves the value of a configuration item as a string array.
1447
1386
The returned vector should be freed with <a
1448
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
1387
href="../glib/glib-Memory-Allocation.html#g-free"
1449
1388
><code class="function">g_free()</code></a> when no longer needed. The
1450
1389
configuration value is retrieved from the user's private configuration
1451
1390
storage area.</p>
1456
1395
<col align="left" valign="top">
1457
1396
<tbody>
1458
1397
<tr>
1459
<td>
1460
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1398
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1461
1399
<td> A gnome configuration path to an item in the user-private namespace.
1462
1400
</td>
1463
1401
</tr>
1464
1402
<tr>
1465
<td>
1466
<span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1403
<td><span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1467
1404
<td> Number of elements in the vector.
1468
1405
</td>
1469
1406
</tr>
1470
1407
<tr>
1471
<td>
1472
<span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1408
<td><span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1473
1409
<td> Vector of strings.
1474
1410
</td>
1475
1411
</tr>
1478
1414
</div>
1479
1415
<hr>
1480
1416
<div class="refsect2" lang="en">
1481
<a name="id2804128"></a><h3>
1417
<a name="id3003352"></a><h3>
1482
1418
<a name="gnome-config-private-get-vector-with-default"></a>gnome_config_private_get_vector_with_default()</h3>
1483
<a class="indexterm" name="id2804144"></a><pre class="programlisting">#define gnome_config_private_get_vector_with_default(path, argcp, argvp, def)</pre>
1419
<a class="indexterm" name="id3003368"></a><pre class="programlisting">#define gnome_config_private_get_vector_with_default(path, argcp, argvp, def)</pre>
1484
1420
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1485
1421
<h3 class="title">Warning</h3>
1486
1422
<p><code class="literal">gnome_config_private_get_vector_with_default</code> is deprecated and should not be used in newly-written code.</p>
1488
1424
<p>
1489
1425
Retrieves the value of a configuration item as a string array.
1490
1426
The returned vector should be freed with <a
1491
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
1427
href="../glib/glib-Memory-Allocation.html#g-free"
1492
1428
><code class="function">g_free()</code></a> when no longer needed. The
1493
1429
configuration value is retrieved from the user's private configuration
1494
1430
storage area.</p>
1499
1435
<col align="left" valign="top">
1500
1436
<tbody>
1501
1437
<tr>
1502
<td>
1503
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1438
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1504
1439
<td> A gnome configuration path to an item in the user-private namespace.
1505
1440
</td>
1506
1441
</tr>
1507
1442
<tr>
1508
<td>
1509
<span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1443
<td><span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
1510
1444
<td> Number of elements in the vector
1511
1445
</td>
1512
1446
</tr>
1513
1447
<tr>
1514
<td>
1515
<span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1448
<td><span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
1516
1449
<td> Vector of strings
1517
1450
</td>
1518
1451
</tr>
1519
1452
<tr>
1520
<td>
1521
<span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1453
<td><span class="term"><em class="parameter"><code>def</code></em> :</span></td>
1522
1454
<td> A pointer to a flag that will be set if the default value for the item
1523
1455
is returned.
1524
1456
</td>
1528
1460
</div>
1529
1461
<hr>
1530
1462
<div class="refsect2" lang="en">
1531
<a name="id2804253"></a><h3>
1463
<a name="id3003477"></a><h3>
1532
1464
<a name="gnome-config-set-vector"></a>gnome_config_set_vector()</h3>
1533
<a class="indexterm" name="id2804268"></a><pre class="programlisting">#define gnome_config_set_vector(path,argc,argv)</pre>
1465
<a class="indexterm" name="id3003492"></a><pre class="programlisting">#define gnome_config_set_vector(path,argc,argv)</pre>
1534
1466
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1535
1467
<h3 class="title">Warning</h3>
1536
1468
<p><code class="literal">gnome_config_set_vector</code> is deprecated and should not be used in newly-written code.</p>
1545
1477
<col align="left" valign="top">
1546
1478
<tbody>
1547
1479
<tr>
1548
<td>
1549
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1480
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1550
1481
<td> A gnome configuration path to a key.
1551
1482
</td>
1552
1483
</tr>
1553
1484
<tr>
1554
<td>
1555
<span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1485
<td><span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1556
1486
<td> The number of elements in <em class="parameter"><code>argv</code></em>.
1557
1487
</td>
1558
1488
</tr>
1559
1489
<tr>
1560
<td>
1561
<span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1490
<td><span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1562
1491
<td> A string array holding the data to store.
1563
1492
</td>
1564
1493
</tr>
1567
1496
</div>
1568
1497
<hr>
1569
1498
<div class="refsect2" lang="en">
1570
<a name="id2804365"></a><h3>
1499
<a name="id3003589"></a><h3>
1571
1500
<a name="gnome-config-private-set-vector"></a>gnome_config_private_set_vector()</h3>
1572
<a class="indexterm" name="id2804380"></a><pre class="programlisting">#define gnome_config_private_set_vector(path,argc,argv)</pre>
1501
<a class="indexterm" name="id3003605"></a><pre class="programlisting">#define gnome_config_private_set_vector(path,argc,argv)</pre>
1573
1502
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1574
1503
<h3 class="title">Warning</h3>
1575
1504
<p><code class="literal">gnome_config_private_set_vector</code> is deprecated and should not be used in newly-written code.</p>
1584
1513
<col align="left" valign="top">
1585
1514
<tbody>
1586
1515
<tr>
1587
<td>
1588
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1516
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1589
1517
<td> A gnome configuration path to a key.
1590
1518
</td>
1591
1519
</tr>
1592
1520
<tr>
1593
<td>
1594
<span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1521
<td><span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1595
1522
<td> The number of elements in <em class="parameter"><code>argv</code></em>.
1596
1523
</td>
1597
1524
</tr>
1598
1525
<tr>
1599
<td>
1600
<span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1526
<td><span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1601
1527
<td> A string array holding the data to store.
1602
1528
</td>
1603
1529
</tr>
1606
1532
</div>
1607
1533
<hr>
1608
1534
<div class="refsect2" lang="en">
1609
<a name="id2804479"></a><h3>
1535
<a name="id3003703"></a><h3>
1610
1536
<a name="gnome-config-assemble-vector"></a>gnome_config_assemble_vector ()</h3>
1611
<a class="indexterm" name="id2804494"></a><pre class="programlisting">char* gnome_config_assemble_vector (int argc,
1537
<a class="indexterm" name="id3003719"></a><pre class="programlisting">char* gnome_config_assemble_vector (int argc,
1612
1538
const char *const argv[]);</pre>
1613
1539
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1614
1540
<h3 class="title">Warning</h3>
1617
1543
<p>
1618
1544
This routine returns the the strings in the array contactenated by
1619
1545
spaces. The return value should be freed with <a
1620
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
1546
href="../glib/glib-Memory-Allocation.html#g-free"
1621
1547
><code class="function">g_free()</code></a> when it is no longer
1622
1548
required.</p>
1623
1549
<p>
1627
1553
<col align="left" valign="top">
1628
1554
<tbody>
1629
1555
<tr>
1630
<td>
1631
<span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1556
<td><span class="term"><em class="parameter"><code>argc</code></em> :</span></td>
1632
1557
<td> Number of elements in the <em class="parameter"><code>argv</code></em> string array.
1633
1558
</td>
1634
1559
</tr>
1635
1560
<tr>
1636
<td>
1637
<span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1561
<td><span class="term"><em class="parameter"><code>argv</code></em> :</span></td>
1638
1562
<td> An array of strings.
1639
1563
</td>
1640
1564
</tr>
1641
1565
<tr>
1642
<td>
1643
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1566
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1644
1567
<td> A string with the concatenation results.
1645
1568
</td>
1646
1569
</tr>
1649
1572
</div>
1650
1573
<hr>
1651
1574
<div class="refsect2" lang="en">
1652
<a name="id2804608"></a><h3>
1575
<a name="id3003833"></a><h3>
1653
1576
<a name="gnome-config-has-section"></a>gnome_config_has_section()</h3>
1654
<a class="indexterm" name="id2804623"></a><pre class="programlisting">#define gnome_config_has_section(path)</pre>
1577
<a class="indexterm" name="id3003848"></a><pre class="programlisting">#define gnome_config_has_section(path)</pre>
1655
1578
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1656
1579
<h3 class="title">Warning</h3>
1657
1580
<p><code class="literal">gnome_config_has_section</code> is deprecated and should not be used in newly-written code.</p>
1666
1589
<col align="left" valign="top">
1667
1590
<tbody>
1668
1591
<tr>
1669
<td>
1670
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1592
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1671
1593
<td> A gnome configuration path to a section
1672
1594
</td>
1673
1595
</tr>
1674
1596
<tr>
1675
<td>
1676
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1597
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1677
1598
<td> <a
1678
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1599
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
1679
1600
><code class="literal">TRUE</code></a> if the section exists, <a
1680
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1601
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
1681
1602
><code class="literal">FALSE</code></a> otherwise.
1682
1603
</td>
1683
1604
</tr>
1686
1607
</div>
1687
1608
<hr>
1688
1609
<div class="refsect2" lang="en">
1689
<a name="id2804712"></a><h3>
1610
<a name="id3003936"></a><h3>
1690
1611
<a name="gnome-config-private-has-section"></a>gnome_config_private_has_section()</h3>
1691
<a class="indexterm" name="id2804728"></a><pre class="programlisting">#define gnome_config_private_has_section(path)</pre>
1612
<a class="indexterm" name="id3003952"></a><pre class="programlisting">#define gnome_config_private_has_section(path)</pre>
1692
1613
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1693
1614
<h3 class="title">Warning</h3>
1694
1615
<p><code class="literal">gnome_config_private_has_section</code> is deprecated and should not be used in newly-written code.</p>
1703
1624
<col align="left" valign="top">
1704
1625
<tbody>
1705
1626
<tr>
1706
<td>
1707
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1627
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1708
1628
<td> A gnome configuration path to a section
1709
1629
</td>
1710
1630
</tr>
1711
1631
<tr>
1712
<td>
1713
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1632
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1714
1633
<td> <a
1715
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1634
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
1716
1635
><code class="literal">TRUE</code></a> if the section exists, <a
1717
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1636
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
1718
1637
><code class="literal">FALSE</code></a> otherwise.
1719
1638
</td>
1720
1639
</tr>
1723
1642
</div>
1724
1643
<hr>
1725
1644
<div class="refsect2" lang="en">
1726
<a name="id2804817"></a><h3>
1645
<a name="id3004041"></a><h3>
1727
1646
<a name="gnome-config-init-iterator"></a>gnome_config_init_iterator()</h3>
1728
<a class="indexterm" name="id2804832"></a><pre class="programlisting">#define gnome_config_init_iterator(path)</pre>
1647
<a class="indexterm" name="id3004057"></a><pre class="programlisting">#define gnome_config_init_iterator(path)</pre>
1729
1648
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1730
1649
<h3 class="title">Warning</h3>
1731
1650
<p><code class="literal">gnome_config_init_iterator</code> is deprecated and should not be used in newly-written code.</p>
1742
1661
<col align="left" valign="top">
1743
1662
<tbody>
1744
1663
<tr>
1745
<td>
1746
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1664
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1747
1665
<td> A gnome configuration path for a section.
1748
1666
</td>
1749
1667
</tr>
1750
1668
<tr>
1751
<td>
1752
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1669
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1753
1670
<td> The iterator handle.
1754
1671
</td>
1755
1672
</tr>
1758
1675
</div>
1759
1676
<hr>
1760
1677
<div class="refsect2" lang="en">
1761
<a name="id2804913"></a><h3>
1678
<a name="id3004137"></a><h3>
1762
1679
<a name="gnome-config-private-init-iterator"></a>gnome_config_private_init_iterator()</h3>
1763
<a class="indexterm" name="id2804929"></a><pre class="programlisting">#define gnome_config_private_init_iterator(path)</pre>
1680
<a class="indexterm" name="id3004154"></a><pre class="programlisting">#define gnome_config_private_init_iterator(path)</pre>
1764
1681
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1765
1682
<h3 class="title">Warning</h3>
1766
1683
<p><code class="literal">gnome_config_private_init_iterator</code> is deprecated and should not be used in newly-written code.</p>
1777
1694
<col align="left" valign="top">
1778
1695
<tbody>
1779
1696
<tr>
1780
<td>
1781
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1697
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1782
1698
<td> A gnome configuration path for a section.
1783
1699
</td>
1784
1700
</tr>
1785
1701
<tr>
1786
<td>
1787
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1702
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1788
1703
<td> The iterator handle.
1789
1704
</td>
1790
1705
</tr>
1793
1708
</div>
1794
1709
<hr>
1795
1710
<div class="refsect2" lang="en">
1796
<a name="id2805010"></a><h3>
1711
<a name="id3004234"></a><h3>
1797
1712
<a name="gnome-config-init-iterator-sections"></a>gnome_config_init_iterator_sections()</h3>
1798
<a class="indexterm" name="id2805026"></a><pre class="programlisting">#define gnome_config_init_iterator_sections(path)</pre>
1713
<a class="indexterm" name="id3004251"></a><pre class="programlisting">#define gnome_config_init_iterator_sections(path)</pre>
1799
1714
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1800
1715
<h3 class="title">Warning</h3>
1801
1716
<p><code class="literal">gnome_config_init_iterator_sections</code> is deprecated and should not be used in newly-written code.</p>
1812
1727
<col align="left" valign="top">
1813
1728
<tbody>
1814
1729
<tr>
1815
<td>
1816
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1730
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1817
1731
<td> A gnome configuration path for a file.
1818
1732
</td>
1819
1733
</tr>
1820
1734
<tr>
1821
<td>
1822
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1735
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1823
1736
<td> The iterator handle.
1824
1737
</td>
1825
1738
</tr>
1828
1741
</div>
1829
1742
<hr>
1830
1743
<div class="refsect2" lang="en">
1831
<a name="id2805107"></a><h3>
1744
<a name="id3004332"></a><h3>
1832
1745
<a name="gnome-config-private-init-iterator-sections"></a>gnome_config_private_init_iterator_sections()</h3>
1833
<a class="indexterm" name="id2805125"></a><pre class="programlisting">#define gnome_config_private_init_iterator_sections(path)</pre>
1746
<a class="indexterm" name="id3004349"></a><pre class="programlisting">#define gnome_config_private_init_iterator_sections(path)</pre>
1834
1747
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1835
1748
<h3 class="title">Warning</h3>
1836
1749
<p><code class="literal">gnome_config_private_init_iterator_sections</code> is deprecated and should not be used in newly-written code.</p>
1847
1760
<col align="left" valign="top">
1848
1761
<tbody>
1849
1762
<tr>
1850
<td>
1851
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1763
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1852
1764
<td> A gnome configuration path for a file
1853
1765
</td>
1854
1766
</tr>
1855
1767
<tr>
1856
<td>
1857
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1768
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1858
1769
<td> The iterator handle.
1859
1770
</td>
1860
1771
</tr>
1863
1774
</div>
1864
1775
<hr>
1865
1776
<div class="refsect2" lang="en">
1866
<a name="id2805206"></a><h3>
1777
<a name="id3004430"></a><h3>
1867
1778
<a name="gnome-config-iterator-next"></a>gnome_config_iterator_next ()</h3>
1868
<a class="indexterm" name="id2805222"></a><pre class="programlisting">void* gnome_config_iterator_next (void *iterator_handle,
1779
<a class="indexterm" name="id3004447"></a><pre class="programlisting">void* gnome_config_iterator_next (void *iterator_handle,
1869
1780
char **key,
1870
1781
char **value);</pre>
1871
1782
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1874
1785
</div>
1875
1786
<p>
1876
1787
If <em class="parameter"><code>key</code></em> is non-NULL, then <em class="parameter"><code>key</code></em> will point to a <a
1877
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-malloc"
1788
href="../glib/glib-Memory-Allocation.html#g-malloc"
1878
1789
><code class="function">g_malloc()</code></a>ed region that
1879
1790
holds the key.
1880
1791
</p>
1881
1792
<p>
1882
1793
If <em class="parameter"><code>value</code></em> is non-NULL, then <em class="parameter"><code>value</code></em> will point to a <a
1883
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-malloc"
1794
href="../glib/glib-Memory-Allocation.html#g-malloc"
1884
1795
><code class="function">g_malloc()</code></a>ed region that
1885
1796
holds the key.</p>
1886
1797
<p>
1890
1801
<col align="left" valign="top">
1891
1802
<tbody>
1892
1803
<tr>
1893
<td>
1894
<span class="term"><em class="parameter"><code>iterator_handle</code></em> :</span></td>
1804
<td><span class="term"><em class="parameter"><code>iterator_handle</code></em> :</span></td>
1895
1805
<td> A gnome configu iterator handle, returned from any
1896
1806
iteration start routine or this routine.
1897
1807
</td>
1898
1808
</tr>
1899
1809
<tr>
1900
<td>
1901
<span class="term"><em class="parameter"><code>key</code></em> :</span></td>
1810
<td><span class="term"><em class="parameter"><code>key</code></em> :</span></td>
1902
1811
<td> Address where the key gets stored.
1903
1812
</td>
1904
1813
</tr>
1905
1814
<tr>
1906
<td>
1907
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1815
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
1908
1816
<td> Address where the value gets stored.
1909
1817
</td>
1910
1818
</tr>
1911
1819
<tr>
1912
<td>
1913
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1820
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1914
1821
<td>
1915
1822
1916
1823
1921
1828
</div>
1922
1829
<hr>
1923
1830
<div class="refsect2" lang="en">
1924
<a name="id2805388"></a><h3>
1831
<a name="id3004613"></a><h3>
1925
1832
<a name="gnome-config-drop-all"></a>gnome_config_drop_all ()</h3>
1926
<a class="indexterm" name="id2805403"></a><pre class="programlisting">void gnome_config_drop_all (void);</pre>
1833
<a class="indexterm" name="id3004629"></a><pre class="programlisting">void gnome_config_drop_all (void);</pre>
1927
1834
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1928
1835
<h3 class="title">Warning</h3>
1929
1836
<p><code class="literal">gnome_config_drop_all</code> is deprecated and should not be used in newly-written code.</p>
1938
1845
</div>
1939
1846
<hr>
1940
1847
<div class="refsect2" lang="en">
1941
<a name="id2805443"></a><h3>
1848
<a name="id3004668"></a><h3>
1942
1849
<a name="gnome-config-sync"></a>gnome_config_sync ()</h3>
1943
<a class="indexterm" name="id2805459"></a><pre class="programlisting"><a
1944
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
1850
<a class="indexterm" name="id3004684"></a><pre class="programlisting"><a
1851
href="../glib/glib-Basic-Types.html#gboolean"
1945
1852
>gboolean</a> gnome_config_sync (void);</pre>
1946
1853
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1947
1854
<h3 class="title">Warning</h3>
1960
1867
<div class="variablelist"><table border="0">
1961
1868
<col align="left" valign="top">
1962
1869
<tbody><tr>
1963
<td>
1964
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1870
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1965
1871
<td> <a
1966
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1872
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
1967
1873
><code class="literal">TRUE</code></a> if everything went well. <a
1968
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1874
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
1969
1875
><code class="literal">FALSE</code></a> if any file
1970
1876
could not be written to disk.
1971
1877
</td>
1974
1880
</div>
1975
1881
<hr>
1976
1882
<div class="refsect2" lang="en">
1977
<a name="id2805538"></a><h3>
1883
<a name="id3004763"></a><h3>
1978
1884
<a name="gnome-config-sync-file"></a>gnome_config_sync_file()</h3>
1979
<a class="indexterm" name="id2805553"></a><pre class="programlisting">#define gnome_config_sync_file(path)</pre>
1885
<a class="indexterm" name="id3004779"></a><pre class="programlisting">#define gnome_config_sync_file(path)</pre>
1980
1886
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1981
1887
<h3 class="title">Warning</h3>
1982
1888
<p><code class="literal">gnome_config_sync_file</code> is deprecated and should not be used in newly-written code.</p>
1996
1902
<col align="left" valign="top">
1997
1903
<tbody>
1998
1904
<tr>
1999
<td>
2000
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1905
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2001
1906
<td> A gnome-config path
2002
1907
</td>
2003
1908
</tr>
2004
1909
<tr>
2005
<td>
2006
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1910
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2007
1911
<td> <a
2008
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1912
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
2009
1913
><code class="literal">TRUE</code></a> if everything went well, <a
2010
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1914
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
2011
1915
><code class="literal">FALSE</code></a> if the file
2012
1916
could not be written to for some reason. <a
2013
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1917
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
2014
1918
><code class="literal">FALSE</code></a> is only returned
2015
1919
when a write was actually attempted and failed.
2016
1920
</td>
2020
1924
</div>
2021
1925
<hr>
2022
1926
<div class="refsect2" lang="en">
2023
<a name="id2805664"></a><h3>
1927
<a name="id3004889"></a><h3>
2024
1928
<a name="gnome-config-private-sync-file"></a>gnome_config_private_sync_file()</h3>
2025
<a class="indexterm" name="id2805679"></a><pre class="programlisting">#define gnome_config_private_sync_file(path)</pre>
1929
<a class="indexterm" name="id3004905"></a><pre class="programlisting">#define gnome_config_private_sync_file(path)</pre>
2026
1930
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2027
1931
<h3 class="title">Warning</h3>
2028
1932
<p><code class="literal">gnome_config_private_sync_file</code> is deprecated and should not be used in newly-written code.</p>
2042
1946
<col align="left" valign="top">
2043
1947
<tbody>
2044
1948
<tr>
2045
<td>
2046
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1949
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2047
1950
<td> A gnome-config path
2048
1951
</td>
2049
1952
</tr>
2050
1953
<tr>
2051
<td>
2052
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1954
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2053
1955
<td> <a
2054
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1956
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
2055
1957
><code class="literal">TRUE</code></a> if everything went well, <a
2056
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1958
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
2057
1959
><code class="literal">FALSE</code></a> if the file
2058
1960
could not be written to for some reason. <a
2059
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1961
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
2060
1962
><code class="literal">FALSE</code></a> is only returned
2061
1963
when a write was actually attempted and failed.
2062
1964
</td>
2066
1968
</div>
2067
1969
<hr>
2068
1970
<div class="refsect2" lang="en">
2069
<a name="id2805790"></a><h3>
1971
<a name="id3005016"></a><h3>
2070
1972
<a name="gnome-config-drop-file"></a>gnome_config_drop_file()</h3>
2071
<a class="indexterm" name="id2805806"></a><pre class="programlisting">#define gnome_config_drop_file(path)</pre>
1973
<a class="indexterm" name="id3005031"></a><pre class="programlisting">#define gnome_config_drop_file(path)</pre>
2072
1974
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2073
1975
<h3 class="title">Warning</h3>
2074
1976
<p><code class="literal">gnome_config_drop_file</code> is deprecated and should not be used in newly-written code.</p>
2083
1985
<div class="variablelist"><table border="0">
2084
1986
<col align="left" valign="top">
2085
1987
<tbody><tr>
2086
<td>
2087
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
1988
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2088
1989
<td> A gnome-config path
2089
1990
</td>
2090
1991
</tr></tbody>
2092
1993
</div>
2093
1994
<hr>
2094
1995
<div class="refsect2" lang="en">
2095
<a name="id2805874"></a><h3>
1996
<a name="id3005100"></a><h3>
2096
1997
<a name="gnome-config-private-drop-file"></a>gnome_config_private_drop_file()</h3>
2097
<a class="indexterm" name="id2805890"></a><pre class="programlisting">#define gnome_config_private_drop_file(path)</pre>
1998
<a class="indexterm" name="id3005116"></a><pre class="programlisting">#define gnome_config_private_drop_file(path)</pre>
2098
1999
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2099
2000
<h3 class="title">Warning</h3>
2100
2001
<p><code class="literal">gnome_config_private_drop_file</code> is deprecated and should not be used in newly-written code.</p>
2108
2009
<div class="variablelist"><table border="0">
2109
2010
<col align="left" valign="top">
2110
2011
<tbody><tr>
2111
<td>
2112
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2012
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2113
2013
<td> A gnome-config path
2114
2014
</td>
2115
2015
</tr></tbody>
2117
2017
</div>
2118
2018
<hr>
2119
2019
<div class="refsect2" lang="en">
2120
<a name="id2805948"></a><h3>
2020
<a name="id3005174"></a><h3>
2121
2021
<a name="gnome-config-clean-file"></a>gnome_config_clean_file()</h3>
2122
<a class="indexterm" name="id2805963"></a><pre class="programlisting">#define gnome_config_clean_file(path)</pre>
2022
<a class="indexterm" name="id3005189"></a><pre class="programlisting">#define gnome_config_clean_file(path)</pre>
2123
2023
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2124
2024
<h3 class="title">Warning</h3>
2125
2025
<p><code class="literal">gnome_config_clean_file</code> is deprecated and should not be used in newly-written code.</p>
2136
2036
<div class="variablelist"><table border="0">
2137
2037
<col align="left" valign="top">
2138
2038
<tbody><tr>
2139
<td>
2140
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2039
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2141
2040
<td> A gnome-config path
2142
2041
</td>
2143
2042
</tr></tbody>
2145
2044
</div>
2146
2045
<hr>
2147
2046
<div class="refsect2" lang="en">
2148
<a name="id2806035"></a><h3>
2047
<a name="id3005261"></a><h3>
2149
2048
<a name="gnome-config-private-clean-file"></a>gnome_config_private_clean_file()</h3>
2150
<a class="indexterm" name="id2806051"></a><pre class="programlisting">#define gnome_config_private_clean_file(path)</pre>
2049
<a class="indexterm" name="id3005277"></a><pre class="programlisting">#define gnome_config_private_clean_file(path)</pre>
2151
2050
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2152
2051
<h3 class="title">Warning</h3>
2153
2052
<p><code class="literal">gnome_config_private_clean_file</code> is deprecated and should not be used in newly-written code.</p>
2164
2063
<div class="variablelist"><table border="0">
2165
2064
<col align="left" valign="top">
2166
2065
<tbody><tr>
2167
<td>
2168
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2066
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2169
2067
<td> A gnome-config path
2170
2068
</td>
2171
2069
</tr></tbody>
2173
2071
</div>
2174
2072
<hr>
2175
2073
<div class="refsect2" lang="en">
2176
<a name="id2806124"></a><h3>
2074
<a name="id3005350"></a><h3>
2177
2075
<a name="gnome-config-clean-section"></a>gnome_config_clean_section()</h3>
2178
<a class="indexterm" name="id2806140"></a><pre class="programlisting">#define gnome_config_clean_section(path)</pre>
2076
<a class="indexterm" name="id3005366"></a><pre class="programlisting">#define gnome_config_clean_section(path)</pre>
2179
2077
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2180
2078
<h3 class="title">Warning</h3>
2181
2079
<p><code class="literal">gnome_config_clean_section</code> is deprecated and should not be used in newly-written code.</p>
2190
2088
<div class="variablelist"><table border="0">
2191
2089
<col align="left" valign="top">
2192
2090
<tbody><tr>
2193
<td>
2194
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2091
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2195
2092
<td> A gnome configuration path to a section.
2196
2093
</td>
2197
2094
</tr></tbody>
2199
2096
</div>
2200
2097
<hr>
2201
2098
<div class="refsect2" lang="en">
2202
<a name="id2806209"></a><h3>
2099
<a name="id3005435"></a><h3>
2203
2100
<a name="gnome-config-private-clean-section"></a>gnome_config_private_clean_section()</h3>
2204
<a class="indexterm" name="id2806225"></a><pre class="programlisting">#define gnome_config_private_clean_section(path)</pre>
2101
<a class="indexterm" name="id3005451"></a><pre class="programlisting">#define gnome_config_private_clean_section(path)</pre>
2205
2102
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2206
2103
<h3 class="title">Warning</h3>
2207
2104
<p><code class="literal">gnome_config_private_clean_section</code> is deprecated and should not be used in newly-written code.</p>
2216
2113
<div class="variablelist"><table border="0">
2217
2114
<col align="left" valign="top">
2218
2115
<tbody><tr>
2219
<td>
2220
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2116
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2221
2117
<td> A gnome configuration path to a section.
2222
2118
</td>
2223
2119
</tr></tbody>
2225
2121
</div>
2226
2122
<hr>
2227
2123
<div class="refsect2" lang="en">
2228
<a name="id2806294"></a><h3>
2124
<a name="id3005520"></a><h3>
2229
2125
<a name="gnome-config-clean-key"></a>gnome_config_clean_key()</h3>
2230
<a class="indexterm" name="id2806309"></a><pre class="programlisting">#define gnome_config_clean_key(path)</pre>
2126
<a class="indexterm" name="id3005535"></a><pre class="programlisting">#define gnome_config_clean_key(path)</pre>
2231
2127
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2232
2128
<h3 class="title">Warning</h3>
2233
2129
<p><code class="literal">gnome_config_clean_key</code> is deprecated and should not be used in newly-written code.</p>
2243
2139
<div class="variablelist"><table border="0">
2244
2140
<col align="left" valign="top">
2245
2141
<tbody><tr>
2246
<td>
2247
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2142
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2248
2143
<td> A gnome configuration path to a key.
2249
2144
</td>
2250
2145
</tr></tbody>
2252
2147
</div>
2253
2148
<hr>
2254
2149
<div class="refsect2" lang="en">
2255
<a name="id2806375"></a><h3>
2150
<a name="id3005601"></a><h3>
2256
2151
<a name="gnome-config-private-clean-key"></a>gnome_config_private_clean_key()</h3>
2257
<a class="indexterm" name="id2806391"></a><pre class="programlisting">#define gnome_config_private_clean_key(path)</pre>
2152
<a class="indexterm" name="id3005617"></a><pre class="programlisting">#define gnome_config_private_clean_key(path)</pre>
2258
2153
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2259
2154
<h3 class="title">Warning</h3>
2260
2155
<p><code class="literal">gnome_config_private_clean_key</code> is deprecated and should not be used in newly-written code.</p>
2271
2166
<div class="variablelist"><table border="0">
2272
2167
<col align="left" valign="top">
2273
2168
<tbody><tr>
2274
<td>
2275
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2169
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2276
2170
<td> A gnome configuration path to a key.
2277
2171
</td>
2278
2172
</tr></tbody>
2280
2174
</div>
2281
2175
<hr>
2282
2176
<div class="refsect2" lang="en">
2283
<a name="id2806457"></a><h3>
2177
<a name="id3005683"></a><h3>
2284
2178
<a name="gnome-config-get-real-path"></a>gnome_config_get_real_path()</h3>
2285
<a class="indexterm" name="id2806473"></a><pre class="programlisting">#define gnome_config_get_real_path(path)</pre>
2179
<a class="indexterm" name="id3005699"></a><pre class="programlisting">#define gnome_config_get_real_path(path)</pre>
2286
2180
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2287
2181
<h3 class="title">Warning</h3>
2288
2182
<p><code class="literal">gnome_config_get_real_path</code> is deprecated and should not be used in newly-written code.</p>
2294
2188
<col align="left" valign="top">
2295
2189
<tbody>
2296
2190
<tr>
2297
<td>
2298
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2191
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2299
2192
<td>A configuration file (this should only be the file, not the section or
2300
2193
key).
2301
2194
</td>
2302
2195
</tr>
2303
2196
<tr>
2304
<td>
2305
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2197
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2306
2198
<td>An absolute path to the config file.
2307
2199
2308
2200
2313
2205
</div>
2314
2206
<hr>
2315
2207
<div class="refsect2" lang="en">
2316
<a name="id2806532"></a><h3>
2208
<a name="id3005758"></a><h3>
2317
2209
<a name="gnome-config-private-get-real-path"></a>gnome_config_private_get_real_path()</h3>
2318
<a class="indexterm" name="id2806549"></a><pre class="programlisting">#define gnome_config_private_get_real_path(path)</pre>
2210
<a class="indexterm" name="id3005775"></a><pre class="programlisting">#define gnome_config_private_get_real_path(path)</pre>
2319
2211
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2320
2212
<h3 class="title">Warning</h3>
2321
2213
<p><code class="literal">gnome_config_private_get_real_path</code> is deprecated and should not be used in newly-written code.</p>
2328
2220
<col align="left" valign="top">
2329
2221
<tbody>
2330
2222
<tr>
2331
<td>
2332
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2223
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2333
2224
<td>A configuration file (this should only be the file, not the section or
2334
2225
key).
2335
2226
</td>
2336
2227
</tr>
2337
2228
<tr>
2338
<td>
2339
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2229
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2340
2230
<td>An absolute path to the config file.
2341
2231
2342
2232
2347
2237
</div>
2348
2238
<hr>
2349
2239
<div class="refsect2" lang="en">
2350
<a name="id2806609"></a><h3>
2240
<a name="id3005835"></a><h3>
2351
2241
<a name="gnome-config-push-prefix"></a>gnome_config_push_prefix ()</h3>
2352
<a class="indexterm" name="id2806625"></a><pre class="programlisting">void gnome_config_push_prefix (const char *path);</pre>
2242
<a class="indexterm" name="id3005851"></a><pre class="programlisting">void gnome_config_push_prefix (const char *path);</pre>
2353
2243
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2354
2244
<h3 class="title">Warning</h3>
2355
2245
<p><code class="literal">gnome_config_push_prefix</code> is deprecated and should not be used in newly-written code.</p>
2371
2261
<div class="variablelist"><table border="0">
2372
2262
<col align="left" valign="top">
2373
2263
<tbody><tr>
2374
<td>
2375
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2264
<td><span class="term"><em class="parameter"><code>path</code></em> :</span></td>
2376
2265
<td> A gnome configuration path prefix.
2377
2266
</td>
2378
2267
</tr></tbody>
2380
2269
</div>
2381
2270
<hr>
2382
2271
<div class="refsect2" lang="en">
2383
<a name="id2806705"></a><h3>
2272
<a name="id3005931"></a><h3>
2384
2273
<a name="gnome-config-pop-prefix"></a>gnome_config_pop_prefix ()</h3>
2385
<a class="indexterm" name="id2806720"></a><pre class="programlisting">void gnome_config_pop_prefix (void);</pre>
2274
<a class="indexterm" name="id3005946"></a><pre class="programlisting">void gnome_config_pop_prefix (void);</pre>
2386
2275
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2387
2276
<h3 class="title">Warning</h3>
2388
2277
<p><code class="literal">gnome_config_pop_prefix</code> is deprecated and should not be used in newly-written code.</p>
2395
2284
</div>
2396
2285
<hr>
2397
2286
<div class="refsect2" lang="en">
2398
<a name="id2806759"></a><h3>
2287
<a name="id3005985"></a><h3>
2399
2288
<a name="gnome-config-make-vector"></a>gnome_config_make_vector ()</h3>
2400
<a class="indexterm" name="id2806775"></a><pre class="programlisting">void gnome_config_make_vector (const char *string,
2289
<a class="indexterm" name="id3006001"></a><pre class="programlisting">void gnome_config_make_vector (const char *string,
2401
2290
int *argcp,
2402
2291
char ***argvp);</pre>
2403
2292
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2415
2304
<col align="left" valign="top">
2416
2305
<tbody>
2417
2306
<tr>
2418
<td>
2419
<span class="term"><em class="parameter"><code>string</code></em> :</span></td>
2307
<td><span class="term"><em class="parameter"><code>string</code></em> :</span></td>
2420
2308
<td> The stringified vector to decode into 'argcp' and 'argvp'
2421
2309
</td>
2422
2310
</tr>
2423
2311
<tr>
2424
<td>
2425
<span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
2312
<td><span class="term"><em class="parameter"><code>argcp</code></em> :</span></td>
2426
2313
<td> Returns the number of elements in <em class="parameter"><code>string</code></em>.
2427
2314
</td>
2428
2315
</tr>
2429
2316
<tr>
2430
<td>
2431
<span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
2317
<td><span class="term"><em class="parameter"><code>argvp</code></em> :</span></td>
2432
2318
<td> Returns the array of strings found in <em class="parameter"><code>string</code></em>.
2433
2319
</td>
2434
2320
</tr>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1