diff options
Diffstat (limited to 'doc/git-permalink.pt.1')
| -rw-r--r-- | doc/git-permalink.pt.1 | 210 |
1 files changed, 0 insertions, 210 deletions
diff --git a/doc/git-permalink.pt.1 b/doc/git-permalink.pt.1 deleted file mode 100644 index 5b8ae4a..0000000 --- a/doc/git-permalink.pt.1 +++ /dev/null @@ -1,210 +0,0 @@ -.\"******************************************************************* -.\" -.\" This file was generated with po4a. Translate the source file. -.\" -.\"******************************************************************* -.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "manual do usuário do git\-permalink" - - -.SH NOME - -git\-permalink \- extensão Git para gerar links web permanentes (permalink) de -arquivos de um repositório. - - -.SH SINOPSE - -\fBgit\-permalink\fP [\fIOPÇÕES\fP] \fIARQUIVO\fP [\fINOLINHA\fP] - - -.SH DESCRIÇÃO - -\fBgit\-permalink\fP usa o próprio Git para pegar a) o commit do \fIHEAD\fP e b) o -\fIremote.origin.url\fP usando \fBgit\-config\fP(1), e opcionalmente c) um modelo -de substituição de URL. Então ele usa esses valores para construir o link -para uma URL \fIpermanente\fP (permalink), com o commit incluso para garantir -sua unicidade, e opcionalmente o número da linha selecionada. - -\fBgit\-permalink\fP depois usa o \fBxdg\-open\fP(1) para abrir a URL. - -.SH OPÇÕES - -.TP -\fB\-p\fP -Somento imprime o link da URL web na saída padrão (STDOUT), não tenta -abrí\-lo com \fBxdg\-open\fP(1) ou fazer qualquer coisa com ele. Por padrão isso -está desligado. - -.TP -\fB\-\-help\fP, \fB\-h\fP -Mostra mensagem de ajuda. - -.TP -\fB\-\-version\fP, \fB\-V\fP -Imprime o número da versão. - - -.SH CONFIGURAÇÃO - -.SS "ORIGENS REMOTAS COM SUPORTE" - -A lista atual de origens remotas com suporte é: - -.RS -.IP \(bu -git.euandreh.xyz (onde o próprio git\-permalink está hospedado =p) -.IP \(bu -sourcehut -.IP \(bu -git.kernel.org -.IP \(bu -savannah -.IP \(bu -notabug -.IP \(bu -codeberg -.IP \(bu -bitbucket -.IP \(bu -pagure -.IP \(bu -gitlab -.IP \(bu -github -.RE - -Mudanças para adição de mais sites de hospedagem de código são bem\-vindas! - -Veja -.UR https://euandreh.xyz/git\-permalink/TODOs.html#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a -#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a -.UE -para discussão e mais -informações. - -.SS MODELOS - -Se você quiser configurar o modelo de substituição de URL de um projeto que -não tem suporte a um tipo de origem remota você pode fazê\-lo com -\fBgit\-config\fP(1). - -Há dois tipos de opções de configuração disponíveis: - -.TP -\fBgit\-permalink.template\-file\-commit\fP -Um modelo de substituição de URL em que o nome do \fIarquivo\fP vem primeiro, e -o \fIcommit\fP vem depois. cgit usa esse tipo de URL, como em: - -.nf - https://git.euandreh.xyz/fallible/tree/%s?id=%s -.fi - -Nesse exemplo, o nome do \fIarquivo\fP vem primeiro e o \fIcommit\fP vem só no -final, depois do "id=". - -.TP -\fBgit\-permalink.template\-commit\-file\fP -Um modelo de substituição de URL em que o \fIcommit\fP vem primeiro, e o nome -do \fIarquivo\fP vem depois. sourcehut usa esse tipo de URL, como em: - -.nf - https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s -.fi - -Nesse exemplo, o \fIcommit\fP aparece primeiro no caminho da URL, e o nome do -\fIarquivo\fP vem depois. - -.P -Se nenhuma das duas opções for encontrada pelo \fBgit\-config\fP(1) e o -\fBgit\-permalink\fP não consegue adivinhar a URL, ele termina com um erro. - - -.SH EXEMPLOS - -Abre o arquivo \fIsrc/fold.c\fP de um projeto com a origem apontada para o -\fIsourcehut\fP: - -.nf - $ git permalink src/fold.c 125 - Abrindo https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125 -.fi - -Gera um link das linhas 59 a 94 do arquivo \fInongnu/packages/clojure.scm\fP em -um projeto hospedado no \fIgitlab\fP, mas somente o imprimie \fIsem\fP abrí\-lo com -\fBxdg\-open\fP(1): - -.nf - $ git permalink \-p nongnu/packages/clojure.scm 59\-94 - https://gitlab.com/nonguix/nonguix/\-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59\-94 -.fi - -.P -Configura um modelo de URL, e abre o arquivo \fIsrc/app_add.c\fP sem selecionar -uma linha específica: - -.nf - $ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s' - $ git permalink src/app_add.c - Abrindo https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3 -.fi - -.P -Abre o arquivo \fI\-\-help\fP: - -.nf - $ git permalink \-\- \-\-help - Abrindo https://git.euandreh.xyz/non\-existent\-repository/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e -.fi - -.SH "CÓDIGO DE SAÍDA" - -.TP -\fB0\fP -Execução bem\-sucedida. - -.TP -\fB1\fP -Sem suporte à origem remota. Veja a lista de quais tem suporte em ORIGENS -REMOTAS COM SUPORTE, e como adicionar origens customizadas a parteir de um -model em MODELOS. - -.TP -\fB2\fP -Argumentos inválidos. - - -.SH "VEJA TAMBÉM" - -\fBgit\-config\fP(1) \fBxdg\-open\fP(1) - - -.SH AUTORES - -.MT eu@euandre.org -EuAndreh -.ME -e colaboradores. - - -.SH BUGS - -.IP \(bu -Relate bugs na -.MT ~euandreh/public\-inbox@lists.sr.ht -lista de discussão -.ME . -Use o assunto "\f(CR[git\-permalink] BUG ou TASK: -<descrição>\fR". -.IP \(bu -Veja os bugs -.UR https://euandreh.xyz/git\-permalink/TODOs.html -online -.UE . -.IP \(bu -.UR https://euandreh.xyz/git\-permalink/ -Página inicial -.UE . -.IP \(bu -.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D -Comentários e discussões -.UE . |