<p> Attention is currently required from: Kevin Harwell. </p>
<p><a href="https://gerrit.asterisk.org/c/asterisk/+/17514">View Change</a></p><p>2 comments:</p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0;"><p><a href="null">File include/asterisk/fskmodem_int.h:</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/+/17514/comment/480e732f_07faf921">Patch Set #3, Line 69:</a> </p><p><blockquote style="border-left: 1px solid #aaa; margin: 10px 0; padding: 0 10px;"><pre style="font-family: monospace,monospace; white-space: pre-wrap;">/* \brief Retrieve a serial byte into outbyte.<br>   Buffer is a pointer into a series of<br>   shorts and len records the number of bytes in the buffer.  len will be<br>   overwritten with the number of bytes left that were not consumed.<br>   \return return value is as follows:<br>   \arg 0: Still looking for something...<br>   \arg 1: An output byte was received and stored in outbyte<br>   \arg -1: An error occured in the transmission<br>   This must be called with at least 80 bytes of buffer. */<br></pre></blockquote></p><p><blockquote style="border-left: 1px solid #aaa; margin: 10px 0; padding: 0 10px;">Why was this documentation removed?</blockquote></p><p style="white-space: pre-wrap; word-wrap: break-word;">It gave a warning because of multiple definitions of return values. The problem is that Doxygen somehow collects the symbols and overloads the one from fskmodem_float. I had two alternatives:<br>(a) live with the hard to understand warning or<br>(b) remove the description in one _float or _int.</p></li></ul></li><li style="margin: 0; padding: 0;"><p><a href="null">File main/media_cache.c:</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/+/17514/comment/1ae1ccac_6f47ce73">Patch Set #3, Line 131:</a> <code style="font-family:monospace,monospace"> * \param bucket_file The \ref ast_bucket_file media cache item to upadte</code></p><p><blockquote style="border-left: 1px solid #aaa; margin: 10px 0; padding: 0 10px;">Surprised this didn't give a warning. This parameter/line should be swapped with the one above. […]</blockquote></p><p style="white-space: pre-wrap; word-wrap: break-word;">Doxygen does not care about the order of the parameters while describing them. Anyway, I am going to swap it (and fix the typing error in ‘update’).</p></li></ul></li></ul><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/17514">change 17514</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/+/17514"/><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: Ib8359e3590a9109eb04a5376559d040e5e21867e </div>
<div style="display:none"> Gerrit-Change-Number: 17514 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </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-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-Attention: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-Comment-Date: Wed, 24 Nov 2021 18:59:31 +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: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: comment </div>