add library/cpp/actors, ymake build to ydb oss export

build/conf/bison_lex.conf

@@ -0,0 +1,133 @@
+# This defines macros and rules for Bison and Flex source processing
+#
+# This specilizes _SRC() macro, so should be imported after generic version definition
+# Thus uses _ADD_HIDDEN_INPUTS() macro from ymake.core.conf
+
+LEX_FLAGS=
+BISON_FLAGS=-v
+
+_BISON_DATA_DIR=contrib/tools/bison/bison/data
+_CPP_BISON_SKELS=${_BISON_DATA_DIR}/glr.cc ${_BISON_DATA_DIR}/lalr1.cc ${_BISON_DATA_DIR}/yacc.c ${_BISON_DATA_DIR}/stack.hh ${_BISON_DATA_DIR}/variant.hh ${_BISON_DATA_DIR}/c++.m4 ${_BISON_DATA_DIR}/c++-skel.m4
+
+_BISON_GEN_EXT=.cpp
+_FLEX_GEN_EXT=.cpp
+
+_BISON_HEADER=--defines=${nopath;noext;output;main;addincl;norel;suf=.h:SRC}
+_BISON_PP=$YMAKE_PYTHON ${input:"build/scripts/preprocess.py"} $_ADD_HIDDEN_INPUTS($_CPP_BISON_SKELS) ${nopath;noext;tmp:SRC.h}
+
+_FLEX_TOOL=${tool:"contrib/tools/flex-old"}
+_FLEX_TOOL_DIR=contrib/tools/flex-old
+_FLEX_HEADER=
+
+### @usage: FLEX_FLAGS(<flags>)
+###
+### Set flags for Lex tool (flex) invocations.
+macro FLEX_FLAGS(Flags...) {
+    SET_APPEND(LEX_FLAGS $Flags)
+}
+
+### @usage: BISON_FLAGS(<flags>)
+###
+### Set flags for Bison tool invocations.
+macro BISON_FLAGS(Flags...) {
+    SET_APPEND(BISON_FLAGS $Flags)
+}
+
+### @usage: BISON_GEN_C()
+###
+### Generate C from Bison grammar. The C++ is generated by default.
+macro BISON_GEN_C() {
+    SET(_BISON_GEN_EXT .c)
+    SET(_BISON_PP)
+}
+
+### @usage: BISON_GEN_CPP()
+###
+### Generate C++ from Bison grammar. This is current default.
+macro BISON_GEN_CPP() {
+    SET(_BISON_GEN_EXT .cpp)
+}
+
+
+### @usage: FLEX_GEN_C()
+###
+### Generate C from Lex grammar. The C++ is generated by default.
+macro FLEX_GEN_C() {
+    SET(_FLEX_GEN_EXT .c)
+}
+
+### @usage: FLEX_GEN_CPP()
+###
+### Generate C++ from Lex grammar. This is current default.
+macro FLEX_GEN_CPP() {
+    SET(_FLEX_GEN_EXT .cpp)
+}
+
+### @usage: BISON_HEADER(<header_suffix>)
+###
+### Use SUFF (including extension) to name Bison defines header file. The default is just `.h`.
+macro BISON_HEADER(Suffix) {
+    SET(_BISON_HEADER --defines=\${nopath;noext;output;main;addincl;norel;suf=$Suffix:SRC})
+}
+
+### @usage: BISON_NO_HEADER()
+###
+### Don't emit Bison defines header file.
+macro BISON_NO_HEADER() {
+    SET(_BISON_HEADER)
+}
+
+### @usage: USE_MODERN_FLEX()
+###
+### Use `contrib/tools/flex` as flex tool. Default is `contrib/tools/flex-old`.
+### @note: by default no header is emitted. Use `USE_MODERN_FLEX_WITH_HEADER` to add header emission.
+macro USE_MODERN_FLEX() {
+    SET(_FLEX_TOOL \${tool:"contrib/tools/flex"} --m4=\${tool:"contrib/tools/bison/m4"})
+    SET(_FLEX_TOOL_DIR contrib/tools/flex)
+}
+
+### @usage: USE_MODERN_FLEX_WITH_HEADER(<header_suffix>)
+###
+### Use `contrib/tools/flex` as flex tool. Default is `contrib/tools/flex-old`.
+### Additionally emit headers with suffix provided. Header suffix should include extension `.h`.
+###
+### @example: USE_MODERN_FLEX_WITH_HEADER(_lexer.h)
+macro USE_MODERN_FLEX_WITH_HEADER(Suffix) {
+    SET(_FLEX_TOOL \${tool:"contrib/tools/flex"} --m4=\${tool:"contrib/tools/bison/m4"})
+    SET(_FLEX_TOOL_DIR contrib/tools/flex)
+    SET(_FLEX_HEADER --header-file=\${nopath;noext;output;main;addincl;norel;suf=$Suffix:SRC})
+}
+
+### @usage: USE_OLD_FLEX()
+###
+### Use `contrib/tools/flex-old` as flex tool. This is current default.
+macro USE_OLD_FLEX() {
+    SET(_FLEX_TOOL \${tool:"contrib/tools/flex-old"})
+    SET(_FLEX_TOOL_DIR contrib/tools/flex-old)
+}
+
+macro _SRC("y", SRC, SRCFLAGS...) {
+    .CMD=${tool:"contrib/tools/bison/bison"} $BISON_FLAGS --m4=${tool:"contrib/tools/bison/m4"} $_BISON_HEADER -o ${nopath;output;suf=$_BISON_GEN_EXT:SRC} ${input:SRC} ${SRCFLAGS} ${kv;hide:"p YC"} ${kv;hide:"pc light-green"} && $_BISON_PP
+    .SEM=target_bison_parser PRIVATE ${input:SRC} ${output;nopath;noext;hide;suf=${OBJ_SUF}.o:SRC} ${nopath;noext;output;hide:SRC.h} ${nopath;noext;output;addincl;hide:SRC.h} && set_global_flags BISON_FLAGS $BISON_FLAGS && conan_require bison/3.5.3 && conan_import '"bin, bison* -> ./bin/bison/bin"' && conan_import '"res, * -> ./bin/bison/res"'
+}
+
+macro _SRC("ypp", SRC, SRCFLAGS...) {
+    .CMD=$_SRC(y $SRC $SRCFLAGS)
+    .SEM=$_SRC(y $SRC $SRCFLAGS)
+}
+
+macro _SRC("l", SRC, SRCFLAGS...) {
+    .CMD=$_FLEX_TOOL $LEX_FLAGS ${SRCFLAGS} $_FLEX_HEADER -o${output;suf=$_FLEX_GEN_EXT:SRC} ${output_include;hide:"util/system/compiler.h"} ${input:SRC} ${kv;hide:"p LX"} ${kv;hide:"pc yellow"}
+    .ADDINCL=$_FLEX_TOOL_DIR
+    .SEM=target_flex_lexers ${tool;hide:_FLEX_TOOL} ${output;hide;suf=${OBJ_SUF}.o:SRC} ${input:SRC} && set_global_flags LEX_FLAGS $LEX_FLAGS
+}
+
+# tag:src-processing
+macro _SRC("lex", SRC, SRCFLAGS...) {
+    .CMD=$_SRC(l $SRC $SRCFLAGS)
+}
+
+# tag:src-processing
+macro _SRC("lpp", SRC, SRCFLAGS...) {
+    .CMD=$_SRC(l $SRC $SRCFLAGS)
+}

build/conf/compilers/gnu_compiler.conf

@@ -0,0 +1,217 @@
+_OPTIMIZE_RELEASE=
+when ($_BUILD_RELEASE == "yes") {
+    when ($_BUILD_SIZE_OPTIMIZED == "yes") {
+        # -Oz is clang's more size-aggressive version of -Os
+        # For ARM specifically, clang -Oz is on par with gcc -Os:
+        # https://github.com/android/ndk/issues/133#issuecomment-365763507
+        when($CLANG == "yes") {
+            _OPTIMIZE_RELEASE=-Oz
+        }
+        otherwise {
+            _OPTIMIZE_RELEASE=-Os
+        }
+    }
+    otherwise {
+        _OPTIMIZE_RELEASE=-O3
+    }
+}
+
+_SFDL_FLAGS=-E -C -x c++
+when ($CLANG == "yes") {
+    _SFDL_FLAGS+=-Qunused-arguments
+}
+
+_DEBUG_INFO_FLAGS=-g
+when ($OS_LINUX == "yes") {
+    _DEBUG_INFO_FLAGS=-g -ggnu-pubnames
+}
+
+_CROSS_SUFFIX=.pic
+when ($FORCE_NO_PIC == "yes") {
+    _CROSS_SUFFIX=
+}
+
+C_COMPILER=${quo:C_COMPILER_UNQUOTED}
+OPTIMIZE=$_OPTIMIZE_RELEASE
+FSTACK=-fstack-protector
+DUMP_DEPS=
+GCC_PREPROCESSOR_OPTS=$DUMP_DEPS $C_DEFINES
+
+# PIE is only valid for executables, while PIC implies a shared library
+# `-pie` with a shared library is either ignored or fails to link
+when ($PIC == "yes") {
+    CFLAGS+=-fPIC
+    LDFLAGS+=-fPIC
+}
+elsewhen ($PIE == "yes") {
+    CFLAGS+=-fPIE
+    LDFLAGS+=-fPIE -pie
+}
+
+CFLAGS+=$_C_FLAGS $DEBUG_INFO_FLAGS $_C_FOPTIONS $C_WARNING_OPTS $GCC_PREPROCESSOR_OPTS $USER_CFLAGS $USER_CFLAGS_GLOBAL
+CXXFLAGS+=$CFLAGS $_CXX_STD $CXX_WARNING_OPTS $USER_CXXFLAGS $USER_CXXFLAGS_GLOBAL
+CONLYFLAGS+=$USER_CONLYFLAGS $USER_CONLYFLAGS_GLOBAL
+CXX_COMPILER=${quo:CXX_COMPILER_UNQUOTED}
+NOGCCSTACKCHECK=yes
+SFDL_FLAG=$_SFDL_FLAGS -o $SFDL_TMP_OUT
+WERROR_FLAG=-Werror
+DEBUG_INFO_FLAGS=$_DEBUG_INFO_FLAGS
+
+when ($NO_WSHADOW == "yes") {
+    C_WARNING_OPTS += -Wno-shadow
+}
+# Though -w is intended to switch off all the warnings,
+# it does not switch at least -Wregister and -Wreserved-user-defined-literal under clang.
+#
+# Use -Wno-everything to force warning suppression.
+when ($NO_COMPILER_WARNINGS == "yes") {
+    C_WARNING_OPTS = -w
+    CXX_WARNING_OPTS = -Wno-everything
+}
+when ($NO_OPTIMIZE == "yes") {
+    OPTIMIZE = -O0
+}
+when ($SAVE_TEMPS ==  "yes") {
+    CXXFLAGS += -save-temps
+}
+when ($NOGCCSTACKCHECK != "yes") {
+    FSTACK += -fstack-check
+}
+
+when ($FORCE_CONSISTENT_DEBUG == "yes") {
+    when ($CLANG == "yes") {
+        CL_DEBUG_INFO=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B -fdebug-prefix-map=${ARCADIA_ROOT}=/-S -fdebug-prefix-map=$(TOOL_ROOT)=/-T -Xclang -fdebug-compilation-dir -Xclang /tmp
+    }
+    otherwise {
+        CL_DEBUG_INFO=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B -fdebug-prefix-map=${ARCADIA_ROOT}=/-S -fdebug-prefix-map=$(TOOL_ROOT)=/-T
+    }
+    YASM_DEBUG_INFO=--replace=${ARCADIA_BUILD_ROOT}=/-B --replace=${ARCADIA_ROOT}=/-S --replace=$(TOOL_ROOT)=/-T ${env:"YASM_TEST_SUITE=1"}
+}
+elsewhen ($CONSISTENT_DEBUG == "yes") {
+    when ($CLANG == "yes") {
+        CL_DEBUG_INFO_DISABLE_CACHE__NO_UID__=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B -fdebug-prefix-map=${ARCADIA_ROOT}=/-S -fdebug-prefix-map=$(TOOL_ROOT)=/-T -Xclang -fdebug-compilation-dir -Xclang /tmp
+    }
+    otherwise {
+        CL_DEBUG_INFO_DISABLE_CACHE__NO_UID__=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B -fdebug-prefix-map=${ARCADIA_ROOT}=/-S -fdebug-prefix-map=$(TOOL_ROOT)=/-T
+    }
+    YASM_DEBUG_INFO_DISABLE_CACHE__NO_UID__=--replace=${ARCADIA_BUILD_ROOT}=/-B --replace=${ARCADIA_ROOT}=/-S --replace=$(TOOL_ROOT)=/-T ${env:"YASM_TEST_SUITE=1"}
+}
+elsewhen ($CONSISTENT_DEBUG_LIGHT == "yes") {
+    when ($CLANG == "yes") {
+        CL_DEBUG_INFO_DISABLE_CACHE__NO_UID__=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B -Xclang -fdebug-compilation-dir -Xclang /tmp
+    }
+    otherwise {
+        CL_DEBUG_INFO_DISABLE_CACHE__NO_UID__=-fdebug-prefix-map=${ARCADIA_BUILD_ROOT}=/-B
+    }
+    YASM_DEBUG_INFO_DISABLE_CACHE__NO_UID__=--replace=${ARCADIA_BUILD_ROOT}=/-B ${env:"YASM_TEST_SUITE=1"}
+}
+
+when ($FORCE_CONSISTENT_BUILD == "yes") {
+    CL_MACRO_INFO=-Wno-builtin-macro-redefined -D__DATE__=\""Sep 31 2019\"" -D__TIME__=\"00:00:00\" -fmacro-prefix-map=${ARCADIA_BUILD_ROOT}/= -fmacro-prefix-map=${ARCADIA_ROOT}/= -fmacro-prefix-map=$(TOOL_ROOT)/=
+}
+elsewhen ($CONSISTENT_BUILD == "yes") {
+    CL_MACRO_INFO_DISABLE_CACHE__NO_UID__=-Wno-builtin-macro-redefined -D__DATE__=\""Sep 31 2019\"" -D__TIME__=\"00:00:00\" -fmacro-prefix-map=${ARCADIA_BUILD_ROOT}/= -fmacro-prefix-map=${ARCADIA_ROOT}/= -fmacro-prefix-map=$(TOOL_ROOT)/=
+}
+
+_CFLAGS_ARCH_I386=
+when ($ARCH_I386 == "yes" && $ARCH_I686 != "yes") {
+    _CFLAGS_ARCH_I386=-march=pentiumpro -mtune=pentiumpro
+}
+
+CFLAGS+=$_CFLAGS_ARCH_I386
+
+BC_CFLAGS+=$CFLAGS
+BC_CXXFLAGS+=$CXXFLAGS
+C_DEFINES+=-D__LONG_LONG_SUPPORTED
+
+OBJ_CROSS_SUF=$OBJ_SUF$_CROSS_SUFFIX
+OBJECT_SUF=$OBJ_SUF$_CROSS_SUFFIX.o
+GCC_COMPILE_FLAGS=$EXTRA_C_FLAGS -c -o $_COMPILE_OUTPUTS ${pre=-I:_C__INCLUDE}
+EXTRA_COVERAGE_OUTPUT=${output;noauto;hide;suf=${OBJECT_SUF}.gcno:SRC}
+CLANG_TIDY_OUTPUT_FILE=${output;noauto;suf=${OBJECT_SUF}.tidyjson:SRC}
+YNDEXER_OUTPUT_FILE=${output;noauto;suf=${OBJECT_SUF}${COMPILE_OUT_SUFFIX}.ydx.pb2:SRC}
+
+when ($DUMP_COMPILER_DEPS == "yes") {
+    DUMP_DEPS=-MD ${output;hide;noauto;suf=${OBJ_SUF}.o.d:SRC}
+}
+elsewhen ($DUMP_COMPILER_DEPS_FAST == "yes") {
+    DUMP_DEPS=-E -M -MF ${output;noauto;suf=${OBJ_SUF}.o.d:SRC}
+}
+
+_COMPILER_TIME_TRACE_GRANULARITY=500
+when ($TIME_TRACE_GRANULARITY && $TIME_TRACE_GRANULARITY != "") {
+    _COMPILER_TIME_TRACE_GRANULARITY=$TIME_TRACE_GRANULARITY
+}
+
+_COMPILER_TIME_TRACE_FLAGS=
+_COMPILER_TIME_TRACE_POSTPROCESS=
+when (($TIME_TRACE == "yes" || $COMPILER_TIME_TRACE == "yes") && $_HAS_TIME_TRACE == "yes") {
+    _COMPILER_TIME_TRACE_FLAGS=-ftime-trace -ftime-trace-granularity=$_COMPILER_TIME_TRACE_GRANULARITY
+    _COMPILER_TIME_TRACE_POSTPROCESS=$YMAKE_PYTHON ${input:"build/scripts/find_time_trace.py"} $_COMPILE_OUTPUTS $_COMPILE_TIME_TRACE_OUTPUTS
+}
+
+_C_CPP_KV_STYLE=${hide;kv:"p CC"} ${hide;kv:"pc green"}
+_CPP_ARGS=\
+    $CLANG_TIDY_ARGS \
+    $YNDEXER_ARGS \
+    $CXX_COMPILER \
+    $C_FLAGS_PLATFORM \
+    $GCC_COMPILE_FLAGS \
+    $CXXFLAGS \
+    $CL_MACRO_INFO \
+    $CL_MACRO_INFO_DISABLE_CACHE__NO_UID__ \
+    $_COMPILER_TIME_TRACE_FLAGS \
+    $EXTRA_OUTPUT \
+    $SRCFLAGS \
+    $_LANG_CFLAGS_VALUE \
+    ${input:SRC} \
+    $TOOLCHAIN_ENV \
+    $YNDEXER_OUTPUT \
+    && $_COMPILER_TIME_TRACE_POSTPROCESS \
+    $_C_CPP_KV_STYLE
+
+_C_ARGS=\
+    $CLANG_TIDY_ARGS \
+    $YNDEXER_ARGS \
+    $C_COMPILER \
+    $C_FLAGS_PLATFORM \
+    $GCC_COMPILE_FLAGS \
+    $CFLAGS \
+    $CL_MACRO_INFO \
+    $CL_MACRO_INFO_DISABLE_CACHE__NO_UID__ \
+    $_COMPILER_TIME_TRACE_FLAGS \
+    $CONLYFLAGS \
+    $EXTRA_OUTPUT \
+    $SRCFLAGS \
+    ${input:SRC} \
+    $TOOLCHAIN_ENV \
+    $YNDEXER_OUTPUT \
+    $_C_CPP_KV_STYLE
+
+### _SRC_C_NODEPS_CMD is obtained from _C_ARGS by filtering the following elements:
+### ${input:SRC}
+### $CL_MACRO_INFO
+### $CL_MACRO_INFO_DISABLE_CACHE__NO_UID__
+### $CLANG_TIDY_ARGS
+### $EXTRA_OUTPUT
+### $EXTRA_COVERAGE_OUTPUT
+### $SRCFLAGS
+### $YNDEXER_ARGS
+### $YNDEXER_OUTPUT
+###
+### $GCC_COMPILE_FLAGS is substituted for $EXTRA_C_FLAGS -c -o ${OUTFILE} ${SRC} ${pre=-I:INC}
+_SRC_C_NODEPS_CMD=\
+    $C_COMPILER \
+    $C_FLAGS_PLATFORM \
+    $EXTRA_C_FLAGS -c -o ${OUTFILE} ${SRC} ${pre=-I:INC} \
+    $CFLAGS \
+    $CONLYFLAGS \
+    $TOOLCHAIN_ENV \
+    $_C_CPP_KV_STYLE
+
+_FORCE_CPP_FLAGS=-x c++
+
+_SRC_CPP_CMD=$_CPP_ARGS
+_SRC_C_CMD=$_C_ARGS
+_SRC_M_CMD=$SRC_c($SRC $SRCFLAGS)
+_SRC_MASM_CMD=$_EMPTY_CMD

