From nobody Thu May 2 21:57:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1600867088; cv=none; d=zohomail.com; s=zohoarc; b=BbSEZCHBvNObLanUgiIlXL30QQHyxjgf7S9/bDdwA3NQ36FUseCkSU0zBoOqa5GzhsXAJ6V5XKv0FBO5733BsExCjQ+1zFwjOE7HGMwzk3z3bgK0kGdMKqairaEb/JiRZfZg0PBWOpIoqhtjZ95rION81UUUeu8iF/QyrNsd6Ug= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1600867088; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=lBYHOCnnEFN6zNPG4M3ortq/UhPiXsg+9FABDrtOgGo=; b=afLY1S0GeJj1alhrvo7kYbo9jcXOgGZ3v15cKw+L9veZcU4D4athysDPmT7+o3H33Argg2wLGxaVSkXmSmQpJbq4wSNJDq30uS1mZmUDvJIZnczvpu52357/5/5po5hbKtgppoivTn3MxLRsIISmO0ay+LOxNxbv9Ll95uz+76k= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 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-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1600867088959207.1667238214418; Wed, 23 Sep 2020 06:18:08 -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-9-VNx7RKmcPfW3v3V2EA20Yw-1; Wed, 23 Sep 2020 09:18:04 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id D1C951007B29; Wed, 23 Sep 2020 13:17:58 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id E64FB60BEC; Wed, 23 Sep 2020 13:17:57 +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 8B41C183D040; Wed, 23 Sep 2020 13:17:56 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 08NDHtll012248 for ; Wed, 23 Sep 2020 09:17:55 -0400 Received: by smtp.corp.redhat.com (Postfix) id 8D05D100AE54; Wed, 23 Sep 2020 13:17:55 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 88F851002D41 for ; Wed, 23 Sep 2020 13:17:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1600867087; 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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=lBYHOCnnEFN6zNPG4M3ortq/UhPiXsg+9FABDrtOgGo=; b=KGwzKX8bxacGOZgWl+7BKTeHt7WYmCIKvMN4i1CvCLRENNnSuf1wM79m7NqPMQwqaUASvR 62aL9RnlNnZbcyNcougzazzDEx/eHKFG9Xp2kuEh+v77UHdfx2BKuSWPV+a7OdI1HSahU9 gYBpwrDWMObZbKbppc8zHQa9SV4R5cw= X-MC-Unique: VNx7RKmcPfW3v3V2EA20Yw-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH] docs: manpages: Strip table of contents from manpages Date: Wed, 23 Sep 2020 15:17:50 +0200 Message-Id: <35f8dcc77fbcf1584e9de3430f049114085d1ea1.1600867070.git.pkrempa@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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.12 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-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) After meson conversion the man pages started to contain the table of contents. In autoconf we prevented this by a 'grep -v ::contents' in the command building the manpages. A more cultured solution is to strip out the 'contents' docutils element directly. Reported-by: Daniel P. Berrang=C3=A9 Signed-off-by: Peter Krempa Reviewed-by: Daniel P. Berrang=C3=A9 Reviewed-by: J=C3=A1n Tomko Reviewed-by: Pavel Hrdina --- docs/manpages/meson.build | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build index 3888bb8efe..7ed1d304a4 100644 --- a/docs/manpages/meson.build +++ b/docs/manpages/meson.build @@ -89,7 +89,8 @@ foreach data : docs_man_files man_file, input: rst_file, output: man_file, - command: [ rst2man_prog, '--strict', '@INPUT@', '@OUTPUT@' ], + # 'contents' element is the table of contents which is undesired in = manpage + command: [ rst2man_prog, '--strip-elements-with-class', 'contents', = '--strict', '@INPUT@', '@OUTPUT@' ], install: true, install_dir: mandir / 'man@0@'.format(data['section']), ) --=20 2.26.2