From nobody Tue May 7 10:07:15 2024 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 Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [207.211.31.81]) by mx.zohomail.com with SMTPS id 1580293167572825.7430157489811; Wed, 29 Jan 2020 02:19:27 -0800 (PST) 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-271-CGkJeSK4NdGhjAgX9QTCVQ-1; Wed, 29 Jan 2020 05:19:10 -0500 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 4FB7213E2; Wed, 29 Jan 2020 10:19:05 +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 E02F260BE0; Wed, 29 Jan 2020 10:19:04 +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 9BB6C18089CD; Wed, 29 Jan 2020 10:19:03 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 00TAJ1VW029971 for ; Wed, 29 Jan 2020 05:19:01 -0500 Received: by smtp.corp.redhat.com (Postfix) id CAB2F84BC4; Wed, 29 Jan 2020 10:19:01 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-112-16.ams2.redhat.com [10.36.112.16]) by smtp.corp.redhat.com (Postfix) with ESMTP id C17E988821; Wed, 29 Jan 2020 10:19:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1580293166; 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=WeHGywrej9DefGUxJOkWeIcFatwwL8zM1fkH6QpyMvE=; b=AbN2rgH63mOnb2KLbe7XwxpQAiUtPt4idZOY1NoahhfBDtGKNRn/ml1t7hh8tBu1gvkAds M6EsQblCHlaVgBGgo5WUIfcqWAL56wN/dGkrtAsI5AdgjI/tMLhtKjRh+3bFdyaNmWAQ2g 6om42eTlsMIetBOz9bQV96vuzDMw17g= From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH 1/2] docs: fix various duplicate link targets in virsh.rst Date: Wed, 29 Jan 2020 10:18:54 +0000 Message-Id: <20200129101855.1582866-2-berrange@redhat.com> In-Reply-To: <20200129101855.1582866-1-berrange@redhat.com> References: <20200129101855.1582866-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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 X-MC-Unique: CGkJeSK4NdGhjAgX9QTCVQ-1 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" You can't have two links with the same text when using named link references (a single "_"). If you need multiple links with the same text you must use anonymous link references (a double "_"). There are also some duplicate section headers causing the same problem with duplicate link targets. Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: J=C3=A1n Tomko --- docs/manpages/virsh.rst | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index 8841ae1b31..105b0d8f03 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -356,7 +356,7 @@ connect is automatically run with the *URI* parameter requested by the ``-c`` option on the command line. The *URI* parameter specifies how to connect to the hypervisor. The URI docs -`https://libvirt.org/uri.html `_ list the +`https://libvirt.org/uri.html `__ list the values supported, but the most common are: =20 =20 @@ -379,7 +379,7 @@ values supported, but the most common are: To find the currently used URI, check the *uri* command documented below. =20 For remote access see the URI docs -`https://libvirt.org/uri.html `_ on how +`https://libvirt.org/uri.html `__ on how to make URIs. The *--readonly* option allows for read-only connection =20 =20 @@ -879,7 +879,7 @@ domain capabilities XML (printed by ``domcapabilities``= command). In addition to the element itself, this command accepts full domain XML, capabilities XML, or domain capabilities XML containing the CPU definition. For more information on guest CPU definition see: -`https://libvirt.org/formatdomain.html#elementsCPU `_. If *--error* is +`https://libvirt.org/formatdomain.html#elementsCPU `__. If *--error* is specified, the command will return an error when the given CPU is incompatible with host CPU and a message providing more details about the incompatibility will be printed out. @@ -943,7 +943,7 @@ host CPU model found in the domain capabilities XML (pr= inted by the ``domcapabilities`` command). In addition to the element itself, this command accepts full domain XML, capabilities XML, or domain capabilities = XML containing the CPU definition. For more information on guest CPU definition -see: `https://libvirt.org/formatdomain.html#elementsCPU `_. +see: `https://libvirt.org/formatdomain.html#elementsCPU `__. =20 The *virttype* option specifies the virtualization type (usable in the 'ty= pe' attribute of the top level element from the domain XML). *emulato= r* @@ -1819,8 +1819,8 @@ domid Convert a domain name (or UUID) to a domain id =20 =20 -domif ------ +domif-getlink +------------- =20 **Syntax:** =20 @@ -1835,8 +1835,8 @@ purposes, *--persistent* is alias of *--config*. *interface-device* can be the interface's target name or the MAC address. =20 =20 -domif ------ +domif-setlink +------------- =20 **Syntax:** =20 @@ -1979,7 +1979,7 @@ inbound or outbound bandwidth. *average,peak,burst,fl= oor* is the same as in command *attach-interface*. Values for *average*, *peak* and *floor* are expressed in kilobytes per second, while *burst* is expressed in kilob= ytes in a single burst at *peak* speed as described in the Network XML -documentation at `https://libvirt.org/formatnetwork.html#elementQoS `_. +documentation at `https://libvirt.org/formatnetwork.html#elementQoS `__. =20 To clear inbound or outbound settings, use *--inbound* or *--outbound* respectfully with average value of zero. @@ -2444,8 +2444,8 @@ domuuid Convert a domain name or id to domain UUID =20 =20 -domxml ------- +domxml-from-native +------------------ =20 **Syntax:** =20 @@ -2462,8 +2462,8 @@ VMware/ESX hypervisor, the *format* argument must be = ``vmware-vmx``. For the Bhyve hypervisor, the *format* argument must be ``bhyve-argv``. =20 =20 -domxml ------- +domxml-to-native +---------------- =20 **Syntax:** =20 @@ -4392,7 +4392,7 @@ attach-device Attach a device to the domain, using a device definition in an XML file using a device definition element such as or as the top-level element. See the documentation at -`https://libvirt.org/formatdomain.html#elementsDevices `_ to learn about +`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about libvirt XML format for a device. If *--config* is specified the command alters the persistent domain configuration with the device attach taking effect the next time libvirt starts the domain. @@ -4549,7 +4549,7 @@ specified. The other two *peak* and *burst* are opti= onal, so are expressed in kilobytes per second, while *burst* is expressed in kilobytes in a single burst at *peak* speed as described in the Network XML documentation at -`https://libvirt.org/formatnetwork.html#elementQoS `_. +`https://libvirt.org/formatnetwork.html#elementQoS `__. =20 ``--managed`` is usable only for *hostdev* type and tells libvirt that the interface should be managed, which means detached and reattached @@ -4719,7 +4719,7 @@ Update the characteristics of a device associated wit= h *domain*, based on the device definition in an XML *file*. The *--force* option can be used to force device update, e.g., to eject a CD-ROM even if it is locked/mounted in the domain. See the documentation at -`https://libvirt.org/formatdomain.html#elementsDevices `_ to learn about +`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about libvirt XML format for a device. =20 If *--live* is specified, affect a running domain. @@ -4957,7 +4957,7 @@ VIRTUAL NETWORK COMMANDS The following commands manipulate networks. Libvirt has the capability to define virtual networks which can then be used by domains and linked to actual network devices. For more detailed information about this feature -see the documentation at `https://libvirt.org/formatnetwork.html `_ . Many +see the documentation at `https://libvirt.org/formatnetwork.html `__ . Many of the commands for virtual networks are similar to the ones used for doma= ins, but the way to name a virtual network is either by its name or UUID. =20 @@ -4986,7 +4986,7 @@ net-create =20 Create a transient (temporary) virtual network from an XML *file* and instantiate (start) the network. -See the documentation at `https://libvirt.org/formatnetwork.html `_ +See the documentation at `https://libvirt.org/formatnetwork.html `__ to get a description of the XML network format used by libvirt. =20 =20 --=20 2.24.1 From nobody Tue May 7 10:07:15 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) client-ip=205.139.110.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) by mx.zohomail.com with SMTPS id 1580293167699894.1701184444499; Wed, 29 Jan 2020 02:19:27 -0800 (PST) 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-80-eD_0yseuNreLAIaXOsoIYg-1; Wed, 29 Jan 2020 05:19:23 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 1BCEE800D41; Wed, 29 Jan 2020 10:19:17 +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 E306B8702C; Wed, 29 Jan 2020 10:19:16 +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 7DBE58577C; Wed, 29 Jan 2020 10:19:16 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 00TAJ3ft029978 for ; Wed, 29 Jan 2020 05:19:03 -0500 Received: by smtp.corp.redhat.com (Postfix) id 3CC9E84BC5; Wed, 29 Jan 2020 10:19:03 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-112-16.ams2.redhat.com [10.36.112.16]) by smtp.corp.redhat.com (Postfix) with ESMTP id 38D7788821; Wed, 29 Jan 2020 10:19:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1580293166; 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=yI0nW09x98pxUru/YA7oxb8+Jpb1EAPBXq2niEOQzrw=; b=iGh+v0Y/jUlrXtYfNe6XUlB/MbPJXkjo6UkwlnhQnTEe8VkzoMBteRRxR7uVisg7VUasJJ fcGMmVM3zGUUQB9LjzHFMybMwSugD5TnxyNx7pCli44o38AB1uHL98zVIhwPQ6LFLQtjor abF0nx9muFZLBeyUp3mW8xWEOfDeJoE= From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH 2/2] docs: use --strict arg when processing rst docs Date: Wed, 29 Jan 2020 10:18:55 +0000 Message-Id: <20200129101855.1582866-3-berrange@redhat.com> In-Reply-To: <20200129101855.1582866-1-berrange@redhat.com> References: <20200129101855.1582866-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.15 X-MC-Unique: eD_0yseuNreLAIaXOsoIYg-1 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" The --strict arg forces the rst tools to abort with an error instead of printing warnings to stderr, or the output document. Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: J=C3=A1n Tomko --- docs/Makefile.am | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/Makefile.am b/docs/Makefile.am index 94ae5079dd..61862c4ab7 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -267,21 +267,21 @@ man8_MANS =3D $(manpages8_rst:%.rst=3D%.8) grep -v '^\.\. contents::' < $< | \ sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \ -e 's|RUNSTATEDIR|$(runstatedir)|g' | \ - $(RST2MAN) > $@ || { rm $@ && exit 1; } + $(RST2MAN) --strict > $@ || { rm $@ && exit 1; } =20 %.7: %.rst $(AM_V_GEN)$(MKDIR_P) `dirname $@` && \ grep -v '^\.\. contents::' < $< | \ sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \ -e 's|RUNSTATEDIR|$(runstatedir)|g' | \ - $(RST2MAN) > $@ || { rm $@ && exit 1; } + $(RST2MAN) --strict > $@ || { rm $@ && exit 1; } =20 %.8: %.rst $(AM_V_GEN)$(MKDIR_P) `dirname $@` && \ grep -v '^\.\. contents::' < $< | \ sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \ -e 's|RUNSTATEDIR|$(runstatedir)|g' | \ - $(RST2MAN) > $@ || { rm $@ && exit 1; } + $(RST2MAN) --strict > $@ || { rm $@ && exit 1; } =20 manpages/virkeycode-%.rst: $(top_srcdir)/src/keycodemapdb/data/keymaps.csv= \ $(top_srcdir)/src/keycodemapdb/tools/keymap-gen Makefile.am @@ -420,11 +420,11 @@ manpages/%.html.in: manpages/%.rst grep -v '^:Manual ' < $< | \ sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \ -e 's|RUNSTATEDIR|$(runstatedir)|g' | \ - $(RST2HTML) > $@ || { rm $@ && exit 1; } + $(RST2HTML) --strict > $@ || { rm $@ && exit 1; } =20 %.html.in: %.rst $(AM_V_GEN)$(MKDIR_P) `dirname $@` && \ - $(RST2HTML) $< > $@ || { rm $@ && exit 1; } + $(RST2HTML) --strict $< > $@ || { rm $@ && exit 1; } =20 %.html.tmp: %.html.in site.xsl subsite.xsl page.xsl \ $(acl_generated) --=20 2.24.1