Index: trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/graphicalUserInterface.xml
===================================================================
--- trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/graphicalUserInterface.xml	(revision 905)
+++ trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/graphicalUserInterface.xml	(revision 921)
@@ -29,5 +29,5 @@
 The "intercoms" category
 provides an expandable command interpreter. It is the key mechanism
-of Geant4 to realize user interactions of all categories without
+of Geant4 to realize secure user interactions of all categories without
 being annoyed by the dependencies among categories. The direct use
 of Geant4 classes in a C++ program offers a first ground level of
@@ -36,4 +36,6 @@
 hard-coded in the program.
 </para>
+
+
 
 </sect3>
@@ -52,7 +54,7 @@
 the interfaces category. This interfacing strategy opens an
 important door towards various user interface tools and allows
-Geant4 to utilize the state-of-the-art GUI tools such as Motif and
-Java, etc..The richness of the collaboration has permitted for
-different groups to offer various user interfaces to the Geant4
+Geant4 to utilize the state-of-the-art GUI tools such as Motif, Qt,
+and Java etc..The richness of the collaboration has permitted for
+developers to offer various user interfaces to the Geant4
 command system. Currently available are the following;
 
@@ -67,5 +69,5 @@
   </para></listitem>
   <listitem><para>
-  GAG, a fully Graphical User Interface and its extension
+  GAG, a fully Graphical User Interface and its network extension
   GainServer of the client/server type.
   </para></listitem>
@@ -76,16 +78,19 @@
 Full implementation of the character
 terminals (1 and 2) is included in the standard Geant4 distribution
-in the <literal>source/interfaces/basic</literal> directory. As for GAG
-with rich GUI functionalities, its front-end classes are included
-in the Geant4 distribution in the source/interfaces/GAG directory.
-The corresponding GUI package is available either from the author's
-Web pages (see URL below) or in the distributed package under the
-<literal>environments/MOMO</literal> directory.
+in the <literal>source/interfaces/basic</literal> directory. As for GAG, 
+the front-end class is included
+in the Geant4 distribution in the source/interfaces/GAG directory,
+while its partner GUI package MOMO.jar is available in the standard Geant4 distribution 
+under the
+<literal>environments/MOMO</literal> directory. MOMO.jar, Java archive file, contains
+not only GAG, but also GGE and other helper packages.
+Supplementary information is available
+from the author's Webpage(see URL below). 
 </para>
 
 <para>
 GAG, GainServer's client GUI Gain: 
-<ulink url="http://erpc1.naruto-u.ac.jp/~geant4">
-http://erpc1.naruto-u.ac.jp/~geant4
+<ulink url="http://www-geant4.kek.jp/~yoshidah">
+http://www-geant4.kek.jp/~yoshidah
 </ulink>
 </para>
@@ -238,5 +243,5 @@
 A command box is at disposal for entering or recalling Geant4 commands.
 Command completion by typing &amp;ldquo;TAB&amp;rdquo; key is
-available on the command line. The shellcommands "exit, cont,
+available on the command line. The shell commands "exit, cont,
 help, ls, cd..." are also supported. A menu bar could be customized
 through the <emphasis>AddMenu</emphasis> and 
@@ -287,10 +292,10 @@
 
 <para>
-They are the front-end classes of Geant4 which interface with their
-respective graphical user interfaces, GAG (Geant4 Adaptive GUI) and Gain
-(Geant4 adaptive interface for network). While GAG must run on the same 
+They are the front-end classes of Geant4 which make connection with their
+respective graphical user interfaces, GAG (Geant4 Adaptive GUI) via pipe, and Gain
+(Geant4 adaptive interface for network) via sockets. While GAG must run on the same 
 system (Windows or Unixen) as a Geant4 application, Gain can run on a
-remote system (Windows, Linux, etc.) to which JVM (Java Virtual
-Machine) is installed. A Geant4 application is invoked on a Unix
+remote system (Windows, Linux, etc.) in which JRE (Java Runtime
+Environment) is installed. A Geant4 application is invoked on a Unix
 (Linux) system and behaves as a network server. It opens a port,
 waiting the connection from the Gain. Gain is capable to connect to
@@ -300,22 +305,25 @@
 
 <para>
-Client GUI, GAG and Gain have almost similar look-and-feel. So,
-GAG's functionalities are briefly introduced here. Please refer to
-the above URL for details and to download the client GUIs.
-</para>
-
-<para>
-GAG is a Graphical User Interface tool with which user
-can set parameters and execute commands. It is adaptive, since GAG
-reflects the internal states of Geant4 that is a state machine. GAG
-is based on the server-client model; GAG is the server, while
-Geant4 executables are clients. Hence, GAG does nothing by itself
-and it must invoke an executable simulation program. Geant4's
+Client GUIs, GAG and Gain have almost similar look-and-feel. So,
+GAG's functionalities are briefly explained here. Please refer to
+the above URL for details.
+</para>
+
+<para>
+Using GAG, user
+can select a command, set its parameters and execute it. It is adaptive, in the sense that it
+reflects the internal states of Geant4 that is a state machine. So, GAG  always provides users with
+the Geant4 commands which may be added, deleted, enabled or disabled during a session. GAG does nothing by itself but to play an intermediate between user and 
+ an executable simulation program via pipes. Geant4's
 front-end class <emphasis>G4UIGAG</emphasis> must be instantiated to 
