You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2021/11/06 08:56:52 UTC

[tomcat] branch 10.0.x updated (bdb5dd6 -> d2ae5d6)

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

markt pushed a change to branch 10.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git.


    from bdb5dd6  Complete some Javadoc
     new 0774019  Complete some Javadoc TODOs
     new d2ae5d6  Update RAT excludes for new CI system

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 java/jakarta/servlet/ServletContext.java | 15 ++++++++++-----
 res/rat/rat-excludes.txt                 |  8 +++++---
 2 files changed, 15 insertions(+), 8 deletions(-)

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


[tomcat] 02/02: Update RAT excludes for new CI system

Posted by ma...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

markt pushed a commit to branch 10.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git

commit d2ae5d63cda4d9e5af24ea0249c266a9322754d3
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Sat Nov 6 08:56:36 2021 +0000

    Update RAT excludes for new CI system
---
 res/rat/rat-excludes.txt | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/res/rat/rat-excludes.txt b/res/rat/rat-excludes.txt
index 8d23f0f..450484e 100644
--- a/res/rat/rat-excludes.txt
+++ b/res/rat/rat-excludes.txt
@@ -30,7 +30,7 @@
   - package-list and script.js files in API documentation (javadoc) are
     generated
 
-  - other test files, such as trivial textual files containing only "OK' string,
+  - test files, such as trivial textual files containing only "OK' string,
     files in unusual encodings or compressed files are also excluded.
 
   - JSON files (RFC7159) are data and cannot contain comments
@@ -53,9 +53,9 @@
 
   - Markdown files for display in their GitHub UI
 
-  - Temporary cache files used by Checkstle
+  - Temporary cache files used by Checkstyle
 
-  - Configuration files for third party Continuous Integration systems like Travis CI
+  - Temporary files used by buildbot
 
 
 output/build/logs/*
@@ -212,3 +212,5 @@ output/dist/temp/safeToDelete.tmp
 
 output/res/checkstyle/*
 
+tomcat-10.0.x/**
+

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


[tomcat] 01/02: Complete some Javadoc TODOs

Posted by ma...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

markt pushed a commit to branch 10.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git

commit 07740198c2d6eb6d8748729e7d7d236b57dca2a2
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Sat Nov 6 08:53:11 2021 +0000

    Complete some Javadoc TODOs
    
    While the Javadoc needed to be written, the primary motivation for this
    commit was triggering a CI build.
---
 java/jakarta/servlet/ServletContext.java | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/java/jakarta/servlet/ServletContext.java b/java/jakarta/servlet/ServletContext.java
index a991e05..1730c79 100644
--- a/java/jakarta/servlet/ServletContext.java
+++ b/java/jakarta/servlet/ServletContext.java
@@ -644,11 +644,15 @@ public interface ServletContext {
     public ServletRegistration.Dynamic addJspFile(String jspName, String jspFile);
 
     /**
-     * TODO SERVLET3 - Add comments
-     * @param <T> TODO
-     * @param c   TODO
-     * @return TODO
-     * @throws ServletException TODO
+     * Create an Servlet instance using the given class. The instance is just
+     * created. No initialisation occurs.
+     *
+     * @param <T> The type for the given class
+     * @param c   The the class for which an instance should be created
+     *
+     * @return The created Servlet instance.
+     *
+     * @throws ServletException If the servlet instance cannot be created.
      * @throws UnsupportedOperationException    If called from a
      *    {@link ServletContextListener#contextInitialized(ServletContextEvent)}
      *    method of a {@link ServletContextListener} that was not defined in a
@@ -656,6 +660,7 @@ public interface ServletContext {
      *    {@link jakarta.servlet.annotation.WebListener}. For example, a
      *    {@link ServletContextListener} defined in a TLD would not be able to
      *    use this method.
+     *
      * @since Servlet 3.0
      */
     public <T extends Servlet> T createServlet(Class<T> c)

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