From owner-freebsd-doc Wed Aug 14 9:10:10 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 29E0637B400 for ; Wed, 14 Aug 2002 09:10:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3759843E70 for ; Wed, 14 Aug 2002 09:10:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g7EGA2JU094050 for ; Wed, 14 Aug 2002 09:10:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g7EGA2fu094049; Wed, 14 Aug 2002 09:10:02 -0700 (PDT) Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7862537B400 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-1.0 Subject: docs/41666: sysctl -w used in docs, though "-w" is deprecated and ignored Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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 sysctl -w book.html: class="COMMAND">sysctl -w book.html:"USERINPUT">sysctl -w kern.fallback_elf_brand=3 Binary file book.txt matches linuxemu-mathematica.html:"USERINPUT">sysctl -w kern.fallback_elf_brand=3 linuxemu-mathematicau.html:"USERINPUT">sysctl -w kern.fallback_elf_brand=3 natd.html: "COMMAND">sysctl -w net.inet.ip.forwarding=1 pppoe.html: class="COMMAND">sysctl -w ./faq/book.html:"USERINPUT">sysctl -w kern.timecounter.method=1 ./faq/book.html:"USERINPUT">sysctl -w kern.timecounter.hardware=i8254 ./faq/book.html:"USERINPUT">sysctl -w vfs.usermount=1 ./faq/book.html:"USERINPUT">sysctl -w net.inet.icmp.icmplim=300 ./faq/book.html:"USERINPUT">sysctl -w net.inet.icmp.icmplim_output=0 ./faq/troubleshoot.html:"USERINPUT">sysctl -w kern.timecounter.method=1 ./faq/troubleshoot.html:"USERINPUT">sysctl -w kern.timecounter.hardware=i8254 ./faq/networking.html:"USERINPUT">sysctl -w net.inet.icmp.icmplim=300 ./faq/networking.html:"USERINPUT">sysctl -w net.inet.icmp.icmplim_output=0 Binary file ../faq/book.txt matches ./faq/disks.html:"USERINPUT">sysctl -w vfs.usermount=1 >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