Plugin Comentário¶
Comente e descomente código usando a própria sintaxe de comentário da linguagem, escolhida automaticamente a partir do tipo do arquivo. As operações de linha atuam sobre linhas inteiras; as de bloco envolvem uma seleção com marcadores de comentário de bloco.
Onde encontrá-lo¶
Editar ▸ Comentário:
| Comando | Atalho | Atua sobre |
|---|---|---|
| Alternar comentário de uma linha | Ctrl+Q (⌃Q no macOS) |
as linhas selecionadas, ou a linha do cursor |
| Comentário de uma linha | Ctrl+K |
as linhas selecionadas, ou a linha do cursor |
| Remover comentário de uma linha | Ctrl+Shift+K |
as linhas selecionadas, ou a linha do cursor |
| Comentário de bloco | Ctrl+Shift+Q (⌃⇧Q no macOS) |
o intervalo de bytes selecionado |
| Remover comentário de bloco | — | o intervalo de bytes selecionado |
Como funciona¶
- Os comandos de linha acrescentam ou removem o marcador de linha da
linguagem (p. ex.
//,#,--) no começo de cada linha que a seleção toca. Alternar comenta as linhas quando alguma está sem comentário, e as descomenta caso contrário. - Os comandos de bloco envolvem ou desenvolvem a seleção com os marcadores de
bloco da linguagem (p. ex.
/* … */,<!-- … -->). O comentário de bloco precisa de uma seleção não vazia; sem nada selecionado ele mostra um aviso na barra de status.
Os marcadores de comentário vêm do tipo de arquivo do documento (pela
extensão). Um buffer sem título ou uma extensão desconhecida recorrem aos
marcadores estilo C (// e /* */). Se um tipo de arquivo não tem sintaxe de
linha, os comandos de linha informam "Nenhuma sintaxe de comentário de linha
conhecida para este arquivo"; o mesmo vale para a sintaxe de bloco.
Alternar é o que vale a pena lembrar
Ctrl+Q alterna, então você raramente precisa dos comandos explícitos de
comentar/descomentar — eles existem para quando você quer forçar uma direção.