Lines 1-3 and 70-72 contain a warning message automatically generated by tjpp.
Line 4 shows that PACKAGE_ROOT has been replaced by com.somusar.tjpptest, as expected.
The $include directives have produced code lines 12-22.
Lines 24 and 25 contain the results returned by macro my_macros/timestamp.
Lines 46-47 and 64-65 correspond to the two $traces of "subpackage/SimpleClass.tj".

    1      // WARNING: file "subpackage/SimpleClass.java" generated from "subpackage/SimpleClass.tj"
    2      //          Changes should be applied on the source file.
    3      
    4      package com.somusar.tjpptest.subpackage;
    5      
    6      /**
    7       *   Class SimpleClass:
    8       *
    9       *   A simple software entity.
   10       */
   11      
   12                                 // begin include "header.tjh"
   13      //
   14      // Sample header file for Java preprocessor
   15      //
   16                                 //   end include "header.tjh"
   17                                 // begin include "subinc/subhdr.tjh"
   18      //
   19      // Sample header file for Java preprocessor from a subdirectory
   20      // of include root directory "tjpp_inst/tjpp_include"
   21      //
   22                                 //   end include "subinc/subhdr.tjh"
   23      
   24      //   DATE of preprocessing: timestamp for "date": Wed Dec 03 2003
   25      //   TIME of preprocessing: timestamp for "time": 17:35:16.844
   26      
   27      public class SimpleClass {
   28      
   29          private String       aStringOfChar;        
   30          private int          anInt;            
   31          private Object       aThing;             
   32          
   33          /*
   34           *   Get methods
   35           */
   36      
   37          public String getAStringOfChar() {
   38              return aStringOfChar;
   39          }
   40      
   41          public int getAnInt() {
   42              return anInt;
   43          }
   44      
   45          public Object getAThing() {
   46              System.err.println("[T] File subpackage/SimpleClass.java, line 46 (src: subpackage/SimpleClass.tj, 39)");
   47              System.err.println("[T]    [aThing = '" + aThing + "']");
   48              return aThing;
   49          }
   50      
   51          /*
   52           *   Set methods
   53           */
   54      
   55          public void setAStringOfChar( String aStringOfChar ) {
   56              this.aStringOfChar = aStringOfChar;
   57          }
   58      
   59          public void setAnInt( int anInt ) {
   60              this.anInt = anInt;
   61          }
   62      
   63          public void setAThing( Object aThing ) {
   64              System.err.println("[T] File subpackage/SimpleClass.java, line 64 (src: subpackage/SimpleClass.tj, 56)");
   65              System.err.println("[T]    [aThing = '" + aThing + "']");
   66              this.aThing = aThing;
   67          }
   68      
   69      }
   70      
   71      // WARNING: file "subpackage/SimpleClass.java" generated from "subpackage/SimpleClass.tj"
   72      //          Changes should be applied on the source file.
	       

Line 1 defines the interface of this macro, which expects one parameter called "what".
Lines 7 and 9 call Tefigel's built-in functions DATE and TIME.
Line 11 sets the return value of this macro to the string on the right side of the assignment.

    1      @ INTERFACE(what)
    2      | 
    3      |   Sample user-defined macro, returning a string
    4      |   with a time stamp, as requested via parameter "what"
    5      |
    6      @ IF what=date
    7      @    SET TS=$DATE
    8      @ ELSE
    9      @    SET TS=$TIME
   10      @ ENDIF
   11      @ RETVALUE=timestamp for "what": TS
	       

This tjpp macro is equivalent to the following C #define:

  #define perc(a,b) ((a) * 100.0 / (b))

A major advantage of tjpp macros is that they reside in individual files and are called by means of their file-system path name, relative to "tjpp_lib". Moreover, they can accept a variable number of arguments. This particular macro expects two arguments, referred to by means of local variables a and b, as specified on line 1.

    1      @ INTERFACE(a,b)
    2      | 
    3      |   Sample user-defined macro, returning a code string
    4      |   to compute the percentage on given arguments.
    5      |
    6      @ RETVALUE=((a) * 100.0 / (b))
	       

