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 CCBB64577C; Fri, 9 Aug 2024 21:04:16 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8F14C42F21; Fri, 9 Aug 2024 21:04:13 +0200 (CEST) Received: from mail-pg1-f182.google.com (mail-pg1-f182.google.com [209.85.215.182]) by mails.dpdk.org (Postfix) with ESMTP id 40C8742F03 for ; Fri, 9 Aug 2024 21:04:12 +0200 (CEST) Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-7a1be7b7bb5so1810236a12.0 for ; Fri, 09 Aug 2024 12:04:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iol.unh.edu; s=unh-iol; t=1723230251; x=1723835051; 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=Y542ZqRQsp5npqAGSloz66QDgTgIQcNY25+aOxqf2KU=; b=Gnu6J2le2fmRUecR42yB5viGLFUFA4BCkiTM1TY5Qx8/ATr3+PEsuzGWdYIYhBe6kd GRx6oxD5SrCYwbGD+NXQynybT6kzWL2ay9O/7hCQtqwmj22wjCEHUfCmZkOdsEvaFpIw 0Zxn28ByEdg2aCxOuH4Rxj6OQ20e7FWYNoT58= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1723230251; x=1723835051; 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=Y542ZqRQsp5npqAGSloz66QDgTgIQcNY25+aOxqf2KU=; b=taqYXuvkaNCkIInaefO0GBG5rN1M73QyuR5pUYs4X4YfoyRnLfwrsancAIWFdhjtHj aFH6AySvFT6pmdWXcawIv9PYh0ZXwh5DEHgY6VqyruMnh6wNy92SrFUeC55Yl8qOAyNY Pll0aWkCc49QL6HH9jXKXBij9njWTupxG3gz8L9NA7+o3pRuRYOl/RhplHXQucogAgLs MSSB6sOzCnDqS86Kr8k3ffPyXRTEcNgRCV/bE3YFzE3v6GNAx9i2cvBUAQFbkMSLxvfl xR+tkMDdooRkLSDkxQR2Yx9gtkUfk/TU+13ID6Yl8bKdiP+4aUwfk/Yf3j1UGbDcr8rv IEYQ== X-Forwarded-Encrypted: i=1; AJvYcCXdkQg+aFiul3aHVGqd3ihU889BNN2JZ+GTO5QQBqBgsLSLcVoVW1ObXrtFXy0AIFnt9g/SRK4Jpicl/jA= X-Gm-Message-State: AOJu0Yz4whfMRgsTVF19IHX3fe2dvQ286hAf+wwumhEAwh1Btp2F71Tf RIaXN3wCHGOwNEaLgRbsDD6eO+e/hXFlOqV8DmbwdI4ZyW/OnJn8n10fxx5esL31oq6sCTWl8U3 kLrYZxyppU9Wn3Xx5XzoQ9T+/CQQ5kpbjv+2pEw== X-Google-Smtp-Source: AGHT+IE3PZ9N7tpjSLXtFQfInwXILbvCRGK17D7YF/m48uhG8jOpUbgURQuceflGUJlPJ/5ll+vuqtdrcrONVxkvSr8= X-Received: by 2002:a17:902:d48d:b0:1fb:7978:6b1 with SMTP id d9443c01a7336-200ae54983fmr27163085ad.31.1723230251241; Fri, 09 Aug 2024 12:04:11 -0700 (PDT) MIME-Version: 1.0 References: <20231115133606.42081-1-juraj.linkes@pantheon.tech> <20240808085452.426702-1-juraj.linkes@pantheon.tech> <20240808085452.426702-4-juraj.linkes@pantheon.tech> In-Reply-To: <20240808085452.426702-4-juraj.linkes@pantheon.tech> From: Jeremy Spewock Date: Fri, 9 Aug 2024 15:04:00 -0400 Message-ID: Subject: Re: [PATCH v16 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 Thu, Aug 8, 2024 at 4:54=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