-communicate with GAG. This runs on Linux and Windows 2000.
-GAG is written in Java and
-its Jar (Java Archive) file is available from the above URL. See
-the same pages to know how to install and run Java programs.
-</para>
+communicate with GAG. GAG runs on Linux and Windows. If MOMO.jar is in your
+CLASSPATH, it can be run by a command;
+</para>
+
+<informalexample>
+<programlisting>
+   %java -jar MOMO.jar
+</programlisting>
+</informalexample>
 
 <para>
@@ -329,5 +337,5 @@
     a GEANT4 process and to exit GAG. Upon the normal exit or an
     unexpected death of the Geant4 process, GAG window are
-    automatically reset to accept another GEANT4 executable.    
+    automatically reset to run another GEANT4 executable.    
     </listitem>
   </varlistentry>
@@ -335,7 +343,7 @@
     <term>GEANT4 Command tree:</term>
     <listitem>
-    Upon the establishment of the pipe with the GEANT4 process, GAG displays
-    the command menu tree whose look and feel is quite similar to
-    Windows' file browser. Disabled commands are shown opaque. GAG
+    Upon the establishment of the pipe connection with the GEANT4 process, GAG displays
+    the command menu, using expandable tree browser whose look and feel is similar to
+    a file browser. Disabled commands are shown in opaque. GAG
     doesn &amp;rsquo;t display commands that are just below the root of
     the command hierarchy. Direct type-in field is available for such
@@ -364,5 +372,5 @@
     Log can be redirected to the terminal (xterm or cygwin
     window) from which GAG is invoked. It can be interrupted as will,
-    in the middle of long session of execution. Log can be saved to a
+    in the middle of a long session of execution. Log can be saved to a
     file independent of the above redirection . GAG displays warning or
     error messages from GEANT4 in a pop-up warning widget.
@@ -383,5 +391,6 @@
 
 <para>
-The libraries that don't depend on external packages are made by default. 
+The libraries that don't depend on external packages are created by default, using
+Geant4 configure scripts. 
 They include <emphasis>G4UIterminal</emphasis>, <emphasis>G4UItcsh</emphasis>
 and <emphasis>G4UIGAG</emphasis> in libraries <emphasis>libG4UIbasic.a/so</emphasis> and
@@ -396,5 +405,5 @@
 <emphasis role="bold">G4UI_BUILD_XAW_SESSION</emphasis> or
 <emphasis role="bold">G4UI_BUILD_WIN32_SESSION</emphasis> must be set
-explicitly.
+explicitly before creating libraries.
 </para>
 
@@ -405,5 +414,5 @@
 
 <para>
-Build scheme of the user interface libraries is
+The scheme of building the user interface libraries is
 specified in "$G4INSTALL/config/G4UI_BUILD.gmk" makefile and the
 dependencies on the external packages are specified in
@@ -416,5 +425,5 @@
 <sect2 id="sect.HowToSetUpInter.HowToUseInter">
 <title>
-How to Use the Interface
+How to Use the Interface in Your Application
 </title>
 
@@ -422,15 +431,15 @@
 To use a given interface
 (<literal>G4UIxxx</literal> where <literal>xxx = terminal,Xm, Xaw, Win32,
-GAG, GainServer</literal>) in a user's program, he has the following
-lines in his main program;
+GAG, GainServer</literal>) in your program, you have  following
+lines in your main program;
 
 <informalexample>
 <programlisting>
-// to include the class definition in his main program:
+// to include the class definition in the main program:
    #include "G4Uixxx.hh"
-// to instantiate a session of his choice and start the session
+// to instantiate a session of your choice and start the session
    G4UIsession* session = new G4UIxxx;
    session-&gt;SessionStart();
-// the line next to the "SessionStart" is usually to finish the session
+// the line next to the "SessionStart" is necessary to finish the session
    delete session;
 </programlisting>
@@ -466,6 +475,6 @@
 
 <para>
-Again, environment variable selects a given interface. But for your
-convenience, some of them are set defaults.
+Again, environment variable must be preset to select a given interface. But for your
+convenience, some of them are set by defaults.
 
 <itemizedlist spacing="compact">
@@ -473,5 +482,5 @@
    <emphasis>G4UIterminal</emphasis>, <emphasis>G4UItcsh</emphasis>, 
    <emphasis>G4UIGAG</emphasis> and <emphasis>G4UIGainServer</emphasis> 
-   can be used without any environment
+   can be used without setting any environment
    variables. Sessions not needing external packages or libraries are
    always built (see "G4UI_BUILD.gmk") and linked, so the user can
@@ -497,5 +506,5 @@
    <listitem><para>
    If the environment variable <emphasis role="bold">G4UI_NONE</emphasis> is
-   set, no externa ibraries are selected. Also, for your convenience, if any
+   set, no external libraries are selected. Also, for your convenience, if any
    <emphasis role="bold">G4UI_USE_XXX</emphasis> environment variable is set, 
    then the corresponding C-pre-processor flag is also set. However, if the
Index: trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/visualization.xml
===================================================================
--- trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/visualization.xml	(revision 905)
+++ trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/GettingStarted/visualization.xml	(revision 921)
@@ -2,4 +2,5 @@
 <!--                                                          -->
 <!--  [History]                                               -->
+<!--    Update HepRApp reference: Joseph Perl, Dec-2008       -->
 <!--    Converted to DocBook: Katsuya Amako, Aug-2006         -->
 <!--    Changed by: Katsuya Amako, 30-Nov-1998                -->
@@ -72,5 +73,5 @@
 graphics systems use a graphics library compiled with Geant4, such
 as OpenGL, Qt or OpenInventor, while others involve a separate application, such as
-WIRED or DAWN.
+HepRApp or DAWN.
 </para>
 