The $attached copyright file has been copied to lines 4-8.
Lines 34-37 show the code generated by directive enumeration.
Lines 39-49 result from directive member.
Lines 51-98 result from directive getters.
Lines 99-134 result from directive setters: no set method has been generated for properties declared read-only.
The values of two traced variables are printed out on lines 145-147.
Lines 148-155 show the code generated by directive assert.
Line 167 contains the result of $my_macros/perc(anInt),1000.
Lines 168-169 trace variable d, while no tracing statements have been generated for parameter anInt, as $trace(anInt) followed a ": TRACE_SWITCH=off" directive.
Lines 173-188 show the code generated by directive to_string.

    1      // WARNING: file "ComplexClass.java" generated from "ComplexClass.tj"
    2      //          Changes should be applied on the source file.
    3      
    4      //
    5      // Sample copyright file for Java preprocessor
    6      //
    7      //    Copyright (c) _____________ , 2003 - All rights reserved.
    8      //
    9                                 // begin include "header.tjh"
   10      //
   11      // Sample header file for Java preprocessor
   12      //
   13                                 //   end include "header.tjh"
   14                                 // begin include "subinc/subhdr.tjh"
   15      //
   16      // Sample header file for Java preprocessor from a subdirectory
   17      // of include root directory "tjpp_inst/tjpp_include"
   18      //
   19                                 //   end include "subinc/subhdr.tjh"
   20      
   21      package com.somusar.tjpptest;
   22      
   23      /**
   24       *   Class ComplexClass:
   25       *
   26       *   A software entity with several fields and collections.
   27       */
   28      
   29      import com.somusar.tjpptest.subpackage.SimpleClass;
   30      import java.util.Date;
   31      
   32      public class ComplexClass extends SimpleClass {
   33      
   34          // Map enum 'Color' onto an int with a set of values
   35          public static final int RED                = 0;
   36          public static final int GREEN              = 1;
   37          public static final int BLUE               = 2;
   38      
   39          private boolean      aBool;
   40          private int          aColor;
   41          private double       aFloat;
   42          private int          aRange;
   43          private String       aString;
   44          private Date         aTime;
   45          private int          aUniqueId;     // read-only
   46          private int          anInt;         // read-only
   47          private int          anotherColor;  // read-only
   48          private Object       aThing;
   49          private int          anIntArray[][];
   50          
   51          /*
   52           *   Get methods
   53           */
   54      
   55          public boolean getABool() {
   56              return aBool;
   57          }
   58      
   59          public int getAColor() {
   60              return aColor;
   61          }
   62      
   63          public double getAFloat() {
   64              return aFloat;
   65          }
   66      
   67          public int getARange() {
   68              return aRange;
   69          }
   70      
   71          public String getAString() {
   72              return aString;
   73          }
   74      
   75          public Date getATime() {
   76              return aTime;
   77          }
   78      
   79          public int getAUniqueId() {
   80              return aUniqueId;
   81          }
   82      
   83          public int getAnInt() {
   84              return anInt;
   85          }
   86      
   87          public int getAnotherColor() {
   88              return anotherColor;
   89          }
   90      
   91          public Object getAThing() {
   92              return aThing;
   93          }
   94      
   95          public int[][] getAnIntArray() {
   96              return anIntArray;
   97          }
   98      
   99          /*
  100           *   Set methods
  101           */
  102      
  103          public void setABool( boolean aBool ) {
  104              this.aBool = aBool;
  105          }
  106      
  107          public void setAColor( int aColor ) {
  108              this.aColor = aColor;
  109          }
  110      
  111          public void setAFloat( double aFloat ) {
  112              this.aFloat = aFloat;
  113          }
  114      
  115          public void setARange( int aRange ) {
  116              this.aRange = aRange;
  117          }
  118      
  119          public void setAString( String aString ) {
  120              this.aString = aString;
  121          }
  122      
  123          public void setATime( Date aTime ) {
  124              this.aTime = aTime;
  125          }
  126      
  127          public void setAThing( Object aThing ) {
  128              this.aThing = aThing;
  129          }
  130      
  131          public void setAnIntArray( int anIntArray[][] ) {
  132              this.anIntArray = anIntArray;
  133          }
  134      
  135      
  136          /**
  137           *   Method 'A function'
  138           */
  139      
  140          public boolean aFunction (
  141                          int aRange,
  142                          int aColor
  143                 )
  144          {
  145              System.err.println("[T] File ComplexClass.java, line 145 (src: ComplexClass.tj, 53)");
  146              System.err.println("[T]    [aRange = '" + aRange + "']");
  147              System.err.println("[T]    [aColor = '" + aColor + "']");
  148              {
  149                  if (! (aRange >= 0 && aRange < 20000)) {
  150                      System.err.println("[A] -------------");
  151                      System.err.println("[A] --- File ComplexClass.java, line 149 (src: ComplexClass.tj, 54)");
  152                      System.err.println("[A] --- Assertion 'aRange >= 0 && aRange < 20000' failed");
  153                      System.err.println("[A] -------------");
  154                  }
  155              }
  156              return true;
  157          }
  158      
  159          /**
  160           *   Method 'A function'
  161           */
  162      
  163          public double aFunction (
  164                          int anInt
  165                 )
  166          {
  167              double d = ((anInt) * 100.0 / (1000));
  168              System.err.println("[T] File ComplexClass.java, line 168 (src: ComplexClass.tj, 70)");
  169              System.err.println("[T]    [d = '" + d + "']");
  170              return d;
  171          }
  172      
  173          public String toString() {
  174              String s = "[" +
  175                         " aBool = '" + aBool + "'" +
  176                         " aColor = '" + aColor + "'" +
  177                         " aFloat = '" + aFloat + "'" +
  178                         " aRange = '" + aRange + "'" +
  179                         " aString = '" + aString + "'" +
  180                         " aTime = '" + aTime + "'" +
  181                         " aUniqueId = '" + aUniqueId + "'" +
  182                         " anInt = '" + anInt + "'" +
  183                         " anotherColor = '" + anotherColor + "'" +
  184                         " aThing = '" + aThing + "'" +
  185                         " anIntArray = '" + anIntArray + "'" +
  186                         " ]";
  187              return s;
  188          }
  189      
  190      }
  191      
  192      // WARNING: file "ComplexClass.java" generated from "ComplexClass.tj"
  193      //          Changes should be applied on the source file.
	       

