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 AFA7A45F21; Mon, 23 Dec 2024 14:22:28 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 679C7402AB; Mon, 23 Dec 2024 14:22:28 +0100 (CET) Received: from mail-wm1-f43.google.com (mail-wm1-f43.google.com [209.85.128.43]) by mails.dpdk.org (Postfix) with ESMTP id 8DDA640263 for ; Mon, 23 Dec 2024 14:22:27 +0100 (CET) Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-4361f796586so44503035e9.3 for ; Mon, 23 Dec 2024 05:22:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734960147; x=1735564947; darn=dpdk.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=kNRwAs/ky9n6kAL8jIUKUqjEjUlYy/oGAarQSbOPmDc=; b=bLaGGJh0E5HAnmhKFv4OSvNqGcs5PZ8puAlLdp0rHmVPIwMhg4CRJNRZI7UzzXyprZ YhSbMJxmW7G+7+ziA+DvXDgcKjtLWPpgO7jD/bR1vCu273wjW2UQqWTN1jSkYE9Js06q 4AjPPlFB6YI57oVDb+B2FAtx9DsKw3PzokGv7BWuiWMFsv4TfYBdjnQmQrbDeu7WGIas wObPt8IlmOVIV5TzLjkrFfSm7kIm4ZNGW5UuiZGqjUYNxEgAqblVW1lCyxSfNxoi7J2c EJb6xeoKfcVlTRxgu/sCMjlZVOMWw/w9qyTzedG96MMDtsCZGh3VO4bp6SCdjQ6FlvEl CGZg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734960147; x=1735564947; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=kNRwAs/ky9n6kAL8jIUKUqjEjUlYy/oGAarQSbOPmDc=; b=pqcNkX5gebFLdRUq7v+COvhPPsa4vYhNq0XcPV7pPd124uoPlF9dGcJK8MT0WRUhlv 0afjpsuSKudtMlSdc3d0XREpax9xH2cQtpleaNzt76SMjSEh/nRfKsZQ+bSxDLwBVbA8 TJ0DvF8rNi5zppv8UzE+0wUGvEzhnw7Jusmpoj2/d5vtT9J9e4e/VK65JJSDaTO8nibs +V6qKpx1eVLaFjVVYF+kQflA57rDgxNEoA6+1xnkt1FZQixC1Lu6KIm0kUUobuERdKqu VLB/F/KE/B7bweH7r6YmlvAEGCjfo+vBVZkuOGyxr74lhCy7JDOazC6gRJ7XLz5Zfn9J rS8w== X-Gm-Message-State: AOJu0Yw9gLBMUrUWLw/FHGSjc1xZuYA13/7T8IdATODPS1yZir1nQXy/ MOAA6cT6s7nI7i8JOcWDtnDr5Cg+pw9puhbsMKONMFdGmrrPTN7oBAKCcg== X-Gm-Gg: ASbGncuumWugCaSJgnH93z8nJXC+1UNHLrcgHCfbHsfWodmwG4W2SrHkgn/7+pHZ9qy 4rwFjHdibD7nLCs1tpYxXjIZ1AgXsl77GARo8pduRslEGVyWMMFpcnaUOsV+UTPQFvEDs69JZLz qyTn5K8gqEi4VKlz+o12HWhzrO+WDZIpKMAGOoZpncYCN+yB5kkCJQfIE91mHCAukxlZnYfrj4D 4ZM7cbgAhcMEu7QIKofpLquIY6adNualxsDorAIMHg/nPfVh2JP8No/J074k6c= X-Google-Smtp-Source: AGHT+IGP0zcIiYGEqv/LVd7xYBtOhq2/6PiUUJzRlp7hj+j73CCWMBgsCHP8pGav9fGMYYHX5+Qayw== X-Received: by 2002:a05:6000:2c6:b0:385:fa26:f0ac with SMTP id ffacd0b85a97d-38a221e264cmr12208582f8f.7.1734960146663; Mon, 23 Dec 2024 05:22:26 -0800 (PST) Received: from localhost ([2a01:4b00:d036:ae00:372d:4bf1:fd51:f809]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-38a1c8ac974sm11342504f8f.91.2024.12.23.05.22.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 23 Dec 2024 05:22:25 -0800 (PST) From: luca.boccassi@gmail.com To: dev@dpdk.org Cc: bruce.richardson@intel.com Subject: [PATCH] doc: add install_tag to meson Date: Mon, 23 Dec 2024 13:21:13 +0000 Message-ID: <20241223132220.138227-1-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.45.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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: "bluca@debian.org" This allows building and installing only the documentation, without recompiling the whole project, using: meson build -Denable_docs=true meson compile -C build doc meson install -C build --no-rebuild --tags doc In Debian/Ubuntu the documentation is built separately from the binaries, in a separate architecture-independent build job, so that it has to be done only once, instead of once per supported architecture. Signed-off-by: Luca Boccassi --- This requires meson 0.60, so there's a warning printed as the minimum defined is 0.57, but it's harmless, and the feature is only used when explicitly invoked with --tags, which simply has to be done with newer meson versions. If install --tags is not used, then there's no issue. doc/api/meson.build | 3 +++ doc/guides/meson.build | 1 + 2 files changed, 4 insertions(+) diff --git a/doc/api/meson.build b/doc/api/meson.build index ac6eb8236d..9b66dce4f3 100644 --- a/doc/api/meson.build +++ b/doc/api/meson.build @@ -27,6 +27,7 @@ example = custom_target('examples.dox', depfile: 'examples.dox.d', install: get_option('enable_docs'), install_dir: htmldir, + install_tag: 'doc', build_by_default: get_option('enable_docs')) # set up common Doxygen configuration @@ -76,6 +77,7 @@ doxy_html_build = custom_target('doxygen-html', command: [generate_doxygen, '@OUTPUT@', doxygen, '@INPUT@'], install: get_option('enable_docs'), install_dir: htmldir, + install_tag: 'doc', build_by_default: get_option('enable_docs')) doc_targets += doxy_html_build @@ -90,6 +92,7 @@ doxy_man_build = custom_target('doxygen-man', command: [generate_doxygen, '@OUTPUT@', doxygen, '@INPUT@'], install: get_option('enable_docs'), install_dir: get_option('datadir'), + install_tag: 'doc', build_by_default: get_option('enable_docs')) doc_targets += doxy_man_build diff --git a/doc/guides/meson.build b/doc/guides/meson.build index f8bbfba9f5..04bfbd1326 100644 --- a/doc/guides/meson.build +++ b/doc/guides/meson.build @@ -22,6 +22,7 @@ html_guides = custom_target('html_guides', depfile: '.html.d', build_by_default: get_option('enable_docs'), install: get_option('enable_docs'), + install_tag: 'doc', install_dir: htmldir) doc_targets += html_guides -- 2.45.2