build/conf/compilers/msvc_compiler.conf

@@ -0,0 +1,90 @@
+MSVC_INLINE_OPTIMIZED=yes
+when ($MSVC_INLINE_OPTIMIZED == "yes") {
+    MSVC_INLINE_FLAG=/Zc:inline
+}
+when ($MSVC_INLINE_OPTIMIZED == "no") {
+    MSVC_INLINE_FLAG=/Zc:inline-
+}
+
+# Provide proper __cplusplus value
+# https://devblogs.microsoft.com/cppblog/msvc-now-correctly-reports-__cplusplus/
+_CXX_FLAGS=/Zc:__cplusplus
+
+_MSVC_ONLY_FLAGS=
+DEBUG_INFO_FLAGS=/Z7
+when ($IDE_MSVS == "yes") {
+    when ($CLANG_CL != "yes") {
+        _MSVC_ONLY_FLAGS=/FD /MP
+    }
+    DEBUG_INFO_FLAGS=/Zi /FS
+}
+
+# https://msdn.microsoft.com/en-us/library/abx4dbyh.aspx
+when ($DLL_RUNTIME == "yes") {
+    _FLAGS_DEBUG_RUNTIME=/MDd
+    _FLAGS_RELEASE_RUNTIME=/MD
+}
+otherwise {
+    _FLAGS_DEBUG_RUNTIME=/MTd
+    _FLAGS_RELEASE_RUNTIME=/MT
+}
+CFLAGS_DEBUG=/Ob0 /Od /D_DEBUG $_FLAGS_DEBUG_RUNTIME
+CFLAGS_RELEASE=/Ox /Ob2 /Oi /DNDEBUG $_FLAGS_RELEASE_RUNTIME
+
+MASMFLAGS=
+_MASM_IO=/nologo /c /Fo${output;suf=${OBJECT_SUF}:SRC} ${input;msvs_source:SRC}
+when ($ARCH_ARMV7) {
+    _MASM_IO=-o ${output;suf=${OBJECT_SUF}:SRC} ${input;msvs_source:SRC}
+}
+
+OBJ_CROSS_SUF=$OBJ_SUF
+OBJECT_SUF=$OBJ_SUF.obj
+
+CFLAGS+=$_MSVC_FLAGS $_MSVC_ONLY_FLAGS $CFLAGS_PER_TYPE $DEBUG_INFO_FLAGS $C_WARNING_OPTS $C_DEFINES $USER_CFLAGS $USER_CFLAGS_GLOBAL
+CXXFLAGS+=$CFLAGS $_STD_CXX $_CXX_FLAGS $_CXX_DEFINES $CXX_WARNING_OPTS $USER_CXXFLAGS $USER_CXXFLAGS_GLOBAL
+CONLYFLAGS+=$USER_CONLYFLAGS $USER_CONLYFLAGS_GLOBAL
+
+BC_CFLAGS+=$CFLAGS
+BC_CXXFLAGS+=$BC_CFLAGS $CXXFLAGS
+
+CFLAGS+=$_CFLAGS_UCRT_VC_INCLUDES
+
+when ($NO_WSHADOW == "yes") {
+    C_WARNING_OPTS+=/wd4456 /wd4457
+}
+
+when ($NO_COMPILER_WARNINGS == "yes") {
+    C_WARNING_OPTS=/w
+    when ($CLANG_CL == "yes") {
+        # Though /w is intended to switch off all the warnings,
+        # it does not switch at least -Wregister and -Wreserved-user-defined-literal under clang-cl.
+        #
+        # Use -Wno-everything to force warning suppression.
+        CXX_WARNING_OPTS=-Wno-everything
+    }
+    otherwise {
+        CXX_WARNING_OPTS=
+    }
+}
+
+when ($NO_OPTIMIZE == "yes") {
+    OPTIMIZE=/Od
+}
+
+SFDL_FLAG=/E /C /P /TP /Fi$SFDL_TMP_OUT
+WERROR_FLAG=/WX
+
+CL_WRAPPER=${FIX_MSVC_OUTPUT} cl
+ML_WRAPPER=${FIX_MSVC_OUTPUT} ml
+when ($_UNDER_WINE == "yes" && $CLANG_CL !="yes") {
+    CL_WRAPPER=
+    ML_WRAPPER=
+}
+
+_FORCE_CPP_FLAGS=/TP
+
+_SRC_C_NODEPS_CMD=${TOOLCHAIN_ENV} ${CL_WRAPPER} ${C_COMPILER} /c /Fo${OUTFILE} ${SRC} ${EXTRA_C_FLAGS} ${pre=/I :INC} ${CFLAGS} ${hide;kv:"soe"} ${hide;kv:"p CC"} ${hide;kv:"pc yellow"}
+_SRC_CPP_CMD=${TOOLCHAIN_ENV} ${CL_WRAPPER} ${CXX_COMPILER} /c /Fo$_COMPILE_OUTPUTS ${input;msvs_source:SRC} ${EXTRA_C_FLAGS} ${pre=/I :_C__INCLUDE} ${CXXFLAGS} ${SRCFLAGS} ${_LANG_CFLAGS_VALUE} ${hide;kv:"soe"} ${hide;kv:"p CC"} ${hide;kv:"pc yellow"}
+_SRC_C_CMD=${TOOLCHAIN_ENV} ${CL_WRAPPER} ${C_COMPILER} /c /Fo$_COMPILE_OUTPUTS ${input;msvs_source:SRC} ${EXTRA_C_FLAGS} ${pre=/I :_C__INCLUDE} ${CFLAGS} ${CONLYFLAGS} ${SRCFLAGS} ${hide;kv:"soe"} ${hide;kv:"p CC"} ${hide;kv:"pc yellow"}
+_SRC_M_CMD=$_EMPTY_CMD
+_SRC_MASM_CMD=${cwd:ARCADIA_BUILD_ROOT} ${TOOLCHAIN_ENV} ${ML_WRAPPER} ${MASM_COMPILER} ${MASMFLAGS} ${SRCFLAGS} $_MASM_IO ${kv;hide:"p AS"} ${kv;hide:"pc yellow"}

