doc/pkgsrc.*: regen

This commit is contained in:
nia 2021-06-11 15:10:08 +00:00
parent c654f888a5
commit 5cb81374b5
2 changed files with 101 additions and 276 deletions

View file

@ -339,7 +339,7 @@ builds)</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="#basic-programming-languages">21.4.1. C, C++, and Fortran</a></span></dt>
<dt><span class="sect2"><a href="#java-programming-language">21.4.2. Java</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing Perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#shell-scripts">21.4.4. Packages containing shell scripts</a></span></dt>
<dt><span class="sect2"><a href="#other-programming-languages">21.4.5. Other programming languages</a></span></dt>
</dl></dd>
@ -358,22 +358,19 @@ builds)</a></span></dt>
<dt><span class="sect2"><a href="#installing-score-files">21.6.3. Installing highscore files</a></span></dt>
<dt><span class="sect2"><a href="#destdir-support">21.6.4. Adding DESTDIR support to packages</a></span></dt>
<dt><span class="sect2"><a href="#hardcoded-paths">21.6.5. Packages with hardcoded paths to other interpreters</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing perl modules</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing Perl modules</a></span></dt>
<dt><span class="sect2"><a href="#faq.info-files">21.6.7. Packages installing info files</a></span></dt>
<dt><span class="sect2"><a href="#manpages">21.6.8. Packages installing man pages</a></span></dt>
<dt><span class="sect2"><a href="#gconf-data-files">21.6.9. Packages installing GConf data files</a></span></dt>
<dt><span class="sect2"><a href="#scrollkeeper-data-files">21.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt>
<dt><span class="sect2"><a href="#x11-fonts">21.6.11. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#gtk2-modules">21.6.12. Packages installing GTK2 modules</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.13. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.14. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.15. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.16. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.17. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.18. Packages supporting running binaries in
<dt><span class="sect2"><a href="#x11-fonts">21.6.9. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.10. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.11. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.12. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.13. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.14. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.15. Packages supporting running binaries in
emulation</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.19. Packages installing hicolor theme icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.20. Packages installing desktop files</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.16. Packages installing hicolor icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.17. Packages installing desktop files</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#punting">21.7. Marking packages as having problems</a></span></dt>
</dl></dd>
@ -3282,7 +3279,7 @@ anymore, you can remove that file and run <span class="command"><strong>cvs -q u
<dd><dl>
<dt><span class="sect2"><a href="#basic-programming-languages">21.4.1. C, C++, and Fortran</a></span></dt>
<dt><span class="sect2"><a href="#java-programming-language">21.4.2. Java</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing Perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#shell-scripts">21.4.4. Packages containing shell scripts</a></span></dt>
<dt><span class="sect2"><a href="#other-programming-languages">21.4.5. Other programming languages</a></span></dt>
</dl></dd>
@ -3301,22 +3298,19 @@ anymore, you can remove that file and run <span class="command"><strong>cvs -q u
<dt><span class="sect2"><a href="#installing-score-files">21.6.3. Installing highscore files</a></span></dt>
<dt><span class="sect2"><a href="#destdir-support">21.6.4. Adding DESTDIR support to packages</a></span></dt>
<dt><span class="sect2"><a href="#hardcoded-paths">21.6.5. Packages with hardcoded paths to other interpreters</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing perl modules</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing Perl modules</a></span></dt>
<dt><span class="sect2"><a href="#faq.info-files">21.6.7. Packages installing info files</a></span></dt>
<dt><span class="sect2"><a href="#manpages">21.6.8. Packages installing man pages</a></span></dt>
<dt><span class="sect2"><a href="#gconf-data-files">21.6.9. Packages installing GConf data files</a></span></dt>
<dt><span class="sect2"><a href="#scrollkeeper-data-files">21.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt>
<dt><span class="sect2"><a href="#x11-fonts">21.6.11. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#gtk2-modules">21.6.12. Packages installing GTK2 modules</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.13. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.14. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.15. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.16. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.17. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.18. Packages supporting running binaries in
<dt><span class="sect2"><a href="#x11-fonts">21.6.9. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.10. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.11. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.12. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.13. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.14. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.15. Packages supporting running binaries in
emulation</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.19. Packages installing hicolor theme icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.20. Packages installing desktop files</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.16. Packages installing hicolor icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.17. Packages installing desktop files</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#punting">21.7. Marking packages as having problems</a></span></dt>
</dl></dd>
@ -7277,7 +7271,7 @@ environment variable to <code class="literal">NO</code>.</p>
<dd><dl>
<dt><span class="sect2"><a href="#basic-programming-languages">21.4.1. C, C++, and Fortran</a></span></dt>
<dt><span class="sect2"><a href="#java-programming-language">21.4.2. Java</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#perl-scripts">21.4.3. Packages containing Perl scripts</a></span></dt>
<dt><span class="sect2"><a href="#shell-scripts">21.4.4. Packages containing shell scripts</a></span></dt>
<dt><span class="sect2"><a href="#other-programming-languages">21.4.5. Other programming languages</a></span></dt>
</dl></dd>
@ -7296,22 +7290,19 @@ environment variable to <code class="literal">NO</code>.</p>
<dt><span class="sect2"><a href="#installing-score-files">21.6.3. Installing highscore files</a></span></dt>
<dt><span class="sect2"><a href="#destdir-support">21.6.4. Adding DESTDIR support to packages</a></span></dt>
<dt><span class="sect2"><a href="#hardcoded-paths">21.6.5. Packages with hardcoded paths to other interpreters</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing perl modules</a></span></dt>
<dt><span class="sect2"><a href="#perl-modules">21.6.6. Packages installing Perl modules</a></span></dt>
<dt><span class="sect2"><a href="#faq.info-files">21.6.7. Packages installing info files</a></span></dt>
<dt><span class="sect2"><a href="#manpages">21.6.8. Packages installing man pages</a></span></dt>
<dt><span class="sect2"><a href="#gconf-data-files">21.6.9. Packages installing GConf data files</a></span></dt>
<dt><span class="sect2"><a href="#scrollkeeper-data-files">21.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt>
<dt><span class="sect2"><a href="#x11-fonts">21.6.11. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#gtk2-modules">21.6.12. Packages installing GTK2 modules</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.13. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.14. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.15. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.16. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.17. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.18. Packages supporting running binaries in
<dt><span class="sect2"><a href="#x11-fonts">21.6.9. Packages installing X11 fonts</a></span></dt>
<dt><span class="sect2"><a href="#sgml-xml-data">21.6.10. Packages installing SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href="#mime-database">21.6.11. Packages installing extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href="#intltool">21.6.12. Packages using intltool</a></span></dt>
<dt><span class="sect2"><a href="#startup-scripts">21.6.13. Packages installing startup scripts</a></span></dt>
<dt><span class="sect2"><a href="#tex-packages">21.6.14. Packages installing TeX modules</a></span></dt>
<dt><span class="sect2"><a href="#emulation-packages">21.6.15. Packages supporting running binaries in
emulation</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.19. Packages installing hicolor theme icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.20. Packages installing desktop files</a></span></dt>
<dt><span class="sect2"><a href="#hicolor-theme">21.6.16. Packages installing hicolor icons</a></span></dt>
<dt><span class="sect2"><a href="#desktop-files">21.6.17. Packages installing desktop files</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#punting">21.7. Marking packages as having problems</a></span></dt>
</dl>
@ -8463,8 +8454,8 @@ pre-configure:
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="perl-scripts"></a>21.4.3. Packages containing perl scripts</h3></div></div></div>
<p>If your package contains interpreted perl scripts, add
<a name="perl-scripts"></a>21.4.3. Packages containing Perl scripts</h3></div></div></div>
<p>If your package contains interpreted Perl scripts, add
<span class="quote">&#8220;<span class="quote">perl</span>&#8221;</span> to the <code class="varname">USE_TOOLS</code> variable
and set <code class="varname">REPLACE_PERL</code> to ensure that the proper
interpreter path is set. <code class="varname">REPLACE_PERL</code> should
@ -8475,7 +8466,7 @@ pre-configure:
<p>If a particular version of perl is needed, set the
<code class="varname">PERL5_REQD</code> variable to the version number. The
default is <span class="quote">&#8220;<span class="quote">5.0</span>&#8221;</span>.</p>
<p>See <a class="xref" href="#perl-modules" title="21.6.6. Packages installing perl modules">Section 21.6.6, &#8220;Packages installing perl modules&#8221;</a> for information
<p>See <a class="xref" href="#perl-modules" title="21.6.6. Packages installing Perl modules">Section 21.6.6, &#8220;Packages installing Perl modules&#8221;</a> for information
about handling perl modules.</p>
</div>
<div class="sect2">
@ -8961,7 +8952,7 @@ SPECIAL_PERMS+= ${PREFIX}/bin/moon-buggy ${SETGID_GAMES_PERMS}
<div class="titlepage"><div><div><h3 class="title">
<a name="hardcoded-paths"></a>21.6.5. Packages with hardcoded paths to other interpreters</h3></div></div></div>
<p>Your package may also contain scripts with hardcoded paths to
other interpreters besides (or as well as) perl. To correct the
other interpreters besides (or as well as) Perl. To correct the
full pathname to the script interpreter, you need to set the
following definitions in your <code class="filename">Makefile</code> (we
shall use <span class="command"><strong>tclsh</strong></span> in this example):</p>
@ -8981,7 +8972,7 @@ REPLACE_FILES.tcl= # list of tcl scripts which need to be fixed,
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="perl-modules"></a>21.6.6. Packages installing perl modules</h3></div></div></div>
<a name="perl-modules"></a>21.6.6. Packages installing Perl modules</h3></div></div></div>
<p>Makefiles of packages providing perl5 modules should include
the Makefile fragment
<code class="filename">../../lang/perl5/module.mk</code>. It provides a
@ -9105,62 +9096,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="gconf-data-files"></a>21.6.9. Packages installing GConf data files</h3></div></div></div>
<p>If a package installs <code class="filename">.schemas</code> or
<code class="filename">.entries</code> files, used by GConf,
you need to take some extra steps to make sure they get registered
in the database:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>Include <code class="filename">../../devel/GConf/schemas.mk</code>
instead of its <code class="filename">buildlink3.mk</code> file. This
takes care of rebuilding the GConf database at installation and
deinstallation time, and tells the package where to install
GConf data files using some standard configure arguments. It
also disallows any access to the database directly from the
package.</p></li>
<li class="listitem"><p>Ensure that the package installs its
<code class="filename">.schemas</code> files under
<code class="filename">${PREFIX}/share/gconf/schemas</code>. If they get
installed under <code class="filename">${PREFIX}/etc</code>, you will
need to manually patch the package.</p></li>
<li class="listitem"><p>Check the PLIST and remove any entries under the etc/gconf
directory, as they will be handled automatically. See
<a class="xref" href="#faq.conf" title="10.13. How do I change the location of configuration files?">Section 10.13, &#8220;How do I change the location of configuration files?&#8221;</a> for more information.</p></li>
<li class="listitem"><p>Define the <code class="varname">GCONF_SCHEMAS</code> variable in
your <code class="filename">Makefile</code> with a list of all
<code class="filename">.schemas</code> files installed by the package, if
any. Names must not contain any directories in them.</p></li>
<li class="listitem"><p>Define the <code class="varname">GCONF_ENTRIES</code> variable in
your <code class="filename">Makefile</code> with a
list of all <code class="filename">.entries</code> files installed by the
package, if any. Names must not contain any directories in
them.</p></li>
</ol></div>
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="scrollkeeper-data-files"></a>21.6.10. Packages installing scrollkeeper/rarian data files</h3></div></div></div>
<p>If a package installs <code class="filename">.omf</code> files, used by
scrollkeeper/rarian, you need to take some extra steps to make sure they
get registered in the database:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>Include
<code class="filename">../../mk/omf-scrollkeeper.mk</code>
instead of rarian's <code class="filename">buildlink3.mk</code> file. This
takes care of rebuilding the scrollkeeper database at
installation and deinstallation time, and disallows any access
to it directly from the package.</p></li>
<li class="listitem"><p>Check the PLIST and remove any entries under the
<code class="filename">libdata/scrollkeeper</code> directory, as they
will be handled automatically.</p></li>
<li class="listitem"><p>Remove the <code class="filename">share/omf</code> directory from
the PLIST. It will be handled by rarian. (<span class="command"><strong>make
print-PLIST</strong></span> does this automatically.)</p></li>
</ol></div>
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="x11-fonts"></a>21.6.11. Packages installing X11 fonts</h3></div></div></div>
<a name="x11-fonts"></a>21.6.9. Packages installing X11 fonts</h3></div></div></div>
<p>If a package installs font files, you will need to rebuild
the fonts database in the directory where they get installed at
installation and deinstallation time. This can be automatically
@ -9177,35 +9113,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="gtk2-modules"></a>21.6.12. Packages installing GTK2 modules</h3></div></div></div>
<p>If a package installs GTK2 immodules or loaders, you need to
take some extra steps to get them registered in the GTK2 database
properly:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>Include
<code class="filename">../../x11/gtk2/modules.mk</code> instead of its
<code class="filename">buildlink3.mk</code> file. This takes care of
rebuilding the database at installation and deinstallation time.</p></li>
<li class="listitem"><p>Set <code class="varname">GTK2_IMMODULES=YES</code> if
your package installs GTK2 immodules.</p></li>
<li class="listitem"><p>Set <code class="varname">GTK2_LOADERS=YES</code> if your package installs
GTK2 loaders.</p></li>
<li class="listitem">
<p>Patch the package to not touch any of the GTK2
databases directly. These are:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p><code class="filename">libdata/gtk-2.0/gdk-pixbuf.loaders</code></p></li>
<li class="listitem"><p><code class="filename">libdata/gtk-2.0/gtk.immodules</code></p></li>
</ul></div>
</li>
<li class="listitem"><p>Check the <code class="filename">PLIST</code> and remove
any entries under the <code class="filename">libdata/gtk-2.0</code>
directory, as they will be handled automatically.</p></li>
</ol></div>
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="sgml-xml-data"></a>21.6.13. Packages installing SGML or XML data</h3></div></div></div>
<a name="sgml-xml-data"></a>21.6.10. Packages installing SGML or XML data</h3></div></div></div>
<p>If a package installs SGML or XML data files that need to be
registered in system-wide catalogs (like DTDs, sub-catalogs,
etc.), you need to take some extra steps:</p>
@ -9233,7 +9141,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="mime-database"></a>21.6.14. Packages installing extensions to the MIME database</h3></div></div></div>
<a name="mime-database"></a>21.6.11. Packages installing extensions to the MIME database</h3></div></div></div>
<p>If a package provides extensions to the MIME database by
installing <code class="filename">.xml</code> files inside
<code class="filename">${PREFIX}/share/mime/packages</code>, you
@ -9263,7 +9171,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="intltool"></a>21.6.15. Packages using intltool</h3></div></div></div>
<a name="intltool"></a>21.6.12. Packages using intltool</h3></div></div></div>
<p>If a package uses intltool during its build, add
<code class="literal">intltool</code> to the <code class="varname">USE_TOOLS</code>,
which forces it to use the intltool package provided by pkgsrc,
@ -9274,7 +9182,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="startup-scripts"></a>21.6.16. Packages installing startup scripts</h3></div></div></div>
<a name="startup-scripts"></a>21.6.13. Packages installing startup scripts</h3></div></div></div>
<p>If a package contains a rc.d script, it won't be copied into
the startup directory by default, but you can enable it, by adding
the option <code class="varname">PKG_RCD_SCRIPTS=YES</code> in
@ -9285,7 +9193,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="tex-packages"></a>21.6.17. Packages installing TeX modules</h3></div></div></div>
<a name="tex-packages"></a>21.6.14. Packages installing TeX modules</h3></div></div></div>
<p>If a package installs TeX packages into the texmf tree,
the <code class="filename">ls-R</code> database of the tree needs to be
updated.</p>
@ -9324,7 +9232,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="emulation-packages"></a>21.6.18. Packages supporting running binaries in
<a name="emulation-packages"></a>21.6.15. Packages supporting running binaries in
emulation</h3></div></div></div>
<p>There are some packages that provide libraries and
executables for running binaries from a one operating system
@ -9341,7 +9249,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="hicolor-theme"></a>21.6.19. Packages installing hicolor theme icons</h3></div></div></div>
<a name="hicolor-theme"></a>21.6.16. Packages installing hicolor icons</h3></div></div></div>
<p>If a package installs images under the
<code class="filename">share/icons/hicolor</code> and/or updates the
<code class="filename">share/icons/hicolor/icon-theme.cache</code>
@ -9363,7 +9271,7 @@ PERL5_PACKLIST= auto/Pg/.packlist
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="desktop-files"></a>21.6.20. Packages installing desktop files</h3></div></div></div>
<a name="desktop-files"></a>21.6.17. Packages installing desktop files</h3></div></div></div>
<p>If a package installs <code class="filename">.desktop</code> files
under <code class="filename">share/applications</code> and these include
MIME information (MimeType key), you need to take extra steps to
@ -9551,25 +9459,21 @@ solution is given. After applying the solution be sure to
</tr></thead>
<tbody>
<tr>
<td>Installs OMF files under <code class="filename">share/omf</code>.</td>
<td>See <a class="xref" href="#scrollkeeper-data-files" title="21.6.10. Packages installing scrollkeeper/rarian data files">Section 21.6.10, &#8220;Packages installing scrollkeeper/rarian data files&#8221;</a>.</td>
</tr>
<tr>
<td>Installs icons under the
<code class="filename">share/icons/hicolor</code> hierarchy or updates
<code class="filename">share/icons/hicolor/icon-theme.cache</code>.</td>
<td>See <a class="xref" href="#hicolor-theme" title="21.6.19. Packages installing hicolor theme icons">Section 21.6.19, &#8220;Packages installing hicolor theme icons&#8221;</a>.</td>
<td>See <a class="xref" href="#hicolor-theme" title="21.6.16. Packages installing hicolor icons">Section 21.6.16, &#8220;Packages installing hicolor icons&#8221;</a>.</td>
</tr>
<tr>
<td>Installs files under
<code class="filename">share/mime/packages</code>.</td>
<td>See <a class="xref" href="#mime-database" title="21.6.14. Packages installing extensions to the MIME database">Section 21.6.14, &#8220;Packages installing extensions to the MIME database&#8221;</a>.</td>
<td>See <a class="xref" href="#mime-database" title="21.6.11. Packages installing extensions to the MIME database">Section 21.6.11, &#8220;Packages installing extensions to the MIME database&#8221;</a>.</td>
</tr>
<tr>
<td>Installs <code class="filename">.desktop</code> files under
<code class="filename">share/applications</code> and these include MIME
information.</td>
<td>See <a class="xref" href="#desktop-files" title="21.6.20. Packages installing desktop files">Section 21.6.20, &#8220;Packages installing desktop files&#8221;</a>.</td>
<td>See <a class="xref" href="#desktop-files" title="21.6.17. Packages installing desktop files">Section 21.6.17, &#8220;Packages installing desktop files&#8221;</a>.</td>
</tr>
</tbody>
</table></div>

