From nobody Tue Apr 7 20:07:29 2026 Received: from mail-wr1-f53.google.com (mail-wr1-f53.google.com [209.85.221.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 89C2F359A86 for ; Wed, 11 Mar 2026 16:33:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.53 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773246804; cv=none; b=NYAzcm4tOArqbnTBSyC6kAHByzz8pYy/FZ208a9Y0SnG4n7pPxSKpO0YJ2eOJpFoOcCSdhLMXI1oCiOaVdFHhd8NNYdY1yRlpBnWEYcCjgmOL0irDBQzZYjRhilwt3nvX4d3akj+e2s7lL+k1De7u1UN1m2VNomh51Vh/EiccKQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773246804; c=relaxed/simple; bh=vqXEHc0MX/ELy4nQN//vZz467e+MRBIE9/NcKUlUe/U=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=YOtxSC10eJcqZc5JYo/oTKPVInbT4bq7hhmj+m0xD1CgQ7XwvrWIaSpqe4myaBBaTBWmvVLwdFHiL6xrzagx2TA+lCqqltcwjPrBKbfk+kdJ7SIhBYt8im/ZnejIYPoPH/mdVyzqKEDlPtH9rYbT4ITOuYy3YK+Q0wqVALooVV8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=RNwSTCdy; arc=none smtp.client-ip=209.85.221.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="RNwSTCdy" Received: by mail-wr1-f53.google.com with SMTP id ffacd0b85a97d-439afc58ac7so102833f8f.0 for ; Wed, 11 Mar 2026 09:33:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773246802; x=1773851602; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=QZxQ/W7gUa+cqIc6WQ/7+HCXvezDqsbdntL4Eq/Kvzg=; b=RNwSTCdykJsjKDrFpLqqW7wH313XbNz/K127kdG+TgsEEKxF8MWgiRI2gKSwcGhpv0 xoJKzoQg5TsQ0u+xQLu4R54a26Obfs4zW0/7CEKFTfOTxVHDL/zyel5Dx8wbpSDU4quD M8pwRN+1B8QcykIgmn+xNuF957YW7L7OX+PEhnuRLPw387hV3KvI5Wx7xqReoFQ/z7ep 30pvg6lOjXJBaSJ/IaF3V1jgN7Ju646T3sMVDvrR6cA2hvpDhKR0Xe8JrwAQsL1/1eQw kyZmZzfqjI3C4ZT4TrTT+0HyEiiV2jlHgagSlLHClqFF1hRte9oLSio7NwRMdsEcxeH1 OpGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773246802; x=1773851602; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=QZxQ/W7gUa+cqIc6WQ/7+HCXvezDqsbdntL4Eq/Kvzg=; b=NJ6Zn664HPS5gmir6ZH4/wprNjmpfmCLeAU/TYH50qmaz50oN5Ec+0gN6MDplszRjp G5ozxR5qmX824lih03yhhiNVBsrXBk3CrAM4i/VrWjmXgLRM3xuBg1vFYQL7Y3jadEuo N7VANt1BcJL23l6KumAeKN8F2QI3Ki7YP+aX7QWiTJsr+Fl7pd1PpiGMJdmTOcXG2onK ZcYXiVNeiZhhrcOuKWd7KJBf+/g65lCToeeJ9X8FVC6z6GpM6r5zdffIPqTi9ohQ9QQd TE1acg/PwXKyB0pn++YaAi8wFOdBC7J283Xziq/Pp8yQNLomUdroFdCY2RQp998GJ7CG 2BdA== X-Forwarded-Encrypted: i=1; AJvYcCXIbV2KsCXD5uYDNi38tG4xMU+/MeZ65u4l2WPv/YBPS634228oZWUpzFd5nb01DKq+CP5sby78envlWQg=@vger.kernel.org X-Gm-Message-State: AOJu0YxIEqA617k9fTj4Dyaso0Poc3iF0BvTXNAOlHjNvadkLKhdvoBT LTbKyViOThaUvK8ue9M0w26WG+iUBMmS5EcjQZClDcJ+EW2b5ITYNTqHV8/WZCu/ X-Gm-Gg: ATEYQzxPq19mKuhj6EQ0DWYwHunHCbjuaJZ08TibYkaVZonGuhEKa7jzcT/f7Eo3cja 0SIl2U97M7Y1IMfSbNcQmepA6hUZlXlGte5JnLIsPEcZCpTV2DBW+LNNvobbnx7b0iMrOLHC7OT 92R1KpqoKqcv/qbDI+8AEcO/oI5RBZqe7qkCxqARJBIj9+X+eGiPozb18GLpcOBJA4ubTr8mpkq kBGO37KXqHuS3yUGo97dKMNHOttIo8h42WV44H6DCyXlPd7oxJMayTEvSJSgUgoZ7Ef5oCOzOJN fVAxiVW5EynQDlWLPFt8HJRKu4WWhO6cNIFRQLsNe4BlkQut59tZDucKqcXvWkwH4fJbeXrm3F+ ElDkhYYQ3Z4xES231gp54zh7/EOSlCbYjOFqmmWVLME92w70G6aviSfopjDp1NxVgFWi/X9n+2N tGO6Z8MF9qRXGulYCaNXpTnQPtCG21pFPElr9afh0qTAg2XmGm69m/ X-Received: by 2002:a05:6000:2509:b0:439:b28c:d47c with SMTP id ffacd0b85a97d-439f821a08fmr6553725f8f.37.1773246801682; Wed, 11 Mar 2026 09:33:21 -0700 (PDT) Received: from aldo-conte-t14.tailf68ad9.ts.net ([217.61.173.50]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-439fe2186e3sm404936f8f.26.2026.03.11.09.33.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Mar 2026 09:33:21 -0700 (PDT) From: Aldo Conte To: heikki.krogerus@linux.intel.com, gregkh@linuxfoundation.org Cc: linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] usb: typec: Document priority and mode_selection fields in struct typec_altmode Date: Wed, 11 Mar 2026 17:33:20 +0100 Message-ID: <20260311163320.61534-1-aldocontelk@gmail.com> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The fields 'priority' and 'mode_selection' in struct typec_altmode are missing from the kernel-doc comment, which results in warnings when building the documentation with 'make htmldocs'. WARNING: ./include/linux/usb/typec_altmode.h:44 struct member 'priority' no= t described in 'typec_altmode' WARNING: ./include/linux/usb/typec_altmode.h:44 struct member 'mode_selecti= on' not described in 'typec_altmode' Document both fields to keep the kernel-doc comment aligned with the structure definition. Signed-off-by: Aldo Conte Reviewed-by: Heikki Krogerus --- include/linux/usb/typec_altmode.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/include/linux/usb/typec_altmode.h b/include/linux/usb/typec_al= tmode.h index 0513d333b797..b90cc5cfff8d 100644 --- a/include/linux/usb/typec_altmode.h +++ b/include/linux/usb/typec_altmode.h @@ -26,6 +26,9 @@ struct typec_altmode_ops; * @mode: Index of the Mode * @vdo: VDO returned by Discover Modes USB PD command * @active: Tells has the mode been entered or not + * @priority: Priority used by the automatic alternate mode selection proc= ess + * @mode_selection: Whether entry to this alternate mode is managed by the + * automatic alternate mode selection process or by the specific driver * @desc: Optional human readable description of the mode * @ops: Operations vector from the driver * @cable_ops: Cable operations vector from the driver. --=20 2.53.0