Re: misc/41528

[Yorick Hardy <yorickhardy%gmail.com@localhost>]

Thanks for the input. Here is a patch which
does not remove that section.

Matthew Mondor wrote:
> On Thu,  4 Jun 2009 06:50:03 +0000 (UTC)
> Yorick Hardy <yorickhardy%gmail.com@localhost> wrote:
>
> >  Matthew Mondor wrote:
> >  > On Wed,  3 Jun 2009 11:15:05 +0000 (UTC)
> >  > Yorick Hardy <yorickhardy%gmail.com@localhost> wrote:
> >  > 
> >  >>  -Section "Module"
> >  >>  -        ...
> >  >>  -        Load  "dri"
> >  >>  -        Load  "GLcore"
> >  >>  -        Load  "glx"
> >  >>  -EndSection
> >  >>  -\&...
> >  >>  -Section "DRI"
> >  >>  -        Group "wheel"
> >  >>  -        Mode 0660
> >  >>  -EndSection
> >  > 
> >  > Are you sure that it's best to remove these as well?
> >  
> >  I am not sure, but it does already appear in /usr/X11R7/lib/X11/doc/README.DRI
> >  (I proposed to add /usr/X11R7/lib/X11/doc/README.DRI under the SEE ALSO 
> > section).
> >  
> >  Should we reproduce this?
>
> On netbsd-5 /usr/X11R7/lib/X11/doc/README.DRI exists, but is much
> longer to read than this manual page; moreover, there is no mention of
> GLcore, and group is "xf86dri" instead of "wheel" (I'm not sure how
> much this matters in practice, however).
>
> I remember was how nice and easy it was for me to get xorg+DRI
> working by checking this man page alone.  Perhaps that it's best to
> both keep this little section as well as a reference to the
> README.DRI?
>
> Thanks,


--
Kind regards,

Yorick Hardy

--- share/man/man4/drm.4.orig   2009-05-12 19:03:47.000000000 +0200
+++ share/man/man4/drm.4        2009-06-05 07:56:59.000000000 +0200
@@ -86,31 +86,31 @@
 .Pa /dev/dri/card*
 device must exist, and DRI must be enabled in the X configuration
 file.
+.Xr X 7
+provided with NetBSD and compiled from
+.Xr pkgsrc 7
+do so automatically where supported.
 .Pp
-Details for these steps:
-.Bl -enum -offset indent
-.It
-X must be compiled with DRI support.
-On i386, this is usually the default.
-.It
-Mesa (see
-.Pa http://www.mesa3d.org/ )
-should be compiled for the netbsd-dri target, patch available at
-.Pa http://issc.uj.ac.za/~yorick/drm/mesa.patch
-.It
-The device node must exist:
+.Xr X 7
+will attempt to create the device node automatically.
+To create the device node manually:
 .Bd -literal -offset indent
 mkdir -p /dev/dri
 mknod /dev/dri/card0 c 180 0
 chgrp wheel /dev/dri/card0
 chmod 0660 /dev/dri/card0
 .Ed
-.It
-Enable DRI in the X configuration (either
+.Pp
+To enable DRI in the X configuration add the following to either
 .Pa xorg.conf
+for
+.Xr Xorg 1
 or
-.Pa XF86Config ) :
-.Bd -literal
+.Pa XF86Config
+for
+.Xr XFree86 1
+:
+.Bd -literal -offset indent
 Section "Module"
         ...
         Load  "dri"
@@ -123,7 +123,6 @@
         Mode 0660
 EndSection
 .Ed
-.El
 .Pp
 Debugging output can be enabled and disabled by setting the
 .Xr sysctl 8
@@ -138,7 +137,12 @@
 etc.
 .Sh SEE ALSO
 .Xr agp 4 ,
-.Xr X 7
+.Xr X 7 ,
+.Xr XFree86 1 ,
+.Xr Xorg 1 ,
+.Xr xorg.conf 5 ,
+.Xr XF86Config 5 ,
+.Xr /usr/X11R[67]/lib/X11/doc/README.DRI
 .Sh HISTORY
 DRM was first available for Linux.
 Subsequently Eric Anholt ported the DRM kernel modules to
@@ -188,17 +192,6 @@
 .An Daryll Strauss ,
 .An Keith Whitwell
 .Sh CAVEATS
-Disable AIGLX if necessary
-.Pq Pa xorg.conf :
-.Bd -literal -offset indent
-Section "ServerFlags"
-        Option  "AIGLX" "off"
-EndSection
-
-Section "Extensions"
-        Option "Composite" "Disable"
-EndSection
-.Ed
 .Pp
 In case of errors,
 .Pa /dev/dri/card0