Bug 260196

Summary: Fix package references for legacy nvidia drivers in FAQ 11.16
Product: Documentation Reporter: Pau Amma <pauamma>
Component: Books & ArticlesAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed Overcome By Events    
Severity: Affects Some People CC: carlavilla, doc, dvl, grahamperrin, grahamperrin
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Pau Amma 2021-12-04 00:29:20 UTC 
"Older drivers are available as package:x11/nvidia-driver-[]" in documentation/content/en/books/faq/_index.adoc, besides lacking a final ".", doesn't link to anything useful.

Perhaps a list of legacy driver port names? Or something like "*" and no link to make it more obvious user intervention is required?

On my trusty 12.2 laptop:
% pkg search nvidia-driver
nvidia-driver-460.67           NVidia graphics card binary drivers for hardware OpenGL rendering
nvidia-driver-304-304.137_8    NVidia graphics card binary drivers for hardware OpenGL rendering
nvidia-driver-340-340.108_2    NVidia graphics card binary drivers for hardware OpenGL rendering
nvidia-driver-390-390.141      NVidia graphics card binary drivers for hardware OpenGL rendering
Comment 2 Pau Amma 2021-12-04 10:23:02 UTC 
(In reply to Graham Perrin from comment #1)
That WFM.
Comment 3 commit-hook freebsd_committer freebsd_triage 2021-12-04 22:59:17 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=f66fca12e527e161095ff5eb56e2c5f5779209c4

commit f66fca12e527e161095ff5eb56e2c5f5779209c4
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2021-12-04 22:57:04 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2021-12-04 22:57:04 +0000

    Fix package references for legacy nvidia drivers in FAQ 11.16

    PR:             260196
    Submitted by:   PauAmma <pauamma@gundo.com>

 documentation/content/en/books/faq/_index.adoc | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
Comment 4 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2021-12-04 23:00:14 UTC 
I added a list with all the legacy drivers.
Btw, the graphics section should be improved in the FAQ and also in the Handbook.

Thanks for this :)
Comment 5 Graham Perrin freebsd_committer freebsd_triage 2021-12-05 03:48:58 UTC 
Thanks, however the three paths are not found in cgit. 

Re: the current edition of <https://docs.freebsd.org/en/books/faq/#x-3d-acceleration> and (for example) its link out to 
<https://cgit.freebsd.org/ports/tree/x11/nvidia-driver-390/pkg-descr>

dvl, please: in the absence of a description under 
<https://cgit.freebsd.org/ports/tree/x11/nvidia-driver-390/>, how do you gain the description that's represented in FreshPorts? 

<https://www.freshports.org/x11/nvidia-driver-390/#description>

(I wondered whether the three legacy NVIDIA drivers are a special case, but I can't find anything directly relevant in GitHub or FreshPorts News.)

TIA
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2021-12-05 03:51:44 UTC 
/me glances at 

MASTERDIR=	${.CURDIR}/../nvidia-driver

<https://cgit.freebsd.org/ports/tree/x11/nvidia-driver-390/Makefile?id=836cc2b180cc77ead7b8a9bc3622a63b34facbd2#n8>
Comment 7 Mark Linimon freebsd_committer freebsd_triage 2021-12-11 15:17:46 UTC 
Re-opened at submitter's request.
Comment 8 Dan Langille freebsd_committer freebsd_triage 2021-12-11 15:34:28 UTC 
(In reply to Graham Perrin from comment #5)


The description for a port is obtained via make -v DESCR

[pkg01 dan ~/ports/head/x11/nvidia-driver-390] % make -V DESCR
/usr/home/dan/ports/head/x11/nvidia-driver-390/../nvidia-driver/pkg-descr


[pkg01 dan ~/ports/head/x11/nvidia-driver-390] % cat /usr/home/dan/ports/head/x11/nvidia-driver-390/../nvidia-driver/pkg-descr
These are the official NVidia binary drivers for hardware OpenGL rendering
in X11, using the GLX extensions.

WWW: https://www.nvidia.com/object/unix.html
Comment 9 Graham Perrin 2023-08-23 16:48:15 UTC 
See also: bug 273313