pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc doc/pkgsrc.*: regen
details: https://anonhg.NetBSD.org/pkgsrc/rev/bd448df55ffa
branches: trunk
changeset: 454431:bd448df55ffa
user: nia <nia%pkgsrc.org@localhost>
date: Fri Jun 11 15:10:08 2021 +0000
description:
doc/pkgsrc.*: regen
diffstat:
doc/pkgsrc.html | 196 ++++++++++++++-----------------------------------------
doc/pkgsrc.txt | 183 ++++++++++++++-------------------------------------
2 files changed, 102 insertions(+), 277 deletions(-)
diffs (truncated from 697 to 300 lines):
diff -r ae8c2196b837 -r bd448df55ffa doc/pkgsrc.html
--- a/doc/pkgsrc.html Fri Jun 11 15:09:51 2021 +0000
+++ b/doc/pkgsrc.html Fri Jun 11 15:10:08 2021 +0000
@@ -339,7 +339,7 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
<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 @@
</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">“<span class="quote">perl</span>”</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 @@
<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">“<span class="quote">5.0</span>”</span>.</p>
-<p>See <a class="xref" href="#perl-modules" title="21.6.6. Packages installing perl modules">Section 21.6.6, “Packages installing perl modules”</a> for information
+<p>See <a class="xref" href="#perl-modules" title="21.6.6. Packages installing Perl modules">Section 21.6.6, “Packages installing Perl modules”</a> for information
about handling perl modules.</p>
</div>
<div class="sect2">
@@ -8961,7 +8952,7 @@
<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 @@
</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 @@
</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, “How do I change the location of configuration files?”</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 @@
</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 @@
</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 @@
</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 @@
</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 @@
</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>
Home |
Main Index |
Thread Index |
Old Index