Skip to content

Commit

Permalink
New and Noteworthy for 4.33
Browse files Browse the repository at this point in the history
  • Loading branch information
@elsazac
elsazac committed Aug 23, 2024
1 parent 2194d70 commit eca50f7
Show file tree
Hide file tree
Showing 41 changed files with 384 additions and 190 deletions.
2 changes: 1 addition & 1 deletion eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/META-INF/MANIFEST.MF
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: %pluginName
Bundle-SymbolicName: org.eclipse.jdt.doc.user; singleton:=true
Bundle-Version: 3.15.2200.qualifier
Bundle-Version: 3.15.2300.qualifier
Bundle-Vendor: %providerName
Bundle-Localization: plugin
Require-Bundle: org.eclipse.help;bundle-version="[3.2.0,4.0.0)"
2 changes: 1 addition & 1 deletion eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/pom.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,6 @@
</parent>
<groupId>org.eclipse.jdt</groupId>
<artifactId>org.eclipse.jdt.doc.user</artifactId>
<version>3.15.2200-SNAPSHOT</version>
<version>3.15.2300-SNAPSHOT</version>
<packaging>eclipse-plugin</packaging>
</project>
2 changes: 1 addition & 1 deletion eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/topics_WhatsNew.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@
<!-- ================================ -->
<toc label="What's New">
<topic href="whatsNew/jdt_whatsnew.html#JavaEditor" label="Java Editor"/>
<topic href="whatsNew/jdt_whatsnew.html#JavaViewsAndDialogs" label="Java Views and Dialogs"/>
<!-- <topic href="whatsNew/jdt_whatsnew.html#JavaViewsAndDialogs" label="Java Views and Dialogs"/> -->
</toc>
Binary file removed .../bundles/org.eclipse.jdt.doc.user/whatsNew/images/anonymous-local-var-after.png
View file
Binary file not shown.
Binary file removed ...bundles/org.eclipse.jdt.doc.user/whatsNew/images/anonymous-local-var-before.png
View file
Binary file not shown.
Binary file removed ...bundles/org.eclipse.jdt.doc.user/whatsNew/images/decl-with-assignment-after.png
View file
Binary file not shown.
Binary file removed ...dles/org.eclipse.jdt.doc.user/whatsNew/images/decl-with-assignment-combined.png
View file
Binary file not shown.
Binary file added ....common/bundles/org.eclipse.jdt.doc.user/whatsNew/images/ifelsestring-after.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...common/bundles/org.eclipse.jdt.doc.user/whatsNew/images/ifelsestring-before.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed ...ommon/bundles/org.eclipse.jdt.doc.user/whatsNew/images/javadoc-styling-menu.png
View file
Binary file not shown.
Binary file removed ...common/bundles/org.eclipse.jdt.doc.user/whatsNew/images/javadoc-styling-new.png
View file
Binary file not shown.
Binary file removed ...common/bundles/org.eclipse.jdt.doc.user/whatsNew/images/javadoc-styling-old.png
View file
Binary file not shown.
Binary file removed ...ommon/bundles/org.eclipse.jdt.doc.user/whatsNew/images/message-format-after.png
View file
Binary file not shown.
Binary file removed ...org.eclipse.jdt.doc.user/whatsNew/images/new-self-encapsulate-fields-dialog.png
View file
Binary file not shown.
Binary file removed ...mon/bundles/org.eclipse.jdt.doc.user/whatsNew/images/original-string-concat.png
View file
Binary file not shown.
Binary file removed ...on/bundles/org.eclipse.jdt.doc.user/whatsNew/images/ser-change-in-own-class.png
View file
Binary file not shown.
Binary file removed ...n/bundles/org.eclipse.jdt.doc.user/whatsNew/images/ser-change-in-references.png
View file
Binary file not shown.
Binary file removed ...les/org.eclipse.jdt.doc.user/whatsNew/images/split-try-with-resources-after.png
View file
Binary file not shown.
Binary file removed ...es/org.eclipse.jdt.doc.user/whatsNew/images/split-try-with-resources-before.png
View file
Binary file not shown.
Binary file removed ...common/bundles/org.eclipse.jdt.doc.user/whatsNew/images/string-format-after.png
View file
Binary file not shown.
Binary file removed ...org.eclipse.jdt.doc.user/whatsNew/images/types-call-hierarchy-on-ctrl-click.png
View file
Binary file not shown.
149 changes: 28 additions & 121 deletions eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/whatsNew/jdt_whatsnew.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,20 +17,20 @@
table.news tr td.content {vertical-align: top;}
ul {padding-left: 13px;}
</style>
<title>What's New in Eclipse 4.32 (JDT)</title>
<title>What's New in Eclipse 4.33 (JDT)</title>
</head>

<body>
<h2>Java Development Tools</h2>
<p>Here are descriptions of some of the more interesting or significant changes made to the Java development tools (JDT)
for the 4.32 release of Eclipse.
for the 4.33 release of Eclipse.
They are grouped into:</p>
<ul> <!-- NOTE: Sync ../topics_WhatsNew.xml with this! -->
<!--li><a href="#Java21">New Java&trade; Language Features</a></li-->
<!--li><a href="#JUnit">JUnit</a></li-->
<li><a href="#JavaEditor">Java Editor</a></li>
<!--li><a href="#JavaCompiler">Java Compiler</a></li-->
<li><a href="#JavaViewsAndDialogs">Java Views and Dialogs</a></li>
<!--<li><a href="#JavaViewsAndDialogs">Java Views and Dialogs</a></li>-->
<!--li><a href="#JavaFormatter">Java Formatter</a></li-->
<!--li><a href="#Debug">Debug</a></li-->
<!--li><a href="#JDTDev">JDT Developers</a></li-->
Expand Down Expand Up @@ -60,13 +60,11 @@ <h2>Java&trade; XX Support </h2>
<!-- ******************* End of Java XX Support ************************************* -->

<!-- ******************* JUnit ************************************* -->
<!--
<tr>
<!-- <tr>
<td id="JUnit" class="section" colspan="2">
<h2>JUnit</h2>
</td>
</tr>
-->
</td>
</tr> -->
<!-- ******************* End of JUnit ************************************* -->

<!-- ******************* Java Editor ************************************* -->
Expand All @@ -76,151 +74,60 @@ <h2>Java Editor </h2>
</td>
</tr>

