.\" -*- nroff -*-
.\" manpage for /etc/dir_colors, config file for dircolors(1)
.\" extracted from color-ls 3.12.0.3 dircolors(1) manpage
.\"
.\" This file may be copied under the conditions described
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
.\" that should have been distributed together with this file.
.\"
.TH DIR_COLORS 5 "11/1998" "Utilit. de Arquivos GNU 4.0"
.SH NOME
dir_colors \- arquivo de configurao para dircolors(1)
.SH DESCRIO
O arquivo
.B dir_colors
contem informaes de configurao para o programa
.BR dircolors (1)
, o qual, por sua vez, provm informaes de cor para
.BR ls (1).
O arquivo  normalmente encontrado em
.IR /etc,
embora os usurios possam manter uma cpia particular no seu diretrio 
pessoal como
.IR .dir_colors.
.PP
O arquivo de configurao consiste de vrios enunciados, um por linha.
Qualquer coisa  direita da marca (\#)  tratada com um comentrio, 
se esta marca estiver no comeo da linha ou for precedida por pelo
menos um espao. Linhas em branco so ignoradas.
.PP
A seo
.I global
do arquivo consiste de algum enunciado depois do primeiro enunciado
.B TERM
. Qualquer enunciado na seo global do arquivo  considerado
vlido para todo tipo de terminal. Seguindo a seo global 
uma ou mais sees
.I terminal-specific
, as quais so precedidas por um ou mais enunciados
.B TERM
, o qual especifica o tipo de terminal (como fornecido pela varivel de ambiente
.B TERM
) nas seguintes declaraes aplicadas. Ele permite sobrescrever a 
declarao global por uma subseqente
especificao de terminal.
.PP
Os enunciados seguintes so reconhecidos, tipo da letra  insignificante:
.PP
.TP
.B TERM \fIterminal-type\fR
Inicia a seo de especificao de terminal e especifica em qual terminal
ela se aplica. Mltiplos enunciados
.B TERM
podem ser usados para criar uma seo que pode ser aplicada para vrios tipos
de terminal.
.TP
.B COLOR yes|all|no|none|tty
Especifica que colorizao deveria ficar sempre disponvel (\fIyes\fR ou
\fIall\fR), nunca disponvel (\fIno\fR ou \fInone\fR) ou disponvel 
somente se a sada for um terminal (\fItty\fR). O padro  \fIno\fR.
.TP
.B EIGHTBIT yes|no
Especifica que caracteres de oito bits da ISO 8859 deverian estar disponveis
por padro. Pode por razes de compatibilidade ser especificado como 1
para \fIyes\fR ou 0 para \fIno\fR. O padro  \fIno\fR.
.TP
.B OPTIONS \fIoptions\fR
Adiciona opes de comando de linha para o comando de linha padro 
.B ls
. As opes pode ser quaisquer opes vlidas do comando de linha
.B ls
, e devem incluir o sinal de menos em primeiro lugar.
Favor notar que
.B dircolors
no verifica a validade destas opes.
.TP
.B NORMAL \fIcolor-sequence\fR
Especifica a cor usada para texto normal (no nome de arquivo).
.TP
.B FILE \fIcolor-sequence\fR
Especifica a cor usada para arquivos regulares.
.TP
.B DIR \fIcolor-sequence\fR
Especifica a cor usada para diretrios.
.TP
.B LINK \fIcolor-sequence\fR
Especifica a cor usada para ligaes simblicas.
.TP
.B ORPHAN \fIcolor-sequence\fR
Especifica a cor usada para uma ligao simblica orf (a qual
aponta para um arquivo inexistente). Se isto no for especificado,
.B ls
ir usar a cor do
.B LINK
no lugar.
.TP
.B MISSING \fIcolor-sequence\fR
Especifica a cor usada para um arquivo perdido (um arquivo inexistente
o qual todavia tem uma ligao simblica apontado para si). Se isto no for especificado,
.B ls
ir usar a cor do 
.B FILE
no lugar.
.TP
.B FIFO \fIcolor-sequence\fR
Especifica a cor usada por um FIFO (pipe nomeado).
.TP
.B SOCK \fIcolor-sequence\fR
Especifica a cor usada por um socket.
.TP
.B BLK \fIcolor-sequence\fR
Especifica a cor usada por um arquivo especial de bloco.
.TP
.B CHR \fIcolor-sequence\fR
Especifica a cor usada por um arquivo especial de caractere.
.TP
.B EXEC \fIcolor-sequence\fR
Especifica a cor usada por um arquivo executvel.
.TP
.B LEFTCODE \fIcolor-sequence\fR
Especifica o
.I "left code"
para terminais que no so terminais ISO\ 6429 (veja abaixo).
.TP
.B RIGHTCODE \fIcolor-sequence\fR
Especifica o
.I "right code"
para terminais que no so terminais ISO\ 6429 (veja abaixo).
.TP
.B ENDCODE \fIcolor-sequence\fR
Especifica o
.I "end code"
para terminais que no so terminais ISO\ 6429 (veja abaixo).
.TP
\fB*\fIextension\fR \fIcolor-sequence\fR
Especifica a cor usada para qualquer arquivo que termine com \fIextension\fR.
.TP
\fB .\fIextension\fR \fIcolor-sequence\fR
De forma semelhante \fB*\fR.\fIextension\fR. Especifica a cor usada por 
qualquer tipo de arquivo que termine com a extenso.\fIextension\fR. Note que
o ponto  includo na extenso, o qual torna impossvel especificar uma
extenso que no inicia com um ponto, assim como
.B ~
para arquivos de recuperao do
.B emacs.
Esta forma poderia ser considerada obsoleta.
.SH SEQENCIA DE CORES (ANSI) ISO 6429
A maioria do terminais ASCII com capacidade de cor usam a seqencia de 
cores (ANSI) ISO 6429, e muitos terminais simples sem capacidade de cor, incluindo
.B xterm
e o largamente usado e copiado DEC VT100, iro reconhecer os cdigos 
de cores ISO 6429 e de forma inofensiva remove elas a partir da sada ou as emula.
.B ls
usa o cdigo ISO 6429 por padro, assumindo que a colorizao est ativada.

As seqencias ISO 6429 de cores so compostas de seqencias de nmeros
separados por ponto e vrgula. Os cdigos mais comuns so:
.sp
.RS +.2i
.ta 1.0i
.nf
 0     para restaurar a cor padro
 1     para cor brilhante
 4     para sublinhar o texto
 5     para fazer o texto pisca
30     negro para o fundo mais prximo
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 prpura
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 prpura
46     segundo plano em azul-esverdeado
47     segundo plano em branco (ou cinza)
.fi
.RE
.sp
Nem todos os comando iro trabalhar em todos os sistema ou dispositivos de vdeo.
.PP
.B ls
usa os seguintes padres:
.sp
.RS +.2i
.ta 1.0i 2.5i
.nf
\fBNORMAL\fR   0       Texto normal (no  um nome de arquivo)
\fBFILE\fR     0       Arquivo normal
\fBDIR\fR      32      Diretrio
\fBLINK\fR     36      Ligao simblica
\fBORPHAN\fR   undefined       Ligao simblica orf
\fBMISSING\fR  undefined       Arquivo perdido
\fBFIFO\fR     31      Pipe nomeado (FIFO)
\fBSOCK\fR     33      Socket
\fBBLK\fR      44;37   Dispositivo de bloco
\fBCHR\fR      44;37   Dispositivo de caractere
\fBEXEC\fR     35      Arquivo executvel
.fi
.RE
.sp
Alguns programas de terminal no reconhecem o padro apropriadamente. 
Se todo texto  estiver colorizado depois de voc exibir um listagem 
de diretrio, altere os cdigos
.B NORMAL
e
.B FILE
para o cdigo numrico normal nas cores de primeiro e
segundo planos.
.SH OUTROS TIPO DE TERMINAIS (CONFIGURAES AVANADAS)
Se voc tem um terminal capaz de exibir cores (ou de outra forma sublinhar)
(ou impressora) que usa um conjunto de cdigos de cores diferentes, voc pode
ainda gerar uma codificao adequada. Para funcionar assim voc ter que usar as definies
.BR LEFTCODE ,
.BR RIGHTCODE ,
e
.BR ENDCODE.

.PP
Quando estiver escrevendo um nome de arquivo,
.B ls
ger a seguinte seqencia de sada:
.B LEFTCODE
.I typecode
.B RIGHTCODE
.I filename
.BR ENDCODE ,
onde o
.I typecode
 a seqencia de cores que depende do tipo ou nome do arquivo. Se o
.B ENDCODE
e indefinido, a seqencia
.B "LEFTCODE NORMAL RIGHTCODE"
ser usada no lugar. O propsito dos left(right)codes  meramente
para reduzir a quantidade de impresso necessria (e para esconder os feios
cdigos de sada vindo do usurio). Se eles no so apropriados para 
seu terminal, voc pode elimin-los pela especificao da respectiva
palavra-chave da linha para si mesma.
.PP
.B NOTA:
Se o
.B ENDCODE
 definido na seo global do arquivo de configurao, ele
.I no pode
estar indefinido na seo terminal-specific do arquivo. Isto significa
que qualquer definio
.B NORMAL
no vai ter qualquer efeito. Um cdigo
.B ENDCODE
pode de qualquer forma ser especificado, o qual dever ter o mesmo efeito.
.SH ESCAPE SEQUENCES
Para especificar caracteres de controle ou vazios na seqencia de cor ou 
nas extenses do nome de arquivos, uma das notaes no estilo C ou \e-escaped, ou
.BR estilo stty
podem ser usadas. A notao no estilo C
inclui os seguintes caracteres:
.sp
.RS +.2i
.ta 1.0i
.nf
\fB\ea\fR      Sinal sonoro (ASCII 7)
\fB\eb\fR      Tecla de retorno (ASCII 8)
\fB\ee\fR      Tecla de sada (ASCII 27)
\fB\ef\fR      Puxar folha (ASCII 12)
\fB\en\fR      Nova linha (ASCII 10)
\fB\er\fR      Retorno de carro (ASCII 13)
\fB\et\fR      Tabulao (ASCII 9)
\fB\ev\fR      Tabulao vertical (ASCII 11)
\fB\e?\fR      Apaguar (ASCII 127)
\fB\e\fInnn\fR Qualquer caractere (nmero octal)
\fB\ex\fInnn\fR        Qualquer caractere (nmero hexadecimal)
\fB\e_\fR      Espao
\fB\e\e\fR     Barra invertida (\e)
\fB\e^\fR      Circunflexo (^)
\fB\e#\fR      Smbolo (#)
.fi
.RE
.sp
Por favor note que sadas so necessrias para entrar um espao, barra invetida,
circunflexo ou qualquer outro caractere de controle em qualquer lugar de um cadeia de caracteres,
e assim como um smbolo # no primeiro caractere.
.SH NOTAS
As definies padro
.B LEFTCODE
e
.B RIGHTCODE
, so usadas pelos terminais ISO 6429 so:
.sp
.RS +.2i
.ta 1.0i
.nf
\fBLEFTCODE\fR  \ee[
\fBRIGHTCODE\fR m
.fi
.RE
.sp
O padro
.B ENDCODE
 indefinido.
.SH "VEJA TAMBM"
.BR dircolors (5),
.BR ls (1),
.BR stty (1),
.BR xterm (1)
.SH ARQUIVOS
.TP
O arquivo de configurao de todo o sistema para
.BR dircolors
 encontrado em
.I /etc/dir_colors .
.TP
O arquivo de configurao de cada usurio para
.BR dircolors
 encontrado em
.I /~/dir_colors .
.SH NOTAS
Esta pgina descreve
.B dir_colors
como se encontra no pacote Utilitrios de Arquivos 4.0;
outras verses podem ser um pouco diferentes.
Envie correes e adies para aeb@cwi.nl.
Relatrio de problemas no programa para fileutils-bugs@gnu.ai.mit.edu.
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndr L. Fassone Canova <lonelywolf@blv.com.br> (traduo)\fR
\&\fR\&\f(CWRoberto Selbach Teixeira <robteix@zaz.com.br> (reviso)\fR