[pkgsrc/trunk]: pkgsrc/doc Document OWNER

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/07b6dda30425
branches:  trunk
changeset: 542867:07b6dda30425
user:      abs <abs%pkgsrc.org@localhost>
date:      Thu May 29 08:34:26 2008 +0000

description:
Document OWNER

diffstat:

 doc/Makefile-example           |   4 ++--
 doc/guide/files/components.xml |  26 +++++++++++++++++---------
 doc/guide/files/fixes.xml      |   5 +++--
 3 files changed, 22 insertions(+), 13 deletions(-)

diffs (79 lines):

diff -r c6b6dcb96223 -r 07b6dda30425 doc/Makefile-example
--- a/doc/Makefile-example      Thu May 29 08:34:25 2008 +0000
+++ b/doc/Makefile-example      Thu May 29 08:34:26 2008 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile-example,v 1.16 2008/01/04 19:53:36 heinz Exp $
+# $NetBSD: Makefile-example,v 1.17 2008/05/29 08:34:26 abs Exp $
 
 # First paragraph - distfile and binary package data
 # DISTNAME PKGNAME PKGREVISION SVR4_PKGNAME CATEGORIES MASTER_SITES
@@ -10,7 +10,7 @@
 MASTER_SITES=          ${MASTER_SITE_GNU:=make/}
 #EXTRACT_SUFX=         .tar.bz2        # .tar.gz is the default, only needed in unusual circumstances
 
-# Second paragraph - MAINTAINER, HOMEPAGE and COMMENT
+# Second paragraph - MAINTAINER/OWNER, HOMEPAGE and COMMENT
 MAINTAINER=            pkgsrc-users%NetBSD.org@localhost       # set this to your email address, pkgsrc-users@ is the default
 HOMEPAGE=              http://www.gnu.org/software/make/make.html
 COMMENT=               GNU version of 'make' utility   # start with a capital, no articles at start
diff -r c6b6dcb96223 -r 07b6dda30425 doc/guide/files/components.xml
--- a/doc/guide/files/components.xml    Thu May 29 08:34:25 2008 +0000
+++ b/doc/guide/files/components.xml    Thu May 29 08:34:26 2008 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.38 2008/01/02 14:20:55 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.39 2008/05/29 08:34:26 abs Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
 <title>Package components - files, directories and contents</title>
@@ -96,16 +96,24 @@
   <para>The third section contains the following variables.
   <itemizedlist>
 
-    <listitem><para><varname>MAINTAINER</varname> is the email address
-    of the person who feels responsible for this package, and who is
-    most likely to look at problems or questions regarding this
-    package which have been reported with &man.send-pr.1;. Other
-    developers should contact the <varname>MAINTAINER</varname> before
-    making major changes to the package. When packaging a new program,
-    set <varname>MAINTAINER</varname> to yourself. If you really can't
-    maintain the package for future updates, set it to
+    <listitem><para><varname>MAINTAINER</varname> is the email
+    address of the person who feels responsible for this package,
+    and who is most likely to look at problems or questions regarding
+    this package which have been reported with &man.send-pr.1;.
+    Other developers may contact the <varname>MAINTAINER</varname>
+    before making changes to the package, but are not required to
+    do so. When packaging a new program, set <varname>MAINTAINER</varname>
+    to yourself. If you really can't maintain the package for future
+    updates, set it to
     <email>pkgsrc-users%NetBSD.org@localhost</email>.</para></listitem>
 
+    <listitem><para><varname>OWNER</varname> should be used instead
+    of <varname>MAINTAINER</varname> when you do not want other
+    developers to update or change the package without contacting
+    you first. A package Makefile should contain one of
+    <varname>MAINTAINER</varname> or <varname>OWNER</varname>, but
+    not both.  </para></listitem>
+
     <listitem><para><varname>HOMEPAGE</varname> is a URL where users can
     find more information about the package.</para></listitem>
 
diff -r c6b6dcb96223 -r 07b6dda30425 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Thu May 29 08:34:25 2008 +0000
+++ b/doc/guide/files/fixes.xml Thu May 29 08:34:26 2008 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.92 2008/01/23 13:46:21 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.93 2008/05/29 08:34:26 abs Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -586,7 +586,8 @@
     <varname>PKGREVISION</varname> are:</para>
 
     <itemizedlist><listitem>
-      <para>Changing <varname>HOMEPAGE</varname>, <varname>MAINTAINER</varname>,
+      <para>Changing <varname>HOMEPAGE</varname>,
+      <varname>MAINTAINER</varname>, <varname>OWNER</varname>,
       or comments in Makefile.</para></listitem><listitem><para>
       Changing build variables if the resulting binary package is the same.</para></listitem><listitem><para>
       Changing <filename>DESCR</filename>.</para></listitem><listitem><para>