Bug 288129 – new snapshot of app-doc/opengl-manpages

• Product: Gentoo Linux
• Status: RESOLVED WONTFIX

[Description Oleg Popov 2009-10-07 22:12:54 UTC]

app-doc/opengl-manpages-20001215 is masked for removal because it's outdated. Yesterday I made new snapshot. Maybe it will be better to use it than to remove package completely?

PS Snapshot was made by script and may contain bugs (however, I didn't find any)

Reproducible: Always

[Comment 1 Oleg Popov 2009-10-07 22:14:19 UTC]

Created attachment 206377 [details]
man pages for opengl functiona

[Comment 2 Oleg Popov 2009-10-07 22:15:13 UTC]

Created attachment 206378 [details]
man pages for opengl ARB extensions

[Comment 3 Oleg Popov 2009-10-07 22:16:03 UTC]

Created attachment 206379 [details]
man pages for opengl EXT extensions

[Comment 4 Oleg Popov 2009-10-07 22:16:45 UTC]

Created attachment 206381 [details]
man pages for other opengl extensions

[Comment 5 Rémi Cardona (RETIRED) 2009-10-08 11:20:40 UTC]

Thanks for making snapshots, but I'm pretty sure that we could have made them ourselves had we really wanted to keep the package.

The real reason for the removal is that the build system for the man pages has been _completely_ changed and I don't want to spend time trying to figure it out when the website has all the info one would ever need to write opengl apps.

Sorry, but unless someone write a _proper_ ebuild for the man pages, the package will be removed soon.

Thanks

[Comment 6 Oleg Popov 2009-10-08 11:26:15 UTC]

There aren't xml's to build in my snapshot. There are _manpages_, ready to install without building.

[Comment 7 Pekka Paalanen 2009-10-10 17:08:33 UTC]

(In reply to comment #5)
> The real reason for the removal is that the build system for the man pages has
> been _completely_ changed and I don't want to spend time trying to figure it
> out when the website has all the info one would ever need to write opengl apps.
> 

Writing 'man glDrawElements' in a terminal is a lot more convenient than using a web browser.

> Sorry, but unless someone write a _proper_ ebuild for the man pages, the
> package will be removed soon.

What kind would a "proper" ebuild be? One that downloads the manual sources from SVN, and compiles them into man-pages?

Would such an ebuild be accepted, if the contributor does not want to maintain it after creating it?

[Comment 8 Nick Bowler 2009-11-12 17:21:45 UTC]

(In reply to comment #5)
> The real reason for the removal is that the build system for the man pages has
> been _completely_ changed and I don't want to spend time trying to figure it
> out when the website has all the info one would ever need to write opengl apps.

Why does a different build system for new versions of a package change the situation with the old version?  Websites are pretty bad replacements for man pages.

> Sorry, but unless someone write a _proper_ ebuild for the man pages, the
> package will be removed soon.

Please keep the package.  The existing ebuild works perfectly fine, doesn't it?

The comment from package.mask says "Outdated and useless".  Outdated, maybe -- a package from 2000 is obviously not going to include the latest and greatest OpenGL features.  Useless, no -- the documentation installed by this package is still valid today.  Only when mesa stops supporting old OpenGL functions will this package become useless.