<tr id="split-try-with-resources">
<td class="title"><a href="#split-try-with-resources">Split try-with-resources</a></td>
<td class="content">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.core/pull/1226 -->
A new quick assist has been added to allow splitting resources from a try-with-resources into an inner try-with-resources. All resources from the point of the split are added to the new inner try-with-resources statement. The assist is offered when <b>CTRL+1</b> is clicked while some part of a resource statement in the try-with-resources is selected.
<p>For example, in the following example, we can select part of the second resources statement:</p>
<p><img src="images/split-try-with-resources-before.png" alt="try-with-resources example before" width="800"/></p>
<p>and choose to split from that point:</p>
<p><img src="images/split-try-with-resources-after.png" alt="try-with-resources example after" width="800"/></p>
</td>
</tr>
<tr id="message-format-text-block">
<td class="title"><a href="#message-format-text-block">String concat to formatted text block</a></td>
<td class="content">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.ui/issues/1366 -->
The quick assists to convert a mixed string concatenatation of literals and variables into a <b>MessageFormat</b> or <b>String.format</b> call have been enhanced to use a text block when using Java 15 or greater. This is useful when there is purposeful alignment of the line indentation of the concatenation (e.g. a code snippet).
<p>For example, in the following example:</p>
<p><img src="images/original-string-concat.png" alt="original string concatenation" width="800"/></p>
<p>If we use <b>CTRL+1</b> with the cursor in the concatenation and choose <b>Use 'MessageFormat' for string concatenation</b> we get:</p>
<p><img src="images/message-format-after.png" alt="after changing to MessageFormat" width="800"/></p>
<p>or if we choose <b>Use 'String.format' for string concatenation</b> we get:</p>
<p><img src="images/string-format-after.png" alt="after changing to String.format" width="800"/></p>
</td>
</tr>
<tr id="combine-decl-and-assigment">
<td class="title"><a href="#combine-decl-and-assignment">Combine declaration and assignment</a></td>
<td class="content">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.core/pull/1330 -->
The <b>Remove overridden assignment</b> cleanup found in the <b>Unnecessary Code</b> tab of the clean-up configuration dialog has been enhanced to combine a variable declaration that is immediately followed by an assignment into a declaration with assignment.
<p>For example, the following:</p>
<p><img src="images/decl-with-assignment-after.png" alt="declaration with assignment immediately after" width="800"/></p>
<p>will be transformed into:</p>
<p><img src="images/decl-with-assignment-combined.png" alt="declaration with assignment combined" width="800"/></p>
</td>
</tr>
<tr id="extract-anonymous-class">
<td class="title"><a href="#extract-anonymous-class">Extract anonymous class to local variable</a></td>
<tr id="enhanced-if-else-switch-cleanup">
<td class="title"><a href="#new-make-static-refactoring">Enhance if/else to switch CleanUp</a></td>
<td class="content">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.core/pull/1063 -->
A new quick-assist has been added to extract an anonymous class implementation to a local variable. To use, click on <b>CTRL+1</b> with the cursor within the anonymous class.
For example:
<p><img src="images/anonymous-local-var-before.png" alt="anonymous class to local variable before"/></p>
<p>Results in:</p>
<p><img src="images/anonymous-local-var-after.png" alt="anonymous class to local variable after"/></p>
The clean-up to convert an if/else-if/else block into a switch has been enhanced to support String literals and Enum constants. As before, the if/else-if/else block must have at least 3 blocks and must look for constant expressions except for the last block which can be put into the <b>default</b> case.
<p>For a <b>String</b> variable, each <b>if/else</b> expression can check using the <b>String.equals()</b> method. For an <b>Enum</b> the code simply uses the <b>==</b> operator. Use of the <b>||</b> operator is allowed to check multiple values and corresponds to a fall-through in the resultant switch statement.</p>
<p>To use the clean-up, go to <b>Source &gt; Clean Up &gt; Code Style</b> page and select: <b>Convert if/else if/else chain with 3 blocks min to switch</b>.</p>
<p>For example, performing the clean-up on the following:</p>
<p><img src="images/ifelsestring-before.png" alt="convert if/else if/else to switch"/></p>
<p>will result in:</p>
<p><img src="images/ifelsestring-after.png" alt="converted if/else if/else to switch"/></p>
</td>
</tr>
<tr id="types-call-hierarchy-on-ctrl-click">
<td class="title"><a href="#types-call-hierarchy-on-ctrl-click">Types call Hierarchy on Ctrl+Click</a></td>
<td class="content">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.ui/pull/1367 -->
<p><code>Open Call Hierarchy</code> action now added to the list of actions shown on <code>Ctrl+Click</code> for types as well</p>
<p><img src="images/types-call-hierarchy-on-ctrl-click.png" alt="Call hierarchy action for types"/></p>
</td>
</tr>
</tr>


<!-- ******************* End of Java Editor ************************************* -->

<!-- ******************* Java Views and Dialogs ************************************* -->
<tr>
<!--<tr>
<td id="JavaViewsAndDialogs" class="section" colspan="2">
<h2>Java Views and Dialogs</h2>
</td>
</tr>
<tr id="javadocStylingImprovements">
<!-- https://github.com/eclipse-jdt/eclipse.jdt.ui/pull/1074 -->
<td class="title">Javadoc styling improvements</td>
<td class="content">
Styling of the method signatures displayed in the Javadoc view and hover dialog has been improved to make them easier
to read.
<p>
Until now, the entire signature has been rendered as one continuous text making it a bit hard to identify specific parts.
This is especially difficult when the signature contained type variables of generic declarations:
</p>
<p><img src="images/javadoc-styling-old.png" alt="Old Javadoc styling"/></p>
Now, by default, parts of the signature are visually distinguished by using italic, lighter, or colorized text or by placing
them on separate lines.
<p><img src="images/javadoc-styling-new.png" alt="New Javadoc styling"/></p>
<p>
Coloring is used to distinguish different types used as type variables. Four different colors are pre-configured and are also
re-used repeatedly in case more unique types are present in displayed Javadoc. Note: custom colors can be configured to
avoid this repetition.
</p>
<p>
All aspects of the new styling can be customized through the Javadoc styling menu accessible via a new menu button added to
the toolbar of the Javadoc view and Javadoc hover (here visible after pressing F2), where the button itself toggles the new styling
functionality on/off.
</p>
<p><img src="images/javadoc-styling-menu.png" alt="New Javadoc styling menu"/></p>
</td>
</tr>

