<p> Attention is currently required from: George Joseph. </p>
<p><a href="https://gerrit.asterisk.org/c/asterisk/+/17511">View Change</a></p><p>1 comment:</p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0;"><p><a href="null">Patchset:</a></p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0 0 0 16px;"><p style="margin-bottom: 4px;"><a href="https://gerrit.asterisk.org/c/asterisk/+/17511?tab=comments">Patch Set #1:</a> </p><p><blockquote style="border-left: 1px solid #aaa; margin: 10px 0; padding: 0 10px;">I may have missed the "return and retval" situation in earlier reviews. […]</blockquote></p><p style="white-space: pre-wrap; word-wrap: break-word;">I described it one of the issue reports: The problem was that code existed which used ‘retval \c NULL’. That created a warning because the first word after retval is a parameter. And Doxygen got confused because \c is an environment. The solution was then to go for ‘retval NULL’ especially because NULL is then displayed as typewriter font. Then, for consistency, I changed all ‘return \c NULL’ to ‘retval NULL’. And then for consistency, I moved all fixed values into retval, like NULL.</p><p style="white-space: pre-wrap; word-wrap: break-word;">Of course, you could follow/create a style guide to go for just a one-return-liner if just a single exception exists. Or no return at all. Or … Anyway, all the files I touched, I (tried!) to follow that style, recommended in the Doxygen ‘sphere’ as well <https://github.com/doxygen/doxygen/issues/7769#issuecomment-626348804></p><p style="white-space: pre-wrap; word-wrap: break-word;">My patches are (mainly!) about fixing all *syntax* errors, those for which Doxygen creates an actual warning. Sometimes, I apply file-wide *style* to get it a bit more consistent. Personally, I prefer that extra NULL because one the can grep/regex easier through the code, if he/she wants to create a certain style.</p><p style="white-space: pre-wrap; word-wrap: break-word;">In other words, my changes do not follow an consistent style on the *semantic* level. I focused on *syntactic* level. If somebody wants to improve the semantics, welcome! But not my area right now.</p><p style="white-space: pre-wrap; word-wrap: break-word;">Long story short, ‘retval \c NULL’ was the problem, I tried to fix somehow.</p></li></ul></li></ul><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/17511">change 17511</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/17511"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I572e6019c422780dde5ce8448b6c85c77af6046d </div>
<div style="display:none"> Gerrit-Change-Number: 17511 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Alexander Traud <pabstraud@compuserve.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-CC: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-Attention: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-Comment-Date: Fri, 19 Nov 2021 16:10:46 +0000 </div>
<div style="display:none"> Gerrit-HasComments: Yes </div>
<div style="display:none"> Gerrit-Has-Labels: No </div>
<div style="display:none"> Comment-In-Reply-To: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: comment </div>