Date: Sat, 11 Apr 2015 19:07:15 +0600 From: Muhammad Moinur Rahman <bofh@FreeBSD.org> To: Alexey Dokuchaev <danfe@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: <CA%2BnPUkxPPLUNCgeQRaqwSgrUoHnociq5gnpk27tpHV_c1KsKkA@mail.gmail.com> In-Reply-To: <20150411122342.GA92044@FreeBSD.org> References: <201504111139.t3BBda9a063948@svn.freebsd.org> <20150411114800.GA77956@FreeBSD.org> <CA%2BnPUkxqhnbaoS==vW=yEOiDFkM1DuHHQUTyEGsJCJ=5%2BUCexw@mail.gmail.com> <20150411122342.GA92044@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
r383799. On Sat, Apr 11, 2015 at 6:23 PM, Alexey Dokuchaev <danfe@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@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?CA%2BnPUkxPPLUNCgeQRaqwSgrUoHnociq5gnpk27tpHV_c1KsKkA>