From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 27 Jul 2023 06:51:39 +0000 (+0300)
Subject: ; Better documentation of HOME on MS-Windows
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e708da62270d311d6bceac0dcbdf4740112156ed;p=emacs.git

; Better documentation of HOME on MS-Windows

* doc/emacs/custom.texi (Find Init): Add footnote about HOME on
MS-Windows.  (Bug#64871)
---

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index d2d51e344dd..456e2087217 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2823,7 +2823,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