update changelog for manpage updates

[sven/java-package.git] / make-jpkg.1

diff --git a/make-jpkg.1 b/make-jpkg.1
index 96c30a02a1005d20eb1e66067178b624502383be..e8af5a79863ead47b19905113fdd7e8ea3a22094 100644 (file)
--- 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 "January 22, 2012"
+.TH MAKE-JPKG 1 "September 10, 2016"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -16,20 +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 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 the given Java
+\fBmake-jpkg\fP builds a Debian package from the given Java
 distribution FILE.
-This program works currently with the following Java REs, SDKs and APIs archive files:
- Oracle(TM) 6 Standard Edition (starting with update 10)
- Oracle(TM) 7 Standard Edition
+.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
@@ -39,44 +43,58 @@ 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 --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.
 .B --help
 display help text and exit
 .TP
 .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
-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) 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:
+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-7u2-linux-x64.tar.gz
+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-j2sdk1.7_1.7.0+update2_amd64.deb
+dpkg \-i oracle-java8-jdk_8u102_amd64.deb
 .PP
-When you're done, you can remove initial download as well as generated package:
+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-j2sdk1.7_1.7.0+update2_amd64.deb
+rm <path_to_download_directory>/jdk-8u102-linux-x64.tar.gz oracle-java8-jdk_8u102_amd64.deb
 .PP
 .SH ENVIRONMENT
 .TP