The Inside Out

Soporte Técnico: Ayuda doctor!

La ayuda en Linux se presenta de varias maneras. Cada sistema Linux tiene por un lado las llamadas "manpages" o páginas del manual, que aparecen al usar una consola con los comandos man e info. Por otro lado, cada distribución hace su propia documentación para describir sus programas y su configuración particular. Además, se suelen incluír los documentos "HOWTO" (o traducidos al español: "COMO") que explican un tema en particular con gran detalle. En tercer lugar está la comunidad de usuarios, un grupo enormemente distribuido, que puede ayudarlo muchísimo con sus problemas. Si usted compró una distribución en caja, pongamos por ejemplo Mandriva Linux 8.2, incluirá manuales de uso. Si bajó los archivos de Internet, como mínimo tendrá la documentación online en sus CDs.

Si la documentación que usted tiene en su PC no le alcanza, o usted no sabe que le alcanza (algo que esperamos solucionar con este CD), puede recurrir a la red.
Lo primero que usted debería hacer es visitar el sitio de la distribución que usted usa, y agregarlo a sus favoritos. Cada distribución proporciona mucha ayuda, listas de hardware soportado, enlaces útiles, etc. Saber inglés puede ayudarlo mucho en su búsqueda.
Si no encuentra en ese sitio la solución, el siguiente paso es una búsqueda en Google. Simplemente con escribir las palabras que mejor describan su problema y su distribución usted debería encontrar algo.
Si esto tampoco funciona, puede probar visitando los foros de discusión de su distribución particular, y en especial los enlaces que le damos aquí.

El Sistema de Ayuda en GNU/Linux

El sistema de ayuda actual en Linux está disperso entre varios formatos: archivos legibles por el programa man, otros legibles por el programa info, otros de texto puro, otros como HOWTOs o COMOs, la ayuda de KDE y GNOME en formato (al menos la primera) Docbook, los foros, listas de correo, tutoriales, etc. Una de las tareas más importantes que nos queda por completar en la comunidad Linux, es la de lograr la unificación de esos sistemas en uno o en un número menor (o al menos lograr un sistema coherente de ayuda). Pero por el momento, veamos lo que tenemos, y tratemos de aprovecharlo.

Este tutorial se dedica a la parte de la ayuda que no está incluída en sistemas gráficos, como la Ayuda de KDE o GNOME, que es bastante fácil de consultar. También evitamos tratar aquí los manuales de ayuda de su distribución porque no sabemos cuál de ellas usa usted, y porque, en algunos casos, sólo está disponible en el paquete pago: la edición download (gratuita) de, por ejemplo, Mandriva Linux no incluye los manuales que la empresa hace (sí incluye HOWTOs, man, etc.).

Para empezar: usen el comando apropos. Apropos toma el argumento (la palabra buscada) que le damos y nos devuelve el montón (o no) de páginas de manual en las que esa palabra o frase aparece en la descripción de un comando. Por ejemplo, escribir
apropos internet
nos devuelve un listado de páginas de manual:

[rogelio@Edhellond rogelio]$ apropos internet
MIME [mime]          (1)  - Multipurpose Internet Mail Extensions
nslookup             (8)  - query Internet name servers interactively
xinetd               (8)  - the extended Internet services daemon
xinetd.conf [xinetd] (5)  - Extended Internet Services Daemon configuration file
[adriano@Edhellond adriano]$

Evidentemente, el resultado tal vez no sea lo que buscábamos. En ese caso, deberemos pensar en otra palabra para conseguir mejores resultados, o buscar en los HOWTOs o en la red. El caso particular de estar buscando una manera de conectarnos es particularmente difícil de este modo, porque los comandos necesarios (desde una conexión por módem) son pppd y chat. Sus descripciones son pobres, para ser amables con ellos. Por otro lado, la conexión en Linux está cubierta muy bien por kppp, un programa del entorno KDE que provee la misma funcionalidad, tiene muy buena ayuda y es muy fácil de usar. Búsquelo en su menú entre los programas de internet.

Una última aclaración: si el comando apropos no devuelve nada, lo más probable es que la base de datos en que el programa se basa no haya sido creada todavía. Para crearla, ejecute el siguiente comando como usuario root:

make whatis

Luego de la espera podrá usar el comando apropos.

Man

Man es el sistema de ayuda más importante en Linux. Los otros dos grandes "sistemas" son info (descrito más abajo) y la opción --help al ejecutar un programa desde una terminal o consola.

Abra una terminal desde su entorno gráfico, y ejecute
man man
para ver la página de man sobre sí mismo.

Los documentos de man se dividen en secciones, según sean:

1. Comandos
2. Llamadas al sistema (funciones para el núcleo)
3. Llamadas a librerías
4. Archivos especiales
5. Formatos de archivos y convenciones
6. Juegos
7. Paquetes de macros y convenciones
8. Comandos a ejecutar por root
9. Funciones del núcleo

No se preocupe por no entender el propósito de alguna sección ahora. Principalmente, usará las secciones 1, 5, 7 y 8. En realidad, normalmente ni siquiera necesitará usar secciones, pero de todos modos, la manera de hacerlo es
man nº programa (por ejemplo, man 5 mail)
Las principales opciones y maneras de usar man para un principiante son:
man -a programa (por ejemplo, man -a ls)
man -k programa
-a indica que se muestren todas las secciones del manual que tengan referencias al programa. Por ejemplo, man -a man devuelve todas las entradas de man, no sólo la de la sección 1.

-k sirve, igual que el comando apropos, para encontrar qué programa hace algo. por ejemplo, man -k mail me devuelve todos los programas relacionados con la palabra mail en su descripción, con las correspondientes secciones, y una explicación de para qué sirve cada uno.

Para salir de las páginas de man, basta apretar la tecla q.

Help

help es el complemento de man para comandos internos del shell. Pruebe ejecutar help help para saber qué está incluído aquí y qué no. Como regla general, si al pedir ayuda de un comando (y ese comando existe en el sistema) no pasa nada con man o info, pruebe con help. ¿Ejemplos? alias, exit, echo...

Info

El comando info fue creado para superar algunas ausencias del otro gran comando de ayuda: man. Está planteado de manera de hacerlo mucho más flexible de usar, con links para navegación estilo web, por ejemplo. Pasemos a tocar un poco.

Para empezar, haga una prueba simple. Abra una terminal y escriba

info

Eso muestra la "homepage" de info. En ella puede ver que ? lista todos los comandos usables dentro de info, d vuelve a la home, n avanza, p retrocede y b va al inicio de cada página (next, previous, beginning). h abre una ayuda a los principiantes.

Ahora pase al segundo punto: con Tab, lleve el cursor al siguiente link más cercano, y pulse Enter sobre ese enlace. Los enlaces se reconocen por llevar : en su estructura (por ejemplo, Info: es un enlace). Para seguir un enlace, suponiendo que no llegó a él con Tab, puede poner el cursor en la palabra-enlace y dar Enter.

Para moverse puede por supuesto usar las flechas del teclado, pero también la barra espaciadora (avanza una página) o Backspace (retrocede una página). Con Control + L puede recargar la página de info.

Un comando muy útil es S. Permite buscar cadenas de texto dentro del archivo info. El comando Esc + S busca hacia atrás. Con esto tiene una idea básica del uso de man e info, que por su propia naturaleza no pueden ser demasiado complejos. Esperamos que los aproveche para poder aprender mucho más sobre su Linux!

Los HOWTOs, Tutoriales y otras formas de ayuda en la red

Los HOWTOs o COMOs son documentos en formato HTML (páginas web) con información sobre un tema específico, pero no sobre un programa específico. Por ejemplo, el PPP HOWTO cubre todo lo referente al protocolo Point to Point, que se encarga de manejar conexiones a otras computadoras, desde una red local a la internet. Suelen ser muy completos, técnicos, jugosos y difíciles de comprender. Conviene leerlos dos veces, porque la información que buscamos (aunque sea "busque en tal lado") está. Suelen incluirse en las distribuciones, por lo que bastaría un comando como urpmi howto en Mandriva Linux para poderlos instalar, si es que no lo estaban ya. Pueden encontrarse también en la red, claro, dado que normalmente hay una persona que se ocupa de cada uno y lo mantiene actualizado. Pueden encontrar COMOs (las traducciones e innovaciones en HOWTOs al castellano) en el proyecto LuCAS.
Las FAQ (Frequently Asked Questions, preguntas más frecuentes) son otra manifestación de estos documentos, pero tienden a responder dudas puntuales y comunes, por lo que pueden ser mejores para un usuario inexperto. Se encuentran en el sitio de cada aplicación en particular.

Los tutoriales en internet y los foros de discusión / listas de correo / etc. son indudablemente la opción más cómoda muchas veces, pero hay que saber encontrar los adecuados y cómo usarlos. Uno muy bueno para usuarios de la distribución Mandriva Linux es el de mandrivausers, con gente muy amable, una sección de traducción de mensajes e incluso gente que ha pasado a otras distribuciones como Gentoo o Debian pero que sigue participando mucho solamente porque el foro es excelente. Dispone incluso de una sección de traducción para que los usuarios que no hablan inglés puedan publicar sus dudas y recibir respuesta. Por último, busque en Linux Google o Justlinux.

En Argentina, el sitio principal para un usuario debería ser su LUG (Linux Users Group). Para encontrar el suyo, visite el núcleo de todos los LUGs de Argentina: el LUGAr. El LUGAr tiene un sitio hijo, AULA (AULA Une a los Linuxeros Argentinos), que se encarga de nuclear la información y documentación de todos los LUGs. El proyecto AULA aún no está terminado a la fecha, pero para el momento en que lea esto debería haber nacido.

Consejos generales al usar un foro o una lista de correos:

• No crea que se le debe una respuesta, mucho menos inmediata. Sea amable con la gente que puede responder a su pregunta. Después de todo, usted no está pagando para que le resuelvan su problema. Los autores han visto personalmente a un usuario reclamar porque no había una respuesta a su problema -de manera agresiva además- veinte minutos luego de publicar su primer mensaje a un foro, a las dos de la mañana de un sábado. Dicho esto, las respuestas a problemas en las listas de correo suelen ser muy rápidas y amables. Intente que sigan siendo rápidas y amables: haga preguntas claras y corteses.
• No crea que el que responde conoce el problema de antemano. Algunas descripciones de cuelgues o problemas se limitan a decir "Mi navegador X se cuelga. Qué hago?" o "No me anda Internet", lo que hace necesaria toda una serie de mensajes y grandes pérdidas de tiempo. Demuestre que intenta salir del problema, no que quiere todo servido. Recibirá más ayuda de este modo.
• Intente describir a sí mismo el problema lo mejor que pueda, y escríbalo. Relea el texto e intente con eso reproducir el problema para ver qué tan claro ha sido. Avise si ha buscado algo en internet y por qué no le sirvió, si lo hizo.
• Intente dar un título claro a su mensaje (es decir, algo distinto de "AYUDAAAAAA", o "Tengo problemas").
• No grite. Escribir todo con MAYUSCULAS en la red equivale a gritar, y es muy molesto de leer.