[ < ] [ > ]   [ << ] [ 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 March, 29 2007 using texi2html 1.76.