Re: clang manual page?

On Thu, Apr 05, 2018 at 08:11:50PM -0500, Benjamin Kaduk wrote:
> On Thu, Apr 05, 2018 at 05:56:24PM -0700, Steve Kargl wrote:
> > I never said that you said it was in base.  I'm noting that
> > referring a user to a non-existent manual page is of little
> > help.  In fact, your 7 word response is an affirmation that
> > the tools supplied in base should be properly documented.
> 
> It would probably be more useful to file explicit bug reports
> (or even write a patch) about missing or poor documentation, than
> to proffer passive-aggressive inquiries on public mailing lists
> that merely suggest but do not explicitly state that the
> documentation is deficient.
> 

There is nothing passive nor aggressive in asking about how
to use the tools supplied in base because its accompanying
documentation is substantially lacking in quality.  

It should be the responsibility of the individual (or individuals)
who import new software into base to ensure that it has proper
documentation.  Of course, the assumption is that this individual
has (or these individuals have) a familiarity with the software,
which should facilitate writing said documentation.  This started
8 year 10 months ago when clang pre-2.8 was committed without a
manpage.  The initial version of clang.1 appeared 7 year 6 months
ago.  FreeBSD is now at clang 6.0.0.  I fully anticipate that the
next import of clang will again have poor documentation.

To preempt a retort about "stop complaining and contribute a fix",
I'll note that all of my previous contributions that are in base have
been accompanied by documentation.

-- 
Steve