Quick draft

Author: niloc132

build_tools/doctool/src/com/google/doctool/ResourceIncluder.java

@@ -52,29 +52,12 @@ public static String getResourceFromClasspathScrubbedForHTML(String partialPath)
    */
   private static String getFileFromClassPath(String partialPath)
       throws IOException {
-    InputStream in = ResourceIncluder.class.getClassLoader().getResourceAsStream(
-        partialPath);
-    try {
+    try (InputStream in = ResourceIncluder.class.getClassLoader().getResourceAsStream(partialPath);
+    ){
       if (in == null) {
         throw new FileNotFoundException(partialPath);
       }
-      ByteArrayOutputStream os = new ByteArrayOutputStream();
-      byte[] buffer = new byte[1024];
-      int bytesRead;
-      while (true) {
-        bytesRead = in.read(buffer);
-        if (bytesRead >= 0) {
-          // Copy the bytes out.
-          os.write(buffer, 0, bytesRead);
-        } else {
-          // End of input stream.
-          break;
-        }
-      }
-
-      return os.toString(StandardCharsets.UTF_8);
-    } finally {
-      close(in);
+      return new String(in.readAllBytes(), StandardCharsets.UTF_8);
     }
   }
 

dev/core/src/com/google/gwt/dev/shell/BrowserChannelServer.java

@@ -412,27 +412,8 @@ protected void processConnection() throws IOException, BrowserChannelException {
         moduleName = oldLoadModule.getModuleName();
         userAgent = oldLoadModule.getUserAgent();
         protocolVersion = 1;
-        HelpInfo helpInfo = new HelpInfo() {
-          @Override
-          public String getAnchorText() {
-            return "UsingOOPHM wiki page";
-          }
-
-          @Override
-          public URL getURL() {
-            try {
-              // TODO(jat): better landing page for more info
-              return new URL(
-                  "http://code.google.com/p/google-web-toolkit/wiki/UsingOOPHM");
-            } catch (MalformedURLException e) {
-              // can't happen
-              return null;
-            }
-          }
-        };
         logger.log(TreeLogger.WARN, "Connection from old browser plugin -- "
-            + "please upgrade to a later version for full functionality", null,
-            helpInfo);
+            + "please upgrade to a later version for full functionality");
         break;
       case CHECK_VERSIONS:
         String connectError = null;

dev/core/src/com/google/gwt/dev/util/GwtprojectOrgHelpInfo.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2025 GWT Project Authors
+ *
+ * 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.
+ */
+package com.google.gwt.dev.util;
+
+import com.google.gwt.core.ext.TreeLogger;
+
+import java.net.MalformedURLException;
+import java.net.URL;
+
+/**
+ * Reference to a help document on the GWT project website.
+ */
+public class GwtprojectOrgHelpInfo extends TreeLogger.HelpInfo {
+  private URL url;
+
+  public GwtprojectOrgHelpInfo(String relativeUrl) {
+    try {
+      url = new URL("https://gwtproject.org" + relativeUrl);
+    } catch (MalformedURLException ignored) {
+      // ignore, url will be null
+    }
+  }
+
+  @Override
+  public URL getURL() {
+    return url;
+  }
+}

dev/core/src/com/google/gwt/dev/util/InstalledHelpInfo.java

@@ -24,7 +24,11 @@
 
 /**
  * Help info based on the GWT installation directory.
+ *
+ * @deprecated Use {@link GwtprojectOrgHelpInfo} instead so that links work when users aren't using
+ * the GWT SDK zip.
  */
+@Deprecated
 public class InstalledHelpInfo extends HelpInfo {
   private URL url;
 

distro-source/core/src/doc/helpInfo/servletMappings.html

@@ -9,11 +9,8 @@
 tags. These define Java Servlets that implement the server-side
 component of a GWT-enabled web application.</p>
 
-<p>Prior to GWT 1.6, these GWT module servlet tags controlled the set of
-servlets were actually instantiated during hosted mode. But as of GWT 1.6, this
-is no longer true.  Instead, the web application's <code>WEB-INF/web.xml</code>
-configuration file controls what servlets are instantiated. A GWT module
-specifies only what servlets are <i>expected</i>.
+<p>In modern GWT applications, these are only used for testing, and it is
+discouraged to use them in application code.</p>
 
 <p>During hosted mode startup, the set of expected servlets (from GWT module
 <code>&lt;servlet&gt;</code> tags) is validated against the set of actual