diff options
-rw-r--r-- | doc/pkgsrc.html | 51 | ||||
-rw-r--r-- | doc/pkgsrc.txt | 40 |
2 files changed, 60 insertions, 31 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html index 9df1e667a31..02e837894e4 100644 --- a/doc/pkgsrc.html +++ b/doc/pkgsrc.html @@ -3,7 +3,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>The pkgsrc guide</title> -<link rel="stylesheet" href="/NetBSD.css" type="text/css"> +<link rel="stylesheet" href="/global.css" type="text/css"> <meta name="generator" content="DocBook XSL Stylesheets VX.X.X"> <meta name="description" content="pkgsrc is a centralized package management system for Unix-like operating systems. This guide provides information for users and developers of pkgsrc. It covers installation of binary and source packages, creation of binary and source packages and a high-level overview about the infrastructure."> </head> @@ -964,6 +964,23 @@ release=pkgsrc <code class="prompt">$</code> <strong class="userinput"><code>CVS_RSH="ssh"</code></strong> <code class="prompt">$</code> <strong class="userinput"><code>export CVSROOT CVS_RSH</code></strong> </pre> +<p>By default, cvs doesn't do things like most people would + expect it to do, and this is unlikely to change. But there is a + way to convince cvs, by creating a file called + <code class="filename">.cvsrc</code> in your home directory and saving + the following lines to it. This file will save you lots of + headache and some bug reports, so we strongly recommend it. You + can find an explanation of this file in the CVS + documentation.</p> +<pre class="programlisting"> +# recommended CVS configuration file from the pkgsrc guide +checkout -P +update -d +release -d +diff -up +cvs -q -z3 +rdiff -u +</pre> <p>Then, you change to the directory where you want to have your copy of pkgsrc. In most cases this is <code class="filename">/usr</code>. In that directory you run the @@ -4498,6 +4515,8 @@ converters games mbone print x11 maintainer. This benefits non-pkgsrc users of the package, and usually makes it possible to remove the patch in future version.</p> +<p>The file names of the patch files are usually of the form + <code class="filename">patch-<em class="replaceable"><code>[a-z][a-z]</code></em></code>.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> @@ -7516,7 +7535,7 @@ TOOLS_PLATFORM.true?= true # shell builtin <tbody> <tr class="question"> <td align="left" valign="top"> -<a name="tools.new"></a><a name="id2707841"></a><b>17.4.1.</b> +<a name="tools.new"></a><a name="id2708068"></a><b>17.4.1.</b> </td> <td align="left" valign="top"><p>How do I add a new tool?</p></td> </tr> @@ -7526,7 +7545,7 @@ TOOLS_PLATFORM.true?= true # shell builtin </tr> <tr class="question"> <td align="left" valign="top"> -<a name="tools.listall"></a><a name="id2707850"></a><b>17.4.2.</b> +<a name="tools.listall"></a><a name="id2708077"></a><b>17.4.2.</b> </td> <td align="left" valign="top"><p>How do I get a list of all available tools?</p></td> @@ -7537,7 +7556,7 @@ TOOLS_PLATFORM.true?= true # shell builtin </tr> <tr class="question"> <td align="left" valign="top"> -<a name="tools.used"></a><a name="id2707861"></a><b>17.4.3.</b> +<a name="tools.used"></a><a name="id2708088"></a><b>17.4.3.</b> </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 @@ -9519,7 +9538,7 @@ do?</a> <tbody> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.makeflags"></a><a name="id2713470"></a><b>21.1.</b> +<a name="devfaq.makeflags"></a><a name="id2713629"></a><b>21.1.</b> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and @@ -9535,7 +9554,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.make"></a><a name="id2713509"></a><b>21.2.</b> +<a name="devfaq.make"></a><a name="id2713804"></a><b>21.2.</b> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and @@ -9553,7 +9572,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.cc"></a><a name="id2713549"></a><b>21.3.</b> +<a name="devfaq.cc"></a><a name="id2713845"></a><b>21.3.</b> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and @@ -9571,7 +9590,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.bl3flags"></a><a name="id2713589"></a><b>21.4.</b> +<a name="devfaq.bl3flags"></a><a name="id2713884"></a><b>21.4.</b> </td> <td align="left" valign="top"><p>What is the difference between <code class="varname">BUILDLINK_LDFLAGS</code>, @@ -9584,7 +9603,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.bl3prefix"></a><a name="id2713677"></a><b>21.5.</b> +<a name="devfaq.bl3prefix"></a><a name="id2713905"></a><b>21.5.</b> </td> <td align="left" valign="top"><p>Why does <span><strong class="command">make show-var VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span> @@ -9600,7 +9619,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.master_sites"></a><a name="id2713707"></a><b>21.6.</b> +<a name="devfaq.master_sites"></a><a name="id2713934"></a><b>21.6.</b> </td> <td align="left" valign="top"><p>What does <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I @@ -9624,7 +9643,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.mailinglists"></a><a name="id2713784"></a><b>21.7.</b> +<a name="devfaq.mailinglists"></a><a name="id2714011"></a><b>21.7.</b> </td> <td align="left" valign="top"><p>Which mailing lists are there for package developers?</p></td> @@ -9649,7 +9668,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.documentation"></a><a name="id2713822"></a><b>21.8.</b> +<a name="devfaq.documentation"></a><a name="id2714050"></a><b>21.8.</b> </td> <td align="left" valign="top"><p>Where is the pkgsrc documentation?</p></td> @@ -9697,7 +9716,7 @@ do?</a> </tr> <tr class="question"> <td align="left" valign="top"> -<a name="devfaq.too-much-time"></a><a name="id2713953"></a><b>21.9.</b> +<a name="devfaq.too-much-time"></a><a name="id2714180"></a><b>21.9.</b> </td> <td align="left" valign="top"><p>I have a little time to kill. What shall I do?</p></td> @@ -10931,10 +10950,10 @@ source packages</h2></div></div></div> <div class="itemizedlist"><ul type="disc"> <li><p><code class="filename">pkgsrc/doc/pkgsrc.txt</code></p></li> <li><p><code class="filename">pkgsrc/doc/pkgsrc.html</code></p></li> -<li><p><a href="http://www.NetBSD.org/Documentation/pkgsrc/" target="_top">http://www.NetBSD.org/Documentation/pkgsrc/</a></p></li> -<li><p><a href="http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.pdf" target="_top">http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.pdf</a>: +<li><p><a href="http://www.NetBSD.org/docs/pkgsrc/" target="_top">http://www.NetBSD.org/docs/pkgsrc/</a></p></li> +<li><p><a href="http://www.NetBSD.org/docs/pkgsrc/pkgsrc.pdf" target="_top">http://www.NetBSD.org/docs/pkgsrc/pkgsrc.pdf</a>: The PDF version of the pkgsrc guide.</p></li> -<li><p><a href="http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.ps" target="_top">http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.ps</a>: +<li><p><a href="http://www.NetBSD.org/docs/pkgsrc/pkgsrc.ps" target="_top">http://www.NetBSD.org/docs/pkgsrc/pkgsrc.ps</a>: PostScript version of the pkgsrc guide.</p></li> </ul></div> </div> diff --git a/doc/pkgsrc.txt b/doc/pkgsrc.txt index f637dabef5e..1a7e54dfed4 100644 --- a/doc/pkgsrc.txt +++ b/doc/pkgsrc.txt @@ -854,6 +854,21 @@ Or, the same for the bourne shell: $ CVS_RSH="ssh" $ export CVSROOT CVS_RSH +By default, cvs doesn't do things like most people would expect it to do, and +this is unlikely to change. But there is a way to convince cvs, by creating a +file called .cvsrc in your home directory and saving the following lines to it. +This file will save you lots of headache and some bug reports, so we strongly +recommend it. You can find an explanation of this file in the CVS +documentation. + +# recommended CVS configuration file from the pkgsrc guide +checkout -P +update -d +release -d +diff -up +cvs -q -z3 +rdiff -u + Then, you change to the directory where you want to have your copy of pkgsrc. In most cases this is /usr. In that directory you run the checkout command, which is cvs -q checkout -P pkgsrc for the current branch and cvs -q checkout @@ -1433,7 +1448,6 @@ with the OpenBSD userland tools. There are several steps: .endif - 3.3.7. Solaris Solaris 2.6 through 9 are supported on both x86 and sparc. You will need a @@ -1854,7 +1868,6 @@ added to help with this. % - If you want to install a binary package that you've either created yourself (see next section), that you put into pkgsrc/packages manually or that is located on a remote FTP server, you can use the "bin-install" target. This @@ -3797,6 +3810,8 @@ enforcing pkgsrc's view of where man pages should go), send the patch as a bug report to the maintainer. This benefits non-pkgsrc users of the package, and usually makes it possible to remove the patch in future version. +The file names of the patch files are usually of the form patch-[a-z][a-z]. + 10.3.3. Sources where the patch files come from If you want to share patches between multiple packages in pkgsrc, e.g. because @@ -3850,12 +3865,10 @@ Table 10.1. Patching examples |configure|netbsd*) have_kvm=yes ;; |AC_CHECK_LIB(kvm, kvm_open, have_kvm=yes, have_kvm=no)| |script |*) have_kvm=no ;; | | | |esac | | -| | | | |---------+--------------------------+------------------------------------------------------| -| |#if defined(__NetBSD__) |#if defined(HAVE_SYS_EVENT_H) | -|C source |# include <sys/event.h> |# include <sys/event.h> | -|file |#endif |#endif | -| | | | +|C source |#if defined(__NetBSD__) |#if defined(HAVE_SYS_EVENT_H) | +|file |# include <sys/event.h> |# include <sys/event.h> | +| |#endif |#endif | |---------+--------------------------+------------------------------------------------------| | |int |int | | |monitor_file(...) |monitor_file(...) | @@ -3867,7 +3880,6 @@ Table 10.1. Patching examples | | ... | ... | | |#endif |#endif | | |} |} | -| | | | +-------------------------------------------------------------------------------------------+ @@ -5066,7 +5078,6 @@ In order to provide system startup scripts, the package has to: RCD_SCRIPTS+= cupsd - Once this is done, pkginstall will do the following steps for each script in an automated fashion: @@ -8026,7 +8037,6 @@ the minimum required tools: CONFIGURE_ARGS+=--with-html-dir=${PREFIX}/share/gtk-doc/... - GNOME uses multiple shared directories and files under the installation prefix to maintain databases. In this context, shared means that those exact same directories and files are used among several different packages, leading to @@ -8947,13 +8957,13 @@ files are created from it: * pkgsrc/doc/pkgsrc.html - * http://www.NetBSD.org/Documentation/pkgsrc/ + * http://www.NetBSD.org/docs/pkgsrc/ - * http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.pdf: The PDF version of - the pkgsrc guide. + * http://www.NetBSD.org/docs/pkgsrc/pkgsrc.pdf: The PDF version of the pkgsrc + guide. - * http://www.NetBSD.org/Documentation/pkgsrc/pkgsrc.ps: PostScript version of - the pkgsrc guide. + * http://www.NetBSD.org/docs/pkgsrc/pkgsrc.ps: PostScript version of the + pkgsrc guide. D.2. Procedure |