From owner-svn-ports-all@FreeBSD.ORG Sat Apr 11 13:07:23 2015 Return-Path: Delivered-To: svn-ports-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1C4CA53F; Sat, 11 Apr 2015 13:07:23 +0000 (UTC) Received: from mail-ie0-f172.google.com (mail-ie0-f172.google.com [209.85.223.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id D22E47C; Sat, 11 Apr 2015 13:07:22 +0000 (UTC) Received: by iebrs15 with SMTP id rs15so36194537ieb.3; Sat, 11 Apr 2015 06:07:16 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=hkptRQgsPjJpz9aYIaI7EkmWfkE0a/kbW/AWXPDtP1A=; b=SXgZQwDI2328IKPb4OcvvMojrQVQnEZa0e8JMaoA40bH/e7hHBNgvSOY8kJ2JuUjTK yawH3y698tZ3WQQQmHuZcwtW+zwV4866jpMVcXPc7T1YPxnHQ/a6vAl5nKeDSFYiHjaK AHtKRAG43qKs8CA7S8DVt5dAb/SePKfNmppZiBISSpfFtr0WJ2HBCZcDDcPRN6UqkJht 3wVLZmV13qkUR0AZYB+/K6CANzXV+kYlEorw1Di7c5/ph19qjCchGpYcvGtzbqTlg4kG HkBZNh4GHpm6sE2t4ojkyWaR1X0u2rfLVTyIN1nM3meh0aFmX6/ARYy9mA+Ur0GcyILi HIPg== X-Received: by 10.42.88.206 with SMTP id d14mr9307793icm.40.1428757635989; Sat, 11 Apr 2015 06:07:15 -0700 (PDT) Received: from mail-ig0-f171.google.com (mail-ig0-f171.google.com. [209.85.213.171]) by mx.google.com with ESMTPSA id e4sm1245392igx.7.2015.04.11.06.07.15 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 11 Apr 2015 06:07:15 -0700 (PDT) Received: by igblo3 with SMTP id lo3so16530587igb.0; Sat, 11 Apr 2015 06:07:15 -0700 (PDT) MIME-Version: 1.0 X-Received: by 10.107.11.81 with SMTP id v78mr9449573ioi.66.1428757635161; Sat, 11 Apr 2015 06:07:15 -0700 (PDT) Received: by 10.64.164.99 with HTTP; Sat, 11 Apr 2015 06:07:15 -0700 (PDT) In-Reply-To: <20150411122342.GA92044@FreeBSD.org> References: <201504111139.t3BBda9a063948@svn.freebsd.org> <20150411114800.GA77956@FreeBSD.org> <20150411122342.GA92044@FreeBSD.org> Date: Sat, 11 Apr 2015 19:07:15 +0600 Message-ID: Subject: Re: svn commit: r383790 - in head/lang: . c From: Muhammad Moinur Rahman To: Alexey Dokuchaev Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.18-1 Cc: "svn-ports-head@freebsd.org" , "svn-ports-all@freebsd.org" , "ports-committers@freebsd.org" X-BeenThere: svn-ports-all@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the ports tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Apr 2015 13:07:23 -0000 r383799. On Sat, Apr 11, 2015 at 6:23 PM, Alexey Dokuchaev 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 > 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 >