Changes between Version 64 and Version 65 of Orio

Timestamp:

06/13/08 21:59:29 (15 years ago)

Author:

hartono

Comment:

--

Orio

@@ -237 +237 @@
 With the module name provided in the leader annotation, Orio dynamically loads the corresponding code transformation module and uses it to transform and generate the code in the annotation body block. If the pertinent module cannot be found in the Orio module directory, an error message is produced, and the Orio optimization process is terminated. Such ''name-based dynamic loading'' provides flexibility and easy extensibility without requiring detailed knowledge or modification of the existing Orio system.
 
-Since Orio implementation is all in Python, to construct a new program transformation module therefore requires a Python programming skill. Transformation module writers need to create a new Python module inside `src/module` directory, where the abstract base class of the code transformation modules is located. This abstract class provides a partial implementation of the source-to-source transformation process, leaving it to subclasses to complete the implementation. The program below displays the abstract class code that inherits a class constructor and an abstract transformation function to its subclasses.
-
+Since Orio implementation is all in Python, to construct a new program transformation module therefore requires a Python programming skill. Transformation module writers need to create a new Python module inside `src/module` directory, where the abstract base class of the code transformation modules is available. This abstract class provides a partial implementation of the source-to-source transformation process, leaving it to subclasses to complete the implementation. The program below displays the abstract class code that inherits a class constructor and an abstract transformation function to its subclasses. Information about the class attributes is included in the code below as well.
 
 {{{
@@ -244 +243 @@
 # File: src/module/module.py
 # 
-# The abstract class of the Orio's code transformation module 
-# 
- 
+
 class Module: 
     '''The abstract class of the Orio's code transformation module''' 
-     
+
     def __init__(self, cmd_line_opts, perf_params, module_code, line_no, indent_size, annot_body_code): 
         ''' 
-        To instantiate a program transformation module used to transform the annotated code. 
- 
-        The class variables consist of the following: 
+        The class constructor used to instantiate a program transformation module. 
+
+        The following are the class attributes: 
            cmd_line_opts      an object representing the command line options 
-                              (see src/cmd_line_opts.py for more details) 
-           perf_params        a table/mapping that maps each performance parameter to its value 
+                              (see src/main/cmd_line_opts.py for more details) 
+           perf_params        a table that maps each performance parameter to its value 
            module_code        the code of annotation module body 
            line_no            the starting line position of the module code in the source code 
@@ -263 +260 @@
                               indentation of the leader annotation 
            annot_body_code    the text located in the annotation body block 
-           verbose            to show details of the results of the running transformation modules 
-        ''' 
- 
+        ''' 
         self.cmd_line_opts = cmd_line_opts 
         self.perf_params = perf_params 
@@ -273 +268 @@
         self.annot_body_code = annot_body_code 
  
-        # a boolean value 
-        self.verbose = self.cmd_line_opts.verbose 
- 
-    #-------------------------------------------------------------------- 
-         
     def transform(self): 
         ''' 
-        The main code transformation procedure. 
-        The returned value is a string value that represents the transformed/optimized code. 
-        ''' 
-         
+        The main code transformation procedure. The returned value is a string value that 
+        represents the transformed/optimized code. 
+        ''' 
         raise NotImplementedError('%s: unimplemented abstract function "transform"' % 
                                   (self.__class__.__name__))