From nobody@FreeBSD.org  Fri Dec 19 16:57:27 2008
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 DB1091065675
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 19 Dec 2008 16:57:27 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id CBC868FC16
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 19 Dec 2008 16:57:27 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id mBJGvRG7068124
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 19 Dec 2008 16:57:27 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id mBJGvRCn068123;
	Fri, 19 Dec 2008 16:57:27 GMT
	(envelope-from nobody)
Message-Id: <200812191657.mBJGvRCn068123@www.freebsd.org>
Date: Fri, 19 Dec 2008 16:57:27 GMT
From: "Ben C. O. Grimm" <freebsd@bengrimm.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: man 8 shutdown does not explain operation without command-line options
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         129765
>Category:       docs
>Synopsis:       shutdown(8) does not explain operation without command-line options
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 19 17:00:02 UTC 2008
>Closed-Date:    Wed Apr 01 06:19:50 UTC 2009
>Last-Modified:  Wed Apr  1 08:40:03 UTC 2009
>Originator:     Ben C. O. Grimm
>Release:        7.1-PRERELEASE
>Organization:
None
>Environment:
FreeBSD hail.bengrimm.net 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #0: Mon Dec  1 17:04:32 CET 2008     root@hail.bengrimm.net:/usr/obj/usr/src/sys/HAIL  i386
>Description:
The manual for shutdown(8) describes how the command behaves using command-line options like -h or -p, but not the behavior when omitting these options, like in 'shutdown now'. 

There is a brief mention of 'bringing the system down to single-user state' (which is what 'shutdown now' actually does), but it is not explained. 

See how this might confuse users: http://forums.freebsd.org/showthread.php?p=6273
>How-To-Repeat:

>Fix:
Add a one-liner to the manual about the effect of not using command-line switches in the shutdown command.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Tue Dec 23 15:00:30 UTC 2008 
State-Changed-Why:  
I have committed a change to shutdown.8, thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Dec 23 15:00:30 UTC 2008 
Responsible-Changed-Why:  
Over to me, MFC reminder. 

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

From: "Ben C. O. Grimm" <Ben.Grimm@BenGrimm.net>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/129765: shutdown(8) does not explain operation without command-line
 options
Date: Wed, 04 Feb 2009 15:52:37 +0100

 MFC postponed or in the works?

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/129765: commit references a PR
Date: Wed,  1 Apr 2009 06:01:50 +0000 (UTC)

 Author: trhodes
 Date: Wed Apr  1 06:01:40 2009
 New Revision: 190605
 URL: http://svn.freebsd.org/changeset/base/190605
 
 Log:
   MFC r186431:
   
   Note that when shutdown is run without options, it will place
   the system into single user mode at the time specified.
   
   PR:		129765
   
   Approved by:	re (kib)
 
 Modified:
   stable/7/sbin/shutdown/   (props changed)
   stable/7/sbin/shutdown/shutdown.8
 
 Modified: stable/7/sbin/shutdown/shutdown.8
 ==============================================================================
 --- stable/7/sbin/shutdown/shutdown.8	Wed Apr  1 04:36:37 2009	(r190604)
 +++ stable/7/sbin/shutdown/shutdown.8	Wed Apr  1 06:01:40 2009	(r190605)
 @@ -28,7 +28,7 @@
  .\"     @(#)shutdown.8	8.2 (Berkeley) 4/27/95
  .\" $FreeBSD$
  .\"
 -.Dd December 11, 1998
 +.Dd December 23, 2008
  .Dt SHUTDOWN 8
  .Os
  .Sh NAME
 @@ -167,6 +167,12 @@ The
  file that
  .Nm
  created will be removed automatically.
 +.Pp
 +When run without options, the  
 +.Nm
 +utility will place the system into single user mode at the 
 +.Ar time
 +specified.
  .Sh FILES
  .Bl -tag -width /var/run/nologin -compact
  .It Pa /var/run/nologin
 _______________________________________________
 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: trhodes 
State-Changed-When: Wed Apr 1 06:19:28 UTC 2009 
State-Changed-Why:  
MFC to both 6 and 7 complete, thanks! 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/129765: commit references a PR
Date: Wed,  1 Apr 2009 06:19:11 +0000 (UTC)

 Author: trhodes
 Date: Wed Apr  1 06:18:51 2009
 New Revision: 190607
 URL: http://svn.freebsd.org/changeset/base/190607
 
 Log:
   MFC r186431:
   
   Note that when shutdown is run without options, it will place
   the system into single user mode at the time specified.
   
   PR:		129765
 
 Modified:
   stable/6/sbin/shutdown/   (props changed)
   stable/6/sbin/shutdown/shutdown.8
 
 Modified: stable/6/sbin/shutdown/shutdown.8
 ==============================================================================
 --- stable/6/sbin/shutdown/shutdown.8	Wed Apr  1 06:03:23 2009	(r190606)
 +++ stable/6/sbin/shutdown/shutdown.8	Wed Apr  1 06:18:51 2009	(r190607)
 @@ -28,7 +28,7 @@
  .\"     @(#)shutdown.8	8.2 (Berkeley) 4/27/95
  .\" $FreeBSD$
  .\"
 -.Dd December 11, 1998
 +.Dd December 23, 2008
  .Dt SHUTDOWN 8
  .Os
  .Sh NAME
 @@ -167,6 +167,12 @@ The
  file that
  .Nm
  created will be removed automatically.
 +.Pp
 +When run without options, the  
 +.Nm
 +utility will place the system into single user mode at the 
 +.Ar time
 +specified.
  .Sh FILES
  .Bl -tag -width /var/run/nologin -compact
  .It Pa /var/run/nologin
 _______________________________________________
 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"
 

From: "Ben C. O. Grimm" <freebsd@bengrimm.net>
To: trhodes@FreeBSD.org, bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/129765: shutdown(8) does not explain operation without command-line
 options
Date: Wed, 01 Apr 2009 10:36:10 +0200

 trhodes@FreeBSD.org wrote:
 > Synopsis: shutdown(8) does not explain operation without command-line options
 > 
 > State-Changed-From-To: patched->closed
 > State-Changed-By: trhodes
 > State-Changed-When: Wed Apr 1 06:19:28 UTC 2009
 > State-Changed-Why: 
 > MFC to both 6 and 7 complete, thanks!
 > 
 > http://www.freebsd.org/cgi/query-pr.cgi?pr=129765
 
 Thanks, guys!
 
 Ben, a.k.a. DutchDaemon, FreeBSD Forums.
>Unformatted:
