Red Hat Bugzilla – Bug 160939
Describe problem, fix, or request for release notes
Last modified: 2007-04-18 13:28:16 EDT
Description of problem, bug, incorrect information, or enhancement request:
At the part that explains how to file a bug report about the release notes, the
url does not wrap (on Firefox 1.0.4), causing alot of horizontal scrolling:
"For reporting errors or other requests about these release notes, file a bug
report using this pre-filled bugzilla template:
The above url needs to wrap or instead say :
For reporting errors or other requests about these release notes, file a bug
report using this <a href="linkhere">pre-filled bugzilla template</a>.
Version of release notes this bug refers to:
Fedora Core 4 final release
The release notes are written in DocBook XML and are rendered to HTML along with
other formats such as plain ASCII text. The Fedora Documentation Project's
DocBook XML guidelines currently require use of the URL itself as the link text
for <ulink> (a DocBook counterpart of HTML <a>). This is because some rendering
tools will not provide a proper hyperlink, and without one, a user wouldn't be
able to use the URL at all unless it was reproduced in full. We do try to
provide TinyURLs where practical, but they usually appear in addition to the
full text of the link, which would not solve this problem.
Recommend this be CLOSED as NOTABUG.
This was actually fixed in the release notes erratum:
Please help get these notes erratum out in the world. Perhaps I should do an
announcement on f-announce-l.
Just the TinyURL was used. This was done for the same reason this bug was
filed, because the URL does not wrap and is too long. I decided the risk was
low of TinyURL purging the URL during the lifetime of these release notes.
We'll follow the same policy in the future.
Paul's points are accurate. With rare exception, we'll only use a TinyURL for
the pre-filled bugzilla template.
Thus was invented the new TINY-BUG-URL entity:
<!ENTITY TINY-BUG-URL "http://tinyurl.com/al5g4">