emacs-29 b2cb6e82160 4/7: ; Better documentation of HOME on MS-Windows

[Eli Zaretskii]

branch: emacs-29
commit b2cb6e821603b53b88b99b5cbf24dc715fc25867
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Better documentation of HOME on MS-Windows
    
    * doc/emacs/custom.texi (Find Init): Add footnote about HOME on
    MS-Windows.  (Bug#64871)
    
    (cherry picked from commit d59630e591cd49780e6554d1025c1879bb89680b)
---
 doc/emacs/custom.texi | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index e56b1fe964c..ea29876be80 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2804,7 +2804,12 @@ library.  @xref{Hooks}.
 @subsection How Emacs Finds Your Init File
 
   Emacs normally finds your init file in a location under your home
-directory.  @xref{Init File}.
+directory@footnote{
+On MS-Windows, there's no single directory considered by all programs
+as ``the home directory'' of the user.  Emacs uses one of the
+pertinent directories as the equivalent of your home directory; see
+@ref{Windows HOME}, for the details.
+}.  @xref{Init File}.
 
   Emacs looks for your init file using the filenames @file{~/.emacs.el},
 @file{~/.emacs}, or @file{~/.emacs.d/init.el} in that order; you can