docs/125587: FAQ entry 5.13 -- adjustion is not an English word; tunable?

[Ben Kaduk]

The following reply was made to PR docs/125587; it has been noted by GNATS.

From: "Ben Kaduk" <minimarmot at gmail.com>
To: "Mike Small" <smallm at panix.com>
Cc: freebsd-gnats-submit at freebsd.org
Subject: Re: docs/125587: FAQ entry 5.13 -- adjustion is not an English word; tunable?
Date: Mon, 14 Jul 2008 06:11:12 -0400

 [sigh, hit reply instead of reply-all; sorry Mike]
 
 On Sun, Jul 13, 2008 at 11:16 PM, Mike Small <smallm at panix.com> wrote:
 >
 >>Number:         125587
 >>Category:       docs
 >>Synopsis:       FAQ entry 5.13 -- adjustion is not an English word; tunable?
 >>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:   Mon Jul 14 03:20:01 UTC 2008
 >>Closed-Date:
 >>Last-Modified:
 >>Originator:     Mike Small
 >>Release:        7.0-RELEASE
 >>Organization:
 >>Environment:
 > FreeBSD rex 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008     root at logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
 >>Description:
 > First of all, the second sentence in paragraph three of FAQ entry 5.13 uses the word "adjustion".  I don't believe this is a word in English.  Probably the word "adjustment" would be more suitable.
 >
 > Secondly, the same paragraph also uses the word "tunable" as a noun.  Is this a term people use in BSD?  I mean, it's clear what's meant from the context, but using "variable" or "sysctl variable", as is done in the first paragraph, seems clearer and less strange to me.
 >
 > Lastly, the word "in" is repeated: "If this tunable needs adjustion it needs to be defined in in /boot/loader.conf"
 
 
 
 You are correct -- `adjustion' should be ``adjustment'', and the
 doubled `in' should be corrected.
 
 However, `tunable' is a technical term in this context, referring to
 a kernel variable that can be set at boot time but not changed
 after the system is running -- this particular one resizes several
 static kernel data structures.
 
 Thanks for pointing these out!
 
 -Ben Kaduk