Re: Re: [UnixOS2] libc

On Sat, Jul 19, 2003 at 01:50:52PM +0200, Andreas Buening wrote:
> > But this is an *orthogonal* target.

> It's not really orthogonal.

Well, I think it is.  ;-)

> If we start a new emx release we should also start to create docs in
> the final format.

I do not why this is a prerequisite.  It is a nuisance to cater to the
EMX format, but comparing with other workloads, this is peanuts.

> If function foo is updated then also an uptodate foo manpage (or
> whatever) has to be provided.

Absolutely.  But this "whatever" may be in EMX format too - while
other parts of the docs are not converted to the new format.

Hope this helps,
Ilya

P.S.  To see the description of POD, run

  perldoc perlpod

(or google for perlpod).  It is 5 pages total.  The sources of the
docs (i.e., what perldoc finds and shows) are in the installed Perl
tree, in the pod/ directory.

To see one example of mine:

  ilyaz.org/software/os2/os2hek-tools.*

(only POD and INF files are provided now).  Not very representative, though...