regen

1 files changed, 73 insertions, 46 deletions

diff --git a/doc/pkgsrc.txt b/doc/pkgsrc.txt
index a1bfe25e89f..6eff6ee1046 100644
--- a/doc/pkgsrc.txt
+++ b/doc/pkgsrc.txt
@@ -61,13 +61,14 @@ I. The pkgsrc user's guide
         3.2. Bootstrapping pkgsrc
         3.3. Platform-specific notes
 
-            3.3.1. Darwin (Mac OS X)
-            3.3.2. FreeBSD
-            3.3.3. Interix
-            3.3.4. IRIX
-            3.3.5. Linux
-            3.3.6. OpenBSD
-            3.3.7. Solaris
+            3.3.1. Cygwin
+            3.3.2. Darwin (Mac OS X)
+            3.3.3. FreeBSD
+            3.3.4. Interix
+            3.3.5. IRIX
+            3.3.6. Linux
+            3.3.7. OpenBSD
+            3.3.8. Solaris
 
     4. Using pkgsrc
 
@@ -588,6 +589,12 @@ Table 1.1. Platforms supported by pkgsrc
 |HP-UX                                        |     Apr 2007     |
 |---------------------------------------------+------------------|
 |Haiku                                        |     Sep 2010     |
+|---------------------------------------------+------------------|
+|MirBSD                                       |     Aug 2011     |
+|---------------------------------------------+------------------|
+|Minix3                                       |     Nov 2011     |
+|---------------------------------------------+------------------|
+|Cygwin                                       |     Mar 2013     |
 +----------------------------------------------------------------+
 
 
@@ -706,13 +713,14 @@ Table of Contents
     3.2. Bootstrapping pkgsrc
     3.3. Platform-specific notes
 
-        3.3.1. Darwin (Mac OS X)
-        3.3.2. FreeBSD
-        3.3.3. Interix
-        3.3.4. IRIX
-        3.3.5. Linux
-        3.3.6. OpenBSD
-        3.3.7. Solaris
+        3.3.1. Cygwin
+        3.3.2. Darwin (Mac OS X)
+        3.3.3. FreeBSD
+        3.3.4. Interix
+        3.3.5. IRIX
+        3.3.6. Linux
+        3.3.7. OpenBSD
+        3.3.8. Solaris
 
 4. Using pkgsrc
 
@@ -973,13 +981,14 @@ Table of Contents
 3.2. Bootstrapping pkgsrc
 3.3. Platform-specific notes
 
-    3.3.1. Darwin (Mac OS X)
-    3.3.2. FreeBSD
-    3.3.3. Interix
-    3.3.4. IRIX
-    3.3.5. Linux
-    3.3.6. OpenBSD
-    3.3.7. Solaris
+    3.3.1. Cygwin
+    3.3.2. Darwin (Mac OS X)
+    3.3.3. FreeBSD
+    3.3.4. Interix
+    3.3.5. IRIX
+    3.3.6. Linux
+    3.3.7. OpenBSD
+    3.3.8. Solaris
 
 3.1. Binary distribution
 
@@ -1027,7 +1036,24 @@ build and install packages.
 
 Here are some platform-specific notes you should be aware of.
 
-3.3.1. Darwin (Mac OS X)
+3.3.1. Cygwin
+
+Cygwin 1.7.x and later are supported.
+
+You need to install minimal base packages in `Base' category plus any of
+compiler, gcc, gcc4, and/or clang. For gcc and gcc4, C and C++ compiler will be
+installed by default, but you can install Fortran compiler additionally because
+it will be required to use libtool. If it is not installed (or too old),
+Fortran compiler will be installed with pkgsrc automatically.
+
+As noted in Cygwin FAQ: `Why doesn't su work?', su(1) command has been in
+Cygwin distribution, but it has never worked. Unless you bootstrap pkgsrc with
+the --unprivileged option, workaround is:
+
+  * Right click "Cygwin Terminal" in your Start Menu, then pick "Run as
+    administrator".
+
+3.3.2. Darwin (Mac OS X)
 
 Darwin 5.x and up are supported.
 
