From owner-freebsd-doc@FreeBSD.ORG  Mon Jan 21 15:26:03 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id C86AA16A47B
	for <freebsd-doc@freebsd.org>; Mon, 21 Jan 2008 15:26:03 +0000 (UTC)
	(envelope-from jhb@freebsd.org)
Received: from elvis.mu.org (elvis.mu.org [192.203.228.196])
	by mx1.freebsd.org (Postfix) with ESMTP id B38A013C457
	for <freebsd-doc@freebsd.org>; Mon, 21 Jan 2008 15:26:03 +0000 (UTC)
	(envelope-from jhb@freebsd.org)
Received: from zion.baldwin.cx (66-23-211-162.clients.speedfactory.net
	[66.23.211.162]) by elvis.mu.org (Postfix) with ESMTP id D567C1A4D84;
	Mon, 21 Jan 2008 07:04:13 -0800 (PST)
From: John Baldwin <jhb@freebsd.org>
To: freebsd-doc@freebsd.org
Date: Mon, 21 Jan 2008 10:06:42 -0500
User-Agent: KMail/1.9.7
References: <20080121111755.GA28672@blackbone.openportal.org.ua>
In-Reply-To: <20080121111755.GA28672@blackbone.openportal.org.ua>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200801211006.42247.jhb@freebsd.org>
Cc: sin@openportal.org.ua
Subject: Re: Incaccuracy in the Handbook
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 21 Jan 2008 15:26:03 -0000

On Monday 21 January 2008 06:17:56 am sin@openportal.org.ua wrote:
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html
> 
> Quote:
> "(for obscure technical reasons, IRQ2 = IRQ 9)"
> 
> Doesn't it seen to you that this sounds like a huge ignorance when stated in 
> a fundamental document like FreeBSD handbook? If you just want to omit some
> unnescessary technical details, maybe, you should rather just say "for 
> technical reasons" instead?
> 
> P.S. Just for that case if an author of this chapter didn't know why it happens
> that way:
> 
> "IRQ 2 - Cascaded signals from IRQs 8-15. A device configured to use IRQ 2 
> will actually be using IRQ 9"
> http://en.wikipedia.org/wiki/Interrupt_request

Perhaps s/obscure/obtuse/.  It actually is obscure to a lot of folks who
aren't intimately familiar with x86 internals.

-- 
John Baldwin