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 目标构建 foobar。这些目标打开各自的 PDF 文件,其先决条件为 build/X.pdf(其中 Xfoobar)。这些是构建适当 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 的规则应该 运行(同样,其中 Xfoobar) 比 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