GNU autotools 프로젝트의 빌드 매뉴얼과 관련된 "make distcheck" 문제

저는 작은 프로젝트를 사용 autoconf하고 구축하고 있습니다.automake

프로젝트 매뉴얼에는 OpenBSD의 기본 언어를 사용했습니다.mdoc체재, man이를 사용하여 설치 가능한 형식의 매뉴얼을 생성합니다.mandoc유틸리티. - 포맷된 매뉴얼은 일부 시스템에서 제대로 이해하지 못하거나 전혀 이해 하지 못하기 때문에 man실제 매뉴얼로 설치됩니다 .make installmdoc

프로젝트 doc디렉토리에는 현재 다음과 같은 파일이 있습니다 Makefile.am(설명서는 라는 유틸리티에 대한 것입니다 shell).

dist_man1_MANS= shell.man
EXTRA_DIST=     shell.mdoc

shell.man:      shell.mdoc
        $(mandoc) -T man shell.mdoc >shell.man

$(mandoc)포맷터의 전체 경로로 올바르게 확장됩니다 mandoc(이 변수는 스크립트에 의해 설정됨 configure).

이를 통해 make dist이를 실행하여 나머지 프로젝트 배포 파일과 함께 소스 매뉴얼과 생성된 매뉴얼을 포함하는 shell.man압축 아카이브를 생성할 수 있습니다.tarmdocman

$ tar tzf shell-toolbox-20180401.tar.gz
...
shell-toolbox-20180401/doc/Makefile.am
shell-toolbox-20180401/doc/shell.man
shell-toolbox-20180401/doc/Makefile.in
shell-toolbox-20180401/doc/shell.mdoc

이 tar아카이브는 나중에 프로젝트와 해당 매뉴얼을 성공적으로 빌드하고 설치하는 데 사용될 수 있습니다. 여태까지는 그런대로 잘됐다.

그러나 내가 달리면make distcheck(왜냐하면 나는 그것이 절대적으로 작동하는지 확인하고 싶기 때문입니다):

$ make distcheck
...
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /usr/local/bin/gmkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking whether make supports nested variables... yes
checking for mandoc... /usr/bin/mandoc
checking that generated files are newer than configure... done
configure: creating ./config.status
config.status: creating Makefile
config.status: creating src/Makefile
config.status: creating doc/Makefile
config.status: creating src/shell
Making all in src
Making all in doc
/usr/bin/mandoc -T man shell.mdoc >shell.man
mandoc: shell.mdoc: ERROR: No such file or directory
*** Error 3 in shell-toolbox-20180401/_build/sub/doc (Makefile:459 'shell.man')
*** Error 1 in shell-toolbox-20180401/_build/sub (Makefile:345 'all-recursive')
*** Error 1 in /home/myself/local/build/shell-toolbox (Makefile:576 'distcheck')

mdoc매뉴얼을 빌드할 때가 되면 빌드 디렉토리에 소스 파일이 없는 것 같습니다:

$ ls shell-toolbox-20180401/_build/sub/doc
total 32
-rw-r--r--  1 myself  myself  14989 Apr  1 21:35 Makefile
-rw-r--r--  1 myself  myself      0 Apr  1 21:35 shell.man

길이가 0인 shell.man파일은 실패한 mandoc실행에서 생성됩니다.

소스 코드는 압축이 풀린 아카이브에 있지만 _build/sub/doc디렉토리에 복사되지는 않았습니다.

$ ls -l shell-toolbox-20180401/doc
total 48
-r--r--r--  1 myself  myself   178 Apr  1 21:23 Makefile.am
-r--r--r--  1 myself  myself 13925 Apr  1 21:23 Makefile.in
-r--r--r--  1 myself  myself  3443 Apr  1 21:27 shell.man
-r--r--r--  1 myself  myself  3319 Apr  1 18:54 shell.mdoc

질문: 형식화된 매뉴얼을 생성하기 전에 소스 코드를 빌드 디렉토리에 올바르게 복사 automake하려면 어떤 마법을 적용해야 합니까 ? make distcheck나는 해킹 없이 이 작업을 수행할 수 있는 "올바른" 방법을 찾고 있습니다.mdocman

나는 사용하려고

man1_SOURCES= shell.mdoc

그러나 이것은 사람들을 automake불평 하게 만든다.

doc/Makefile.am:2: warning: variable 'man1_SOURCES' is defined but no program or
doc/Makefile.am:2: library has 'man1' as canonical name (possible typo)

---

이 오류를 발생시키는 또 다른 방법은 수동으로 수행하는 것입니다.VPATH 빌드(이것은 기본적으로 를 수행할 때 발생하는 일입니다 make distcheck):

$ make distclean
$ mkdir t
$ cd t

$ ../configure
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /usr/local/bin/gmkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking whether make supports nested variables... yes
checking for mandoc... /usr/bin/mandoc
checking that generated files are newer than configure... done
configure: creating ./config.status
config.status: creating Makefile
config.status: creating src/Makefile
config.status: creating doc/Makefile
config.status: creating src/shell

$ make
Making all in src
Making all in doc
/usr/bin/mandoc -T man shell.mdoc >shell.man
mandoc: shell.mdoc: ERROR: No such file or directory
*** Error 3 in doc (Makefile:459 'shell.man')
*** Error 1 in /home/myself/local/build/shell-toolbox/t (Makefile:345 'all-recursive')

$ ls -l doc
total 32
-rw-r--r--  1 myself myself 14589 Apr  1 22:42 Makefile
-rw-r--r--  1 myself myself     0 Apr  1 22:42 shell.man