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 D42D4A0032; Wed, 11 May 2022 11:34:30 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AA30840DDD; Wed, 11 May 2022 11:34:30 +0200 (CEST) Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12on2089.outbound.protection.outlook.com [40.107.244.89]) by mails.dpdk.org (Postfix) with ESMTP id 0128840042 for ; Wed, 11 May 2022 11:34:29 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KLnojgff8tm10nmH7F42HYOC8PwYg92peFV/qpEmCanqkZe5AYoeF06xMB0/1vtQG7OZhlJ9csFFL338jgeITvI0RceB79flbCtu6yzF8tg51Nq387x5OaLid3Y082GOD1ZdlqLBHP0Hv7ZkvrjSlAICZNLFffvykDZaoQwUosvkCURX/9uQk3kI+TD5VD7G7JkopEoWeVNxv5y2wQEjNKduAvQUgs3eSzI2ue5RtexDPkpuIz+c4+pM/DEj/IwJoiywBgAyhSyj4Se8+P2lKgF59lab9UkzncrXGx43lW6IBmZp7W9KcwmG3sYMEFdPcUX+7O/f6NBNvdGvC4nvig== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=WL+31m0REB98u13DgBnV+AoAILu/AZKYDrzfMvu2JOw=; b=dsdJqamK8MED5nMD0g9mtqN6BKpBhyk7J8ZkEFFElyceI1SHMRhCTgva8wSM213tRGNBpny3hD5hZNfUqF5A+cKr2BHo0ysco4CQMXTKrFMOt9Kp7Pd3FXl5tmiTcjF9AARfiY3vNX5k8SJuk7qu4FFzHlov1Qm8fJakjUwb9zBgefrte7n7w+GJGMf0NEE+qCHYktDZZXtxkmcpbLyYkj8DZuqP9Db15aRaajWmT2c+mYsr/iWrSGL7m5BWW8OO3B9FBDQhrb9srhjIV5pVw0OX0zZR+4u8cR4WdHUv8o2t2T1VwAADrQfRHOniKxPGCkM9+DInF+M/JYHlBdwtRQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=WL+31m0REB98u13DgBnV+AoAILu/AZKYDrzfMvu2JOw=; b=Z1ee2BE2Kk9tw7yyZ1sogBxCLEYRaB7kI3Ry+1VSuKh8gjVGz3Z3B4vSB7skehcFRwbh8LSKM0hR6pccez3iSMvsx30TFqVPzrp1viPQDq3JkzdP10kEvc97eUE13CkPKwLZKto5EE+ODL26EEIkA6XjiQsr6xRdgofjpXLUrNk= Received: from MN2PR12MB3085.namprd12.prod.outlook.com (2603:10b6:208:c5::29) by CY4PR1201MB2535.namprd12.prod.outlook.com (2603:10b6:903:db::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5227.23; Wed, 11 May 2022 09:34:26 +0000 Received: from MN2PR12MB3085.namprd12.prod.outlook.com ([fe80::4db6:24ce:d0dd:bbcf]) by MN2PR12MB3085.namprd12.prod.outlook.com ([fe80::4db6:24ce:d0dd:bbcf%5]) with mapi id 15.20.5186.028; Wed, 11 May 2022 09:34:26 +0000 From: "Varghese, Vipin" To: Dmitry Kozlyuk , "dev@dpdk.org" Subject: RE: [PATCH v2 0/3] doc: build on Windows Thread-Topic: [PATCH v2 0/3] doc: build on Windows Thread-Index: AQHYSdk+I2JFJmkU1kOr4AT1pSIDj60Znp1w Date: Wed, 11 May 2022 09:34:26 +0000 Message-ID: References: <20220331212830.708912-1-dmitry.kozliuk@gmail.com> <20220406171012.87759-1-dmitry.kozliuk@gmail.com> In-Reply-To: <20220406171012.87759-1-dmitry.kozliuk@gmail.com> Accept-Language: en-IN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: msip_labels: MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Enabled=true; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_SetDate=2022-05-11T09:34:23Z; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Method=Standard; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Name=General; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_SiteId=3dd8961f-e488-4e60-8e11-a82d994e183d; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_ActionId=c89afb2a-50ca-4e9a-89ae-fbc6ecc12f10; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_ContentBits=1 msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_enabled: true msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_setdate: 2022-05-11T09:34:23Z msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_method: Standard msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_name: General msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_siteid: 3dd8961f-e488-4e60-8e11-a82d994e183d msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_actionid: ddd6de69-2777-498d-a2b7-ca4af533054b msip_label_4342314e-0df4-4b58-84bf-38bed6170a0f_contentbits: 0 authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: a268369c-9c5b-41aa-a603-08da333170d7 x-ms-traffictypediagnostic: CY4PR1201MB2535:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: +cXi5z6IIreMfDbwdrcFVuCHvicXCtDhIiyMvyoqAYFQbd7nDDzDy/dWcshFyHm6HIDVKW+LkSmsgTtP7k5lf9LIYKD0NrRvybMqJ2RrP9Vmqt9YYz71gJj/tMJ9uUCOn4uDLz6nNZ/xr8TGZU5bVCAHKF11Du9GNQkIxadkd8iftsi4HPIbfApTMU7576zgHanzldSq1zJh5IY/LN38p28E2A3zKqyTihcCJEQUIOaXU5HJS45gFY9Qvmd0+Pl/KzkZbLbQU8pk375RszDzBYvs80BpvVsNwOdSyomelF0I837QqL07TE01CkNTVYaBmHMShJ0xyhnfCsIhyqEv7uMXTlrxYOzpfFD/+JDt1ak34/kxpHE3uNTa6s1HWaZCkADPqXfivZoioubVPep33F1UYgd5/woljVSNPAFLkrq7LLAhWf1/rvYwUkmaNGZXkooR7GevJrbnYuKc7y8NoAYCJlTdZepBHGg22C0IANRGVlAzmsdm4+JWoifGg3PDZWvoIP+kq5aUCtiUiJZHCBF6YUKPyHQeNI7FAo6yPp8AtrJ8WpQQBgqkTXKDFv87Pl4QPtjxlFxGLR5qskFx8qfyjVttB+K8a/jpWFIyGmbW+Hlia82AxFNuyTOFw7pviXM2J3V4Li1ctU0++OPxfvV7rG41C4hPA0rJiy3FqCMTqudhdOQNBG4mZ9ek9FPB91Y/pexlQ9c2bK5fADsNFPiL15TlnxJnET1vuHiXwHo= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR12MB3085.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(4636009)(366004)(6506007)(52536014)(71200400001)(86362001)(26005)(122000001)(83380400001)(2906002)(8936002)(66946007)(64756008)(33656002)(66446008)(66556008)(66476007)(76116006)(38100700002)(5660300002)(53546011)(55236004)(8676002)(508600001)(110136005)(316002)(55016003)(38070700005)(186003)(9686003)(7696005)(460985005); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?REqVeCb7GtAfX6kViR1uL2lNKQQNcVWN/HwBNXdFXqoZOEU1AtDRNswoiBDf?= =?us-ascii?Q?kzAy2oUrfsSciQkrFPm0osmGHza2Zng6WbP4mfg0TUdl/nKIkXWAVncn1fgF?= =?us-ascii?Q?oXWJgGshn6fQjqLFrUHpCaiJpvGLbdzF75+3/O0K6/+07B7rHnWhbp4f+bpg?= =?us-ascii?Q?9eBXvKfvkQtK6OTYtBESBi6NDRyTFETjjWglDKUD7tPjmoWShK+3ailUbdBp?= =?us-ascii?Q?9XMjhxRkQgJ12lK5lcZQvZw3Ymev6nlHbkpeKh/DqmpfAnCE9jsx6BMzvfBO?= =?us-ascii?Q?67CirlZ7UIsEELivUjAV4YG6Y28h77xecVIaFkbkOkXSu78oBbYpnHcJI8FW?= =?us-ascii?Q?Qt3gUrv9w4Fcr6/ijSlec6ntcQHNjThCnQ+HjaKKnAhMx4AvuALxPMg4/NM2?= =?us-ascii?Q?zG+gl7a2YotPpGqyFJ+59kBdQrWOX2bpx3XQwCEQce0mfoCyvCalm+twGGuP?= =?us-ascii?Q?FkuUghzOVx8ucCePh3VpUGxzr8iwPEul4ZGDd44Xy7AnV7MZm+R8HvWBwu71?= =?us-ascii?Q?2MnE0ipBR7/LsS7d9/EsNI7B1Sa84yMwP6/mmajqWLi3x1E7sK9qIr2uzm20?= =?us-ascii?Q?eAqLpVMlDo5pnF/fu3VTofoX/kS3rJnj2/qQtGP314prHQIldI6YYlb4VsCX?= =?us-ascii?Q?OUH6UE9l5euA65gxS7ahksPH1EIiulWP1QpV7gc1g0AoQU3yGVGaScOS7DTv?= =?us-ascii?Q?nHhiSzJK5J5alsiXveGaiC0CXsgpNJKIfxnTNM2TsW4fASiAia5h65/6+gVY?= =?us-ascii?Q?yUaE5bKd9KjTBOcH7HmIxvAfMH5LAPNKg2HqV5DpaZ8vvLYMsx8VObq3Wneg?= =?us-ascii?Q?kvddInbC8tQ0VFm/ix6LWapUkowGcV9gwz1SeZRpf67EUWGtPSGLS2oVuPHc?= =?us-ascii?Q?ezs+asX4QENInk/Ye2GXjBYpEpc80TyNwCzVPnWMV9iSjSK2USoRe1JZhu2I?= =?us-ascii?Q?tHd8j0udVtrUs60iZMsqfNzFY0JhlJ+9eav8PupryCEXaC3zwUr/WG2AcaNT?= =?us-ascii?Q?37fHJlByXbzZqRFsrbE+zlgCfqcKBL1kqdXFD0qjyNl7C8TDEc7ELtbWlcPW?= =?us-ascii?Q?sJBETwjA4nbWVgTMp5GPrTbTlVDZ6gXmD3xbL1PI60d7fUAwkOuOkoguGYrZ?= =?us-ascii?Q?gqgEjfiX6iB4EgS8v0wqwyc5tGoramkQU6b2tli1sUC+ZHKJ/sMlxK15coer?= =?us-ascii?Q?4UC3cVIjJdjltU5iE5RXcvzyg5s9SdDYsbcoLHwtRWjMMAKsnuCIkTeiVulT?= =?us-ascii?Q?KM1XcyyZRcgRjAeY12HdN3F0M5l/bjCa31czyxsACxkChb58Jf9izUk8SMgc?= =?us-ascii?Q?kyWiUrTP/NIySsm4mDbZqhF5IMnN/Kv+ex9J9Z2tVCaMf6gLBFDqL5Q+Yn8u?= =?us-ascii?Q?ERJAHjw2+p7DcfRmCfvVP8xIGX3TlQVSE0oqIBbu/h27sOCRCpFvVN6YskbI?= =?us-ascii?Q?oynACt6pmpixsKi8mMNAKtbOlywCdaCApQsOj5RoczvJycFfQJSJnGZBq/20?= =?us-ascii?Q?u1ymIxmqDwCXbcXWi55jSNNr/eDbVDzvUOfcwweJK1bpUO7Zle+61W4mU+h1?= =?us-ascii?Q?tGSgTAJ+IEli2IQAmvToXqvUPxPQk9cPTZiLcf2QxRAvkB4fZcXJLlQSCbuv?= =?us-ascii?Q?mZnygXT9EzoaEbM/P7q0hjoW5a+bkJeJqlIgM78AQSpq3i2zoEZYPOKuRhvW?= =?us-ascii?Q?FepNFZWnxwBEKqMR+aD7B4ava2utKtKERESciVN1kNj4ZyTV1jj+EsbV3qcM?= =?us-ascii?Q?Pvu+l1muZg=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MN2PR12MB3085.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: a268369c-9c5b-41aa-a603-08da333170d7 X-MS-Exchange-CrossTenant-originalarrivaltime: 11 May 2022 09:34:26.5785 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: gxXmUkuSNwYawuIjoditoihpIxnujOJJZBkB98609l4ydTIchCVpCjLRHb9W3eOMTyogUP/yh4nTXMFSrQAJAg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR1201MB2535 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 [AMD Official Use Only - General] Hi Dmitry, Thank you for allowing me to try these changes on both Linux & Windows. I w= as facing some hurdles in both environments. On Linux I was facing ``` Traceback (most recent call last): File "/home/amd/vipin/dpdk/test/dpdk/doc/api/generate_doxygen.py", line 1= 3, in subprocess.run(doxygen_command, check=3DTrue, stdout=3Dout) File "/usr/lib/python3.8/subprocess.py", line 493, in run with Popen(*popenargs, **kwargs) as process: File "/usr/lib/python3.8/subprocess.py", line 858, in __init__ self._execute_child(args, executable, preexec_fn, close_fds, File "/usr/lib/python3.8/subprocess.py", line 1580, in _execute_child executable =3D args[0] IndexError: list index out of range ``` With some debugging this was root caused to `doxygen permission issue in th= e environment`. Re-running the `ninja -C build` with root user solved this = for me. For Windows I faced ``` [528/682] Generating doc/guides/html_guides with a custom command FAILED: doc/guides/html "C:\Program Files\Meson\meson.exe" "runpython" "../buildtools/call-sphinx-b= uild.py" "C:/Users/Administrator/AppData/Local/Programs/Python/Python310/Sc= ripts/sphinx-build.EXE" "22.07.0-rc0" "C:/Users/Administrator/Desktop/docs/= doc/guides" "C:/Users/Administrator/Desktop/docs/build/doc/guides" Traceback (most recent call last): File "mesonbuild\mesonmain.py", line 146, in run File "mesonbuild\mesonmain.py", line 106, in run_runpython_command File "runpy.py", line 269, in run_path File "runpy.py", line 96, in _run_module_code File "runpy.py", line 86, in _run_code File "../buildtools/call-sphinx-build.py", line 10, in from packaging.version import Version ModuleNotFoundError: No module named 'packaging' ERROR: Unhandled python exception ``` Checking for `packaging` in windows, the library is present ``` C:\Users\Administrator\Desktop\docs>pip3 install packaging Requirement already satisfied: packaging in c:\users\administrator\appdata\= local\programs\python\python310\lib\site-packages (21.3) Requirement already satisfied: pyparsing!=3D3.0.5,>=3D2.0.2 in c:\users\adm= inistrator\appdata\local\programs\python\python310\lib\site-packages (from = packaging) (3.0.7) ``` Running python directly gives success for package as ``` import packaging dir(packaging) ['__about__', '__all__', '__author__', '__builtins__', '__cached__', '__cop= yright__', '__doc__', '__email__', '__file__', '__license__', '__loader__',= '__name__', '__package__', '__path__', '__spec__', '__summary__', '__title= __', '__uri__', '__version__'] ``` So the problem is narrowed down `sys.path` variation as ``` Path from standalone run for call-sphinx-build.py: ['C:\\Users\\Administrat= or\\Desktop\\docs\\buildtools', 'C:\\Users\\Administrator\\AppData\\Local\\= Programs\\Python\\Python310\\python310.zip', 'C:\\Users\\Administrator\\App= Data\\Local\\Programs\\Python\\Python310\\DLLs', 'C:\\Users\\Administrator\= \AppData\\Local\\Programs\\Python\\Python310\\lib', 'C:\\Users\\Administrat= or\\AppData\\Local\\Programs\\Python\\Python310', 'C:\\Users\\Administrator= \\AppData\\Local\\Programs\\Python\\Python310\\lib\\site-packages'] Path from ninja build for docs for call-sphinx-build.py: ['../buildtools', = 'C:\\Program Files\\Meson\\base_library.zip', 'C:\\Program Files\\Meson\\li= b-dynload', 'C:\\Program Files\\Meson'] ``` > -----Original Message----- > From: Dmitry Kozlyuk > Sent: Wednesday, April 6, 2022 10:40 PM > To: dev@dpdk.org > Cc: Varghese, Vipin ; Dmitry Kozlyuk > > Subject: [PATCH v2 0/3] doc: build on Windows >=20 > [CAUTION: External Email] >=20 > Enable biulding documentation on Windows natively. > Thanks to Vipin for raising the issue. >=20 > v2: fix typo in meson.build file name, > use print(file=3Dx) instead of stdout redirection. >=20 > Dmitry Kozlyuk (3): > doc: simplify CSS customization for Doxygen > doc: fix API index Markdown syntax > doc: rewrite shell scripts in Python >=20 > doc/api/custom.css | 6 + > doc/api/doxy-api-index.md | 366 +++++++++++++++++------------------ > doc/api/doxy-api.conf.in | 1 + > doc/api/doxy-html-custom.sh | 8 - > doc/api/generate_doxygen.py | 19 ++ > doc/api/generate_doxygen.sh | 15 -- > doc/api/generate_examples.py | 31 +++ > doc/api/generate_examples.sh | 20 -- > doc/api/meson.build | 7 +- > 9 files changed, 243 insertions(+), 230 deletions(-) create mode 100644 > doc/api/custom.css delete mode 100755 doc/api/doxy-html-custom.sh creat= e > mode 100644 doc/api/generate_doxygen.py delete mode 100755 > doc/api/generate_doxygen.sh create mode 100644 > doc/api/generate_examples.py delete mode 100755 > doc/api/generate_examples.sh >=20 > -- > 2.29.3