From owner-freebsd-doc@freebsd.org Tue Mar 19 19:13:41 2019 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 7D6AB1532C61 for ; Tue, 19 Mar 2019 19:13:41 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id ECC9D6BC2F for ; Tue, 19 Mar 2019 19:13:40 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id A2D611532C5E; Tue, 19 Mar 2019 19:13:40 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6181A1532C5D for ; Tue, 19 Mar 2019 19:13:40 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id E9D096BC2B for ; Tue, 19 Mar 2019 19:13:39 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id 32F51E786 for ; Tue, 19 Mar 2019 19:13:39 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id x2JJDdBk056645 for ; Tue, 19 Mar 2019 19:13:39 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id x2JJDdt7056644 for doc@FreeBSD.org; Tue, 19 Mar 2019 19:13:39 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 235850] bectl(8): create should mention it creates from booted system without any other argument Date: Tue, 19 Mar 2019 19:13:39 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: needs-patch X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: kevans@freebsd.org X-Bugzilla-Status: In Progress X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: 0mp@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: cc Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 19 Mar 2019 19:13:41 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D235850 Kyle Evans changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |kevans@freebsd.org --- Comment #3 from Kyle Evans --- (In reply to Mateusz Piotrowski from comment #1) Right, he's talking specifically about the 'create' subcommand. I note that= the man page here is kind of... bad. We should do the following: 1.) Get rid of the bectl create [-r] beName@snapshot line in SYNOPSIS 2.) Get rid of the same down in commands 3.) Amend the create command description to mention: If the .Fl e argument is specified, the new environment will be cloned from the given nonActiveBE | beName@snapshot. When the .Fl e argument is not specified, the new environment will be created from the currently booted environment.=20 If .Nm is creating from another boot environment, a snapshot of that boot environm= ent will be created to clone from. Of course, the markup is basically all wrong, but I think that gets the idea across. We should mention for those not familiar with bectl that the defaul= t is to use the currently booted environment, and we should mention for those ma= ybe not necessarily familiar with some of the underlying ZFS terminology that create of anything other than beName@snapshot implies that a snapshot of th= at boot environment will be made for creation. --=20 You are receiving this mail because: You are on the CC list for the bug.=