| Summary: | Ebuild request app-doc/opengl-manpages | ||
|---|---|---|---|
| Product: | Gentoo Linux | Reporter: | Samuel Bauer <samuel.bauer> |
| Component: | New packages | Assignee: | Default Assignee for New Packages <maintainer-wanted> |
| Status: | CONFIRMED --- | ||
| Severity: | normal | CC: | dschridde+gentoobugs, moreilcon |
| Priority: | High | ||
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | Linux | ||
| URL: | http://www.opengl.org/wiki/Getting_started/XML_Toolchain_and_Man_Pages | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
| Attachments: |
opengl manpages from khronos CVS
opengl manpages from khronos CVS metadata file for opengl-manpages opengl-manpages with html ouptut support Ressource to fix the author for groff output opengl-manpages-4.9999.ebuild opengl-manpages-4.9999.ebuild also includes manvol fix opengl-manpages-4.9999.ebuild |
||
|
Description
Samuel Bauer
2010-12-29 16:51:32 UTC
Created attachment 258372 [details]
opengl manpages from khronos CVS
If all flags unset then this ebuild installs nothing.
Missing pdf output format
Created attachment 258396 [details]
opengl manpages from khronos CVS
Created attachment 258398 [details]
metadata file for opengl-manpages
As suggested in the metadata.xml attachement, I can maintain this package. Anyway when I'll see how to generate pdf output I'll add support for this in the ebuild and enrich the opengl wiki related page. But this ebuild depends on two ebuild not in the portage tree yet. app-text/docbook-mathml-dtd, I submitted this one but don't feel like I can maintain it as my knowledge for docbook is quite null. app-text/mathml-xml-dtd which was submitted by another dude but is not having maintainer. Those ebuild can be found here yet: http://bugs.gentoo.org/show_bug.cgi?id=194501 http://bugs.gentoo.org/show_bug.cgi?id=349033 So I don't know how to become maintainer of an ebuild whose have unmaintained dependencies. Also this ebuild was previously proposed from SGI manpages, which are unmaintained http://bugs.gentoo.org/show_bug.cgi?id=120375 They suggest in this bug to make an ebuild with the khronos ( opengl.org ) CVS server. This bug was closed and none reply when I submitted a fix, this why I opened a new bug. P.S.: .s/ebuild/web browser/ Lot of user like to have the man-pages from the command line rather than in one ebuild. :) Created attachment 271489 [details]
opengl-manpages with html ouptut support
Created attachment 271491 [details]
Ressource to fix the author for groff output
I fully support this request. Would it be possible to proxy maintain it? Otherwise: Whiteboard+=sunrise-suggested (In reply to comment #8) > I fully support this request. Would it be possible to proxy maintain it? It would be possible, as the documentation is a CVS repository, proxy maintain it shouldn't be that much work. But for the dependencies (mathml-xml-dtd, docbook-mathml-dtd), I dare not to be. I'm not a docbook specialist nor than a mathml specification afficionados. To avoid dependencies, I can try to maintain a snapshot of my "locally generated documentation". I think if I ask the repository admin to mail me whenever there is a commit, it won't be to much pain for him. (In reply to comment #8) > Otherwise: Whiteboard+=sunrise-suggested I already tried to commit this ebuild on sunrise but for some obscure reasons (as far as I remember) the XML team refused the mathml-xml-dtd and docbook-mathml-dtd ebuilds. Those ebuild are dependencies for the former one. All those ebuild have already been reviewed on the sunrise irc channel, so they are supposed to be "standard". Created attachment 285015 [details] opengl-manpages-4.9999.ebuild Attached ebuild builds the OpenGL 2,3,4 manpages (name it opengl-manpages-{2,3,4}.9999.ebuild to build the respective versions). It depends on https://bugs.gentoo.org/attachment.cgi?id=271491 (files/fix-author-manual.xsl) and attachment #258398 [details] (metadata.xml). This ebuild presents a minor improvement over the previously attached ebuilds: * It can build docs for OpenGL 2,3,4 * It moves the fix using "fix-author-manual.xsl" into src_prepare, since it seems more like a sed than regular building * Makes repoman happy * Apart from that there are only some minor string changes and removal of some unimportant/obvious messages Comments and improvements welcome. When you do something more it would be nice to edit the khronos wiki. When doing this all the user will have an easy access to documentation. http://www.opengl.org/wiki/Getting_started/XML_Toolchain_and_Man_Pages The section to edit is: "Output manual pages to man format" (even the section title is weird, it would better be: output to groff format) Created attachment 285237 [details]
opengl-manpages-4.9999.ebuild
The previously attached ebuild had a bug where the check for major_version=2 was wrong, resulting in a broken ESVN_REPO_URI for this version.
Created attachment 286563 [details]
also includes manvol fix
due `doman` limitations manual pages installed into /usr/share/man/man3,
on contrary, internal man references use man3G prefix (see for example glUniform4i)
attached xslt includes `<manvolnum>3G</manvolnum>` to `<manvolnum>3</manvolnum>` substitution
Created attachment 286565 [details]
opengl-manpages-4.9999.ebuild
updated ebuild version
Initial major version checking is now unuseful as svn directory for opengl2 manpages is now: https://cvs.khronos.org/svn/repos/ogl/trunk/ecosystem/public/sdk/docs/man2/ GLSL manpages could be compiled using the current ebuild. But there's some other fixes to apply. To insure different version of the glManpages maybe could we pretend gl3 and gl4 for version 3 and 4 (Else ebuilds should be mutually exclusive). |