From nobody Sat Oct 4 23:24:53 2025 X-Original-To: dev-commits-src-main@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 4cfM7p0nmnz6B8PY; Sat, 04 Oct 2025 23:24:54 +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 4cfM7p09LVz3NLq; Sat, 04 Oct 2025 23:24:54 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759620294; 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=uBHfEXmMInZXjp8uhIOCeFvGzk2EkP2plZ2+ETYndio=; b=DSlKiZS3llHIpCHM1fWNqx4R+b/xwMd0O0vgRrvG2QY2aVaJ35ZPsADzm9a775e5AQeEnk W67XsykozcsVoXyPIGg7AuGItFXbfS7H+0bs3HfGICprQfoZvK3ZQDdP5K4N+odKmqESaY 8zORZ8TvRqZ+DgIbqpEhwMFJSd39OYBv9yNczjEb7BCH8T1TpVe0ZfFnrh382SKOPIL5Ld 0RYJIPQaC5O08YUlGEhnGEgIBFIVtlVdTrBM4Rw01sXDP6kxJkLVjpiEadFYapkObh2Nrh 4j9ypwGcUr+5kJWlMv8J93UsWujCYB9k/AgqF+oe6bj+FsyVJpph6JdLCElP/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759620294; 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=uBHfEXmMInZXjp8uhIOCeFvGzk2EkP2plZ2+ETYndio=; b=A4yS8osxArz9VZ8gcNUV6qUu0t7L78QwEEXdItljqwtBIPCizsYQKSsh/uLNA6bG+Q/tG3 wMP2fRa0J8KcF0DbIFWxpbdYPpmNX89O2XXlz8XWvNGwo4D4XIiEvDROvE9LBkq24+xG4D 4OH2f9DDtdOjZdcb3ai826o754QoXHcd7jedShuqE58kvIZmRm6jN7rln55r2jZ8JVyb+F 2Of7t/nF1ZyE/hSIjAcbCProoGuMRM038RQeksnO5ZaRCcAQ4aRcGn4XyHNH7UJ1KqGPXV JIUnpBN7lSF2scRl+egpeXCVXVfgZXjp6NAzcMzFbB3y5VQmXzLFwa862t+u+g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1759620294; a=rsa-sha256; cv=none; b=EssBtWYKhoXlcC66r3ANNQGrP2BVxao5n4Z8is/XOYQNXed9yUgubiLwWULGRMk2QbA8wH Fp6H0fNRuhEzIrp+kl6SnRcW92ZoxawBoD2zQv//ikGq6F8xM+RPwqssmn3LZZA0tcfZld tyLIsfy14wxhY41ZkuHO5qYDBfWWZOUJi/jdhmS4hvEG4Kwd7nGVqZLR8dlg4oYS6Ce//c npJjzG6ZTF7nnx2MuOprF+SK4dAsIAp8dyhh7wwFYER4SxY+m6KruP9OZpywKW/mJ3VCXw 2W+i9IkRsiIeuNpVoAnnW5YJ94u5QbSylu5u+h9chVPQ8MIxNxnXWssGhTqGcw== 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 4cfM7n6qZ9z13GY; Sat, 04 Oct 2025 23:24:53 +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 594NOrlw012105; Sat, 4 Oct 2025 23:24:53 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 594NOr7N012102; Sat, 4 Oct 2025 23:24:53 GMT (envelope-from git) Date: Sat, 4 Oct 2025 23:24:53 GMT Message-Id: <202510042324.594NOr7N012102@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 81d9e08a4df4 - main - bsdinstall.8: Minor maintenance List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@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/main X-Git-Reftype: branch X-Git-Commit: 81d9e08a4df42079d5e163b5991d5d6f3a28d4f0 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=81d9e08a4df42079d5e163b5991d5d6f3a28d4f0 commit 81d9e08a4df42079d5e163b5991d5d6f3a28d4f0 Author: Alexander Ziaee AuthorDate: 2025-10-03 22:26:05 +0000 Commit: Alexander Ziaee CommitDate: 2025-10-04 23:24:15 +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 --- 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: