Comentários embutidos para Bash?

Eu gostaria de comentar um único sinalizador em um comando de uma linha. Bash apenas parece ter from # till end-of-linecomentários. Estou vendo truques como:

ls -l $([ ] && -F is turned off) -a /etc

É feio, mas melhor que nada. Existe uma maneira melhor?

O seguinte parece funcionar, mas não tenho certeza se é portátil:

ls -l `# -F is turned off` -a /etc

O meu preferido é:

Comentando em um script Bash

Isso terá alguma sobrecarga, mas tecnicamente ele responde à sua pergunta

echo abc `#put your comment here` \
     def `#another chance for a comment` \
     xyz etc

E para tubulações especificamente, existe uma solução mais limpa, sem custos indiretos

echo abc |        # normal comment OK here
     tr a-z A-Z | # another normal comment OK here
     sort |       # the pipelines are automatically continued
     uniq         # final comment

Como colocar um comentário de linha para um comando de várias linhas

Acho mais fácil (e mais legível) copiar a linha e comentar a versão original:

#Old version of ls:
#ls -l $([ ] && -F is turned off) -a /etc
ls -l -a /etc

$(: ...) é um pouco menos feio, mas ainda não é bom.

Que tal armazená-lo em uma variável?

#extraargs=-F
ls -l $extraargs -a /etc

Aqui está minha solução para comentários embutidos entre vários comandos canalizados.

Exemplo de código não comentado:

    #!/bin/sh
    cat input.txt \
    | grep something \
    | sort -r

Solução para um comentário de canal (usando uma função auxiliar):

    #!/bin/sh
    pipe_comment() {
        cat - 
    }
    cat input.txt \
    | pipe_comment "filter down to lines that contain the word: something" \
    | grep something \
    | pipe_comment "reverse sort what is left" \
    | sort -r

Ou, se preferir, aqui está a mesma solução sem a função auxiliar, mas é um pouco mais confusa:

    #!/bin/sh
    cat input.txt \
    | cat - `: filter down to lines that contain the word: something` \
    | grep something \
    | cat - `: reverse sort what is left` \
    | sort -r

A maioria dos comandos permite que os argumentos cheguem em qualquer ordem. Basta mover os sinalizadores comentados para o final da linha:

ls -l -a /etc # -F is turned off

Em seguida, para ativá-lo, remova o comentário e remova o texto:

ls -l -a /etc -F

Se você souber que uma variável está vazia, use-a como um comentário. Obviamente, se não estiver vazio, ele estragará seu comando.

ls -l $ {1 # -F está desativado} -a / etc

§ 10.2 Substituição de Parâmetros

Para desativar uma parte de um comando como a && b, simplesmente criei um script vazio xque está no caminho, para que eu possa fazer coisas como:

mvn install && runProject

quando eu preciso construir, e

x mvn install && runProject

quando não (usando Ctrl + Ae Ctrl + Epara ir para o início e o fim).

Conforme observado nos comentários, outra maneira de fazer isso é o Bash interno, em :vez de x:

$  : Hello world, how are you? && echo "Fine."
Fine.

Se o comentário vale a pena ser feito, provavelmente ele pode ir no final da linha ou em uma linha por conta própria. Raramente acho necessário comentários dentro da linha com o código antes e depois do comentário em qualquer idioma.

Ah, há uma exceção, que é o dialeto do SQL que eu costumo usar que usa '{comments}'. Ocasionalmente, escreverei:

CREATE UNIQUE INDEX u1_table ON Table(...);
CREATE {DUPS} INDEX d1_table ON Table(...);

Mas mesmo isso é exagero.