fix macros usages

commit_hash:fee2049f5852cb4173e4f523434afca9dcb771cc

build/conf/docs.conf

@@ -125,7 +125,7 @@ module _DOCS_BASE_UNIT: _DOCS_BARE_UNIT {
 }
 
 # tag:internal tag:docs
-### _DOCS_YFM_USE_PLANTUML() # internal
+### @usage: _DOCS_YFM_USE_PLANTUML() # internal
 ###
 ### This macr sets appropriate dependencies for use of plantuml plugin
 macro _DOCS_YFM_USE_PLANTUML() {

build/conf/java.conf

@@ -126,7 +126,7 @@ multimodule JAVA_CONTRIB_ANNOTATION_PROCESSOR {
     }
 }
 
-### Usage JUNIT_TESTS_JAR(path/to/some/peer realname.jar)
+### @usage: JUNIT_TESTS_JAR(path/to/some/peer realname.jar)
 ###
 ### Specifies jar to search test suites and test cases. By default tests are
 ### searched in the jar compild by JTEST or JUNIT5 module sources. This macro
@@ -1797,7 +1797,7 @@ macro ANNOTATION_PROCESSOR(Args...) {
 }
 
 EXCLUDE_VALUE=
-### EXCLUDE(prefixes)
+### @usage: EXCLUDE(prefixes)
 ###
 ### Specifies which libraries should be excluded from the classpath.
 macro EXCLUDE(Args...) {
@@ -2066,7 +2066,7 @@ IGNORE_JAVA_DEPENDENCIES_CONFIGURATION=no
 JAVA_DEPENDENCIES_CONFIGURATION_VALUE=
 
 # tag:java-specific
-### @usage JAVA_DEPENDENCIES_CONFIGURATION(Vetos...)
+### @usage: JAVA_DEPENDENCIES_CONFIGURATION(Vetos...)
 ### Validate contrib/java dependencies
 ### Valid arguments
 ### FORBID_DIRECT_PEERDIRS - fail when module have direct PEERDIR (with version) (non-transitive)
@@ -2087,7 +2087,7 @@ JAR_INCLUDE_FILTER_VALUE=
 JAR_EXCLUDE_FILTER_VALUE=
 
 # tag:java-specific
-### @usage:JAR_INCLUDE(Filters...)
+### @usage: JAR_INCLUDE(Filters...)
 ### Filter .jar file content: keep only matched files
 ### * and ** patterns are supported (like JAVA_SRCS)
 macro JAR_INCLUDE(Filters...) {
@@ -2095,7 +2095,7 @@ macro JAR_INCLUDE(Filters...) {
 }
 
 # tag:java-specific
-### @usage:JAR_EXCLUDE(Filters...)
+### @usage: JAR_EXCLUDE(Filters...)
 ### Filter .jar file content: remove matched files
 ### * and ** patterns are supported (like JAVA_SRCS)
 macro JAR_EXCLUDE(Filters...) {
@@ -2198,7 +2198,7 @@ macro USE_KTLINT_OLD() {
 _KTLINT_BASELINE_FILE=
 
 # tag:kotlin-specific
-### @usage: #deprecated KTLINT_BASELINE_FILE(ktlint-baseline.xml "https://st.yandex-team.ru/REMOVE-BASELINE-1")
+### @usage: KTLINT_BASELINE_FILE(ktlint-baseline.xml "https://st.yandex-team.ru/REMOVE-BASELINE-1") # deprecated
 ### Path to baseline file for ktlint test and ticket to fix all ktlint warnings in file and then remove it
 macro KTLINT_BASELINE_FILE(File, Ticket) {
     SET(_KTLINT_BASELINE_FILE $File)

build/conf/proto.conf

@@ -566,7 +566,7 @@ macro GRPC() {
 _GRPC_GMOCK_OUTFLAG=
 
 # tag:proto tag:grpc
-### @usage: WITH_GMOCK()
+### @usage: GRPC_WITH_GMOCK()
 ###
 ### Enable generating *_mock.grpc.pb.cc/h files
 macro GRPC_WITH_GMOCK() {

build/conf/python.conf

@@ -745,7 +745,7 @@ otherwise {
 }
 
 # tag:python-specific
-### @usage: _BASE_PY_PROGRAM #internal
+### @usage: _BASE_PY3_PROGRAM #internal
 ###
 ### The base module for all Python 3.x binary programs. Adds linking logic, relevant module properties and
 ### dependency on Python 3.x interpreter. Also adds import tests on all sources including libraries.
@@ -901,7 +901,7 @@ macro _ARCADIA_PYTHON3_ADDINCL() {
 }
 
 # tag:python-specific  tag:internal
-### @usage: _PYTHON_ADDINCL()  # internal
+### @usage: _PYTHON3_ADDINCL()  # internal
 ###
 ### This macro sets up Python 3.x headers for both Arcadia and non-Arcadia python.
 macro _PYTHON3_ADDINCL() {

build/conf/ts/ts.conf

@@ -121,7 +121,7 @@ macro TS_ESLINT_CONFIG(ConfigName) {
 }
 
 _TS_LINT_SRCS_VALUE=
-### _TS_CONFIG_EPILOGUE() # internal
+### @usage: _TS_CONFIG_EPILOGUE() # internal
 ###
 ### This macro executes macros which should be invoked after all user specified macros in the ya.make file
 macro _TS_CONFIG_EPILOGUE() {
@@ -140,7 +140,7 @@ TSYNDEXER_CMD=${cwd:ARCADIA_BUILD_ROOT} \
     $TSYNDEXER_TOOL -m ${CURDIR} -o ${output:TSYNDEXER_OUTPUT_FILE} -r ${ARCADIA_ROOT} \
     ${hide;kv:"pc magenta"} ${hide;kv:"p YTS"} $_AS_HIDDEN_INPUTS(IN $_TS_LINT_SRCS_VALUE)
 
-### _DO_TS_YNDEXING() # internal
+### @usage: _DO_TS_YNDEXING() # internal
 ###
 ### Adds a command-node for TS-modules codenavigation indexing.
 ### Output ydx.pb2 file will be processed along with other indexes for other modules and
@@ -179,7 +179,7 @@ macro _AS_HIDDEN_INPUTS(IN{input}[]) {
 
 _TS_FILES_COPY_CMD=
 
-### TS_FILES(Files...)
+### @usage: TS_FILES(Files...)
 ###
 ### Adds files to output as is. Similar to FILES but works for TS build modules
 ### Documentation: https://docs.yandex-team.ru/frontend-in-arcadia/references/TS_PACKAGE#ts-files
@@ -188,7 +188,7 @@ macro TS_FILES(Files...) {
     _TS_FILES($Files)
 }
 
-### TS_FILES_GLOB(Glob...)
+### @usage: TS_FILES_GLOB(Glob...)
 ###
 ### Adds files to output by glob, e.g. TS_FILES_GLOB(**/*.css)
 ### Documentation: https://docs.yandex-team.ru/frontend-in-arcadia/references/TS_PACKAGE#ts-files-glob
@@ -197,7 +197,7 @@ macro TS_FILES_GLOB(Glob...) {
     TS_FILES(${FILES_BY_GLOB})
 }
 
-### @usage TS_LARGE_FILES(DESTINATION dest_dir Files...)
+### @usage: TS_LARGE_FILES(DESTINATION dest_dir Files...)
 ###
 ### Use large file ether from working copy or from remote storage via placeholder <File>.external
 ### If <File> is present locally (and not a symlink!) it will be copied to build directory.

build/plugins/extralibs.py

@@ -1,6 +1,6 @@
 def onpy_extralibs(unit, *args):
     """
-    @usage: EXTRALIBS(liblist)
+    @usage: PY_EXTRALIBS(liblist)
     Add external dynamic libraries during program linkage stage" }
     """
 

build/ymake.core.conf

@@ -440,7 +440,7 @@ macro CHECK_CONFIG_H(Conf) {
 }
 
 REQUIRED_TRANSITIVE_PEERS=
-### @usage REQUIRES(dirs...)
+### @usage: REQUIRES(dirs...)
 ###
 ### Specify list of dirs which this module must depend on indirectly.
 ###
@@ -452,7 +452,7 @@ macro REQUIRES(DIRS[]) {
 
 CHECK_DEPENDENT_DIRS_TYPES=
 CHECK_DEPENDENT_DIRS_RESTRICTIONS=
-### @usage CHECK_DEPENDENT_DIRS(DENY|ALLOW_ONLY ([ALL|PEERDIRS|GLOB] dir)...)
+### @usage: CHECK_DEPENDENT_DIRS(DENY|ALLOW_ONLY ([ALL|PEERDIRS|GLOB] dir)...)
 ###
 ### Specify project transitive dependencies constraints.
 ###
@@ -479,7 +479,7 @@ macro _RESOURCE_SEM(INPUTS[], KEYS[], OPTS[]) {
 }
 
 # tag:built-in
-### @usage: RESOURCE([FORCE_TEXT ][Src Key]* [- Key=Value]*) # built-in
+### @usage: RESOURCE([FORCE_TEXT ][Src Key]* [- Key=Value]*) # builtin
 ### Add data (resources, random files, strings) to the program)
 ### The common usage is to place Src file into binary. The Key is used to access it using library/cpp/resource or library/python/resource.
 ### Alternative syntax with '- Key=Value' allows placing Value string as resource data into binary and make it accessible by Key.
@@ -1018,7 +1018,7 @@ when ($SO_OUTPUTS == "yes") {
 }
 
 # tag:restricted tag:DLL
-### $usage: WITH_DYNAMIC_LIBS() # restricted
+### @usage: WITH_DYNAMIC_LIBS() # restricted
 ###
 ### Include dynamic libraries as extra PROGRAM/DLL outputs
 macro WITH_DYNAMIC_LIBS() {
@@ -1026,31 +1026,31 @@ macro WITH_DYNAMIC_LIBS() {
 }
 
 # tag:internal
-### $usage: REAL_LINK_EXE_IMPL(peers...) # internal
+### @usage: REAL_LINK_EXE_IMPL(peers...) # internal
 macro REAL_LINK_EXE_IMPL(WHOLE_ARCHIVE_PEERS...) {
     .CMD=$REAL_LINK_EXE_CMDLINE && $LINK_OR_COPY_SO_CMD
 }
 
 # tag:internal
-### $usage: REAL_LINK_EXEC_DYN_LIB_IMPL(peers...) # internal
+### @usage: REAL_LINK_EXEC_DYN_LIB_IMPL(peers...) # internal
 macro REAL_LINK_EXEC_DYN_LIB_IMPL(WHOLE_ARCHIVE_PEERS...) {
     .CMD=$REAL_LINK_EXEC_DYN_LIB_CMDLINE
 }
 
 # tag:internal
-### $usage: REAL_LINK_DYN_LIB_IMPL(peers...) # internal
+### @usage: REAL_LINK_DYN_LIB_IMPL(peers...) # internal
 macro REAL_LINK_DYN_LIB_IMPL(WHOLE_ARCHIVE_PEERS...) {
     .CMD=$REAL_LINK_DYN_LIB_CMDLINE && $LINK_OR_COPY_SO_CMD
 }
 
 # tag:internal
-### $usage: LINK_EXE_IMPL(peers...) # internal
+### @usage: LINK_EXE_IMPL(peers...) # internal
 macro LINK_EXE_IMPL(WHOLE_ARCHIVE_PEERS...) {
     .CMD=$LINK_EXE_CMDLINE && $LINK_OR_COPY_SO_CMD
 }
 
 # tag:internal
-### $usage: LINK_EXEC_DYN_LIB_IMPL(peers...) # internal
+### @usage: LINK_EXEC_DYN_LIB_IMPL(peers...) # internal
 macro LINK_EXEC_DYN_LIB_IMPL(WHOLE_ARCHIVE_PEERS...) {
     .CMD=$LINK_EXEC_DYN_LIB_CMDLINE
 }
@@ -1457,7 +1457,7 @@ module BOOSTTEST: _BASE_PROGRAM {
 }
 
 # tag:deprecated
-### @usage BOOSTTEST_WITH_MAIN([name]) #deprecated
+### @usage: BOOSTTEST_WITH_MAIN([name]) #deprecated
 ###
 ### Same as BOOSTTEST (see above), but comes with builtin int main(argc, argv) implementation
 module BOOSTTEST_WITH_MAIN: BOOSTTEST {
@@ -2578,7 +2578,7 @@ macro EXTRALIBS_STATIC(Args...) {
     LDFLAGS(-Wl,-Bstatic ${Args} -Wl,-Bdynamic)
 }
 
-### @usage ADD_COMPILABLE_TRANSLATE(Dict Name Options...)
+### @usage: ADD_COMPILABLE_TRANSLATE(Dict Name Options...)
 ###
 ### Generate translation dictionary code to transdict.LOWER(Name).cpp that will than be compiled into library
 macro ADD_COMPILABLE_TRANSLATE(Dict, Name, MakeTransDictOptions...) {
@@ -2587,7 +2587,7 @@ macro ADD_COMPILABLE_TRANSLATE(Dict, Name, MakeTransDictOptions...) {
      RUN_PROGRAM(dict/tools/maketransdict -i ${Dict} ${MakeTransDictOptions} ${Name} STDOUT_NOAUTO ${__translate_dict} IN ${Dict})
 }
 
-### @usage ADD_COMPILABLE_TRANSLIT(TranslitTable NGrams Name Options...)
+### @usage: ADD_COMPILABLE_TRANSLIT(TranslitTable NGrams Name Options...)
 ###
 ### Generate transliteration dictionary code
 ### This will emit both translit, untranslit and ngrams table codes those will be than further compiled into library
@@ -2643,7 +2643,7 @@ macro _ARF_HELPER(Args...) {
      RESOURCE_FILES($Args)
 }
 
-### @usage ALL_RESOURCE_FILES(Ext [PREFIX {prefix}] [STRIP {strip}] Dirs...)
+### @usage: ALL_RESOURCE_FILES(Ext [PREFIX {prefix}] [STRIP {strip}] Dirs...)
 ###
 ### This macro collects all files with extension `Ext` and
 ### Passes them to `RESOURCE_FILES` macro as relative to current directory
@@ -2657,7 +2657,7 @@ macro ALL_RESOURCE_FILES(EXT, PREFIX="", STRIP="", DIRS...) {
      _ARF_HELPER(${pre=PREFIX :PREFIX} STRIP ${ARCADIA_ROOT}/${MODDIR}/${STRIP} ${pre=$ALL_RES_:EXT})
 }
 
-### @usage ALL_RESOURCE_FILES_FROM_DIRS([PREFIX {prefix}] [STRIP {strip}] Dirs...)
+### @usage: ALL_RESOURCE_FILES_FROM_DIRS([PREFIX {prefix}] [STRIP {strip}] Dirs...)
 ###
 ### This macro collects all files non-recursively from listed Dirs and
 ### Passes them to `RESOURCE_FILES` macro as relative to current directory
@@ -3435,7 +3435,7 @@ macro _SRC("ydl", SRC, SRCFLAGS...) {
 }
 
 # tag:ydl-specific
-### @usage BUILD_YDL_DESC(Input Symbol Output)
+### @usage: BUILD_YDL_DESC(Input Symbol Output)
 ###
 ### Generate a descriptor for a Symbol located in a ydl module Input, and put it to the file Output.
 ###
@@ -3468,7 +3468,7 @@ macro YDL_DESC_USE_BINARY() {
     SET_APPEND(YDL_DESC_FLAGS $YDL_DESC_FLAGS_BINARY)
 }
 
-### @usage SRC(File Flags...)
+### @usage: SRC(File Flags...)
 ###
 ### Compile single file with extra Flags.
 ### Compilation is driven by the last extension of the File and Flags are specific to corresponding compilation command
@@ -3561,7 +3561,7 @@ macro _SRC_CUSTOM_C_CPP("C", MACRO_NAME, FILE, COMPILE_OUT_SUFFIX, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_SSE2(File Flags...)
+### @usage: SRC_C_SSE2(File Flags...)
 ###
 ### Compile a single C/C++ file with SSE2 and additional Flags
 macro SRC_C_SSE2(FILE, FLAGS...) {
@@ -3569,7 +3569,7 @@ macro SRC_C_SSE2(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_SSE3(File Flags...)
+### @usage: SRC_C_SSE3(File Flags...)
 ###
 ### Compile a single C/C++ file with SSE3 and additional Flags
 macro SRC_C_SSE3(FILE, FLAGS...) {
@@ -3577,7 +3577,7 @@ macro SRC_C_SSE3(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_SSSE3(File Flags...)
+### @usage: SRC_C_SSSE3(File Flags...)
 ###
 ### Compile a single C/C++ file with SSSE3 and additional Flags
 macro SRC_C_SSSE3(FILE, FLAGS...) {
@@ -3585,7 +3585,7 @@ macro SRC_C_SSSE3(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_SSE4(File Flags...)
+### @usage: SRC_C_SSE4(File Flags...)
 ###
 ### Compile a single C/C++ file with SSE4 and additional Flags
 macro SRC_C_SSE4(FILE, FLAGS...) {
@@ -3593,7 +3593,7 @@ macro SRC_C_SSE4(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_SSE41(File Flags...)
+### @usage: SRC_C_SSE41(File Flags...)
 ###
 ### Compile a single C/C++ file with SSE4.1 and additional Flags
 macro SRC_C_SSE41(FILE, FLAGS...) {
@@ -3601,7 +3601,7 @@ macro SRC_C_SSE41(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_AVX(File Flags...)
+### @usage: SRC_C_AVX(File Flags...)
 ###
 ### Compile a single C/C++ file with AVX and additional Flags
 macro SRC_C_AVX(FILE, FLAGS...) {
@@ -3609,7 +3609,7 @@ macro SRC_C_AVX(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_AVX2(File Flags...)
+### @usage: SRC_C_AVX2(File Flags...)
 ###
 ### Compile a single C/C++ file with AVX2 and additional Flags
 macro SRC_C_AVX2(FILE, FLAGS...) {
@@ -3617,7 +3617,7 @@ macro SRC_C_AVX2(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_AVX512(File Flags...)
+### @usage: SRC_C_AVX512(File Flags...)
 ###
 ### Compile a single C/C++ file with AVX512 and additional Flags
 macro SRC_C_AVX512(FILE, FLAGS...) {
@@ -3625,7 +3625,7 @@ macro SRC_C_AVX512(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_AVX512(File Flags...)
+### @usage: SRC_C_AMX(File Flags...)
 ###
 ### Compile a single C/C++ file with AVX512 and additional Flags
 macro SRC_C_AMX(FILE, FLAGS...) {
@@ -3633,7 +3633,7 @@ macro SRC_C_AMX(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_XOP(File Flags...)
+### @usage: SRC_C_XOP(File Flags...)
 ###
 ### Compile a single C/C++ file with (an AMD-specific instruction set,
 ### see https://en.wikipedia.org/wiki/XOP_instruction_set) and additional Flags
@@ -3642,7 +3642,7 @@ macro SRC_C_XOP(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific tag:cpu
-### @uasge SRC_C_PCLMUL(File Flags...)
+### @usage: SRC_C_PCLMUL(File Flags...)
 ###
 ### Compile a single C/C++ file with PCLMUL and additional Flags
 macro SRC_C_PCLMUL(FILE, FLAGS...) {
@@ -3699,7 +3699,7 @@ macro _SRC_STRICT_C_CPP("C", MACRO_NAME, FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific
-### @uasge SRC_C_PIC(File Flags...)
+### @usage: SRC_C_PIC(File Flags...)
 ###
 ### Compile a single C/C++ file with -fPIC and additional Flags
 macro SRC_C_PIC(FILE, FLAGS...) {
@@ -3707,7 +3707,7 @@ macro SRC_C_PIC(FILE, FLAGS...) {
 }
 
 # tag:src-specific tag:cpp-specific
-### @uasge SRC_C_NO_LTO(File Flags...)
+### @usage: SRC_C_NO_LTO(File Flags...)
 ###
 ### Compile a single C/C++ file with link-time-optimization disabling and additional Flags
 macro SRC_C_NO_LTO(FILE, FLAGS...) {
@@ -3912,7 +3912,7 @@ macro UPDATE_VCS_JAVA_INFO_NODEP(Jar) {
 
 VCS_INFO_FILE=
 
-### @usage VCS_INFO_FILE([FILE out_file])
+### @usage: VCS_INFO_FILE([FILE out_file])
 ###
 ### Enable saving vcs info as a json-file into PACKAGE
 ###
@@ -3951,7 +3951,7 @@ macro DECIMAL_MD5_LOWER_32_BITS(File, FUNCNAME="", Opts...) {
 }
 
 # tag:internal
-### @usage $CFG_VARS # internal
+### @usage: CFG_VARS # internal
 ###
 ### Mark commands that embed Configuration variables into files
 macro CFG_VARS() {
@@ -4379,7 +4379,7 @@ macro _TARGET_SOURCES_FOR_HEADERS(Args...) {
 }
 
 # tag:internal
-### @usage: _TARGET_SOURCES_FOR_HEADERS_IMPL([GENERATE] Args...) # internal
+### @usage: _SET_ENV_FOR_CUSTOM_COMMAND_IMPL([GENERATE] Args...) # internal
 ### Generate prefix " ${CMAKE_COMMAND} -E env " before $Args when GENERATE is specified in the list of actual arguments
 macro _SET_ENV_FOR_CUSTOM_COMMAND_IMPL(GENERATE?" ${CMAKE_COMMAND} -E env ":"", Args...) {
     .SEM=$GENERATE ${pre= :Args}
@@ -4611,7 +4611,7 @@ macro FROM_SANDBOX(Id, OUT{output}[], OUT_NOAUTO{output}[], OUTPUT_INCLUDES[], I
     ADD_CHECK(check.resource $Id)
 }
 
-### @usage LARGE_FILES([AUTOUPDATED]  Files...)
+### @usage: LARGE_FILES([AUTOUPDATED]  Files...)
 ###
 ### Use large file ether from working copy or from remote storage via placeholder <File>.external
 ### If <File> is present locally (and not a symlink!) it will be copied to build directory.
@@ -4814,7 +4814,7 @@ otherwise {
 PACK_TGZ=${cwd:ARCADIA_BUILD_ROOT} tar -czf ${rootrel:OUTPUT} ${rootrel:INPUT} ${hide;kv:"p AR"} ${hide;kv:"pc light-red"}
 
 #  tag:internal
-### @usage TOUCH(Outputs...) # internal
+### @usage: TOUCH(Outputs...) # internal
 ### Just introduce outputs
 macro TOUCH(Outputs...) {
     .CMD=$YMAKE_PYTHON ${input:"build/scripts/touch.py"} ${output:Outputs}
@@ -5132,7 +5132,7 @@ module PREBUILT_PROGRAM: _LINK_UNIT {
     }
 }
 
-### @usage COLLECT_JINJA_TEMPLATES(varname path)
+### @usage: COLLECT_JINJA_TEMPLATES(varname path)
 ###
 ### This macro collects all jinja and yaml files in the directory specified by second argument and
 ### stores result in the variable with mane specified by first parameter.
@@ -5809,7 +5809,7 @@ macro _ADD_CPP_LINTER_CHECK(Args...) {
 }
 
 # tag:test
-### @usage STYLE_CPP([CONFIG_TYPE config_type])
+### @usage: STYLE_CPP([CONFIG_TYPE config_type])
 ###
 ### Run 'ya tool clang-format' test on all cpp sources and headers of the current module
 macro STYLE_CPP(CONFIG_TYPE="") {