€•w      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ1/translations/zh_CN/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/zh_TW/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/it_IT/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ja_JP/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ko_KR/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/sp_SP/kbuild/kconfig-macro-language”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒKconfig macro language”h]”hŒKconfig macro language”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒK/var/lib/git/docbuild/linux/Documentation/kbuild/kconfig-macro-language.rst”h Kubh¢)”}”(hhh]”(h§)”}”(hŒConcept”h]”hŒConcept”…””}”(hhºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh·hžhhŸh¶h KubhŒ	paragraph”“”)”}”(hŒ÷The basic idea was inspired by Make. When we look at Make, we notice sort of
two languages in one. One language describes dependency graphs consisting of
targets and prerequisites. The other is a macro language for performing textual
substitution.”h]”hŒ÷The basic idea was inspired by Make. When we look at Make, we notice sort of
two languages in one. One language describes dependency graphs consisting of
targets and prerequisites. The other is a macro language for performing textual
substitution.”…””}”(hhÊhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒpThere is clear distinction between the two language stages. For example, you
can write a makefile like follows::”h]”hŒoThere is clear distinction between the two language stages. For example, you
can write a makefile like follows:”…””}”(hhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhŒliteral_block”“”)”}”(hŒPAPP := foo
SRC := foo.c
CC := gcc

$(APP): $(SRC)
        $(CC) -o $(APP) $(SRC)”h]”hŒPAPP := foo
SRC := foo.c
CC := gcc

$(APP): $(SRC)
        $(CC) -o $(APP) $(SRC)”…””}”hhèsbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hæhŸh¶h Khh·hžhubhÉ)”}”(hŒ‰The macro language replaces the variable references with their expanded form,
and handles as if the source file were input like follows::”h]”hŒˆThe macro language replaces the variable references with their expanded form,
and handles as if the source file were input like follows:”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhç)”}”(hŒ#foo: foo.c
        gcc -o foo foo.c”h]”hŒ#foo: foo.c
        gcc -o foo foo.c”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h Khh·hžhubhÉ)”}”(hŒRThen, Make analyzes the dependency graph and determines the targets to be
updated.”h]”hŒRThen, Make analyzes the dependency graph and determines the targets to be
updated.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒ\The idea is quite similar in Kconfig - it is possible to describe a Kconfig
file like this::”h]”hŒ[The idea is quite similar in Kconfig - it is possible to describe a Kconfig
file like this:”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K hh·hžhubhç)”}”(hŒaCC := gcc

config CC_HAS_FOO
        def_bool $(shell, $(srctree)/scripts/gcc-check-foo.sh $(CC))”h]”hŒaCC := gcc

config CC_HAS_FOO
        def_bool $(shell, $(srctree)/scripts/gcc-check-foo.sh $(CC))”…””}”hj0  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K#hh·hžhubhÉ)”}”(hŒYThe macro language in Kconfig processes the source file into the following
