Clarify docs, mark functor funcs to be depreciated

Author: kennykos

pykokkos/core/translators/members.py

@@ -115,9 +115,12 @@ def get_fields(
         Get all fields (or instance variables) in classdef by parsing the constructor
 
         :param classdef: the classdef being parsed
-        :param source: the python source code of the workload
+        :param source: the python source code of the functor
         :param pk_import: the identifier used to access the PyKokkos package
         :returns: a dictionary mapping from field name to type
+
+
+        NOTE: **used by workloads & functors; depreciate with functions** 
         """
 
         visitor = ConstructorVisitor(source, "fields", pk_import, True)
@@ -133,9 +136,11 @@ def get_views(
         Get all views defined in classdef by parsing the constructor
 
         :param classdef: the classdef to be parsed
-        :param source: the python source code of the workload
+        :param source: the python source code of the functor
         :param pk_import: the identifier used to access the PyKokkos package
         :returns: a dictionary mapping from view name to type (only dimensionality and type)
+
+        NOTE: **used by workloads & functors; depreciate with functions** 
         """
 
         visitor = ConstructorVisitor(source, "views", pk_import, True)
@@ -179,7 +184,7 @@ def get_params(
         Gets all fields and views passed as parameters to the workunit
 
         :param functiondef: the functiondef to be parsed
-        :param source: the python source code of the workload
+        :param source: the python source code of the workunit
         :param param_begin: where workunit argument begins (excluding tid/acc)
         """
 
@@ -198,7 +203,7 @@ def get_view_template_params(
         Get the template parameters for all views defined in the constructor
 
         :param node: the classdef or functiondef to be parsed
-        :param source: the python source code of the workload
+        :param source: the python source code of the workunit
         :returns: a dictionary mapping from view name to a list of template parameters
         """
 
@@ -268,9 +273,11 @@ def get_random_pool(
         Gets the type of the random pool if it exists
 
         :param classdef: the classdef to be parsed
-        :param source: the python source code of the workload
+        :param source: the python source code of the functor
         :param pk_import: the identifier used to access the PyKokkos package
         :returns: the type of the random pool if it exists
+
+        NOTE: **used by workloads & functors; depreciate with functions** 
         """
 
         visitor = ConstructorVisitor(source, "randpool", pk_import, True)

pykokkos/core/visitors/constructor_visitor.py

@@ -22,6 +22,8 @@ def __init__(
         :param member_type: specifies which members to retrieve, "fields", "views", or "typeinfo"
         :param pk_import: the identifier used to access the PyKokkos package
         :param debug: if true, prints the python AST when an error is encountered
+
+        NOTE: **used by workloads & functors; depreciate with functions** 
         """
 
         if member_type not in ("fields", "views", "typeinfo", "randpool"):