From nobody Mon Jan 16 18:20:16 2023 X-Original-To: dev-commits-doc-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 4NwgL85CQ1z2t1KP for ; Mon, 16 Jan 2023 18:20:16 +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 4NwgL84gClz3hK0; Mon, 16 Jan 2023 18:20:16 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1673893216; 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=TXkcGlC/rvFc2jjSEoIdtFfX6GyF0DAHGLCWvyg1pqw=; b=xF2PlS0ceI2Xr40LpDXCqTtqHuF2DC7sl4wpNOtYHwzfLD2y/V3avsk/mKbR640ckyHLpz JCDGWPUnz0S2cVNm/ghpBOA8XXMmS3THcvdW+Ds+MUSK+eMWomOqOfbAuN2iBW3efANaRw rHaTlE7Z+4sAfBdWqVXs2BlRciEWe8DreqO2+88dKtMMts++TZrt8kzHYVJOfX0o6iHs6O UBd0SK3MsMtKP08Gk9iTVk3R+2n4cEFAjcgr6hZS5/t6lXNVqlcIUVcg6n8tlPyU3brCyP JFfe9SmSXYVCQdL4G+TjlZBq0tS48Un1gmX2BA7o/GcKftzTpQJy5t7HBy7Fgg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1673893216; 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=TXkcGlC/rvFc2jjSEoIdtFfX6GyF0DAHGLCWvyg1pqw=; b=HDeHn0gHhIrDk9PtODMRmW4LUQYTJLCiX8Q3qWKslRvliZSsrVjsiUCvXCnFcxWAF1gDhw 9FNlfX9aCpZvJmldLf/rjoDeKUA58RW5vAopROwSFDVLYIbQehhoHnm64emZuxmMpaEUPx 4sQf+4TMi5COQH9n7PpUbb97adxicpSK8sO6RfpVp1i1aXnhi79AOW/v1Jp3F9BdCqKjdc hz+quaWlhyrXRg4843yXr0L04PgI7eN+c2NaR4d4vR3yarxwti0kFkgUPHBuj7OpVpvkHg gpRAHYnQFXIfUB5R7QsP+DEk2NwYXh5iIybVlANL3WwBq39L26dHQa9F+8vnkQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1673893216; a=rsa-sha256; cv=none; b=dhf6tjsODIIkwyc+EsFc2vyThBRZ8TzgRFVXxec8uW56Foo15Kh85WHzbqK46sG7UeteIH lfrhypf0BKLXJ5nkb2PUSaRdTDQi4Bz8RGI/eafSk3qDuuDdX4zMS921hJqTy71cZs1mtR 7gFnu6PQ98UFT8dEnPJ/bBpSuAsU0bNVGZfcg9DGv/mSOkqEVuPjtaqp+vroA/F34Lgo61 iAlJRv0EN6LDQywXnq3G6LrmNfmPqqezgliqBzBUB3ETkMhFcWf0cyEgJQKI3bNotMWBBy yDOB4cMApsvTGXmRheTcM/IfJ8vUihey+A49N9i6ObsjWfIvsjLF4cd2tZgCCw== 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 4NwgL83k0fz1GPd; Mon, 16 Jan 2023 18:20:16 +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 30GIKGNV072488; Mon, 16 Jan 2023 18:20:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30GIKGWh072481; Mon, 16 Jan 2023 18:20:16 GMT (envelope-from git) Date: Mon, 16 Jan 2023 18:20:16 GMT Message-Id: <202301161820.30GIKGWh072481@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: cab5f02b26 - main - SA/EN templates: sync with secteam repo List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cab5f02b268232771875489845cf56eab37923b0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/doc/commit/?id=cab5f02b268232771875489845cf56eab37923b0 commit cab5f02b268232771875489845cf56eab37923b0 Author: Ed Maste AuthorDate: 2023-01-16 18:18:42 +0000 Commit: Ed Maste CommitDate: 2023-01-16 18:19:44 +0000 SA/EN templates: sync with secteam repo --- website/static/security/advisory-template.txt | 12 ++++++------ website/static/security/errata-template.txt | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/website/static/security/advisory-template.txt b/website/static/security/advisory-template.txt index 9917e6b971..baa938a140 100644 --- a/website/static/security/advisory-template.txt +++ b/website/static/security/advisory-template.txt @@ -6,16 +6,16 @@ Topic: Category: < core | contrib > Module: -Announced: 2022-XX-XX +Announced: 2023-XX-XX Credits: Affects: -Corrected: 2022-XX-XX XX:XX:XX UTC (stable/13, 13.1-STABLE) - 2022-XX-XX XX:XX:XX UTC (releng/13.1, 13.1-RELEASE-pXX) - 2022-XX-XX XX:XX:XX UTC (stable/12, 12.4-STABLE) - 2022-XX-XX XX:XX:XX UTC (releng/12.3, 12.3-RELEASE) - 2022-XX-XX XX:XX:XX UTC (releng/12.4, 12.4-XX) +Corrected: 2023-XX-XX XX:XX:XX UTC (stable/13, 13.1-STABLE) + 2023-XX-XX XX:XX:XX UTC (releng/13.1, 13.1-RELEASE-pXX) + 2023-XX-XX XX:XX:XX UTC (stable/12, 12.4-STABLE) + 2023-XX-XX XX:XX:XX UTC (releng/12.3, 12.3-RELEASE-pXX) + 2023-XX-XX XX:XX:XX UTC (releng/12.4, 12.4-RELEASE-pXX) CVE Name: CVE-XXXX-XXXX For general information regarding FreeBSD Security Advisories, diff --git a/website/static/security/errata-template.txt b/website/static/security/errata-template.txt index e75ca867c6..edfd5bf1c0 100644 --- a/website/static/security/errata-template.txt +++ b/website/static/security/errata-template.txt @@ -6,16 +6,16 @@ Topic: Category: < core | contrib > Module: -Announced: 2022-XX-XX +Announced: 2023-XX-XX Credits: Affects: -Corrected: 2022-XX-XX XX:XX:XX UTC (stable/13, 13.1-STABLE) - 2022-XX-XX XX:XX:XX UTC (releng/13.1, 13.1-RELEASE-pXX) - 2022-XX-XX XX:XX:XX UTC (stable/12, 12.4-STABLE) - 2022-XX-XX XX:XX:XX UTC (releng/12.3, 12.3-RELEASE) - 2022-XX-XX XX:XX:XX UTC (releng/12.4, 12.4-XX) +Corrected: 2023-XX-XX XX:XX:XX UTC (stable/13, 13.1-STABLE) + 2023-XX-XX XX:XX:XX UTC (releng/13.1, 13.1-RELEASE-pXX) + 2023-XX-XX XX:XX:XX UTC (stable/12, 12.4-STABLE) + 2023-XX-XX XX:XX:XX UTC (releng/12.3, 12.3-RELEASE-pXX) + 2023-XX-XX XX:XX:XX UTC (releng/12.4, 12.4-RELEASE-pXX) For general information regarding FreeBSD Errata Notices and Security Advisories, including descriptions of the fields above, security From nobody Tue Jan 17 20:48:21 2023 X-Original-To: dev-commits-doc-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 4NxLZY70JDz2v2gG for ; Tue, 17 Jan 2023 20:48:21 +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 4NxLZY5n1Zz3wpY; Tue, 17 Jan 2023 20:48:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1673988501; 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=giUNQ4NPnz90lM8wqTdl8NYePJXLLPnNunKWHqFRueY=; b=UnpD2aJOKnuW8tXdovZXuR+ZPwuTch4GK/CeG/DpHdz+e5qboK+LzNWrnI4XI4lXnYxI41 0vkLINo04y4oMNmdiE3yVnQjX4tH7yXskkQV5oZy/gt7ukjf/KThpFRE5AtXz2q/JM1xNE bw1F1xHAikefsTXoXmzFJO3rotZEgyNt+Ere4zHDZP2SJg7+RJ87pYJDnvfjATds588Kzx Pk4/ORShBnECHZCO2/dR3lou6iuFMlDcRgPq/efyXxSX/E7u9Lj7rVLpWIJnuOvtYL2xpu SaGHUoGYz9RJBKqxEocpZM+aF1p0UZkuIMF9lDS2Az5FAqRlSc5dF/0i6RfRAg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1673988501; 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=giUNQ4NPnz90lM8wqTdl8NYePJXLLPnNunKWHqFRueY=; b=oJ+3Tl+7D5rQNKYgfAxdO3TEjom8qTO6Aieub8k0nx7wjZSCcO5XQEUTSJYR5auaQ33u0B GRMotLf+3WutEJnQGbssH7/TiAFGoaey6fIyC0koOAEzcqUOInSF78gb1fnlTpB4lt4Oae Zbp0Y9szOTY4ahxUSI5M9wlGb57IdkN22TNA8w3tSqLqGwKU2Y1ME+plIyReoY5nK03Wes GFEx/q5UZQtItvC1Mr6375m7URVLiclzMbCtvSCbO9t1HlZ7RYYhO7Q6nvGm/j+6usMCGz pHxNuc0zsFoA3saK2G7dQArpfBOrV1HWP4SKCjD/GBEVFZ7ohmmJ1LqNN+4zTQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1673988501; a=rsa-sha256; cv=none; b=Bx5fk1axbX0QnymLkL7FSY5lArMQQvjxshyHP0d/TyGRZyoq+il61mX8/zb8sDuAi66EuJ f4HAKk5JOtiSLEW38zwRo6cJhqnlgFouGyX6aIDYeiFrNNG9qgjWozn1WpdiTeTZFrtnUT 3oaBAVA92rCRJ1+AtkyIUb7MwJ5065AtKSn7pht4Dnb2bR7Pi/ZkXnY7DeLcMkXLJSj6Rc MOjp7TTrt6PEQdLj4egCpHgt07QATxd+7KPgXSdUxuLnXSlVmqb/SgdIs/Tf+jZW7pIacJ lr/CuALLAZZzq6KzvJfivxJRChh4I3I16+lI7DuaUNVYSQxEohUf0mdJOwFHCw== 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 4NxLZY4rLNzlb2; Tue, 17 Jan 2023 20:48:21 +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 30HKmL6r049117; Tue, 17 Jan 2023 20:48:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30HKmL16049116; Tue, 17 Jan 2023 20:48:21 GMT (envelope-from git) Date: Tue, 17 Jan 2023 20:48:21 GMT Message-Id: <202301172048.30HKmL16049116@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Rene Ladan Subject: git: 1d19899875 - main - Extend the expiration date of my GPG key. List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rene X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1d1989987560ad64bbfee480d761b03b649d8df6 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by rene: URL: https://cgit.FreeBSD.org/doc/commit/?id=1d1989987560ad64bbfee480d761b03b649d8df6 commit 1d1989987560ad64bbfee480d761b03b649d8df6 Author: Rene Ladan AuthorDate: 2023-01-17 20:47:49 +0000 Commit: Rene Ladan CommitDate: 2023-01-17 20:47:49 +0000 Extend the expiration date of my GPG key. --- documentation/static/pgpkeys/rene.key | 54 +++++++++++++++++------------------ 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/documentation/static/pgpkeys/rene.key b/documentation/static/pgpkeys/rene.key index ec00a6551d..4a4aef3b5b 100644 --- a/documentation/static/pgpkeys/rene.key +++ b/documentation/static/pgpkeys/rene.key @@ -2,10 +2,10 @@ [.literal-block-margin] .... -pub rsa4096/ADBBF8610A3789B7 2012-11-18 [SC] [expires: 2023-01-12] +pub rsa4096/ADBBF8610A3789B7 2012-11-18 [SC] [expires: 2024-01-17] Key fingerprint = 101A 716B 162B 00E5 5BED EA05 ADBB F861 0A37 89B7 uid René Ladan -sub rsa4096/CB77BE03B67184C6 2012-11-18 [E] [expires: 2023-01-12] +sub rsa4096/CB77BE03B67184C6 2012-11-18 [E] [expires: 2024-01-17] .... @@ -26,18 +26,18 @@ PsgaPDzFkKm6gkLKDmJVXrYUJYvyYxUasMO/LRD4CXsH06KtF6l/wQEAyEQRXFn4 NDQGlWAQbxWTfdUCE7Tvq94jG5Nz+OtN6H5sYK2aUdKsDoYkCa1eK8dQHQARAQAB tB5SZW7DqSBMYWRhbiA8cmVuZUBmcmVlYnNkLm9yZz6JAlgEEwEKAEICGwMGCwkI BwMCBhUIAgkKCwQWAgMBAh4BAheAAhkBFiEEEBpxaxYrAOVb7eoFrbv4YQo3ibcF -AmHfRiMFCRMXJxwACgkQrbv4YQo3ibcsIBAAuTYyKv2RyhxfCGUNoqhFPGzD8el/ -AJCbDuD0VLvL+5yvWF3XLEXNUvqJp1ernXV6H5nmnOStm8DkiMMxa47qcM25K/Wb -5OUDcvwgRnuk0K0kR0mMKSZkwwgRuu4mSeMCq5VIExJoUxPZPDPyU53qH589dsXd -+gklDgiLMvR1ZcPplcCvFbO9SXY/4GRAt7AKsu2rpGG91RMr2u7spN69uxRhbY3y -H9H91OY4lwt9W+HVNHNVr6W4XmKh4+ZFFpYZHWsLXD8U5Yx9vqbNFOqzjTPqweEu -L05X7KdaGU6O4Mr64crWsnoHG163+dR0tHyHRWpwV66VgAts+SID1/pWS052fbIM -l/vIQQZTVW4Qi/RjnopNzElOmgzvUYNJnWLNbZu6HXPFrv5lEGUrwVPqLcvDJJ9n -mi4wCjip6/O+H5M3VMCrJdPCn+WXNXE008OTIn2T/acVQ1Y/tXjWhen4F8+9OzSY -HDimMJTi7rNJB9z8bPiRl3udJ+ZK0n8U0P4OdIIFiUNThp4xk4s8XEgsMORQJMv6 -WwyrQKMyChbmhzRApddR24IBxqOt/BcvXGJHGFtjN9rJQrodEUGFZoNJzcql2wJu -bgd17PalBqoENuFMwO5JfTpZUvjpy04i9ovDiyc7wOCGZWED6fkzQ5BDF9dQe0VJ -uC7SadQMdRGga9CJAhwEEAEIAAYFAlCp0z0ACgkQqchsjdOujTqBFQ/+IRl+WvxW +AmPHBuUFCRT+594ACgkQrbv4YQo3ibceMw//awoRzVK1HqGV6ESdfcz1RXYLRpum +o7tn/rLxelrO8GXRbySf6PeC3mW8mt4Q7QP3Lc1LUwezBN6wjV6Fpse+iTyhQy4a +SJ1MRVW9YxbtRkaBYkCwvdpP19QQ9K0r5826Hg74U+jw/SKmhdofLGWDwePdAagW +xfRdT6DF7wNnr+Vjxyb644ddn/wf+F+JsRE2oNHdSJpjb/y1O2KSfinEiQspad9J +qzebawdgW5uR9D91KuhZk+iIq8cKQiWjwSYzA2JLX43fd40sKcqVO80OvkMPhRPH +Ziouq3z1yK0Blip1dJ0JTUWklJxldlQfc/m+MTyh4hgPRXYJisMHUEgSwgPF8ROr +kKww23rJ3dNpM013CaHS0pfshIcyI1Q0Nke+raQ76godyt1s6XqhHMO5yLYq/XeP +crBBoVdZTH/13pw68Hb2zWqRdkY65xST/IMQtSDjIXCkMSKFD2RPLRkaQb75TKqH +musLIIWshfXoEnFuEZW1gAcMHz3Utuopr1JCE752amTTVaF8YLoqFGZWjO4uQVrw +DAfkLabJO221Yw+R7Qgm8gjUvoTTLIagocChiq2ELySwWNNRxyDY21/rvhh9H1Dw +ZZVA01w072dKGLw7m2ojYprQvvSWkJA4Otf/HuG3JTzqJBi1KEbUDfGqlQ8BdunL +aK86+uA3br3sIEKJAhwEEAEIAAYFAlCp0z0ACgkQqchsjdOujTqBFQ/+IRl+WvxW qduN4MEFgpe3flJanjKZIh7sOsMVhKTdlCq09c7Sr4axQPslBvmklvO5IaOMaTgx b7fo7dqjrhYozE2MWEHf7qTa2TQG/ZU9sBM0W+u7GbBY8WAokIidqm4FcxPqneJG iG34ebtv+I3ZPwKJn/0AwvDlmG0oONm6JftJigxnl2dsxG5PHYtEt0FtpsN0D4fG @@ -95,18 +95,18 @@ ugFs5d0z1sTi3kWXWNBK0UV7cKJp2mrk8jxtKGphYRP7X09KMkljQgs8yJfVO6I3 sSshdnt30wo/AJtf1gGCCuSgZdi/jcwYFQeR28c/dlLpw864vJR+uWZnxfibPZjJ +MPQqoa6YuhOkJAg+dfwwkOEDIADhMfiBrPRMRThIWG46BXLaEBrWgIkbtQnXmYD Ppz5auJVaRkIPZM+BnnQkobMNwQ5++m3TVKd4QT5ABEBAAGJAjwEGAEKACYCGwwW -IQQQGnFrFisA5Vvt6gWtu/hhCjeJtwUCYd9F9gUJExcm7wAKCRCtu/hhCjeJt/Pt -D/9lKfmLSnASrlhChIpmo1OGQuFryocmYnOq9Ygga/sFOOJ2xoSmqjsSeijnxq6W -26ykwtalHIc5ZuSIQMhJJlTu+Jbq+bzs5ndtxNfeHbqU6Q/BSEoUsiwz2wtOWNX/ -Y6WpF5k7Bj61wzVBDiQg1tT/aAhvF3IHUGmuDZ7paDAG9+sxDSIE2S9Mv7wOIeSi -iOh27439mDY98Dw3cY77oMIg0XVWYpzFVqzhyRb5/TBMOmeIKCauz1f25j6NMY3Z -E54cwQ4+okuxeEcxSGGdJ7ubkqXVpGbpphjS/uQKftM/uwasaKF1Vnhg9AJbcTt5 -k3M3gxD2mZYEJs9F3SXr/7JrrMGjtSDaZGdbjJoYvEtdHjdllvjpvV7LubYHZxo9 -oRVrL8vx5zsT1FmGuqw+hDJH2xe0rHn6GZgEvLL+u4Q+5Jrlp6IBBHeqQdEa38on -A8MHxDBZwjy2BQL+76o1G5vckCTJi65+qQXti9Nizd24Q3UfWBBY93yjCcB7+2gu -hYlujjRtWxgJzjQfLw4J1UZp1ILjq8lEC6ioNfbQw5yvHvPjTVBI3/uqrYVr31Cp -Zo4HiX3UEShEzIHwExZdStA5ESCkAa2VjadiVNLHchSSK82BGtRHy6od8AZu4IYq -bBcRDSi2dcQWiCdQ3NHm2exSbqQAK4imIQMbN5/f6en4qw== -=GsRP +IQQQGnFrFisA5Vvt6gWtu/hhCjeJtwUCY8cIFgUJFP7pDwAKCRCtu/hhCjeJt+08 +EACh5Y41nAIaFY3vsN1JeYhSsIejBiYfpW3lSek4DAXbqt/e24RxFkGcBkffWtyr +LmNj844YFad8wkUQYjRhWEJxs8X8r6HDhBiSFJbXBxEwS28L2HaeJQPnpDmRkwy7 +amGy37NVMDM7HxnZEV2aRxuNfLj/PPeIAfUeQPE4GJV345QSYbj+HBkSta37l5V7 +k+R/KGnmMWBJwTxsH6vD6wl8tBAWPXXjjQRTWQl5XL6o4YXzAaYXbiG2XxbMjduN +23iHS5zdd8ieLEvLashYMvi51+OQ2/r9QyB9VXhdCJN17MLTUIuA2gF15SHu8ClN +OHqrmsgTd+uZy5MSnsnD54pBVj7+wWGeVm8QyjKsQ0CqfIr3sq2g1x9Cnfl0SrD8 +BeJwmMu9K4ukkcmZHbW1v9da196of7Z3WZxmsVrsIMhKTZNRwLKGiNqHjxgA/atf +SPWqb1KkTWfxK9xxLj1zInG+0MVaAW483D1cIMMpYSlmJPFcVppAKdV7yDL9puw0 +fOmaazE6IRxPnTaVCk/y/muZG2FRcVhIpcZT/H2mtTnIZ+5tX5theOt7dwpO3nXS +PwiOAckHHGDTxsYEC9gulmsufg4M5S0/4zrn46uxAyIlgSTSiGoXM0SDhsYMo/Ui +LCwPar3dI1qCbimCBCIiFEfJyWR6PTL4J5oDNzyLZo4J1g== +=WEMD -----END PGP PUBLIC KEY BLOCK----- .... From nobody Wed Jan 18 00:12:48 2023 X-Original-To: dev-commits-doc-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 4NxR6T3cjTz2sVMF for ; Wed, 18 Jan 2023 00:12:49 +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 4NxR6T1Hgnz4KJV; Wed, 18 Jan 2023 00:12:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674000769; 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=rfutTAugfQskEWbukzirchhE8QmpGGO1FI1nlRSPQk4=; b=gCpNc9ENEd6KObX8Oc9d8Dg2yMTxovx/xTOmG6afDrIBLPDm2CkqPiuO11BDJl6FSioaCP yxIphswBAkXebCmQQK0ORpDl4y8v8d8oIIkBWWAzvavdnLBiLik8XD4rTIOC6BQr01R8UY Ruq958dAGgMNEnI94z/MYNPyuFDA9M8Rqp2yjH78Mxx9fU5bUYStI3d2biHGv4b28QBYD6 YTxC0Eg4QNPQq3nswxw5MViLNAEu/zhyNbf1rKohW944Mbyh+AwljnE6zsLOaQdCPjJRxZ wGf49dv+9GO8SCIeU16xdYPHARcKBkcnJ8uy584Hk6HJM2El71GHgSCCacU91Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674000769; 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=rfutTAugfQskEWbukzirchhE8QmpGGO1FI1nlRSPQk4=; b=f8gpYBn9/DvXJIi64uzOqhzR7QAqlasrAQIQeUtd+ZxlcobZav1T6wa1xMPqBE7Z/dHCz8 KEvGGvoKM4aFOmgeRkW7BWKfSwiwbG52nfIsnDZ3DAh/rqhnkx0JOTe0NzSmAIhwpLveuC IQc1WRtz3gYh1VS9Bo6JlQSwNY4whIZydcxxSK1+23E0nfjzrHov0STb/LSg9MNox5HtT0 eD2L4flxa1ZolCruycDBJh7XYc3mP0pZxaK6TLXNYciwxzdzibJzF1i0Eg9a7lQjzIMJJh s6QJcHQPZrGFd4RGxREG0NmuS+6no5XZkLCD/RWacSFdikyux+Y7w+8WkQgtTw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674000769; a=rsa-sha256; cv=none; b=nbxVLczcKgscO8U7pQ9hztO3tB51rOvfGHR1P54EaSzfCiHbubiedJPZU7LPk7/7vx0OHj 9TUErmgU1cNyI3l0p1ZKcvHh2j6A1hYuA5ynl/Q73JN3eW55Q8FsXUBfE/Gn+JLiZRICed 9+IPp1etWD96voV4gCV0BHdoes/nfNNz34WYCR8F9xr42wUWyUvOZT649IqKFWSQohEIPS 5sWFjZ3X5qGFyZYL6iBCpFJ8VhjFy7Gd+e+IhI0MLY7kmsU8jbiFzMMgeVcR0Gz1cmO6Rk I5gR+n1r0FZDR5BAaOFrGcJ51eFdWF4+mkzIbxZny1UXE28aJh1UEtfDNO64iA== 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 4NxR6T0NS1zqjl; Wed, 18 Jan 2023 00:12:49 +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 30I0CmXc052443; Wed, 18 Jan 2023 00:12:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30I0Cm4F052442; Wed, 18 Jan 2023 00:12:48 GMT (envelope-from git) Date: Wed, 18 Jan 2023 00:12:48 GMT Message-Id: <202301180012.30I0Cm4F052442@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: 5c86c37ba2 - main - 13.2R signatures are not yet available List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5c86c37ba257eeab7495f1fdd54856f023165a7b Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=5c86c37ba257eeab7495f1fdd54856f023165a7b commit 5c86c37ba257eeab7495f1fdd54856f023165a7b Author: Graham Perrin AuthorDate: 2023-01-18 00:08:22 +0000 Commit: Graham Perrin CommitDate: 2023-01-18 00:08:22 +0000 13.2R signatures are not yet available Comment out the line in _index.adoc. Affects: https://www.freebsd.org/releases/13.2R/ Fixes: 6d8c97bfa5 release: add schedule for 13.2-RELEASE --- website/content/en/releases/13.2R/_index.adoc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/website/content/en/releases/13.2R/_index.adoc b/website/content/en/releases/13.2R/_index.adoc index 7ae2eb8e52..ea5bacadef 100644 --- a/website/content/en/releases/13.2R/_index.adoc +++ b/website/content/en/releases/13.2R/_index.adoc @@ -11,17 +11,18 @@ sidenav: download == Introduction -This is the index page for FreeBSD {localRel}. For more information about the release engineering process, please see the link:../../releng/[Release Engineering] section of the web site. +This is the index page for FreeBSD {localRel}. +For more information about the release engineering process, please see the link:../../releng/[Release Engineering] section of the web site. == Detailed Information More detailed information, such as release notes and hardware notes can be found at these pages: -link:signatures/[FreeBSD {localRel}-RELEASE signed checksum files] + +//link:signatures/[FreeBSD {localRel}-RELEASE signed checksum files] + //link:installation/[FreeBSD {localRel}-RELEASE installation information] + //link:hardware/[FreeBSD {localRel}-RELEASE hardware information] + //link:relnotes/[FreeBSD {localRel}-RELEASE release notes] + //link:errata/[FreeBSD {localRel}-RELEASE errata] + //link:readme/[FreeBSD {localRel}-RELEASE readme] + link:schedule/[FreeBSD {localRel}-RELEASE schedule] + -//link:todo/[FreeBSD Release Engineering TODO Page] + +//link:todo/[FreeBSD Release Engineering TODO Page] From nobody Wed Jan 18 17:37:18 2023 X-Original-To: dev-commits-doc-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 4NxtHf2q0nz2sXFg for ; Wed, 18 Jan 2023 17:37:18 +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 4NxtHf2P2yz3mHr; Wed, 18 Jan 2023 17:37:18 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674063438; 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=2/wh79ydDZYpRMJA8qHJF6tQyUPMad7WWH1QZMuXDhQ=; b=X4/IK8zdbLXRKaEsfR/cvpyb7vNYX4bQ3Uq4EKULxfjoZCjst1GwbVAvxY1IwB1C7qPwUW 0lNKp4CBgIjcIyPvdw3/HeB6KZLlSbpNVgnLg1JZYjeSc3kQNMvZr+hYGk30qVn7oxrI37 0D2o3cuHRzRx1vWu3YmtX7TOdRMlqaKAx+if5LmjNq2I8ayb+yd2HETksr89xsZLpwiOHY IYjdNcrz4yJHqfOlFEOxOns5EwGPpqFGOdlZMNyZm4I2/YJd+Fy4tfR+Z1b3/pHnQMnjtC yKmw9PFtzX1/uPDGHsvU319GR2QcBD0638T+WXQWWdGWTyXfoWz8Z2Ok/rCYkg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674063438; 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=2/wh79ydDZYpRMJA8qHJF6tQyUPMad7WWH1QZMuXDhQ=; b=lntH2wEx6eGern+waTemkouMd2HlzsC6i3X0uURmNj3YUKG/vxdSY31L1oh1Ka1ym4knLq 9YUoP2EP/bd5oogTZRWaBIywfGsfplD//9OH1OWI2QPrMpK1uZBT7fVEEUUkLqCqEo9s9q Hp7CcvgZ4yZtYobUHLk6YYeG8O2V5VW+BI5SmxKL7v3xhG1T35aPR2U5GkhtBaO589JYDn Mjb6spEUC6PMy3dTXzysTFZ2HtHzSot9bryyOK3X672yCeIdjFlgrDx95c1amlD/G5rXdY Hg/2oqxXVtLazHx9Uupeq0hT/Ys0Qptur/mjiWR9isTjOn4HKTmwYMlL80csGw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674063438; a=rsa-sha256; cv=none; b=fSaZPhwLy8k2kOseLzT5s+hJ647XTH/vVSDOJugfZgxUhTXJuCvscDkk8xWd98OZlXvXmL AmVOBNZc4IaR3NehQM8h3GhGvkbQNBxt1o5SMeGQX9Yncfx4ytXM4/9PG0RF8feGljJfQA sb2qHP12lhFoXwNEak8Nm+jzSOLJ4ObTYZAOF5ofIyMlrSmiPRDvBvBbVHXU9TjwjoTtH9 vXQ+tyq/g1chL6jTXFZmOpztm4flrJy28vb/czEYdmsy5wbgk+8mYq4VUHx8bBWz+NyByB qQsOq2lLFxGARImxQ+HSbVXtAh66wsKmgUjtcYmAsYrXeYgPIU00LknTbCxZ0w== 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 4NxtHf1LNgzKl9; Wed, 18 Jan 2023 17:37:18 +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 30IHbI1g039449; Wed, 18 Jan 2023 17:37:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30IHbIPJ039448; Wed, 18 Jan 2023 17:37:18 GMT (envelope-from git) Date: Wed, 18 Jan 2023 17:37:18 GMT Message-Id: <202301181737.30IHbIPJ039448@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando=20Apestegu=C3=ADa?= Subject: git: 284cdb7ffb - main - [phb] Document USES=octave List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 284cdb7ffb5936abf7dff60823ce796efae71fee Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=284cdb7ffb5936abf7dff60823ce796efae71fee commit 284cdb7ffb5936abf7dff60823ce796efae71fee Author: Fernando Apesteguía AuthorDate: 2023-01-10 12:30:31 +0000 Commit: Fernando Apesteguía CommitDate: 2023-01-18 17:32:50 +0000 [phb] Document USES=octave Missing from the Porter's Handbook. --- documentation/content/en/books/porters-handbook/uses/_index.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index ff44f7ae20..75597e1561 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -1308,6 +1308,14 @@ Possible arguments: (none) Add objective C dependencies (compiler, runtime library) if the base system does not support it. +[[uses-octave]] +== `octave` + +Possible arguments: (none), env + +Uses package:math/octave[]. +`env` loads only one `OCTAVE_VERSION` environmental variable. + [[uses-openal]] == `openal` From nobody Thu Jan 19 10:38:23 2023 X-Original-To: dev-commits-doc-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 4NyJxr2k58z2sXfH for ; Thu, 19 Jan 2023 10:38:24 +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 4NyJxr1p6mz4HCw; Thu, 19 Jan 2023 10:38:24 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674124704; 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=hdAaUH8h1eOVbmXAW0g+WgDh/LpMEV9PFlIGPWZBvwM=; b=EKchhwp6qqS/APKgXq7/9W/i6QTlEfPFTfbVhbJYumSLWo4QEFWyCPVSGKmuRZ+g0fqj6H jvJ2c3hOOxq/KpeT+D05BnNkBW5SJU6KT4zpGC8GfCzRl4ygW84TKOlNj3vbte4YXovZOb kID4EWAUeUBemnShaJL6N7VSw/3QHXmbEjFvvDQ+MiKVVbjEclKYBxqVfn7ApbmMr1/PjX Sf8ZDbElkBAWy7V0d+K3i8enVI+hbPOUXdA2vojF23C5UR8NBih3XyPtoxTeiaetHiQKil cqo06llgxlwRo3Nk0CkpClU0yynIsn/ooa6wkjO1HG3nGIvqGn92Sd69MOoVPw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674124704; 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=hdAaUH8h1eOVbmXAW0g+WgDh/LpMEV9PFlIGPWZBvwM=; b=KjVWar51WR4OGysXEA/pFUzG0hWPUdhxbuutGyZh/k8UIT7ah4RnJOMxuHvRHIskt8vIVc QcL+fla3xWivwo1IX76msO8ej4NyWDM9KvImnO11+aYjOJjZ6bpE1I1iss5Yq1og1dT2hb mLZM0/qlzWgErARlUymobMNEUFQW2rha+TUwevFpAXSSP2aHEmIpXX2jEMJalcV+3uK39L ytDnLH+tZ5maTRZjik8AUsKkK5R+tjZSImSmjaCJIcw6f/N1mX0oGPGzCXwmmtIxNJCgp+ V6kV3gDOq3dgkmCY2+BCWWuRZADMqj6+nRfFKWQDfzX0SGAm1OLoXgHkAU3P2A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674124704; a=rsa-sha256; cv=none; b=ZTJaeN5vGMTYc8kJYuvnoxj7QICM23kBFK8IFoGnjUz/f2w2Eg7VFp0O6ZameSCcKRipkT qwVytNe7ksq/w3df7Lp7rWbHVvRghlymRbBouiopu+Y9wTiJd/EGnzzSgvGTjebd8QqJ0s OUK4Md6sSyAA3roxGzebA9m2SzSEaavVwcWfmdFI3xOipIR4k+TK6C5jbzEWv8VNHAqI7b 0TIoSPeiu/0BH7o26UPsRDpNNJHs29FBTboKtgr3XKbBFjPL6lj92NlY1wKXpSIeXOwRKR wNtam7NbtXVWOkNqSOJuVg9ZHSxgcW0HNJytl9wflXwvtqxYcVIo8ijGhi9VCw== 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 4NyJxr0lM2znjZ; Thu, 19 Jan 2023 10:38:24 +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 30JAcNeT096156; Thu, 19 Jan 2023 10:38:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30JAcNOL096155; Thu, 19 Jan 2023 10:38:23 GMT (envelope-from git) Date: Thu, 19 Jan 2023 10:38:23 GMT Message-Id: <202301191038.30JAcNOL096155@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: c0a1f9d433 - main - ja/webpage: update search-mid.adoc List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ryusuke X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c0a1f9d4337f2cce070c53ea8b86daa1ec20f145 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=c0a1f9d4337f2cce070c53ea8b86daa1ec20f145 commit c0a1f9d4337f2cce070c53ea8b86daa1ec20f145 Author: Ryusuke SUZUKI AuthorDate: 2023-01-19 10:36:50 +0000 Commit: Ryusuke SUZUKI CommitDate: 2023-01-19 10:36:50 +0000 ja/webpage: update search-mid.adoc -> b2ca25aa7b --- website/content/ja/search/search-mid.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/ja/search/search-mid.adoc b/website/content/ja/search/search-mid.adoc index eea72c1eab..7f46b680e3 100644 --- a/website/content/ja/search/search-mid.adoc +++ b/website/content/ja/search/search-mid.adoc @@ -9,6 +9,6 @@ sidenav: about {{< form-search-mid-message >}} -ここではメールのヘッダのキーワードのうち *Message-ID*、*Resent-Message-id*、*In-Reply-to*、そして *References* のみで検索が行えます。 Message-ID とは <199802242058.MAA24843@monk.via.net> のようなものです。 ほかのメールのヘッダのキーワードはサポートしておりません。 この Message-ID のデータベースは毎時間更新しています。 +ここではメールのヘッダのキーワードのうち *Message-ID*, *Resent-Message-id*, *In-Reply-to* そして *References* のみで検索が行えます。 Message-ID とは <199802242058.MAA24843@monk.via.net> のようなものです。 ほかのメールのヘッダのキーワードはサポートしておりません。 この Message-ID のデータベースは 5 分毎に更新しています。 link:../#mailinglists[メーリングリストのアーカイブからの全文検索はこちら。] From nobody Thu Jan 19 19:44:14 2023 X-Original-To: dev-commits-doc-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 4NyY3f1ztcz2sW7Z for ; Thu, 19 Jan 2023 19:44:14 +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 4NyY3f1g0yz47bL; Thu, 19 Jan 2023 19:44:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674157454; 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=wSuacMPXvWVswIFpckuLH60uFsB+OvgDQya1TXd6fyI=; b=ucCutCLjdP6AYFO9POdhSs7r0RIEKk3GvzpSZTJ+Gs22xZsbCrUz+hOBs52p/oKN8rNeJZ KlHITGS7Gx9I4slTDM6gTlp7GhN5gMWfEOBPjBUHFmEJ+ikvshVcS/+cbZ0TUPMnfdC5GU X+dr1gcxp3sl2D8ziBl+PHcCXpgwD9mj68b068A/x5PS9n/b4HUOF85BEdDtP4J5Jf+Q4G P9qe/+42ELktAUNDGvS419i6NOSlCSs4ztP5g4udKDGZ+VUQmH6c3AcIVV1hZM0LYiCzg/ WzA5ykiSM+/K0lcBreMhvTlx/pJ6bnUaOYoD7HU2Yi/5B0yW71//afLigjI3ng== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674157454; 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=wSuacMPXvWVswIFpckuLH60uFsB+OvgDQya1TXd6fyI=; b=G1TeTsoFMvpDuflyeyb3/2Yl7fRntJs0miCQPAPbH3lFcsRXh80z7LAGTixWDttc+sRuX7 s9TY2YkDA1GQxOTUYlbhAGkJuw0dlxMx7fwTjnOoFJN3yArynqKWkI2uQDsuBalmhRfWc1 BdaL+TNQL9mjh/gPu1V948bmXz49kYKfBvJvV1+0VRRVzxqFTyLzDDkZCy47kO/9J6Wvr6 6M4UOpC4RETK1amXL5mfv/c9hIlQpHeEYQreeuRdpZKEwqxzAb/qX0d9JDNIudIUkbgJeD ddvrloTMggmp9/CF9+09qoyEfJ2HIjnaNHlWjOuAZnINYtGnEUCeWin4UDvw4Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674157454; a=rsa-sha256; cv=none; b=fThj+qNxlRxzdu47KxjyXjeWr2flU2b1B8QHztdx6fYf08OGSQKUgCqHCjwGYf6gLBRFoI KCXXLPmVokTLhi0gXjsio9wxrREcuR0Fvy1I2y7+aGKtnW3AsBbrrVXyDumQSYiIQpPiOb hlFc98Vzxl0/MsTFKA+ZBelZqqBZfH1Rpl1MczhrWtSY420mPIZCknyE+FWejWFRHoKgeZ awbvFzcoeJHy4L9Yz2XaxGdVericUbTT2yszhAEOuyAeMx4LiNxBle1l7EXmco1FOmja5s 2uJ6y6I4xdImHGaec1hOKBjzS9fH8+jDk2UDVcfA8pyr7OKZ2idPmH4uJaz5PQ== 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 4NyY3f0jzkz139m; Thu, 19 Jan 2023 19:44:14 +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 30JJiEZ2082752; Thu, 19 Jan 2023 19:44:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30JJiEcs082751; Thu, 19 Jan 2023 19:44:14 GMT (envelope-from git) Date: Thu, 19 Jan 2023 19:44:14 GMT Message-Id: <202301191944.30JJiEcs082751@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 27721a2fd3 - main - Upgrade basics and ports chapters List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 27721a2fd3fba5c653c866a6bfb1e476bf4888a1 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=27721a2fd3fba5c653c866a6bfb1e476bf4888a1 commit 27721a2fd3fba5c653c866a6bfb1e476bf4888a1 Author: Sergio Carlavilla Delgado AuthorDate: 2023-01-19 19:37:03 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-01-19 19:37:03 +0000 Upgrade basics and ports chapters * Changes in basics chapter: * Improve the rendering of the tables * Improve titles, show text instead of showing a command * Upgrade information about the "removing user procedure" * Upgrade "Directory Structure" based on hier.7 * Run all the commands and check that the correct output is displayed * Changes in ports chapter: * Simplify the way the user search for packages * Some minor changes in software packages examples, use Nginx instead of Apache, etc. * Improve the pkg bootstrap and show the current way. Remove references of FreeBSD 9 and 10. * Add information about how to configure pkg * Update information on how to handle packages: search, install, update, remove, etc. * Put the information on how to handle packets in order * Add information on how to block and unblock packages * Global: * Add alt text to all of the images * Improve the AsciiDoc Reviewed by: karels@, bcr@, arrowd@, jrm@ --- .../content/en/books/handbook/basics/_index.adoc | 332 ++++++----- .../content/en/books/handbook/ports/_index.adoc | 617 +++++++++++---------- 2 files changed, 491 insertions(+), 458 deletions(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index 23c7183a04..ea69f1e767 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -84,12 +84,12 @@ login: The first line contains some information about the system. The `amd64` indicates that the system in this example is running a 64-bit version of FreeBSD. -The hostname is `pc3.example.org`, and [.filename]#ttyv0# indicates that this is the "system console". +The hostname is `pc3.example.org`, and `ttyv0` indicates that this is the "system console". The second line is the login prompt. Since FreeBSD is a multiuser system, it needs some way to distinguish between different users. This is accomplished by requiring every user to log into the system before gaining access to the programs on the system. -Every user has a unique name "username" and a personal "password". +Every user has a unique "username" and a personal "password". To log into the system console, type the username that was configured during system installation, as described in crossref:bsdinstall[bsdinstall-addusers,Add Users], and press kbd:[Enter]. Then enter the password associated with the username and press kbd:[Enter]. @@ -111,7 +111,7 @@ Each virtual console has its own login prompt and shell and it is easy to switch This essentially provides the command line equivalent of having several windows open at the same time in a graphical environment. The key combinations kbd:[Alt+F1] through kbd:[Alt+F8] have been reserved by FreeBSD for switching between virtual consoles. -Use kbd:[Alt+F1] to switch to the system console ([.filename]#ttyv0#), kbd:[Alt+F2] to access the first virtual console ([.filename]#ttyv1#), kbd:[Alt+F3] to access the second virtual console ([.filename]#ttyv2#), and so on. +Use kbd:[Alt+F1] to switch to the system console (`ttyv0`), kbd:[Alt+F2] to access the first virtual console (`ttyv1`), kbd:[Alt+F3] to access the second virtual console (`ttyv2`), and so on. When using Xorg as a graphical console, the combination becomes kbd:[Ctrl+Alt+F1] to return to a text-based virtual console. When switching from one console to the next, FreeBSD manages the screen output. @@ -120,7 +120,7 @@ The programs that are launched in one virtual console do not stop running when t Refer to man:kbdcontrol[1], man:vidcontrol[1], man:atkbd[4], man:syscons[4], and man:vt[4] for a more technical description of the FreeBSD console and its keyboard drivers. -In FreeBSD, the number of available virtual consoles is configured in this section of [.filename]#/etc/ttys#: +In FreeBSD, the number of available virtual consoles is configured in this section of `/etc/ttys`: [.programlisting] .... @@ -139,9 +139,9 @@ ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure .... To disable a virtual console, put a comment symbol (`+#+`) at the beginning of the line representing that virtual console. -For example, to reduce the number of available virtual consoles from eight to four, put a `+#+` in front of the last four lines representing virtual consoles [.filename]#ttyv5# through [.filename]#ttyv8#. -_Do not_ comment out the line for the system console [.filename]#ttyv0#. -Note that the last virtual console ([.filename]#ttyv8#) is used to access the graphical environment if Xorg has been installed and configured as described in crossref:x11[x11,The X Window System]. +For example, to reduce the number of available virtual consoles from eight to four, put a `+#+` in front of the last four lines representing virtual consoles `ttyv5` through `ttyv8`. +_Do not_ comment out the line for the system console `ttyv0`. +Note that the last virtual console (`ttyv8`) is used to access the graphical environment if Xorg has been installed and configured as described in crossref:x11[x11,The X Window System]. For a detailed description of every column in this file and the available options for the virtual consoles, refer to man:ttys[5]. @@ -155,7 +155,7 @@ While in single user mode, networking and other virtual consoles are not availab However, full `root` access to the system is available, and by default, the `root` password is not needed. For these reasons, physical access to the keyboard is needed to boot into this mode and determining who has physical access to the keyboard is something to consider when securing a FreeBSD system. -The settings which control single user mode are found in this section of [.filename]#/etc/ttys#: +The settings which control single user mode are found in this section of `/etc/ttys`: [.programlisting] .... @@ -203,7 +203,7 @@ To select a new video mode, specify the mode using man:vidcontrol[1] as the `roo # vidcontrol MODE_279 .... -If the new video mode is acceptable, it can be permanently set on boot by adding it to [.filename]#/etc/rc.conf#: +If the new video mode is acceptable, it can be permanently set on boot by adding it to `/etc/rc.conf`: [.programlisting] .... @@ -239,12 +239,6 @@ The reason for this is security; if all services ran as the superuser, they coul Examples of system accounts are `daemon`, `operator`, `bind`, `news`, and `www`. -[WARNING] -==== - -Care must be taken when using the operator group, as unintended superuser-like access privileges may be granted, including but not limited to shutdown, reboot, and access to all items in [.filename]#/dev# in the group. -==== - `nobody` is the generic unprivileged system account. However, the more services that use `nobody`, the more files and processes that user will become associated with, and hence the more privileged that user becomes. @@ -299,7 +293,7 @@ Similar to a comment, this information can contain spaces, uppercase characters, Home directory:: The home directory is the full path to a directory on the system. This is the user's starting directory when the user logs in. -A common convention is to put all user home directories under [.filename]#/home/username# or [.filename]#/usr/home/username#. +A common convention is to put all user home directories under `/home/username` or `/usr/home/username`. Each user stores their personal files and subdirectories in their own home directory. User shell:: @@ -356,7 +350,7 @@ See the manual page for each utility for more details and usage examples. [[users-modifying-utilities]] .Utilities for Managing User Accounts -[cols="1,1", frame="none", options="header"] +[cols="25h,~"] |=== | Command | Summary @@ -375,14 +369,17 @@ See the manual page for each utility for more details and usage examples. |man:pw[8] |A powerful and flexible tool for modifying all aspects of user accounts. + +|man:bsdconfig[8] +|A system configuration utility with account management support. |=== [[users-adduser]] -==== `adduser` +==== Adding a user The recommended program for adding new users is man:adduser[8]. -When a new user is added, this program automatically updates [.filename]#/etc/passwd# and [.filename]#/etc/group#. -It also creates a home directory for the new user, copies in the default configuration files from [.filename]#/usr/share/skel#, and can optionally mail the new user a welcome message. +When a new user is added, this program automatically updates `/etc/passwd` and `/etc/group`. +It also creates a home directory for the new user, copies in the default configuration files from `/usr/share/skel`, and can optionally mail the new user a welcome message. This utility must be run as the superuser. The man:adduser[8] utility is interactive and walks through the steps for creating a new user account. @@ -425,7 +422,6 @@ OK? (yes/no): yes adduser: INFO: Successfully added (jru) to the user database. Add another user? (yes/no): no Goodbye! -# .... ==== @@ -435,20 +431,23 @@ Since the password is not echoed when typed, be careful to not mistype the passw ==== [[users-rmuser]] -==== `rmuser` +==== Removing a user To completely remove a user from the system, run man:rmuser[8] as the superuser. This command performs the following steps: [.procedure] +==== . Removes the user's man:crontab[1] entry, if one exists. . Removes any man:at[1] jobs belonging to the user. -. Kills all processes owned by the user. +. Sends a SIGKILL signal to all processes owned by the user. . Removes the user from the system's local password file. -. Optionally removes the user's home directory, if it is owned by the user. -. Removes the incoming mail files belonging to the user from [.filename]#/var/mail#. -. Removes all files owned by the user from temporary file storage areas such as [.filename]#/tmp#. -. Finally, removes the username from all groups to which it belongs in [.filename]#/etc/group#. If a group becomes empty and the group name is the same as the username, the group is removed. This complements the per-user unique groups created by man:adduser[8]. +. Removes the user's home directory (if it is owned by the user), including handling of symbolic links in the path to the actual home directory. +. Removes the incoming mail files belonging to the user from `/var/mail`. +. Removes all files owned by the user from `/tmp`, `/var/tmp`, and `/var/tmp/vi.recover`. +. Removes the username from all groups to which it belongs in `/etc/group`. (If a group becomes empty and the group name is the same as the username, the group is removed; this complements man:adduser[8]'s per-user unique groups.) +. Removes all message queues, shared memory segments and semaphores owned by the user. +==== man:rmuser[8] cannot be used to remove superuser accounts since that is almost always an indication of massive destruction. @@ -465,12 +464,11 @@ jru:*:1001:1001::0:0:J. Random User:/home/jru:/usr/local/bin/zsh Is this the entry you wish to remove? y Remove user's home directory (/home/jru)? y Removing user (jru): mailspool home passwd. -# .... ==== [[users-chpass]] -==== `chpass` +==== Change user information Any user can use man:chpass[1] to change their default shell and personal information associated with their user account. The superuser can use this utility to change additional account information for any user. @@ -535,7 +533,7 @@ How to configure NIS is covered in crossref:network-servers[network-servers,Netw ==== [[users-passwd]] -==== `passwd` +==== Change user password Any user can easily change their password using man:passwd[1]. To prevent accidental or unauthorized changes, this command will prompt for the user's original password before a new password can be set: @@ -579,7 +577,7 @@ As with man:chpass[1], man:yppasswd[1] is a link to man:passwd[1], so NIS works ==== [[users-pw]] -==== `pw` +==== Create, remove, modify and display system users and groups The man:pw[8] utility can create, remove, modify, and display users and groups. It functions as a front end to the system user and group files. @@ -592,15 +590,20 @@ A group is a list of users. A group is identified by its group name and GID. In FreeBSD, the kernel uses the UID of a process, and the list of groups it belongs to, to determine what the process is allowed to do. Most of the time, the GID of a user or process usually means the first group in the list. -The group name to GID mapping is listed in [.filename]#/etc/group#. +The group name to GID mapping is listed in `/etc/group`. This is a plain text file with four colon-delimited fields. The first field is the group name, the second is the encrypted password, the third the GID, and the fourth the comma-delimited list of members. For a more complete description of the syntax, refer to man:group[5]. -The superuser can modify [.filename]#/etc/group# using a text editor. +The superuser can modify `/etc/group` using a text editor, although editing the group file using man:vigr[8] is preferred because it can catch some common mistakes. Alternatively, man:pw[8] can be used to add and edit groups. For example, to add a group called `teamtwo` and then confirm that it exists: +[WARNING] +==== +Care must be taken when using the operator group, as unintended superuser-like access privileges may be granted, including but not limited to shutdown, reboot, and access to all items in `/dev` in the group. +==== + .Adding a Group Using man:pw[8] [example] ==== @@ -630,7 +633,7 @@ teamtwo:*:1100:jru The argument to `-M` is a comma-delimited list of users to be added to a new (empty) group or to replace the members of an existing group. To the user, this group membership is different from (and in addition to) the user's primary group listed in the password file. This means that the user will not show up as a member when using `groupshow` with man:pw[8], but will show up when the information is queried via man:id[1] or a similar tool. -When man:pw[8] is used to add a user to a group, it only manipulates [.filename]#/etc/group# and does not attempt to read additional data from [.filename]#/etc/passwd#. +When man:pw[8] is used to add a user to a group, it only manipulates `/etc/group` and does not attempt to read additional data from `/etc/passwd`. .Adding a New Member to a Group Using man:pw[8] [example] @@ -658,7 +661,7 @@ uid=1001(jru) gid=1001(jru) groups=1001(jru), 1100(teamtwo) In this example, `jru` is a member of the groups `jru` and `teamtwo`. -For more information about this command and the format of [.filename]#/etc/group#, refer to man:pw[8] and man:group[5]. +For more information about this command and the format of `/etc/group`, refer to man:pw[8] and man:group[5]. [[permissions]] == Permissions @@ -730,7 +733,7 @@ total 530 -rw-r--r-- 1 root wheel 7680 Sep 5 12:31 email.txt .... -The first (leftmost) character in the first column indicates whether this file is a regular file, a directory, a special character device, a socket, or any other special pseudo-file device. +Focusing on the line for `myfile`, the `(leftmost)` first character indicates whether this file is a regular file, a directory, a special character device, a socket, or any other special pseudo-file device. In this example, the `-` indicates a regular file. The next three characters, `rw-` in this example, give the permissions for the owner of the file. The next three characters, `r--`, give the permissions for the group that the file belongs to. @@ -740,7 +743,7 @@ In this example, the permissions are set so the owner can read and write to the According to the table above, the permissions for this file would be `644`, where each digit represents the three parts of the file's permission. How does the system control permissions on devices? FreeBSD treats most hardware devices as a file that programs can open, read, and write data to. -These special device files are stored in [.filename]#/dev/#. +These special device files are stored in `/dev/`. Directories are also treated as files. They have read, write, and execute permissions. @@ -816,7 +819,7 @@ Symbolic permissions use the syntax of (who) (action) (permissions), where the f |=== These values are used with man:chmod[1], but with letters instead of numbers. -For example, the following command would block other users from accessing _FILE_: +For example, the following command would block both members of the group associated with _FILE_ and all other users from accessing _FILE_: [source,shell] .... @@ -838,7 +841,7 @@ These flags add an additional level of security and control over files, but not With file flags, even `root` can be prevented from removing or altering files. File flags are modified using man:chflags[1]. -For example, to enable the system undeletable flag on the file [.filename]#file1#, issue the following command: +For example, to enable the system undeletable flag on the file `file1`, issue the following command: [source,shell] .... @@ -868,7 +871,7 @@ Several file flags may only be added or removed by the `root` user. In other cases, the file owner may set its file flags. Refer to man:chflags[1] and man:chflags[2] for more information. -=== The `setuid`, `setgid`, and `sticky` Permissions +=== The setuid, setgid, and sticky Permissions Other than the permissions already discussed, there are three other specific settings that all administrators should know about. They are the `setuid`, `setgid`, and `sticky` permissions. @@ -882,14 +885,21 @@ As an example, man:passwd[1] runs with the real user ID when a user changes thei However, in order to update the password database, the command runs as the effective ID of the `root` user. This allows users to change their passwords without seeing a `Permission Denied` error. -The setuid permission may be set by prefixing a permission set with the number four (4) as shown in the following example: +The setuid permission may be added symbolically by adding the `s` permission for the user as in the following example: + +[source,shell] +.... +# chmod u+s suidexample.sh +.... + +The setuid permission may also be set by prefixing a permission set with the number four (4) as shown in the following example: [source,shell] .... # chmod 4755 suidexample.sh .... -The permissions on [.filename]#suidexample.sh# now look like the following: +The permissions on `suidexample.sh` now look like the following: [.programlisting] .... @@ -935,7 +945,14 @@ Although man:passwd[1] is run as a normal user, it is using the effective UID of The `setgid` permission performs the same function as the `setuid` permission; except that it alters the group settings. When an application or utility executes with this setting, it will be granted the permissions based on the group that owns the file, not the user who started the process. -To set the `setgid` permission on a file, provide man:chmod[1] with a leading two (2): +To set the `setgid` permission on a file symbolically, add the `s` permission for the group with man:chmod[1]: + +[source,shell] +.... +# chmod g+s sgidexample.sh +.... + +Alternatively, provide man:chmod[1] with a leading two (2): [source,shell] .... @@ -959,8 +976,15 @@ The `setuid` and `setgid` permission bits may lower system security, by allowing The third special permission, the `sticky bit`, can strengthen the security of a system. When the `sticky bit` is set on a directory, it allows file deletion only by the file owner. -This is useful to prevent file deletion in public directories, such as [.filename]#/tmp#, by users who do not own the file. -To utilize this permission, prefix the permission set with a one (1): +This is useful to prevent file deletion in public directories, such as `/tmp`, by users who do not own the file. +To utilize this permission, add the `t` mode to the file: + +[source,shell] +.... +# chmod +t /tmp +.... + +Alternatively, prefix the permission set with a one (1): [source,shell] .... @@ -989,129 +1013,123 @@ The root directory also contains mount points for other file systems that are mo A mount point is a directory where additional file systems can be grafted onto a parent file system (usually the root file system). This is further described in <>. -Standard mount points include [.filename]#/usr/#, [.filename]#/var/#, [.filename]#/tmp/#, [.filename]#/mnt/#, and [.filename]#/cdrom/#. -These directories are usually referenced to entries in [.filename]#/etc/fstab#. +Standard mount points include `/usr/`, `/var/`, `/tmp/`, `/mnt/`, and `/cdrom/`. +These directories are usually referenced to entries in `/etc/fstab`. This file is a table of various file systems and mount points and is read by the system. -Most of the file systems in [.filename]#/etc/fstab# are mounted automatically at boot time from the script man:rc[8] unless their entry includes `noauto`. +Most of the file systems in `/etc/fstab` are mounted automatically at boot time from the script man:rc[8] unless their entry includes `noauto`. Details can be found in <>. A complete description of the file system hierarchy is available in man:hier[7]. The following table provides a brief overview of the most common directories. -[.informaltable] -[cols="1,1", frame="none", options="header"] +[cols="25h,~"] |=== | Directory | Description -|[.filename]#/# +|`/` |Root directory of the file system. -|[.filename]#/bin/# +|`/bin/` |User utilities fundamental to both single-user and multi-user environments. -|[.filename]#/boot/# +|`/boot/` |Programs and configuration files used during operating system bootstrap. -|[.filename]#/boot/defaults/# +|`/boot/defaults/` |Default boot configuration files. Refer to man:loader.conf[5] for details. -|[.filename]#/dev/# -|Device nodes. Refer to man:intro[4] for details. +|`/dev/` +|Device special files managed by man:devfs[5] -|[.filename]#/etc/# +|`/etc/` |System configuration files and scripts. -|[.filename]#/etc/defaults/# +|`/etc/defaults/` |Default system configuration files. Refer to man:rc[8] for details. -|[.filename]#/etc/mail/# -|Configuration files for mail transport agents such as man:sendmail[8]. - -|[.filename]#/etc/periodic/# +|`/etc/periodic/` |Scripts that run daily, weekly, and monthly, via man:cron[8]. Refer to man:periodic[8] for details. -|[.filename]#/etc/ppp/# -|man:ppp[8] configuration files. +|`/lib/` +|Critical system libraries needed for binaries in `/bin` and `/sbin` -|[.filename]#/mnt/# +|`/libexec/` +|Critical system files + +|`/media/` +|Contains subdirectories to be used as mount points for removable media such as CDs, USB drives, and floppy disks + +|`/mnt/` |Empty directory commonly used by system administrators as a temporary mount point. -|[.filename]#/proc/# +|`/net/` +|Automounted NFS shares; see man:auto_master[5] + +|`/proc/` |Process file system. Refer to man:procfs[5], man:mount_procfs[8] for details. -|[.filename]#/rescue/# +|`/rescue/` |Statically linked programs for emergency recovery as described in man:rescue[8]. -|[.filename]#/root/# +|`/root/` |Home directory for the `root` account. -|[.filename]#/sbin/# +|`/sbin/` |System programs and administration utilities fundamental to both single-user and multi-user environments. -|[.filename]#/tmp/# -|Temporary files which are usually _not_ preserved across a system reboot. A memory-based file system is often mounted at [.filename]#/tmp#. This can be automated using the tmpmfs-related variables of man:rc.conf[5] or with an entry in [.filename]#/etc/fstab#; refer to man:mdmfs[8] for details. +|`/tmp/` +|Temporary files which are usually _not_ preserved across a system reboot. A memory-based file system is often mounted at `/tmp`. This can be automated using the tmpmfs-related variables of man:rc.conf[5] or with an entry in `/etc/fstab`; refer to man:mdmfs[8] for details. -|[.filename]#/usr/# +|`/usr/` |The majority of user utilities and applications. -|[.filename]#/usr/bin/# +|`/usr/bin/` |Common utilities, programming tools, and applications. -|[.filename]#/usr/include/# +|`/usr/include/` |Standard C include files. -|[.filename]#/usr/lib/# +|`/usr/lib/` |Archive libraries. -|[.filename]#/usr/libdata/# +|`/usr/libdata/` |Miscellaneous utility data files. -|[.filename]#/usr/libexec/# +|`/usr/libexec/` |System daemons and system utilities executed by other programs. -|[.filename]#/usr/local/# -|Local executables and libraries. Also used as the default destination for the FreeBSD ports framework. Within [.filename]#/usr/local#, the general layout sketched out by man:hier[7] for [.filename]#/usr# should be used. Exceptions are the man directory, which is directly under [.filename]#/usr/local# rather than under [.filename]#/usr/local/share#, and the ports documentation is in [.filename]#share/doc/port#. - -|[.filename]#/usr/obj/# -|Architecture-specific target tree produced by building the [.filename]#/usr/src# tree. +|`/usr/local/` +|Local executables and libraries. Also used as the default destination for the FreeBSD ports framework. Within `/usr/local`, the general layout sketched out by man:hier[7] for `/usr` should be used. Exceptions are the man directory, which is directly under `/usr/local` rather than under `/usr/local/share`, and the ports documentation is in `share/doc/port`. -|[.filename]#/usr/ports/# +|`/usr/ports/` |The FreeBSD Ports Collection (optional). -|[.filename]#/usr/sbin/# +|`/usr/sbin/` |System daemons and system utilities executed by users. -|[.filename]#/usr/share/# +|`/usr/share/` |Architecture-independent files. -|[.filename]#/usr/src/# +|`/usr/src/` |BSD and/or local source files. -|[.filename]#/var/# -|Multi-purpose log, temporary, transient, and spool files. A memory-based file system is sometimes mounted at [.filename]#/var#. This can be automated using the varmfs-related variables in man:rc.conf[5] or with an entry in [.filename]#/etc/fstab#; refer to man:mdmfs[8] for details. +|`/var/` +|Multi-purpose log, temporary, transient, and spool files. -|[.filename]#/var/log/# +|`/var/log/` |Miscellaneous system log files. -|[.filename]#/var/mail/# -|User mailbox files. +|`/var/tmp/` +|Temporary files which are usually preserved across a system reboot. -|[.filename]#/var/spool/# -|Miscellaneous printer and mail system spooling directories. - -|[.filename]#/var/tmp/# -|Temporary files which are usually preserved across a system reboot, unless [.filename]#/var# is a memory-based file system. - -|[.filename]#/var/yp/# -|NIS maps. |=== [[disk-organization]] == Disk Organization The smallest unit of organization that FreeBSD uses to find files is the filename. -Filenames are case-sensitive, which means that [.filename]#readme.txt# and [.filename]#README.TXT# are two separate files. +Filenames are case-sensitive, which means that `readme.txt` and `README.TXT` are two separate files. FreeBSD does not use the extension of a file to determine whether the file is a program, document, or some other form of data. Files are stored in directories. @@ -1119,10 +1137,10 @@ A directory may contain no files, or it may contain many hundreds of files. A directory can also contain other directories, allowing a hierarchy of directories within one another in order to organize data. Files and directories are referenced by giving the file or directory name, followed by a forward slash, `/`, followed by any other directory names that are necessary. -For example, if the directory [.filename]#foo# contains a directory [.filename]#bar# which contains the file [.filename]#readme.txt#, the full name, or _path_, to the file is [.filename]#foo/bar/readme.txt#. +For example, if the directory `foo` contains a directory `bar` which contains the file `readme.txt`, the full name, or _path_, to the file is `foo/bar/readme.txt`. Note that this is different from Windows(R) which uses `\` to separate file and directory names. FreeBSD does not use drive letters, or other drive names in the path. -For example, one would not type [.filename]#c:\foo\bar\readme.txt# on FreeBSD. +For example, one would not type `c:\foo\bar\readme.txt` on FreeBSD. Directories and files are stored in a file system. Each file system contains exactly one directory at the very top level, called the _root directory_ for that file system. @@ -1138,37 +1156,37 @@ Call `A` the root file system. If man:ls[1] is used to view the contents of this directory, it will show two subdirectories, `A1` and `A2`. The directory tree looks like this: -image::example-dir1.png[] +image::example-dir1.png[Directory tree with the root directory and two subdirectories, A1 and A2] A file system must be mounted on to a directory in another file system. When mounting file system `B` on to the directory `A1`, the root directory of `B` replaces `A1`, and the directories in `B` appear accordingly: -image::example-dir2.png[] +image::example-dir2.png[Directory tree with the root directory and two subdirectories, A1 and A2. And more subdirectories, B1 and B2 hanging from A1] -Any files that are in the `B1` or `B2` directories can be reached with the path [.filename]#/A1/B1# or [.filename]#/A1/B2# as necessary. -Any files that were in [.filename]#/A1# have been temporarily hidden. +Any files that are in the `B1` or `B2` directories can be reached with the path `/A1/B1` or `/A1/B2` as necessary. +Any files that were in `/A1` have been temporarily hidden. They will reappear if `B` is _unmounted_ from `A`. If `B` had been mounted on `A2` then the diagram would look like this: -image::example-dir3.png[] +image::example-dir3.png[Directory tree with the root directory and two subdirectories, A1 and A2. And more subdirectories, B1 and B2 hanging from A2] -and the paths would be [.filename]#/A2/B1# and [.filename]#/A2/B2# respectively. +and the paths would be `/A2/B1` and `/A2/B2` respectively. File systems can be mounted on top of one another. Continuing the last example, the `C` file system could be mounted on top of the `B1` directory in the `B` file system, leading to this arrangement: -image::example-dir4.png[] +image::example-dir4.png[A complex directory tree. With different subdirectories hanging from root.] Or `C` could be mounted directly on to the `A` file system, under the `A1` directory: -image::example-dir5.png[] +image::example-dir5.png[A complex directory tree. With different subdirectories hanging from root.] It is entirely possible to have one large root file system, and not need to create any others. There are some drawbacks to this approach, and one advantage. .Benefits of Multiple File Systems -* Different file systems can have different _mount options_. For example, the root file system can be mounted read-only, making it impossible for users to inadvertently delete or edit a critical file. Separating user-writable file systems, such as [.filename]#/home#, from other file systems allows them to be mounted _nosuid_. This option prevents the _suid_/_guid_ bits on executables stored on the file system from taking effect, possibly improving security. +* Different file systems can have different _mount options_. For example, the root file system can be mounted read-only, making it impossible for users to inadvertently delete or edit a critical file. Separating user-writable file systems, such as `/home`, from other file systems allows them to be mounted _nosuid_. This option prevents the _suid_/_guid_ bits on executables stored on the file system from taking effect, possibly improving security. * FreeBSD automatically optimizes the layout of files on a file system, depending on how the file system is being used. So a file system that contains many small files that are written frequently will have a different optimization to one that contains fewer, larger files. By having one big file system this optimization breaks down. * FreeBSD's file systems are robust if power is lost. However, a power loss at a critical point could still damage the structure of the file system. By splitting data over multiple file systems it is more likely that the system will still come up, making it easier to restore from backup as necessary. @@ -1178,6 +1196,9 @@ There are some drawbacks to this approach, and one advantage. [IMPORTANT] ==== FreeBSD features the man:growfs[8] command, which makes it possible to increase the size of file system on the fly, removing this limitation. +A file system can only be expanded into free space in the partition in which it resides. +If there is space after the partition, the partition can be expanded with man:gpart[8]. +If the partition is the last one on a virtual disk, and the disk is expanded, the partition can then be expanded. ==== File systems are contained in partitions. @@ -1191,8 +1212,7 @@ When FreeBSD runs out of memory, it moves some of the data that is not currently Some partitions have certain conventions associated with them. -[.informaltable] -[cols="1,1", frame="none", options="header"] +[cols="25h,~"] |=== | Partition | Convention @@ -1291,31 +1311,31 @@ When installing FreeBSD, configure the disk slices, create partitions within the ==== This diagram shows FreeBSD's view of the first SATA disk attached to the system. Assume that the disk is 250 GB in size, and contains an 80 GB slice and a 170 GB slice (MS-DOS(R) partitions). -The first slice contains a Windows(R) NTFS file system, [.filename]#C:#, and the second slice contains a FreeBSD installation. +The first slice contains a Windows(R) NTFS file system, `C:`, and the second slice contains a FreeBSD installation. This example FreeBSD installation has four data partitions and a swap partition. The four partitions each hold a file system. -Partition `a` is used for the root file system, `d` for [.filename]#/var/#, `e` for [.filename]#/tmp/#, and `f` for [.filename]#/usr/#. +Partition `a` is used for the root file system, `d` for `/var/`, `e` for `/tmp/`, and `f` for `/usr/`. Partition letter `c` refers to the entire slice, and so is not used for ordinary partitions. -image::disk-layout.png[] +image::disk-layout.png[Layout of a shared drive between Windows and FreeBSD] ==== [[mount-unmount]] == Mounting and Unmounting File Systems -The file system is best visualized as a tree, rooted, as it were, at [.filename]#/#. [.filename]#/dev#, [.filename]#/usr#, and the other directories in the root directory are branches, which may have their own branches, such as [.filename]#/usr/local#, and so on. +The file system is best visualized as a tree, rooted, as it were, at `/`. `/dev`, `/usr`, and the other directories in the root directory are branches, which may have their own branches, such as `/usr/local`, and so on. There are various reasons to house some of these directories on separate file systems. -[.filename]#/var# contains the directories [.filename]#log/#, [.filename]#spool/#, and various types of temporary files, and as such, may get filled up. -Filling up the root file system is not a good idea, so splitting [.filename]#/var# from [.filename]#/# is often favorable. +`/var` contains the directories `log/`, `spool/`, and various types of temporary files, and as such, may get filled up. +Filling up the root file system is not a good idea, so splitting `/var` from `/` is often favorable. Another common reason to contain certain directory trees on other file systems is if they are to be housed on separate physical disks, or are separate virtual disks, such as Network File System mounts, described in crossref:network-servers[network-nfs,“Network File System (NFS)”], or CDROM drives. [[disks-fstab]] -=== The [.filename]#fstab# File +=== The fstab File -During the boot process (crossref:boot[boot,The FreeBSD Booting Process]), file systems listed in [.filename]#/etc/fstab# are automatically mounted except for the entries containing `noauto`. +During the boot process (crossref:boot[boot,The FreeBSD Booting Process]), file systems listed in `/etc/fstab` are automatically mounted except for the entries containing `noauto`. This file contains entries in the following format: [.programlisting] @@ -1343,13 +1363,13 @@ Used by man:dump[8] to determine which file systems require dumping. If the field is missing, a value of zero is assumed. `passno`:: -Determines the order in which file systems should be checked. +Determines the order in which UFS file systems should be checked by man:fsck[8] after a reboot. File systems that should be skipped should have their `passno` set to zero. The root file system needs to be checked before everything else and should have its `passno` set to one. The other file systems should be set to values greater than one. If more than one file system has the same `passno`, man:fsck[8] will attempt to check file systems in parallel if possible. -Refer to man:fstab[5] for more information on the format of [.filename]#/etc/fstab# and its options. +Refer to man:fstab[5] for more information on the format of `/etc/fstab` and its options. [[disks-mount]] === Using man:mount[8] @@ -1369,7 +1389,7 @@ This command provides many options which are described in man:mount[8], The most .Mount Options `-a`:: -Mount all the file systems listed in [.filename]#/etc/fstab#, except those marked as "noauto", excluded by the `-t` flag, or those that are already mounted. +Mount all the file systems listed in `/etc/fstab`, except those marked as "noauto", excluded by the `-t` flag, or those that are already mounted. `-d`:: Do everything except for the actual mount system call. @@ -1534,46 +1554,6 @@ Restarting `httpd` would result in a brief outage period on the web server. Instead, send the daemon the `SIGHUP` signal. Be aware that different daemons will have different behavior, so refer to the documentation for the daemon to determine if `SIGHUP` will achieve the desired results. -[.procedure] -**** -.Procedure: Sending a Signal to a Process - -This example shows how to send a signal to man:inetd[8]. -The man:inetd[8] configuration file is [.filename]#/etc/inetd.conf#, and man:inetd[8] will re-read this configuration file when it is sent a `SIGHUP`. - -. Find the PID of the process to send the signal to using man:pgrep[1]. In this example, the PID for man:inetd[8] is 198: -+ -[source,shell] -.... -% pgrep -l inetd -198 inetd -.... -+ -. Use man:kill[1] to send the signal. As man:inetd[8] is owned by `root`, use man:su[1] to become `root` first. -+ -[source,shell] -.... -% su -Password: -# /bin/kill -s HUP 198 -.... - -Like most UNIX(R) commands, man:kill[1] will not print any output if it is successful. -If a signal is sent to a process not owned by that user, the message `kill: _PID_: Operation not permitted` will be displayed. -Mistyping the PID will either send the signal to the wrong process, which could have negative results, or will send the signal to a PID that is not currently in use, resulting in the error `kill: _PID_: No such process`. - -[NOTE] -==== -*Why Use `/bin/kill`?:* + - -Many shells provide `kill` as a built in command, meaning that the shell will send the signal directly, rather than running [.filename]#/bin/kill#. -Be aware that different shells have a different syntax for specifying the name of the signal to send. -Rather than try to learn all of them, it can be simpler to specify `/bin/kill`. -==== -**** - -When sending other signals, substitute `TERM` or `KILL` with the name of the signal. - [IMPORTANT] ==== Killing a random process on the system is a bad idea. @@ -1598,11 +1578,11 @@ Each shell has unique properties that may or may not work with a user's preferre One common shell feature is filename completion. After a user types the first few letters of a command or filename and presses kbd:[Tab], the shell completes the rest of the command or filename. -Consider two files called [.filename]#foobar# and [.filename]#football#. -To delete [.filename]#foobar#, the user might type `rm foo` and press kbd:[Tab] to complete the filename. +Consider two files called `foobar` and `football`. +To delete `foobar`, the user might type `rm foo` and press kbd:[Tab] to complete the filename. But the shell only shows `rm foo`. -It was unable to complete the filename because both [.filename]#foobar# and [.filename]#football# start with `foo`. +It was unable to complete the filename because both `foobar` and `football` start with `foo`. Some shells sound a beep or show all the choices if more than one name matches. The user must then type more characters to identify the desired filename. Typing a `t` and pressing kbd:[Tab] again is enough to let the shell determine which filename is desired and fill in the rest. @@ -1615,7 +1595,7 @@ Note that the names of environment variables are always in uppercase. [[shell-env-vars]] .Common Environment Variables -[cols="1,1", frame="none", options="header"] +[cols="25h,~"] |=== | Variable | Description @@ -1657,7 +1637,7 @@ Note that the names of environment variables are always in uppercase. How to set an environment variable differs between shells. In man:tcsh[1] and man:csh[1], use `setenv` to set environment variables. In man:sh[1] and `bash`, use `export` to set the current environment variables. -This example sets the default `EDITOR` to [.filename]#/usr/local/bin/emacs# for the man:tcsh[1] shell: +This example sets the default `EDITOR` to `/usr/local/bin/emacs` for the man:tcsh[1] shell: [source,shell] .... @@ -1699,7 +1679,7 @@ For example, to change the shell to `bash`: [NOTE] ==== -The new shell _must_ be present in [.filename]#/etc/shells#. +The new shell _must_ be present in `/etc/shells`. If the shell was installed from the FreeBSD Ports Collection as described in crossref:ports[ports,Installing Applications: Packages and Ports], it should be automatically added to this file. If it is missing, add it using this command, replacing the path with the path of the shell: @@ -1724,7 +1704,7 @@ To capture the output of the man:ls[1] command, for example, into a file, redire % ls > directory_listing.txt .... -The directory contents will now be listed in [.filename]#directory_listing.txt#. +The directory contents will now be listed in `directory_listing.txt`. Some commands can be used to read input, such as man:sort[1]. To sort this listing, redirect the input: @@ -1759,7 +1739,7 @@ Basically, a pipe allows the standard output of a command to be passed as standa % cat directory_listing.txt | sort | less .... -In that example, the contents of [.filename]#directory_listing.txt# will be sorted and the output passed to man:less[1]. +In that example, the contents of `directory_listing.txt` will be sorted and the output passed to man:less[1]. This allows the user to scroll through the output at their own pace and prevent it from scrolling off the screen. [[editors]] @@ -1788,12 +1768,12 @@ To change the default editor, set the `EDITOR` environment variable as described A device is a term used mostly for hardware-related activities in a system, including disks, printers, graphics cards, and keyboards. When FreeBSD boots, the majority of the boot messages refer to devices being detected. -A copy of the boot messages are saved to [.filename]#/var/run/dmesg.boot#. +A copy of the boot messages is saved to `/var/run/dmesg.boot`. Each device has a device name and number. -For example, [.filename]#ada0# is the first SATA hard drive, while [.filename]#kbd0# represents the keyboard. +For example, `ada0` is the first SATA hard drive, while `kbd0` represents the keyboard. -Most devices in FreeBSD must be accessed through special files called device nodes, which are located in [.filename]#/dev#. +Most devices in FreeBSD must be accessed through special files called device nodes, which are located in `/dev`. [[basics-more-information]] == Manual Pages @@ -1850,7 +1830,7 @@ If the name of the manual page is unknown, use `man -k` to search for keywords i This command displays a list of commands that have the keyword "mail" in their descriptions. This is equivalent to using man:apropos[1]. -To read the descriptions for all of the commands in [.filename]#/usr/sbin#, type: +To read the descriptions for all of the commands in `/usr/sbin`, type: [source,shell] .... diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index b7c29721c5..f7f351013c 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -69,15 +69,6 @@ After reading this chapter, you will know: [[ports-overview]] == Overview of Software Installation -The typical steps for installing third-party software on a UNIX(R) system include: - -[.procedure] -. Find and download the software, which might be distributed in source code format or as a binary. -. Unpack the software from its distribution format. This is typically a tarball compressed with a program such as man:compress[1], man:gzip[1], man:bzip2[1] or man:xz[1]. -. Locate the documentation in [.filename]#INSTALL#, [.filename]#README# or some file in a [.filename]#doc/# subdirectory and read up on how to install the software. -. If the software was distributed in source format, compile it. This may involve editing a [.filename]#Makefile# or running a `configure` script. -. Test and install the software. - A FreeBSD _port_ is a collection of files designed to automate the process of compiling an application from source code. The files that comprise a port contain all the necessary information to automatically download, extract, patch, compile, and install the application. @@ -99,14 +90,14 @@ Select the technology that meets your requirements for installing a particular a .Package Benefits * A compressed package tarball is typically smaller than the compressed tarball containing the source code for the application. -* Packages do not require compilation time. For large applications, such as Mozilla, KDE, or GNOME, this can be important on a slow system. +* Packages do not require compilation time. For large applications, such as Firefox, KDE Plasma, or GNOME, this can be important on a slow system. * Packages do not require any understanding of the process involved in compiling software on FreeBSD. .Port Benefits * Packages are normally compiled with conservative options because they have to run on the maximum number of systems. By compiling from the port, one can change the compilation options. -* Some applications have compile-time options relating to which features are installed. For example, Apache can be configured with a wide variety of different built-in options. +* Some applications have compile-time options relating to which features are installed. For example, NGINX(R) can be configured with a wide variety of different built-in options. + -In some cases, multiple packages will exist for the same application to specify certain settings. For example, Ghostscript is available as a [.filename]#ghostscript# package and a [.filename]#ghostscript-nox11# package, depending on whether or not Xorg is installed. Creating multiple packages rapidly becomes impossible if an application has more than one or two different compile-time options. +In some cases, multiple packages will exist for the same application to specify certain settings. For example, NGINX(R) is available as a `nginx` package and a `nginx-lite` package, depending on whether or not Xorg is installed. Creating multiple packages rapidly becomes impossible if an application has more than one or two different compile-time options. * The licensing conditions of some software forbid binary distribution. Such software must be distributed as source code which must be compiled by the end-user. * Some people do not trust binary distributions or prefer to read through source code in order to look for potential problems. * Source code is needed in order to apply custom patches. @@ -115,7 +106,6 @@ To keep track of updated ports, subscribe to the {freebsd-ports} and the {freebs [WARNING] ==== - Before installing any application, check https://vuxml.freebsd.org/[] for security issues related to the application or type `pkg audit -F` to check all installed applications for known vulnerabilities. ==== @@ -127,210 +117,66 @@ The remainder of this chapter explains how to use packages and ports to install FreeBSD's list of available applications is growing all the time. There are a number of ways to find software to install: -* The FreeBSD web site maintains an up-to-date searchable list of all the available applications, at link:https://www.FreeBSD.org/ports/[https://www.FreeBSD.org/ports/]. The ports can be searched by application name or by software category. -* Dan Langille maintains http://www.FreshPorts.org/[FreshPorts.org] which provides a comprehensive search utility and also tracks changes to the applications in the Ports Collection. Registered users can create a customized watch list in order to receive an automated email when their watched ports are updated. -* If finding a particular application becomes challenging, try searching a site like http://www.sourceforge.net/[SourceForge.net] or http://www.github.com/[GitHub.com] then check back at the link:https://www.FreeBSD.org/ports/[FreeBSD site] to see if the application has been ported. -* To search the binary package repository for an application: -+ -[source,shell] -.... -# pkg search subversion -git-subversion-1.9.2 -java-subversion-1.8.8_2 -p5-subversion-1.8.8_2 -py27-hgsubversion-1.6 -py27-subversion-1.8.8_2 -ruby-subversion-1.8.8_2 -subversion-1.8.8_2 -subversion-book-4515 -subversion-static-1.8.8_2 -subversion16-1.6.23_4 -subversion17-1.7.16_2 -.... -+ -Package names include the version number and, in the case of ports based on python, the version number of the version of python the package was built with. -Some ports also have multiple versions available. -In the case of Subversion, there are different versions available, as well as different compile options. -In this case, the statically linked version of Subversion. -When indicating which package to install, it is best to specify the application by the port origin, which is the path in the ports tree. -Repeat the `pkg search` with `-o` to list the origin of each package: -+ -[source,shell] -.... -# pkg search -o subversion -devel/git-subversion -java/java-subversion -devel/p5-subversion -devel/py-hgsubversion -devel/py-subversion -devel/ruby-subversion -devel/subversion16 -devel/subversion17 -devel/subversion -devel/subversion-book -devel/subversion-static -.... -+ -Searching by shell globs, regular expressions, exact match, by description, or any other field in the repository database is also supported by `pkg search`. -After installing package:ports-mgmt/pkg[] or package:ports-mgmt/pkg-devel[], see man:pkg-search[8] for more details. -* If the Ports Collection is already installed, there are several methods to query the local version of the ports tree. To find out which category a port is in, type `whereis _file_`, where _file_ is the program to be installed: -+ -[source,shell] -.... -# whereis lsof -lsof: /usr/ports/sysutils/lsof -.... -+ -Alternately, an man:echo[1] statement can be used: -+ -[source,shell] -.... -# echo /usr/ports/*/*lsof* -/usr/ports/sysutils/lsof -.... -+ -Note that this will also return any matched files downloaded into the [.filename]#/usr/ports/distfiles# directory. -* Another way to find software is by using the Ports Collection's built-in search mechanism. To use the search feature, cd to [.filename]#/usr/ports# then run `make search name=program-name` where _program-name_ is the name of the software. For example, to search for `lsof`: -+ -[source,shell] -.... -# cd /usr/ports -# make search name=lsof -Port: lsof-4.88.d,8 -Path: /usr/ports/sysutils/lsof -Info: Lists information about open files (similar to fstat(1)) -Maint: ler@lerctr.org -Index: sysutils -B-deps: -R-deps: -.... -+ -[TIP] -==== -The built-in search mechanism uses a file of index information. -If a message indicates that the [.filename]#INDEX# is required, run `make fetchindex` to download the current index file. -With the [.filename]#INDEX# present, `make search` will be able to perform the requested search. -==== -+ -The "Path:" line indicates where to find the port. -+ -To receive less information, use the `quicksearch` feature: -+ -[source,shell] -.... -# cd /usr/ports -# make quicksearch name=lsof -Port: lsof-4.88.d,8 -Path: /usr/ports/sysutils/lsof -Info: Lists information about open files (similar to fstat(1)) -.... -+ -For more in-depth searching, use `make search key=_string_` or `make quicksearch key=_string_`, where _string_ is some text to search for. -The text can be in comments, descriptions, or dependencies in order to find ports which relate to a particular subject when the name of the program is unknown. -+ -When using `search` or `quicksearch`, the search string is case-insensitive. -Searching for "LSOF" will yield the same results as searching for "lsof". +* The FreeBSD web site maintains an up-to-date searchable list of all the available applications, at link:https://www.FreeBSD.org/ports/[Ports Portal]. The ports can be searched by application name or by software category. +* Dan Langille maintains https://www.freshports.org/[FreshPorts] which provides a comprehensive search utility and also tracks changes to the applications in the Ports Collection. Registered users can create a customized watch list in order to receive an automated email when their watched ports are updated. +* If finding a particular application becomes challenging, try searching a site like https://sourceforge.net/[SourceForge] or https://github.com/[GitHub] then check back at the link:https://www.FreeBSD.org/ports/[Ports Portal] to see if the application has been ported. *** 824 LINES SKIPPED *** From nobody Thu Jan 19 20:03:42 2023 X-Original-To: dev-commits-doc-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 4NyYV637tvz2sXrB for ; Thu, 19 Jan 2023 20:03:42 +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 4NyYV6261Lz49ZM; Thu, 19 Jan 2023 20:03:42 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674158622; 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=o2krOlnLAaF3VXaDtQsNikQJpPGmcaa+2ZUAvjHlak0=; b=T/99sA3092vdHAef5zIr2SW2/7/Hpe0/O7a2TjgtffG/9YO+/aGetgsR60Bds8FCfz6qQZ gYjURucAbbuAnr1NitNuuokKfkWZ9Nocp+/ZzPSBEIhJWCZ3EDJaLTKFvYjuJ5SHm08CFb 3jxL88f+X/XdzP/hIcIKoLMuLqEudf3G/pB8KrUm7Gsfg+QnR1+7wiXYvN59q/eLKeQE0b vhbOvWRCcxEEo0E8FpLT8CprSatQRYL+vL95ZMPykxbMSPkAKbAHxzz7CjZ5LY0i37Tx7D ZO83YjCpVbRIu+qCq/AljOp0u3KId5lyEu3zsHxqHCpVe6a6AcjIzPiDFPxGgQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674158622; 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=o2krOlnLAaF3VXaDtQsNikQJpPGmcaa+2ZUAvjHlak0=; b=Ldqvk8AhZuO00fCD1GhkhG+AH/MZ1WCcfVa4jqxVipRkDGZz3ib/yGTVDKWS3n0t7c4DsT C7AgjkWL7QaSeYxt01oqcON2ALdoIp7woZIhONHYiEQHDnfBuUsU/q+rp8b2rnpSIORzIL ckUZq9zu5d8bSGEgmKnaxBrhniK/+cMjCqENYsWIph/gKg+HEAgzsuOYSTt8/k72XdQSQ4 oyi2UGMvJmjQxbJTtomFrJQgr6cMmQfrObIguM6BsKEdbBAniHQszlRyt5Umb5gR3PaQ2P LV16BtX2dumNjVgI0Qt4lcqzDW/RmiR4Y2xlgI0sH/P2HHjlkZJ1HG/ZZ0bLGA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674158622; a=rsa-sha256; cv=none; b=sSfRA9mGOjy3ucp3aWDYrNUcAiE3atl0D9gLTcLIQQudujvGSRSs0uswci8JKkJkS2XuFZ Be7VaWQbeXi3AEgk3k5NYTWm6o+SqQngXDDOkRCgLKLVK5zMsu4WZ7dF/1eF+7BYSUs5tv 5rtW8pSuTg0Z7v/BPRHK63Q2vb7GF17gowggb3Ce2eYJjksVMbjAM4J/ZLovELNZFjk6pt bCqXA8bJB6B+VEoix1CXzI+mWYnrRi+JLFX/NjTJ+TYnOena9Zci2b7QLD+MX2rmBcSvAO XXX+Rub7mphqqWUsNvw3Dz7Q3ksailSKtmdFnEWYArYxbfj2h+TFl70OdNksaQ== 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 4NyYV6192Vz13F9; Thu, 19 Jan 2023 20:03:42 +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 30JK3g1s011714; Thu, 19 Jan 2023 20:03:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30JK3giN011713; Thu, 19 Jan 2023 20:03:42 GMT (envelope-from git) Date: Thu, 19 Jan 2023 20:03:42 GMT Message-Id: <202301192003.30JK3giN011713@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 4a9bfe3a29 - main - Fix minor typo List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4a9bfe3a29d27809febed1e636d19444dc6fa588 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=4a9bfe3a29d27809febed1e636d19444dc6fa588 commit 4a9bfe3a29d27809febed1e636d19444dc6fa588 Author: Sergio Carlavilla Delgado AuthorDate: 2023-01-19 20:01:41 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-01-19 20:01:41 +0000 Fix minor typo Reported by: jrm@ --- documentation/content/en/books/handbook/basics/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index ea69f1e767..6174c0ade0 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -733,7 +733,7 @@ total 530 -rw-r--r-- 1 root wheel 7680 Sep 5 12:31 email.txt .... -Focusing on the line for `myfile`, the `(leftmost)` first character indicates whether this file is a regular file, a directory, a special character device, a socket, or any other special pseudo-file device. +Focusing on the line for `myfile`, the first `(leftmost)` character indicates whether this file is a regular file, a directory, a special character device, a socket, or any other special pseudo-file device. In this example, the `-` indicates a regular file. The next three characters, `rw-` in this example, give the permissions for the owner of the file. The next three characters, `r--`, give the permissions for the group that the file belongs to. From nobody Thu Jan 19 20:16:34 2023 X-Original-To: dev-commits-doc-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 4NyYmy47Jlz2sZVj for ; Thu, 19 Jan 2023 20:16:34 +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 4NyYmy3dqJz4CBH; Thu, 19 Jan 2023 20:16:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674159394; 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=zVpsUhxMGXg2rKNSioM1vKRBze9AM8Egf6PgQSgGz8o=; b=hr34clVNJDbxRzwAGdrzXYpwkfgWnglwwta+lNShG56NeknUvH5eptrpPthKsmpejixreX sPWmCpVz5QbQZMVBLqYj+MWg+XEaEz+8kwBej0GWtswHPZW6PqITvIZi/GKNL/tucmpjhT 1bMSsjOvBXaPvN2I9dfRg9udbmBRvc2zUfdhipTCh7+/NMa3pjIu0V9K2ln1zlwiSo2XAq 3VOkPvtmzrhi1u5BR+elEKtDw4RcwxICQZb/XswquuXbMZ4kZrxa7KeAoqGyaRpsRQKn3l FhrcuKKxeiDAPimgysFrcLh/yb/9tqrfhc98+NOVYm2xO4VzOoxQ4ARmvrqdXw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674159394; 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=zVpsUhxMGXg2rKNSioM1vKRBze9AM8Egf6PgQSgGz8o=; b=EuyhT2ctSTOZuz6lcVnPtqvPiya0DD0PV8lP8jygxPhffKv0NB8czqUiE4coF0Jj6CKqKK JhRWCE3dDORxgYaMmF8OlekScVdFH5eX9JD0kWvVNsy0JyorUgVP3HYzMfEQ2TMt8AHoFE 6ZgX379g8GQiK+mwyu0TXM/mHmzhCk5DPoVbrbebN/e+Ko7YFx9RTD5mmkdOXLNN1tEn1Z S674AxFqB8vfNCqMWoJ3Ppd8+E4fIxN+XZGffmtW0SDmNXG8lGUCCRMye3YYCtrUS/2nk1 p0Hj5hdwz8jZkgzydWX+zvZY7B0Ph0tQywSfyGjhKLeLZ9Srfcgx3Z+MpKTQ3A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674159394; a=rsa-sha256; cv=none; b=TofZLRzrDdLcoQ7+PAJnHE+5SHccUMVVx5th1xQx/FPdG/gun12LHClwxAvpczczImI7S8 VvnaMyYWblHaDm0hfxwy3GT5KplqCYVwuk0HoPHOxfVd65SaVOzk1sRmdW52WRCbZyQYet GS10xnXYmVZy0fQSiDv/pZRhsxIYX4imZK6zMJ+k5Nt3XxPfQB80fBc8L9HBsTDLT9jx2Q bAvvr85tzfXBfWlbkJQRbqe5OfpME6oCaVqMuNtPS8X8kqOUkufACjEsxI/8wEx62FH6xg n1cVeYavTU5DTTwGWSCM3PT9WzrUOqhGur1Bxp7vvTNC9bIsiMJRhN08IRe3lQ== 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 4NyYmy2hPvz13V0; Thu, 19 Jan 2023 20:16:34 +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 30JKGYBS026303; Thu, 19 Jan 2023 20:16:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30JKGYHw026302; Thu, 19 Jan 2023 20:16:34 GMT (envelope-from git) Date: Thu, 19 Jan 2023 20:16:34 GMT Message-Id: <202301192016.30JKGYHw026302@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: c5fa554557 - main - Ports chapter - Upgrade references to stale packages List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c5fa554557e5cb07eec0446c7fcef05090065fb6 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=c5fa554557e5cb07eec0446c7fcef05090065fb6 commit c5fa554557e5cb07eec0446c7fcef05090065fb6 Author: Sergio Carlavilla Delgado AuthorDate: 2023-01-19 20:16:08 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-01-19 20:16:08 +0000 Ports chapter - Upgrade references to stale packages --- .../content/en/books/handbook/ports/_index.adoc | 21 ++++++--------------- 1 file changed, 6 insertions(+), 15 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index f7f351013c..79e5e97cc5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -651,27 +651,20 @@ And to unlock `nginx-lite`: Software within the FreeBSD Ports Collection can undergo major version number changes. To address this, pkg has a built-in command to update package origins. -This can be useful, for example, if package:lang/php5[] is renamed to package:lang/php53[] so that package:lang/php5[] can now represent version `5.4`. +This can be useful, for example, if package:lang/python3[] is renamed to package:lang/python311[] so that package:lang/python3[] can now represent version `3.11`. To change the package origin for the above example, run: [source,shell] .... -# pkg set -o lang/php5:lang/php53 +# pkg set -o lang/python3:lang/python311 .... -As another example, to update package:lang/ruby18[] to package:lang/ruby19[], run: +As another example, to update package:lang/ruby31[] to package:lang/ruby32[], run: [source,shell] .... -# pkg set -o lang/ruby18:lang/ruby19 -.... - -As a final example, to change the origin of the `libglut` shared libraries from package:graphics/libglut[] to package:graphics/freeglut[], run: - -[source,shell] -.... -# pkg set -o graphics/libglut:graphics/freeglut +# pkg set -o lang/ruby31:lang/ruby32 .... [NOTE] @@ -681,12 +674,10 @@ To force a reinstallation of dependent packages, run: [source,shell] .... -# pkg install -Rf graphics/freeglut +# pkg install -Rf lang/ruby32 .... ==== - - [[ports-using]] == Using the Ports Collection @@ -861,7 +852,7 @@ To save this extra step, instead use `make install clean` when compiling the por ==== Customizing Ports Installation Some ports provide build options which can be used to enable or disable application components, provide security options, or allow for other customizations. -Examples include package:www/firefox[], package:security/gpgme[], and package:mail/sylpheed-claws[]. +Examples include package:www/firefox[] and package:security/gpgme[]. If the port depends upon other ports which have configurable options, it may pause several times for user interaction as the default behavior is to prompt the user to select options from a menu. To avoid this and do all of the configuration in one batch, run `make config-recursive` within the port skeleton. From nobody Sat Jan 21 00:20:25 2023 X-Original-To: dev-commits-doc-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 4NzH7t13WBz2t0qn for ; Sat, 21 Jan 2023 00:20:26 +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 4NzH7t0WC8z41jm; Sat, 21 Jan 2023 00:20:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674260426; 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=DdyM47EUyuz78yp7K5Wg7QHMUSH/2f7NSh84pNhfPa4=; b=Arcn1UoFxNi9EFas9mqgQUV6+dSZpwwGzdqisrrzao2ztDRK2GwyRp4i1Rsj6JzrsCO0Js Hf5HNQJSg6S/BjH6WzwOzWUPtJBmW8CpdtmuBQTc5LbZbH2POrhZpkiRd3QAagYdshXkMJ nny4kSTDnQ2MatShkaMfWHZP0CIuqHBtVatWDTTmTeEB0O7ejbxO0ZxQw+ZhXBDmidlTkI /WvIM4exGxS5W3o+rVwHCXKyhcVJwf7m9418KdvQ4Xtcj84jOq6KLjlLn70CseiRdqqILQ zXnNCNPAlFthadA0ugYgxXGn/S5lVyGwdpyil+8O2iuvoeu50sm2z9CW8qyPvg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674260426; 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=DdyM47EUyuz78yp7K5Wg7QHMUSH/2f7NSh84pNhfPa4=; b=WNww2SwXZOs2oGJG7N/1RAFNnwIINqVX1RCRO9SkbA8Bv5tk+cOrChNaVO7N6XJaa6Dr7K PUPIgTy6xVDmvBA3fFHNJ+XWaS36enJXwf6/DiM3SHdkzknX1dA1+WzrP9oRUVRH2a6Eu7 6qcg1se8v+jdfISgxocgqAmuMxUo2fX87Cb8JTlQrAkGyOpLV1Z9JkTnzSH8wau0QQPirY ZwADgJ01ri0Wn890OM0tL4xMm14iAqzWlVJxEOLBlFSwribKf5e+kGwHSCWAG0grxSqtU/ kx9BX9pg77aix9yehj8b5J/UvQt1eWy+c0Ywz1nFA1Jpve3vzwKePAVrrv+xDg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674260426; a=rsa-sha256; cv=none; b=EOu5BIy8U/HXt2ondamb9Np5IZ2fL0S4uPziE8ngXEHrcZjvwV9vJSA0alslgSjE6il0On sBHDMLcIsyUB0seHpK/FdLJUCwMnsPMBHXwbyciZydxpbwKMHwMXMAqSMMezFEVJIro6F7 4XEheevvdZ3JW2w4O3o2ztc/JRSQ3xdAEYw1laxi9dcGK0fDILZZlt124AsyqRBoxpyMSS tzBojTR4z5pxlZpm5pN+QvWx1Iasyb+U8NMhbBOIw2D+c/zA2VlX2ULkiyB2Of0AmYNGOL hmO9ODAKSEATpnwSXCQVwut22Z/CUpfYRSmi38zAMX1hqelHZYL3GjZlE/wBTg== 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 4NzH7s6gF5zqGd; Sat, 21 Jan 2023 00:20:25 +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 30L0KPHg039973; Sat, 21 Jan 2023 00:20:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30L0KPvp039972; Sat, 21 Jan 2023 00:20:25 GMT (envelope-from git) Date: Sat, 21 Jan 2023 00:20:25 GMT Message-Id: <202301210020.30L0KPvp039972@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 6a430fe152 - main - documentation/pdf: Improve zh-cn|zh-tw font issues List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6a430fe152e6374caf0851d253819293522fcdb4 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=6a430fe152e6374caf0851d253819293522fcdb4 commit 6a430fe152e6374caf0851d253819293522fcdb4 Author: Yan Hao Wang AuthorDate: 2023-01-20 19:50:45 +0000 Commit: Danilo G. Baio CommitDate: 2023-01-21 00:14:53 +0000 documentation/pdf: Improve zh-cn|zh-tw font issues The build script now uses fonts installed by the port/pkg docproj-fonts-cjk. Differential Revision: https://reviews.freebsd.org/D36623 Differential Revision: https://reviews.freebsd.org/D37447 Co-authored-by: Danilo G. Baio --- documentation/tools/asciidoctor.sh | 25 ++++++++++++++++++++++++- shared/zh-cn/zh-cn-theme.yml | 16 ++++++++++++++++ shared/zh-tw/zh-tw-theme.yml | 16 ++++++++++++++++ 3 files changed, 56 insertions(+), 1 deletion(-) diff --git a/documentation/tools/asciidoctor.sh b/documentation/tools/asciidoctor.sh index 27ce3f790c..ab5125bc0f 100755 --- a/documentation/tools/asciidoctor.sh +++ b/documentation/tools/asciidoctor.sh @@ -49,6 +49,8 @@ build_pdf() { local cur_dir_source="content/$doc_lang/$doc_type/$doc_name/" local cur_dir_output="public/$doc_lang/$doc_type/$doc_name/" + local theme_font="" + if [ ! -d "$cur_dir_output" ]; then mkdir -p "$cur_dir_output" fi @@ -68,6 +70,27 @@ build_pdf() { local asciidoctor_file_name="_index.adoc" fi + # Check non default fonts + case "$doc_lang" in + zh-cn) + if [ ! -f "$LOCALBASE/share/docproj-fonts-cjk/NotoSansSC-Medium.otf" ]; then + echo " font not found, skipping pdf build" + return + fi + theme_font="-a scripts=cjk -a pdf-theme=./shared/zh-cn/zh-cn-theme.yml -a pdf-fontsdir=$LOCALBASE/share/docproj-fonts-cjk" + ;; + zh-tw) + if [ ! -f "$LOCALBASE/share/docproj-fonts-cjk/NotoSansTC-Medium.otf" ]; then + echo " font not found, skipping pdf build" + return + fi + theme_font="-a pdf-theme=./shared/zh-tw/zh-tw-theme.yml -a pdf-fontsdir=$LOCALBASE/share/docproj-fonts-cjk/" + ;; + *) + theme_font="-a pdf-theme=default-with-fallback-font" + ;; + esac + $ASCIIDOCTORPDF_CMD \ -r ./shared/lib/man-macro.rb \ -r ./shared/lib/git-macro.rb \ @@ -80,7 +103,7 @@ build_pdf() { -a lang="$doc_lang" \ -a isonline=1 \ -a env-beastie=1 \ - -a pdf-theme=default-with-fallback-font \ + ${theme_font} \ -o "${cur_dir_output}${doc_name}_${doc_lang}.pdf" \ "${cur_dir_source}${asciidoctor_file_name}" } diff --git a/shared/zh-cn/zh-cn-theme.yml b/shared/zh-cn/zh-cn-theme.yml new file mode 100644 index 0000000000..8e1c288aad --- /dev/null +++ b/shared/zh-cn/zh-cn-theme.yml @@ -0,0 +1,16 @@ +extends: default +font: + catalog: + merge: true + Noto Sans SC: NotoSansSC-Medium.otf + fallbacks: + - Noto Serif +base: + text-align: left + font-family: Noto Sans SC +codespan: + font-family: Noto Sans SC +kbd: + font-family: $codespan-font-family +code: + font-family: $codespan-font-family diff --git a/shared/zh-tw/zh-tw-theme.yml b/shared/zh-tw/zh-tw-theme.yml new file mode 100644 index 0000000000..b4ce1d6f05 --- /dev/null +++ b/shared/zh-tw/zh-tw-theme.yml @@ -0,0 +1,16 @@ +extends: default +font: + catalog: + merge: true + Noto Sans TC: NotoSansTC-Medium.otf + fallbacks: + - Noto Serif +base: + text-align: left + font-family: Noto Sans TC +codespan: + font-family: Noto Sans TC +kbd: + font-family: $codespan-font-family +code: + font-family: $codespan-font-family From nobody Sat Jan 21 00:59:28 2023 X-Original-To: dev-commits-doc-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 4NzJ0x2DbZz2t4nv for ; Sat, 21 Jan 2023 00:59:29 +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 4NzJ0x1bdKz469L; Sat, 21 Jan 2023 00:59:29 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674262769; 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=24WAVEDEAWFKKn85na0y/z8pJJUYnHQm51y3TSuzSgs=; b=ASeYQxnqZ4yQXnCKjvFIOTgVodIWBo5lyE9s2fjVIDY+j2WZ5/Jb5cpcRQU3EqpeJgU4+0 xURYbHycHO7baplcRQEbbMzDA0JRiS/RykobFlR5x+FYzFDO2/dbj32/8v7c1XUQk7X/+r eZ6Uoll8ONRABwjTrjrneuC8MbB5p54jNUAesTDCMORB4SmmLS4BUpX1XtdtjS/c9bRIWT TxnXVNzFrnyggs19miEE7mdcBerjZxgB13ewubewPXK5v/qqdSDzl6Qh7jXqvmr9XClALz oR7UflAUZbELQO8JtHnMNYlll9EQWkeWFVkPICS8EDrHtm/lvq/1JGD4mo4gfg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674262769; 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=24WAVEDEAWFKKn85na0y/z8pJJUYnHQm51y3TSuzSgs=; b=DElyr4MwJ+rG2XMhuBjqCphyiyoZK3jCNUnrg1f4oQtVswdzZFq9RB5BcCyD5sMQHs/3pj YvlhIvlZlNHRYhwrGUn2j7QV1p0VWIoJJmhZjPMN8eV1ymQazABfoAHNe438YyxcgkgUAG L2GPg4bnOGMilIjrx0iqoQSly/9wQpNwrWVGjoBkRFgi4CSdMr5nJ7FIsRVIXmCVek/8R6 yOicV0H/yrYZGQUUY3iKzScN7roBHPlo6FihZ38ucyD0wTwVYadxkHN8+n6JfuoCO+9pMZ rdZv3pZiWPOXSWIRp1QzCDUg6tHCztzo5PhiOfrjmPymrDa6a77XCNGFqRaNkA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674262769; a=rsa-sha256; cv=none; b=V1YG6b5GFFD++HouhS5kux/HxC1inGrqGs1u2ZnKUTktiz/X9xDjzc+Vavci6kyOpzYgRS Nz7MWcudn6MQ3qCb1Ks9tGmlFbHOPSjPUXS40cWo3jYb9x7sByq9JA9rr57KcpYYgjL/+B hJZhPy5Unw4NhPQvK7feXdvdRfzPmaJ7xU+Qy8pld1l+PORR4OG70j0C8poq2VApvZgYj6 AJzh91bQXYO7lSlk3x/j2KnwyITvzPCGZeNVby93SN2A3JwmqoIvhnIRpFF89UOb1jeXd9 BOLfPJ1FKBUAP9t1660wddb8UHZcdgo9ckVZYqD5+c/LGG+CTq+5OXS1dvSO4w== 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 4NzJ0x0YW2zrMX; Sat, 21 Jan 2023 00:59:29 +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 30L0xSOL087413; Sat, 21 Jan 2023 00:59:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30L0xSXr087412; Sat, 21 Jan 2023 00:59:28 GMT (envelope-from git) Date: Sat, 21 Jan 2023 00:59:28 GMT Message-Id: <202301210059.30L0xSXr087412@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 8548086872 - main - Remove build verbosity by default List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 854808687207af05b2c62ec3faca0d1ccc4d5823 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=854808687207af05b2c62ec3faca0d1ccc4d5823 commit 854808687207af05b2c62ec3faca0d1ccc4d5823 Author: Danilo G. Baio AuthorDate: 2023-01-21 00:57:44 +0000 Commit: Danilo G. Baio CommitDate: 2023-01-21 00:58:11 +0000 Remove build verbosity by default This way, it will be easier to identify warnings and errors from Hugo for anyone when working and building the website or the documentation portal. On CI, the builds have verbose and debug options enabled: ``` $ cd doc $ make HUGO_ARGS="--verbose --debug" ``` --- documentation/Makefile | 2 +- website/Makefile | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/Makefile b/documentation/Makefile index 410ff444df..ba42e14b0b 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -43,7 +43,7 @@ GEMBASE?= ${LOCALBASE} RUBY_CMD = ${GEMBASE}/bin/ruby HUGO_CMD = ${LOCALBASE}/bin/hugo -HUGO_ARGS?= --verbose --minify +HUGO_ARGS?= --minify HUGO_OFFLINE_ARGS?= --environment offline --verbose --minify ROUGIFY_CMD= ${GEMBASE}/bin/rougify ASCIIDOCTOR_CMD= ${GEMBASE}/bin/asciidoctor diff --git a/website/Makefile b/website/Makefile index 288d171a43..a087bca2b2 100644 --- a/website/Makefile +++ b/website/Makefile @@ -22,7 +22,7 @@ LOCALBASE?= /usr/local RUBY_CMD = ${LOCALBASE}/bin/ruby HUGO_CMD = ${LOCALBASE}/bin/hugo -HUGO_ARGS?= --verbose +HUGO_ARGS?= RUBYLIB = ../shared/lib .export RUBYLIB From nobody Sat Jan 21 02:45:35 2023 X-Original-To: dev-commits-doc-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 4NzLMM4XRKz2v3Py for ; Sat, 21 Jan 2023 02:45:35 +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 4NzLMM41H4z4JxH; Sat, 21 Jan 2023 02:45:35 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674269135; 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=x4xb2yfQjFcKgTdao0HPH4HrReHhA0h/L7ZAXrNLF6I=; b=L2JPeGg3hKSEyjXS5fmVkJUl2nCzEKYmiK2pDzVsTnIdN5ZsdvFnv/o71VdXcOtHA19n9P G10/+Z/LaT610QHxNxwr2SOA2HpVAqmpZQoWKUol1kzghsq2gxOrf0+60Pu7BTKqZ4O6xE RwNQsl2lWMbUzuZuO0y1zo3O1/12odBSd8Ps0TlPN5uc4Qo/VSF4SbXgwPsRqx5LfTzNv7 XtZIjvQ1PWZOTkFE7G2YXA9PR5Y+lYI3e4zfajmyMcVz5k5aWy9So8gRpfA6OidL4QxZix +GizcyGNfEc3JB+VtAG+X1Lt+5n8jvwvU/rBDthOnjC9s33DkZI5qTIGxfSaCQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674269135; 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=x4xb2yfQjFcKgTdao0HPH4HrReHhA0h/L7ZAXrNLF6I=; b=BxUfPHE1qDH8Zfo0DxXu8wiLVmwXZg2YYl2CEWcgfDjm/8yseiCQJOukJTwjqXhfSwAoZ+ MXGguKgvBm0XXGQb9EGN18dlq4Ifs7OruC3b9hVoRrQCRfRfcLscBu3SKrYHqyT3MdOosB DgRUL9JaM6/MfGVHT58DS9n1kMhPxV3AO4cbsabHzDBQbWhMgMIbOD6JkfjkQBttltA4MW 47hlUCD8jsRUS2ad6nUkKnDVjoR1M21GJDySuEsYvmOhQDENPQ2YO4ummPV3U9wWWXIKaE 0bJrocX8x/jvA1y5iVl+bkjotb4Aa0RnNqtLWcK9igD8rrUvb9/tycVc48pFsw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674269135; a=rsa-sha256; cv=none; b=FVb6ZMeRg2BqwDOBGSKNSiQVVHZZs7YBQojpKOFalDQOPbG77zwGBbLVqwhWThMgY0zEto IJRgNcNBp/bFWrs6hin9qhfYS0Z5oGDgmu3MKtZmyTvuTZk8tdexQ/MyWhWWIX6sT/eLhT B+1K5yWv4if5ITw+awR9HQS/DAFsMqgBB2rNC8AVA/0WQbEYQKipI2i6qtlfTha0i6q3LP zZGYUwN8tajph/HWCjTiKFvJSqe+72HMdFTi7kVVXTElHGWEp8WHNn02pudWx2f/w4Ayte 4DISX3S8gRodylxVIP+KwvDNuUVw4UwKYTOWrt8jc7Tlnq+5Re/5HO2+qgaurw== 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 4NzLMM346mztl0; Sat, 21 Jan 2023 02:45:35 +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 30L2jZv6043425; Sat, 21 Jan 2023 02:45:35 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30L2jZfr043424; Sat, 21 Jan 2023 02:45:35 GMT (envelope-from git) Date: Sat, 21 Jan 2023 02:45:35 GMT Message-Id: <202301210245.30L2jZfr043424@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 481bff5848 - main - documentation/pdf: Remove scripts=cjk from asciidoctor-pdf build List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 481bff5848cf76646cbea521024fa82e3c5a08e0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=481bff5848cf76646cbea521024fa82e3c5a08e0 commit 481bff5848cf76646cbea521024fa82e3c5a08e0 Author: Danilo G. Baio AuthorDate: 2023-01-21 02:39:39 +0000 Commit: Danilo G. Baio CommitDate: 2023-01-21 02:39:39 +0000 documentation/pdf: Remove scripts=cjk from asciidoctor-pdf build There is a bug when building some documents, like the porters-handbook/security chapter (callouts). --- documentation/tools/asciidoctor.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/tools/asciidoctor.sh b/documentation/tools/asciidoctor.sh index ab5125bc0f..9f81723126 100755 --- a/documentation/tools/asciidoctor.sh +++ b/documentation/tools/asciidoctor.sh @@ -77,7 +77,7 @@ build_pdf() { echo " font not found, skipping pdf build" return fi - theme_font="-a scripts=cjk -a pdf-theme=./shared/zh-cn/zh-cn-theme.yml -a pdf-fontsdir=$LOCALBASE/share/docproj-fonts-cjk" + theme_font="-a pdf-theme=./shared/zh-cn/zh-cn-theme.yml -a pdf-fontsdir=$LOCALBASE/share/docproj-fonts-cjk" ;; zh-tw) if [ ! -f "$LOCALBASE/share/docproj-fonts-cjk/NotoSansTC-Medium.otf" ]; then From nobody Sat Jan 21 23:35:23 2023 X-Original-To: dev-commits-doc-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 4Nzt5T0Yfgz311TZ for ; Sat, 21 Jan 2023 23:35:25 +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 4Nzt5T0FPVz3hcS; Sat, 21 Jan 2023 23:35:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674344125; 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=wZXSRATZq49SYjNZ8rKK6fAEror2q6wV8VY/RRq0U5U=; b=khNHHRXmkGh098GYCxOb73dsqsroEh/FjyixGFL2qq5SPlqaoZajEDn+ceAbr7Ty4fx8WY GrsWLgy9elfsaZiJaRwusBi9d9fY1lUQ1uIzn55FMIFDQgEooSnHeWYlveveiIMy/EX3T8 rx7YziNbNO471eDhVBD2zkzRMqsy+fVyiquWcRqi14Op/iSC36497LfAG0SDdVa11gofcF amvtzO8opLsqlYo3lS6Bzu4FzmGZyOACR9zZpEJFVY/bW+dEa8TzCcCUughgvG1TQSmUU3 dWG8yhjI2540KJEQuUNHLQLUYJY+5HW34aYkuoG2gCQcwC9EnA0IWKR81gz0vg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674344125; 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=wZXSRATZq49SYjNZ8rKK6fAEror2q6wV8VY/RRq0U5U=; b=PmCi3yv5wu7TeQcei8OVXTX/W9dozmYQxLmgRb9a+aPrlvccBtOgwZ9N1TyJteWoka/UBP 6qy5FHaISnK6jENn6Q0YDeLCN379lvCPRVJ+RGytvZdaevPBJNZLHFol8C4aW+KiTf/jaH a6TAMjZPwNx3x5OnSHkwhnh47kzLN13xwc9GIfMMnn4b6mja0YsJdEJ5sVkv9yJSvJhPGX MwoQlGOb0n1svBRVu8uhrC2WHQ/jICA3ouZs0xdQXle2+Wvt3GhBizFxiho5EODtHH2+r7 WaGVSrak/00bOo24ANJfSG4dIxy40LioHxC8kpmLYD2Nggn2/S8P2E1MweHLUQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674344125; a=rsa-sha256; cv=none; b=vrJjm21+52WLfFM2Wh4DaLL1jdFRVa4AqzCF3wxBQUFUFneXfu5vcMYHpkPAOwXK6iY/Nx AsnDXwcMuSIFR/bToAqsCU39Imzi7N0XvzVVLvgSPdcd92oAX/XkW7R+Q0onyrM7YJicUi OCxwUd1jf8H7FX4apezShpE709zC/wo99wr1YkjfGeSYJ6vJ17ret/p1jh1BiEfeblHAEa 0+LJ/Vys5ymLy4EO79/NuW5ZBC+5wxpdz6UkjakNGV6oYvrN013aL9nwdCnoIPVPWJwlz8 cFr+wHqD7hIqojQKHorjzZyEzHWR/rqPNXlSMlTGZA5VLGv7ov84FcvLH/hYAQ== 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 4Nzt5S6QZwzSgP; Sat, 21 Jan 2023 23:35:24 +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 30LNZOZQ020736; Sat, 21 Jan 2023 23:35:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30LNZNDG020735; Sat, 21 Jan 2023 23:35:23 GMT (envelope-from git) Date: Sat, 21 Jan 2023 23:35:23 GMT Message-Id: <202301212335.30LNZNDG020735@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 62d80a7755 - main - doc: Update source files (en .po), for translations List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 62d80a7755f68e823f09e8e2c2684203f1fd3e00 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=62d80a7755f68e823f09e8e2c2684203f1fd3e00 commit 62d80a7755f68e823f09e8e2c2684203f1fd3e00 Author: Danilo G. Baio AuthorDate: 2023-01-21 23:34:54 +0000 Commit: Danilo G. Baio CommitDate: 2023-01-21 23:34:54 +0000 doc: Update source files (en .po), for translations --- .../content/en/articles/committers-guide/_index.po | 1220 +-- .../content/en/articles/nanobsd/_index.po | 100 +- .../content/en/articles/pgpkeys/_index.po | 886 +- documentation/content/en/books/dev-model/_index.po | 20 +- .../en/books/developers-handbook/tools/_index.po | 16 +- .../en/books/developers-handbook/x86/_index.po | 12 +- documentation/content/en/books/faq/_index.po | 2218 ++-- .../en/books/fdp-primer/doc-build/_index.po | 6 +- .../en/books/fdp-primer/editor-config/_index.po | 213 +- .../content/en/books/fdp-primer/overview/_index.po | 69 +- .../en/books/fdp-primer/structure/_index.po | 121 +- .../en/books/fdp-primer/trademarks/_index.po | 80 +- .../en/books/fdp-primer/writing-style/_index.po | 287 +- .../books/handbook/advanced-networking/_index.po | 22 +- .../content/en/books/handbook/audit/_index.po | 4 +- .../content/en/books/handbook/basics/_index.po | 1750 ++- .../en/books/handbook/bibliography/_index.po | 541 +- .../content/en/books/handbook/boot/_index.po | 4 +- .../content/en/books/handbook/bsdinstall/_index.po | 2987 +++--- .../content/en/books/handbook/config/_index.po | 10 +- .../en/books/handbook/cutting-edge/_index.po | 329 +- .../content/en/books/handbook/desktop/_index.po | 4 +- .../content/en/books/handbook/disks/_index.po | 16 +- .../content/en/books/handbook/dtrace/_index.po | 4 +- .../en/books/handbook/filesystems/_index.po | 4 +- .../content/en/books/handbook/firewalls/_index.po | 42 +- .../content/en/books/handbook/geom/_index.po | 4 +- .../content/en/books/handbook/introduction.po | 25 +- .../en/books/handbook/introduction/_index.po | 465 +- .../content/en/books/handbook/jails/_index.po | 4 +- .../en/books/handbook/kernelconfig/_index.po | 29 +- .../content/en/books/handbook/l10n/_index.po | 9 +- .../content/en/books/handbook/linuxemu/_index.po | 10 +- .../content/en/books/handbook/mac/_index.po | 4 +- .../content/en/books/handbook/mail/_index.po | 6 +- .../content/en/books/handbook/mirrors/_index.po | 7 +- .../content/en/books/handbook/multimedia/_index.po | 6 +- .../en/books/handbook/network-servers/_index.po | 31 +- documentation/content/en/books/handbook/parti.po | 7 +- .../content/en/books/handbook/pgpkeys/_index.po | 12 +- .../content/en/books/handbook/ports/_index.po | 1608 +-- .../en/books/handbook/ppp-and-slip/_index.po | 10 +- .../content/en/books/handbook/preface/_index.po | 368 +- .../content/en/books/handbook/printing/_index.po | 4 +- .../content/en/books/handbook/security/_index.po | 1136 +- .../en/books/handbook/serialcomms/_index.po | 18 +- .../en/books/handbook/usb-device-mode/_index.po | 4 +- .../en/books/handbook/virtualization/_index.po | 12 +- .../content/en/books/handbook/wine/_index.po | 31 +- .../content/en/books/handbook/x11/_index.po | 1145 +- .../content/en/books/handbook/zfs/_index.po | 51 +- .../en/books/porters-handbook/makefiles/_index.po | 1047 +- .../en/books/porters-handbook/pkg-files/_index.po | 196 +- .../books/porters-handbook/porting-dads/_index.po | 13 +- .../en/books/porters-handbook/special/_index.po | 89 +- .../en/books/porters-handbook/uses/_index.po | 2175 ++-- .../en/books/porters-handbook/versions/_index.po | 10660 ++++++++++--------- 57 files changed, 14637 insertions(+), 15514 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.po b/documentation/content/en/articles/committers-guide/_index.po index 9938c1f80a..cd4083faf1 100644 --- a/documentation/content/en/articles/committers-guide/_index.po +++ b/documentation/content/en/articles/committers-guide/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-10-16 17:07-0300\n" +"POT-Creation-Date: 2023-01-21 20:00-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -48,7 +48,7 @@ msgid "" "Almost all FreeBSD developers have commit rights to one or more " "repositories. However, a few developers do not, and some of the information " "here applies to them as well. (For instance, some people only have rights " -"to work with the Problem Report database). Please see <> " +"to work with the Problem Report database.) Please see <> " "for more information." msgstr "" @@ -127,7 +127,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:82 #, no-wrap -msgid "`ssh://git@gitrepo.FreeBSD.org/src.git` (see also <>)." +msgid "`ssh://git@gitrepo.FreeBSD.org/src.git`" msgstr "" #. type: Table @@ -139,7 +139,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:85 #, no-wrap -msgid "`ssh://git@gitrepo.FreeBSD.org/doc.git` (see also <>)." +msgid "`ssh://git@gitrepo.FreeBSD.org/doc.git`" msgstr "" #. type: Table @@ -151,7 +151,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:88 #, no-wrap -msgid "`ssh://git@gitrepo.FreeBSD.org/ports.git` (see also <>)." +msgid "`ssh://git@gitrepo.FreeBSD.org/ports.git`" msgstr "" #. type: Table @@ -163,7 +163,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:91 #, no-wrap -msgid "developers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists can be found in the files [.filename]#/local/mail/repository-name-developers-archive# and [.filename]#/local/mail/repository-name-committers-archive# on the `FreeBSD.org` cluster.)" +msgid "developers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists can be found in the files [.filename]#/local/mail/repository-name-developers-archive# and [.filename]#/local/mail/repository-name-committers-archive# on `freefall.FreeBSD.org`.)" msgstr "" #. type: Table @@ -175,7 +175,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:94 #, no-wrap -msgid "[.filename]#/home/core/public/monthly-reports# on the `FreeBSD.org` cluster." +msgid "[.filename]#/home/core/public/reports# on the `FreeBSD.org` cluster." msgstr "" #. type: Table @@ -355,8 +355,7 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:181 msgid "" "2048-bit keys with a three-year expiration provide adequate protection at " -"present (2013-12). http://danielpocock.com/rsa-key-sizes-2048-or-4096-bits[] " -"describes the situation in more detail." +"present (2022-10)." msgstr "" #. type: Plain text @@ -379,9 +378,9 @@ msgstr "" msgid "" "After the email address is entered, a passphrase is requested. Methods of " "creating a secure passphrase are contentious. Rather than suggest a single " -"way, here are some links to sites that describe various methods: http://" -"world.std.com/~reinhold/diceware.html[], http://www.iusmentis.com/security/" -"passphrasefaq/[], http://xkcd.com/936/[], http://en.wikipedia.org/wiki/" +"way, here are some links to sites that describe various methods: https://" +"world.std.com/~reinhold/diceware.html[], https://www.iusmentis.com/security/" +"passphrasefaq/[], https://xkcd.com/936/[], https://en.wikipedia.org/wiki/" "Passphrase[]." msgstr "" @@ -597,9 +596,9 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:270 msgid "" "doc committers may commit documentation changes to [.filename]#src# files, " -"such as man pages, READMEs, fortune databases, calendar files, and comment " -"fixes without approval from a src committer, subject to the normal care and " -"tending of commits." +"such as manual pages, READMEs, fortune databases, calendar files, and " +"comment fixes without approval from a src committer, subject to the normal " +"care and tending of commits." msgstr "" #. type: Plain text @@ -895,8 +894,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:389 msgid "" -"Again, note that `gitrepo.freebsd.org` will be canonicalized to `repo." -"freebsd.org` in the future." +"Again, note that `gitrepo.freebsd.org` has been canonicalized to `repo." +"freebsd.org`." msgstr "" #. type: Plain text @@ -955,8 +954,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:420 msgid "" -"For browsing `internal/admin` branch on web: https://cgit.freebsd.org/" -"${repo}/log/?h=internal/admin" +"For browsing `internal/admin` branch on web: `https://cgit.freebsd.org/" +"${repo}/log/?h=internal/admin`" msgstr "" #. type: Plain text @@ -2030,8 +2029,8 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:935 msgid "" "For MFC commits, for example a vendor import, you would need to specify one " -"parent for cherry-pick purposes. Normally, that would be the \"first parent" -"\" of the branch you are cherry-picking from, so:" +"parent for cherry-pick purposes. Normally, that would be the \"first " +"parent\" of the branch you are cherry-picking from, so:" msgstr "" #. type: delimited block . 4 @@ -3926,8 +3925,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:1867 msgid "" -"(note that gitrepo.freebsd.org will be change to repo.freebsd.org in the " -"future.)" +"(Note that gitrepo.freebsd.org now points to the same addresses as repo." +"freebsd.org.)" msgstr "" #. type: Plain text @@ -4809,8 +4808,8 @@ msgid "" "Make whatever modifications you wish in your branch. Build, test, and once " "you're ready to collaborate with others it's time to push your changes into " "your hosted branch. Before you can push you'll have to set the appropriate " -"upstream, as Git will tell you the first time you try to push to your +github" -"+ remote:" +"upstream, as Git will tell you the first time you try to push to your " +"+github+ remote:" msgstr "" #. type: delimited block . 4 @@ -5243,8 +5242,9 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:2512 msgid "" -"See <> to generate or set a Kerberos for use with other " -"FreeBSD services like the bug tracking database." +"See <> to generate or set a Kerberos account for use with " +"other FreeBSD services like the link:https://bugs.freebsd.org/bugzilla/[bug-" +"tracking database] (you get a bug-tracking account as part of that step)." msgstr "" #. type: Plain text @@ -5253,36 +5253,37 @@ msgid "Optional: Enable Wiki Account" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2515 +#: documentation/content/en/articles/committers-guide/_index.adoc:2517 msgid "" -"https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows " -"sharing projects and ideas. Those who do not yet have an account can follow " -"instructions on the https://wiki.freebsd.org/AboutWiki[AboutWiki Page] to " -"obtain one. Contact mailto:wiki-admin@FreeBSD.org[wiki-admin@FreeBSD.org] if " -"you need help with your Wiki account." +"link:https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows " +"sharing projects and ideas. Those who do not yet have an account can follow " +"instructions on the link:https://wiki.freebsd.org/Wiki/About[Wiki/About " +"page] to obtain one. Contact mailto:wiki-admin@FreeBSD.org[wiki-" +"admin@FreeBSD.org] if you need help with your Wiki account." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2516 +#: documentation/content/en/articles/committers-guide/_index.adoc:2518 msgid "Optional: Update Wiki Information" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2518 +#: documentation/content/en/articles/committers-guide/_index.adoc:2520 msgid "" "Wiki Information - After gaining access to the wiki, some people add entries " "to the https://wiki.freebsd.org/HowWeGotHere[How We Got Here], https://wiki." -"freebsd.org/IRC/Nicknames[IRC Nicks], and https://wiki.freebsd.org/Community/" -"Dogs[Dogs of FreeBSD] pages." +"freebsd.org/IRC/Nicknames[IRC Nicks], https://wiki.freebsd.org/Community/" +"Dogs[Dogs of FreeBSD], and or https://wiki.freebsd.org/Community/Cats[Cats " +"of FreeBSD] pages." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2519 +#: documentation/content/en/articles/committers-guide/_index.adoc:2521 msgid "Optional: Update Ports with Personal Information" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2521 +#: documentation/content/en/articles/committers-guide/_index.adoc:2523 msgid "" "[.filename]#ports/astro/xearth/files/freebsd.committers.markers# and [." "filename]#src/usr.bin/calendar/calendars/calendar.freebsd# - Some people add " @@ -5291,12 +5292,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2522 +#: documentation/content/en/articles/committers-guide/_index.adoc:2524 msgid "Optional: Prevent Duplicate Mailings" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2524 +#: documentation/content/en/articles/committers-guide/_index.adoc:2526 msgid "" "Subscribers to {dev-commits-doc-all}, {dev-commits-ports-all} or {dev-" "commits-src-all} might wish to unsubscribe to avoid receiving duplicate " @@ -5304,13 +5305,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2527 +#: documentation/content/en/articles/committers-guide/_index.adoc:2529 #, no-wrap msgid "For Everyone" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2533 +#: documentation/content/en/articles/committers-guide/_index.adoc:2535 msgid "" "Introduce yourself to the other developers, otherwise no one will have any " "idea who you are or what you are working on. The introduction need not be a " @@ -5320,7 +5321,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2534 +#: documentation/content/en/articles/committers-guide/_index.adoc:2536 msgid "" "Log into `freefall.FreeBSD.org` and create a [.filename]#/var/forward/user# " "(where _user_ is your username) file containing the e-mail address where you " @@ -5333,14 +5334,14 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2538 +#: documentation/content/en/articles/committers-guide/_index.adoc:2540 msgid "" "If your e-mail system uses SPF with strict rules, you should exclude `mx2." "FreeBSD.org` from SPF checks." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2541 +#: documentation/content/en/articles/committers-guide/_index.adoc:2543 msgid "" "Due to the severe load dealing with SPAM places on the central mail servers " "that do the mailing list processing, the front-end server does do some basic " @@ -5352,7 +5353,7 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2545 +#: documentation/content/en/articles/committers-guide/_index.adoc:2547 msgid "" "Those who are developers but not committers will not be subscribed to the " "committers or developers mailing lists. The subscriptions are derived from " @@ -5360,35 +5361,35 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:2549 +#: documentation/content/en/articles/committers-guide/_index.adoc:2551 #, no-wrap msgid "SMTP Access Setup" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2552 +#: documentation/content/en/articles/committers-guide/_index.adoc:2554 msgid "" "For those willing to send e-mail messages through the FreeBSD.org " "infrastructure, follow the instructions below:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2556 +#: documentation/content/en/articles/committers-guide/_index.adoc:2558 msgid "Point your mail client at `smtp.FreeBSD.org:587`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2557 +#: documentation/content/en/articles/committers-guide/_index.adoc:2559 msgid "Enable STARTTLS." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2558 +#: documentation/content/en/articles/committers-guide/_index.adoc:2560 msgid "Ensure your `From:` address is set to `_yourusername_@FreeBSD.org`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2559 +#: documentation/content/en/articles/committers-guide/_index.adoc:2561 msgid "" "For authentication, you can use your FreeBSD Kerberos username and password " "(see <>). The `_yourusername_/mail` principal is preferred, " @@ -5396,57 +5397,57 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2563 +#: documentation/content/en/articles/committers-guide/_index.adoc:2565 msgid "Do not include `@FreeBSD.org` when entering in your username." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2565 +#: documentation/content/en/articles/committers-guide/_index.adoc:2567 #, no-wrap msgid "Additional Notes" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2569 +#: documentation/content/en/articles/committers-guide/_index.adoc:2571 msgid "" "Will only accept mail from `_yourusername_@FreeBSD.org`. If you are " "authenticated as one user, you are not permitted to send mail from another." msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2570 +#: documentation/content/en/articles/committers-guide/_index.adoc:2572 msgid "" "A header will be appended with the SASL username: (`Authenticated sender: " "_username_`)." msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2571 +#: documentation/content/en/articles/committers-guide/_index.adoc:2573 msgid "" "Host has various rate limits in place to cut down on brute force attempts." msgstr "" #. type: Title ===== -#: documentation/content/en/articles/committers-guide/_index.adoc:2575 +#: documentation/content/en/articles/committers-guide/_index.adoc:2577 #, no-wrap msgid "Using a Local MTA to Forward Emails to the FreeBSD.org SMTP Service" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2578 +#: documentation/content/en/articles/committers-guide/_index.adoc:2580 msgid "" "It is also possible to use a local MTA to forward locally sent emails to the " "FreeBSD.org SMTP servers." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2580 +#: documentation/content/en/articles/committers-guide/_index.adoc:2582 #, no-wrap msgid "Using Postfix" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2585 +#: documentation/content/en/articles/committers-guide/_index.adoc:2587 msgid "" "To tell a local Postfix instance that anything from `_yourusername_@FreeBSD." "org` should be forwarded to the FreeBSD.org servers, add this to your [." @@ -5454,7 +5455,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2593 +#: documentation/content/en/articles/committers-guide/_index.adoc:2595 #, no-wrap msgid "" "sender_dependent_relayhost_maps = hash:/usr/local/etc/postfix/relayhost_maps\n" @@ -5465,33 +5466,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2596 +#: documentation/content/en/articles/committers-guide/_index.adoc:2598 msgid "" "Create [.filename]#/usr/local/etc/postfix/relayhost_maps# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2600 +#: documentation/content/en/articles/committers-guide/_index.adoc:2602 #, no-wrap msgid "yourusername@FreeBSD.org [smtp.freebsd.org]:587\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2603 +#: documentation/content/en/articles/committers-guide/_index.adoc:2605 msgid "" "Create [.filename]#/usr/local/etc/postfix/sasl_passwd# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2607 +#: documentation/content/en/articles/committers-guide/_index.adoc:2609 #, no-wrap msgid "[smtp.freebsd.org]:587 yourusername:yourpassword\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2610 +#: documentation/content/en/articles/committers-guide/_index.adoc:2612 msgid "" "If the email server is used by other people, you may want to prevent them " "from sending e-mails from your address. To achieve this, add this to your [." @@ -5499,7 +5500,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2615 +#: documentation/content/en/articles/committers-guide/_index.adoc:2617 #, no-wrap msgid "" "smtpd_sender_login_maps = hash:/usr/local/etc/postfix/sender_login_maps\n" @@ -5507,33 +5508,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2618 +#: documentation/content/en/articles/committers-guide/_index.adoc:2620 msgid "" "Create [.filename]#/usr/local/etc/postfix/sender_login_maps# with the " "following content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2622 +#: documentation/content/en/articles/committers-guide/_index.adoc:2624 #, no-wrap msgid "yourusername@FreeBSD.org yourlocalusername\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2625 +#: documentation/content/en/articles/committers-guide/_index.adoc:2627 msgid "" "Where _yourlocalusername_ is the SASL username used to connect to the local " "instance of Postfix." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2628 +#: documentation/content/en/articles/committers-guide/_index.adoc:2630 #, no-wrap msgid "Using OpenSMTPD" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2633 +#: documentation/content/en/articles/committers-guide/_index.adoc:2635 msgid "" "To tell a local OpenSMTPD instance that anything from " "`_yourusername_@FreeBSD.org` should be forwarded to the FreeBSD.org servers, " @@ -5541,7 +5542,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2638 +#: documentation/content/en/articles/committers-guide/_index.adoc:2640 #, no-wrap msgid "" "action \"freebsd\" relay host smtp+tls://freebsd@smtp.freebsd.org:587 auth \n" @@ -5549,32 +5550,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2641 +#: documentation/content/en/articles/committers-guide/_index.adoc:2643 msgid "" "Where _yourlocalusername_ is the SASL username used to connect to the local " "instance of OpenSMTPD." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2643 +#: documentation/content/en/articles/committers-guide/_index.adoc:2645 msgid "" "Create [.filename]#/usr/local/etc/mail/secrets# with the following content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2647 +#: documentation/content/en/articles/committers-guide/_index.adoc:2649 #, no-wrap msgid "freebsd\tyourusername:yourpassword\n" msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2651 +#: documentation/content/en/articles/committers-guide/_index.adoc:2653 #, no-wrap msgid "Using Exim" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2657 +#: documentation/content/en/articles/committers-guide/_index.adoc:2659 #, no-wrap msgid "" "To direct a local Exim instance to forward all mail from `_example_@FreeBSD.org`\n" @@ -5582,7 +5583,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2666 +#: documentation/content/en/articles/committers-guide/_index.adoc:2668 #, no-wrap msgid "" "Routers section: (at the top of the list):\n" @@ -5594,7 +5595,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2678 +#: documentation/content/en/articles/committers-guide/_index.adoc:2680 #, no-wrap msgid "" "Transport Section:\n" @@ -5611,7 +5612,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2684 +#: documentation/content/en/articles/committers-guide/_index.adoc:2686 #, no-wrap msgid "" "Authenticators:\n" @@ -5622,26 +5623,26 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2687 +#: documentation/content/en/articles/committers-guide/_index.adoc:2689 msgid "" "Create [.filename]#/usr/local/etc/exim/freebsd_send# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2691 +#: documentation/content/en/articles/committers-guide/_index.adoc:2693 #, no-wrap msgid "example@freebsd.org:smtp.freebsd.org::587\n" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2696 +#: documentation/content/en/articles/committers-guide/_index.adoc:2698 #, no-wrap msgid "Mentors" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2701 +#: documentation/content/en/articles/committers-guide/_index.adoc:2703 msgid "" "All new developers have a mentor assigned to them for the first few months. " "A mentor is responsible for teaching the mentee the rules and conventions of " @@ -5651,7 +5652,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2704 +#: documentation/content/en/articles/committers-guide/_index.adoc:2706 msgid "" "For committers: do not commit anything without first getting mentor " "approval. Document that approval with an `Approved by:` line in the commit " @@ -5659,7 +5660,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2708 +#: documentation/content/en/articles/committers-guide/_index.adoc:2710 msgid "" "When the mentor decides that a mentee has learned the ropes and is ready to " "commit on their own, the mentor announces it with a commit to [." @@ -5669,13 +5670,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2710 +#: documentation/content/en/articles/committers-guide/_index.adoc:2712 #, no-wrap msgid "Pre-Commit Review" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2715 +#: documentation/content/en/articles/committers-guide/_index.adoc:2717 msgid "" "Code review is one way to increase the quality of software. The following " "guidelines apply to commits to the `head` (-CURRENT) branch of the `src` " @@ -5685,28 +5686,28 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2717 +#: documentation/content/en/articles/committers-guide/_index.adoc:2719 msgid "" "All non-trivial changes should be reviewed before they are committed to the " "repository." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2718 +#: documentation/content/en/articles/committers-guide/_index.adoc:2720 msgid "" "Reviews may be conducted by email, in Bugzilla, in Phabricator, or by " "another mechanism. Where possible, reviews should be public." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2719 +#: documentation/content/en/articles/committers-guide/_index.adoc:2721 msgid "" "The developer responsible for a code change is also responsible for making " "all necessary review-related changes." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2720 +#: documentation/content/en/articles/committers-guide/_index.adoc:2722 msgid "" "Code review can be an iterative process, which continues until the patch is " "ready to be committed. Specifically, once a patch is sent out for review, it " @@ -5716,12 +5717,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2721 +#: documentation/content/en/articles/committers-guide/_index.adoc:2723 msgid "Timeouts are not a substitute for review." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2723 +#: documentation/content/en/articles/committers-guide/_index.adoc:2725 msgid "" "Sometimes code reviews will take longer than you would hope for, especially " "for larger features. Accepted ways to speed up review times for your patches " @@ -5729,14 +5730,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2725 +#: documentation/content/en/articles/committers-guide/_index.adoc:2727 msgid "" "Review other people's patches. If you help out, everybody will be more " "willing to do the same for you; goodwill is our currency." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2726 +#: documentation/content/en/articles/committers-guide/_index.adoc:2728 msgid "" "Ping the patch. If it is urgent, provide reasons why it is important to you " "to get this patch landed and ping it every couple of days. If it is not " @@ -5745,14 +5746,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2727 +#: documentation/content/en/articles/committers-guide/_index.adoc:2729 msgid "" "Ask for help on mailing lists, IRC, etc. Others may be able to either help " "you directly, or suggest a reviewer." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2728 +#: documentation/content/en/articles/committers-guide/_index.adoc:2730 msgid "" "Split your patch into multiple smaller patches that build on each other. The " "smaller your patch, the higher the probability that somebody will take a " @@ -5760,7 +5761,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2730 +#: documentation/content/en/articles/committers-guide/_index.adoc:2732 msgid "" "When making large changes, it is helpful to keep this in mind from the " "beginning of the effort as breaking large changes into smaller ones is often " @@ -5768,7 +5769,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2735 +#: documentation/content/en/articles/committers-guide/_index.adoc:2737 msgid "" "Developers should participate in code reviews as both reviewers and " "reviewees. If someone is kind enough to review your code, you should return " @@ -5779,7 +5780,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2738 +#: documentation/content/en/articles/committers-guide/_index.adoc:2740 msgid "" "In some cases, no subject-matter expert may be available. In those cases, a " "review by an experienced developer is sufficient when coupled with " @@ -5787,26 +5788,26 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2740 +#: documentation/content/en/articles/committers-guide/_index.adoc:2742 #, no-wrap msgid "Commit Log Messages" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2743 +#: documentation/content/en/articles/committers-guide/_index.adoc:2745 msgid "" "This section contains some suggestions and traditions for how commit logs " "are formatted." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2744 +#: documentation/content/en/articles/committers-guide/_index.adoc:2746 #, no-wrap msgid "Why are commit messages important?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2748 +#: documentation/content/en/articles/committers-guide/_index.adoc:2750 msgid "" "When you commit a change in Git, Subversion, or another version control " "system (VCS), you're prompted to write some text describing the commit -- a " @@ -5816,7 +5817,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2751 +#: documentation/content/en/articles/committers-guide/_index.adoc:2753 msgid "" "Most projects have more than one developer and last for some length of " "time. Commit messages are a very important method of communicating with " @@ -5824,7 +5825,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2754 +#: documentation/content/en/articles/committers-guide/_index.adoc:2756 msgid "" "FreeBSD has hundreds of active developers and hundreds of thousands of " "commits spanning decades of history. Over that time the developer community " @@ -5833,17 +5834,17 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2756 +#: documentation/content/en/articles/committers-guide/_index.adoc:2758 msgid "Commit messages serve at least three purposes:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2758 +#: documentation/content/en/articles/committers-guide/_index.adoc:2760 msgid "Communicating with other developers" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2763 +#: documentation/content/en/articles/committers-guide/_index.adoc:2765 msgid "" "FreeBSD commits generate email to various mailing lists. These include the " "commit message along with a copy of the patch itself. Commit messages are " @@ -5855,12 +5856,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2765 +#: documentation/content/en/articles/committers-guide/_index.adoc:2767 msgid "Making Changes Discoverable" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2769 +#: documentation/content/en/articles/committers-guide/_index.adoc:2771 msgid "" "In a large project with a long history it may be difficult to find changes " "of interest when investigating an issue or change in behaviour. Verbose, " @@ -5869,12 +5870,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2771 +#: documentation/content/en/articles/committers-guide/_index.adoc:2773 msgid "Providing historical documentation" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2775 +#: documentation/content/en/articles/committers-guide/_index.adoc:2777 msgid "" "Commit messages serve to document changes for future developers, perhaps " "years or decades later. This future developer may even be you, the original " @@ -5883,27 +5884,27 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2777 +#: documentation/content/en/articles/committers-guide/_index.adoc:2779 msgid "" "The `git blame` command annotates each line of a source file with the change " "(hash and subject line) that brought it in." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2779 +#: documentation/content/en/articles/committers-guide/_index.adoc:2781 msgid "" "Having established the importance, here are elements of a good FreeBSD " "commit message:" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2780 +#: documentation/content/en/articles/committers-guide/_index.adoc:2782 #, no-wrap msgid "Start with a subject line" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2784 +#: documentation/content/en/articles/committers-guide/_index.adoc:2786 msgid "" "Commit messages should start with a single-line subject that briefly " "summarizes the change. The subject should, by itself, allow the reader to " @@ -5911,13 +5912,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2785 +#: documentation/content/en/articles/committers-guide/_index.adoc:2787 #, no-wrap msgid "Keep subject lines short" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2790 +#: documentation/content/en/articles/committers-guide/_index.adoc:2792 msgid "" "The subject line should be as short as possible while still retaining the " "required information. This is to make browsing Git log more efficient, and " @@ -5927,86 +5928,86 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2791 +#: documentation/content/en/articles/committers-guide/_index.adoc:2793 #, no-wrap msgid "Prefix the subject line with a component, if applicable" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2794 +#: documentation/content/en/articles/committers-guide/_index.adoc:2796 msgid "" "If the change relates to a specific component the subject line may be " "prefixed with that component name and a colon (:)." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2796 +#: documentation/content/en/articles/committers-guide/_index.adoc:2798 msgid "✓ `foo: Add -k option to keep temporary data`" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2798 +#: documentation/content/en/articles/committers-guide/_index.adoc:2800 msgid "" "Include the prefix in the 63-character limit suggested above, so that `git " *** 86065 LINES SKIPPED ***