Bug 260196 - Fix package references for legacy nvidia drivers in FAQ 11.16
Summary: Fix package references for legacy nvidia drivers in FAQ 11.16
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-12-04 00:29 UTC by PauAmma
Modified: 2021-12-11 15:34 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description PauAmma freebsd_triage 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 PauAmma freebsd_triage 2021-12-04 10:23:02 UTC
(In reply to Graham Perrin from comment #1)
That WFM.
Comment 3 commit-hook freebsd_committer 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 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 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 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 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