[pkgsrc/trunk]: pkgsrc/doc/guide/files Change the 'non-root builds' question ...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/e031342a2f8c
branches:  trunk
changeset: 494759:e031342a2f8c
user:      jmmv <jmmv%pkgsrc.org@localhost>
date:      Sun May 29 17:16:28 2005 +0000

description:
Change the 'non-root builds' question to reflect recent changes (existence
of the UNPRIVILEGED variable and simplification of bootstrapping).

diffstat:

 doc/guide/files/faq.xml |  29 +++++++++++++++++++++++------
 1 files changed, 23 insertions(+), 6 deletions(-)

diffs (43 lines):

diff -r 4d58722fba9f -r e031342a2f8c doc/guide/files/faq.xml
--- a/doc/guide/files/faq.xml   Sun May 29 17:15:25 2005 +0000
+++ b/doc/guide/files/faq.xml   Sun May 29 17:16:28 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: faq.xml,v 1.10 2005/05/24 12:14:42 wiz Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.11 2005/05/29 17:16:28 jmmv Exp $ -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
   <title>Frequently Asked Questions</title>
@@ -232,11 +232,28 @@
 <sect1 id="non-root-pkgsrc">
     <title>How to use pkgsrc as non-root</title>
     
-     <para>  If you want to use pkgsrc as non-root user, you can set
-      some variables  to make pkgsrc work under these
-      conditions. Please see   <ulink
-      url="http://mail-index.NetBSD.org/tech-pkg/2003/09/27/0023.html";>this
-      message</ulink> for more details.  </para> 
+    <para>If you want to use pkgsrc as non-root user, you can set some
+    variables to make pkgsrc work under these conditions.  At the very
+    least, you need to set <varname>UNPRIVILEGED</varname> to
+    <quote>yes</quote>; this will turn on unprivileged mode and set
+    multiple related variables to allow installation of packages as
+    non-root.</para>
+
+    <para>In case the defaults are not enough, you may want to tune some
+    other variables used.  For example, if the automatic user/group
+    detection leads to incorrect values (or not the ones you would like
+    to use), you can change them by setting
+    <varname>UNPRIVILEGED_USER</varname> and
+    <varname>UNPRIVILEGED_GROUP</varname> respectively.</para>
+
+    <para>As regards bootstrapping, please note that the
+    <command>bootstrap</command> script will ease non-root configuration
+    when given the <quote>--ignore-user-check</quote> flag, as it will
+    choose and use multiple default directories under
+    <filename>~/pkg</filename> as the installation targets.  These
+    directories can be overriden by the <quote>--prefix</quote> flag
+    provided by the script, as well as some others that allow finer tuning
+    of the tree layout.</para>
 </sect1>
 
 <sect1 id="resume-transfers">