[PATCH] Add FAQ 4.46. How do I fix find_fast_cwd warnings?

[Brian Inglis]

On 2017-11-12 12:07, Ken Brown wrote:
> On 11/12/2017 1:39 PM, Brian Inglis wrote:
>> Having responded to some of these posts and being prompted by the suggestion in
>> a reply to one by "Cyg simple", I attach an offering, in the off chance that
>> anyone affected might actually check the FAQ or find it in a search. ;^>
> 
> Even if they don't find it, we can refer them to the FAQ rather than re-writing
> variations on the same answer each time.  But your patch should be to
> winsup/doc/faq-using.xml.

Darn, it looked generated but I only looked around htdocs for sources.
Resubmitting against original winsup/doc/ source, which was much easier to edit.
;^>

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada
-------------- next part --------------
>From ebd6307c5aed2fc4b48945a335fcd216fa46ca01 Mon Sep 17 00:00:00 2001
From: Brian Inglis <Brian.Inglis@SystematicSW.ab.ca>
Date: Sun, 12 Nov 2017 14:25:32 -0700
Subject: [PATCH] add FAQ 4.46. How do I fix find_fast_cwd warnings?

---
 winsup/doc/faq-using.xml | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml
index b6b152e4e..165da5c68 100644
--- a/winsup/doc/faq-using.xml
+++ b/winsup/doc/faq-using.xml
@@ -1419,4 +1419,37 @@ such as virtual memory paging and file caching.</para>
   difficult to make <literal>fork()</literal> work reliably.</para>
 </answer>
 </qandaentry>
+
+<qandaentry id='faq.using.fixing-find_fast_cwd-warnings'>
+  <question><para>How do I fix <literal>find_fast_cwd</literal> warnings?</para></question>
+  <answer>
+    <para>Some ancient Cygwin releases asked users to report problems that were
+      difficult to diagnose to the mailing list with the message:</para>
+
+    <screen>find_fast_cwd: WARNING: Couldn't compute FAST_CWD pointer. Please report
+    this problem to the public mailing list cygwin@cygwin.com</screen>
+
+    <para>These problems were fixed long ago in updated Cygwin releases.</para>
+    <para>Unfortunately some projects and products still distribute these ancient
+	Cygwin releases, which do not support newer Windows releases, rather than
+	having their product install the current Cygwin release over the Internet.
+	They also provide no information about keeping Cygwin up to date with
+	upgrades and fixes.</para>
+    <para>The fix is simply downloading and running Cygwin Setup, using the
+	instructions at: 
+	<ulink url="https://cygwin.com/cygwin-ug-net/setup-net.html">
+	    setup-net.html</ulink>.</para>
+    <para>When running Setup, you should not change most of the values
+	presented, just select the <strong>Next</strong> button in most cases,
+	as you already have a Cygwin release installed and only want to upgrade
+	your current installation.  You should make your own selection if the
+	internet connection to your system requires a proxy, and to pick the
+	nearest up to date Cygwin download (mirror) site to your system for
+	faster downloads.</para>
+    <para>Cygwin Setup will download and apply updates to all packages required
+	for Cygwin itself and installed applications.
+	Any problems with applying updates or the application after updates should be
+	reported to the project or product vendor for follow up action.</para>
+  </answer>
+</qandaentry>
 </qandadiv>
-- 
2.15.0