src/jdk.pack/share/man/unpack200.1

@@ -1,7 +1,6 @@
-'\" t
-.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
+.\" Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 .\"
 .\" This code is free software; you can redistribute it and/or modify it
 .\" under the terms of the GNU General Public License version 2 only, as
 .\" published by the Free Software Foundation.

@@ -18,120 +17,110 @@
 .\"
 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 .\" or visit www.oracle.com if you need additional information or have any
 .\" questions.
 .\"
-.\"     Arch: generic
-.\"     Software: JDK 8
-.\"     Date: 21 November 2013
-.\"     SectDesc: Java Deployment Tools
-.\"     Title: unpack200.1
-.\"
-.if n .pl 99999
-.TH unpack200 1 "21 November 2013" "JDK 8" "Java Deployment Tools"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-
+.\" Automatically generated by Pandoc 2.3.1
+.\"
+.TH "UNPACK200" "1" "2018" "JDK 13" "JDK Commands"
+.hy
 .SH NAME    
-unpack200 \- Transforms a packed file produced by pack200(1) into a JAR file for web deployment\&.
+.PP
+unpack200 \- transform a packed file into a JAR file for web deployment
 .SH SYNOPSIS    
-.sp     
-.nf     
-
-\fBunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR
-.fi     
-.sp     
+.PP
+\f[CB]unpack200\f[R] [\f[I]options\f[R]] \f[I]input\-file\f[R]
+\f[I]JAR\-file\f[R]
 .TP     
-\fIoptions\fR
-The command-line options\&. See Options\&.
+.B \f[I]options\f[R]
+The command\-line options.
+See \f[B]Options for the unpack200 Command\f[R].
+.RS
+.RE
 .TP     
-\fIinput-file\fR
-Name of the input file, which can be a pack200 gzip file or a pack200 file\&. The input can also be JAR file produced by \f3pack200\fR(1) with an effort of \f30\fR, in which case the contents of the input file are copied to the output JAR file with the Pack200 marker\&.
+.B \f[I]input\-file\f[R]
+Name of the input file, which can be a \f[CB]pack200\ gzip\f[R] file or a
+\f[CB]pack200\f[R] file.
+The input can also be a JAR file produced by \f[CB]pack200\f[R] with an
+effort of \f[CB]0\f[R], in which case the contents of the input file are
+copied to the output JAR file with the \f[CB]pack200\f[R] marker.
+.RS
+.RE
 .TP     
-\fIJAR-file\fR
-Name of the output JAR file\&.
+.B \f[I]JAR\-file\f[R]
+Name of the output JAR file.
+.RS
+.RE
 .SH DESCRIPTION    