intermediate::”h]”hŒXThe macro language in Kconfig processes the source file into the following
intermediate:”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K(hh·hžhubhç)”}”(hŒ$config CC_HAS_FOO
        def_bool y”h]”hŒ$config CC_HAS_FOO
        def_bool y”…””}”hjL  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K+hh·hžhubhÉ)”}”(hŒvThen, Kconfig moves onto the evaluation stage to resolve inter-symbol
dependency as explained in kconfig-language.rst.”h]”hŒvThen, Kconfig moves onto the evaluation stage to resolve inter-symbol
dependency as explained in kconfig-language.rst.”…””}”(hjZ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K.hh·hžhubeh}”(h]”Œconcept”ah ]”h"]”Œconcept”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ	Variables”h]”hŒ	Variables”…””}”(hjs  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjp  hžhhŸh¶h K3ubhÉ)”}”(hXx  Like in Make, a variable in Kconfig works as a macro variable.  A macro
variable is expanded "in place" to yield a text string that may then be
expanded further. To get the value of a variable, enclose the variable name in
$( ). The parentheses are required even for single-letter variable names; $X is
a syntax error. The curly brace form as in ${CC} is not supported either.”h]”hX|  Like in Make, a variable in Kconfig works as a macro variable.  A macro
variable is expanded â€œin placeâ€ to yield a text string that may then be
expanded further. To get the value of a variable, enclose the variable name in
$( ). The parentheses are required even for single-letter variable names; $X is
a syntax error. The curly brace form as in ${CC} is not supported either.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K5hjp  hžhubhÉ)”}”(hŒ_There are two types of variables: simply expanded variables and recursively
expanded variables.”h]”hŒ_There are two types of variables: simply expanded variables and recursively
expanded variables.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K;hjp  hžhubhÉ)”}”(hŒŸA simply expanded variable is defined using the := assignment operator. Its
righthand side is expanded immediately upon reading the line from the Kconfig
file.”h]”hŒŸA simply expanded variable is defined using the := assignment operator. Its
righthand side is expanded immediately upon reading the line from the Kconfig
file.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K>hjp  hžhubhÉ)”}”(hŒìA recursively expanded variable is defined using the = assignment operator.
Its righthand side is simply stored as the value of the variable without
expanding it in any way. Instead, the expansion is performed when the variable
is used.”h]”hŒìA recursively expanded variable is defined using the = assignment operator.
Its righthand side is simply stored as the value of the variable without
expanding it in any way. Instead, the expansion is performed when the variable
is used.”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KBhjp  hžhubhÉ)”}”(hŒðThere is another type of assignment operator; += is used to append text to a
variable. The righthand side of += is expanded immediately if the lefthand
side was originally defined as a simple variable. Otherwise, its evaluation is
deferred.”h]”hŒðThere is another type of assignment operator; += is used to append text to a
variable. The righthand side of += is expanded immediately if the lefthand
side was originally defined as a simple variable. Otherwise, its evaluation is
deferred.”…””}”(hj¹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KGhjp  hžhubhÉ)”}”(hŒCThe variable reference can take parameters, in the following form::”h]”hŒBThe variable reference can take parameters, in the following form:”…””}”(hjÇ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KLhjp  hžhubhç)”}”(hŒ$(name,arg1,arg2,arg3)”h]”hŒ$(name,arg1,arg2,arg3)”…””}”hjÕ  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KNhjp  hžhubhÉ)”}”(hŒ–You can consider the parameterized reference as a function. (more precisely,
"user-defined function" in contrast to "built-in function" listed below).”h]”hŒžYou can consider the parameterized reference as a function. (more precisely,
â€œuser-defined functionâ€ in contrast to â€œbuilt-in functionâ€ listed below).”…””}”(hjã  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KPhjp  hžhubhÉ)”}”(hX"  Useful functions must be expanded when they are used since the same function is
expanded differently if different parameters are passed. Hence, a user-defined
function is defined using the = assignment operator. The parameters are
referenced within the body definition with $(1), $(2), etc.”h]”hX"  Useful functions must be expanded when they are used since the same function is
expanded differently if different parameters are passed. Hence, a user-defined
function is defined using the = assignment operator. The parameters are
referenced within the body definition with $(1), $(2), etc.”…””}”(hjñ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KShjp  hžhubhÉ)”}”(hŒèIn fact, recursively expanded variables and user-defined functions are the same
internally. (In other words, "variable" is "function with zero argument".)
When we say "variable" in a broad sense, it includes "user-defined function".”h]”hŒøIn fact, recursively expanded variables and user-defined functions are the same
internally. (In other words, â€œvariableâ€ is â€œfunction with zero argumentâ€.)
When we say â€œvariableâ€ in a broad sense, it includes â€œuser-defined functionâ€.”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KXhjp  hžhubeh}”(h]”Œ	variables”ah ]”h"]”Œ	variables”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K3ubh¢)”}”(hhh]”(h§)”}”(hŒBuilt-in functions”h]”hŒBuilt-in functions”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K^ubhÉ)”}”(hŒnLike Make, Kconfig provides several built-in functions. Every function takes a
particular number of arguments.”h]”hŒnLike Make, Kconfig provides several built-in functions. Every function takes a
particular number of arguments.”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K`hj  hžhubhÉ)”}”(hXI  In Make, every built-in function takes at least one argument. Kconfig allows
zero argument for built-in functions, such as $(filename), $(lineno). You could
consider those as "built-in variable", but it is just a matter of how we call
it after all. Let's say "built-in function" here to refer to natively supported
functionality.”h]”hXS  In Make, every built-in function takes at least one argument. Kconfig allows
zero argument for built-in functions, such as $(filename), $(lineno). You could
consider those as â€œbuilt-in variableâ€, but it is just a matter of how we call
it after all. Letâ€™s say â€œbuilt-in functionâ€ here to refer to natively supported
functionality.”…””}”(hj4  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kchj  hžhubhÉ)”}”(hŒ<Kconfig currently supports the following built-in functions.”h]”hŒ<Kconfig currently supports the following built-in functions.”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kihj  hžhubhŒblock_quote”“”)”}”(hXX  - $(shell,command)

 The "shell" function accepts a single argument that is expanded and passed
 to a subshell for execution. The standard output of the command is then read
 and returned as the value of the function. Every newline in the output is
 replaced with a space. Any trailing newlines are deleted. The standard error
 is not returned, nor is any program exit status.

- $(info,text)

 The "info" function takes a single argument and prints it to stdout.
 It evaluates to an empty string.

- $(warning-if,condition,text)

 The "warning-if" function takes two arguments. If the condition part is "y",
 the text part is sent to stderr. The text is prefixed with the name of the
 current Kconfig file and the current line number.

- $(error-if,condition,text)

 The "error-if" function is similar to "warning-if", but it terminates the
 parsing immediately if the condition part is "y".

- $(filename)

 The 'filename' takes no argument, and $(filename) is expanded to the file
 name being parsed.

- $(lineno)

 The 'lineno' takes no argument, and $(lineno) is expanded to the line number
 being parsed.

”h]”(hŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒ$(shell,command)
”h]”hÉ)”}”(hŒ$(shell,command)”h]”hŒ$(shell,command)”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kkhj]  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hjX  ubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jV  hŸh¶h KkhjR  ubjQ  )”}”(hX`  The "shell" function accepts a single argument that is expanded and passed
to a subshell for execution. The standard output of the command is then read
and returned as the value of the function. Every newline in the output is
replaced with a space. Any trailing newlines are deleted. The standard error
is not returned, nor is any program exit status.
”h]”hÉ)”}”(hX_  The "shell" function accepts a single argument that is expanded and passed
to a subshell for execution. The standard output of the command is then read
and returned as the value of the function. Every newline in the output is
replaced with a space. Any trailing newlines are deleted. The standard error
is not returned, nor is any program exit status.”h]”hXc  The â€œshellâ€ function accepts a single argument that is expanded and passed
to a subshell for execution. The standard output of the command is then read
and returned as the value of the function. Every newline in the output is
replaced with a space. Any trailing newlines are deleted. The standard error
is not returned, nor is any program exit status.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kmhj}  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h KmhjR  ubjW  )”}”(hhh]”j\  )”}”(hŒ$(info,text)
”h]”hÉ)”}”(hŒ$(info,text)”h]”hŒ$(info,text)”…””}”(hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kshj˜  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hj•  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jV  hŸh¶h KshjR  ubjQ  )”}”(hŒfThe "info" function takes a single argument and prints it to stdout.
It evaluates to an empty string.
”h]”hÉ)”}”(hŒeThe "info" function takes a single argument and prints it to stdout.
It evaluates to an empty string.”h]”hŒiThe â€œinfoâ€ function takes a single argument and prints it to stdout.
It evaluates to an empty string.”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kuhj¶  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h KuhjR  ubjW  )”}”(hhh]”j\  )”}”(hŒ$(warning-if,condition,text)
”h]”hÉ)”}”(hŒ$(warning-if,condition,text)”h]”hŒ$(warning-if,condition,text)”…””}”(hjÕ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KxhjÑ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jV  hŸh¶h KxhjR  ubjQ  )”}”(hŒÊThe "warning-if" function takes two arguments. If the condition part is "y",
the text part is sent to stderr. The text is prefixed with the name of the
current Kconfig file and the current line number.
”h]”hÉ)”}”(hŒÉThe "warning-if" function takes two arguments. If the condition part is "y",
the text part is sent to stderr. The text is prefixed with the name of the
current Kconfig file and the current line number.”h]”hŒÑThe â€œwarning-ifâ€ function takes two arguments. If the condition part is â€œyâ€,
the text part is sent to stderr. The text is prefixed with the name of the
current Kconfig file and the current line number.”…””}”(hjó  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kzhjï  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h KzhjR  ubjW  )”}”(hhh]”j\  )”}”(hŒ$(error-if,condition,text)
”h]”hÉ)”}”(hŒ$(error-if,condition,text)”h]”hŒ$(error-if,condition,text)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K~hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hj  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jV  hŸh¶h K~hjR  ubjQ  )”}”(hŒ|The "error-if" function is similar to "warning-if", but it terminates the
parsing immediately if the condition part is "y".
”h]”hÉ)”}”(hŒ{The "error-if" function is similar to "warning-if", but it terminates the
parsing immediately if the condition part is "y".”h]”hŒ‡The â€œerror-ifâ€ function is similar to â€œwarning-ifâ€, but it terminates the
parsing immediately if the condition part is â€œyâ€.”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K€hj(  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h K€hjR  ubjW  )”}”(hhh]”j\  )”}”(hŒ$(filename)
”h]”hÉ)”}”(hŒ$(filename)”h]”hŒ$(filename)”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KƒhjC  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hj@  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jV  hŸh¶h KƒhjR  ubjQ  )”}”(hŒ]The 'filename' takes no argument, and $(filename) is expanded to the file
name being parsed.
”h]”hÉ)”}”(hŒ\The 'filename' takes no argument, and $(filename) is expanded to the file
name being parsed.”h]”hŒ`The â€˜filenameâ€™ takes no argument, and $(filename) is expanded to the file
name being parsed.”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K…hja  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h K…hjR  ubjW  )”}”(hhh]”j\  )”}”(hŒ
$(lineno)
”h]”hÉ)”}”(hŒ	$(lineno)”h]”hŒ	$(lineno)”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kˆhj|  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j[  hjy  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jV  hŸh¶h KˆhjR  ubjQ  )”}”(hŒ\The 'lineno' takes no argument, and $(lineno) is expanded to the line number
being parsed.

”h]”hÉ)”}”(hŒZThe 'lineno' takes no argument, and $(lineno) is expanded to the line number
being parsed.”h]”hŒ^The â€˜linenoâ€™ takes no argument, and $(lineno) is expanded to the line number
being parsed.”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KŠhjš  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h KŠhjR  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jP  hŸh¶h Kkhj  hžhubeh}”(h]”Œbuilt-in-functions”ah ]”h"]”Œbuilt-in functions”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K^ubh¢)”}”(hhh]”(h§)”}”(hŒMake vs Kconfig”h]”hŒMake vs Kconfig”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjÀ  hžhhŸh¶h KubhÉ)”}”(hŒ\Kconfig adopts Make-like macro language, but the function call syntax is
slightly different.”h]”hŒ\Kconfig adopts Make-like macro language, but the function call syntax is
slightly different.”…””}”(hjÑ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K‘hjÀ  hžhubhÉ)”}”(hŒ)A function call in Make looks like this::”h]”hŒ(A function call in Make looks like this:”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K”hjÀ  hžhubhç)”}”(hŒ$(func-name arg1,arg2,arg3)”h]”hŒ$(func-name arg1,arg2,arg3)”…””}”hjí  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K–hjÀ  hžhubhÉ)”}”(hXm  The function name and the first argument are separated by at least one
whitespace. Then, leading whitespaces are trimmed from the first argument,
while whitespaces in the other arguments are kept. You need to use a kind of
trick to start the first parameter with spaces. For example, if you want
to make "info" function print "  hello", you can write like follows::”h]”hXt  The function name and the first argument are separated by at least one
whitespace. Then, leading whitespaces are trimmed from the first argument,
while whitespaces in the other arguments are kept. You need to use a kind of
trick to start the first parameter with spaces. For example, if you want
to make â€œinfoâ€ function print â€œ  helloâ€, you can write like follows:”…””}”(hjû  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K˜hjÀ  hžhubhç)”}”(hŒAempty :=
space := $(empty) $(empty)
$(info $(space)$(space)hello)”h]”hŒAempty :=
space := $(empty) $(empty)
$(info $(space)$(space)hello)”…””}”hj	  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KžhjÀ  hžhubhÉ)”}”(hŒ˜Kconfig uses only commas for delimiters, and keeps all whitespaces in the
function call. Some people prefer putting a space after each comma delimiter::”h]”hŒ—Kconfig uses only commas for delimiters, and keeps all whitespaces in the
function call. Some people prefer putting a space after each comma delimiter:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¢hjÀ  hžhubhç)”}”(hŒ$(func-name, arg1, arg2, arg3)”h]”hŒ$(func-name, arg1, arg2, arg3)”…””}”hj%  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K¥hjÀ  hžhubhÉ)”}”(hŒýIn this case, "func-name" will receive " arg1", " arg2", " arg3". The presence
of leading spaces may matter depending on the function. The same applies to
Make - for example, $(subst .c, .o, $(sources)) is a typical mistake; it
replaces ".c" with " .o".”h]”hX  In this case, â€œfunc-nameâ€ will receive â€œ arg1â€, â€œ arg2â€, â€œ arg3â€. The presence
of leading spaces may matter depending on the function. The same applies to
Make - for example, $(subst .c, .o, $(sources)) is a typical mistake; it
replaces â€œ.câ€ with â€œ .oâ€.”…””}”(hj3  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K§hjÀ  hžhubhÉ)”}”(hŒ`In Make, a user-defined function is referenced by using a built-in function,
'call', like this::”h]”hŒcIn Make, a user-defined function is referenced by using a built-in function,
â€˜callâ€™, like this:”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¬hjÀ  hžhubhç)”}”(hŒ$(call my-func,arg1,arg2,arg3)”h]”hŒ$(call my-func,arg1,arg2,arg3)”…””}”hjO  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K¯hjÀ  hžhubhÉ)”}”(hŒKconfig invokes user-defined functions and built-in functions in the same way.
The omission of 'call' makes the syntax shorter.”h]”hŒƒKconfig invokes user-defined functions and built-in functions in the same way.
The omission of â€˜callâ€™ makes the syntax shorter.”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K±hjÀ  hžhubhÉ)”}”(hX	  In Make, some functions treat commas verbatim instead of argument separators.
For example, $(shell echo hello, world) runs the command "echo hello, world".
Likewise, $(info hello, world) prints "hello, world" to stdout. You could say
this is _useful_ inconsistency.”h]”hX  In Make, some functions treat commas verbatim instead of argument separators.
For example, $(shell echo hello, world) runs the command â€œecho hello, worldâ€.
Likewise, $(info hello, world) prints â€œhello, worldâ€ to stdout. You could say
this is _useful_ inconsistency.”…””}”(hjk  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K´hjÀ  hžhubhÉ)”}”(hŒŒIn Kconfig, for simpler implementation and grammatical consistency, commas that
appear in the $( ) context are always delimiters. It means::”h]”hŒ‹In Kconfig, for simpler implementation and grammatical consistency, commas that
appear in the $( ) context are always delimiters. It means:”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¹hjÀ  hžhubhç)”}”(hŒ$(shell, echo hello, world)”h]”hŒ$(shell, echo hello, world)”…””}”hj‡  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h K¼hjÀ  hžhubhÉ)”}”(hŒœis an error because it is passing two parameters where the 'shell' function
accepts only one. To pass commas in arguments, you can use the following trick::”h]”hŒŸis an error because it is passing two parameters where the â€˜shellâ€™ function
accepts only one. To pass commas in arguments, you can use the following trick:”…””}”(hj•  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¾hjÀ  hžhubhç)”}”(hŒ-comma := ,
$(shell, echo hello$(comma) world)”h]”hŒ-comma := ,
$(shell, echo hello$(comma) world)”…””}”hj£  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KÁhjÀ  hžhubeh}”(h]”Œmake-vs-kconfig”ah ]”h"]”Œmake vs kconfig”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒCaveats”h]”hŒCaveats”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¹  hžhhŸh¶h KÆubhÉ)”}”(hŒ±A variable (or function) cannot be expanded across tokens. So, you cannot use
a variable as a shorthand for an expression that consists of multiple tokens.
The following works::”h]”hŒ°A variable (or function) cannot be expanded across tokens. So, you cannot use
a variable as a shorthand for an expression that consists of multiple tokens.
The following works:”…””}”(hjÊ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KÈhj¹  hžhubhç)”}”(hŒcRANGE_MIN := 1
RANGE_MAX := 3

config FOO
        int "foo"
        range $(RANGE_MIN) $(RANGE_MAX)”h]”hŒcRANGE_MIN := 1
