From owner-freebsd-ports@FreeBSD.ORG Sun Apr 5 12:33:00 2009 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D7ABC106566B for ; Sun, 5 Apr 2009 12:33:00 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.27]) by mx1.freebsd.org (Postfix) with ESMTP id 62B778FC1E for ; Sun, 5 Apr 2009 12:32:59 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by ey-out-2122.google.com with SMTP id 4so403388eyf.7 for ; Sun, 05 Apr 2009 05:32:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; bh=CA1aDixju9QfNUL4e+fvWHAN6hNCI66zIkZ9TMuCtCU=; b=axbH2d4e/125S1Br68myPvamE88eRskD84ul7A2ZMq0L9fCjSokr+188ifJvw28zEE c3bROLBB+7RGZHgijdwotwl76X+dWIYpqphKN42T9UWytnGW5DUYVU6EBM3c1JswJKzM 8GgbBzfQyx4vmQvW7n2EeM+gXrTtXpS7+hofI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:date:from:organization:user-agent:mime-version:to :cc:subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=RIB5AWo9kd+anY2L5XT1joPqfJkFJernGWuObFSeEz2buFBUwnhqf8Ko2ugbl7m0lg ff0sPKKEEwbHvCafUOm1Nq19jldWIAuUzWFebDpvxI60YHvQhB8FINNkucWc7IwrKtYZ UGK19xSpZ3EQ2JGBDElUb07e0VGA4N675w87c= Received: by 10.210.137.17 with SMTP id k17mr688448ebd.88.1238934779124; Sun, 05 Apr 2009 05:32:59 -0700 (PDT) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id 10sm5368944eyd.53.2009.04.05.05.32.58 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 05 Apr 2009 05:32:58 -0700 (PDT) Sender: Rene Ladan Message-ID: <49D8A4F9.3060602@freebsd.org> Date: Sun, 05 Apr 2009 14:32:57 +0200 From: Rene Ladan Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.21 (X11/20090404) MIME-Version: 1.0 To: Matthew Seaman References: <20090404072204.28191678@scorpio> <49D75693.1030802@infracaninophile.co.uk> <20090404093151.344c9868@scorpio> <49D7654C.8010608@infracaninophile.co.uk> In-Reply-To: <49D7654C.8010608@infracaninophile.co.uk> X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-ports@freebsd.org Subject: Re: Adding comment to UPDATING file X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Apr 2009 12:33:01 -0000 Matthew Seaman schreef: > Jerry wrote: >> On Sat, 04 Apr 2009 13:46:11 +0100 >> Matthew Seaman wrote: > >>> I find it's also a good idea to add a warning about such things to >>> any pkg_message printed out at install time. >> >> Thanks! I was considering the pkg_message idea; however, users of >> Portupgrade or other port maintenance tools often do not see the >> messages printed out out the end of the installation. I will be >> including a message though. > > portmaster saves up all the pkg_messages and displays them at the end > of the update session. I believe moves are afoot to add similar behaviour > to some other ports management tools. > > Also: > > pkg_info -Dx portname > is a command that should be more widely known and used. > >> Maybe they should add an addendum to the Porter's Handbook >> describing that. > > If you send an e-mail to freebsd-doc@... or send-pr with some suggested > text, > it or something similar is fairly likely to be incorporated. Even > better if > you send a patch against the Docbook sources, but on the whole just having > some suggested text to work with is acceptable. Although right now is Both plain text and SGML are fine, altough the latter is easier to incorporate. Don't forget to mention the section where to place it. > maybe > not the best time as I think the docs slush preparatory to 7.2-RELEASE is > imminent, if not already here... > The slush will start at April 10. This does not mean that every commit has to be approved, unlike commits to ports when the ports tree is frozen. It is meant as a slowdown (no big patches or patches that move a lot of text around) to allow translators to catch up and for the doceng/re team to start building the documentation for the CD/DVD images. Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = ADBC ECCD EB5F A6B4 549F 600D 8C9E 647A E564 2BFC (subkeys.pgp.net)