Date: Sat, 11 Apr 2015 12:23:42 +0000 From: Alexey Dokuchaev <danfe@FreeBSD.org> To: Muhammad Moinur Rahman <bofh@FreeBSD.org> Cc: "svn-ports-head@freebsd.org" <svn-ports-head@freebsd.org>, "svn-ports-all@freebsd.org" <svn-ports-all@freebsd.org>, "ports-committers@freebsd.org" <ports-committers@freebsd.org> Subject: Re: svn commit: r383790 - in head/lang: . c Message-ID: <20150411122342.GA92044@FreeBSD.org> In-Reply-To: <CA%2BnPUkxqhnbaoS==vW=yEOiDFkM1DuHHQUTyEGsJCJ=5%2BUCexw@mail.gmail.com> References: <201504111139.t3BBda9a063948@svn.freebsd.org> <20150411114800.GA77956@FreeBSD.org> <CA%2BnPUkxqhnbaoS==vW=yEOiDFkM1DuHHQUTyEGsJCJ=5%2BUCexw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20150411122342.GA92044>