<tr id="batch-encapsulate-fields">
<td class="title"><a href="#batch-encapsulate-fields">Enable encapsulating multiple fields from a single dialog</a></td>
<td class="content">
It is now possible to encapsulate multiple fields of a class and its references in other classes by invoking <b>Refactor > Encapsulate Fields...</b> on that class.
<p>The new dialog looks like this:</p>
<p><img src="images/new-self-encapsulate-fields-dialog.png" width="800"/></p>
<p>The Encapsulate Fields option can be accessed either by the <b>menu bar &gt; Refactor</b> or by right clicking while hovering over any field. </p>
<p>The dialog now consists of a tree where you can check all the fields that need to be encapsulated along with their getter and setter.</p>
<p>You can now select <b>Same as field</b> (default option) as the access modifier for the generated getters and setters.</p>
<p>The operation would have the following results as displayed in the example below:</p>
<p><img src="images/ser-change-in-own-class.png" width="800"/></p>
<p><img src="images/ser-change-in-references.png" width="800"/></p>

</td>
</tr>
</tr> -->
<!-- ******************* End of Java Views and Dialogs ************************************* -->

<!-- ******************* Java Compiler ************************************* -->
<!--
<tr>
<!-- <tr>
<td id="JavaCompiler" class="section" colspan="2">
<h2>Java Compiler</h2>
</td>
</tr>
-->
</tr> -->
<!-- ******************* End of Java Compiler ************************************* -->

<!-- ******************* Java Formatter ************************************* -->
<!--
<tr>
<!-- <tr>
<td id="JavaFormatter" class="section" colspan="2">
<h2>Java Formatter </h2>
</td>
</tr>
-->
</tr> -->
<!-- ******************* End of Java Formatter ************************************* -->

<!-- *********************** Debug ******************************** -->
<!--
<tr>
<!-- <tr>
<td id="Debug" class="section" colspan="2">
<h2>Debug</h2>
</td>
</tr>
-->
</tr> -->
<!--************************ End of Debug ******************************** -->

<!-- *********************** JDT Developers ******************************** -->
<!--
<tr>
<!-- <tr>
<td id="JDTDev" class="section" colspan="2">
<h2>JDT Developers</h2>
</td>
</tr>
-->
</tr> -->
<!-- *********************** End of JDT Developers ******************************** -->
<tr><td colspan="2"/></tr>
</tbody>
Expand Down
Binary file added ...form.common/bundles/org.eclipse.platform.doc.isv/whatsNew/.platform_isv_whatsnew.html.swp
View file
Binary file not shown.
30 changes: 5 additions & 25 deletions ....platform.common/bundles/org.eclipse.platform.doc.isv/whatsNew/platform_isv_whatsnew.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,13 @@
table.news tr td.content {vertical-align: top;}
ul {padding-left: 13px;}
</style>
<title>Eclipse Platform What's New in 4.32</title>
<title>Eclipse Platform What's New in 4.33</title>
</head>

<body>
<h2>Platform and Equinox API</h2>
<p>Here are descriptions of some of the changes of interest to plug-in developers
made to the Eclipse Platform and SWT for the 4.32 release of Eclipse.
made to the Eclipse Platform and SWT for the 4.33 release of Eclipse.
</p>
<ul><!-- NOTE: Sync ../topics_WhatsNew.xml with this! -->
<li><a href="#Platform">Platform Changes</a></li>
Expand All @@ -41,39 +41,19 @@ <h2>Platform and Equinox API</h2>
<table class="news">
<colgroup>
<col class="title" />
<col />
<col class="Description" />
</colgroup>
<tbody>
<!-- ******************** Platform ********************** -->
<tr>
<td id="Platform" class="section" colspan="2"><h2>Platform Changes</h2></td>
</tr>

