<p>Might be better to link <a href="https://developer.gnome.org/glib/stable/glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS">directly to the macro</a>, and also use <a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#external-hyperlink-targets">external hyperlink target</a> to improve the readability, as <a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliases">explained in the manual</a>:</p>
<blockquote>
<p><strong>Caution!</strong><br>
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 <strong>strongly recommended</strong>. The embedded URI construct is most suited to documents intended only to be read in processed form.</p>
</blockquote>
<p>I might update if I get bored.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/geany/geany/pull/1582#issuecomment-323892051">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABDrJ4w9xFnDjmVnzbAHXQ4n0VHetlmpks5saiuRgaJpZM4O9n9n">mute the thread</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ0Mi9pcrqKa596DR1hVrNk-3kypTks5saiuRgaJpZM4O9n9n.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
  <link itemprop="url" href="https://github.com/geany/geany/pull/1582#issuecomment-323892051"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>

<script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/geany/geany","title":"geany/geany","subtitle":"GitHub repository","main_image_url":"https://cloud.githubusercontent.com/assets/143418/17495839/a5054eac-5d88-11e6-95fc-7290892c7bb5.png","avatar_image_url":"https://cloud.githubusercontent.com/assets/143418/15842166/7c72db34-2c0b-11e6-9aed-b52498112777.png","action":{"name":"Open in GitHub","url":"https://github.com/geany/geany"}},"updates":{"snippets":[{"icon":"PERSON","message":"@codebrainz in #1582: 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):\r\n\r\n\u003e **Caution!**\r\n\u003e 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.\r\n\r\nI might update if I get bored."}],"action":{"name":"View Pull Request","url":"https://github.com/geany/geany/pull/1582#issuecomment-323892051"}}}</script>