Provided by: manpages-pt_20040726-1_all bug

NOME

       dir_colors - arquivo de configuração para dircolors(1)

DESCRIÇÃO

       O arquivo dir_colors contem informações de configuração para o programa
       dircolors(1) , o qual, por sua vez,  provém  informações  de  cor  para
       ls(1).   O arquivo é normalmente encontrado em /etc, embora os usuários
       possam manter uma  cópia  particular  no  seu  diretório  pessoal  como
       .dir_colors.

       O  arquivo de configuração consiste de vários enunciados, um por linha.
       Qualquer coisa à direita da marca (se esta marca estiver no  começo  da
       linha  ou  for precedida por pelo menos um espaço. Linhas em branco são
       ignoradas.

       A seção global  do  arquivo  consiste  de  algum  enunciado  depois  do
       primeiro  enunciado  TERM válido para todo tipo de terminal. Seguindo a
       seção global é uma ou mais seções  terminal-specific  ,  as  quais  são
       precedidas por um ou mais enunciados TERM , o qual especifica o tipo de
       terminal (como fornecido pela variável de ambiente TERM ) nas seguintes
       declarações aplicadas. Ele permite sobrescrever a declaração global por
       uma subseqüente especificação de terminal.

       Os  enunciados  seguintes   são   reconhecidos,   tipo   da   letra   é
       insignificante:

       TERM terminal-type
              Inicia a seção de especificação de terminal e especifica em qual
              terminal ela se aplica.  Múltiplos  enunciados  TERM  podem  ser
              usados  para  criar  uma seção que pode ser aplicada para vários
              tipos de terminal.

       COLOR yes|all|no|none|tty
              Especifica que colorização deveria ficar sempre disponível  (yes
              ou  all), nunca disponível (no ou none) ou disponível somente se
              a saída for um terminal (tty). O padrão é no.

       EIGHTBIT yes|no
              Especifica que caracteres de oito  bits  da  ISO  8859  deverian
              estar disponíveis por padrão. Pode por razões de compatibilidade
              ser especificado como 1 para yes ou 0 para no. O padrão é no.

       OPTIONS options
              Adiciona opções de comando de linha  para  o  comando  de  linha
              padrão  ls  ls  ,  e  devem incluir o sinal de menos em primeiro
              lugar.  Favor notar que dircolors não verifica a validade destas
              opções.

       NORMAL color-sequence
              Especifica  a cor usada para texto normal (não nome de arquivo).

       FILE color-sequence
              Especifica a cor usada para arquivos regulares.

       DIR color-sequence
              Especifica a cor usada para diretórios.

       LINK color-sequence
              Especifica a cor usada para ligações simbólicas.

       ORPHAN color-sequence
              Especifica a cor usada para uma ligação simbólica orfã  (a  qual
              aponta   para   um   arquivo   inexistente).  Se  isto  não  for
              especificado, ls irá usar a cor do LINK no lugar.

       MISSING color-sequence
              Especifica a cor usada  para  um  arquivo  perdido  (um  arquivo
              inexistente  o  qual  todavia tem uma ligação simbólica apontado
              para si). Se isto não for especificado, ls irá  usar  a  cor  do
              FILE no lugar.

       FIFO color-sequence
              Especifica a cor usada por um FIFO (pipe nomeado).

       SOCK color-sequence
              Especifica a cor usada por um socket.

       BLK color-sequence
              Especifica a cor usada por um arquivo especial de bloco.

       CHR color-sequence
              Especifica a cor usada por um arquivo especial de caractere.

       EXEC color-sequence
              Especifica a cor usada por um arquivo executável.

       LEFTCODE color-sequence
              Especifica  o  left  code  para  terminais que não são terminais
              ISO 6429 (veja abaixo).

       RIGHTCODE color-sequence
              Especifica o right code para terminais  que  não  são  terminais
              ISO 6429 (veja abaixo).

       ENDCODE color-sequence
              Especifica  o  end  code  para  terminais  que não são terminais
              ISO 6429 (veja abaixo).

       *extension color-sequence
              Especifica a cor usada para qualquer  arquivo  que  termine  com
              extension.

        .extension color-sequence
              De  forma  semelhante  *.extension.  Especifica  a cor usada por
              qualquer tipo de arquivo que termine com  a  extensão.extension.
              Note que o ponto é incluído na extensão, o qual torna impossível
              especificar uma extensão que não inicia com um ponto, assim como
              ~ para arquivos de recuperação do emacs.  Esta forma poderia ser
              considerada obsoleta.

SEQÜENCIA DE CORES (ANSI) ISO 6429

       A maioria do terminais ASCII com capacidade de cor usam a seqüencia  de
       cores  (ANSI)  ISO  6429,  e muitos terminais simples sem capacidade de
       cor, incluindo xterm e o largamente usado e  copiado  DEC  VT100,  irão
       reconhecer  os  códigos  de cores ISO 6429 e de forma inofensiva remove
       elas a partir da saída ou as emula.  ls  usa  o  código  ISO  6429  por
       padrão, assumindo que a colorização está ativada.

       As  seqüencias ISO 6429 de cores são compostas de seqüencias de números
       separados por ponto e vírgula. Os códigos mais comuns são:

          0     para restaurar a cor padrão
          1     para cor brilhante
          4     para sublinhar o texto
          5     para fazer o texto pisca
         30     negro para o fundo mais próximo
         31     primeiro plano em vermleho
         32     primeiro plano em verde
         33     primeiro plano em amarelo (ou marrom)
         34     primeiro plano em azul
         35     primeiro plano em púrpura
         36     primeiro plano em azul-esverdeado
         37     primeiro plano em branco (ou cinza)
         40     segundo plano em preto
         41     segundo plano em vermelho
         42     segundo plano em verde
         43     segundo plano em amarelo (ou marrom)
         44     segundo plano em azul
         45     segundo plano em púrpura
         46     segundo plano em azul-esverdeado
         47     segundo plano em branco (ou cinza)

       Nem todos os comando irão trabalhar em todos os sistema ou dispositivos
       de vídeo.

       ls usa os seguintes padrões:

         NORMAL   0       Texto normal (não é um nome de arquivo)
         FILE     0       Arquivo normal
         DIR      32      Diretório
         LINK     36      Ligação simbólica
         ORPHAN   undefined       Ligação simbólica orfã
         MISSING  undefined       Arquivo perdido
         FIFO     31      Pipe nomeado (FIFO)
         SOCK     33      Socket
         BLK      44;37   Dispositivo de bloco
         CHR      44;37   Dispositivo de caractere
         EXEC     35      Arquivo executável

       Alguns  programas  de terminal não reconhecem o padrão apropriadamente.
       Se todo texto é estiver colorizado depois de você exibir um listagem de
       diretório,  altere  os  códigos  NORMAL  e  FILE para o código numérico
       normal nas cores de primeiro e segundo planos.

OUTROS TIPO DE TERMINAIS (CONFIGURAÇÕES AVANÇADAS)

       Se você tem um terminal capaz  de  exibir  cores  (ou  de  outra  forma
       sublinhar)  (ou  impressora)  que  usa  um conjunto de códigos de cores
       diferentes, você  pode  ainda  gerar  uma  codificação  adequada.  Para
       funcionar assim você terá que usar as definições LEFTCODE, RIGHTCODE, e
       ENDCODE.

       Quando estiver escrevendo um  nome  de  arquivo,  ls  gerá  a  seguinte
       seqüencia  de saída: LEFTCODE typecode RIGHTCODE filename ENDCODE, onde
       o typecode é a seqüencia de cores  que  depende  do  tipo  ou  nome  do
       arquivo.  Se  o  ENDCODE  e  indefinido,  a  seqüencia  LEFTCODE NORMAL
       RIGHTCODE será usada no  lugar.  O  propósito  dos  left(right)codes  é
       meramente  para  reduzir  a  quantidade de impressão necessária (e para
       esconder os feios códigos de saída vindo do usuário). Se eles  não  são
       apropriados para seu terminal, você pode eliminá-los pela especificação
       da respectiva palavra-chave da linha para si mesma.

       NOTA:  Se  o  ENDCODE  é  definido  na  seção  global  do  arquivo   de
       configuração,  ele no pode estar indefinido na seção terminal-specific
       do arquivo. Isto significa que qualquer definição NORMAL  não  vai  ter
       qualquer   efeito.  Um  código  ENDCODE  pode  de  qualquer  forma  ser
       especificado, o qual deverá ter o mesmo efeito.

ESCAPE SEQUENCES

       Para especificar caracteres de controle ou vazios na seqüencia  de  cor
       ou  nas  extensões do nome de arquivos, uma das notações no estilo C ou
       \-escaped, ou estilostty podem ser usadas. A notação no estilo C inclui
       os seguintes caracteres:

         \a      Sinal sonoro (ASCII 7)
         \b      Tecla de retorno (ASCII 8)
         \e      Tecla de saída (ASCII 27)
         \f      Puxar folha (ASCII 12)
         \n      Nova linha (ASCII 10)
         \r      Retorno de carro (ASCII 13)
         \t      Tabulação (ASCII 9)
         \v      Tabulação vertical (ASCII 11)
         \?      Apaguar (ASCII 127)
         \nnn Qualquer caractere (número octal)
         \xnnn        Qualquer caractere (número hexadecimal)
         \_      Espaço
         \\     Barra invertida (\)
         \^      Circunflexo (^)
         \#      Símbolo (#)

       Por  favor note que saídas são necessárias para entrar um espaço, barra
       invetida, circunflexo  ou  qualquer  outro  caractere  de  controle  em
       qualquer lugar de um cadeia de caracteres, e assim como um símbolo # no
       primeiro caractere.

NOTAS

       As definições padrão LEFTCODE e RIGHTCODE , são usadas pelos  terminais
       ISO 6429 são:

         LEFTCODE  \e[
         RIGHTCODE m

       O padrão ENDCODE é indefinido.

VEJA TAMBÉM

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

ARQUIVOS

       O arquivo de configuração de todo o sistema para
              dircolors é encontrado em /etc/dir_colors .

       O arquivo de configuração de cada usuário para
              dircolors é encontrado em /~/dir_colors .

NOTAS

       Esta  página descreve dir_colors como se encontra no pacote Utilitários
       de Arquivos 4.0; outras versões podem ser um pouco  diferentes.   Envie
       correções  e  adições  para  aeb@cwi.nl.   Relatório  de  problemas  no
       programa para fileutils-bugs@gnu.ai.mit.edu.

TRADUZIDO POR LDP-BR em 21/08/2000.

       André L.  Fassone  Canova  <lonelywolf@blv.com.br>  (tradução)  Roberto
       Selbach Teixeira <robteix@zaz.com.br> (revisão)