.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_MAKESHLIBS 1"
.TH DH_MAKESHLIBS 1 "2019-09-14" "12.6" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOME"
.IX Header "NOME"
dh_makeshlibs \- cria automaticamente o ficheiro shlibs e chama
dpkg-gensymbols
.SH "RESUMO"
.IX Header "RESUMO"
\&\fBdh_makeshlibs\fR [\fIopções do debhelper\fR] [\fB\-m\fR\fImajor\fR]
[\fB\-V\fR\fI[dependências]\fR] [\fB\-n\fR] [\fB\-X\fR\fIitem\fR] [\fB\-\-\fR \fIparâmetros\fR]
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
\&\fBdh_makeshlibs\fR é um programa debhelper que sonda automaticamente por
bibliotecas partilhadas, e gera um ficheiro shlibs para as bibliotecas que
encontra.
.PP
Também assegura que o ldconfig é invocado durante a instalação e remoção
quando encontra bibliotecas partilhadas. Desde o debhelper 9.20151004, isto
é feito via um trigger do dpkg. Nas versões mais antigas do debhelper,
\&\fBdh_makeshlibs\fR seria geralmente um script de mantenedor para este
objectivo.
.PP
Since debhelper 12.3, \fBdh_makeshlibs\fR will by default add an additional
\&\fIudeb\fR line for udebs in the shlibs file, when the udeb has the same name
as the deb followed by a \*(L"\-udeb\*(R" suffix (e.g. if the deb is called
\&\*(L"libfoo1\*(R", then debhelper will auto-detect the udeb if it is named
\&\*(L"libfoo1\-udeb\*(R"). Please use the \fB\-\-add\-udeb\fR and \fB\-\-no\-add\-udeb\fR options
below when this auto-detection is insufficient.
.PP
If you previously used \fB\-\-add\-udeb\fR and is considering to migrate to using
the auto-detection new auto-detection feature in 12.3, then please remember
to test that the resulting \fIDEBIAN/shlibs\fR files are as expected.  There
are some known corner cases, where the auto-detection is insufficient.
These include when the udeb contains library files from multiple regular deb
packages or when the packages do not follow the expected naming convention.
.SH "FICHEIROS"
.IX Header "FICHEIROS"
.IP "debian/\fIpacote\fR.shlibs" 4
.IX Item "debian/pacote.shlibs"
Instala este ficheiro, se presente, no pacote como DEBIAN/shlibs. Se
omitido, o debhelper irá gerar um ficheiro shlibs automaticamente se
detectar quaisquer bibliotecas.
.Sp
Note que em níveis de compatibilidade 9 e anteriores, este ficheiro era
instalado pelo \fBdh_installdeb\fR\|(1) em vez do \fBdh_makeshlibs\fR.
.IP "debian/\fIpacote\fR.symbols" 4
.IX Item "debian/pacote.symbols"
.PD 0
.IP "debian/\fIpacote\fR.symbols.\fIarquitectura\fR" 4
.IX Item "debian/pacote.symbols.arquitectura"
.PD
Estes ficheiros de símbolos, se presentes, são passados para
\&\fBdpkg\-gensymbols\fR\|(1) para serem processados e instalados. Use os nomes
específicos de \fIarch\fR se precisar de disponibilizar ficheiros de símbolos
diferentes para diferentes arquitecturas.
.SH "OPÇÕES"
.IX Header "OPÇÕES"
.IP "\fB\-m\fR\fImajor\fR, \fB\-\-major=\fR\fImajor\fR" 4
.IX Item "-mmajor, --major=major"
Em vez de tentar adivinhar o maior número da biblioteca com o objdump, usa o
maior número especificado após o parâmetro \-m. Isto é muito menos útil do
que costumava ser, de volta aos maus velhos tempos quando este programa
olhava para os nomes de ficheiro das bibliotecas em vez de usar o objdump.
.IP "\fB\-V\fR, \fB\-V\fR\fIdependências\fR" 4
.IX Item "-V, -Vdependências"
.PD 0
.IP "\fB\-\-version\-info\fR, \fB\-\-version\-info=\fR\fIdependências\fR" 4
.IX Item "--version-info, --version-info=dependências"
.PD
Se um ficheiro shlibs for gerado por este programa, esta opção controla que
versão será usada na relação de dependência.
.Sp
Em compatibilidade 12 e posterior, \fBdh_makeshlibs\fR usa por predefinição
\&\fB\-VUpstream\-Version\fR.  Em compatibilidade 11 e anterior o comportamento
predefinido é como \fB\-VNone\fR..
.Sp
A ferramenta \fBdh_makeshlibs\fR pode gerar dependências em três variantes:
.RS 4
.IP "\fB\-VUpstream\-Version\fR" 4
.IX Item "-VUpstream-Version"
A dependência será "\fIpackagename\fR \fB(>\fR= \fIpackageversion\fR\fB)\fR".  Note
que \fIUpstream-Version\fR é sensível a maiúsculas/minúsculas e tem de ser
escrito exactamente como mostrado aqui.
.Sp
Esta é uma definição conservativa que assegura sempre que as dependências de
bibliotecas partilhadas dos pacotes mais antigos são pelo menos tão justas o
quanto precisam de ser (a menos que a biblioteca seja inclinada a alterar a
\&\s-1ABI\s0 sem actualizar o número de versão do autor).
.Sp
O reverso da medalha é que os pacotes podem acabar com dependências muito
apertadas em alguns casos (note que um ficheiro symbols pode mitigar esta
situação). Isto é geralmente uma inconveniência menor temporária e
normalmente muito melhor que a falha causada ao esquecer de inserir a
informação de dependência.
.Sp
Este formato explícito foi adicionado no debhelper/11.3. Nas versões
anteriores, era usado em vez disto um \fB\-V\fR sem nenhuma informação de
dependência (e esse formato ainda funciona).
.IP "\fB\-VNone\fR" 4
.IX Item "-VNone"
A dependência será "\fIpackagename\fR".  Note que \fINone\fR é sensível a
maiúsculas/minúsculas e tem de ser escrito exactamente como mostrado aqui.
.Sp
Este formato é na generalidade não seguro sendo a única excepção se o autor
original não estender a \s-1ABI\s0 de maneira nenhuma. No entanto, a maioria dos
autores originais melhoram as suas interfaces com o passar do tempo e é
recomendado que os pacotes usem \fB\-VUpstream\-Version\fR (ou um dos outros
formatos de \fB\-V\fR\fIdependencies\fR).
.Sp
Alternativamente, isto pode ser suficiente se (e apenas se) o pacote usar
versão por símbolo (veja \fBdpkg\-gensymbols\fR\|(1)) e \fInão\fR compilar nenhum
pacote udeb. Note que symbols não são suportados para pacotes udeb, os quais
apenas se apoiam em shlibs para manuseamento das dependências.
.IP "\fB\-V\fR\fIpackage-relation\fR" 4
.IX Item "-Vpackage-relation"
Neste caso, o valor passado a \fB\-V\fR irá ser usado como uma relação de
dependência. O \fIpackage-relation\fR deve geralmente ser do formato
"\fIalgum-nome-pacote\fR \fB(>\fR= \fIalguma\-versão\-pacote\fR\fB)\fR".  Lembre-se de
incluir o nome do pacote.
.Sp
Note que o debhelper irá usar o calor \fIcomo está\fR sem verificações de
sanidade ou modificação. Em casos \fIraros e especiais\fR, isto é preciso para
gerar uma dependência num pacote diferente daquele que contém a biblioteca.
.RE
.RS 4
.Sp
Quando escolher um valor para esta opção, por favor lembre-se que se o
pacote fornecer um ficheiro symbols, então esse é geralmente preferido sobre
o ficheiro shlibs para pacotes .deb regulares. Veja \fBdpkg\-shlibdeps\fR\|(1)
para mais informação sobre este tópico.
.RE
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Não adiciona o trigger \*(L"ldconfig\*(R" mesmo que parece que o pacote possa
precisar dele. A opção é chamada \fB\-\-no\-scripts\fR por razões históricas pois
o \fBdh_makeshlibs\fR previamente gerava scripts do mantenedor que chamavam
\&\fBldconfig\fR.
.IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4
.IX Item "-Xitem, --exclude=item"
Exclui ficheiros que contenham \fIitem\fR em qualquer ponto do seu nome de
ficheiro ou directório de serem tratados como bibliotecas partilhadas.
.IP "\fB\-\-add\-udeb=\fR\fIudeb\fR" 4
.IX Item "--add-udeb=udeb"
Cria uma linha adicionar para udebs no ficheiro shlibs e usa \fIudeb\fR como o
nome do pacote para o udebs depender dele em vez do pacote da biblioteca
normal.
.Sp
This is option is only useful for special cases such as when debhelper
cannot auto-detect package name of the udeb package, when the udeb will
contain libraries from multiple deb packages, or when the udeb contains
libraries \fBnot\fR present in the deb package.
.IP "\fB\-\-no\-add\-udeb\fR" 4
.IX Item "--no-add-udeb"
Do not add any udeb lines to the shlibs file.  This can be used to disable
the default auto-detection of udebs.
.IP "\fB\-\-\fR \fIparams\fR" 4
.IX Item "-- params"
Passa \fIparams\fR para \fBdpkg\-gensymbols\fR\|(1).
.SH "EXEMPLOS"
.IX Header "EXEMPLOS"
.IP "\fBdh_makeshlibs \-VNone\fR" 4
.IX Item "dh_makeshlibs -VNone"
Assumindo que este é um pacote chamado \fIlibfoobar1\fR, gera um ficheiro
shlibs que se parece com algo como isto:
 libfoobar 1 libfoobar1
.IP "\fBdh_makeshlibs \-VUpstream\-Version\fR" 4
.IX Item "dh_makeshlibs -VUpstream-Version"
Assumindo que a versão actual do pacote é 1.1\-3, gera um ficheiro shlibs
que se parece com algo como isto:
 libfoobar 1 libfoobar1 (>= 1.1)
.IP "\fBdh_makeshlibs \-V 'libfoobar1 (>= 1.0)'\fR" 4
.IX Item "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
Gera um ficheiro shlibs que se parece com isto:
  libfoobar 1 libfoobar1 (>= 1.0)
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
\&\fBdebhelper\fR\|(7)
.PP
Este programa é parte do debhelper.
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>
.SH "TRADUÇÃO"
.IX Header "TRADUÇÃO"
Américo Monteiro
.PP
Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro \fIa_monteiro@gmx.com\fR
ou
Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.