From owner-freebsd-doc@FreeBSD.ORG Sun May 8 20:03:09 2005 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9DBEC16A4E7 for ; Sun, 8 May 2005 20:03:09 +0000 (GMT) Received: from relay.rdsnet.ro (gimli.rdsnet.ro [193.231.236.70]) by mx1.FreeBSD.org (Postfix) with SMTP id 10C4143DA5 for ; Sun, 8 May 2005 20:03:08 +0000 (GMT) (envelope-from itetcu@people.tecnik93.com) Received: (qmail 2930 invoked from network); 8 May 2005 19:55:41 -0000 Received: from unknown (HELO smtp.rdsnet.ro) (62.231.74.130) by smtp1-133.rdsnet.ro with SMTP; 8 May 2005 19:55:41 -0000 Received: (qmail 5583 invoked by uid 89); 8 May 2005 20:15:59 -0000 Received: from unknown (HELO it.buh.tecnik93.com) (81.196.204.98) by 0 with SMTP; 8 May 2005 20:15:59 -0000 Received: from it.buh.tecnik93.com (localhost.buh.tecnik93.com [127.0.0.1]) by it.buh.tecnik93.com (Postfix) with ESMTP id 4F31811417; Sun, 8 May 2005 23:03:05 +0300 (EEST) Date: Sun, 8 May 2005 23:03:04 +0300 From: Ion-Mihai Tetcu To: Roman Neuhauser Message-ID: <20050508230304.5de3ea23@it.buh.tecnik93.com> In-Reply-To: <20050508101708.GB3232@isis.sigpipe.cz> References: <1115337385.0@it.buh.tecnik93.com> <20050506044846.2473f92c@it.buh.tecnik93.com> <20050507122226.3ef86c5e@it.buh.tecnik93.com> <20050508101708.GB3232@isis.sigpipe.cz> X-Mailer: Sylpheed-Claws 1.0.4 (GTK+ 1.2.10; i386-portbld-freebsd5.4) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org cc: FreeBSD gnats submit cc: pav@freebsd.org Subject: Re: docs/80681: articles/problem-reports: don't tell people they should sumbit a PR each time they see an outdated port X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 08 May 2005 20:03:09 -0000 On Sun, 8 May 2005 12:17:08 +0200 Roman Neuhauser wrote: > # itetcu@people.tecnik93.com / 2005-05-07 12:22:26 +0300: > > The only reason for "outdated announce" PR is that maybe someday someone > > other that a commiter (as a commiter is busy enough) will start looking > > in the PR database for something to do; now we all know how interested > > is the mythical Someone to do just that. IMO the practical value of this > > PR equals zero (even less since they generate supplementary work for the > > commiters - and the typical wait time for a non-commiter maintainer > > update is about a week this days). > > > > Now if the port is maintained, to have a PR announcing you there's a new > > version is usually frustrating: you know there's a new version, you > > probably have worked with the developer on it, you're probably testing > > to see there's no regression, etc. So this kind of PRs do the same good > > as a simple email (which can be useful if you maintain a large number of > > ports or for the ports that are updated rarely - I use a monthly cron > > job to remind me of them). > > I used the above text as a base for this patch; I haven't tested > it compiles. > > Index: en_US.ISO8859-1/articles/problem-reports/article.sgml > =================================================================== > RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/problem-reports/article.sgml,v > retrieving revision 1.36 > diff -u -u -r1.36 article.sgml > --- en_US.ISO8859-1/articles/problem-reports/article.sgml 15 Jan 2005 02:16:42 -0000 1.36 > +++ en_US.ISO8859-1/articles/problem-reports/article.sgml 8 May 2005 10:11:30 -0000 > @@ -107,6 +107,20 @@ > software (mainly ports, but also externally maintained base > system components such as BIND or various GNU > utilities). > + For unmaintained ports (MAINTAINER contains > + ports@FreeBSD.org), such update notifications > + might get picked up by an interested > + committer, or you might be asked to provide a patch to update > + the port; providing it upfront will greatly improve your chances > + that the port will get updated in a timely manner. > + If the port is maintained, PRs announcing new upstream releases > + are usually not very useful since they generate supplementary work > + for the commiters, and the maintainer likely knows already there's > + a new version, they have probably worked with the developers on it, > + they're probably testing to see there's no regression, etc. > + In either case, following the process described in + url="&url.books.porters-handbook;/port-upgrading.html">Porter's > + Handbook will yield the best results. > > I'd say it better that my original and should be committed. -- IOnut Unregistered ;) FreeBSD "user"