현재 Automake는 Texinfo와 man page에 대한 지원을 제공한다.
현재 디렉토리에 Texinfo 소스가 잇으면, 그 소스를 `TEXINFOS'
primary에 선언해 놓아야 한다. 보통 Texinfo 파일은 info로 변환되기
때문에, info_TEXINFOS 매크로가 여기서 가장 많이 사용된다. 어떤
Texinfo 소스 파일도 `.texi'나 `.texinfo' 확장자로 끝나야
한다는 것에 유의하자.
`texi' 파일이 `version.texi'를 @include한다면, 그
파일은 자동으로 만들어 질 것이다. `version.texi'는 참조해서 사용할
수 있는 세개의 Texinfo 매크로가 정의되어 있다: EDITION,
VERSION, 그리고 UPDATED이다. 처음 두개는 패키지의 버전
번호를 담고 있다 (하지만, 명확히 하기 위해 따로 넣는다); 마지막은 주요
화일이 마지막으로 수정된 날짜이다. `version.texi' 지원은
mdate-sh 프로그램을 필요로 한다; 이 프로그램은 Automake와 함께
제공된다.
때로 한개의 info 화일이 실제로는 여러개의 `.texi' 화일에 의존하는 경우가 있다. 예를 들어, GNU Hello에서, `hello.texi'는 `gpl.texi'를 포함한다. Automake에게 이런 의존성을 `texi_TEXINFOS' 변수를 사용해서 알려줄 수 있다. 여기 Hello가 어떻게 하는지 있다:
info_TEXINFOS = kpathsea.texi kpathsea_TEXINFOS = install.texi copying.texi freedom.texi
기본적으로, Automake는 Texinfo 소스와 같은 디렉토리에 `texinfo.tex'
파일이 있어야 한다. 하지만, `configure.in'에서
AC_CONFIG_AUX_DIR를 사용하면, `texinfo.tex'은 그 위치에서
찾아질 것이다. Automake는 `--add-missing' 옵션을 주면
`texinfo.tex'을 제공해 준다.
만약 여러개의 디렉토리에 Texinfo 파일이 있다면, TEXINFO_TEX
변수를 사용해서 automake에게 어디에 이 패키지의 `texinfo.tex'
파일이 있는지 알려줄 수 있다. 이 변수의 값은 현재 `Makefile.am'에
대한 `texinfo.tex'의 상대 경로(relative path)여야 한다.
TEXINFO_TEX = ../doc/texinfo.tex
`no-texinfo.tex' 옵션은 `texinfo.tex' 파일이 필요하지 않도록
할 때 쓰일 수 있다. 하지만, TEXINFO_TEX을 쓰면, dvi
목표(target)이 동작하기 때문에 더 좋다.
Automake는 install-info target을 만들어 낸다; 어떤 사람들은 직접
이 target을 사용한다. 기본적으로, info page는 `make install'에 의해
설치된다. 이런 동작은 no-installinfo 옵션을 통해 막을 수 있다.
패키지에는 man page도 포함될 수 있다. (하지만 이 문제에 대한 GNU 표준을
보라, section `Man Pages' in The GNU Coding Standards.) Man
page는 `MANS' paimary를 사용해 선언된다. 보통 man_MANS
매크로가 사용된다. Man page는 확장자에 따라 자동으로 mandir의
알맞은 서브디렉토리로 설치된다.
디폴트로, man page는 `make install'에 의해 설치된다. 하지만, GNU
프로젝트는 man page를 필요로 하지 않기 때문에, 많은 maintainer들은 man
page를 계속 변경하려는 노력을 계속하지 않는다. 이 경우,
no-installman 옵션은 man page가 디폴트로 설치되는 것을 막을
것이다. 사용자는 계속 직접 `make install-man'을 통해 설치할 수
있다.
여기 GNU cpio에서 어떻게 문서가 다뤄지는지가 있다 (Texinfo 문서와
man page를 모두 포함한 것이다):
info_TEXINFOS = cpio.texi man_MANS = cpio.1 mt.1
Texinfo 소스, info page, 그리고 man page는 모두 배포판을 만드는 데 소스 파일로 취급된다.
man page가 자동으로 생성되도록 하는 건 드물기 때문에, Man page는 현재 소스로 취급되지 않는다.
Go to the first, previous, next, last section, table of contents.