在并行 automake 中使用 help2man

Question

我正在开发一个使用 GNU 自动工具（autoconf、automake）构建的项目。它确实运行良好，但我遇到了 help2man 的问题：在构建并行 (MAKEFLAGS=-j3) 时，项目被构建了两次 - 一次使用“正常”目标，一次使用 foo.1 进行调用。

以下是来自Makefile.am的相关部分：

foo.1 : $(top_srcdir)/man/foo.x $(top_srcdir)/src/main.c $(top_srcdir)/configure.ac
    $(MAKE) $(AM_MAKEFLAGS) foo$(EXEEXT)
    -$(HELP2MAN) -o $@ --include $< $(top_builddir)/foo

所以，我的问题是如何编写Makefile.am 来支持以下内容：

1. 分发foo.1 以支持没有help2man 的系统
2. 不要抛出错误
3. 必要时重建联机帮助页

期待你的回答

Answer 1

foo.1 需要正确的先决条件。 AIUI，help2man 只需要构建可执行二进制文件：

foo.1 : $(top_srcdir)/man/foo.x $(top_srcdir)/configure.ac $(top_builddir)/foo
        -$(HELP2MAN) -o $@ --include $< $(top_builddir)/foo

那就是 3)

不明白你想要从 2) 中得到什么，这通常是不可能的。

dist_man_MANS = foo.1

这是 1)

Answer 2

这个问题似乎没有简单的解决方案；以下对我有用。

在configure.ac，你必须检查 help2man。如果交叉编译，你不能运行 help2man，因为可执行文件会被运行。因此包含以下 sn-p：

# Man pages
AS_IF([test "$cross_compiling" = "no"], [
    AM_MISSING_PROG([HELP2MAN], [help2man])
], [
    HELP2MAN=:
])

对于建筑，有两个层次的概念。首先，检查联机帮助页是否比可执行文件新；如果是这样，为了禁止不必要的联机帮助页重建，您可以使用联机帮助页本身最后一次更改的临时文件检查源。所以，Makefile.am 包含：

dist_man_MANS = foo.1
EXTRA_DIST += $(dist_man_MANS:.1=.x) common.x
MOSTLYCLEANFILES += $(dist_man_MANS:=-t)
MAINTAINERCLEANFILES += $(dist_man_MANS)

common_dep = $(top_srcdir)/common.x $(top_srcdir)/configure.ac $(top_srcdir)/.version
common_indirect_dep = $(top_srcdir)/common.x $(top_srcdir)/configure $(top_srcdir)/.version
foo.1 : $(common_indirect_dep) $(top_builddir)/foo$(EXEEXT)
foo.1-t : $(common_dep) $(top_srcdir)/main-helpversion.c

SUFFIXES += .x .1 .1-t
.x.1:
    test -f $@ || if test -f $(top_srcdir)/`echo $@ | $(SED) -e 's,.*/,,'`; then \
        touch -r $(top_srcdir)/`echo $@ | $(SED) -e 's,.*/,,'` $@; \
    else \
        touch -d @0 $@; \
    fi
    touch -r $@ $@-t
    $(MAKE) $(AM_MAKEFLAGS) $@-t
    if test -s $@-t; then \
        mv -f $@-t $@; \
    else \
        rm -f $@-t; \
        if test -s $@; then touch $@; else rm -f $@; fi; \
    fi
.x.1-t:
    $(HELP2MAN) -o $@ -I $< -I $(top_srcdir)/common.x -s 1 foo$(EXEEXT)