diff --git a/build/ymake.core.conf b/build/ymake.core.conf
index 3f5f5b3a..f100865d 100644
--- a/build/ymake.core.conf
+++ b/build/ymake.core.conf
@@ -3140,10 +3140,19 @@ macro _SRC_f_old(SRC, SRCFLAGS...) {
     .CMD=$YMAKE_PYTHON ${input:"build/scripts/f2c.py"} -t ${tool:"contrib/tools/f2c"} -c ${input:SRC} -o ${output:SRC.c} ${hide;output_include:"f2c.h"} ${hide;kv:"p FT"} ${hide;kv:"pc light-green"}
 }
 
+### @usage: AR_PLUGIN(plugin_name)
+###
+### Register script, which will process module's .a (archive) output
+### Script will receive path to archive, which it should modify in place
 macro AR_PLUGIN(name) {
     SET(_AR_PLUGIN $name.pyplugin)
 }
 
+### @usage: LD_PLUGIN(plugin_name)
+###
+### Register script, which will process all inputs to any link_exe.py call with modules's library
+### Script will receive all arguments to link_exe.py, and can output into stdout preprocessed list
+### of all arguments, in JSON format
 macro LD_PLUGIN(name) {
     SRCS(GLOBAL $name.pyplugin)
 }