m4는 입력의 어떤 위치에서든지 파일의 이름을 지정하여 삽입할 수 있다.
include(filename) sinclude(filename)
둘 다 filename이라는 이름의 파일을 m4로 읽어들인다. 파일의 끝에
다다랐다면 입력은 이전에 읽던 입력파일로 다시 계속된다.
따라서 include와 sinclude의 확장은 filename의 속
내용이 된다.
include되는 파일이 존재하지 않는 것이면 에러이다. 존재하지 않는 파일들
때문에 에러 메시지가 생기는 것을 원하지 않는다면, sinclude를 사용하라.
만일 존재한다면 확장되고 그렇지 않으면 아무 것으로도 확장되지 않는다.
include(`no-such-file') => error-->30.include:2: m4: Cannot open no-such-file: No such file or directory sinclude(`no-such-file') =>
`incl.m4' 파일이 다음과 같은 내용을 가지고 있다고 가정하자.
Include file start foo Include file end
보통의 경우, 파일을 삽입하기는 파일의 속 내용을 현재의 입력 스트림으로
삽입하기 위해 쓰인다. 파일의 내용이 mr에 의해 읽혀지고 그 파일의
내용에 있는 매크로 호출은 확장될 것이다.
define(`foo', `FOO') => include(`incl.m4') =>Include file start =>FOO =>Include file end =>
include와 sinclude가 파일의 내용으로 확장된다는 사실은 전체
파일들에서 작동하는 매크로를 정의하는 데에 쓰일 수 있다. 예를 들면,
여기에서 `bar'는 `incl.m4'의 내용으로 확장하도록 정의된다.
define(`bar', include(`incl.m4')) => This is `bar': >>>bar<<< =>This is bar: >>>Include file start =>foo =>Include file end =><<<
이러한 include의 사용은 파일이 인용문자, 쉼표, 괄호 등을 포함할 수
있기 때문에 그리 뻔한 것이 아니다. 이런 것들이 m4가 구문 분석 작업을 하는 데
끼어 들 수도 있다.
내장 매크로 include와 sinclude는 인자가 있을 때에만 인식된다.
GNU m4에서는 현재 작업 디렉토리가 아닌 다른 디렉토리에서 파일을 찾아서
삽입하는 것을 허용한다.
파일 이름이 절대 경로로 지정되어 있지 않고, 현재 작업 디렉토리에서 보이지 않는다면, 지정된 검색 경로 속에서 파일을 찾아 본다. 먼저, 명령행에서 `-I' 옵션으로 지정한 곳을 거기에 지정된 순서대로 뒤진다. 두 번째로, `M4PATH' 환경변수가 설정되어 있다면, 그것은 콜론으로 분리된 디렉토리의 목록이어야 하는데, 거기에 있는 순서대로 검색할 것이다.
파일 삽입시 자동 검색에서 문제점이 발생한다면, `p' 디버깅 플래그가 이러한 문제점을 따로 떼어 내는 데에 도움이 된다. (see section 디버깅 출력을 제어하기).
Go to the first, previous, next, last section, table of contents.