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

Re: Mandatory -dbg packages for libraries? (and API docs too)



Stefano Zacchiroli <zack@debian.org> writes:

> Fair enough, but note that having man pages is actually addressed by the
> policy. Why do you think API doc shouldn't? After all man pages are docs
> for users and API doc are too, with the only difference that in the
> latter case the "users" are programmers.

In my case, because of:

    binary-without-manpage (1283 packages, 3616 tags)

I think we should demonstrate our ability to deliver on tasks we've
already promised to do before promising to do even more in the same vein.
Good library API documentation is in many cases much harder to write than
a man page for a binary.  Many of those already diagnosed missing man
pages are a matter of a few minutes to write a brief man page for a
wrapper script or simple utility.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>



Reply to: