[libvirt] [PATCH 12/17] docs: convert virt-sanlock-cleanup man page from pod to rst

Daniel P. Berrangé berrange at redhat.com
Fri Dec 6 14:50:37 UTC 2019


This was a semi-automated conversion. First it was run through pod2rst,
and then it was manually editted to use a rst structure that matches
expectations of rst2man.

Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
---
 docs/Makefile.am                       |  1 +
 docs/manpages/index.rst                |  1 +
 docs/manpages/virt-sanlock-cleanup.rst | 79 ++++++++++++++++++++++++++
 tools/Makefile.am                      |  3 -
 tools/virt-sanlock-cleanup.pod         | 49 ----------------
 5 files changed, 81 insertions(+), 52 deletions(-)
 create mode 100644 docs/manpages/virt-sanlock-cleanup.rst
 delete mode 100644 tools/virt-sanlock-cleanup.pod

diff --git a/docs/Makefile.am b/docs/Makefile.am
index fa41077381..b652d361b3 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -207,6 +207,7 @@ manpages1_rst = \
 manpages7_rst = \
   $(NULL)
 manpages8_rst = \
+  manpages/virt-sanlock-cleanup.rst \
   $(NULL)
 manpages_rst += \
   $(manpages1_rst) \
diff --git a/docs/manpages/index.rst b/docs/manpages/index.rst
index 5042071c7d..85a9100ce8 100644
--- a/docs/manpages/index.rst
+++ b/docs/manpages/index.rst
@@ -15,3 +15,4 @@ Tools
 * `virt-host-validate(1) <virt-host-validate.html>`__ - validate host virtualization setup
 * `virt-pki-validate(1) <virt-pki-validate.html>`__ - validate libvirt PKI files are configured correctly
 * `virt-xml-validate(1) <virt-xml-validate.html>`__ - validate libvirt XML files against a schema
+* `virt-sanlock-cleanup(8) <virt-sanlock-cleanup.html>`__ - remove stale sanlock resource lease files
diff --git a/docs/manpages/virt-sanlock-cleanup.rst b/docs/manpages/virt-sanlock-cleanup.rst
new file mode 100644
index 0000000000..ac49fa4191
--- /dev/null
+++ b/docs/manpages/virt-sanlock-cleanup.rst
@@ -0,0 +1,79 @@
+====================
+virt-sanlock-cleanup
+====================
+
+-----------------------------------------
+remove stale sanlock resource lease files
+-----------------------------------------
+
+:Manual section: 1
+:Manual group: Virtualization Support
+
+.. contents::
+
+SYNOPSIS
+========
+
+``virt-sanlock-cleanup``
+
+
+DESCRIPTION
+===========
+
+This tool removes any resource lease files created by the sanlock
+lock manager plugin. The resource lease files only need to exist
+on disks when a guest using the resource is active. This script
+reclaims the disk space used by resources which are not currently
+active.
+
+
+EXIT STATUS
+===========
+
+Upon successful processing of leases cleanup, an exit status
+of 0 will be set. Upon fatal error a non-zero status will
+be set.
+
+
+AUTHOR
+======
+
+Daniel P. Berrangé
+
+
+BUGS
+====
+
+Please report all bugs you discover.  This should be done via either:
+
+#. the mailing list
+
+   `https://libvirt.org/contact.html <https://libvirt.org/contact.html>`_
+
+#. the bug tracker
+
+   `https://libvirt.org/bugs.html <https://libvirt.org/bugs.html>`_
+
+Alternatively, you may report bugs to your software distributor / vendor.
+
+
+COPYRIGHT
+=========
+
+Copyright (C) 2011, 2013 Red Hat, Inc.
+
+
+LICENSE
+=======
+
+``virt-sanlock-cleanup`` is distributed under the terms of the GNU GPL v2+.
+This is free software; see the source for copying conditions. There
+is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
+PURPOSE
+
+
+SEE ALSO
+========
+
+virsh(1), `online instructions <https://libvirt.org/locking.html>`_,
+`https://libvirt.org/ <https://libvirt.org/>`_
diff --git a/tools/Makefile.am b/tools/Makefile.am
index ca4dcfc9f6..01bba235a4 100644
--- a/tools/Makefile.am
+++ b/tools/Makefile.am
@@ -55,14 +55,12 @@ ICON_FILES = \
 PODFILES = \
 	virt-admin.pod \
 	virt-login-shell.pod \
-	virt-sanlock-cleanup.pod \
 	virsh.pod \
 	$(NULL)
 
 MANINFILES = \
 	virt-admin.1.in \
 	virt-login-shell.1.in \
-	virt-sanlock-cleanup.8.in \
 	virsh.1.in \
 	$(NULL)
 
@@ -97,7 +95,6 @@ man1_MANS = \
 
 if WITH_SANLOCK
 sbin_SCRIPTS = virt-sanlock-cleanup
-man8_MANS = virt-sanlock-cleanup.8
 DISTCLEANFILES += virt-sanlock-cleanup
 endif WITH_SANLOCK
 
diff --git a/tools/virt-sanlock-cleanup.pod b/tools/virt-sanlock-cleanup.pod
deleted file mode 100644
index 41012566a1..0000000000
--- a/tools/virt-sanlock-cleanup.pod
+++ /dev/null
@@ -1,49 +0,0 @@
-=head1 NAME
-
-virt-sanlock-cleanup - remove stale sanlock resource lease files
-
-=head1 SYNOPSIS
-
-B<virt-sanlock-cleanup>
-
-=head1 DESCRIPTION
-
-This tool removes any resource lease files created by the sanlock
-lock manager plugin. The resource lease files only need to exist
-on disks when a guest using the resource is active. This script
-reclaims the disk space used by resources which are not currently
-active.
-
-=head1 EXIT STATUS
-
-Upon successful processing of leases cleanup, an exit status
-of 0 will be set. Upon fatal error a non-zero status will
-be set.
-
-=head1 AUTHOR
-
-Daniel Berrange
-
-=head1 BUGS
-
-Report any bugs discovered to the libvirt community via the
-mailing list L<https://libvirt.org/contact.html> or bug tracker
-L<https://libvirt.org/bugs.html>.
-Alternatively report bugs to your software distributor / vendor.
-
-=head1 COPYRIGHT
-
-Copyright (C) 2011, 2013 Red Hat, Inc.
-
-=head1 LICENSE
-
-virt-sanlock-cleanup is distributed under the terms of the GNU GPL v2+.
-This is free software; see the source for copying conditions. There
-is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
-PURPOSE
-
-=head1 SEE ALSO
-
-L<virsh(1)>, online instructions L<https://libvirt.org/locking.html>
-
-=cut
-- 
2.23.0




More information about the libvir-list mailing list