Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 09 Jan 2022 05:11:23 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 258264] Following handbook on nvidia drivers makes system get stuck on boot.
Message-ID:  <bug-258264-9-uFnte3u8L1@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-258264-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-258264-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D258264

--- Comment #4 from Graham Perrin <grahamperrin@gmail.com> ---
(In reply to Danilo G. Baio from comment #3)

A few thoughts.=20

From
<https://docs.freebsd.org/en/books/porters-handbook/pkg-files/index.html#po=
rting-message>:=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.

<https://www.freshports.org/x11/nvidia-driver/#message>; 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
<https://docs.freebsd.org/en/books/handbook/linuxemu/#linuxemu-lbc-install>;


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)
<https://http.download.nvidia.com/XFree86/FreeBSD-x86_64/470.86/README/>; is
more user-friendly.=20

The FreeBSD Handbook might usefully refer to
<https://www.nvidia.com/en-us/drivers/unix/>; 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.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-258264-9-uFnte3u8L1>