Atualmente estou trabalhando em um pacote onde o usuário pode definir as opções do pacote no meio do documento ou dentro de um grupo local. Atualmente, o usuário pode fazer isso por meio dos comandos do usuário \set<package>keys
ou \reset<package>keys
, que primeiro redefine as opções do pacote para os padrões antes de definir as novas opções. Pretendo que esses comandos sejam usados apenas no nível do documento; eles não devem ser usados diretamente no preâmbulo.
Minha pergunta é: qual é a melhor prática para nomear esses comandos? Minha confusão vem de outro thread de troca de pilha
Opção de pacote versus comando de configuração
onde a resposta principal recomenda que o autor do pacote forneça um comando de usuário chamado \<package>setup
. Além disso, muitos outros pacotes seguem a mesma convenção: siunitx
usa \sisetup
, unicode-math
usa \unimathsetup
, microtype
usa \microtypesetup
, etc. No entanto, acho que o nome \package<setup>
implica, ao contrário do meu pacote atual, que (1) \<package>setup
pode/deve ser usado diretamente no preâmbulo e (2) \<package>setup
configura as opções do pacoteglobalmenteem vez delocalmente.
Eu adiciono a tag expl3
à minha pergunta porque atualmente estou escrevendo um pacote em expl3
. Além disso, as opções do pacote são definidas via l3keys
e \ProcessKeyOptions
.