From nobody Tue Mar 29 12:40:57 2022 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 AE0A91A4C05C; Tue, 29 Mar 2022 12:40:57 +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 4KSTgs4T5fz4pMl; Tue, 29 Mar 2022 12:40:57 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648557657; 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=f9vGMB1PSuldPOp52UgqkqJpQ8KTuwphlLFzcH2lQGc=; b=YVGhPUJnw+rsiyHUaxhCjkoDOB/K+ycvwitL+VTyxnkjJHmOp4hrEp23XNG/ZwTvKW/i4n xa7KZ4yGjkyJoMgAX+LVtSS2xX+KpFF+SzUkqMrMAjjy3Ahsm59c8UJtArdjVatDvCfBnd WbF09jl6uiT0acdEonel7v+6tQHs5fr3pF4Hqpwuf2HgZU4V71S3lt8DR32/+5mRAs7LVu uieQmm2aj4+uCpk2ie3NpiZoVuEQ1xLOXs8S2Ex3ArWOyfkEk1TccbXW71OAacL3Ejhj0M dJYrdvGgfRbzBV0AsEHuJKASviI5RGIZnjIdXFDsk1k9Ec0GSmyyYxUQJBZ9ig== 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 796BF1E772; Tue, 29 Mar 2022 12:40:57 +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 22TCevjn009161; Tue, 29 Mar 2022 12:40:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22TCevMe009160; Tue, 29 Mar 2022 12:40:57 GMT (envelope-from git) Date: Tue, 29 Mar 2022 12:40:57 GMT Message-Id: <202203291240.22TCevMe009160@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 15647a710641 - main - freebsd-update.8: Fix use of mdoc(8) macros 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: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@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/main X-Git-Reftype: branch X-Git-Commit: 15647a710641ea8327bcabfc95ff5b4ed8e68234 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648557657; 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=f9vGMB1PSuldPOp52UgqkqJpQ8KTuwphlLFzcH2lQGc=; b=fMQSZbEpbbyibxV6mmaY4ywQUd8kT3QvwVZttCugdamb5QDH5T3xB/RLLEwygLIPDAqgBd mw0Yn75YRYii7pUicJoyIAFdoOkXfM91/0rPLRRzcQwiKIZ+eMVZW+YAC31+q+jf++H7EV Wk7RYtAccf65tEkIKcgwErAq27cjWL6t8B9rBPYKpftCiYO1S7UGP2D3v8GONw9wBiCwLH KAzZwG54tLT0wy2ahAWPZmjA/hBorzMejmN9eJtM5AVGbb1iOgpbqX0Is2O7qWGosW65F9 +QnKl7nTt+ANj9KRELwZjTjM661m+3mCbcrsRuOvQYTC7aDpeI1UrxmXEZGv5A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648557657; a=rsa-sha256; cv=none; b=IaSnFCuSv/nqJUE65dAvR8joQtOQ6AsPd4yMOk4UAfNVqWWPSfTYKV0yIBREk76RysDgeT uGoXp13xlbi8+f4zlOl+OswndKrUCrFzegt2K0f1cDvck13dBvBn4dGGl6iJtf3KRHQL2J AnWJK1G/jC5+5Oy12mgLVqH1fbTXMQyB6AlbQ/vXc/ogvXRsXmP/Te7FGHhxQXInVkSHWs F8IaF0c7XIXoo8/R6YxLBXUcbx31Y4bvzJSEwOgp+nQipftF8KYwDUYLHwx7JlF361qPMH kW/TGfOeOS63BmoCqjdQNhAAZ3p3W8m3iUJUTAelxF+u2OVgPZOzJTGZTweDYw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=15647a710641ea8327bcabfc95ff5b4ed8e68234 commit 15647a710641ea8327bcabfc95ff5b4ed8e68234 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-29 12:35:46 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-29 12:39:15 +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 --- 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.