* [PATCH] winsup/doc/faq-what.xml FAQ 1.5 Clarify What version is this
@ 2020-07-13 12:58 Brian Inglis
2020-07-13 15:21 ` Corinna Vinschen
0 siblings, 1 reply; 2+ messages in thread
From: Brian Inglis @ 2020-07-13 12:58 UTC (permalink / raw)
To: cygwin-patches
Patch to:
https://sourceware.org/git/?p=newlib-cygwin.git;f=winsup/doc/faq-what.xml;a=blob
as a result of thread:
https://cygwin.com/pipermail/cygwin/2020-July/245442.html
and comments:
https://cygwin.com/pipermail/cygwin-patches/2020q3/010331.html
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,
replace setup.exe reference by Cygwin Setup program wording.
---
winsup/doc/faq-what.xml | 29 +++++++++++++++++++----------
1 file changed, 19 insertions(+), 10 deletions(-)
diff --git a/winsup/doc/faq-what.xml b/winsup/doc/faq-what.xml
index ce3483017d..772fc04645 100644
--- a/winsup/doc/faq-what.xml
+++ b/winsup/doc/faq-what.xml
@@ -85,25 +85,34 @@ freedoms, so it is free software.
<answer>
<para>To find the version of the Cygwin DLL installed, you can use
-<filename>uname</filename> as on Linux or <filename>cygcheck</filename>. Refer to each command's
+<filename>uname</filename> <literal>-r</literal> as you would for a Unix kernel.
+As the Cygwin DLL takes the place of a Unix kernel,
+you can also use the Unix compatible command:
+<filename>head</filename> <filename>/proc/version</filename>,
+or the Cygwin specific command:
+<filename>cygcheck</filename> <literal>-V</literal>.
+Refer to each command's
<literal>--help</literal> output and the
<ulink url='https://cygwin.com/cygwin-ug-net/'>Cygwin User's Guide</ulink>
for more information.
</para>
<para>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. The packages in Cygwin are continually improving, thanks to
-the efforts of net volunteers who maintain the Cygwin binary ports.
+release, there is none.
+Each package in the Cygwin release has its own version, and the
+<literal>cygwin</literal> 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 volunteers who maintain the Cygwin ports.
Each package has its own version numbers and its own release process.
</para>
<para>So, how do you get the most up-to-date version of Cygwin? Easy. Just
-download the Cygwin Setup program by following the instructions
-<ulink url='https://cygwin.com/install.html'>here</ulink>.
-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
-<filename>setup.exe</filename>, see
+download the Cygwin Setup program by following the
+<ulink url='https://cygwin.com/install.html'>installation instructions</ulink>.
+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
<ulink url='https://cygwin.com/cygwin-ug-net/setup-net.html'>Setting Up Cygwin</ulink>
-in the Cygwin User's Guide.
+in the Cygwin User's Guide.
</para></answer></qandaentry>
<qandaentry id="faq.what.who">
--
2.27.0
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [PATCH] winsup/doc/faq-what.xml FAQ 1.5 Clarify What version is this
2020-07-13 12:58 [PATCH] winsup/doc/faq-what.xml FAQ 1.5 Clarify What version is this Brian Inglis
@ 2020-07-13 15:21 ` Corinna Vinschen
0 siblings, 0 replies; 2+ messages in thread
From: Corinna Vinschen @ 2020-07-13 15:21 UTC (permalink / raw)
To: cygwin-patches
On Jul 13 06:58, Brian Inglis wrote:
> Patch to:
> https://sourceware.org/git/?p=newlib-cygwin.git;f=winsup/doc/faq-what.xml;a=blob
> as a result of thread:
> https://cygwin.com/pipermail/cygwin/2020-July/245442.html
> and comments:
> https://cygwin.com/pipermail/cygwin-patches/2020q3/010331.html
> 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,
> replace setup.exe reference by Cygwin Setup program wording.
> ---
> winsup/doc/faq-what.xml | 29 +++++++++++++++++++----------
> 1 file changed, 19 insertions(+), 10 deletions(-)
Pushed with minor change to log message subject line.
Thanks,
Corinna
--
Corinna Vinschen
Cygwin Maintainer
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2020-07-13 15:21 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-07-13 12:58 [PATCH] winsup/doc/faq-what.xml FAQ 1.5 Clarify What version is this Brian Inglis
2020-07-13 15:21 ` Corinna Vinschen
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).