[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
현재 Automake는 Texinfo와 man page에 대한 지원을 제공한다.
10.1 Texinfo | ||
10.2 Man page |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
현재 디렉토리에 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] | [ ? ] |
패키지에는 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 September 28, 2013 using texi2html 1.82.