
\chapter{Lectura de documentación y obtención de ayuda \label{docs}}


\section{Tipos de documentación}

\index{documentación}\index{commands!documentación}\index{locating!documentación}\index{encontrando!documentación}Puede
encontrar documentación, dentro de un sistema Debian, al menos en los
siguientes emplazamientos:

\begin{itemize}
\item Páginas \texttt{man} o páginas de manual; léalas con la orden
\texttt{man}
\item Páginas \texttt{info}; léalas con la orden \texttt{info}. 
\item El directorio \texttt{/usr/doc/}\texttt{\emph{paquete}}, donde
\texttt{\textit{paquete}} es el nombre del paquete Debian.

\begin{quote}
Pista:\space
Para leer los ficheros que hay en \texttt{/usr/doc} resulta útil
\texttt{zless}; para más detalles, véase la sección \ref{zless} en la
página \pageref{zless}.

\end{quote}

\item \texttt{/usr/doc/HOWTO/}contiene los documentos de formato
«Cómo» del proyecto de Documentación de Linux (LDP, Linux
Documentation Project), en caso de que haya instalado los paquetes
Debian que contienen estos documentos.
\item Muchas órdenes disponen de una opción \texttt{-h} o
\texttt{-{}-help}. Para comprobarlo, escriba la orden seguida de una
de estas dos opciones.
\item El \lnk{Proyecto de documentación de
Debian}{http://www.debian.org/\~{}elphick/ddp/} tiene escritos algunos
manuales.
\item La \lnk{Página de soporte de
Debian}{http://www.debian.org/support/} tiene unas Preguntas de Uso
Frecuente (PUF, en inglés \textit{Frequently Asked Questions, FAQ} y
otros recursos. También puede probar la sede web de Linux, 
\lnk{Linux web site}{http://www.linux.org/}.
\end{itemize}
Hay varias razones por las que existe tan confusa variedad de fuentes
para la documentación. Por ejemplo, se supone que \texttt{info}
sustituye a \texttt{man}, pero \texttt{man} aún no ha
desaparecido. Sin embargo, es agradable saber que existe tanta
documentación. 

Así que ¿a dónde acudir en busca de ayuda? Aquí tiene algunas
sugerencias: 

\begin{itemize}
\item Utilice las páginas de manual y las opciones \texttt{-{}-help} o
\texttt{-h} para obtener un rápido resumen de la sintaxis de la orden
y sus opciones. Utilice \texttt{man} en el caso de que el programa
todavía no disponga de página info.
\item Utilice \texttt{info} si el programa tiene documentación
\texttt{info}. 
\item Si ninguno de los dos medios resulta, busque en
\texttt{/usr/doc/}\texttt{\textit{nombre- paquete}}. 
\item \texttt{/usr/doc/}\texttt{\textit{nombrepaquete}} contiene a
menudo información específica de Debian, incluso si existe una página
de manual o una página info.
\item Utilice los Cómos (HOWTOs) para buscar instrucciones sobre la
forma de configurar un aspecto particular, o para información sobre su
hardware en particular. Por ejemplo, el Ethernet-Cómo (Ethernet-HOWTO)
contiene gran cantidad de información sobre tarjetas Ethernet, y el PPP-Cómo (PPP-HOWTO) explica con detalle
cómo configurar el PPP. 
\item Utilice los manuales del proyecto de documentación de Debian
para explicaciones conceptuales e información específica de Debian. 
\item Si todo lo demás no funciona, entonces pregunte a alguien. Véase
la sección \ref{docs-support} en la página \pageref{docs-support}.
\end{itemize}
El uso de las páginas man se trata más arriba en la sección \ref{man
pages}, página \pageref{man pages}.\index{documentación}\index{órdenes!documentación}\index{localizar!documentación}\index{encontrar!documentación}
Es muy sencillo: pulse la barra espaciadora para desplazarse una
pantalla hacia abajo, y pulse \texttt{q} para abandonar la lectura.
El uso de \texttt{info}, la visualización de ficheros de
\texttt{/usr/doc}, y la petición de ayuda de una persona son todos
conceptos que se discuten en el resto del capítulo.

\subsection{Uso de \texttt{info\label{docs-info}\index{info|texttt}}}

\texttt{info} es el visualizador de documentación de GNU. Algunos
programas proporcionan
documentación\index{documentación!info}\index{órdenes!documentación!info}\index{info}\index{utilidades!visor
de documentación de GNU}\index{aplicaciones!visor de documentación de
GNU}\index{visor de documentación de GNU} en formato \texttt{info};
utilice \texttt{info} para visualizar esta documentación.
Para arrancar el visor basta con ejecutar \texttt{info}; también puede
añadir un asunto:

\begin{alltt}
     info emacs
\end{alltt}
También puede hacer aparecer la documentación sobre el propio
\texttt{info}, que incluye un tutorial. Ejecute:

\begin{alltt}
     info info
\end{alltt}
A partir de este momento, puede navegar con estas teclas:

\begin{description}
\item [\texttt{flechas}] Mueve el cursor por el documento.
\item [\texttt{m~RET}] Selecciona el elemento de menú sobre el que se
encuentra el cursor.
\item [\texttt{u}] Se desplaza «hacia arriba» en el documento.
\item [\texttt{n}] Se desplaza a la página siguiente.
\item [\texttt{p}] Se desplaza a la página anterior.
\item [\texttt{s}] Busca una cadena de texto.
\item [\texttt{g}] Va a una página específica.
\item [\texttt{q}] Sale de info
\end{description}
Se dará cuenta de que la línea superior de la pantalla indica las
páginas siguiente (next), anterior (previous) y «arriba» (up), que
corresponden a las teclas \texttt{n}, \texttt{p} y \texttt{u} keys.\index{documentación!info}\index{órdenes!documentación!info}\index{info}\index{utilidades!visor de documentación de GNU}\index{aplicaciones!visor de documentación de GNU}\index{visor de documentación de GNU}


\subsection{Los Cómos o HOWTOs }

\index{Proyecto de Documentación de Linux!HOWTOs}\index{Proyecto de
documentación de Linux!Cómos}\index{HOWTOs}\index{Cómos}\index{sistema
de ayuda!HOWTOs}\index{sistema de
ayuda!Cómos}\index{documentación!HOWTOs}\index{documentación!Cómos}Además
de sus libros, el proyecto de documentación de Linux ha confeccionado
una serie de documentos cortos que describen cómo configurar aspectos
particulares de GNU/Linux. Por ejemplo, el SCSI-Cómo (SCSI-HOWTO)
describe algunas de las complicaciones del uso de SCSI, uno de los
estándares de comunicación con los dispositivos, en su uso con
GNU/Linux. En general, los Cómos o HOWTOs tienen información
específica acerca de configuraciones particulares de hardware, y
estarán más actualizados que este manual.

Existen paquetes Debian para los Cómos o
HOWTOs. \texttt{doc-linux-text} contiene los diferentes Cómos en
formato texto; el paquete \\\texttt{doc-linux-html} contiene los Cómos
en (oh sorpresa) formato HTML navegable. Nótese que Debian ha
empaquetado también las traducciones de los Cómos (por ejemplo el
paquete \texttt{doc-linux-es}, N. de los T.) en diferentes
lenguas. Quizás prefiera estos paquetes si el inglés no es su idioma
nativo. Debian dispone de paquetes para Alemán, Castellano, Coreano,
Francés, Italiano, Japonés, Polaco, Sueco, Chino y Croata, en la
versión HTML de los HOWTOs. 
Generalmente están disponibles en el paquete
\texttt{doc-linux-}\texttt{\textit{codigoidioma}}, 
donde \texttt{\textit{codigoidioma}} es \texttt{fr} para Francés, \texttt{es}
para Español, etc. Si Usted ha instalado una de ellas, deberá estar en
\texttt{/usr/doc/HOWTO}. No obstante, podrá hallar versiones más
recientes en la Red en la \lnk{Página del LDP}{http://metalab.unc.edu/LDP/}.


\subsection{Ayuda personal \label{docs-support}}

\index{lista de distribución!Debian}\index{lista de distribución de
Debian}\index{Internet!lista de distribución de Debian}\index{correo
electrónico!lista de distribución de Debian}\index{IRC (Internet Relay
Chat)!lista de distribución de Debian}\index{sedes web!Debian}El
lugar adecuado para pedir ayuda sobre Debian es la lista de correo 
\texttt{debian-user-spanish} (la inglesa se llama
\texttt{debian-user}, N. de los T.) en
\emaillnk{debian-user-spanish@lists.debian.org}. Si ya sabe cómo
utilizar el IRC puede utilizar el canal \texttt{\#debian} en 
\texttt{irc.debian.org}. Puede encontrar ayuda específica sobre linux
en las jerarquías de grupos de noticias (news) USENET siguientes: 
\texttt{es.comp.os.linux.*} y \texttt{comp.os.linux.{*}}. También es
posible contratar asesores y servicio técnico que le proporcionen
servicios de soporte garantizado. La \lnk{Sede web de
Debian}{http://www.debian.org/} dispone de más información sobre estos
recursos.

Por favor, de nuevo reiteramos que \textit{no} pida ayuda a los
autores de este libro. Probablemente no conozcamos la respuesta a su
problema concreto, de todas maneras; si manda un correo a
\texttt{debian-user} o \texttt{debian-user-spanish}, obtendrá con
mayor rapidez respuestas de mayor calidad.\index{lista de
distribución!Debian}\index{lista de distribución de
Debian}\index{Internet!lista de distribución de Debian}\index{correo
electrónico!lista de distribución de Debian}\index{IRC (Internet Relay
Chat)!lista de distribución de Debian}\index{Web
sites!Debian}\index{preguntas!soporte técnico}\index{pedir ayuda
técnica}\index{soporte técnico!pedir ayuda} Sea siempre amable y haga
un esfuerzo por ayudarse leyendo previamente la
documentación. Recuerde que Debian es un esfuerzo de voluntarios y que
la gente le hace un favor al prestarle gratuitamente su tiempo y su
ayuda. Muchos de ellos cobran cientos de euros por dar el mismo tipo
de soporte técnico durante su jornada laboral.

\subsubsection{Trucos para plantear preguntas}

\begin{itemize}
\item Lea primero la documentación obvia. En ella se tratarán
cuestiones tales como las opciones de las órdenes y sobre la tarea que
realiza la orden. Ello incluye las páginas de manual y la
documentación \texttt{info}.
\item Compruebe los Cómos (HOWTOs) si su duda se refiere a cuestiones
tales como el PPP o Ethernet.
\item Intente asegurarse de que la respuesta no está en este libro.
\item No tenga miedo de preguntar, después de haber realizado el
esfuerzo básico para localizar la respuesta.
\item NO tema solicitar explicaciones de concepto, opiniones y otras
ayudas que a menudo no se encuentran en la documentación.
\item Incluya toda la información que parezca relevante. Mencione
siempre la versión de Debian que utiliza. Mencione también la versión
de los paquetes objeto de su consulta: la orden
\texttt{dpkg~-l}~\texttt{\textit{nombrepaquete}} le proporcionará esta
información. Es útil especificar también hasta qué punto ha intentado
arreglar el problema y lo que sucedió cuando intentó esa
solución. Sírvase incluir los mensajes de error exactos, si los hubo.
\item NO se disculpe por ser nuevo en Linux. No hay razón por la que
todo el mundo tenga que ser un experto en GNU/Linux para usarlo, igual
que no todo el mundo tiene que ser un mecánico para usar un auto. 
\item No haga envíos de correo ni de noticias de usenet en formato
HTML. Algunas versiones de Netscape y de Internet Explorer envían los
mensajes en HTML en vez de hacerlo en texto sencillo. La mayor parte
de las personas ni siquera leerán estos envíos, porque resultan
difíciles de visualizar en la mayoría de los programas. En algún
lugar de las Preferencias habrá una opción par deshabilitar el HTML.
\item Sea amable. Recuerde que Debian es un esfuerzo llevado
totalmente a cabo por voluntarios, y cualquiera que le ayude lo está
haciendo en su tiempo libre, más allá de la simple cortesía.
\item Reenvíe su pregunta a la lista si después de varios días no ha
obtenido respuesta. Quizás hubo muchos mensajes esos días y pasó
desapercibido entre ellos. O bien quizás nadie sepa la respuesta; si
nadie contesta la segunda vez, es lo más seguro. Intente incluir más
información esta segunda vez. 
\item Conteste Usted mismo las preguntas cuando sepa la
respuesta. Debian precisa que cada uno haga su propia tarea. Si alguna
vez Usted pregunta, y más tarde otra persona pregunta lo mismo, ya
sabrá cómo contestarle. Hágalo, pues.
\end{itemize}\index{preguntas!soporte técnico}\index{pedir soporte
técnico}\index{soporte técnico!plantear preguntas}

\subsection{Obtener información del sistema }

\index{encontrar!información del sistema}\index{localizar!información
del sistema}Cuando está intentando diagnosticar un problema o pidiendo
ayuda, precisará obtener información acerca de su sistema. Algunas
maneras de lograrlo son:  

\begin{itemize}
\item Examine los ficheros de \texttt{/var/log/}.
\item Examine la salida de la orden \texttt{dmesg}.
\item Ejecute \texttt{uname~-a}.
\end{itemize}

\chapter{Solución de problemas}

En Debian, como en la vida, las cosas no siempre funcionan como podría
esperarse o como a uno le gustaría. A pesar de que Debian tiene una
bien ganada reputación de ser sólida y estable como una roca, algunas
veces la reacción que manifieste ante sus órdenes puede no ser la
esperada. En esta sección intentamos arrojar alguna luz sobre los
problemas más comunes con los que se encuentra la gente.


\section{Dificultades comunes}

Esta sección proporciona algunos trucos para bregar con algunas de las
dificultades que con mayor frecuencia han encontrado los usuarios.


\subsection{Trabajar con ficheros de nombres extraños}

\index{convenciones para denominación!ficheros!solución de
problemas}\index{ficheros!convenciones para denominación!solución de
problemas}\index{solución de problemas!ficheros!convenciones para
denominación}A veces le sucederá que haya creado accidentalmente un
fichero que contiene un carácter que normalmente no se halla en
nombres de ficheros. Entre los ejemplos se cuentan el espacio, un
guión inicial, o quizás una comilla. Puede que le resulte difícil
acceder a estos ficheros, renombrarlos o borrarlos.

He aquí algunas indicaciones que le ayudarán:

\begin{itemize}
\item Pruebe a encerrar el nombre del fichero entre comillas simples,
de la siguiente manera:\\
\texttt{less~'Fichero~con~espacios.txt'}
\item Inserte \texttt{./} antes del nombre del fichero:\\
\texttt{less~'./-un~fichero~raro.txt'}
\item Utilice comodines:\\
\texttt{less~Fichero?con?espacios.txt}
\item Utilice una barra invertida antes de cada carácter poco
habitual:\\
\texttt{less~Fichero\textbackslash{}~con\textbackslash{}~espacios.txt}
\end{itemize}

\subsection{Impresión\index{impresión}}

\index{impresión!solución de
problemas}\index{dispositivos!impresoras!solución de
problemas}\index{solución de problemas!impresión}Una fuente habitual
de problemas es el sistema de impresión en Debian. Tradicionalmente la
impresión ha sido un aspecto poderoso pero complicado de Unix. Sin
embargo, Debian lo hace más fácil. Una manera sencilla de imprimir es
el paquete \texttt{magicfilter}. \texttt{magicfilter} le preguntará
algunas cuestiones acerca de su impresora y luego la configurará por
usted. Si tiene problemas al imprimir, pruebe \texttt{magicfilter}.


\subsection{Problemas con las X\index{X, solución de problemas}}

\index{Interfaces gráficas de usuario (GUIs)!Sistema de ventanas X!solución
de problemas}\index{GUI!Sistema de ventanas X!solución de
problemas}\index{X Window (sistema)!solución de
problemas}\index{solución de problemas!sistema
de ventanas X}\index{sistemas operativos!sistema de ventanas X!solución de
problemas}En torno a las de ventanas X se plantean muchas preguntas. He
aquí algunas pistas de tipo general sobre las acciones que hay que
intentar si experimenta dificultades al configurar el sistema
de ventanas X. 

\begin{itemize}
\item Para problemas con el ratón, ejecute \texttt{XF86Setup} y pruebe
las opciones PS/2, Microsoft, MouseSystems y Logitech. La mayoría de
los ratones se ajustan a uno de estos cuatro protocolos. Por otra
parte, el nombre de dispositivo para los ratones PS/2 es
\texttt{/dev/psaux}  y para los ratones de puerto serie, uno de los
puertos serie, por ejemplo \texttt{/dev/ttyS0}.
\item Si desconoce qué chipset de vídeo tiene, intente ejecutar 
\linebreak \texttt{SuperProbe};
a menudo podrá obtener la información por usted.
\item Si su pantalla no presenta el suficiente número de colores,
intente seleccionar una tarjeta de vídeo diferente o dígale al sistema
X cuánta memoria RAM de vídeo tiene su tarjeta.
\item Si su pantalla se pone negra o presenta texto ilegible cuando
arranca las X, es probable que haya seleccionado una frecuencia de
refresco incorrecta. Vuelva a \texttt{XF86Setup} o a
\texttt{xf86config} y vuelva a comprobar estas configuraciones.
\item \texttt{xvidtune} puede serle útil si la imagen está demasiado
descentrada hacia la izquierda o la derecha, o demasiado a lo alto o a
lo bajo, o bien si es demasiado ancha o estrecha. 
\item \texttt{xdpyinfo} le dará información sobre una sesión X en
ejecución.
\item \texttt{XF86Setup} ajusta la profundidad de color por defecto.
\item Puede usted seleccionar su gestor de ventanas por defecto si edita 
\linebreak \texttt{/etc/X11/window-managers}.
\item \texttt{/var/log/xdm-errors} contiene información útil si
experimenta pro- \\blemas intentando que \texttt{xdm} arranque
correctamente. 
\end{itemize}
Como resumen final, pruebe las utilidades \texttt{XF86Setup} o
\texttt{xf86config} para configurar o reconfigurar su hardware para
las X.

\chapter{Arrancando el sistema }

\index{LILO (``Linux Loader'', «cargador de Linux»)}\index{proceso de
arranque!LILO (``Linux Loader'', «cargador de Linux»)}\index{sistema
operativo!arranque!LILO (``Linux Loader'', «cargador de Linux»)}Este
apéndice describe los pasos que tienen lugar durante el proceso de
arranque de GNU/Linux. 

La forma en que arranque su sistema depende de la manera en que
configurase las cosas cuando lo instaló. Lo más normal es que
encienda su ordenador. Pero tal vez tenga que insertar antes un
disquete. 

Linux se carga mediante un programa llamado LILO, o LInux LOader
(«cargador de Linux»). LILO puede también cargar otros sistemas
operativos y preguntarle qué sistema desearía cargar.

Lo primero que sucede cuando enciende el ordenador en un PC Intel
es que se ejecuta la BIOS. La BIOS\index{BIOS (Basic Input/Output
System)}\index{programas!BIOS (Basic Input/Output
System)}\index{inicio!proceso de arranque!BIOS} es la abreviatura de
Basic Input Output System, «sistema de entrada y salida básico». Se
trata de un programa permanentemente almacenado en la computadora en
circuitos de sólo lectura. Lleva a cabo algunas comprobaciones mínimas
y luego busca un disquete floppy en la primera unidad de disco. Si lo
encuentra, busca en él un sector de arranque y empieza a ejecutar el
código contenido en él, si existe alguno. Si hay disco, pero no
sector de arranque, la BIOS imprimirá un mensaje parecido a éste: 
\texttt{Non-system~disk~or~disk~error}. Al quitar el disco y pulsar
una tecla, el proceso de arranque se reanudará.

Si no hay un disco floppy en la unidad, la BIOS busca un MBR en el
disco duro. Comenzará a ejecutar el código que se encuentra allí, lo
que cargará el sistema operativo. En los sistemas GNU/Linux, LILO
puede ocupar el MBR y cargará GNU/Linux.

De esta manera, si decide instalar LILO en su disco duro, deberá poder
ver \texttt{LILO} cuando arranque su computadora. Llegados a este
punto, puede pulsar la tecla \texttt{Shift} izquierda para seleccionar
el sistema operativo con el que vaya a arrancar, o bien pulse
\texttt{Tab} para ver una lista de opciones. Teclee una de estas
opciones y pulse \texttt{Enter}. LILO arrancará el sistema operativo
propuesto.\index{discos duros!LILO!sistema operativo, arranque de}

Si no pulsa la tecla \texttt{Shift}, LILO cargará automáticamente el
sistema operativo por defecto después de 5 segundos. Si lo desea,
puede cambiar automáticamente el sistema que LILO vaya a cargar, qué
sistemas puede cargar, y cuánto tiempo esperará antes de cargar uno
automáticamente. 

Si no instaló LILO en su disco duro, probablemente haya creado un 
\textit{disquete de arranque}. \index{discos!discos de
arranque!LILO}El disco de arranque contendrá en él una copia de
LILO. Todo lo que ha de hacer es introducir el disco antes de encender
su computador, y la BIOS lo encontrará antes de comprobar el MBR
(Master Boot Record) del disco duro. Para volver a un sistema
operativo no Linux, retire el disco y reinicie el computador. Desde
linux asegúrese de que sigue el procedimiento correcto para el
reinicio; para más detalles, véase la sección \ref{shutdown} en la
página \pageref{shutdown}. 

LILO carga el \index{núcleo:LILO (``Linux loader'', «cargador de Linux»)}núcleo de Linux desde
el disco y luego le pasa el control al núcleo. El núcleo es el
programa central del sistema operativo, que a su vez controla todos
los otros programas. El núcleo pasa a ignorar a BIOS y LILO.

En plataformas distintas a Intel, las cosas son algo diferentes, pero
una vez que arranque, todo es aproximadamente de la misma manera.

\index{núcleo:LILO (``Linux loader'', «cargador de Linux»)}\index{LILO
(``Linux loader'', «cargador de Linux»)}Linux se fija en el tipo de
hardware sobre el que se ejecuta. Precisa saber cuántos discos duros
tiene, si tiene un bus mouse, si el equipo está en red o no, y otros
asuntos menudos por el estilo. Linux no recuerda estos detalles entre
un arranque y otro, de manera que pregunta estas cuestiones cada vez
que se inicia. Por suerte no le pregunta a usted estas cosas; se las
consulta al propio hardware.
Mientras arranca, el núcleo de Linux imprimirá por pantalla mensajes
que describen lo que hace.

El proceso de detección\index{proceso de detección}\index{proceso de
arranque!proceso de detección}\index{inicio!proceso de
arranque!proceso de detección} puede provocar problemas con su
sistema, pero de haberlos causado, lo habrían hecho la primera vez que
instaló GNU/Linux. Si experimenta problemas consulte las instrucciones
de instalación o haga sus preguntas en una lista de distribución.

El núcleo simplemente gestiona los otros programas, de forma que
cuando ya está satisfecho porque todo está en orden, debe arrancar
algún otro programa para poder hacer algo útil. El programa que el
núcleo arranca se llama \texttt{init}. Después de dar arrancar 
\texttt{init}, nunca arranca ningún programa más. El núcleo se
convierte en gestor y proveedor de servicios.

Una vez arrancado \texttt{init}, ejecuta cierto número de guiones (en
inglés ``scripts'', ficheros que contienen órdenes) que preparan el
sistema para su uso. Llevan a cabo ciertos mantenimientos rutinarios y
dan comienzo a multitud de programas que realizan tareas tales como
mostrar una línea de ``login:'', permanecer a la escucha para
conexiones de red y mantener un registro de las actividades del
computador. 

