Re: [Freetype] Where are there man/info pages?

[Werner LEMBERG]

> > > However, I can't find any man pages or info pages for freetype,
> > > FreeType, freetype2, FreeType2.
> >
> > There never will be, I think.  FreeType is a library which has no
> > visible interface to an end user.
> 
> I must say that I would think that this arguement is flawed. If you
> look at say stat(), fprintf() or many other "non-visible calls" they
> are all documented. Coders generally look for man pages when they
> can't remember an interface.

Well, there are a lot of people who are unhappy that you have a man
page for each C function without a proper namespace restriction.

> If the documentation was written in docbook, then it is also
> possible to automatically produce HTML, man and info pages.  Perhaps
> this could be considered?

Are you volunteering to do that? :-) Currently, we use a special tool
to extract properly formatted comments in the source files to produce
the FreeType API in HTML form.  If someone has time it could be
improved by adding more cross links.

  http://www.freetype.org/freetype2/docs/reference/ft2-toc.html


    Werner