RANGE_MAX := 3

config FOO
        int "foo"
        range $(RANGE_MIN) $(RANGE_MAX)”…””}”hjØ  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KÌhj¹  hžhubhÉ)”}”(hŒ"But, the following does not work::”h]”hŒ!But, the following does not work:”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KÓhj¹  hžhubhç)”}”(hŒCRANGES := 1 3

config FOO
        int "foo"
        range $(RANGES)”h]”hŒCRANGES := 1 3

config FOO
        int "foo"
        range $(RANGES)”…””}”hjô  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KÕhj¹  hžhubhÉ)”}”(hŒWA variable cannot be expanded to any keyword in Kconfig.  The following does
not work::”h]”hŒVA variable cannot be expanded to any keyword in Kconfig.  The following does
not work:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KÛhj¹  hžhubhç)”}”(hŒJMY_TYPE := tristate

config FOO
        $(MY_TYPE) "foo"
        default y”h]”hŒJMY_TYPE := tristate

config FOO
        $(MY_TYPE) "foo"
        default y”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h KÞhj¹  hžhubhÉ)”}”(hŒ‹Obviously from the design, $(shell command) is expanded in the textual
substitution phase. You cannot pass symbols to the 'shell' function.”h]”hŒObviously from the design, $(shell command) is expanded in the textual
substitution phase. You cannot pass symbols to the â€˜shellâ€™ function.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kähj¹  hžhubhÉ)”}”(hŒ)The following does not work as expected::”h]”hŒ(The following does not work as expected:”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kçhj¹  hžhubhç)”}”(hŒìconfig ENDIAN_FLAG
        string
        default "-mbig-endian" if CPU_BIG_ENDIAN
        default "-mlittle-endian" if CPU_LITTLE_ENDIAN

config CC_HAS_ENDIAN_FLAG
        def_bool $(shell $(srctree)/scripts/gcc-check-flag ENDIAN_FLAG)”h]”hŒìconfig ENDIAN_FLAG
        string
        default "-mbig-endian" if CPU_BIG_ENDIAN
        default "-mlittle-endian" if CPU_LITTLE_ENDIAN

config CC_HAS_ENDIAN_FLAG
        def_bool $(shell $(srctree)/scripts/gcc-check-flag ENDIAN_FLAG)”…””}”hj:  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h Kéhj¹  hžhubhÉ)”}”(hŒSInstead, you can do like follows so that any function call is statically
expanded::”h]”hŒRInstead, you can do like follows so that any function call is statically
expanded:”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kñhj¹  hžhubhç)”}”(hŒàconfig CC_HAS_ENDIAN_FLAG
        bool
        default $(shell $(srctree)/scripts/gcc-check-flag -mbig-endian) if CPU_BIG_ENDIAN
        default $(shell $(srctree)/scripts/gcc-check-flag -mlittle-endian) if CPU_LITTLE_ENDIAN”h]”hŒàconfig CC_HAS_ENDIAN_FLAG
        bool
        default $(shell $(srctree)/scripts/gcc-check-flag -mbig-endian) if CPU_BIG_ENDIAN
        default $(shell $(srctree)/scripts/gcc-check-flag -mlittle-endian) if CPU_LITTLE_ENDIAN”…””}”hjV  sbah}”(h]”h ]”h"]”h$]”h&]”höh÷uh1hæhŸh¶h Kôhj¹  hžhubeh}”(h]”Œcaveats”ah ]”h"]”Œcaveats”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KÆubeh}”(h]”Œkconfig-macro-language”ah ]”h"]”Œkconfig macro language”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j—  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jq  jn  jm  jj  j  j  j½  jº  j¶  j³  ji  jf  uŒ	nametypes”}”(jq  ‰jm  ‰j  ‰j½  ‰j¶  ‰ji  ‰uh}”(jn  h£jj  h·j  jp  jº  j  j³  jÀ  jf  j¹  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.