-The \f3unpack200\fR command is a native implementation that transforms a packed file produced by \f3pack200\fR\f3(1)\fR into a JAR file\&. A typical usage follows\&. In the following example, the \f3myarchive\&.jar\fR file is produced from \f3myarchive\&.pack\&.gz\fR with the default \f3unpack200\fR command settings\&.
-.sp     
-.nf     
-\f3unpack200 myarchive\&.pack\&.gz myarchive\&.jar\fP
-.fi     
-.nf     
-\f3\fP
-.fi     
-.sp     
-.SH OPTIONS    
-.TP
--Hvalue --deflate-hint=\fIvalue\fR
-.br
-Sets the deflation to be \f3true\fR, \f3false\fR, or \f3keep\fR on all entries within a JAR file\&. The default mode is \f3keep\fR\&. If the value is \f3true\fR or \f3false\fR, then the \f3--deflate=hint\fR option overrides the default behavior and sets the deflation mode on all entries within the output JAR file\&.
-.TP
--r --remove-pack-file
-.br
-Removes the input pack file\&.
-.TP
--v --verbose
-.br
-Displays minimal messages\&. Multiple specifications of this option displays more verbose messages\&.
-.TP
--q --quiet
-.br
-Specifies quiet operation with no messages\&.
-.TP
--lfilename --log-file=\fIfilename\fR
-.br
-Specifies a log file where output messages are logged\&.
-.TP
--? -h --help
-.br
-Prints help information about the \f3unpack200\fR command\&.
-.TP
--V --version
-.br
-Prints version information about the \f3unpack200\fR command\&.
-.TP
--J\fIoption\fR
-.br
-Passes option to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
+.PP
+The \f[CB]unpack200\f[R] command is a native implementation that
+transforms a packed file produced by the \f[CB]pack200\f[R] into a JAR
+file for web deployment.
+An example of typical usage follows.
+In the following example, the \f[CB]myarchive.jar\f[R] file is produced
+from \f[CB]myarchive.pack.gz\f[R] with the default \f[CB]unpack200\f[R]
+command settings.
+.RS
+.PP
+\f[CB]unpack200\ myarchive.pack.gz\ myarchive.jar\f[R]
+.RE
+.SH OPTIONS FOR THE UNPACK200 COMMAND
+.TP
+.B \f[CB]\-H\f[R]\f[I]value\f[R] or \f[CB]\-\-deflate\-hint=\f[R]\f[I]value\f[R]
+Sets the deflation to be \f[CB]true\f[R], \f[CB]false\f[R], or \f[CB]keep\f[R]
+on all entries within a JAR file.
+The default mode is \f[CB]keep\f[R].
+If the value is \f[CB]true\f[R] or \f[CB]false\f[R], then the
+\f[CB]\-\-deflate=hint\f[R] option overrides the default behavior and sets
+the deflation mode on all entries within the output JAR file.
+.RS
+.RE
+.TP
+.B \f[CB]\-r\f[R] or \f[CB]\-\-remove\-pack\-file\f[R]
+Removes the input pack file.
+.RS
+.RE
+.TP
+.B \f[CB]\-v\f[R] or \f[CB]\-\-verbose\f[R]
+Displays minimal messages.
+Multiple specifications of this option displays more verbose messages.
+.RS
+.RE
+.TP
+.B \f[CB]\-q\f[R] or \f[CB]\-\-quiet\f[R]
+Specifies quiet operation with no messages.
+.RS
+.RE
+.TP
+.B \f[CB]\-l\f[R] \f[I]filename\f[R] or \f[CB]\-\-log\-file=\f[R]\f[I]filename\f[R]
+Specifies a log file where output messages are logged.
+.RS
+.RE
+.TP
+.B \f[CB]\-?\f[R] or \f[CB]\-h\f[R] or \f[CB]\-\-help\f[R]
+Prints help information about the \f[CB]unpack200\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-V\f[R] or \f[CB]\-\-version\f[R]
+Prints version information about the \f[CB]unpack200\f[R] command.
+.RS
+.RE
+.TP
+.B \f[CB]\-J\f[R]\f[I]option\f[R]
+Passes \f[I]option\f[R] to the Java Virtual Machine, where
+\f[CB]option\f[R] is one of the options described on the reference page
+for the Java application launcher.
+For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.
+.RS
+.RE
 .SH NOTES    
-This command should not be confused with the \f3unpack\fR command\&. They are distinctly separate products\&.
 .PP
-The Java SE API Specification provided with the JDK is the superseding authority in case of discrepancies\&.
-.SH EXIT\ STATUS    
-The following exit values are returned: 0 for successful completion, and a value that is greater than 0 when an error occurred\&.
-.SH SEE\ ALSO    
-.TP 0.2i    
-\(bu
-pack200(1)
-.TP 0.2i    
-\(bu
-jar(1)
-.TP 0.2i    
-\(bu
-jarsigner(1)
-.TP 0.2i    
-\(bu
-Pack200 and Compression at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment-guide/pack200\&.html
-.TP 0.2i    
-\(bu
-The Java SE Technical Documentation page at http://docs\&.oracle\&.com/javase/
-.RE
-.br
-'pl 8.5i
-'bp
+This command shouldn\[aq]t be confused with the \f[CB]unpack\f[R] command.
+They\[aq]re distinctly separate products.
+.PP
+The Java SE API Specification provided with the JDK is the superseding
+authority in case of discrepancies.
+.SH EXIT STATUS
+.PP
+The following exit values are returned: 0 for successful completion, and
+a value that is greater than 0 when an error occurred.