[PATCH] Fix some broken links in Cygwin FAQ

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

[PATCH] Fix some broken links in Cygwin FAQ

Jon TURNEY
GNU no longer encourages the use of documentation mirrors, to avoid
referring to obsolete documentation.  Also www.fsf.org/manual/ is
just a redirect to www.fsf.org/manual

Links to using-utils.html #fragments are no longer correct as each utility
is now a separate page, since 646745cb.

indiana.edu seems to have moved XLiveCD information, without a redirect.

Linking to clean_setup.pl on cygwin.com doesn't work, as direct downloads
aren't allowed, so instead state where it can be found on a mirror.

Signed-off-by: Jon Turney <[hidden email]>
---
 winsup/doc/faq-resources.xml | 4 +---
 winsup/doc/faq-setup.xml     | 8 ++++----
 winsup/doc/faq-using.xml     | 2 +-
 winsup/doc/faq-what.xml      | 4 +---
 4 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/winsup/doc/faq-resources.xml b/winsup/doc/faq-resources.xml
index c797127..35cb689 100644
--- a/winsup/doc/faq-resources.xml
+++ b/winsup/doc/faq-resources.xml
@@ -34,9 +34,7 @@ and an API Reference at
 <ulink url="https://cygwin.com/cygwin-api/cygwin-api.html"/>.
 </para>
 <para>You can find documentation for the individual GNU tools at
-<ulink url="http://www.fsf.org/manual/"/>.  (You should read GNU manuals from
-a local mirror, check
-<ulink url="http://www.fsf.org/server/list-mirrors.html"/> for a list of them.)
+<ulink url="http://www.gnu.org/manual/"/>.
 </para>
 </answer></qandaentry>
 
diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
index a790974..0fc2635 100644
--- a/winsup/doc/faq-setup.xml
+++ b/winsup/doc/faq-setup.xml
@@ -333,7 +333,7 @@ you will have to select it explicitly.  See
 <ulink url="https://cygwin.com/packages/"/> for a searchable list of available
 packages, or use <literal>cygcheck -p </literal> as described in the Cygwin
 User's Guide at
-<ulink url="https://cygwin.com/cygwin-ug-net/using-utils.html#cygcheck"/>.
+<ulink url="https://cygwin.com/cygwin-ug-net/cygcheck.html"/>.
 </para>
 <para>If you want to build programs, of course you'll need <literal>gcc</literal>,
 <literal>binutils</literal>, <literal>make</literal> and probably other packages from the
@@ -415,7 +415,7 @@ looking names, being encoded with their URLs
 <para>Of course, you can keep them around in case you want to reinstall a
 package. If you want to clean out only the outdated packages, Michael Chase
 has written a script called <literal>clean_setup.pl</literal>, available
-at <ulink url="ftp://cygwin.com/pub/cygwin/unsupported/clean_setup.pl" />.
+at <filename>unsupported/clean_setup.pl</filename> in a Cygwin mirror.
 </para>
 </answer></qandaentry>
 
@@ -576,7 +576,7 @@ installed are <literal>sshd</literal>, <literal>cron</literal>,
 that might be running in the background.  Exit the command prompt and ensure
 that no Cygwin processes remain.  Note: If you want to save your mount points for a later
 reinstall, first save the output of <literal>mount -m</literal> as described at
-<ulink url="https://cygwin.com/cygwin-ug-net/using-utils.html#mount"/>.
+<ulink url="https://cygwin.com/cygwin-ug-net/mount.html"/>.
 </para>
 </listitem>
 <listitem><para>If you installed <literal>cyglsa.dll</literal> by running the
@@ -704,7 +704,7 @@ the Cygwin Setup homepage at
 <answer>
 
 <para>While some users have successfully done this, for example Indiana
-University's XLiveCD <ulink url="http://xlivecd.indiana.edu/"/>, there is no
+University's XLiveCD <ulink url="http://racinfo.indiana.edu/research/xlivecd.php"/>, there is no
 easy way to do it. Full instructions for constructing a portable Cygwin
 on CD by hand can be found on the mailing list at
 <ulink url="https://www.cygwin.com/ml/cygwin/2003-07/msg01117.html"/>
diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml
index 415b8a5..deb7c7e 100644
--- a/winsup/doc/faq-using.xml
+++ b/winsup/doc/faq-using.xml
@@ -1160,7 +1160,7 @@ domains. For example, you might want to use the <computeroutput>Domain
 Users</computeroutput> group instead.</para>
 
 <para>For more information on <command>setfacl</command>, see
-<ulink url="https://cygwin.com/cygwin-ug-net/using-utils.html#setfacl"/></para>
+<ulink url="https://cygwin.com/cygwin-ug-net/setfacl.html"/></para>
 </answer></qandaentry>
 
 <qandaentry id="faq.using.same-with-rhosts">
diff --git a/winsup/doc/faq-what.xml b/winsup/doc/faq-what.xml
index e71cada..ce34830 100644
--- a/winsup/doc/faq-what.xml
+++ b/winsup/doc/faq-what.xml
@@ -56,9 +56,7 @@ Guide, an API Reference, mailing lists and archives.
 <para>You can find documentation for the individual GNU tools typically
 as man pages or info pages as part of the Cygwin net distribution.
 Additionally you can get the latest docs at
-<ulink url="http://www.gnu.org/manual/"/>.  (You should read GNU manuals from a
-local mirror.  Check <ulink url="http://www.gnu.org/server/list-mirrors.html"/>
-for a list of them.)
+<ulink url="http://www.gnu.org/manual"/>.
 </para>
 </answer></qandaentry>
 
--
2.8.3

Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [PATCH] Fix some broken links in Cygwin FAQ

Corinna Vinschen-2
On Dec 14 18:02, Jon Turney wrote:
> GNU no longer encourages the use of documentation mirrors, to avoid
> referring to obsolete documentation.  Also www.fsf.org/manual/ is
> just a redirect to www.fsf.org/manual

:)

> Links to using-utils.html #fragments are no longer correct as each utility
> is now a separate page, since 646745cb.
>
> indiana.edu seems to have moved XLiveCD information, without a redirect.
>
> Linking to clean_setup.pl on cygwin.com doesn't work, as direct downloads
> aren't allowed, so instead state where it can be found on a mirror.

Ack.  Please apply.


Thanks,
Corinna

--
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Maintainer                 cygwin AT cygwin DOT com
Red Hat

signature.asc (836 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: [PATCH] Fix some broken links in Cygwin FAQ

Jon TURNEY
On 14/12/2016 22:06, Corinna Vinschen wrote:
> On Dec 14 18:02, Jon Turney wrote:
>> GNU no longer encourages the use of documentation mirrors, to avoid
>> referring to obsolete documentation.  Also www.fsf.org/manual/ is
>> just a redirect to www.fsf.org/manual
>
> :)

Bah.

"www.fsf.org/manual/ is just a redirect to www.gnu.org/manual/"

The sentence with this link is repeated, but we get it right once (Q1.3)
and then wrong (Q3.1)

>> Links to using-utils.html #fragments are no longer correct as each utility
>> is now a separate page, since 646745cb.
>>
>> indiana.edu seems to have moved XLiveCD information, without a redirect.
>>
>> Linking to clean_setup.pl on cygwin.com doesn't work, as direct downloads
>> aren't allowed, so instead state where it can be found on a mirror.
>
> Ack.  Please apply.

Done.
Loading...