Renaming, commenting sample

libraries/examples/scripting/jvm-maven-deps/script/src/org/jetbrains/kotlin/script/examples/jvm/resolve/maven/scriptDef.kt

@@ -34,9 +34,13 @@ object MyScriptProperties : ScriptingProperties() {
                 "scripting-jvm-maven-deps", // script library jar name
                 "kotlin-script-util" // DependsOn annotation is taken from script-util
             )
+            // variant: dependencies(collectDependenciesFromCurrentContext(...
             refineConfiguration {
+            // variant ^: dynamicConfiguration
                 handler(MyConfigurator())
-                onAnnotations(DependsOn::class, Repository::class)
+                triggerOnAnnotations(DependsOn::class, Repository::class)
+                // variants: onAnnotations, refineOnAnnotations (esp. for dynamicConfiguration), updateOnAnnotations
+                // other triggers: beforeParsing, onSections
             }
         }
     }

libraries/scripting/common/src/kotlin/script/experimental/api/scriptDefinition.kt

@@ -69,31 +69,31 @@ class RefineConfigurationBuilder(props: ScriptingProperties) : PropertiesBuilder
         props.data[ScriptDefinitionProperties.refineConfigurationHandler] = fn
     }
 
-    fun beforeParsing(value: Boolean = true) {
+    fun triggerBeforeParsing(value: Boolean = true) {
         props.data[ScriptDefinitionProperties.refineConfigurationBeforeParsing] = value
     }
 
-    fun onAnnotations(annotations: Iterable<KotlinType>) {
+    fun triggerOnAnnotations(annotations: Iterable<KotlinType>) {
         props.data.addToListProperty(ScriptDefinitionProperties.refineConfigurationOnAnnotations, annotations)
     }
 
-    fun onAnnotations(vararg annotations: KotlinType) {
+    fun triggerOnAnnotations(vararg annotations: KotlinType) {
-        onAnnotations(annotations.asIterable())
+        triggerOnAnnotations(annotations.asIterable())
     }
 
-    inline fun <reified T : Annotation> onAnnotations() {
+    inline fun <reified T : Annotation> triggerOnAnnotations() {
-        onAnnotations(KotlinType(T::class))
+        triggerOnAnnotations(KotlinType(T::class))
     }
 
-    fun onAnnotations(vararg annotations: KClass<out Annotation>) {
+    fun triggerOnAnnotations(vararg annotations: KClass<out Annotation>) {
-        onAnnotations(annotations.map { KotlinType(it) })
+        triggerOnAnnotations(annotations.map { KotlinType(it) })
     }
 
-    fun onSections(sections: Iterable<String>) {
+    fun triggerOnSections(sections: Iterable<String>) {
         props.data.addToListProperty(ScriptDefinitionProperties.refineConfigurationOnSections, sections)
     }
 
-    fun onSections(vararg sections: String) {
+    fun triggerOnSections(vararg sections: String) {
         props.data.addToListProperty(ScriptDefinitionProperties.refineConfigurationOnSections, *sections)
     }
 }