From nobody Mon Feb 9 12:29:15 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) client-ip=207.211.31.81; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1595510590; cv=none; d=zohomail.com; s=zohoarc; b=ZtVGfL9HthCi1VSXYWXklxQd12WbXzikrT5PtZrSKZJt5MDYU5BJ5+6BskFqFOaYozDEUsf7AwaoSKYoMFhBfOFNWYAF5SsmQZvx30hcp6qd6e4CeC2ZsBXba2NivPJpd8NWpD6MwqtYj6uSRQXuzAUKqrnP0u7HUWtMN0iDyjI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1595510590; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=HxiE5tLTZMl1URer/36cJBLNBssQ6c8AVkPhqgseUiA=; b=HdffBNEmI90HzWOVlJEgi4zDSnuSAeWCTP/TZwxCmyKi2nUEB2YzAj+ScP/k5PQrSTp8CKlmzd06007PVbrlrP5xFDF6NLs57FjaW91LRy8wC+ytdSsJtrAe1fX1kpGYM7VU/wrpB+L5OSrdrPzEQ4GvlC4qWvm/FzWU7EUFfHw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-1.mimecast.com [207.211.31.81]) by mx.zohomail.com with SMTPS id 159551059003977.14167455100312; Thu, 23 Jul 2020 06:23:10 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-214-_LfEJwITOnyTHiVSQMr2lA-1; Thu, 23 Jul 2020 09:21:59 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4194680046E; Thu, 23 Jul 2020 13:21:51 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 1E8EF8BEF5; Thu, 23 Jul 2020 13:21:51 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id E01D29625C; Thu, 23 Jul 2020 13:21:50 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06NDLkmN028298 for ; Thu, 23 Jul 2020 09:21:46 -0400 Received: by smtp.corp.redhat.com (Postfix) id ED6F419D7B; Thu, 23 Jul 2020 13:21:46 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.37]) by smtp.corp.redhat.com (Postfix) with ESMTP id 33E5519D7D for ; Thu, 23 Jul 2020 13:21:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1595510588; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=HxiE5tLTZMl1URer/36cJBLNBssQ6c8AVkPhqgseUiA=; b=OaxwOO0rff1/Mt8Ye1S1JPlqkP2SesPHUAjrWnhI1O6CBQnsf9a9+qab07W0ms2lATFEb8 CVZ3jCqGV/NuR5VJAzxGk0ZHefjGENGr+PkrmL01Y+ddARybn3i3UTupSDyFgTqz1oYrc8 bU81kjIRw5jI91pQVZyz/vT2RQhVz84= X-MC-Unique: _LfEJwITOnyTHiVSQMr2lA-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 04/32] docs: meson: Add dependencies for RST docs Date: Thu, 23 Jul 2020 15:21:09 +0200 Message-Id: <24d688c59f7aec8aa581defc0b17302d61f93435.1595510131.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Prepare for splitting out parts of RST documents into separate files by introducing 'includes' property in the build system. While the include itself is handled by docutils, it allows us to declare dependencies between the files so that they are rebuilt properly. Signed-off-by: Peter Krempa --- docs/meson.build | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/docs/meson.build b/docs/meson.build index 001b1fe6f0..1e1383daa9 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -112,6 +112,7 @@ docs_html_in_files =3D [ # docs_rst_files: # each entry is a dictionary with following items: # name - base file name (required) +# includes - rst files included by this file (optional) docs_rst_files =3D [ { 'name': 'advanced-tests' }, { 'name': 'best-practices' }, @@ -212,9 +213,29 @@ endforeach foreach data : docs_rst_files rst_file =3D '@0@.rst'.format(data['name']) + html_in_file =3D '@0@.html.in'.format(data['name']) + depend_files =3D [] + + if data.has_key('includes') + depend_files =3D files(data['includes']) + endif + + out_file =3D custom_target( + html_in_file, + input: rst_file, + output: html_in_file, + command: [ + rst2html_prog, + '--strict', + '@INPUT@', + '@OUTPUT@', + ], + depend_files: depend_files, + ) + docs_html_in_gen +=3D { 'name': data['name'], - 'file': docs_rst2html_gen.process(rst_file), + 'file': out_file, } endforeach --=20 2.26.2