Man pages: español vs inglés

Estaba revisando la manpage de un comando buscando unas opciones, concretamente la opción -b del comando ping con la idea de hacer un ping a la dirección de broadcast, y ver si me muestra todas las máquinas de la red en el archivo /proc/net/arp junto con su IP y MAC.

Como buen castellano, tengo instalado los paquetes manpages-es y manpages-es-extra para ver por defecto estas en español, pero cual es mi sorpresa al ver que en la página man de pin en español no aparece esta opción. Sin embargo, tras revisar la página man en inglés del comando ping si aparece…

La diferencia está en que la página man en inglés tiene fecha del 9 de Diciembre del 2007, y por el contrario, la traducción de la manpage al español es de la página de 30 de Agosto de 1996, y ha llovido mucho desde entonces.

Sigo pensando que las páginas man son necesarias, y que el proyecto PAMELI de traducción de páginas man es algo vital para el desarrollo y promoción del Software Libre. De hecho, algunos de los libros tan importantes como es Linux un a Nutshell de O’Really, incorpora un listado con todas las páginas man de los distintos comandos, o al menos los más importantes.

Personalmente llevo un tiempo revisando las distintas posibilidades que encuentro para traducir las páginas man al castellano de la forma más sencilla posible y a día de hoy tengo pendiente hacer una prueba, pero por falta de tiempo y recursos aún no me he puesto con ello. Si hay alguien interesado que me quiera echar una mano, que se ponga en contacto conmigo y le comento las diferentes posibilidades que barajo.

eXe – eLearning XHTML editor

Un par de presentaciones sacadas de slideshare acerca de este editor XHTML para contenidos eLearning el cual aún no tengo el gusto de conocer.

Open Access Repositories

Me he encontrado con el proyecto OARiNZ, que al parecer se encarga de diseñar y construir la infraestructura necesaria para conectar todos los repositorios digitales de investigación de Nueva Zelanda que cumplan con las normas de interoperabilidad y acceso bajo el lema de “Open Access Repositories in New Zealand” que además han publicado interesante documentación técnica sobre los principales sistemas de código abierto para crear repositorios digitales.

A continuación dejo una serie de enlaces tanto al proyecto en Eduforge como a la web principal del proyecto, así como a una entrada en un blog que me ha parecido interesante sobre todo por los comentarios que en él se dan lugar. Además en este último dan una referencia a un framework para evaluar software open source que también me gustaría tener en cuenta en posteriores ocasiones (OpenBRR)

[eduforge.org] ~$ Research Repositories in New Zealand

[oarinz.ac.nz] ~$ Open Access Repositories in New Zealand

[weblogs.madrimasd.org] ~$ Software de código abierto para repositorios digitales

Reutilizando contenidos libres

Estaba revisando el procedimiento a seguir para publicar imágenes en la Wikipedia, y me he encontrado un “mapa conceptual” acercar de la reutilización de contenidos fuera de la red Wikimedia bastante aclaratorio, que además podemos aplicar a otros ámbitos.

El gráfico en cuestión se encuentra bajo la licencia GFDL, por lo que podemos utilizarlo tal y como explica este ;o). En las referencias se puede encontrar las fuentes en formato svg.

Referencias:

[es.wikipedia.org] ~$ Ayuda:Imágenes

[commons.wikimedia.org] ~$ Reusing content outside Wikimedia

MySQL, el SGBD libre con documentación propietaria

MySQL es un SGBD relacional, multihilo y multiusuario, y desde mi punto de vista, uno de los grandes pilares del Software Libre y de la Web 2.0, ya que muchas aplicaciones, servicios y plataformas web utilizan este motor de bases de datos para su funcionamiento.

Como supongo que muchos ya saben, MySQL se encuentra disponible bajo una doble licencia: GPL  y Comercial, estando esta última destinada a empresas que quieran utilizarlo en sus desarrollos sin la necesidad de liberar sus trabajos para las redes víricas de la MySQL.

Pero este no es el único modelo de negocio de MySQL sino que, como es lógico, cuentan con un programa de certificación muy goloso para aquellos administradores de sistemas que deseen certificar sus conocimientos en esta base de datos.Además supongo que contarán con algún programa de partners ya sea para certificación, implantación, consultoría o cualquier otra actividad relacionada con su base de datos.

Lo que no comprendo muy bien es por qué la documentación, aunque puesta a libre disposición a través de Internet e incluso en idioma Español o Castellano, no es libre. Si obtenemos cualquier manual de su página web se incluye en estos la siguiente nota:

“Esta documentación NO se distribuye bajo una licencia GPL. El uso de esta documentación está sujeta a los siguientes términos: Puede Usted crear una copia impresa de esta documentación únicamente para su uso personal. La conversión a otros formatos está permitida siempre y cuando el contenido no se vea alterado ni editado de ninguna manera. No está permitida la publicación ni la distribución de esta documentación bajo ninguna forma ni en ningún medio, excepto si distribuye la documentación en una manera similar a la que utiliza MySQL para difundirla (esto es, electrónicamente para ser bajada con el software) o en un CD-ROM o medio similar, siempre y cuando la documentación se difunda junto con el software en el mismo medio. Para cualquier otra utilización, como por ejemplo cualquier difusión de copias escritas, o el uso de esta documentación, en su totalidad o parcialmente, en otra publicación, se debe obtener una autorización escrita previa por parte de un representante autorizado de MySQL AB. MySQL AB se reserva cualquier derecho y todos los derechos sobre esta documentación, aunque no esté aquí expresamente acordado.”

Ante esta situación yo me pregunto: ¿acaso les perjudicaría la liberación de esta documentación? y ¿sería interesante crear un grupo o proyecto de documentación libre del SGBD MySQL?

CHM (Microsoft Compiled HTML Help)

