From nobody Thu May 04 00:28: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 4QBZRW2zmvz49QqR for ; Thu, 4 May 2023 00:28:23 +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 4QBZRW2Brfz4GrB; Thu, 4 May 2023 00:28:23 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683160103; 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=I4IDGN6woubtmqwvCHy092YnMpOpbEDaq5O+/+NECaQ=; b=wecj4zRmO1KxYL5Ah7R1yb3aPGIsQQtpGOi5hIX9VrIdxNAA4GgjRiub7qmSpHJObfJWHl by+bix7D8doy+ygzYEcOKMc9aQkHNvQqQjCBbNVXOH1+/1hZLXuy6guDNZnM3QC3IJSRuc +ZlmiadyAOwCfTtlR0QmlWOPoQSk+PRMtQ+l4w80X05uf1bnOV8klGHXJ5P0p2ViklpJxt rqVMFOhZ/EzqUwN7YUQhZv/u1NdgA5YjJHc7o6DRLk/Lfkr/yIZkl0f13qDPGszjM48w9g lJw1d5mjOiwD8f8bHm9gJ3UlHIqlO9pW48iHKI6sIAQaztKbS+OQ745pf3Eacw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683160103; 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=I4IDGN6woubtmqwvCHy092YnMpOpbEDaq5O+/+NECaQ=; b=BYGPaOiFbn1x4XqoulB0LMdMmF4xXlzY02MFUPKaky6vR/JfVIeQe3NdnN6qqMh1BTMzAS fvO8ApZR4uHAYv9oe7HcGfETWuSfLKu8YEFoK+t1qLb5E5DgK0kdKqKn/DBUN25g37Uy19 aVON32e/qYLEzLnSz5+h8xs9IK9G9vG2So9f6rh2SaLGP/MSvYCJq0Nglu6ze/pbH8/Jrh EtREtI7xgO5GAXFmqhPEF91OT+bqE+ww09Ae0DVyVVb/YppcKvQkFH1HwFOcvl5uW/TB5g i1GHf0zLuV8ny+Qbhh5mWoLe2dnjHvwAIa4zXm/djyI/yQqEIeDxaWxsIYuAZQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1683160103; a=rsa-sha256; cv=none; b=YHS+Ck/e2TEc1cpJG8i+BCWs7hvKMyvRRh9QGahQfltLXN04e3coqu/58/H/hwGcIGpuGA uBT9RYh8WCdcN120upBapEF0S2IPUYl4yafE5uvqAiptkPhNf4j1Dgab/jbq/aK5eO9As8 JcFpC0sk+Pz8cbHFA2dDyvJxMQHc1EamhzrRWOpBwF1aaJpBRd/rQKKOYoBJ6oM1o9tERY 62zkr26cdZYy+z+slieWqZ6TOuNrXUxNpa489UJV6YlavV1FvcZVrq7UcEg5mVEMepH2PW s2Jx4Gw7ZBuZon9Q27VtAEfTZgG6Yxh9zONf+44Mvbgay3K7lRANqrHQAx6beQ== 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 4QBZRW1J0szqrw; Thu, 4 May 2023 00:28:23 +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 3440SNm9048022; Thu, 4 May 2023 00:28:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 3440SNbo048021; Thu, 4 May 2023 00:28:23 GMT (envelope-from git) Date: Thu, 4 May 2023 00:28:23 GMT Message-Id: <202305040028.3440SNbo048021@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: e63798df73 - main - =?utf-8?Q?FreeBSD=20Handbook:=20Config=E2=80=A6=20and=20Tuning:=20corrections?= 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: e63798df73d7d956d8c3ce3f81225421fdd1db23 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=e63798df73d7d956d8c3ce3f81225421fdd1db23 commit e63798df73d7d956d8c3ce3f81225421fdd1db23 Author: Graham Perrin AuthorDate: 2023-05-04 00:19:20 +0000 Commit: Graham Perrin CommitDate: 2023-05-04 00:19:20 +0000 FreeBSD Handbook: Config… and Tuning: corrections Minor corrections. Names of some mailing lists lacked the 'the' prefix. If referring to an outdated/legacy list archive, without mentioning that it is not current: also, refer to the current archive. One sentence per line should apply to most areas where a question mark is followed by a space. --- .../content/en/books/handbook/config/_index.adoc | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc index de68f3fdc3..f157c3c897 100644 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -672,7 +672,11 @@ For more information, refer to man:hosts[5] and to [.filename]#/usr/share/exampl ==== Troubleshooting When troubleshooting hardware and software configurations, check the simple things first. -Is the network cable plugged in? Are the network services properly configured? Is the firewall configured correctly? Is the NIC supported by FreeBSD? Before sending a bug report, always check the Hardware Notes, update the version of FreeBSD to the latest STABLE version, check the mailing list archives, and search the Internet. +Is the network cable plugged in? +Are the network services properly configured? +Is the firewall configured correctly? +Is the NIC supported by FreeBSD? +Before sending a bug report, always check the Hardware Notes, update the version of FreeBSD to the latest STABLE version, check the mailing list archives, and search the Internet. If the card works, yet performance is poor, read through man:tuning[7]. Also, check the network configuration as incorrect network settings can cause slow connections. @@ -1907,7 +1911,7 @@ acpi_dsdt_name="/boot/DSDT.aml" .... Be sure to copy [.filename]#DSDT.aml# to [.filename]#/boot#, then reboot the system. -If this fixes the problem, send a man:diff[1] of the old and new ASL to {freebsd-acpi} so that developers can work around the buggy behavior in [.filename]#acpica#. +If this fixes the problem, send a man:diff[1] of the old and new ASL to the {freebsd-acpi} so that developers can work around the buggy behavior in [.filename]#acpica#. [[ACPI-submitdebug]] === Getting and Submitting Debugging Info @@ -1941,7 +1945,7 @@ If the required information is triggered by a specific event, such as a suspend Instead, use `sysctl` to specify the layer and level after booting and preparing the system for the specific event. The variables which can be set using `sysctl` are named the same as the tunables in [.filename]#/boot/loader.conf#. -Once the debugging information is gathered, it can be sent to {freebsd-acpi} so that it can be used by the FreeBSD ACPI maintainers to identify the root cause of the problem and to develop a solution. +Once the debugging information is gathered, it can be sent to the {freebsd-acpi} so that it can be used by the FreeBSD ACPI maintainers to identify the root cause of the problem and to develop a solution. [NOTE] ==== @@ -1964,18 +1968,18 @@ When submitting a problem report, include the following information: Substitute the login name for _name_ and manufacturer/model for _system_. For example, use [.filename]#njl-FooCo6000.asl#. -Most FreeBSD developers watch the {freebsd-current}, but one should submit problems to {freebsd-acpi} to be sure it is seen. +Most FreeBSD developers watch the {freebsd-current}, but one should submit problems to the {freebsd-acpi} to be sure it is seen. Be patient when waiting for a response. If the bug is not immediately apparent, submit a bug report. When entering a PR, include the same information as requested above. This helps developers to track the problem and resolve it. -Do not send a PR without emailing {freebsd-acpi} first as it is likely that the problem has been reported before. +Do not send a PR without emailing the {freebsd-acpi} first as it is likely that the problem has been reported before. [[ACPI-References]] === References More information about ACPI may be found in the following locations: -* The FreeBSD ACPI Mailing List Archives (https://lists.freebsd.org/pipermail/freebsd-acpi/[https://lists.freebsd.org/pipermail/freebsd-acpi/]) +* Archives at https://lists.freebsd.org/pipermail/freebsd-acpi/[] and more recent https://lists.freebsd.org/archives/freebsd-acpi/[] * The ACPI 2.0 Specification (http://acpi.info/spec.htm[http://acpi.info/spec.htm]) * man:acpi[4], man:acpi_thermal[4], man:acpidump[8], man:iasl[8], and man:acpidb[8]