From eae1693c768eabaca45e02e216ac8c55bcff46a9 Mon Sep 17 00:00:00 2001
From: Erez Sh <erezshin@gmail.com>
Date: Sun, 16 Aug 2020 20:56:25 +0300
Subject: [PATCH] Docs: Moved some examples away from docstrings

---
 docs/visitors.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 lark/visitors.py  | 38 --------------------------------------
 2 files changed, 40 insertions(+), 38 deletions(-)

diff --git a/docs/visitors.rst b/docs/visitors.rst
index a734e3b..aa3189e 100644
--- a/docs/visitors.rst
+++ b/docs/visitors.rst
@@ -45,12 +45,52 @@ Interpreter
 
 .. autoclass:: lark.visitors.Interpreter
 
+
+Example:
+    ::
+
+        class IncreaseSomeOfTheNumbers(Interpreter):
+            def number(self, tree):
+                tree.children[0] += 1
+
+            def skip(self, tree):
+                # skip this subtree. don't change any number node inside it.
+                pass
+
+            IncreaseSomeOfTheNumbers().visit(parse_tree)
+
 Transformer
 -----------
 
 .. autoclass:: lark.visitors.Transformer
     :members: __default__, __default_token__
 
+Example:
+    ::
+
+        from lark import Tree, Transformer
+
+        class EvalExpressions(Transformer):
+            def expr(self, args):
+                    return eval(args[0])
+
+        t = Tree('a', [Tree('expr', ['1+2'])])
+        print(EvalExpressions().transform( t ))
+
+        # Prints: Tree(a, [3])
+
+Example:
+    ::
+
+        class T(Transformer):
+            INT = int
+            NUMBER = float
+            def NAME(self, name):
+                return lookup_dict.get(name, name)
+
+        T(visit_tokens=True).transform(tree)
+
+
 v_args
 ------
 
diff --git a/lark/visitors.py b/lark/visitors.py
index 6ea39b0..14896e5 100644
--- a/lark/visitors.py
+++ b/lark/visitors.py
@@ -63,20 +63,6 @@ class Transformer(_Decoratable):
     - ``Transformer_InPlace`` - Non-recursive. Changes the tree in-place instead of returning new instances
     - ``Transformer_InPlaceRecursive`` - Recursive. Changes the tree in-place instead of returning new instances
 
-    Example:
-        ::
-
-            from lark import Tree, Transformer
-
-            class EvalExpressions(Transformer):
-                def expr(self, args):
-                        return eval(args[0])
-
-            t = Tree('a', [Tree('expr', ['1+2'])])
-            print(EvalExpressions().transform( t ))
-
-            # Prints: Tree(a, [3])
-
     Parameters:
         visit_tokens: By default, transformers only visit rules.
             visit_tokens=True will tell ``Transformer`` to visit tokens
@@ -84,17 +70,6 @@ class Transformer(_Decoratable):
             but it's easier to maintain and works for all algorithms
             (even when there isn't a lexer).
 
-    Example:
-        ::
-
-            class T(Transformer):
-                INT = int
-                NUMBER = float
-                def NAME(self, name):
-                    return lookup_dict.get(name, name)
-
-            T(visit_tokens=True).transform(tree)
-
     """
     __visit_tokens__ = True   # For backwards compatibility
 
@@ -328,19 +303,6 @@ class Interpreter(_Decoratable):
     Unlike ``Transformer`` and ``Visitor``, the Interpreter doesn't automatically visit its sub-branches.
     The user has to explicitly call ``visit``, ``visit_children``, or use the ``@visit_children_decor``.
     This allows the user to implement branching and loops.
-
-    Example:
-        ::
-
-            class IncreaseSomeOfTheNumbers(Interpreter):
-                def number(self, tree):
-                    tree.children[0] += 1
-
-                def skip(self, tree):
-                    # skip this subtree. don't change any number node inside it.
-                    pass
-
-                IncreaseSomeOfTheNumbers().visit(parse_tree)
     """
 
     def visit(self, tree):