From nobody Tue Apr 5 14:08:58 2022 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 85E1B1A8667C; Tue, 5 Apr 2022 14:08:58 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KXqJB32Blz4Sqp; Tue, 5 Apr 2022 14:08:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649167738; 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=c/eT1/I8gmFsLtq7WAu8cBUJKZNsFfiN8RguV/Cx7eA=; b=iiyYuUpDBTDKEAPrJU2ICyI+m5oLqOPH+Gk6PFA4XDFF7GVKwF0f9gR7HqU4IT6/B0dw2Z ehOldp2aoqLSjyncLAkY1dFGojCi5yzkriBNcNTKWy7eInXW6b6CBM7BGhRIUIaIFUf2IQ KyXHMjtk29poNFyRzlPZ0K/IpvvBbb+A7GKb0XETBlhsxs2U/ZMI/kbDN5zgFOGmrv6m7d dMzLEo9oNI1lDvU23+0sPhW1Xjz9nHCIC1Uz5i0+IhjPIOBqXYMzqcbjDWw5ASip+jzX3G elW8j2EcbnXSaa+sW386Fbct+qR8jgkG78ryyFo9I0wyysftDz7P4diB/MedyQ== 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 4868A27A60; Tue, 5 Apr 2022 14:08:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 235E8w4m079139; Tue, 5 Apr 2022 14:08:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 235E8wQP079138; Tue, 5 Apr 2022 14:08:58 GMT (envelope-from git) Date: Tue, 5 Apr 2022 14:08:58 GMT Message-Id: <202204051408.235E8wQP079138@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 4cb463698e55 - stable/12 - freebsd-update.8: Fix use of mdoc(8) macros 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: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/stable/12 X-Git-Reftype: branch X-Git-Commit: 4cb463698e55a47c4aeff06c1dbd1bb326fde81e Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649167738; 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=c/eT1/I8gmFsLtq7WAu8cBUJKZNsFfiN8RguV/Cx7eA=; b=rZ+F77KJUrbp2mOHW+3OXMu/W9I/XOsZ9R3e1z7FEmbtG8ArH14s8TZUW5HEXVz0rkhIIS +p4YGCO+9ooF+MgGvWk53B8LqiV3tFZk3DqzEeQ79MNE+ReSrwCYhx1CxI63DW1cP1CpDG wu+sUj/BLvEWBFPexgioXGkj1JX1M0g75Z/OirKZnYT0dslXWtm6B4KuAETUZbLV29RhfB WIJKGDL/cav+qhx3l/23db6F0NP6y9hLNRZsz0sSssjktZUl7XRlzC598+o39zz4xohNk7 qRV4Xikk8ifZ7uR7yBH4V3aU4jSpwnrwLH3rfkMkKnmfdk8hT2iy/D+tlioZvw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649167738; a=rsa-sha256; cv=none; b=DZA3YWQMAElSVAMKKk7FGAwBun5wChLvbhAdzzMnTCQz7Aid/hZBeDnu2WjwLRv3ZFDkHE luDQgUmeLbfnTF+Zc1Sqb22JoGu0KMaA5LBTLc4Tr1wiYN2jVYjiAGDaSo2KyYBKCSKT/t EItcyuosAXGeBUt3J4whC9ySANINnwQe0Jnfy7Bz6jlvGrev2wke7evKycILC0qLrh5aqC ck5gRLmb3Ln+j6t9SStz/F7whoXoLpQbqmvLq3BhKJHiy7xdGNaKgIjddei60zHv1XKcNI LUOQmoCFb8eXtXCZXLrwEWdrrl/ZHU+oAl/47fG+ktEuXYOz81Api+DaTGNPCQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=4cb463698e55a47c4aeff06c1dbd1bb326fde81e commit 4cb463698e55a47c4aeff06c1dbd1bb326fde81e Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-29 12:35:46 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-05 14:06:19 +0000 freebsd-update.8: Fix use of mdoc(8) macros - Use Ar for arguments. - Use Cm for freebsd-update commands like "upgrade". - Reference other manuals with Xr when possible. MFC after: 1 week (cherry picked from commit 15647a710641ea8327bcabfc95ff5b4ed8e68234) --- usr.sbin/freebsd-update/freebsd-update.8 | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8 index be477d0cdce7..9b0e4400d425 100644 --- a/usr.sbin/freebsd-update/freebsd-update.8 +++ b/usr.sbin/freebsd-update/freebsd-update.8 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 1, 2021 +.Dd March 29, 2022 .Dt FREEBSD-UPDATE 8 .Os .Sh NAME @@ -43,7 +43,7 @@ .Op Fl s Ar server .Op Fl t Ar address .Op Fl -not-running-from-cron -.Cm command ... +.Ar command ... .Sh DESCRIPTION The .Nm @@ -106,7 +106,8 @@ Trust an RSA key with SHA256 of .It Fl r Ar newrelease Specify the new release (e.g., 11.2-RELEASE) to which .Nm -should upgrade (upgrade command only). +should upgrade +.Pq Cm upgrade No command only . .It Fl s Ar server Fetch files from the specified server or server pool. (default: read value from configuration file.) @@ -119,11 +120,14 @@ command, if any, to .It Fl -not-running-from-cron Force .Nm Cm fetch -to proceed when there is no controlling tty. +to proceed when there is no controlling +.Xr tty 4 . This is for use by automated scripts and orchestration tools. Please do not run .Nm Cm fetch -from crontab or similar using this flag, see: +from +.Xr crontab 5 +or similar using this flag, see: .Nm Cm cron .It Fl -currently-running Ar release Do not detect the currently-running release; instead, assume that the @@ -190,7 +194,9 @@ If your clock is set to local time, adding the line .Pp .Dl 0 3 * * * root /usr/sbin/freebsd-update cron .Pp -to /etc/crontab will check for updates every night. +to +.Pa /etc/crontab +will check for updates every night. If your clock is set to UTC, please pick a random time other than 3AM, to avoid overly imposing an uneven load on the server(s) hosting the updates.