Voir la source de GNU make

{{IntroductionInformatique
|texte=
}}
== Le principe ==
{{par|1=
La structure d'un fichier {{m|Makefile}} est une suite de règles. Chaque règle a la structure suivante :
{{code|lang=make|code=

target1 target2 ... :  prerequisite1  prerequisite2 ..
        recipe1
        recipe2
        ...

}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Rule-Introduction}}
}}

== Un exemple simple ==
{{Ex|1=
{{code|lang=make|code=
edit : main.o kbd.o command.o display.o \
       insert.o search.o files.o utils.o
        cc -o edit main.o kbd.o command.o display.o \
                   insert.o search.o files.o utils.o
main.o : main.c defs.h
        cc -c main.c
kbd.o : kbd.c defs.h command.h
        cc -c kbd.c
command.o : command.c defs.h command.h
        cc -c command.c
display.o : display.c defs.h buffer.h
        cc -c display.c
insert.o : insert.c defs.h buffer.h
        cc -c insert.c
search.o : search.c defs.h buffer.h
        cc -c search.c
files.o : files.c defs.h buffer.h command.h
        cc -c files.c
utils.o : utils.c defs.h
        cc -c utils.c
clean :
        rm edit main.o kbd.o command.o display.o \
           insert.o search.o files.o utils.o
}}
}}
=== Les variables ===
{{alerte
|texte=Nous devrions utiliser les variables pour la liste dupliquée (inutilement et source d'erreurs) {{mm|main.o kbd.o ...}}
}}
{{Ex|1=Ce qui nous conduit à :
{{code|lang=make|code=
objects = main.o kbd.o command.o display.o \
       insert.o search.o files.o utils.o

edit : $(objects)
        cc -o edit $(objects)

...
clean :
        rm edit $(objects)
}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Variables-Simplify}}
}}

=== Les fausses (PHONY) cibles ===
{{alerte
|texte=la cible {{mm|clean}} doit être déclarée {{m|PHONY}} (fausse cible -> n'est pas un fichier)
}}
{{Ex|1=Ce qui nous conduit à :
{{code|lang=make|code=
.PHONY : clean
clean :
        rm edit $(objects)
}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Cleanup}}
}}

== Les règles implicites ==
=== Les règles implicites fournies par make ===
{{Ex|1=
Dans la règle suivante {{mm|foo.o}} {{mm|bar.o}} n'ont pas de règles de construction. Dans ce cas {{mm|make}} va chercher dans les règles {{m|implicites}}.
{{code|lang=make|code=
foo : foo.o bar.o
        cc -o foo foo.o bar.o $(CFLAGS) $(LDFLAGS)
}}
}}
=== Suffix rules ===
{{Ex|1=
Parmi les règles implicites, il y a celles qui sont fournies par {{mm|make}}, dont voici un exemple avec l'ancienne manière de l'écrire ({{m|Suffix rules}}) :
{{code|lang=make|code=
.c.o:
        $(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
}}
où 
* $(CC) est le compilateur par défaut du langage C.
* $@ est une {{m|variable automatique}}({{more_info|https://www.gnu.org/software/make/manual/make.html#Automatic-Variables}}) désignant la cible, exemple {{mm|foo.o}}
* $< est une {{m|variable automatique}} désignant la source, exemple {{mm|foo.c}} 
{{more_info|https://www.gnu.org/software/make/manual/make.html#Implicit-Rules}}
|2=suffixRule1}}
{{Alerte|texte=
La partie droite (prerequisite) doit être vide sinon l'interprétation change du tout au tout:
}}{{Ex|1=
{{code|lang=make|code=
.c.o: foo.h
        $(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
}}
}}
{{Ex|1=
Dans ce cas la la cible est {{m|{{mm|.c.o}}}} est donc la règle n'est pas implicite, pour décrire une telle règle implicite il faut utiliser la nouvelle façon, {{m|pattern rules}} :
{{code|lang=make|code=
%.o: %.c foo.h
        $(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
}}
}}

=== Pattern rules ===
{{Ex|1=
Ainsi la première {{clinkn|suffixRule1|règle}} implicite en {{m|pattern rule}} serait :
{{code|lang=make|code=
%.o: %.c
        $(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $< 
}}
}}{{Ex|1=
ou 
{{code|lang=make|code=
objects = foo.o bar.o 

all: $(objects)

$(objects): %.o: %.c
        $(CC) -c $(CFLAGS) $< -o $@
}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Static-Pattern}}
}}
=== Les règles implicites par défaut ===
{{par|1=On obtient la liste des règles par défaut en exécutant la commande suivante dans un répertoire ne contenant pas de fichier {{mm|Makefile}} :
{{code|lang=bash|code=
make -p
}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Catalogue-of-Rules}}
}}
{{ex|1=On obtient par exemple la liste des suffixes :
{{code|lang=make|code=
.SUFFIXES: .out .a .ln .o .c .cc .C .cpp .p .f .F .m .r .y .l .ym .yl .s .S .mod .sym .def .h .info .dvi .tex .texinfo .texi .txinfo .w .ch .web .sh .elc .el
}}
}}
{{ex|1=On obtient par exemple la règle pour les sources dans le langage {{mm|C}} :
{{code|lang=make|code=
OUTPUT_OPTION = -o $@
# …
.c.o:
	$(COMPILE.c) $(OUTPUT_OPTION) $<
}}
}}
{{ex|1=On obtient par exemple la règle pour les sources dans le langage {{mm|c++}} :
{{code|lang=make|code=
OUTPUT_OPTION = -o $@
# …
.cpp.o:
	$(COMPILE.cpp) $(OUTPUT_OPTION) $<
}}
}}
{{ex|1=On obtient par exemple pour lier les fichiers binaires compilés :
{{code|lang=make|code=
LINK.o = $(CC) $(LDFLAGS) $(TARGET_ARCH)
# …
%: %.o
	$(LINK.o) $^ $(LOADLIBES) $(LDLIBS) -o $@
}}
}}
=== Annulation d'une règle implicite par défaut ===
{{par|1=On réécrit la règle sans fournir la recette :
{{code|lang=make|code=

%.o : %.c

}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Canceling-Rules}}
}}

== Un autre style ==
{{Ex|1=En utilisant les règles implicites on peut écrire plusieurs cibles pour un seul source :
{{code|lang=make|code=
objects = main.o kbd.o command.o display.o \
          insert.o search.o files.o utils.o

edit : $(objects)
        cc -o edit $(objects)

$(objects) : defs.h

kbd.o command.o files.o : command.h

display.o insert.o search.o files.o : buffer.h

}}
{{more_info|https://www.gnu.org/software/make/manual/make.html#Combine-By-Prerequisite}}
}}

== Liens ==
{{parW|1=
* Doc
*: https://www.gnu.org/software/make/manual/make.html
}}