From nobody Tue Apr 05 14:09:29 2022 X-Original-To: dev-commits-src-branches@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 51F1A1A87585; Tue, 5 Apr 2022 14:09:31 +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 4KXqJp39Tfz4TB1; Tue, 5 Apr 2022 14:09:30 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649167771; 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=ViWFx5REfJ7cMb+2jCKhGe+EfQQ0j91g04OlRHbTeHE=; b=HWru7CN5Fd+rGd2te2B3oZeIovm1mEe25RGDT4sFN4rVHlPOumPEIs/2OdJbVPzHCXbyf/ bhdd4nha+9HXAFHZ3ha+VKvjli25ktPKAmdq/LVibiLAxJCA6zKRpfn0VDItVrf/nanoJM VTcyZXsfFkbxL/2rO8nmEIPuGlMs+LltF/Z0Vc6uw2+7qwCeJ90gsJBM82otWSLkKYzb+P hpx8/iXJrJFe2EAkmAG7oK+BbJC0rXd0ofu9aJBYqYTgHwnc7j/Iq5BzGKFqNyK2UkUM3i Vct3WGCudArm7sdm6Gy/ahsVJoYxhZNsc/wLCZOz/SOPzVG1wmXZ1XqKaTqo2Q== 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 0FC5827E8E; Tue, 5 Apr 2022 14:09:30 +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 235E9T5r079354; Tue, 5 Apr 2022 14:09:29 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 235E9TrN079353; Tue, 5 Apr 2022 14:09:29 GMT (envelope-from git) Date: Tue, 5 Apr 2022 14:09:29 GMT Message-Id: <202204051409.235E9TrN079353@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: dee5ec942e10 - stable/13 - freebsd-update.8: Fix use of mdoc(8) macros List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/13 X-Git-Reftype: branch X-Git-Commit: dee5ec942e10275e6dbab1e83a3dfd1043210935 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649167771; 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=ViWFx5REfJ7cMb+2jCKhGe+EfQQ0j91g04OlRHbTeHE=; b=tbRlt9d7KyfhhJmX5V5h9qPylxH7iRtWKZeLdxITQ0h14zSK6Rrhf7olvA3ejcGvwwpVZS jn1WSiC65R04/5XRDwVvOBjkS+OdLChj5t+tizqozqwBIX0BjlieQ67mJ+GU3+nuD3tXan DaCbLN8Jw+irKGUGhJPnozPsfzK2UzaBnLSctZ84ykQ0xkhpsRe1WmjkgDtued19CCRrX3 S7Aoi20tc32zSSTqyDQLCu3TFkcxXeAzxw5VqO5EUqBGXZz3cm0XFIRe1LLXZuziTbg0PB TLxx+tFPsXX/3QA4MCjy7JplCg+pN0hOXYsnYIUxvEZn5OXtU5gBrC2Oaqw1Ig== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649167771; a=rsa-sha256; cv=none; b=yIipwkbxaoIWOa3z+XaPR2USKBn6tvs3WqEe5XDJLqxmUfcsCbV0nA4h5AR4xiHGOckeJ3 N9M/LMB8weWZgDS1VUmxSkUc42jPyMHKLpcuW6IXQVYbqmPelZJoPv/BX/y0GdBSoRZjy0 YQnchh9gvUgTiTDdDTBrHWJFlfONbyT5hyEOkIVZmsmY78Lf9tFkONJc4qNos82Gy60CEo svyZcBX1nTAf32HajbtnIKE9/7SrnGEAbUguaqCsIBp8X/eb0Ilvp1wCBVAI3m3fUchgAA 2EhPFazA4tz+pNEclJjNM11sQ/9/x6JRHxfzQUxk1EEOL/Bphf/IhF41XU5alw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=dee5ec942e10275e6dbab1e83a3dfd1043210935 commit dee5ec942e10275e6dbab1e83a3dfd1043210935 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:08:43 +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.