Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 1 Aug 2011 18:19:33 +0200
From:      Joel Dahl <joel@vnode.se>
To:        Hiroki Sato <hrs@FreeBSD.org>
Cc:        svn-src-head@FreeBSD.org, svn-src-all@FreeBSD.org, src-committers@FreeBSD.org, doc@FreeBSD.org, joel@FreeBSD.org
Subject:   Re: svn commit: r224533 - head/share/man/man4
Message-ID:  <20110801161933.GN14345@goofy03.vnode.local>
In-Reply-To: <20110801.121233.1052535658641629145.hrs@allbsd.org>
References:  <201107302309.p6UN9rhJ019321@svn.freebsd.org> <20110801.121233.1052535658641629145.hrs@allbsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On 01-08-2011 12:12, Hiroki Sato wrote:
> Hi Joel,
> 
> Joel Dahl <joel@FreeBSD.org> wrote
>   in <201107302309.p6UN9rhJ019321@svn.freebsd.org>:
> 
> jo> Author: joel (doc committer)
> jo> Date: Sat Jul 30 23:09:52 2011
> jo> New Revision: 224533
> jo> URL: http://svn.freebsd.org/changeset/base/224533
> jo>
> jo> Log:
> jo>   Add a better description, a few examples and a couple of minor fixes.
> jo>
> jo>   Reviewed by:	brueffer
> jo>   Approved by:	re (kib)
> jo>
> jo> Modified:
> jo>   head/share/man/man4/pcm.4
> jo>
> jo> Modified: head/share/man/man4/pcm.4
> jo> ==============================================================================
> 
> (snip)
> 
> jo> @@ -173,7 +244,7 @@ controls (bass and treble).
> jo>  Commonly used for ear-candy or frequency compensation due to the vast
> jo>  difference in hardware quality.
> jo>  EQ is disabled by default, but can be enabled with the
> jo> -.Va hint.pcm. Ns Ao Ar X Ac Ns Va .eq
> jo> +.Va hint.pcm.%d.eq
> 
>  :
> 
> jo> -.It Va hint.pcm. Ns Ao Ar X Ac Ns Va .eq
> jo> +.It Va hint.pcm.%d.eq
> 
>  :
> 
> jo> -.It Va hint.pcm. Ns Ao Ar X Ac Ns Va .vpc
> jo> +.It Va hint.pcm.%d.vpc
> 
>  I know several manual pages are also using this expression (%d) for
>  replaceables, but I am wondering if this is friendly for average
>  users.  Is ".Ar N" for an integer problematic, for example?  I would
>  like comments since other documents in DocBook have used such a
>  notation for a long time and I feel we need consistency with them.

I changed it to be consistent with the rest of the manual page, but I'm also
not a big fan of using %d as it might be a bit confusing for some users...

-- 
Joel



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20110801161933.GN14345>