From nobody Sun Jan 09 05:11:23 2022 X-Original-To: doc@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 5764E193196E for ; Sun, 9 Jan 2022 05:11:23 +0000 (UTC) (envelope-from bugzilla-noreply@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 4JWlRb0ssBz4mDw for ; Sun, 9 Jan 2022 05:11:23 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (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 F27A94512 for ; Sun, 9 Jan 2022 05:11:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 2095BMwE031426 for ; Sun, 9 Jan 2022 05:11:22 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 2095BMVO031425 for doc@FreeBSD.org; Sun, 9 Jan 2022 05:11:22 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 258264] Following handbook on nvidia drivers makes system get stuck on boot. Date: Sun, 09 Jan 2022 05:11:23 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: needs-patch X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: grahamperrin@gmail.com X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1641705083; 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: in-reply-to:in-reply-to:references:references; bh=5d8SFNn2vaGLsW9DQ04MLtWTyiS7uB4sqpx3WS97S0k=; b=U0NLKZv2ZTVxL6QRd8TGXu8PEA7l/HOKC5Btca/m6g9yARc9x2QxBcZkV2ww9vazrIIWe+ rZVyWdsQOfqt/6K2LmKGtOQO6kqLtE0UB4iFf98QB0A9AdVHAQ4kJD+FXtkReKh2MSMLyl GhNChuIspzM7HtcFs/pB1bUNS/8XqOYBZRflaMB5ejaBesQhgN6aI+Z3uTCtCmGg6pj9tK 89r6Hdu89bAxPk6BFmHSgo7VCFRD4fODYPyKJtPA4uniuuIVVduBhjdyMRhaUrFo79VJrs LfOrj/rh9KznCmvUBOQXSw1KUvAIS7qPpj9MSMAwoeoaUeMMWaXRLPNFjF1tLQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1641705083; a=rsa-sha256; cv=none; b=noRhwobeY2fTnJbimYOIFWXHu/JTJjgoEqyiL8HXDOonTuLRfmFRGS9+5w7H4/4HksZmO1 Z+/nC0vWAg9WSHnw7o8t+FVZ/CpyTDc0lDR0MxDNuHNiWrOwNS2jD0f/uRqVu0fp9Op2PE ctOTpS+t2Mp7HJ3RLfMP/ZQXBGi9TpzDgQc6udovNQQcLqZRMg0PzVVU6PDwglaf9ESugg F0cu9e4hNNmGZD9Hf7CjlKS78xWCeE8uvZKtfVK65KHSyCHfSpJeTUvufLk1Fsqbj6x8B4 reQyFOpMv0tNLFFxZKgyU1Hp5K5a/gN2x4yINL9n7mK+srZIdakOD8I5mX9Wpg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D258264 --- Comment #4 from Graham Perrin --- (In reply to Danilo G. Baio from comment #3) A few thoughts.=20 From :=20 > pkg-message must contain only information that is vital to setup and=20 > operation on FreeBSD, and that is unique to the port in question. there's a paragraph across eight lines about linux_enable=3D"YES", which is not unique to any d= river for NVIDIA.=20 Instead, consider a more concise reference to:=20 The installed README (from NVIDIA) is thorough, however more than sixty-two thousand words on a single page is probably a turn-off for a significant proportion of users.=20 Moreover, it's better to have sight of a README prior to installation.=20 Paginated HTML e.g. (for the currently ported version) is more user-friendly.=20 The FreeBSD Handbook might usefully refer to with hints:=20 * to scroll down to the FreeBSD x64 section to find what's=20 closest to the currently ported version * to then find the README under ADDITIONAL INFORMATION; and=20 to _not_ download the driver from NVIDIA's site if the intention is=20 to install the port =E2=80=93 NVIDIA drivers in the FreeBSD ports collection benefit from=20 specialist maintainance. (Words to that effect.) Thanks --=20 You are receiving this mail because: You are the assignee for the bug.=