Add comments

Author: hermansje

pythonwhat/check_function.py

@@ -56,7 +56,7 @@ def check_function(name, index=0,
             in case the function parameters were not successfully matched.
         expand_msg (str): If specified, this overrides any messages that are prepended by previous SCT chains.
         signature (Signature): Normally, check_function() can figure out what the function signature is,
-            but it might be necessary to use build_sig to manually build a signature and pass this along.
+            but it might be necessary to use ``sig_from_params()`` to manually build a signature and pass this along.
         state (State): State object that is passed from the SCT Chain (don't specify this).
 
     :Examples:

pythonwhat/check_syntax.py

@@ -46,7 +46,7 @@ def wrapper(*args, **kwargs):
 class Chain:
     def __init__(self, state):
         self._state = state
-        self._crnt_sct = None
+        self._crnt_sct = None  # last called SCT
         self._waiting_on_call = False
 
     def _double_attr_error(self):
@@ -91,6 +91,7 @@ def __init__(self, stack = None):
 
     def __call__(self, *args, **kwargs):
         if not self._crnt_sct:
+            # first function in chain
             state = kwargs.get('state') or args[0]
             return reduce(lambda s, f: f(state=s), self._stack, state)
         else: