From owner-freebsd-doc@FreeBSD.ORG  Wed Jul  9 19:02:10 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 28D1DEA3
 for <freebsd-doc@freebsd.org>; Wed,  9 Jul 2014 19:02:10 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id C9C862E76
 for <freebsd-doc@freebsd.org>; Wed,  9 Jul 2014 19:02:09 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.9/8.14.9) with ESMTP id s69J232C071914
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Wed, 9 Jul 2014 13:02:03 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s69J23xY071911;
 Wed, 9 Jul 2014 13:02:03 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Wed, 9 Jul 2014 13:02:03 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Patrick Powell <papowell@astart.com>
Subject: Re: Handbook - mention portsnap in Section 5.3 - finding software,
 pkgng respository
In-Reply-To: <53BD617E.1040700@astart.com>
Message-ID: <alpine.BSF.2.11.1407091259460.69938@wonkity.com>
References: <53BD617E.1040700@astart.com>
User-Agent: Alpine 2.11 (BSF 23 2013-08-11)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Wed, 09 Jul 2014 13:02:03 -0600 (MDT)
Cc: freebsd-doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 09 Jul 2014 19:02:10 -0000

On Wed, 9 Jul 2014, Patrick Powell wrote:

> I notice that Section 5.3 - Finding Software describes how to search for 
> software but there are a couple
> of steps left out that might confuse a newbie.

...

> Note:  I think pkg is a GREAT improvement over the old pkg_add, but the 
> legacy documentation in the FreeBSD handbook needs to be updated.  If 
> somebody sends me either a set of files for Handbook Section 5.2, 5.3,  5.4
> or idiot level instructions on how to access the files (SVN, etc.) I will 
> edit them and submit them for comment.
> I can put the content in the files,  but some expert may need to massage the 
> formatting a bit.

We have a book for that:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/

The quick start shows the initial steps:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview-quick-start.html