14 Recursos do GNU make

Aqui está um resumo dos recursos do GNU make, a título de comparação com outras versões do make e em reconhecimento a elas. Como referência, tomamos os recursos do make dos sistemas 4.2 BSD como ponto de partida. Se você se preocupa em escrever makefiles portáveis, não deve usar os recursos listados aqui, nem os apresentados no capítulo Incompatibilidades e recursos não implementados.

Muitos recursos vêm da versão do make do System V.

• A variável VPATH e seu significado especial. Veja a seção Buscar diretórios para pré-requisitos (prerequisites). Esse recurso existe no make do System V, mas não é documentado. Ele é documentado no make do 4.3 BSD (que afirma imitar o recurso VPATH do System V).
• Makefiles incluídos. Veja a seção Incluir outros Makefiles. Permitir que vários arquivos sejam incluídos com uma única diretiva é uma extensão do GNU.
• As variáveis são lidas a partir do ambiente e comunicadas por meio dele. Veja a seção Variáveis do ambiente.
• Opções passadas por meio da variável MAKEFLAGS a invocações recursivas do make. Veja a seção Comunicar opções a um sub-make.
• A variável automática $% recebe o nome do membro em uma referência a arquivo de arquivo (archive). Veja a seção Variáveis automáticas.
• As variáveis automáticas $@, $*, $<, $% e $? têm formas correspondentes como $(@F) e $(@D). Generalizamos isso para $^ como uma extensão óbvia. Veja a seção Variáveis automáticas.
• Referências a variáveis com substituição. Veja a seção Fundamentos das referências a variáveis.
• As opções de linha de comando «-b» e «-m», que são aceitas e ignoradas. No make do System V, essas opções de fato fazem algo.
• Execução de comandos recursivos que invocam o make por meio da variável MAKE, mesmo que «-n», «-q» ou «-t» seja especificado. Veja a seção Uso recursivo do make.
• Suporte ao sufixo «.a» nas regras de sufixo. Veja a seção Regras de sufixo para arquivos de arquivo. Esse recurso está obsoleto no GNU make, porque o recurso geral de encadeamento de regras (veja Cadeias de regras implícitas) faz com que uma única regra de padrão para instalar membros em um arquivo de arquivo (veja Regra implícita para alvos de membro de arquivo) seja suficiente.
• A disposição das linhas e as combinações de barra invertida/quebra de linha nas receitas (recipes) são preservadas quando as receitas são exibidas, de modo que apareçam como estão no makefile, exceto pela remoção do espaço em branco inicial.

Os recursos a seguir foram inspirados em várias outras versões do make. Em alguns casos, não está claro exatamente quais versões inspiraram quais outras.

• Regras de padrão usando «%». Isso foi implementado em diversas versões do make. Não temos certeza de quem o inventou primeiro, mas se espalhou bastante. Veja a seção Definir e redefinir regras de padrão.
• Encadeamento de regras e arquivos intermediários implícitos. Isso foi implementado por Stu Feldman em sua versão do make para o AT&T Eighth Edition Research Unix e, mais tarde, por Andrew Hume, da AT&T Bell Labs, em seu programa mk (onde ele o chama de “fecho transitivo (transitive closure)”). Não sabemos ao certo se obtivemos isso de algum deles ou se o concebemos por conta própria na mesma época. Veja a seção Cadeias de regras implícitas.
• A variável automática $^, que contém uma lista de todos os pré-requisitos do alvo atual. Não fomos nós que a inventamos, mas não fazemos ideia de quem o fez. Veja a seção Variáveis automáticas. A variável automática $+ é uma simples extensão de $^.
• O indicador “e se (what if)” («-W» no GNU make) foi (até onde sabemos) inventado por Andrew Hume no mk. Veja a seção Em vez de executar receitas.
• O conceito de fazer várias coisas ao mesmo tempo (paralelismo) existe em muitas encarnações do make e de programas semelhantes, embora não nas implementações do System V ou do BSD. Veja a seção Execução de receitas.
• Várias ferramentas de build que oferecem suporte a paralelismo também oferecem suporte a coletar a saída e exibi-la como um único bloco. Veja a seção Saída durante a execução paralela.
• Referências a variáveis modificadas usando substituição de padrão vêm do SunOS 4. Veja a seção Fundamentos das referências a variáveis. Essa funcionalidade já era fornecida no GNU make pela função patsubst antes de a sintaxe alternativa ser implementada para compatibilidade com o SunOS 4. Não está totalmente claro quem inspirou quem, já que o GNU make tinha patsubst antes de o SunOS 4 ser lançado.
• O significado especial dos caracteres «+» que precedem as linhas de receita (veja Em vez de executar receitas) é determinado pelo IEEE Standard 1003.2-1992 (POSIX.2).
• A sintaxe «+=» para acrescentar (append) ao valor de uma variável vem do make do SunOS 4. Veja a seção Acrescentar mais texto a variáveis.
• A sintaxe «archive(mem1 mem2…)» para listar vários membros em um único arquivo de arquivo vem do make do SunOS 4. Veja a seção Membros de arquivo de arquivo como alvos.
• A diretiva -include, que inclui makefiles sem gerar erro para arquivos inexistentes, vem do make do SunOS 4. (Mas observe que o make do SunOS 4 não permite especificar vários makefiles em uma única diretiva -include.) O mesmo recurso aparece com o nome sinclude no make do SGI e talvez em outros.
• O operador de atribuição via shell != existe em muitas versões BSD do make e foi implementado aqui propositadamente para se comportar de forma idêntica a essas implementações.
• Diversas ferramentas de gerenciamento de build são implementadas usando linguagens de script como Perl ou Python e, assim, fornecem uma linguagem de script embutida natural, semelhante à integração do GNU Guile pelo GNU make.

