From nobody Mon Feb 9 06:02:17 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 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=1649340063; cv=none; d=zohomail.com; s=zohoarc; b=VUxKNvmexZIU9Mzr9qo2tWze34SdmrZVB7RO6SJQXYg2EWcg6IOIKNsKo0ELEKMZJ8UbVMAh6YeTxPaUrU2nkCcHNqiWct2vSPI4pHTrVrsMkU5FsZLd/IW1ggoYro2ihBdVpUZ30xZz9Px1CEZxuoGIFUJa3l3q3ItRsvSQBZc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1649340063; 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=hCB7y19KQMgCfqt5dCkgk0X+px1pm6lbXZKuCNW7zoc=; b=e9ToMSF/Tj5DVaAwvoxsY1/kzE1H35NC7mNAKdJ4mU8HSkJmdEzbNgY9r8qjjkchVVTzqSmG2MoM+SseVyjvhV+N0FyvcYvL55z22O5fHDkBm1sdSBGjaxW0knfaXcgnQE0igZT3wBE7h3+s5PxCsKY23Xs93THnUEuKmWsOa68= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1649340063043260.6070692359938; Thu, 7 Apr 2022 07:01:03 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-345-LskxV7UYNyCGA7HJ0MjADQ-1; Thu, 07 Apr 2022 10:00:59 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 9DC9738009E6; Thu, 7 Apr 2022 14:00:39 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8AEA0C28114; Thu, 7 Apr 2022 14:00:39 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 3B99F1949761; Thu, 7 Apr 2022 14:00:39 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 1F8E1194034B for ; Thu, 7 Apr 2022 14:00:38 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 0D90740314D; Thu, 7 Apr 2022 14:00:38 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.35]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7F95B403153 for ; Thu, 7 Apr 2022 14:00:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1649340062; 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=hCB7y19KQMgCfqt5dCkgk0X+px1pm6lbXZKuCNW7zoc=; b=gYn1MXLtqkxrhkbuGbVom5Oy44lVj4C+L/W5BzLHkwCgu3X3czSsF3YOtT3UeK80yrbHvh nXjLuvlqbZ1wBQagmY5ilDvk4mJGmA3p0YBrknJIZasf4GB+yLk8aQvBuvZMTHKnzOpRte 9PF81KSlQuLQ00oYmBFnuLx3DL9dDpg= X-MC-Unique: LskxV7UYNyCGA7HJ0MjADQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 03/11] docs: kbase: Section of 'internals' documents into a subfolder Date: Thu, 7 Apr 2022 16:00:25 +0200 Message-Id: <0a9525a8b7b3323fdaecb37979ef54f0872ced73.1649339910.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.85 on 10.11.54.10 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 2.85 on 10.11.54.8 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1649340064502100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Add an 'internals' subfolder to 'docs/kbase' to house all the documents under internals. The output files are still under 'docs/kbase'. Signed-off-by: Peter Krempa --- docs/kbase/index.rst | 4 +- .../incremental-backup.rst} | 0 docs/kbase/internals/meson.build | 55 +++++++++++++++++++ .../migration.rst} | 0 docs/kbase/meson.build | 4 +- 5 files changed, 59 insertions(+), 4 deletions(-) rename docs/kbase/{incrementalbackupinternals.rst =3D> internals/increment= al-backup.rst} (100%) create mode 100644 docs/kbase/internals/meson.build rename docs/kbase/{migrationinternals.rst =3D> internals/migration.rst} (1= 00%) diff --git a/docs/kbase/index.rst b/docs/kbase/index.rst index 4e18acd4d9..c6748e8883 100644 --- a/docs/kbase/index.rst +++ b/docs/kbase/index.rst @@ -79,9 +79,9 @@ Debugging Internals --------- -`Incremental backup internals `__ +`Incremental backup internals `__ Incremental backup implementation details relevant for users -`VM migration internals `__ +`VM migration internals `__ VM migration implementation details, complementing the info in `migration <../migration.html>`__ diff --git a/docs/kbase/incrementalbackupinternals.rst b/docs/kbase/interna= ls/incremental-backup.rst similarity index 100% rename from docs/kbase/incrementalbackupinternals.rst rename to docs/kbase/internals/incremental-backup.rst diff --git a/docs/kbase/internals/meson.build b/docs/kbase/internals/meson.= build new file mode 100644 index 0000000000..923e262706 --- /dev/null +++ b/docs/kbase/internals/meson.build @@ -0,0 +1,55 @@ +docs_kbase_internals_files =3D [ + 'incremental-backup', + 'migration', +] + + +html_xslt_gen_install_dir =3D docs_html_dir / 'kbase' / 'internals' +html_xslt_gen =3D [] + +foreach name : docs_kbase_internals_files + rst_file =3D '@0@.rst'.format(name) + + html_xslt_gen +=3D { + 'name': name, + 'file': docs_rst2html5_gen.process(rst_file), + 'source': 'docs' / 'kbase' / 'internals' / rst_file, + 'href_base': '../../', + } +endforeach + +# keep the XSLT processing code block in sync with docs/meson.build + +# --- begin of XSLT processing --- + +foreach data : html_xslt_gen + html_filename =3D data['name'] + '.html' + + html_file =3D custom_target( + html_filename, + input: data.get('file', data['name'] + '.html.in'), + output: html_filename, + command: [ + xsltproc_prog, + '--stringparam', 'pagesrc', data.get('source', ''), + '--stringparam', 'builddir', meson.build_root(), + '--stringparam', 'timestamp', docs_timestamp, + '--stringparam', 'href_base', data.get('href_base', ''), + '--nonet', + site_xsl, + '@INPUT@', + ], + depends: data.get('depends', []), + depend_files: [ page_xsl ], + capture: true, + install: true, + install_dir: html_xslt_gen_install_dir, + ) + + install_web_deps +=3D html_file + install_web_files +=3D html_file.full_path() + ':' + html_xslt_gen_insta= ll_dir +endforeach + +html_xslt_gen =3D [] + +# --- end of XSLT processing --- diff --git a/docs/kbase/migrationinternals.rst b/docs/kbase/internals/migra= tion.rst similarity index 100% rename from docs/kbase/migrationinternals.rst rename to docs/kbase/internals/migration.rst diff --git a/docs/kbase/meson.build b/docs/kbase/meson.build index e37feb6d30..269bf64a94 100644 --- a/docs/kbase/meson.build +++ b/docs/kbase/meson.build @@ -2,7 +2,6 @@ docs_kbase_files =3D [ 'backing_chains', 'debuglogs', 'domainstatecapture', - 'incrementalbackupinternals', 'index', 'kvm-realtime', 'launch_security_sev', @@ -12,7 +11,6 @@ docs_kbase_files =3D [ 'locking-sanlock', 'memorydevices', 'merging_disk_image_chains', - 'migrationinternals', 'qemu-core-dump', 'qemu-passthrough-security', 'rpm-deployment', @@ -73,3 +71,5 @@ endforeach html_xslt_gen =3D [] # --- end of XSLT processing --- + +subdir('internals') --=20 2.35.1