Skip to content

Commit 965b855

Browse files
committed
Improve the styling and wording of the existing 4.36 news.
1 parent 746bc4a commit 965b855

File tree

2 files changed

+63
-74
lines changed

2 files changed

+63
-74
lines changed

news/4.36/jdt.html

Lines changed: 46 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -99,36 +99,29 @@ <h2>Java Editor </h2>
9999
</td>
100100
</tr>
101101
<tr id="customFoldingRegions">
102-
<td class="title">Custom folding regions</td>
102+
<td class="title">Custom Folding Regions</td>
103103
<td class="content">
104104
It is now possible to create custom folding regions by specifying a comment at the start and end of the region.
105105
You can enable and configure this feature under <b>Window &gt; Preferences &gt; Java &gt; Editor &gt; Folding &gt; Custom folding regions</b>.
106+
<img src="images/custom_folding_regions_preferences.png" alt="Preference page for custom folding regions" />
106107
<p>
107-
<img src="images/custom_folding_regions_preferences.png" alt="Preference page for custom folding regions" />
108-
</p>
109-
<p>
110-
In that preference page, you can specify the text that should be used to start and end a custom folding region.
108+
on that preference page, you can specify the text that should be used to start and end a custom folding region.
111109
When this is enabled, writing a comment starting with the specified region start followed by another comment starting with the specified region end creates a folding region.
112110
</p>
113-
<p>
114-
<img src="images/custom_folding_regions_code_expanded.png" alt="code containing comments with the text 'region' and 'endregion'" />
115-
</p>
111+
<img src="images/custom_folding_regions_code_expanded.png" alt="code containing comments with the text 'region' and 'endregion'" />
116112
<p>
117113
Custom folding regions can be collapsed like any other folding regions.
118114
</p>
119-
<p>
120-
<img src="images/custom_folding_regions_code_collapsed.png" alt="custom folding regions are collapsed" />
121-
</p>
115+
<img src="images/custom_folding_regions_code_collapsed.png" alt="custom folding regions are collapsed" />
122116
</td>
123117
</tr>
124118
<tr id="foldingProjectPreferences">
125-
<td class="title">Project Properties page for folding</td>
119+
<td class="title">Project Properties Page for Folding</td>
126120
<td class="content">
127-
Preferences for folding can now be configured on a per-project basis in addition to configuring folding for workspaces.
121+
Preferences for folding can now be configured on a per-project basis in addition to configuring folding for the workspace.
128122
This page is available under <b>Project &gt; Properties &gt; Java Editor &gt; Folding</b>.
129-
<p>
130-
<img src="images/folding_property_page.png" alt="Project Properties page for folding" />
131-
</p>
123+
<p></p>
124+
<img src="images/folding_property_page.png" alt="Project Properties page for folding" />
132125
</td>
133126
</tr>
134127
<!-- ******************* End of Java Editor ************************************* -->
@@ -164,68 +157,67 @@ <h2>Debug</h2>
164157
</td>
165158
</tr>
166159
<tr id="collapsing-stackframes">
167-
<td class="title">Collapsing stack frames</td>
160+
<td class="title">Collapsing Stack Frames</td>
168161
<td class="content">
169-
Navigating in deep stack frames can be challenging during debuging, due to high number of stack frames that are not relevant for most of the time, for example because they are provided by either the JDK or a testing framework, or by some library</b>
170-
This feature tries to help focusing on the stack frames, that are the coming from the user created projects, drastically reducing the unnecessary noise in the Debug View
171-
<p>
172-
<img src="images/not-collapsed.png" alt="Original" />
173-
</p><br>
174-
The feature can be enabled from the Debug toolbar in Debug → Java → Collapse Stack Frames.<br>
162+
Navigating in deep stack frames can be challenging during debuging, due to the high number of stack frames that are not relevant most of the time,
163+
for example because they are provided by either the JDK, by a testing framework, or by a library</b>
164+
This feature tries to help focus on the stack frames that are coming from the user-created projects,
165+
drastically reducing the unnecessary noise in the Debug View.
166+
<p></p>
167+
<img src="images/not-collapsed.png" alt="Original" />
175168
<p>
176-
<img src="images/menuitem.png" alt="Menu to enable" />
177-
</p><br>
178-
After enabling it, the view becomes much simpler and less intimidating:
169+
The feature can be enabled from the Debug toolbar in <b>Debug &gt; Java &gt; Collapse Stack Frames</b>.<br>
170+
</p>
171+
<img src="images/menuitem.png" alt="Menu to enable" />
179172
<p>
180-
<img src="images/collapsed.png" alt="Collapsed stack frames" />
181-
</p><br>
173+
After enabling it, the view becomes much simpler and less intimidating:
174+
</p>
175+
<img src="images/collapsed.png" alt="Collapsed stack frames" />
182176
</td>
183177
</td>
184178
</tr>
185179

