Provided by: manpages-es_1.55-10_all bug

NOMBRE

       dir_colors - fichero de configuracion para dircolors(1)

DESCRIPCI'ON

       El  programa ls(1) usa la variable de entorno LS_COLORS para determinar
       los colores con los que debe  mostrar  los  nombres  de  fichero.  Esta
       variable de entorno se inicializa normalmente con una orden como

              eval `dircolors some_path/dir_colors`

       localizado  en un fichero de inicializacion del interprete por defecto,
       como  /etc/profile  o  /etc/csh.cshrc.   (Vea  tambien   dircolors(1).)
       Habitualmente,  el  fichero  utilizado  es  /etc/DIR_COLORS y puede ser
       sobreescrito con un fichero .dir_colors en el  directorio  personal  de
       cada usuario.

       Este  fichero  de  configuracion consiste en varias sentencias, una por
       linea.  Cualquier cosa a la derecha de una  almohadilla  (#)  se  trata
       como  un  comentario si la almohadilla esta al principio de una linea o
       esta precedida por, al menos, un  espacio  en  blanco.  Las  lineas  en
       blanco se ignoran.

       La  seccion  global  del  fichero  esta formada por cualquier sentencia
       antes de la primera sentencia TERM.  Cualquier sentencia en la  seccion
       global  del  fichero  se  considera  valida  para  todos  los  tipos de
       terminales. A continuacion de la seccion global hay una o mas secciones
       espec'ificas   de  terminales,  que  estan  precedidas  por  una  o  mas
       sentencias TERM que especifican los tipos de terminal (tal y  como  los
       da   la  variable  de  entorno  TERM)  para  los  que  se  aplican  las
       declaraciones que les siguen. Siempre es posible anular una declaracion
       global mediante una subsiguiente declaracion especifica de terminales.

       Se reconocen las siguientes sentencias, sin distinguir entre mayusculas
       y minusculas:

       TERM tipo-terminal
              Comienza una seccion especifica de terminales y especifica a que
              terminal  se  aplica.  Se  pueden usar multiples sentencias TERM
              para crear  una  seccion  que  se  aplique  a  varios  tipos  de
              terminales.

       COLOR yes|all|no|none|tty
              (Solo  en  Slackware;  ignorada  por la utilidad dircolors(1) de
              GNU.)  Especifica que la coloracion siempre deberia estar activa
              (yes  o  all),  simepre inactiva (no o none) o activa solo si la
              salida es una terminal (tty).  El valor por omision es no.

       EIGHTBIT yes|no
              (Solo en Slackware; ignorada por  la  utilidad  dircolors(1)  de
              GNU.)   Especifica  que,  por  omision,  deberian  estar activos
              caracteres ISO 8859 de 8 bits. Por  razones  de  compatibilidad,
              tambien  se  puede especificar 1 para yes y 0 para no.  El valor
              por omision es no.

       OPTIONS opciones
              (Solo en Slackware; ignorada por  la  utilidad  dircolors(1)  de
              GNU.)   Anade  opciones  de  la  linea  de ordenes a la linea de
              ordenes por omision de ls.  Las opciones  pueden  ser  cualquier
              opcion  valida  de la linea de ordenes de ls, y deberian incluir
              el signo menos del principio.   Dese  cuenta  que  dircolors  no
              verifica la validez de estas opciones.

       NORMAL secuencia-color
              Especifica  el  color  usado para el texto normal (no nombres de
              fichero).

       FILE secuencia-color
              Especifica el color usado para un fichero regular.

       DIR secuencia-color
              Especifica el color para los directorios.

       LINK secuencia-color
              Especifica el color para los enlaces simbolicos.

       ORPHAN secuencia-color
              Especifica el color usado para un enlace simbolico huerfano (uno
              que  apunta  a  un  fichero  inexistente).  Si no se indica este
              color, ls usara en su lugar el color de LINK.

       MISSING secuencia-color
              Especifica el color usado para un fichero  ausente  (un  fichero
              inexistente   que,   sin  embargo,  tiene  un  enlace  simbolico
              apuntaNdo a el). Si no se indica este  color,  ls  usara  en  su
              lugar el color de FILE.

       FIFO secuencia-color
              Especifica el color usado para una FIFO (tuberia con nombre).

       SOCK secuencia-color
              Especifica el color para los conectores.

       B DOOR secuencia-color
              (Soportada  desde file-utils 4.1) Especifica el color usado para
              una "puerta" (Solaris 2.5 y posteriores).

       BLK secuencia-color
              Especifica  el  color  usado  para  un   fichero   especial   de
              dispositivo de bloque.

       CHR secuencia-color
              Especifica   el   color   usado  para  un  fichero  especial  de
              dispositivo de caracteres.

       EXEC secuencia-color
              Especifica el color usado para un fichero que  tiene  activo  el
              atributo de ejecutable.

       LEFTCODE secuencia-color
              Especifica  el  c'odigo a la izquierda para terminales que no son
              ISO 6429 (ver mas abajo).

       RIGHTCODE secuencia-color
              Especifica el c'odigo a la derecha para  terminales  que  no  son
              ISO 6429 (ver mas abajo).

       ENDCODE secuencia-color
              Especifica  el  c'odigo  al  final  para  terminales  que  no son
              ISO 6429 (ver mas abajo).

       *extensi'on secuencia-color
              Especifica el color usado para cualquier fichero que termina  en
              extensi'on.

        .extension secuencia-color
              Lo  mismo  que  *.extensi'on.   Especifica  el  color  usado para
              cualquier fichero que termina en .extension.  Dese cuenta que el
              punto  se  incluye  en  la  extension,  lo  que  hace  imposible
              especifica una extension que no comience por punto, tal  como  ~
              para  los  ficheros de respaldo de emacs.  Esta forma se deberia
              considerar obsoleta.

SECUENCIAS DE COLOR ISO 6429 (ANSI)

       La mayoria de las  terminales  ASCII  con  capacidades  de  color  usan
       actualmente  secuencias  de  color ISO 6429 (ANSI), y muchas terminales
       comunes sin capacidades de color, incluyendo  xterm  y  la  ampliamente
       usada  y  copiada  DEC  VT100,  reconoceran  codigos de color ISO 6429,
       elminandolos de la salida limpiamente o emulandolos.   ls  usa  codigos
       ISO 6429 por omision, suponiendo que la coloracion este activa.

       Las  secuencias  de  color  ISO 6429 estan compuestas por secuencias de
       numeros separados por caracteres punto y coma. Los codigos mas  comunes
       son:

         0         para restablecer el color por omision
         1         para colores mas brillantes
         4         para texto subrayado
         5         para texto centelleante
         30        para primer plano negro
         31        para primer plano rojo
         32        para primer plano verde
         33        para primer plano amarillo (o marron)
         34        para primer plano azul
         35        para primer plano purpura
         36        para primer plano cian
         37        para primer plano blanco (o gris)
         40        para segundo plano negro
         41        para segundo plano rojo
         42        para segundo plano verde
         43        para segundo plano amarillo (o marron)
         44        para segundo plano azul
         45        para segundo plano purpura
         46        para segundo plano cian
         47        para segundo plano blanco (o gris)

       No  todas  las ordenes funcionaran en todos los sistemas o dispositivos
       de visualizacion.

       ls usa por omision los siguientes valores:

         NORMAL    0              Texto normal (no nombres de fichero)
         FILE      0              Fichero regular
         DIR       32             Directorio
         LINK      36             Enlace simbolico
         ORPHAN    indefinido     Enlace simbolico huerfano
         MISSING   indefinido     Fichero ausente
         FIFO      31             Tuberia con nombre (FIFO)
         SOCK      33             Conector
         BLK       44;37          Dispositivo de bloques
         CHR       44;37          Dispositivo de caracteres
         EXEC      35             Fichero ejecutable

       Unos pocos programas de terminal no reconocen adecuadamente los valores
       por omision. Si se colorea todo el texto despues de realizar un listado
       del directorio,  cambie  los  codigos  NORMAL  y  FILE  a  los  codigos
       numericos para sus colores de primer y segundo plano.

OTROS TIPOS DE TERMINAL (CONFIGURACI'ON AVANZADA)

       Si  posee  una  terminal (io impresora!) con capacidades de color (o un
       metodo de resaltado distinto) que usa un conjunto diferente de codigos,
       todavia  puede  generar  una  configuracion  adecuada.  Para hacer eso,
       tendra que usar las definiciones LEFTCODE, RIGHTCODE y ENDCODE.

       Cuando ls escribe un nombre de fichero, genera las siguiente  secuencia
       de salida: LEFTCODE c'odigo_de_tipo RIGHTCODE nombre_de_fichero ENDCODE,
       donde c'odigo_de_tipo es la secuencia de color que depende  del  tipo  o
       nombre del fichero. Si el valor ENDCODE esta indefinido, en su lugar se
       usara la secuencia LEFTCODE NORMAL  RIGHTCODE.   El  proposito  de  los
       codigos  a  la izquierda y a la derecha es simplemente el de reducir la
       cantidad de escritura necesaria (y el  de  ocultar  codigos  de  escape
       desagradables  a  los  usuarios). Si no son adecuados para su terminal,
       puede eliminarlos especificando en una  linea  solo  la  palabra  clave
       correspondiente.

       NOTA:  Si  ENDCODE  esta  definida  en la seccion global del fichero de
       configuracion, no se puede anular en una seccion del fichero especifica
       de  terminales.  Esto  significaria  que cualquier definicion NORMAL no
       tendria efecto. Sin embargo, se puede especificar un ENDCODE diferente,
       que tendria el mismo efecto.

SECUENCIAS DE ESCAPE

       Para  especificar  caracteres de espacio o de control en las secuencias
       de color o en las extensiones de los nombres de fichero, se puede  usar
       tanto la notacion de codigos de \-escape al estilo de C o la notacion ^
       al estilo de stty.  La notacion al estilo de C incluyen los  siguientes
       caracteres:

         \a        Pitido (ASCII 7)
         \b        Retroceso (ASCII 8)
         \e        Escape (ASCII 27)
         \f        Salto de pagina (ASCII 12)
         \n        Nueva linea (ASCII 10)
         \r        Retorno de carro (ASCII 13)
         \t        Tabulador (ASCII 9)
         \v        Tabulador vertical (ASCII 11)
         \?        Borrado (ASCII 127)
         \nnn      Cualquier caracter (notacion octal)
         \xnnn     Cualquier caracter (notacion hexadecimal)
         \_        Espacio
         \\        Barra inclinada invertida (\)
         \^        Acento circunflejo (^)
         \#        Almohadilla (#)

       Dese cuenta que los caracteres de escape son necesarios para introducir
       un espacio, una barra inclinada  invertida,  un  acento  circunflejo  o
       cualquier caracter de control en cualquier lugar de la cadena, asi como
       una almohadilla como primer caracter.

OBSERVACIONES

       Las definiciones por omision de LEFTCODE y RIGHTCODE,  que  son  usadas
       por las terminales ISO 6429, son:

         LEFTCODE  \e[
         RIGHTCODE m

       El valor por omision de ENDCODE esta indefinido.

V'EASE TAMBI'EN

       dircolors(1), ls(1), stty(1), xterm(1)

FICHEROS

       /etc/DIR_COLORS
              Fichero de configuracion global del sistema para dircolors.

       ~/.dir_colors
              Fichero de configuracion por usuario para dircolors.

OBSERVACIONES

       Esta  pagina  describe  el formato del fichero dir_colors tal y como se
       usa  en  el  paquete  fileutils-4.1.  Otras  versiones  pueden  diferir
       ligeramente. Envie correos con correciones y ampliaciones a aeb@cwi.nl.
       Informe de fallos en el programa en fileutils-bugs@gnu.ai.mit.edu.