Date: Sat, 03 Oct 2009 12:31:22 +0300 From: Manolis Kiagias <sonic2000gr@gmail.com> To: Jan Oppolzer <jan.oppolzer@gmail.com> Cc: doc@freebsd.org Subject: Re: A misunderstanding in FreeBSD Handbook Message-ID: <4AC719EA.2030400@gmail.com> In-Reply-To: <200910031057.03060.jan.oppolzer@gmail.com> References: <200910031057.03060.jan.oppolzer@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Jan Oppolzer wrote: > Hello, > > in my opinion, there's a little mistake in FreeBSD Handbook in section 24.3 > Portsnap: A Ports Collection Update Tool [1] which can confuse mainly > newcomers in FreeBSD. > > If portsnap was run previously then after 'portsnap fetch' should be executed > 'portsnap update' (as noted in 'man portsnap') instead of 'portsnap extract' > which is said in the handbook. > > At the end there's written to execute 'portsnap fetch update' to run both > processes consecutively, but it was stated to run 'fetch' and then 'extract'. > Which is misleading. > > I guess it'd be a good idea to mention differences in "extract" and "update" or > at least mention they exist and to read manual page for more information which > one to use and when. > > [1] http://www.freebsd.org/doc/en/books/handbook/updating-upgrading- > portsnap.html > > > Best regards, > Jan Oppolzer > Hi Jan, You are right, the Handbook does not differentiate between extract (which should be used the first time only) and update (to be used on subsequent runs). I'll have a try at rewording this today to get it in line with the man page. Thanks!
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4AC719EA.2030400>