freebsd-doc Digest, Vol 331, Issue 4

[Johan Kuuse]

> Date: Wed, 29 Jul 2009 16:01:51 GMT
> From: Glen Barber <glen.j.barber at gmail.com>
> Subject: docs/137243: [patch] Minor grammatical fixes to Handbook
> 	Section	24.2.2
> To: freebsd-gnats-submit at FreeBSD.org
> Message-ID: <200907291601.n6TG1ptk082497 at www.freebsd.org>
> 
> 
> >Number:         137243
> >Category:       docs
> >Synopsis:       [patch] Minor grammatical fixes to Handbook Section 24.2.2
> >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:   Wed Jul 29 16:10:04 UTC 2009
> >Closed-Date:
> >Last-Modified:
> >Originator:     Glen Barber
> >Release:        8.0-BETA2
> >Organization:
> >Environment:
> FreeBSD orion 8.0-BETA2 FreeBSD 8.0-BETA2 #11 r195886: Sun Jul 26 05:27:01 EDT 2009     root at orion:/usr/obj/usr/src/sys/ORION  i386
> >Description:
> Section 24.2.2 [1] of the handbook contains minor grammatical errors.  The handbook states the following:
> "This entry states that once every day, the freebsd-update will be ran." 
> 
> This should either be: 
> 
> a - This entry states that once every day, freebsd-update will run.
> 
> or
> 
> b - This entry states that once every day, the freebsd-update utility will be run.
> 
> 
> [1] - http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/updating-upgrading-freebsdupdate.html
> >How-To-Repeat:
> 
> >Fix:
> The attached patch contains a grammatical fix for the handbook, assuming the first case in the description of this PR
> 
> 
> 
> 
> Patch attached with submission follows:
> 
> --- cutting-edge/chapter.sgml.orig	2009-07-29 11:46:13.000000000 -0400
> +++ cutting-edge/chapter.sgml	2009-07-29 11:50:23.000000000 -0400
> @@ -281,8 +281,8 @@
>  
>        <programlisting>@daily                                  root    freebsd-update cron</programlisting>
>  
> -      <para>This entry states that once every day, the
> -	<command>freebsd-update</command> will be ran.  In this way,
> +      <para>This entry states that once every day, 
> +	<command>freebsd-update</command> will run.  In this way,
>  	using the <option>cron</option> argument,
>  	<command>freebsd-update</command> will only check if updates
>  	exist.  If patches exist, they will automatically be downloaded
> 
> 
> >Release-Note:
> >Audit-Trail:
> >Unformatted:

The crontab examples itself has an incorrect syntax:

BAD (current example):
@daily                                  root freebsd-update cron

Working example:
@daily                                  /usr/sbin/freebsd-update cron

Regards,
Johan