Makefile 中的二次扩展导致运行不必要的目标

问题描述

我正在尝试使用 latexmk 编写一个使用 LaTeX 构建 PDF 输出的 Makefile。输出具有基本相同的规则，具有不同的先决条件，因此我尝试使用 GNU Make 的“二次扩展”来概括我的原始 Makefile。 （我还创建了 .PHONY 目标，也带有二次扩展，以使其更加用户友好。）但是，这导致先决条件规则始终运行，即使它们不运行”不必如此。幸运的是，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

需要说明的是：build/X.pdf 的规则应该在 XSRC 中枚举的文件时运行（同样，其中 X 是 foo 或 bar）比 PDF 更新，或者 PDF 不存在；但它不应该以其他方式运行。

解决方法

我相信这有点复杂，超出了它的需要。这些第二个扩展语句的一部分可以用 static pattern rules 替换。另一件事是 .SECONDEXPANSION: 使所有进一步的 Makefile 内容都受制于 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