Generation of assertion code is controlled by tjpp's variable ASSERTION_SWITCH (lines 11-13).
Line 14 defines a string pattern to be printed out by each assertion message.
Line 16 retrieves the current line numbers of both input (".tj") and output (".java") files.
The assertion expression passed as argument to assert is referred to by means of tjpp's variable REG_ALL on lines 17 and 20.
The code fragment pattern generated for each assert is defined by lines 15 and 17-23, and can easily be customized as needed, for instance adding error-raising statements.

    1      @ INTERFACE(...)
    2      |
    3      |   Generate a block of statements to check an assertion.
    4      |   The assertion expression is passed as one or more arguments
    5      |   and used below as REG_ALL.
    6      |   When an assertion evaluates to false, the generated code
    7      |   prints out a trace message with source file and line, then
    8      |   continues normal execution flow.
    9      |   No code is generated if ASSERTION_SWITCH is not "on".
   10      |
   11      @ IF ASSERTION_SWITCH#on
   12      @    QUIT
   13      @ ENDIF
   14      @ SET ASSERTIONBANNER=[A] ---
   15              {
   16      @ SET FILELOC=$jfileloc
   17                  if (! (REG_ALL)) {
   18                      System.err.println("ASSERTIONBANNER----------");
   19                      System.err.println("ASSERTIONBANNER FILELOC");
   20                      System.err.println("ASSERTIONBANNER Assertion 'REG_ALL' failed");
   21                      System.err.println("ASSERTIONBANNER----------");
   22                  }
   23              }
	       

Lines 1-7 result from line 16 of TestJavapp.java.
Lines 8-10 result from line 17 of the same file.
Lines 11-12 result from line 18.
Lines 13-14 result from line 19.
Lines 15-16 result from line 20.

    1      [T] File ComplexClass.java, line 145 (src: ComplexClass.tj, 53)
    2      [T]    [aRange = '20000']
    3      [T]    [aColor = '0']
    4      [A] -------------
    5      [A] --- File ComplexClass.java, line 149 (src: ComplexClass.tj, 54)
    6      [A] --- Assertion 'aRange >= 0 && aRange < 20000' failed
    7      [A] -------------
    8      [T] File ComplexClass.java, line 145 (src: ComplexClass.tj, 53)
    9      [T]    [aRange = '10000']
   10      [T]    [aColor = '1']
   11      [T] File ComplexClass.java, line 168 (src: ComplexClass.tj, 70)
   12      [T]    [d = '1.2']
   13      [T] File subpackage/SimpleClass.java, line 64 (src: subpackage/SimpleClass.tj, 56)
   14      [T]    [aThing = '[ aBool = 'false' aColor = '0' aFloat = '0.0' aRange = '0' aString = 'null' aTime = 'null' aUniqueId = '0' anInt = '0' anotherColor = '0' aThing = 'null' anIntArray = 'null' ]']
   15      [T] File subpackage/SimpleClass.java, line 46 (src: subpackage/SimpleClass.tj, 39)
   16      [T]    [aThing = '[ aBool = 'false' aColor = '0' aFloat = '0.0' aRange = '0' aString = 'null' aTime = 'null' aUniqueId = '0' anInt = '0' anotherColor = '0' aThing = 'null' anIntArray = 'null' ]']
	       

