variables: document make run variables

Signed-off-by: Øyvind Harboe <[email protected]>

Author: oharboe

flow/Makefile

@@ -1051,8 +1051,6 @@ test-unset-and-make-%: ; $(UNSET_AND_MAKE) $*
 klayout:
 	$(KLAYOUT_CMD)
 
-export RUN_LOG_NAME_STEM ?= run
-
 .phony: run
 run:
 	@mkdir -p $(RESULTS_DIR) $(LOG_DIR) $(REPORTS_DIR) $(OBJECTS_DIR)

flow/scripts/variables.yaml

@@ -875,3 +875,12 @@ GDS_ALLOW_EMPTY:
     Regular expression of module names of macros that have no .gds file
   stages:
     - final
+RUN_SCRIPT:
+  description: >
+    Path to script to run from `make run`, python or tcl script detected by
+    .py or .tcl extension.
+RUN_LOG_NAME_STEM:
+  description: >
+    Stem of the log file name, the log file will be named
+    `$(LOG_DIR)/$(RUN_LOG_NAME_STEM).log`.
+  default: run