[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