147 lines
6.2 KiB
HTML
147 lines
6.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANPATH</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANPATH</H1>
|
|
Section: /etc/manpath.config (5)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOME</H2>
|
|
|
|
manpath - formato do ficheiro /etc/manpath.config
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIÇÃO</H2>
|
|
|
|
O ficheiro de configuração de manpath é usado pelos utilitários das páginas
|
|
do manual para avaliar os manpath do utilizador em tempo de execução, para
|
|
indicar quais as hierarquias de páginas do manual (manpaths) devem ser
|
|
tratadas como hierarquias do sistema e como atribuir-lhes pastas a usar para
|
|
armazenar ficheiros cat.
|
|
<P>
|
|
Se a variável de ambiente $<B>MANPATH</B> já estiver definida, a informação
|
|
contida em /etc/manpath.config não se lhe sobrepõe.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>FORMATO</H2>
|
|
|
|
Actualmente são reconhecidos os seguintes tipos:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>#</B><I> comentário</I><DD>
|
|
Linhas em branco ou começadas com <B>#</B> serão tratadas como comentários e
|
|
ignoradas.
|
|
<DT id="2"><B>MANDATORY_MANPATH</B><I> manpath_element</I><DD>
|
|
Linhas desta forma indicam manpaths que todo o $<B>MANPATH</B> gerado
|
|
automaticamente deve conter. Isto incluirá tipicamente <I>/usr/man</I>.
|
|
<DT id="3"><B>MANPATH_MAP</B><I> path_element manpath_element</I><DD>
|
|
Linhas desta forma configuram $<B>PATH</B> para mapas $<B>MANPATH</B>. Para cada
|
|
<I>path_element</I> encontrado no $<B>PATH</B> do utilizador, será adicionado
|
|
<I>manpath_element</I> a $<B>MANPATH</B>.
|
|
<DT id="4"><B>MANDB_MAP </B><I>manpath_element </I>[ <I>catpath_element</I> ]<DD>
|
|
Linhas desta forma indicam que manpaths devem ser tratados como manpaths de
|
|
sistema e, opcionalmente, onde devem ser armazenados os seus ficheiros
|
|
cat. Este tipo de campo é particularmente importante se <B>man</B> for um
|
|
programa setuid, porque (quando no ficheiro de configuração do sistema %
|
|
manpath_config_file% em vez no ficheiro de configuração .manpath por
|
|
utilizador) indica quais hierarquias de páginas do manual aceder como
|
|
utilizador setuid e quais aceder como o utilizador chamador.
|
|
<P>
|
|
As hierarquias das páginas de manual do sistema estão habitualmente
|
|
armazenadas em <I>/usr</I>, tal como <I>/usr/man</I>, <I>/usr/local/man</I> e
|
|
<I>/usr/X11R6/man</I>.
|
|
<P>
|
|
Se as páginas cat de um <I>manpath_element</I> não devem ser armazenadas ou
|
|
devem ser armazenadas na localização tradicional, <I>catpath_element</I> pode
|
|
ser omitido.
|
|
<P>
|
|
A colocação tradicional de cat seria impossível para hierarquias de páginas
|
|
do manual montadas como só de leitura e, por causa disto, é possível
|
|
especificar qualquer hierarquia válida para o seu armazenamento. Para
|
|
observação de <B>Linux FSSTND</B>, a palavra-chave <B>FSSTND</B> pode ser usada em
|
|
vez da pasta real.
|
|
<P>
|
|
Infelizmente, é necessário especificar <B>todos</B> os caminhos de sistema de
|
|
árvores do manual, incluindo caminhos de sistemas operativos alternativos,
|
|
tais como <I>/usr/man/sun</I> e quaisquer caminhos <B>NLS locale</B>, tais como
|
|
<I>/usr/man/de_DE.88591</I>.
|
|
<P>
|
|
Como a informação é analisada linha a linha na ordem de escrita, é
|
|
necessário que qualquer manpath que seja uma sub-hierarquia de outra
|
|
hierarquia seja listado primeiro, senão será feita uma correspondência
|
|
incorrecta. Um exemplo disto seria que <I>/usr/man/de_DE.88591</I> tem de vir
|
|
antes de <I>/usr/man</I>.
|
|
<DT id="5"><B>DEFINE</B><I> valor de chave</I><DD>
|
|
Linhas desta forma definem diversas variáveis de configuração; veja o
|
|
ficheiro de configuração predefinido para consultar as variáveis usadas
|
|
pelos utilitários das páginas do manual. Incluem caminhos predefinidos para
|
|
vários programas (tais co <I>grep</I> e <I>tbl</I>) e vários conjuntos predefinidos
|
|
de argumentos para esses programas.
|
|
<DT id="6"><B>SECTION</B> <I>secção</I> ...<DD>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
Linhas desta forma definem a ordem em que as secções do manual devem ser
|
|
procuradas. Se não houver directivas <B>SECTION</B> no ficheiro de configuração,
|
|
a predefinição é:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<PRE>
|
|
SECTION 1 n l 8 3 0 2 5 4 9 6 7</PRE>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Se forem indicadas múltiplas directivas <B>SECTION</B>, as suas listas de
|
|
secções serão concatenadas.
|
|
<P>
|
|
|
|
Se uma extensão em particularnão estiver na lista (digamos, 1mh), será
|
|
mostrada com o resto da secção a que pertence. O efeito disto é que só
|
|
precisa de listar explicitamente extensões se pretender forçar uma
|
|
determinada ordem. Secções com extensões devem habitualmente ser adjacentes
|
|
à sua secção principal (e.g. "1 1mh 8 ...").
|
|
<P>
|
|
|
|
<B>SECTIONS</B> é aceite como nome alternativo para esta directiva.
|
|
</DL>
|
|
|
|
<DT id="9"><B>MINCATWIDTH</B><I> largura</I><DD>
|
|
Se a largura do terminal for menor que <I>largura</I>, as páginas cat não serão
|
|
criadas (se em falta) ou mostradas. A predefinição é 80.
|
|
<DT id="10"><B>MAXCATWIDTH</B><I> largura</I><DD>
|
|
Se a largura do terminal for maior que <I>largura</I>, as páginas cat não serão
|
|
criadas (se em falta) ou mostradas. A predefinição é 80.
|
|
<DT id="11"><B>CATWIDTH</B><I> largura</I><DD>
|
|
Se a <I>largura</I> for diferente de zero, as páginas cat serão sempre
|
|
formatadas para um terminal da largura indicada, independentemente da
|
|
largura real do terminal um uso. Deve geralmente estar dentro do intervalo
|
|
definido por <B>MINCATWIDTH</B> e <B>MAXCATWIDTH</B>.
|
|
<DT id="12"><B>NOCACHE</B>
|
|
|
|
|
|
<DD>
|
|
Esta bandeira impede que <B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1) crie páginas cat automaticamente.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>ERROS</H2>
|
|
|
|
A não ser que as regras acima sejam rigorosamente seguidas e observadas, os
|
|
utilitários das páginas do manual não funcionarão como desejável. As regras
|
|
são excessivamente complicadas.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NOME</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">DESCRIÇÃO</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">FORMATO</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">ERROS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:22 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|