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