From 9cbf5d39fa6295c71060cdf58929077b3d5ae021 Mon Sep 17 00:00:00 2001
From: obache <obache@pkgsrc.org>
Date: Fri, 8 Mar 2013 12:08:08 +0000
Subject: Note su(1) issue for Cygwin.

---
 doc/guide/files/platforms.xml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

(limited to 'doc/guide')

diff --git a/doc/guide/files/platforms.xml b/doc/guide/files/platforms.xml
index 90b06b9e434..bcc6e6545d9 100644
--- a/doc/guide/files/platforms.xml
+++ b/doc/guide/files/platforms.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: platforms.xml,v 1.80 2013/03/02 14:16:04 obache Exp $ -->
+<!-- $NetBSD: platforms.xml,v 1.81 2013/03/08 12:08:08 obache Exp $ -->
 
 <chapter id="platforms">
   <title>Using pkgsrc on systems other than &os;</title>
@@ -81,6 +81,18 @@
       because it will be required to use libtool.
       If it is not installed (or too old), Fortran compiler will be
       installed with pkgsrc automatically.</para>
+
+      <para>As noted in
+      <ulink url="http://cygwin.com/faq-nochunks.html#faq.using.su">Cygwin FAQ: `Why doesn't su work?'</ulink>,
+      su(1) command has been in Cygwin distribution, but it has never worked.
+      Unless you bootstrap pkgsrc with the --unprivileged option, workaround is:
+      </para>
+      <itemizedlist>
+        <listitem>
+          <para>Right click "Cygwin Terminal" in your Start Menu,
+          then pick "Run as administrator".</para>
+        </listitem>
+      </itemizedlist>
     </sect2>
 
     <sect2 id="darwin">
-- 
cgit v1.2.3