From 99a95d1df4b8430da38c9065b6f32a730f533ccc Mon Sep 17 00:00:00 2001 From: Corinna Vinschen Date: Mon, 16 Feb 2015 10:23:01 +0000 Subject: [PATCH] * setup-files.xml (setup-files): Drop hint to set HOME in Windows environment. * setup-env.xml (setup-env-ov): Discourage setting HOME in the Windows environment. --- winsup/doc/ChangeLog | 7 +++++++ winsup/doc/setup-env.xml | 9 +++++---- winsup/doc/setup-files.xml | 16 +++++++--------- 3 files changed, 19 insertions(+), 13 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index c79cf9632..8d39979f2 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,10 @@ +2015-02-16 Corinna Vinschen + + * setup-files.xml (setup-files): Drop hint to set HOME in Windows + environment. + * setup-env.xml (setup-env-ov): Discourage setting HOME in the Windows + environment. + 2015-02-15 Corinna Vinschen * posix.xml (std-gnu): Add missing __mempcpy. diff --git a/winsup/doc/setup-env.xml b/winsup/doc/setup-env.xml index ab3d50bdc..4b519a2a1 100644 --- a/winsup/doc/setup-env.xml +++ b/winsup/doc/setup-env.xml @@ -50,10 +50,11 @@ This is usually done by the batch file you're starting your shell with. The HOME environment variable is used by many programs to -determine the location of your home directory and we recommend that it be -defined. This environment variable is also converted from Windows format -when a Cygwin process first starts. It's usually set in the shell -profile scripts in the /etc directory. +determine the location of your home directory. This environment variable, +if it exists, is converted from Windows format when a Cygwin process first +starts. However, it's usually set in the shell profile scripts in the /etc +directory, and it's not recommended to set +the variable in your Windows environment. diff --git a/winsup/doc/setup-files.xml b/winsup/doc/setup-files.xml index 3fc4d0ccb..35aeb45f5 100644 --- a/winsup/doc/setup-files.xml +++ b/winsup/doc/setup-files.xml @@ -8,18 +8,16 @@ To set up bash so that cut and paste work properly, click on the "Properties" button of the window, then on the "Misc" tab. Make sure that "QuickEdit mode" and "Insert mode" are checked. These settings -will be remembered next time you run bash from that shortcut. Similarly -you can set the working directory inside the "Program" tab. The entry -"%HOME%" is valid, but requires that you set HOME in -the Windows environment. +will be remembered next time you run bash from that shortcut. -Your home directory should contain three initialization files -that control the behavior of bash. They are -.profile, .bashrc and -.inputrc. The Cygwin base installation creates -stub files when you start bash for the first time. +Your home directory should contain three initialization files that +control the behavior of bash. They are .profile, +.bashrc and .inputrc. +The Cygwin base installation creates stub files when you start bash +for the first time. + .profile (other names are also valid, see the bash man