Document OWNER

3 files changed, 22 insertions, 13 deletions

diff --git a/doc/Makefile-example b/doc/Makefile-example
index fd290ef71a5..cedb961bae1 100644
--- a/doc/Makefile-example
+++ b/doc/Makefile-example
@@ -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 @@ CATEGORIES=		devel gnu	# multiple categories are allowed
 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	# 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 --git a/doc/guide/files/components.xml b/doc/guide/files/components.xml
index faf7c030958..76fca135cf9 100644
--- a/doc/guide/files/components.xml
+++ b/doc/guide/files/components.xml
@@ -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 @@ converters    games         mbone         print         x11
   <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</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 --git a/doc/guide/files/fixes.xml b/doc/guide/files/fixes.xml
index be3f349abd3..2db69100fce 100644
--- a/doc/guide/files/fixes.xml
+++ b/doc/guide/files/fixes.xml
@@ -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 @@ DISTNAME=       foo-17.43
     <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>