From owner-freebsd-newbies@FreeBSD.ORG Fri Dec 24 19:37:35 2004 Return-Path: Delivered-To: freebsd-newbies@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2B61616A4CE for ; Fri, 24 Dec 2004 19:37:35 +0000 (GMT) Received: from sccimhc91.asp.att.net (sccimhc91.asp.att.net [63.240.76.165]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB0BD43D31 for ; Fri, 24 Dec 2004 19:37:34 +0000 (GMT) (envelope-from freebsd@nbritton.org) Received: from [192.168.1.10] (12-223-129-46.client.insightbb.com[12.223.129.46]) by sccimhc91.asp.att.net (sccimhc91) with ESMTP id <20041224193732i9100rfl2qe>; Fri, 24 Dec 2004 19:37:34 +0000 Message-ID: <41CC6FFB.10408@nbritton.org> Date: Fri, 24 Dec 2004 13:37:31 -0600 From: Nikolas Britton User-Agent: Mozilla Thunderbird 1.0 (X11/20041219) X-Accept-Language: en-us, en MIME-Version: 1.0 To: Giorgos Keramidas References: <000401c4e96a$4213de20$6400a8c0@musal32mpxlg> <200412232002.50704.krinklyfig@spymac.com> <20041224060441.GC19192@parts-unknown.org> <20041224150022.GB1699@gothmog.gr> In-Reply-To: <20041224150022.GB1699@gothmog.gr> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit cc: David Benfell cc: freebsd-newbies@freebsd.org Subject: Re: Manpage interpreter X-BeenThere: freebsd-newbies@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Gathering place for new users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Dec 2004 19:37:35 -0000 Giorgos Keramidas wrote: >On 2004-12-23 22:04, David Benfell wrote: > > >>On Thu, 23 Dec 2004 20:02:49 -0800, Joshua Tinnin wrote: >> >> >>>I don't think there is any such thing as an interpreter, per se, but >>>if there is something confusing about a manpage, you can ask. >>> >>> >>It's even been known to happen that man pages can get revised (though >>I think my experience with this was with OpenBSD). >> >> > >This happens with FreeBSD all the time too. When something is >confusing, and the freebsd-doc team learns about it, we do try to reword >the confusing parts, even rewrite entire sections of the manpages. > >The important bit here is that we have to be told what *is* confusing :) > >- Giorgos > > > Ok here you go, 1. The man page for nice is misleading, it says to use "nice -n num# command" but we all know that won't work "nice: Badly formed number." it should say "nice -/+num# command" 2. Secion 7.2.3 (Utilizing Multiple Sound Sources) implies that hw.snd.maxautovchans is only usefull for kernel loadable sound modules, this is not true: "To set the number of virtual channels, there are two sysctl knobs which, if you are the root user, can be set like this: # sysctl hw.snd.pcm0.vchans=4 # sysctl hw.snd.maxautovchans=4 The above example allocates four virtual channels, which is a practical number for everyday use. hw.snd.pcm0.vchans is the number of virtual channels pcm0 has, and is configurable once a device has been attached. hw.snd.maxautovchans is the number of virtual channels a new audio device is given when it is attached using kldload(8). Since the pcm module can be loaded independently of the hardware drivers, hw.snd.maxautovchans can store how many virtual channels any devices which are attached later will be given."