`xbps-install` man page: Describe creation of `.new-<version>` files

Aberta
#448 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
1/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
45/100
Tipo de issue
Documentação
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Domínio
cli, documentation

Direção de pesquisa

Start with the existing xbps-install man page and compare its configuration-file behavior with the relevant explanation in xbps.d(5). Document when an existing configuration file is preserved and when a .new- file is created, then verify the wording clearly covers the described situation.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Nowhere in the xbps repo or void-docs repo is it mentioned that if there already exists a config file on the FS that is different from the config file in the package, the config file on disk won't be overwritten, but the new config file will be saved to .new-<version>.

There is this in xbps.d(5):

    keepconf=true|false
        If set to false (default), xbps will overwrite configuration files if
        they have not been changed since installation and a newer version is
        available.

        If set to true, xbps will save the new configuration file as
        <name>.new-<version> if the original configuration file has not been
        changed since installation.

But that doesn't count, because:

  • it's in the wrong man page
  • it describes a specific config setting
  • it doesn´t say anything about the situation I described above
Linguagem predominante
C
Estrelas
1.2k
Forks
156
Merge médio
1h 39min
PRs com merge (30d)
1

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de void-linux/xbps

Todas as issues de void-linux/xbps

Issues semelhantes

Mais issues de C

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.