[PATCH] Clarify FAQ 1.5 What version of Cygwin is this, anyway?
Jon Turney
jon.turney@dronecode.org.uk
Sat Jul 4 15:35:06 GMT 2020
On 04/07/2020 04:47, Brian Inglis wrote:
> On 2020-07-03 17:17, Brian Inglis wrote:
>> Relate Cygwin DLL to Unix kernel,
>> add required options to command examples,
>> differentiate Unix and Cygwin commands;
>> mention that the cygwin package contains the DLL.
>>
>> ---
>> faq/faq.html | 34 ++++++++++++++++++++++++----------
>> 1 file changed, 24 insertions(+), 10 deletions(-)
>
> Patch to:
> https://cygwin.com/git/?p=cygwin-htdocs.git;f=faq/faq.html;hb=HEAD
> as a result of thread:
> https://cygwin.com/pipermail/cygwin/2020-July/245442.html
Thanks for looking at this.
My perspective is that, if (as appears to be the case here) the problem
is with people who can't or won't read and *absorb* the available
information, the solution is not to add more words reiterating and
expanding, but rather to focus on clarifying the existing words.
So, I'd think this faq should start with a paragraph consisting of a
single sentence similar to:
"To find the version of the Cygwin DLL installed, you can use `uname
-a`, as you would for a Unix kernel".
Feel free to elaborate on alternatives and refinements on that in later
paragraphs.
If you're touching this FAQ, please also replace the literal `setup.exe`
with `the setup program` or similar circumlocutions, as we no longer use
that literal name.
More information about the Cygwin-patches
mailing list