Received: by 2002:ab2:69cc:0:b0:1f4:be93:e15a with SMTP id n12csp1862564lqp; Mon, 15 Apr 2024 22:56:33 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCVuLOezdkX4pbmK2kdEs+ImIBm4k2MvB0AMn9Z7VWkIMeL6wcXQ7mUiCDxDnhHYak2WFtxlEbHgU6nm1hJjE1Tv9OrUxztEXLzncFvtlQ== X-Google-Smtp-Source: AGHT+IE7Y5V2VK8FrNFDWNLQ3XzWXYhVFLS0dP2jsvYucgKOZ/M+uzG1k4lWQZOtEbMlYHcfNtjI X-Received: by 2002:ad4:4a65:0:b0:69b:6fb4:f0d1 with SMTP id cn5-20020ad44a65000000b0069b6fb4f0d1mr7368250qvb.62.1713246992766; Mon, 15 Apr 2024 22:56:32 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1713246992; cv=pass; d=google.com; s=arc-20160816; b=NHe5JdTVy3z8xVt+zDn4YaROyHib/4JZPa0FMErO4A991frFl+MOHrlt0XrSiF2s89 eZ1Y0dNR/CbBPHsAlUwsKT0l3Zs2B9AydVSVXFPq0lY7w6HUXBp3NckmMmL1rW1uJiaj FhVIa1fPaVdW/6ik3QGXFOe3ujUII0CLBk2UlBikG0Ra/HgehT3U3q7pBb7oJ3KMAhBo 5VAIayNiEbUMhDx7727RqoUUdFEYLcjEVT5MtY63vozGkITe1veCYRjyRrTdjizcGynD bnq6fga8wlVGFP12nPTWDQDQ7LaIw8K2ja+qUynsknwJyaB6TMofIc/BOa90uuyOTkqf n0Sg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:from :dkim-signature; bh=MYsxM8sUexu5PeidcDFg7wtBhZutdc0P4xRrT0as04E=; fh=RpUkPCO1yB9SrvCZK9/H1csNKJkfhSEm0lTOtlRGhag=; b=GiFCQsEl2BAHTrM1dvW4pQ/4zGqP46N5F8/n7g5h/EOPTI1WG1CvHkUvescvooH59t 0pUH6FC9RAtzEkoZ3oGNaIEZ9FlArwQVeIX68Q6bL8dhDFja6Kf5lD3Chy0h35Tf9fx+ WErB5xfNeBzmf03j2CMkkBTlJKCspQ3Q3sj2EdBqCkLJCbUAq7WwuPyDTyat45xRr5TQ IMCqm3YU3Wtyqawcw54F+ZXA63btOooJL/slvGvR3ap6ES7rRXUY2M8IyKeTPdCEz5q9 +1BXZbKTfnp3cfPA/21/bBc9TkM+iirZdreCDGkZwH4wcLAKfohq5bKmdckqLlDc3RoZ aZ7A==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=dMAFCz0X; 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-146292-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-146292-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id w9-20020a0cef89000000b006993d4fe1b7si11375684qvr.514.2024.04.15.22.56.32 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Apr 2024 22:56:32 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-146292-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=dMAFCz0X; 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-146292-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-146292-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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 6DD211C215BF for ; Tue, 16 Apr 2024 05:56:32 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 15D393BBCF; Tue, 16 Apr 2024 05:56:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="dMAFCz0X" Received: from relay1-d.mail.gandi.net (relay1-d.mail.gandi.net [217.70.183.193]) (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 419D61FA1; Tue, 16 Apr 2024 05:56:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.70.183.193 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713246984; cv=none; b=FxoTEI8MdhP5aY9kbFMACVYCV7XGAJzdgVnuuIzscZFSi8EtTl3p9nyGxEHS9sRbxpyndaG0dL7AV3kWEUdBFpHkwH2j/LL/1vYd+/yO0mfWhFbuS1FGoQzTGfIKAf1sIzrnB6kwHoVmOUSDxq5+goKZMHQi6dLn/4CipWI+um8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713246984; c=relaxed/simple; bh=G81PiCaYxRMH5Yr1uK64EHf3fyvJO8LewC0bgtkT7gA=; h=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc; b=Gwgr7IGz8jMHEqzAAgHmuSmI72XfQnL4rZZGNFtcoxjCyaoH7U1w6ESXIu7eG8iIDuErJNhlor8ZGfoR/qPHErxV0VNmQBjnJegb/Chk+WDyDwjoruBVjodeYDVaxfoc2jM1mXvTiFUy6xyKVAFojvhzlO5QFASFqR1CVxzJl2s= 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=dMAFCz0X; arc=none smtp.client-ip=217.70.183.193 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 DA68E240003; Tue, 16 Apr 2024 05:56:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1713246974; 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: content-transfer-encoding:content-transfer-encoding; bh=MYsxM8sUexu5PeidcDFg7wtBhZutdc0P4xRrT0as04E=; b=dMAFCz0XbNW8H5WJkyypAbjWjYkpXoJmGx9BlOkCQi4Atd1BkaeH7CtcBL+of1PNSbw3SA Z57stfHKQgbfhoAo0RMgdWJTOdg5Nixb1JyDA3a9wiQxWwFPjzWl4TTihw6SU5Et7TSf4x hNHpmp49CNMdWoUgrlbnVhEqthc4fEDrFCPpsKqDYIqLFZ5rP7MDZ/i+hBnpAB8wUyXxce 6gJaejS97CvHBs+sToD+UE8P++rSP3+3OGqw78s0423WBGPVue2yY/JTbs5OK7/AOLIyvD ugK2brVD00iP4z3lgpvKslQcqIONw+W8VFHHBY0qJJiMo0uBaYeXdMMbLhVWSQ== From: Luca Ceresoli Subject: [PATCH 00/12] ASoC: doc: dapm: various improvements Date: Tue, 16 Apr 2024 07:56:06 +0200 Message-Id: <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="utf-8" Content-Transfer-Encoding: 7bit X-B4-Tracking: v=1; b=H4sIAPYSHmYC/6tWKk4tykwtVrJSqFYqSi3LLM7MzwNyDHUUlJIzE vPSU3UzU4B8JSMDIxMDY0NT3ZTEglzdlPzkYl1zy6QUU8M0IzPzlCQloPqCotS0zAqwWdGxtbU A+qgurFsAAAA= To: Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Jonathan Corbet Cc: Alexandre Belloni , Thomas Petazzoni , linux-sound@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Luca Ceresoli X-Mailer: b4 0.13.0 X-GND-Sasl: luca.ceresoli@bootlin.com 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 --- Luca Ceresoli (12): ASoC: doc: dapm: fix typos ASoC: doc: dapm: fix struct name ASoC: doc: dapm: minor rewording 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