Bug 260199 - FAQ references to NVIDIA resources
Summary: FAQ references to NVIDIA resources
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Sergio Carlavilla Delgado
URL: https://cgit.freebsd.org/doc/tree/doc...
Depends on:
Blocks: 260183
  Show dependency treegraph
Reported: 2021-12-04 05:46 UTC by Graham Perrin
Modified: 2021-12-04 11:40 UTC (History)
2 users (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin 2021-12-04 05:46:12 UTC
Under <https://docs.freebsd.org/en/books/faq/#x-3d-acceleration>: 

> … nVidia provides detailed information on which card is supported by which 
> driver on their web site: http://www.nvidia.com/object/IO_32667.html. …

From bug 260183 comment 0: 

> … _not_ the best page to tell which driver is appropriate because the 
> result is legacy-only <https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/>.

Instead, maybe: 


> Unix Drivers | NVIDIA

Not anchorable, but there are sections for: 

* FreeBSD x86

* FreeBSD x64

The latter includes a link to the latest production branch, where (through clicking the version) a SUPPORTED PRODUCTS tab makes things reasonably clear for this branch. 


<https://forums.freebsd.org/posts/524748> reminds me that <https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/> – 

> What's a legacy driver? | NVIDIA

– was somewhat ambiguous, possibly contradictory, when read alongside other NVIDIA resources. Still, this NVIDIA page is probably a useful point of reference. 

Edge cases

<https://lists.freebsd.org/archives/freebsd-hackers/2021-December/000582.html> for example, Andriy Gapon wrote: 

> Apparently not all GT 730 cards are made equal. …

Without attempting to detail any case, maybe the FAQ (or better the Handbook) should simply: 

* acknowledge that edge cases exist

    "NVIDIA's pages are not entirely authoritiative"
    or words to that effect

* steer to <https://www.freebsd.org/support/> in case of trouble.
Comment 1 Graham Perrin 2021-12-04 06:03:17 UTC
(In reply to Graham Perrin from comment #0)

> … a SUPPORTED PRODUCTS tab makes things reasonably clear …

It should be pointed out that the adjacent DOWNLOAD button is not appropriate if, as is likely, the reader intends to use the FreeBSD-maintained port. 


Side note (not for the FAQ): <https://forums.freebsd.org/posts/545002> mentions NVIDIA's installer making inappropriate changes to /boot/loader.conf