* cygwin.xsl: Allow 3 section levels in TOC.

* new-features.xml: (ov-new1.7.32): Add new section.
	* ntsec.xml: Rename top-level section to reflect extension of topics.
	Remove old /etc/passwd, /etc/group considerations.  Add new sections
	explaining Windows to POSIX account mapping.  Make setuid sections
	third level sections.
	* pathnames.xml: Note new method of account mapping for fstab.d/$USER.
	* faq-setup.xml: Rework references to /etc/passwd and /etc/group to
	reflect changes to account handling.
	* faq-using.xml: Ditto.

winsup/doc/ChangeLog

@@ -1,3 +1,16 @@
+2014-07-30  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwin.xsl: Allow 3 section levels in TOC.
+	* new-features.xml: (ov-new1.7.32): Add new section.
+	* ntsec.xml: Rename top-level section to reflect extension of topics.
+	Remove old /etc/passwd, /etc/group considerations.  Add new sections
+	explaining Windows to POSIX account mapping.  Make setuid sections
+	third level sections.
+	* pathnames.xml: Note new method of account mapping for fstab.d/$USER.
+	* faq-setup.xml: Rework references to /etc/passwd and /etc/group to
+	reflect changes to account handling.
+	* faq-using.xml: Ditto.
+
 2014-07-21  Corinna Vinschen  <corinna@vinschen.de>
 
 	* new-features.xml: (ov-new1.7.31): Add new section.

winsup/doc/cygwin.xsl

@@ -8,5 +8,6 @@
 <xsl:param name="html.stylesheet" select="'docbook.css'"/>
 <xsl:param name="use.id.as.filename" select="1" />
 <xsl:param name="root.filename" select="@id" />
+<xsl:param name="toc.section.depth" select="3" />
 
 </xsl:stylesheet>

winsup/doc/faq-setup.xml

@@ -377,8 +377,9 @@ you are much better off if you can avoid the problem entirely.
 run mkpasswd.
 </para>
 </listitem>
-<listitem><para>You can simply edit the /etc/passwd file and change the Cygwin user name 
+<listitem><para>If you already have an /etc/passwd file, you can simply edit
-(first field). It's also a good idea to avoid spaces in the home directory.
+your Cygwin user name (first field). It's also a good idea to avoid spaces in
+the home directory.
 </para>
 </listitem>
 </orderedlist>
@@ -396,7 +397,7 @@ in order of decreasing priority:
 <listitem><para><literal>HOME</literal> from the Windows environment, translated to POSIX form.
 </para>
 </listitem>
-<listitem><para>The entry in /etc/passwd
+<listitem><para>The pw_home field from the passwd entry as returned by <command>getent passwd</command>.
 </para>
 </listitem>
 <listitem><para>/home/USERNAME
@@ -404,8 +405,7 @@ in order of decreasing priority:
 </listitem>
 </orderedlist>
 
-<para>When using Cygwin from the network (telnet, ssh,...), <literal>HOME</literal> is set 
+<para>When using Cygwin from the network (telnet, ssh,...), <literal>HOME</literal> is taken from the passwd entry.
-from /etc/passwd.
 </para>
 <para>If your <literal>HOME</literal> is set to a value such as /cygdrive/c, it is likely 
 that it was set in Windows. Start a DOS Command Window and type 
@@ -413,8 +413,9 @@ that it was set in Windows. Start a DOS Command Window and type
 </para>
 <para>Access to shared drives is often restricted when starting from the network,
 thus Domain users may wish to have a different <literal>HOME</literal> in the 
-Windows environment (on shared drive) than in /etc/passwd (on local drive).
+Windows environment (on shared drive) than in Cygwin (on local drive).
-Note that ssh only considers /etc/passwd, disregarding <literal>HOME</literal>. 
+Note that ssh only considers the account information as retrieved by
+getpwnam(3), disregarding <literal>HOME</literal>. 
 </para>
 </answer></qandaentry>
 

winsup/doc/faq-using.xml

@@ -137,7 +137,7 @@ as such.
 
 <para>Your .bashrc is read from your home directory specified by the HOME
 environment variable.  It uses /.bashrc if HOME is not set.  So you need
-to set HOME (and the home dir in your /etc/passwd entry) correctly.
+to set HOME (and the home dir in your passwd account information) correctly.
 </para>
 </answer></qandaentry>
 
@@ -265,12 +265,6 @@ must create the whatis database.  Just run the command
 <question><para>Why doesn't <literal>chmod</literal> work?</para></question>
 <answer>
 
-<para>The most common case is that your <literal>/etc/passwd</literal>
-or <literal>/etc/group</literal> files are not properly set up. If 
-<literal>ls -l</literal> shows a group of <literal>mkpasswd</literal> 
-or <literal>mkgroup</literal>, you need to run one or both of those
-commands.
-</para>
 <para>If you're using FAT32 instead of NTFS, <literal>chmod</literal> 
 will fail since FAT32 does not provide any permission information.
 You should really consider converting the drive to NTFS with
@@ -1031,19 +1025,6 @@ If everything looks ok, run bash.  Starting with Windows Vista, make
 sure you're running bash elevated.
 </para>
 
-<para>
-If "cyg_server" is not already in <literal>/etc/passwd</literal>, add it
-using <literal>mkpasswd</literal>.  Make sure all domain accounts which are
-supposed to be able to logon via ssh are in <literal>/etc/passwd</literal>.
-Also make sure that all important domain groups are in
-<literal>/etc/group</literal>.  If in doubt, call
-</para>
-
-<screen>
-  $ mkpasswd -l -d your_domain > /etc/passwd
-  $ mkgroup -l -d your_domain > /etc/group
-</screen>
-
 <para>
 Then run ssh-host-config.  Answer all questions so that "cyg_server" is
 used to run the service.  When done, check ownership of

winsup/doc/new-features.xml

@@ -4,6 +4,20 @@
 
 <sect1 id="ov-new1.7"><title>What's new and what changed in Cygwin 1.7</title>
 
+<sect2 id="ov-new1.7.32"><title>What's new and what changed from 1.7.31 to 1.7.32</title>
+
+<itemizedlist mark="bullet">
+
+<listitem><para>
+Introduce reading passwd/group entries directly from SAM/AD, thus allowing
+to do without /etc/passwd and /etc/group files.  Introduce /etc/nsswitch.conf
+file to configure passwd/group handling.
+</para></listitem>
+
+</itemizedlist>
+
+</sect2>
+
 <sect2 id="ov-new1.7.31"><title>What's new and what changed from 1.7.30 to 1.7.31</title>
 
 <itemizedlist mark="bullet">

winsup/doc/pathnames.xml

@@ -44,7 +44,9 @@ all users.  Sometimes there's a requirement to have user specific
 mount points.  The Cygwin DLL supports user specific fstab files.
 These are stored in the directory <filename>/etc/fstab.d</filename>
 and the name of the file is the Cygwin username of the user, as it's
-stored in the <filename>/etc/passwd</filename> file.  The structure of the
+created from the Windows account database or stored in the
+<filename>/etc/passwd</filename> file (see
+<xref linkend="ntsec-mapping"></xref>).  The structure of the
 user specific file is identical to the system-wide
 <filename>fstab</filename> file.</para>