From owner-freebsd-stable@FreeBSD.ORG Thu Feb 6 18:53:02 2014 Return-Path: Delivered-To: stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 30863A64; Thu, 6 Feb 2014 18:53:02 +0000 (UTC) Received: from theravensnest.org (theraven.freebsd.your.org [216.14.102.27]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id EC4A5187B; Thu, 6 Feb 2014 18:53:01 +0000 (UTC) Received: from [192.168.0.7] (cpc28-cmbg15-2-0-cust64.5-4.cable.virginm.net [86.27.189.65]) (authenticated bits=0) by theravensnest.org (8.14.7/8.14.5) with ESMTP id s16IqnQB070545 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Thu, 6 Feb 2014 18:52:51 GMT (envelope-from theraven@FreeBSD.org) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 7.0 \(1822\)) Subject: Re: RFC: deprecation of nve(4) in 10-STABLE and removal from 11-CURRENT From: David Chisnall In-Reply-To: <201402061834.s16IYgDK044802@fire.js.berklix.net> Date: Thu, 6 Feb 2014 18:52:43 +0000 Content-Transfer-Encoding: quoted-printable Message-Id: References: <201402061834.s16IYgDK044802@fire.js.berklix.net> To: "Julian H. Stacey" X-Mailer: Apple Mail (2.1822) Cc: pyunyh@gmail.com, stable@freebsd.org, "current@freebsd.org Current" , Christian Brueffer X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 06 Feb 2014 18:53:02 -0000 On 6 Feb 2014, at 18:34, Julian H. Stacey wrote: > Best avoid the obscure word `Deprecated' in manuals: > It's not common/ plain English. Maybe a geek import, or USA > dialect ? It's not easily internationaly understood English. > Best make manuals easier for non native English speakers (& native > English too ;-). I am British born & bred, whether in English > speaking circles in UK or Germany I never hear or read 'deprecated' > unless its in BSD context. Few native English speakers I know will = be > immediately sure of the meaning, it's too obscure. I'd strongly disagree with this. Deprecated is, perhaps, only in common = use as jargon, but it's very widespread within the tech field. I don't = think I've ever read an API reference that doesn't include the word, for = example, and it's even a keyword in many code documentation tools. For = example, JavaDoc supports @deprecated and gcc / clang include an = __attribute__((deprecated)) that generates a compile-time warning = whenever anyone tries to call a deprecated function. =20 I've not come across the word outside of tech uses, but I've also not = come across the term network interface outside of tech circles. = Deprecated, in this use, may be jargon, but it's very widespread jargon, = and requesting it not be used sounds like asking for words like driver = or processor also be avoided. David (Also a native English speaker, although familiar with the unofficial = fork from Leftpondia)=