Uma solicitação pull foi enviada esta semana para introduzir o subsistema GenPD e adicionar uma nova área de drivers/genpd para os drivers do provedor GenPD ao kernel... O que levou Linus Torvalds a se questionar o que diabos é "GenPD", como provavelmente a maioria de vocês também está se perguntando.
O criador do Linux, Linus Torvalds, às vezes é conhecido por expressar sua desaprovação em relação a algumas siglas, e o alvo de sua irritação desta semana foi o GenPD. Esta solicitação pull adiciona o subsistema do provedor GenPD e começa a mover outro código existente do SoC para lá, já que possui cerca de 60 usuários da interface do provedor GenPD no kernel. No entanto, nunca explicaram o que é o GenPD. Portanto, outra mensagem clássica de Linus Torvalds:
"Eu estava começando a analisar isso e tentei descobrir o que diabos é 'genpd'.
Absolutamente nada na solicitação pull explica o que isso pode ser.
Mesmo depois de olhar para isso, não consegui encontrar nada útil.
O mais próximo parece ser a entrada no arquivo MAINTAINERS que diz "PROVEDORES DE DOMÍNIO PM GENÉRICO", o que, na verdade, não esclarece nada.
Ok, então temos uma opção Kconfig para PM_GENERIC_DOMAINS, então dei uma olhada nisso. Não possui texto de ajuda, pois é completamente gerado internamente.
Resultado final: decidi que, sem qualquer tipo de explicação, 'genpd' é um nome completamente inútil e que não quero adicionar aleatoriamente um novo diretório sem nenhuma explicação sobre o que diabos é.
Então acabei desfazendo, porque se eu tivesse que pesquisar no Google o que é, não iria aceitar.
Podemos concordar que
(a) cinco letras aleatórias seguidas não constituem documentação
(b) se tivermos um novo subsistema, ele deve ter alguma explicação para isso
E mesmo se você me enviar uma nova solicitação pull com uma explicação real para o termo, será que realmente temos que usar um nome tão terrivelmente desagradável?
Este não é algum tipo de abreviação padrão da indústria.
Sim, o Google mostra que o termo "genpd" tem sido usado há alguns anos no mundo do Linux SoC, mas será que temos tão pouco espaço em disco que não podemos usar nomes mais descritivos?
Agora olho para essa área bagunçada sem nenhuma documentação e percebo que ela também faz parte da série de solicitações de pull do SoC do Arnd.
Que coisa horrível é essa. Por favor, não use combinações aleatórias de letras que não tenham absolutamente nenhum significado para ninguém e que nem sejam explicadas."
Torvalds então respondeu a si mesmo, acrescentando:
"Nota lateral: pelo menos para mim, 'gen' é a abreviação de 'gerar'. Olhando para a nomenclatura existente no kernel, é assim que a usamos (muitos exemplos disso em diferentes áreas).
Também temos "genérico"? Sim. E como 'gen' não significa 'genérico' para ninguém, normalmente o explicamos - como em asm-genérico, mas também 'som/soc/genérico', ou na verdade muitos outros exemplos.
Porque realmente não estamos tão próximos de ficar sem letras.
Quanto à parte 'pd', na verdade tem um significado bastante utilizado na indústria, mas tende a ser 'fornecimento de energia', no sentido de USB-C.
Então eu realmente acho essa abreviação ativamente enganosa,
Sei que o código SoC usou essa abreviação internamente, mas depois de expô-lo dessa forma, realmente acho que você deveria fazer um trabalho muito melhor na nomenclatura.
GenPD, neste contexto, acaba significando Domínios Genéricos de Energia e é uma abstração de como a energia é controlada para componentes em um SoC com o relacionamento entre dispositivos e controladores de energia. Não é realmente empolgante para os usuários finais, mas é importante para o pessoal do SoC e é o exemplo mais recente da importância de uma nomenclatura precisa.
Linus Torvalds acabou aceitando a solicitação de pull na noite passada, mas solicitou que este subsistema fosse renomeado antes do encerramento da janela de mesclagem do Linux 6.6 no final da próxima semana. Foram sugeridos nomes como renomeá-lo simplesmente para drivers/power/genérico, pelo menos fornecendo mais clareza do que apenas "GenPD".
Até a próxima !!
Nenhum comentário:
Postar um comentário