[Bug 258264] Following handbook on nvidia drivers makes system get stuck on boot.

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=258264

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

A few thoughts. 

From
<https://docs.freebsd.org/en/books/porters-handbook/pkg-files/index.html#porting-message>: 

> pkg-message must contain only information that is vital to setup and 
> 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="YES", which is not unique to any driver
for NVIDIA. 

Instead, consider a more concise reference to: 
<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. 

Moreover, it's better to have sight of a README prior to installation. 

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. 

The FreeBSD Handbook might usefully refer to
<https://www.nvidia.com/en-us/drivers/unix/> with hints: 

* to scroll down to the FreeBSD x64 section to find what's 
  closest to the currently ported version

* to then find the README under ADDITIONAL INFORMATION; and 
  to _not_ download the driver from NVIDIA's site if the intention is 
  to install the port

  – NVIDIA drivers in the FreeBSD ports collection benefit from 
    specialist maintainance.


(Words to that effect.)

Thanks

-- 
You are receiving this mail because:
You are on the CC list for the bug.