[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10. 문서를 build하기

현재 Automake는 Texinfo와 man page에 대한 지원을 제공한다.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.1 Texinfo

현재 디렉토리에 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 옵션을 통해 막을 수 있다.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10.2 Man page

패키지에는 man page도 포함될 수 있다. (하지만 이 문제에 대한 GNU 표준을 보라, (standards)Man Pages 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는 현재 소스로 취급되지 않는다.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Autobuild on August 22, 2016 using texi2html 1.82.