diff options
author | mishka <mishka@pkgsrc.org> | 2009-03-20 15:14:07 +0000 |
---|---|---|
committer | mishka <mishka@pkgsrc.org> | 2009-03-20 15:14:07 +0000 |
commit | a0e17fb7790dbccf656de4c2ced7205a3bd13586 (patch) | |
tree | 2a14e69d74546337950b338ce99f32b1d45d794e /doc/pkgsrc.html | |
parent | 153de4e0d02c7d2a93e80c63a60800a6c660a880 (diff) | |
download | pkgsrc-a0e17fb7790dbccf656de4c2ced7205a3bd13586.tar.gz |
Regen.
Diffstat (limited to 'doc/pkgsrc.html')
-rw-r--r-- | doc/pkgsrc.html | 70 |
1 files changed, 49 insertions, 21 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html index eb052d43f46..1ee25bf722a 100644 --- a/doc/pkgsrc.html +++ b/doc/pkgsrc.html @@ -366,7 +366,7 @@ builds)</a></span></dt> <dt><span class="sect2"><a href="#faq.info-files">19.6.7. Packages installing info files</a></span></dt> <dt><span class="sect2"><a href="#manpages">19.6.8. Packages installing man pages</a></span></dt> <dt><span class="sect2"><a href="#gconf-data-files">19.6.9. Packages installing GConf data files</a></span></dt> -<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper data files</a></span></dt> +<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt> <dt><span class="sect2"><a href="#x11-fonts">19.6.11. Packages installing X11 fonts</a></span></dt> <dt><span class="sect2"><a href="#gtk2-modules">19.6.12. Packages installing GTK2 modules</a></span></dt> <dt><span class="sect2"><a href="#sgml-xml-data">19.6.13. Packages installing SGML or XML data</a></span></dt> @@ -3854,7 +3854,7 @@ anymore, you can remove that file and run <span class="command"><strong>cvs -q u <dt><span class="sect2"><a href="#faq.info-files">19.6.7. Packages installing info files</a></span></dt> <dt><span class="sect2"><a href="#manpages">19.6.8. Packages installing man pages</a></span></dt> <dt><span class="sect2"><a href="#gconf-data-files">19.6.9. Packages installing GConf data files</a></span></dt> -<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper data files</a></span></dt> +<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt> <dt><span class="sect2"><a href="#x11-fonts">19.6.11. Packages installing X11 fonts</a></span></dt> <dt><span class="sect2"><a href="#gtk2-modules">19.6.12. Packages installing GTK2 modules</a></span></dt> <dt><span class="sect2"><a href="#sgml-xml-data">19.6.13. Packages installing SGML or XML data</a></span></dt> @@ -5307,6 +5307,33 @@ PLIST_SUBST+= SOMEVAR="somevalue" <p>This replaces all occurrences of “<span class="quote">${SOMEVAR}</span>” in the <code class="filename">PLIST</code> with “<span class="quote">somevalue</span>”.</p> +<p>The <code class="varname">PLIST_VARS</code> can be used to simplify + the common case of conditionally including some + <code class="filename">PLIST</code> entries. It can be done by adding + <code class="literal"><code class="varname">PLIST_VARS</code>+=foo</code> and + setting the coresponding <code class="varname">PLIST.foo</code> variable + to <code class="literal">yes</code>, if the entry should be included. + This will substitute “<span class="quote"><code class="varname">${PLIST.foo}</code></span>” + in the <code class="filename">PLIST</code> with either + “<span class="quote"><code class="literal">""</code></span>” or + “<span class="quote"><code class="literal">"@comment "</code></span>”. + For example, in <code class="filename">Makefile</code>:</p> +<pre class="programlisting"> +PLIST_VARS+= foo +.if <em class="replaceable"><code>condition</code></em> +PLIST.foo= yes +.else + </pre> +<p>And then in <code class="filename">PLIST</code>:</p> +<pre class="programlisting"> +@comment $NetBSD$ +bin/bar +man/man1/bar.1 +${PLIST.foo}bin/foo +${PLIST.foo}man/man1/foo.1 +${PLIST.foo}share/bar/foo.data +${PLIST.foo}@dirrm share/bar + </pre> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> @@ -7634,7 +7661,7 @@ TOOLS_PLATFORM.true?= true # shell builtin <tbody> <tr class="question"> <td align="left" valign="top"> -<a name="tools.new"></a><a name="id52054999"></a><p><b>18.4.1.</b></p> +<a name="tools.new"></a><a name="id1168230286379"></a><p><b>18.4.1.</b></p> </td> <td align="left" valign="top"><p>How do I add a new tool?</p></td> </tr> @@ -7644,7 +7671,7 @@ TOOLS_PLATFORM.true?= true # shell builtin </tr> <tr class="question"> <td align="left" valign="top"> -<a name="tools.listall"></a><a name="id52055008"></a><p><b>18.4.2.</b></p> +<a name="tools.listall"></a><a name="id1168230286388"></a><p><b>18.4.2.</b></p> </td> <td align="left" valign="top"><p>How do I get a list of all available tools?</p></td> @@ -7655,7 +7682,7 @@ TOOLS_PLATFORM.true?= true # shell builtin </tr> <tr class="question"> <td align="left" valign="top"> -<a name="tools.used"></a><a name="id52055016"></a><p><b>18.4.3.</b></p> +<a name="tools.used"></a><a name="id1168230286396"></a><p><b>18.4.3.</b></p> </td> <td align="left" valign="top"><p>How can I get a list of all the tools that a package is using while being built? I want to know whether it @@ -7728,7 +7755,7 @@ TOOLS_PLATFORM.true?= true # shell builtin <dt><span class="sect2"><a href="#faq.info-files">19.6.7. Packages installing info files</a></span></dt> <dt><span class="sect2"><a href="#manpages">19.6.8. Packages installing man pages</a></span></dt> <dt><span class="sect2"><a href="#gconf-data-files">19.6.9. Packages installing GConf data files</a></span></dt> -<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper data files</a></span></dt> +<dt><span class="sect2"><a href="#scrollkeeper-data-files">19.6.10. Packages installing scrollkeeper/rarian data files</a></span></dt> <dt><span class="sect2"><a href="#x11-fonts">19.6.11. Packages installing X11 fonts</a></span></dt> <dt><span class="sect2"><a href="#gtk2-modules">19.6.12. Packages installing GTK2 modules</a></span></dt> <dt><span class="sect2"><a href="#sgml-xml-data">19.6.13. Packages installing SGML or XML data</a></span></dt> @@ -9098,14 +9125,14 @@ PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/Pg/.packlist </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="scrollkeeper-data-files"></a>19.6.10. Packages installing scrollkeeper data files</h3></div></div></div> +<a name="scrollkeeper-data-files"></a>19.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, you need to take some extra steps to make sure they + scrollkeeper/rarian, you need to take some extra steps to make sure they get registered in the database:</p> <div class="orderedlist"><ol type="1"> <li><p>Include - <code class="filename">../../textproc/rarian/omf.mk</code> - instead of its <code class="filename">buildlink3.mk</code> file. This + <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> @@ -9113,7 +9140,8 @@ PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/Pg/.packlist <code class="filename">libdata/scrollkeeper</code> directory, as they will be handled automatically.</p></li> <li><p>Remove the <code class="filename">share/omf</code> directory from - the PLIST. It will be handled by scrollkeeper.</p></li> + 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" lang="en"> @@ -9666,7 +9694,7 @@ do?</a> <tbody> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.makeflags"></a><a name="id52059900"></a><p><b>22.1.</b></p> +<a name="devfaq.makeflags"></a><a name="id1168230291165"></a><p><b>22.1.</b></p> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and @@ -9682,7 +9710,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.make"></a><a name="id52059936"></a><p><b>22.2.</b></p> +<a name="devfaq.make"></a><a name="id1168230291198"></a><p><b>22.2.</b></p> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and @@ -9700,7 +9728,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.cc"></a><a name="id52059974"></a><p><b>22.3.</b></p> +<a name="devfaq.cc"></a><a name="id1168230291236"></a><p><b>22.3.</b></p> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and @@ -9718,7 +9746,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.bl3flags"></a><a name="id52060009"></a><p><b>22.4.</b></p> +<a name="devfaq.bl3flags"></a><a name="id1168230291270"></a><p><b>22.4.</b></p> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">BUILDLINK_LDFLAGS</code>, @@ -9731,7 +9759,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.bl3prefix"></a><a name="id52060097"></a><p><b>22.5.</b></p> +<a name="devfaq.bl3prefix"></a><a name="id1168230291289"></a><p><b>22.5.</b></p> </td> <td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span> @@ -9747,7 +9775,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.master_sites"></a><a name="id52060122"></a><p><b>22.6.</b></p> +<a name="devfaq.master_sites"></a><a name="id1168230291315"></a><p><b>22.6.</b></p> </td> <td align="left" valign="top"><p>What does <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I @@ -9771,7 +9799,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.mailinglists"></a><a name="id52060325"></a><p><b>22.7.</b></p> +<a name="devfaq.mailinglists"></a><a name="id1168230291450"></a><p><b>22.7.</b></p> </td> <td align="left" valign="top"><p>Which mailing lists are there for package developers?</p></td> @@ -9796,7 +9824,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.documentation"></a><a name="id52060359"></a><p><b>22.8.</b></p> +<a name="devfaq.documentation"></a><a name="id1168230291481"></a><p><b>22.8.</b></p> </td> <td align="left" valign="top"><p>Where is the pkgsrc documentation?</p></td> @@ -9844,7 +9872,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.too-much-time"></a><a name="id52060413"></a><p><b>22.9.</b></p> +<a name="devfaq.too-much-time"></a><a name="id1168230291536"></a><p><b>22.9.</b></p> </td> <td align="left" valign="top"><p>I have a little time to kill. What shall I do?</p></td> @@ -10027,7 +10055,7 @@ solution is given. After applying the solution be sure to <tbody> <tr> <td>Installs OMF files under <code class="filename">share/omf</code>.</td> -<td>See <a class="xref" href="#scrollkeeper-data-files" title="19.6.10. Packages installing scrollkeeper data files">Section 19.6.10, “Packages installing scrollkeeper data files”</a>.</td> +<td>See <a class="xref" href="#scrollkeeper-data-files" title="19.6.10. Packages installing scrollkeeper/rarian data files">Section 19.6.10, “Packages installing scrollkeeper/rarian data files”</a>.</td> </tr> <tr> <td>Installs icons under the |