[pkgsrc/trunk]: pkgsrc/doc/guide/files Added a chapter "The implementation of...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/05ef9f8ecf00
branches:  trunk
changeset: 515279:05ef9f8ecf00
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Fri Jun 30 08:58:16 2006 +0000

description:
Added a chapter "The implementation of the bulk builds" that describes
how the bulk builds should look like in the future. It is a design
document and subject to discussion.

diffstat:

 doc/guide/files/Makefile      |   3 +-
 doc/guide/files/chapters.ent  |   3 +-
 doc/guide/files/infr.bulk.xml |  51 +++++++++++++++++++++++++++++++++++++++++++
 doc/guide/files/pkgsrc.xml    |   5 ++-
 4 files changed, 58 insertions(+), 4 deletions(-)

diffs (118 lines):

diff -r 917987878741 -r 05ef9f8ecf00 doc/guide/files/Makefile
--- a/doc/guide/files/Makefile  Fri Jun 30 07:15:30 2006 +0000
+++ b/doc/guide/files/Makefile  Fri Jun 30 08:58:16 2006 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.9 2006/06/01 08:39:03 rillig Exp $
+# $NetBSD: Makefile,v 1.10 2006/06/30 08:58:16 rillig Exp $
 
 WEB_PREFIX?=   ${.CURDIR}/../htdocs
 
@@ -19,6 +19,7 @@
 SRCS+= fixes.xml
 SRCS+= ftp-layout.xml
 SRCS+= getting.xml
+SRCS+= infr.bulk.xml
 SRCS+= infr.design.xml
 SRCS+= introduction.xml
 SRCS+= logs.xml
diff -r 917987878741 -r 05ef9f8ecf00 doc/guide/files/chapters.ent
--- a/doc/guide/files/chapters.ent      Fri Jun 30 07:15:30 2006 +0000
+++ b/doc/guide/files/chapters.ent      Fri Jun 30 08:58:16 2006 +0000
@@ -1,7 +1,7 @@
 <!--
        Creates entities for each chapter in the pkgsrc book.
 
-       $NetBSD: chapters.ent,v 1.12 2006/06/01 08:39:03 rillig Exp $
+       $NetBSD: chapters.ent,v 1.13 2006/06/30 08:58:16 rillig Exp $
 -->
 
 <!ENTITY chap.intro                    SYSTEM "introduction.xml">
@@ -32,6 +32,7 @@
 <!-- The pkgsrc infrastructure -->
 <!ENTITY chap.infr.design              SYSTEM "infr.design.xml">
 <!ENTITY chap.regression               SYSTEM "regression.xml">
+<!ENTITY chap.infr.bulk                        SYSTEM "infr.bulk.xml">
 <!ENTITY chap.porting                  SYSTEM "porting.xml">
 
 <!-- appendix -->
diff -r 917987878741 -r 05ef9f8ecf00 doc/guide/files/infr.bulk.xml
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/guide/files/infr.bulk.xml     Fri Jun 30 08:58:16 2006 +0000
@@ -0,0 +1,51 @@
+<!-- $NetBSD: infr.bulk.xml,v 1.1 2006/06/30 08:58:16 rillig Exp $ -->
+
+<chapter id="infr.bulk">
+<title>The implementation of the pkgsrc bulk builds</title>
+
+<sect1 id="infr.bulk.what">
+<title>Deciding which packages to build</title>
+
+<note><para>This is not yet implemented.</para></note>
+
+       <para>Some of the pkgsrc packages are not usable in a certain
+       build configuration, either because of platform limitations
+       (processor, operating system) or because the build is done by an
+       unprivileged user. This section lists all the conditions that
+       influence whether a package is excluded from a bulk
+       build.</para>
+
+       <itemizedlist>
+
+       <listitem><para><varname>ONLY_FOR_PLATFORM</varname> or
+       <varname>NOT_FOR_PLATFORM</varname> may be defined in the
+       package <filename>Makefile</filename>.</para></listitem>
+
+       <listitem><para><varname>ONLY_FOR_COMPILER</varname> or
+       <varname>NOT_FOR_COMPILER</varname> may be defined in the
+       package <filename>Makefile</filename>.</para></listitem>
+
+       <listitem><para><varname>NOT_FOR_UNPRIVILEGED</varname> (does
+       not exist yet) may be defined in the package
+       <filename>Makefile</filename> (only affects bulk builds in
+       unprivileged mode).</para></listitem>
+
+       <listitem><para><varname>LICENSE</varname> may be defined in the
+       package <filename>Makefile</filename>. This may be overridden by
+       defining <varname>ACCEPTABLE_LICENSES</varname> in
+       <filename>mk.conf</filename>.</para></listitem>
+
+       <listitem><para>The package vulnerability database may list the
+       package as vulnerable. This may be overridden by defining 
+       <varname>ALLOW_VULNERABLE_PACKAGES</varname> in
+       <filename>mk.conf</filename>.</para></listitem>
+
+       <listitem><para>Packages that define
+       <varname>INTERACTIVE_STAGE</varname> cannot be built by the bulk
+       builds, which are by definition
+       non-interactive.</para></listitem>
+
+       </itemizedlist>
+
+</sect1>
+</chapter>
diff -r 917987878741 -r 05ef9f8ecf00 doc/guide/files/pkgsrc.xml
--- a/doc/guide/files/pkgsrc.xml        Fri Jun 30 07:15:30 2006 +0000
+++ b/doc/guide/files/pkgsrc.xml        Fri Jun 30 08:58:16 2006 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: pkgsrc.xml,v 1.19 2006/06/01 08:39:03 rillig Exp $ -->
+<!-- $NetBSD: pkgsrc.xml,v 1.20 2006/06/30 08:58:16 rillig Exp $ -->
 
 
 <?xml version="1.0"?>
@@ -45,7 +45,7 @@
       <holder role="mailto:www%NetBSD.org@localhost";>The NetBSD Foundation, Inc</holder>
     </copyright>
 
-    <pubdate>$NetBSD: pkgsrc.xml,v 1.19 2006/06/01 08:39:03 rillig Exp $</pubdate>
+    <pubdate>$NetBSD: pkgsrc.xml,v 1.20 2006/06/30 08:58:16 rillig Exp $</pubdate>
 
     <abstract>
 
@@ -106,6 +106,7 @@
 
     &chap.infr.design;
     &chap.regression;
+    &chap.infr.bulk;
     &chap.porting;
   </part>