| Offset 1, 34 lines modified |
Offset 1, 34 lines modified |
| 1 |
<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Debian·GNOME·Packaging·Policy</title><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.78.1"><meta·name="description"·content="This·document·describes·the·policy·requirements·for·the·packaging·of·GNOME·programs·in·Debian·GNU/Linux."></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·lang="en"·class="book"><div·class="titlepage"><div><div><h1·class="title"><a·name="debian-gnome-policy"></a>Debian·GNOME·Packaging·Policy</h1></div><div><div·class="author"><h3·class="author"><span·class="firstname">Ross</span>·<span·class="surname">Burton</span></h3><code·class="email"><<a·class="email"·href="mailto:ross@debian.org">ross@debian.org</a>></code></div></div><div><div·class="othercredit"><h3·class="othercredit"><span·class="firstname">Mikael</span>·<span·class="surname">Hallendal</span></h3><span·class="contrib">Advised·on·correct·gtk-doc·usage</span> <code·class="email"·✂
|
1 |
<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Debian·GNOME·Packaging·Policy</title><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.78.1"><meta·name="description"·content="This·document·describes·the·policy·requirements·for·the·packaging·of·GNOME·programs·in·Debian·GNU/Linux."></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·lang="en"·class="book"><div·class="titlepage"><div><div><h1·class="title"><a·name="debian-gnome-policy"></a>Debian·GNOME·Packaging·Policy</h1></div><div><div·class="author"><h3·class="author"><span·class="firstname">Ross</span>·<span·class="surname">Burton</span></h3><code·class="email"><<a·class="email"·href="mailto:ross@debian.org">ross@debian.org</a>></code></div></div><div><div·class="othercredit"><h3·class="othercredit"><span·class="firstname">Mikael</span>·<span·class="surname">Hallendal</span></h3><span·class="contrib">Advised·on·correct·gtk-doc·usage</span> <code·class="email"·✂
|
| 2 |
········<em><span·class="remark">TODO:·insert·Open·Content·License·or·similar·here</span></em>
|
2 |
········<em><span·class="remark">TODO:·insert·Open·Content·License·or·similar·here</span></em>
|
| 3 |
······</p></div></div><div><div·class="revhistory"><table·style="border-style:solid;·width:100%;"·summary="Revision·History"><tr><th·align="left"·valign="top"·colspan="2"><b>Revision·History</b></th></tr><tr><td·align="left">Revision·20050123-1</td><td·align="left">2005-01-23</td></tr><tr><td·align="left"·colspan="2">Remove·section·on·Nautilus·Views,·add·dh_gconf,·and·clarify
|
3 |
······</p></div></div><div><div·class="revhistory"><table·style="border-style:solid;·width:100%;"·summary="Revision·History"><tr><th·align="left"·valign="top"·colspan="2"><b>Revision·History</b></th></tr><tr><td·align="left">Revision·20050123-1</td><td·align="left">2005-01-23</td></tr><tr><td·align="left"·colspan="2">Remove·section·on·Nautilus·Views,·add·dh_gconf,·and·clarify
|
| 4 |
········gtk-doc·paths.</td></tr><tr><td·align="left">Revision·20040816-1</td><td·align="left">2004-08-16</td></tr><tr><td·align="left"·colspan="2">Quick·update·to·cover·changes·up·to·GNOME·2.6.</td></tr><tr><td·align="left">Revision·20030502-1</td><td·align="left">2003-05-03</td></tr><tr><td·align="left"·colspan="2">Clarified·gtk-doc·layout,·added·a·section·on·the
|
4 |
········gtk-doc·paths.</td></tr><tr><td·align="left">Revision·20040816-1</td><td·align="left">2004-08-16</td></tr><tr><td·align="left"·colspan="2">Quick·update·to·cover·changes·up·to·GNOME·2.6.</td></tr><tr><td·align="left">Revision·20030502-1</td><td·align="left">2003-05-03</td></tr><tr><td·align="left"·colspan="2">Clarified·gtk-doc·layout,·added·a·section·on·the
|
| 5 |
········'gnome'·section,·and·clarified·the·section·for
|
5 |
········'gnome'·section,·and·clarified·the·section·for
|
| 6 |
········engines.</td></tr><tr><td·align="left">Revision·20030218-1</td><td·align="left">2003-02-18</td></tr><tr><td·align="left"·colspan="2">Rewrote·section·on·API·Documentation,·after·talking
|
6 |
········engines.</td></tr><tr><td·align="left">Revision·20030218-1</td><td·align="left">2003-02-18</td></tr><tr><td·align="left"·colspan="2">Rewrote·section·on·API·Documentation,·after·talking
|
| 7 |
········to·gtk-doc·developers.</td></tr><tr><td·align="left">Revision·20030119-1</td><td·align="left">2003-01-19</td></tr><tr><td·align="left"·colspan="2">Added·a·section·on·GnomeVFS,·and·rewrote·the·API
|
7 |
········to·gtk-doc·developers.</td></tr><tr><td·align="left">Revision·20030119-1</td><td·align="left">2003-01-19</td></tr><tr><td·align="left"·colspan="2">Added·a·section·on·GnomeVFS,·and·rewrote·the·API
|
| 8 |
········documentation·section.</td></tr><tr><td·align="left">Revision·20030114-1</td><td·align="left">2003-01-14</td></tr><tr><td·align="left"·colspan="2">Reformatted·in·DocBook.</td></tr></table></div></div><div><div·class="abstract"><p·class="title"><b>Abstract</b></p><p>
|
8 |
········documentation·section.</td></tr><tr><td·align="left">Revision·20030114-1</td><td·align="left">2003-01-14</td></tr><tr><td·align="left"·colspan="2">Reformatted·in·DocBook.</td></tr></table></div></div><div><div·class="abstract"><p·class="title"><b>Abstract</b></p><p>
|
| 9 |
········This·document·describes·the·policy·requirements·for·the·packaging·of·GNOME·programs·in
|
9 |
········This·document·describes·the·policy·requirements·for·the·packaging·of·GNOME·programs·in
|
| 10 |
········Debian·GNU/Linux.
|
10 |
········Debian·GNU/Linux.
|
| 11 |
······</p></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="chapter"><a·href="#idm139903879048608">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="#idm139903879045888">2.·General·Packaging·Guidelines</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="#idm139903879045200">Package·Naming</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879041872">Package·Section</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879039904">Documentation</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879012592">Use·of·GConf</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="#idm139903874027152">3.·Specific·Packaging·Guidelines</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="#idm139903874026512">Panel·Applets</a></span></dt><dt><span·class="sect1"><a·href="#idm139903874022688">Themes·and·Theme·Engines</a></span></dt><dt><span·class="sect1"><a·href="#idm139903874017296">GnomeVFS·Methods</a></span></dt></dl>·✂
|
11 |
······</p></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="chapter"><a·href="#idm140375521183296">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="#idm140375521180576">2.·General·Packaging·Guidelines</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="#idm140375521179888">Package·Naming</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521176608">Package·Section</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521174640">Documentation</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521147280">Use·of·GConf</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="#idm140375516165168">3.·Specific·Packaging·Guidelines</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="#idm140375516164528">Panel·Applets</a></span></dt><dt><span·class="sect1"><a·href="#idm140375516160704">Themes·and·Theme·Engines</a></span></dt><dt><span·class="sect1"><a·href="#idm140375516155312">GnomeVFS·Methods</a></span></dt></dl>·✂
|
| 12 |
······This·document·describes·the·policy·requirements·for·the·packaging·of
|
12 |
······This·document·describes·the·policy·requirements·for·the·packaging·of
|
| 13 |
······<span·class="application">GNOME</span>·programs.
|
13 |
······<span·class="application">GNOME</span>·programs.
|
| 14 |
····</p><p>
|
14 |
····</p><p>
|
| 15 |
······This·document·is·currently·a·draft,·as·it·evolves·it·should·become·more·organised.
|
15 |
······This·document·is·currently·a·draft,·as·it·evolves·it·should·become·more·organised.
|
| 16 |
····</p><p>
|
16 |
····</p><p>
|
| 17 |
······This·document·only·mentions·packaging·guidelines·appropriate·for·GNOME·packages.·The·Debian
|
17 |
······This·document·only·mentions·packaging·guidelines·appropriate·for·GNOME·packages.·The·Debian
|
| 18 |
······Policy·still·applies·to·all·packages.
|
18 |
······Policy·still·applies·to·all·packages.
|
| 19 |
····</p></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm139903879045888"></a>Chapter 2. General·Packaging·Guidelines</h1></div></div></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="sect1"><a·href="#idm139903879045200">Package·Naming</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879041872">Package·Section</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879039904">Documentation</a></span></dt><dt><span·class="sect1"><a·href="#idm139903879012592">Use·of·GConf</a></span></dt></dl></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903879045200"></a>Package·Naming</h2></div></div></div><p>
|
19 |
····</p></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm140375521180576"></a>Chapter 2. General·Packaging·Guidelines</h1></div></div></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="sect1"><a·href="#idm140375521179888">Package·Naming</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521176608">Package·Section</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521174640">Documentation</a></span></dt><dt><span·class="sect1"><a·href="#idm140375521147280">Use·of·GConf</a></span></dt></dl></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375521179888"></a>Package·Naming</h2></div></div></div><p>
|
| 20 |
········Programs·that·the·end·user·can·actually·run·(such·as·<span·class="application">File·Roller</span>)
|
20 |
········Programs·that·the·end·user·can·actually·run·(such·as·<span·class="application">File·Roller</span>)
|
| 21 |
········should·be·packaged·as·the·name·of·the·program.·Do·not·suffix·the·package·with·a
|
21 |
········should·be·packaged·as·the·name·of·the·program.·Do·not·suffix·the·package·with·a
|
| 22 |
········<code·class="literal">2</code>·to·represent·the·GNOME·2·package;·if·upstream·is·maintaining·both·GNOME
|
22 |
········<code·class="literal">2</code>·to·represent·the·GNOME·2·package;·if·upstream·is·maintaining·both·GNOME
|
| 23 |
········1·and·GNOME·2·releases,·then·name·the·GNOME·1·package·<code·class="literal">foo-gnome1</code>·instead.
|
23 |
········1·and·GNOME·2·releases,·then·name·the·GNOME·1·package·<code·class="literal">foo-gnome1</code>·instead.
|
| 24 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903879041872"></a>Package·Section</h2></div></div></div><p>
|
24 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375521176608"></a>Package·Section</h2></div></div></div><p>
|
| 25 |
········GNOME·applications·(not·libraries)·should·be·in·the·<code·class="literal">gnome</code>·section·unless
|
25 |
········GNOME·applications·(not·libraries)·should·be·in·the·<code·class="literal">gnome</code>·section·unless
|
| 26 |
········they·are·used·by·multiple·environments·(such·as·KDE).
|
26 |
········they·are·used·by·multiple·environments·(such·as·KDE).
|
| 27 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903879039904"></a>Documentation</h2></div></div></div><p>
|
27 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375521174640"></a>Documentation</h2></div></div></div><p>
|
| 28 |
········If·any·binaries·accept·the·standard·GTK+·or·GNOME·command-line·options,·the·manual·pages
|
28 |
········If·any·binaries·accept·the·standard·GTK+·or·GNOME·command-line·options,·the·manual·pages
|
| 29 |
········should·refer·to·the·GTK+·and/or·GNOME·common·command-line·option·manual·pages,
|
29 |
········should·refer·to·the·GTK+·and/or·GNOME·common·command-line·option·manual·pages,
|
| 30 |
········<code·class="filename">gtk-options.7</code>·and·<code·class="filename">gnome-options.7</code>·(in·the·packages
|
30 |
········<code·class="filename">gtk-options.7</code>·and·<code·class="filename">gnome-options.7</code>·(in·the·packages
|
| 31 |
········<code·class="filename">libgtk2.0-bin</code>·and·<code·class="filename">libgnome2-common</code>·respectively).
|
31 |
········<code·class="filename">libgtk2.0-bin</code>·and·<code·class="filename">libgnome2-common</code>·respectively).
|
| 32 |
······</p><p>
|
32 |
······</p><p>
|
| 33 |
········If·the·upstream·tarball·contains·API·documentation·for·a·library·which·is·generated·using
|
33 |
········If·the·upstream·tarball·contains·API·documentation·for·a·library·which·is·generated·using
|
| 34 |
········<span·class="application">gtk-doc</span>·or·<span·class="application">doxygen</span>,·it·should·not·be
|
34 |
········<span·class="application">gtk-doc</span>·or·<span·class="application">doxygen</span>,·it·should·not·be
|
| Offset 43, 22 lines modified |
Offset 43, 22 lines modified |
| 43 |
········after·the·type·of·file·(such·as·<code·class="filename">html/</code>).·This·is·so·that·multiple
|
43 |
········after·the·type·of·file·(such·as·<code·class="filename">html/</code>).·This·is·so·that·multiple
|
| 44 |
········formats·can·be·packaged·(PDF·for·example).
|
44 |
········formats·can·be·packaged·(PDF·for·example).
|
| 45 |
······</p><p>
|
45 |
······</p><p>
|
| 46 |
········However,·if·<span·class="application">gtk-doc</span>·is·used·to·generate·the·API·documentation,
|
46 |
········However,·if·<span·class="application">gtk-doc</span>·is·used·to·generate·the·API·documentation,
|
| 47 |
········the·documentation·should·be·installed·in·the·default·location,
|
47 |
········the·documentation·should·be·installed·in·the·default·location,
|
| 48 |
········<code·class="filename">/usr/share/gtk-doc/html/[package]</code>,·with·a·symbolic·link·in
|
48 |
········<code·class="filename">/usr/share/gtk-doc/html/[package]</code>,·with·a·symbolic·link·in
|
| 49 |
········<code·class="filename">/usr/share/doc/[package]/html/</code>.
|
49 |
········<code·class="filename">/usr/share/doc/[package]/html/</code>.
|
| 50 |
········<a·href="#ftn.idm139903879018176"·class="footnote"·name="idm139903879018176"><sup·class="footnote">[1]</sup></a>·The·<code·class="filename">[package].devhelp</code>·file·must·also·be·installed.··This
|
50 |
········<a·href="#ftn.idm140375521152864"·class="footnote"·name="idm140375521152864"><sup·class="footnote">[1]</sup></a>·The·<code·class="filename">[package].devhelp</code>·file·must·also·be·installed.··This
|
| 51 |
········ensures·that·gtk-doc·and·other·tools·which·use·the·gtk-doc·metadata·(such·as
|
51 |
········ensures·that·gtk-doc·and·other·tools·which·use·the·gtk-doc·metadata·(such·as
|
| 52 |
········<span·class="application">DevHelp</span>)·can·find·the·documentation.
|
52 |
········<span·class="application">DevHelp</span>)·can·find·the·documentation.
|
| 53 |
······</p><p>
|
53 |
······</p><p>
|
| 54 |
········<em><span·class="remark">TODO:·There·is·the·issue·of·rebuilding·documentation
|
54 |
········<em><span·class="remark">TODO:·There·is·the·issue·of·rebuilding·documentation
|
| 55 |
··········if·upstream·didn't·generate·it·with·cross-references.·Ideally·all·types·will·be
|
55 |
··········if·upstream·didn't·generate·it·with·cross-references.·Ideally·all·types·will·be
|
| 56 |
··········cross-referenced,·down·to·<span·class="type">gint</span>.</span></em>
|
56 |
··········cross-referenced,·down·to·<span·class="type">gint</span>.</span></em>
|
| 57 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903879012592"></a>Use·of·GConf</h2></div></div></div><p>
|
57 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375521147280"></a>Use·of·GConf</h2></div></div></div><p>
|
| 58 |
········Many·GNOME·applications·use·<span·class="application">GConf</span>·for·preferences,·and·most
|
58 |
········Many·GNOME·applications·use·<span·class="application">GConf</span>·for·preferences,·and·most
|
| 59 |
········applications·provide·schemas·for·the·keys·they·set.·These·schemas·must·be·handled·specially
|
59 |
········applications·provide·schemas·for·the·keys·they·set.·These·schemas·must·be·handled·specially
|
| 60 |
········in·the·package·build·process.··There·are·two·issues:·the·location·of·schema·files·on·disk,
|
60 |
········in·the·package·build·process.··There·are·two·issues:·the·location·of·schema·files·on·disk,
|
| 61 |
········and·registering·schemas·at·install·time.
|
61 |
········and·registering·schemas·at·install·time.
|
| 62 |
······</p><p>
|
62 |
······</p><p>
|
| 63 |
········GConf·schema·files·are·by·default·installed·into·<code·class="filename">/etc/gconf/schemas</code>,
|
63 |
········GConf·schema·files·are·by·default·installed·into·<code·class="filename">/etc/gconf/schemas</code>,
|
| 64 |
········but·as·they·are·not·configuration·files·we·move·them·to
|
64 |
········but·as·they·are·not·configuration·files·we·move·them·to
|
| Offset 82, 44 lines modified |
Offset 82, 44 lines modified |
| 82 |
········1.·This·will·ensure·that·the·schemas·are·not·installed·on·your·machine
|
82 |
········1.·This·will·ensure·that·the·schemas·are·not·installed·on·your·machine
|
| 83 |
········in·the·package·build·tree.··Then·in·the·relevant·<code·class="literal">binary-</code>·target·call
|
83 |
········in·the·package·build·tree.··Then·in·the·relevant·<code·class="literal">binary-</code>·target·call
|
| 84 |
········<code·class="filename">dh_gconf</code>·to·create·the·maintainer·scripts.
|
84 |
········<code·class="filename">dh_gconf</code>·to·create·the·maintainer·scripts.
|
| 85 |
······</p><p>
|
85 |
······</p><p>
|
| 86 |
········If·you·use·<code·class="filename">dh_gconf</code>·via·either·CDBS·or·manually,·you·must·depend·on
|
86 |
········If·you·use·<code·class="filename">dh_gconf</code>·via·either·CDBS·or·manually,·you·must·depend·on
|
| 87 |
········<code·class="filename">debhelper</code>·>=·4.1.87,·although·<code·class="filename">debhelper</code>·>=·4.2.16
|
87 |
········<code·class="filename">debhelper</code>·>=·4.1.87,·although·<code·class="filename">debhelper</code>·>=·4.2.16
|
| 88 |
········is·recomended·for·the·move·of·schemas·to·<code·class="filename">/usr/share/gconf/schemas</code>.
|
88 |
········is·recomended·for·the·move·of·schemas·to·<code·class="filename">/usr/share/gconf/schemas</code>.
|
| 89 |
······</p></div><div·class="footnotes"><br><hr·style="width:100;·text-align:left;margin-left:·0"><div·id="ftn.idm139903879018176"·class="footnote"><p><a·href="#idm139903879018176"·class="para"><sup·class="para">[1]·</sup></a>
|
89 |
······</p></div><div·class="footnotes"><br><hr·style="width:100;·text-align:left;margin-left:·0"><div·id="ftn.idm140375521152864"·class="footnote"><p><a·href="#idm140375521152864"·class="para"><sup·class="para">[1]·</sup></a>
|
| 90 |
············Alternatively,·the·documentation·can·be·installed·into
|
90 |
············Alternatively,·the·documentation·can·be·installed·into
|
| 91 |
············<code·class="filename">/usr/share/doc/[package]/</code>·and·a·symbolic·link·to·it·created·in
|
91 |
············<code·class="filename">/usr/share/doc/[package]/</code>·and·a·symbolic·link·to·it·created·in
|
| 92 |
············<code·class="filename">/usr/share/gtk-doc/html/</code>.
|
92 |
············<code·class="filename">/usr/share/gtk-doc/html/</code>.
|
| 93 |
··········</p></div></div></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm139903874027152"></a>Chapter 3. Specific·Packaging·Guidelines</h1></div></div></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="sect1"><a·href="#idm139903874026512">Panel·Applets</a></span></dt><dt><span·class="sect1"><a·href="#idm139903874022688">Themes·and·Theme·Engines</a></span></dt><dt><span·class="sect1"><a·href="#idm139903874017296">GnomeVFS·Methods</a></span></dt></dl></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903874026512"></a>Panel·Applets</h2></div></div></div><p>
|
93 |
··········</p></div></div></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm140375516165168"></a>Chapter 3. Specific·Packaging·Guidelines</h1></div></div></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl·class="toc"><dt><span·class="sect1"><a·href="#idm140375516164528">Panel·Applets</a></span></dt><dt><span·class="sect1"><a·href="#idm140375516160704">Themes·and·Theme·Engines</a></span></dt><dt><span·class="sect1"><a·href="#idm140375516155312">GnomeVFS·Methods</a></span></dt></dl></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375516164528"></a>Panel·Applets</h2></div></div></div><p>
|
| 94 |
········<em><span·class="remark">TODO:·Panel·applets·--·"gnome-applet-foo"·or·"foo-applet"·or
|
94 |
········<em><span·class="remark">TODO:·Panel·applets·--·"gnome-applet-foo"·or·"foo-applet"·or
|
| 95 |
········"gnome-foo-applet"?</span></em>
|
95 |
········"gnome-foo-applet"?</span></em>
|
| 96 |
······</p><p>
|
96 |
······</p><p>
|
| 97 |
········Panel·applets·must·be·installed·into·<code·class="filename">/usr/lib/gnome-panel</code>·as·they·are
|
97 |
········Panel·applets·must·be·installed·into·<code·class="filename">/usr/lib/gnome-panel</code>·as·they·are
|
| 98 |
········never
|
98 |
········never
|
| 99 |
··········directly·executabled·by·the·user.·This·applies·to·both
|
99 |
··········directly·executabled·by·the·user.·This·applies·to·both
|
| 100 |
········shared·library·and·executable·panel·applets.·<em><span·class="remark">TODO:·Or·should
|
100 |
········shared·library·and·executable·panel·applets.·<em><span·class="remark">TODO:·Or·should
|
| 101 |
··········they·go·into·<code·class="filename">/usr/share/gnome-applets</code>?</span></em>
|
101 |
··········they·go·into·<code·class="filename">/usr/share/gnome-applets</code>?</span></em>
|
| 102 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903874022688"></a>Themes·and·Theme·Engines</h2></div></div></div><p>
|
102 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375516160704"></a>Themes·and·Theme·Engines</h2></div></div></div><p>
|
| 103 |
········GTK+·1.x·engines·must·be·named·<code·class="filename">gtk-engines-[name]</code>,·and·GTK+·2.x·engines
|
103 |
········GTK+·1.x·engines·must·be·named·<code·class="filename">gtk-engines-[name]</code>,·and·GTK+·2.x·engines
|
| 104 |
········must·named·<code·class="filename">gtk2-engines-[name]</code>.··All·engines·should·be·in·the
|
104 |
········must·named·<code·class="filename">gtk2-engines-[name]</code>.··All·engines·should·be·in·the
|
| 105 |
········<code·class="literal">gnome</code>·section.
|
105 |
········<code·class="literal">gnome</code>·section.
|
| 106 |
······</p><p>
|
106 |
······</p><p>
|
| 107 |
········Unless·there·are·special·requirements,·GTK+·themes·should·not·specify·a·font.·This·is
|
107 |
········Unless·there·are·special·requirements,·GTK+·themes·should·not·specify·a·font.·This·is
|
| 108 |
········because·a·font·specified·in·a·theme·can·not·be·changed·by·the·user·trivially.
|
108 |
········because·a·font·specified·in·a·theme·can·not·be·changed·by·the·user·trivially.
|
| 109 |
······</p><p>
|
109 |
······</p><p>
|
| 110 |
········<em><span·class="remark">TODO:·How·do·we·package·pure·gtkrc·themes·which·use·engines·(such·as·GitM,·which
|
110 |
········<em><span·class="remark">TODO:·How·do·we·package·pure·gtkrc·themes·which·use·engines·(such·as·GitM,·which
|
| 111 |
········uses·mist)?··Should·engine·packages·include·a·set·of·decent·themes·for·this·engine,·even·if
|
111 |
········uses·mist)?··Should·engine·packages·include·a·set·of·decent·themes·for·this·engine,·even·if
|
| 112 |
········they·were·not·written·by·the·same·author?</span></em>
|
112 |
········they·were·not·written·by·the·same·author?</span></em>
|
| 113 |
······</p><p>
|
113 |
······</p><p>
|
| 114 |
········<em><span·class="remark">TODO:·Icon·themes?··Metacity·themes?</span></em>
|
114 |
········<em><span·class="remark">TODO:·Icon·themes?··Metacity·themes?</span></em>
|
| 115 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm139903874017296"></a>GnomeVFS·Methods</h2></div></div></div><p>
|
115 |
······</p></div><div·class="sect1"><div·class="titlepage"><div><div><h2·class="title"·style="clear:·both"><a·name="idm140375516155312"></a>GnomeVFS·Methods</h2></div></div></div><p>
|
| 116 |
········It·is·recommended·that·any·GnomeVFS·methods·included·with·a·program·should·be·packaged
|
116 |
········It·is·recommended·that·any·GnomeVFS·methods·included·with·a·program·should·be·packaged
|
| 117 |
········separately,·with·just·the·necessary·shared·library·and·the·GnomeVFS·module·configuration
|
117 |
········separately,·with·just·the·necessary·shared·library·and·the·GnomeVFS·module·configuration
|
| 118 |
········file.··If·a·package·provides·just·a·single·method,·it·should·be·named·like
|
118 |
········file.··If·a·package·provides·just·a·single·method,·it·should·be·named·like
|
| 119 |
········<code·class="filename">gnomevfs-method-[prefix]</code>,·where·<code·class="varname">[prefix]</code>·is·the·URI
|
119 |
········<code·class="filename">gnomevfs-method-[prefix]</code>,·where·<code·class="varname">[prefix]</code>·is·the·URI
|
| 120 |
········prefix·that·the·method·provides.
|
120 |
········prefix·that·the·method·provides.
|
| 121 |
······</p><p>
|
121 |
······</p><p>
|
| 122 |
········If·a·single·upstream·source·package·provides·multiple·methods,·it·may·either·be·packaged·as
|
122 |
········If·a·single·upstream·source·package·provides·multiple·methods,·it·may·either·be·packaged·as
|
| 123 |
········<code·class="filename">gnomevfs-methods-[name]</code>,·where·<code·class="varname">[name]</code>·is·the·name·of
|
123 |
········<code·class="filename">gnomevfs-methods-[name]</code>,·where·<code·class="varname">[name]</code>·is·the·name·of
|
| 124 |
········the·upstream·source,·or·it·may·be·split·into·multiple·individual·packages·as·above.
|
124 |
········the·upstream·source,·or·it·may·be·split·into·multiple·individual·packages·as·above.
|
| 125 |
······</p></div></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm139903874012976"></a>Chapter 4. License</h1></div></div></div><p><em><span·class="remark">TODO:·insert·something·sane.</span></em></p></div></div></body></html>
|
125 |
······</p></div></div><div·class="chapter"><div·class="titlepage"><div><div><h1·class="title"><a·name="idm140375516150992"></a>Chapter 4. License</h1></div></div></div><p><em><span·class="remark">TODO:·insert·something·sane.</span></em></p></div></div></body></html>
|