From nobody Thu Oct 9 14:26:12 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cjBxw3skpz6BWn3; Thu, 09 Oct 2025 14:26:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cjBxw2YHvz3mjG; Thu, 09 Oct 2025 14:26:12 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760019972; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=caVLWqmQyURGparjRA0pGLAkJSuD172kcm18zBImjxs=; b=TXnVjBp2NYd5Bflxmy+C/i+hb5sJNQtdaEJxOldQjZ9tCFdBoMMCqoiT5JkS+Q7SPaS7TA dTJ5PXzuccgel7DAvQff+meUiVtx4jrkxqqYc0FnOG8FEhAbMDdd2dxCwOX1GKH6gvNxD1 h6LcC/tUA6x7p6KOoPvf0H4U8ecZ/2TyZaHyqZ6elWASQk1xKzGti2WVn9ec9Ov4lofzS+ wEI6WK1TauigHdfliX1pQbMakO7Y9OqG00FWyNrFjwC8Rvq3tcKvbqYBmH33jGdfbrMNDt fDdEU5OES0Qd7yq63RK5REAf80EPDV7ruT8e/cKKidG9Z1axE2sXmU5ZgLdDYw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760019972; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=caVLWqmQyURGparjRA0pGLAkJSuD172kcm18zBImjxs=; b=Y/PR6at+SXli4JshsBDlocO0lQneY2gUiTAvQqOrnyTLrAsxHVmcN2rtWM2xbS8g+HVnmz P0swsioR7T5treEjXMKhedTn/BqpqyBNDWfE1G32vM2QlKKzpXB5azARYHf7GolqWvtI6T 8eki7ZMDmcT2djrCu4o9arpFs/xlYOGlUCew7BGDN5Mh/0Nejcw1jbgjZGveKlVCE7C5Oa tQ4OuWKEgLQnNDIjlU49i5F9Anl/PgAmxaIgeVuHEzeFN1B2YtWOuz9r+KEdhjzwU4PKRK ZRvhSY9dsJjZeo9jX3v+c40JmTqpQxWIoBruNL2HRrF1rUt7TdYEi2U7lrg3hA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1760019972; a=rsa-sha256; cv=none; b=t2KB6KKakOe+ReuataDMS5TT9qy7bzi+KZCOyMwkzGp5vCOfavbf/y4FpXXlvvf924aV/3 s7f1d4rYRfSQHq7B86vjM11nSh2YvQ9Eom1zWNWi5OgGUOijm+hRjy1YaGjDVw5wJDZIpC eTJjvp0RAnFrKGSsQPVd/0nMJEteznRaf0FyycNpCYE3UMnxKenFGfdT2uUDGmYEKs2fVq RNYlDxsRoluItuPIeGlefcObmKJK1UDvTaoPrrMhk3ePNSFGzeQCljBH0H4UDmXqxnMBr+ mNnuvNypSj4zmRU26utMI645ZAqH7IccSPRFrc4WIbIBvbKWci0Y1BEciPIHug== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cjBxw27D5z5v6; Thu, 09 Oct 2025 14:26:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 599EQCnd079811; Thu, 9 Oct 2025 14:26:12 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 599EQCxm079808; Thu, 9 Oct 2025 14:26:12 GMT (envelope-from git) Date: Thu, 9 Oct 2025 14:26:12 GMT Message-Id: <202510091426.599EQCxm079808@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 4e2526fc9956 - stable/15 - bsdinstall.8: Minor maintenance List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 4e2526fc9956ee9cf82f6457195b2bf709fd445f Auto-Submitted: auto-generated The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=4e2526fc9956ee9cf82f6457195b2bf709fd445f commit 4e2526fc9956ee9cf82f6457195b2bf709fd445f Author: Alexander Ziaee AuthorDate: 2025-10-03 22:26:05 +0000 Commit: Alexander Ziaee CommitDate: 2025-10-09 14:25:08 +0000 bsdinstall.8: Minor maintenance Replace CD-ROMs with "discs, USBs, or network boot environments" to both modernize aesthetic and also nudge youths to think at scale. Since I'm disrupting the flow of these lines anyway, expand the VM acronym because I think this is one of the first manuals people will be looking at. Reset list alignment to seven characters. It was at 19 characters, and that was not enough to align them all, wasting many extra lines by crunching all the words over. Seven actually bought us some lines from six due to avg item size. Tag SPDX. MFC after: 3 days Discussed with: ivy, zi (cherry picked from commit 81d9e08a4df42079d5e163b5991d5d6f3a28d4f0) --- usr.sbin/bsdinstall/bsdinstall.8 | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/usr.sbin/bsdinstall/bsdinstall.8 b/usr.sbin/bsdinstall/bsdinstall.8 index 527250d380d1..6175d26b4fd3 100644 --- a/usr.sbin/bsdinstall/bsdinstall.8 +++ b/usr.sbin/bsdinstall/bsdinstall.8 @@ -1,4 +1,6 @@ -.\"- +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2011-2013 Nathan Whitehorn All rights reserved. .\" Copyright (c) 2018 Roberto Fernandez Cueto .\" Copyright (c) 2024 The FreeBSD Foundation @@ -27,7 +29,7 @@ .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd November 4, 2024 +.Dd October 3, 2025 .Dt BSDINSTALL 8 .Os .Sh NAME @@ -40,9 +42,10 @@ .Op Ar ... .Sh DESCRIPTION .Nm -is used for installation of new systems, both for system setup from -installation media, e.g., CD-ROMs, and for use on live systems to prepare -VM images and jails. +is used for installation of new systems, +both for system setup from installation media, +such as discs, USBs, or network boot environments, +and for use on live systems to prepare jails and virtual machine images. .Pp Much like .Xr make 1 , Nm @@ -56,7 +59,7 @@ these subtargets can be invoked separately by an installation script. .Sh OPTIONS .Nm supports the following options, global to all targets: -.Bl -tag -width indent+ +.Bl -tag -width "-D file" .It Fl D Ar file Provide a path for the installation log file .Pq overrides Ev BSDINSTALL_LOG . @@ -73,7 +76,7 @@ For interactive use, most users will be interested only in the and .Cm script targets. -.Bl -tag -width "jail destination" +.Bl -tag -width "-D file" .It Cm auto Run the standard interactive installation, including disk partitioning. .It Cm jail Ar destination @@ -295,7 +298,7 @@ Many are used internally during installation and have reasonable default values for most installation scenarios. Others are set by various interactive user prompts, and can be usefully overridden when making scripted or customized installers. -.Bl -tag -width "BSDINSTALL_DISTSITE" +.Bl -tag -width "-D file" .It Ev TMPDIR The directory to use for temporary files. Default: