From mboxrd@z Thu Jan  1 00:00:00 1970
From: Takashi Iwai <tiwai@suse.de>
Subject: Re: [alsa-utils] alsaucm should come with a man page
Date: Wed, 03 Aug 2016 17:57:49 +0200
Message-ID: <s5hmvkt975u.wl-tiwai@suse.de>
References: <20160727114828.9d6c709d80084b659426e6cc@ao2.it>
Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka")
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Return-path: <alsa-devel-bounces@alsa-project.org>
Received: from mx2.suse.de (mx2.suse.de [195.135.220.15])
 by alsa0.perex.cz (Postfix) with ESMTP id 3530F26690E
 for <alsa-devel@alsa-project.org>; Wed,  3 Aug 2016 17:57:51 +0200 (CEST)
In-Reply-To: <20160727114828.9d6c709d80084b659426e6cc@ao2.it>
List-Unsubscribe: <http://mailman.alsa-project.org/mailman/options/alsa-devel>,
 <mailto:alsa-devel-request@alsa-project.org?subject=unsubscribe>
List-Archive: <http://mailman.alsa-project.org/pipermail/alsa-devel/>
List-Post: <mailto:alsa-devel@alsa-project.org>
List-Help: <mailto:alsa-devel-request@alsa-project.org?subject=help>
List-Subscribe: <http://mailman.alsa-project.org/mailman/listinfo/alsa-devel>,
 <mailto:alsa-devel-request@alsa-project.org?subject=subscribe>
Errors-To: alsa-devel-bounces@alsa-project.org
Sender: alsa-devel-bounces@alsa-project.org
To: Antonio Ospite <ao2@ao2.it>
Cc: alsa-devel@alsa-project.org, Stefan Schmidt <stefan@slimlogic.co.uk>, Liam Girdwood <lrg@slimlogic.co.uk>, Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>, Justin Xu <justinx@slimlogic.co.uk>
List-Id: alsa-devel@alsa-project.org

On Wed, 27 Jul 2016 11:48:28 +0200,
Antonio Ospite wrote:
> 
> Hi,
> 
> I used alsaucm to test mixer use cases for an Intel Baytrail tablet, I
> wanted to use bare alsa before bringing pulseaudio in, and it took some
> time to get my head around it.
> 
> The output from the "alsaucm --help" is too terse, I had to look at the
> alsa-lib code[1] to see the possible IDENTIFIERs, and even then it was
> not clear to me that some operations, like for instance "list _devices",
> can only work after setting a _verb in the same _execution_, for
> instance this sequence doesn't work:
> 
> # alsaucm -c bytcr-rt5640 set _verb HiFi
> # alsaucm -c bytcr-rt5640 list _devices
> 
> But this command does:
>   
> # alsaucm -c bytcr-rt5640 -b - <<EOM
> set _verb HiFi
> list _devces
> EOM
> 
> Now that I know something more it makes sense: UCM just operates on
> mixer settings, it does not have its own external state.
> 
> However, my point is that a man page explaining these things can make
> the life easier to new users.
> 
> It would be better if alsa/UCM developers wrote the man page, but if no
> one steps up I guess I could draft a first version myself.

Go ahead, please post your draft version.  That's already helpful.


thanks,

Takashi