<div dir="ltr">On 7 January 2014 08:16, Werner LEMBERG <span dir="ltr"><<a href="mailto:wl@gnu.org" target="_blank">wl@gnu.org</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div class="im"><br>
> So my question is: what type of documentation do people in the list<br>
> want to see the most?  In-line function docs in the comments that<br>
> populate the gtk-docs?<br>
<br>
</div>Each function needs a description, together with an explanation of all<br>
parameters, return values, etc., etc. – just think of having a<br>
HarfBuzz manpage.<br>
<div class="im"><br></div></blockquote><div><br></div><div><div style="font-family:arial,sans-serif;font-size:13px">The code already is gtk-doc friendly. The docs matching objects and functions are autogenerated with --enable-gtk-doc into html and xml.</div>
<div style="font-family:arial,sans-serif;font-size:13px">The problem is that most files just have empty templates and not the actual content of the docs.</div></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div class="im">
> Or external documentation that explains how to use Harfbuzz?<br>
<br>
</div>This is certainly useful, too.  But I consider the `manpage'<br>
documentation quest more important since there are already showcases<br>
that demonstrate HarfBuzz quite well.<br>
<span class=""><font color="#888888"><br>
<br>
    Werner<br>
</font></span></blockquote></div><br></div></div>