svn commit: r383790 - in head/lang: . c

[Alexey Dokuchaev]

On Sat, Apr 11, 2015 at 05:58:44PM +0600, Muhammad Moinur Rahman wrote:
> The website also doesn't seem to be be that much informative other than
> some examples.

Please, don't top-quote.

> On Sat, Apr 11, 2015 at 5:48 PM, Alexey Dokuchaev <danfe at freebsd.org> wrote:
> > You've esentially quoted COMMENT (and, suddenly, pkg-descr) twice, but
> > I still don't quite understand what does this thing does and exactly
> > how it works. [...]
> >
> > Port description should not be just a copy of COMMENT.  Let me quote PHB:
> >
> >   "A well-written pkg-descr describes the port completely enough that
> >    users would not have to consult the documentation or visit the
> >    website to understand what the software does, how it can be useful,
> >    or what particularly nice features it has. [...]"

Muhammad, if upstream does not maintain their software well enough (that
includes documentation, of course), but FreeBSD ships it to our dear users,
it means that it becomes maintainer's job.  If maintainer fails to do his
or her job sufficiently well, it becomes responsibility of the committer.

(Frankly, I'm a bit surprised how frequently do I have to explain these
things.)

Play with it a bit (you say there're some examples) and tell us what the
heck is that thing.  Sending your text upstream is also a good idea. ;-)

./danfe