varname-dot-parsefile.mk revision 1.7 1 1.7 rillig # $NetBSD: varname-dot-parsefile.mk,v 1.7 2023/06/21 07:30:50 rillig Exp $
2 1.1 rillig #
3 1.3 rillig # Tests for the special .PARSEFILE variable, which contains the basename part
4 1.3 rillig # of the file that is currently parsed.
5 1.7 rillig #
6 1.7 rillig # See also
7 1.7 rillig # varname-dot-includedfromdir.mk
8 1.7 rillig # varname-dot-includedfromfile.mk
9 1.7 rillig # varname-dot-parsedir.mk
10 1.7 rillig #
11 1.7 rillig # History
12 1.7 rillig # .PARSEDIR and .PARSEFILE were added on 1999-08-09.
13 1.1 rillig
14 1.3 rillig .if ${.PARSEFILE} != "varname-dot-parsefile.mk"
15 1.3 rillig . error
16 1.3 rillig .endif
17 1.3 rillig
18 1.3 rillig # During parsing, it is possible to undefine .PARSEFILE.
19 1.3 rillig # Not that anyone would ever want to do this, but there's code in parse.c,
20 1.3 rillig # function PrintLocation, that explicitly handles this situation.
21 1.3 rillig .if !defined(.PARSEFILE)
22 1.3 rillig . error
23 1.3 rillig .endif
24 1.3 rillig .undef .PARSEFILE
25 1.3 rillig .if defined(.PARSEFILE)
26 1.3 rillig . error
27 1.3 rillig .endif
28 1.3 rillig
29 1.3 rillig # The variable .PARSEFILE is indirectly used by the .info directive,
30 1.3 rillig # via PrintLocation.
31 1.6 rillig # expect+1: At this point, .PARSEFILE is undefined.
32 1.3 rillig .info At this point, .PARSEFILE is undefined.
33 1.3 rillig
34 1.3 rillig # There is absolutely no point in faking the location of the file that is
35 1.4 rillig # being parsed. Technically, it's possible though, but only if the file
36 1.4 rillig # being parsed is a relative pathname. See PrintLocation for details.
37 1.5 rillig .PARSEFILE= fake-parsefile
38 1.4 rillig .info The location can be faked in some cases.
39 1.3 rillig
40 1.3 rillig # After including another file, .PARSEFILE is reset.
41 1.3 rillig .include "/dev/null"
42 1.6 rillig # expect+1: The location is no longer fake.
43 1.3 rillig .info The location is no longer fake.
44 1.1 rillig
45 1.1 rillig all:
46 1.3 rillig @echo At run time, .PARSEFILE is ${.PARSEFILE:Uundefined}.
47