Bug 260199

Summary:	FAQ references to NVIDIA resources
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Sergio Carlavilla Delgado <carlavilla>
Status:	Closed Not A Bug
Severity:	Affects Many People	CC:	avg, carlavilla, doc
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://cgit.freebsd.org/doc/tree/documentation/content/en/books/faq/_index.adoc?id=989d921f5d4ac8d8b7c831c13b8954ad1901be24#n1902
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=260196
Bug Depends on:
Bug Blocks:	260183

Description Graham Perrin freebsd_committer

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: 

<https://www.nvidia.com/en-gb/drivers/unix/>

> 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. 


Legacy
======

<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 freebsd_committer

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

Comment 2 Graham Perrin freebsd_committer

2022-12-30 11:59:37 UTC

Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …

Comment 3 Sergio Carlavilla Delgado freebsd_committer

2023-02-17 19:14:31 UTC

Since the FAQ is gonna be rewritten, we can close this