Thread API documentary about Thread stop(), start() and suspend()
need to be refined.

Java Thread model needs to be explained clearly in the
following aspects.

(1)A public method other than run() of a Thread object
  can be called after the thread object is suspended.
  The invoked method is executed by the calling thread.

(2) What does stop() exactly means? Right now, after
    calling t.stop(), t is an instance of Thread, t can
    be started again by calling t.start(). Does stop()
    mean terminating the execution flow ? How about start()?
    It seems that a *real* Thread (execution unit) is not
    created until start() is called against Thread object t.
    What is the semantic of the second calling t.start() mentioned
    above.

-----Below are two sampling codes--------------------

/*
  Test a public method other than run() of a Thread object
  can be called after the thread object is suspended.
  The invoked method is executed by the calling thread.
  */
class jotter extends Thread {
  int count = 0;

  jotter(String n)
  {
    super(n);
  }

  public int getcount()
  {
    System.out.println("getcount() is executed by " + Thread.currentThread().getName());
    return count;
  }
  
  public void run() {

    while ( true ) {
      count++;
      System.out.println(count + ": I will be suspended.");

      // computation ...
      for(int j =0; j < 50000; j++) ;

      Thread.currentThread().sleep(5);
      System.out.println(count + ": I'm back");
    }
  }
}
class thtest02 {
  public static void main(String args[]) {
    int i= 0;
    jotter jt = new jotter("jotter");

    jt.start();

    Thread.currentThread().setName("mainthread");

    // let the jotter run
    Thread.currentThread().yield();

    // idle
    for(int j=0; j < 10000; j++) ;

    // suspend the child thread
    jt.suspend();
    
    Thread.currentThread().sleep(100);
    
    //we still call the method jt.getcount() though
    //thread jt is suspended
    System.out.println("We still call the method getcount() of");
    System.out.println("object jt though the thread jt is suspended");

    System.out.println(i=jt.getcount());

    System.out.println("The main thread is done");

    //resume the child thread in order to kill it
    jt.resume();
    // stop the child thread jt
    jt.stop();
    
    if ( i > 0 )
      System.out.println("The test pass is ok");
    else
      System.out.println("The test pass failed");
  }
}

/*
  test the thread is started, then stopped, started again.
  weird??
  */

class jotter implements Runnable {
  int count = 0;

  public int getcount()
  {
    System.out.println("getcount() is executed by " + Thread.currentThread().getName());
    return count;
  }
  
  public void run() {
    boolean flag;

    flag = true;
    while ( flag ) {
      count++;
      // computation ...
      for(int j =0; j < 50000; j++) ;
      System.out.println("The thread executing run() is " +
Thread.currentThread().getName());
      System.out.println("count = " + getcount());
      if ( count > 20) flag = false;

      Thread.currentThread().sleep(5);
    }
  }
}

class thtest07 {
  public static void main(String args[]) {
    int i= 0;
    jotter robj = new jotter();
    
    Thread jt = new Thread(robj);

    jt.setName("jotter");
    jt.start();

    Thread.currentThread().setName("mainthread");

    // let the jotter run
    Thread.currentThread().yield();

    // idle
    for(int j=0; j < 10000; j++) ;

    // stop the child thread
    jt.stop();

    Thread.currentThread().sleep(100);
    System.out.println("count in the child thread = " + robj.getcount());
 
    System.out.println("The main thread will restart the stopped thread");
    jt.start();

    Thread.currentThread().sleep(100);
    System.out.println("count in the child thread = " + robj.getcount());
    jt.join();

    System.out.println("count in the child thread = " + robj.getcount());
  }
}