<p style="white-space: pre-wrap; word-wrap: break-word;">In the end I kept the naming the same, while spreading a lot more documentation to clarify. The outer struct could be called "osmo_use_count_list", but semantically, it represents *the* use count of this object, which happens to be fragmented into separate named tokens with a portion of the counts for each token. Each token has a 'use' (a name) and a 'count', which IMHO can't be improved upon naming wise. Suggestions welcome. (I also like how 'use' and 'count' make 'use count' ;)</p><p><a href="https://gerrit.osmocom.org/13121">View Change</a></p><p>1 comment:</p><ul style="list-style: none; padding: 0;"><li style="margin: 0; padding: 0;"><p><a href="https://gerrit.osmocom.org/#/c/13121/2/src/use_count.c">File src/use_count.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.osmocom.org/#/c/13121/2/src/use_count.c@205">Patch Set #2, Line 205:</a> <code style="font-family:monospace,monospace"> * \param[in] file  Source file path, as in __FILE__.</code></p><p><blockquote style="border-left: 1px solid #aaa; margin: 10px 0; padding: 0 10px;">ACK. […]</blockquote></p><p style="white-space: pre-wrap; word-wrap: break-word;">NACK, I disagree with describing all arguments here. The reason is that this is the kind of private implementation handle for the actual osmo_use_count_get_put() API, and writing out all arguments will be an exact copy of the description in osmo_use_count_get_put(). Add a few patches here and there, and very soon both will be out of sync. I will not introduce such a copy for function signatures that are so obviously one and the same.</p><p style="white-space: pre-wrap; word-wrap: break-word;">Having 'change' vs 'diff' isn't harmful, but I can change that if you insist. I can diff that if you insist.</p></li></ul></li></ul><p>To view, visit <a href="https://gerrit.osmocom.org/13121">change 13121</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.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.osmocom.org/13121"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: libosmocore </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: comment </div>
<div style="display:none"> Gerrit-Change-Id: Ife31e6798b4e728a23913179e346552a7dd338c0 </div>
<div style="display:none"> Gerrit-Change-Number: 13121 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </div>
<div style="display:none"> Gerrit-Owner: Neels Hofmeyr <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Harald Welte <laforge@gnumonks.org> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder (1000002) </div>
<div style="display:none"> Gerrit-Reviewer: Neels Hofmeyr <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Pau Espin Pedrol <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Vadim Yanitskiy <axilirator@gmail.com> </div>
<div style="display:none"> Gerrit-CC: Max <msuraev@sysmocom.de> </div>
<div style="display:none"> Gerrit-Comment-Date: Fri, 15 Mar 2019 04:04:22 +0000 </div>
<div style="display:none"> Gerrit-HasComments: Yes </div>
<div style="display:none"> Gerrit-HasLabels: No </div>