PR#161: Fix Issues Installing Java quick-docs - fedora-docs/quick-docs

fedora-docs / quick-docs

#161 Fix Issues Installing Java quick-docs

Merged 4 years ago by pbokoc. Opened 4 years ago by hhlp.

Unknown source java into master

Fix Issues Installing Java quick-docs

Héctor Louzao • 4 years ago

4862730

modules/ROOT/pages/_partials/proc_installing-openjdk.adoc

file modified

+8 -22

		`@@ -4,38 +4,24 @@`
		`To install OpenJDK from the Fedora repository:`

		`. Run the following command to list available versions:`
		`- +`
		`+`
		`----`
		`$ dnf search openjdk`
		`----`
		`+`
		`. Copy the version of OpenJDK you want to install.`
		`- +`
		`+`
		`[NOTE]`
		`- ====`
		`Various flavors of OpenJDK are available. For information about these options, search the link:http://openjdk.java.net/[OpenJDK web site].`
		`- ====`
		`- +`
		`- . Run the following command to install OpenJDK:`
		`- +`
		`+`
		`+ * Run the following command to install OpenJDK:`
		`+`
		`----`
		`# dnf install <openjdk-package-name>`
		`----`
		`- +`
		`- For example:`
		`- +`
		`- ----`
		`- # dnf install java-1.8.0-openjdk.x86_64`
		`- ----`

		`- // tag::java-alternatives[]`
		`- [NOTE]`
		`- ====`
		`- If you have installed other versions of Java, you might need to switch the active version of Java:`
		`+ For example:`

		`----`
		`- # alternatives --config java`
		`+ # dnf install java-{1.8.0\|11\|latest}-openjdk.x86_64`
		`----`
		`-`
		`- A list of installed Java versions is displayed. Choose the version you require.`
		`- ====`
		`- // end::java-alternatives[]`

modules/ROOT/pages/_partials/proc_installing-oracle-java.adoc

file modified

+26 -7

		`@@ -1,18 +1,37 @@`
		`[id='installing-oracle-java-se']`
		`= Installing Oracle Java SE`

		`- To install Oracle Java SE:`
		`+ include::{partialsdir}/3rdparty-message.adoc[]`

		`- . Navigate to link:http://www.oracle.com/technetwork/java/javase/downloads[Oracle Java SE downloads page].`
		`+ To install Oracle Java SE:`

		`- . Choose the version of Java you wish to use. Typically, you would navigate to the link:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html[version 8 page].`
		`+ . Navigate to link:http://www.oracle.com/technetwork/java/javase/downloads[Oracle Java SE downloads page], and`
		`+ choose the version of Java you wish to use.`

		`. Accept the license agreement and download the appropriate tar.gz file for your systems architecture. Do NOT use Oracle rpms as these are NOT compatible with fedora/openjdk packages. Download tar.gz instead and unpack it somewhere.`

		`- . Use tar to unpack downloaded archive e.g.:`
		`- +`
		+ . Use `DNF` to install it the downloaded version e.g.:
		`+`
		`+ ----`
		`+ sudo dnf install version-downloaded.rpm`
		`+ ----`
		`+`
		`+ Note: Always make sure to download latest version available.`
		`+`
		`+ == Switching between Java Versions`
		`+`
		`+ You might have installed several versions of Java on your system, you can switch from one`
		`+`
		`+ After running this command, you will see a a list of all installed Java versions, select t`
		`+`
		`----`
		`- # tar -xvzf jdk-8u201-linux-x64.tar.gz`
		`+ sudo alternatives --config java`
		`----`

		`- Note that jdk-8u201-linux-x64.tar.gz is used as example only. Always make sure to download latest version available.`
		`+ Simply enter a selection number to choose which java executable should be used by default.`
		`+`
		`+ * verify:`
		`+`
		`+ ----`
		`+ java --Versions`
		`+ ----`

modules/ROOT/pages/installing-java.adoc

file modified

+9 -1

		`@@ -17,6 +17,14 @@`
		`* Oracle Java SE -- a free JDK from Oracle.`
		`This version is not open-source and we recommend that it only be used if OpenJDK is not sufficient.`

		`+ You can find the following Versions:`
		`+`
		`+ * Version (Ex. 8)`
		`+`
		+ * Long Term Support or `LTS`
		`+`
		`+ * Latest`
		`+`
		`include::{partialsdir}/proc_installing-openjdk.adoc[leveloffset=+1]`

		`include::{partialsdir}/proc_installing-oracle-java.adoc[leveloffset=+1]`
		`@@ -31,7 +39,7 @@`

		`* link:https://admin.fedoraproject.org/mailman/listinfo/java-devel[java-devel mailing list]`
		`* Freenode IRC channel link:irc://irc.freenode.net/fedora-java[#fedora-java]`
		`- * link:https://Ask.FedoraProject.org/en/questions/scope:all/sort:activity-desc/tags:java/page:1/[Ask Fedora about Java]`
		`+ * link:https://ask.fedoraproject.org/tags/java[Ask Fedora about Java]`

		`For more information about Java in general, see:`

hhlp commented 4 years ago

What this change accomplishes:

Ask Fedora about Java -> point out to https://ask.fedoraproject.org/en/questions/scope:all/sort:activity-desc/tags:java/page:1/ instead of https://ask.fedoraproject.org/tags/java
Add it switch between Version
Add Version, LTS, and Latest
Where this premise come from? Do NOT use Oracle rpms as these are NOT compatible with fedora/openjdk packages, actually is very well compatible and works with fedora rpm format package, and I install it without any problem or message...

[Ticket: #160 ]