<br><div class="gmail_quote">2012/10/26 Emilien Kia <span dir="ltr"><<a href="mailto:kiae.dev@gmail.com" target="_blank">kiae.dev@gmail.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi all,<br></blockquote><div> <br>Hi Emilien,<br><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">
>> 2012/10/12 Charles Lepple <<a href="mailto:clepple@gmail.com">clepple@gmail.com</a>>:<br>
>>> <a href="https://github.com/clepple/nut/pull/2#issuecomment-9356397" target="_blank">https://github.com/clepple/nut/pull/2#issuecomment-9356397</a><br>
>><br>
</div><div class="im">>> In my mind, this is the biggest roadblock to merging. Developers need to<br>
>> know that this library exists (News section of website, etc.) and need to<br>
>> know why they might want this over the existing C API. Then, they need to<br>
>> know how to use it. Much of the benefit of a wrapper library evaporates if a<br>
>> developer has to basically read through the code to understand how to use<br>
>> it.<br>
<br>
</div>I have commited a little description of the new libnutclient with a<br>
little code sample.<br></blockquote><div> <br>great, thanks!<br><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I continue to think that manpages are not adapted to C++ documentation<br>
and javadoc/doxygen-like is more adapted.<br></blockquote><div><br>so we continue to be on the same page ;)<br>iirc, I only mentioned manpages for the C interface, not the C++ one (maybe just over a coffee...)<br> <br></div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I will look at doxygen documentation generation when trunk will have<br>
documentated code (and libnutclient have).<br></blockquote><div><br>imho, this is a chicken-n-egg issue.<br>as for unit tests, the best is probably to have something showcased on a branch, then merge that in the trunk and generalize to the whole tree... and libnutclient would be a good opportunity ;)<br>
<br>I'd be happy to help on this topic too...<br>I know Charles is also interested in, but he's already quite busy with git, apcupsd-ups and real-life.<br>so he may just comment and give some thoughts.<br><br>cheers,<br>
Arnaud<br></div></div>-- <br>Network UPS Tools (NUT) Project Leader - <a href="http://www.networkupstools.org" target="_blank">http://www.networkupstools.org</a><br>Debian Developer - <a href="http://www.debian.org" target="_blank">http://www.debian.org</a><br>
Free Software Developer - <a href="http://arnaud.quette.fr" target="_blank">http://arnaud.quette.fr</a><br><br>