[PATCH] Book: Add caveat about HOME directory

This was inspired by a real problem: a co-worker somehow had his HOME
variable saying one thing, and /etc/passwd saying something else, and
he couldn't understand why the changes he made to ~/.subversion/config
weren't having any effect. For what it's worth, he was using Cygwin,
and the Cygwin version of Subversion, not the native Win32 version.

Log message:
* ch07.xml (section 1.1): warn about confusion if HOME and /etc/passwd disagree

Index: ch07.xml
===================================================================
--- ch07.xml (revision 11185)
+++ ch07.xml (working copy)
@@ -72,7 +72,23 @@
         command-line client is executed, it creates a per-user
         configuration area. On Unix-like systems, this area appears
         as a directory named <filename>.subversion</filename> in the
- user's home directory. On Win32 systems, Subversion creates a
+ user's home directory.
+ <footnote>
+ <para>
+ Note that the user's home directory is determined by their
+ entry in the <filename>/etc/passwd</filename> file, or
+ equivalent, and <emphasis>not</emphasis> by the contents
+ of the <literal>HOME</literal> environment variable.
+ Usually the password file and the environment variable
+ refer to the same spot, but occasionally they don't. So
+ if you're wondering why the changes you've made to
+ <filename>$HOME/.subversion/config</filename> have no
+ effect, check to see if <emphasis>your</emphasis>
+ <literal>HOME</literal> variable refers to the same
+ directory as the password database.
+ </para>
+ </footnote>
+ On Win32 systems, Subversion creates a
         folder named <filename>Subversion</filename>, typically inside
         the <filename>Application Data</filename> area of the user's
         profile directory (which, by the way, is usually a hidden

-- 
A novice of the temple once approached the Master Programmer with a question.
"Master, does Emacs have the Buddha nature?" the novice asked.
The Master Programmer had been in the temple for many years and
could be relied upon to know these things.  He thought for
several minutes before replying.  "I don't see why not.  It's
bloody well got everything else."
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org