如何在 Ubuntu 上获取 OpenGL 手册页（如“man glRotate”）？

Question

在 MacOSX 上，“man glRotate”会显示 glRotate 联机帮助页。

在 ubuntu 上，安装了 manpages-dev 和 manpages-posix-dev 后，“man glRotate”不会显示 glRotate 手册页（尽管我可以构建和编译 gl 应用程序）。

我缺少什么？我该如何设置？

Answer 1

sudo apt-get install opengl-4-man-doc opencl-1.2-man-doc

包含许多手册页，例如：

man glDrawArrays

但不包含 man glRotate。我认为这是因为不包含已弃用的即时 API。

apt-file search glRotate 显示了一些点击，但它们似乎不是“官方的”。

在 Ubuntu 16.04 上测试。

Answer 2

将 Khronos OpenGL-Refpages 存储库 与 来自 PKGBUILD 脚本 ="https://www.archlinux.org/packages/extra/any/opengl-man-pages/" rel="nofollow noreferrer">Arch opengl-man-pages 包。

# $Id$
# Maintainer: AndyRTR <[email protected]>

pkgname=opengl-man-pages
pkgver=20170404
_commit=03552a8094ae3017e0b8b2ad44c602f81c03e848
pkgrel=1
pkgdesc="OpenGL Man Pages"
arch=('any')
url="https://github.com/KhronosGroup/OpenGL-Refpages"
license=('custom')
# OpenGL 4.x (current) API and GLSL pages - libxslt' 'docbook-xsl'
# OpenGL 3.x and older 'w3c-mathml2' 'docbook-mathml'
makedepends=('libxslt' 'docbook-xsl' 'w3c-mathml2' 'docbook-mathml' 'git')
source=(${pkgname}::git+https://github.com/KhronosGroup/OpenGL-Refpages#commit=$_commit
        'LICENSE')
sha256sums=('SKIP'
            'a7b2f6669d7ead91dcaf5a03620cdf9d37c54d83fd1899b4ef84683c7e6d4024')
# gl2.1 = OpenGL 2.1 (including fixed functionality)
# es3   = OpenGL ES 3.x (will always be the latest ES, currently 3.2)
# gl4   = OpenGL 4.x (current) API and GLSL pages
_mandirs=(gl4 es3 gl2.1)

pkgver() {
  date +%Y%m%d
}

build() {
  export WD=`pwd`
  xmlcatalog --create --noout \
    --add public "-//W3C//DTD MathML 2.0//EN" "file:///usr/share/xml/w3c/mathml2/mathml2.dtd" \
    --add public "-//W3C//DTD MathML//EN" "file:///usr/share/xml/w3c/mathml2/mathml2.dtd" \
    --add system "http://www.w3.org/TR/MathML2/dtd/mathml2.dtd" "file:///usr/share/xml/w3c/mathml2/mathml2.dtd" \
    mathml2.cat
  export XML_CATALOG_FILES="$WD/mathml2.cat /etc/xml/catalog"

  for manpages in ${_mandirs[@]}; do
    cd "${srcdir}/${pkgname}/${manpages}"
    for file in gl*.xml; do
      xsltproc --noout --nonet /usr/share/xml/docbook/xsl-stylesheets-*/manpages/docbook.xsl ${file}
    done
  done
}

package() {
  install -d "${pkgdir}/usr/share/man/man3"
  for manpages in ${_mandirs[@]}; do
    cd "${srcdir}/${pkgname}/${manpages}"
    install -m644 *.3G "${pkgdir}/usr/share/man/man3/"
  done
  # license
  install -D -m644 "${srcdir}/LICENSE" "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
}

我必须在我的 Debian Stretch 盒子上安装一些额外的软件包来构建文档：

sudo apt-get install xsltproc docbook-xsl docbook-xsl-ns w3-dtd-mathml docbook-mathml