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

[Muhammad Moinur Rahman]

r383799.

On Sat, Apr 11, 2015 at 6:23 PM, Alexey Dokuchaev <danfe at freebsd.org> wrote:

> 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
>