Proposed patch for web site: update most links to HTTPS

Warren Young wyml@etr-usa.com
Tue May 24 12:42:00 GMT 2016


On May 23, 2016, at 4:35 AM, Corinna Vinschen wrote:
> 
> using relative paths inside the Cygwin docs
> (cygwin-api, cygwin-ug-net, and faq) is not such a bright idea, because
> the docs should ideally work even if not on the cygwin.com website.

Did you mean to say “absolute paths”?  If not, then you’re arguing against yourself here.  Relative links within the docs *are* what allow the docs to work when hosted off cygwin.com, as in my info(1) example.  Otherwise, a link that should be an internal cross-reference turns into an external web page link.

Also keep in mind that DocBook has *four* different styles of links: <link>, <olink>, <ulink>, and <xref>.  They mean different things, and give different effects.  Depending on the stylesheets you use, they can even change behavior between different output types.

  http://www.sagehill.net/docbookxsl/CrossRefs.html
  http://www.sagehill.net/docbookxsl/Ulinks.html
  http://www.sagehill.net/docbookxsl/Olinking.html
--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple



More information about the Cygwin mailing list