After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 654153 - Periods are getting embedded into hyperlinks instead of signifying the end of a sentence.
Periods are getting embedded into hyperlinks instead of signifying the end of...
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
unspecified
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2011-07-07 12:02 UTC by Ray Lefuel
Modified: 2012-11-18 11:11 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Patch for "file:: and for ".: at end (992 bytes, patch)
2011-07-30 18:48 UTC, albert
none Details | Review

Description Ray Lefuel 2011-07-07 12:02:33 UTC
In the Doxygen XML output, I noticed that I cannot end a sentence with a URL because the period is placed inside the hyperlink that Doxygen auto-generates.

For example, if I have the following sentence in the brief description of my source code...

For more information, see http://www.google.com.

Then the XML output interprets the sentence as ...

"<para>For more information, see <ulink url="http://www.google.com.">http://www.google.com.</ulink></para>"

It should be:

"<para>For more information, see <ulink url="http://www.google.com">http://www.google.com</ulink>.</para>"

Also, is there a way to prevent Doxygen from converting URLs into active hyperlinks?  Sometimes I need to refer to URLs that don't exist (i.e. http://host:port) so I don't always want them converted.  The only way, as far as I can tell, is to place the URL in quotations.
Comment 1 albert 2011-07-30 18:43:42 UTC
An other problem with hyper-linking is that when one uses file: followed by a <space> this is also seen as the start of a hyper-link.
Example:
!> @brief writes info to file: oops
subroutine wr()
end
Comment 2 albert 2011-07-30 18:48:46 UTC
Created attachment 192918 [details] [review]
Patch for "file:: and for ".: at end

This patch fixes the file: problem by specifying that a least one character has to follow the : (i.e replaced * in + in the definition of the URLMASK)

Created a new rule for the URL that matches the URL plus a "." but leaves this "." in the input stream.
Comment 3 Dimitri van Heesch 2011-10-29 15:05:08 UTC
Thanks Albert,

I'll include the patch in the next subversion update.

To prevent an automatic link to http://host:port, use %http://host:port
Comment 4 Dimitri van Heesch 2011-12-03 18:22:49 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.6. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.