--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/bsd/doc/man/jdeps.1 Mon Nov 25 20:19:02 2013 -0800
@@ -0,0 +1,532 @@
+'\" t
+.\" Copyright (c) 2013, 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.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" 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: Basic Tools
+.\" Title: jdeps.1
+.\"
+.if n .pl 99999
+.TH jdeps 1 "21 November 2013" "JDK 8" "Basic 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 *
+.\" -----------------------------------------------------------------
+
+.SH NAME
+jdeps \- Java class dependency analyzer\&.
+.SH SYNOPSIS
+.sp
+.nf
+
+\fBjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&.
+.fi
+.sp
+.TP
+\fIoptions\fR
+Command-line options\&. See Options\&.
+.TP
+\fIclass\fR\fIes\fR
+Name of the classes to analyze\&. You can specify a class that can be found in the class path, by its file name, a directory, or a JAR file\&.
+.SH DESCRIPTION
+The \fI\fR\f3jdeps\fR command shows the package-level or class-level dependencies of Java class files\&. The input class can be a path name to a \f3\&.class\fR file, a directory, a JAR file, or it can be a fully qualified class name to analyze all class files\&. The options determine the output\&. By default, \f3jdeps\fR outputs the dependencies to the system output\&. It can generate the dependencies in DOT language (see the \f3-dotoutput\fR option)\&.
+.SH OPTIONS
+.TP
+-dotoutput <\fIdir\fR>
+.br
+Destination directory for DOT file output\&. If specified, \f3jdeps\fR will generate one dot file per each analyzed archive named <\fIarchive-file-name\fR>\&.dot listing the dependencies, and also a summary file named summary\&.dot listing the dependencies among the archives\&.
+.TP
+-s, -summary
+.br
+Prints dependency summary only\&.
+.TP
+-v, -verbose
+.br
+Prints all class-level dependencies\&.
+.TP
+-verbose:package
+.br
+Prints package-level dependencies excluding dependencies within the same archive\&.
+.TP
+-verbose:class
+.br
+Prints class-level dependencies excluding dependencies within the same archive\&.
+.TP
+-cp <\fIpath\fR>, -classpath <\fIpath\fR>
+.br
+Specifies where to find class files\&.
+
+See also Setting the Class Path\&.
+.TP
+-p <\fIpkg name\fR>, -package <\fIpkg name\fR>
+.br
+Finds dependencies in the specified package\&. You can specify this option multiple times for different packages\&. The \f3-p\fR and \f3-e\fR options are mutually exclusive\&.
+.TP
+-e <\fIregex\fR>, -regex <\fIregex\fR>
+.br
+Finds dependencies in packages matching the specified regular expression pattern\&. The \f3-p\fR and \f3-e\fR options are mutually exclusive\&.
+.TP
+-include <\fIregex\fR>
+.br
+Restricts analysis to classes matching pattern\&. This option filters the list of classes to be analyzed\&. It can be used together with \f3-p\fR and \f3-e\fR which apply pattern to the dependencies\&.
+.TP
+-P, -profile
+.br
+Shows profile or the file containing a package\&.
+.TP
+-apionly
+.br
+Restricts analysis to APIs, for example, dependences from the signature of \f3public\fR and \f3protected\fR members of public classes including field type, method parameter types, returned type, and checked exception types\&.
+.TP
+-R, -recursive
+.br
+Recursively traverses all dependencies\&.
+.TP
+-version
+.br
+Prints version information\&.
+.TP
+-h, -?, -help
+.br
+Prints help message for \f3jdeps\fR\&.
+.SH EXAMPLES
+Analyzing the dependencies of Notepad\&.jar\&.
+.sp
+.nf
+\f3$ jdeps demo/jfc/Notepad/Notepad\&.jar\fP
+.fi
+.nf
+\f3\fP
+.fi
+.nf
+\f3demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar\fP
+.fi
+.nf
+\f3 <unnamed> (Notepad\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.awt \fP
+.fi
+.nf
+\f3 \-> java\&.awt\&.event \fP
+.fi
+.nf
+\f3 \-> java\&.beans \fP
+.fi
+.nf
+\f3 \-> java\&.io \fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3 \-> java\&.net \fP
+.fi
+.nf
+\f3 \-> java\&.util \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.logging \fP
+.fi
+.nf
+\f3 \-> javax\&.swing \fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.border \fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.event \fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.text \fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.tree \fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.undo \fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+Use -P or -profile option to show on which profile that Notepad depends\&.
+.sp
+.nf
+\f3$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar \fP
+.fi
+.nf
+\f3demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE)\fP
+.fi
+.nf
+\f3 <unnamed> (Notepad\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.awt Full JRE\fP
+.fi
+.nf
+\f3 \-> java\&.awt\&.event Full JRE\fP
+.fi
+.nf
+\f3 \-> java\&.beans Full JRE\fP
+.fi
+.nf
+\f3 \-> java\&.io compact1\fP
+.fi
+.nf
+\f3 \-> java\&.lang compact1\fP
+.fi
+.nf
+\f3 \-> java\&.net compact1\fP
+.fi
+.nf
+\f3 \-> java\&.util compact1\fP
+.fi
+.nf
+\f3 \-> java\&.util\&.logging compact1\fP
+.fi
+.nf
+\f3 \-> javax\&.swing Full JRE\fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.border Full JRE\fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.event Full JRE\fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.text Full JRE\fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.tree Full JRE\fP
+.fi
+.nf
+\f3 \-> javax\&.swing\&.undo Full JRE\fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+Analyzing the immediate dependencies of a specific class in a given classpath, for example the \f3com\&.sun\&.tools\&.jdeps\&.Main\fR class in the tools\&.jar file\&.
+.sp
+.nf
+\f3$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fP
+.fi
+.nf
+\f3lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fP
+.fi
+.nf
+\f3 com\&.sun\&.tools\&.jdeps (tools\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.io \fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+Use the \f3-verbose:class\fR option to find class-level dependencies or use the \f3-v\fR or \f3-verbose\fR option to include dependencies from the same JAR file\&.
+.sp
+.nf
+\f3$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fP
+.fi
+.nf
+\f3\fP
+.fi
+.nf
+\f3lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fP
+.fi
+.nf
+\f3 com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.io\&.PrintWriter \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.Exception \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.Object \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.String \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.System \fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+Use the \f3-R\fR or \f3-recursive\fR option to analyze the transitive dependencies of the \f3com\&.sun\&.tools\&.jdeps\&.Main\fR class\&.
+.sp
+.nf
+\f3$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fP
+.fi
+.nf
+\f3lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fP
+.fi
+.nf
+\f3 com\&.sun\&.tools\&.classfile (tools\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.io \fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.reflect \fP
+.fi
+.nf
+\f3 \-> java\&.nio\&.charset \fP
+.fi
+.nf
+\f3 \-> java\&.nio\&.file \fP
+.fi
+.nf
+\f3 \-> java\&.util \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.regex \fP
+.fi
+.nf
+\f3 com\&.sun\&.tools\&.jdeps (tools\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.io \fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3 \-> java\&.nio\&.file \fP
+.fi
+.nf
+\f3 \-> java\&.nio\&.file\&.attribute \fP
+.fi
+.nf
+\f3 \-> java\&.text \fP
+.fi
+.nf
+\f3 \-> java\&.util \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.jar \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.regex \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.zip \fP
+.fi
+.nf
+\f3/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar\fP
+.fi
+.nf
+\f3 javax\&.crypto (jce\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.io \fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3 \-> java\&.lang\&.reflect \fP
+.fi
+.nf
+\f3 \-> java\&.net \fP
+.fi
+.nf
+\f3 \-> java\&.nio \fP
+.fi
+.nf
+\f3 \-> java\&.security \fP
+.fi
+.nf
+\f3 \-> java\&.security\&.cert \fP
+.fi
+.nf
+\f3 \-> java\&.security\&.spec \fP
+.fi
+.nf
+\f3 \-> java\&.util \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.concurrent \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.jar \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.regex \fP
+.fi
+.nf
+\f3 \-> java\&.util\&.zip \fP
+.fi
+.nf
+\f3 \-> javax\&.security\&.auth \fP
+.fi
+.nf
+\f3 \-> sun\&.security\&.jca JDK internal API (rt\&.jar)\fP
+.fi
+.nf
+\f3 \-> sun\&.security\&.util JDK internal API (rt\&.jar)\fP
+.fi
+.nf
+\f3 javax\&.crypto\&.spec (jce\&.jar)\fP
+.fi
+.nf
+\f3 \-> java\&.lang \fP
+.fi
+.nf
+\f3 \-> java\&.security\&.spec \fP
+.fi
+.nf
+\f3 \-> java\&.util \fP
+.fi
+.nf
+\f3/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar\fP
+.fi
+.nf
+\f3 java\&.security (rt\&.jar)\fP
+.fi
+.nf
+\f3 \-> javax\&.crypto\fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+Generate dot files of the dependencies of Notepad demo\&.
+.sp
+.nf
+\f3$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar\fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+\f3jdeps\fR will create one dot file for each given JAR file named <\fIfilename\fR>\&.dot in the dot directory specified in the \f3-dotoutput\fR option, and also a summary file named summary\&.dot that will list the dependencies among the JAR files
+.sp
+.nf
+\f3$ cat dot/Notepad\&.jar\&.dot \fP
+.fi
+.nf
+\f3digraph "Notepad\&.jar" {\fP
+.fi
+.nf
+\f3 // Path: demo/jfc/Notepad/Notepad\&.jar\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.awt";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.awt\&.event";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.beans";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.io";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.lang";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.net";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.util";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "java\&.util\&.logging";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing\&.border";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing\&.event";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing\&.text";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing\&.tree";\fP
+.fi
+.nf
+\f3 "<unnamed>" \-> "javax\&.swing\&.undo";\fP
+.fi
+.nf
+\f3}\fP
+.fi
+.nf
+\f3\fP
+.fi
+.nf
+\f3$ cat dot/summary\&.dot\fP
+.fi
+.nf
+\f3digraph "summary" {\fP
+.fi
+.nf
+\f3 "Notepad\&.jar" \-> "rt\&.jar";\fP
+.fi
+.nf
+\f3}\fP
+.fi
+.nf
+\f3\fP
+.fi
+.sp
+.SH SEE\ ALSO
+.TP 0.2i
+\(bu
+javap(1)
+.RE
+.br
+'pl 8.5i
+'bp