On Wed, Apr 29, 2009 at 05:28:52PM +0530, Bharath Kumar wrote:

> Well, I slotted it as a library since we are providing  jar files which
> the developers can use to develop server and client applications to
> manage resources.

I don't think we have an expectation to find Java developer documentation
in man pages.  I would expect HTMLized javadoc available on the net, and
possibly on the machine as well (as presumably you have in
/usr/share/docs/wiseman).

I would, however, expect a man page for every command delivered into a
directory that would be on someone's PATH, even if it were fairly simple
and didn't do much more than give a quick description of what the command
did, and how to find more information.

FWIW, there's no need to post updated documentation every time you respond
to a comment on the list, particularly for something as simple as a
one-word change.  There are other folks who have been doing this a great
deal in other cases, and we're just ending up with dozens of copies of the
entire set of case materials in the mail log to no real purpose.  There's
the original set, and there should be the final set.  If the materials have
changed significantly since the case started, but the case hasn't converged
yet, there may be a call for updated materials to be posted, but that
should generally be done a) on request, and b) directly into the case
directory, rather than to the list, which should simply receive a notice
that this has been done.

Thanks,
Danek

Reply via email to