186180
<tr id="Navigate-to-variable-declaration-from-variable-view">
187-
<td class="title">Navigate to variable declaration</td>
181+
<td class="title">Navigate to Variable Declaration</td>
188182
<td class="content">
189-
Users can now navigate to a variable’s declaration directly from the Variables view during a debug session, making it easier to trace variables—especially in methods with numerous local variables.
190-
<br><br>
191-
Choose <b>Navigate to Declaration</b> from context menu of variables
183+
Users can now navigate to a variable’s declaration directly from the Variables view during a debug session,
184+
making it easier to locate a variable, especially in methods with numerous local variables.
192185
<p>
193-
<img src="images/NavigateToDeclareMenu.png" alt="Navigation_menu" />
194-
</p><br>
195-
<br><br>
196-
Now editor will jump and highlight its declaration
186+
Choose <b>Navigate to Declaration</b> from context menu of a variable.
187+
</p>
188+
<img src="images/NavigateToDeclareMenu.png" alt="Navigation_menu" />
197189
<p>
198-
<img src="images/Navigation.png" alt="Navigation_done" />
199-
</p><br>
190+
The editor will jump and highlight its declaration.
191+
</p>
192+
<img src="images/Navigation.png" alt="Navigation_done" />
200193
</td>
201194
</tr>
202195

203196
<tr id="Auto-resume-triggerpoints">
204-
<td class="title">Auto-Resuming Trigger Points</td>
197+
<td class="title">Auto-Resuming Trigger Points</td>
205198
<td class="content">
206-
Trigger points can now be configured to automatically resume execution when hit, allowing breakpoints after the trigger point to be activated while skipping those before it,
207-
enabling more focused and efficient debugging workflows.
208-
<br><br>
209-
On enabling a trigger point a new option will be shown its left to <b>Continue execution </b> on hit or not
199+
Trigger points can now be configured to automatically resume execution when hit,
200+
allowing breakpoints after the trigger point to be activated while skipping those before it,
201+
thereby enabling a more focused and efficient debugging workflow.
210202
<p>
203+
Upon enabling a trigger point, a new option will be shown to <b>Continue execution on hit</b> or not.
204+
</p>
211205
<img src="images/TriggerEnabled.png" alt="Triggerpoint Enabled" />
212-
</p><br>
213-
<br><br>
214-
Once <b>Continue execution on hit</b> is toggled, breakpoint label will update to <b>[Resume on hit]</b> meaning it wont suspend on hit
215206
<p>
207+
Once <b>Continue execution on hit</b> is toggled, the breakpoint label will update to <b>[Resume on hit]</b> meaning it won't suspend on hit.
208+
</p>
216209
<img src="images/TriggerContinue.png" alt="Triggerpoint Continue" />
217-
</p><br>
218-
<br><br>
219-
Resume trigger also supports conditions, meaning if condition is met true it will resume the execution else it will suspend
220210
<p>
211+
Resume trigger also supports conditions, meaning if condition is true it will resume the execution otherwise it will suspend.
212+
</p>
221213
<img src="images/ResumeWithCondition.png" alt="Resume-Triggerpoint with conditions" />
222-
</p><br>
223-
<br><br>
224-
Now when you run in debug, Trigger point wont hit, allowing you to skip previous breakpoints and hit on the actual breakpoint you need to focus. <br><br>
225-
For example, here <i>Resume trigger</i> was set on line number 7 and during debugging it hit on line number 8 by skipping all the previous breakpoints
226214
<p>
215+
Now when you run in debug mode, the trigger point won't hit, allowing you to skip previous breakpoints, and stop on the actual breakpoint on which you need to focus.
216+
</p>
217+
<p>
218+
For example, here <i>Resume trigger</i> was set on line number 7 and during debugging it hit on line number 8 by skipping all the previous breakpoints.
219+
</p>
227220
<img src="images/TriggerExecution.png" alt="Resume-Triggerpoint execution" />
228-
</p><br>
229221
</td>
230222
</tr>
231223
<tr id="DefaultFoldingMechanism">

