Makefile 中的二次扩展导致不必要的目标 运行
Secondary expansion in a Makefile is causing unnecessary targets to be run
我正在尝试使用 Latexmk 编写一个使用 LaTeX 构建 PDF 输出的 Makefile。输出具有基本相同的规则,但先决条件不同,因此我尝试使用 GNU Make 的“二次扩展”来概括我的原始 Makefile。 (我还创建了 .PHONY
目标,也进行了二次扩展,以使其更加用户友好。)但是,这导致先决条件规则 always 成为 运行,即使他们不需要。幸运的是,Latexmk 足够聪明,可以避免做不必要的工作,但我想知道我是否做错了什么......
尝试抽象我正在尝试的内容:
,-> foo -> build/foo.pdf
all -{
`-> bar -> build/bar.pdf
即 all
目标构建 foo
和 bar
。这些目标打开各自的 PDF 文件,其先决条件为 build/X.pdf
(其中 X
为 foo
或 bar
)。这些是构建适当 PDF 文件的真实目标。
这是我想出的:
TARGETS = foo bar
BUILD_DIR = build
OUTPUTS = $(TARGETS:%=$(BUILD_DIR)/%.pdf)
commonSRC = src/preamble.tex src/header.tex # etc...
fooSRC = src/foo.tex $(commonSRC) # etc...
barSRC = src/bar.tex $(commonSRC) # etc...
all: $(TARGETS)
.SECONDEXPANSION:
$(TARGETS): $(BUILD_DIR)/$$@.pdf
open $<
# FIXME This isn't quite right: This rule is still getting called by the
# above rule, even when it doesn't need to be. Latexmk is clever enough
# not to do any extra work, but it shouldn't run at all.
.SECONDEXPANSION:
$(OUTPUTS): $$($$(subst .pdf,SRC,$$(@F))) $(BUILD_DIR)
latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $<
$(BUILD_DIR):
mkdir $@
clean:
rm -rf $(BUILD_DIR)
.PHONY: all $(TARGETS) clean
明确一点:每当 XSRC
中列举的文件时,build/X.pdf
的规则应该 运行(同样,其中 X
是 foo
或bar
) 比 PDF 更新,或者 PDF 不存在;但它不应该 运行 否则。
我认为这有点复杂,超出了它的需要。这些第二个扩展语句的一部分可以直接用 static pattern rules. The other thing is that .SECONDEXPANSION:
makes all further Makefile
contents to be subject to second expansion 替换,所以你不需要在每个目标之前明确声明它(这样标记 .PHONY
目标会更清楚,以便快速查看是否目标是否虚假)。
不过,我认为这里最重要的问题是您提到目录作为先决条件。请记住,make
决定是否根据依赖项时间戳重建目标,并且目录的时间戳始终在更新此目录中的文件时更新。因此,每当您编写 $(BUILD_DIR)/foo.pdf
时,$(BUILD_DIR)
时间戳都会更新,并且下一次调用将再次构建,因为目录较新。您可以通过将目录指定为 order-only prerequisite 来避免它(这意味着:如果不存在则构建,但不检查时间戳)。
把它们放在一起我会这样做:
TARGETS = foo bar
BUILD_DIR = build
commonSRC = src/preamble.tex src/header.tex # etc...
fooSRC = src/foo.tex $(commonSRC) # etc...
barSRC = src/bar.tex $(commonSRC) # etc...
.SECONDEXPANSION:
.PHONY: all
all: $(TARGETS)
.PHONY: $(TARGETS)
$(TARGETS): %: $(BUILD_DIR)/%.pdf
echo open $<
$(BUILD_DIR)/%.pdf: $$($$*SRC) | $(BUILD_DIR)
echo latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $< > $@
$(BUILD_DIR):
mkdir -p $@
.PHONY: clean
clean:
rm -rf $(BUILD_DIR)
输出:
$ make all
mkdir -p build
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
echo open build/bar.pdf
open build/bar.pdf
$ make all
echo open build/foo.pdf
open build/foo.pdf
echo open build/bar.pdf
open build/bar.pdf
请注意,后续调用并未尝试构建任何内容,只是打开 pdf。但是它仍然对文件更改做出反应:
$ touch src/foo.tex
$ make all
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo open build/bar.pdf
open build/bar.pdf
$ touch src/header.tex
$ make all
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
echo open build/bar.pdf
open build/bar.pdf
我正在尝试使用 Latexmk 编写一个使用 LaTeX 构建 PDF 输出的 Makefile。输出具有基本相同的规则,但先决条件不同,因此我尝试使用 GNU Make 的“二次扩展”来概括我的原始 Makefile。 (我还创建了 .PHONY
目标,也进行了二次扩展,以使其更加用户友好。)但是,这导致先决条件规则 always 成为 运行,即使他们不需要。幸运的是,Latexmk 足够聪明,可以避免做不必要的工作,但我想知道我是否做错了什么......
尝试抽象我正在尝试的内容:
,-> foo -> build/foo.pdf
all -{
`-> bar -> build/bar.pdf
即 all
目标构建 foo
和 bar
。这些目标打开各自的 PDF 文件,其先决条件为 build/X.pdf
(其中 X
为 foo
或 bar
)。这些是构建适当 PDF 文件的真实目标。
这是我想出的:
TARGETS = foo bar
BUILD_DIR = build
OUTPUTS = $(TARGETS:%=$(BUILD_DIR)/%.pdf)
commonSRC = src/preamble.tex src/header.tex # etc...
fooSRC = src/foo.tex $(commonSRC) # etc...
barSRC = src/bar.tex $(commonSRC) # etc...
all: $(TARGETS)
.SECONDEXPANSION:
$(TARGETS): $(BUILD_DIR)/$$@.pdf
open $<
# FIXME This isn't quite right: This rule is still getting called by the
# above rule, even when it doesn't need to be. Latexmk is clever enough
# not to do any extra work, but it shouldn't run at all.
.SECONDEXPANSION:
$(OUTPUTS): $$($$(subst .pdf,SRC,$$(@F))) $(BUILD_DIR)
latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $<
$(BUILD_DIR):
mkdir $@
clean:
rm -rf $(BUILD_DIR)
.PHONY: all $(TARGETS) clean
明确一点:每当 XSRC
中列举的文件时,build/X.pdf
的规则应该 运行(同样,其中 X
是 foo
或bar
) 比 PDF 更新,或者 PDF 不存在;但它不应该 运行 否则。
我认为这有点复杂,超出了它的需要。这些第二个扩展语句的一部分可以直接用 static pattern rules. The other thing is that .SECONDEXPANSION:
makes all further Makefile
contents to be subject to second expansion 替换,所以你不需要在每个目标之前明确声明它(这样标记 .PHONY
目标会更清楚,以便快速查看是否目标是否虚假)。
不过,我认为这里最重要的问题是您提到目录作为先决条件。请记住,make
决定是否根据依赖项时间戳重建目标,并且目录的时间戳始终在更新此目录中的文件时更新。因此,每当您编写 $(BUILD_DIR)/foo.pdf
时,$(BUILD_DIR)
时间戳都会更新,并且下一次调用将再次构建,因为目录较新。您可以通过将目录指定为 order-only prerequisite 来避免它(这意味着:如果不存在则构建,但不检查时间戳)。
把它们放在一起我会这样做:
TARGETS = foo bar
BUILD_DIR = build
commonSRC = src/preamble.tex src/header.tex # etc...
fooSRC = src/foo.tex $(commonSRC) # etc...
barSRC = src/bar.tex $(commonSRC) # etc...
.SECONDEXPANSION:
.PHONY: all
all: $(TARGETS)
.PHONY: $(TARGETS)
$(TARGETS): %: $(BUILD_DIR)/%.pdf
echo open $<
$(BUILD_DIR)/%.pdf: $$($$*SRC) | $(BUILD_DIR)
echo latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $< > $@
$(BUILD_DIR):
mkdir -p $@
.PHONY: clean
clean:
rm -rf $(BUILD_DIR)
输出:
$ make all
mkdir -p build
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
echo open build/bar.pdf
open build/bar.pdf
$ make all
echo open build/foo.pdf
open build/foo.pdf
echo open build/bar.pdf
open build/bar.pdf
请注意,后续调用并未尝试构建任何内容,只是打开 pdf。但是它仍然对文件更改做出反应:
$ touch src/foo.tex
$ make all
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo open build/bar.pdf
open build/bar.pdf
$ touch src/header.tex
$ make all
echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
echo open build/foo.pdf
open build/foo.pdf
echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
echo open build/bar.pdf
open build/bar.pdf