man: zfs-promote.8: import examples from zfs.8

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #13228

man/man8/zfs-promote.8

@@ -29,7 +29,7 @@
 .\" Copyright 2018 Nexenta Systems, Inc.
 .\" Copyright 2019 Joyent, Inc.
 .\"
-.Dd June 30, 2019
+.Dd March 16, 2022
 .Dt ZFS-PROMOTE 8
 .Os
 .
@@ -59,6 +59,26 @@ The
 .Nm zfs Cm rename
 subcommand can be used to rename any conflicting snapshots.
 .
+.Sh EXAMPLES
+.\" These are, respectively, examples 10 from zfs.8
+.\" Make sure to update them bidirectionally
+.Ss Example 1 : No Promoting a ZFS Clone
+The following commands illustrate how to test out changes to a file system, and
+then replace the original file system with the changed one, using clones, clone
+promotion, and renaming:
+.Bd -literal -compact -offset Ds
+.No # Nm zfs Cm create Ar pool/project/production
+  populate /pool/project/production with data
+.No # Nm zfs Cm snapshot Ar pool/project/production Ns @ Ns Ar today
+.No # Nm zfs Cm clone Ar pool/project/production@today pool/project/beta
+  make changes to /pool/project/beta and test them
+.No # Nm zfs Cm promote Ar pool/project/beta
+.No # Nm zfs Cm rename Ar pool/project/production pool/project/legacy
+.No # Nm zfs Cm rename Ar pool/project/beta pool/project/production
+  once the legacy version is no longer needed, it can be destroyed
+.No # Nm zfs Cm destroy Ar pool/project/legacy
+.Ed
+.
 .Sh SEE ALSO
 .Xr zfs-clone 8 ,
 .Xr zfs-rename 8

man/man8/zfs.8

@@ -305,6 +305,7 @@ if invalid command line options were specified.
 .\" Examples 5 are shared with zfs-list.8.
 .\" Examples 8 are shared with zfs-rollback.8.
 .\" Examples 9, 10 are shared with zfs-clone.8.
+.\" Examples 10 are also shared with zfs-promote.8.
 .\" Examples 12, 13 are shared with zfs-send.8.
 .\" Examples 12, 13 are also shared with zfs-receive.8.
 .\" Examples 17, 18, 19, 20, 21 are shared with zfs-allow.8.