Might be better to link [directly to the 
macro](https://developer.gnome.org/glib/stable/glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS),
 and also use [external hyperlink 
target](http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#external-hyperlink-targets)
 to improve the readability, as [explained in the 
manual](http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliases):

> **Caution!**
> This construct offers easy authoring and maintenance of hyperlinks at the 
> expense of general readability. Inline URIs, especially long ones, inevitably 
> interrupt the natural flow of text. For documents meant to be read in source 
> form, the use of independent block-level hyperlink targets is **strongly 
> recommended**. The embedded URI construct is most suited to documents 
> intended only to be read in processed form.

I might update if I get bored.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/pull/1582#issuecomment-323892051

Reply via email to