4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gnome-help</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
7
7
<link rel="start" href="index.html" title="GNOME Library Reference Manual">
8
8
<link rel="up" href="ch03.html" title="Displaying Help and External Info">
9
9
<link rel="prev" href="ch03.html" title="Displaying Help and External Info">
37
37
<th width="100%" align="center">GNOME Library Reference Manual</th>
38
38
<td><a accesskey="n" href="libgnome-gnome-url.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
40
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2735086" class="shortcut">Top</a>
40
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2536808" class="shortcut">Top</a>
42
<a href="#id2736336" class="shortcut">Description</a></nobr></td></tr>
42
<a href="#id2537918" class="shortcut">Description</a></nobr></td></tr>
44
44
<div class="refentry" lang="en">
45
45
<a name="libgnome-gnome-help"></a><div class="titlepage"></div>
46
46
<div class="refnamediv"><table width="100%"><tr>
49
<a name="id2735086"></a><span class="refentrytitle">gnome-help</span>
49
<a name="id2536808"></a><span class="refentrytitle">gnome-help</span>
51
51
<p>gnome-help — Display application and GNOME system help.</p>
107
107
<div class="refsect1" lang="en">
108
<a name="id2736353"></a><h2>Details</h2>
108
<a name="id2537935"></a><h2>Details</h2>
109
109
<div class="refsect2" lang="en">
110
<a name="id2736364"></a><h3>
110
<a name="id2537945"></a><h3>
111
111
<a name="GnomeHelpError"></a>enum GnomeHelpError</h3>
112
<a class="indexterm" name="id2736376"></a><pre class="programlisting">typedef enum {
112
<a class="indexterm" name="id2537958"></a><pre class="programlisting">typedef enum {
113
113
GNOME_HELP_ERROR_INTERNAL,
114
114
GNOME_HELP_ERROR_NOT_FOUND
115
115
} GnomeHelpError;
121
121
<col align="left" valign="top">
124
<td><span class="term"><a name="GNOME-HELP-ERROR-INTERNAL:CAPS"></a><code class="literal">GNOME_HELP_ERROR_INTERNAL</code></span></td>
125
<span class="term"><a name="GNOME-HELP-ERROR-INTERNAL:CAPS"></a><code class="literal">GNOME_HELP_ERROR_INTERNAL</code></span></td>
125
126
<td>Something went wrong internally. This is most
126
127
likely caused by a resource problem or bad installation.
130
<td><span class="term"><a name="GNOME-HELP-ERROR-NOT-FOUND:CAPS"></a><code class="literal">GNOME_HELP_ERROR_NOT_FOUND</code></span></td>
132
<span class="term"><a name="GNOME-HELP-ERROR-NOT-FOUND:CAPS"></a><code class="literal">GNOME_HELP_ERROR_NOT_FOUND</code></span></td>
131
133
<td>Help file does not exist.
139
141
<div class="refsect2" lang="en">
140
<a name="id2736455"></a><h3>
142
<a name="id2538037"></a><h3>
141
143
<a name="GNOME-HELP-ERROR:CAPS"></a>GNOME_HELP_ERROR</h3>
142
<a class="indexterm" name="id2736469"></a><pre class="programlisting">#define GNOME_HELP_ERROR (gnome_help_error_quark ())
144
<a class="indexterm" name="id2538051"></a><pre class="programlisting">#define GNOME_HELP_ERROR (gnome_help_error_quark ())
145
147
The class (or domain) of errors raised directly by the gnome-help module. This
150
152
<div class="refsect2" lang="en">
151
<a name="id2736495"></a><h3>
153
<a name="id2538077"></a><h3>
152
154
<a name="gnome-help-display"></a>gnome_help_display ()</h3>
153
<a class="indexterm" name="id2736508"></a><pre class="programlisting">gboolean gnome_help_display (const char *file_name,
155
<a class="indexterm" name="id2538090"></a><pre class="programlisting">gboolean gnome_help_display (const char *file_name,
154
156
const char *link_id,
155
157
GError **error);</pre>
163
165
<col align="left" valign="top">
166
<td><span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
169
<span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
167
170
<td> The name of the help document to display.
171
<td><span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
173
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
174
><code class="literal">NULL</code></a>. If set, refers to an anchor or section id within the
175
<span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
176
<td> Can be <code class="literal">NULL</code>. If set, refers to an anchor or section id within the
175
177
requested document.
179
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
182
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
180
183
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
181
occurs during processing, or <a
182
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
183
><code class="literal">NULL</code></a>
184
occurs during processing, or <code class="literal">NULL</code>
187
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
189
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
188
190
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
189
191
contain the actual error).
196
198
<div class="refsect2" lang="en">
197
<a name="id2736681"></a><h3>
199
<a name="id2538263"></a><h3>
198
200
<a name="gnome-help-display-with-doc-id"></a>gnome_help_display_with_doc_id ()</h3>
199
<a class="indexterm" name="id2736694"></a><pre class="programlisting">gboolean gnome_help_display_with_doc_id (<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
201
<a class="indexterm" name="id2538276"></a><pre class="programlisting">gboolean gnome_help_display_with_doc_id (<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
200
202
const char *doc_id,
201
203
const char *file_name,
202
204
const char *link_id,
224
226
<col align="left" valign="top">
227
<td><span class="term"><em class="parameter"><code>program</code></em> :</span></td>
228
<td> The current application object, or <a
229
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
230
><code class="literal">NULL</code></a> for the default one.
230
<span class="term"><em class="parameter"><code>program</code></em> :</span></td>
231
<td> The current application object, or <code class="literal">NULL</code> for the default one.
234
<td><span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
235
<td> The document identifier, or <a
236
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
237
><code class="literal">NULL</code></a> to default to the application ID
236
<span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
237
<td> The document identifier, or <code class="literal">NULL</code> to default to the application ID
238
238
(app_id) of the specified <em class="parameter"><code>program</code></em>.
242
<td><span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
243
<span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
243
244
<td> The name of the help document to display.
247
<td><span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
249
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
250
><code class="literal">NULL</code></a>. If set, refers to an anchor or section id within the
249
<span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
250
<td> Can be <code class="literal">NULL</code>. If set, refers to an anchor or section id within the
251
251
requested document.
255
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
256
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
256
257
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
257
occurs during processing, or <a
258
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
259
><code class="literal">NULL</code></a>
258
occurs during processing, or <code class="literal">NULL</code>
263
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
263
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
264
264
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
265
265
contain the actual error).
272
272
<div class="refsect2" lang="en">
273
<a name="id2737015"></a><h3>
273
<a name="id2538597"></a><h3>
274
274
<a name="gnome-help-display-with-doc-id-and-env"></a>gnome_help_display_with_doc_id_and_env ()</h3>
275
<a class="indexterm" name="id2737032"></a><pre class="programlisting">gboolean gnome_help_display_with_doc_id_and_env
275
<a class="indexterm" name="id2538613"></a><pre class="programlisting">gboolean gnome_help_display_with_doc_id_and_env
276
276
(<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
277
277
const char *doc_id,
278
278
const char *file_name,
290
290
<col align="left" valign="top">
293
<td><span class="term"><em class="parameter"><code>program</code></em> :</span></td>
294
<td> The current application object, or <a
295
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
296
><code class="literal">NULL</code></a> for the default one.
294
<span class="term"><em class="parameter"><code>program</code></em> :</span></td>
295
<td> The current application object, or <code class="literal">NULL</code> for the default one.
300
<td><span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
301
<td> The document identifier, or <a
302
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
303
><code class="literal">NULL</code></a> to default to empty string.
300
<span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
301
<td> The document identifier, or <code class="literal">NULL</code> to default to empty string.
304
302
(app_id) of the specified <em class="parameter"><code>program</code></em>.
308
<td><span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
307
<span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
309
308
<td> The name of the help document to display.
313
<td><span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
315
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
316
><code class="literal">NULL</code></a>. If set, refers to an anchor or section id within the
313
<span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
314
<td> Can be <code class="literal">NULL</code>. If set, refers to an anchor or section id within the
317
315
requested document.
321
<td><span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
322
<td> child's environment, or <a
323
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
324
><code class="literal">NULL</code></a> to inherit parent's.
320
<span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
321
<td> child's environment, or <code class="literal">NULL</code> to inherit parent's.
328
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
326
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
329
327
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
330
occurs during processing, or <a
331
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
332
><code class="literal">NULL</code></a>
328
occurs during processing, or <code class="literal">NULL</code>
336
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
333
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
337
334
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
338
335
contain the actual error).
344
<p class="since">Since 2.2
348
345
<div class="refsect2" lang="en">
349
<a name="id2737324"></a><h3>
346
<a name="id2538904"></a><h3>
350
347
<a name="gnome-help-display-desktop"></a>gnome_help_display_desktop ()</h3>
351
<a class="indexterm" name="id2737338"></a><pre class="programlisting">gboolean gnome_help_display_desktop (<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
348
<a class="indexterm" name="id2538918"></a><pre class="programlisting">gboolean gnome_help_display_desktop (<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
352
349
const char *doc_id,
353
350
const char *file_name,
354
351
const char *link_id,
371
368
<col align="left" valign="top">
374
<td><span class="term"><em class="parameter"><code>program</code></em> :</span></td>
375
<td> The current application object, or <a
376
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
377
><code class="literal">NULL</code></a> for the default one.
372
<span class="term"><em class="parameter"><code>program</code></em> :</span></td>
373
<td> The current application object, or <code class="literal">NULL</code> for the default one.
381
<td><span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
378
<span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
382
379
<td> The name of the help file relative to the system's help domain
383
380
(<a href="libgnome-gnome-program.html#GNOME-FILE-DOMAIN-HELP:CAPS"><span class="type">GNOME_FILE_DOMAIN_HELP</span></a>).
387
<td><span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
385
<span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
388
386
<td> The name of the help document to display.
392
<td><span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
394
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
395
><code class="literal">NULL</code></a>. If set, refers to an anchor or section id within the
391
<span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
392
<td> Can be <code class="literal">NULL</code>. If set, refers to an anchor or section id within the
396
393
requested document.
400
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
398
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
401
399
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
402
occurs during processing, or <a
403
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
404
><code class="literal">NULL</code></a>
400
occurs during processing, or <code class="literal">NULL</code>
408
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
405
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
409
406
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
410
407
contain the actual error).
417
414
<div class="refsect2" lang="en">
418
<a name="id2737628"></a><h3>
415
<a name="id2539207"></a><h3>
419
416
<a name="gnome-help-display-desktop-with-env"></a>gnome_help_display_desktop_with_env ()</h3>
420
<a class="indexterm" name="id2737644"></a><pre class="programlisting">gboolean gnome_help_display_desktop_with_env
417
<a class="indexterm" name="id2539223"></a><pre class="programlisting">gboolean gnome_help_display_desktop_with_env
421
418
(<a href="libgnome-gnome-program.html#GnomeProgram">GnomeProgram</a> *program,
422
419
const char *doc_id,
423
420
const char *file_name,
435
432
<col align="left" valign="top">
438
<td><span class="term"><em class="parameter"><code>program</code></em> :</span></td>
439
<td> The current application object, or <a
440
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
441
><code class="literal">NULL</code></a> for the default one.
436
<span class="term"><em class="parameter"><code>program</code></em> :</span></td>
437
<td> The current application object, or <code class="literal">NULL</code> for the default one.
445
<td><span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
442
<span class="term"><em class="parameter"><code>doc_id</code></em> :</span></td>
446
443
<td> The name of the help file relative to the system's help domain
447
444
(<a href="libgnome-gnome-program.html#GNOME-FILE-DOMAIN-HELP:CAPS"><span class="type">GNOME_FILE_DOMAIN_HELP</span></a>).
451
<td><span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
449
<span class="term"><em class="parameter"><code>file_name</code></em> :</span></td>
452
450
<td> The name of the help document to display.
456
<td><span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
458
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
459
><code class="literal">NULL</code></a>. If set, refers to an anchor or section id within the
455
<span class="term"><em class="parameter"><code>link_id</code></em> :</span></td>
456
<td> Can be <code class="literal">NULL</code>. If set, refers to an anchor or section id within the
460
457
requested document.
464
<td><span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
465
<td> child's environment, or <a
466
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
467
><code class="literal">NULL</code></a> to inherit parent's.
462
<span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
463
<td> child's environment, or <code class="literal">NULL</code> to inherit parent's.
471
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
468
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
472
469
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
473
occurs during processing, or <a
474
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
475
><code class="literal">NULL</code></a>
470
occurs during processing, or <code class="literal">NULL</code>
479
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
475
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
480
476
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
481
477
contain the actual error).
487
<p class="since">Since 2.2
491
487
<div class="refsect2" lang="en">
492
<a name="id2737928"></a><h3>
488
<a name="id2539505"></a><h3>
493
489
<a name="gnome-help-display-uri"></a>gnome_help_display_uri ()</h3>
494
<a class="indexterm" name="id2737940"></a><pre class="programlisting">gboolean gnome_help_display_uri (const char *help_uri,
490
<a class="indexterm" name="id2539517"></a><pre class="programlisting">gboolean gnome_help_display_uri (const char *help_uri,
495
491
GError **error);</pre>
497
493
Displays <em class="parameter"><code>help_uri</code></em> in the user's preferred viewer. You should never need to
506
502
<col align="left" valign="top">
509
<td><span class="term"><em class="parameter"><code>help_uri</code></em> :</span></td>
506
<span class="term"><em class="parameter"><code>help_uri</code></em> :</span></td>
510
507
<td> The URI to display.
514
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
512
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
515
513
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
516
occurs during processing, or <a
517
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
518
><code class="literal">NULL</code></a>
514
occurs during processing, or <code class="literal">NULL</code>
522
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
519
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
523
520
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
524
521
contain the actual error).
531
528
<div class="refsect2" lang="en">
532
<a name="id2738091"></a><h3>
529
<a name="id2539668"></a><h3>
533
530
<a name="gnome-help-display-uri-with-env"></a>gnome_help_display_uri_with_env ()</h3>
534
<a class="indexterm" name="id2738106"></a><pre class="programlisting">gboolean gnome_help_display_uri_with_env (const char *help_uri,
531
<a class="indexterm" name="id2539683"></a><pre class="programlisting">gboolean gnome_help_display_uri_with_env (const char *help_uri,
536
533
GError **error);</pre>
545
542
<col align="left" valign="top">
548
<td><span class="term"><em class="parameter"><code>help_uri</code></em> :</span></td>
546
<span class="term"><em class="parameter"><code>help_uri</code></em> :</span></td>
549
547
<td> The URI to display.
553
<td><span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
554
<td> child's environment, or <a
555
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
556
><code class="literal">NULL</code></a> to inherit parent's.
552
<span class="term"><em class="parameter"><code>envp</code></em> :</span></td>
553
<td> child's environment, or <code class="literal">NULL</code> to inherit parent's.
560
<td><span class="term"><em class="parameter"><code>error</code></em> :</span></td>
558
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
561
559
<td> A <span class="type">GError</span> instance that will hold the specifics of any error which
562
occurs during processing, or <a
563
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
564
><code class="literal">NULL</code></a>
560
occurs during processing, or <code class="literal">NULL</code>
568
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
565
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
569
566
<td> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise (in which case <em class="parameter"><code>error</code></em> will
570
567
contain the actual error).