Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update documentation for jextract #767

Closed
keithc-ca opened this issue Apr 9, 2021 · 2 comments · Fixed by #770
Closed

Update documentation for jextract #767

keithc-ca opened this issue Apr 9, 2021 · 2 comments · Fixed by #770
Milestone
Release 0.26 (Jav...

Comments

@keithc-ca
Copy link
Contributor

Overview:
The jextract command is deprecated; the replacement is jpackcore.

Release target:
Eclipse OpenJ9 0.26.0

See eclipse-openj9/openj9#11278.
@keithc-ca keithc-ca mentioned this issue Apr 9, 2021
Merged
@SueChaplain
Copy link
Contributor

@keithc-ca, based on your comment I some questions:

The plan is that jpackcore will be equivalent to (i.e. an alias for) jextract in all versions of Java where openjdk does not provide a different tool named jextract. Then you will be able to use jpackcore in any (recent) build independent of whether jextract means the same thing.

  • we announce as deprecated in 0.26.0, to be removed in a future release, but do not mention jpackcore
  • we document jpackcore for all releases when?
  • in 0.28.0, we mark jextract original as 8 & 11 only in the docs and leave it there until when? EOS on OpenJDK 11?
  • in 0.28.0, we introduce a new jextract for 17+ for Panama

@keithc-ca
Copy link
Contributor Author

We can announce jpackcore in 0.26 for all releases.
When the Panama variant of jextract is released (17?) it will replace the openj9 tool that had that name.
I see no value in removing jextract from 8 or 11.
To be clear, 'we' are not introducing the new jextract, it will come from openjdk upstream.

SueChaplain added a commit to SueChaplain/openj9-docs that referenced this issue Apr 12, 2021
@SueChaplain
Deprecate jextract, replace with jpackcore
cd4ffae 
- Added info to the release topic about deprecating jextract
- Changed the references in the jextract topic to jpackcore, including a note about jextract deprecation
- Found and updated other references to jextract in the docs.

Closes: eclipse-openj9#767

Signed-off-by: SueChaplain <[email protected]>
@SueChaplain SueChaplain mentioned this issue Apr 12, 2021
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
Release 0.26 (Java 8, 11, 16) Apr ref...
Development

Successfully merging a pull request may close this issue.

Deprecate jextract, replace with jpackcore SueChaplain/openj9-docs
2 participants
@keithc-ca @SueChaplain