View file

@ -329,7 +329,7 @@ II. The pkgsrc developer's guide
21.4.1. C, C++, and Fortran
21.4.2. Java
21.4.3. Packages containing perl scripts
21.4.3. Packages containing Perl scripts
21.4.4. Packages containing shell scripts
21.4.5. Other programming languages
@ -348,21 +348,18 @@ II. The pkgsrc developer's guide
21.6.3. Installing highscore files
21.6.4. Adding DESTDIR support to packages
21.6.5. Packages with hardcoded paths to other interpreters
21.6.6. Packages installing perl modules
21.6.6. Packages installing Perl modules
21.6.7. Packages installing info files
21.6.8. Packages installing man pages
21.6.9. Packages installing GConf data files
21.6.10. Packages installing scrollkeeper/rarian data files
21.6.11. Packages installing X11 fonts
21.6.12. Packages installing GTK2 modules
21.6.13. Packages installing SGML or XML data
21.6.14. Packages installing extensions to the MIME database
21.6.15. Packages using intltool
21.6.16. Packages installing startup scripts
21.6.17. Packages installing TeX modules
21.6.18. Packages supporting running binaries in emulation
21.6.19. Packages installing hicolor theme icons
21.6.20. Packages installing desktop files
21.6.9. Packages installing X11 fonts
21.6.10. Packages installing SGML or XML data
21.6.11. Packages installing extensions to the MIME database
21.6.12. Packages using intltool
21.6.13. Packages installing startup scripts
21.6.14. Packages installing TeX modules
21.6.15. Packages supporting running binaries in emulation
21.6.16. Packages installing hicolor icons
21.6.17. Packages installing desktop files
21.7. Marking packages as having problems
@ -2831,7 +2828,7 @@ Table of Contents
21.4.1. C, C++, and Fortran
21.4.2. Java
21.4.3. Packages containing perl scripts
21.4.3. Packages containing Perl scripts
21.4.4. Packages containing shell scripts
21.4.5. Other programming languages
@ -2850,21 +2847,18 @@ Table of Contents
21.6.3. Installing highscore files
21.6.4. Adding DESTDIR support to packages
21.6.5. Packages with hardcoded paths to other interpreters
21.6.6. Packages installing perl modules
21.6.6. Packages installing Perl modules
21.6.7. Packages installing info files
21.6.8. Packages installing man pages
21.6.9. Packages installing GConf data files
21.6.10. Packages installing scrollkeeper/rarian data files
21.6.11. Packages installing X11 fonts
21.6.12. Packages installing GTK2 modules
21.6.13. Packages installing SGML or XML data
21.6.14. Packages installing extensions to the MIME database
21.6.15. Packages using intltool
21.6.16. Packages installing startup scripts
21.6.17. Packages installing TeX modules
21.6.18. Packages supporting running binaries in emulation
21.6.19. Packages installing hicolor theme icons
21.6.20. Packages installing desktop files
21.6.9. Packages installing X11 fonts
21.6.10. Packages installing SGML or XML data
21.6.11. Packages installing extensions to the MIME database
21.6.12. Packages using intltool
21.6.13. Packages installing startup scripts
21.6.14. Packages installing TeX modules
21.6.15. Packages supporting running binaries in emulation
21.6.16. Packages installing hicolor icons
21.6.17. Packages installing desktop files
21.7. Marking packages as having problems
@ -6039,7 +6033,7 @@ Table of Contents
21.4.1. C, C++, and Fortran
21.4.2. Java
21.4.3. Packages containing perl scripts
21.4.3. Packages containing Perl scripts
21.4.4. Packages containing shell scripts
21.4.5. Other programming languages
@ -6058,21 +6052,18 @@ Table of Contents
21.6.3. Installing highscore files
21.6.4. Adding DESTDIR support to packages
21.6.5. Packages with hardcoded paths to other interpreters
21.6.6. Packages installing perl modules
21.6.6. Packages installing Perl modules
21.6.7. Packages installing info files
21.6.8. Packages installing man pages
21.6.9. Packages installing GConf data files
21.6.10. Packages installing scrollkeeper/rarian data files
21.6.11. Packages installing X11 fonts
21.6.12. Packages installing GTK2 modules
21.6.13. Packages installing SGML or XML data
21.6.14. Packages installing extensions to the MIME database
21.6.15. Packages using intltool
21.6.16. Packages installing startup scripts
21.6.17. Packages installing TeX modules
21.6.18. Packages supporting running binaries in emulation
21.6.19. Packages installing hicolor theme icons
21.6.20. Packages installing desktop files
21.6.9. Packages installing X11 fonts
21.6.10. Packages installing SGML or XML data
21.6.11. Packages installing extensions to the MIME database
21.6.12. Packages using intltool
21.6.13. Packages installing startup scripts
21.6.14. Packages installing TeX modules
21.6.15. Packages supporting running binaries in emulation
21.6.16. Packages installing hicolor icons
21.6.17. Packages installing desktop files
21.7. Marking packages as having problems
@ -7013,9 +7004,9 @@ variables:
implementation dependency. It may be used to set JAVA_HOME to a good value
if the program needs this variable to be defined.
21.4.3. Packages containing perl scripts
21.4.3. Packages containing Perl scripts
If your package contains interpreted perl scripts, add "perl" to the USE_TOOLS
If your package contains interpreted Perl scripts, add "perl" to the USE_TOOLS
variable and set REPLACE_PERL to ensure that the proper interpreter path is
set. REPLACE_PERL should contain a list of scripts, relative to WRKSRC, that
you want adjusted. Every occurrence of */bin/perl in a she-bang line will be
@ -7024,7 +7015,7 @@ replaced with the full path to the perl executable.
If a particular version of perl is needed, set the PERL5_REQD variable to the
version number. The default is "5.0".
See Section 21.6.6, "Packages installing perl modules" for information about
See Section 21.6.6, "Packages installing Perl modules" for information about
handling perl modules.
21.4.4. Packages containing shell scripts
@ -7394,7 +7385,7 @@ as root ("destdir") or the package can install as non-root user ("user-destdir"
21.6.5. Packages with hardcoded paths to other interpreters
Your package may also contain scripts with hardcoded paths to other
interpreters besides (or as well as) perl. To correct the full pathname to the
interpreters besides (or as well as) Perl. To correct the full pathname to the
script interpreter, you need to set the following definitions in your Makefile
(we shall use tclsh in this example):
@ -7408,7 +7399,7 @@ Note
Before March 2006, these variables were called _REPLACE.* and _REPLACE_FILES.*.
21.6.6. Packages installing perl modules
21.6.6. Packages installing Perl modules
Makefiles of packages providing perl5 modules should include the Makefile
fragment ../../lang/perl5/module.mk. It provides a do-configure target for the
@ -7495,50 +7486,7 @@ use of --mandir, you can set GNU_CONFIGURE_MANDIR as needed.
See Section 19.5, "Man page compression" for information on installation of
compressed manual pages.
21.6.9. Packages installing GConf data files
If a package installs .schemas or .entries files, used by GConf, you need to
take some extra steps to make sure they get registered in the database:
1. Include ../../devel/GConf/schemas.mk instead of its buildlink3.mk file.
This takes care of rebuilding the GConf database at installation and
deinstallation time, and tells the package where to install GConf data
files using some standard configure arguments. It also disallows any access
to the database directly from the package.
2. Ensure that the package installs its .schemas files under ${PREFIX}/share/
gconf/schemas. If they get installed under ${PREFIX}/etc, you will need to
manually patch the package.
3. Check the PLIST and remove any entries under the etc/gconf directory, as
they will be handled automatically. See Section 10.13, "How do I change the
location of configuration files?" for more information.
4. Define the GCONF_SCHEMAS variable in your Makefile with a list of all
.schemas files installed by the package, if any. Names must not contain any
directories in them.
5. Define the GCONF_ENTRIES variable in your Makefile with a list of all
.entries files installed by the package, if any. Names must not contain any
directories in them.
21.6.10. Packages installing scrollkeeper/rarian data files
If a package installs .omf files, used by scrollkeeper/rarian, you need to take
some extra steps to make sure they get registered in the database:
1. Include ../../mk/omf-scrollkeeper.mk instead of rarian's buildlink3.mk
file. This takes care of rebuilding the scrollkeeper database at
installation and deinstallation time, and disallows any access to it
directly from the package.
2. Check the PLIST and remove any entries under the libdata/scrollkeeper
directory, as they will be handled automatically.
3. Remove the share/omf directory from the PLIST. It will be handled by
rarian. (make print-PLIST does this automatically.)
21.6.11. Packages installing X11 fonts
21.6.9. Packages installing X11 fonts
If a package installs font files, you will need to rebuild the fonts database
in the directory where they get installed at installation and deinstallation
@ -7552,30 +7500,7 @@ Note that you should not create new directories for fonts; instead use the
standard ones to avoid that the user needs to manually configure his X server
to find them.
21.6.12. Packages installing GTK2 modules
If a package installs GTK2 immodules or loaders, you need to take some extra
steps to get them registered in the GTK2 database properly:
1. Include ../../x11/gtk2/modules.mk instead of its buildlink3.mk file. This
takes care of rebuilding the database at installation and deinstallation
time.
2. Set GTK2_IMMODULES=YES if your package installs GTK2 immodules.
3. Set GTK2_LOADERS=YES if your package installs GTK2 loaders.
4. Patch the package to not touch any of the GTK2 databases directly. These
are:
+ libdata/gtk-2.0/gdk-pixbuf.loaders
+ libdata/gtk-2.0/gtk.immodules
5. Check the PLIST and remove any entries under the libdata/gtk-2.0 directory,
as they will be handled automatically.
21.6.13. Packages installing SGML or XML data
21.6.10. Packages installing SGML or XML data
If a package installs SGML or XML data files that need to be registered in
system-wide catalogs (like DTDs, sub-catalogs, etc.), you need to take some
@ -7601,7 +7526,7 @@ extra steps:
(specifically, arguments recognized by the 'add' action). Note that you
will normally not use this variable.
21.6.14. Packages installing extensions to the MIME database
21.6.11. Packages installing extensions to the MIME database
If a package provides extensions to the MIME database by installing .xml files
inside ${PREFIX}/share/mime/packages, you need to take some extra steps to
@ -7622,7 +7547,7 @@ ensure that the database is kept consistent with respect to these new files:
3. Remove any share/mime/* directories from the PLIST. They will be handled by
the shared-mime-info package.
21.6.15. Packages using intltool
21.6.12. Packages using intltool
If a package uses intltool during its build, add intltool to the USE_TOOLS,
which forces it to use the intltool package provided by pkgsrc, instead of the
@ -7632,7 +7557,7 @@ This tracks intltool's build-time dependencies and uses the latest available
version; this way, the package benefits of any bug fixes that may have appeared
since it was released.
21.6.16. Packages installing startup scripts
21.6.13. Packages installing startup scripts
If a package contains a rc.d script, it won't be copied into the startup
directory by default, but you can enable it, by adding the option
@ -7640,7 +7565,7 @@ PKG_RCD_SCRIPTS=YES in mk.conf. This option will copy the scripts into /etc/
rc.d when a package is installed, and it will automatically remove the scripts
when the package is deinstalled.
21.6.17. Packages installing TeX modules
21.6.14. Packages installing TeX modules
If a package installs TeX packages into the texmf tree, the ls-R database of
the tree needs to be updated.
@ -7666,7 +7591,7 @@ into ${PREFIX}/share/texmf-dist, not ${PREFIX}/share/texmf.
3. Make sure that none of ls-R databases are included in PLIST, as they will
be removed only by the kpathsea package.
21.6.18. Packages supporting running binaries in emulation
21.6.15. Packages supporting running binaries in emulation
There are some packages that provide libraries and executables for running
binaries from a one operating system on a different one (if the latter supports
@ -7680,7 +7605,7 @@ linker. Since the standard dynamic linker is run, this fails for emulation
packages, because the libraries used by the emulation are not in the standard
directories.
21.6.19. Packages installing hicolor theme icons
21.6.16. Packages installing hicolor icons
If a package installs images under the share/icons/hicolor and/or updates the
share/icons/hicolor/icon-theme.cache database, you need to take some extra
@ -7697,7 +7622,7 @@ that the cache database is rebuilt:
The best way to verify that the PLIST is correct with respect to the last two
points is to regenerate it using make print-PLIST.
21.6.20. Packages installing desktop files
21.6.17. Packages installing desktop files
If a package installs .desktop files under share/applications and these include
MIME information (MimeType key), you need to take extra steps to ensure that
@ -7848,19 +7773,15 @@ Table 22.1. PLIST handling for GNOME packages
+-----------------------------------------------------------------------------+
| If the package... | Then... |
|-------------------------------------------+---------------------------------|
| |See Section 21.6.10, "Packages |
|Installs OMF files under share/omf. |installing scrollkeeper/rarian |
| |data files". |
|-------------------------------------------+---------------------------------|
|Installs icons under the share/icons/ |See Section 21.6.19, "Packages |
|hicolor hierarchy or updates share/icons/ |installing hicolor theme icons". |
|Installs icons under the share/icons/ |See Section 21.6.16, "Packages |
|hicolor hierarchy or updates share/icons/ |installing hicolor icons". |
|hicolor/icon-theme.cache. | |
|-------------------------------------------+---------------------------------|
| |See Section 21.6.14, "Packages |
| |See Section 21.6.11, "Packages |
|Installs files under share/mime/packages. |installing extensions to the MIME|
| |database". |
|-------------------------------------------+---------------------------------|
|Installs .desktop files under share/ |See Section 21.6.20, "Packages |
|Installs .desktop files under share/ |See Section 21.6.17, "Packages |
|applications and these include MIME |installing desktop files". |
|information. | |
+-----------------------------------------------------------------------------+