summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2007-07-20 15:21:53 +0000
committerrillig <rillig@pkgsrc.org>2007-07-20 15:21:53 +0000
commit61492d05b05dc21ff613a5011c758ef7c7e32ca2 (patch)
tree9334c5db428765664187bc03e2cf07a37b513c3b /doc
parentde541f9c303c4af620d41c6242f83a7b6c1066c4 (diff)
downloadpkgsrc-61492d05b05dc21ff613a5011c758ef7c7e32ca2.tar.gz
regen
Diffstat (limited to 'doc')
-rw-r--r--doc/pkgsrc.html51
-rw-r--r--doc/pkgsrc.txt40
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
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-25 15:14:25 +0000