FS#22119 - [mesa] get gl manpages from source, not from outdated snapshot on ftp.archlinux.org

Attached to Project: Arch Linux
Opened by Thomas Dziedzic (tomd123) - Thursday, 16 December 2010, 16:55 GMT
Last edited by Eric Belanger (Snowman) - Monday, 14 February 2011, 22:31 GMT
Task Type Bug Report
Category Packages: Extra
Status Closed
Assigned To Jan de Groot (JGC)
Andreas Radke (AndyRTR)
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 0
Private No

Details

The current way to include the gl manpages is to add it to mesa even though it's not in the upstream release.
This is my first gripe with the package.

Second, the snapshot we are using was generated on 01/25/2008.
Checking out the latest man pages source shows me that there has been lots of activity since then.
http://www.opengl.org/wiki/Getting_started/XML_Toolchain_and_Man_Pages

Please consider using upstream sources rather then an outdated snapshot.

Also, maybe these man pages deserve their own package, since it really isn't shipped with mesa.
If the man pages would be split from mesa, making them an optdepend would probably be the way to go.
This task depends upon

Closed by  Eric Belanger (Snowman)
Monday, 14 February 2011, 22:31 GMT
Reason for closing:  Fixed
Additional comments about closing:  see last comment.
Comment by Andreas Radke (AndyRTR) - Friday, 17 December 2010, 21:09 GMT
Splitting out the opengl-man-pages to a separate pkg makes sense. But the build isn't straight forward. Please provide a working PKGBUILD. I don't have the time for this right now. You can use my attemp as a base. Maybe we should ship the XHTML doc + usual man-pages in 2 subpackages.
   PKGBUILD (1 KiB)
Comment by Eric Belanger (Snowman) - Friday, 17 December 2010, 22:25 GMT
Wouldn't it be better to just add a package_opengl-man-pages function to the current mesa PKGBUILD instead of creating a new one?
Comment by Jan de Groot (JGC) - Friday, 17 December 2010, 22:52 GMT
Mesa doesn't come with OpenGL documentation, so just like mesa-demos, they're a standalone project and thus need a standalone PKGBUILD.
I don't build all xorg utilities from one PKGBUILD and 50 split package_() functions either, they're all standalone projects.
Comment by Andreas Radke (AndyRTR) - Saturday, 12 February 2011, 23:19 GMT
http://www.opengl.org/wiki/Getting_started/XML_Toolchain_and_Man_Pages - see there for build instructions. please someone with time and interest provide a working PKGBUILD, use my initial PKGBUILD as a base for the code checkout.

   PKGBUILD (1 KiB)
Comment by Eric Belanger (Snowman) - Monday, 14 February 2011, 05:03 GMT
I've attached a working PKGBUILD with fixed versions of 2 makedepends that were in AUR.

BTW, I've added a line in the mksource function to remove the .svn directories for the source tarball. You might want to add it to your mesa PKGBUILD.
(application/x-gzip)    opengl-man-pages_all.tgz (7.1 KiB)
Comment by Andreas Radke (AndyRTR) - Monday, 14 February 2011, 18:39 GMT
Looks good to me. Also the 2 additional makedeps won't pull in any further deps. But I'd like to have the opengl-man-pages packages build separately from mesa. It would be nice if you can do the pkg adding later. I'm currently busy with other stuff but could come back to this in a few days if needed. Thanks for your work.
Comment by Eric Belanger (Snowman) - Monday, 14 February 2011, 18:59 GMT
Sure. I'll add them later today. I'm not sure why you said "But I'd like to have the opengl-man-pages packages build separately from mesa" as the opengl-man-pages PKGBUILD dosn't depend on mesa at all.
Comment by Eric Belanger (Snowman) - Monday, 14 February 2011, 22:31 GMT
opengl-man-pages, docbook-mathml and w3c-mathml2 are now in repos. Please adopt them. I've also modidified mesa (trunk only) so it won't provide the man pages anymore and I've added an optdepends on opengl-man-pages.

Loading...