[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Werner LEMBERG
Subject: Re: [Freetype] Where are there man/info pages?
Date: Sat, 07 Jul 2001 17:32:01 +0200 (CEST)

> > > 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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]