<p><b>@b4n</b> commented on this pull request.</p>

<hr>

<p>In <a href="https://github.com/geany/geany/pull/1282#pullrequestreview-6346663">HACKING</a>:</p>
<pre style='color:#555'>> @@ -200,8 +200,18 @@ Coding
   moment, we want to keep the minimum requirement for GTK at 2.24 (of
   course, you can use the GTK_CHECK_VERSION macro to protect code using
   later versions).
-* Variables should be declared before statements. You can use
-  gcc's -Wdeclaration-after-statement to warn about this.
+* Variables should be declared (and initialized) as close as practical
+  to their first use. This reduces the chances of intervening code being
+  inserted between declaration and use, where the variable may be
+  uninitialized.
+* Variables should be defined within the smallest scope that is practical,
+  for example inside a conditional branch which uses them or in the
+  initialization part of a for loop.
+* Local variables that will not be modified should be marked as ``const``
+  to indicate intention. This allows the compiler to give a warning if
+  part of the code accidentally tries to change the value. This does not
+  apply to non-pointer parameters where it needlessly exposes the
+  implementation and it's obvious a copy is made anyway.
</pre>
<p>It doesn't have to expose it, adding the <code>const</code> qualifier to an argument so that the argument itself is not modifiable still is compatible with a prototype not specifying it.  ISO/IEC 9899:201x n1570 6.7.6.3§15 states that</p>

<blockquote>
<p>[…] the parameter type lists, if both are present, shall agree in the number of parameters and in use of the ellipsis terminator; <strong>corresponding parameters shall have compatible types</strong>. […] (In the determination of type compatibility and of a composite type, each parameter declared with function or array type is taken as having the adjusted type and <strong>each parameter declared with qualified type is taken as having the unqualified version of its declared type</strong>.)</p>
</blockquote>

<p>So it's perfectly valid to have</p>

<div class="highlight highlight-source-c"><pre><span class="pl-k">int</span> <span class="pl-en">foo</span>(<span class="pl-k">int</span>);
<span class="pl-c">/* ... */</span>
<span class="pl-k">int</span> <span class="pl-en">foo</span>(<span class="pl-k">const</span> <span class="pl-k">int</span> a) {
  <span class="pl-k">return</span> a;
}</pre></div>

<p>And qualifying the argument "variable" <code>const</code> is just as useful as for a local variable, or maybe even more as the value is likely not to be recoverable another way.  We probably have very few of those in Geany's code, but there's a fair share in CTags and IMO it's a nice use of <code>const</code> just like on variables.</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/1282#pullrequestreview-6346663">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABDrJybowe4qCg-dfneW9xkNNQ8Vf8Yzks5q4zqqgaJpZM4KkGJE">mute the thread</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ2UwfyBbIR41a8cFAGGt4EUVz0bOks5q4zqqgaJpZM4KkGJE.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/1282#pullrequestreview-6346663"></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":"@b4n commented on #1282"}],"action":{"name":"View Pull Request","url":"https://github.com/geany/geany/pull/1282#pullrequestreview-6346663"}}}</script>