svn commit: r348305 - stable/11/sbin/bectl

[Kyle Evans]

Author: kevans
Date: Mon May 27 13:14:22 2019
New Revision: 348305
URL: https://svnweb.freebsd.org/changeset/base/348305

Log:
  MFC r348127: bectl(8): add description for create subcommand
  
  In commit r345845, a portion of documentation for the create subcommand was
  removed. Specifically, for creating a snapshot of an existing boot
  environment. bectl even has a test-case for this functionality.
  
  Removing the sub-command description was discussed in PR 235850.
  
  This patch brings back the second "create" description that was originally
  in place. Albeit, with a few wording/clarifying changes.
  
  Approved by:	re (marius)

Modified:
  stable/11/sbin/bectl/bectl.8
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/sbin/bectl/bectl.8
==============================================================================
--- stable/11/sbin/bectl/bectl.8	Mon May 27 13:12:51 2019	(r348304)
+++ stable/11/sbin/bectl/bectl.8	Mon May 27 13:14:22 2019	(r348305)
@@ -18,7 +18,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd April 3, 2019
+.Dd May 12, 2019
 .Dt BECTL 8
 .Os
 .Sh NAME
@@ -35,6 +35,10 @@
 .Op Fl e Brq Ar nonActiveBe | Ar beName Ns Cm @ Ns Ar snapshot
 .Ar newBeName
 .Nm
+.Cm create
+.Op Fl r
+.Ar beName at snapshot
+.Nm
 .Cm destroy
 .Op Fl \&Fo
 .Ar beName Ns Op Cm @ Ns Ar snapshot
@@ -120,6 +124,20 @@ Otherwise, the new environment will be created from th
 If
 .Nm
 is creating from another boot environment, a snapshot of that boot environment will be created to clone from.
+.It Xo
+.Cm create
+.Op Fl r
+.Ar beName at snapshot
+.Xc
+Create a snapshot of the boot environment named
+.Ar beName .
+.Pp
+If the
+.Fl r
+flag is given, a recursive snapshot of the boot environment will be created.
+A snapshot is created for each descendant dataset of the boot environment.
+.Pp
+No new boot environment is created with this command.
 .It Xo
 .Cm destroy
 .Op Fl \&Fo