From owner-freebsd-current@FreeBSD.ORG Sun Feb 22 23:11:43 2009 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 18A731065688; Sun, 22 Feb 2009 23:11:43 +0000 (UTC) (envelope-from yanefbsd@gmail.com) Received: from el-out-1112.google.com (el-out-1112.google.com [209.85.162.181]) by mx1.freebsd.org (Postfix) with ESMTP id 8D05F8FC23; Sun, 22 Feb 2009 23:11:42 +0000 (UTC) (envelope-from yanefbsd@gmail.com) Received: by el-out-1112.google.com with SMTP id r27so1224854ele.13 for ; Sun, 22 Feb 2009 15:11:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=enXzSzMQ1cIXVb3pR7KJnXrJWvzoCQIwKPTOV9udzlo=; b=CPHBngwWKRVwmUKRQZZ1vBTDMwaGFfi8HaMa61+hcp6oIaBj8AvBHouKMxa/L0u4L5 O93q7hHEduCaH8q+jBYS5ynzJ3tTEfH0KDqLEdj1FVqwZYDAgF/W456+t+E2Y6qZbNVi BIkYG8PHhi2il/1NoVXoCB9js+1Fy/JiBFOcw= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=svMQxML9S5LZHWYNVr7yDRIQ9y1Fju4cHtw1BpQjAGu8fqbf41WNnOvl0yNIHocN3L qNsV5njVC8qus4LNfqg5ZDt7IHdaqEyVs74v4ETcWQ75VnIiLj6zQDO+vp5mY/ga7AHc 7HlY//bCn8HuAGd12S7LNsbtG6w2KIbr8crZM= MIME-Version: 1.0 Received: by 10.90.35.9 with SMTP id i9mr1108267agi.20.1235344301854; Sun, 22 Feb 2009 15:11:41 -0800 (PST) In-Reply-To: <49A1C41A.5070504@FreeBSD.org> References: <1235218982.00077642.1235207402@10.7.7.3> <499FFC5F.3020903@FreeBSD.org> <47d0403c0902210949i74473bc5j57c923e13c85e89@mail.gmail.com> <49A04510.5030405@FreeBSD.org> <7d6fde3d0902211356h66b05cfcxf2ebbe9b2a6fd0f0@mail.gmail.com> <49A07A1A.2030902@FreeBSD.org> <49A1C41A.5070504@FreeBSD.org> Date: Sun, 22 Feb 2009 15:11:41 -0800 Message-ID: <7d6fde3d0902221511l1f221f50sb91dd086147edcb4@mail.gmail.com> From: Garrett Cooper To: Doug Barton Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: Alexander Motin , FreeBSD Current Subject: Re: Annoying whitenoise sound coming from snd_hda enabled chipset X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 22 Feb 2009 23:11:44 -0000 On Sun, Feb 22, 2009 at 1:31 PM, Doug Barton wrote: > Alexander Motin wrote: >> It won't help. People never read manuals, especially long ones. :( > > While I can certainly sympathize with this (I frequently answer help > requests for mergemaster and portmaster with "It's in the manual") > it's always better to document stuff. There are at least _some_ users > who do actually RTFM, and when they don't, at least you don't have to > type the whole answer all over again. :) Exactly -- besides saying `RTFM in this manpage, section, here' is much more satisfying than having to rehash the same answer quite a few times. Btw, maybe the manpage for snd_hda should be split up into multiple manpages or put into a special chapter in the handbook? It is fairly long (but don't get me wrong -- the data is EXCELLENT!), but getting to point may help your readers stay on track ;). Just a thought ><. -Garrett