Add a manpage for snapper-sync

diff --git a/configure.ac b/configure.ac
index f15bf28ed908272905c07b0a24e20c6fc069bc64..013a79c7ed1b8e77732bc51af16d2598920d1fbe 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -242,6 +242,7 @@ AC_CONFIG_FILES([
        doc/snapperd.xml:doc/snapperd.xml.in
        doc/snapper-configs.xml:doc/snapper-configs.xml.in
        doc/snbk.xml:doc/snbk.xml.in
+       doc/snapper-sync.xml:doc/snapper-sync.xml.in
        doc/snapper-backup-configs.xml:doc/snapper-backup-configs.xml.in
        doc/snapper-zypp-plugin.xml:doc/snapper-zypp-plugin.xml.in
        doc/snapper-zypp-plugin.conf.xml:doc/snapper-zypp-plugin.conf.xml.in

diff --git a/dists/debian/snapper-backup.manpages b/dists/debian/snapper-backup.manpages
index f1f434bacc50918f2bb8924753b2414f11cdce27..a937b71d9490e9f22f3f36e22fd81667d6739433 100644 (file)
--- a/dists/debian/snapper-backup.manpages
+++ b/dists/debian/snapper-backup.manpages
@@ -1,2 +1,3 @@
 debian/tmp/usr/share/man/man8/snbk.8
+debian/tmp/usr/share/man/man8/snapper-sync.8
 debian/tmp/usr/share/man/man5/snapper-backup-configs.5

diff --git a/doc/Makefile.am b/doc/Makefile.am
index f6fe4220a639e4b2c0050cee6d99e8e61b4de85f..640e3e100ec1a2ab000f9b1af617c7420e67d43c 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -4,7 +4,8 @@
 
 if ENABLE_DOC
 
-man_MANS = snapper.8 snapperd.8 snapper-configs.5 snbk.8 snapper-backup-configs.5
+man_MANS = snapper.8 snapperd.8 snapper-configs.5              \
+          snbk.8 snapper-sync.8 snapper-backup-configs.5
 
 if HAVE_PAM
 man_MANS += pam_snapper.8

diff --git a/doc/snapper-sync.xml.in b/doc/snapper-sync.xml.in
new file mode 100644 (file)
index 0000000..c0791c9
--- /dev/null
+++ b/doc/snapper-sync.xml.in
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry id='snapper-sync8' xmlns:xlink="http://www.w3.org/1999/xlink">
+
+  <refentryinfo>
+    <date>2026-07-16</date>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>snapper-sync</refentrytitle>
+    <manvolnum>8</manvolnum>
+    <refmiscinfo class='date'>2026-07-16</refmiscinfo>
+    <refmiscinfo class='version'>@VERSION@</refmiscinfo>
+    <refmiscinfo class='manual'>Filesystem Snapshot Management</refmiscinfo>
+  </refmeta>
+
+  <refnamediv>
+    <refname>snapper-sync</refname>
+    <refpurpose>Script to synchronize the highest snapshot number</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>snapper-sync</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para><command>snapper-sync</command> is a script to synchronize the highest snapshot
+    number across the source and backup target devices, avoiding a potential snapshot
+    number collision after restoration. For details, please refer to the
+    <citerefentry>
+      <refentrytitle>snbk</refentrytitle><manvolnum>8</manvolnum>
+    </citerefentry>
+    documentation</para>
+  </refsect1>
+
+  <refsect1 id='exit_status'>
+    <title>EXIT STATUS</title>
+    <para>Normally the exit status is 0. If an error occurred the exit status is 1.</para>
+  </refsect1>
+
+  <refsect1 id='homepage'>
+    <title>HOMEPAGE</title>
+    <para><ulink url='http://snapper.io/'>http://snapper.io/</ulink></para>
+  </refsect1>
+
+  <refsect1 id='authors'>
+    <title>AUTHORS</title>
+    <para>Arvin Schnell <email>aschnell@suse.com</email></para>
+  </refsect1>
+
+  <refsect1 id='see_also'>
+    <title>SEE ALSO</title>
+    <para>
+      <citerefentry><refentrytitle>snbk</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+    </para>
+  </refsect1>
+
+</refentry>

diff --git a/snapper.spec.in b/snapper.spec.in
index b6974acd20b67b114410d85b805500f9e901a358..53371e8619b8a8d99d8ef8faf9bc19e367c3d2d1 100644 (file)
--- a/snapper.spec.in
+++ b/snapper.spec.in
@@ -380,6 +380,7 @@ A backup program for snapshots created by snapper.
 %{_unitdir}/snapper-timeline.timer.d
 %{_unitdir}/snapper-timeline.timer.d/10-snapper-sync-override.conf
 %{_mandir}/*/snbk.8*
+%{_mandir}/*/snapper-sync.8*
 %{_mandir}/*/snapper-backup-configs.5*
 %dir %{_datadir}/bash-completion
 %dir %{_datadir}/bash-completion/completions