.

software/ors-amarisoft/config/enb.jinja2.cfg

@@ -14,8 +14,18 @@
 
 {%- import 'lte.jinja2' as lte -%}
 
-{#- return value is json-encoded to workaround jinja2 macro-ret limitation. #}
-{#- XXX macro return json -> starts from j #}
+{#- J is used around macro calls to retrieve returned objects.
+
+    It is needed to workaround jinja2 limitation that macro can return only
+    strings - not arbitrary objects: we return objects as JSON-encoded string
+    and J decodes them.
+
+    By convention macros that return JSON-encoded objects start with "j" prefix.
+
+    Usage example:
+
+      set obj = J(jmymacro(...))
+#}
 {%- set J = json_module.loads %}
 
 {#- XXX error(slave, msg)  vvv is debug stub -#}
@@ -420,7 +430,7 @@
     ],
   },
 
-  # NR cells
+  # NR cells (TODO)
   {#- XXX + nr_cell_list        #}
   {#- XXX + nr_cell_default     #}
 }