From nobody@FreeBSD.org  Wed Aug 14 09:07:03 2002
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7862537B400
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Aug 2002 09:07:03 -0700 (PDT)
Received: from www.freebsd.org (www.FreeBSD.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1D35943E72
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Aug 2002 09:07:03 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.4/8.12.4) with ESMTP id g7EG72OT001420
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Aug 2002 09:07:02 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.4/8.12.4/Submit) id g7EG72Im001419;
	Wed, 14 Aug 2002 09:07:02 -0700 (PDT)
Message-Id: <200208141607.g7EG72Im001419@www.freebsd.org>
Date: Wed, 14 Aug 2002 09:07:02 -0700 (PDT)
From: Mark Stosberg <mark@summersault.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: sysctl -w used in docs, though "-w" is deprecated and ignored
X-Send-Pr-Version: www-1.0

>Number:         41666
>Category:       docs
>Synopsis:       sysctl -w used in docs, though "-w" is deprecated and ignored
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 14 09:10:01 PDT 2002
>Closed-Date:    Thu Aug 15 14:08:41 PDT 2002
>Last-Modified:  Thu Aug 15 14:08:41 PDT 2002
>Originator:     Mark Stosberg
>Release:        4.5-RELEASE
>Organization:
Summersault.com
>Environment:
FreeBSD 4.5-RELEASE #0: Thu Jun 27 14:58:27 EST 2002 i386
>Description:
This may or may not be a bug, depending on your documentation policy. :) I noticed that there are several mentions in the current documentation of "sysctl -w", although the "-w" doesn't mean anything on current systems. If your goal with the documentation is to focus on the current systems, it might make sense to remove the now-useless "-w" option from these examples. However, if you want to leave it there to remain compatible with older versions of FreeBSD, that makes sense too. 
>How-To-Repeat:
Here's a simple grep that catches several mentions of this. There may be others:

[/usr/share/doc/handbook]
root@reidhosp> grep -R 'sysctl -w' * ../faq/
book.html:              command <tt class="COMMAND">sysctl -w
book.html:                      class="COMMAND">sysctl -w
book.html:"USERINPUT"><b>sysctl -w kern.fallback_elf_brand=3</b></tt>
Binary file book.txt matches
linuxemu-mathematica.html:"USERINPUT"><b>sysctl -w kern.fallback_elf_brand=3</b></tt>
linuxemu-mathematicau.html:"USERINPUT"><b>sysctl -w kern.fallback_elf_brand=3</b></tt>
natd.html:                "COMMAND">sysctl -w net.inet.ip.forwarding=1</tt>
pppoe.html:        class="COMMAND">sysctl -w
./faq/book.html:"USERINPUT"><b>sysctl -w kern.timecounter.method=1</b></tt>
./faq/book.html:"USERINPUT"><b>sysctl -w kern.timecounter.hardware=i8254</b></tt>
./faq/book.html:"USERINPUT"><b>sysctl -w vfs.usermount=1</b></tt>
./faq/book.html:"USERINPUT"><b>sysctl -w net.inet.icmp.icmplim=300</b></tt>
./faq/book.html:"USERINPUT"><b>sysctl -w net.inet.icmp.icmplim_output=0</b></tt>
./faq/troubleshoot.html:"USERINPUT"><b>sysctl -w kern.timecounter.method=1</b></tt>
./faq/troubleshoot.html:"USERINPUT"><b>sysctl -w kern.timecounter.hardware=i8254</b></tt>
./faq/networking.html:"USERINPUT"><b>sysctl -w net.inet.icmp.icmplim=300</b></tt>
./faq/networking.html:"USERINPUT"><b>sysctl -w net.inet.icmp.icmplim_output=0</b></tt>
Binary file ../faq/book.txt matches
./faq/disks.html:"USERINPUT"><b>sysctl -w vfs.usermount=1</b></tt>

>Fix:
Remove "-w" option in these locations
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Wed Aug 14 14:54:55 PDT 2002 
Responsible-Changed-Why:  
I'll take this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41666 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Thu Aug 15 14:05:32 PDT 2002 
State-Changed-Why:  
I fixed it in the Handbook since this latter covers 4.X branch. 
For the FAQ and the articles, it should not be changed: sysctl -w is the 
only way to set a sysctl variable for 2.X and 3.X (the FAQ covers 2.X, 
3.X and 4.X). 

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