From nobody@FreeBSD.org  Mon Jul 11 15:26:05 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 31DF11065747
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jul 2011 15:26:05 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 096508FC1C
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jul 2011 15:26:05 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p6BFQ4M3036276
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jul 2011 15:26:04 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p6BFQ4Du036275;
	Mon, 11 Jul 2011 15:26:04 GMT
	(envelope-from nobody)
Message-Id: <201107111526.p6BFQ4Du036275@red.freebsd.org>
Date: Mon, 11 Jul 2011 15:26:04 GMT
From: Alexander Best <arundel@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] slightly improve shutdown(8) man page
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         158807
>Category:       docs
>Synopsis:       [patch] slightly improve shutdown(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 11 15:30:13 UTC 2011
>Closed-Date:    Fri Jul 22 01:01:28 UTC 2011
>Last-Modified:  Fri Jul 22 01:01:28 UTC 2011
>Originator:     Alexander Best
>Release:        9.0-CURRENT
>Organization:
>Environment:
FreeBSD otaku 9.0-CURRENT FreeBSD 9.0-CURRENT #23 r223911=11f0313-dirty: Mon Jul 11 00:20:49 CEST 2011     arundel@otaku:/usr/obj/usr/git-freebsd-head/sys/ARUNDEL  amd64
>Description:
While reading the shutdown(8) man page i found a couple of errors. The attached patch should take care of them.
>How-To-Repeat:

>Fix:
Apply the attached patch!

Patch attached with submission follows:

diff --git a/sbin/shutdown/shutdown.8 b/sbin/shutdown/shutdown.8
index 032c4f3..e7648d6 100644
--- a/sbin/shutdown/shutdown.8
+++ b/sbin/shutdown/shutdown.8
@@ -28,7 +28,7 @@
 .\"     @(#)shutdown.8	8.2 (Berkeley) 4/27/95
 .\" $FreeBSD$
 .\"
-.Dd December 30, 2010
+.Dd July 11, 2011
 .Dt SHUTDOWN 8
 .Os
 .Sh NAME
@@ -83,20 +83,20 @@ If one of the
 .Fl p
 or
 .Fl r
-is specified,
+options are specified,
 .Nm
 will execute
 .Xr halt 8
 or
 .Xr reboot 8
-instead of sending signal to
+instead of sending a signal to
 .Xr init 8 .
 .It Fl n
 If the
 .Fl o
-is specified, prevent the file system cache from being flushed by passing
+option is specified, prevent the file system cache from being flushed by passing
 .Fl n
-option to
+to
 .Xr halt 8
 or
 .Xr reboot 8 .
@@ -106,10 +106,10 @@ This option should probably not be used.
 is the time at which
 .Nm
 will bring the system down and
-may be the word
+may be the case-insensitive word
 .Ar now
 (indicating an immediate shutdown) or
-specify a future time in one of two formats:
+a future time in one of two formats:
 .Ar +number ,
 or
 .Ar yymmddhhmm ,
@@ -148,7 +148,7 @@ exits.
 .Pp
 At shutdown time a message is written to the system log, containing the
 time of shutdown, the person who initiated the shutdown and the reason.
-Corresponding signal is then sent to
+The corresponding signal is then sent to
 .Xr init 8
 to respectively halt, reboot or bring the system down to single-user state
 (depending on the above options).
@@ -176,16 +176,18 @@ utility will place the system into single user mode at the
 .Ar time
 specified.
 .Pp
-Calling utility as
+Executing
 .Nm poweroff
-is equivalent of calling:
+is equivalent to:
 .Bd -literal -offset indent
 shutdown -p now
 .Ed
 .Sh FILES
 .Bl -tag -width /var/run/nologin -compact
 .It Pa /var/run/nologin
-tells login not to let anyone log in
+tells
+.Xr login 1
+not to let anyone log in
 .El
 .Sh COMPATIBILITY
 The hours and minutes in the second time format may be separated by


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->gjb 
Responsible-Changed-By: arundel 
Responsible-Changed-When: Mon Jul 11 15:56:00 UTC 2011 
Responsible-Changed-Why:  
Over to Glen, as per request. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=158807 
State-Changed-From-To: open->patched 
State-Changed-By: gjb 
State-Changed-When: Thu Jul 14 02:41:58 UTC 2011 
State-Changed-Why:  
Committed to HEAD (r223991) with minor changes.  MFC in 1 week. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=158807 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: bin/158807: commit references a PR
Date: Thu, 14 Jul 2011 02:41:58 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Thu Jul 14 02:41:45 2011
 New Revision: 223991
 URL: http://svn.freebsd.org/changeset/base/223991
 
 Log:
   Improvements to the shutdown(8) manual.
   
   PR:		158807
   Submitted by:	arundel
   MFC after:	1 week
 
 Modified:
   head/sbin/shutdown/shutdown.8
 
 Modified: head/sbin/shutdown/shutdown.8
 ==============================================================================
 --- head/sbin/shutdown/shutdown.8	Thu Jul 14 00:15:26 2011	(r223990)
 +++ head/sbin/shutdown/shutdown.8	Thu Jul 14 02:41:45 2011	(r223991)
 @@ -28,7 +28,7 @@
  .\"     @(#)shutdown.8	8.2 (Berkeley) 4/27/95
  .\" $FreeBSD$
  .\"
 -.Dd December 30, 2010
 +.Dd July 13, 2011
  .Dt SHUTDOWN 8
  .Os
  .Sh NAME
 @@ -83,20 +83,20 @@ If one of the
  .Fl p
  or
  .Fl r
 -is specified,
 +options are specified,
  .Nm
  will execute
  .Xr halt 8
  or
  .Xr reboot 8
 -instead of sending signal to
 +instead of sending a signal to
  .Xr init 8 .
  .It Fl n
  If the
  .Fl o
 -is specified, prevent the file system cache from being flushed by passing
 +option is specified, prevent the file system cache from being flushed by passing
  .Fl n
 -option to
 +to
  .Xr halt 8
  or
  .Xr reboot 8 .
 @@ -106,10 +106,10 @@ This option should probably not be used.
  is the time at which
  .Nm
  will bring the system down and
 -may be the word
 +may be the case-insensitive word
  .Ar now
  (indicating an immediate shutdown) or
 -specify a future time in one of two formats:
 +a future time in one of two formats:
  .Ar +number ,
  or
  .Ar yymmddhhmm ,
 @@ -148,7 +148,7 @@ exits.
  .Pp
  At shutdown time a message is written to the system log, containing the
  time of shutdown, the person who initiated the shutdown and the reason.
 -Corresponding signal is then sent to
 +The corresponding signal is then sent to
  .Xr init 8
  to respectively halt, reboot or bring the system down to single-user state
  (depending on the above options).
 @@ -176,16 +176,18 @@ utility will place the system into singl
  .Ar time
  specified.
  .Pp
 -Calling utility as
 -.Nm poweroff
 -is equivalent of calling:
 +Calling
 +.Dq Nm poweroff
 +is equivalent to running:
  .Bd -literal -offset indent
  shutdown -p now
  .Ed
  .Sh FILES
  .Bl -tag -width /var/run/nologin -compact
  .It Pa /var/run/nologin
 -tells login not to let anyone log in
 +tells
 +.Xr login 1
 +not to let anyone log in
  .El
  .Sh COMPATIBILITY
  The hours and minutes in the second time format may be separated by
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Fri Jul 22 01:00:58 UTC 2011 
State-Changed-Why:  
MFCd to 8-STABLE and 7-STABLE.  Thanks! 


http://www.freebsd.org/cgi/query-pr.cgi?pr=158807 
>Unformatted:
