X-Git-Url: http://git.sven.stormbind.net/?p=sven%2Fjava-package.git;a=blobdiff_plain;f=make-jpkg.1;h=34a5462f052befe0d0b46411a2f968d7649cd4c5;hp=dee5358f14d1984acc3b9fc88d4a5e714bfb47bf;hb=a87614986d49e2eac20bd8fa0b8df85a5419fa46;hpb=ca8b5d176518ea838461b92229d2fbebb3731de8

diff --git a/make-jpkg.1 b/make-jpkg.1
index dee5358..34a5462 100644
--- a/make-jpkg.1
+++ b/make-jpkg.1
@@ -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 "September 10, 2016"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -16,19 +16,24 @@
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-make-jpkg \- build Debian packages from Java(TM) 2 binary distributions
+make-jpkg \- builds Debian packages from Java binary distributions
 .SH SYNOPSIS
 .B make-jpkg
 [\fIOPTION\fR]... [\fIFILE\fR]
 .SH DESCRIPTION
 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
 .\" respectively.
 .PP
-\fBmake-jpkg\fP creates a Debian package from a Java(TM) 2
-distribution. This program works currently with the following Java(TM) 2 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
@@ -38,32 +43,66 @@ full name used in the maintainer field of the package
 .B --email \fIEMAIL\fR
 email address used in the maintainer field of the package
 .TP
+.B --distribution \fIDISTRIBUTION\fR
+distribution to use in the debian changelog for the resulting package
+.TP
+.B --priority \fIPRIORITY\fR
+numeric priority for use by \fBupdate-alternatives\fP.  This overrides the default
+priority, which is intentionally lower than that of the Debian-provided OpenJDK
+packages.  Only use this option if the generated package should be considered higher
+priority by \fBupdate-alternatives\fP.
+.TP
 .B --changes
 create a .changes file
 .TP
 .B --revision
 add debian revision
 .TP
+.B --source
+build a source package instead of a binary deb package
+.TP
+.B --with-system-certs
+Replace the JVMs keystore with a softlink to the system's keystore,
+(/etc/ssl/certs/java/cacerts) which is managed automatically by the
+ca-certificates and ca-certificates-java packages.
+.TP
+.B --jce-policy \fIJCE_POLICY_FILE\fR
+Replace cryptography files with versions
+from the specified JCE_POLICY_FILE.
+.TP
 .B --help
 display help text and exit
 .TP
 .B --version
 output version information and exit
 .PP
-Download a supported Java(TM) 2 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
-directory. The temporary directory defaults to 
+The program requires about 400 MB free disk space in a temporary
+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) 8 Standard Edition JDK, download a release from http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html and invoke make-jpkg, for example:
+.IP
+make-jpkg <path_to_download_directory>/jdk-8u102-linux-x64.tar.gz
+.PP
+This generate a Debian package in the current directory, that can be installed using dpkg:
+.IP
+dpkg \-i oracle-java8-jdk_8u102_amd64.deb
+.PP
+When you're done, you can delete initial download as well as generated package:
+.IP
+rm <path_to_download_directory>/jdk-8u102-linux-x64.tar.gz oracle-java8-jdk_8u102_amd64.deb
+.PP
 .SH ENVIRONMENT
 .TP
 .SM TMPDIR
@@ -76,6 +115,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>.