Received: by 2002:a05:6500:1b45:b0:1f5:f2ab:c469 with SMTP id cz5csp251925lqb; Tue, 16 Apr 2024 14:50:37 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCWML4aKrNg5jCLcGhj7M7AhnK91UWZUDZMauPuDAamAERoS0lZGaQZmJMhWDrzUVuipXnBYK590L0dyAbMEMTLI/nBq7USEY2z0u27oIA== X-Google-Smtp-Source: AGHT+IH3asuNUX5op/BNDJcH5fiqGXZpie0k2vdNClUxCn1cJcPc8AJJBzvaaWg/fJt3/zd2Zqwu X-Received: by 2002:a17:902:b194:b0:1e3:e25c:fa5c with SMTP id s20-20020a170902b19400b001e3e25cfa5cmr12636887plr.67.1713304237342; Tue, 16 Apr 2024 14:50:37 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1713304237; cv=pass; d=google.com; s=arc-20160816; b=ks6FJbb5j0gY57Q88iB8KZ3LpoGCS2y9jh/Dfidxr7rXXGrvq6S8qFbuxp+jwVWFF2 M7Kj8KrlCEXYHznVYXFPIa7XD3020dMRM93e82eDCeZ8Ep8FTGvLl8kPmJu1oeIaIyVN RlhJknnKjTIk2nsBTmZWqsmA0cABPM0b6BTAh+hUAPL/wAc/TlG9R8uo7NQOiYte65Sc NpxpOb5kYD2hMjlLaJ3FYADtnrh2MK+o4biV6DVIGwkfcvlvXSsQRGJJimD7EZ3ZffZz zKoL3FwINTROwXpbl2JI6DaCGcy01TfGfYBRHttqsJ5RFh3ecMQlZBr4ewuZHgALFFkh 8pCA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:content-disposition:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:message-id:subject:cc :to:from:date:dkim-signature; bh=rppgb29WBPwJgBwf6YcIy3zYefYu53Agf92ysrhH2uo=; fh=FKYZcxO7sOO0b2BBeKp8vh4qKQaq6R1uLJQ291vebg4=; b=jxRFKDcLgDLOD9qCjEMazvgpWUBrzPyZyh55sb+S/wtQKtE77/0qgXT0SJesOXpGux hgZuYBJNdh570KLgca9fAlVjt+FYfhYi2QQfLKcGlbvRZhcB3iHMlMt4T93eDMC+aUja CBUJgKngnf+Aaahz4RUcLIiPKFRMTDxBu8fdMrjFY4BJNsHb0RlXzSY68g/RCuqWo80L bNpf3+FfaG9hljLoxiaJIIi5K3gy/VFIT5ta5zCDOx/3zQSHwwR6Mgj2g2WPqaETktQA /zAWTKktzHmFu8pLhmJ/WUh2tqEea40l7kT7GW24Zqh/Ia1E4YlAKlpX4uZsVcVUcuDA ntHA==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=anx82zwj; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-147639-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-147639-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id o15-20020a170902d4cf00b001dcfaf5bfefsi10556323plg.573.2024.04.16.14.50.36 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Apr 2024 14:50:37 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-147639-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=anx82zwj; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-147639-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-147639-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 594C8B2438C for ; Tue, 16 Apr 2024 21:37:07 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A359B13C8EE; Tue, 16 Apr 2024 21:23:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="anx82zwj" Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 207CB13C664; Tue, 16 Apr 2024 21:23:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.70.183.197 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713302638; cv=none; b=Onjrng6Cib+ulRL8nWmDwOYlLPoVZPDmpOImbcURjpz0GN5OcpFJM+WWECZkp0pp4GrjRAgHNTAH5rLN46JHOhel6+ygwXeFOvLLUsTRk0cWByohj3Hix5Kf0vb+fAtdiOgdXEUVXdVViZ+gJ3xUNyWwAPO7Wk86qhitWEOVbHs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713302638; c=relaxed/simple; bh=AGxlsIIeZOw1hCiNiY9zQa7S35WYc82++11WQkIBkX0=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=pw7CuDhdkYnfOsQ1NYHKQyykd+azLmxMxURZXd7q9qTPOlJTiH5SNfV/F9PtS21f3s8TnzD/7MsWCg5ulCnqeuLJX1gcQnLcOtvhn26LRJclT9Axkc/ZsKgm8f3DV186H1J7cWC4GjSLapmfdziI273JCFdMT48wGxPViV7rHpA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=anx82zwj; arc=none smtp.client-ip=217.70.183.197 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Received: by mail.gandi.net (Postfix) with ESMTPSA id DB4C31C0002; Tue, 16 Apr 2024 21:23:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1713302634; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=rppgb29WBPwJgBwf6YcIy3zYefYu53Agf92ysrhH2uo=; b=anx82zwjU91TDZFpHnwmFVXoRJRahhjEqwJmYWqhwimW4kRFAgkJKlwQzrSn33dXCf9u9I tQ5ITL/hgKy4dhMS+kOfViBYgyL39P8YAvgNNxMNLL7ou5BzTfy0takhKxfYl4z0YJbfx2 0iHXXZ7nZzNZrcbzXxAWFqBeTHLlO83biwiXHbmM4wP1xZusKgAfh4utSs/3iWpdl0DopW DcbP2hcfwY+mc6GvkTb4VCqpPfU/g4S9g+kpZGbJC2fw8FU3GMftutRzIjS/pk+i0SF6up PpOAe3ruyo73gnCUbZJBE8XNBaAlE9Bfgk2iV5qNfTqRiGKKI0PWb/FJcKd79Q== Date: Tue, 16 Apr 2024 23:23:49 +0200 From: Alexandre Belloni To: Luca Ceresoli Cc: Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Jonathan Corbet , Thomas Petazzoni , linux-sound@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 00/12] ASoC: doc: dapm: various improvements Message-ID: <20240416212349079fdffc@mail.local> References: <20240416-dapm-docs-v1-0-a818d2819bf6@bootlin.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20240416-dapm-docs-v1-0-a818d2819bf6@bootlin.com> X-GND-Sasl: alexandre.belloni@bootlin.com On 16/04/2024 07:56:06+0200, Luca Ceresoli wrote: > This series applies various improvements to the DAPM documentation: a > rewrite of a few sections for clarity, style improvements and typo fixes. > > Signed-off-by: Luca Ceresoli Reviewed-by: Alexandre Belloni > --- > Luca Ceresoli (12): > ASoC: doc: dapm: fix typos > ASoC: doc: dapm: fix struct name > ASoC: doc: dapm: minor rewording I'm wondering whether you could improve this patch by not rewrapping the whole paragraph. > ASoC: doc: dapm: remove dash after colon > ASoC: doc: dapm: clarify it's an internal API > ASoC: doc: dapm: replace "map" with "graph" > ASoC: doc: dapm: extend initial descrption > ASoC: doc: dapm: describe how widgets and routes are registered > ASoC: doc: dapm: fix and improve section "Registering DAPM controls" > ASoC: doc: dapm: improve section "Codec/DSP Widget Interconnections" > ASoC: doc: dapm: update section "DAPM Widget Events" > ASoC: doc: dapm: update event types > > Documentation/sound/soc/dapm-graph.svg | 375 +++++++++++++++++++++++++++++++++ > Documentation/sound/soc/dapm.rst | 178 ++++++++++------ > 2 files changed, 494 insertions(+), 59 deletions(-) > --- > base-commit: 8f2c057754b25075aa3da132cd4fd4478cdab854 > change-id: 20240315-dapm-docs-79bd51f267db > > Best regards, > -- > Luca Ceresoli > -- Alexandre Belloni, co-owner and COO, Bootlin Embedded Linux and Kernel engineering https://bootlin.com