From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 453BC4401D; Mon, 13 May 2024 21:01:23 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 242C840608; Mon, 13 May 2024 21:01:23 +0200 (CEST) Received: from mail-pf1-f181.google.com (mail-pf1-f181.google.com [209.85.210.181]) by mails.dpdk.org (Postfix) with ESMTP id E2B0D402CD for ; Mon, 13 May 2024 21:01:21 +0200 (CEST) Received: by mail-pf1-f181.google.com with SMTP id d2e1a72fcca58-6f450f43971so3943951b3a.3 for ; Mon, 13 May 2024 12:01:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1715626881; x=1716231681; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:from:to:cc:subject:date :message-id:reply-to; bh=jfpM/S+iLNcHE13UQwkSbxAsXjyEb2+XF0r5lMbbRMU=; b=iskUl8lHJ2bJXoFaKSqlmfXk9Cgdwo0wgvZ43pOijG+oq/C1EIdNxQA9tz8FP0bovn xSd+GWKqZwXk7p6e1S29GeJxQABZijxTdIyJ5MSy/uRIRiTKrxGymd0iYBTtzOI2e0HZ qF9Ut0FKqEJTP0xn+kQOpCty0JiraYxOjcghoHIvteF6idbXucaJ3JtggIHESjxmzZua gVBrIU9HbN4BaqqMEXp4U0RYSGFKXEoHsBlLA/in0fUWZ5PBgcejWO92+4KCwHD8+Mq9 VPrM2uYYnQd4hiLtdUf12DaL2Yb5dVSgGEWFPPTpSRUYd+sc0etcckiMK90hfapBsXrq Lj2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1715626881; x=1716231681; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=jfpM/S+iLNcHE13UQwkSbxAsXjyEb2+XF0r5lMbbRMU=; b=R1sLsVWY5WjlvCuBb4mrKvCUWtjKmchLTkaqqfVYMHholjUEFk1BYeo6qW+QTxdM4h 6spazLRsBoyrEuE6yNzbeypqCPaVXgckO3Ygq/cC5sbtHfrO7WhNPWCH7ZqAj8Vpr/JL /z5mIOYZVGKec7/7Y8otvCq8Wu/V7P/AS5vrPTvc4S7P3Oq3Gx+7oYJKZF19k3CbQhlL iZpkhzD3zRF2xFXmA3teSgQggGNsNS2ILs9Q1okk4/zdXn5Krf7uEiYRAePsb36mprfm Ocz3rI+/OB8KfdbP21AURAHqbHVrwqdvr0EACchpxKFGxu33dAd1FJtDAvyoHUr6G/Cl llqg== X-Gm-Message-State: AOJu0YxJCPVXm3+2wcCcE9rlyOqYO3CHKrisP9tydG5A3RNrHtRRHCgz gXGTdtTEvdeC3GlB+bXIwfMKpH36PmliQiGk8NTCLhqqeVp4+GIJaZZ6hvpNywgnCcbB5ONOtPa +T8faIQ== X-Google-Smtp-Source: AGHT+IE3QMu30UAqolp5pZv8uqtgW4ttX3umLpNxsykF27VQbiphJKgS8ZLzXF+zW7oZz/8gwe6P+g== X-Received: by 2002:a05:6a20:dd9d:b0:1ac:fd95:574e with SMTP id adf61e73a8af0-1afde0e2101mr8894943637.28.1715626881087; Mon, 13 May 2024 12:01:21 -0700 (PDT) Received: from hermes.local (204-195-96-226.wavecable.com. [204.195.96.226]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-63d66da5eb6sm4079805a12.25.2024.05.13.12.01.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 May 2024 12:01:20 -0700 (PDT) Date: Mon, 13 May 2024 12:01:18 -0700 From: Stephen Hemminger To: Nandini Persad Cc: dev@dpdk.org Subject: Re: [PATCH 3/9] doc: reword argparse section in prog guide Message-ID: <20240513120118.26a99ee5@hermes.local> In-Reply-To: <20240513155911.31872-4-nandinipersad361@gmail.com> References: <20240513155911.31872-1-nandinipersad361@gmail.com> <20240513155911.31872-4-nandinipersad361@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org On Mon, 13 May 2024 08:59:05 -0700 Nandini Persad wrote: > @@ -132,15 +131,15 @@ their values are parsing in the order defined. > The compact mode is not supported. > Take above "-a" and "-d" as an example, don't support "-ad" input. > > -Parsing by autosave way > +Parsing the Autosave Method > ~~~~~~~~~~~~~~~~~~~~~~~ RST is picky about the title format. If you build the docs, this change will generate a warning: ninja -C build doc ninja: Entering directory `build' [4/5] Generating doc/guides/html_guides with a custom command /home/shemminger/DPDK/doc-rework/doc/guides/contributing/design.rst:41: WARNING: Bullet list ends without a blank line; unexpected unindent. /home/shemminger/DPDK/doc-rework/doc/guides/prog_guide/argparse_lib.rst:135: WARNING: Title underline too short. Parsing the Autosave Method ~~~~~~~~~~~~~~~~~~~~~~~ /home/shemminger/DPDK/doc-rework/doc/guides/prog_guide/argparse_lib.rst:135: WARNING: Title underline too short. Parsing the Autosave Method ~~~~~~~~~~~~~~~~~~~~~~~ /home/shemminger/DPDK/doc-rework/doc/guides/prog_guide/argparse_lib.rst:161: WARNING: Title underline too short. Parsing by Callback Method ~~~~~~~~~ /home/shemminger/DPDK/doc-rework/doc/guides/prog_guide/argparse_lib.rst:161: WARNING: Title underline too short. Parsing by Callback Method ~~~~~~~~~ [4/5] Running external command doc (wrapped by meson to set env) Building docs: Doxygen_API(HTML) Doxygen_API(Manpage) HTML_Guides