.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: pkgctl-version-setup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-01-27
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH PKGCTL\-VERSION\-SETUP 1 "27 janeiro 2026" \ \& \ \&
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de  URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if  \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH NOME
pkgctl\-version\-setup \- Detecta e configura automaticamente uma configuração
básica do nvchecker
.SH SINOPSE
.sp
pkgctl version setup [OPÇÕES] [PKGBASE.\|.\|.]
.SH DESCRIÇÃO
.sp
Este subcomando automatiza a criação de um arquivo de configuração básico
nvchecker(1) analisando o array de fontes especificada no arquivo
PKGBUILD(1) de um pacote. Este comando detecta de forma inteligente várias
plataformas e APIs (por exemplo, GitHub, GitLab, PyPI) usadas pelas fontes
do pacote e gera uma configuração \f(CR.nvchecker.toml\fR correspondente com
base em sua melhor estimativa.
.sp
Isso é particularmente útil para inicializar as configurações do
nvchecker(1) para um pacote sem criar manualmente o arquivo
\&\f(CR.nvchecker.toml\fR. Ele simplifica o processo de configuração de
verificações de versão, especialmente ao fazer a transição de um
monitoramento de pacote de uma plataforma de fontes para outra ou ao iniciar
verificações de versão para um novo pacote.
.sp
Se nenhum \f(CRPKGBASE\fR for especificado, o comando usará por padrão o
diretório de trabalho atual.
.sp
Para obter uma lista de fontes suportadas e seus formatos de URL esperados,
consulte a seção de fontes.
.SH OPÇÕES
.sp
\fB\-f, \-\-force\fP
.RS 4
Sobrescreve a configuração existente do nvchecker(1)
.RE
.sp
\fB\-\-prefer\-platform\-api\fP
.RS 4
Prefere a API GitHub/GitLab específica da plataforma em vez do Git para
casos complexos
.RE
.sp
\fB\-\-url\fP \fIURL\fP
.RS 4
Deriva o alvo de verificação do URL fornecido em vez das entradas do array
de fontes
.RE
.sp
\fB\-\-no\-check\fP
.RS 4
Não executa pkgctl\-version\-check(1) após a configuração
.RE
.sp
\fB\-\-no\-upstream\fP
.RS 4
Define uma configuração em branco para pacotes sem fontes upstream, como
metapacotes. Isso deve ser usado apenas em casos sem upstream. Entre em
contato com a equipe de desenvolvimento para obter orientação sobre fontes
upstream difíceis de configurar.
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
Mostra um texto de ajuda.
.RE
.SH FONTES
.sp
Aqui estão as plataformas e fontes atualmente suportadas, juntamente com
exemplos de formatos de URL que permitem sua detecção automática como tipos
de fontes específicos:
.sp
\fBGit\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git://git.foobar.org/example
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git+https://git.foobar.org/example
.RE
.RE
.sp
\fBGitHub\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project/archive/v1.0/project\-v1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBGitLab\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools.git" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools/\-/releases/v1.1.0/downloads/devtools\-v1.1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBHackage\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad\-0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.RE
.sp
\fBNPM\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://registry.npmjs.org/node\-gyp/\-/node\-gyp\-10.0.1.tgz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://www.npmjs.com/package/node\-gyp" "" ""
.RE
.RE
.sp
\fBPyPI\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.io/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/packages/source/b/bleach" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://files.pythonhosted.org/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/project/SQLAlchemy/" "" ""
.RE
.RE
.sp
\fBRubyGems\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/downloads/diff\-lcs\-1.5.1.gem" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/gems/diff\-lcs" "" ""
.RE
.RE
.sp
\fBCPAN\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.RE
.sp
\fBcrates.io\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://static.crates.io/crates/shotgun/shotgun\-1.0.crate" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/api/v1/crates/shotgun/1.0/download" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/crates/git\-smash" "" ""
.RE
.RE
.SH EXEMPLOS
.sp
\fBpkgctl version setup\fP
.RS 4
Detecta fontes do diretório atual\(cqs PKGBUILD(1) e configura um
\&\f(CR.nvchecker.toml\fR básico.
.RE
.sp
\fBpkgctl version setup \-\-url
.URL "https://github.com/example/project" "" "\fP"
\fP
.RS 4
\fBGera um \fP\f(CR.nvchecker.toml\fB para o PKGBUILD(1) atual, mas substitui a URL de fontes pelo projeto GitHub especificado.\fP
.RE
.SH "VEJA TAMBÉM"
.sp
pkgctl\-version(1)  pkgctl\-version\-check(1)  nvchecker(1)  PKGBUILD(5)
.SH SITE
.sp
\fI
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
\fP
.sp
\fIPor favor, relate bugs e solicitações de recursos no rastreador de problemas. Por favor, faça o seu melhor para fornecer um caso de teste reproduzível para bugs.\fP
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Rafael Fontenelle <rafaelff@gnome.org>
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .