Go to the first, previous, next, last section, table of contents.

입력되는 것과 매크로를 디버깅 하는 방법

m4에서 매크로를 작성할 때, 그것들이 의도했던 대로 작동하는 경우는 드물 것이다. (대부분의 프로그래밍 언어의 경우에도 마찬가지이긴 하다.) m4에서 디버깅하는 것을 위한 약간의 지원이 있다.

매크로 정의를 보기

매크로 명칭이 어떻게 확장되는지 그 정의를 내장 매크로인 dumpdef를 사용하여 볼 수 있다. 

dumpdef(...)

인자의 수에는 제한이 없다. 아무런 인자도 없이 호출한다면, 그것은 현재 알려져 있는 모든 명칭의 정의를 보여 줄 것이다. 그렇지 않은 경우에는 인자로 주어진 명칭의 정의만 보여준다. 출력은 곧바로 표준 에러 출력으로 찍혀 나온다.

dumpdef는 확장되지 않는다. 

define(`foo', `Hello world.')
=>
dumpdef(`foo')
error-->foo:	`Hello world.'
=>
dumpdef(`define')
error-->define:	<define>
=>

마지막 예는 내장 매크로 정의를 보여주는 방법을 보여준다.

표시하기를 제어하는 것에 대한 자세한 정보는 See section 디버깅 출력을 제어하기.

매크로 호출을 추적하기

매크로 호출과 확장되는 것을 내장 매크로 traceon과 traceoff를 사용하여 추적할 수 있다. 

traceon(...)
traceoff(...)

아무런 인자도 없이 호출한다면, traceon과 traceoff는 정의된 모든 매크로에 대한 추적 기능을 각각 켜거나 끌 것이다. 인자를 주어서 호출한다면 해당 매크로만 영향을 받는다.

traceon과 traceoff는 확장되지 않는다.

추적되는 매크로가 호출되면 인자들이 수집된 후에 그 호출이 표시된다. 매크로 호출의 결과로 확장되는 것이 있다면 호출이 된 후에 그 확장된 결과를 표시한다. 그 출력은 곧바로 표준 에러 출력으로 찍힌다. 

define(`foo', `Hello World.')
=>
define(`echo', `$@')
=>
traceon(`foo', `echo')
=>
foo
error-->m4trace: -1- foo -> `Hello World.'
=>Hello World.
echo(gnus, and gnats)
error-->m4trace: -1- echo(`gnus', `and gnats') -> ``gnus',`and gnats''
=>gnus,and gnats

줄문자(`-') 사이의 숫자는 확장의 단계 깊이를 나타낸다. 이것은 대부분의 경우에 1이며, 최외곽 단계의 확장임을 나타낸다. 그러나 매크로의 인자가, 따옴표로 묶지 않은 매크로 호출을 포함할 때에는 증가할 수 있다.

표시를 제어하는 것에 관한 더 자세한 정보는 See section 디버깅 출력을 제어하기

디버깅 출력을 제어하기

m4를 실행할 때에 명령행에 주는 `-d' 옵션은, 앞 절에서 설명한 매크로들을 사용할 때에 얼마나 자세하게 정보를 표시할지를 제어한다.

그 옵션 다음에 적는 flag 값으로는 다음에 나오는 것들 중에서 하나 이상을 지정할 수 있다.

t
이번의 m4 프로그램 호출에서 이루어지는 모든 매크로 호출을 추적한다.
a
각각의 매크로 호출에서 실제로 주어지는 인자를 보여준다. `t' flag와 같이 사용된 경우에는 모든 매크로 호출에 적용되고, 아니면 traceon을 호출할 때에 지정된 매크로에만 적용된다.
e
확장되는 매크로라면 각 매크로 호출에서 확장되는 결과를 보여준다. `t' flag가 사용되었다면 모든 매크로 호출에 적용되고, 아니면 traceon을 호출할 때에 지정된 매크로에만 적용된다.
q
현재 지정된 인용부호를 사용하여, 호출시에 주어진 인자와 매크로 확장을 둘러싸서 표시한다.
c
각각의 매크로 호출당 여러 줄의 추적사항을 보여준다. 첫 번째 줄은 매크로가 발견되었지만 아직 그 인자가 수집되지 않은 단계에서 표시되고, 둘째 줄은 그 인자가 수집되었을 때, 셋째 줄은 호출이 완료된 후에 표시된다.
x
출력되는 줄마다 각각 유일무이한 '매크로 호출 아이디'를 보여준다. 이것은 위에서 설명한 `c' 플래그와 함께 사용하면 유용하다.
f
각각의 추적 출력 줄마다 현재의 입력 파일의 이름을 덧붙인다.
l
각각의 추적 출력 줄마다 현재의 입력의 줄 번호를 덧붙인다.
p
지정한 파일이 경로 검색 메카니즘(see section 삽입할 파일 검색하기)을 써서 발견되었다면, 실제로 사용되는 파일이름을 출력한다.
i
현재의 입력 파일이 바뀔 때마다 파일 이름과 입력 줄 번호가 담긴 메시지를 출력한다.
V
이 플래그를 쓰면, 위에서 설명한 플래그들이 모두 한꺼번에 지정된다.

`-d' 옵션에 아무런 플래그도 지정하지 않았다면, 디폴트로 `aeq'로 지정된다. 위에서 설명한 두 절에서의 예제는 디폴트 플래그가 지정되어 있다고 가정했다.

내장 매크로인 debugmode는 디버깅 정보의 출력 양식을 실행 중에 바꾸는 역할을 한다. 

debugmode(opt flags)

여기서 flags 인자는 위에서 설명한 문자들의 부분 집합이어야 한다. 특별한 경우로, 인자가 `+'로 시작한다면, 그 플래그들은 현재의 디버그 플래그에 추가된다. 그리고 `-'로 시작한다면 그 플래그들은 제거된다. 아무런 인자도 없다면, 디버깅 플래그는 아무것도 없게 된다. (`-d' 옵션을 주지 않은 것처럼 된다.) 그리고 텅 빈 인자를 주면 플래그를 디폴트 값으로 재설정하게 된다.

디버깅 출력을 저장하기

디버깅 정보와 추적 정보는 m4에 `-o' 옵션을 줘서 파일로 출력을 재지정할 수 있다. 또는 내장 매크로인 debugfile을 사용할 수도 있다. 

debugfile(opt filename)

이렇게 하면 이제부터 모든 디버깅과 추적 메시지의 출력을 filename으로 보낸다. filename을 비워 놓으면, 디버깅과 추적 출력은 사라지게 되며 만약 debugfile이 아무런 인자도 없이 호출되었다면, 디버깅과 추적 출력은 표준 에러 출력으로 보내진다.

Go to the first, previous, next, last section, table of contents.