1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Application Help Buttons</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs07.html" title="Listing Documents in the Help Menu"><link rel="next" href="indexs09.html" title="Packaging Applet Documentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Application Help Buttons</th></tr><tr><td width="20%" align="left"><a href="indexs07.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a href="indexs09.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="applicationhelpbuttons"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="applicationhelpbuttons"></a>Application Help Buttons</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940222"></a>Developer Information</h3><p>
2        This section is for developers.  Documentation authors
3        generally do not need to know this material.
4      </p></div><p>
5      Most GNOME applications will have Help
6      buttons.  These are most often seen in Preference windows. (All
7      Preference windows should have Help
8      buttons.) Most Help buttons will connect
9      to the application manual, although some may connect to special
10      documents.  Because the Help buttons do
11      not generally have their own special documentation, the
12      documentation author(s) do not need to do very much.  However,
13      the application author must be careful to guarantee that the
14      application correctly opens the help documentation when the
15      Help buttons are pressed.  
16    </p><p>
17      To make the Help buttons call the correct document in the GNOME Help
18      Browser the developer should add code based on the following example:
19    </p><pre class="programlisting">
20gchar *tmp;
21tmp = gnome_help_file_find_file ("module", "page.html");
22if (tmp) {
23  gnome_help_goto(0, tmp);
24  g_free(tmp);
25}
26    </pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940360"></a>NOTE</h3><p>
27        The example above is in the C language, please refer to other
28        documentation or forums for other GNOME language bindings.
29      </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a href="indexs07.html">Prev</a>�</td><td width="20%" align="center"><a href="index.html">Home</a></td><td width="40%" align="right">�<a href="indexs09.html">Next</a></td></tr><tr><td width="40%" align="left">Listing Documents in the Help Menu�</td><td width="20%" align="center"><a href="index.html">Up</a></td><td width="40%" align="right">�Packaging Applet Documentation</td></tr></table></div></body></html>
30