[Github-comments] [geany/geany] Added small description of G_GNUC_UNUSED macro. (#1582)

Matthew Brush notifications at xxxxx
Tue Aug 22 01:14:58 UTC 2017


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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20170822/58d540ec/attachment.html>


More information about the Github-comments mailing list