On 7 January 2014 08:16, Werner LEMBERG <[email protected]> wrote:

>
> > So my question is: what type of documentation do people in the list
> > want to see the most?  In-line function docs in the comments that
> > populate the gtk-docs?
>
> Each function needs a description, together with an explanation of all
> parameters, return values, etc., etc. – just think of having a
> HarfBuzz manpage.
>
>
The code already is gtk-doc friendly. The docs matching objects and
functions are autogenerated with --enable-gtk-doc into html and xml.
The problem is that most files just have empty templates and not the actual
content of the docs.


> > Or external documentation that explains how to use Harfbuzz?
>
> This is certainly useful, too.  But I consider the `manpage'
> documentation quest more important since there are already showcases
> that demonstrate HarfBuzz quite well.
>
>
>     Werner
>
_______________________________________________
HarfBuzz mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/harfbuzz

Reply via email to