pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc regen.
details: https://anonhg.NetBSD.org/pkgsrc/rev/2f17d825efe3
branches: trunk
changeset: 502283:2f17d825efe3
user: rillig <rillig%pkgsrc.org@localhost>
date: Thu Nov 03 20:46:21 2005 +0000
description:
regen.
diffstat:
doc/pkgsrc.html | 957 +++++++++++++++++++++++++++++++++++++++----------------
doc/pkgsrc.txt | 367 +++++++++++++-------
2 files changed, 911 insertions(+), 413 deletions(-)
diffs (truncated from 1482 to 300 lines):
diff -r 13b9c758a048 -r 2f17d825efe3 doc/pkgsrc.html
--- a/doc/pkgsrc.html Thu Nov 03 20:41:43 2005 +0000
+++ b/doc/pkgsrc.html Thu Nov 03 20:46:21 2005 +0000
@@ -680,14 +680,77 @@
<dd>
<dl>
<dt><span class="sect1"><a href=
- "#build.prefix">14.1. Program
+ "#build.intro">14.1. Introduction</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.prefix">14.2. Program
location</a></span></dt>
<dt><span class="sect1"><a href=
- "#main-targets">14.2. Main targets</a></span></dt>
-
- <dt><span class="sect1"><a href=
- "#build.helpful-targets">14.3. Other helpful
+ "#build.builddirs">14.3. Directories used during
+ the build process</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.running">14.4. Running a
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.fetch">14.5. The <span class=
+ "emphasis"><em>fetch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.checksum">14.6. The <span class=
+ "emphasis"><em>checksum</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.extract">14.7. The <span class=
+ "emphasis"><em>extract</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.patch">14.8. The <span class=
+ "emphasis"><em>patch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.tools">14.9. The <span class=
+ "emphasis"><em>tools</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.wrapper">14.10. The <span class=
+ "emphasis"><em>wrapper</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.configure">14.11. The <span class=
+ "emphasis"><em>configure</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.build">14.12. The <span class=
+ "emphasis"><em>build</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.test">14.13. The <span class=
+ "emphasis"><em>test</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.install">14.14. The <span class=
+ "emphasis"><em>install</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.package">14.15. The <span class=
+ "emphasis"><em>package</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.helpful-targets">14.16. Other helpful
targets</a></span></dt>
</dl>
</dd>
@@ -3892,7 +3955,7 @@
</div>
<p>See <a href="#build.helpful-targets" title=
- "14.3. Other helpful targets">Section 14.3,
+ "14.16. Other helpful targets">Section 14.16,
“Other helpful targets”</a>.</p>
</div>
@@ -5990,14 +6053,72 @@
<dd>
<dl>
- <dt><span class="sect1"><a href="#build.prefix">14.1.
+ <dt><span class="sect1"><a href="#build.intro">14.1.
+ Introduction</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.prefix">14.2.
Program location</a></span></dt>
- <dt><span class="sect1"><a href="#main-targets">14.2.
- Main targets</a></span></dt>
+ <dt><span class="sect1"><a href=
+ "#build.builddirs">14.3. Directories used during the
+ build process</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.running">14.4. Running a
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.fetch">14.5.
+ The <span class="emphasis"><em>fetch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.checksum">14.6. The <span class=
+ "emphasis"><em>checksum</em></span>
+ phase</a></span></dt>
<dt><span class="sect1"><a href=
- "#build.helpful-targets">14.3. Other helpful
+ "#build.extract">14.7. The <span class=
+ "emphasis"><em>extract</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.patch">14.8.
+ The <span class="emphasis"><em>patch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.tools">14.9.
+ The <span class="emphasis"><em>tools</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.wrapper">14.10. The <span class=
+ "emphasis"><em>wrapper</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.configure">14.11. The <span class=
+ "emphasis"><em>configure</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.build">14.12.
+ The <span class="emphasis"><em>build</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.test">14.13.
+ The <span class="emphasis"><em>test</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.install">14.14. The <span class=
+ "emphasis"><em>install</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.package">14.15. The <span class=
+ "emphasis"><em>package</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.helpful-targets">14.16. Other helpful
targets</a></span></dt>
</dl>
</dd>
@@ -7579,7 +7700,7 @@
print-PLIST</strong></span> command to output a PLIST
that matches any new files since the package was
extracted. See <a href="#build.helpful-targets" title=
- "14.3. Other helpful targets">Section 14.3,
+ "14.16. Other helpful targets">Section 14.16,
“Other helpful targets”</a> for more
information on this target.</p>
</div>
@@ -9977,30 +10098,110 @@
<p><b>Table of Contents</b></p>
<dl>
- <dt><span class="sect1"><a href="#build.prefix">14.1.
+ <dt><span class="sect1"><a href="#build.intro">14.1.
+ Introduction</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.prefix">14.2.
Program location</a></span></dt>
- <dt><span class="sect1"><a href="#main-targets">14.2.
- Main targets</a></span></dt>
-
<dt><span class="sect1"><a href=
- "#build.helpful-targets">14.3. Other helpful
+ "#build.builddirs">14.3. Directories used during the
+ build process</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.running">14.4.
+ Running a phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.fetch">14.5.
+ The <span class="emphasis"><em>fetch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.checksum">14.6.
+ The <span class="emphasis"><em>checksum</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.extract">14.7.
+ The <span class="emphasis"><em>extract</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.patch">14.8.
+ The <span class="emphasis"><em>patch</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.tools">14.9.
+ The <span class="emphasis"><em>tools</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.wrapper">14.10.
+ The <span class="emphasis"><em>wrapper</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.configure">14.11. The <span class=
+ "emphasis"><em>configure</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.build">14.12.
+ The <span class="emphasis"><em>build</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.test">14.13.
+ The <span class="emphasis"><em>test</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.install">14.14.
+ The <span class="emphasis"><em>install</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href="#build.package">14.15.
+ The <span class="emphasis"><em>package</em></span>
+ phase</a></span></dt>
+
+ <dt><span class="sect1"><a href=
+ "#build.helpful-targets">14.16. Other helpful
targets</a></span></dt>
</dl>
</div>
- <p>The basic steps for building a program are always the
- same. First the program's source (<span class=
- "emphasis"><em>distfile</em></span>) must be brought to the
- local system and then extracted. After any patches to
- compile properly on NetBSD are applied, the software can be
- configured, then built (usually by compiling), and finally
- the generated binaries, etc. can be put into place on the
- system. These are exactly the steps performed by the NetBSD
- package system, which is implemented as a series of targets
- in a central Makefile, <code xmlns=
- "http://www.w3.org/TR/xhtml1/transitional" class=
- "filename">pkgsrc/mk/bsd.pkg.mk</code>.</p>
+ <div class="sect1" lang="en" xml:lang="en">
+ <div class="titlepage">
+ <div>
+ <div>
+ <h2 class="title" style="clear: both"><a name=
+ "build.intro" id=
+ "build.intro"></a>14.1. Introduction</h2>
+ </div>
+ </div>
+ </div>
+
+ <p>This chapter gives a detailed description on how a
+ package is built. Building a package is separated into
+ different <span class="emphasis"><em>phases</em></span>
+ (for example <code class="varname">fetch</code>,
+ <code class="varname">build</code>, <code class=
+ "varname">install</code>), all of which are described in
+ the following sections. Each phase is splitted into
+ so-called <span class="emphasis"><em>stages</em></span>,
+ which take the name of the containing stage, prefixed by
+ one of <code class="varname">pre-</code>, <code class=
+ "varname">do-</code> or <code class=
+ "varname">post-</code>. (Examples are <code class=
+ "varname">pre-configure</code>, <code class=
+ "varname">post-build</code>.) Most of the actual work is
+ done in the <code class="varname">do-*</code> stages.</p>
+
+ <p>The basic steps for building a program are always the
+ same. First the program's source (<span class=
+ "emphasis"><em>distfile</em></span>) must be brought to
+ the local system and then extracted. After any patches to
+ compile properly on NetBSD are applied, the software can
+ be configured, then built (usually by compiling), and
+ finally the generated binaries, etc. can be put into
Home |
Main Index |
Thread Index |
Old Index