Skip to content

Commit

Permalink
docs: Update reference from "Adopt" to "Adoptium" (#2938)
Browse files Browse the repository at this point in the history
* docs: Update reference from "Adopt" to "Adoptium"

* docs: fix linter in md file

* docs: fix more linter and disable terminology linter

	- ignore: Incorrect usage of the term: “png”, use “PNG” instead
	- ignore: ncorrect usage of the term: “website”, use “site” instead
	- ignore: Incorrect usage of the term: “html”, use “HTML” instead
	- fix typo

* Update CHANGELOG.md

Co-authored-by: Shelley Lambert <[email protected]>

Co-authored-by: Shelley Lambert <[email protected]>
  • Loading branch information
zdtsw and smlambert authored Jun 2, 2022
1 parent bc0ac5b commit 12c9e94
Show file tree
Hide file tree
Showing 17 changed files with 58 additions and 53 deletions.
15 changes: 8 additions & 7 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
<!-- textlint-disable terminology -->
# Changelog for openjdk-build scripts (DEPRECATED)

## DEPRECATION NOTES
Expand Down Expand Up @@ -44,15 +45,15 @@ can be generated manually as well.
1. `-bv` is removed, (long form `--variant` changes to `--build-variant`).
1. `-c` (long form `--clean-docker-build`) added to build from a clean docker container.
1. `-ca` changes to `-C`, (long form `--configure-args` stays the same).
1. `--clean-git-repos`, added to clean out any 'bad' local git repo you already have.
1. `--clean-git-repos`, added to clean out any 'bad' local git repository you already have.
1. `-D` (long form `--docker`) added for building in a docker container.
1. `-dsgc` is removed, (long form `--disable-shallow-git-clone` stays the same).
1. `-ftd` changes to `-f`, (long form `--freetype-dir` stays the same).
1. `--freetype-build-param`, specify any special freetype build parameters (required for some OS's).
1. `--freetype-version`, specify the version of freetype you are building.
1. `-h` (long form `--help`) added.
1. `-i` (long form `--ignore-container`) added to ignore existing docker container.
1. `-j, --jtreg` and `-js, --jtreg-subsets` are removed as tests should be run via the openjdk-tests repo / project.
1. `-j, --jtreg` and `-js, --jtreg-subsets` are removed as tests should be run via the aqa-tests repository / project.
1. `-J` (long form `--jdk-boot-dir` added to set JDK boot dir.
1. `-nc` (long form `--no-colour`) is removed.
1. `-p` (long form `--processors`) added to set number of processors in docker build.
Expand Down Expand Up @@ -82,27 +83,27 @@ container.
1. `--sudo` added to run the docker container as root.
1. _docker-build.sh_ added. This script is invoked for building (Adopt) OpenJDK
binaries in a Docker container.
1. _docker/jdk<X>/x86_64/ubuntu/Dockerfile_ updated for various bug fixes.
1. _docker/jdk<X>/x86_64/ubuntu/Dockerfile_ updated for various bugfixes.
1. _docker/jdk<X>/x86_64/ubuntu/dockerConfiguration.sh_ files added. These
contain Docker specific environment variables that the build scripts need (as
opposed to falsely picking up the underlying native env).

### Build Farm Support

1. New _build-farm/make-adopt-build-farm.sh_ added for the new AdoptOpenJDK
Build Farm jenkins pipeline to build Adopt OpenJDK binaries. Sets the default
Build Farm jenkins pipeline to build Adoptium OpenJDK binaries. Sets the default
environment variables that are currently set in individual jobs. This allows
us to now track and version these variables.
1. New _build-farm/set-platform-specific-configurations.sh_ added for the new
AdoptOpenJDK Build Farm jenkins pipeline to build Adopt OpenJDK binaries. Sets
AdoptOpenJDK Build Farm jenkins pipeline to build Adoptium OpenJDK binaries. Sets
the default environment variables that are currently set in individual jobs.
This allows us to now track and version these variables.
1. New _build-farm/platform-specific-configurations/<platform>.sh added for
the new AdoptOpenJDK Build Farm jenkins pipeline to build Adopt OpenJDK binaries.
the new AdoptOpenJDK Build Farm jenkins pipeline to build Adoptium OpenJDK binaries.
Sets the default environment variables for specific platforms that are currently
set in individual jobs. This allows us to now track and version these variables.
1. New _build-farm/sign-releases.sh added for the new AdoptOpenJDK Build Farm
jenkins pipeline to code sign Adopt OpenJDK binaries (Mac and Windows for now).
jenkins pipeline to code sign Adoptium OpenJDK binaries (Mac and Windows for now).
1. _pipelines/build/common/build_base_file.groovy_ added. This co-ordinates the various
pipeline builds.
1._pipelines/build/common/create\_job\_from\_template.groovy_ added. This dynamically
Expand Down
15 changes: 8 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
<!-- textlint-disable terminology -->
# Repository for code and instructions for building OpenJDK binaries, defaulting to Eclipse Temurin™

These scripts can be used to build OpenJDK anywhere but are primarily used by Eclipse Adoptium members (vendors) to build binaries. The scripts default to the use case of building Eclipse Temurin binaries which occurs on the build farm at <https://ci.adoptopenjdk.net>. Those binaries are then made available for consumption at <https://adoptium.net> and via the API <https://api.adoptium.net>.
Expand All @@ -6,7 +7,7 @@ These scripts can be used to build OpenJDK anywhere but are primarily used by Ec

## Where can I find the release status of Eclipse Temurin™ binaries?

Go to the [Eclipse Adoptium Top Level Project Repo](https://www.github.com/adoptium/adoptium/issues) for release tracking.
Go to the [Eclipse Adoptium Top Level Project repository](https://www.github.com/adoptium/adoptium/issues) for release tracking.

## TL;DR: I want to build a JDK NOW

Expand Down Expand Up @@ -57,7 +58,7 @@ This repository contains several useful scripts in order to build OpenJDK
personally or at build farm scale.

1. The `build-farm` folder contains shell scripts for multi configuration Jenkins
build jobs used for building Adopt OpenJDK binaries.
build jobs used for building Adoptium OpenJDK binaries.
1. The `docker` folder contains tools for generating dockerfiles which can be used as part of building
OpenJDK inside a Docker container.
1. The `git-hg` folder has now been moved to it's own separate repository. See [openjdk-mirror-scripts](https://github.com/adoptium/mirror-scripts).
Expand All @@ -72,7 +73,7 @@ file that's used to enable SSL connections.

## The makejdk-any-platform.sh script

`makejdk-any-platform.sh` is the entry point for building (Adopt) OpenJDK binaries.
`makejdk-any-platform.sh` is the entry point for building (Adoptium) OpenJDK binaries.
Building natively or in a docker container are both supported. This script (and
its supporting scripts) have defaults, but you can override these as needed.
The scripts will auto detect the platform and architecture it is running on and
Expand Down Expand Up @@ -127,7 +128,7 @@ specify any custom user configuration arguments, using
temporary_speech_mark_placeholder in the place of any speech marks.

--clean-git-repo
clean out any 'bad' local git repo you already have.
clean out any 'bad' local git repository you already have.

--create-debug-image
create a debug-image archive with the debug symbols.
Expand Down Expand Up @@ -274,7 +275,7 @@ general preparation.
### Building OpenJDK from a non-Adoptium repository
These scripts default to using Adoptium as the OpenJDK source repo to build
These scripts default to using Adoptium as the OpenJDK source repository to build
from, but you can override this with the `-r` flag. If you want to run from a
non-default branch you can also specify -b e.g.
Expand Down Expand Up @@ -334,7 +335,7 @@ Alongside the built assets a metadata file will be created with info about the b
The Metadata class is contained in the [Metadata.groovy](https://github.com/adoptium/ci-jenkins-pipelines/blob/master/pipelines/library/src/common/MetaData.groovy) file and the Json is constructed and written in the [openjdk_build_pipeline.groovy](https://github.com/adoptium/ci-jenkins-pipelines/blob/master/pipelines/build/common/openjdk_build_pipeline.groovy) file.
It is worth noting the additional tags on the semver is the adopt build number.
It is worth noting the additional tags on the SemVer is the build number.
Below are all of the keys contained in the metadata file and some example values that can be present.
Expand Down Expand Up @@ -428,7 +429,7 @@ Example values: [`202008210941`, `202010120348`, `202007272039`]
- `scmRef:`
Example values: [`dragonwell-8.4.4_jdk8u262-b10`, `jdk-16+19_adopt-61198-g59e3baa94ac`, `jdk-11.0.9+10_adopt-197-g11f44f68c5`, `23f997ca1`]
A reference the the base JDK repository being build, usually including a Github commit reference, i.e. `jdk-16+19_adopt-61198-g59e3baa94ac` links to `https://github.com/adoptium/openjdk-jdk/commit/59e3baa94ac` via the commit SHA **59e3baa94ac**.
A reference the the base JDK repository being build, usually including a GitHub commit reference, i.e. `jdk-16+19_adopt-61198-g59e3baa94ac` links to `https://github.com/adoptium/openjdk-jdk/commit/59e3baa94ac` via the commit SHA **59e3baa94ac**.
Values that only contain a commit reference such as `23f997ca1` are OpenJ9 commits on their respective JDK repositories, for example **23f997ca1** links to the commit `https://github.com/ibmruntimes/openj9-openjdk-jdk14/commit/23f997ca1.`
Expand Down
Loading

0 comments on commit 12c9e94

Please sign in to comment.