From owner-freebsd-newbies@FreeBSD.ORG Fri Dec 24 19:47:37 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 874B516A4CE for ; Fri, 24 Dec 2004 19:47:37 +0000 (GMT) Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.26]) by mx1.FreeBSD.org (Postfix) with ESMTP id A2B5E43D2D for ; Fri, 24 Dec 2004 19:47:36 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a130.otenet.gr [212.205.215.130]) iBOJlSCi020723; Fri, 24 Dec 2004 21:47:31 +0200 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.13.1/8.13.1) with ESMTP id iBOJlRgc092492; Fri, 24 Dec 2004 21:47:27 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.13.1/8.13.1/Submit) id iBOJlRGC092491; Fri, 24 Dec 2004 21:47:27 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Date: Fri, 24 Dec 2004 21:47:27 +0200 From: Giorgos Keramidas To: Nikolas Britton Message-ID: <20041224194727.GA88657@gothmog.gr> References: <000401c4e96a$4213de20$6400a8c0@musal32mpxlg> <200412232002.50704.krinklyfig@spymac.com> <20041224060441.GC19192@parts-unknown.org> <20041224150022.GB1699@gothmog.gr> <41CC6FFB.10408@nbritton.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <41CC6FFB.10408@nbritton.org> 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:47:37 -0000 On 2004-12-24 13:37, Nikolas Britton wrote: >Giorgos Keramidas wrote: >>>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 :) > > 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" What version of FreeBSD are you using? The manpage matches the behavior of the utility here, but this is FreeBSD 6.0-CURRENT. % $ nice -n 12 ls -l /dev/null % crw-rw-rw- 1 root wheel 2, 2 Dec 24 21:40 /dev/null % % $ nice -n +12 ls -l /dev/null % crw-rw-rw- 1 root wheel 2, 2 Dec 24 21:40 /dev/null % % $ nice -n -12 ls -l /dev/null % nice: setpriority: Permission denied % crw-rw-rw- 1 root wheel 2, 2 Dec 24 21:40 /dev/null The manpage also says: % COMPATIBILITY % The traditional -increment option has been deprecated but is % still supported. > 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." I see. Do you think it's ok if I mention attaching at boot time too, e.g. like this? 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). + channels a new audio device is given when it is attached at boot + time or when loaded as a module with kldload(8). Does this seem better? :-) - Giorgos