Buenas!.

Hace cosa unos días instalé la nueva versión del M.A.M.E. Ademas de compilar tanto el programa que tarda lo suyo y las utilidades externas.
Este programa trae un directorio de ayudas y estas también se pueden compilar. Las posibilidades que ofrece el archivo make de este
programa para las ayudas son las siguiente:

Citar:

Please use `make <target>' where <target> is one of
  html       to make standalone HTML files
  dirhtml    to make HTML files named index.html in directories
  singlehtml to make a single large HTML file
  pickle     to make pickle files
  json       to make JSON files
  htmlhelp   to make HTML files and a HTML help project
  qthelp     to make HTML files and a qthelp project
  devhelp    to make HTML files and a Devhelp project
  epub       to make an epub
  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  latexpdf   to make LaTeX files and run them through pdflatex
  text       to make text files
  man        to make manual pages
  texinfo    to make Texinfo files
  info       to make Texinfo files and run them through makeinfo
  gettext    to make PO message catalogs
  changes    to make an overview of all changed/added/deprecated items
  linkcheck  to check all external links for integrity
  doctest    to run all doctests embedded in the documentation (if enabled)

Ademas existe un subdirectorio con las páginas del manual para man de Linux.
Estos archivos tienen una serie de extensiones, ejemplo:

Puede ser un nombre y extensión:

castool.1
mame.6

Al pedir ayuda sobre man,  nos encontramos esto y los relacionamos con las extensiones.

Citar:

 La siguiente tabla muestra los números de sección del manual y los tipos de páginas que contienen.

       1   Programas ejecutables y guiones del intérprete de órdenes
       2   Llamadas del sistema (funciones servidas por el núcleo)
       3   Llamadas de la biblioteca (funciones contenidas en las bibliotecas del sistema)
       4   Ficheros especiales (se encuentran generalmente en /dev)
       5   Formato de ficheros y convenios p.ej. I/etc/passwd
       6   Juegos
       7   Paquetes de macros y convenios p.ej. man(7), groff(7).
       8   Órdenes de admistración del sistema (generalmente solo son para root)
       9   Rutinas del núcleo [No es estándar]
       n   nuevo [obsoleto]
       l   local [obsoleto]
       p   público [obsoleto]
       o   viejo [obsoleto]

Como la aplicación se instala por defecto en: /usr/local/games
En /usr/local podemos encontrar /man
Y ademas podemos encontrar /usr/local/share/man

¿ Diferencias ?, ni idea por ahora.

Lo que hice por defecto fue crear en /usr/local/man, dos directorios: man1 y man6, en estos copie los archivos que corresponden
a las extensiones de cada uno. Así:  castool.1 lo copie al directorio: /usr/local/man/man1

Bien, con eso ya tengo el manual sobre ese comando u otros que haya copiado.
Puedo pedir ayuda sobre el comando de la siguiente forma:



También puedo hacer esto:





Algo que si pude ver. Si intento compilar o crear las páginas manpages:



Me da error.

Citar:

sphinx-build -b man -d build/doctrees   source build/man
make: sphinx-build: No se encontró el programa
Makefile:122: fallo en las instrucciones para el objetivo 'man'
make: *** [man] Error 127

La relación que encontré de sphinx es que es un programa hecho con Python y existe para las dos versiones.
De la versión para Python2:

Citar:

Sphinx is a tool for producing documentation for Python projects, using
reStructuredText as markup language.

Sphinx features:
 * HTML, CHM, LaTeX output,
 * Cross-referencing source code,
 * Automatic indices,
 * Code highlighting, using Pygments,
 * Extensibility. Existing extensions:
   - automatic testing of code snippets,
   - including docstrings from Python modules.

This package includes Python 2 modules and command line utilities.

Sphinx

Creía que era algo propio del sistema Linux.
Si vamos al directorio /usr/share/man y mostramos el /usr/share/man/man1 todos están compilados con gz

Saludos

===================
Gambas Básico
"No es un bug, es una característica no documentada"