Date: Wed, 14 Aug 2002 09:07:02 -0700 (PDT) From: Mark Stosberg <mark@summersault.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/41666: sysctl -w used in docs, though "-w" is deprecated and ignored Message-ID: <200208141607.g7EG72Im001419@www.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 41666 >Category: docs >Synopsis: sysctl -w used in docs, though "-w" is deprecated and ignored >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 Aug 14 09:10:01 PDT 2002 >Closed-Date: >Last-Modified: >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: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200208141607.g7EG72Im001419>