Date: Sun, 22 Feb 2009 15:11:41 -0800 From: Garrett Cooper <yanefbsd@gmail.com> To: Doug Barton <dougb@freebsd.org> Cc: Alexander Motin <mav@freebsd.org>, FreeBSD Current <freebsd-current@freebsd.org> Subject: Re: Annoying whitenoise sound coming from snd_hda enabled chipset Message-ID: <7d6fde3d0902221511l1f221f50sb91dd086147edcb4@mail.gmail.com> 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> <alpine.GSO.1.10.0902211333260.28932@multics.mit.edu> <7d6fde3d0902211356h66b05cfcxf2ebbe9b2a6fd0f0@mail.gmail.com> <49A07A1A.2030902@FreeBSD.org> <49A1C41A.5070504@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Feb 22, 2009 at 1:31 PM, Doug Barton <dougb@freebsd.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?7d6fde3d0902221511l1f221f50sb91dd086147edcb4>