[GROOVY-1873] Relative links in the HTML documentation are broken during conversion to PDF

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.1-beta-1
• Fix Version/s: 1.5.6
• Assignee: Paul King
• Reporter: Robert Stroud
• Created: 03/May/07 11:22
• Updated: 27/Apr/08 04:51
• Resolved: 18/Apr/08 18:35

Description

There are a few broken links in the Groovy PDF documentation (wiki-snapshot.pdf) - I don't think the links are broken in the HTML version, so I suspect there's a problem with the generation of the PDF.

My guess is that relative links don't work...

See for example, the Next link at the bottom of the Installing Groovy page:

http://groovy.codehaus.org/Installing+Groovy

The relevant HTML is as follows:

<a href="Embedding+Groovy">Next</a>

Note that the link is relative (no initial /) rather than absolute, unlike the other links in the file, but both forms of link should work (and do work in a web browser).

See also the links in "Differences from Java", towards the end in the section entitled "New features added to Groovy" - all relative links, all broken in the PDF.

I don't know how extensive this problem is, or whether it can be fixed by changing the way in which the PDF is generated from the HTML, but until it's fixed, it's a good reason to generate HTML rather than PDF for the documentation.