|
| 1 | +## Description |
| 2 | + |
| 3 | +This directory contains the Splash-screen and About-dialog images of **future** versions of Eclipse. |
| 4 | +It serves as a kind of staging area and is not included in the built bundle. |
| 5 | +These images will be moved to their final location by the `prepareNextDevCycle.sh` script, which is called during the preparation of the development of the corresponding release. |
| 6 | +Therefore the image(s) for a corresponding release must be available in this directory **BEFORE the DEVELOPMENT of that release is PREPARED** and the following requirements apply: |
| 7 | + |
| 8 | +- The Splash-screen images **must** be named according to the following schema: |
| 9 | +`splash_${NEXT_RELEASE_YEAR}.png` |
| 10 | +for example `splash_2025-12.png`. |
| 11 | + |
| 12 | +- The About-dialog image (and it's high-DPI version) of a future version must be added to this directory, if changed, and be named |
| 13 | +`eclipse_lg.png` respectively `[email protected]` |
| 14 | + |
| 15 | +While there is a dedicated Splash-screen image for each release (containing the version of the release), |
| 16 | +the About-dialog image is the same for multiple releases as long as they share the same Splash-screen base style/template. |
| 17 | + |
| 18 | +The Splash-screen and About-dialog images of the currently developed and past Eclipse versions don't need to be included in this directory. |
| 19 | + |
| 20 | +## Providing new Splash-screen images for a future release |
| 21 | + |
| 22 | +Due to the requirements described above, the images for a new Splash-screen base style/template must be added to this folder |
| 23 | +before the development of the first release that is intended to use them is prepared. |
| 24 | +For example if a Splash-screen style/template is used for 2026-06 ff., the new images should be added at latest near the end of the 2026-03 development. |
| 25 | +When a new Splash-screen style/template is introduced, typically the Splash-screen images for four consecutive releases are added to this directory, |
| 26 | +following the naming requirements described above. |
| 27 | +The About-dialog image(s) is typically the same for these four consecutive releases, i.e. as long as the Splash-screen style/template is unchanged. |
| 28 | + |
| 29 | +The Splash-screen and About-dialog images of the currently developed and past Eclipse versions in this folder are irrelevant and should be removed. |
| 30 | +In fact the mentioned `prepareNextDevCycle.sh` script will _move_ the images to their production location when they become effective, i.e. when a new release is prepared. |
| 31 | +This behavior clears this directory automatically over time. |
| 32 | + |
| 33 | +To test the result of a future release preparation, you can run the following bash snippet (adjust the numbers accordingly): |
| 34 | +```` |
| 35 | +export NEXT_RELEASE_VERSION=4.39 |
| 36 | +export NEXT_RELEASE_NAME=2026-03 |
| 37 | +./prepareNextDevCycle.sh |
| 38 | +``` |
| 39 | +**Please make sure to not submit the resulting commit!** |
0 commit comments