From owner-freebsd-doc@FreeBSD.ORG Sun Jul 22 15:19:41 2007 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5C48F16A417 for ; Sun, 22 Jul 2007 15:19:41 +0000 (UTC) (envelope-from andy.kosela@gmail.com) Received: from qb-out-0506.google.com (qb-out-0506.google.com [72.14.204.234]) by mx1.freebsd.org (Postfix) with ESMTP id 10CA413C474 for ; Sun, 22 Jul 2007 15:19:40 +0000 (UTC) (envelope-from andy.kosela@gmail.com) Received: by qb-out-0506.google.com with SMTP id a10so1570446qbd for ; Sun, 22 Jul 2007 08:19:40 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:mime-version:content-type:content-transfer-encoding:content-disposition; b=XmhMAXZ3RmJ11zdvVTH9EFuHN+TcJt7zqfMbcCSJ73izuWat3/VzKNMSOcXRmcUsnjjNfwLQtv6+ryba4L6UcDIbqy61Yfqyi+qef7C4qW6yciwW7r/ghHVViXduq6gf28cl6IyjDNXnKTMuVJmK+LCWH6L5x2FkCJ0Yx94u+74= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:mime-version:content-type:content-transfer-encoding:content-disposition; b=KPIf/5LER7lez7MG3nITkQt4E13AaiB5U5q7Uw7QsqAHZE90a2Xr4s/kVP5g3PgskbU/YS+Fmflxbne1Dy3vPVcxOhRg17Iv/PWFScL9J5ucFTz2FlHs8rCQHKkewxsYIf7gx/nTc+BSbWb6iaH2mAUAbpVny98vXFOWcWDSF7w= Received: by 10.114.175.16 with SMTP id x16mr2182625wae.1185116731988; Sun, 22 Jul 2007 08:05:31 -0700 (PDT) Received: by 10.114.12.19 with HTTP; Sun, 22 Jul 2007 08:05:31 -0700 (PDT) Message-ID: <3cc535c80707220805i1a7acafapeb547c728ad5e5d8@mail.gmail.com> Date: Sun, 22 Jul 2007 17:05:31 +0200 From: "Andy Kosela" To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline Cc: Doug Barton , andy.kosela@gmail.com Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 22 Jul 2007 15:19:41 -0000 Doug Barton wrote: > What I think would be more useful (and again, I'm speaking only for > myself) would be a list of tools available with a brief description of > each, and links to outside sources (web pages, pkg-descr files, etc.) > where an interested user can get more information. I do think that > letting our users know that there are tools available is a good thing, > I don't think mini-manuals for each tool is appropriate in that context. > > If anyone else thinks that this is a good idea, I'd be happy to > contribute a paragraph on portmaster, and help with rewriting that > section if desired. Hi all, I see that chinsan's commit generated some confusion and sparked a discussion about the overall goals of this chapter. Fist of all it wasn't me who submitted this new paragraph but I was asked by chinsan to write something on bpkg(8), because he wanted to include information about bpkg(8) in the Handbook. As Marc politely remarked the only "semi-official" tool is portupgrade(1) and I fully agree with him it should be the only one fully documented in the Handbook. I don't see any reason to include an additional nearly identical manual for portmanager (with all due respect to its creator). But at the same time I agree with Doug here when he says about the idea of creating a list of actively maintained ports management applications with a description of each. Letting the community know the alternatives is a good thing IMHO. Chinsan, Doug - will you be working on this? I am willing to offer my help if needed. Best regards, -- Andy Kosela Pythagoras Foundation "What is that which always is and has no becoming, and what is that which becomes but never is" Plato