Formatação de Makefile

O parser do Make usa um único caractere de tab como prefixo unívoco que marca uma linha como parte da receita de uma regra. Essa escolha data da primeira versão pública do make em 1977 e foi consolidada porque os tabs eram um sinal confiável, que aparecia no início da linha e não colidiria com espaços dentro de atribuições de variáveis ou definições de alvos. Mesmo causando confusão por décadas, mudar essa regra silenciosamente quebraria milhões de Makefiles existentes, por isso o GNU make mantém o tab como o padrão RECIPEPREFIX.

Atribuição recursiva (=) adia a expansão até que a variável seja usada, então as variáveis referenciadas são pesquisadas no momento do uso. Atribuição simples (:=) e atribuição simples POSIX (::=) expandem o lado direito imediatamente, então o valor é fixo no momento da definição. Atribuição condicional (?=) define a variável apenas se ela estiver atualmente indefinida, o que é útil para valores padrão que podem ser sobrescritos pelo ambiente. Atribuição de anexação (+=) adiciona ao valor existente, preservando o comportamento recursivo ou simples do original. Atribuição de shell (!=) executa o lado direito como um comando de shell e armazena a saída resultante, semelhante a backticks em shell.

Uma linha de receita é a linha indentada que executa como parte das ações de uma regra; no make padrão, ela deve começar com um caractere de tab. Uma linha de continuação é qualquer linha cuja linha anterior termina com um caractere de barra invertida, que logicamente une as duas linhas em uma. As linhas de continuação herdam o contexto da linha anterior, então uma continuação de receita continua sendo uma receita e uma continuação de atribuição continua sendo uma atribuição. A indentação de uma linha de continuação é apenas estética e não altera como o make a analisa.

A declaração .PHONY informa o make que os nomes listados não são arquivos reais, mas rótulos de ação, então o make deve sempre executar suas receitas, independentemente de qualquer arquivo com o mesmo nome no diretório de trabalho. Sem isso, um arquivo chamado clean desativaria automaticamente o comando make clean porque o make consideraria o alvo atualizado. O .PHONY não altera as regras de análise de receitas ou de indentação — as linhas de receita sob alvos .PHONY ainda devem começar com um caractere de tab — mas altera a lógica de comparação de timestamps, para que a receita seja considerada fora de data em cada chamada.