diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 82301ebfc3b..5fafbeb7f6e 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,9 @@
+2003-02-21  Ben Elliston  <bje@redhat.com>
+
+	PR other/5634
+	* doc/install.texi (Configuration): Explain using $HOME instead of
+	the ~ metacharacter when referring to home directories.
+
 2003-02-20  Alexandre Oliva  <aoliva@redhat.com>
 
 	* configure.in (TARGET_SYSTEM_ROOT): Set default to
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index c3bc46fbbbd..0d1496ddeb0 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -358,7 +358,10 @@ other than the default.  The toplevel installation directory defaults to
 @file{/usr/local}.
 
 We @strong{highly} recommend against @var{dirname} being the same or a
-subdirectory of @var{objdir} or vice versa.
+subdirectory of @var{objdir} or vice versa.  If specifying a directory
+beneath a user's home directory tree, some shells will not expand
+@var{dirname} correctly if it contains the @samp{~} metacharacter; use
+@env{$HOME} instead.
 
 These additional options control where certain parts of the distribution
 are installed.  Normally you should not need to use these options.