[tomcat] branch master updated: Improve Graal doc again

[re...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

remm pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/master by this push:
     new 6e25e58  Improve Graal doc again
6e25e58 is described below

commit 6e25e58afc4c7a4bed48072533c2949c67a0fe92
Author: remm <re...@apache.org>
AuthorDate: Fri Nov 29 17:30:28 2019 +0100

    Improve Graal doc again
    
    After double checking findings, document precisely which items are not
    functional. The list now looks a lot better than before.
    It is not possible to support more than a very specific Graal version at
    this time, so specify 19.3 must be used [hopefully the minor 19.3.x
    versions will not break anything ... but it's almost certain the next
    major "stable" versions will need changes that will force dropping
    support for 19.3].
    Talk about --static since it is useful and works, mention the needed
    static libraries (if one is missing, the linker of course starts
    screaming in a very ugly way).
---
 webapps/docs/graal.xml | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/webapps/docs/graal.xml b/webapps/docs/graal.xml
index 0739428..27ca99a 100644
--- a/webapps/docs/graal.xml
+++ b/webapps/docs/graal.xml
@@ -35,9 +35,9 @@
   <section name="Introduction">
 
   <p>
-    Tomcat supports using the GraalVM Native Image tool to produce a native
-    binary including the container. This documentation page describes the
-    build process of such an image.
+    Tomcat supports using the GraalVM 19.3 Native Image tool to produce
+    a native binary including the container. This documentation page
+    describes the build process of such an image.
   </p>
 
   </section>
@@ -141,6 +141,8 @@ ant -Dwebapp.name=somewebapp -f graal-webapp.ant.xml</source>
         -H:ResourceConfigurationFiles=$TOMCAT_MAVEN/tomcat-resource.json\
         -H:JNIConfigurationFiles=$TOMCAT_MAVEN/tomcat-jni.json\
         -jar $TOMCAT_MAVEN/target/tomcat-maven-1.0.jar</source>
+    The additional <code>--static</code> parameter enables static linking of
+    glibc, zlib and libstd++ in the generated binary.
   </p>
 
   <p>
@@ -174,12 +176,14 @@ ant -Dwebapp.name=somewebapp -f graal-webapp.ant.xml</source>
   <p>
     Missing items for better Tomcat functionality:
     <ul>
-      <li>BeanInfo support: BeanInfo use in JSP taglibs must be configured
-        manually in descriptors</li>
-      <li>Java serialization: Clustering, session persistence</li>
-      <li>Static linking configuration: tomcat-native support when creating
-        an image with static linking</li>
-      <li>JMX: Tomcat monitoring and management</li>
+      <li>Java serialization: Clustering and session persistence are not
+        functional</li>
+      <li>JMX: The usual monitoring and management is not usable</li>
+      <li>java.util.logging LogManager: Configuration through a system property
+        is not implemented, so standard java.util.logging must be used instead
+        of JULI</li>
+      <li>Static linking configuration: tomcat-native cannot be statically
+        linked</li>
     </ul>
   </p>
 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org