Some broken links in docs on x.cygwin.com

[Jonathan <john dot doe99 at gmail dot com>]

I was looking at the Cygwin/X (compiled docs) FAQ on the website, to
see if Cygwin esp. the Cygwin/X stuff would be useful for me. Anyway,
noticed a few broken links and thought it'd be helpful if I notified
somebody of them. Hope this mailing list is a suitable venue... I went
into the #cygwinx IRC channel to enquire, but nobody was around at the
time. My search of the mailing-list archive didn't bring up anything
similar. My *nix experience level means I'm not - technically - able
to provide a patch, myself.

Best,

- Adam.


I've split it into two sections a) Broken links in the FAQ and other
docs provided on the website and b) Comments on links in the website's
compiled docs of format: text.

== Broken links in the FAQ and other docs provided on the website ==

Page: http://x.cygwin.com/docs/faq/
Title: Cygwin/X Frequently Asked Questions | version: Last updated: 2004-04-04 
Section title: 10.8. Where can I get help for installing DocBook on Cygwin?
Summary: Broken link to external page - page not found. HTML version
(and other formats of course, if they're all same version)

Current link in FAQ:
http://ourworld.compuserve.com/homepages/hoenicka_markus/cygbook1.html
Most recent Wayback Archive of that Compuserve docbook page, is dated
Oct 20, 2004 [http://web.archive.org/web/20041020081458/http://ourworld.compuserve.com/homepages/hoenicka_markus/cygbook1.html].

However, a Google search for the author cited in the tutorial brings
up Markus Hoenicka's _new_ website including the Cygwin guide linked
from the FAQ, therein:
http://www.mhoenicka.de/software/sgml/sgmlnt.html.
The direct link to the HTML version of that guide (the linked
compuserve webpage was to the HTML version) is:
http://www.mhoenicka.de/software/sgml/tutorial/book1.html
Probably easier to use that than the Waybacked one; since if he
updates it in the future that'd obviously be the one he updated. :)

Note: The same webpage is linked separately from the Cygwin Docs
contributors guide at: http://x.cygwin.com/docs/cg/docs-docbook.html

..........I was going to send a note that I'd found that broken link
so it could be fixed. Since I'd installed a Firefox extension that
checked page links, I thought it might be useful to check for & notify
y'all of any other broken links I could  find. I didn't have time to
locate replacement URLs for them all, since some are technical pages
it's probably for the best so more *nix-savvy users can locate the
pages; avoiding errors.

FAQ 'Section 4.1.2. I there a way to add a layout to the list of autodetected?'
Microsoft Global Dev website.  - link broken

FAQ 'Section 6.6. I get no login screen for Solaris'
At 'Note:, ...'X Server manual page' and 'Fonts in X11R6.7' are both
broken links.

FAQ 'Section 7.4. I have a specific error message that is not
addressed in the Error and Warning Messages section.'
The 'Cygwin/X mailing list' hyperlink (its the second link) is broken.

FAQ 'Section 7.5 My bug report the Cygwin/X mailing list was ignored.
What do I do now?'
The 'search the mailing list archives' link is broken.

FAQ 'Section 11.2 What licenses apply to the X Window System source code?' 
The 'certified by the Free Software Foundation' link is broken

There's a few broken links in the User Guide (HTML version)
[http://x.cygwin.com/docs/ug/using-remote-session.html] too:
accessed from link at http://x.cygwin.com/docs/ug/.
At Chapter 4. Under 'Note:' the 'X Server manual page' and 'X Server
XDMCP Options' are both broken links - returning a 404 error.

Also, the Contributors Guide includes "Chapter 4 - Website Maintenance". 
[http://x.cygwin.com/docs/cg/website.html]. Some potential
contributors might be dissuaded from helping out / thinking their
input would be well-received though, given that the total content if
that chapter is a single word and exclamation mark: ''Foo!'.

== Links in the text version of the docs on the website ==

The text version of all three documents on the website have the links
supposedly at the bottom Cygwin/X Contributor's Guide, Cygwin/X
Frequently Asked Questions, Cygwin/X User's Guide.
Links are relative in the case of other sections of the documentation
and the few external links are absolute links. The relative ones are
all of the type (example from users guide
[http://x.cygwin.com/docs/ug/cygwin-x-ug.txt]:
11. file://localhost/mnt/d/ago/cygwin-x-doc/build/ug/dump.html#using-starting-sh

If this is machine-specific with its mount point i.e. specific to the
machine it was made on, then this isn't particularly helpful. If not
then little harm was caused in my confusedly bringing it up ;).

Also, some of the external links are referenced well in the above
documentation, e.g. Chapter 4. Using Cygwin/X includes "You may wish
to read the [46]Linux XDMCP HOWTO or the
[47]X Server XDMCP Options for more information.". The
references/endnotes then neatly give the URLs for no.'s 47 & 48.
But... some referenced links such as 36 & 48, however, repeat the
links already given in the body of the document; which give a numbered
reference with the URL just given. I presume this is because the
anchor tags label the link a URL rather than page title, currently.

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://x.cygwin.com/docs/
FAQ:                   http://x.cygwin.com/docs/faq/