[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100516: Fix bug #8221 with descri
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100516: Fix bug #8221 with description of how HOME is set on Windows. |
Date: |
Fri, 11 Mar 2011 13:17:24 +0200 |
User-agent: |
Bazaar (2.0.3) |
------------------------------------------------------------
revno: 100516
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-23
timestamp: Fri 2011-03-11 13:17:24 +0200
message:
Fix bug #8221 with description of how HOME is set on Windows.
doc/emacs/msdog.texi (Windows HOME): Fix the wording to clarify how
Emacs sets HOME on Windows and where it looks for init files.
modified:
doc/emacs/ChangeLog
doc/emacs/msdog.texi
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2011-03-07 05:20:23 +0000
+++ b/doc/emacs/ChangeLog 2011-03-11 11:17:24 +0000
@@ -1,3 +1,8 @@
+2011-03-11 Eli Zaretskii <address@hidden>
+
+ * msdog.texi (Windows HOME): Fix the wording to clarify how Emacs sets
+ HOME on Windows and where it looks for init files. (Bug#8221)
+
2011-03-07 Chong Yidong <address@hidden>
* Version 23.3 released.
=== modified file 'doc/emacs/msdog.texi'
--- a/doc/emacs/msdog.texi 2011-01-07 15:32:12 +0000
+++ b/doc/emacs/msdog.texi 2011-03-11 11:17:24 +0000
@@ -404,36 +404,45 @@
@dfn{user-specific application data directory}. The actual location
depends on your Windows version and system configuration; typical values
are @file{C:\Documents and address@hidden Data} on
-Windows 2K/XP and later, and either @file{C:\WINDOWS\Application Data}
+Windows 2K/XP/2K3, @file{C:address@hidden on
+Windows Vista/7/2K8, and either @file{C:\WINDOWS\Application Data}
or @file{C:address@hidden Data} on the
-older Windows 9X/ME systems.
+older Windows 9X/ME systems. If this directory does not exist or
+cannot be accessed, Emacs falls back to @file{C:\} as the default
+value of @code{HOME}.
- @code{HOME} can also be set in the system registry, for details see
+ You can override this default value of @code{HOME} by explicitly
+setting the environment variable @env{HOME} to point to any directory
+on your system. @env{HOME} can be set either from the command shell
+prompt or from the @samp{My Computer}s @samp{Properties} dialog.
address@hidden can also be set in the system registry, for details see
@ref{MS-Windows Registry}.
address@hidden init file @file{.emacs} on MS-Windows
- The home directory is where your init file @file{.emacs} is stored.
-When Emacs starts, it first checks whether the environment variable
address@hidden is set. If it is, it looks for the init file in the
-directory pointed by @env{HOME}. If @env{HOME} is not defined, Emacs
-checks for an existing @file{.emacs} file in @file{C:\}, the root
-directory of drive @file{C:address@hidden
-The check in @file{C:\} is for compatibility with older versions of Emacs,
-which didn't check the application data directory.
-}. If there's no such file in @file{C:\}, Emacs next uses the Windows
-system calls to find out the exact location of your application data
-directory. If that system call fails, Emacs falls back to @file{C:\}.
+ For compatibility with older versions of address@hidden
+Older versions of Emacs didn't check the application data directory.
+}, if there is a file named @file{.emacs} in @file{C:\}, the root
+directory of drive @file{C:}, and @env{HOME} is set neither in the
+environment nor in the Registry, Emacs will treat @file{C:\} as the
+default @code{HOME} location, and will not look in the application
+data directory, even if it exists. Note that only @file{.emacs} is
+looked for in @file{C:\}; the older name @file{_emacs} (see below) is
+not. This use of @file{C:\.emacs} to define @code{HOME} is
+deprecated.
- Whatever the final place is, Emacs sets the value of the @env{HOME}
-environment variable to point to it, and it will use that location for
-other files and directories it normally creates in the user's home
-directory.
+ Whatever the final place is, Emacs sets the internal value of the
address@hidden environment variable to point to it, and it will use that
+location for other files and directories it normally looks for or
+creates in the user's home directory.
You can always find out where Emacs thinks is your home directory's
location by typing @kbd{C-x d ~/ @key{RET}}. This should present the
list of files in the home directory, and show its full name on the
first line. Likewise, to visit your init file, type @kbd{C-x C-f
-~/.emacs @key{RET}}.
+~/.emacs @key{RET}} (assuming the file's name is @file{.emacs}).
+
address@hidden init file @file{.emacs} on MS-Windows
+ The home directory is where your init file is stored. It can have
+any name mentioned in @ref{Init File}.
@cindex @file{_emacs} init file, MS-Windows
Because MS-DOS does not allow file names with leading dots, and
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/emacs-23 r100516: Fix bug #8221 with description of how HOME is set on Windows.,
Eli Zaretskii <=