Comunidad Gambas-es

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