@@ -1038,7 +1064,7 @@ optional package included with the Developer Tools) if you intend to build
 packages that use the X11 Window System. (If you don't want or need the full
 Xcode GUI, download and install Command Line Tools for Xcode.)
 
-3.3.2. FreeBSD
+3.3.3. FreeBSD
 
 FreeBSD 8.3 and 9.0 have been tested and are supported, other versions may
 work.
@@ -1063,7 +1089,7 @@ with the FreeBSD userland tools. There are several steps:
  3. An example mk.conf file will be placed in /etc/mk.conf.example file when
     you use the bootstrap script.
 
-3.3.3. Interix
+3.3.4. Interix
 
 Interix is a POSIX-compatible subsystem for the Windows NT kernel, providing a
 Unix-like environment with a tighter kernel integration than available with
@@ -1081,7 +1107,7 @@ and Windows Server 2008 R2 (6.1). As of this writing, the SUA's Interix 6.0
 (32bit) and 6.1 (64bit) subsystems have been tested. Other versions may work as
 well. The Interix 5.x subsystem has not yet been tested with pkgsrc.
 
-3.3.3.1. When installing Interix/SFU
+3.3.4.1. When installing Interix/SFU
 
 At an absolute minimum, the following packages must be installed from the
 Windows Services for Unix 3.5 distribution in order to use pkgsrc:
@@ -1125,7 +1151,7 @@ hotfixes note above, the following option can be added to the appropriate
 will disable DEP completely, which may be a security risk if applications are
 often run as a user in the Administrators group!)
 
-3.3.3.2. What to do if Interix/SFU is already installed
+3.3.4.2. What to do if Interix/SFU is already installed
 
 If SFU is already installed and you wish to alter these settings to work with
 pkgsrc, note the following things.
@@ -1148,7 +1174,7 @@ pkgsrc, note the following things.
 
     Set the DWORD value "EnableSetuidBinaries" to 1; then reboot.
 
-3.3.3.3. Important notes for using pkgsrc
+3.3.4.3. Important notes for using pkgsrc
 
 The package manager (either the pkgsrc "su" user, or the user running
 "pkg_add") must be a member of the local Administrators group. Such a user must
