From f8154c827b290fcc2107cb525ac740127e2e4be8 Mon Sep 17 00:00:00 2001 From: Colin Alworth Date: Wed, 18 Dec 2024 19:34:39 -0600 Subject: [PATCH] Fix or remove broken links in release-notes.md In the past, release notes files were created per-release, but those have all been deleted - the earliest such release was 2.5, old enough that I didn't feel it was necessary to dig through history and find those notes and restore them, but just deleted the broken links. Old javadoc links apparently used `.` instead of `/` delimiters for packages, and left off `.html` suffixes. In theory our server will automatically deal with the missing suffixes, but won't rewrite paths. Going back to 1.x days, some documentation was written by adding inner classes to a DeveloperGuide class, and adding notes there. I've found the present-day equivelents of each of those old documents, or just deleted the links where nothing seemed appropriate. --- src/main/markdown/release-notes.md | 129 +++++++++++++---------------- 1 file changed, 57 insertions(+), 72 deletions(-) diff --git a/src/main/markdown/release-notes.md b/src/main/markdown/release-notes.md index a3549db2b..e7e009734 100644 --- a/src/main/markdown/release-notes.md +++ b/src/main/markdown/release-notes.md @@ -1147,8 +1147,7 @@ on the server ([7527](https://code.google.com/p/google-web-toolkit/issues/detail ## Release Notes for 2.5.0 This release includes some minor bug fixes found in the release -candidate. See [What's New in -GWT 2.5](doc/latest/ReleaseNotes.html) plus the release notes for [2.5.0 +candidate. See the release notes for [2.5.0 (RC1)](#Release_Notes_2_5_0_RC1) and [2.5.0 (RC2)](#Release_Notes_2_5_0_RC2) for the full list of features and bugs fixes included in the GWT 2.5.0 release. @@ -1163,8 +1162,7 @@ recompile your app, and redeploy. ## Release Notes for 2.5.0 (RC2) -This is release candidate 2 of GWT 2.5. See the [What's new in GWT 2.5](doc/latest/ReleaseNotes.html) page as -well as release notes below for the full list of features and bugfixes +This is release candidate 2 of GWT 2.5. See the release notes below for the full list of features and bugfixes in this release. ### Changes since RC1 @@ -1180,8 +1178,7 @@ tracker](https://github.com/gwtproject/gwt/issues?q=is%3Aissue+label%3AFixedIn2_ ## Release Notes for 2.5.0 (RC1) -This is release candidate 1 of GWT 2.5. See the [What's new in GWT 2.5](doc/latest/ReleaseNotes.html) page as -well as release notes below for the full list of features and bugfixes +This is release candidate 1 of GWT 2.5. See the release notes below for the full list of features and bugfixes in this release. ### Major Enhancements @@ -1473,8 +1470,6 @@ such as the Canvas/Audio/Video tags, an updated CellTable widget that now supports sortable columns and fixed column widths, and a more lenient SafeHtml template parser. -Also see [What's New in GWT 2.2?](doc/2.2/ReleaseNotes.html) - ### General Enhancements * Touchstart, touchmove, touchend, touchcancel have been @@ -1528,10 +1523,8 @@ in this release. ## Release Notes for 2.1.0 This release includes some minor bug fixes found in the release -candidate. See [What's New in -GWT 2.1](doc/2.1/ReleaseNotes.html) plus the release notes for [2.1.0 -(RC1)](#Release_Notes_2_1_0_RC1) for the full list of features and bugs fixes included in the GWT -2.1.0 release. +candidate. See the release notes for [2.1.0 (RC1)](#Release_Notes_2_1_0_RC1) for the full +list of features and bugs fixes included in the GWT 2.1.0 release. * * * @@ -1787,8 +1780,8 @@ the complete list of bug fixes and enhancements](https://github.com/gwtproject/g ## Release Notes for 2.0.0 This release includes some minor bug fixes found in the release -candidate. See [What's New -in GWT 2.0](doc/2.0/ReleaseNotes_2_0.html) plus the release notes for [2.0.0 (RC1)](#Release_Notes_2_0_0_rc1) and [2.0.0-rc2](#Release_Notes_2_0_0_rc2) for the full list of +candidate. See the release notes for [2.0.0 (RC1)](#Release_Notes_2_0_0_rc1) and +[2.0.0-rc2](#Release_Notes_2_0_0_rc2) for the full list of features and bugs fixes included in the GWT 2.0.0 release. * * * @@ -2004,8 +1997,6 @@ potentially breaking change for libraries that use deferred binding to specialize code based on user agent (see the next section for technical details). -Also see [What's New in 1.7?](doc/1.7/ReleaseNotes_1_7.html) - ### Potentially breaking changes and fixes * This release includes explicit support for IE8, which has some @@ -2056,8 +2047,6 @@ introduced in 1.6.2 are resolved. ## Release Notes for 1.6.2 (RC) -Please see [What's new in GWT 1.6?](doc/1.6/ReleaseNotes_1_6.html) (online) - * * * ## Release Notes for 1.5.3 @@ -2204,9 +2193,7 @@ the complete list of bug fixes and enhancements](https://github.com/gwtproject/g ## Release Notes for 1.5.0 (RC) -This release candidate is, in a word, huge. Rather than including all -the details here, please see [What's -New in GWT 1.5?](http://code.google.com/p/google-web-toolkit-doc-1-5/wiki/ReleaseNotes_1_5_ImportantNotes) for full details. The main thing you'll want to know +This release candidate is, in a word, huge. The main thing you'll want to know is that GWT 1.5 supports the Java 5 language features (generics, enumerated types, annotations, etc.). But check out the full notes, because there's a lot of great stuff! @@ -2235,24 +2222,24 @@ the [release notes for 1.4.10](#Release_Notes_1_4_10) first. ### New Features -* [DOM.eventGetCurrentEvent()](doc/html/com.google.gwt.user.client.DOM#eventGetCurrentEvent\(\)) +* [DOM.eventGetCurrentEvent()](javadoc/latest/com/google/gwt/user/client/DOM.html#eventGetCurrentEvent\(\)) now provides global access to the current Event object. ([#1309](https://code.google.com/p/google-web-toolkit/issues/detail?id=1309)) * [PopupPanel.setPopupPositionAndShow(PopupCallback -callback)](doc/html/com.google.gwt.user.client.ui.PopupPanel#setPopupPositionAndShow\(com.google.gwt.user.client.ui.PopupPanel.PositionCallback\)) now provides now provides a simpler and bulletproof way to +callback)](javadoc/latest/com/google/gwt/user/client/ui/PopupPanel.html#setPopupPositionAndShow\(com.google.gwt.user.client.ui.PopupPanel.PositionCallback\)) now provides now provides a simpler and bulletproof way to control the layout of popups. ([#1120](https://code.google.com/p/google-web-toolkit/issues/detail?id=1120), [#1243](https://code.google.com/p/google-web-toolkit/issues/detail?id=1243)) -* The [SuggestionHandler](doc/html/com.google.gwt.user.client.ui.SuggestionHandler) +* The [SuggestionHandler](javadoc/latest/com/google/gwt/user/client/ui/SuggestionHandler.html) interface can be used to respond to the user selecting a suggstion in -the [SuggestBox](doc/html/com.google.gwt.user.client.ui.SuggestBox). +the [SuggestBox](javadoc/latest/com/google/gwt/user/client/ui/SuggestBox.html). ([#1086](https://code.google.com/p/google-web-toolkit/issues/detail?id=1086)) -* [Collection.toArray(Object[])](doc/html/java.util.Collection) +* [Collection.toArray(Object[])](https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html) is now implemented. ([#695](https://code.google.com/p/google-web-toolkit/issues/detail?id=695)) * If you have it installed, [Google Gears](http://gears.google.com/) is now accessible in hosted mode (Windows only). ([#1252](https://code.google.com/p/google-web-toolkit/issues/detail?id=1252)) ### General Changes -* Startup is now faster and more reliable. In particular, [onModuleLoad()](doc/html/com.google.gwt.core.client.EntryPoint#onModuleLoad\(\)) +* Startup is now faster and more reliable. In particular, [onModuleLoad()](javadoc/latest/com/google/gwt/core/client/EntryPoint.html#onModuleLoad\(\)) is now called as soon as the DOM is ready, which will generally be before the page's body.onload() event is fired. This allows your application to startup before certain resources (such as images) are @@ -2261,36 +2248,36 @@ fully loaded. [#1281](https://code.google.com/p/google-web-toolkit/issues/detail?id=1281), [#1358](https://code.google.com/p/google-web-toolkit/issues/detail?id=1358)) * An important discussion of HTTP headers, caching, and HTTPS -has been added to the [ImageBundle](doc/html/com.google.gwt.user.client.ui.ImageBundle) +has been added to the [ImageBundle](javadoc/latest/com/google/gwt/user/client/ui/ImageBundle.html) documentation. ([#1172](https://code.google.com/p/google-web-toolkit/issues/detail?id=1172)) -* [PopupPanel.center()](doc/html/com.google.gwt.user.client.ui.PopupPanel#center\(\)) +* [PopupPanel.center()](javadoc/latest/com/google/gwt/user/client/ui/PopupPanel.html#center\(\)) now causes the popup to be shown as well as centered. ([#1120](https://code.google.com/p/google-web-toolkit/issues/detail?id=1120)) -* [RichTextArea](doc/html/com.google.gwt.user.client.ui.RichTextArea) +* [RichTextArea](javadoc/latest/com/google/gwt/user/client/ui/RichTextArea.html) underwent number of bugfixes and should be stable now. ([#1130](https://code.google.com/p/google-web-toolkit/issues/detail?id=1130), [#1214](https://code.google.com/p/google-web-toolkit/issues/detail?id=1214), [#1276](https://code.google.com/p/google-web-toolkit/issues/detail?id=1276)) -* New [RPC](doc/html/com.google.gwt.doc.DeveloperGuide.RemoteProcedureCalls) +* New [RPC](doc/latest/DevGuideServerCommunication.html#DevGuideRemoteProcedureCalls) warnings * Warn if a non-checked exception is used in the throws clause of a RemoteService method. * Warn if no concrete, serializable subclasses can be found for a given type declared in a RemoteService interface. -* [RPC](doc/html/com.google.gwt.doc.DeveloperGuide.RemoteProcedureCalls) +* [RPC](doc/latest/DevGuideServerCommunication.html#DevGuideRemoteProcedureCalls) now generates a serialization policy file during compilation. The serialization policy file contains a whitelist of allowed types which may be serialized. Its name is a strong hash name followed by `.gwt.rpc`. This file must be deployed to your web server as a public resource, -accessible from a [RemoteServiceServlet](doc/html/com.google.gwt.user.server.rpc.RemoteServiceServlet) +accessible from a [RemoteServiceServlet](javadoc/latest/com/google/gwt/user/server/rpc/RemoteServiceServlet.html) via `ServletContext.getResource()`. If it is not deployed properly, RPC will run in 1.3.3 compatibility mode and refuse to -serialize types implementing [Serializable](doc/html/java.io.Serializable). +serialize types implementing [Serializable](https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html). ([#1297](https://code.google.com/p/google-web-toolkit/issues/detail?id=1297)) * [Panel.adopt(Widget, -Element)](doc/html/com.google.gwt.user.client.ui.Panel#adopt\(com.google.gwt.user.client.ui.Widget,%20com.google.gwt.user.client.Element\)) and [Panel.disown(Widget)](doc/html/com.google.gwt.user.client.ui.Panel#disown\(com.google.gwt.user.client.ui.Widget\)) +Element)](javadoc/latest/com/google/gwt/user/client/ui/Panel.html#adopt\(com.google.gwt.user.client.ui.Widget,%20com.google.gwt.user.client.Element\)) and [Panel.disown(Widget)](javadoc/latest/com/google/gwt/user/client/ui/Panel.html#disown\(com.google.gwt.user.client.ui.Widget\)) have been deprecated. If you have subclassed Panel, please carefully -review the new documentation for [Panel.add(Widget)](doc/html/com.google.gwt.user.client.ui.Panel#add\(com.google.gwt.user.client.ui.Widget\)) -and [Panel.remove(Widget)](doc/html/com.google.gwt.user.client.ui.Panel#remove\(com.google.gwt.user.client.ui.Widget\)) +review the new documentation for [Panel.add(Widget)](javadoc/latest/com/google/gwt/user/client/ui/Panel.html#add\(com.google.gwt.user.client.ui.Widget\)) +and [Panel.remove(Widget)](javadoc/latest/com/google/gwt/user/client/ui/Panel.html#remove\(com.google.gwt.user.client.ui.Widget\)) for details on the correct way to add and remove Widgets from Panels. ([#1121](https://code.google.com/p/google-web-toolkit/issues/detail?id=1121)) * The benchmark viewer application is now faster, prettier, and @@ -2298,7 +2285,7 @@ a bit more user friendly. ### Retractions from 1.4.10 -* Breaking changes to the semantics of [UIObject.setStyleName()](doc/html/com.google.gwt.user.client.ui.UIObject#setStyleName\(java.lang.String\)) +* Breaking changes to the semantics of [UIObject.setStyleName()](javadoc/latest/com/google/gwt/user/client/ui/UIObject.html#setStyleName\(java.lang.String\)) have been backed out. All changes relative to 1.3.3 should now be backwards-compatible. ([#1079](https://code.google.com/p/google-web-toolkit/issues/detail?id=1079)) * The linux distribution of 1.4.10 bundled Mozilla 1.7.13 @@ -2357,8 +2344,8 @@ of String might work. This type of code is less likely to work now and will likely become more strict in the future. Bottom line: don't do this. Make sure collections only contain the declared item type (or subtypes thereof). -* **[Serializable](doc/html/java.io.Serializable) -equivalent to [IsSerializable](doc/html/com.google.gwt.user.client.rpc.IsSerializable)** +* **[Serializable](https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html) +equivalent to [IsSerializable](javadoc/latest/com/google/gwt/user/client/rpc/IsSerializable.html)** Although GWT's RPC mechanism doesn't purport to honor the semantics of Java serialization, by popular demand, Serializable and IsSerializable @@ -2367,7 +2354,7 @@ server-side interoperability and remove much of the need for DTOs. * **Warn about missing gwt.typeArgs** Every Collection or Map type should have an associated [gwt.typeArgs -javadoc annotation](doc/html/com.google.gwt.doc.DeveloperGuide.RemoteProcedureCalls.SerializableTypes). In the past, a missing @gwt.typeArgs would +javadoc annotation](doc/latest/DevGuideServerCommunication.html#DevGuideSerializableTypes). In the past, a missing @gwt.typeArgs would generally have no noticeable effect, because a bug in the RPC system would generate code for all available serializable types, even if they weren't used in your service interface. Now that this bug has been @@ -2405,7 +2392,7 @@ files via a module `