8060151: Check-in changes for 8u40 nroff Open JDK
Reviewed-by: mcimadamore, kvn
diff --git a/src/bsd/doc/man/javadoc.1 b/src/bsd/doc/man/javadoc.1
index b48535a..f4b342b 100644
--- a/src/bsd/doc/man/javadoc.1
+++ b/src/bsd/doc/man/javadoc.1
@@ -1,5 +1,5 @@
'\" t
-.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.
+.\" Copyright (c) 1994, 2015, Oracle and/or its affiliates. All rights reserved.
.\"
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
@@ -23,12 +23,12 @@
.\"
.\" Arch: generic
.\" Software: JDK 8
-.\" Date: 10 May 2011
+.\" Date: 03 March 2015
.\" SectDesc: Basic Tools
.\" Title: javadoc.1
.\"
.if n .pl 99999
-.TH javadoc 1 "10 May 2011" "JDK 8" "Basic Tools"
+.TH javadoc 1 "03 March 2015" "JDK 8" "Basic Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -209,7 +209,7 @@
\f3package java\&.lang\&.applet;\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -251,7 +251,7 @@
\f3initialize, start, and stop the applet\&. \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3@since 1\&.0 \fP
@@ -266,7 +266,7 @@
\f3</HTML>\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The \f3package\&.html\fR file is a typical HTML file and does not include a package declaration\&. The content of the package comment file is written in HTML with one exception\&. The documentation comment should not include the comment separators \f3/**\fR and \f3*/\fR or leading asterisks\&. When writing the comment, make the first sentence a summary about the package, and do not put a title or any other text between the \f3<body>\fR tag and the first sentence\&. You can include package tags\&. All block tags must appear after the main description\&. If you add an \f3@see\fR tag in a package comment file, then it must have a fully qualified name\&.
@@ -334,7 +334,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SS TEST\ AND\ TEMPLATE\ FILES
@@ -350,7 +350,7 @@
\f3com/package1/test\-files/\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
If your test files contain documentation comments, then you can set up a separate run of the \f3javadoc\fR command to produce test file documentation by passing in their test source file names with wild cards, such as \f3com/package1/test-files/*\&.java\fR\&.
@@ -560,7 +560,7 @@
\f3implements Serializable\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The declaration for the \f3Boolean\&.valueOf\fR method is:
@@ -569,7 +569,7 @@
\f3public static Boolean valueOf(String s)\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The \f3javadoc\fR command can include the modifiers \f3public\fR, \f3protected\fR, \f3private\fR, \f3abstract\fR, \f3final\fR, \f3static\fR, \f3transient\fR, and \f3volatile\fR, but not \f3synchronized\fR or \f3native\fR\&. The \f3synchronized\fR and \f3native\fR modifiers are considered implementation detail and not part of the API specification\&.
@@ -593,7 +593,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
To save space you can put a comment on one line:
@@ -602,7 +602,7 @@
\f3/** This comment takes up only one line\&. */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -623,19 +623,19 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3import com\&.example; // MISTAKE \- Important not to put import statement here\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3public class Whatever{ }\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -657,7 +657,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -676,7 +676,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -700,7 +700,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -730,7 +730,7 @@
\f3public int x, y; // Avoid this \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The \f3javadoc\fR command generates the following documentation from the previous code:
@@ -739,7 +739,7 @@
\f3public int x\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The horizontal and vertical distances of point (x, y)\&.
@@ -748,7 +748,7 @@
\f3public int y\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The horizontal and vertical distances of point (x, y)\&.
@@ -872,7 +872,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -899,11 +899,10 @@
.TP 0.2i
\(bu
In the text arguments of the \f3@return\fR, \f3@param,\fR and \f3@throws\fR tags of a method\&. In this case, the tag text is copied from the corresponding tag up the hierarchy\&.
-.RE
-.RS
-See Method Comment Inheritance for a description of how comments are found in the inheritance hierarchy\&. Note that if this tag is missing, then the comment is or is not automatically inherited according to rules described in that section\&.
+.RE
-.RE
+
+See Method Comment Inheritance for a description of how comments are found in the inheritance hierarchy\&. Note that if this tag is missing, then the comment is or is not automatically inherited according to rules described in that section\&.
.TP
{@link \fIpackage\&.class#member label\fR}
Introduced in JDK 1\&.2
@@ -920,7 +919,7 @@
\f3Use the {@link #getComponentAt(int, int) getComponentAt} method\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -931,7 +930,7 @@
\f3Use the <a href="Component\&.html#getComponentAt(int, int)">getComponentAt</a> method\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -942,7 +941,7 @@
\f3Use the getComponentAt method\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -982,7 +981,7 @@
\f3}\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1014,7 +1013,7 @@
\f3}\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1071,7 +1070,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1091,7 +1090,7 @@
\f3</dl>\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1128,7 +1127,7 @@
\f3@see #constructor(Type argname, Type argname,\&.\&.\&.) \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3\fIReferencing another class in the current or imported packages\fR\fP
@@ -1155,7 +1154,7 @@
\f3@see Class \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3\fIReferencing an element in another package (fully qualified)\fR\fP
@@ -1185,7 +1184,7 @@
\f3@see package\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3\fRNotes about the previous listing:
@@ -1215,7 +1214,7 @@
Any enclosing classes and interfaces searching the closest first\&.
.TP 0.4i
3\&.
-Any superclasses and superonterfaces, searching the closest first\&.
+Any superclasses and superinterfaces, searching the closest first\&.
.TP 0.4i
4\&.
The current package\&.
@@ -1307,7 +1306,7 @@
\f3@see "The Java Programming Language" // "The Java Programming Language" \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\fINote:\fR You can extend the \f3@se\fR\f3e\fR tag to link to classes not being documented with the \f3-link\fR option\&.
@@ -1317,7 +1316,7 @@
Used in the documentation comment for a default serializable field\&. See Documenting Serializable Fields and Data for a Class at http://docs\&.oracle\&.com/javase/8/docs/platform/serialization/spec/serial-arch\&.html#5251
-See also Oracle\(cqs Criteria for Including Classes in the Serialilzed Form Specification at http://www\&.oracle\&.com/technetwork/java/javase/documentation/serialized-criteria-137781\&.html
+See also Oracle\(cqs Criteria for Including Classes in the Serialized Form Specification at http://www\&.oracle\&.com/technetwork/java/javase/documentation/serialized-criteria-137781\&.html
An optional \f3field-description\fR should explain the meaning of the field and list the acceptable values\&. When needed, the description can span multiple lines\&. The standard doclet adds this information to the serialized form page\&. See Cross-Reference Pages\&.
@@ -1331,13 +1330,12 @@
.TP 0.2i
\(bu
A private or package-private class that implements \f3Serializable\fR is excluded unless that class (or its package) is marked with the \f3@serial include\fR tag\&.
-.RE
-.RS
+.RE
+
+
For example, the \f3javax\&.swing\fR package is marked with the \f3@serial\fR\f3exclude\fR tag in package\&.html or package-info\&.java\&. The public class \f3java\&.security\&.BasicPermission\fR is marked with the \f3@serial exclude\fR tag\&. The package-private class \f3java\&.util\&.PropertyPermissionCollection\fR is marked with the \f3@serial include\fR tag\&.
The \f3@serial\fR tag at the class level overrides the \f3@serial\fR tag at the package level\&.
-
-.RE
.TP
@serialData \fIdata-description\fR
Introduced in JDK 1\&.2
@@ -1387,7 +1385,7 @@
\f3public static final String SCRIPT_START = "<script>"\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1407,7 +1405,7 @@
\f3public String evalScript(String script) {}\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1494,7 +1492,7 @@
\f3}\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SS FIELD\ TAGS
@@ -1523,7 +1521,7 @@
\f3 int x = 1263732;\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SS CONSTRUCTOR\ AND\ METHOD\ TAGS
@@ -1578,7 +1576,7 @@
\f3 }\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SH OPTIONS
@@ -1592,7 +1590,7 @@
.PP
The options are:
.PP
--1\&.1 || -author || -bootclasspath classpathlist || -bottom text || -breakiterator || -charset name || -classpath classpathlist || -d directory || -docencoding name || -docfilesubdirs || -doclet class || -docletpath classpathlist || -doctitle title || -encoding || -exclude packagename1:packagename2:\&.\&.\&. || -excludedocfilessubdir name1:name2 || -extdirs dirist || -footer footer || -group groupheading packagepattern:packagepattern || -header header || -help || -helpfile path\efilename || -Jflag || -keywords || -link extdocURL || -linkoffline extdocURL packagelistLoc || -linksource || -locale language_country_variant || -nocomment || -nodeprecated || -nodeprecatedlist || -nohelp || -noindex || -nonavbar || -noqualifier all | packagename1:packagename2\&.\&.\&. || -nosince || -notimestamp || -notree || -overview path/filename || -package || -private || -protected || -public || -quiet || -serialwarn || -source release || -sourcepath sourcepathlist || -sourcetab tablength || -splitindex || -stylesheet path/filename || -subpackages package1:package2:\&.\&.\&. || -tag tagname:Xaoptcmf:"taghead" || -taglet class || -tagletpath tagletpathlist || -title title || -top || -use || -verbose || -version || -windowtitle title
+-1\&.1 || -author || -bootclasspath classpathlist || -bottom text || -breakiterator || -charset name || -classpath classpathlist || -d directory || -docencoding name || -docfilesubdirs || -doclet class || -docletpath classpathlist || -doctitle title || -encoding || -exclude packagename1:packagename2:\&.\&.\&. || -excludedocfilessubdir name1:name2 || -extdirs dirist || -footer footer || -group groupheading packagepattern:packagepattern || -header header || -help || -helpfile path\efilename || -Jflag || -javafx ||-keywords || -link extdocURL || -linkoffline extdocURL packagelistLoc || -linksource || -locale language_country_variant || -nocomment || -nodeprecated || -nodeprecatedlist || -nohelp || -noindex || -nonavbar || -noqualifier all | packagename1:packagename2\&.\&.\&. || -nosince || -notimestamp || -notree || -overview path/filename || -package || -private || -protected || -public || -quiet || -serialwarn || -source release || -sourcepath sourcepathlist || -sourcetab tablength || -splitindex || -stylesheet path/filename || -subpackages package1:package2:\&.\&.\&. || -tag tagname:Xaoptcmf:"taghead" || -taglet class || -tagletpath tagletpathlist || -title title || -top || -use || -verbose || -version || -windowtitle title
.PP
The following options are the core Javadoc options that are available to all doclets\&. The standard doclet provides the rest of the doclets: \f3-bootclasspath\fR, \f3-breakiterator\fR, \f3-classpath\fR, \f3-doclet\fR, \f3-docletpath\fR, \f3-encoding\fR, -\f3exclude\fR, \f3-extdirs\fR, \f3-help\fR, \f3-locale\fR, \f3-\fR\f3overview\fR, \f3-package\fR, \f3-private\fR, \f3-protected\fR, \f3-public\fR, \f3-quiet\fR, \f3-source\fR, \f3-sourcepath\fR, \f3-subpackages\fR, and \f3-verbose\fR\&.
.SS JAVADOC\ OPTIONS
@@ -1635,12 +1633,11 @@
.TP 0.2i
\(bu
\f3-Xdoclint all,\fR\fI-group\fR : enable all except \fIgroup\fR checks
-.RE
-.RS
+.RE
+
+
The variable \fIgroup\fR has one of the following values:
.RS
-
-.RE
.TP 0.2i
\(bu
\f3accessibility\fR : Checks for the issues to be detected by an accessibility checker (for example, no caption or summary attributes specified in a \f3<table>\fR tag)\&.
@@ -1656,8 +1653,9 @@
.TP 0.2i
\(bu
\f3syntax\fR : Checks for low level issues like unescaped angle brackets (\f3<\fR and \f3>\fR) and ampersands (\f3&\fR) and invalid Javadoc tags\&.
-.RE
-.RS
+.RE
+
+
You can specify the \f3-Xdoclint\fR option multiple times to enable the option to check errors and warnings in multiple categories\&. Alternatively, you can specify multiple error and warning categories by using the preceding options\&. For example, use either of the following commands to check for the HTML, syntax, and accessibility issues in the file \fIfilename\fR\&.
.sp
.nf
@@ -1667,7 +1665,7 @@
\f3javadoc \-Xdoclint:html,syntax,accessibility \fIfilename\fR\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1675,8 +1673,6 @@
\fINote:\fR The \f3javadoc\fR command does not guarantee the completeness of these checks\&. In particular, it is not a full HTML compliance checker\&. The goal of the -\f3Xdoclint\fR option is to enable the \f3javadoc\fR command to report majority of common errors\&.
The \f3javadoc\fR command does not attempt to fix invalid input, it just reports it\&.
-
-.RE
.TP
-public
.br
@@ -1740,7 +1736,7 @@
\f3javadoc \-sourcepath /home/user/src/ com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1755,7 +1751,7 @@
\f3javadoc \-sourcepath /home/user1/src:/home/user2/src com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1766,13 +1762,13 @@
If you omit \f3-sourcepath\fR, then the \f3javadoc\fR command uses \f3-classpath\fR to find the source files and class files (for backward compatibility)\&. If you want to search for source and class files in separate paths, then use both \f3-sourcepath\fR and \f3-classpath\fR\&.
-For example, if you want to document \f3com\&.mypackage\fR, whose source files reside in the directory /home/user/src/com/mypackage, and if this package relies on a library in /home/user/libthen you would use the following command:
+For example, if you want to document \f3com\&.mypackage\fR, whose source files reside in the directory /home/user/src/com/mypackage, and if this package relies on a library in /home/user/lib, then you would use the following command:
.sp
.nf
\f3javadoc \-sourcepath /home/user/lib \-classpath /home/user/src com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1795,7 +1791,7 @@
\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax\&.swing \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1813,7 +1809,7 @@
\f3 java\&.net:java\&.lang\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1846,11 +1842,10 @@
.TP 0.2i
\(bu
Breakiterator sentence-break algorithm\&. Stops at a period, question mark, or exclamation point followed by a space when the next word starts with a capital letter\&. This is meant to handle most abbreviations (such as "The serial no\&. is valid", but will not handle "Mr\&. Smith")\&. The \f3-breakiterator\fR option does not stop at HTML tags or sentences that begin with numbers or symbols\&. The algorithm stops at the last period in \&.\&./filename, even when embedded in an HTML tag\&.
-.RE
-.RS
-In Java SE 1\&.5 the \f3-breakiterator\fR option warning messages are removed, and the default sentence-break algorithm is unchanged\&. If you have not modified your source code to eliminate the \f3-breakiterator\fR option warnings in Java SE 1\&.4\&.x, then you do not have to do anything\&. The warnings go away starting with Java SE 1\&.5\&.0\&.
+.RE
-.RE
+
+In Java SE 1\&.5 the \f3-breakiterator\fR option warning messages are removed, and the default sentence-break algorithm is unchanged\&. If you have not modified your source code to eliminate the \f3-breakiterator\fR option warnings in Java SE 1\&.4\&.x, then you do not have to do anything\&. The warnings go away starting with Java SE 1\&.5\&.0\&.
.TP
-locale \fIlanguage_country_variant\fR
.br
@@ -1885,7 +1880,21 @@
\f3Java HotSpot(TM) 64\-Bit Server VM (build 23\&.5\-b02, mixed mode)\fP
.fi
.nf
-\f3\fR
+\f3\fP
+.fi
+.sp
+
+.TP
+-javafx
+.br
+Generates HTML documentation using the JavaFX extensions to the standard doclet\&. The generated documentation includes a Property Summary section in addition to the other summary sections generated by the standard Java doclet\&. The listed properties are linked to the sections for the getter and setter methods of each property\&.
+
+If there are no documentation comments written explicitly for getter and setter methods, the documentation comments from the property method are automatically copied to the generated documentation for these methods\&. This option also adds a new \f3@defaultValue\fR tag that allows documenting the default value for a property\&.
+
+Example:
+.sp
+.nf
+\f3javadoc \-javafx MyClass\&.java \-d testdir\fP
.fi
.sp
@@ -1957,7 +1966,7 @@
\f3\-link <directory>/<directory>/\&.\&.\&./<name>\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -1982,7 +1991,7 @@
\f3javadoc \-link http://docs\&.oracle\&.com/javase/8/docs/api/ com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The command generates documentation for the package \f3com\&.mypackage\fR with links to the Java SE packages\&. The generated documentation contains links to the \f3Object\fR class, for example, in the class \f3trees\fR\&. Other options, such as the \f3-sourcepath\fR and \f3-d\fR options, are not shown\&.
@@ -2044,7 +2053,7 @@
\f3and so on \&.\&.\&.\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
When \f3javadoc\fR is run without the \f3-link\fR option and encounters a name that belongs to an externally referenced class, it prints the name with no link\&. However, when the \f3-link\fR option is used, the \f3javadoc\fR command searches the package-list file at the specified \fIextdocURL\fR location for that package name\&. When it finds the package name, it prefixes the name with \fIextdocURL\fR\&.
@@ -2094,7 +2103,7 @@
\f3javadoc \-linkoffline http://docs\&.oracle\&.com/javase/8/docs/api/ \&. com\&.mypackage \fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2118,7 +2127,7 @@
\f3packagelistLoc2 \&.\&.\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2133,7 +2142,7 @@
\f3javadoc \-d update \-linkoffline \&. html com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
When the \f3javadoc\fR command completes, copy these generated class pages in update/com/package (not the overview or index) to the original files in html/com/package\&.
@@ -2150,7 +2159,7 @@
\f3public class Button extends Component implements Accessible\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2161,7 +2170,7 @@
\f3public String getLabel()\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2176,8 +2185,9 @@
.TP 0.2i
\(bu
The \f3packagepattern\fR value can be any package name at the start of any package name followed by an asterisk (*)\&. The asterisk is the only wildcard allowed and means match any characters\&. Multiple patterns can be included in a group by separating them with colons (:)\&. If you use an asterisk in a pattern or pattern list, then the pattern list must be inside quotation marks, such as \f3"java\&.lang*:java\&.util"\fR\&.
-.RE
-.RS
+.RE
+
+
When you do not supply a \f3-group\fR option, all packages are placed in one group with the heading \fIPackages\fR and appropriate subheadings\&. If the subheadings do not include all documented packages (all groups), then the remaining packages appear in a separate group with the subheading Other Packages\&.
For example, the following \f3javadoc\fR command separates the three documented packages into \fICore\fR, \fIExtension\fR, and \fIOther Packages\fR\&. The trailing dot (\&.) does not appear in \f3java\&.lang*\fR\&. Including the dot, such as \f3java\&.lang\&.*\fR omits the\f3java\&.lang\fR package\&.
@@ -2192,7 +2202,7 @@
\f3 java\&.lang java\&.lang\&.reflect java\&.util javax\&.servlet java\&.new\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2212,8 +2222,6 @@
\fIOther Packages\fR
\f3java\&.new\fR
-
-.RE
.TP
-nodeprecated
.br
@@ -2251,7 +2259,7 @@
\f3javadoc \-helpfile /home/user/myhelp\&.html java\&.awt\&.\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2264,7 +2272,7 @@
\f3javadoc \-stylesheet file /home/user/mystylesheet\&.css com\&.mypackage\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2283,7 +2291,7 @@
\f3<META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2296,7 +2304,7 @@
.br
Specifies the encoding of the generated HTML files\&. The name should be a preferred MIME name as specified in the IANA Registry, Character Sets at http://www\&.iana\&.org/assignments/character-sets
-If you omit the \f3-docencoding\fR option but use the \f3-encoding\fR option, then the encoding of the generated HTML files is determined by the \f3-encoding\fR option, for example: \f3javadoc -docencoding"iso-8859-1" mypackage\fR\&. See also the \f3-encoding\fR and \f3-docencoding name\fR options\&.
+If you omit the \f3-docencoding\fR option but use the \f3-encoding\fR option, then the encoding of the generated HTML files is determined by the \f3-encoding\fR option, for example: \f3javadoc -docencoding "iso-8859-1" mypackage\fR\&. See also the \f3-encoding\fR and \f3-docencoding name\fR options\&.
.TP
-keywords
.br
@@ -2315,7 +2323,7 @@
\f3<META NAME="keywords" CONTENT="charAt()">\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2360,7 +2368,7 @@
\f3 */\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2390,7 +2398,7 @@
\f3\-tag example:X\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2433,7 +2441,7 @@
\f3\-tag see\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2523,7 +2531,7 @@
\f3\-sourcepath /java/pubs/ws/1\&.7\&.0/src/share/classes\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
Create a file named packages that contains:
@@ -2538,7 +2546,7 @@
\f3com\&.mypackage3\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
Run the \f3javadoc\fR command as follows:
@@ -2547,7 +2555,7 @@
\f3javadoc @options @packages\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 3 Argument Files with Paths\fR
@@ -2558,7 +2566,7 @@
\f3javadoc @path1/options @path2/packages\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 4 Option Arguments\fR
@@ -2581,7 +2589,7 @@
\f3 Other names may be trademarks of their respective owners\&.</font>\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
Run the \f3javadoc\fR command as follows:\f3javadoc -bottom @bottom @packages\fR\&.
@@ -2616,7 +2624,7 @@
\f3javadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 2 Change to Root and Run Explicit Packages\fR
@@ -2630,7 +2638,7 @@
\f3javadoc \-d /home/html java\&.awt java\&.awt\&.event\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
To also traverse down other package trees, append their names to the \f3-subpackages\fR argument, such as j\f3ava:javax:org\&.xml\&.sax\fR\&.
@@ -2643,7 +2651,7 @@
\f3javadoc \-d /home/html \-sourcepath /home/src java\&.awt java\&.awt\&.event\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 4 Run from Any Directory on Explicit Packages in Multiple Trees\fR
@@ -2654,7 +2662,7 @@
\f3javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java\&.awt java\&.awt\&.event\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The result is that all cases generate HTML-formatted documentation for the \f3public\fR and \f3protected\fR classes and interfaces in packages j\f3ava\&.awt\fR and \f3java\&.awt\&.even\fRt and save the HTML files in the specified destination directory\&. Because two or more packages are being generated, the document has three HTML frames: one for the list of packages, another for the list of classes, and the third for the main class pages\&.
@@ -2676,7 +2684,7 @@
\f3javadoc \-d /home/html Button\&.java Canvas\&.java Graphics*\&.java\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 2 Change to the Root Directory of the Package\fR
@@ -2690,7 +2698,7 @@
\f3javadoc \-d /home/html java/awt/Button\&.java java/applet/Applet\&.java\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
\f3Example 3 Document Files from Any Directory\fR
@@ -2704,7 +2712,7 @@
\f3/home/src/java/awt/Graphics*\&.java\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2720,7 +2728,7 @@
\f3/home/src/java/applet/Applet\&.java\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SS REAL-WORLD\ EXAMPLES
@@ -2784,7 +2792,7 @@
\f3@packages\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
@@ -2802,7 +2810,7 @@
\f3import javax\&.tools\&.ToolProvider;\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3public class JavaAccessSample{\fP
@@ -2838,7 +2846,7 @@
\f3 }\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
The first three arguments of the \f3run\fR method specify input, standard output, and standard error streams\&. \f3Null\fR is the default value for \f3System\&.in\fR, \f3System\&.out\fR, and \f3System\&.err\fR, respectively\&.
@@ -2891,7 +2899,7 @@
\f3 java\&.applet\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.nf
\f3WINDOWTITLE = \&'Java\(tm SE 7 API Specification\&'\fP
@@ -2927,7 +2935,7 @@
\f3SRCDIR = \&'/java/jdk/1\&.7\&.0/src/share/classes\&'\fP
.fi
.nf
-\f3\fR
+\f3\fP
.fi
.sp
.SS NOTES