Melhores práticas para definir opções de pacote no meio do documento

Melhores práticas para definir opções de pacote no meio do documento

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>keysou \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: siunitxusa \sisetup, unicode-mathusa \unimathsetup, microtypeusa \microtypesetup, etc. No entanto, acho que o nome \package<setup>implica, ao contrário do meu pacote atual, que (1) \<package>setuppode/deve ser usado diretamente no preâmbulo e (2) \<package>setupconfigura 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 l3keyse \ProcessKeyOptions.

informação relacionada