Updated the manpages for Java 8
[sven/java-package.git] / make-jpkg.1
index 62108ee..9575561 100644 (file)
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH MAKE-JPKG 1 "November 04, 2005"
+.TH MAKE-JPKG 1 "January 22, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -16,7 +16,7 @@
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-make-jpkg \- build Debian packages from Java binary distributions
+make-jpkg \- builds Debian packages from Java binary distributions
 .SH SYNOPSIS
 .B make-jpkg
 [\fIOPTION\fR]... [\fIFILE\fR]
@@ -25,10 +25,15 @@ make-jpkg \- build Debian packages from Java binary distributions
 .\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
 .\" respectively.
 .PP
-\fBmake-jpkg\fP creates a Debian package from a Java
-distribution. This program works currently with the following Java REs, SDKs and APIs:
- Oracle(TM) 1.6 Standard Edition (starting with update 10)
- Oracle(TM) 1.7 Standard Edition
+\fBmake-jpkg\fP builds a Debian package from the given Java
+distribution FILE.
+.PP
+Supported java binary distributions currently include:
+  * Oracle (http://www.oracle.com/technetwork/java/javase/downloads) :
+    - The Java Development Kit (JDK), version 6, 7 and 8
+    - The Java Runtime Environment (JRE), version 6, 7 and 8
+    - The Java API Javadoc, version 6, 7 and 8
+  (Choose tar.gz archives or self-extracting archives, do _not_ choose the RPM!)
 .PP
 The following options are recognized:
 .TP
@@ -50,13 +55,13 @@ display help text and exit
 .B --version
 output version information and exit
 .PP
-Download a supported Java RE or SDK or API tar.gz or self-extracting archive from
+Download a supported JRE, JDK, API tar.gz or self-extracting archive from
 .B http://www.oracle.com/technetwork/java/javase/downloads
 and execute
 .B make-jpkg
 .I file
 with the downloaded file. The program asks the user for additional
-information and creates a Debian binary package in the current
+information and builds a Debian binary package in the current
 directory.
 .PP
 The program requires about 200 MB free disk space in a temporary
@@ -64,6 +69,19 @@ directory. The temporary directory defaults to
 .I /tmp
 but you can specify an alternate directory by setting the environment
 variable \fITMPDIR\fR.
+.SH EXAMPLE
+To install Oracle(TM) 7 Standard Edition JDK, download a release - 64 bits version of update 2 from http://www.oracle.com/technetwork/java/javase/downloads/jdk-7u2-download-1377129.html in this example - and invoke make-jpkg:
+.IP
+make-jpkg <path_to_download_directory>/jdk-7u2-linux-x64.tar.gz
+.PP
+This generate a Debian package in the current directory, that can be installed using dpkg:
+.IP
+dpkg \-i oracle-java7-jdk_7u2_amd64.deb
+.PP
+When you're done, you can delete initial download as well as generated package:
+.IP
+rm <path_to_download_directory>/jdk-7u2-linux-x64.tar.gz oracle-java7-jdk_7u2_amd64.deb
+.PP
 .SH ENVIRONMENT
 .TP
 .SM TMPDIR
@@ -76,6 +94,8 @@ then the default of "Debian Java Maintainers" is used.
 .SM J2SE_PACKAGE_EMAIL
 email address used in the maintainer field of the package; if none is supplied
 the default of "pkg-java-maintainers@lists.alioth.debian.org" is used.
+.SH SEE ALSO
+.BR update-java-alternatives(1)
 .SH AUTHOR
 This manual page was written by Hubert Schmid <j2se-package@z42.de>.