Lines 5-10 result from calling my_macro/get_results with mode BY_NUMBER.
Lines 13-18 result from calling my_macro/get_results with mode BY_NAME.

Note that a wrongType, supplied to get_results, purposely produced the wrong statements of lines 10 and 18, and caused tjpp to issue a warning message. The Java compiler would then detect the error and the generated code would not be compiled.

    1      // WARNING: file "Results.java" generated from "Results.tj"
    2      //          Changes should be applied on the source file.
    3      
    4              // Get results from "rs" by column number
    5              int         rCustId     = rs.getInt(    1);
    6              String      rFirstName  = rs.getString( 2);
    7              String      rLastName   = rs.getString( 3);
    8              float       rBalance    = rs.getFloat(  4);
    9              String      rEmail      = rs.getString( 5);
   10              wrongType   rSthgElse   = rs.get UNKNOWN (      6);
   11      
   12              // Get results from "results" by column name
   13              int         rCustId     = results.getInt(       "CUST_ID");
   14              String      rFirstName  = results.getString(    "FIRST_NAME");
   15              String      rLastName   = results.getString(    "LAST_NAME");
   16              float       rBalance    = results.getFloat(     "BALANCE");
   17              String      rEmail      = results.getString(    "EMAIL");
   18              wrongType   rSthgElse   = results.get UNKNOWN ( "STHG_ELSE");
   19      
   20      // WARNING: file "Results.java" generated from "Results.tj"
   21      //          Changes should be applied on the source file.
	       

This macro generates result-set getXXX statements from a parametric source variable for the type/id pairs supplied as arguments.
A mode parameter specifies whether the getXXX should use the column name or column number.

    1      @ INTERFACE(mode,source)
    2      |
    3      |   Generate statements in the form (mode = BY_NUMBER) 
    4      |       int         rCustId      = source.getInt(1);
    5      |   or (mode = BY_NAME) 
    6      |       int         rCustId      = source.getInt("CUST_ID");
    7      |   Actually, more arguments are supplied, namely a 
    8      |   list of type/id arguments, like in "int/cust_id".
    9      |
   10      @ DASH ^
   11      |   Create a mapping between Java types and getXXX accessors
   12      @ SET     jmap^int=Int
   13      @ SET   jmap^float=Float
   14      @ SET  jmap^double=Double
   15      @ SET  jmap^String=String
   16      @ SET jmap^boolean=Boolean
   17      |   Scan list of type/id pairs, skipping mode and source
   18      @ SET I=2
   19      @ WHILE I<REG_COUNT
   20      @    SET FIELD=REG_^I
   21      |    Strip leading and trailing blanks
   22      @    SET FIELD=$WORD(FIELD,0)
   23      |    Retrieve type
   24      @    SET JTYPE=$FIELD(FIELD,0,/)
   25      |    Retrieve identifier
   26      @    SET   JID=$FIELD(FIELD,1,/)
   27      |    Check if type mapping is known, issue a warning otherwise
   28      |    and propagate error into Java code
   29      @    SET JRESTYPE=$VALUE(jmap^JTYPE)
   30      @    IF JRESTYPE~jmap
   31      @       SET JRESTYPE= UNKNOWN 
   32      $       warning($jfileloc(src_only): don't know how to map type "JTYPE")
   33      @    ENDIF
   34      |    Select mode of getXXX
   35      @    IF mode=BY_NAME
   36      @       SET JKEY="$MAKE_ID(JID,ABC_DEF)"
   37      @    ELSE
   38      @       SET JKEY=I
   39      @       SUB JKEY 1
   40      @    ENDIF
   41      |    Prepare a local identifier
   42      @    SET JID=$MAKE_ID(r_^JID,abcDef)
   43      |    Prepare right-hand side of assignment
   44      @    SET JVAL=source.get^JRESTYPE(      JKEY)
   45      |    Generate tab-aligned code
   46      @    ECHO $TABS(        JTYPE   JID     = JVAL;,8,20,32,48)
   47      @    ADD I 1
   48      @ ENDWHILE
   49      @ DASH