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-Tag: emacs-29.1.90~277^2~7
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b2cb6e821603b53b88b99b5cbf24dc715fc25867;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)

(cherry picked from commit d59630e591cd49780e6554d1025c1879bb89680b)
---

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