docs/171759: portsnap man page is misleading

[Paul Hoffman]

>Number:         171759
>Category:       docs
>Synopsis:       portsnap man page is misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Sep 18 23:10:07 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Paul Hoffman
>Release:        8.3
>Organization:
>Environment:
FreeBSD hoffman.proper.com 8.3-RELEASE-p3 FreeBSD 8.3-RELEASE-p3 #0: Mon Jun 11 23:52:38 UTC 2012     root at i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
The first tip in the portsnap man page says:
     o   If your clock is set to local time, adding the line

               0 3 * * * root /usr/sbin/portsnap cron

         to /etc/crontab is a good way to make sure you always have an up-to-
         date snapshot of the ports tree available which can quickly be
         extracted into /usr/ports.

"extracted" is wrong: it should be "updated". However, it is misleading because it doesn't tell you *how* you can quickly update the ports, which is obviously what most people want to do. 
>How-To-Repeat:

>Fix:
     o   If your clock is set to local time, adding the line

               0 3 * * * root /usr/sbin/portsnap cron update

         to /etc/crontab is a good way to make sure you always have an up-to-
         date snapshot of the ports tree in /usr/ports.  

>Release-Note:
>Audit-Trail:
>Unformatted: