MODULO UNO SEMANA DOS

4. DOCUMENTACIN EN LINUX 4.1 Documentacin y ayuda Este capitulo se incluir en este punto del curso, por la importancia que tiene el conocer cul es el proceso de documentacin en Linux y cules son las opciones con las que usted cuenta a la hora de necesitar un soporte con respecto a cualquiera de los temas tratados durante el curso y su uso posterior despus de ste. El soporte en Linux si existe, pero se debe de entender de una manera diferente como quizs se habla de soporte hoy en da. La forma como funciona Linux y las comunidades de software libre no dejan otra cosa que pensar que no existe una empresa o compaa global encargada del soporte en todos los sentidos para el sistema operativo como tal, y mucho menos para cada una de las aplicaciones que utilicemos. Aqu es donde entra el otro concepto de soporte. Las comunidades de software libre, los grupos de inters, los proyectos libres y empresas que quieren aportar con el movimiento de software libre, son las encargadas de generar la documentacin necesaria para darle

un soporte real al sistema operativo y a cada una de las aplicaciones que puedan trabajar sobre l. A partir de esto y teniendo como base INTERNET, el soporte del software libre se extiende a las listas de correo, los foros de discusin, los chats y sistemas de comunicacin de tiempo real, en donde claramente tendremos respuesta a cada una de las necesidades que tengamos en algn momento dado. Este capitulo es pues un acercamiento al tipo de documentacin existente y la forma como usted puede acceder a ella. 4.2 Filosofa RTFM La filosofa RTFM no es otra cosa que una costumbre que se gener entre las comunidades de software libre y las personas que contribuyen de forma gil al proceso de documentacin en Linux y todos sus proyectos. RTFM son las siglas para Read The Fucking Manual, lo que en espaol traducira algo como: Lee el Maldito Manual. Aunque la expresin es algo fuerte no pasa de ah, lo que se quiere con ella, es que las personas que apenas se inician en el mundo Linux o en la cultura del software libre, tengan presente que antes de pedir 1

informacin, antes de escribir correos electrnicos a las personas encargadas de los proyectos, antes de postear en los foros diciendo que Linux no funciona por algn motivo, se dediquen a leer ellos mismos un poco, que se informen y traten de resolver el problema por ellos mismos, en pocas palabras, que lean primero los manuales que vienen anexos a las aplicaciones que estn usando. Como puede ver, no es un acto de grosera, aunque mucha personas pueden llegar a considerarlos como tal, pero esta sencilla forma de pensamiento es la que ha llevado que los usuarios finales de los sistemas operativos, se vuelvan menos dependientes de los tcnicos o de terceras personas y desarrollen ese espritu investigador que es tan comn en el mundo del Software Libre. La recomendacin es, entonces, estar atentos cuando necesitemos ayuda, mucha veces los problemas no son mas que simple falta de observacin o de buena lectura, y que no se enfurezcan cuando alguien en determinadas circunstancias les responda RTFM!. Estas palabras sern con mucho cario. 4.3 Pginas del Manual (pginas man) y los HOWTO's (COMO's).

Una de las primeras cosas que har cuando algo no le funcione, ser tratar de averiguar qu ha pasado, o cmo se debe hacer lo que trata de hacer. Las pginas del manual en Linux, son la documentacin que acompaa a cada una de las aplicaciones o comandos del sistema. Esta documentacin ser ms o menos extensa dependiendo del grupo de personas que hayan desarrollado la aplicacin y del tiempo que hayan destinado a su documentacin. Existe un formato estndar para la presentacin de esta informacin y una forma casi nica para acceder a su contenido. Cuando tengamos nuestro sistema Linux instalado podremos revisar una a una la documentacin existente para cada comando del sistema. Con esto podr solucionar muchos de los problemas que se le presenten. La forma de acceder a esa informacin es a travs del comando: $ man [COMANDO | aplicacin] Esto significa que escribiremos en nuestro sistema la palabra "man" seguida del nombre del comando o de la aplicacin sobre la que se quiere consultar algo. 2

Ejemplo: $man vi Como puede ver, el acceder a esta informacin no es algo complicado y es una forma en la cual rpidamente podr darle solucin a sus dudas. Los HOWTO's traducidos como COMO's al espaol, no son otra cosa que documentos cortos, casi siempre en un mismo formato rpido de leer y entender para cualquier usuario, que describe el procedimiento a ejecutar o la forma como se hace algo en el sistema. La palabra CMO la entenderemos como: "CMO poder hacer algo" A travs de los CMO 's en Linux, podr aprender: CMO instalar Linux CMO instalar una impresora CMO configurar su red CMO instalar una tarjeta de video CMO disear con gimp CMO del kernel Por poner varios ejemplos. La lista de los CMO's disponibles crece diariamente y no se especializa nicamente en aspectos tcnicos, puede decirse que encontrar un COMO para cada duda que tenga. Cada vez es ms fcil solucionar por

si mismo los problemas que se presenten. Cuando tenga un problema con una aplicacin o un aspecto general del sistema, no dude en buscar el COMO correspondiente en Internet. Existen sitios que se dedican a reunir este tipo de informacin y podr encontrar fcilmente los COMO's que necesite. Por tomar un ejemplo, esta Web rene varios COMO's en castellano: http://es.tldp.org/COMOINSFLUG/COMOs/ y en ingls: http://www.tldp.org/HOWTO/HOWTOINDEX/howtos.html 4.4 Documentos Adems de la documentacin de las pginas "man" y los COMO's, existe un estilo de documentacin completa donde se explica el proceso para realizar algo paso a paso. Este tipo de documentacin se conoce como la documentacin oficial y puede ser generada por los mismos proyectos de software libre o por grupos de inters que se dedican a esto. La documentacin existente en Linux cada vez se encuentra ms en espaol, gracias a los grupos y los 3

proyectos de habla hispana que quieren aportarle un granito, de esta forma, a la comunidad de Software Libre. Entre los proyectos mas destacados esta el proyecto de LUCAS, que ha crecido tanto que ahora se convirti en el proyecto de documentacin ms grande del habla hispana, este proyecto se llama The Linux Document Project, existe en ingls y existe en espaol, su pgina oficial es: www.tldp.org, aqu podr encontrar informacin abundante y completa sobre casi cualquier tema de Linux, lo invito a que visite esta web y explore todo su contenido. Algunos de los documentos que podr encontrar son: LIPP Linux Instalacin y Primeros Pasos, una gua bsica, especial para los recin iniciados. GLUP Gua del Usuario de Linux, especial para todos los usuarios de GNU/Linux, abarca las tareas ms cotidianas como por ejemplo edicin de archivos, manejo en el shell, manejo del entorno grfico, entre otras. GARL Gua de Administracin de Redes en Linux, una gua avanzada sobre la configuracin de los diferentes servicios de red que un servidor GNU/Linux puede proveer.

GULP Gua Linux de Programacin, al momento de la redaccin de este curso, la GULP se halla en desarrollo, incluye diferentes aspectos de la programacin en C del sistema, desde los conceptos bsicos hasta la programacin con semforos. GUIA DEL NCLEO Un libro ideal para hackers, programadores y entusiastas de lo desconocido. 4.5 Listas de correo, FAQ's y sitios en Internet Las listas de correo sern de invaluable valor para las personas que apenas comienzan en el mundo Linux. Son las listas a travs de las cuales se resuelven los problemas ms comunes a los usuarios inexpertos y donde todos se retroalimentan por medio de sus preguntas y respuestas. Estas listas son normalmente abiertas al pblico y cualquiera puede ingresar a ellas, una vez est inscrito en una de estas listas, podr opinar, preguntar y resolver dudas abiertamente. Cada lista de correo tiene sus propias condiciones de uso y las reglas de cmo debe presentarse una pregunta o cmo se le debe responder a alguien. 4

Es bueno leer antes de inscribirse en una lista los aspectos generales de cmo se debe comportar, con el fin de no provocar malos entendidos y que por esta razn sea expulsado de alguna de estas listas. Mucha listas de correo llevan aos de funcionamiento y han generado por todo este tiempo mucha respuestas a dudas expuestas. Estas preguntas son almacenadas en pginas Web con el fin de que todo el pblico en Internet sepa de lo que se ha hablado durante el tiempo de funcionamiento de la lista. Tambin a partir de esta informacin se generan las conocidas FAQ's (Frequently Asked Questions), lo que traduce Preguntas Mas Frecuentes, estas son documentos cortos de 10 a 15 preguntas donde se consignan las preguntas que todas las personas que empiezan tienen en algn momento. Se recomienda leer estas FAQ's antes de intentar resolver su problema a travs de una lista de correo. Los sitios de Internet donde se puede buscar ayuda, estn organizados normalmente por los llamados LUG's, que traduce Grupos de Usuarios Linux (GUL's), estos grupos son los encargados de la difusin

desinteresada del Software Libre en todo el mundo. Alrededor del mundo pueden encontrarse miles de grupos que hacen esta labor. Colombia no es la excepcin y se podrn encontrar Grupos de Usuarios Linux en mucha Ciudades y Municipios del pas. En las pginas Web de estos sitios, podr leer mas informacin acerca de lo que hacen y cul es su filosofa de trabajo, tambin encontrarn documentacin generada por ellos mismos y proyectos en los cuales estn trabajando actualmente. Posiblemente tenga un GUL cerca a usted. Si tiene problemas no dude en localizar a las personas encargadas del GUL ms cercano y hgale saber sus necesidades, muy seguramente ellos le podrn ayudar. A continuacin encuentra una enumeracin de listas de correo importantes en el mundo y otras de los grupos colombianos con sus respectivas pginas Web. BULMA - www.bulmalug.net LuCAS - www.tldp.org HISPALINUX http://www.hispaLinux.es/ 5

Listas: LuCAS@hispaLinux.es, para suscribirse se debe enviar un correo electrnico a la direccin lucasrequest@hispaLinux.es y en el tema debe ir la palabra ``subscribe'' L-Linux: lLinux@calvo.teleco.ulpgc.es, para suscribirse se debe enviar un correo electrnico a la direccin majordomo@calvo.teleco.ulpgc.es y en el cuerpo del mensaje debe ir lo siguiente: subscribe l-Linux Grupos colombianos: GIGAX (Grupo de implementacin GNU y arquitecturas *X) www.gigax.org - Medelln -Colombia Lista: gigax-users@gigax.org Para subscribirse ir al sitio: http://www.gigax.org/mailman/listinfo/ gigax-users y registrarse en la lista. GLUM - Magdalena http://glum.unimag.edu.co/ MERLINUX - BOGOTA Para suscribirse a la lista: http://mail.merLinux.org/mailman/listin fo/merLinux/ XUNILOMBIA - COLOMBIA http://xunilombia.ccasoft.org/ ChampeTUX -- GLUG Cartagena http://www.caribenet.com/Linux/

Para subscribirse ir al sitio: http://ctg.caribenet.com/mailman/listin fo/champetux/ SLCOLOMBIA -Software Libre Colombia http://www.slcolombia.org/ Una lista muy completa de los grupos colombianos se encuentra en: COLIBR - Grupo de Usuarios de Software Libre http://bachue.com/colibri/grupos.html