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
