Don't reserve a new UID/GID unless you need it to make binary packages work.

svn path=/head/; revision=3180

handbook/porting.sgml

@@ -1,4 +1,4 @@
-<!-- $Id: porting.sgml,v 1.105 1998-07-25 21:44:56 hoek Exp $ -->
+<!-- $Id: porting.sgml,v 1.106 1998-07-25 22:43:53 hoek Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <sect1><heading>Porting an existing piece of free software<label id="porting"></heading>
@@ -1530,12 +1530,15 @@ lib/libtcl80.so.1.0
       <sect3>
 	<heading>UIDs</heading>
 
-	<p>If your port requires a certain user ID to be on the
+	<p>If your port requires a certain user to be on the
 	  installed system, let the <tt>pkg/INSTALL</tt> script call
 	  <tt>pw</tt> to create it automatically.  Look at
-	  <tt>japanese/Wnn</tt> or <tt>net/cvsup-mirror</tt> for
-	  examples.  It is customary to use UIDs in the upper 2-digit
-	  range (i.e., from around 50 to 99) for this purpose.
+	  <tt>net/cvsup-mirror</tt> for an example.
+
+	<p>If your port must use the same user/group ID number when it is
+	   installed as a binary package as when it was compiled, then you
+	   must choose a free UID from 50 to 99 and register it
+	   below.   Look at <tt>japanese/Wnn</tt> for an example.
 
 	<p>Make sure you don't use a UID already used by the system or
 	  other ports.  This is the current list of UIDs between 50
@@ -1562,9 +1565,9 @@ qmailr:*:86:82:QMail user:/var/qmail:/nonexistent
 msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh
 </verb></tscreen>
 
-	<p>Please send a notice to &a.ports; if you submit or commit a
-	  port that allocates a new UID in this range so we can keep
-	  this list up to date.
+	<p>Please include a notice when you submit a port (or an upgrade)
+	  that reserves a new UID or GID in this range.  This allows us
+	  to keep the list of reserved IDs up to date.
 
       <sect3>
 	<heading>Do things rationally</heading>