Início / unix / Perguntas / 778721
Accepted
Popup
Asked: 2024-06-21 14:53:32 +0800 CST

Convenção de nomenclatura de parâmetros - opções não documentadas

  • 772

O GNU há muito pressiona por uma combinação de opções curtas ( -h) e opções longas ( --help), o que ajuda bastante a esclarecer a confusão sintática de comandos como tare dd, com sua sintaxe legada que remonta à idade da pedra.

Mas aprendi recentemente que o GNU partedtem um terceiro tipo de opção, onde um 'recurso não documentado' pode ser acessado com ---pretend-input-tty. Parece que foi introduzido neste commit em 2007.

É a primeira vez que vejo isso e estou intrigado. Trata-se de algum tipo de convenção mais ampla ou apenas pontual?

gnu

1 respostas

  1. Best Answer

    Opções longas não documentadas começando com 3 travessões são de fato difundidas em software do projeto GNU. Até onde eu sei, isso não é mencionado nos padrões de codificação GNU .

    Outros exemplos de busca {"-.*argumentnos arquivos C na árvore de origem de alguns pacotes de software GNU:

    coreutils/src/du.c:  /* {"-debug", no_argument, nullptr, FTS_DEBUG}, */
coreutils/src/factor.c:  {"-debug", no_argument, nullptr, DEV_DEBUG_OPTION},
coreutils/src/head.c:  {"-presume-input-pipe", no_argument, nullptr,
coreutils/src/numfmt.c:  {"-debug", no_argument, nullptr, DEV_DEBUG_OPTION},
coreutils/src/rm.c:  {"-presume-input-tty", no_argument, nullptr, PRESUME_INPUT_TTY_OPTION},
coreutils/src/split.c:  {"-io-blksize", required_argument, nullptr,
coreutils/src/stty.c:  {"-debug", no_argument, nullptr, DEV_DEBUG_OPTION},
coreutils/src/tail.c:  {"-disable-inotify", no_argument, nullptr,
coreutils/src/tail.c:  {"-presume-input-pipe", no_argument, nullptr,
diffutils/src/diff.c:  {"-no-directory", no_argument, nullptr, NO_DIRECTORY_OPTION},
diffutils/src/diff.c:  {"-presume-output-tty", no_argument, nullptr, PRESUME_OUTPUT_TTY_OPTION},

    Entre eles, o mais antigo que consegui encontrar em uma rápida olhada nos logs do git foi o taildo ---disable-inotify( mencionado em algumas perguntas e respostas aqui ), que foi adicionado em 2009.

    commit 526a057602f7f312443ae4ec0653fec84bca9ff2
Author: Pádraig Brady <[email protected]>
Date:   Fri Sep 4 21:41:30 2009 +0100

    tests: test old tail -f method even on systems with inotify

    * src/tail.c (main): Add an undocumented ---disable-inotify option

    Em qualquer caso, uma opção não documentada é aquela que não está comprometida e pode desaparecer sem aviso prévio numa versão futura. Usar essa ---optionconvenção é bom porque é um lembrete de que ela não veio para ficar.

    Existem também opções não documentadas de uma única letra, como o -Xdo GNU grepou opções que possuem outro alias não documentado para compatibilidade com outras implementações, como o --text/ --binarydo GNU cksum.

    Alguns começaram como não documentados, como o -Edo GNU sed(para compatibilidade com BSD, GNU tendo -rem vez disso), mas acabaram sendo documentados mais tarde (no caso de sed's -Eporque foi esse que acabou sendo especificado pelo POSIX e também é indiscutivelmente um muito melhor, pois é consistente grep -Ee faz muito mais sentido Epara xtended do que para egex).Err

    • 6

relate perguntas