From patchwork Mon Nov 14 14:22:24 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luca Boccassi X-Patchwork-Id: 119837 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 4CA7CA00C4; Mon, 14 Nov 2022 15:22:34 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3EED840150; Mon, 14 Nov 2022 15:22:34 +0100 (CET) Received: from mail-wr1-f46.google.com (mail-wr1-f46.google.com [209.85.221.46]) by mails.dpdk.org (Postfix) with ESMTP id 29CF44014F for ; Mon, 14 Nov 2022 15:22:33 +0100 (CET) Received: by mail-wr1-f46.google.com with SMTP id d9so13859145wrm.13 for ; Mon, 14 Nov 2022 06:22:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=5XAzUwfmrIs9HbvgKIJR/I8KBVQmFxn8jaUxV03a74Q=; b=EBBP9m/pqBfQ9OifnLeIS87sASyFwmLwf+63VOnu7Z7dApBL/zTRah9cQg+PgQP/ix GOYowVsGIxt4mPmc+9OhvYS2jRSIs+7pHEI/Mlebm5uKNbUhclevb2c5KuuNADf/2yCy 0mLIprA6Z2cP8ZNyfecsrGkAea0Tvg2UQSVqqSSRFigYBgmYiZvvxEuRqBmW/qaUXg4P HS8Fns6jTmYoiVofioobMEmDeuAD/7Sc+me9DynR9mQVSC24xTngD4dLrEDcxwR53Y+X JTKuKGExS6c2hE14rHKrDGiEmqUdVwCYsAF0/bEvwY6uI/meT36fg+vUDWMwXiMzJq40 FDmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=5XAzUwfmrIs9HbvgKIJR/I8KBVQmFxn8jaUxV03a74Q=; b=oBuymWGQwkUIp6404H6x58lPCEdddaZu6PEd1oAfoxBF4L7Xe45WPt1+BJK30hH7v6 cbI65N6U6c6VNGENbHUyLmVm2o1Rq3XVtfhezYyvNlQJTHhE+pminSNZH50fDjUCi5d2 Wx712f3VkqaEl7FkgemuGscwXxJuZDajtxq1sDEOKvcERHJ/HX7TFnQFNYcPkx/aHZFy NEejNfiBKH+vJFV5x/B97rSmm+JM2aPIw4bej4ppxNDlYJ3iZhTfWueMWqdu6ikEbob0 8ig0biDdXqOlPekObjRYDKyAmqkq0LiLh7ZMhoT98RxNTQ618pMv421s7imUHLBVsTj/ 4Epg== X-Gm-Message-State: ANoB5plwwvsOkzQNP+Vfg0nPj1681pBna6iLzD6gN1oXAwopv1VATwps r3k7QirRnrUdDyvm4X+KFQqLqojCdzw= X-Google-Smtp-Source: AA0mqf5yaCo5sjWCAkoUiOOiQy5BDE5W/7D6tEc1YXP2oCeThU2vfX7IZpqA8ZpPFvjAFJu9QPdqxQ== X-Received: by 2002:a05:6000:c:b0:238:3edf:74a0 with SMTP id h12-20020a056000000c00b002383edf74a0mr7861190wrx.435.1668435752594; Mon, 14 Nov 2022 06:22:32 -0800 (PST) Received: from localhost ([2a01:4b00:d307:1000:f1d3:eb5e:11f4:a7d9]) by smtp.gmail.com with ESMTPSA id n128-20020a1ca486000000b003cfd4a50d5asm9601101wme.34.2022.11.14.06.22.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 14 Nov 2022 06:22:31 -0800 (PST) From: luca.boccassi@gmail.com To: dev@dpdk.org Subject: [PATCH 1/2] docs: add +x to generator scripts Date: Mon, 14 Nov 2022 14:22:24 +0000 Message-Id: <20221114142225.85403-1-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 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 From: Luca Boccassi These scripts have a shebang so they are meant to be runnable, so set +x bits Fixes: 53bb9a073f4f ("doc: rewrite shell scripts in Python") Signed-off-by: Luca Boccassi Acked-by: Bruce Richardson --- doc/api/generate_doxygen.py | 0 doc/api/generate_examples.py | 0 2 files changed, 0 insertions(+), 0 deletions(-) mode change 100644 => 100755 doc/api/generate_doxygen.py mode change 100644 => 100755 doc/api/generate_examples.py diff --git a/doc/api/generate_doxygen.py b/doc/api/generate_doxygen.py old mode 100644 new mode 100755 diff --git a/doc/api/generate_examples.py b/doc/api/generate_examples.py old mode 100644 new mode 100755 From patchwork Mon Nov 14 14:22:25 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luca Boccassi X-Patchwork-Id: 119838 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id E8F06A00C4; Mon, 14 Nov 2022 15:22:37 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5611E42D0E; Mon, 14 Nov 2022 15:22:37 +0100 (CET) Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) by mails.dpdk.org (Postfix) with ESMTP id CC3EB4014F for ; Mon, 14 Nov 2022 15:22:36 +0100 (CET) Received: by mail-wr1-f48.google.com with SMTP id bs21so18549263wrb.4 for ; Mon, 14 Nov 2022 06:22:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=ND8N4k9zEw8NnsHW1aP2f5RBtcfNDWMUnufeftECb0c=; b=arE5zi+kpc24XEN+0jTG9FIdABnPGnMFpOg68QDjGRHcO03ywfyqBF3pvozLhFNfjQ F802KAxlHN3Ive4dsnDjhqI8SF7bI1KjD0zyEcesYibDrAhfJWA5UzanUGho0krOxTrP nkp5Lk7JPNiVbhO9uBpFl+jJMbBMx61+Uphx+RJulmWD7kesnmmCuJCJnio/0s9IctcP P6qQEaenEUlnm1flbuzdnr7MxntNi/+jmIcS0+88ldQ3dgygvr0+9zfSD8NWpcSsBU9g RWTKfMv2/G3HuO6CnrADCu7VuRZ6CvENsMD/fp8AOXoVwrulA/JB4lEp63jK7a8x9Bo7 r6GA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ND8N4k9zEw8NnsHW1aP2f5RBtcfNDWMUnufeftECb0c=; b=QqN/e8B6buQJc7e+Aa5vI3vrkSvgJY/lASiMgJ2dP5Ggpwif7F7pJ48DwT5KrA4sj7 mP6ZJgGbTvU1P9wakxkYThUW8AoTkEVvaSd2pA3CYqhPvFkfTyVaIr79hNgXTe9xyZsK 0Qf+3ZsMP6gsy0sAgDbvEM5l7uYy8/5QINlt5kJZWO0rymCpVB7f+bOo8StUTWgI7Vcm e4kKbJTo8NsMlANev50jnkyPmla27cR/BM/LmZZHU3jrS5pXbclWXnJkGoowFfiCPhRw 8WE/9L7VXGXGcxdbbbIqsjVb4WzAJ0D+xaVN3XNR85Hc/HhQUgtn2r0/Uya7F3shzCe2 6rpQ== X-Gm-Message-State: ANoB5pn2ahvSWcfbCtxrn5YAOga1cf1/PgRErMZcPu9KP61pHRw/wQsm Fdzq4ZJMdCSuv3TbvxB3aWG85W1sEts= X-Google-Smtp-Source: AA0mqf4xK5rYMRAPiG2504qr0PBe4dUhhSgvIlpXqQ08MbpjByjp7dCFhDUIxhcKSeTpKRQ48fyLsg== X-Received: by 2002:adf:f74f:0:b0:22c:f296:1120 with SMTP id z15-20020adff74f000000b0022cf2961120mr7345212wrp.369.1668435756260; Mon, 14 Nov 2022 06:22:36 -0800 (PST) Received: from localhost ([2a01:4b00:d307:1000:f1d3:eb5e:11f4:a7d9]) by smtp.gmail.com with ESMTPSA id o18-20020adfe812000000b00228692033dcsm9680256wrm.91.2022.11.14.06.22.35 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 14 Nov 2022 06:22:35 -0800 (PST) From: luca.boccassi@gmail.com To: dev@dpdk.org Subject: [PATCH 2/2] docs: sort files lists in generator scripts Date: Mon, 14 Nov 2022 14:22:25 +0000 Message-Id: <20221114142225.85403-2-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221114142225.85403-1-luca.boccassi@gmail.com> References: <20221114142225.85403-1-luca.boccassi@gmail.com> MIME-Version: 1.0 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 From: Luca Boccassi In order to build the documentation in a reproducible manner, sort the lists of files used as input, since walking the filesystem is not guaranteed to be done in a stable order. When converting the scripts from shell to python, sorting the input was lost. Fixes: 53bb9a073f4f ("doc: rewrite shell scripts in Python") Signed-off-by: Luca Boccassi Acked-by: Bruce Richardson --- doc/api/generate_doxygen.py | 2 +- doc/api/generate_examples.py | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/api/generate_doxygen.py b/doc/api/generate_doxygen.py index 2ccedf844e..d3a22869f6 100755 --- a/doc/api/generate_doxygen.py +++ b/doc/api/generate_doxygen.py @@ -13,7 +13,7 @@ subprocess.run(doxygen_command, check=True, stdout=out) with open(out_file) as out, open(dep_file, 'w') as dep: print(f'{out_dir}:', end=' ', file=dep) - for line in out: + for line in sorted(out): match = re.match(pattern, line) if match: print(match.group(1), end=' ', file=dep) diff --git a/doc/api/generate_examples.py b/doc/api/generate_examples.py index c35e72f280..7315b3c356 100755 --- a/doc/api/generate_examples.py +++ b/doc/api/generate_examples.py @@ -11,7 +11,7 @@ with open(f'{api_examples}.d', 'w') as dep: print(f'{api_examples}:', end=' ', file=dep) for root, _, files in os.walk(examples_dir): - for name in files: + for name in sorted(files): is_source = name.endswith('.c') if is_source or name == 'meson.build': path = os.path.join(root, name) @@ -23,7 +23,7 @@ print('''/** @page examples DPDK Example Programs ''', file=out) - for path in sources: + for path in sorted(sources): # Produce consistent output with forward slashes on all systems. # Every \ in paths within examples directory is a separator, not escape. relpath = os.path.relpath(path, examples_dir).replace('\\', '/')