build/conf/compilers/nvcc.conf

@@ -0,0 +1,3 @@
+when ($NO_COMPILER_WARNINGS == "yes") {
+    CUDA_NVCC_FLAGS += -w
+}

build/conf/coverage_full_instrumentation.conf

@@ -0,0 +1,8 @@
+USE_SCU_VALUE="yes"
+
+macro POPULATE_CPP_COVERAGE_FLAGS() {
+    when ($CLANG_COVERAGE && $CLANG_COVERAGE != "no") {
+        CFLAGS+=-fprofile-instr-generate -fcoverage-mapping -DCLANG_COVERAGE
+        LDFLAGS+=-fprofile-instr-generate -fcoverage-mapping
+    }
+}

build/conf/coverage_selective_instrumentation.conf

@@ -0,0 +1,5 @@
+USE_SCU_VALUE="no"
+
+macro POPULATE_CPP_COVERAGE_FLAGS() {
+    SET_CPP_COVERAGE_FLAGS()
+}

build/conf/docs.conf

@@ -0,0 +1,402 @@
+#
+# Documentation build support
+#
+
+# tag:docs
+TOUCH_DOCS=$YMAKE_PYTHON3 ${input:"build/scripts/touch.py"} ${kv;hide:"p DC"} ${kv;hide:"pc light-cyan"} $TARGET
+TOUCH_DOCS_MF=$TOUCH_DOCS && $GENERATE_MF
+
+# tag:docs
+### @usage: DOCS_COPY_FILES(FROM src_dir [NAMESPCE dst_dir] files...)
+###
+### Copy files from src_dir to $BINDIR/dst_dir
+macro DOCS_COPY_FILES(FROM="${CURDIR}", NAMESPACE=".", FILES...) {
+    .CMD=$YMAKE_PYTHON3 ${input:"build/scripts/copy_docs_files.py"} ${input;hide:"build/scripts/process_command_files.py"} --source-root $ARCADIA_ROOT --build-root $ARCADIA_BUILD_ROOT --src-dir $FROM --dst-dir $BINDIR/$NAMESPACE $FILES ${input;hide;context=TEXT;pre=${FROM}/:FILES} ${output;hide;pre=${NAMESPACE}/:FILES}
+}
+
+# tag:docs
+_DOCS_USE_PLANTUML=no
+_DOCS_EXTRA_TOOLS=
+_DOCS_EXTRA_INPUTS=
+_DOCS_ENV=
+_DOCS_KV=${kv;hide:"p DO"} ${kv;hide:"pc light-cyan"} ${kv;hide:"show_out yes"}
+
+_DOCS_PLANTUML_ENV=\
+${env:"JAVA_PATH=$JDK19_RESOURCE_GLOBAL/bin/java"} \
+${env:"PLANTUML_PATH=contrib/tools/plantuml/plantuml.run.cp.jar"} \
+${env:"_JAVA_OPTIONS='-Dsun.awt.fontconfig=contrib/java/openjdk-fontconfig/fontconfig.properties -Djava.awt.headless=true'"} \
+${env:"LANG=en_US.UTF-8"} \
+${env:"LC_ALL=C.UTF-8"}
+
+_DOCS_SRCS_VALUE=
+_DOCS_VARS_FLAG=
+
+_DOCS_YFM_OUTPUT_FORMAT=
+_DOCS_YFM_BOOK_OUTPUT_FORMAT=--output-format html --allowHTML
+_DOCS_YFM_LIB_OUTPUT_FORMAT=--output-format md --add-map-file
+
+_DOCS_YFM_CMDLINE=\
+${cwd:ARCADIA_BUILD_ROOT} $YMAKE_PYTHON3 ${input:"build/scripts/extract_docs.py"} ${input;hide:"build/scripts/process_command_files.py"} --skip-prefix $ARCADIA_BUILD_ROOT --dest-dir $BINDIR/__s ${rootrel:PEERS} \
+&& ${cwd:ARCADIA_BUILD_ROOT} $YMAKE_PYTHON3 ${input:"build/scripts/stdout2stderr.py"} $YFM_TOOL_RESOURCE_GLOBAL/yfm-docs --input $BINDIR/__s --output $BINDIR/__docsbuild $_DOCS_VARS_FLAG $_DOCS_YFM_OUTPUT_FORMAT --config ${input:CONFIG} $_DOCS_EXTRA_TOOLS ${hide;input:EXTRA_INPUTS} $_DOCS_ENV \
+&& $YMAKE_PYTHON3 ${input:"build/scripts/tar_sources.py"} --output $TARGET --input $BINDIR/__docsbuild $_DOCS_KV
+
+# tag:internal tag:docs
+macro _DOCS_YFM_CMD_IMPL(CONFIG, EXTRA_INPUTS[]) {
+    .CMD=$_DOCS_YFM_CMDLINE
+}
+
+_DOCS_YFM_CMD=$_DOCS_YFM_CMD_IMPL($_DOCS_CONFIG_VALUE EXTRA_INPUTS $_DOCS_EXTRA_INPUTS)
+
+# tag:docs
+### This module is intended for internal use only. Common parts for DOCS and MKDOCS multimodules
+### should be defined here.
+module _DOCS_BARE_UNIT: _BARE_UNIT {
+    .ALLOWED=DOCS_DIR DOCS_CONFIG DOCS_VARS
+    .CMD=TOUCH_DOCS_MF
+    .FINAL_TARGET=no
+    .NODE_TYPE=Bundle
+    .PEERDIR_POLICY=as_include
+
+    ENABLE(_DOCS_BARE_UNIT)
+
+    SET(MODULE_SUFFIX .tar.gz)
+    SET(MODULE_LANG DOCS)
+}
+
+# tag:docs tag:internal
+_DOCS_DIR_INTERNAL_NAMESPACE=
+
+# tag:internal tag:docs
+_DOCS_LIBRARY_CMDLINE=\
+$YMAKE_PYTHON3 ${input:"build/scripts/copy_docs_files_to_dir.py"} ${input;hide:"build/scripts/process_command_files.py"} $_DOCS_SRCS_VALUE $_DOCS_DIR_VALUE $_DOCS_BIN_DIR_VALUE --dest-dir $BINDIR/__s --source-root $ARCADIA_ROOT --build-root $ARCADIA_BUILD_ROOT ${input;context=TEXT:INCLUDE_SRCS} \
+&& $YMAKE_PYTHON3 ${input:"build/scripts/tar_sources.py"} --output $TARGET --input $BINDIR/__s $_DOCS_KV
+
+# tag:internal tag:docs
+macro _DOCS_LIBRARY_CMD_IMPL(INCLUDE_SRCS[], EXTRA_INPUTS[]) {
+    .CMD=$_DOCS_LIBRARY_CMDLINE
+}
+
+_DOCS_LIBRARY_CMD=$_DOCS_LIBRARY_CMD_IMPL(INCLUDE_SRCS $_DOCS_INCLUDE_SOURCES_VALUE)
+
+# tag:docs
+module DOCS_LIBRARY: _DOCS_BARE_UNIT {
+    .CMD=_DOCS_LIBRARY_CMD
+    .ALIASES=SRCS=_DOCS_SRCS DOCS_DIR=_YFM_DOCS_DIR
+    .EPILOGUE=_DOCS_LIBRARY_EPILOGUE
+    .NODE_TYPE=Library
+
+    ENABLE(DOCS_LIBRARY)
+
+    SET(MODULE_TYPE LIBRARY)
+    SET(MODULE_TAG DOCS_LIBRARY)
+    SET(PEERDIR_TAGS DOCS_LIBRARY)
+
+    SET(MODULE_SUFFIX .docslib)
+}
+
+# tag:docs
+macro _DOCS_SRCS(SRCDIR=".", EXCLUDE[], INCLUDE...) {
+    SET(_VAR_DOCS_SRCS_SALT __SRCDIR__ $SRCDIR __EXCLUDE__ $EXCLUDE __INCLUDE__ $INCLUDE)
+    SET(_DOCS_SRCS_GLOB uniq_docs_${hash:_VAR_DOCS_SRCS_SALT})
+    _GLOB(${_DOCS_SRCS_GLOB} ${pre=${SRCDIR}/:INCLUDE} EXCLUDE ${EXCLUDE})
+    SET_APPEND(_DOCS_INCLUDE_SOURCES_VALUE ${input:$_DOCS_SRCS_GLOB})
+    SET(_YFM_DOCS_DIR_DEFAULT_VALUE __dummy_dir__)
+}
+
+# tag:docs
+macro _DOCS_LIBRARY_EPILOGUE() {
+    _YFM_DOCS_DIR($_YFM_DOCS_DIR_DEFAULT_VALUE)
+    _SET_DOCS_BIN_DIR_FLAG($_DOCS_DIR_INTERNAL_NAMESPACE $MODDIR)
+}
+
+# tag:docs
+### This module is intended for internal use only. Common parts for submodules of DOCS multimodule
+### should be defined here.
+module _DOCS_BASE_UNIT: _DOCS_BARE_UNIT {
+    .ALIASES=DOCS_DIR=_YFM_DOCS_DIR
+    .NODE_TYPE=Library
+
+    ENABLE(_DOCS_BASE_UNIT)
+
+    PEERDIR+=build/platform/yfm
+    DOCS_CONFIG($_DOCS_YFM_DEFAULT_CONFIG)
+}
+
+# tag:internal tag:docs
+### _DOCS_YFM_USE_PLANTUML() # internal
+###
+### This macr sets appropriate dependencies for use of plantuml plugin
+macro _DOCS_YFM_USE_PLANTUML() {
+    when ($DOCSLIB == "yes") {
+        PEERDIR+=build/platform/java/jdk/jdk19 contrib/java/openjdk-fontconfig
+
+        _DOCS_ENV+=$_DOCS_PLANTUML_ENV
+        _DOCS_EXTRA_TOOLS+=${hide;tool:"contrib/tools/plantuml"}
+    }
+}
+
+# tag:docs
+### @usage: DOCS()
+###
+### Documentation project multimodule.
+###
+### When built directly, via RECURSE, DEPENDS or BUNDLE the output artifact is docs.tar.gz with statically generated site.
+### When PEERDIRed from other DOCS() module behaves like a UNION (supplying own content and dependencies to build target).
+### Peerdirs from modules other than DOCS are not accepted.
+### Most usual macros are not accepted, only used with the macros DOCS_DIR(), DOCS_CONFIG(), DOCS_VARS().
+###
+### @see: [DOCS_DIR()](#macro_DOCS_DIR), [DOCS_CONFIG()](#macro_DOCS_CONFIG), [DOCS_VARS()](#macro_DOCS_VARS).
+multimodule DOCS {
+    module DOCSBOOK: _DOCS_BASE_UNIT {
+        .CMD=_DOCS_YFM_CMD
+        .FINAL_TARGET=yes
+        .PEERDIR_POLICY=as_build_from
+        .IGNORED=DOCS_DIR DOCS_INCLUDE_SOURCES DOCS_COPY_FILES PEERDIR PYTHON RUN_PROGRAM RUN_PYTHON3 RUN_LUA RUN_JAVA_PROGRAM FROM_SANDBOX SRCS
+        .PEERDIRSELF=DOCSLIB
+
+        ENABLE(DOCSBOOK)
+
+        SET(MODULE_TAG DOCSBOOK)
+        SET(PEERDIR_TAGS DOCSLIB)
+
+        _DOCS_YFM_OUTPUT_FORMAT=$_DOCS_YFM_BOOK_OUTPUT_FORMAT
+
+        PROCESS_DOCS()
+    }
+
+    module DOCSLIB: _DOCS_BASE_UNIT {
+        .CMD=_DOCS_YFM_CMD
+        .PEERDIR_POLICY=as_build_from
+        .IGNORED=DOCS_DIR DOCS_INCLUDE_SOURCES DOCS_COPY_FILES PEERDIR PYTHON RUN_PROGRAM RUN_PYTHON3 RUN_LUA RUN_JAVA_PROGRAM FROM_SANDBOX SRCS
+        .PEERDIRSELF=DOCSLIB_INTERNAL
+        .PROXY=yes
+
+        ENABLE(DOCSLIB)
+
+        SET(MODULE_TAG DOCSLIB)
+        SET(PEERDIR_TAGS DOCSLIB_INTERNAL)
+
+        REALPRJNAME=preprocessed
+
+        _DOCS_YFM_OUTPUT_FORMAT=$_DOCS_YFM_LIB_OUTPUT_FORMAT
+
+        PROCESS_DOCS()
+    }
+
+    module DOCSLIB_INTERNAL: DOCS_LIBRARY {
+        .IGNORED=DOCS_CONFIG
+        .EPILOGUE=_DOCS_LIBRARY_EPILOGUE
+
+        ENABLE(DOCSLIB_INTERNAL)
+        DISABLE(START_TARGET)
+
+        SET(MODULE_TAG DOCSLIB_INTERNAL)
+        SET(PEERDIR_TAGS DOCSLIB_EXTERNAL DOCS_LIBRARY)
+        # additional .fake extension make this output suppressed by ya-bin
+        SET(MODULE_SUFFIX .docslib.fake)
+
+        SET(_DOCS_DIR_INTERNAL_NAMESPACE .)
+
+        REALPRJNAME=__docs_internal
+    }
+
+    module DOCSLIB_EXTERNAL: DOCS_LIBRARY {
+        .IGNORED=DOCS_CONFIG
+        .EPILOGUE=_DOCS_LIBRARY_EPILOGUE
+
+        ENABLE(DOCSLIB_EXTERNAL)
+        DISABLE(START_TARGET)
+
+        SET(MODULE_TAG DOCSLIB_EXTERNAL)
+        SET(PEERDIR_TAGS DOCSLIB_EXTERNAL DOCS_LIBRARY)
+
+        REALPRJNAME=__docs_external
+    }
+}
+
+_DOCS_FS_TOOLS=$YMAKE_PYTHON3 ${input:"build/scripts/fs_tools.py"} ${input;hide:"build/scripts/process_command_files.py"}
+
+_DOCS_MKDOCS_CMDLINE_SUFFIX=
+_DOCS_MKDOCS_BOOK_CMDLINE_SUFFIX=${pre=--dep ;ext=preprocessed.tar.gz:PEERS}
+_DOCS_MKDOCS_LIB_CMDLINE_SUFFIX=--preprocess-md-only
+
+_DOCS_MKDOCS_CMDLINE=\
+${cwd:ARCADIA_ROOT} $_DOCS_FS_TOOLS copy_all_files $_MKDOCS_DOCS_DIR_VALUE $BINDIR/__s $_DOCS_SRCS_VALUE \
+&& $YMAKE_PYTHON3 ${input:"build/scripts/copy_files_to_dir.py"} ${input;hide:"build/scripts/process_command_files.py"} --dest-dir $BINDIR/__s --skip-prefix $ARCADIA_ROOT --skip-prefix $ARCADIA_BUILD_ROOT ${input;context=TEXT:INCLUDE_SRCS} \
+&& ${cwd:BINDIR} $YMAKE_PYTHON3 ${input:"build/scripts/mkdocs_builder_wrapper.py"} $ARCADIA_BUILD_ROOT ${tool:"tools/mkdocs_builder"} --docs-dir $BINDIR/__s --output-tar $TARGET --config ${input:CONFIG} $_DOCS_VARS_FLAG $_DOCS_MKDOCS_CMDLINE_SUFFIX $_DOCS_EXTRA_TOOLS ${hide;input:EXTRA_INPUTS} $_DOCS_ENV $_DOCS_KV
+
+# tag:internal tag:docs
+macro _DOCS_MKDOCS_CMD_IMPL(CONFIG, INCLUDE_SRCS[], EXTRA_INPUTS[]) {
+    .CMD=$_DOCS_MKDOCS_CMDLINE
+}
+
+_DOCS_MKDOCS_CMD=$_DOCS_MKDOCS_CMD_IMPL($_DOCS_CONFIG_VALUE INCLUDE_SRCS $_DOCS_INCLUDE_SOURCES_VALUE)
+
+_DOCS_YFM_DEFAULT_CONFIG=$MODDIR/.yfm
+_DOCS_MKDOCS_DEFAULT_CONFIG=$MODDIR/mkdocs.yml
+
+# tag:docs
+### This module is intended for internal use only. Common parts for submodules of MKDOCS multimodule
+### should be defined here.
+module _MKDOCS_BASE_UNIT: _DOCS_BARE_UNIT {
+    .ALIASES=DOCS_DIR=_MKDOCS_DOCS_DIR
+
+    ENABLE(_MKDOCS_BASE_UNIT)
+
+    DOCS_CONFIG($_DOCS_MKDOCS_DEFAULT_CONFIG)
+}
+
+# tag:internal tag:docs
+### _MKDOCS_EPILOOGUE() # internal
+###
+### This macro executes macros which should be envoked after all user
+### specified macros in the ya.make file
+macro _MKDOCS_EPILOGUE() {
+    _LATE_GLOB(_DOCS_SRCS_GLOB ${pre=${ARCADIA_ROOT}/;suf=/**/*:_MKDOCS_DOCS_DIR_VALUE})
+    SET(_DOCS_SRCS_VALUE \${input;hide:_DOCS_SRCS_GLOB})
+}
+
+# tag:docs
+### @usage: MKDOCS()
+###
+### Documentation project multimodule.
+###
+### When built directly, via RECURSE, DEPENDS or BUNDLE the output artifact is docs.tar.gz with statically generated site (using mkdocs as builder).
+### When PEERDIRed from other MKDOCS() module behaves like a UNION (supplying own content and dependencies to build target).
+### Peerdirs from modules other than MKDOCS are not accepted.
+### Most usual macros are not accepted, only used with the macros DOCS_DIR(), DOCS_CONFIG(), DOCS_VARS().
+###
+### @see: [DOCS_DIR()](#macro_DOCS_DIR), [DOCS_CONFIG()](#macro_DOCS_CONFIG), [DOCS_VARS()](#macro_DOCS_VARS).
+multimodule MKDOCS {
+    module MKDOCSBOOK: _MKDOCS_BASE_UNIT {
+        .CMD=_DOCS_MKDOCS_CMD
+        .EPILOGUE=_MKDOCS_EPILOGUE
+        .FINAL_TARGET=yes
+        .PEERDIR_POLICY=as_build_from
+
+        ENABLE(MKDOCSBOOK)
+
+        SET(MODULE_TYPE PROGRAM)
+        SET(PEERDIR_TAGS MKDOCSLIB)
+        SET(MODULE_TAG MKDOCSBOOK)
+
+        _DOCS_MKDOCS_CMDLINE_SUFFIX=$_DOCS_MKDOCS_BOOK_CMDLINE_SUFFIX
+
+        PROCESS_MKDOCS()
+    }
+
+    module MKDOCSLIB: _MKDOCS_BASE_UNIT {
+        .CMD=_DOCS_MKDOCS_CMD
+        .EPILOGUE=_MKDOCS_EPILOGUE
+        .PEERDIR_POLICY=as_include
+
+        ENABLE(MKDOCSLIB)
+
+        SET(MODULE_TYPE LIBRARY)
+        SET(PEERDIR_TAGS MKDOCSLIB)
+        SET(MODULE_TAG MKDOCSLIB)
+
+        REALPRJNAME=preprocessed
+
+        _DOCS_MKDOCS_CMDLINE_SUFFIX=$_DOCS_MKDOCS_LIB_CMDLINE_SUFFIX
+
+        PROCESS_MKDOCS()
+    }
+}
+
+# tag:docs
+_DOCS_USE_PLANTUML=
+### @usage: USE_PLANTUML()
+###
+### Use PlantUML plug-in for yfm builder to render UML diagrams into documentation
+macro USE_PLANTUML() {
+    ENABLE(_DOCS_USE_PLANTUML)
+}
+
+# tag:docs
+_DOCS_DIR_VALUE=
+_DOCS_BIN_DIR_VALUE=
+### @usage: DOCS_DIR(path)
+###
+### Specify directory with source .md files for DOCS multimodule if it differs from project directory.
+### Path must be Arcadia root relative.
+###
+### @see: [DOCS](#multimodule_DOCS)
+macro DOCS_DIR(Dir) {
+    ENABLE(UNUSED_MACRO)
+}
+
+# tag:docs tag:internal
+macro _APPEND_DOCS_DIR_FLAG(DIR, NAMESPACE, DYMMY...) {
+    SET_APPEND(_DOCS_DIR_VALUE --docs-dir $DIR $NAMESPACE)
+}
+
+# tag:docs tag:internal
+macro _SET_DOCS_BIN_DIR_FLAG(NAMESPACE, DUMMY...) {
+    SET(_DOCS_BIN_DIR_VALUE --bin-dir $BINDIR $NAMESPACE $AUTO_INPUT)
+}
+
+# tag:docs tag:internal
+_YFM_DOCS_DIR_DEFAULT_VALUE=$MODDIR
+_YFM_DEFAULT_NAMESPACE=
+### @usage: DOCS_DIR(path) # internal
+macro _YFM_DOCS_DIR(DIR) {
+    _APPEND_DOCS_DIR_FLAG($DIR $_DOCS_DIR_INTERNAL_NAMESPACE $DIR)
+
+    SET(_VAR_DOCS_DIR_SALT __MODDIR__ $MODDIR __DIR__ $DIR)
+    SET(_DOCS_DIR_GLOB uniq_docs_dir_${hash:_VAR_DOCS_DIR_SALT})
+    _LATE_GLOB(${_DOCS_DIR_GLOB} ${ARCADIA_ROOT}/$DIR/**/*)
+    SET_APPEND(_DOCS_SRCS_VALUE \${input;hide:$_DOCS_DIR_GLOB})
+
+    # We set the value of var _YFM_DOCS_DIR_DEFAULT_VALUE to some non-existing dir. This value
+    # will be used in _DOCS_LIBRARY_EPILOGUE calls. In case when this macro _YFM_DOCS_DIR is
+    # explicitly called in DOCS_LIBRARY module $MODDIR as default DOCS_DIR for DOCS_LIBRARY will
+    # be ignore.
+    SET(_YFM_DOCS_DIR_DEFAULT_VALUE __dummy_dir__)
+}
+
+# tag:docs tag:internal
+_MKDOCS_DOCS_DIR_VALUE=$MODDIR
+### @usage: DOCS_DIR(path) # internal
+macro _MKDOCS_DOCS_DIR(Dir) {
+    SET(_MKDOCS_DOCS_DIR_VALUE $Dir)
+}
+
+# tag:docs
+_DOCS_DEFAULT_CONFIG=
+_DOCS_CONFIG_VALUE=$_DOCS_DEFAULT_CONFIG
+### @usage: DOCS_CONFIG(path)
+###
+### Specify path to config file for DOCS multimodule if it differs from default path.
+### If used for [MKDOCS](#multimodule_MKDOCS) multimodule the default path is "%%project_directory%%/mkdocs.yml".
+### If used for [DOCS](#multimodule_DOCS) multimodule the default path is "%%project_directory%%/.yfm".
+### Path must be either Arcadia root relative.
+###
+### @see: [DOCS](#multimodule_DOCS)
+macro DOCS_CONFIG(File) {
+    SET(_DOCS_CONFIG_VALUE $File)
+}
+
+# tag:docs
+_DOCS_VARS_VALUE=
+### @usage: DOCS_VARS(variable1=value1 variable2=value2 ...)
+###
+### Specify a set of default values of template variables for DOCS multimodule.
+### There must be no spaces around "=". Values will be treated as strings.
+###
+### @see: [DOCS](#multimodule_DOCS)
+macro DOCS_VARS(Args...) {
+    SET_APPEND(_DOCS_VARS_VALUE $Args)
+}
+
+# tag:docs
+_DOCS_INCLUDE_SOURCES_VALUE=
+### @usage: DOCS_INCLUDE_SOURCES(path...)
+###
+### Specify a list of paths to source code files which will be used as text includes in a documentation project.
+### Paths must be Arcadia root relative.
+###
+### @see: [DOCS](#multimodule_DOCS)
+macro DOCS_INCLUDE_SOURCES(Args...) {
+    SET_APPEND(_DOCS_INCLUDE_SOURCES_VALUE $Args)
+}

build/conf/export_gradle.no.conf

@@ -0,0 +1,3 @@
+macro _WHEN_EXPORT_GRADLE() {
+    ENABLE(UNUSED)
+}

build/conf/export_gradle.yes.conf

@@ -0,0 +1,3 @@
+macro _WHEN_EXPORT_GRADLE() {
+    _SETUP_PROJECT_COORDS_IF_NEEDED($MODDIR)
+}