<tr id="treeviewer_autoexpand_singlechild"> <!-- https://github.com/eclipse-platform/eclipse.platform.ui/issues/1063 -->
<td class="title">Auto-Expand for Single Child Elements in JFace Tree Viewers</td>
<td class="content">
<p>
The API method
<code>org.eclipse.jface.viewers.AbstractTreeViewer.setAutoExpandOnSingleChildLevels(int level)</code> was added to
JFace. If this method is called on a tree viewer with some positive value or the constant <code>ALL_LEVELS</code>,
expanding a tree item that only has a single child element will lead to a recursive expansion of child items. The
recursive expansion stops once an item has more than one child item or the number of expansions reaches the value
passed to the method.
</p>
<p>
To ensure backwards compatibility, this feature is disabled by default. Each instantiation of a concrete
implementation of <code>AbstractTreeViewer</code> is responsible for enabling this feature if needed.
</p>
</td>
</tr>
<!-- ******************** End of Platform ********************** -->

<!-- *********************** SWT *********************** -->
<!--
<tr>
<!-- <tr>
<td id="SWT" class="section" colspan="2"><h2>SWT Changes</h2></td>
</tr>
-->
</tr> -->
<!-- *********************** End of SWT *********************** -->
<tr><td colspan="2"/></tr>
</tbody>
Expand Down
7 changes: 5 additions & 2 deletions eclipse.platform.common/bundles/org.eclipse.platform.doc.user/topics_WhatsNew.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,10 @@
<!-- Define topics for the What's New -->
<!-- ================================ -->
<toc label="What's new">
<topic href="whatsNew/platform_whatsnew.html#Preferences" label="Preferences"/>
<topic href="whatsNew/platform_whatsnew.html#ViewsAndDialogs" label="Views, Dialogs and Toolbar"/>
<topic href="whatsNew/platform_whatsnew.html#TextEditors" label="Text Editors"/>
<topic href="whatsNew/platform_whatsnew.html#Debug" label="Debug"/>
<topic href="whatsNew/platform_whatsnew.html#Preferences" label="Preferences"/>
<topic href="whatsNew/platform_whatsnew.html#StylingThemes" label="Themes and Styling"/>
<topic href="whatsNew/platform_whatsnew.html#GeneralUpdates" label="General Updates"/>
</toc>
</toc>
47 changes: 47 additions & 0 deletions ...common/bundles/org.eclipse.platform.doc.user/whatsNew/images/case-sensitive.svg
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed ...ommon/bundles/org.eclipse.platform.doc.user/whatsNew/images/compare_generic.png
View file
Binary file not shown.
Binary file removed ....eclipse.platform.doc.user/whatsNew/images/generic-text-editors-preferences.png
View file
Binary file not shown.
Binary file added .../bundles/org.eclipse.platform.doc.user/whatsNew/images/multiline_mining_new.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .../bundles/org.eclipse.platform.doc.user/whatsNew/images/multiline_mining_old.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...ommon/bundles/org.eclipse.platform.doc.user/whatsNew/images/overlay-options.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...es/org.eclipse.platform.doc.user/whatsNew/images/overlay-top-replace-closed.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added ...es/org.eclipse.platform.doc.user/whatsNew/images/overlay-top-replace-opened.png
View file
Binary file added ...es/org.eclipse.platform.doc.user/whatsNew/images/overlay-top-search-history.png
View file
Binary file added ...orm.common/bundles/org.eclipse.platform.doc.user/whatsNew/images/pinInspect.png
View file
Binary file added ....common/bundles/org.eclipse.platform.doc.user/whatsNew/images/preview-theme.png
View file
Loading

0 comments on commit eca50f7

Please sign in to comment.