Merge branch 'topic/lkql_jit/add_create_from_template' into 'master'

Enhance the "create_from_template" documentation and update generated LKQL user manual

See merge request eng/libadalang/langkit-query-language!430

Author: HugoGGuerrier

lkql_jit/language/src/main/java/com/adacore/lkql_jit/built_ins/methods/RewritingContextMethods.java

@@ -187,8 +187,20 @@ public Object executeGeneric(VirtualFrame frame, RewritingContext ctx, Object ob
 
     @BuiltInMethod(
         name = "create_from_template",
-        doc = "Create a new node from the provided template, filling '{}' with provided" +
-        " argument, and parsing the template with the specified grammar rule"
+        doc = """
+        Create a new node from the provided template, filling '{}' with provided
+        argument, and parsing the template with the specified grammar rule. Example:
+
+        .. code-block:: lkql
+
+          # Create a new BinOp node with OpAdd as operator, representing the addition of the value
+          # expressed by `my_other_node`, and "42".
+          ctx.create_from_template(
+              "{} + 42",
+              "expr_rule",
+              [my_other_node]
+          )
+        """
     )
     public abstract static class CreateFromTemplateExpr extends BaseRewritingContextExpr {
 

user_manual/generated/std.rst

@@ -415,6 +415,22 @@ Methods for `RewritingContext`
 
     Insert `new_node` at the end of `list_node`
 
+.. method:: RewritingContext.create_from_template(this, template, grammar_rule, arguments)
+
+    Create a new node from the provided template, filling '{}' with provided
+    argument, and parsing the template with the specified grammar rule. Example:
+    
+    .. code-block:: lkql
+    
+      # Create a new BinOp node with OpAdd as operator, representing the addition of the value
+      # expressed by `my_other_node`, and "42".
+      ctx.create_from_template(
+          "{} + 42",
+          "expr_rule",
+          [my_other_node]
+      )
+    
+
 .. method:: RewritingContext.doc(this)
 
     Given any object, return the documentation associated with it