We converted exclusively to https links so the generator should wrap those in appropriate link tags too. Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- docs/newapi.xsl | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/newapi.xsl b/docs/newapi.xsl index e56a5f2a27..f2e8bd5334 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -131,6 +131,11 @@ <xsl:value-of select="$token"/> </a> </xsl:when> + <xsl:when test="starts-with($token, 'https://')"> + <a href="{$token}"> + <xsl:value-of select="$token"/> + </a> + </xsl:when> <xsl:when test="starts-with($token, '&lt;http://') and contains($token, '&gt;')"> <xsl:variable name="link" select="substring(substring-before($token, '&gt;'), 2)"/> -- 2.37.1

Checkpoints created via virDomainCheckpointCreateXML are generally not very useful as they need to be coupled with a backup. Add a disclaimer to the docs explaining why users should use virDomainBackupBegin instead. Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- src/libvirt-domain-checkpoint.c | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/libvirt-domain-checkpoint.c b/src/libvirt-domain-checkpoint.c index de747aff01..078e999bf3 100644 --- a/src/libvirt-domain-checkpoint.c +++ b/src/libvirt-domain-checkpoint.c @@ -142,6 +142,16 @@ virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint) * present, an error is thrown. This flag is incompatible with * VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE. * + * Note: A checkpoint represent s point in time since which blocks changed by + * the hypervisor are tracked. The tracking of changed blocks notes only whether + * a block was modified, but does not preserve the old contents. This means that + * for a checkpoint to be generally usable for doing an incremental backup it's + * required to perform a backup at the same time as taking the checkpoint. + * This is done via the virDomainBackupBegin API, which also allows to create + * a checkpoint at the same time. virDomainCheckpointCreateXML is generally not + * useful for creating checkpoints but rather only for re-creating the libvirt + * metadata. + * * Returns an (opaque) new virDomainCheckpointPtr on success or NULL * on failure. * -- 2.37.1

Use the full link to the backup XML description page and use the proper anchor after html->RST coversion. Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- src/libvirt-domain.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c index 842663a608..80a6f0f269 100644 --- a/src/libvirt-domain.c +++ b/src/libvirt-domain.c @@ -13582,7 +13582,7 @@ virDomainAgentSetResponseTimeout(virDomainPtr domain, * * virDomainBackupGetXMLDesc() can be called to learn actual * values selected. For more information, see - * formatcheckpoint.html#BackupAttributes. + * https://www.libvirt.org/formatbackup.html#backup-xml * * The @checkpointXML parameter is optional; if non-NULL, then libvirt * behaves as if virDomainCheckpointCreateXML() were called to create -- 2.37.1