@@ -1173,7 +1199,7 @@ adequate emulation in most cases:
 interix:kP=\E[S:kN=\E[T:kH=\E[U:dc@:DC@:tc=pcansi:
 
 
-3.3.3.4. Limitations of the Interix platform
+3.3.4.4. Limitations of the Interix platform
 
 Though Interix suffices as a familiar and flexible substitute for a full
 Unix-like platform, it has some drawbacks that should be noted for those
@@ -1217,7 +1243,7 @@ desiring to make the most of Interix.
     make tape drive access possible by using Cygwin as a bridge (similarly to
     audio bridged via Cygwin's esound server).
 
-3.3.3.5. Known issues for pkgsrc on Interix
+3.3.4.5. Known issues for pkgsrc on Interix
 
 It is not necessary, in general, to have a "root" user on the Windows system;
 any member of the local Administrators group will suffice. However, some
@@ -1233,7 +1259,7 @@ around the issue:
 # chmod -R g+w $PKG_DBDIR
 
 
-3.3.4. IRIX
+3.3.5. IRIX
 
 You will need a working C compiler, either gcc or SGI's MIPS and MIPSpro
 compiler (cc/c89). Please set the CC environment variable according to your
@@ -1277,7 +1303,7 @@ to make sure that MIPSPro is used, please set your PATH to not include the
 location of gcc (often /usr/freeware/bin), and (important) pass the
 '--preserve-path' flag.
 
-3.3.5. Linux
+3.3.6. Linux
 
 Some versions of Linux (for example Debian GNU/Linux) need either libtermcap or
 libcurses (libncurses). Installing the distributions libncurses-dev package (or
@@ -1319,7 +1345,7 @@ linking a C++ shared library and records it, throwing away the -Bstatic and
 libtool-linked C++ shared libraries will have a runtime dependency on the icc
 libraries until this is fixed in libtool.
 
-3.3.6. OpenBSD
+3.3.7. OpenBSD
 
 OpenBSD 5.1 has been tested and supported, other versions may work.
 
@@ -1352,7 +1378,7 @@ with the OpenBSD userland tools. There are several steps:
     .endif
 
 
-3.3.7. Solaris
+3.3.8. Solaris
 
 Solaris 2.6 through 10 are supported on both x86 and sparc. You will need a
 working C compiler. Both gcc 4.5.3 and Sun WorkShop 5 have been tested.
@@ -1377,7 +1403,7 @@ Whichever compiler you use, please ensure the compiler tools and your $prefix
 are in your PATH. This includes /usr/ccs/{bin,lib} and e.g. /usr/pkg/
 {bin,sbin}.
 
-3.3.7.1. If you are using gcc
+3.3.8.1. If you are using gcc
 
 It makes life much simpler if you only use the same gcc consistently for
 building all packages.
@@ -1388,7 +1414,7 @@ gcc used during bootstrapping.
 
 Binary packages of gcc can be found through http://www.sunfreeware.com/.
 
-3.3.7.2. If you are using Sun WorkShop
+3.3.8.2. If you are using Sun WorkShop
 
 You will need at least the following packages installed (from WorkShop 5.0)
 
@@ -1412,7 +1438,7 @@ Note
 The CPP setting might break some packages that use the C preprocessor for
 processing things other than C source code.
 
-3.3.7.3. Building 64-bit binaries with SunPro
+3.3.8.3. Building 64-bit binaries with SunPro
 
 To build 64-bit packages, you just need to have the following lines in your
 mk.conf file:
@@ -1425,7 +1451,7 @@ Note
 This setting has been tested for the SPARC architecture. Intel and AMD machines
 need some more work.
 
-3.3.7.4. Common problems
+3.3.8.4. Common problems
 
 Sometimes, when using libtool, /bin/ksh crashes with a segmentation fault. The
 workaround is to use another shell for the configure scripts, for example by
@@ -4680,9 +4706,9 @@ issues:
     implementation.
 
   * motif.buildlink3.mk checks for a system-provided Motif installation or adds
-    a dependency on x11/lesstif or x11/openmotif. The user can set MOTIF_TYPE
-    to "dt", "lesstif", or "openmotif" to choose which Motif version will be
-    used.
+    a dependency on x11/lesstif, x11/motif or x11/openmotif. The user can set
+    MOTIF_TYPE to "dt", "lesstif", "motif" or "openmotif" to choose which Motif
+    version will be used.
 
   * oss.buildlink3.mk defines several variables that may be used by packages
     that use the Open Sound System (OSS) API.
@@ -7275,11 +7301,15 @@ should use the following code.
 If this distinction is not fine enough, you can also test for the following
 macros.
 
-FreeBSD     __FreeBSD__
+Cygwin      __CYGWIN__
 DragonFly   __DragonFly__
+FreeBSD     __FreeBSD__
+Haiku       __HAIKU__
 Interix     __INTERIX
 IRIX        __sgi (TODO: get a definite source for this)
 Linux       linux, __linux, __linux__
+MirBSD      __MirBSD__ (__OpenBSD__ is also defined)
+Minix3      __minix
 NetBSD      __NetBSD__
 OpenBSD     __OpenBSD__
 Solaris     sun, __sun
@@ -9223,11 +9253,8 @@ D.2. Procedure
 The procedure to edit the pkgsrc guide is:
 
  1. Make sure you have the packages needed to regenerate the pkgsrc guide (and
-    other XML-based NetBSD documentation) installed. These are meta-pkgs/
-    netbsd-doc for creating the ASCII and HTML versions, and meta-pkgs/
-    netbsd-doc-print for the PostScript and PDF versions. You will need both
-    packages installed, to make sure documentation is consistent across all
-    formats.
+    other XML-based NetBSD documentation) installed. These are automatically
+    installed when you install the meta-pkgs/pkgsrc-guide-tools package.
 
  2. Run cd doc/guide to get to the right directory. All further steps will take
     place here.