From patchwork Thu Sep 28 05:27:08 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 146012 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:cae8:0:b0:403:3b70:6f57 with SMTP id r8csp3236316vqu; Thu, 28 Sep 2023 04:25:25 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEBpu5voo9os9/UEhw1IzeNfOxELGyK9IfaGu7sOBOO/Gua+usKPdnO3ozBNfe9FcUR5vH1 X-Received: by 2002:a17:903:456:b0:1c6:19db:7b69 with SMTP id iw22-20020a170903045600b001c619db7b69mr802616plb.66.1695900324873; Thu, 28 Sep 2023 04:25:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695900324; cv=none; d=google.com; s=arc-20160816; b=yAb3NW8PN8G9Zcrd2jSNJAZARmgmeL9X3ZgDL+xMHFnYifGKiEO0FvquNtC0shnNx1 RIQT3gdtg6jUXRMUdwTb1R4mfQuE7wH3wqWSd+YintFcBROj9W03tMsSSSmel7IerwUA XOSi1sgocsTSNDxl7gsjqW7PjcKjPxvqvyYA4OE2k+tDOjz7Ocf96FdbjPgUDzhMaESX LauwxkgQiHzk+XV3ExW/Qq7vxNzx4ndDvT6XqmeX8FoJhmHwctWEaEBfYTLEmxRY2tBZ xPBVVTDvIayhDGCX7ytBzTd6z4JaoNryKkt8+0VTkJUBoJkf+jjdofsDTUd20aFVQhSo QmTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=91JYLBFnZKjwBEAu9U+5Q6DScQJFvzg48kgHznaCaic=; fh=o7sAgB4CnSEzHCQZniSMcaQ1fkF714FZIKRiBQZXBcs=; b=tRlFWX+T+/FZZCP+WSHsEPKIokObzUL5l7+BAkFmW+OXPHdLj1+DQ8sEu+FLxc8whY 4AEt2fbQUEr4bVow+pxBMWLS9CFY75bd3SWbSH6RgQwl3fRnA3pY+stMVtzrXBNzHNKz l12xGm7lis7TNN3AF0IY8YCEsh3AwQn+WSEwV2Yp7KAQdYG0SdwvAG0+6GdXIRDX45wd 7/muLKnObb4O4LLC1SZ16ymeFE47Sw8SSgr876fzT04aylyE4k5YDuMFBHI39i4DfCMo LPeZKAje/cEO9X4Y2PsMe/30POY9Ckakm2uUojZn4nEYuBk8s35AaHWjC0CpHSuzwpxx t9uA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=Vxb3cF5o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id h11-20020a170902f54b00b001c5f15d24ffsi16435961plf.116.2023.09.28.04.25.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Sep 2023 04:25:24 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=Vxb3cF5o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 8B94480ADF21; Wed, 27 Sep 2023 22:27:32 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230180AbjI1F1T (ORCPT + 20 others); Thu, 28 Sep 2023 01:27:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40592 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229453AbjI1F1Q (ORCPT ); Thu, 28 Sep 2023 01:27:16 -0400 Received: from mail-qk1-x72a.google.com (mail-qk1-x72a.google.com [IPv6:2607:f8b0:4864:20::72a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9599DBF; Wed, 27 Sep 2023 22:27:15 -0700 (PDT) Received: by mail-qk1-x72a.google.com with SMTP id af79cd13be357-77574dec71bso176575685a.2; Wed, 27 Sep 2023 22:27:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1695878834; x=1696483634; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=91JYLBFnZKjwBEAu9U+5Q6DScQJFvzg48kgHznaCaic=; b=Vxb3cF5oB8WYdgLpRGmn+rWMIdwnWtC0pROz4hiCWqX8ShrwzAZ4AXTxlJbFYrRCsE epyK4JTs6xChbpLZprc1FcZMa1rRaCnPQiMryYEZLSi4KomdB54NkFrdcpWGND7PxOkV 81qNd8ELOySLKpD6p652XRDXlgnZEvbFp0+zBawEDCJwoQUNlD7uwMkyWWHzpTQXSMxi GEdDsG0+fTfpzVhnua546ZDrESOQx2OhGBcGerJfpOnAP7nTFnW2fkPFdeF9HnrGw0FP 2trv7aHrdeUlXDRTcscgwSz3zXlcXrr6HSJqgRGhHoxhRHnQnRNC70oE6Hh0w9twlTyf gxKA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695878834; x=1696483634; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=91JYLBFnZKjwBEAu9U+5Q6DScQJFvzg48kgHznaCaic=; b=vkDiDnlp5T0ofzOX3pz7SSTsKBTbIerSYe8+snJdUB2EK7JLxQqxY4QVmv6lFoew+g zqvK3paRAH/CKraL0ZPbVrv/uskwSXsEZNXD2HeuGQty1vPb10kXNhGjHSTUnnIggFOF n+1OqC5AtX++6RA4zS+IN8TOdcpVNeBon4vfiV1J5n9dXhVokt+qPgXZUxL6QE6RFtOW nd27hHtptt8niH3XGUlT4SovqLu+o6ews/NSPM+dp9N9cr2Sb3dXuTwNs/b+Ru8CUgit Rm6kpgZHhNaYLV1sEteC+F6X19/l/Hgzes1VBMyC1sfImTVAVw+EVM68wAkqGZT62eWj 1f1A== X-Gm-Message-State: AOJu0Yx6LUOinFoZ3/A9jXsgbMTG6zul1O/T87QqJLJkjGznpmx6Le4z gKLJwTS9/1vYgQE3aRs77iG/WZgHhIsxnQ== X-Received: by 2002:a05:620a:4550:b0:773:a9d4:e7f7 with SMTP id u16-20020a05620a455000b00773a9d4e7f7mr259770qkp.16.1695878834692; Wed, 27 Sep 2023 22:27:14 -0700 (PDT) Received: from debian.me ([103.124.138.83]) by smtp.gmail.com with ESMTPSA id br7-20020a056a00440700b00692cb1224casm8458108pfb.183.2023.09.27.22.27.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Sep 2023 22:27:14 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 7135A819448E; Thu, 28 Sep 2023 12:27:09 +0700 (WIB) From: Bagas Sanjaya To: Linux Networking , Linux Documentation , Linux Kernel Mailing List Cc: Vadim Fedorenko , Arkadiusz Kubalewski , Jiri Pirko , Jonathan Corbet , Bagas Sanjaya , "David S. Miller" Subject: [PATCH net-next v2 2/2] Documentation: dpll: wrap DPLL_CMD_PIN_GET output in a code block Date: Thu, 28 Sep 2023 12:27:08 +0700 Message-ID: <20230928052708.44820-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20230928052708.44820-1-bagasdotme@gmail.com> References: <20230928052708.44820-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1763; i=bagasdotme@gmail.com; h=from:subject; bh=NIK+r+umq9T+8ea3aOWEFkLVXITGU0Rtbys6y3sG4jM=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDKmivLH2p9yrmdK+RtUtN8wO2MRhOlH3D8/q59rHXYRdj 27LYyvqKGVhEONikBVTZJmUyNd0epeRyIX2tY4wc1iZQIYwcHEKwESWfGdkaCtiPPyx8vvnjXuv HpLXN9go9nG+uuPVWXGLb6S90XeZUszIMFW27VESn4WocIZazMN3ytd+6K4S6Ky7dyJ8suMvhhN rOAE= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Spam-Status: No, score=1.2 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.6 X-Spam-Level: * X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 27 Sep 2023 22:27:32 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778280378550819452 X-GMAIL-MSGID: 1778280378550819452 DPLL_CMD_PIN_GET netlink command output for mux-type pins looks ugly with normal paragraph formatting. Format it as a code block instead. Reviewed-by: Vadim Fedorenko Signed-off-by: Bagas Sanjaya Acked-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/driver-api/dpll.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/Documentation/driver-api/dpll.rst b/Documentation/driver-api/dpll.rst index 01eb4de867036f..69670deb8c4e09 100644 --- a/Documentation/driver-api/dpll.rst +++ b/Documentation/driver-api/dpll.rst @@ -119,19 +119,19 @@ with. If a pin was registered with multiple parent pins, they behave like a multiple output multiplexer. In this case output of a ``DPLL_CMD_PIN_GET`` would contain multiple pin-parent nested -attributes with current state related to each parent, like: +attributes with current state related to each parent, like:: -'pin': [{{ - 'clock-id': 282574471561216, - 'module-name': 'ice', - 'capabilities': 4, - 'id': 13, - 'parent-pin': [ - {'parent-id': 2, 'state': 'connected'}, - {'parent-id': 3, 'state': 'disconnected'} - ], - 'type': 'synce-eth-port' - }}] + 'pin': [{{ + 'clock-id': 282574471561216, + 'module-name': 'ice', + 'capabilities': 4, + 'id': 13, + 'parent-pin': [ + {'parent-id': 2, 'state': 'connected'}, + {'parent-id': 3, 'state': 'disconnected'} + ], + 'type': 'synce-eth-port' + }}] Only one child pin can provide its signal to the parent MUX-type pin at a time, the selection is done by requesting change of a child pin state