En la Wikipedia podemos leer:

“Microsoft Compiled HTML Help es un formato privativo de ayuda en línea desarrollado por Microsoft. Se popularizó con Windows 98, y es compatible con Windows XP. En 2002, Microsoft anunció que debido a fallos de seguridad no seguirían usando dicho formato a partir de Windows Vista. El sustituto para la ayuda de Windows que proponen es Microsoft Assistance Markup Language.”

A modo de opinión personal, lo primero que me gustaría aclarar es que no me extraña en absoluto que un producto de Microsoft contenga fallos de seguridad. En segundo lugar, que no entiendo como un formato reconocido como vulnerable por el propio Microsoft en el 2002 se sigue utilizando a día de hoy, aunque también es cierto que prefiero a este antes que “el sucesor”. Y por último, ¿a ver si es posible que el vulnerable es Windows en general y no el formato CHM?… Que yo sepa en GNU/Linux el formato CHM no presenta ninguna vulnerabilidad.

Bueno y una vez expresada mi opinión, vamos a lo que vamos que son utilidades CHM libres.

En principio solo he buscado visores, ya que es lo que necesitaba, pero si me topo con nuevas aplicaciones útiles, como pueden ser generar o convertir desde y para CHM las añadiré.

Para Linux he encontrado tres:

• kcmViewer (KDE)
• GnoCHM (GNOME)
• xchm (wxWidgets)

Por otro lado, anuque no suelo hablar de este SO, me he cruzado con una aplicación GLPL para MAC (¿o debería decir GNU/MAC) llamada Chmox.

Me falta buscar alguna para Symbian, pero ya si eso en otro momento que ahora mismo no tengo mucha intención de leer CHM’s en un Nokia E51 :p Además también sería interesante encontrar alguna aplicación portable y/o multiplataforma que poder llevar en el pendrive o memoria USB junto con el archivo CHM…

Proyectos de documentación y traducción de documentación libre

Desde que empecé a utilizar GNU/Linux me interesé especialmente por los proyectos de documentación y traducción de la documentación libre, como pueden ser howtos, readmes, kernel Linux, man pages, etc. Personalmente creo que la existencia de documentación libre es fundamental para la promoción del software libre, puesto que somos muchos los que llegamos a este mundo sin conocimientos en otros idiomas, y una cosa es saber informática, y otra muy distinta saber idiomas ¿no?.

Creo que deberíamos buscar la forma de poner algunos de estos proyectos en marcha, o por lo menos hablar y debatir las diferentes posibilidades. Algunos de los principales proyectos que considero esenciales son:

• TLDP/LUCAS – servicios editoriales para la documentación libre en español
• PAMELI – traducción al español de las páginas de manual de Linux
• DILE – traducción al español de las páginas INFO de Linux
• NULIES – núcleo Linux en español

Si a alguien le interesa, ya sabe dónde puede encontrarme ;o)

Estructura páginas man

No hay mucha información al respecto, de hecho la única fuente que recuerdo es LinuxFocus.org quien publicó un artículo en Nomviembre de 2003 bajo licencia GNU FDL.

[linuxfocus.org] ~$ Escribiendo páginas de manual

info vs man

La verdad es que estoy bastante confuso…

En diversas fuentes de Internet me encuentro textos que indican que el proyecto info sustituye a las páginas man y que se encuentran más actualizadas que estas últimas, y yo me pregunto ¿qué hay de cierto en estas afirmaciones?

En el día a día, a la hora de buscar información prácticamente solo veo referencias a las manpages, y casi nunca se habla de info.De hecho según tengo entendido para empaquetar una aplicación para una distribución un requisito es que los comandos ejecutables incorporen una página man, pero nunca oí nada de info, ¿esto es cierto?.

A ver si averiguo algo…

Referencias:

[es.wikipedia.org] ~$ Man

[es.wikipedia.org] ~$ Texinfo

Manpages

Man es una herramienta de sistemas Unix que se utiliza para documentar y aprender sobre comandos, archivos, llamadas de sistema, etc, en un sistema operativo tal como GNU/Linux. Actualmente se basa en groff y es el sistema más utilizado para la documentación en sistemas Unix, aunque son pocas las características útiles en comparación con el relativamente reciente comando info, que cuenta con características como enlaces que facilitan la interfaz de usuario, ya que al visitar la documentación relativa a un comando se puede saltar a otra página sin tener que salir y ejecutar nuevamente el programa, que es el caso de man.

Utilización

La mayoría de las aplicaciones aportan documentación de manual accesible desde el mismo comando:

man [comando]

Por ejemplo, para saber todo lo relacionado sobre la aplicación man basta con poner en la consola :

man man

Y se mostrará la información necesaria sobre este. En ocasiones el mismo programa posee diversas secciones de manual, cuando esto ocurre suele mostrar un mensaje indicando la sección, como man(1) y man(7), o exit(1) y exit(3). Para acceder a estas secciones basta con indicarlo de la siguiente forma:

man 3 printf

Secciones

El manual normalmente está dividido en ocho secciones numeradas, organizadas como sigue (en BSD, Unix y Linux):

Sección     Descripción
1     Comandos Generales
2     Llamadas al sistema
3     Biblioteca C de funciones
4     Ficheros especiales (normalmente dispositivos, que se pueden encontrar en /dev) y drivers
5     Formatos de fichero y convenciones
6     Juegos y salvapantallas
7     Miscelánea
8     Comandos de administración del sistema y Demonios

En algunos sistemas están disponibles también las siguientes secciones:

Sección     Descripción
0     Archivos de cabecera de la biblioteca estándar de C
9     Rutinas del Kernel
n     Tcl/Tk
x     X Window System

Fuente: Wikipedia
Licencia: GNU FDL