[PATCH] Update FAQs which are out of date on the details of setup UI

[PATCH] Update FAQs which are out of date on the details of setup UI

[Jon Turney]

---
 winsup/doc/faq-setup.xml | 11 ++++++-----
 winsup/doc/faq-using.xml | 14 +++++++-------
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
index ce1069616..da9fce534 100644
--- a/winsup/doc/faq-setup.xml
+++ b/winsup/doc/faq-setup.xml
@@ -518,10 +518,11 @@ getpwnam(3), disregarding <literal>HOME</literal>.
 <question><para>How do I uninstall individual packages?</para></question>
 <answer>
 
-<para>Run the Cygwin Setup program as you would to install packages.  In the list of
-packages to install, browse the relevant category or click on the
-``View'' button to get a full listing.  Click on the cycle glyph until
-the action reads ``Uninstall''.  Proceed by clicking ``Next''.
+<para>Run the Cygwin Setup program as you would to install packages.  In the
+``Select packages to install'' dialog, choose ``Up To Date'' in the
+<literal>View</literal> drop-down menu, and locate the package.  Choose the
+``Uninstall'' action from the drop-down menu in the ``New'' column. Proceed by
+clicking ``Next''.
 </para>
 </answer></qandaentry>
 
@@ -688,7 +689,7 @@ files, reinstall the "<literal>cygwin</literal>" package using the Cygwin Setup
 this purpose.  See <ulink url="http://rsync.samba.org/"/>,
 <ulink url="http://www.gnu.org/software/wget/"/> for utilities that can do this for you.
 For more information on setting up a custom Cygwin package server, see
-the <ulink url="https://sourceware.org/cygwin-apps/setup.html">Cygwin Setup program page</ulink>.
+the <ulink url="https://cygwin.com/package-server.html.html">Cygwin Package Server page</ulink>.
 
 </para>
 </answer></qandaentry>
diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml
index 7b9bbe1c1..ea5f5a797 100644
--- a/winsup/doc/faq-using.xml
+++ b/winsup/doc/faq-using.xml
@@ -15,13 +15,13 @@
 <para>To repair the damage, you must run the Cygwin Setup program again, and re-install the
 package which provides the missing DLL package.
 </para>
-<para>If you already installed the package at one point, the Cygwin Setup program won't
-show the option to install the package by default.  In the
-``Select packages to install'' dialog, click on the <literal>Full/Part</literal>
-button.  This lists all packages, even those that are already
-installed.  Scroll down to locate the missing package, for instance
-<literal>libncurses8</literal>.  Click on the ``cycle'' glyph until it says
-``Reinstall''.  Continue with the installation.
+<para>If you already installed the package at one point, the Cygwin Setup
+program won't show the option to install the package by default.  In the
+``Select packages to install'' dialog, choose ``Full'' in the
+<literal>View</literal> drop-down menu.  This lists all packages, even those
+that are already installed.  Scroll down to locate the missing package, for
+instance <literal>libncurses8</literal>.  Choose the ``Reinstall'' action from
+the drop-down menu in the ``New'' column.  Continue with the installation.
 </para>
 <para>For a detailed explanation of the general problem, and how to extend
 it to other missing DLLs and identify their containing packages, see
-- 
2.36.1

Re: [PATCH] Update FAQs which are out of date on the details of setup UI

[Corinna Vinschen]

On Jul  7 12:44, Jon Turney wrote:
> ---
>  winsup/doc/faq-setup.xml | 11 ++++++-----
>  winsup/doc/faq-using.xml | 14 +++++++-------
>  2 files changed, 13 insertions(+), 12 deletions(-)

LGTM

Thx,
Corinna

Re: [PATCH] Update FAQs which are out of date on the details of setup UI

[Brian Inglis]

On 2022-07-11 01:45, Corinna Vinschen wrote:
> On Jul  7 12:44, Jon Turney wrote:
>> ---
>>   winsup/doc/faq-setup.xml | 11 ++++++-----
>>   winsup/doc/faq-using.xml | 14 +++++++-------
>>   2 files changed, 13 insertions(+), 12 deletions(-)
> LGTM

[original did not make it to me; caught up on archive and noticed]

URL duplicates .html:

	<ulink url="https://cygwin.com/package-server.html.html">

should perhaps also have the self-closing tag delimiter "/>":

	<ulink url="https://cygwin.com/package-server.html" />

where the extra space ensures it is also valid XHTML/XML so it can be 
checked or processed with better tools that can catch issues ;^>

[attachment extract]

diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
index ce1069616..da9fce534 100644
--- a/winsup/doc/faq-setup.xml
+++ b/winsup/doc/faq-setup.xml
...
@@ -688,7 +689,7 @@ files, reinstall the "<literal>cygwin</literal>" 
package using the Cygwin Setup
  this purpose.  See <ulink url="http://rsync.samba.org/"/>,
  <ulink url="http://www.gnu.org/software/wget/"/> for utilities that 
can do this for you.
  For more information on setting up a custom Cygwin package server, see
-the <ulink url="https://sourceware.org/cygwin-apps/setup.html">Cygwin 
Setup program page</ulink>.
+the <ulink url="https://cygwin.com/package-server.html.html">Cygwin 
Package Server page</ulink>.

  </para>
  </answer></qandaentry>
...

-- 
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 binary units and prefixes, physical quantities in SI.]

Re: [PATCH] Update FAQs which are out of date on the details of setup UI

[Corinna Vinschen]

