I3: Melhorar a distinção entre diretivas de configuração e comandos

Criado em 20 mar. 2019 · 4Comentários · Fonte: i3/i3

Estou enviando um…

 [ ] Erro
 [] Solicitação de recurso
 [x] Solicitação de Documentação
 [ ] Outro (Descreva em detalhes)

Comportamento atual

Em nossos canais de suporte, vejo uma confusão frequente de diretivas e comandos de configuração, especificamente quando se trata de for_window e critérios de correspondência. Devemos deixar claro qual é a diferença entre config/comandos, e que um usuário só pode executar comandos em tempo de execução, mas não alterar config.

i3 4,16

4.16 accepted documentation enhancement good first issue

Fonte

Airblader

Comentários muito úteis

Ok, eu vou chegar a ele o. Obrigado.

jeffhuxen em 21 mar. 2019

👍2

Todos 4 comentários

Eu estaria disposto a fazer isso. Isso seria tão simples quanto um arquivo de texto ou eu editaria o arquivo de documentação?

jeffhuxen em 20 mar. 2019

Devemos atualizar o guia do usuário para isso ( docs/userguide ). Ele em si já está separado em configuração e comandos, mas acho que a distinção não é clara o suficiente para os usuários. As seções relevantes são

Particularmente no último, uma dica explícita de que as diretivas de configuração listadas em https://i3wm.org/docs/userguide.html#configuring não podem ser alteradas em tempo de execução, a menos que tenham um comando equivalente, seria extremamente útil, eu acho.

Airblader em 21 mar. 2019

Ok, eu vou chegar a ele o. Obrigado.

jeffhuxen em 21 mar. 2019

👍2

Eu concordo, a seção for_window começa com