[PATCH 2/2] Clarify FAQ 1.5 What version of Cygwin is this, anyway? 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.

Brian Inglis Brian.Inglis@SystematicSw.ab.ca
Fri Jul 10 17:41:39 GMT 2020


Thanks, Gotcha - sent all rather than waiting for chance to edit 2/2 - ops do
sometimes seem to squash commit messages - fixed - added refs to list threads -
sent v3 - learned do do something new in git.

On 2020-07-10 02:35, Corinna Vinschen wrote:
> I'd like to suggest to merge the two patches into one.  Also, check your
> log message of patch 2.  It looks like there's an empty line missing in
> line 2.
> On Jul  9 19:15, Brian Inglis wrote:
>> ---
>>  faq/faq.html | 25 ++++++++++++++-----------
>>  1 file changed, 14 insertions(+), 11 deletions(-)
>>
>> diff --git a/faq/faq.html b/faq/faq.html
>> index 846e087e..8659db5d 100644
>> --- a/faq/faq.html
>> +++ b/faq/faq.html
>> @@ -57,10 +57,12 @@ freedoms, so it is free software.
>>  <tr class="question"><td align="left" valign="top"><a name="faq.what.version"></a><p><b>1.5.</b></p></td>
>>      <td align="left" valign="top"><p>What version of Cygwin <span class="emphasis"><em>is</em></span> this, anyway?</p></td></tr>
>>  <tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top">
>> -    <p>As the Cygwin DLL takes the place of a Unix kernel,
>> -	to find the version of the Cygwin DLL installed,
>> -	you can use any of the Unix compatible commands:
>> +    <p>To find the version of the Cygwin DLL installed,
>> +	you can use:
>>  	<code class="command"><strong>uname -a</strong></code>;
>> +        as you would for a Unix kernel.
>> +        As the Cygwin DLL takes the place of a Unix kernel,
>> +	you can also use any of the Unix compatible commands:
>>  	<code class="command"><strong>uname -srvm</strong></code>;
>>  	<code class="command"><strong>head /proc/version</strong></code>;
>>  	or the Cygwin command:
>> @@ -72,17 +74,18 @@ freedoms, so it is free software.
>>      <p>If you are looking for the version number for the whole Cygwin release,
>>  	there is none.
>>  	Each package in the Cygwin release has its own version, and the
>> -	<code class="package">cygwin</code> package containing the Cygwin DLL and
>> -	Cygwin system specific utilities is just another (but very important!) package.
>> +	<code class="package">cygwin</code> package containing the Cygwin DLL
>> +	and Cygwin system specific utilities is just another (but very
>> +	important!) package.
>>  	The packages in Cygwin are continually improving, thanks to
>>  	the efforts of net volunteers who maintain the Cygwin binary ports.
>>  	Each package has its own version numbers and its own release process.
>>  </p><p>So, how do you get the most up-to-date version of Cygwin?  Easy.  Just
>>  download the Cygwin Setup program by following the instructions
>>  <a class="ulink" href="https://cygwin.com/install.html" target="_top">here</a>.
>> -The setup program will handle the task of updating the packages on your system
>> -to the latest version. For more information about using Cygwin's
>> -<code class="filename">setup.exe</code>, see 
>> +The Setup program will handle the task of updating the packages on your system
>> +to the latest version. For more information about using Cygwin's Setup program,
>> +see 
>>  <a class="ulink" href="https://cygwin.com/cygwin-ug-net/setup-net.html" target="_top">Setting Up Cygwin</a>
>>  in the Cygwin User's Guide. 
>>  </p></td></tr><tr class="question"><td align="left" valign="top"><a name="faq.what.who"></a><p><b>1.6.</b></p></td><td align="left" valign="top"><p>Who's behind the project?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p><span class="bold"><strong>(Please note that if you have cygwin-specific
>> @@ -706,7 +709,8 @@ user with <code class="literal">cygrunsrv -u</code> (see
>>  information).
>>  </p></td></tr><tr class="question"><td align="left" valign="top"><a name="faq.using.path"></a><p><b>4.5.</b></p></td><td align="left" valign="top"><p>How should I set my PATH?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>This is done for you in the file /etc/profile, which is sourced by bash
>>  when you start it from the Desktop or Start Menu shortcut, created by
>> -<code class="literal">setup.exe</code>.  The line is
>> +the Cygwin Setup program.
>> +The line is
>>  </p><pre class="screen">
>>  	PATH="/usr/local/bin:/usr/bin:/bin:$PATH"
>>  </pre><p>Effectively, this <span class="bold"><strong>prepends</strong></span> /usr/local/bin and /usr/bin to your
>> @@ -903,8 +907,7 @@ services like sshd) beforehand.</p><p>The only DLL that is sanctioned by the Cyg
>>  you get by running <a class="ulink" href="https://cygwin.com/install.html" target="_top">setup-x86.exe or setup-x86_64.exe</a>,
>>  installed in a directory controlled by this program.  If you have other
>>  versions on your system and desire help from the cygwin project, you should
>> -delete or rename all DLLs that are not installed by
>> -<code class="filename">setup.exe</code>.
>> +delete or rename all DLLs that are not installed by the Cygwin Setup program.
>>  </p><p>If you're trying to find multiple versions of the DLL that are causing
>>  this problem, reboot first, in case DLLs still loaded in memory are the
>>  cause.  Then use the Windows System find utility to search your whole
>> -- 
>> 2.27.0
> 

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]


More information about the Cygwin-patches mailing list