Os recursos restantes são invenções novas do GNU make:

• Use a opção «-v» ou «--version» para exibir informações de versão e de direitos autorais.
• Use a opção «-h» ou «--help» para resumir as opções do make.
• Variáveis de expansão simples. Veja a seção Os dois tipos (flavor) de variáveis.
• Passar atribuições de variáveis da linha de comando automaticamente, por meio da variável MAKE, às invocações recursivas do make. Veja a seção Uso recursivo do make.
• Use a opção de comando «-C» ou «--directory» para mudar de diretório. Veja a seção Resumo das opções.
• Definições literais de variáveis com define. Veja a seção Definir variáveis de múltiplas linhas.
• Declarar alvos falsos (phony) com o alvo especial .PHONY.

  Andrew Hume, da AT&T Bell Labs, implementou um recurso semelhante com uma sintaxe diferente em seu programa mk. Isso parece ser um caso de descoberta paralela. Veja a seção Alvos falsos (phony).

• Manipular texto chamando funções. Veja a seção Funções para transformar texto.
• Use a opção «-o» ou «--old-file» para fazer de conta que a hora de modificação de um arquivo é antiga. Veja a seção Evitar a recompilação de alguns arquivos.
• Execução condicional.

  Esse recurso foi implementado inúmeras vezes em várias versões do make; parece uma extensão natural derivada dos recursos do pré-processador C e de linguagens de macro semelhantes, e não um conceito revolucionário. Veja a seção Partes condicionais dos Makefiles.

• Especificar um caminho de busca para os makefiles incluídos. Veja a seção Incluir outros Makefiles.
• Especificar makefiles adicionais a serem lidos por meio de uma variável de ambiente. Veja a seção A variável MAKEFILES.
• Remover sequências iniciais de «./» dos nomes de arquivo, de modo que ./file e file sejam considerados o mesmo arquivo.
• Usar um método de busca especial para pré-requisitos de biblioteca escritos na forma «-lname». Veja a seção Busca de diretórios para bibliotecas de ligação.
• Permitir que os sufixos das regras de sufixo (veja Regras de sufixo à moda antiga) contenham quaisquer caracteres. Em outras versões do make, eles devem começar com «.» e não podem conter caracteres «/».
• Manter o controle do nível atual de recursão do make usando a variável MAKELEVEL. Veja a seção Uso recursivo do make.
• Fornecer, na variável MAKECMDGOALS, quaisquer metas (goals) dadas na linha de comando. Veja a seção Argumentos para especificar as metas.
• Especificar regras de padrão estáticas. Veja a seção Regras de padrão estáticas.
• Fornecer busca vpath seletiva. Veja a seção Buscar diretórios para pré-requisitos.
• Fornecer referências a variáveis computadas. Veja a seção Fundamentos das referências a variáveis.
• Atualizar makefiles. Veja a seção Como os Makefiles são regenerados. O make do System V tem uma forma muito, muito limitada dessa funcionalidade, na medida em que faz o checkout de arquivos SCCS dos makefiles.
• Diversas novas regras implícitas embutidas. Veja a seção Catálogo de regras embutidas.
• Carregar objetos dinâmicos capazes de modificar o comportamento do make. Veja a seção Carregar objetos dinâmicos.