From patchwork Mon Sep 15 12:28:40 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 322 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757939389; bh=yzAKrcM2b9GXXsBqb2IwEG3rhBQlLBEPrC3YdywAGD8=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=eqF92Y647IEQNt4SeJvU6wdII7UOpLpqcgI3EoGx4HcsjJzsM5wgIyCHcSaEuP7gA hbDpAssH8TG6TlYuSaDD1LiWY0xPIlLWHVynaevcWEs3c/i6Bmgvc1/n2pzsrekMFB hXbz8pabzqeiNzsUvwafuKhPWQZq6pH82G8gv4TRAWnRTbi+Tbp4KraBMlssexo/0+ XNCiHcTKc8pacTl8PWxphjihxKir6LicAIKOOAMzjltqCTc1B7coR8lwK+UwHujIDu Jm5h3x2KR1I7DHi5rKEBOBGcRHMm/XFwm6a8F2Zslp2FEkUEqLoX6xP8YyDORYYjrX EnyiPSisCstSw== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id B6D2E67BCA for ; Mon, 15 Sep 2025 06:29:49 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id SngQnippfvH7 for ; Mon, 15 Sep 2025 06:29:49 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757939388; bh=yzAKrcM2b9GXXsBqb2IwEG3rhBQlLBEPrC3YdywAGD8=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=B6rX3QbPRmuGIAAv+HlXxIP55v7bdtajxa6VmbS7YaIg3ozqluRz12UIg4bzx+Pn3 Q9Xte4+LQW5fzK9H9Sg+cowlwA9QFFjk/EKXRKW46ufo321hTdDwMXzLUd/vdUDiPY u0B9dAtpg2IYqd6KwiysLeeL3D1sMUmV71wriI9EuSugFF9BiA0nma1Xzpg9r8qkV7 zfxKy4QPohhqoblPBCKMrmTig2Try/1jPAGHP6tg8BANj2YbkYjLdZ8b2dI+HqRwwi 7q5utQtOf5t9YWzAwS90BXcBtO44I7QbJJfoAUTeW++mukQd5oPkUoM3xyMf5FD7rx /2rqOqrO73BQw== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 636EA67BAC for ; Mon, 15 Sep 2025 06:29:48 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757939387; bh=pcSMGn6mma2+uf/6kz9xRqvkniOexDH2BReNn3rgje0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=TH8ePpONwgS6d/FxWJGakYOByaUczDB/qwZ4a3LpbFC6H2FygQ8o80mEiX71uBaMz /chYLVyd982F/8PaF9NLO3PhrmtLfYaDVohvgiwSoVamPvJ0Gmk9e4z34dhBf9/SHj 67duIcX1fcE2tFFl7xs0hQgvWb7JE4diJSJZyn+ydbM03oZvS38gKkAFG08hJP3+K4 Do6vT0BXSs9sqzZ1aEpc6qxwGJt8Vg9jlqZy5eJpKmWZ0DWLJSUZUA3G8fysmoJw5H ZamEU2EmSJE8atJGtzBKm5UIaSnsBK1Rfxh+AQ8pHzud2NQZDDQCNhqZEX3CfwH5fc LzYTKPYkGSk7w== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 661D267BCA; Mon, 15 Sep 2025 06:29:47 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id wbBwYaEgsLLW; Mon, 15 Sep 2025 06:29:47 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757939384; bh=Ds6XUdl7o0F54dEwOg8cXttAZBZ3xcXrGq3MLqU3ngQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KjnfsDf/chqi2h376u7nSQPfMRdNRLQ415motRlQC9ei8+PwW2WQvDZdNSMp+zrne kQtSaSioM7N5wmgpJfg/T7tK6wl1y99sIiTi1zKJ03V6cWExuLbFJCW78V/PVetq5Q qOP88fMPSDr/UwrsldyYPuuT9CKnWIwCVV6w9pAEFkm7GrHTny5irx5CovmNyvpcd1 KFLv/TAPxnpCawNaVA89G02fq7LZ3LhqbfCooqOvJ9BkRVSVpdnpV297yvBIokY+ug PKI528EJqygZGyy6uhT7Et+rANRQIQjJQgORGUpargd+A2Np+waU98nlZ6EIKtJUD2 SaWJTHy7maApQ== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id 3959167BD0; Mon, 15 Sep 2025 06:29:44 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Mon, 15 Sep 2025 06:28:40 -0600 Message-ID: <20250915122905.1217249-8-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250915122905.1217249-1-sjg@u-boot.org> References: <20250915122905.1217249-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: BB72RVBJVAZLHJ72QKW74NGIU34ZUZWV X-Message-ID-Hash: BB72RVBJVAZLHJ72QKW74NGIU34ZUZWV X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Heinrich Schuchardt , Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 07/23] expo: Add comments for enum bootmenu_id_t List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Document the ranges in this enum, so it is clear what they a used for. Signed-off-by: Simon Glass --- boot/bootflow_internal.h | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/boot/bootflow_internal.h b/boot/bootflow_internal.h index 4cdb6966a7b..0b17a23bfd7 100644 --- a/boot/bootflow_internal.h +++ b/boot/bootflow_internal.h @@ -9,8 +9,18 @@ #ifndef __BOOTFLOW_INTERNAL_H #define __BOOTFLOW_INTERNAL_H -/* expo IDs for elements of the bootflow menu */ -enum { +/** + * enum boomenu_id_t - expo IDs for elements of the bootflow menu + * + * The ranges below are as follows: + * + * @ITEM: Menu items + * @ITEM_LABEL: Short Media or other label to indicate what it is, e.g. "mmc0" + * @ITEM_DESC: Longer description or pretty name, e.g. "Ubuntu 2024.04 LTS" + * @ITEM_KEY: Keypress to select this item, e.g. "1" + * @ITEM_PREVIEW: Preview image for the OS + */ +enum boomenu_id_t { START, /* strings */