FS#57655 - [opengl-man-pages] Does not contain man pages for all versions. Install overwrites existing pages.

Attached to Project: Arch Linux
Opened by Daniel Johnson (Dano) - Monday, 26 February 2018, 23:57 GMT
Last edited by Andreas Radke (AndyRTR) - Friday, 26 July 2019, 19:10 GMT
Task Type Bug Report
Category Packages: Extra
Status Closed
Assigned To Andreas Radke (AndyRTR)
Laurent Carlier (lordheavy)
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 2
Private No

Details

Description: Gl4, es3, and gl2.1 man pages are all generated and placed in the same path. This causes man pages that are generated to overwrite each other. You can't tell which version of documentation you are looking at.

I believe that gl2.1 documentation will overwrite any es3 documentation and es3 will overwrite any gl4 documentation. For example, glGenTextures.3G.gz is generated by all 3 versions, but only the gl2.1 version is left after packaging.


Additional info:
* package version: 20170404-1
* Commit that introduces bug: https://git.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/opengl-man-pages&id=0cfcc10ee1dd3785b57bbd8b318f585c3fc5d787


Steps to reproduce:
* Install the opengl-man-pages package
* View man page for glGenTextures `man glGenTextures`. If gl4 documentation was actually available, then a section called "Version Support" would be available, but bugged... it doesn't properly generate in the man page at the moment. The section would exist with an empty table. Only gl2.1 documentation is available

Proposed Solution:
Break up package for the multiple versions. I submitted a bug for the es3 and gl4 generation and will try to submit a PR for them this week. https://github.com/KhronosGroup/OpenGL-Refpages/issues/34
This task depends upon

Closed by  Andreas Radke (AndyRTR)
Friday, 26 July 2019, 19:10 GMT
Reason for closing:  Fixed
Comment by Andreas Radke (AndyRTR) - Thursday, 25 July 2019, 19:52 GMT
Please check todays update in testing repo. It only includes OpenGL 4.x pages but these won't overwrite OpenGL 2.x and OpenGL ES3 anymore.
If GL2 and ES3 pages would be of interest they could be packages in separate packages but these would conflict each other and againt GL4 pages. I guess they are of less interest.

Pages should now also be properly created. Confirmed with that missing "Version support" table.

Loading...