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 CAD77457C6; Wed, 14 Aug 2024 20:50:25 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 469B242670; Wed, 14 Aug 2024 20:50:22 +0200 (CEST) Received: from mail-pj1-f49.google.com (mail-pj1-f49.google.com [209.85.216.49]) by mails.dpdk.org (Postfix) with ESMTP id 2F2D342670 for ; Wed, 14 Aug 2024 20:50:21 +0200 (CEST) Received: by mail-pj1-f49.google.com with SMTP id 98e67ed59e1d1-2d3c396787cso81730a91.1 for ; Wed, 14 Aug 2024 11:50:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iol.unh.edu; s=unh-iol; t=1723661420; x=1724266220; darn=dpdk.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=YtHU45aPItc3NATYfuZ4looz0xcYBb+Gb8DvwmRrGo4=; b=SBrA2mWhhO0VUxaBiUZXDfJKnZJQY0oM4AAxTTRsq6QzGpwD6jPsWq+wWd+9MHH1jJ Vk7zAUtHYa5hqWgS8zrTqy2MIlIK+lTnB+yKAlMe4FHXUSeA+z2VAC6BhIFessKqbZuX amysQH+GKLzTvXRjkLVgLTpQ0Mba+GX4Gxz5o= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1723661420; x=1724266220; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=YtHU45aPItc3NATYfuZ4looz0xcYBb+Gb8DvwmRrGo4=; b=MhKiUN3HNN/LzYyW9ChpYH1NdQQo29GXATh7CvkHgHY6T936lASmmZ1T8aZZA7ufHU kjNts/rFqxl3Qa5bUfk8H7apZpcoBMlc2e+ZsQruVpFQQs+W4QKL6eAmy6Ivz2v6z8el rHlLEEzL5KRCDEU3cPiYKsTRpIBQ6tkv9gihdZwQ9EALowHxiaRmPW8oTTJ/h+w1a2VE E0DwxEkxkvfaEgaemleJGkl+iJp3XCMLbsHPAz442kSIC9pIpShMTPxwj95VnvviC5va F2kQHSz+DicJ54JKJKDBVudEqxK//ahijhFg1aMMLlftK2lHGhhOSQH/IBZhvQe5wG7u NMeg== X-Forwarded-Encrypted: i=1; AJvYcCV17PEeaDBxJT5YtxLGk4qlCdmOwoB+10qy0P334tgTRby4+i3CqBseM1gdrwkEFK6pGWA=@dpdk.org X-Gm-Message-State: AOJu0YwOoEma0H8QCY6y/3ivxy3OHsdrjAudxryvt60opNMq4v20Bjx5 x63K4bVQmj/84+FN0nQZlLpBfXLVjFbjMfJRD0Wauv6qNju/yhXD8ltNGvSGFKbXYzh2Lgvse1F 33fz8kX39A6WIYNCuf5kD0yOX9WV1xAzqk5We2j4f24muEQwSsHk= X-Google-Smtp-Source: AGHT+IH+vJwrO0jIyj35dRiO1gGgMooBf2SqoCeGk5tUzKWcp1/tQFsmYeNAjN4Hsd/qoEGoPo2mOFKLibo4SEF3uAU= X-Received: by 2002:a17:90a:6041:b0:2c2:f2d6:60d4 with SMTP id 98e67ed59e1d1-2d3aaa7ac0bmr4897077a91.8.1723661420072; Wed, 14 Aug 2024 11:50:20 -0700 (PDT) MIME-Version: 1.0 References: <20231115133606.42081-1-juraj.linkes@pantheon.tech> <20240814150535.239547-1-juraj.linkes@pantheon.tech> <20240814150535.239547-4-juraj.linkes@pantheon.tech> In-Reply-To: <20240814150535.239547-4-juraj.linkes@pantheon.tech> From: Jeremy Spewock Date: Wed, 14 Aug 2024 14:50:08 -0400 Message-ID: Subject: Re: [PATCH v17 3/5] dts: add doc generation dependencies To: =?UTF-8?Q?Juraj_Linke=C5=A1?= Cc: thomas@monjalon.net, Honnappa.Nagarahalli@arm.com, bruce.richardson@intel.com, probb@iol.unh.edu, paul.szczepanek@arm.com, Luca.Vizzarro@arm.com, npratte@iol.unh.edu, dev@dpdk.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable 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 Wed, Aug 14, 2024 at 11:05=E2=80=AFAM Juraj Linke=C5=A1 wrote: > > Sphinx imports every Python module (through the autodoc extension) > when generating documentation from docstrings, meaning all DTS > dependencies, including Python version, should be satisfied. This is not > a hard requirement, as imports from dependencies may be mocked in the > autodoc_mock_imports autodoc option. > In case DTS developers want to use a Sphinx installation from their > virtualenv, we provide an optional Poetry group for doc generation. The > pyelftools package is there so that meson picks up the correct Python > installation, as pyelftools is required by the build system. > > Signed-off-by: Juraj Linke=C5=A1 Reviewed-by: Jeremy Spewock