On Jul 23 14:46, Brian Inglis wrote:
> On 2022-07-11 01:45, Corinna Vinschen wrote:
> > On Jul  7 12:44, Jon Turney wrote:
> > > ---
> > >   winsup/doc/faq-setup.xml | 11 ++++++-----
> > >   winsup/doc/faq-using.xml | 14 +++++++-------
> > >   2 files changed, 13 insertions(+), 12 deletions(-)
> > LGTM
> 
> [original did not make it to me; caught up on archive and noticed]
> 
> URL duplicates .html:
> 
> 	<ulink url="https://cygwin.com/package-server.html.html">
> 
> should perhaps also have the self-closing tag delimiter "/>":
> 
> 	<ulink url="https://cygwin.com/package-server.html" />
> 
> where the extra space ensures it is also valid XHTML/XML so it can be
> checked or processed with better tools that can catch issues ;^>
> 
> [attachment extract]
> 
> diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
> index ce1069616..da9fce534 100644
> --- a/winsup/doc/faq-setup.xml
> +++ b/winsup/doc/faq-setup.xml
> ...
> @@ -688,7 +689,7 @@ files, reinstall the "<literal>cygwin</literal>" package
> using the Cygwin Setup
>  this purpose.  See <ulink url="http://rsync.samba.org/"/>,
>  <ulink url="http://www.gnu.org/software/wget/"/> for utilities that can do
> this for you.
>  For more information on setting up a custom Cygwin package server, see
> -the <ulink url="https://sourceware.org/cygwin-apps/setup.html">Cygwin Setup
> program page</ulink>.
> +the <ulink url="https://cygwin.com/package-server.html.html">Cygwin Package
> Server page</ulink>.
> 
>  </para>
>  </answer></qandaentry>
> ...

Sure, please create a patch.


Thanks,
Corinna

Re: [PATCH] Update FAQs which are out of date on the details of setup UI

[Jon Turney]

On 23/07/2022 21:46, Brian Inglis wrote:
> On 2022-07-11 01:45, Corinna Vinschen wrote:
>> On Jul  7 12:44, Jon Turney wrote:
>>> ---
>>>   winsup/doc/faq-setup.xml | 11 ++++++-----
>>>   winsup/doc/faq-using.xml | 14 +++++++-------
>>>   2 files changed, 13 insertions(+), 12 deletions(-)
>> LGTM
> 
> [original did not make it to me; caught up on archive and noticed]
> 
> URL duplicates .html:
> 
>      <ulink url="https://cygwin.com/package-server.html.html">
> 
> should perhaps also have the self-closing tag delimiter "/>":
> 
>      <ulink url="https://cygwin.com/package-server.html" />
> 
> where the extra space ensures it is also valid XHTML/XML so it can be 
> checked or processed with better tools that can catch issues ;^>
> 
> [attachment extract]
> 
> diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
> index ce1069616..da9fce534 100644
> --- a/winsup/doc/faq-setup.xml
> +++ b/winsup/doc/faq-setup.xml
> ...
> @@ -688,7 +689,7 @@ files, reinstall the "<literal>cygwin</literal>" 
> package using the Cygwin Setup
>   this purpose.  See <ulink url="http://rsync.samba.org/"/>,
>   <ulink url="http://www.gnu.org/software/wget/"/> for utilities that 
> can do this for you.
>   For more information on setting up a custom Cygwin package server, see
> -the <ulink url="https://sourceware.org/cygwin-apps/setup.html">Cygwin 
> Setup program page</ulink>.
> +the <ulink url="https://cygwin.com/package-server.html.html">Cygwin 
> Package Server page</ulink>.

I am confused.

The <ulink> tag is closed by the </ulink> tag later on the same line, 
after enclosing the link text 'Cygwin Package Server page'

> 
>   </para>
>   </answer></qandaentry>
> ...

Re: [PATCH] Update FAQs which are out of date on the details of setup UI

[Brian Inglis]

On 2022-07-28 10:42, Jon Turney wrote:
> On 23/07/2022 21:46, Brian Inglis wrote:
>> On 2022-07-11 01:45, Corinna Vinschen wrote:
>>> On Jul  7 12:44, Jon Turney wrote:
>>>> ---
>>>>   winsup/doc/faq-setup.xml | 11 ++++++-----
>>>>   winsup/doc/faq-using.xml | 14 +++++++-------
>>>>   2 files changed, 13 insertions(+), 12 deletions(-)
>>> LGTM
>>
>> [original did not make it to me; caught up on archive and noticed]
>>
>> URL duplicates .html:
>>
>>      <ulink url="https://cygwin.com/package-server.html.html">
>>
>> should perhaps also have the self-closing tag delimiter "/>":
>>
>>      <ulink url="https://cygwin.com/package-server.html" />
>>
>> where the extra space ensures it is also valid XHTML/XML so it can be 
>> checked or processed with better tools that can catch issues ;^>
>>
>> [attachment extract]
>>
>> diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
>> index ce1069616..da9fce534 100644
>> --- a/winsup/doc/faq-setup.xml
>> +++ b/winsup/doc/faq-setup.xml
>> ...
>> @@ -688,7 +689,7 @@ files, reinstall the "<literal>cygwin</literal>" 
>> package using the Cygwin Setup
>>   this purpose.  See <ulink url="http://rsync.samba.org/"/>,
>>   <ulink url="http://www.gnu.org/software/wget/"/> for utilities that 
>> can do this for you.
>>   For more information on setting up a custom Cygwin package server, see
>> -the <ulink url="https://sourceware.org/cygwin-apps/setup.html">Cygwin 
>> Setup program page</ulink>.
>> +the <ulink url="https://cygwin.com/package-server.html.html">Cygwin 
>> Package Server page</ulink>.
> 
> I am confused.
> 
> The <ulink> tag is closed by the </ulink> tag later on the same line, 
> after enclosing the link text 'Cygwin Package Server page'

Sorry I missed those end tags because of the wrap.

-- 
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 binary units and prefixes, physical quantities in SI.]