news/4.36/platform.html

Lines changed: 17 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -111,41 +111,38 @@ <h2>General Updates </h2>
111111
<tr id="rescaleOnRuntimePreference"> <!-- https://github.com/eclipse-platform/eclipse.platform.ui/pull/2868 -->
112112
<td class="title">Monitor-Specific UI Scaling as Default (Windows only)</td>
113113
<td class="content">
114+
In the previous releases, a preference to enable an improved, monitor- and resolution-specific UI scaling on
115+
Windows was introduced (see the news for <a href="../4.34/platform.html#rescale-on-runtime-preference">4.34</a> and
116+
<a href="../4.35/platform.html#rescaleOnRuntimePreference">4.35</a>). The feature has been further improved since
117+
then and is now <b>enabled by default</b>.
114118
<p>
115-
In the previous releases, a preference to enable an improved, monitor- and resolution-specific UI scaling on
116-
Windows was introduced (see the news for <a href="../4.34/platform.php#rescale-on-runtime-preference">4.34</a> and
117-
<a href="../4.35/platform.php#rescaleOnRuntimePreference">4.35</a>). The feature has been further improved since
118-
then and is now <b>enabled by default</b>.
119+
The feature makes each window adapt its scaling to the monitor it is currently placed on in a sharp, resolution-specific way
120+
and without requiring the application to restart.
121+
When using multiple windows, each of them will adapt its scaling to the monitor it is placed on.
122+
When enabled, this new feature replaces the current, limited scaling support for high-resolution monitors,
123+
which initializes the application's window according to the scaling of the primary monitor at application startup
124+
and produces blurry scaling when moving the window to another monitor unless the application is restarted.
119125
</p>
120126
<p>
121-
The feature makes each window adapt its scaling to the monitor it is currently placed on in a sharp,
122-
resolution-specific way and without requiring the application to restart. When using multiple windows, each of
123-
them will adapt its scaling to the monitor it is placed on. When enabled, this new feature replaces the current,
124-
limited scaling support for high-resolution monitors, which initializes the application's window according to the
125-
scaling of the primary monitor at application startup and produces blurry scaling when moving the window to
126-
another monitor unless you restart the application.
127-
</p>
128-
<p>
129-
To disable this feature, uncheck the <i>Monitor-specific UI scaling</i> box on the <b>Appearance</b> preference
130-
page (<b>Window > Preferences > General > Appearance</b>), as shown in the image below. The feature is still under
131-
further development. We encourage users to <b>share their feedback</b> to help us improve the functionality.
132-
</p>
133-
<p>
134-
<img src="images/rescaling_settings-preference.png" alt="Monitor-Specific UI Rescaling Preference" />
127+
To disable this feature, uncheck the <i>Monitor-specific UI scaling</i> box on the <b>Appearance</b> preference page
128+
(<b>Window > Preferences > General > Appearance</b>),
129+
as shown in the image below.
130+
The feature is still under further development. We encourage users to <b>share their feedback</b> to help us improve the functionality.
135131
</p>
132+
<img src="images/rescaling_settings-preference.png" alt="Monitor-Specific UI Rescaling Preference" />
136133
<p>
137134
The images below demonstrate the scaling behavior in an extract of an Eclipse application when moving the window
138135
from a primary monitor with 100% scaling to another monitor with 200% scaling, first having the feature disabled
139136
and second having it enabled.
140137
</p>
141138
<p>
142139
On a 200% monitor with the feature being <b>disabled</b>:
143-
<img src="images/rescaling-disabled.png" alt="Monitor-Specific UI Rescaling Disabled" />
144140
</p>
141+
<img src="images/rescaling-disabled.png" alt="Monitor-Specific UI Rescaling Disabled" />
145142
<p>
146143
On a 200% monitor with the feature being <b>enabled</b>:
147-
<img src="images/rescaling-enabled.png" alt="Monitor-Specific UI Rescaling Enabled" />
148144
</p>
145+
<img src="images/rescaling-enabled.png" alt="Monitor-Specific UI Rescaling Enabled" />
149146
</td>
150147
</tr>
151148
<!-- ******************* End of General Updates ************************************* -->

0 commit comments

Comments
 (0)