Review changes for comments: fix, clarify + make consistent.

Author: pp-mo

lib/iris/fileformats/_nc_load_rules/__init__.py

@@ -9,8 +9,4 @@
 Interprets CF concepts identified by :mod:`iris.fileformats.cf` to add
 components into loaded cubes.
 
-For now : the API mimics :class:`pyke.knowledge_engine.engine`.
-As this is aiming to replace the old Pyke-based logic rules.
-TODO: simplify once the parallel operation with Pyke is no  longer required.
-
 """

lib/iris/fileformats/netcdf.py

@@ -580,7 +580,7 @@ def _load_cube(engine, cf, cf_var, filename):
     engine.cube = cube
     engine.cube_parts = {}
     engine.requires = {}
-    engine.rule_triggered = OrderedAddableList()  # set()
+    engine.rule_triggered = OrderedAddableList()
     engine.filename = filename
 
     # Assert all the case-specific facts.

lib/iris/tests/unit/fileformats/nc_load_rules/actions/__init__.py

@@ -26,8 +26,8 @@
 IN cf : "def _load_cube(engine, cf, cf_var, filename)"
 WHERE:
   - engine is a :class:`iris.fileformats._nc_load_rules.engine.Engine`
-  - cf is a CFReader
-  - cf_var is a CFDAtaVariable
+  - cf is a :class:`iris.fileformats.cf.CFReader`
+  - cf_var is a :class:`iris.fileformats.cf.CFDataVariable`
 
 As it's hard to construct a suitable CFReader from scratch, it would seem
 simpler (for now) to use an ACTUAL FILE.