¿Cómo se construirá la ayuda del man?, me pregunté en más de una oportunidad, hasta que un buen día, Maikel Pernía Matos me explicó que ello se verifica con el empleo de una plantilla y que al pasarle los valores adecuados obtenemos el resultado que vemos al teclear en una consola «man nombre_del_comando_o_aplicación».
Ahora bien, no todo el mundo conoce la susodicha plantilla y si de compartir, ayudar y socializar se trata, mi amigo y autor de «man-editor» se dispuso a crear un editor que le ayudará gráficamente a crear las páginas del «man» o de ayuda a sus programas.
Cuando Ud. da clic sobre el ícono de «man-editor» o teclea en consola «maneditor» (junto y sin comillas), esta es la pantalla que verá:
¿Qué pasos seguir a partir de aquí? Muy fácil, sustituir los corchetes y el texto dentro de estos por lo vinculado con su aplicación. Como puede apreciarse, podemos emplear una interfaz en castellano; empero, me advierte su autor que aún no ha podido lograr verter adecuadamente los encabezados y el contenido al español porque los acentos, las diéresis y las ñildes no se muestran como deberían en nuestra lengua.
Después de sustituidos los acápites que creamos necesario, guardamos el fichero (usa la extensión «.pod») para -si es preciso-, volver a editarlo y finalmente damos clic sobre el ícono «Construir». En nuestro caso, hemos creado la página del «man» de un programa llamado «Ejemplo» y en consola, al teclear «man /home/delio/Ejemplo.1» -dirección en la cual se guardó la página del man-, esto es lo que se nos muestra:
Un detalle final. Si el nombre de nuestro programa tiene más de ocho caracteres, entonces será truncado.
¿Te resultó interesante? Compártelo ...
