Self-review of docs

user/src/com/google/gwt/core/server/jakarta/package-info.java

@@ -20,4 +20,4 @@
  *
  * @since GWT 2.11
  */
-package com.google.gwt.core.server.jakarta;
+package com.google.gwt.core.server.jakarta;

user/src/com/google/gwt/logging/server/jakarta/package-info.java

@@ -20,4 +20,4 @@
  *
  * @since GWT 2.11
  */
-package com.google.gwt.logging.server.jakarta;
+package com.google.gwt.logging.server.jakarta;

user/src/com/google/gwt/user/server/jakarta/package-info.java

@@ -20,4 +20,4 @@
  *
  * @since GWT 2.11
  */
-package com.google.gwt.user.server.jakarta;
+package com.google.gwt.user.server.jakarta;

user/src/com/google/gwt/user/server/rpc/jakarta/package-info.java

@@ -20,4 +20,4 @@
  *
  * @since GWT 2.11
  */
-package com.google.gwt.user.server.rpc.jakarta;
+package com.google.gwt.user.server.rpc.jakarta;

user/src/com/google/web/bindery/requestfactory/gwt/client/RequestFactoryLogHandler.java

@@ -27,6 +27,10 @@
 
 /**
  * A Handler that does remote logging for applications using RequestFactory.
+ * <p>To use this in a project with {@code jakarta.servlet}, a copy will need
+ * to be made, referencing {@link com.google.web.bindery.requestfactory.shared.jakarta.LoggingRequest
+ * com.google.web.bindery.requestfactory.shared.jakarta.LoggingRequest} instead
+ * of the non-jakarta LoggingFactory that this was originally written for.</p>
  */
 public class RequestFactoryLogHandler extends RemoteLogHandlerBase {
 

user/src/com/google/web/bindery/requestfactory/server/Logging.java

@@ -26,8 +26,12 @@
 /**
  * Server-side object that handles log messages sent by
  * {@link com.google.web.bindery.requestfactory.gwt.client.RequestFactoryLogHandler}.
- * To use this in {@code jakarta.servlet} projects, create your own LoggingRequest
- * and RequestFactoryLogHandler types that reference the jakarta variant of this class.
+ * <p>To use this in {@code jakarta.servlet} projects, be sure to reference
+ * {@link com.google.web.bindery.requestfactory.shared.jakarta.LoggingRequest
+ * com.google.web.bindery.requestfactory.shared.jakarta.LoggingRequest} instead
+ * of the non-jakarta version, and making a copy of {@code RequestFactoryLogHandler}
+ * that uses it.
+ * </p>
  */
 public class Logging {
 

user/src/com/google/web/bindery/requestfactory/server/jakarta/package-info.java

@@ -21,4 +21,4 @@
  *
  * @since GWT 2.11
  */
-package com.google.web.bindery.requestfactory.server.jakarta;
+package com.google.web.bindery.requestfactory.server.jakarta;

user/src/com/google/web/bindery/requestfactory/shared/jakarta/package-info.java

@@ -0,0 +1,24 @@
+/*
+ * Copyright 2023 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+/**
+ * Jakarta-specific package for server-only classes. To use these types, be sure
+ * to use the {@code gwt-servlet-jakarta.jar}, or
+ * {@code requestfactory-server-jakarta.jar}.
+ *
+ * @since GWT 2.11
+ */
+package com.google.web.bindery.requestfactory.shared.jakarta;