--- a/.hgignore Mon May 02 09:36:45 2011 -0700
+++ b/.hgignore Wed Jul 05 17:42:56 2017 +0200
@@ -2,3 +2,4 @@
^dist/
/nbproject/private/
^webrev
+^.hgtip
--- a/.hgtags-top-repo Mon May 02 09:36:45 2011 -0700
+++ b/.hgtags-top-repo Wed Jul 05 17:42:56 2017 +0200
@@ -114,3 +114,4 @@
7654afc6a29e43cb0a1343ce7f1287bf690d5e5f jdk7-b137
fc47c97bbbd91b1f774d855c48a7e285eb1a351a jdk7-b138
7ed6d0b9aaa12320832a7ddadb88d6d8d0dda4c1 jdk7-b139
+dcfe74f1c6553c556e7d361c30b0b614eb5e40f6 jdk7-b140
--- a/Makefile Mon May 02 09:36:45 2011 -0700
+++ b/Makefile Wed Jul 05 17:42:56 2017 +0200
@@ -97,7 +97,7 @@
endef
# Generic build of basic repo series
-generic_build_repo_series::
+generic_build_repo_series:: $(SOURCE_TIPS)
$(MKDIR) -p $(OUTPUTDIR)
$(MKDIR) -p $(OUTPUTDIR)/j2sdk-image
@$(call StartTimer)
@@ -243,6 +243,14 @@
debug_build:: build_debug_image
fastdebug_build:: build_fastdebug_image
+# The source tips are stored with the relative path to the repo.
+# This file will be used when constructing the jdk image.
+source_tips: $(SOURCE_TIPS)
+ $(CAT) $<
+$(SOURCE_TIPS): FRC
+ @$(prep-target)
+ @$(call GetSourceTips)
+
clobber:: REPORT_BUILD_TIMES=
clobber::
$(RM) -r $(OUTPUTDIR)/*
--- a/corba/.hgignore Mon May 02 09:36:45 2011 -0700
+++ b/corba/.hgignore Wed Jul 05 17:42:56 2017 +0200
@@ -1,3 +1,4 @@
^build/
^dist/
/nbproject/private/
+^.hgtip
--- a/corba/.hgtags Mon May 02 09:36:45 2011 -0700
+++ b/corba/.hgtags Wed Jul 05 17:42:56 2017 +0200
@@ -114,3 +114,4 @@
a66c01d8bf895261715955df0b95545c000ed6a8 jdk7-b137
78d8cf04697e9df54f7f11e195b7da29b8e345a2 jdk7-b138
60b074ec6fcf5cdf9efce22fdfb02326ed8fa2d3 jdk7-b139
+cdf5d19ec142424489549025e9c42e51f32cf688 jdk7-b140
--- a/hotspot/.hgignore Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/.hgignore Wed Jul 05 17:42:56 2017 +0200
@@ -5,3 +5,4 @@
^src/share/tools/IdealGraphVisualizer/[a-zA-Z0-9]*/build/
^src/share/tools/IdealGraphVisualizer/build/
^src/share/tools/IdealGraphVisualizer/dist/
+^.hgtip
--- a/hotspot/.hgtags Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/.hgtags Wed Jul 05 17:42:56 2017 +0200
@@ -166,3 +166,5 @@
0930dc920c185afbf40fed9a655290b8e5b16783 hs21-b08
611e19a16519d6fb5deea9ab565336e6e6ee475d jdk7-b139
611e19a16519d6fb5deea9ab565336e6e6ee475d hs21-b09
+d283b82966712b353fa307845a1316da42a355f4 jdk7-b140
+d283b82966712b353fa307845a1316da42a355f4 hs21-b10
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/make/cscope.make Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,141 @@
+#
+# Copyright (c) 2000, 2008, 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.
+#
+#
+
+# The cscope.out file is generated in the current directory. The old cscope.out
+# file is *not* removed because cscope is smart enough to only build what has
+# changed. cscope can be confused if files are renamed or removed, so it may be
+# necessary to remove cscope.out (gmake cscope.clean) if a lot of reorganization
+# has occurred.
+
+include $(GAMMADIR)/make/scm.make
+
+RM = rm -f
+HG = hg
+CS_TOP = $(GAMMADIR)
+
+CSDIRS = $(CS_TOP)/src $(CS_TOP)/make
+CSINCS = $(CSDIRS:%=-I%)
+
+CSCOPE = cscope
+CSCOPE_OUT = cscope.out
+CSCOPE_FLAGS = -b
+
+# Allow .java files to be added from the environment (CSCLASSES=yes).
+ifdef CSCLASSES
+ADDCLASSES= -o -name '*.java'
+endif
+
+# Adding CClassHeaders also pushes the file count of a full workspace up about
+# 200 files (these files also don't exist in a new workspace, and thus will
+# cause the recreation of the database as they get created, which might seem
+# a little confusing). Thus allow these files to be added from the environment
+# (CSHEADERS=yes).
+ifndef CSHEADERS
+RMCCHEADERS= -o -name CClassHeaders
+endif
+
+# Ignore build products.
+CS_PRUNE_GENERATED = -o -name '${OSNAME}_*_core' -o \
+ -name '${OSNAME}_*_compiler?'
+
+# O/S-specific files for all systems are included by default. Set CS_OS to a
+# space-separated list of identifiers to include only those systems.
+ifdef CS_OS
+CS_PRUNE_OS = $(patsubst %,-o -name '*%*',\
+ $(filter-out ${CS_OS},linux macos solaris windows))
+endif
+
+# CPU-specific files for all processors are included by default. Set CS_CPU
+# space-separated list identifiers to include only those CPUs.
+ifdef CS_CPU
+CS_PRUNE_CPU = $(patsubst %,-o -name '*%*',\
+ $(filter-out ${CS_CPU},arm ppc sparc x86 zero))
+endif
+
+# What files should we include? A simple rule might be just those files under
+# SCCS control, however this would miss files we create like the opcodes and
+# CClassHeaders. The following attempts to find everything that is *useful*.
+# (.del files are created by sccsrm, demo directories contain many .java files
+# that probably aren't useful for development, and the pkgarchive may contain
+# duplicates of files within the source hierarchy).
+
+# Directories to exclude.
+CS_PRUNE_STD = $(SCM_DIRS) \
+ -o -name '.del-*' \
+ -o -name '*demo' \
+ -o -name pkgarchive
+
+# Placeholder for user-defined excludes.
+CS_PRUNE_EX =
+
+CS_PRUNE = $(CS_PRUNE_STD) \
+ $(CS_PRUNE_OS) \
+ $(CS_PRUNE_CPU) \
+ $(CS_PRUNE_GENERATED) \
+ $(CS_PRUNE_EX) \
+ $(RMCCHEADERS)
+
+# File names to include.
+CSFILENAMES = -name '*.[ch]pp' \
+ -o -name '*.[Ccshlxy]' \
+ $(CS_ADD_GENERATED) \
+ -o -name '*.d' \
+ -o -name '*.il' \
+ -o -name '*.cc' \
+ -o -name '*[Mm]akefile*' \
+ -o -name '*.gmk' \
+ -o -name '*.make' \
+ -o -name '*.ad' \
+ $(ADDCLASSES)
+
+.PHONY: cscope cscope.clean cscope.scratch TAGS.clean FORCE
+.PRECIOUS: cscope.out
+
+cscope $(CSCOPE_OUT): cscope.files FORCE
+ $(CSCOPE) -f $(CSCOPE_OUT) $(CSCOPE_FLAGS)
+
+cscope.clean:
+ $(QUIETLY) $(RM) $(CSCOPE_OUT) cscope.files
+
+cscope.scratch: cscope.clean cscope
+
+# The raw list is reordered so cscope displays the most relevant files first.
+cscope.files:
+ $(QUIETLY) \
+ raw=cscope.$$$$; \
+ find $(CSDIRS) -type d \( $(CS_PRUNE) \) -prune -o \
+ -type f \( $(CSFILENAMES) \) -print > $$raw; \
+ { \
+ echo "$(CSINCS)"; \
+ egrep -v "\.java|/make/" $$raw; \
+ fgrep ".java" $$raw; \
+ fgrep "/make/" $$raw; \
+ } > $@; \
+ rm -f $$raw
+
+TAGS: cscope.files FORCE
+ egrep -v '^-|^$$' $< | etags --members -
+
+TAGS.clean:
+ $(RM) TAGS
--- a/hotspot/make/hotspot_version Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/make/hotspot_version Wed Jul 05 17:42:56 2017 +0200
@@ -35,7 +35,7 @@
HS_MAJOR_VER=21
HS_MINOR_VER=0
-HS_BUILD_NUMBER=10
+HS_BUILD_NUMBER=11
JDK_MAJOR_VER=1
JDK_MINOR_VER=7
--- a/hotspot/make/linux/Makefile Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/make/linux/Makefile Wed Jul 05 17:42:56 2017 +0200
@@ -359,7 +359,7 @@
clean: clean_compiler2 clean_compiler1 clean_core clean_zero clean_shark clean_docs
-include $(GAMMADIR)/make/$(OSNAME)/makefiles/cscope.make
+include $(GAMMADIR)/make/cscope.make
#-------------------------------------------------------------------------------
--- a/hotspot/make/linux/makefiles/cscope.make Mon May 02 09:36:45 2011 -0700
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,160 +0,0 @@
-#
-# Copyright (c) 2005, 2008, 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.
-#
-#
-
-#
-# The cscope.out file is made in the current directory and spans the entire
-# source tree.
-#
-# Things to note:
-# 1. We use relative names for cscope.
-# 2. We *don't* remove the old cscope.out file, because cscope is smart
-# enough to only build what has changed. It can be confused, however,
-# if files are renamed or removed, so it may be necessary to manually
-# remove cscope.out if a lot of reorganization has occurred.
-#
-
-include $(GAMMADIR)/make/scm.make
-
-NAWK = awk
-RM = rm -f
-HG = hg
-CS_TOP = ../..
-
-CSDIRS = $(CS_TOP)/src $(CS_TOP)/build
-CSINCS = $(CSDIRS:%=-I%)
-
-CSCOPE = cscope
-CSCOPE_FLAGS = -b
-
-# Allow .java files to be added from the environment (CSCLASSES=yes).
-ifdef CSCLASSES
-ADDCLASSES= -o -name '*.java'
-endif
-
-# Adding CClassHeaders also pushes the file count of a full workspace up about
-# 200 files (these files also don't exist in a new workspace, and thus will
-# cause the recreation of the database as they get created, which might seem
-# a little confusing). Thus allow these files to be added from the environment
-# (CSHEADERS=yes).
-ifndef CSHEADERS
-RMCCHEADERS= -o -name CClassHeaders
-endif
-
-# Use CS_GENERATED=x to include auto-generated files in the build directories.
-ifdef CS_GENERATED
-CS_ADD_GENERATED = -o -name '*.incl'
-else
-CS_PRUNE_GENERATED = -o -name '${OS}_*_core' -o -name '${OS}_*_compiler?'
-endif
-
-# OS-specific files for other systems are excluded by default. Use CS_OS=yes
-# to include platform-specific files for other platforms.
-ifndef CS_OS
-CS_OS = linux macos solaris win32
-CS_PRUNE_OS = $(patsubst %,-o -name '*%*',$(filter-out ${OS},${CS_OS}))
-endif
-
-# Processor-specific files for other processors are excluded by default. Use
-# CS_CPU=x to include platform-specific files for other platforms.
-ifndef CS_CPU
-CS_CPU = i486 sparc amd64 ia64
-CS_PRUNE_CPU = $(patsubst %,-o -name '*%*',$(filter-out ${SRCARCH},${CS_CPU}))
-endif
-
-# What files should we include? A simple rule might be just those files under
-# SCCS control, however this would miss files we create like the opcodes and
-# CClassHeaders. The following attempts to find everything that is *useful*.
-# (.del files are created by sccsrm, demo directories contain many .java files
-# that probably aren't useful for development, and the pkgarchive may contain
-# duplicates of files within the source hierarchy).
-
-# Directories to exclude.
-CS_PRUNE_STD = $(SCM_DIRS) \
- -o -name '.del-*' \
- -o -name '*demo' \
- -o -name pkgarchive
-
-CS_PRUNE = $(CS_PRUNE_STD) \
- $(CS_PRUNE_OS) \
- $(CS_PRUNE_CPU) \
- $(CS_PRUNE_GENERATED) \
- $(RMCCHEADERS)
-
-# File names to include.
-CSFILENAMES = -name '*.[ch]pp' \
- -o -name '*.[Ccshlxy]' \
- $(CS_ADD_GENERATED) \
- -o -name '*.il' \
- -o -name '*.cc' \
- -o -name '*[Mm]akefile*' \
- -o -name '*.gmk' \
- -o -name '*.make' \
- -o -name '*.ad' \
- $(ADDCLASSES)
-
-.PRECIOUS: cscope.out
-
-cscope cscope.out: cscope.files FORCE
- $(CSCOPE) $(CSCOPE_FLAGS)
-
-# The .raw file is reordered here in an attempt to make cscope display the most
-# relevant files first.
-cscope.files: .cscope.files.raw
- echo "$(CSINCS)" > $@
- -egrep -v "\.java|\/make\/" $< >> $@
- -fgrep ".java" $< >> $@
- -fgrep "/make/" $< >> $@
-
-.cscope.files.raw: .nametable.files
- -find $(CSDIRS) -type d \( $(CS_PRUNE) \) -prune -o \
- -type f \( $(CSFILENAMES) \) -print > $@
-
-cscope.clean: nametable.clean
- -$(RM) cscope.out cscope.files .cscope.files.raw
-
-TAGS: cscope.files FORCE
- egrep -v '^-|^$$' $< | etags --members -
-
-TAGS.clean: nametable.clean
- -$(RM) TAGS
-
-# .nametable.files and .nametable.files.tmp are used to determine if any files
-# were added to/deleted from/renamed in the workspace. If not, then there's
-# normally no need to rebuild the cscope database. To force a rebuild of
-# the cscope database: gmake nametable.clean.
-.nametable.files: .nametable.files.tmp
- ( cmp -s $@ $< ) || ( cp $< $@ )
- -$(RM) $<
-
-# `hg status' is slightly faster than `hg fstatus'. Both are
-# quite a bit slower on an NFS mounted file system, so this is
-# really geared towards repos on local file systems.
-.nametable.files.tmp:
- -$(HG) fstatus -acmn > $@
-nametable.clean:
- -$(RM) .nametable.files .nametable.files.tmp
-
-FORCE:
-
-.PHONY: cscope cscope.clean TAGS.clean nametable.clean FORCE
--- a/hotspot/make/solaris/Makefile Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/make/solaris/Makefile Wed Jul 05 17:42:56 2017 +0200
@@ -296,7 +296,7 @@
clean: clean_compiler2 clean_compiler1 clean_core clean_docs clean_kernel
-include $(GAMMADIR)/make/$(OSNAME)/makefiles/cscope.make
+include $(GAMMADIR)/make/cscope.make
#-------------------------------------------------------------------------------
--- a/hotspot/make/solaris/makefiles/cscope.make Mon May 02 09:36:45 2011 -0700
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,162 +0,0 @@
-#
-# Copyright (c) 2000, 2008, 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.
-#
-#
-
-#
-# The cscope.out file is made in the current directory and spans the entire
-# source tree.
-#
-# Things to note:
-# 1. We use relative names for cscope.
-# 2. We *don't* remove the old cscope.out file, because cscope is smart
-# enough to only build what has changed. It can be confused, however,
-# if files are renamed or removed, so it may be necessary to manually
-# remove cscope.out if a lot of reorganization has occurred.
-#
-
-include $(GAMMADIR)/make/scm.make
-
-NAWK = /usr/xpg4/bin/awk
-RM = rm -f
-HG = hg
-CS_TOP = ../..
-
-CSDIRS = $(CS_TOP)/src $(CS_TOP)/make
-CSINCS = $(CSDIRS:%=-I%)
-
-CSCOPE = cscope
-CSCOPE_FLAGS = -b
-
-# Allow .java files to be added from the environment (CSCLASSES=yes).
-ifdef CSCLASSES
-ADDCLASSES= -o -name '*.java'
-endif
-
-# Adding CClassHeaders also pushes the file count of a full workspace up about
-# 200 files (these files also don't exist in a new workspace, and thus will
-# cause the recreation of the database as they get created, which might seem
-# a little confusing). Thus allow these files to be added from the environment
-# (CSHEADERS=yes).
-ifndef CSHEADERS
-RMCCHEADERS= -o -name CClassHeaders
-endif
-
-# Use CS_GENERATED=x to include auto-generated files in the make directories.
-ifdef CS_GENERATED
-CS_ADD_GENERATED = -o -name '*.incl'
-else
-CS_PRUNE_GENERATED = -o -name '${OS}_*_core' -o -name '${OS}_*_compiler?'
-endif
-
-# OS-specific files for other systems are excluded by default. Use CS_OS=yes
-# to include platform-specific files for other platforms.
-ifndef CS_OS
-CS_OS = linux macos solaris win32
-CS_PRUNE_OS = $(patsubst %,-o -name '*%*',$(filter-out ${OS},${CS_OS}))
-endif
-
-# Processor-specific files for other processors are excluded by default. Use
-# CS_CPU=x to include platform-specific files for other platforms.
-ifndef CS_CPU
-CS_CPU = i486 sparc amd64 ia64
-CS_PRUNE_CPU = $(patsubst %,-o -name '*%*',$(filter-out ${SRCARCH},${CS_CPU}))
-endif
-
-# What files should we include? A simple rule might be just those files under
-# SCCS control, however this would miss files we create like the opcodes and
-# CClassHeaders. The following attempts to find everything that is *useful*.
-# (.del files are created by sccsrm, demo directories contain many .java files
-# that probably aren't useful for development, and the pkgarchive may contain
-# duplicates of files within the source hierarchy).
-
-# Directories to exclude.
-CS_PRUNE_STD = $(SCM_DIRS) \
- -o -name '.del-*' \
- -o -name '*demo' \
- -o -name pkgarchive
-
-CS_PRUNE = $(CS_PRUNE_STD) \
- $(CS_PRUNE_OS) \
- $(CS_PRUNE_CPU) \
- $(CS_PRUNE_GENERATED) \
- $(RMCCHEADERS)
-
-# File names to include.
-CSFILENAMES = -name '*.[ch]pp' \
- -o -name '*.[Ccshlxy]' \
- $(CS_ADD_GENERATED) \
- -o -name '*.d' \
- -o -name '*.il' \
- -o -name '*.cc' \
- -o -name '*[Mm]akefile*' \
- -o -name '*.gmk' \
- -o -name '*.make' \
- -o -name '*.ad' \
- $(ADDCLASSES)
-
-.PRECIOUS: cscope.out
-
-cscope cscope.out: cscope.files FORCE
- $(CSCOPE) $(CSCOPE_FLAGS)
-
-# The .raw file is reordered here in an attempt to make cscope display the most
-# relevant files first.
-cscope.files: .cscope.files.raw
- echo "$(CSINCS)" > $@
- -egrep -v "\.java|\/make\/" $< >> $@
- -fgrep ".java" $< >> $@
- -fgrep "/make/" $< >> $@
-
-.cscope.files.raw: .nametable.files
- -find $(CSDIRS) -type d \( $(CS_PRUNE) \) -prune -o \
- -type f \( $(CSFILENAMES) \) -print > $@
-
-cscope.clean: nametable.clean
- -$(RM) cscope.out cscope.files .cscope.files.raw
-
-TAGS: cscope.files FORCE
- egrep -v '^-|^$$' $< | etags --members -
-
-TAGS.clean: nametable.clean
- -$(RM) TAGS
-
-# .nametable.files and .nametable.files.tmp are used to determine if any files
-# were added to/deleted from/renamed in the workspace. If not, then there's
-# normally no need to rebuild the cscope database. To force a rebuild of
-# the cscope database: gmake nametable.clean.
-.nametable.files: .nametable.files.tmp
- ( cmp -s $@ $< ) || ( cp $< $@ )
- -$(RM) $<
-
-# `hg status' is slightly faster than `hg fstatus'. Both are
-# quite a bit slower on an NFS mounted file system, so this is
-# really geared towards repos on local file systems.
-.nametable.files.tmp:
- -$(HG) fstatus -acmn > $@
-
-nametable.clean:
- -$(RM) .nametable.files .nametable.files.tmp
-
-FORCE:
-
-.PHONY: cscope cscope.clean TAGS.clean nametable.clean FORCE
--- a/hotspot/src/cpu/sparc/vm/methodHandles_sparc.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/cpu/sparc/vm/methodHandles_sparc.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -486,7 +486,7 @@
if (ek == _invokespecial_mh) {
// Must load & check the first argument before entering the target method.
__ load_method_handle_vmslots(O0_argslot, G3_method_handle, O1_scratch);
- __ ld_ptr(__ argument_address(O0_argslot), G3_method_handle);
+ __ ld_ptr(__ argument_address(O0_argslot, -1), G3_method_handle);
__ null_check(G3_method_handle);
__ verify_oop(G3_method_handle);
}
--- a/hotspot/src/cpu/sparc/vm/templateTable_sparc.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/cpu/sparc/vm/templateTable_sparc.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -3293,8 +3293,6 @@
/*virtual*/ false, /*vfinal*/ false, /*indy*/ true);
__ mov(SP, O5_savedSP); // record SP that we wanted the callee to restore
- __ verify_oop(G5_callsite);
-
// profile this call
__ profile_call(O4);
@@ -3307,8 +3305,10 @@
__ sll(Rret, LogBytesPerWord, Rret);
__ ld_ptr(Rtemp, Rret, Rret); // get return address
+ __ verify_oop(G5_callsite);
__ load_heap_oop(G5_callsite, __ delayed_value(java_lang_invoke_CallSite::target_offset_in_bytes, Rscratch), G3_method_handle);
__ null_check(G3_method_handle);
+ __ verify_oop(G3_method_handle);
// Adjust Rret first so Llast_SP can be same as Rret
__ add(Rret, -frame::pc_return_offset, O7);
--- a/hotspot/src/cpu/x86/vm/templateTable_x86_32.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/cpu/x86/vm/templateTable_x86_32.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -422,7 +422,7 @@
Label L_done, L_throw_exception;
const Register con_klass_temp = rcx; // same as Rcache
- __ movptr(con_klass_temp, Address(rax, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(con_klass_temp, rax);
__ cmpptr(con_klass_temp, ExternalAddress((address)Universe::systemObjArrayKlassObj_addr()));
__ jcc(Assembler::notEqual, L_done);
__ cmpl(Address(rax, arrayOopDesc::length_offset_in_bytes()), 0);
@@ -432,7 +432,7 @@
// Load the exception from the system-array which wraps it:
__ bind(L_throw_exception);
- __ movptr(rax, Address(rax, arrayOopDesc::base_offset_in_bytes(T_OBJECT)));
+ __ load_heap_oop(rax, Address(rax, arrayOopDesc::base_offset_in_bytes(T_OBJECT)));
__ jump(ExternalAddress(Interpreter::throw_exception_entry()));
__ bind(L_done);
@@ -946,9 +946,9 @@
__ jcc(Assembler::zero, is_null);
// Move subklass into EBX
- __ movptr(rbx, Address(rax, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rbx, rax);
// Move superklass into EAX
- __ movptr(rax, Address(rdx, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rax, rdx);
__ movptr(rax, Address(rax, sizeof(oopDesc) + objArrayKlass::element_klass_offset_in_bytes()));
// Compress array+index*wordSize+12 into a single register. Frees ECX.
__ lea(rdx, element_address);
@@ -2001,7 +2001,7 @@
if (_desc->bytecode() == Bytecodes::_return_register_finalizer) {
assert(state == vtos, "only valid state");
__ movptr(rax, aaddress(0));
- __ movptr(rdi, Address(rax, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rdi, rax);
__ movl(rdi, Address(rdi, Klass::access_flags_offset_in_bytes() + sizeof(oopDesc)));
__ testl(rdi, JVM_ACC_HAS_FINALIZER);
Label skip_register_finalizer;
@@ -2948,7 +2948,7 @@
// get receiver klass
__ null_check(recv, oopDesc::klass_offset_in_bytes());
// Keep recv in rcx for callee expects it there
- __ movptr(rax, Address(recv, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rax, recv);
__ verify_oop(rax);
// profile this call
@@ -3028,7 +3028,7 @@
// Get receiver klass into rdx - also a null check
__ restore_locals(); // restore rdi
- __ movptr(rdx, Address(rcx, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rdx, rcx);
__ verify_oop(rdx);
// profile this call
@@ -3083,6 +3083,7 @@
void TemplateTable::invokedynamic(int byte_no) {
transition(vtos, vtos);
+ assert(byte_no == f1_oop, "use this argument");
if (!EnableInvokeDynamic) {
// We should not encounter this bytecode if !EnableInvokeDynamic.
@@ -3095,7 +3096,6 @@
return;
}
- assert(byte_no == f1_oop, "use this argument");
prepare_invoke(rax, rbx, byte_no);
// rax: CallSite object (f1)
@@ -3106,14 +3106,14 @@
Register rax_callsite = rax;
Register rcx_method_handle = rcx;
- if (ProfileInterpreter) {
- // %%% should make a type profile for any invokedynamic that takes a ref argument
- // profile this call
- __ profile_call(rsi);
- }
-
- __ movptr(rcx_method_handle, Address(rax_callsite, __ delayed_value(java_lang_invoke_CallSite::target_offset_in_bytes, rcx)));
+ // %%% should make a type profile for any invokedynamic that takes a ref argument
+ // profile this call
+ __ profile_call(rsi);
+
+ __ verify_oop(rax_callsite);
+ __ load_heap_oop(rcx_method_handle, Address(rax_callsite, __ delayed_value(java_lang_invoke_CallSite::target_offset_in_bytes, rdx)));
__ null_check(rcx_method_handle);
+ __ verify_oop(rcx_method_handle);
__ prepare_to_jump_from_interpreted();
__ jump_to_method_handle_entry(rcx_method_handle, rdx);
}
@@ -3258,7 +3258,7 @@
(int32_t)markOopDesc::prototype()); // header
__ pop(rcx); // get saved klass back in the register.
}
- __ movptr(Address(rax, oopDesc::klass_offset_in_bytes()), rcx); // klass
+ __ store_klass(rax, rcx); // klass
{
SkipIfEqual skip_if(_masm, &DTraceAllocProbes, 0);
@@ -3333,7 +3333,7 @@
__ movptr(rax, Address(rcx, rbx, Address::times_ptr, sizeof(constantPoolOopDesc)));
__ bind(resolved);
- __ movptr(rbx, Address(rdx, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rbx, rdx);
// Generate subtype check. Blows ECX. Resets EDI. Object in EDX.
// Superklass in EAX. Subklass in EBX.
@@ -3376,12 +3376,12 @@
__ push(atos);
call_VM(rax, CAST_FROM_FN_PTR(address, InterpreterRuntime::quicken_io_cc) );
__ pop_ptr(rdx);
- __ movptr(rdx, Address(rdx, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rdx, rdx);
__ jmp(resolved);
// Get superklass in EAX and subklass in EDX
__ bind(quicked);
- __ movptr(rdx, Address(rax, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(rdx, rax);
__ movptr(rax, Address(rcx, rbx, Address::times_ptr, sizeof(constantPoolOopDesc)));
__ bind(resolved);
--- a/hotspot/src/cpu/x86/vm/templateTable_x86_64.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/cpu/x86/vm/templateTable_x86_64.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -436,7 +436,7 @@
Label L_done, L_throw_exception;
const Register con_klass_temp = rcx; // same as cache
const Register array_klass_temp = rdx; // same as index
- __ movptr(con_klass_temp, Address(rax, oopDesc::klass_offset_in_bytes()));
+ __ load_klass(con_klass_temp, rax);
__ lea(array_klass_temp, ExternalAddress((address)Universe::systemObjArrayKlassObj_addr()));
__ cmpptr(con_klass_temp, Address(array_klass_temp, 0));
__ jcc(Assembler::notEqual, L_done);
@@ -447,7 +447,7 @@
// Load the exception from the system-array which wraps it:
__ bind(L_throw_exception);
- __ movptr(rax, Address(rax, arrayOopDesc::base_offset_in_bytes(T_OBJECT)));
+ __ load_heap_oop(rax, Address(rax, arrayOopDesc::base_offset_in_bytes(T_OBJECT)));
__ jump(ExternalAddress(Interpreter::throw_exception_entry()));
__ bind(L_done);
@@ -3137,7 +3137,6 @@
return;
}
- assert(byte_no == f1_oop, "use this argument");
prepare_invoke(rax, rbx, byte_no);
// rax: CallSite object (f1)
@@ -3148,14 +3147,14 @@
Register rax_callsite = rax;
Register rcx_method_handle = rcx;
- if (ProfileInterpreter) {
- // %%% should make a type profile for any invokedynamic that takes a ref argument
- // profile this call
- __ profile_call(r13);
- }
-
- __ load_heap_oop(rcx_method_handle, Address(rax_callsite, __ delayed_value(java_lang_invoke_CallSite::target_offset_in_bytes, rcx)));
+ // %%% should make a type profile for any invokedynamic that takes a ref argument
+ // profile this call
+ __ profile_call(r13);
+
+ __ verify_oop(rax_callsite);
+ __ load_heap_oop(rcx_method_handle, Address(rax_callsite, __ delayed_value(java_lang_invoke_CallSite::target_offset_in_bytes, rdx)));
__ null_check(rcx_method_handle);
+ __ verify_oop(rcx_method_handle);
__ prepare_to_jump_from_interpreted();
__ jump_to_method_handle_entry(rcx_method_handle, rdx);
}
--- a/hotspot/src/cpu/x86/vm/vm_version_x86.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/cpu/x86/vm/vm_version_x86.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -441,12 +441,25 @@
}
}
- // On family 21 processors default is no sw prefetch
- if ( cpu_family() == 21 ) {
+ // some defaults for AMD family 15h
+ if ( cpu_family() == 0x15 ) {
+ // On family 15h processors default is no sw prefetch
if (FLAG_IS_DEFAULT(AllocatePrefetchStyle)) {
AllocatePrefetchStyle = 0;
}
+ // Also, if some other prefetch style is specified, default instruction type is PREFETCHW
+ if (FLAG_IS_DEFAULT(AllocatePrefetchInstr)) {
+ AllocatePrefetchInstr = 3;
+ }
+ // On family 15h processors use XMM and UnalignedLoadStores for Array Copy
+ if( FLAG_IS_DEFAULT(UseXMMForArrayCopy) ) {
+ UseXMMForArrayCopy = true;
+ }
+ if( FLAG_IS_DEFAULT(UseUnalignedLoadStores) && UseXMMForArrayCopy ) {
+ UseUnalignedLoadStores = true;
+ }
}
+
}
if( is_intel() ) { // Intel cpus specific settings
--- a/hotspot/src/os/linux/vm/globals_linux.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/os/linux/vm/globals_linux.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -29,13 +29,19 @@
// Defines Linux specific flags. They are not available on other platforms.
//
#define RUNTIME_OS_FLAGS(develop, develop_pd, product, product_pd, diagnostic, notproduct) \
- product(bool, UseOprofile, false, \
- "enable support for Oprofile profiler") \
- \
- product(bool, UseLinuxPosixThreadCPUClocks, true, \
- "enable fast Linux Posix clocks where available")
-// NB: The default value of UseLinuxPosixThreadCPUClocks may be
-// overridden in Arguments::parse_each_vm_init_arg.
+ product(bool, UseOprofile, false, \
+ "enable support for Oprofile profiler") \
+ \
+ product(bool, UseLinuxPosixThreadCPUClocks, true, \
+ "enable fast Linux Posix clocks where available") \
+/* NB: The default value of UseLinuxPosixThreadCPUClocks may be \
+ overridden in Arguments::parse_each_vm_init_arg. */ \
+ \
+ product(bool, UseHugeTLBFS, false, \
+ "Use MAP_HUGETLB for large pages") \
+ \
+ product(bool, UseSHM, false, \
+ "Use SYSV shared memory for large pages")
//
// Defines Linux-specific default values. The flags are available on all
--- a/hotspot/src/os/linux/vm/os_linux.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/os/linux/vm/os_linux.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -2465,16 +2465,40 @@
return res != (uintptr_t) MAP_FAILED;
}
+// Define MAP_HUGETLB here so we can build HotSpot on old systems.
+#ifndef MAP_HUGETLB
+#define MAP_HUGETLB 0x40000
+#endif
+
+// Define MADV_HUGEPAGE here so we can build HotSpot on old systems.
+#ifndef MADV_HUGEPAGE
+#define MADV_HUGEPAGE 14
+#endif
+
bool os::commit_memory(char* addr, size_t size, size_t alignment_hint,
bool exec) {
+ if (UseHugeTLBFS && alignment_hint > (size_t)vm_page_size()) {
+ int prot = exec ? PROT_READ|PROT_WRITE|PROT_EXEC : PROT_READ|PROT_WRITE;
+ uintptr_t res =
+ (uintptr_t) ::mmap(addr, size, prot,
+ MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS|MAP_HUGETLB,
+ -1, 0);
+ return res != (uintptr_t) MAP_FAILED;
+ }
+
return commit_memory(addr, size, exec);
}
-void os::realign_memory(char *addr, size_t bytes, size_t alignment_hint) { }
+void os::realign_memory(char *addr, size_t bytes, size_t alignment_hint) {
+ if (UseHugeTLBFS && alignment_hint > (size_t)vm_page_size()) {
+ // We don't check the return value: madvise(MADV_HUGEPAGE) may not
+ // be supported or the memory may already be backed by huge pages.
+ ::madvise(addr, bytes, MADV_HUGEPAGE);
+ }
+}
void os::free_memory(char *addr, size_t bytes) {
- ::mmap(addr, bytes, PROT_READ | PROT_WRITE,
- MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0);
+ ::madvise(addr, bytes, MADV_DONTNEED);
}
void os::numa_make_global(char *addr, size_t bytes) {
@@ -2812,6 +2836,43 @@
return linux_mprotect(addr, size, PROT_READ|PROT_WRITE);
}
+bool os::Linux::hugetlbfs_sanity_check(bool warn, size_t page_size) {
+ bool result = false;
+ void *p = mmap (NULL, page_size, PROT_READ|PROT_WRITE,
+ MAP_ANONYMOUS|MAP_PRIVATE|MAP_HUGETLB,
+ -1, 0);
+
+ if (p != (void *) -1) {
+ // We don't know if this really is a huge page or not.
+ FILE *fp = fopen("/proc/self/maps", "r");
+ if (fp) {
+ while (!feof(fp)) {
+ char chars[257];
+ long x = 0;
+ if (fgets(chars, sizeof(chars), fp)) {
+ if (sscanf(chars, "%lx-%*lx", &x) == 1
+ && x == (long)p) {
+ if (strstr (chars, "hugepage")) {
+ result = true;
+ break;
+ }
+ }
+ }
+ }
+ fclose(fp);
+ }
+ munmap (p, page_size);
+ if (result)
+ return true;
+ }
+
+ if (warn) {
+ warning("HugeTLBFS is not supported by the operating system.");
+ }
+
+ return result;
+}
+
/*
* Set the coredump_filter bits to include largepages in core dump (bit 6)
*
@@ -2854,7 +2915,16 @@
static size_t _large_page_size = 0;
bool os::large_page_init() {
- if (!UseLargePages) return false;
+ if (!UseLargePages) {
+ UseHugeTLBFS = false;
+ UseSHM = false;
+ return false;
+ }
+
+ if (FLAG_IS_DEFAULT(UseHugeTLBFS) && FLAG_IS_DEFAULT(UseSHM)) {
+ // Our user has not expressed a preference, so we'll try both.
+ UseHugeTLBFS = UseSHM = true;
+ }
if (LargePageSizeInBytes) {
_large_page_size = LargePageSizeInBytes;
@@ -2899,6 +2969,9 @@
}
}
+ // print a warning if any large page related flag is specified on command line
+ bool warn_on_failure = !FLAG_IS_DEFAULT(UseHugeTLBFS);
+
const size_t default_page_size = (size_t)Linux::page_size();
if (_large_page_size > default_page_size) {
_page_sizes[0] = _large_page_size;
@@ -2906,6 +2979,14 @@
_page_sizes[2] = 0;
}
+ UseHugeTLBFS = UseHugeTLBFS &&
+ Linux::hugetlbfs_sanity_check(warn_on_failure, _large_page_size);
+
+ if (UseHugeTLBFS)
+ UseSHM = false;
+
+ UseLargePages = UseHugeTLBFS || UseSHM;
+
set_coredump_filter();
// Large page support is available on 2.6 or newer kernel, some vendors
@@ -2922,7 +3003,7 @@
char* os::reserve_memory_special(size_t bytes, char* req_addr, bool exec) {
// "exec" is passed in but not used. Creating the shared image for
// the code cache doesn't have an SHM_X executable permission to check.
- assert(UseLargePages, "only for large pages");
+ assert(UseLargePages && UseSHM, "only for SHM large pages");
key_t key = IPC_PRIVATE;
char *addr;
@@ -2989,16 +3070,15 @@
return _large_page_size;
}
-// Linux does not support anonymous mmap with large page memory. The only way
-// to reserve large page memory without file backing is through SysV shared
-// memory API. The entire memory region is committed and pinned upfront.
-// Hopefully this will change in the future...
+// HugeTLBFS allows application to commit large page memory on demand;
+// with SysV SHM the entire memory region must be allocated as shared
+// memory.
bool os::can_commit_large_page_memory() {
- return false;
+ return UseHugeTLBFS;
}
bool os::can_execute_large_page_memory() {
- return false;
+ return UseHugeTLBFS;
}
// Reserve memory at an arbitrary address, only if that area is
@@ -4090,6 +4170,23 @@
UseNUMA = false;
}
}
+ // With SHM large pages we cannot uncommit a page, so there's not way
+ // we can make the adaptive lgrp chunk resizing work. If the user specified
+ // both UseNUMA and UseLargePages (or UseSHM) on the command line - warn and
+ // disable adaptive resizing.
+ if (UseNUMA && UseLargePages && UseSHM) {
+ if (!FLAG_IS_DEFAULT(UseNUMA)) {
+ if (FLAG_IS_DEFAULT(UseLargePages) && FLAG_IS_DEFAULT(UseSHM)) {
+ UseLargePages = false;
+ } else {
+ warning("UseNUMA is not fully compatible with SHM large pages, disabling adaptive resizing");
+ UseAdaptiveSizePolicy = false;
+ UseAdaptiveNUMAChunkSizing = false;
+ }
+ } else {
+ UseNUMA = false;
+ }
+ }
if (!UseNUMA && ForceNUMA) {
UseNUMA = true;
}
--- a/hotspot/src/os/linux/vm/os_linux.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/os/linux/vm/os_linux.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -86,6 +86,9 @@
static void rebuild_cpu_to_node_map();
static GrowableArray<int>* cpu_to_node() { return _cpu_to_node; }
+
+ static bool hugetlbfs_sanity_check(bool warn, size_t page_size);
+
public:
static void init_thread_fpu_state();
static int get_fpu_control_word();
--- a/hotspot/src/os/solaris/vm/os_solaris.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/os/solaris/vm/os_solaris.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -2826,7 +2826,9 @@
void os::realign_memory(char *addr, size_t bytes, size_t alignment_hint) {
assert((intptr_t)addr % alignment_hint == 0, "Address should be aligned.");
assert((intptr_t)(addr + bytes) % alignment_hint == 0, "End should be aligned.");
- Solaris::set_mpss_range(addr, bytes, alignment_hint);
+ if (UseLargePages && UseMPSS) {
+ Solaris::set_mpss_range(addr, bytes, alignment_hint);
+ }
}
// Tell the OS to make the range local to the first-touching LWP
@@ -5044,6 +5046,20 @@
UseNUMA = false;
}
}
+ // ISM is not compatible with the NUMA allocator - it always allocates
+ // pages round-robin across the lgroups.
+ if (UseNUMA && UseLargePages && UseISM) {
+ if (!FLAG_IS_DEFAULT(UseNUMA)) {
+ if (FLAG_IS_DEFAULT(UseLargePages) && FLAG_IS_DEFAULT(UseISM)) {
+ UseLargePages = false;
+ } else {
+ warning("UseNUMA is not compatible with ISM large pages, disabling NUMA allocator");
+ UseNUMA = false;
+ }
+ } else {
+ UseNUMA = false;
+ }
+ }
if (!UseNUMA && ForceNUMA) {
UseNUMA = true;
}
--- a/hotspot/src/share/vm/c1/c1_Runtime1.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/c1/c1_Runtime1.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1026,9 +1026,21 @@
// first replace the tail, then the call
#ifdef ARM
if(stub_id == Runtime1::load_klass_patching_id && !VM_Version::supports_movw()) {
+ nmethod* nm = CodeCache::find_nmethod(instr_pc);
+ oop* oop_addr = NULL;
+ assert(nm != NULL, "invalid nmethod_pc");
+ RelocIterator oops(nm, copy_buff, copy_buff + 1);
+ while (oops.next()) {
+ if (oops.type() == relocInfo::oop_type) {
+ oop_Relocation* r = oops.oop_reloc();
+ oop_addr = r->oop_addr();
+ break;
+ }
+ }
+ assert(oop_addr != NULL, "oop relocation must exist");
copy_buff -= *byte_count;
NativeMovConstReg* n_copy2 = nativeMovConstReg_at(copy_buff);
- n_copy2->set_data((intx) (load_klass()), instr_pc);
+ n_copy2->set_pc_relative_offset((address)oop_addr, instr_pc);
}
#endif
--- a/hotspot/src/share/vm/ci/bcEscapeAnalyzer.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/ci/bcEscapeAnalyzer.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -232,14 +232,7 @@
}
// compute size of arguments
- int arg_size = target->arg_size();
- if (code == Bytecodes::_invokedynamic) {
- assert(!target->is_static(), "receiver explicit in method");
- arg_size--; // implicit, not really on stack
- }
- if (!target->is_loaded() && code == Bytecodes::_invokestatic) {
- arg_size--;
- }
+ int arg_size = target->invoke_arg_size(code);
int arg_base = MAX2(state._stack_height - arg_size, 0);
// direct recursive calls are skipped if they can be bound statically without introducing
--- a/hotspot/src/share/vm/ci/ciEnv.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/ci/ciEnv.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -756,7 +756,7 @@
assert(bc == Bytecodes::_invokedynamic, "must be invokedynamic");
bool is_resolved = cpool->cache()->main_entry_at(index)->is_resolved(bc);
- if (is_resolved && (oop) cpool->cache()->secondary_entry_at(index)->f1() == NULL)
+ if (is_resolved && cpool->cache()->secondary_entry_at(index)->is_f1_null())
// FIXME: code generation could allow for null (unlinked) call site
is_resolved = false;
@@ -770,7 +770,7 @@
// Get the invoker methodOop from the constant pool.
oop f1_value = cpool->cache()->main_entry_at(index)->f1();
- methodOop signature_invoker = methodOop(f1_value);
+ methodOop signature_invoker = (methodOop) f1_value;
assert(signature_invoker != NULL && signature_invoker->is_method() && signature_invoker->is_method_handle_invoke(),
"correct result from LinkResolver::resolve_invokedynamic");
--- a/hotspot/src/share/vm/ci/ciMethod.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/ci/ciMethod.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -127,7 +127,24 @@
ciSignature* signature() const { return _signature; }
ciType* return_type() const { return _signature->return_type(); }
int arg_size_no_receiver() const { return _signature->size(); }
- int arg_size() const { return _signature->size() + (_flags.is_static() ? 0 : 1); }
+ // Can only be used on loaded ciMethods
+ int arg_size() const {
+ check_is_loaded();
+ return _signature->size() + (_flags.is_static() ? 0 : 1);
+ }
+ // Report the number of elements on stack when invoking this method.
+ // This is different than the regular arg_size because invokdynamic
+ // has an implicit receiver.
+ int invoke_arg_size(Bytecodes::Code code) const {
+ int arg_size = _signature->size();
+ // Add a receiver argument, maybe:
+ if (code != Bytecodes::_invokestatic &&
+ code != Bytecodes::_invokedynamic) {
+ arg_size++;
+ }
+ return arg_size;
+ }
+
// Method code and related information.
address code() { if (_code == NULL) load_code(); return _code; }
@@ -276,9 +293,9 @@
void print_short_name(outputStream* st = tty);
methodOop get_method_handle_target() {
- klassOop receiver_limit_oop = NULL;
- int flags = 0;
- return MethodHandles::decode_method(get_oop(), receiver_limit_oop, flags);
+ KlassHandle receiver_limit; int flags = 0;
+ methodHandle m = MethodHandles::decode_method(get_oop(), receiver_limit, flags);
+ return m();
}
};
--- a/hotspot/src/share/vm/ci/ciObject.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/ci/ciObject.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -194,6 +194,16 @@
// ciObject::should_be_constant()
bool ciObject::should_be_constant() {
if (ScavengeRootsInCode >= 2) return true; // force everybody to be a constant
+ if (!JavaObjectsInPerm && !is_null_object()) {
+ // We want Strings and Classes to be embeddable by default since
+ // they used to be in the perm world. Not all Strings used to be
+ // embeddable but there's no easy way to distinguish the interned
+ // from the regulars ones so just treat them all that way.
+ ciEnv* env = CURRENT_ENV;
+ if (klass() == env->String_klass() || klass() == env->Class_klass()) {
+ return true;
+ }
+ }
return handle() == NULL || !is_scavengable();
}
--- a/hotspot/src/share/vm/classfile/javaClasses.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/classfile/javaClasses.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1357,7 +1357,7 @@
};
-void java_lang_Throwable::fill_in_stack_trace(Handle throwable, TRAPS) {
+void java_lang_Throwable::fill_in_stack_trace(Handle throwable, methodHandle method, TRAPS) {
if (!StackTraceInThrowable) return;
ResourceMark rm(THREAD);
@@ -1374,6 +1374,16 @@
JavaThread* thread = (JavaThread*)THREAD;
BacktraceBuilder bt(CHECK);
+ // If there is no Java frame just return the method that was being called
+ // with bci 0
+ if (!thread->has_last_Java_frame()) {
+ if (max_depth >= 1 && method() != NULL) {
+ bt.push(method(), 0, CHECK);
+ set_backtrace(throwable(), bt.backtrace());
+ }
+ return;
+ }
+
// Instead of using vframe directly, this version of fill_in_stack_trace
// basically handles everything by hand. This significantly improved the
// speed of this method call up to 28.5% on Solaris sparc. 27.1% on Windows.
@@ -1477,7 +1487,7 @@
set_backtrace(throwable(), bt.backtrace());
}
-void java_lang_Throwable::fill_in_stack_trace(Handle throwable) {
+void java_lang_Throwable::fill_in_stack_trace(Handle throwable, methodHandle method) {
// No-op if stack trace is disabled
if (!StackTraceInThrowable) {
return;
@@ -1491,7 +1501,7 @@
PRESERVE_EXCEPTION_MARK;
JavaThread* thread = JavaThread::active();
- fill_in_stack_trace(throwable, thread);
+ fill_in_stack_trace(throwable, method, thread);
// ignore exceptions thrown during stack trace filling
CLEAR_PENDING_EXCEPTION;
}
--- a/hotspot/src/share/vm/classfile/javaClasses.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/classfile/javaClasses.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -440,8 +440,8 @@
static void fill_in_stack_trace_of_preallocated_backtrace(Handle throwable);
// Fill in current stack trace, can cause GC
- static void fill_in_stack_trace(Handle throwable, TRAPS);
- static void fill_in_stack_trace(Handle throwable);
+ static void fill_in_stack_trace(Handle throwable, methodHandle method, TRAPS);
+ static void fill_in_stack_trace(Handle throwable, methodHandle method = methodHandle());
// Programmatic access to stack trace
static oop get_stack_trace_element(oop throwable, int index, TRAPS);
static int get_stack_trace_depth(oop throwable, TRAPS);
--- a/hotspot/src/share/vm/compiler/compileBroker.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/compiler/compileBroker.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -976,6 +976,15 @@
return;
}
+ // If the requesting thread is holding the pending list lock
+ // then we just return. We can't risk blocking while holding
+ // the pending list lock or a 3-way deadlock may occur
+ // between the reference handler thread, a GC (instigated
+ // by a compiler thread), and compiled method registration.
+ if (instanceRefKlass::owns_pending_list_lock(JavaThread::current())) {
+ return;
+ }
+
// Outputs from the following MutexLocker block:
CompileTask* task = NULL;
bool blocking = false;
@@ -1304,17 +1313,8 @@
// Should the current thread be blocked until this compilation request
// has been fulfilled?
bool CompileBroker::is_compile_blocking(methodHandle method, int osr_bci) {
- if (!BackgroundCompilation) {
- Symbol* class_name = method->method_holder()->klass_part()->name();
- if (class_name->starts_with("java/lang/ref/Reference", 23)) {
- // The reference handler thread can dead lock with the GC if compilation is blocking,
- // so we avoid blocking compiles for anything in the java.lang.ref.Reference class,
- // including inner classes such as ReferenceHandler.
- return false;
- }
- return true;
- }
- return false;
+ assert(!instanceRefKlass::owns_pending_list_lock(JavaThread::current()), "possible deadlock");
+ return !BackgroundCompilation;
}
--- a/hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/compactibleFreeListSpace.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/compactibleFreeListSpace.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1963,10 +1963,21 @@
// Iteration support, mostly delegated from a CMS generation
void CompactibleFreeListSpace::save_marks() {
- // mark the "end" of the used space at the time of this call;
+ assert(Thread::current()->is_VM_thread(),
+ "Global variable should only be set when single-threaded");
+ // Mark the "end" of the used space at the time of this call;
// note, however, that promoted objects from this point
// on are tracked in the _promoInfo below.
set_saved_mark_word(unallocated_block());
+#ifdef ASSERT
+ // Check the sanity of save_marks() etc.
+ MemRegion ur = used_region();
+ MemRegion urasm = used_region_at_save_marks();
+ assert(ur.contains(urasm),
+ err_msg(" Error at save_marks(): [" PTR_FORMAT "," PTR_FORMAT ")"
+ " should contain [" PTR_FORMAT "," PTR_FORMAT ")",
+ ur.start(), ur.end(), urasm.start(), urasm.end()));
+#endif
// inform allocator that promotions should be tracked.
assert(_promoInfo.noPromotions(), "_promoInfo inconsistency");
_promoInfo.startTrackingPromotions();
--- a/hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/concurrentMarkSweepGeneration.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/concurrentMarkSweepGeneration.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -3189,10 +3189,9 @@
}
void CMSCollector::setup_cms_unloading_and_verification_state() {
- const bool should_verify = VerifyBeforeGC || VerifyAfterGC || VerifyDuringGC
+ const bool should_verify = VerifyBeforeGC || VerifyAfterGC || VerifyDuringGC
|| VerifyBeforeExit;
- const int rso = SharedHeap::SO_Symbols | SharedHeap::SO_Strings
- | SharedHeap::SO_CodeCache;
+ const int rso = SharedHeap::SO_Strings | SharedHeap::SO_CodeCache;
if (should_unload_classes()) { // Should unload classes this cycle
remove_root_scanning_option(rso); // Shrink the root set appropriately
--- a/hotspot/src/share/vm/gc_implementation/g1/g1CollectedHeap.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/g1/g1CollectedHeap.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1161,6 +1161,7 @@
TraceTime t(system_gc ? "Full GC (System.gc())" : "Full GC",
PrintGC, true, gclog_or_tty);
+ TraceCollectorStats tcs(g1mm()->full_collection_counters());
TraceMemoryManagerStats tms(true /* fullGC */);
double start = os::elapsedTime();
@@ -1339,6 +1340,7 @@
if (PrintHeapAtGC) {
Universe::print_heap_after_gc();
}
+ g1mm()->update_counters();
return true;
}
@@ -1971,6 +1973,10 @@
init_mutator_alloc_region();
+ // Do create of the monitoring and management support so that
+ // values in the heap have been properly initialized.
+ _g1mm = new G1MonitoringSupport(this, &_g1_storage);
+
return JNI_OK;
}
@@ -2113,6 +2119,28 @@
(cause == GCCause::_java_lang_system_gc && ExplicitGCInvokesConcurrent));
}
+#ifndef PRODUCT
+void G1CollectedHeap::allocate_dummy_regions() {
+ // Let's fill up most of the region
+ size_t word_size = HeapRegion::GrainWords - 1024;
+ // And as a result the region we'll allocate will be humongous.
+ guarantee(isHumongous(word_size), "sanity");
+
+ for (uintx i = 0; i < G1DummyRegionsPerGC; ++i) {
+ // Let's use the existing mechanism for the allocation
+ HeapWord* dummy_obj = humongous_obj_allocate(word_size);
+ if (dummy_obj != NULL) {
+ MemRegion mr(dummy_obj, word_size);
+ CollectedHeap::fill_with_object(mr);
+ } else {
+ // If we can't allocate once, we probably cannot allocate
+ // again. Let's get out of the loop.
+ break;
+ }
+ }
+}
+#endif // !PRODUCT
+
void G1CollectedHeap::increment_full_collections_completed(bool concurrent) {
MonitorLockerEx x(FullGCCount_lock, Mutex::_no_safepoint_check_flag);
@@ -2777,17 +2805,26 @@
bool silent,
bool use_prev_marking) {
if (SafepointSynchronize::is_at_safepoint() || ! UseTLAB) {
- if (!silent) { gclog_or_tty->print("roots "); }
+ if (!silent) { gclog_or_tty->print("Roots (excluding permgen) "); }
VerifyRootsClosure rootsCl(use_prev_marking);
CodeBlobToOopClosure blobsCl(&rootsCl, /*do_marking=*/ false);
- process_strong_roots(true, // activate StrongRootsScope
- false,
- SharedHeap::SO_AllClasses,
+ // We apply the relevant closures to all the oops in the
+ // system dictionary, the string table and the code cache.
+ const int so = SharedHeap::SO_AllClasses | SharedHeap::SO_Strings | SharedHeap::SO_CodeCache;
+ process_strong_roots(true, // activate StrongRootsScope
+ true, // we set "collecting perm gen" to true,
+ // so we don't reset the dirty cards in the perm gen.
+ SharedHeap::ScanningOption(so), // roots scanning options
&rootsCl,
&blobsCl,
&rootsCl);
+ // Since we used "collecting_perm_gen" == true above, we will not have
+ // checked the refs from perm into the G1-collected heap. We check those
+ // references explicitly below. Whether the relevant cards are dirty
+ // is checked further below in the rem set verification.
+ if (!silent) { gclog_or_tty->print("Permgen roots "); }
+ perm_gen()->oop_iterate(&rootsCl);
bool failures = rootsCl.failures();
- rem_set()->invalidate(perm_gen()->used_region(), false);
if (!silent) { gclog_or_tty->print("HeapRegionSets "); }
verify_region_sets();
if (!silent) { gclog_or_tty->print("HeapRegions "); }
@@ -3164,6 +3201,7 @@
TraceCPUTime tcpu(PrintGCDetails, true, gclog_or_tty);
TraceTime t(verbose_str, PrintGC && !PrintGCDetails, true, gclog_or_tty);
+ TraceCollectorStats tcs(g1mm()->incremental_collection_counters());
TraceMemoryManagerStats tms(false /* fullGC */);
// If the secondary_free_list is not empty, append it to the
@@ -3338,6 +3376,8 @@
doConcurrentMark();
}
+ allocate_dummy_regions();
+
#if YOUNG_LIST_VERBOSE
gclog_or_tty->print_cr("\nEnd of the pause.\nYoung_list:");
_young_list->print();
@@ -3401,6 +3441,8 @@
if (PrintHeapAtGC) {
Universe::print_heap_after_gc();
}
+ g1mm()->update_counters();
+
if (G1SummarizeRSetStats &&
(G1SummarizeRSetStatsPeriod > 0) &&
(total_collections() % G1SummarizeRSetStatsPeriod == 0)) {
@@ -5314,6 +5356,7 @@
if (new_alloc_region != NULL) {
g1_policy()->update_region_num(true /* next_is_young */);
set_region_short_lived_locked(new_alloc_region);
+ g1mm()->update_eden_counters();
return new_alloc_region;
}
}
--- a/hotspot/src/share/vm/gc_implementation/g1/g1CollectedHeap.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/g1/g1CollectedHeap.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -28,7 +28,9 @@
#include "gc_implementation/g1/concurrentMark.hpp"
#include "gc_implementation/g1/g1AllocRegion.hpp"
#include "gc_implementation/g1/g1RemSet.hpp"
+#include "gc_implementation/g1/g1MonitoringSupport.hpp"
#include "gc_implementation/g1/heapRegionSets.hpp"
+#include "gc_implementation/shared/hSpaceCounters.hpp"
#include "gc_implementation/parNew/parGCAllocBuffer.hpp"
#include "memory/barrierSet.hpp"
#include "memory/memRegion.hpp"
@@ -57,6 +59,7 @@
class ConcurrentMark;
class ConcurrentMarkThread;
class ConcurrentG1Refine;
+class GenerationCounters;
typedef OverflowTaskQueue<StarTask> RefToScanQueue;
typedef GenericTaskQueueSet<RefToScanQueue> RefToScanQueueSet;
@@ -236,6 +239,9 @@
// current collection.
HeapRegion* _gc_alloc_region_list;
+ // Helper for monitoring and management support.
+ G1MonitoringSupport* _g1mm;
+
// Determines PLAB size for a particular allocation purpose.
static size_t desired_plab_sz(GCAllocPurpose purpose);
@@ -298,6 +304,14 @@
// started is maintained in _total_full_collections in CollectedHeap.
volatile unsigned int _full_collections_completed;
+ // This is a non-product method that is helpful for testing. It is
+ // called at the end of a GC and artificially expands the heap by
+ // allocating a number of dead regions. This way we can induce very
+ // frequent marking cycles and stress the cleanup / concurrent
+ // cleanup code more (as all the regions that will be allocated by
+ // this method will be found dead by the marking cycle).
+ void allocate_dummy_regions() PRODUCT_RETURN;
+
// These are macros so that, if the assert fires, we get the correct
// line number, file, etc.
@@ -542,6 +556,9 @@
HeapWord* expand_and_allocate(size_t word_size);
public:
+
+ G1MonitoringSupport* g1mm() { return _g1mm; }
+
// Expand the garbage-first heap by at least the given size (in bytes!).
// Returns true if the heap was expanded by the requested amount;
// false otherwise.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/src/share/vm/gc_implementation/g1/g1MonitoringSupport.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,178 @@
+/*
+ * Copyright (c) 2011, 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.
+ *
+ */
+
+#include "precompiled.hpp"
+#include "gc_implementation/g1/g1MonitoringSupport.hpp"
+#include "gc_implementation/g1/g1CollectedHeap.inline.hpp"
+#include "gc_implementation/g1/g1CollectorPolicy.hpp"
+
+G1MonitoringSupport::G1MonitoringSupport(G1CollectedHeap* g1h,
+ VirtualSpace* g1_storage_addr) :
+ _g1h(g1h),
+ _incremental_collection_counters(NULL),
+ _full_collection_counters(NULL),
+ _non_young_collection_counters(NULL),
+ _old_space_counters(NULL),
+ _young_collection_counters(NULL),
+ _eden_counters(NULL),
+ _from_counters(NULL),
+ _to_counters(NULL),
+ _g1_storage_addr(g1_storage_addr)
+{
+ // Counters for GC collections
+ //
+ // name "collector.0". In a generational collector this would be the
+ // young generation collection.
+ _incremental_collection_counters =
+ new CollectorCounters("G1 incremental collections", 0);
+ // name "collector.1". In a generational collector this would be the
+ // old generation collection.
+ _full_collection_counters =
+ new CollectorCounters("G1 stop-the-world full collections", 1);
+
+ // timer sampling for all counters supporting sampling only update the
+ // used value. See the take_sample() method. G1 requires both used and
+ // capacity updated so sampling is not currently used. It might
+ // be sufficient to update all counters in take_sample() even though
+ // take_sample() only returns "used". When sampling was used, there
+ // were some anomolous values emitted which may have been the consequence
+ // of not updating all values simultaneously (i.e., see the calculation done
+ // in eden_space_used(), is it possbile that the values used to
+ // calculate either eden_used or survivor_used are being updated by
+ // the collector when the sample is being done?).
+ const bool sampled = false;
+
+ // "Generation" and "Space" counters.
+ //
+ // name "generation.1" This is logically the old generation in
+ // generational GC terms. The "1, 1" parameters are for
+ // the n-th generation (=1) with 1 space.
+ // Counters are created from minCapacity, maxCapacity, and capacity
+ _non_young_collection_counters =
+ new GenerationCounters("whole heap", 1, 1, _g1_storage_addr);
+
+ // name "generation.1.space.0"
+ // Counters are created from maxCapacity, capacity, initCapacity,
+ // and used.
+ _old_space_counters = new HSpaceCounters("space", 0,
+ _g1h->max_capacity(), _g1h->capacity(), _non_young_collection_counters);
+
+ // Young collection set
+ // name "generation.0". This is logically the young generation.
+ // The "0, 3" are paremeters for the n-th genertaion (=0) with 3 spaces.
+ // See _non_young_collection_counters for additional counters
+ _young_collection_counters = new GenerationCounters("young", 0, 3, NULL);
+
+ // Replace "max_heap_byte_size() with maximum young gen size for
+ // g1Collectedheap
+ // name "generation.0.space.0"
+ // See _old_space_counters for additional counters
+ _eden_counters = new HSpaceCounters("eden", 0,
+ _g1h->max_capacity(), eden_space_committed(),
+ _young_collection_counters);
+
+ // name "generation.0.space.1"
+ // See _old_space_counters for additional counters
+ // Set the arguments to indicate that this survivor space is not used.
+ _from_counters = new HSpaceCounters("s0", 1, (long) 0, (long) 0,
+ _young_collection_counters);
+
+ // name "generation.0.space.2"
+ // See _old_space_counters for additional counters
+ _to_counters = new HSpaceCounters("s1", 2,
+ _g1h->max_capacity(),
+ survivor_space_committed(),
+ _young_collection_counters);
+}
+
+size_t G1MonitoringSupport::overall_committed() {
+ return g1h()->capacity();
+}
+
+size_t G1MonitoringSupport::overall_used() {
+ return g1h()->used_unlocked();
+}
+
+size_t G1MonitoringSupport::eden_space_committed() {
+ return MAX2(eden_space_used(), (size_t) HeapRegion::GrainBytes);
+}
+
+size_t G1MonitoringSupport::eden_space_used() {
+ size_t young_list_length = g1h()->young_list()->length();
+ size_t eden_used = young_list_length * HeapRegion::GrainBytes;
+ size_t survivor_used = survivor_space_used();
+ eden_used = subtract_up_to_zero(eden_used, survivor_used);
+ return eden_used;
+}
+
+size_t G1MonitoringSupport::survivor_space_committed() {
+ return MAX2(survivor_space_used(),
+ (size_t) HeapRegion::GrainBytes);
+}
+
+size_t G1MonitoringSupport::survivor_space_used() {
+ size_t survivor_num = g1h()->g1_policy()->recorded_survivor_regions();
+ size_t survivor_used = survivor_num * HeapRegion::GrainBytes;
+ return survivor_used;
+}
+
+size_t G1MonitoringSupport::old_space_committed() {
+ size_t committed = overall_committed();
+ size_t eden_committed = eden_space_committed();
+ size_t survivor_committed = survivor_space_committed();
+ committed = subtract_up_to_zero(committed, eden_committed);
+ committed = subtract_up_to_zero(committed, survivor_committed);
+ committed = MAX2(committed, (size_t) HeapRegion::GrainBytes);
+ return committed;
+}
+
+// See the comment near the top of g1MonitoringSupport.hpp for
+// an explanation of these calculations for "used" and "capacity".
+size_t G1MonitoringSupport::old_space_used() {
+ size_t used = overall_used();
+ size_t eden_used = eden_space_used();
+ size_t survivor_used = survivor_space_used();
+ used = subtract_up_to_zero(used, eden_used);
+ used = subtract_up_to_zero(used, survivor_used);
+ return used;
+}
+
+void G1MonitoringSupport::update_counters() {
+ if (UsePerfData) {
+ eden_counters()->update_capacity(eden_space_committed());
+ eden_counters()->update_used(eden_space_used());
+ to_counters()->update_capacity(survivor_space_committed());
+ to_counters()->update_used(survivor_space_used());
+ old_space_counters()->update_capacity(old_space_committed());
+ old_space_counters()->update_used(old_space_used());
+ non_young_collection_counters()->update_all();
+ }
+}
+
+void G1MonitoringSupport::update_eden_counters() {
+ if (UsePerfData) {
+ eden_counters()->update_capacity(eden_space_committed());
+ eden_counters()->update_used(eden_space_used());
+ }
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/src/share/vm/gc_implementation/g1/g1MonitoringSupport.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,203 @@
+/*
+ * Copyright (c) 2011, 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.
+ *
+ */
+
+#ifndef SHARE_VM_GC_IMPLEMENTATION_G1_G1MONITORINGSUPPORT_HPP
+#define SHARE_VM_GC_IMPLEMENTATION_G1_G1MONITORINGSUPPORT_HPP
+
+#include "gc_implementation/shared/hSpaceCounters.hpp"
+
+class G1CollectedHeap;
+class G1SpaceMonitoringSupport;
+
+// Class for monitoring logical spaces in G1.
+// G1 defines a set of regions as a young
+// collection (analogous to a young generation).
+// The young collection is a logical generation
+// with no fixed chunk (see space.hpp) reflecting
+// the address space for the generation. In addition
+// to the young collection there is its complement
+// the non-young collection that is simply the regions
+// not in the young collection. The non-young collection
+// is treated here as a logical old generation only
+// because the monitoring tools expect a generational
+// heap. The monitoring tools expect that a Space
+// (see space.hpp) exists that describe the
+// address space of young collection and non-young
+// collection and such a view is provided here.
+//
+// This class provides interfaces to access
+// the value of variables for the young collection
+// that include the "capacity" and "used" of the
+// young collection along with constant values
+// for the minimum and maximum capacities for
+// the logical spaces. Similarly for the non-young
+// collection.
+//
+// Also provided are counters for G1 concurrent collections
+// and stop-the-world full heap collecitons.
+//
+// Below is a description of how "used" and "capactiy"
+// (or committed) is calculated for the logical spaces.
+//
+// 1) The used space calculation for a pool is not necessarily
+// independent of the others. We can easily get from G1 the overall
+// used space in the entire heap, the number of regions in the young
+// generation (includes both eden and survivors), and the number of
+// survivor regions. So, from that we calculate:
+//
+// survivor_used = survivor_num * region_size
+// eden_used = young_region_num * region_size - survivor_used
+// old_gen_used = overall_used - eden_used - survivor_used
+//
+// Note that survivor_used and eden_used are upper bounds. To get the
+// actual value we would have to iterate over the regions and add up
+// ->used(). But that'd be expensive. So, we'll accept some lack of
+// accuracy for those two. But, we have to be careful when calculating
+// old_gen_used, in case we subtract from overall_used more then the
+// actual number and our result goes negative.
+//
+// 2) Calculating the used space is straightforward, as described
+// above. However, how do we calculate the committed space, given that
+// we allocate space for the eden, survivor, and old gen out of the
+// same pool of regions? One way to do this is to use the used value
+// as also the committed value for the eden and survivor spaces and
+// then calculate the old gen committed space as follows:
+//
+// old_gen_committed = overall_committed - eden_committed - survivor_committed
+//
+// Maybe a better way to do that would be to calculate used for eden
+// and survivor as a sum of ->used() over their regions and then
+// calculate committed as region_num * region_size (i.e., what we use
+// to calculate the used space now). This is something to consider
+// in the future.
+//
+// 3) Another decision that is again not straightforward is what is
+// the max size that each memory pool can grow to. One way to do this
+// would be to use the committed size for the max for the eden and
+// survivors and calculate the old gen max as follows (basically, it's
+// a similar pattern to what we use for the committed space, as
+// described above):
+//
+// old_gen_max = overall_max - eden_max - survivor_max
+//
+// Unfortunately, the above makes the max of each pool fluctuate over
+// time and, even though this is allowed according to the spec, it
+// broke several assumptions in the M&M framework (there were cases
+// where used would reach a value greater than max). So, for max we
+// use -1, which means "undefined" according to the spec.
+//
+// 4) Now, there is a very subtle issue with all the above. The
+// framework will call get_memory_usage() on the three pools
+// asynchronously. As a result, each call might get a different value
+// for, say, survivor_num which will yield inconsistent values for
+// eden_used, survivor_used, and old_gen_used (as survivor_num is used
+// in the calculation of all three). This would normally be
+// ok. However, it's possible that this might cause the sum of
+// eden_used, survivor_used, and old_gen_used to go over the max heap
+// size and this seems to sometimes cause JConsole (and maybe other
+// clients) to get confused. There's not a really an easy / clean
+// solution to this problem, due to the asynchrounous nature of the
+// framework.
+
+class G1MonitoringSupport : public CHeapObj {
+ G1CollectedHeap* _g1h;
+ VirtualSpace* _g1_storage_addr;
+
+ // jstat performance counters
+ // incremental collections both fully and partially young
+ CollectorCounters* _incremental_collection_counters;
+ // full stop-the-world collections
+ CollectorCounters* _full_collection_counters;
+ // young collection set counters. The _eden_counters,
+ // _from_counters, and _to_counters are associated with
+ // this "generational" counter.
+ GenerationCounters* _young_collection_counters;
+ // non-young collection set counters. The _old_space_counters
+ // below are associated with this "generational" counter.
+ GenerationCounters* _non_young_collection_counters;
+ // Counters for the capacity and used for
+ // the whole heap
+ HSpaceCounters* _old_space_counters;
+ // the young collection
+ HSpaceCounters* _eden_counters;
+ // the survivor collection (only one, _to_counters, is actively used)
+ HSpaceCounters* _from_counters;
+ HSpaceCounters* _to_counters;
+
+ // It returns x - y if x > y, 0 otherwise.
+ // As described in the comment above, some of the inputs to the
+ // calculations we have to do are obtained concurrently and hence
+ // may be inconsistent with each other. So, this provides a
+ // defensive way of performing the subtraction and avoids the value
+ // going negative (which would mean a very large result, given that
+ // the parameter are size_t).
+ static size_t subtract_up_to_zero(size_t x, size_t y) {
+ if (x > y) {
+ return x - y;
+ } else {
+ return 0;
+ }
+ }
+
+ public:
+ G1MonitoringSupport(G1CollectedHeap* g1h, VirtualSpace* g1_storage_addr);
+
+ G1CollectedHeap* g1h() { return _g1h; }
+ VirtualSpace* g1_storage_addr() { return _g1_storage_addr; }
+
+ // Performance Counter accessors
+ void update_counters();
+ void update_eden_counters();
+
+ CollectorCounters* incremental_collection_counters() {
+ return _incremental_collection_counters;
+ }
+ CollectorCounters* full_collection_counters() {
+ return _full_collection_counters;
+ }
+ GenerationCounters* non_young_collection_counters() {
+ return _non_young_collection_counters;
+ }
+ HSpaceCounters* old_space_counters() { return _old_space_counters; }
+ HSpaceCounters* eden_counters() { return _eden_counters; }
+ HSpaceCounters* from_counters() { return _from_counters; }
+ HSpaceCounters* to_counters() { return _to_counters; }
+
+ // Monitoring support used by
+ // MemoryService
+ // jstat counters
+ size_t overall_committed();
+ size_t overall_used();
+
+ size_t eden_space_committed();
+ size_t eden_space_used();
+
+ size_t survivor_space_committed();
+ size_t survivor_space_used();
+
+ size_t old_space_committed();
+ size_t old_space_used();
+};
+
+#endif // SHARE_VM_GC_IMPLEMENTATION_G1_G1MONITORINGSUPPORT_HPP
--- a/hotspot/src/share/vm/gc_implementation/g1/g1_globals.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/g1/g1_globals.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -300,6 +300,11 @@
develop(uintx, G1StressConcRegionFreeingDelayMillis, 0, \
"Artificial delay during concurrent region freeing") \
\
+ develop(uintx, G1DummyRegionsPerGC, 0, \
+ "The number of dummy regions G1 will allocate at the end of " \
+ "each evacuation pause in order to artificially fill up the " \
+ "heap and stress the marking implementation.") \
+ \
develop(bool, ReduceInitialCardMarksForG1, false, \
"When ReduceInitialCardMarks is true, this flag setting " \
" controls whether G1 allows the RICM optimization") \
--- a/hotspot/src/share/vm/gc_implementation/parNew/parCardTableModRefBS.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/parNew/parCardTableModRefBS.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -33,44 +33,43 @@
#include "runtime/mutexLocker.hpp"
#include "runtime/virtualspace.hpp"
-void CardTableModRefBS::par_non_clean_card_iterate_work(Space* sp, MemRegion mr,
- DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl,
- int n_threads) {
- if (n_threads > 0) {
- assert((n_threads == 1 && ParallelGCThreads == 0) ||
- n_threads <= (int)ParallelGCThreads,
- "# worker threads != # requested!");
- // Make sure the LNC array is valid for the space.
- jbyte** lowest_non_clean;
- uintptr_t lowest_non_clean_base_chunk_index;
- size_t lowest_non_clean_chunk_size;
- get_LNC_array_for_space(sp, lowest_non_clean,
- lowest_non_clean_base_chunk_index,
- lowest_non_clean_chunk_size);
+void CardTableModRefBS::non_clean_card_iterate_parallel_work(Space* sp, MemRegion mr,
+ DirtyCardToOopClosure* dcto_cl,
+ ClearNoncleanCardWrapper* cl,
+ int n_threads) {
+ assert(n_threads > 0, "Error: expected n_threads > 0");
+ assert((n_threads == 1 && ParallelGCThreads == 0) ||
+ n_threads <= (int)ParallelGCThreads,
+ "# worker threads != # requested!");
+ // Make sure the LNC array is valid for the space.
+ jbyte** lowest_non_clean;
+ uintptr_t lowest_non_clean_base_chunk_index;
+ size_t lowest_non_clean_chunk_size;
+ get_LNC_array_for_space(sp, lowest_non_clean,
+ lowest_non_clean_base_chunk_index,
+ lowest_non_clean_chunk_size);
- int n_strides = n_threads * StridesPerThread;
- SequentialSubTasksDone* pst = sp->par_seq_tasks();
- pst->set_n_threads(n_threads);
- pst->set_n_tasks(n_strides);
+ int n_strides = n_threads * StridesPerThread;
+ SequentialSubTasksDone* pst = sp->par_seq_tasks();
+ pst->set_n_threads(n_threads);
+ pst->set_n_tasks(n_strides);
- int stride = 0;
- while (!pst->is_task_claimed(/* reference */ stride)) {
- process_stride(sp, mr, stride, n_strides, dcto_cl, cl,
- lowest_non_clean,
- lowest_non_clean_base_chunk_index,
- lowest_non_clean_chunk_size);
- }
- if (pst->all_tasks_completed()) {
- // Clear lowest_non_clean array for next time.
- intptr_t first_chunk_index = addr_to_chunk_index(mr.start());
- uintptr_t last_chunk_index = addr_to_chunk_index(mr.last());
- for (uintptr_t ch = first_chunk_index; ch <= last_chunk_index; ch++) {
- intptr_t ind = ch - lowest_non_clean_base_chunk_index;
- assert(0 <= ind && ind < (intptr_t)lowest_non_clean_chunk_size,
- "Bounds error");
- lowest_non_clean[ind] = NULL;
- }
+ int stride = 0;
+ while (!pst->is_task_claimed(/* reference */ stride)) {
+ process_stride(sp, mr, stride, n_strides, dcto_cl, cl,
+ lowest_non_clean,
+ lowest_non_clean_base_chunk_index,
+ lowest_non_clean_chunk_size);
+ }
+ if (pst->all_tasks_completed()) {
+ // Clear lowest_non_clean array for next time.
+ intptr_t first_chunk_index = addr_to_chunk_index(mr.start());
+ uintptr_t last_chunk_index = addr_to_chunk_index(mr.last());
+ for (uintptr_t ch = first_chunk_index; ch <= last_chunk_index; ch++) {
+ intptr_t ind = ch - lowest_non_clean_base_chunk_index;
+ assert(0 <= ind && ind < (intptr_t)lowest_non_clean_chunk_size,
+ "Bounds error");
+ lowest_non_clean[ind] = NULL;
}
}
}
@@ -81,7 +80,7 @@
MemRegion used,
jint stride, int n_strides,
DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl,
+ ClearNoncleanCardWrapper* cl,
jbyte** lowest_non_clean,
uintptr_t lowest_non_clean_base_chunk_index,
size_t lowest_non_clean_chunk_size) {
@@ -127,7 +126,11 @@
lowest_non_clean_base_chunk_index,
lowest_non_clean_chunk_size);
- non_clean_card_iterate_work(chunk_mr, cl);
+ // We do not call the non_clean_card_iterate_serial() version because
+ // we want to clear the cards, and the ClearNoncleanCardWrapper closure
+ // itself does the work of finding contiguous dirty ranges of cards to
+ // process (and clear).
+ cl->do_MemRegion(chunk_mr);
// Find the next chunk of the stride.
chunk_card_start += CardsPerStrideChunk * n_strides;
--- a/hotspot/src/share/vm/gc_implementation/shared/generationCounters.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/shared/generationCounters.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2002, 2011, 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
@@ -51,15 +51,18 @@
cname = PerfDataManager::counter_name(_name_space, "minCapacity");
PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
+ _virtual_space == NULL ? 0 :
_virtual_space->committed_size(), CHECK);
cname = PerfDataManager::counter_name(_name_space, "maxCapacity");
PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
+ _virtual_space == NULL ? 0 :
_virtual_space->reserved_size(), CHECK);
cname = PerfDataManager::counter_name(_name_space, "capacity");
_current_size = PerfDataManager::create_variable(SUN_GC, cname,
- PerfData::U_Bytes,
+ PerfData::U_Bytes,
+ _virtual_space == NULL ? 0 :
_virtual_space->committed_size(), CHECK);
}
}
--- a/hotspot/src/share/vm/gc_implementation/shared/generationCounters.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/gc_implementation/shared/generationCounters.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2002, 2011, 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
@@ -61,10 +61,11 @@
}
virtual void update_all() {
- _current_size->set_value(_virtual_space->committed_size());
+ _current_size->set_value(_virtual_space == NULL ? 0 :
+ _virtual_space->committed_size());
}
const char* name_space() const { return _name_space; }
+
};
-
#endif // SHARE_VM_GC_IMPLEMENTATION_SHARED_GENERATIONCOUNTERS_HPP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/src/share/vm/gc_implementation/shared/hSpaceCounters.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2011, 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.
+ *
+ */
+
+#include "precompiled.hpp"
+#include "gc_implementation/shared/hSpaceCounters.hpp"
+#include "memory/generation.hpp"
+#include "memory/resourceArea.hpp"
+
+HSpaceCounters::HSpaceCounters(const char* name,
+ int ordinal,
+ size_t max_size,
+ size_t initial_capacity,
+ GenerationCounters* gc) {
+
+ if (UsePerfData) {
+ EXCEPTION_MARK;
+ ResourceMark rm;
+
+ const char* cns =
+ PerfDataManager::name_space(gc->name_space(), "space", ordinal);
+
+ _name_space = NEW_C_HEAP_ARRAY(char, strlen(cns)+1);
+ strcpy(_name_space, cns);
+
+ const char* cname = PerfDataManager::counter_name(_name_space, "name");
+ PerfDataManager::create_string_constant(SUN_GC, cname, name, CHECK);
+
+ cname = PerfDataManager::counter_name(_name_space, "maxCapacity");
+ PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
+ (jlong)max_size, CHECK);
+
+ cname = PerfDataManager::counter_name(_name_space, "capacity");
+ _capacity = PerfDataManager::create_variable(SUN_GC, cname,
+ PerfData::U_Bytes,
+ initial_capacity, CHECK);
+
+ cname = PerfDataManager::counter_name(_name_space, "used");
+ _used = PerfDataManager::create_variable(SUN_GC, cname, PerfData::U_Bytes,
+ (jlong) 0, CHECK);
+
+ cname = PerfDataManager::counter_name(_name_space, "initCapacity");
+ PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
+ initial_capacity, CHECK);
+ }
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hotspot/src/share/vm/gc_implementation/shared/hSpaceCounters.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2011, 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.
+ *
+ */
+
+#ifndef SHARE_VM_GC_IMPLEMENTATION_SHARED_HSPACECOUNTERS_HPP
+#define SHARE_VM_GC_IMPLEMENTATION_SHARED_HSPACECOUNTERS_HPP
+
+#ifndef SERIALGC
+#include "gc_implementation/shared/generationCounters.hpp"
+#include "memory/generation.hpp"
+#include "runtime/perfData.hpp"
+#endif
+
+// A HSpaceCounter is a holder class for performance counters
+// that track a collections (logical spaces) in a heap;
+
+class HeapSpaceUsedHelper;
+class G1SpaceMonitoringSupport;
+
+class HSpaceCounters: public CHeapObj {
+ friend class VMStructs;
+
+ private:
+ PerfVariable* _capacity;
+ PerfVariable* _used;
+
+ // Constant PerfData types don't need to retain a reference.
+ // However, it's a good idea to document them here.
+
+ char* _name_space;
+
+ public:
+
+ HSpaceCounters(const char* name, int ordinal, size_t max_size,
+ size_t initial_capacity, GenerationCounters* gc);
+
+ ~HSpaceCounters() {
+ if (_name_space != NULL) FREE_C_HEAP_ARRAY(char, _name_space);
+ }
+
+ inline void update_capacity(size_t v) {
+ _capacity->set_value(v);
+ }
+
+ inline void update_used(size_t v) {
+ _used->set_value(v);
+ }
+
+ debug_only(
+ // for security reasons, we do not allow arbitrary reads from
+ // the counters as they may live in shared memory.
+ jlong used() {
+ return _used->get_value();
+ }
+ jlong capacity() {
+ return _used->get_value();
+ }
+ )
+
+ inline void update_all(size_t capacity, size_t used) {
+ update_capacity(capacity);
+ update_used(used);
+ }
+
+ const char* name_space() const { return _name_space; }
+};
+#endif // SHARE_VM_GC_IMPLEMENTATION_SHARED_HSPACECOUNTERS_HPP
--- a/hotspot/src/share/vm/memory/cardTableModRefBS.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/cardTableModRefBS.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -456,31 +456,35 @@
}
-void CardTableModRefBS::non_clean_card_iterate(Space* sp,
- MemRegion mr,
- DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl) {
+void CardTableModRefBS::non_clean_card_iterate_possibly_parallel(Space* sp,
+ MemRegion mr,
+ DirtyCardToOopClosure* dcto_cl,
+ ClearNoncleanCardWrapper* cl) {
if (!mr.is_empty()) {
int n_threads = SharedHeap::heap()->n_par_threads();
if (n_threads > 0) {
#ifndef SERIALGC
- par_non_clean_card_iterate_work(sp, mr, dcto_cl, cl, n_threads);
+ non_clean_card_iterate_parallel_work(sp, mr, dcto_cl, cl, n_threads);
#else // SERIALGC
fatal("Parallel gc not supported here.");
#endif // SERIALGC
} else {
- non_clean_card_iterate_work(mr, cl);
+ // We do not call the non_clean_card_iterate_serial() version below because
+ // we want to clear the cards (which non_clean_card_iterate_serial() does not
+ // do for us), and the ClearNoncleanCardWrapper closure itself does the work
+ // of finding contiguous dirty ranges of cards to process (and clear).
+ cl->do_MemRegion(mr);
}
}
}
-// NOTE: For this to work correctly, it is important that
-// we look for non-clean cards below (so as to catch those
-// marked precleaned), rather than look explicitly for dirty
-// cards (and miss those marked precleaned). In that sense,
-// the name precleaned is currently somewhat of a misnomer.
-void CardTableModRefBS::non_clean_card_iterate_work(MemRegion mr,
- MemRegionClosure* cl) {
+// The iterator itself is not MT-aware, but
+// MT-aware callers and closures can use this to
+// accomplish dirty card iteration in parallel. The
+// iterator itself does not clear the dirty cards, or
+// change their values in any manner.
+void CardTableModRefBS::non_clean_card_iterate_serial(MemRegion mr,
+ MemRegionClosure* cl) {
for (int i = 0; i < _cur_covered_regions; i++) {
MemRegion mri = mr.intersection(_covered[i]);
if (mri.word_size() > 0) {
@@ -661,7 +665,7 @@
void CardTableModRefBS::verify_clean_region(MemRegion mr) {
GuaranteeNotModClosure blk(this);
- non_clean_card_iterate_work(mr, &blk);
+ non_clean_card_iterate_serial(mr, &blk);
}
// To verify a MemRegion is entirely dirty this closure is passed to
--- a/hotspot/src/share/vm/memory/cardTableModRefBS.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/cardTableModRefBS.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -44,6 +44,7 @@
class Generation;
class OopsInGenClosure;
class DirtyCardToOopClosure;
+class ClearNoncleanCardWrapper;
class CardTableModRefBS: public ModRefBarrierSet {
// Some classes get to look at some private stuff.
@@ -165,22 +166,28 @@
// Iterate over the portion of the card-table which covers the given
// region mr in the given space and apply cl to any dirty sub-regions
- // of mr. cl and dcto_cl must either be the same closure or cl must
- // wrap dcto_cl. Both are required - neither may be NULL. Also, dcto_cl
- // may be modified. Note that this function will operate in a parallel
- // mode if worker threads are available.
- void non_clean_card_iterate(Space* sp, MemRegion mr,
- DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl);
+ // of mr. Dirty cards are _not_ cleared by the iterator method itself,
+ // but closures may arrange to do so on their own should they so wish.
+ void non_clean_card_iterate_serial(MemRegion mr, MemRegionClosure* cl);
- // Utility function used to implement the other versions below.
- void non_clean_card_iterate_work(MemRegion mr, MemRegionClosure* cl);
+ // A variant of the above that will operate in a parallel mode if
+ // worker threads are available, and clear the dirty cards as it
+ // processes them.
+ // ClearNoncleanCardWrapper cl must wrap the DirtyCardToOopClosure dcto_cl,
+ // which may itself be modified by the method.
+ void non_clean_card_iterate_possibly_parallel(Space* sp, MemRegion mr,
+ DirtyCardToOopClosure* dcto_cl,
+ ClearNoncleanCardWrapper* cl);
- void par_non_clean_card_iterate_work(Space* sp, MemRegion mr,
- DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl,
- int n_threads);
+ private:
+ // Work method used to implement non_clean_card_iterate_possibly_parallel()
+ // above in the parallel case.
+ void non_clean_card_iterate_parallel_work(Space* sp, MemRegion mr,
+ DirtyCardToOopClosure* dcto_cl,
+ ClearNoncleanCardWrapper* cl,
+ int n_threads);
+ protected:
// Dirty the bytes corresponding to "mr" (not all of which must be
// covered.)
void dirty_MemRegion(MemRegion mr);
@@ -237,7 +244,7 @@
MemRegion used,
jint stride, int n_strides,
DirtyCardToOopClosure* dcto_cl,
- MemRegionClosure* cl,
+ ClearNoncleanCardWrapper* cl,
jbyte** lowest_non_clean,
uintptr_t lowest_non_clean_base_chunk_index,
size_t lowest_non_clean_chunk_size);
@@ -409,14 +416,14 @@
// marking, where a dirty card may cause scanning, and summarization
// marking, of objects that extend onto subsequent cards.)
void mod_card_iterate(MemRegionClosure* cl) {
- non_clean_card_iterate_work(_whole_heap, cl);
+ non_clean_card_iterate_serial(_whole_heap, cl);
}
// Like the "mod_cards_iterate" above, except only invokes the closure
// for cards within the MemRegion "mr" (which is required to be
// card-aligned and sized.)
void mod_card_iterate(MemRegion mr, MemRegionClosure* cl) {
- non_clean_card_iterate_work(mr, cl);
+ non_clean_card_iterate_serial(mr, cl);
}
static uintx ct_max_alignment_constraint();
@@ -493,4 +500,5 @@
void set_CTRS(CardTableRS* rs) { _rs = rs; }
};
+
#endif // SHARE_VM_MEMORY_CARDTABLEMODREFBS_HPP
--- a/hotspot/src/share/vm/memory/cardTableRS.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/cardTableRS.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -105,107 +105,111 @@
g->younger_refs_iterate(blk);
}
-class ClearNoncleanCardWrapper: public MemRegionClosure {
- MemRegionClosure* _dirty_card_closure;
- CardTableRS* _ct;
- bool _is_par;
-private:
- // Clears the given card, return true if the corresponding card should be
- // processed.
- bool clear_card(jbyte* entry) {
- if (_is_par) {
- while (true) {
- // In the parallel case, we may have to do this several times.
- jbyte entry_val = *entry;
- assert(entry_val != CardTableRS::clean_card_val(),
- "We shouldn't be looking at clean cards, and this should "
- "be the only place they get cleaned.");
- if (CardTableRS::card_is_dirty_wrt_gen_iter(entry_val)
- || _ct->is_prev_youngergen_card_val(entry_val)) {
- jbyte res =
- Atomic::cmpxchg(CardTableRS::clean_card_val(), entry, entry_val);
- if (res == entry_val) {
- break;
- } else {
- assert(res == CardTableRS::cur_youngergen_and_prev_nonclean_card,
- "The CAS above should only fail if another thread did "
- "a GC write barrier.");
- }
- } else if (entry_val ==
- CardTableRS::cur_youngergen_and_prev_nonclean_card) {
- // Parallelism shouldn't matter in this case. Only the thread
- // assigned to scan the card should change this value.
- *entry = _ct->cur_youngergen_card_val();
- break;
- } else {
- assert(entry_val == _ct->cur_youngergen_card_val(),
- "Should be the only possibility.");
- // In this case, the card was clean before, and become
- // cur_youngergen only because of processing of a promoted object.
- // We don't have to look at the card.
- return false;
- }
+inline bool ClearNoncleanCardWrapper::clear_card(jbyte* entry) {
+ if (_is_par) {
+ return clear_card_parallel(entry);
+ } else {
+ return clear_card_serial(entry);
+ }
+}
+
+inline bool ClearNoncleanCardWrapper::clear_card_parallel(jbyte* entry) {
+ while (true) {
+ // In the parallel case, we may have to do this several times.
+ jbyte entry_val = *entry;
+ assert(entry_val != CardTableRS::clean_card_val(),
+ "We shouldn't be looking at clean cards, and this should "
+ "be the only place they get cleaned.");
+ if (CardTableRS::card_is_dirty_wrt_gen_iter(entry_val)
+ || _ct->is_prev_youngergen_card_val(entry_val)) {
+ jbyte res =
+ Atomic::cmpxchg(CardTableRS::clean_card_val(), entry, entry_val);
+ if (res == entry_val) {
+ break;
+ } else {
+ assert(res == CardTableRS::cur_youngergen_and_prev_nonclean_card,
+ "The CAS above should only fail if another thread did "
+ "a GC write barrier.");
}
- return true;
+ } else if (entry_val ==
+ CardTableRS::cur_youngergen_and_prev_nonclean_card) {
+ // Parallelism shouldn't matter in this case. Only the thread
+ // assigned to scan the card should change this value.
+ *entry = _ct->cur_youngergen_card_val();
+ break;
} else {
- jbyte entry_val = *entry;
- assert(entry_val != CardTableRS::clean_card_val(),
- "We shouldn't be looking at clean cards, and this should "
- "be the only place they get cleaned.");
- assert(entry_val != CardTableRS::cur_youngergen_and_prev_nonclean_card,
- "This should be possible in the sequential case.");
- *entry = CardTableRS::clean_card_val();
- return true;
+ assert(entry_val == _ct->cur_youngergen_card_val(),
+ "Should be the only possibility.");
+ // In this case, the card was clean before, and become
+ // cur_youngergen only because of processing of a promoted object.
+ // We don't have to look at the card.
+ return false;
}
}
+ return true;
+}
-public:
- ClearNoncleanCardWrapper(MemRegionClosure* dirty_card_closure,
- CardTableRS* ct) :
+
+inline bool ClearNoncleanCardWrapper::clear_card_serial(jbyte* entry) {
+ jbyte entry_val = *entry;
+ assert(entry_val != CardTableRS::clean_card_val(),
+ "We shouldn't be looking at clean cards, and this should "
+ "be the only place they get cleaned.");
+ assert(entry_val != CardTableRS::cur_youngergen_and_prev_nonclean_card,
+ "This should be possible in the sequential case.");
+ *entry = CardTableRS::clean_card_val();
+ return true;
+}
+
+ClearNoncleanCardWrapper::ClearNoncleanCardWrapper(
+ MemRegionClosure* dirty_card_closure, CardTableRS* ct) :
_dirty_card_closure(dirty_card_closure), _ct(ct) {
_is_par = (SharedHeap::heap()->n_par_threads() > 0);
+}
+
+void ClearNoncleanCardWrapper::do_MemRegion(MemRegion mr) {
+ assert(mr.word_size() > 0, "Error");
+ assert(_ct->is_aligned(mr.start()), "mr.start() should be card aligned");
+ // mr.end() may not necessarily be card aligned.
+ jbyte* cur_entry = _ct->byte_for(mr.last());
+ const jbyte* limit = _ct->byte_for(mr.start());
+ HeapWord* end_of_non_clean = mr.end();
+ HeapWord* start_of_non_clean = end_of_non_clean;
+ while (cur_entry >= limit) {
+ HeapWord* cur_hw = _ct->addr_for(cur_entry);
+ if ((*cur_entry != CardTableRS::clean_card_val()) && clear_card(cur_entry)) {
+ // Continue the dirty range by opening the
+ // dirty window one card to the left.
+ start_of_non_clean = cur_hw;
+ } else {
+ // We hit a "clean" card; process any non-empty
+ // "dirty" range accumulated so far.
+ if (start_of_non_clean < end_of_non_clean) {
+ const MemRegion mrd(start_of_non_clean, end_of_non_clean);
+ _dirty_card_closure->do_MemRegion(mrd);
+ }
+ // Reset the dirty window, while continuing to look
+ // for the next dirty card that will start a
+ // new dirty window.
+ end_of_non_clean = cur_hw;
+ start_of_non_clean = cur_hw;
+ }
+ // Note that "cur_entry" leads "start_of_non_clean" in
+ // its leftward excursion after this point
+ // in the loop and, when we hit the left end of "mr",
+ // will point off of the left end of the card-table
+ // for "mr".
+ cur_entry--;
}
- void do_MemRegion(MemRegion mr) {
- // We start at the high end of "mr", walking backwards
- // while accumulating a contiguous dirty range of cards in
- // [start_of_non_clean, end_of_non_clean) which we then
- // process en masse.
- HeapWord* end_of_non_clean = mr.end();
- HeapWord* start_of_non_clean = end_of_non_clean;
- jbyte* entry = _ct->byte_for(mr.last());
- const jbyte* first_entry = _ct->byte_for(mr.start());
- while (entry >= first_entry) {
- HeapWord* cur = _ct->addr_for(entry);
- if (!clear_card(entry)) {
- // We hit a clean card; process any non-empty
- // dirty range accumulated so far.
- if (start_of_non_clean < end_of_non_clean) {
- MemRegion mr2(start_of_non_clean, end_of_non_clean);
- _dirty_card_closure->do_MemRegion(mr2);
- }
- // Reset the dirty window while continuing to
- // look for the next dirty window to process.
- end_of_non_clean = cur;
- start_of_non_clean = end_of_non_clean;
- }
- // Open the left end of the window one card to the left.
- start_of_non_clean = cur;
- // Note that "entry" leads "start_of_non_clean" in
- // its leftward excursion after this point
- // in the loop and, when we hit the left end of "mr",
- // will point off of the left end of the card-table
- // for "mr".
- entry--;
- }
- // If the first card of "mr" was dirty, we will have
- // been left with a dirty window, co-initial with "mr",
- // which we now process.
- if (start_of_non_clean < end_of_non_clean) {
- MemRegion mr2(start_of_non_clean, end_of_non_clean);
- _dirty_card_closure->do_MemRegion(mr2);
- }
+ // If the first card of "mr" was dirty, we will have
+ // been left with a dirty window, co-initial with "mr",
+ // which we now process.
+ if (start_of_non_clean < end_of_non_clean) {
+ const MemRegion mrd(start_of_non_clean, end_of_non_clean);
+ _dirty_card_closure->do_MemRegion(mrd);
}
-};
+}
+
// clean (by dirty->clean before) ==> cur_younger_gen
// dirty ==> cur_youngergen_and_prev_nonclean_card
// precleaned ==> cur_youngergen_and_prev_nonclean_card
@@ -246,8 +250,35 @@
cl->gen_boundary());
ClearNoncleanCardWrapper clear_cl(dcto_cl, this);
- _ct_bs->non_clean_card_iterate(sp, sp->used_region_at_save_marks(),
- dcto_cl, &clear_cl);
+ const MemRegion urasm = sp->used_region_at_save_marks();
+#ifdef ASSERT
+ // Convert the assertion check to a warning if we are running
+ // CMS+ParNew until related bug is fixed.
+ MemRegion ur = sp->used_region();
+ assert(ur.contains(urasm) || (UseConcMarkSweepGC && UseParNewGC),
+ err_msg("Did you forget to call save_marks()? "
+ "[" PTR_FORMAT ", " PTR_FORMAT ") is not contained in "
+ "[" PTR_FORMAT ", " PTR_FORMAT ")",
+ urasm.start(), urasm.end(), ur.start(), ur.end()));
+ // In the case of CMS+ParNew, issue a warning
+ if (!ur.contains(urasm)) {
+ assert(UseConcMarkSweepGC && UseParNewGC, "Tautology: see assert above");
+ warning("CMS+ParNew: Did you forget to call save_marks()? "
+ "[" PTR_FORMAT ", " PTR_FORMAT ") is not contained in "
+ "[" PTR_FORMAT ", " PTR_FORMAT ")",
+ urasm.start(), urasm.end(), ur.start(), ur.end());
+ MemRegion ur2 = sp->used_region();
+ MemRegion urasm2 = sp->used_region_at_save_marks();
+ if (!ur.equals(ur2)) {
+ warning("CMS+ParNew: Flickering used_region()!!");
+ }
+ if (!urasm.equals(urasm2)) {
+ warning("CMS+ParNew: Flickering used_region_at_save_marks()!!");
+ }
+ }
+#endif
+ _ct_bs->non_clean_card_iterate_possibly_parallel(sp, urasm,
+ dcto_cl, &clear_cl);
}
void CardTableRS::clear_into_younger(Generation* gen, bool clear_perm) {
--- a/hotspot/src/share/vm/memory/cardTableRS.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/cardTableRS.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2011, 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
@@ -166,4 +166,21 @@
};
+class ClearNoncleanCardWrapper: public MemRegionClosure {
+ MemRegionClosure* _dirty_card_closure;
+ CardTableRS* _ct;
+ bool _is_par;
+private:
+ // Clears the given card, return true if the corresponding card should be
+ // processed.
+ inline bool clear_card(jbyte* entry);
+ // Work methods called by the clear_card()
+ inline bool clear_card_serial(jbyte* entry);
+ inline bool clear_card_parallel(jbyte* entry);
+
+public:
+ ClearNoncleanCardWrapper(MemRegionClosure* dirty_card_closure, CardTableRS* ct);
+ void do_MemRegion(MemRegion mr);
+};
+
#endif // SHARE_VM_MEMORY_CARDTABLERS_HPP
--- a/hotspot/src/share/vm/memory/genCollectedHeap.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/genCollectedHeap.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -427,13 +427,13 @@
// explicitly mark reachable objects in younger generations, to avoid
// excess storage retention.) If "collecting_perm_gen" is false, then
// roots that may only contain references to permGen objects are not
- // scanned. The "so" argument determines which of the roots
+ // scanned; instead, the older_gens closure is applied to all outgoing
+ // references in the perm gen. The "so" argument determines which of the roots
// the closure is applied to:
// "SO_None" does none;
// "SO_AllClasses" applies the closure to all entries in the SystemDictionary;
// "SO_SystemClasses" to all the "system" classes and loaders;
- // "SO_Symbols_and_Strings" applies the closure to all entries in
- // SymbolsTable and StringTable.
+ // "SO_Strings" applies the closure to all entries in the StringTable.
void gen_process_strong_roots(int level,
bool younger_gens_as_roots,
// The remaining arguments are in an order
--- a/hotspot/src/share/vm/memory/genOopClosures.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/genOopClosures.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2011, 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
@@ -175,7 +175,7 @@
protected:
template <class T> inline void do_oop_work(T* p) {
oop obj = oopDesc::load_decode_heap_oop(p);
- guarantee(obj->is_oop_or_null(), "invalid oop");
+ guarantee(obj->is_oop_or_null(), err_msg("invalid oop: " INTPTR_FORMAT, obj));
}
public:
virtual void do_oop(oop* p);
--- a/hotspot/src/share/vm/memory/sharedHeap.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/sharedHeap.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -46,7 +46,6 @@
SH_PS_Management_oops_do,
SH_PS_SystemDictionary_oops_do,
SH_PS_jvmti_oops_do,
- SH_PS_SymbolTable_oops_do,
SH_PS_StringTable_oops_do,
SH_PS_CodeCache_oops_do,
// Leave this one last.
@@ -161,13 +160,9 @@
if (!_process_strong_tasks->is_task_claimed(SH_PS_SystemDictionary_oops_do)) {
if (so & SO_AllClasses) {
SystemDictionary::oops_do(roots);
- } else
- if (so & SO_SystemClasses) {
- SystemDictionary::always_strong_oops_do(roots);
- }
- }
-
- if (!_process_strong_tasks->is_task_claimed(SH_PS_SymbolTable_oops_do)) {
+ } else if (so & SO_SystemClasses) {
+ SystemDictionary::always_strong_oops_do(roots);
+ }
}
if (!_process_strong_tasks->is_task_claimed(SH_PS_StringTable_oops_do)) {
--- a/hotspot/src/share/vm/memory/sharedHeap.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/memory/sharedHeap.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -192,9 +192,8 @@
SO_None = 0x0,
SO_AllClasses = 0x1,
SO_SystemClasses = 0x2,
- SO_Symbols = 0x4,
- SO_Strings = 0x8,
- SO_CodeCache = 0x10
+ SO_Strings = 0x4,
+ SO_CodeCache = 0x8
};
FlexibleWorkGang* workers() const { return _workers; }
@@ -208,14 +207,13 @@
// Invoke the "do_oop" method the closure "roots" on all root locations.
// If "collecting_perm_gen" is false, then roots that may only contain
- // references to permGen objects are not scanned. If true, the
- // "perm_gen" closure is applied to all older-to-younger refs in the
+ // references to permGen objects are not scanned; instead, in that case,
+ // the "perm_blk" closure is applied to all outgoing refs in the
// permanent generation. The "so" argument determines which of roots
// the closure is applied to:
// "SO_None" does none;
// "SO_AllClasses" applies the closure to all entries in the SystemDictionary;
// "SO_SystemClasses" to all the "system" classes and loaders;
- // "SO_Symbols" applies the closure to all entries in SymbolsTable;
// "SO_Strings" applies the closure to all entries in StringTable;
// "SO_CodeCache" applies the closure to all elements of the CodeCache.
void process_strong_roots(bool activate_scope,
--- a/hotspot/src/share/vm/oops/cpCacheOop.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/oops/cpCacheOop.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -104,7 +104,7 @@
void* result = Atomic::cmpxchg_ptr(f1, f1_addr, NULL);
bool success = (result == NULL);
if (success) {
- update_barrier_set(f1_addr, f1);
+ update_barrier_set((void*) f1_addr, f1);
}
}
@@ -275,21 +275,23 @@
return (int) bsm_cache_index;
}
-void ConstantPoolCacheEntry::set_dynamic_call(Handle call_site,
- methodHandle signature_invoker) {
+void ConstantPoolCacheEntry::set_dynamic_call(Handle call_site, methodHandle signature_invoker) {
assert(is_secondary_entry(), "");
+ // NOTE: it's important that all other values are set before f1 is
+ // set since some users short circuit on f1 being set
+ // (i.e. non-null) and that may result in uninitialized values for
+ // other racing threads (e.g. flags).
int param_size = signature_invoker->size_of_parameters();
assert(param_size >= 1, "method argument size must include MH.this");
- param_size -= 1; // do not count MH.this; it is not stacked for invokedynamic
- if (Atomic::cmpxchg_ptr(call_site(), &_f1, NULL) == NULL) {
- // racing threads might be trying to install their own favorites
- set_f1(call_site());
- }
+ param_size -= 1; // do not count MH.this; it is not stacked for invokedynamic
bool is_final = true;
assert(signature_invoker->is_final_method(), "is_final");
- set_flags(as_flags(as_TosState(signature_invoker->result_type()), is_final, false, false, false, true) | param_size);
+ int flags = as_flags(as_TosState(signature_invoker->result_type()), is_final, false, false, false, true) | param_size;
+ assert(_flags == 0 || _flags == flags, "flags should be the same");
+ set_flags(flags);
// do not do set_bytecode on a secondary CP cache entry
//set_bytecode_1(Bytecodes::_invokedynamic);
+ set_f1_if_null_atomic(call_site()); // This must be the last one to set (see NOTE above)!
}
--- a/hotspot/src/share/vm/opto/escape.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/escape.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1437,7 +1437,10 @@
// Update the memory inputs of MemNodes with the value we computed
// in Phase 2 and move stores memory users to corresponding memory slices.
-#ifdef ASSERT
+
+ // Disable memory split verification code until the fix for 6984348.
+ // Currently it produces false negative results since it does not cover all cases.
+#if 0 // ifdef ASSERT
visited.Reset();
Node_Stack old_mems(arena, _compile->unique() >> 2);
#endif
@@ -1447,7 +1450,7 @@
Node *n = ptnode_adr(i)->_node;
assert(n != NULL, "sanity");
if (n->is_Mem()) {
-#ifdef ASSERT
+#if 0 // ifdef ASSERT
Node* old_mem = n->in(MemNode::Memory);
if (!visited.test_set(old_mem->_idx)) {
old_mems.push(old_mem, old_mem->outcnt());
@@ -1469,13 +1472,13 @@
}
}
}
-#ifdef ASSERT
+#if 0 // ifdef ASSERT
// Verify that memory was split correctly
while (old_mems.is_nonempty()) {
Node* old_mem = old_mems.node();
uint old_cnt = old_mems.index();
old_mems.pop();
- assert(old_cnt = old_mem->outcnt(), "old mem could be lost");
+ assert(old_cnt == old_mem->outcnt(), "old mem could be lost");
}
#endif
}
--- a/hotspot/src/share/vm/opto/graphKit.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/graphKit.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1033,14 +1033,10 @@
iter.reset_to_bci(bci());
iter.next();
ciMethod* method = iter.get_method(ignore);
- inputs = method->arg_size_no_receiver();
- // Add a receiver argument, maybe:
- if (code != Bytecodes::_invokestatic &&
- code != Bytecodes::_invokedynamic)
- inputs += 1;
// (Do not use ciMethod::arg_size(), because
// it might be an unloaded method, which doesn't
// know whether it is static or not.)
+ inputs = method->invoke_arg_size(code);
int size = method->return_type()->size();
depth = size - inputs;
}
@@ -2957,8 +2953,7 @@
//---------------------------set_output_for_allocation-------------------------
Node* GraphKit::set_output_for_allocation(AllocateNode* alloc,
- const TypeOopPtr* oop_type,
- bool raw_mem_only) {
+ const TypeOopPtr* oop_type) {
int rawidx = Compile::AliasIdxRaw;
alloc->set_req( TypeFunc::FramePtr, frameptr() );
add_safepoint_edges(alloc);
@@ -2982,7 +2977,7 @@
rawoop)->as_Initialize();
assert(alloc->initialization() == init, "2-way macro link must work");
assert(init ->allocation() == alloc, "2-way macro link must work");
- if (ReduceFieldZeroing && !raw_mem_only) {
+ {
// Extract memory strands which may participate in the new object's
// initialization, and source them from the new InitializeNode.
// This will allow us to observe initializations when they occur,
@@ -3043,11 +3038,9 @@
// the type to a constant.
// The optional arguments are for specialized use by intrinsics:
// - If 'extra_slow_test' if not null is an extra condition for the slow-path.
-// - If 'raw_mem_only', do not cast the result to an oop.
// - If 'return_size_val', report the the total object size to the caller.
Node* GraphKit::new_instance(Node* klass_node,
Node* extra_slow_test,
- bool raw_mem_only, // affect only raw memory
Node* *return_size_val) {
// Compute size in doublewords
// The size is always an integral number of doublewords, represented
@@ -3118,7 +3111,7 @@
size, klass_node,
initial_slow_test);
- return set_output_for_allocation(alloc, oop_type, raw_mem_only);
+ return set_output_for_allocation(alloc, oop_type);
}
//-------------------------------new_array-------------------------------------
@@ -3128,7 +3121,6 @@
Node* GraphKit::new_array(Node* klass_node, // array klass (maybe variable)
Node* length, // number of array elements
int nargs, // number of arguments to push back for uncommon trap
- bool raw_mem_only, // affect only raw memory
Node* *return_size_val) {
jint layout_con = Klass::_lh_neutral_value;
Node* layout_val = get_layout_helper(klass_node, layout_con);
@@ -3273,7 +3265,7 @@
ary_type = ary_type->is_aryptr()->cast_to_size(length_type);
}
- Node* javaoop = set_output_for_allocation(alloc, ary_type, raw_mem_only);
+ Node* javaoop = set_output_for_allocation(alloc, ary_type);
// Cast length on remaining path to be as narrow as possible
if (map()->find_edge(length) >= 0) {
@@ -3462,9 +3454,22 @@
// Get the alias_index for raw card-mark memory
int adr_type = Compile::AliasIdxRaw;
+ Node* zero = __ ConI(0); // Dirty card value
+ BasicType bt = T_BYTE;
+
+ if (UseCondCardMark) {
+ // The classic GC reference write barrier is typically implemented
+ // as a store into the global card mark table. Unfortunately
+ // unconditional stores can result in false sharing and excessive
+ // coherence traffic as well as false transactional aborts.
+ // UseCondCardMark enables MP "polite" conditional card mark
+ // stores. In theory we could relax the load from ctrl() to
+ // no_ctrl, but that doesn't buy much latitude.
+ Node* card_val = __ load( __ ctrl(), card_adr, TypeInt::BYTE, bt, adr_type);
+ __ if_then(card_val, BoolTest::ne, zero);
+ }
+
// Smash zero into card
- Node* zero = __ ConI(0);
- BasicType bt = T_BYTE;
if( !UseConcMarkSweepGC ) {
__ store(__ ctrl(), card_adr, zero, bt, adr_type);
} else {
@@ -3472,6 +3477,10 @@
__ storeCM(__ ctrl(), card_adr, zero, oop_store, adr_idx, bt, adr_type);
}
+ if (UseCondCardMark) {
+ __ end_if();
+ }
+
// Final sync IdealKit and GraphKit.
final_sync(ideal);
}
--- a/hotspot/src/share/vm/opto/graphKit.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/graphKit.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -773,15 +773,13 @@
// implementation of object creation
Node* set_output_for_allocation(AllocateNode* alloc,
- const TypeOopPtr* oop_type,
- bool raw_mem_only);
+ const TypeOopPtr* oop_type);
Node* get_layout_helper(Node* klass_node, jint& constant_value);
Node* new_instance(Node* klass_node,
Node* slow_test = NULL,
- bool raw_mem_only = false,
Node* *return_size_val = NULL);
Node* new_array(Node* klass_node, Node* count_val, int nargs,
- bool raw_mem_only = false, Node* *return_size_val = NULL);
+ Node* *return_size_val = NULL);
// Handy for making control flow
IfNode* create_and_map_if(Node* ctrl, Node* tst, float prob, float cnt) {
--- a/hotspot/src/share/vm/opto/library_call.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/library_call.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -3527,8 +3527,7 @@
Node* orig_tail = _gvn.transform( new(C, 3) SubINode(orig_length, start) );
Node* moved = generate_min_max(vmIntrinsics::_min, orig_tail, length);
- const bool raw_mem_only = true;
- newcopy = new_array(klass_node, length, 0, raw_mem_only);
+ newcopy = new_array(klass_node, length, 0);
// Generate a direct call to the right arraycopy function(s).
// We know the copy is disjoint but we might not know if the
@@ -4325,8 +4324,6 @@
const TypePtr* raw_adr_type = TypeRawPtr::BOTTOM;
int raw_adr_idx = Compile::AliasIdxRaw;
- const bool raw_mem_only = true;
-
Node* array_ctl = generate_array_guard(obj_klass, (RegionNode*)NULL);
if (array_ctl != NULL) {
@@ -4335,8 +4332,7 @@
set_control(array_ctl);
Node* obj_length = load_array_length(obj);
Node* obj_size = NULL;
- Node* alloc_obj = new_array(obj_klass, obj_length, 0,
- raw_mem_only, &obj_size);
+ Node* alloc_obj = new_array(obj_klass, obj_length, 0, &obj_size);
if (!use_ReduceInitialCardMarks()) {
// If it is an oop array, it requires very special treatment,
@@ -4408,7 +4404,7 @@
// It's an instance, and it passed the slow-path tests.
PreserveJVMState pjvms(this);
Node* obj_size = NULL;
- Node* alloc_obj = new_instance(obj_klass, NULL, raw_mem_only, &obj_size);
+ Node* alloc_obj = new_instance(obj_klass, NULL, &obj_size);
copy_to_clone(obj, alloc_obj, obj_size, false, !use_ReduceInitialCardMarks());
--- a/hotspot/src/share/vm/opto/loopopts.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/loopopts.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -2262,6 +2262,9 @@
// stmt1
// |
// v
+// loop predicate
+// |
+// v
// stmt2 clone
// |
// v
@@ -2272,9 +2275,6 @@
// : false true
// : | |
// : | v
-// : | loop predicate
-// : | |
-// : | v
// : | newloop<-----+
// : | | |
// : | stmt3 clone |
@@ -2330,7 +2330,6 @@
}
}
- Node* entry = head->in(LoopNode::EntryControl);
int dd = dom_depth(head);
// Step 1: find cut point
@@ -2627,8 +2626,6 @@
// Backedge of the surviving new_head (the clone) is original last_peel
_igvn.hash_delete(new_head_clone);
- Node* new_entry = move_loop_predicates(entry, new_head_clone->in(LoopNode::EntryControl));
- new_head_clone->set_req(LoopNode::EntryControl, new_entry);
new_head_clone->set_req(LoopNode::LoopBackControl, last_peel);
_igvn._worklist.push(new_head_clone);
--- a/hotspot/src/share/vm/opto/macro.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/macro.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -221,9 +221,16 @@
Node *shift = p2x->unique_out();
Node *addp = shift->unique_out();
for (DUIterator_Last jmin, j = addp->last_outs(jmin); j >= jmin; --j) {
- Node *st = addp->last_out(j);
- assert(st->is_Store(), "store required");
- _igvn.replace_node(st, st->in(MemNode::Memory));
+ Node *mem = addp->last_out(j);
+ if (UseCondCardMark && mem->is_Load()) {
+ assert(mem->Opcode() == Op_LoadB, "unexpected code shape");
+ // The load is checking if the card has been written so
+ // replace it with zero to fold the test.
+ _igvn.replace_node(mem, intcon(0));
+ continue;
+ }
+ assert(mem->is_Store(), "store required");
+ _igvn.replace_node(mem, mem->in(MemNode::Memory));
}
} else {
// G1 pre/post barriers
--- a/hotspot/src/share/vm/opto/memnode.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/memnode.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1259,15 +1259,18 @@
return NULL; // Wait stable graph
}
uint cnt = mem->req();
- for( uint i = 1; i < cnt; i++ ) {
+ for (uint i = 1; i < cnt; i++) {
+ Node* rc = region->in(i);
+ if (rc == NULL || phase->type(rc) == Type::TOP)
+ return NULL; // Wait stable graph
Node *in = mem->in(i);
- if( in == NULL ) {
+ if (in == NULL) {
return NULL; // Wait stable graph
}
}
// Check for loop invariant.
if (cnt == 3) {
- for( uint i = 1; i < cnt; i++ ) {
+ for (uint i = 1; i < cnt; i++) {
Node *in = mem->in(i);
Node* m = MemNode::optimize_memory_chain(in, addr_t, phase);
if (m == mem) {
@@ -1281,38 +1284,37 @@
// Do nothing here if Identity will find a value
// (to avoid infinite chain of value phis generation).
- if ( !phase->eqv(this, this->Identity(phase)) )
+ if (!phase->eqv(this, this->Identity(phase)))
return NULL;
// Skip the split if the region dominates some control edge of the address.
- if (cnt == 3 && !MemNode::all_controls_dominate(address, region))
+ if (!MemNode::all_controls_dominate(address, region))
return NULL;
const Type* this_type = this->bottom_type();
int this_index = phase->C->get_alias_index(addr_t);
int this_offset = addr_t->offset();
int this_iid = addr_t->is_oopptr()->instance_id();
- int wins = 0;
PhaseIterGVN *igvn = phase->is_IterGVN();
Node *phi = new (igvn->C, region->req()) PhiNode(region, this_type, NULL, this_iid, this_index, this_offset);
- for( uint i = 1; i < region->req(); i++ ) {
+ for (uint i = 1; i < region->req(); i++) {
Node *x;
Node* the_clone = NULL;
- if( region->in(i) == phase->C->top() ) {
+ if (region->in(i) == phase->C->top()) {
x = phase->C->top(); // Dead path? Use a dead data op
} else {
x = this->clone(); // Else clone up the data op
the_clone = x; // Remember for possible deletion.
// Alter data node to use pre-phi inputs
- if( this->in(0) == region ) {
- x->set_req( 0, region->in(i) );
+ if (this->in(0) == region) {
+ x->set_req(0, region->in(i));
} else {
- x->set_req( 0, NULL );
+ x->set_req(0, NULL);
}
- for( uint j = 1; j < this->req(); j++ ) {
+ for (uint j = 1; j < this->req(); j++) {
Node *in = this->in(j);
- if( in->is_Phi() && in->in(0) == region )
- x->set_req( j, in->in(i) ); // Use pre-Phi input for the clone
+ if (in->is_Phi() && in->in(0) == region)
+ x->set_req(j, in->in(i)); // Use pre-Phi input for the clone
}
}
// Check for a 'win' on some paths
@@ -1321,12 +1323,11 @@
bool singleton = t->singleton();
// See comments in PhaseIdealLoop::split_thru_phi().
- if( singleton && t == Type::TOP ) {
+ if (singleton && t == Type::TOP) {
singleton &= region->is_Loop() && (i != LoopNode::EntryControl);
}
- if( singleton ) {
- wins++;
+ if (singleton) {
x = igvn->makecon(t);
} else {
// We now call Identity to try to simplify the cloned node.
@@ -1340,13 +1341,11 @@
// igvn->type(x) is set to x->Value() already.
x->raise_bottom_type(t);
Node *y = x->Identity(igvn);
- if( y != x ) {
- wins++;
+ if (y != x) {
x = y;
} else {
y = igvn->hash_find(x);
- if( y ) {
- wins++;
+ if (y) {
x = y;
} else {
// Else x is a new node we are keeping
@@ -1360,13 +1359,9 @@
igvn->remove_dead_node(the_clone);
phi->set_req(i, x);
}
- if( wins > 0 ) {
- // Record Phi
- igvn->register_new_node_with_optimizer(phi);
- return phi;
- }
- igvn->remove_dead_node(phi);
- return NULL;
+ // Record Phi
+ igvn->register_new_node_with_optimizer(phi);
+ return phi;
}
//------------------------------Ideal------------------------------------------
@@ -1677,14 +1672,15 @@
// If we are loading from a freshly-allocated object, produce a zero,
// if the load is provably beyond the header of the object.
// (Also allow a variable load from a fresh array to produce zero.)
- if (ReduceFieldZeroing) {
+ const TypeOopPtr *tinst = tp->isa_oopptr();
+ bool is_instance = (tinst != NULL) && tinst->is_known_instance_field();
+ if (ReduceFieldZeroing || is_instance) {
Node* value = can_see_stored_value(mem,phase);
if (value != NULL && value->is_Con())
return value->bottom_type();
}
- const TypeOopPtr *tinst = tp->isa_oopptr();
- if (tinst != NULL && tinst->is_known_instance_field()) {
+ if (is_instance) {
// If we have an instance type and our memory input is the
// programs's initial memory state, there is no matching store,
// so just return a zero of the appropriate type
--- a/hotspot/src/share/vm/opto/stringopts.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/opto/stringopts.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1172,16 +1172,16 @@
Node* PhaseStringOpts::copy_string(GraphKit& kit, Node* str, Node* char_array, Node* start) {
Node* string = str;
- Node* offset = kit.make_load(NULL,
+ Node* offset = kit.make_load(kit.control(),
kit.basic_plus_adr(string, string, java_lang_String::offset_offset_in_bytes()),
TypeInt::INT, T_INT, offset_field_idx);
- Node* count = kit.make_load(NULL,
+ Node* count = kit.make_load(kit.control(),
kit.basic_plus_adr(string, string, java_lang_String::count_offset_in_bytes()),
TypeInt::INT, T_INT, count_field_idx);
const TypeAryPtr* value_type = TypeAryPtr::make(TypePtr::NotNull,
TypeAry::make(TypeInt::CHAR,TypeInt::POS),
ciTypeArrayKlass::make(T_CHAR), true, 0);
- Node* value = kit.make_load(NULL,
+ Node* value = kit.make_load(kit.control(),
kit.basic_plus_adr(string, string, java_lang_String::value_offset_in_bytes()),
value_type, T_OBJECT, value_field_idx);
@@ -1342,7 +1342,7 @@
}
// Node* offset = kit.make_load(NULL, kit.basic_plus_adr(arg, arg, offset_offset),
// TypeInt::INT, T_INT, offset_field_idx);
- Node* count = kit.make_load(NULL, kit.basic_plus_adr(arg, arg, java_lang_String::count_offset_in_bytes()),
+ Node* count = kit.make_load(kit.control(), kit.basic_plus_adr(arg, arg, java_lang_String::count_offset_in_bytes()),
TypeInt::INT, T_INT, count_field_idx);
length = __ AddI(length, count);
string_sizes->init_req(argi, NULL);
--- a/hotspot/src/share/vm/prims/methodHandleWalk.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/prims/methodHandleWalk.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -82,10 +82,8 @@
void MethodHandleChain::set_last_method(oop target, TRAPS) {
_is_last = true;
- klassOop receiver_limit_oop = NULL;
- int flags = 0;
- methodOop m = MethodHandles::decode_method(target, receiver_limit_oop, flags);
- _last_method = methodHandle(THREAD, m);
+ KlassHandle receiver_limit; int flags = 0;
+ _last_method = MethodHandles::decode_method(target, receiver_limit, flags);
if ((flags & MethodHandles::_dmf_has_receiver) == 0)
_last_invoke = Bytecodes::_invokestatic;
else if ((flags & MethodHandles::_dmf_does_dispatch) == 0)
--- a/hotspot/src/share/vm/prims/methodHandles.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/prims/methodHandles.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -153,9 +153,9 @@
// and local, like parse a data structure. For speed, such methods work on plain
// oops, not handles. Trapping methods uniformly operate on handles.
-methodOop MethodHandles::decode_vmtarget(oop vmtarget, int vmindex, oop mtype,
- klassOop& receiver_limit_result, int& decode_flags_result) {
- if (vmtarget == NULL) return NULL;
+methodHandle MethodHandles::decode_vmtarget(oop vmtarget, int vmindex, oop mtype,
+ KlassHandle& receiver_limit_result, int& decode_flags_result) {
+ if (vmtarget == NULL) return methodHandle();
assert(methodOopDesc::nonvirtual_vtable_index < 0, "encoding");
if (vmindex < 0) {
// this DMH performs no dispatch; it is directly bound to a methodOop
@@ -198,20 +198,20 @@
// MemberName and DirectMethodHandle have the same linkage to the JVM internals.
// (MemberName is the non-operational name used for queries and setup.)
-methodOop MethodHandles::decode_DirectMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result) {
+methodHandle MethodHandles::decode_DirectMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result) {
oop vmtarget = java_lang_invoke_DirectMethodHandle::vmtarget(mh);
int vmindex = java_lang_invoke_DirectMethodHandle::vmindex(mh);
oop mtype = java_lang_invoke_DirectMethodHandle::type(mh);
return decode_vmtarget(vmtarget, vmindex, mtype, receiver_limit_result, decode_flags_result);
}
-methodOop MethodHandles::decode_BoundMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result) {
+methodHandle MethodHandles::decode_BoundMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result) {
assert(java_lang_invoke_BoundMethodHandle::is_instance(mh), "");
assert(mh->klass() != SystemDictionary::AdapterMethodHandle_klass(), "");
for (oop bmh = mh;;) {
// Bound MHs can be stacked to bind several arguments.
oop target = java_lang_invoke_MethodHandle::vmtarget(bmh);
- if (target == NULL) return NULL;
+ if (target == NULL) return methodHandle();
decode_flags_result |= MethodHandles::_dmf_binds_argument;
klassOop tk = target->klass();
if (tk == SystemDictionary::BoundMethodHandle_klass()) {
@@ -236,14 +236,14 @@
}
}
-methodOop MethodHandles::decode_AdapterMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result) {
+methodHandle MethodHandles::decode_AdapterMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result) {
assert(mh->klass() == SystemDictionary::AdapterMethodHandle_klass(), "");
for (oop amh = mh;;) {
// Adapter MHs can be stacked to convert several arguments.
int conv_op = adapter_conversion_op(java_lang_invoke_AdapterMethodHandle::conversion(amh));
decode_flags_result |= (_dmf_adapter_lsb << conv_op) & _DMF_ADAPTER_MASK;
oop target = java_lang_invoke_MethodHandle::vmtarget(amh);
- if (target == NULL) return NULL;
+ if (target == NULL) return methodHandle();
klassOop tk = target->klass();
if (tk == SystemDictionary::AdapterMethodHandle_klass()) {
amh = target;
@@ -255,8 +255,8 @@
}
}
-methodOop MethodHandles::decode_MethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result) {
- if (mh == NULL) return NULL;
+methodHandle MethodHandles::decode_MethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result) {
+ if (mh == NULL) return methodHandle();
klassOop mhk = mh->klass();
assert(java_lang_invoke_MethodHandle::is_subclass(mhk), "must be a MethodHandle");
if (mhk == SystemDictionary::DirectMethodHandle_klass()) {
@@ -270,7 +270,7 @@
return decode_BoundMethodHandle(mh, receiver_limit_result, decode_flags_result);
} else {
assert(false, "cannot parse this MH");
- return NULL; // random MH?
+ return methodHandle(); // random MH?
}
}
@@ -299,9 +299,9 @@
// A trusted party is handing us a cookie to determine a method.
// Let's boil it down to the method oop they really want.
-methodOop MethodHandles::decode_method(oop x, klassOop& receiver_limit_result, int& decode_flags_result) {
+methodHandle MethodHandles::decode_method(oop x, KlassHandle& receiver_limit_result, int& decode_flags_result) {
decode_flags_result = 0;
- receiver_limit_result = NULL;
+ receiver_limit_result = KlassHandle();
klassOop xk = x->klass();
if (xk == Universe::methodKlassObj()) {
return decode_methodOop((methodOop) x, decode_flags_result);
@@ -329,7 +329,7 @@
assert(!x->is_method(), "already checked");
assert(!java_lang_invoke_MemberName::is_instance(x), "already checked");
}
- return NULL;
+ return methodHandle();
}
@@ -389,11 +389,10 @@
int offset = instanceKlass::cast(k)->offset_from_fields(slot);
init_MemberName(mname_oop, k, accessFlags_from(mods), offset);
} else {
- int decode_flags = 0; klassOop receiver_limit = NULL;
- methodOop m = MethodHandles::decode_method(target_oop,
- receiver_limit, decode_flags);
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = MethodHandles::decode_method(target_oop, receiver_limit, decode_flags);
bool do_dispatch = ((decode_flags & MethodHandles::_dmf_does_dispatch) != 0);
- init_MemberName(mname_oop, m, do_dispatch);
+ init_MemberName(mname_oop, m(), do_dispatch);
}
}
@@ -423,13 +422,14 @@
}
-methodOop MethodHandles::decode_MemberName(oop mname, klassOop& receiver_limit_result, int& decode_flags_result) {
+methodHandle MethodHandles::decode_MemberName(oop mname, KlassHandle& receiver_limit_result, int& decode_flags_result) {
+ methodHandle empty;
int flags = java_lang_invoke_MemberName::flags(mname);
- if ((flags & (IS_METHOD | IS_CONSTRUCTOR)) == 0) return NULL; // not invocable
+ if ((flags & (IS_METHOD | IS_CONSTRUCTOR)) == 0) return empty; // not invocable
oop vmtarget = java_lang_invoke_MemberName::vmtarget(mname);
int vmindex = java_lang_invoke_MemberName::vmindex(mname);
- if (vmindex == VM_INDEX_UNINITIALIZED) return NULL; // not resolved
- methodOop m = decode_vmtarget(vmtarget, vmindex, NULL, receiver_limit_result, decode_flags_result);
+ if (vmindex == VM_INDEX_UNINITIALIZED) return empty; // not resolved
+ methodHandle m = decode_vmtarget(vmtarget, vmindex, NULL, receiver_limit_result, decode_flags_result);
oop clazz = java_lang_invoke_MemberName::clazz(mname);
if (clazz != NULL && java_lang_Class::is_instance(clazz)) {
klassOop klass = java_lang_Class::as_klassOop(clazz);
@@ -439,9 +439,7 @@
}
// convert the external string or reflective type to an internal signature
-Symbol* MethodHandles::convert_to_signature(oop type_str,
- bool polymorphic,
- TRAPS) {
+Symbol* MethodHandles::convert_to_signature(oop type_str, bool polymorphic, TRAPS) {
if (java_lang_invoke_MethodType::is_instance(type_str)) {
return java_lang_invoke_MethodType::as_signature(type_str, polymorphic, CHECK_NULL);
} else if (java_lang_Class::is_instance(type_str)) {
@@ -474,48 +472,48 @@
#endif
if (java_lang_invoke_MemberName::vmindex(mname()) != VM_INDEX_UNINITIALIZED)
return; // already resolved
- oop defc_oop = java_lang_invoke_MemberName::clazz(mname());
- oop name_str = java_lang_invoke_MemberName::name(mname());
- oop type_str = java_lang_invoke_MemberName::type(mname());
- int flags = java_lang_invoke_MemberName::flags(mname());
+ Handle defc_oop(THREAD, java_lang_invoke_MemberName::clazz(mname()));
+ Handle name_str(THREAD, java_lang_invoke_MemberName::name( mname()));
+ Handle type_str(THREAD, java_lang_invoke_MemberName::type( mname()));
+ int flags = java_lang_invoke_MemberName::flags(mname());
- if (defc_oop == NULL || name_str == NULL || type_str == NULL) {
+ if (defc_oop.is_null() || name_str.is_null() || type_str.is_null()) {
THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(), "nothing to resolve");
}
- klassOop defc_klassOop = java_lang_Class::as_klassOop(defc_oop);
- defc_oop = NULL; // safety
- if (defc_klassOop == NULL) return; // a primitive; no resolution possible
- if (!Klass::cast(defc_klassOop)->oop_is_instance()) {
- if (!Klass::cast(defc_klassOop)->oop_is_array()) return;
- defc_klassOop = SystemDictionary::Object_klass();
+
+ instanceKlassHandle defc;
+ {
+ klassOop defc_klassOop = java_lang_Class::as_klassOop(defc_oop());
+ if (defc_klassOop == NULL) return; // a primitive; no resolution possible
+ if (!Klass::cast(defc_klassOop)->oop_is_instance()) {
+ if (!Klass::cast(defc_klassOop)->oop_is_array()) return;
+ defc_klassOop = SystemDictionary::Object_klass();
+ }
+ defc = instanceKlassHandle(THREAD, defc_klassOop);
}
- instanceKlassHandle defc(THREAD, defc_klassOop);
- defc_klassOop = NULL; // safety
if (defc.is_null()) {
THROW_MSG(vmSymbols::java_lang_InternalError(), "primitive class");
}
- defc->link_class(CHECK);
+ defc->link_class(CHECK); // possible safepoint
// convert the external string name to an internal symbol
- TempNewSymbol name = java_lang_String::as_symbol_or_null(name_str);
+ TempNewSymbol name = java_lang_String::as_symbol_or_null(name_str());
if (name == NULL) return; // no such name
- name_str = NULL; // safety
Handle polymorphic_method_type;
bool polymorphic_signature = false;
if ((flags & ALL_KINDS) == IS_METHOD &&
(defc() == SystemDictionary::MethodHandle_klass() &&
- methodOopDesc::is_method_handle_invoke_name(name)))
+ methodOopDesc::is_method_handle_invoke_name(name))) {
polymorphic_signature = true;
+ }
// convert the external string or reflective type to an internal signature
- TempNewSymbol type = convert_to_signature(type_str, polymorphic_signature, CHECK);
- if (java_lang_invoke_MethodType::is_instance(type_str) && polymorphic_signature) {
- polymorphic_method_type = Handle(THREAD, type_str); //preserve exactly
+ TempNewSymbol type = convert_to_signature(type_str(), polymorphic_signature, CHECK);
+ if (java_lang_invoke_MethodType::is_instance(type_str()) && polymorphic_signature) {
+ polymorphic_method_type = type_str; // preserve exactly
}
-
if (type == NULL) return; // no such signature exists in the VM
- type_str = NULL; // safety
// Time to do the lookup.
switch (flags & ALL_KINDS) {
@@ -560,8 +558,8 @@
java_lang_invoke_MemberName::set_vmtarget(mname(), vmtarget);
java_lang_invoke_MemberName::set_vmindex(mname(), vmindex);
java_lang_invoke_MemberName::set_modifiers(mname(), mods);
- DEBUG_ONLY(int junk; klassOop junk2);
- assert(decode_MemberName(mname(), junk2, junk) == result.resolved_method()(),
+ DEBUG_ONLY(KlassHandle junk1; int junk2);
+ assert(decode_MemberName(mname(), junk1, junk2) == result.resolved_method(),
"properly stored for later decoding");
return;
}
@@ -589,8 +587,8 @@
java_lang_invoke_MemberName::set_vmtarget(mname(), vmtarget);
java_lang_invoke_MemberName::set_vmindex(mname(), vmindex);
java_lang_invoke_MemberName::set_modifiers(mname(), mods);
- DEBUG_ONLY(int junk; klassOop junk2);
- assert(decode_MemberName(mname(), junk2, junk) == result.resolved_method()(),
+ DEBUG_ONLY(KlassHandle junk1; int junk2);
+ assert(decode_MemberName(mname(), junk1, junk2) == result.resolved_method(),
"properly stored for later decoding");
return;
}
@@ -677,16 +675,14 @@
case IS_METHOD:
case IS_CONSTRUCTOR:
{
- klassOop receiver_limit = NULL;
- int decode_flags = 0;
- methodHandle m(THREAD, decode_vmtarget(vmtarget, vmindex, NULL,
- receiver_limit, decode_flags));
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = decode_vmtarget(vmtarget, vmindex, NULL, receiver_limit, decode_flags);
if (m.is_null()) break;
if (!have_defc) {
klassOop defc = m->method_holder();
- if (receiver_limit != NULL && receiver_limit != defc
- && Klass::cast(receiver_limit)->is_subtype_of(defc))
- defc = receiver_limit;
+ if (receiver_limit.not_null() && receiver_limit() != defc
+ && Klass::cast(receiver_limit())->is_subtype_of(defc))
+ defc = receiver_limit();
java_lang_invoke_MemberName::set_clazz(mname(), Klass::cast(defc)->java_mirror());
}
if (!have_name) {
@@ -884,10 +880,9 @@
// - AMH can have methodOop for static invoke with bound receiver
// - DMH can have methodOop for static invoke (on variable receiver)
// - DMH can have klassOop for dispatched (non-static) invoke
- klassOop receiver_limit = NULL;
- int decode_flags = 0;
- methodOop m = decode_MethodHandle(mh(), receiver_limit, decode_flags);
- if (m == NULL) return NULL;
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = decode_MethodHandle(mh(), receiver_limit, decode_flags);
+ if (m.is_null()) return NULL;
switch (format) {
case ETF_REFLECT_METHOD:
// same as jni_ToReflectedMethod:
@@ -903,10 +898,10 @@
if (SystemDictionary::MemberName_klass() == NULL) break;
instanceKlassHandle mname_klass(THREAD, SystemDictionary::MemberName_klass());
mname_klass->initialize(CHECK_NULL);
- Handle mname = mname_klass->allocate_instance_handle(CHECK_NULL);
+ Handle mname = mname_klass->allocate_instance_handle(CHECK_NULL); // possible safepoint
java_lang_invoke_MemberName::set_vmindex(mname(), VM_INDEX_UNINITIALIZED);
bool do_dispatch = ((decode_flags & MethodHandles::_dmf_does_dispatch) != 0);
- init_MemberName(mname(), m, do_dispatch);
+ init_MemberName(mname(), m(), do_dispatch);
expand_MemberName(mname, 0, CHECK_NULL);
return mname();
}
@@ -1459,8 +1454,8 @@
// that links the interpreter calls to the method. We need the same
// bits, and will use the same calling sequence code.
- int vmindex = methodOopDesc::garbage_vtable_index;
- oop vmtarget = NULL;
+ int vmindex = methodOopDesc::garbage_vtable_index;
+ Handle vmtarget;
instanceKlass::cast(m->method_holder())->link_class(CHECK);
@@ -1478,7 +1473,7 @@
} else if (!do_dispatch || m->can_be_statically_bound()) {
// We are simulating an invokestatic or invokespecial instruction.
// Set up the method pointer, just like ConstantPoolCacheEntry::set_method().
- vmtarget = m();
+ vmtarget = m;
// this does not help dispatch, but it will make it possible to parse this MH:
vmindex = methodOopDesc::nonvirtual_vtable_index;
assert(vmindex < 0, "(>=0) == do_dispatch");
@@ -1490,7 +1485,7 @@
// For a DMH, it is done now, when the handle is created.
Klass* k = Klass::cast(m->method_holder());
if (k->should_be_initialized()) {
- k->initialize(CHECK);
+ k->initialize(CHECK); // possible safepoint
}
}
} else {
@@ -1504,10 +1499,10 @@
if (me == NULL) { THROW(vmSymbols::java_lang_InternalError()); }
- java_lang_invoke_DirectMethodHandle::set_vmtarget(mh(), vmtarget);
- java_lang_invoke_DirectMethodHandle::set_vmindex(mh(), vmindex);
- DEBUG_ONLY(int flags; klassOop rlimit);
- assert(MethodHandles::decode_method(mh(), rlimit, flags) == m(),
+ java_lang_invoke_DirectMethodHandle::set_vmtarget(mh(), vmtarget());
+ java_lang_invoke_DirectMethodHandle::set_vmindex( mh(), vmindex);
+ DEBUG_ONLY(KlassHandle rlimit; int flags);
+ assert(MethodHandles::decode_method(mh(), rlimit, flags) == m,
"properly stored for later decoding");
DEBUG_ONLY(bool actual_do_dispatch = ((flags & _dmf_does_dispatch) != 0));
assert(!(actual_do_dispatch && !do_dispatch),
@@ -1523,10 +1518,13 @@
methodHandle m,
TRAPS) {
// Verify type.
- oop receiver = java_lang_invoke_BoundMethodHandle::argument(mh());
+ KlassHandle bound_recv_type;
+ {
+ oop receiver = java_lang_invoke_BoundMethodHandle::argument(mh());
+ if (receiver != NULL)
+ bound_recv_type = KlassHandle(THREAD, receiver->klass());
+ }
Handle mtype(THREAD, java_lang_invoke_MethodHandle::type(mh()));
- KlassHandle bound_recv_type;
- if (receiver != NULL) bound_recv_type = KlassHandle(THREAD, receiver->klass());
verify_method_type(m, mtype, true, bound_recv_type, CHECK);
int receiver_pos = m->size_of_parameters() - 1;
@@ -1573,8 +1571,8 @@
java_lang_invoke_BoundMethodHandle::set_vmtarget(mh(), m());
- DEBUG_ONLY(int junk; klassOop junk2);
- assert(MethodHandles::decode_method(mh(), junk2, junk) == m(), "properly stored for later decoding");
+ DEBUG_ONLY(KlassHandle junk1; int junk2);
+ assert(MethodHandles::decode_method(mh(), junk1, junk2) == m, "properly stored for later decoding");
assert(decode_MethodHandle_stack_pushes(mh()) == 1, "BMH pushes one stack slot");
// Done!
@@ -1682,8 +1680,11 @@
}
// Get bound type and required slots.
- oop ptype_oop = java_lang_invoke_MethodType::ptype(java_lang_invoke_MethodHandle::type(target()), argnum);
- BasicType ptype = java_lang_Class::as_BasicType(ptype_oop);
+ BasicType ptype;
+ {
+ oop ptype_oop = java_lang_invoke_MethodType::ptype(java_lang_invoke_MethodHandle::type(target()), argnum);
+ ptype = java_lang_Class::as_BasicType(ptype_oop);
+ }
int slots_pushed = type2size[ptype];
// If (a) the target is a direct non-dispatched method handle,
@@ -1694,13 +1695,12 @@
if (OptimizeMethodHandles &&
target->klass() == SystemDictionary::DirectMethodHandle_klass() &&
(argnum == 0 || java_lang_invoke_DirectMethodHandle::vmindex(target()) < 0)) {
- int decode_flags = 0; klassOop receiver_limit_oop = NULL;
- methodHandle m(THREAD, decode_method(target(), receiver_limit_oop, decode_flags));
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = decode_method(target(), receiver_limit, decode_flags);
if (m.is_null()) { THROW_MSG(vmSymbols::java_lang_InternalError(), "DMH failed to decode"); }
DEBUG_ONLY(int m_vmslots = m->size_of_parameters() - slots_pushed); // pos. of 1st arg.
assert(java_lang_invoke_BoundMethodHandle::vmslots(mh()) == m_vmslots, "type w/ m sig");
if (argnum == 0 && (decode_flags & _dmf_has_receiver) != 0) {
- KlassHandle receiver_limit(THREAD, receiver_limit_oop);
init_BoundMethodHandle_with_receiver(mh, m,
receiver_limit, decode_flags,
CHECK);
@@ -2019,7 +2019,6 @@
}
void MethodHandles::init_AdapterMethodHandle(Handle mh, Handle target, int argnum, TRAPS) {
- oop argument = java_lang_invoke_AdapterMethodHandle::argument(mh());
int argslot = java_lang_invoke_AdapterMethodHandle::vmargslot(mh());
jint conversion = java_lang_invoke_AdapterMethodHandle::conversion(mh());
jint conv_op = adapter_conversion_op(conversion);
@@ -2215,18 +2214,14 @@
// which method are we really talking about?
if (target_jh == NULL) { THROW(vmSymbols::java_lang_InternalError()); }
- oop target_oop = JNIHandles::resolve_non_null(target_jh);
- if (java_lang_invoke_MemberName::is_instance(target_oop) &&
- java_lang_invoke_MemberName::vmindex(target_oop) == VM_INDEX_UNINITIALIZED) {
- Handle mname(THREAD, target_oop);
- MethodHandles::resolve_MemberName(mname, CHECK);
- target_oop = mname(); // in case of GC
+ Handle target(THREAD, JNIHandles::resolve_non_null(target_jh));
+ if (java_lang_invoke_MemberName::is_instance(target()) &&
+ java_lang_invoke_MemberName::vmindex(target()) == VM_INDEX_UNINITIALIZED) {
+ MethodHandles::resolve_MemberName(target, CHECK);
}
- int decode_flags = 0; klassOop receiver_limit = NULL;
- methodHandle m(THREAD,
- MethodHandles::decode_method(target_oop,
- receiver_limit, decode_flags));
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = MethodHandles::decode_method(target(), receiver_limit, decode_flags);
if (m.is_null()) { THROW_MSG(vmSymbols::java_lang_InternalError(), "no such method"); }
// The trusted Java code that calls this method should already have performed
@@ -2284,12 +2279,8 @@
// Target object is a reflective method. (%%% Do we need this alternate path?)
Untested("init_BMH of non-MH");
if (argnum != 0) { THROW(vmSymbols::java_lang_InternalError()); }
- int decode_flags = 0; klassOop receiver_limit_oop = NULL;
- methodHandle m(THREAD,
- MethodHandles::decode_method(target(),
- receiver_limit_oop,
- decode_flags));
- KlassHandle receiver_limit(THREAD, receiver_limit_oop);
+ KlassHandle receiver_limit; int decode_flags = 0;
+ methodHandle m = MethodHandles::decode_method(target(), receiver_limit, decode_flags);
MethodHandles::init_BoundMethodHandle_with_receiver(mh, m,
receiver_limit,
decode_flags,
@@ -2424,12 +2415,12 @@
#ifndef PRODUCT
if (which >= 0 && which < con_value_count) {
int con = con_values[which];
- objArrayOop box = (objArrayOop) JNIHandles::resolve(box_jh);
- if (box != NULL && box->klass() == Universe::objectArrayKlassObj() && box->length() > 0) {
+ objArrayHandle box(THREAD, (objArrayOop) JNIHandles::resolve(box_jh));
+ if (box.not_null() && box->klass() == Universe::objectArrayKlassObj() && box->length() > 0) {
const char* str = &con_names[0];
for (int i = 0; i < which; i++)
str += strlen(str) + 1; // skip name and null
- oop name = java_lang_String::create_oop_from_str(str, CHECK_0);
+ oop name = java_lang_String::create_oop_from_str(str, CHECK_0); // possible safepoint
box->obj_at_put(0, name);
}
return con;
@@ -2486,10 +2477,10 @@
jclass clazz_jh, jstring name_jh, jstring sig_jh,
int mflags, jclass caller_jh, jint skip, jobjectArray results_jh)) {
if (clazz_jh == NULL || results_jh == NULL) return -1;
- klassOop k_oop = java_lang_Class::as_klassOop(JNIHandles::resolve_non_null(clazz_jh));
+ KlassHandle k(THREAD, java_lang_Class::as_klassOop(JNIHandles::resolve_non_null(clazz_jh)));
- objArrayOop results = (objArrayOop) JNIHandles::resolve(results_jh);
- if (results == NULL || !results->is_objArray()) return -1;
+ objArrayHandle results(THREAD, (objArrayOop) JNIHandles::resolve(results_jh));
+ if (results.is_null() || !results->is_objArray()) return -1;
TempNewSymbol name = NULL;
TempNewSymbol sig = NULL;
@@ -2502,20 +2493,20 @@
if (sig == NULL) return 0; // a match is not possible
}
- klassOop caller = NULL;
+ KlassHandle caller;
if (caller_jh != NULL) {
oop caller_oop = JNIHandles::resolve_non_null(caller_jh);
if (!java_lang_Class::is_instance(caller_oop)) return -1;
- caller = java_lang_Class::as_klassOop(caller_oop);
+ caller = KlassHandle(THREAD, java_lang_Class::as_klassOop(caller_oop));
}
- if (name != NULL && sig != NULL && results != NULL) {
+ if (name != NULL && sig != NULL && results.not_null()) {
// try a direct resolve
// %%% TO DO
}
- int res = MethodHandles::find_MemberNames(k_oop, name, sig, mflags,
- caller, skip, results);
+ int res = MethodHandles::find_MemberNames(k(), name, sig, mflags,
+ caller(), skip, results());
// TO DO: expand at least some of the MemberNames, to avoid massive callbacks
return res;
}
--- a/hotspot/src/share/vm/prims/methodHandles.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/prims/methodHandles.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -265,13 +265,13 @@
static inline address from_interpreted_entry(EntryKind ek);
// helpers for decode_method.
- static methodOop decode_methodOop(methodOop m, int& decode_flags_result);
- static methodOop decode_vmtarget(oop vmtarget, int vmindex, oop mtype, klassOop& receiver_limit_result, int& decode_flags_result);
- static methodOop decode_MemberName(oop mname, klassOop& receiver_limit_result, int& decode_flags_result);
- static methodOop decode_MethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result);
- static methodOop decode_DirectMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result);
- static methodOop decode_BoundMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result);
- static methodOop decode_AdapterMethodHandle(oop mh, klassOop& receiver_limit_result, int& decode_flags_result);
+ static methodOop decode_methodOop(methodOop m, int& decode_flags_result);
+ static methodHandle decode_vmtarget(oop vmtarget, int vmindex, oop mtype, KlassHandle& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_MemberName(oop mname, KlassHandle& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_MethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_DirectMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_BoundMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_AdapterMethodHandle(oop mh, KlassHandle& receiver_limit_result, int& decode_flags_result);
// Find out how many stack slots an mh pushes or pops.
// The result is *not* reported as a multiple of stack_move_unit();
@@ -317,7 +317,7 @@
_dmf_adapter_lsb = 0x20,
_DMF_ADAPTER_MASK = (_dmf_adapter_lsb << CONV_OP_LIMIT) - _dmf_adapter_lsb
};
- static methodOop decode_method(oop x, klassOop& receiver_limit_result, int& decode_flags_result);
+ static methodHandle decode_method(oop x, KlassHandle& receiver_limit_result, int& decode_flags_result);
enum {
// format of query to getConstant:
GC_JVM_PUSH_LIMIT = 0,
--- a/hotspot/src/share/vm/runtime/globals.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/runtime/globals.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -620,6 +620,9 @@
product(bool, UseSSE42Intrinsics, false, \
"SSE4.2 versions of intrinsics") \
\
+ product(bool, UseCondCardMark, false, \
+ "Check for already marked card before updating card table") \
+ \
develop(bool, TraceCallFixup, false, \
"traces all call fixups") \
\
--- a/hotspot/src/share/vm/runtime/javaCalls.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/runtime/javaCalls.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -389,7 +389,7 @@
// to Java
if (!os::stack_shadow_pages_available(THREAD, method)) {
// Throw stack overflow exception with preinitialized exception.
- Exceptions::throw_stack_overflow_exception(THREAD, __FILE__, __LINE__);
+ Exceptions::throw_stack_overflow_exception(THREAD, __FILE__, __LINE__, method);
return;
} else {
// Touch pages checked if the OS needs them to be touched to be mapped.
--- a/hotspot/src/share/vm/runtime/sharedRuntime.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/runtime/sharedRuntime.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1721,14 +1721,14 @@
targetArity = ArgumentCount(target->signature()).size();
}
}
- klassOop kignore; int dmf_flags = 0;
- methodOop actual_method = MethodHandles::decode_method(actual, kignore, dmf_flags);
+ KlassHandle kignore; int dmf_flags = 0;
+ methodHandle actual_method = MethodHandles::decode_method(actual, kignore, dmf_flags);
if ((dmf_flags & ~(MethodHandles::_dmf_has_receiver |
MethodHandles::_dmf_does_dispatch |
MethodHandles::_dmf_from_interface)) != 0)
- actual_method = NULL; // MH does extra binds, drops, etc.
+ actual_method = methodHandle(); // MH does extra binds, drops, etc.
bool has_receiver = ((dmf_flags & MethodHandles::_dmf_has_receiver) != 0);
- if (actual_method != NULL) {
+ if (actual_method.not_null()) {
mhName = actual_method->signature()->as_C_string();
mhArity = ArgumentCount(actual_method->signature()).size();
if (!actual_method->is_static()) mhArity += 1;
--- a/hotspot/src/share/vm/runtime/vmThread.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/runtime/vmThread.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -291,7 +291,9 @@
// Among other things, this ensures that Eden top is correct.
Universe::heap()->prepare_for_verify();
os::check_heap();
- Universe::verify(true, true); // Silent verification to not polute normal output
+ // Silent verification so as not to pollute normal output,
+ // unless we really asked for it.
+ Universe::verify(true, !(PrintGCDetails || Verbose));
}
CompileBroker::set_should_block();
--- a/hotspot/src/share/vm/services/g1MemoryPool.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/services/g1MemoryPool.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2011, 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
@@ -34,10 +34,10 @@
size_t init_size,
bool support_usage_threshold) :
_g1h(g1h), CollectedMemoryPool(name,
- MemoryPool::Heap,
- init_size,
- undefined_max(),
- support_usage_threshold) {
+ MemoryPool::Heap,
+ init_size,
+ undefined_max(),
+ support_usage_threshold) {
assert(UseG1GC, "sanity");
}
@@ -48,44 +48,27 @@
// See the comment at the top of g1MemoryPool.hpp
size_t G1MemoryPoolSuper::eden_space_used(G1CollectedHeap* g1h) {
- size_t young_list_length = g1h->young_list()->length();
- size_t eden_used = young_list_length * HeapRegion::GrainBytes;
- size_t survivor_used = survivor_space_used(g1h);
- eden_used = subtract_up_to_zero(eden_used, survivor_used);
- return eden_used;
+ return g1h->g1mm()->eden_space_used();
}
// See the comment at the top of g1MemoryPool.hpp
size_t G1MemoryPoolSuper::survivor_space_committed(G1CollectedHeap* g1h) {
- return MAX2(survivor_space_used(g1h), (size_t) HeapRegion::GrainBytes);
+ return g1h->g1mm()->survivor_space_committed();
}
// See the comment at the top of g1MemoryPool.hpp
size_t G1MemoryPoolSuper::survivor_space_used(G1CollectedHeap* g1h) {
- size_t survivor_num = g1h->g1_policy()->recorded_survivor_regions();
- size_t survivor_used = survivor_num * HeapRegion::GrainBytes;
- return survivor_used;
+ return g1h->g1mm()->survivor_space_used();
}
// See the comment at the top of g1MemoryPool.hpp
size_t G1MemoryPoolSuper::old_space_committed(G1CollectedHeap* g1h) {
- size_t committed = overall_committed(g1h);
- size_t eden_committed = eden_space_committed(g1h);
- size_t survivor_committed = survivor_space_committed(g1h);
- committed = subtract_up_to_zero(committed, eden_committed);
- committed = subtract_up_to_zero(committed, survivor_committed);
- committed = MAX2(committed, (size_t) HeapRegion::GrainBytes);
- return committed;
+ return g1h->g1mm()->old_space_committed();
}
// See the comment at the top of g1MemoryPool.hpp
size_t G1MemoryPoolSuper::old_space_used(G1CollectedHeap* g1h) {
- size_t used = overall_used(g1h);
- size_t eden_used = eden_space_used(g1h);
- size_t survivor_used = survivor_space_used(g1h);
- used = subtract_up_to_zero(used, eden_used);
- used = subtract_up_to_zero(used, survivor_used);
- return used;
+ return g1h->g1mm()->old_space_used();
}
G1EdenPool::G1EdenPool(G1CollectedHeap* g1h) :
--- a/hotspot/src/share/vm/services/g1MemoryPool.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/services/g1MemoryPool.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2011, 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
@@ -46,68 +46,9 @@
// get, as this does affect the performance and behavior of G1. Which
// is why we introduce the three memory pools implemented here.
//
-// The above approach inroduces a couple of challenging issues in the
-// implementation of the three memory pools:
-//
-// 1) The used space calculation for a pool is not necessarily
-// independent of the others. We can easily get from G1 the overall
-// used space in the entire heap, the number of regions in the young
-// generation (includes both eden and survivors), and the number of
-// survivor regions. So, from that we calculate:
-//
-// survivor_used = survivor_num * region_size
-// eden_used = young_region_num * region_size - survivor_used
-// old_gen_used = overall_used - eden_used - survivor_used
-//
-// Note that survivor_used and eden_used are upper bounds. To get the
-// actual value we would have to iterate over the regions and add up
-// ->used(). But that'd be expensive. So, we'll accept some lack of
-// accuracy for those two. But, we have to be careful when calculating
-// old_gen_used, in case we subtract from overall_used more then the
-// actual number and our result goes negative.
-//
-// 2) Calculating the used space is straightforward, as described
-// above. However, how do we calculate the committed space, given that
-// we allocate space for the eden, survivor, and old gen out of the
-// same pool of regions? One way to do this is to use the used value
-// as also the committed value for the eden and survivor spaces and
-// then calculate the old gen committed space as follows:
-//
-// old_gen_committed = overall_committed - eden_committed - survivor_committed
+// See comments in g1MonitoringSupport.hpp for additional details
+// on this model.
//
-// Maybe a better way to do that would be to calculate used for eden
-// and survivor as a sum of ->used() over their regions and then
-// calculate committed as region_num * region_size (i.e., what we use
-// to calculate the used space now). This is something to consider
-// in the future.
-//
-// 3) Another decision that is again not straightforward is what is
-// the max size that each memory pool can grow to. One way to do this
-// would be to use the committed size for the max for the eden and
-// survivors and calculate the old gen max as follows (basically, it's
-// a similar pattern to what we use for the committed space, as
-// described above):
-//
-// old_gen_max = overall_max - eden_max - survivor_max
-//
-// Unfortunately, the above makes the max of each pool fluctuate over
-// time and, even though this is allowed according to the spec, it
-// broke several assumptions in the M&M framework (there were cases
-// where used would reach a value greater than max). So, for max we
-// use -1, which means "undefined" according to the spec.
-//
-// 4) Now, there is a very subtle issue with all the above. The
-// framework will call get_memory_usage() on the three pools
-// asynchronously. As a result, each call might get a different value
-// for, say, survivor_num which will yield inconsistent values for
-// eden_used, survivor_used, and old_gen_used (as survivor_num is used
-// in the calculation of all three). This would normally be
-// ok. However, it's possible that this might cause the sum of
-// eden_used, survivor_used, and old_gen_used to go over the max heap
-// size and this seems to sometimes cause JConsole (and maybe other
-// clients) to get confused. There's not a really an easy / clean
-// solution to this problem, due to the asynchrounous nature of the
-// framework.
// This class is shared by the three G1 memory pool classes
@@ -116,22 +57,6 @@
// (see comment above), we put the calculations in this class so that
// we can easily share them among the subclasses.
class G1MemoryPoolSuper : public CollectedMemoryPool {
-private:
- // It returns x - y if x > y, 0 otherwise.
- // As described in the comment above, some of the inputs to the
- // calculations we have to do are obtained concurrently and hence
- // may be inconsistent with each other. So, this provides a
- // defensive way of performing the subtraction and avoids the value
- // going negative (which would mean a very large result, given that
- // the parameter are size_t).
- static size_t subtract_up_to_zero(size_t x, size_t y) {
- if (x > y) {
- return x - y;
- } else {
- return 0;
- }
- }
-
protected:
G1CollectedHeap* _g1h;
@@ -148,13 +73,6 @@
return (size_t) -1;
}
- static size_t overall_committed(G1CollectedHeap* g1h) {
- return g1h->capacity();
- }
- static size_t overall_used(G1CollectedHeap* g1h) {
- return g1h->used_unlocked();
- }
-
static size_t eden_space_committed(G1CollectedHeap* g1h);
static size_t eden_space_used(G1CollectedHeap* g1h);
--- a/hotspot/src/share/vm/utilities/exceptions.cpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/utilities/exceptions.cpp Wed Jul 05 17:42:56 2017 +0200
@@ -207,7 +207,7 @@
}
-void Exceptions::throw_stack_overflow_exception(Thread* THREAD, const char* file, int line) {
+void Exceptions::throw_stack_overflow_exception(Thread* THREAD, const char* file, int line, methodHandle method) {
Handle exception;
if (!THREAD->has_pending_exception()) {
klassOop k = SystemDictionary::StackOverflowError_klass();
@@ -215,13 +215,13 @@
exception = Handle(THREAD, e); // fill_in_stack trace does gc
assert(instanceKlass::cast(k)->is_initialized(), "need to increase min_stack_allowed calculation");
if (StackTraceInThrowable) {
- java_lang_Throwable::fill_in_stack_trace(exception);
+ java_lang_Throwable::fill_in_stack_trace(exception, method());
}
} else {
// if prior exception, throw that one instead
exception = Handle(THREAD, THREAD->pending_exception());
}
- _throw_oop(THREAD, file, line, exception());
+ _throw(THREAD, file, line, exception);
}
void Exceptions::fthrow(Thread* thread, const char* file, int line, Symbol* h_name, const char* format, ...) {
--- a/hotspot/src/share/vm/utilities/exceptions.hpp Mon May 02 09:36:45 2011 -0700
+++ b/hotspot/src/share/vm/utilities/exceptions.hpp Wed Jul 05 17:42:56 2017 +0200
@@ -144,7 +144,7 @@
const char* message,
ExceptionMsgToUtf8Mode to_utf8_safe = safe_to_utf8);
- static void throw_stack_overflow_exception(Thread* thread, const char* file, int line);
+ static void throw_stack_overflow_exception(Thread* thread, const char* file, int line, methodHandle method);
// for AbortVMOnException flag
NOT_PRODUCT(static void debug_check_abort(Handle exception, const char* message = NULL);)
--- a/jdk/.hgignore Mon May 02 09:36:45 2011 -0700
+++ b/jdk/.hgignore Wed Jul 05 17:42:56 2017 +0200
@@ -3,3 +3,4 @@
/nbproject/private/
^make/netbeans/.*/build/
^make/netbeans/.*/dist/
+^.hgtip
--- a/jdk/.hgtags Mon May 02 09:36:45 2011 -0700
+++ b/jdk/.hgtags Wed Jul 05 17:42:56 2017 +0200
@@ -114,3 +114,4 @@
29296ea6529a418037ccce95903249665ef31c11 jdk7-b137
60d3d55dcc9c31a30ced9caa6ef5c0dcd7db031d jdk7-b138
d80954a89b49fda47c0c5cace65a17f5a758b8bd jdk7-b139
+9315c733fb17ddfb9fb44be7e0ffea37bf3c727d jdk7-b140
--- a/jdk/make/common/Defs-linux.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/Defs-linux.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -251,9 +251,8 @@
# statically link libgcc but will print a warning with the flag. We don't
# want the warning, so check gcc version first.
#
-CC_VER_MAJOR := $(shell $(CC) -dumpversion | $(SED) 's/egcs-//' | $(CUT) -d'.' -f1)
-ifeq ("$(CC_VER_MAJOR)", "3")
-OTHER_LDFLAGS += -static-libgcc
+ifeq ($(CC_MAJORVER),3)
+ OTHER_LDFLAGS += -static-libgcc
endif
# Automatic precompiled header option to use (if COMPILE_APPROACH=batch)
@@ -355,7 +354,7 @@
# Japanese manpages
#
JA_SOURCE_ENCODING = eucJP
-JA_TARGET_ENCODINGS = eucJP
+JA_TARGET_ENCODINGS = UTF-8
# Settings for the JDI - Serviceability Agent binding.
HOTSPOT_SALIB_PATH = $(HOTSPOT_IMPORT_PATH)/jre/lib/$(LIBARCH)
--- a/jdk/make/common/Defs-solaris.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/Defs-solaris.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -457,14 +457,15 @@
# On X86, make sure tail call optimization is off
# The z and y are the tail call optimizations.
ifeq ($(ARCH_FAMILY), i586)
- ifeq ($(shell $(EXPR) $(CC_MAJORVER) \>= 5), 1)
- ifeq ($(shell $(EXPR) $(CC_MINORVER) \> 8), 1)
- # Somehow, tail call optimization is creeping in.
- # Make sure it is off.
- # WARNING: These may cause compiler warnings about duplicate -O options
- CC_XKEEPFRAME_OPTIONS += -Wu,-O$(OPT_LEVEL/$(OPTIMIZATION_LEVEL))~yz
- CXX_XKEEPFRAME_OPTIONS += -Qoption ube -O$(OPT_LEVEL/$(OPTIMIZATION_LEVEL))~yz
- endif
+ CC_NEWER_THAN_58 := \
+ $(shell $(EXPR) $(CC_MAJORVER) \> 5 \| \
+ \( $(CC_MAJORVER) = 5 \& $(CC_MINORVER) \> 8 \) )
+ ifeq ($(CC_NEWER_THAN_58),1)
+ # Somehow, tail call optimization is creeping in.
+ # Make sure it is off.
+ # WARNING: These may cause compiler warnings about duplicate -O options
+ CC_XKEEPFRAME_OPTIONS += -Wu,-O$(OPT_LEVEL/$(OPTIMIZATION_LEVEL))~yz
+ CXX_XKEEPFRAME_OPTIONS += -Qoption ube -O$(OPT_LEVEL/$(OPTIMIZATION_LEVEL))~yz
endif
endif
@@ -481,14 +482,15 @@
CXX_XKEEPFRAME_OPTIONS += -Qoption ube -Z~B
endif
- ifeq ($(shell $(EXPR) $(CC_MAJORVER) \>= 5), 1)
- ifeq ($(shell $(EXPR) $(CC_MINORVER) \> 6), 1)
- # Do NOT use frame pointer register as a general purpose opt register
- CC_OPT/NONE += -xregs=no%frameptr
- CXX_OPT/NONE += -xregs=no%frameptr
- CC_XKEEPFRAME_OPTIONS += -xregs=no%frameptr
- CXX_XKEEPFRAME_OPTIONS += -xregs=no%frameptr
- endif
+ CC_NEWER_THAN_56 := \
+ $(shell $(EXPR) $(CC_MAJORVER) \> 5 \| \
+ \( $(CC_MAJORVER) = 5 \& $(CC_MINORVER) \> 6 \) )
+ ifeq ($(CC_NEWER_THAN_56),1)
+ # Do NOT use frame pointer register as a general purpose opt register
+ CC_OPT/NONE += -xregs=no%frameptr
+ CXX_OPT/NONE += -xregs=no%frameptr
+ CC_XKEEPFRAME_OPTIONS += -xregs=no%frameptr
+ CXX_XKEEPFRAME_OPTIONS += -xregs=no%frameptr
endif
endif
@@ -566,8 +568,10 @@
CFLAGS_REQUIRED_sparc += -xregs=no%appl
CFLAGS_REQUIRED_sparcv9 += -xregs=no%appl
endif
- ifeq ($(shell $(EXPR) $(CC_VER) \> 5.6), 1)
- # We MUST allow data alignment of 4 for sparc V8 (32bit)
+ CC_NEWER_THAN_56 := \
+ $(shell $(EXPR) $(CC_MAJORVER) \> 5 \| \
+ \( $(CC_MAJORVER) = 5 \& $(CC_MINORVER) \> 6 \) )
+ ifeq ($(CC_NEWER_THAN_56),1)
# Presents an ABI issue with customer JNI libs? We must be able to
# to handle 4byte aligned objects? (rare occurance, but possible?)
CFLAGS_REQUIRED_sparc += -xmemalign=4s
--- a/jdk/make/common/Demo.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/Demo.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -211,9 +211,13 @@
endif
# Jar manifest file
-$(DEMO_MANIFEST):
+MAINMANIFEST = $(JDK_TOPDIR)/make/tools/manifest.mf
+$(DEMO_MANIFEST): $(MAINMANIFEST)
@$(prep-target)
- $(ECHO) "Main-Class: $(DEMO_MAINCLASS)" > $@
+ $(SED) -e "s#@@RELEASE@@#$(RELEASE)#" \
+ -e "s#@@COMPANY_NAME@@#$(COMPANY_NAME)#" \
+ $(MAINMANIFEST) >> $@
+ $(ECHO) "Main-Class: $(DEMO_MAINCLASS)" >> $@
ifdef DEMO_MANIFEST_ATTR
$(ECHO) "$(DEMO_MANIFEST_ATTR)" >> $@
endif
--- a/jdk/make/common/Release-embedded.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/Release-embedded.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -84,10 +84,10 @@
# Create headless rt.jar
HL_RT_JAR=$(ABS_TEMPDIR)/rt-hl-orig.jar
-$(HL_RT_JAR): MakeHeadlessJarFileList $(JAR_MANIFEST_FILE)
+$(HL_RT_JAR): MakeHeadlessJarFileList $(RT_JAR_MANIFEST_FILE)
$(prep-target)
$(CD) $(CLASSBINDIR) ; \
- $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(JAR_MANIFEST_FILE) $@ @$(HEADLESS_RT_JAR_FILELIST) \
+ $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(RT_JAR_MANIFEST_FILE) $@ @$(HEADLESS_RT_JAR_FILELIST) \
$(JAR_JFLAGS)
@$(CD) $(CLASSBINDIR); $(java-vm-cleanup)
--- a/jdk/make/common/Release.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/Release.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -164,7 +164,7 @@
ifeq ($(PLATFORM), linux)
MANBASEDIRS=$(JDK_TOPDIR)/src/linux/doc $(IMPORTDOCDIR)
MAN1SUBDIR=man
- JA_DIRNAME=ja_JP.$(JA_SOURCE_ENCODING)
+ JA_DIRNAME=ja_JP.UTF-8
endif # linux
define copy-man-pages
@@ -190,8 +190,7 @@
done
$(java-vm-cleanup)
if [ "$(JA_DIRNAME)" != "" ] ; then \
- $(MV) $1/man/ja $1/man/$(JA_DIRNAME); \
- $(CD) $1/man && $(LN) -s $(JA_DIRNAME) ja; \
+ $(CD) $1/man && $(RM) ja && $(LN) -s $(JA_DIRNAME) ja; \
fi
endef
@@ -609,8 +608,8 @@
@$(java-vm-cleanup)
# Create the manifest file.
-JAR_MANIFEST_FILE=$(ABS_TEMPDIR)/manifest.tmp
-$(JAR_MANIFEST_FILE): $(MAINMANIFEST) $(BEANMANIFEST)
+RT_JAR_MANIFEST_FILE=$(ABS_TEMPDIR)/rt_manifest.tmp
+$(RT_JAR_MANIFEST_FILE): $(MAINMANIFEST) $(BEANMANIFEST)
$(prep-target)
$(SED) -e "s#@@RELEASE@@#$(RELEASE)#" \
-e "s#@@COMPANY_NAME@@#$(COMPANY_NAME)#" \
@@ -618,21 +617,28 @@
$(ECHO) >> $@
$(CAT) $(BEANMANIFEST) >> $@
+OTHER_JAR_MANIFEST_FILE=$(ABS_TEMPDIR)/other_manifest.tmp
+$(OTHER_JAR_MANIFEST_FILE): $(MAINMANIFEST)
+ $(prep-target)
+ $(SED) -e "s#@@RELEASE@@#$(RELEASE)#" \
+ -e "s#@@COMPANY_NAME@@#$(COMPANY_NAME)#" \
+ $(MAINMANIFEST) >> $@
+
# Create resources.jar containing non-class files
RESOURCES_JAR=$(ABS_TEMPDIR)/resources-orig.jar
-$(RESOURCES_JAR): $(RES_JAR_FILELIST) $(JAR_MANIFEST_FILE)
+$(RESOURCES_JAR): $(RES_JAR_FILELIST) $(OTHER_JAR_MANIFEST_FILE)
$(prep-target)
$(CD) $(CLASSBINDIR) && \
- $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(JAR_MANIFEST_FILE) $@ \
+ $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(OTHER_JAR_MANIFEST_FILE) $@ \
@$(RES_JAR_FILELIST) $(BOOT_JAR_JFLAGS)
@$(CD) $(CLASSBINDIR) && $(java-vm-cleanup)
# Create jsse.jar containing SunJSSE implementation classes
JSSE_JAR=$(ABS_TEMPDIR)/jsse-orig.jar
-$(JSSE_JAR): $(JAR_MANIFEST_FILE)
+$(JSSE_JAR): $(OTHER_JAR_MANIFEST_FILE)
$(prep-target)
$(CD) $(CLASSBINDIR) && \
- $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(JAR_MANIFEST_FILE) $@ \
+ $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(OTHER_JAR_MANIFEST_FILE) $@ \
$(JSSE_CLASSES_DIRS) $(BOOT_JAR_JFLAGS)
@$(CD) $(CLASSBINDIR) && $(java-vm-cleanup)
@@ -676,10 +682,10 @@
# Create rt.jar
RT_JAR=$(ABS_TEMPDIR)/rt-orig.jar
-$(RT_JAR): $(RT_JAR_FILELIST) $(JAR_MANIFEST_FILE)
+$(RT_JAR): $(RT_JAR_FILELIST) $(RT_JAR_MANIFEST_FILE)
$(prep-target)
$(CD) $(CLASSBINDIR) && \
- $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(JAR_MANIFEST_FILE) $@ \
+ $(BOOT_JAR_CMD) $(CREATE_JAR_OPTS) $(RT_JAR_MANIFEST_FILE) $@ \
@$(RT_JAR_FILELIST) $(BOOT_JAR_JFLAGS)
@$(CD) $(CLASSBINDIR) && $(java-vm-cleanup)
@@ -1117,6 +1123,10 @@
MINIMUM_OS_NAME := $(REQUIRED_OS_NAME)
MINIMUM_OS_VERSION := $(REQUIRED_OS_VERSION)
MINIMUM_OS_ARCH := $(ARCH)
+ALL_SOURCE_TIPS = $(shell \
+ if [ -f $(SOURCE_TIPS) ] ; then \
+ $(CAT) $(SOURCE_TIPS) ; \
+ fi)
$(JDK_INFO_FILE): FRC
$(prep-target)
@@ -1124,6 +1134,7 @@
$(call info-file-item, "OS_NAME", "$(MINIMUM_OS_NAME)")
$(call info-file-item, "OS_VERSION", "$(MINIMUM_OS_VERSION)")
$(call info-file-item, "OS_ARCH", "$(MINIMUM_OS_ARCH)")
+ $(call info-file-item, "SOURCE", "$(ALL_SOURCE_TIPS)")
# Create release file to identify this image
identify-image-jdk:: $(JDK_INFO_FILE)
@@ -1134,6 +1145,7 @@
$(call info-file-item, "OS_NAME", "$(MINIMUM_OS_NAME)")
$(call info-file-item, "OS_VERSION", "$(MINIMUM_OS_VERSION)")
$(call info-file-item, "OS_ARCH", "$(MINIMUM_OS_ARCH)")
+ $(call info-file-item, "SOURCE", "$(ALL_SOURCE_TIPS)")
# Create release file to identify this image
identify-image-jre:: $(JRE_INFO_FILE)
--- a/jdk/make/common/shared/Compiler-gcc.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/shared/Compiler-gcc.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -87,6 +87,8 @@
# Get gcc version
_CC_VER :=$(shell $(CC) -dumpversion 2>&1 )
CC_VER :=$(call GetVersion,"$(_CC_VER)")
+CC_MAJORVER :=$(call MajorVersion,$(CC_VER))
+CC_MINORVER :=$(call MinorVersion,$(CC_VER))
# Name of compiler
COMPILER_NAME = GCC$(call MajorVersion,$(CC_VER))
--- a/jdk/make/common/shared/Compiler-sun.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/shared/Compiler-sun.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -117,7 +117,10 @@
LINT_XARCH_OPTION_OLD/64 += -Xarch=amd64
endif
# Pick the options we want based on the compiler being used. (5.9 or newer)
-ifeq ($(shell expr $(CC_MINORVER) \>= 9), 1)
+CC_59_OR_NEWER := \
+ $(shell expr $(CC_MAJORVER) \> 5 \| \
+ \( $(CC_MAJORVER) = 5 \& $(CC_MINORVER) \>= 9 \) )
+ifeq ($(CC_59_OR_NEWER), 1)
XARCH_OPTION/32 = $(XARCH_OPTION_NEW/32)
XARCH_OPTION/64 = $(XARCH_OPTION_NEW/64)
LINT_XARCH_OPTION/32 = $(LINT_XARCH_OPTION_NEW/32)
--- a/jdk/make/common/shared/Defs-utils.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/shared/Defs-utils.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -110,6 +110,7 @@
GREP = $(UTILS_COMMAND_PATH)grep
GUNZIP = $(UTILS_COMMAND_PATH)gunzip
HEAD = $(UTILS_USR_BIN_PATH)head
+HG = hg
ID = $(UTILS_COMMAND_PATH)id
ISAINFO = $(UTILS_COMMAND_PATH)isainfo
KSH = $(UTILS_COMMAND_PATH)ksh
--- a/jdk/make/common/shared/Defs.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/shared/Defs.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -612,6 +612,44 @@
COPYRIGHT_YEAR = $(shell $(DATE) '+%Y')
endif
+# Create file with source information
+SOURCE_TIPS=$(ABS_OUTPUTDIR)/source_tips
+
+# The source tips can come from the Mercurial repository, or in the files
+# $(HGTIP_FILENAME) which contains the tip but is also positioned in the same
+# directory as the original $(HGDIR) directory.
+# These should not be := assignments, only used from the root Makefile.
+HG_VERSION = $(shell $(HG) version 2> $(DEV_NULL))
+HG_DIRECTORY=.hg
+HGTIP_FILENAME=.hgtip
+HG_SEARCH = ./REPO ./*/REPO ./*/*/REPO ./*/*/*/REPO
+REPO_LIST = $(patsubst ./%,%,$(patsubst %/,%,$(sort $(dir \
+ $(shell ( $(LS) -d $(HG_SEARCH:%/REPO=%/$(HG_DIRECTORY)) ; \
+ $(LS) $(HG_SEARCH:%/REPO=%/$(HGTIP_FILENAME)) ) \
+ 2> $(DEV_NULL))))))
+
+# Emit the repo:tip pairs to $@
+define GetSourceTips
+for i in $(REPO_LIST) IGNORE ; do \
+ if [ "$${i}" = "IGNORE" ] ; then \
+ continue; \
+ elif [ -d $${i}/$(HG_DIRECTORY) -a "$(HG_VERSION)" != "" ] ; then \
+ $(PRINTF) " %s:%s" \
+ "$${i}" `$(HG) tip --repository $${i} --template '{node|short}\n'` ; \
+ elif [ -f $${i}/$(HGTIP_FILENAME) ] ; then \
+ $(PRINTF) " %s:%s" \
+ "$${i}" `$(CAT) $${i}/$(HGTIP_FILENAME)` ; \
+ fi; \
+done >> $@
+$(PRINTF) "\n" >> $@
+endef
+
+# Create the HGTIP_FILENAME file
+define CreateHgTip
+$(HG) tip --repository $1 --template '{node|short}\n' > $1/$(HGTIP_FILENAME);\
+$(ECHO) $1/$(HGTIP_FILENAME)
+endef
+
# Get the compiler specific settings (will run the compiler to find out)
# NOTE: COMPILER_PATH must be set by this time.
# Up until we include this file, we don't know what specific compiler
--- a/jdk/make/common/shared/Platform.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/common/shared/Platform.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -428,8 +428,6 @@
# Machines with 512Mb or less of real memory are considered low memory
# build machines and adjustments will be made to prevent excessing
# system swapping during the build.
-# If we don't know, assume 512. Subtract 128 from MB for VM MAX.
-# Don't set VM max over 1024-128=896.
ifeq ($(JDK_HAS_MEM_INFO),)
JDK_HAS_MEM_INFO=true
export JDK_HAS_MEM_INFO
@@ -440,18 +438,8 @@
else \
echo "false"; \
fi)
- MAX_VM_MEMORY := $(shell \
- if [ $(MB_OF_MEMORY) -le 1024 ] ; then \
- expr $(MB_OF_MEMORY) '-' 128 2> $(DEV_NULL) ; \
- else \
- echo "896"; \
- fi)
- MIN_VM_MEMORY := $(shell \
- if [ $(MAX_VM_MEMORY) -le 128 ] ; then \
- expr $(MAX_VM_MEMORY) '-' 8 2> $(DEV_NULL) ; \
- else \
- echo "128"; \
- fi)
+ MAX_VM_MEMORY := 512
+ MIN_VM_MEMORY := $(MAX_VM_MEMORY)
else
MB_OF_MEMORY := unknown
LOW_MEMORY_MACHINE := true
--- a/jdk/make/javax/crypto/Defs-jce.gmk Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/javax/crypto/Defs-jce.gmk Wed Jul 05 17:42:56 2017 +0200
@@ -31,9 +31,11 @@
JCE_MANIFEST_FILE = $(TEMPDIR)/manifest.mf
$(JCE_MANIFEST_FILE): $(MAINMANIFEST)
$(prep-target)
- ( $(SED) "s/@@RELEASE@@/$(RELEASE)/" $<; \
- $(ECHO) "Extension-Name: javax.crypto"; \
- $(ECHO) "Implementation-Vendor-Id: com.sun"; ) > $@
+ $(SED) -e "s#@@RELEASE@@#$(RELEASE)#" \
+ -e "s#@@COMPANY_NAME@@#$(COMPANY_NAME)#" \
+ $(MAINMANIFEST) >> $@
+ $(ECHO) "Extension-Name: javax.crypto" >> $@
+ $(ECHO) "Implementation-Vendor-Id: com.sun" >> $@
README-MAKEFILE_WARNING = \
"\nPlease read make/javax/crypto/Makefile for further build instructions."
--- a/jdk/make/sun/jpeg/Makefile Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/sun/jpeg/Makefile Wed Jul 05 17:42:56 2017 +0200
@@ -73,9 +73,14 @@
# Recommended way to avoid such warning is to declare the variable as
# volatile to prevent the optimization. However, this approach does not
# work because we have to declare all variables as volatile in result.
-ifndef CROSS_COMPILE_ARCH
- OTHER_CFLAGS += -Wno-clobbered
-endif
+ ifndef CROSS_COMPILE_ARCH
+ CC_43_OR_NEWER := \
+ $(shell $(EXPR) $(CC_MAJORVER) \> 4 \| \
+ \( $(CC_MAJORVER) = 4 \& $(CC_MINORVER) \>= 3 \) )
+ ifeq ($(CC_43_OR_NEWER),1)
+ OTHER_CFLAGS += -Wno-clobbered
+ endif
+ endif
endif
include $(BUILDDIR)/common/Mapfile-vers.gmk
--- a/jdk/make/tools/manifest.mf Mon May 02 09:36:45 2011 -0700
+++ b/jdk/make/tools/manifest.mf Wed Jul 05 17:42:56 2017 +0200
@@ -1,7 +1,7 @@
Manifest-Version: 1.0
Specification-Title: Java Platform API Specification
Specification-Version: 1.7
-Specification-Vendor: Oracle
+Specification-Vendor: Oracle Corporation
Implementation-Title: Java Runtime Environment
Implementation-Version: @@RELEASE@@
Implementation-Vendor: @@COMPANY_NAME@@
--- a/jdk/src/linux/doc/man/ja/appletviewer.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/appletviewer.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,54 +19,44 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH appletviewer 1 "02 Jun 2010"
+.TH appletviewer 1 "14 Apr 2011"
.LP
-.SH ""
-appletviewer \- Java ≪ャ若
-.LP
-.RS 3
-
+.SH "名前"
+appletviewer \- Java アプレットビューア
.LP
.LP
-\f3appletviewer\fP 潟潟 Web 吟紊с≪絎茵障
+\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3appletviewer\fP 潟潟 \f2urls\fP 絎ャ＜潟純若鴻･膓ャ＜潟с≪ｃ潟ц；腓冴障羈: \f2urls\fP ｃсャ＜潟\f2OBJECT\fP\f2EMBED\fP障 \f2APPLET\fP 帥違с≪с翫\f3appletviewer\fP 篏茵障\f3appletviewer\fP с泣若 HTML 帥違荅括完ゃ
+\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注: \f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
.na
-\f2≪ャ若≪帥違\fP @
+\f2「アプレットビューアのタグ」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlс
+http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlを参照してください。
.LP
.LP
-\f3羈:\fP \f3appletviewer\fP RFC2396 ц鎘鴻宴若罘罕緇ｃ膃垸 URL 綽荀障泣若膃垸 URL с＜ゃゃRFC2396 絎号х垸茹ｉゃ鏆荀障
+\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-debug
-Java jdb(1) с≪ャ若≪紮障 ャ＜潟筝≪違с障
+Java デバッガ jdb(1) でアプレットビューアを開始します。これにより、ドキュメント中のアプレットをデバッグすることができます。
.TP 3
\-encoding \ \ encoding name
-ュ HTML ＜ゃ潟潟若ｃ潟医絎障
+入力 HTML ファイルのエンコーディング名を指定します。
.TP 3
\-Jjavaoption
-絖 \f2javaoption\fP appletviewer 絎茵 Java ゃ潟帥帥 1 ゃ綣違羝＜障綣違鴻若鴻障茲違綣違綣違鴻･莨 \f3\-J\fP у阪綽荀障潟潟ゃ絎茵医障＜≪若鴻с
+文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数にスペースを含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリーの利用に有効です。
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/apt.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/apt.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,102 +19,133 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH apt 1 "02 Jun 2010"
+.TH apt 1 "14 Apr 2011"
.LP
.SH "NAME"
.LP
.LP
-\f2apt\fP \- 羈若
+\f2apt\fP \- 注釈処理ツール
.LP
-.SH "綵√"
+.SH "形式"
.LP
.LP
-\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...][\f2javac option\fP] sourcefiles [@files]
+\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...] [\f2javac option\fP] sourcefiles [@files]
.LP
-.SH "＜若"
+.SH "パラメータ"
.LP
.LP
-激с潟筝с劫激с潟＜若帥ゃ筝荐激с潟с
+オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。
.LP
.RS 3
.TP 3
sourcefiles
-若1 ゃ障茲違絲乗院純若鴻＜ゃ
+ゼロ、1 つ、または複数の処理対象のソースファイル
.TP 3
@files
-純若鴻＜ゃ障篁激с潟筝荀ц；腓冴 1 ゃ障茲違＜ゃ
+ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル
.RE
.LP
-.SH "茯"
+.SH "説明"
.LP
.LP
-羈若 \f2apt\fP 違 API 泣若ゃ潟鴻ｃ若罕違羈障\f2apt\fP API 罕膀純若鴻若鴻с違罕≪茯水絨ャ若箴障 API 膩霡違菴遵緇Java(TM) 違潟域茯激鴻罩ｃ≪荐荐障\f2apt\fP 違純若鴻潟若篁＜ゃ篏羈祉泣絎茵障罨＜\f2apt\fP 純若鴻＜ゃ純若鴻＜ゃ筝≧鴻潟潟ゃ冴罐純障若ゃ潟帥с若鴻篏睡 API API \f2com.sun.mirror\fP 泣宴若吾с
+注釈処理ツール \f2apt\fP は、新しいリフレクト API とサポートインフラストラクチャーから構成され、プログラム注釈を処理します。\f2apt\fP リフレクト API は、 構築時のソースベースで、プログラム構造に関する読み取り専用ビューを提供します。これらのリフレクト API は、総称を追加した後に、Java(TM) プログラミング言語の型システムを正しくモデル化するように設計されています。最初に、\f2apt\fP は、新しいソースコードと他のファイルを作成する注釈プロセッサを実行します。次に、\f2apt\fP は、元のソースファイルと生成したソースファイルの両方をコンパイルするため、開発が楽になります。ツールとのインタフェースに使用されるリフレクト API などの API は、\f2com.sun.mirror\fP のサブパッケージです。
.LP
.LP
-若罘純≪荅括完\f2apt\fP 篏睡堺号ゃ
+ツールの機能に関する詳細と、\f2apt\fP を使用した開発方法については、
.na
-\f4\fP\f4apt\fP\f3 ラ\fP @
+\f4「apt 入門」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。
.LP
.RS 3
.TP 3
-羈:
-\f2apt\fP 罘純\f2javac(1)\fP 若筝ｃ羈ゃ潟鴻ｃ若腟粋昭障鴻 Java 潟潟ゃт戎с罔羣障違ゃ潟鴻ｃ若荐茯≪ Java 若筝ｃ羈 API 箴絖障羈祉泣冴違 API \f2javac\fP 若冴ャ茵с障
+注:
+\f2apt\fP の機能は、\f2javac(1)\fP ツールの一部となった注釈処理インフラストラクチャーに組み込まれ、すべての Java コンパイラで使用できるように標準化されました。この新しいインフラストラクチャーは、言語モデルおよび Java プラットフォームの一部となった注釈処理 API に依存します。注釈プロセッサの開発は、新しい API および \f2javac\fP ツールに基づいて行うようお勧めします。
.RE
.LP
-.SH "激с"
+.SH "オプション"
.LP
.SS
-apt 堺激с
+apt 固有のオプション
.LP
.RS 3
.TP 3
\-s dir
-祉泣純若鴻＜ゃ臀ｃ若絎障 ＜ゃ宴若吾腥咲冴ャ泣ｃ臀障
+プロセッサの生成するソースファイルを置くディレクトリルートを指定します。 ファイルは、パッケージの名前空間に基づいてサブディレクトリに置かれます。
.TP 3
\-nocompile
-純若鴻＜ゃ鴻＜ゃ潟潟ゃ障
+ソースファイルをクラスファイルにコンパイルしません。
.TP 3
\-print
-絎帥ゃ鴻茵憗阪障 羈障潟潟ゃ茵障
+指定したタイプのテキスト表現を出力します。 注釈処理またはコンパイルは行いません。
.TP 3
\-A[key[=val]]
-羈祉泣御検激с潟с 激с潟\f2apt\fP 贋･茹ｉс祉泣ｃ篏睡с紊障
+注釈プロセッサへ渡すオプションです。 このオプションは、\f2apt\fP が直接解釈するのではなく、それぞれのプロセッサによって使用できるように変えられます。
.TP 3
\-factorypath path
-羈祉泣＜罎膣≪贋絎障 激с潟篏睡翫鴻鴻＜罎膣≪障
+注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。
.TP 3
\-factory classname
-篏睡羈祉泣＜с 罎冴祉鴻ャ障
+使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。
+.TP 3
+\-version
+バージョン情報を出力します。
+.TP 3
+\-X
+非標準オプションに関する情報を表示します。
.RE
.LP
.SS
-javac 援激с
+javac と共用するオプション
.LP
.RS 3
.TP 3
\-d dir
-祉泣 javac 鴻＜ゃ臀贋絎障
+プロセッサと javac 生成のクラスファイルを置く場所を指定します。
.TP 3
-\-cp path or \-classpath path
-若吟若鴻＜ゃ羈祉泣＜罎膣≪贋絎障\f2\-factorypath\fP 絎翫鴻鴻＜罎膣≪障
+\-cp path または \-classpath path
+ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。
.RE
.LP
.LP
-\f2javac\fP 激с潟荅括完ゃjavac(1) ャ≪若吾с
+\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。
+.LP
+.SS
+非標準オプション
.LP
-.SH "羈"
+.RS 3
+.TP 3
+\-XListAnnotationTypes
+注釈の型に検出されるリスト.
+.TP 3
+\-XListDeclarations
+指定および宣言がインクルードされるリスト.
+.TP 3
+\-XPrintAptRounds
+初期および再帰的な \f2apt\fP ラウンドに関する情報を出力する.
+.TP 3
+\-XPrintFactoryInfo
+処理を要求するファクトリの注釈に関する情報を出力する.
+.TP 3
+\-XclassesAsDecls
+クラスファイルとソースファイルの両方を、処理対象の宣言として処理します。
+.RE
+
.LP
.LP
-\f2apt\fP 罘純\f2javac\fP 箴罔羣羈ゃ潟鴻ｃ若腟粋昭障障篁緇 JDK 若鴻с\f2apt\fP 渇∫ｃ API 泣若筝罩≪醇с障
+\f3注\fP: これらは非標準オプションなので、予告なく変更される可能性があります。
+.LP
+.SH "注"
.LP
-.SH "∫ｉ"
+.LP
+\f2apt\fP の機能は、\f2javac\fP により提供される標準注釈処理インフラストラクチャーに組み込まれました。今後の JDK リリースでは、\f2apt\fP および関連する API のサポートが中止する可能性があります。
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/linux/doc/man/ja/extcheck.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/extcheck.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH extcheck 1 "02 Jun 2010"
+.TH extcheck 1 "14 Apr 2011"
.LP
-.SH ""
-extcheck \- jar 腴九罎冴若ｃｃ
-.LP
-.RS 3
-
+.SH "名前"
+extcheck \- jar の競合検出ユーティリティー
.LP
.LP
-\f3extcheck\fP 帥若蚊 jar ＜ゃ憜ゃ潟鴻若≦宍罘純 jar ＜ゃ若吾с潟腴九罎冴障
+\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,39 +39,33 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3extcheck\fP 若ｃｃ若絎 Jar ＜ゃ帥ゃ潟若吾с潟 Java(TM) 2 SDK ゃ潟鴻若≦宍罘純腴九с障≦宍罘純ゃ潟鴻若若ｃｃ若篏帥ｃ若吾с潟違≦宍罘純сゃ潟鴻若茯帥鴻с障
+\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。
.LP
.LP
-\f3extcheck\fP 若ｃｃ若\f2targetfile.jar\fP ＜ゃс鴻 \f2Specification\-title\fP \f2Specification\-version\fP ≦宍罘純ｃ憜ゃ潟鴻若鴻 Jar ＜ゃ絲上若罸莠障с≦宍罘純ｃ\f2jre/lib/ext\fP с\f3extcheck\fP 若ｃｃ若\f2java.lang.Package.isCompatibleWith\fP ＜純罕号с若吾с括垩罸莠障
-.LP
-.LP
-腴九罎冴翫帥若潟潟若 \f20\fP с
+\f3extcheck\fP ユーティリティーは、targetfile.jar ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされている \f2すべての Jar ファイル内の\fP 対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。
.LP
.LP
-≦宍罘純ｃ jar ＜ゃс鴻筝 \f2Specification\-title\fP喝筝障違 \f2Specification\-version\fP 垩翫若с若潟若菴障\f2targetfile.jar\fP с鴻 \f2Specification\-title\fP 障 \f2Specification\-version\fP 絮с翫若с若潟若菴障
+競合が検出されない場合のリターンコードは \f20\fP です。
+.LP
.LP
-.SH "激с"
+拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP 、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。 \f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-verbose
-≦宍罘純ｃ Jar ＜ゃс筝荀ц；腓冴障障帥若蚊 jar ＜ゃс鴻絮с括九 jar ＜ゃゃ怨障
+拡張機能ディレクトリ内の Jar ファイルを、チェック時に一覧表示します。また、ターゲット jar ファイルのマニフェストの属性、および競合する jar ファイルについても報告します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
jar(1)
--- a/jdk/src/linux/doc/man/ja/idlj.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/idlj.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,20 +19,14 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH idlj 1 "02 Jun 2010"
+.TH idlj 1 "14 Apr 2011"
.LP
-.SH ""
-idlj \- IDL\-to\-Java 潟潟ゃ
-.LP
-.RS 3
-
+.SH "名前"
+idlj \- IDL\-to\-Java コンパイラ
.LP
-\f3idlj\fP 絎 IDL ＜ゃ Java ゃ潟ｃ潟違障
-.RE
-.SH "綵√"
-.LP
-
+\f3idlj\fP は、指定された IDL ファイルから Java バインディングを生成します。
+.SH "形式"
.LP
.nf
\f3
@@ -44,68 +38,118 @@
.LP
.LP
-\f2idl\-file\fP ゃ潟帥с若劫臂荐茯 (IDL) 絎臂ャｃ＜ゃс\f2options\fP 篁紙с\f2idl\-file\fP 絎違障
-.LP
-.SH "茯"
+\f2idl\-file\fP は、インタフェース定義言語 (IDL) による定義が入ったファイルの名前です。\f2options\fP の順番は任意ですが、\f2idl\-file\fP よりも前に指定しなければなりません。
.LP
-
+.SH "説明"
.LP
-IDL\-to\-Java 潟潟ゃ絎 IDL ＜ゃゃ Java ゃ潟ｃ潟違障 ゃ潟ｃ潟違荅括完
+.LP
+IDL\-to\-Java コンパイラは、指定された IDL ファイルについて Java バインディングを生成します。バインディングの詳細は、
.na
\f2OMG IDL to Java Language Mapping Specification\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html сIDL\-to\-Java 潟潟ゃ篁ュ若鴻筝\f2idltojava\fP ｃ障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html を参照してください。IDL\-to\-Java コンパイラの以前のリリースの中には、\f2idltojava\fP という名前だったものがあります。
+.LP
.SS
-ゃ≪潟ゃ潟ｃ潟違潟泣若若ゃ潟ｃ潟違肴
+クライアントバインディングおよびサーバーバインディングの発行
+.LP
+.LP
+My.idl という名前の IDL ファイルに対して Java バインディングを生成するには、次のコマンドを実行します。
.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
+.LP
+.LP
+これにより、クライアント側のバインディングが生成されます。このコマンドは、次のコマンドと等価です。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient\fP My.idl
+.fl
+.fi
.LP
-My.idl IDL ＜ゃ絲障 Java ゃ潟ｃ潟違罨＜潟潟絎茵障 \f2idlj My.idl\fP
.LP
-ゃ≪潟眼ゃ潟ｃ潟違障 潟潟罨＜潟潟膈箴＜с \f2idlj \fP\f4\-fclient\fP\f2 My.idl\fP
+クライアント側のバインディングには、サーバー側のスケルトンは組み込まれていません。インタフェースに対してサーバー側のバインディングを生成するには、次のコマンドを実行します。
.LP
-ゃ≪潟眼ゃ潟ｃ潟違泣若弱眼鴻宴潟腟粋昭障障ゃ潟帥с若鴻絲障泣若弱眼ゃ潟ｃ潟違罨＜潟潟絎茵障 \f2idlj \fP\f4\-fserver\fP\f2 My.idl\fP
-.LP
-泣若弱眼ゃ潟ｃ潟違ゃ≪潟眼ゃ潟ｃ潟違鴻宴潟腟粋昭障障 鴻 \f2POA\fP (膓帥≪) 鴻сゃ≪潟眼泣若弱眼筝≧鴻ゃ潟ｃ潟違翫罨＜潟潟 (膈箴) ＜ 1 ゃ篏睡障 \f2idlj \fP\f4\-fclient \-fserver\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fserver\fP My.idl
+.fl
+.fi
+
.LP
.LP
-泣若弱眼≪2 ゃ≪純с膓帥≪Tie 紮茘蚊≪с
+サーバー側のバインディングには、クライアント側のバインディングのほかに、スケルトンも含まれています。これらはすべて、 \f2POA\fP (つまり継承モデル) クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド (どれも等価) のうちの 1 つを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient \-fserver\fP My.idl
+.fl
+idlj \f3\-fall\fP My.idl
+.fl
+.fi
+
.LP
.LP
-泣若弱眼≪腱紙純泣若潟膓帥≪с\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2MyPOA.java\fP ＜ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyPOA\fP 膓帥綽荀障
+サーバー側で可能なモデルは 2 つあります。継承モデルと Tie 委譲モデルです。
.LP
.LP
-\f2MyPOA.java\fP
+デフォルトのサーバー側のモデルは、「移殖可能サーバント継承モデル」です。\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2MyPOA.java\fP というファイルが生成されます。この実装は \f2My\fP に提供し、\f2MyPOA\fP を継承する必要があります。
+.LP
+.LP
+\f2MyPOA.java\fP は
.na
\f2org.omg.PortableServer.Servant\fP @
.fi
-http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html ≦宍鴻若若鴻鴻宴潟с鴻宴潟絎茖 IDL ゃ潟帥с若鴻∫ｄ \f2InvokeHandler\fP ゃ潟帥с若鴻若激с潟ゃ潟帥с若鴻絎茖障
+http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html を拡張するストリームベースのスケルトンで、スケルトンが実装する IDL インタフェースに関連付けられている \f2InvokeHandler\fP インタフェースとオペレーションインタフェースを実装します。
.LP
.LP
.na
\f2Portable Object Adapter (POA)\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html \f2PortableServer\fP ≪吾ャ若ゃｃ \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違＜純箴障 ＜純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫ｃ泣若潟篏九勝若吟若若若ゃ障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は Java の \f2org.omg.PortableServer.Servant\fP クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。
+.LP
+.LP
+継承モデルのもう 1 つのオプションは、\f2\-oldImplBase\fP フラグを使用することで、J2SE 1.4 より前のバージョンの Java プログラミング言語と互換性のあるサーバー側バインディングを生成することです。ただし、\f2\-oldImplBase\fP フラグを使用するのは、標準的な手法ではありません。これらの API は今後非推奨になる予定です。このフラグを使用するのは、J2SE 1.3 で記述された既存のサーバーとの互換性が必要な場合だけです。その場合には既存の MAKEFILE を変更し、\f2idlj\fP コンパイラに \f2\-oldImplBase\fP フラグを追加する必要があります。そうしないと、POA ベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次のコマンドを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient \-fserver\fP \f3\-oldImplBase\fP My.idl
+.fl
+idlj \f3\-fall\fP \f3\-oldImplBase\fP My.idl
+.fl
+.fi
+
.LP
.LP
-膓帥≪ 1 ゃ激с潟\f2\-oldImplBase\fP 違篏睡J2SE 1.4 若吾с潟 Java 違潟域茯篋с泣若弱眼ゃ潟ｃ潟違с\f2\-oldImplBase\fP 違篏睡罔羣羈с障 API ｨ絅障違篏睡J2SE 1.3 ц菴違√泣若若篋с篆ゅ翫с翫√ MAKEFILE 紊眼 \f2idlj\fP 潟潟ゃ \f2\-oldImplBase\fP 違菴遵綽荀障 違菴遵翫POA 若鴻泣若弱眼潟違障筝篏篋с泣若弱眼ゃ潟ｃ潟違罨＜潟潟篏睡障
+\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2_MyImplBase.java\fP というファイルが生成されます。\f2My\fP に対してその実装を提供し、この実装は \f2_MyImplBase\fP から継承しなければなりません。
.LP
-\f2idlj \fP\f4\-fclient \-fserver\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fall\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
.LP
-\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2_MyImplBase.java\fP ＜ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyImplBase\fP 膓帥違障
+もう 1 つのサーバー側モデルは、Tie モデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tie とスケルトンを同時に生成することはできないため、それらは別々に生成しなければなりません。次のコマンドによって、Tie モデル用のバインディングが生成されます。
.LP
- 1 ゃ泣若弱眼≪Tie ≪若違с泣若弱眼≪紮茘蚊≪сTie 鴻宴潟сャ違障罨＜潟潟ｃTie ≪ゃ潟ｃ潟違障
+.nf
+\f3
+.fl
+idlj \fP\f3\-fall\fP My.idl
+.fl
+idlj \f3\-fallTIE\fP My.idl
+.fl
+.fi
+
.LP
-\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fallTIE\fP\f2 My.idl\fP
.LP
-\f2My\fP ゃ潟帥с若鴻翫筝荐 2 潟潟\f2MyPOATie.java\fP 障\f2MyPOATie\fP 潟潟鴻帥\f2delegate\fP 障箴с POA ≪篏睡潟潟鴻帥 \f2poa\fP 綽荀с\f2delegate\fP 絲障絎茖箴違障絎茖 \f2MyOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2MyPOATie\fP у茖違障違罨＜障
+\f2My\fP というインタフェースの場合、上記の 2 番目のコマンドにより、\f2MyPOATie.java\fP が生成されます。\f2MyPOATie\fP のコンストラクタは、\f2delegate\fP を取ります。この例では、デフォルトの POA モデルを使用しているため、コンストラクタにも \f2poa\fP が必要です。\f2delegate\fP に対して実装を提供しなければなりませんが、この実装は \f2MyOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2MyPOATie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。
+.LP
.nf
\f3
.fl
@@ -143,16 +187,24 @@
.fi
.LP
-篁絎茖膓帥違翫罔羣膓帥≪с Tie ≪篏睡障Java 翫ゃ潟帥с若鴻膓帥違狗障鴻膓帥篏睡с鴻 1 ゃс膓帥≪篏睡翫鴻障Tie ≪篏睡翫鴻篏睡若吟若т戎с障･с 1 ゅャ罨鴻障ゃ障＜純若喝冴篏＜純若喝冴榊障
.LP
-IDL 若吾с潟 J2SE 1.4 若吾с潟 Java 荐茯吾潟違篋с泣若弱眼 Tie ≪ゃ潟ｃ潟違罨＜潟潟篏睡障
-.LP
-\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fall\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fallTIE\fP\f2 My.idl\fP
+他の実装から継承しなければならない場合、標準の継承モデルではなく Tie モデルを使用することがあります。Java の場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは 1 つだけです。継承モデルを使用した場合は、そのスロットが占有されます。Tie モデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが 1 つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼び出しが 1 回発生します。
.LP
.LP
-\f2My\fP ゃ潟帥с若鴻翫 \f2My_Tie.java\fP 障\f2My_Tie\fP 潟潟鴻帥\f2impl\fP 障\f2impl\fP 絲障絎茖箴違障絎茖 \f2HelloOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2My_Tie\fP у茖違障違罨＜障
+IDL のバージョンから J2SE 1.4 より前のバージョンの Java 言語へのマッピングと互換性のある、サーバー側の Tie モデルのバインディングを生成するには、次のコマンドを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-oldImplBase\fP \f3\-fall\fP My.idl
+.fl
+idlj \f3\-oldImplBase\fP \f3\-fallTIE\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+\f2My\fP というインタフェースの場合、これにより \f2My_Tie.java\fP が生成されます。\f2My_Tie\fP のコンストラクタは、\f2impl\fP を取ります。\f2impl\fP に対して実装を提供しなければなりませんが、その実装は \f2HelloOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2My_Tie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。
.LP
.nf
\f3
@@ -183,201 +235,383 @@
.fi
.LP
-.RE
.SS
-肴＜ゃ篁ｆ推臀絎
+発行されたファイルの代替位置の指定
+.LP
+.LP
+発行されたファイルをカレントディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。
.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj \fP\f3\-td /altdir\fP My.idl
+.fl
+.fi
.LP
-肴＜ゃ潟ｃ篁ュｃ臀罨＜潟潟с潟潟ゃ若喝冴障
-.RS 3
+.LP
+\f2My\fP インタフェースの場合、バインディングは、\f2./My.java\fP ではなく、\f2/altdir/My.java\fP などに発行されます。
+.LP
+.SS
+インクルードファイルの代替位置の指定
+.LP
+.LP
+\f2My.idl\fP にもう 1 つの IDL ファイル \f2MyOther.idl\fP がインクルードされている場合、コンパイラは、ローカルディレクトリに \f2MyOther.idl\fP があるものと想定します。もしそのファイルが、たとえば \f2/includes\fP にある場合は、次のようなコマンドでコンパイラを呼び出します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-i /includes\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+また、もし \f2My.idl\fP に、たとえば \f2/moreIncludes\fP にある \f2Another.idl\fP もインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-i /includes \-i /moreIncludes\fP My.idl
+.fl
+.fi
.LP
-\f2idlj \fP\f4\-td /altdir\fP\f2 My.idl\fP
-.RE
-\f2My\fP ゃ潟帥с若鴻翫ゃ潟ｃ潟違\f2./My.java\fP с\f2/altdir/My.java\fP 肴障
-.RE
-.SS
-ゃ潟若＜ゃ篁ｆ推臀絎
+.LP
+このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルードファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATH にリストされているディレクトリ内に \f2idl.config\fP という名前のファイルを作成します。その \f2idl.config\fP の中に、次のような形式の行を入れます。
.LP
-.RS 3
+.nf
+\f3
+.fl
+includes=/includes;/moreIncludes
+.fl
+\fP
+.fi
.LP
-\f2My.idl\fP 1 ゃ IDL ＜ゃ \f2MyOther.idl\fP ゃ潟若翫潟潟ゃ若ｃ \f2MyOther.idl\fP 喝障＜ゃ \f2/includes\fP 翫罨＜潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes\fP\f2 My.idl\fP
.LP
-障 \f2My.idl\fP \f2/moreIncludes\fP \f2Another.idl\fP ゃ潟若с違罨＜潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes \-i /moreIncludes\fP\f2 My.idl\fP
-.LP
-綵√сゃ潟若絎潟潟激茲障 сゃ潟若＜ゃ罎膣≪贋潟潟ゃ腓冴ャ号障号医紊違鴻篌若障CLASSPATH 鴻ｃ \f2idl.config\fP ＜ゃ篏障 \f2idl.config\fP 筝罨＜綵√茵ャ障 \f2includes=/includes;/moreIncludes\fP
-.LP
-潟潟ゃ＜ゃ罎膣≪ゃ潟若鴻茯粋昭帥障箴сｃ阪絖祉潟 (;) ｃ障阪絖若ｃ違障違Windows 若с祉潟潟сUnix 若с潟潟с \f2ゃ潟若\fP荅括完ゃ
+コンパイラは、このファイルを検索し、インクルードリストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン (;) になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windows プラットフォームではセミコロンですが、Unix プラットフォームではコロンです。 \f2インクルード\fPの詳細については、
.na
-\f2CLASSPATH 荐絎\fP @
+\f2CLASSPATH の設定\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#general с
-.RE
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#general を参照してください。
+.LP
.SS
-ゃ潟若＜ゃ絲障ゃ潟ｃ潟違肴
+インクルードファイルに対するバインディングの発行
+.LP
+.LP
+デフォルトでは、コマンド行に指定した IDL ファイルで定義されているインタフェースや構造体などについてのみ、Java バインディングが生成されます。インクルードされたファイルで定義されている型については、Java バインディングは生成されません。たとえば、次の 2 つの IDL ファイルについて考えてみましょう。
+.LP
+
+.LP
+.LP
+\f4My.idl\fP
.LP
-.RS 3
+.nf
+\f3
+.fl
+#include <MyOther.idl>
+.fl
+interface My
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
.LP
-с潟潟茵絎 IDL ＜ゃу臂ゃ潟帥с若鴻罕篏ゃ帥Java ゃ潟ｃ潟違障ゃ潟若＜ゃу臂ゃJava ゃ潟ｃ潟違障違罨＜ 2 ゃ IDL ＜ゃゃ帥障 \f4My.idl\fP
+
.LP
-\f2#include <MyOther.idl>\fP
-.br
-\f2interface My\fP
-.br
-\f2{\fP
-.br
-\f2};\fP
-.br
-\f4MyOther.idl\fP
+.LP
+\f4MyOther.idl\fP
.LP
-\f2interface MyOther\fP
-.br
-\f2{\fP
-.br
-\f2};\fP\
-.LP
-罨＜潟潟с\f2My\fP 絲障 Java ゃ潟ｃ潟違障 \f2idlj My.idl\fP
-.LP
-\f2My.idl\fP у臂\f2My.idl\fP ゃ潟若＜ゃ (箴с \f2MyOther.idl\fP) у臂鴻ゃ Java ゃ潟ｃ潟違罨＜潟潟篏睡障 \f2idlj \fP\f4\-emitAll\fP\f2 My.idl\fP
+.nf
+\f3
+.fl
+interface MyOther
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
+
.LP
-荀≪羈違障違若鴻潟若絎 \f2#include\fP 菴違障 \f2#include\fP ゃ潟若荀с障絲障篁絎臂蚊障鴻潟若絎 \f2#include\fP 綵潟с \f2#include\fP 障 ゃ障ゃ潟若＜ゃ潟若＜ゃ障丈絎絲障 Java ゃ潟ｃ潟違肴障罨＜箴腓冴障 \f4My.idl\fP
+
.LP
-\f2#include <MyOther.idl>\fP
-.br
-\f2interface My\fP
-.br
-\f2{\fP
-.br
-\f2\ #include <Embedded.idl>\fP
-.br
-\f2};\ \fP \f4MyOther.idl\fP
.LP
-\f2interface MyOther\fP
-.br
-\f2{\fP
-.br
-\f2};\ \fP \f4Embedded.idl\fP
-.LP
-\f2enum E {one, two, three};\fP\
-.LP
-罨＜潟潟絎茵 \f2idlj My.idl\fP
+次のコマンドでは、\f2My\fP に対する Java バインディングだけが生成されます。
.LP
-罨＜筝ｃ Java ＜ゃ障 \f2./MyHolder.java\fP
-.br
-\f2./MyHelper.java\fP
-.br
-\f2./_MyStub.java\fP
-.br
-\f2./MyPackage\fP
-.br
-\f2./MyPackage/EHolder.java\fP
-.br
-\f2./MyPackage/EHelper.java\fP
-.br
-\f2./MyPackage/E.java\fP
-.br
-\f2./My.java\fP
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
.LP
-ゃ潟若荀 \f2#include\fP 絎臂\f2MyOther.java\fP 障綵潟с \f2#include\fP у臂\f2E.java\fP 障\f2Embedded.idl\fP \f2My\fP ゃ潟帥с若鴻鴻潟若ゃ潟若\f2My\fP 鴻潟若 (ゃ障\f2MyPackage\fP ) 障
.LP
-筝荐箴 \f2\-emitAll\fP 違篏睡違ゃ潟若鴻＜ゃ鴻肴障
+\f2My.idl\fP で定義されている型と、\f2My.idl\fP にインクルードされたファイル (この例では \f2MyOther.idl\fP) で定義されている型すべてについて Java バインディングを生成するには、次のコマンドを使用します。
.LP
-.RE
-.SS
-宴若吾･莨水
-.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj \fP\f3\-emitAll\fP My.idl
+.fl
+.fi
.LP
-ABC 篌腓障篏罐罨＜ IDL ＜ゃ罕膀障
-.br
-\f4Widgets.idl\fP
.LP
-\f2module Widgets\fP
-.br
-\f2{\fP
-.br
-\f2\ interface W1 {...};\fP
-.br
-\f2\ interface W2 {...};\fP
-.br
-\f2};\fP\
+このデフォルトの規則に関して注意しなければならないことがあります。グローバルスコープに指定した \f2#include\fP 文は、前述のとおりに処理されます。これらの \f2#include\fP 文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した \f2#include\fP 文は、本当の意味での \f2#include\fP 文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対して Java バインディングが発行されます。次はその例です。
.LP
-＜ゃ絲障 IDL\-to\-Java 潟潟ゃ絎茵\f2W1\fP \f2W2\fP 絲障 Java ゃ潟ｃ潟違 \f2Widgets\fP 宴若後障罐ｄ篌腓障宴若吾\f2com.<篌腓上>\fP 宴若後臀ｃ障\f2Widgets\fP 宴若吾с筝сｄ緇宴若吾 \f2com.abc.Widgets\fP 綽荀障宴若御･莨 \f2Widgets\fP ≪吾ャ若篁罨＜潟潟絎茵障 \f2idlj \fP\f4\-pkgPrefix Widgets com.abc\fP\f2 Widgets.idl\fP
-.LP
-\f2Widgets.idl\fP ゃ潟若 IDL ＜ゃ翫潟潟 \f2\-pkgPrefix\fP 違綽荀с違絎 IDL ＜ゃ\f2com.abc.Widgets\fP 宴若吾с\f2Widgets\fP 宴若吾罎膣≪障
-.LP
-･莨綽荀宴若吾ゃ翫菴違 \f2idl.config\fP ＜ゃф･莨絎膂≦с宴若吾･莨絎茵罨＜綵√ц菴違障
-.LP
-\f2PkgPrefix.<type>=<prefix>\fP
-.LP
-ｃ筝荐箴翫罨＜荐菴違障 \f2PkgPrefix.Widgets=com.abc\fP
+
.LP
.LP
-激с潟篏睡吾 ID 綵演帥障
-.LP
-.RE
-.SS
-潟潟ゃ激潟絎臂
-.LP
-.RS 3
-
+\f4My.idl\fP
.LP
-潟潟ゃ激潟 IDL ＜ゃу臂翫激潟絎臂綽荀障 違ゃ潟ｃ潟医違潟若腟水ャ篏睡障罨＜潟潟 \f2idlj \fP\f4\-d\fP\f2 MYDEF My.idl\fP
-.LP
-\f2My.idl\fP \f2#define MYDEF\fP 茵絎翫膈箴＜с
-.RE
-.SS
-√ゃ潟ｃ潟違篆
-.LP
-.RS 3
+.nf
+\f3
+.fl
+#include <MyOther.idl>
+.fl
+interface My
+.fl
+{
+.fl
+ #include <Embedded.idl>
+.fl
+};
+.fl
+\fP
+.fi
.LP
-Java ゃ潟ｃ潟違＜ゃс絖翫\f2\-keep\fP 違絎潟潟ゃ筝吾帥с障сс絖鴻＜ゃ障＜ゃ鴻帥ゃ冴翫 (絎鴻罩ｇ∈с篁ュ鴻帥ゃ冴帥)\f2\-keep\fP 激с潟с罨＜潟潟 \f2idlj \fP\f4\-keep\fP\f2 My.idl\fP
-.LP
-ゃ≪潟眼ゃ潟ｃ潟違с障絖鴻肴障
-.RE
-.SS
-潟潟ゃ我倶茵腓
-.LP
-.RS 3
.LP
-IDL\-to\-Java 潟潟ゃ絎茵罧級х倶＜祉若吾障激≪若 (＜祉若吾紊≪若) \f2\-v\fP 激с潟篏睡障 \f2idlj \fP\f4\-v\fP\f2 My.idl\fP
+.LP
+\f4MyOther.idl\fP
.LP
-с潟潟ゃ激≪若с絎茵障
-.RE
-.SS
-若吾с恰宴茵腓
+.nf
+\f3
+.fl
+interface MyOther
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
+
.LP
-.RS 3
.LP
.LP
-IDL\-to\-Java 潟潟ゃ若吾с潟茵腓冴潟潟茵 \f2\-version\fP 激с潟絎障
+\f4Embedded.idl\fP
+.LP
+.nf
+\f3
+.fl
+enum E {one, two, three};
+.fl
+\fP
+.fi
+
+.LP
+
+.LP
+.LP
+このとき、次のコマンドを実行すると、
+.LP
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
.LP
.LP
-\f2idlj \-version\fP
+次のような一連の Java ファイルが生成されます。
+.LP
+.nf
+\f3
+.fl
+./MyHolder.java
+.fl
+./MyHelper.java
+.fl
+./_MyStub.java
+.fl
+./MyPackage
+.fl
+./MyPackage/EHolder.java
+.fl
+./MyPackage/EHelper.java
+.fl
+./MyPackage/E.java
+.fl
+./My.java
+.fl
+\fP
+.fi
+
+.LP
+.LP
+インポート文と見なされる \f2#include\fP に定義されているため、\f2MyOther.java\fP は生成されません。ただし、本当の意味での \f2#include\fP で定義されているため、\f2E.java\fP は生成されます。さらに、\f2Embedded.idl\fP が \f2My\fP インタフェースのスコープ内にインクルードされていたため、\f2My\fP のスコープ内 (つまり、\f2MyPackage\fP 内) に生成されています。
+.LP
+.LP
+上記の例で \f2\-emitAll\fP フラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。
+.LP
+.SS
+パッケージの接頭辞の挿入
+.LP
+.LP
+ABC という名前の会社のために作業していて、次のような IDL ファイルを構築したとしましょう。
+.LP
+
+.LP
+.LP
+\f4Widgets.idl\fP
+.LP
+.nf
+\f3
+.fl
+module Widgets
+.fl
+{
+.fl
+ interface W1 {...};
+.fl
+ interface W2 {...};
+.fl
+};
+.fl
+\fP
+.fi
+
+.LP
+
.LP
.LP
-若吾с恰宴潟潟ゃｃゃ潟ｃ潟医吾莨若障障激с潟潟潟茵絎篁ュ激с潟絎鴻∴障
+このファイルに対して IDL\-to\-Java コンパイラを実行すると、\f2W1\fP および \f2W2\fP に対する Java バインディングが \f2Widgets\fP パッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<会社名>\fP という名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fP パッケージでは不十分です。慣例に従うには、パッケージを \f2com.abc.Widgets\fP にする必要があります。このパッケージ接頭辞を \f2Widgets\fP モジュールに付加するには、次のコマンドを実行します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-pkgPrefix Widgets com.abc\fP Widgets.idl
+.fl
+.fi
+
+.LP
+.LP
+\f2Widgets.idl\fP をインクルードしている IDL ファイルがある場合は、そのコマンドにも \f2\-pkgPrefix\fP フラグが必要です。このフラグを指定しないと、その IDL ファイルは、\f2com.abc.Widgets\fP パッケージではなく、\f2Widgets\fP パッケージを検索することになります。
+.LP
+.LP
+接頭辞が必要なパッケージがいくつもある場合は、前述の \f2idl.config\fP ファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。
+.LP
+.nf
+\f3
+.fl
+PkgPrefix.<type>=<prefix>
+.fl
+\fP
+.fi
+
+.LP
+したがって、上記の例の場合は、次のように記述します。
+.nf
+\f3
+.fl
+PkgPrefix.Widgets=com.abc
+.fl
+\fP
+.fi
+
+.LP
+.LP
+このオプションを使用しても、リポジトリ ID は影響を受けません。
+.LP
+.SS
+コンパイル前のシンボルの定義
+.LP
+.LP
+コンパイル用のシンボルが IDL ファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグコードを組み入れるときに使用します。次のコマンドは、
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-d\fP MYDEF My.idl
+.fl
+.fi
+
+.LP
.LP
-.RE
-.SH "激с"
+\f2My.idl\fP 内に \f2#define MYDEF\fP という行を指定した場合と等価です。
+.LP
+.SS
+既存のバインディングの保持
+.LP
+.LP
+Java バインディングファイルがすでに存在する場合は、\f2\-keep\fP フラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合 (ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\-keep オプションは有用です。次のコマンドは、
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-keep\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+クライアント側のバインディングで、まだ存在しないものをすべて発行します。
+.LP
+.SS
+コンパイルの進捗状況の表示
+.LP
+.LP
+IDL\-to\-Java コンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モード (メッセージが多いモード) にするには、\f2\-v\fP オプションを使用します。
.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-v\fP My.idl
+.fl
+.fi
.LP
+.LP
+デフォルトでは、コンパイラは冗長モードでは実行されません。
+.LP
+.SS
+バージョン情報の表示
+.LP
+.LP
+IDL\-to\-Java コンパイラのビルドバージョンを表示するには、コマンド行で \f2\-version\fP オプションを指定します。
+.LP
+.nf
+\f3
+.fl
+idlj \-version
+.fl
+\fP
+.fi
+
+.LP
+.LP
+バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。
+.LP
+.SH "オプション"
+.LP
.RS 3
.TP 3
\-d symbol
-激с潟IDL ＜ゃ罨＜茵菴遵翫膈箴＜с
-.RS 3
-
-.LP
+このオプションは、IDL ファイルに次のような行を追加した場合と等価です。
.nf
\f3
.fl
@@ -385,33 +619,32 @@
.fl
\fP
.fi
-.RE
.TP 3
\-emitAll
-\f2#include\fP ＜ゃу臂鴻肴障
+#include ファイル 内で定義されているものも含めて、 \f2すべての型を\fP 発行します。
.TP 3
\-fside
-肴ゃ潟ｃ潟違絎臂障 \f2side\fP \f2client\fP\f2server\fP\f2serverTIE\fP\f2all\fP\f2allTIE\fP ＜с\f2\-fserverTIE\fP 障 \f2\-fallTIE\fP 激с潟絎紮茘蚊≪鴻宴潟肴障違絎ｃ翫\f2\-fclient\fP 絎荀障
+発行するバインディングを定義します。\f2side\fP は \f2client\fP、\f2server\fP、\f2serverTIE\fP、\f2all\fP、\f2allTIE\fP のいずれかになります。\f2\-fserverTIE\fP または \f2\-fallTIE\fP オプションを指定すると、委譲モデルスケルトンが発行されます。このフラグを指定しなかった場合は、\f2\-fclient\fP が指定されたものと見なされます。
.TP 3
\-i include\-path
-сゃ潟若＜ゃ潟ｃ罎膣≪障激с潟絎祉ｃ菴遵с障
+デフォルトでは、インクルードファイルはカレントディレクトリから検索されます。このオプションを指定すると、ほかのディレクトリを追加できます。
.TP 3
\-keep
-＜ゃс絖翫＜ゃ筝吾障с筝吾障
+生成されるファイルがすでに存在している場合は、そのファイルが上書きされません。デフォルトでは、上書きされます。
.TP 3
\-noWarn
-茘＜祉若吾茵腓冴障
+警告メッセージを表示しないようにします。
.TP 3
\-oldImplBase
-v1.4 JDK ORB 篋с鴻宴潟障сPOA 膓帥≪泣若弱眼ゃ潟ｃ潟違障激с潟絎\f2ImplBase\fP 膓帥≪鴻с泣若弱眼ゃ潟ｃ潟違сゃ若吾с潟 Java 違潟域茯筝篏篋с緇障
+v1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。デフォルトでは、POA 継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\f2ImplBase\fP 継承モデルのクラスであるサーバー側バインディングが生成されるので、古いバージョンの Java プログラミング言語との下位互換性が得られます。
.TP 3
\-pkgPrefix type prefix
-\f2type\fP ＜ゃ鴻潟若ф冴翫絲障鴻＜ゃゃ Java 宴若後 \f2prefix\fP ･莨篁障\f2type\fP ≪吾ャ若膣≪吾ャ若紊眼у臂 IDL 膣＜с
+\f2type\fP がファイルスコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成される Java パッケージ名に \f2prefix\fP という接頭辞が付加されます。\f2type\fP は、トップレベルモジュールの単純名か、どのモジュールよりも外側で定義された IDL 型の単純名のどちらかです。
.TP 3
\-pkgTranslate type package
-茘ュ筝≪吾ャ若 \f2type\fP 罎冴 Java 宴若後鴻＜ゃゃ茘ュ筝 \f2package\fP х舟障 \f2pkgPrefix\fP 紊眼障\f2type\fP ≪吾ャ若障鴻≪吾ャ若紊у臂 IDL 膣с 絎宴若後罩ｇ∈筝眼違障
+識別子の中にモジュール名 type が検出されると、生成される Java パッケージ内のすべてのファイルについて、識別子の中のその名前が package で置き換えられます。最初に \f2pkgPrefix\fP を変更します。\f2type\fP は、トップレベルのモジュール、またはすべてのモジュールの外部で定義された IDL 型の単純名です。そして、完全なパッケージ名に正確に一致しなければなりません。
.LP
-1 ゃ茘ュ筝ц違紊翫ｃ激吾違障違罨＜綣違絎翫
+1 つの識別子の中で複数の変換がマッチする場合は、もっとも長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、
.nf
\f3
.fl
@@ -420,89 +653,85 @@
\fP
.fi
.LP
-罨＜紊絎純障
+次のような変換が実施されます。
.nf
\f3
.fl
-foo => bar
+foo => bar
.fl
-foo.boo => bar.boo
+foo.boo => bar.boo
.fl
-foo.baz => buzz.fizz
+foo.baz => buzz.fizz
.fl
-foo.baz.bar => buzz.fizz.bar
+foo.baz.bar => buzz.fizz.bar
.fl
\fP
.fi
.LP
-罨＜宴若後紊с障
+次のパッケージ名を変換することはできません。
.RS 3
.TP 2
o
\f2org\fP
.TP 2
o
-\f2org.omg\fP障 \f2org.omg\fP 泣宴若
+\f2org.omg\fP、または \f2org.omg\fP のサブパッケージ
.RE
.LP
-宴若後紊篋с潟若障 \f2\-pkgTranslate\fP 綣違宴若吾篏睡若宴障
+これらのパッケージ名を変換しようとすると、互換性のないコードが生成されます。そして、\f2\-pkgTranslate\fP のあとの最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。
.TP 3
\-skeletonName xxx%yyy
-\f2xxx%yyy\fP 鴻宴潟篁帥若潟篏睡障罨＜с
+\f2xxx%yyy\fP が、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。
.RS 3
.TP 2
o
-\f2POA\fP 阪鴻翫%POA(\f2\-fserver\fP 障 \f2\-fall\fP)
+\f2POA\fP 基底クラスの場合は「%POA」(\f2\-fserver\fP または \f2\-fall\fP)
.TP 2
o
-\f2oldImplBase\fP 鴻翫_%ImplBase(\f2\-oldImplBase\fP (\f2\-fserver\fP 障 \f2\-fall\fP))
+\f2oldImplBase\fP クラスの場合は「_%ImplBase」(\f2\-oldImplBase\fP かつ (\f2\-fserver\fP または \f2\-fall\fP))
.RE
.TP 3
\-td dir
-阪ｃ潟ｃс\f2dir\fP 篏睡障
+出力ディレクトリとして、カレントディレクトリではなく、\f2dir\fP が使用されます。
.TP 3
\-tieName xxx%yyy
-帥若潟緇ｃ Tie 篁障罨＜с
+このパターンに従って Tie に名前が付けられます。デフォルトは次のとおりです。
.RS 3
.TP 2
o
-\f2POA\fP Tie 阪鴻翫%POATie(\f2\-fserverTie\fP 障 \f2\-fallTie\fP)
+\f2POA\fP Tie 基底クラスの場合は「%POATie」(\f2\-fserverTie\fP または \f2\-fallTie\fP)
.TP 2
o
-\f2oldImplBase\fP Tie 鴻翫%_Tie(\f2\-oldImplBase\fP (\f2\-fserverTie\fP 障 \f2\-fallTie\fP))
+\f2oldImplBase\fP Tie クラスの場合は「%_Tie」(\f2\-oldImplBase\fP かつ (\f2\-fserverTie\fP または \f2\-fallTie\fP))
.RE
.TP 3
-\-verbose
-激≪若障
+\-nowarn, \-verbose
+冗長モードになります。
.TP 3
\-version
-若吾с恰宴茵腓冴腟篋障
+バージョン情報を表示して終了します。
.RE
.LP
-激с潟荅括完ゃ茯祉激с潟с
-.SH "句"
-.LP
-
+各オプションの詳細については、「説明」のセクションを参照してください。
+.SH "制約"
.LP
.RS 3
.TP 2
o
-違若鴻潟若鴻宴若茘ュIDL ｃ \f2Object\fP 障 \f2ValueBase\fP 膓眼сｃ障茘ュゃ激潟若篋若茘ュ絎臂荐怨絎臂筝吾障障箙句с
+グローバルスコープ内のエスケープされた識別子は、IDL プリミティブ型の \f2Object\fP または \f2ValueBase\fP と同じ綴りであってはなりません。これらの識別子については、シンボルテーブルが事前にロードされており、これらの識別子の再定義を許可すると元の定義が上書きされてしまいます。これは、おそらく恒久的な制約です。
.TP 2
o
-\f2fixed\fP IDL 泣若障
+\f2fixed\fP という IDL 型はサポートされていません。
.RE
.LP
-.SH "∝ャ馹"
-.LP
-
+.SH "既知の問題点"
.LP
.RS 3
.TP 2
o
-違若茘ュゃゃ潟若障篋若 impl 若喝冴箴紊障 \f2ServerDelegate\fP DSI 潟若 \f2NullPointerException\fP с
+グローバル識別子についてインポートが生成されません。予期されないローカル impl を呼び出すと、例外を受け取ります。 しかし、その原因は、\f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP にあるようです。
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/jar.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jar.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,104 +19,93 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jar 1 "02 Jun 2010"
+.TH jar 1 "14 Apr 2011"
.LP
-.SH ""
-jar \- Java ARchive 若
+.SH "名前"
+jar \- Java ARchive ツール
.LP
-\f3jar\fP 茲違＜ゃ 1 ゃ JAR ≪若ゃ＜ゃ腟障
+\f3jar\fP は複数のファイルを 1 つの JAR アーカイブファイルに結合します。
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-潟潟茵綣違＜ゃ
+コマンド行引数ファイル
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.RS 3
.TP 3
-JAR ＜ゃ篏
+JAR ファイルの作成
\f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ贋
+JAR ファイルの更新
\f4jar u\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ遵
+JAR ファイルの抽出
\f4jar x\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ絎鴻茵綵√筝荀ц；腓
+JAR ファイルの内容の表形式による一覧表示
\f4jar t\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ吾ゃ潟鴻菴遵
+JAR ファイルへのインデックスの追加
\f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
.RE
.LP
.LP
-茯
-.LP
-.RS 3
-
+説明
.LP
.RS 3
.TP 3
cuxtiv0Mmfe
-\f2jar\fP 潟潟九勝激с
+\f2jar\fP コマンドを制御するオプション
.TP 3
jarfile
-篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)障絎鴻筝荀ц；腓 (\f2t\fP) 絲乗院 JAR ＜ゃ\f2f\fP 激с潟＜ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュJAR ＜ゃ緇 (x t 翫)罔羣阪吾JAR ＜ゃ篆＜障(c u 翫)
+作成 (\f2c\fP)、更新 (\f2u\fP)、抽出 (\f2x\fP)、または目次表示 (\f2t\fP) の対象となる JAR ファイル。\f2f\fP オプションとファイル名 \f2jarfile\fP とがペアになります。 つまり、片方を記述すれば、もう一方も記述する必要があります。 \f2f\fP と \f2jarfile\fP を省略すると、標準入力から「JAR ファイル」が取得されるか (x および t の場合)、標準出力へ「JAR ファイル」が送信されます(c および u の場合)。
.TP 3
inputfiles
-\f2jarfile\fP 腟 (c u 翫)\f2jarfile\fP 遵 (x 翫) 障筝荀ц；腓 (t 翫) 腥榊純у阪＜ゃ障ｃ鴻ｃ絽亥障＜ゃ激с \f2O\fP (若) 篏睡х軒障
+\f2jarfile\fP に結合されるか (c および u の場合)、\f2jarfile\fP から抽出 (x の場合) または一覧表示 (t の場合) される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション \f20\fP (ゼロ) を使用しないかぎり圧縮されます。
.TP 3
manifest
-\f2name\fP\f2:\fP\f2value\fP ≪JAR ＜ゃ MANIFEST.MF 障√с鴻＜ゃ\f2\-m\fP 激с潟＜ゃ \f2manifest\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
+JAR ファイルの MANIFEST.MF 内に含めるべき \f2name\fP\f2:\fP \f2value\fP ペアが含まれている既存のマニフェストファイル。\f2m\fP オプションとファイル名 \f2manifest\fP とがペアになります。つまり、片方を記述すれば、もう一方も記述する必要があります。\f3m\fP、\f3f\fP、および \f3e\fP の出現順序は、\f2manifest\fP、\f2jarfile\fP、\f2entrypoint\fP の出現順序と一致する必要があります。
.TP 3
entrypoint
-絎茵 JAR ＜ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟荐絎鴻\f2\-e\fP 激с潟 entrypoint 絲障ｃ障 ＜絎翫筝≧鴻絎綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
+実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして設定するクラスの名前。\f2\-e\fP オプションと entrypoint は対になっています。どちらかを指定する場合は両方とも指定する必要があります。\f3m\fP、\f3f\fP、および \f3e\fP の出現順序は、\f2manifest\fP、\f2jarfile\fP、\f2entrypoint\fP の出現順序と一致する必要があります。
.TP 3
\-C\ dir
-膓 \f2inputfiles\fP 綣違ｃ \f2dir\fP 娯紊眼障\f2\-C\ \fP\f2dir\fP \f2inputfiles\fP 祉茲遺戎с障
+これに続く \f2inputfiles\fP 引数を処理する間、ディレクトリを \f2dir\fP へ一時的に変更します。 \f2\-C\ \fP\f2\-\ dir\fP \f2inputfiles\fP のセットは複数使用できます。
.TP 3
\-Joption
-Java 絎茵医御検激с潟\f2\-J\fP \f2option\fP 腥榊純ャс
+Java 実行環境へ渡されるオプション。\f2\-J\fP と \f2option\fP の間には空白を入れないでください。
.RE
.LP
-.RE
-.SH "茯"
+.SH "説明"
.LP
-
-.LP
-\f3jar\fP 若茲違＜ゃ 1 ゃ JAR ≪若ゃ＜ゃ腟障 \f3jar\fP ZIP
+\f3jar\fP ツールは複数のファイルを 1 つの JAR アーカイブファイルに結合します。\f3jar\fP は、ZIP および
.na
\f2ZLIB\fP @
.fi
-http://www.gzip.org/zlib/ х軒綵√若鴻羆≪若ゃ喝х軒若с \f3jar\fP 若筝祉ゃ Java ≪≪宴若激с潟 1 ≪若ゃ腟怨с≪≪宴若激с潟潟潟若潟 (＜ゃゃ＜若吾潟泣潟) 1 ゃ≪若ゃ腟Java 若吾с潟 (吟) 潟潟若潟 1 HTTP 潟吟激с潟с潟若с潟潟若潟違･膓綽荀障ｃ潟若違紊у羝障 障\f3jar\fP ＜ゃх軒с潟若障障＜ゃ潟≪篏臀峨吾莨若с絽茯荐若純障jar 若罕\f2tar\fP 潟潟罕祉弱с\f3JAR\fP ≪若ゃх軒鴻鴻潟篏睡с障
+http://www.gzip.org/zlib/ 圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし \f3jar\fP ツールの主な目的は、いくつかの Java アプレットやアプリケーションを 1 個のアーカイブに統合することです。アプレットやアプリケーションのコンポーネント (ファイル、イメージ、およびサウンド) が 1 つのアーカイブに結合されていると、Java エージェント (ブラウザなど) は、それらのコンポーネントを 1 回の HTTP トランザクションでダウンロードすることができ、コンポーネントごとに新しい接続を必要とすることがありません。これにより、ダウンロード時間が大幅に短縮されます。また、\f3jar\fP はファイルの圧縮も行うので、ダウンロード時間がさらに短縮されます。また、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるので、配布元の認証が可能になります。jar ツールの構文は、\f2tar\fP コマンドの構文とほぼ同じです。\f3JAR\fP アーカイブは、圧縮されているかどうかにかかわらず、クラスパスのエントリとして使用できます。
.LP
-茲違＜ゃ JAR ＜ゃ悟筝篏睡羈罨＜с
-.LP
-.RS 3
-
+複数のファイルを JAR ファイルへ結合する一般的な使用法は次のとおりです。
.LP
.nf
\f3
@@ -125,19 +114,15 @@
.fl
\fP
.fi
-.RE
.LP
-箴с憜ｃ (.class) ＜ゃ鴻\f2myFile.jar\fP ＜ゃ主障jar 若\f2META\-INF/MANIFEST.MF\fP с鴻＜ゃ潟障絽吾JAR ＜ゃ潟障с鴻＜ゃ≪若ゃ≪＜炊宴絎ｈ若帥 \f2name\ :\ value\fP ≪主障jar 若с鴻＜ゃ＜炊宴主号荅括完ゃ
+この例では、現在のディレクトリにあるクラス (.class) ファイルがすべて、\f2myFile.jar\fP という名前のファイルに格納されます。jar ツールは自動的に、 \f2META\-INF/MANIFEST.MF\fP という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを \f2name\ :\ value\fP ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、「
.na
\f2JAR file specification\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifestс
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest」を参照してください。
.LP
-√с鴻＜ゃ主 \f2name\ :\ value\fP ≪ JAR ＜ゃ綽荀翫＜ゃ罨＜ \f2\-m\fP 激с潟篏帥ｃ絎障
-.LP
-.RS 3
-
+既存のマニフェストファイル内に格納された \f2name\ :\ value\fP ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。
.LP
.nf
\f3
@@ -146,20 +131,16 @@
.fl
\fP
.fi
-.RE
.LP
-√с鴻＜ゃ壕絖хｃ綽荀障 с鴻＜ゃ壕絖хｃ翫\f3jar\fP 緇茵茹ｆ障
+既存のマニフェストファイルは改行文字で終わっている必要があります。マニフェストファイルが改行文字で終わっていないと、\f3jar\fP はその最終行を解析しません。
.br
.LP
.br
.LP
-\f3羈:\ \fP潟潟茵 \f2cmf\fP с \f2cfm\fP 絎 jar 潟潟 (m \-f 激с潟) 翫\f3jar\fP 潟潟茵障 JAR ≪若ゃ絎膓с鴻＜ゃ絎綽荀障 罨＜箴腓冴障
-.RS 3
-
-.LP
+\f3注:\ \fPコマンド行に \f2cmf\fP ではなく \f2cfm\fP が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず JAR アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。 次に例を示します。
.nf
\f3
.fl
@@ -167,15 +148,11 @@
.fl
\fP
.fi
-.RE
.LP
-с鴻RFC822 ASCII 綵√ц鎘鴻綵√сс鴻＜ゃ絎鴻膂≦茵腓冴括隈с障
+マニフェストは、RFC822 ASCII 形式で規定されたテキスト形式であるため、マニフェストファイルの内容を簡単に表示および編集できます。
.LP
-JAR ＜ゃ＜ゃ遵冴翫\f2x\fP 篏睡障
-.LP
-.RS 3
-
+JAR ファイルからファイルを抽出する場合は、 \f2x\fP を使用します。
.LP
.nf
\f3
@@ -184,14 +161,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-jar ＜ゃャ＜ゃ遵冴翫＜ゃ絎障
-.LP
-.RS 3
-
+jar ファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。
.LP
.nf
\f3
@@ -200,18 +173,14 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-JDK 若吾с 1.3 篁ラ\f2jar\fP 若ｃｃ若
+JDK のバージョン 1.3 以降から、\f2jar\fP ユーティリティーで
.na
\f2JarIndex\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex 泣若障 JarIndex 篏睡≪宴若激с潟鴻若若 JAR ＜ゃ鴻若合筝障≪宴若激с潟障≪茲違 JAR ＜ゃ潟翫鴻若綽荀 JAR ＜ゃ篁ュ潟若潟若潟茵障若潟鴻違 \f2\-i\fP 激с潟絎 \f2jar\fP 絎茵鴻障激с潟篏帥絎 JAR ＜ゃ潟＜ゃ＜ゃ潟＜ゃ箴絖鴻 JAR ＜ゃゃ宴若娯臀宴障 ＜ゃ潟＜ゃ箴絖 JAR ＜ゃJAR ＜ゃ潟＜ゃс鴻 \f2Class\-Path\fP 絮с絎鏆荀障
-.LP
-.RS 3
-
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index がサポートされています。 JarIndex を使用すると、アプリケーションのクラスローダーで JAR ファイルからクラスがロードされるときの効率が向上します。アプリケーションまたはアプレットが複数の JAR ファイルにバンドルされている場合は、クラスがロードされるときに、必要な JAR ファイル以外のダウンロードおよびオープンは行われません。このパフォーマンスの最適化は、新しい \f2\-i\fP オプションを指定して \f2jar\fP を実行すると有効になります。このオプションを使うと、指定した JAR メインファイルと、そのメインファイルが依存しているすべての JAR ファイルについて、パッケージ位置情報が生成されます。メインファイルが依存している JAR ファイルは、JAR メインファイルのマニフェストの \f2Class\-Path\fP 属性に指定しておく必要があります。
.LP
.nf
\f3
@@ -220,52 +189,42 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-箴с\f2INDEX.LIST\fP ＜ゃ \f2main.jar\fP \f2META\-INF\fP ｃ水ャ障
+この例では、 \f2INDEX.LIST\fP ファイルが \f2main.jar\fP の \f2META\-INF\fP ディレクトリ内に挿入されます。
.br
.br
-＜ゃ主宴篏睡≪宴若激с潟鴻若若合鴻若障 ゃ潟鴻＜ゃ篏臀宴主号荅括完 \f2JarIndex\fP 篁罕с
+このファイルに格納されている情報を使用して、アプリケーションのクラスローダーは、効率的にクラスをロードします。インデックスファイルに位置情報を格納する方法の詳細は、「JarIndex 仕様」を参照してください。
.br
.br
-ｃ潟若障 \f2dir1\fP ＜ゃх軒罔羣阪阪膓罔羣ュ \f2dir2\fP 遵冴障 (筝≧鴻 \f2jar\fP 潟潟 \f2\-f\fP 激с潟) 罨＜箴腓冴障
-.LP
-.RS 3
-
+ディレクトリをコピーするには、まず \f2dir1\fP 内のファイルを圧縮して \f2stdout\fP に出力し、続いて \f2stdin\fP から抽出して \f2dir2\fP に出力します (\f2\-f\fP オプションはどちらの \f2jar\fP コマンドでも省略)。
.LP
.nf
\f3
.fl
-% (cd dir1; jar c .) | (cd dir2; jar x)
+% (cd dir1; jar c .)| (cd dir2; jar x)
.fl
\fP
.fi
-.RE
.LP
.LP
-\f2jar\fP 篏帥ｃ JAR ＜ゃ JAR ＜ゃс鴻篏潟潟泣潟腆肴箴с障
+\f2jar\fP を使用して JAR ファイルや JAR マニフェストファイルを操作するサンプルコマンドを確認したい場合は、後述の「例」を参照してください。また、「
.na
\f2Java Tutorial\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jar JAR 潟若鴻с
+http://download.oracle.com/javase/tutorial/deployment/jar」の JAR コースも参照してください。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
c
-\f2jarfile\fP ф違≪若ゃ＜ゃ篏 (\f2f\fP 絎翫)罔羣阪т障 (\f2f\fP \f2jarfile\fP ャ翫)\f2inputfiles\fP ф絎＜ゃｃ≪若ゃ菴遵障
+f が指定された場合は \f2jarfile\fP という名前の \f2新しい\fP アーカイブファイルを \f2作成し、\fP f と \f2jarfile\fP が省略された場合は標準出力に情報を出力します。\f2inputfiles\fP で指定されたファイルとディレクトリを、このアーカイブに追加します。
.TP 3
u
-\f2inputfiles\fP ф絎＜ゃｃ菴遵√＜ゃ \f2jarfile\fP 贋違障 (\f2f\fP 絎翫) 箴腓冴障
-.RS 3
-
-.LP
+f が指定されている場合に、既存ファイル \f2jarfile\fP を \f2更新する目的で、\fP \f2inputfiles\fP に指定されたファイルやディレクトリを追加します。次に例を示します。
.nf
\f3
.fl
@@ -273,11 +232,7 @@
.fl
\fP
.fi
-.RE
-筝潟潟＜ゃ \f2foo.class\fP √ JAR ＜ゃ \f2foo.jar\fP 菴遵障罨＜箴腓冴\f2\-u\fP 激с潟с鴻潟贋違с障
-.RS 3
-
-.LP
+上のコマンドは、ファイル \f2foo.class\fP を既存の JAR ファイル \f2foo.jar\fP に追加します。次の例に示すように、\f2\-u\fP オプションは、マニフェストエントリも更新できます。
.nf
\f3
.fl
@@ -285,20 +240,16 @@
.fl
\fP
.fi
-.RE
-\f2foo.jar\fP с鴻с鴻 \f2name:value\fP ≪ф贋違障
+\f2foo.jar\fP マニフェストをマニフェスト内の \f2name:value\fP ペアで更新します。
.TP 3
x
-\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)＜ゃｃ遵冴障\f2inputfiles\fP 絎翫絎＜ゃｃ遵冴障絎違鴻＜ゃｃ遵冴障遵冴＜ゃユ≪若ゃц┃絎с
+f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、ファイルやディレクトリを抽出します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが抽出されます。指定されていなければ、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。
.TP 3
t
-\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)絎鴻茵綵√т荀ц；腓冴障\f2inputfiles\fP 絎翫絎＜ゃｃ筝荀ц；腓冴障絎違鴻＜ゃｃ筝荀ц；腓冴障
+f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、目次を表示します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが一覧表示されます。指定されていなければ、すべてのファイルとディレクトリが一覧表示されます。
.TP 3
i
-絎 \f2jarfile\fP 箴絖 JAR ＜ゃゃゃ潟号宴障箴腓冴障
-.RS 3
-
-.LP
+指定された \f2jarfile\fP と、それに依存する JAR ファイルについて、インデックス情報を生成します。たとえば、
.nf
\f3
.fl
@@ -306,29 +257,25 @@
.fl
\fP
.fi
-.RE
.LP
-筝潟潟\f2foo.jar\fP \f2INDEX.LIST\fP ＜ゃ障 ＜ゃ\f2foo.jar\fP \f2foo.jar\fP \f2Class\-Path\fP 絮с絎鴻 JAR ＜ゃャｃ宴若吾篏臀宴吾莨若障障 ゃ潟鴻箴с
+上のコマンドは、\f2foo.jar\fP 内に \f2INDEX.LIST\fP ファイルを生成します。 このファイルには、\f2foo.jar\fP と、\f2foo.jar\fP の \f2Class\-Path\fP 属性に指定されたすべての JAR ファイルに入っている各パッケージの位置情報が書き込まれています。インデックスの例を参照してください。
.TP 3
f
-篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)ゃ潟壕申 (\f2i\fP)障茵腓 (\f2t\fP) 絲乗院＜ゃ \f2jarfile\fP 絎障\f2f\fP 激с潟＜ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュ JAR ＜ゃ篏睡 (x t 翫)罔羣阪 jar ＜ゃ 篆＜障 (c u 翫)
+次の各処理の対象となるファイル \f2jarfile\fP を指定します。作成 (\f2c\fP)、更新 (\f2u\fP)、抽出 (\f2x\fP)、インデックス追加 (\f2i\fP)、または表示 (\f2t\fP)。\f2f\fP オプションとファイル名 \f2jarfile\fP とがペアになります。 つまり、片方を記述すれば、もう一方も記述する必要があります。Omitting \f2f\fP と \f2jarfile\fP を省略すると、x や t の場合は \f2標準入力\fPから JAR ファイル名が取得され、c や u の場合は \f2標準出力\fP に JAR ファイルが送信されます。
.TP 3
v
-荅括完阪罔羣阪障т腓冴障
+詳細な出力を標準出力に生成します。あとで例を示します。
.TP 3
0
-(若) ZIP х軒篏睡篆絖障
+(ゼロ) ZIP による圧縮を使用せずに、保存します。
.TP 3
M
-с鴻＜ゃ潟篏障 (c u 翫) 障с鴻＜ゃ潟絖翫ゃ障 (u 翫)
+マニフェストファイルエントリを作成しません (c および u の場合)。または、マニフェストファイルエントリが存在する場合にそれを削除します (u の場合)。
.TP 3
m
-\f2META\-INF/MANIFEST.MF\fP ＜ゃф絎с鴻＜ゃ \f2manifest\fP \f2name :value\fP 絮с≪腟粋昭帥障су \f2jar\fP \f2name\ :\ value\fP ≪菴遵障у翫\f2jar\fP ゃ贋違障
+\f2META\-INF/MANIFEST.MF\fP のファイルで指定したマニフェストファイル \f2manifest\fP の \f2name : value\fP の属性ペアを組み込みます。 \f2jar\fP は、すでに同じ名前で存在しないかぎり、その \f2name:value\fP ペアを追加します。同じ名前で存在する場合、 \f2jar\fP はその値を更新します。
.LP
-潟潟茵с\f3m\fP \f3f\fP 絖\f2manifest\fP \f2jarfile\fP ュ綺綺ц菴違綽荀障違罨＜篏帥障
-.RS 3
-
-.LP
+コマンド行で、\f3m\fP と \f3f\fP の文字は、\f2manifest\fP と \f2jarfile\fP の入力順序と同じ順序で記述する必要があります。たとえば、次のようにして使います。
.nf
\f3
.fl
@@ -336,22 +283,17 @@
.fl
\fP
.fi
-.RE
-с鴻障с鴻劫ャ \f2name\ :\ value\fP 絮с≪菴遵с障違潟惹宴若吾с恰宴宴若吾激若潟違障 JAR 潟≪宴若激с潟絎茵絮с菴遵с障\f4\-m\fP 激с潟篏睡箴ゃJava Tutorial
+デフォルトのマニフェストには含まれないマニフェストに、特別な目的の \f2name\ :\ value\fP の属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージシーリング、または JAR にバンドルされたアプリケーションを実行するための属性を追加できます。「Java Tutorial」の「
.na
\f2JAR Files\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jar/潟若鴻с
-.LP
+http://download.oracle.com/javase/tutorial/deployment/jar/」コースを参照し、 \f4\-m\fP オプションの使用例を確認してください。
.TP 3
e
-絎茵 JAR ＜ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟\f2entrypoint\fP 荐絎障激с潟篏睡с鴻＜ゃ \f2Main\-Class\fP 絮уゃ篏障筝吾障 激с潟JAR ＜ゃ篏筝障贋遺賢篏睡с障 激с潟篏帥違с鴻＜ゃ膩障篏≪宴若激с潟潟ゃ潟絎с障
+実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして、\f2entrypoint\fP を設定します。このオプションを使用すると、マニフェストファイル内の \f2Main\-Class\fP 属性値が作成または上書きされます。このオプションは、JAR ファイルの作成中または更新中に使用できます。このオプションを使えば、マニフェストファイルを編集または作成することなしに、アプリケーションのエントリポイントを指定できます。
.br
.br
-違罨＜潟潟 \f2Main.jar\fP 篏障с鴻＜ゃ \f2Main\-Class\fP 絮уゃ \f2Main\fP 荐絎障
-.RS 3
-
-.LP
+たとえば、次のコマンドでは \f2Main.jar\fP が作成されますが、その際、マニフェスト内の \f2Main\-Class\fP 属性値は \f2Main\fP に設定されます。
.nf
\f3
.fl
@@ -359,12 +301,8 @@
.fl
\fP
.fi
-.RE
.LP
-罨＜潟潟絎茵 java 潟帥ゃ贋･≪宴若激с潟莎桁с障
-.RS 3
-
-.LP
+次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。
.nf
\f3
.fl
@@ -372,11 +310,7 @@
.fl
\fP
.fi
-.RE
-潟ゃ潟劫劫宴若後絖翫潟ゃ潟阪絖 (.) 障鴻激 (/) 篏睡с障違\f2Main.class\fP \f2foo\fP 宴若後絖翫罨＜潟ゃ潟絎с障
-.RS 3
-
-.LP
+あるパッケージ内にエントリポイントのクラス名が含まれている場合、ドット (「.」) 、スラッシュ (「/」) のいずれかの文字をその区切り文字として使用できます。たとえば、 \f2Main.class\fP が \f2foo\fP という名前のパッケージに含まれている場合、エントリポイントは次のようにして指定できます。
.nf
\f3
.fl
@@ -384,11 +318,7 @@
.fl
\fP
.fi
-.RE
-障
-.RS 3
-
-.LP
+または
.nf
\f3
.fl
@@ -396,18 +326,14 @@
.fl
\fP
.fi
-.RE
-\f3羈:\ \fP \f2\-m\fP 激с潟 \f2\-e\fP 激с潟筝≧鴻絎翫絎с鴻 \f2Main\-Class\fP 絮с障\f2Main.class\fP 絎障ｃ若榊JAR 篏障贋医医幻腟篋障
+\f3注:\ \fP \f2\-m\fP オプションと \f2\-e\fP オプションの両方を同時に指定した場合、指定したマニフェストにも \f2Main\-Class\fP 属性が含まれていれば、 \f2Main.class\fP の指定があいまいになってエラーや発生し、JAR の作成処理や更新処理が異常終了します。
.LP
.TP 3
\-C \ dir
-\f2jar\fP 潟潟絎茵筝緇膓 \f2inputfiles\fP 綣違筝ｃ紊眼障 (\f2cd\fP\ \f2dir\fP)UNIX \f2tar\fP 若ｃｃ若 \f2\-C\fP 激с潟罘純蕁篌若障
+\f2jar\fP コマンドの実行中に後続の \f2inputfiles\fP 引数を処理するときに、一時的にディレクトリを変更します (cd \f2dir\fP)。この処理は、UNIX の \f2tar\fP ユーティリティーの \f2\-C\fP オプションの機能に類似しています。
.br
.br
-違罨＜潟潟\f2classes\fP ｃ腱糸ｃ \f2bar.class\fP \f2foo.jar\fP 菴遵障
-.RS 3
-
-.LP
+たとえば、次のコマンドは、\f2classes\fP ディレクトリに移動し、そのディレクトリから \f2bar.class\fP を \f2foo.jar\fP に追加します。
.nf
\f3
.fl
@@ -415,23 +341,15 @@
.fl
\fP
.fi
-.RE
-罨＜潟潟с\f2classes\fP ｃ腱糸\f2classes\fP ｃ鴻＜ゃ \f2foo.jar\fP 菴遵障 (jar ＜ゃ classes ｃ篏障) 罨＜ｃ祉ｃ\f2bin\fP ｃ腱糸\f2xyz.class\fP \f2foo.jar\fP 菴遵障
-.RS 3
-
-.LP
+次のコマンドでは、\f2classes\fP ディレクトリに移動し、\f2classes\fP ディレクトリ内のすべてのファイルを \f2foo.jar\fP に追加します (jar ファイルには classes ディレクトリを作成しません)。次に元のディレクトリに戻ってから、\f2bin\fP ディレクトリに移動し、\f2xyz.class\fP を \f2foo.jar\fP に追加します。
.nf
\f3
.fl
-jar uf foo.jar \-C classes . \-C bin xyz.class
+jar uf foo.jar \-C classes .\-C bin xyz.class
.fl
\fP
.fi
-.RE
-\f2classes\fP \f2bar1\fP \f2bar2\fP 篆翫\f2jar tf foo.jar\fP 篏睡JAR ＜ゃ罨＜荀膣障
-.RS 3
-
-.LP
+\f2classes\fP にファイル \f2bar1\fP と \f2bar2\fP が格納されている場合に、 \f2jar tf foo.jar\fP 使用したときの JAR ファイルの中身を、次に示します。
.nf
\f3
.fl
@@ -447,30 +365,24 @@
.fl
\fP
.fi
-.RE
.LP
.TP 3
\-Joption
-Java 絎茵医 \f2option\fP 羝＜障 \f2option\fP Java ≪宴若激с活儀若＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f4\-J\-Xmx48M\fP 絎紊с＜≪若 48M ゃ荐絎障\f2\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 実行環境に \f2option\fP を渡します。 \f2option\fP には、「Java アプリケーション起動ツール」のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、 \f4\-J\-Xmx48M\fP と指定すると、最大メモリーが 48M バイトに設定されます。\f2\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.SH "潟潟茵綣違＜ゃ"
-.LP
-
+.SH "コマンド行引数ファイル"
.LP
-jar 潟潟茵膂≧\f2jar\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝＜ゃ絎с障篁紙激 jar 潟潟篏с若ｃ潟違激鴻潟潟茵狗茹ｆ障障
+jar のコマンド行を短くしたり簡潔にしたりするために、jar コマンドに対する引数 (\-J オプションを除く) を含む 1 つ以上の \f2ファイルを\fP 指定することが \f2できます\fP 。これにより、任意の長さの jar コマンドを作成でき、オペレーティングシステムによるコマンド行の制限から解放されます。
.LP
-綣違＜ゃ激с潟＜ゃс障＜ゃ綣違鴻若鴻障壕у阪障綣違＜ゃ＜ゃ憜ｃ荀後障鴻障 綣違＜ゃ篏臀荀後障鴻с障ゃ若 (*) 絽吾違若ｃ潟違激鴻激сｃ絖茹ｉ障翫茹ｉ障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
+引数ファイルにはオプションとファイル名を含めることができます。ファイル内の各引数は、スペースまたは改行で区切ります。引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。ワイルドカード (*) は、通常ならばオペレーティングシステムシェルによってあらゆる文字に解釈されますが、この場合はそのようには解釈されません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
.LP
.LP
-\f2jar\fP 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障\f2jar\fP \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
+\f2jar\fP を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。 \f2jar\fP は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
.br
.br
-罨＜箴с\f2find\fP 潟潟阪＜ゃ \f2classes.list\fP 主障
-.LP
-.RS 3
-
+次の例で、 \f2classes.list\fP には、 \f2find\fP コマンドによって出力されたファイルの名前が格納されます。
.LP
.nf
\f3
@@ -478,14 +390,10 @@
% find \fP\f3.\fP \-name '*.class' \-print > classes.list
.fl
.fi
-.RE
.LP
.LP
-緇綣違＜ゃ罕篏帥ｃ \f2jar\fP 鴻羝＜\f2Classes.list\fP \f2jar\fP 潟潟絎茵с障
-.LP
-.RS 3
-
+次に、引数ファイル構文を使用して \f2classes.list\fP を jar に渡すことで、 \f2そのリスト\fP に対して \f2jar\fP コマンドを実行できます。
.LP
.nf
\f3
@@ -494,13 +402,9 @@
.fl
\fP
.fi
-.RE
.LP
-綣違＜ゃ鴻絎с障後障鴻荐菴違綣違＜ゃ鴻＜ゃ羝＜鴻絲障後丞с憜篏罐ｃ後丞障 罨＜箴腓冴障
-.RS 3
-
-.LP
+引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、現在の作業ディレクトリに相対的となります。次はその例です。
.nf
\f3
.fl
@@ -508,20 +412,14 @@
.fl
\fP
.fi
-.RE
.LP
.LP
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
-劫ｃ鴻＜ゃ≪若ゃ菴遵 (≪若ゃс絖翫絎鴻筝吾) 罨＜障\f2\-v\fP 激с潟篏睡宴荅括完絎泣ゃ冴違贋井ャ≪若ゃ＜ゃゃ荅括完宴茵腓冴障
-.RS 3
-
-.LP
+特定のディレクトリ内のすべてのファイルをアーカイブに追加する (そのアーカイブがすでに存在する場合は、その内容を上書きする) には、次のようにします。\f2\-v\fP オプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。
.nf
\f3
.fl
@@ -557,13 +455,9 @@
.fl
\fP
.fi
-.RE
.LP
-с糸若ｃ＜ゃ潟合泣ｃ翫筝 JAR ＜ゃ腟с障
-.RS 3
-
-.LP
+すでに画像、オーディオファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一の JAR ファイルに結合できます。
.nf
\f3
.fl
@@ -607,13 +501,9 @@
.fl
\fP
.fi
-.RE
.LP
-JAR ＜ゃ潟茵腓冴\f2t\fP激с潟篏睡障
-.RS 3
-
-.LP
+JAR ファイルのエントリ名を表示するには、「\f2t\fP」オプションを使用します。
.nf
\f3
.fl
@@ -641,28 +531,24 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-鴻若蕭ゃ潟鴻＜ゃ JAR ＜ゃ菴遵\f2i\fP激с潟篏睡障
+クラスロードを高速にするためにインデックスファイルを JAR ファイルに追加するには、「\f2i\fP」オプションを使用します。
.br
.br
-箴:
+例:
.br
.LP
-.RS 3
-
-.LP
-違綣≪宴若激с括娯箴絖鴻\f2main.jar\fP\f2buy.jar\fP \f2sell.jar\fP 3 ゃ JAR ＜ゃ蚊障
+たとえば、株取引アプリケーションの内部依存しているクラスを、\f2main.jar\fP、\f2buy.jar\fP、および \f2sell.jar\fP という 3 つの JAR ファイルに分割したとします。
.br
.LP
.br
.LP
-\f2main.jar\fP с鴻 \f2Class\-path\fP 絮с罨＜絎翫
+\f2main.jar\fP のマニフェストの \f2Class\-path\fP 属性に次のように指定した場合、
.nf
\f3
.fl
@@ -672,7 +558,7 @@
.fi
.LP
-\f2\-i\fP 激с潟篏睡違≪宴若激с潟鴻 茯粋昭帥蕭с障
+\f2\-i\fP オプションを使用すれば、アプリケーションのクラスの 読み込みを高速化できます。
.nf
\f3
.fl
@@ -682,38 +568,34 @@
.fi
.LP
-\f2INDEX.LIST\fP ＜ゃ \f2META\-INF\fP ｃ水ャ障腟≪宴若激с潟鴻若若ｃ鴻障 純若鴻罎膣≪茵 jar ＜ゃ潟若障
-.RE
-.SH "∫ｉ"
+\f2INDEX.LIST\fP ファイルが \f2META\-INF\fP ディレクトリに挿入されます。この結果、アプリケーションのクラスローダーによってクラスまたはリソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。
+.SH "関連項目"
.LP
-
.LP
.na
-\f2JAR ＜ゃ网荀\fP @
+\f2JAR ファイルの概要\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
-.br
-
+.LP
.LP
.na
-\f2JAR ＜ゃ篁罕\fP @
+\f2JAR ファイルの仕様\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
-.br
-
+.LP
+.LP
+.na
+\f2JarIndex の仕様\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index
+.LP
.LP
.na
-\f2Jar ゃ潟鴻\fP @
+\f2JAR チュートリアル\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex
-.br
-
+http://download.oracle.com/javase/tutorial/deployment/jar/index.html
.LP
-.na
-\f2Jar ャ若≪\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/jar (Java Software Web 泣ゃ)
-.br
-
.LP
-pack200(1)
+pack200(1)
+.LP
+
--- a/jdk/src/linux/doc/man/ja/jarsigner.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jarsigner.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1998, 2011, 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
@@ -19,117 +19,1010 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jarsigner 1 "02 Jun 2010"
+.TH jarsigner 1 "14 Apr 2011"
.LP
-.SH ""
-jarsigner \- JAR 臀峨恰荐若若
-.LP
-.RS 3
-
+.SH "名前"
+jarsigner \- JAR 署名および検証ツール
.LP
.LP
-Java ARchive (JAR) ＜ゃ臀峨臀峨篁 JAR ＜ゃ臀峨罎荐若障
+Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
\fP\f3jarsigner\fP [ options ] jar\-file alias
.fl
-\f3jarsigner\fP \-verify [ options ] jar\-file
+\f3jarsigner\fP \-verify [ options ] jar\-file [alias...]
.fl
.fi
.LP
-.SH "茯"
.LP
-
+jarsigner の \-verify コマンドでは、JAR ファイル名のあとに 0 個以上のキーストア別名を指定できます。キーストア別名が指定された場合、jarsigner は、JAR ファイル内の各署名付きエンティティーの検証に使用される証明書がキーストア別名のいずれかに一致することをチェックします。別名は、\-keystore で指定されたキーストア内またはデフォルトのキーストア内に定義されます。
+.LP
+.SH "説明"
.LP
.LP
-\f3jarsigner\fP 若罨＜ 2 ゃт戎障
+\f3jarsigner\fP ツールは、次の 2 つの目的で使用します。
.LP
.RS 3
.TP 3
1.
-Java ARchive (JAR) ＜ゃ臀峨篁
+Java ARchive (JAR) ファイルに署名を付ける
.TP 3
2.
-臀峨篁 JAR ＜ゃ臀峨翫с罎荐若
+署名付き JAR ファイルの署名と整合性を検証する
+.RE
+
+.LP
+.LP
+JAR 機能を使うと、クラスファイル、イメージ、サウンド、およびその他のデジタルデータを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。開発者は、jar(1) という名前のツールを使って JAR ファイルを作成できます。技術的な観点から言えば、すべての ZIP ファイルも JAR ファイルとみなすことができます。 ただし、\f3jar\fP によって作成された JAR ファイル、または \f3jarsigner\fP によって処理された JAR ファイルには、META\-INF/MANIFEST.MF ファイルが含まれています。
+.LP
+.LP
+「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティー (人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。
+.LP
+.RS 3
+.TP 2
+o
+署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、デジタル署名が本物かどうかを検証できる
+.TP 2
+o
+非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である
+.TP 2
+o
+デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの署名として機能することはない
+.TP 2
+o
+署名付きのデータは変更できない。 データが変更された場合は、その署名によってデータが本物ではないことが検証される
.RE
.LP
.LP
-JAR 罘純篏帥鴻＜ゃゃ＜若吾泣潟潟篁吾帥若帥筝＜ゃ宴若後сс＜ゃ菴ゅ号絽с障肴jar(1) 若篏帥ｃ JAR ＜ゃ篏с障茵荀括鴻荐違鴻 ZIP ＜ゃ JAR ＜ゃ帥с障 \f3jar\fP ｃ篏 JAR ＜ゃ障 \f3jarsigner\fP ｃ JAR ＜ゃMETA\-INF/MANIFEST.MF ＜ゃ障障
+ファイルに対してエンティティーの署名を生成するには、まず、エンティティーは、そのエンティティーに関連する公開鍵と非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つまたは複数の証明書も必要です。「証明書」とは、あるエンティティーが発行したデジタル署名付きの文書で、別なエンティティーの公開鍵が特定の値であることを証明しています。
+.LP
+.LP
+\f3jarsigner\fP は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1) ユーティリティーを使います。
+.LP
+.LP
+\f3jarsigner\fP は、エンティティーの非公開鍵を使って署名を生成します。署名付き JAR ファイルには特に、ファイルの署名に使用された非公開鍵に対応する公開鍵に対する、キーストア内の証明書のコピーが含まれています。\f3jarsigner\fP は、署名付き JAR ファイル内 (署名ブロックファイル内) にある証明書を使用してそのファイルのデジタル署名を検証できます。
+.LP
+.LP
+\f3jarsigner\fP はタイムスタンプを含む署名を生成するので、システムやデプロイヤ (Java Plug\-in を含む) はJAR ファイルが署名証明書の有効期間中に署名されたかどうかをチェックできます。さらに、API を使用すると、アプリケーションからタイムスタンプ情報を取得できます。
+.LP
+.LP
+現時点では、\f3jarsigner\fP で署名できるのは、JDK の jar(1) ツールで作成された JAR ファイル、または ZIP ファイルだけです。JAR ファイルは ZIP ファイルと同じですが、JAR ファイルには META\-INF/MANIFEST.MF ファイルが含まれている点が異なります。META\-INF/MANIFEST.MF ファイルは、\f3jarsigner\fP が ZIP ファイルに署名を付けるときに自動的に作成されます。
+.LP
+.LP
+デフォルトでは、\f3jarsigner\fP は JAR (または ZIP) ファイルに「署名」を付けます。署名付き JAR ファイルを「検証」する場合は、 \f2\-verify\fP オプションを指定します。
+.LP
+.SS
+キーストアの別名
+.LP
+.LP
+キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。
+.LP
+.LP
+\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、working ディレクトリの mystore という名前のキーストアに含まれる別名 duke に関連付けられた非公開鍵を使って、MyJARFile.jar という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jar は署名付きの JAR ファイルによって上書きされます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-storepass myspass
+.fl
+ \-keypass dukekeypasswd MyJARFile.jar duke
+.fl
+\fP
+.fi
+
+.LP
+.LP
+キーストアはパスワードで保護されているので、ストアのパスワード (上の例では mypass) を指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワード (上の例では dukekeypasswd) を指定する必要があります。 コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。
+.LP
+.SS
+キーストアの場所
+.LP
+.LP
+\f3jarsigner\fP には、 \f2使用するキーストアの URL を指定する \-keystore\fP があります。キーストア \f2は\fP デフォルトで、 \f2user.home\fP システムプロパティーで決まるユーザーのホームディレクトリの .keystore という名前のファイル内に格納されます。Solaris システムの場合、 \f2user.home\fP のデフォルトはユーザーの home ディレクトリになります。
+.LP
+.LP
+\-keystore オプション \f2に指定した\fP 入力ストリームが \f2KeyStore.load\fP メソッドに渡される点に注意してください。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではない場合、たとえばそれがハードウェアトークンデバイス上に存在している場合などに指定すべきです。
+.LP
+.SS
+キーストアの実装
+.LP
+.LP
+java.security パッケージ \f2で提供されている\fP KeyStore クラス \f2は、\fP キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
+.LP
+.LP
+現在、キーストアの実装を使用するものとして、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールがあります。KeyStore \f2は\fP public として使用可能なので、Java 2 SDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。
+.LP
+.LP
+キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。
.LP
.LP
-吾帥臀峨若 (臀峨絲乗院若) 潟ｃｃ (篋冴篌腓障) 泣冴ャ荐膊с吾臀峨罕吾帥臀峨紊鴻障
+キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP によって提供されるアプリケーションインタフェースが「サービスプロバイダインタフェース」 (SPI) に基づいて実装されます。つまり、対応する抽象クラス \f2KeystoreSpi\fP が同じ \f2java.security\fP パッケージ内に存在しており、このクラスによって、「プロバイダ」が実装する必要のあるサービスプロバイダインタフェースメソッドが定義されています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、
+.na
+\f2「Java 暗号化アーキテクチャー用プロバイダの実装方法」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
+.LP
+.LP
+アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの \f2実装を\fP 選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。
+.LP
+.LP
+\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
+.LP
+.LP
+\f3jarsigner\fP と \f3keytool\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアのタイプを指定できます。
+.LP
+.LP
+ユーザーがキーストアのタイプを明示的に指定しなかった場合、ツールは、単純にセキュリティープロパティーファイルで指定された \f2keystore.type\fP プロパティーの値に基づいて、キーストアの実装を選択します。このセキュリティープロパティーファイルは \f2java.security\fP と呼ばれ、SDK セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security 内に存在しています。ここで、\f2java.home\fP は実行時環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment のトップレベルディレクトリ) です。
+.LP
+.LP
+各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
+.LP
+.LP
+\f2KeyStore\fP クラスに定義されている static メソッド \f2getDefaultType\fP を使用すると、アプリケーションやアプレットから \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ \f2(keystore.type プロパティーで指定されたタイプ)\fP のインスタンスを生成します。
+.LP
+.nf
+\f3
+.fl
+ KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
+.fl
+\fP
+.fi
+
+.LP
+.LP
+デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。
+.LP
+.nf
+\f3
+.fl
+ keystore.type=jks
+.fl
+\fP
+.fi
+
+.LP
+.LP
+注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
+.LP
+.LP
+各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
+.LP
+.nf
+\f3
+.fl
+ keystore.type=pkcs12
+.fl
+\fP
+.fi
+
+.LP
+.LP
+PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」にある
+.na
+\f2「KeyTool and JarSigner」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner節を参照してください。
+.LP
+.SS
+サポートされるアルゴリズム
+.LP
+.LP
+\f3jarsigner\fP はデフォルトで、次のいずれかを使用して JAR ファイルに署名します。
.LP
.RS 3
.TP 2
o
-臀峨篏帥泣絲障泣篏帥ｃ荐膊茵с吾帥臀峨罎荐若с
+SHA1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム)
+.TP 2
+o
+SHA256 ダイジェストアルゴリズムを使用した RSA アルゴリズム
+.TP 2
+o
+SHA256 と ECDSA (楕円曲線デジタル署名アルゴリズム) を使用した EC (楕円曲線) 暗号方式アルゴリズム
+.RE
+
+.LP
+.LP
+具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、\f3jarsigner\fP は SHA1withDSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が RSA 鍵である場合、\f3jarsigner\fP は SHA256withRSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が EC 鍵である場合、\f3jarsigner\fP は SHA256withECDSA アルゴリズムを使って JAR ファイルに署名を付けます。
+.LP
+.LP
+これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。
+.LP
+.SS
+署名付き JAR ファイル
+.LP
+.LP
+\f3jarsigner\fP を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが META\-INF ディレクトリに置かれる点が異なります。
+.LP
+.RS 3
+.TP 2
+o
+.SF 拡張子の付いた署名ファイル
+.TP 2
+o
+.DSA、.RSA、または .EC を拡張子に持つ署名ブロックファイル
+.RE
+
+.LP
+.LP
+これら 2 つのファイルのベースファイル名は、 \f2\-sigFile\fP オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。
+.LP
+.nf
+\f3
+.fl
+\-sigFile MKSIGN
+.fl
+\fP
+.fi
+
+.LP
+.LP
+この場合、ファイル名はそれぞれ MKSIGN.SF と MKSIGN.DSA になります。
+.LP
+.LP
+コマンド行で \f2\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。
+.LP
+\f3署名 (.SF) ファイル\fP
+.LP
+.LP
+署名ファイル (.SF ファイル) は、\f3jarsigner\fP で署名を付けた JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、.SF ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。
+.LP
+.RS 3
+.TP 2
+o
+ファイル名
.TP 2
o
-泣篁篋冴ャ吾帥臀峨初筝純с
+使われているダイジェストアルゴリズム (SHA) の名前
+.TP 2
+o
+SHA ダイジェストの値
+.RE
+
+.LP
+.LP
+マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータのダイジェスト (ハッシュ) です。一方、.SF ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当するソースファイルに対応する 3 行のハッシュです。
+.LP
+.LP
+署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。後述の「JAR ファイルの検証」で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。
+.LP
+\f3署名ブロックファイル\fP
+.LP
+.SF ファイルには署名が付けられ、署名は署名ブロックファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。 証明書または証明書チェーンは、署名に使われた非公開鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェストアルゴリズムに応じて .DSA、.RSA、.EC のいずれかになります。
+.SS
+署名タイムスタンプ
+.LP
+.LP
+\f2jarsigner\fP ツールは、JAR ファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、 \f2jarsigner\fP は代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。
+.LP
+.RS 3
+.TP 2
+o
+\f2\-tsa url\fP
+.TP 2
+o
+\f2\-tsacert alias\fP
.TP 2
o
-吾帥臀峨臀峨篁若帥絲乗院с祉若帥臀峨罘純
+\f2\-altsigner class\fP
.TP 2
o
-臀峨篁若帥紊眼с 若帥紊眼翫臀峨ｃ若帥с罎荐若
+\f2\-altsignerpath classpathlist\fP
+.RE
+
+.LP
+.LP
+これらの各オプションの詳細については、後述の「オプション」節を参照してください。
+.LP
+.SS
+JAR ファイルの検証
+.LP
+.LP
+JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。
+.LP
+.RS 3
+.TP 3
+1.
+.SF ファイルそれ自体の署名を検証します。
+.LP
+この手順では、各署名ブロック (.DSA) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って生成されたものであることを確認します。 .DSA ファイルには、公開鍵の証明書 (または証明書チェーン) も含まれています。また、この手順では、目的の署名が、対応する署名 (.SF) ファイル内の有効な署名であるかどうかを調べ、.SF ファイルが改変されていないことも確認します。
+.TP 3
+2.
+.SF ファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突き合わせて検証します。
+.LP
+.SF ファイルには、マニフェストファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。このヘッダーが存在する場合は、ヘッダー内のハッシュが実際にマニフェストファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致する場合は、次の手順に進みます。
+.LP
+ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。具体的には、.SF ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するかどうかを確認します (「署名 (.SF) ファイル」を参照)。
+.LP
+.SF ファイルのヘッダーに格納されたマニフェストファイルのハッシュと、実際のマニフェストファイルのハッシュとが一致しない場合は、署名 (および .SF ファイル) の生成後に、JAR ファイルに 1 つ以上のファイルが追加 \f2(jar ツールを使用)\fP された可能性があります。jar \f2ツール\fP を使ってファイルを追加した場合、マニフェストファイルは変更されますが (新しいファイル用のセクションが追加される)、.SF ファイルは変更されません。この場合、.SF ファイルのヘッダー以外のセクションに格納されたハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するときは、署名の生成時に JAR ファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。
+.TP 3
+3.
+JAR ファイル内のファイルのうち、.SF ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルのダイジェストを計算し、結果をマニフェストセクション内の該当するファイルのダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない場合は検証が失敗します。
.RE
.LP
.LP
-＜ゃ絲障潟ｃｃ若臀峨障潟ｃｃ若潟ｃｃ若∫ｃ泣泣≪ゅ荀障 障泣茯荐若 1 ゃ障茲違荐惹吾綽荀с荐惹吾潟ｃｃ若肴吾帥臀峨篁吾сャ潟ｃｃ若泣劫ゃс荐惹障
-.LP
+検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティー例外がスローされます。スローされたセキュリティー例外は、\f3jarsigner\fP がキャッチして表示します。
.LP
-\f3jarsigner\fP 若鴻≪障泣荐惹御宴篏帥ｃJAR ＜ゃ吾帥臀峨障若鴻≪泣泣∫ｄ X.509 荐惹吾с若潟若帥若鴻с若鴻≪篏膊∞keytool(1) 若ｃｃ若篏帥障
-.LP
-.LP
-\f3jarsigner\fP 潟ｃｃ若泣篏帥ｃ臀峨障臀峨篁 JAR ＜ゃ＜ゃ臀峨篏睡泣絲上泣篆絖若鴻≪ｃ荐惹吾潟若障障 \f3jarsigner\fP 臀峨篁 JAR ＜ゃ吾帥臀峨＜ゃ (臀峨＜ゃ) 障荐惹吾篏帥ｃ罎荐若с障
+.SS
+1 つの JAR ファイルを対象とする複数の署名
.LP
.LP
-5.0 篁ラс\f3jarsigner\fP 帥ゃ鴻帥潟臀峨с激鴻ゃ (Java Plug\-in ) JAR ＜ゃ臀峨荐惹吾号筝臀峨сс障5.0 ц申 API 篏睡≪宴若激с潟帥ゃ鴻帥潟宴緇с障
-.LP
-.LP
-憝鴻с\f3jarsigner\fP х讐сJDK jar(1) 若т JAR ＜ゃ障 ZIP ＜ゃсJAR ＜ゃ ZIP ＜ゃсJAR ＜ゃ META\-INF/MANIFEST.MF ＜ゃ障鴻違障META\-INF/MANIFEST.MF ＜ゃ\f3jarsigner\fP ZIP ＜ゃ臀峨篁篏障
-.LP
+1 つの JAR ファイルに対して \f3jarsigner\fP ツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JAR ファイルに複数のユーザーの署名を付けることができます。
.LP
-с\f3jarsigner\fP JAR (障 ZIP) ＜ゃ臀峨篁障臀峨篁 JAR ＜ゃ罎荐若翫\f2\-verify\fP 激с潟絎障
-.LP
-.SS
-JDK 1.1 篋
-.LP
-.RS 3
+.nf
+\f3
+.fl
+ jarsigner myBundle.jar susan
+.fl
+ jarsigner myBundle.jar kevin
+.fl
+\fP
+.fi
.LP
.LP
-\f3keytool\fP 若 \f3jarsigner\fP 若JDK 1.1 ф箴 \f3javakey\fP 若絎臀с違若 \f3javakey\fP 紊罘純若鴻≪泣鴻若т茘激罘純臀峨臀峨罎荐若罘純ｃ障
+JAR ファイルが複数回署名されている場合、その JAR ファイルには .SF ファイルと .DSA ファイルの対が複数含まれることになります。 .SF ファイルと .DSA ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力される JAR ファイルには、次の名前を持つファイルが含まれます。
+.LP
+.nf
+\f3
+.fl
+ SUSAN.SF
+.fl
+ SUSAN.DSA
+.fl
+ KEVIN.SF
+.fl
+ KEVIN.DSA
+.fl
+\fP
+.fi
+
.LP
.LP
-違若鴻≪≪若ｃ若\f3javakey\fP 篏膊∞≪ゃ潟ｃｃ若若帥若鴻篁ｃс若鴻√就綣JDK 1.1 \f3javakey\fP 篏帥ｃ若帥若劫就綣筝篏篋с障罨＜純с
+注: JAR ファイルでは、JDK 1.1 の \f3javakey\fP ツールで生成された署名と \f3jarsigner\fP で生成された署名が混在できます。つまり、すでに \f3javakey\fP を使って署名が付けられている JAR ファイルに、\f3jarsigner\fP を使って署名を付けることができます。
+.LP
+.SH "オプション"
+.LP
+.LP
+以下では、\f3jarsigner\fP のオプションについて説明します。注:
.LP
.RS 3
.TP 2
o
-\f3keytool\fP \f2\-identitydb\fP 潟潟篏帥≪ゃ潟ｃｃ若若帥若鴻宴若鴻≪ゃ潟若с障
+どのオプション名にも先頭にマイナス記号 (\-) が付く
+.TP 2
+o
+オプションは任意の順序で指定できる
+.TP 2
+o
+イタリック体の項目の実際の値 (オプションの値) は、ユーザーが指定する必要がある
+.TP 2
+o
+\f2\-keystore\fP、 \f2\-storepass\fP、 \f2\-keypass\fP、 \f2\-sigfile\fP、 \f2\-sigalg\fP、 \f2\-digestalg\fP、および \f2\-signedjar\fP オプションを使用できるのは、署名付き JAR ファイルを検証する場合ではなく、JAR ファイルに署名する場合だけです。同様に、別名をコマンド行で指定するのは、JAR ファイルに署名を付ける場合だけである
+.RE
+
+.LP
+.RS 3
+.TP 3
+\-keystore url
+キーストアの場所を示す URL を指定します。デフォルトは、ユーザーのホームディレクトリ内のファイル \f2.keystore\fP です。 ユーザーのホームディレクトリは、user.home システムプロパティーによって決まります。
+.LP
+署名するときはキーストアが必要です。 このため、デフォルトのキーストアが存在しない場合、あるいはデフォルト以外のほかのキーストアを使用する場合は、キーストアを明示的に指定する必要があります。
+.LP
+検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに \f2\-verbose\fP オプションも指定されていた場合、JAR ファイルの検証に使用される証明書がそのキーストアに 1 つでも含まれているかどうかに関する追加情報が出力されます。
+.LP
+注: \f2\-keystore\fP の引数には、URL の代わりにファイル名 (とパス) を指定できます。 ファイル名 (とパス) を指定した場合は、「file:」URL として扱われます。たとえば、次のように指定できます。
+.nf
+\f3
+.fl
+ \-keystore \fP\f4filePathAndName\fP\f3
+.fl
+\fP
+.fi
+.LP
+これは、次の指定と同じものとして扱われます。
+.nf
+\f3
+.fl
+ \-keystore file:\fP\f4filePathAndName\fP\f3
+.fl
+\fP
+.fi
+.LP
+JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。
+.RS 3
+.TP 2
+o
+\f2\-keystore NONE\fP
+.TP 2
+o
+\f2\-storetype PKCS11\fP
+.RE
+.LP
+たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。
+.nf
+\f3
+.fl
+ jarsigner \-keystore NONE \-storetype PKCS11 \-list
+.fl
+
+.fl
+\fP
+.fi
+.TP 3
+\-storetype storetype
+インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストアタイプは、セキュリティープロパティーファイル内の keystore.type プロパティーの値で指定されたタイプです。この値は、 \f2java.security.KeyStore\fP の static getDefaultType メソッド \f2で取得できます。\fP.
+.LP
+\-storepass オプションを使って PCKS#11 トークンの PIN を \f2指定することも\fP できます。何も指定しなかった場合、keytool と jarsigner はユーザーにトークン PIN の 入力を求めます。トークンに保護された認証パス (専用の PIN パッドや生体読み取り機など) がある場合、\f2\-protected\fP オプションを指定する必要がありますが、パスワードオプションを指定する必要はありません。
+.TP 3
+\-storepass[:env | :file] argument
+.LP
+キーストアにアクセスするのに必要なパスワードを指定します。このオプションが必要なのは、JAR ファイルに署名を付けるときだけです (JAR ファイルを検証するときは不要)。その場合、 \f2\-storepass\fP オプションをコマンド行で指定しなかった場合は、新しいパスワードの入力を求められます。
+.LP
+修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。
+.RS 3
+.TP 2
+o
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
+.TP 2
+o
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
+.TP 3
+\-keypass[:env | :file] argument
+.LP
+コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するのに使うパスワードを指定します。\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。
+.LP
+修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。
+.RS 3
+.TP 2
+o
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
+.TP 2
+o
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
+.TP 3
+\-sigfile file
+.SF ファイルと .DSA ファイルの生成に使うベースファイル名を指定します。たとえば、\f2file\fP に DUKESIGN を指定すると、生成される .SF ファイルと .DSA ファイルの名前は、それぞれ DUKESIGN.SF と DUKESIGN.DSA になります。 これらのファイルは、署名付き JAR ファイルの META\-INF ディレクトリに置かれます。
+.LP
+\f2file\fP に使用できる文字は「a\-zA\-Z0\-9_\-」です。つまり、文字、数字、下線、およびハイフンだけを使用できます。注: .SF および .DSA のファイル名では、小文字はすべて大文字に変換されます。
+.LP
+\-sigfile \f2オプション\fP を指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
+.TP 3
+\-sigalg algorithm
+JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。
+.LP
+標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」にある
+.na
+\f2「Appendix A 」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、SHA256withRSA、SHA256withECDSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
+.TP 3
+\-digestalg algorithm
+JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。
+.LP
+標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」にある
+.na
+\f2「Appendix A 」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
+.TP 3
+\-signedjar file
+署名付き JAR ファイルの名前を指定します。
+.LP
+コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる JAR ファイル) の名前と同じ名前が使われます。 この場合、入力 JAR ファイルは署名付き JAR ファイルによって上書きされます。
+.TP 3
+\-verify
+コマンド行でこのオプションが指定されている場合は、指定された JAR ファイルが検証されます。 JAR ファイルへの署名は行われません。検証が成功すると、「jar verified」 というメッセージが表示されます。署名されていない JAR ファイル、またはサポートされていないアルゴリズム (RSA プロバイダのインストールを終了していない場合の RSA など) を使って署名された JAR ファイルを検証しようとすると、「jar is unsigned. (signatures missing or not parsable)」というメッセージが表示されます。
+.LP
+署名付き JAR ファイルは、\f3jarsigner\fP または JDK 1.1 の \f3javakey\fP ツール、あるいはその両方を使って検証できます。
+.LP
+検証についての詳細は、「JAR ファイルの検証」を参照してください。
+.TP 3
+\-certs
+コマンド行で、 \f2\-verify\fP および \f2\-verbose\fP オプションとともにこのオプションを指定した場合、JAR ファイルの各署名者の証明書情報が出力に含まれます。証明書情報には次のものが含まれます。
+.RS 3
+.TP 2
+o
+署名者の公開鍵を証明する (.DSA ファイルに格納された) 証明書の種類の名前
+.TP 2
+o
+証明書が X. 証明書 (つまり、 \f2java.security.cert.X509Certificate\fP のインスタンス) である場合は、署名者の識別名
+.RE
+.LP
+キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストアファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。
+.RS 3
.TP 2
o
-\f3jarsigner\fP 篁ュ \f3javakey\fP 篏帥ｃ臀峨 JAR ＜ゃ臀峨篁с障
+署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。 ただし、キーストアではなく JDK 1.1 のアイデンティティーデータベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。
+.RE
+.TP 3
+\-certchain file
+コマンド行で指定した別名で決まるキーストアエントリの非公開鍵に関連付けられた証明書チェーンが完全でない場合に、使用すべき証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェアトークン上に格納されているが、そこには証明書チェーンの全体を保持できるだけの領域が存在していないような場合です。このファイルは一連の X.509 証明書が順に連結されたもの、PKCS#7 形式の単一データブロックのいずれかとなり、そのエンコーディング形式はバイナリエンコーディング形式、Internet RFC 1421 標準で規定される印刷可能エンコーディング形式 (BASE64 エンコーディングとも呼ばれる) のいずれかになります。
+.TP 3
+\-verbose
+コマンド行でこのオプションが指定されている場合、\f3jarsigner\fP は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出力します。
+.TP 3
+\-internalsf
+以前は、JAR ファイルの署名時に生成された .DSA (署名ブロック) ファイルの中に、生成された .SF ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この動作は変更されました。この動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、デフォルトでは .SF ファイルが .DSA ファイルに含まれないようになっています。ただし、 \f2\-internalsf\fP オプションをコマンド行で指定すると、以前と同じように動作します。\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP
+.TP 3
+\-sectionsonly
+コマンド行でこのオプションが指定されている場合、JAR ファイルの署名時に生成される .SF ファイル (署名ファイル) には、マニフェストファイル全体のハッシュを含むヘッダーは追加されません。この場合、.SF ファイルに含まれるのは、JAR ファイル内の各ソースファイルに関する情報およびハッシュだけです。詳細は、「署名 (.SF) ファイル」を参照してください。
+.LP
+デフォルトでは、最適化を行うために、マニフェストファイル全体のハッシュを含むヘッダーが追加されます。ヘッダーが存在する場合は、JAR ファイルの検証時に、まずヘッダー内のハッシュが、マニフェストファイル全体のハッシュと実際に一致するかどうかが確認されます。ハッシュが一致する場合、検証は次の手順に進みます。ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。 具体的には、.SF ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するかどうかを確認します。
+.LP
+詳細は、「JAR ファイルの検証」を参照してください。
+.LP
+\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP
+.TP 3
+\-protected
+\f2true\fP または \f2false\fP。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値を \f2true\fP に指定してください。
+.TP 3
+\-providerClass provider\-class\-name
+サービスプロバイダがセキュリティープロパティーファイル (\f2java.security\fP) のリストに入っていないときに、暗号化サービスプロバイダのマスタークラスファイルの名前を指定します。
+.LP
+\f2\-providerArg\fP \f2ConfigFilePath\fP オプションと組み合わせて使用します。keytool と jarsigner はプロバイダを動的にインストールします (ここで、\f2ConfigFilePath\fP はトークン設定ファイルへのパスです)。セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されていない場合に PKCS#11 キーストアを一覧表示するコマンドの例を次に示します。
+.nf
+\f3
+.fl
+jarsigner \-keystore NONE \-storetype PKCS11 \\
+.fl
+ \-providerClass sun.security.pkcs11.SunPKCS11 \\
+.fl
+ \-providerArg /foo/bar/token.config \\
+.fl
+ \-list
+.fl
+\fP
+.fi
+.TP 3
+\-providerName providerName
+\f2java.security\fP セキュリティープロパティーファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前です。
+.LP
+Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP という形式になります。 ここで「\f2TokenName\fP」は、プロバイダインスタンスが構成された名前の接尾辞です。 詳細は
+.na
+\f2構成属性の表\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSを参照してください。たとえば、以下のコマンドでは、名前接尾辞 \f2SmartCard\fP の PKCS#11 キーストアプロバイダインスタンスの内容をリストします。
+.nf
+\f3
+.fl
+jarsigner \-keystore NONE \-storetype PKCS11 \\
+.fl
+ \-providerName SunPKCS11\-SmartCard \\
+.fl
+ \-list
+.fl
+\fP
+.fi
+.TP 3
+\-Jjavaoption
+指定された \f2javaoption\fP 文字列を Java インタプリタに直接渡します。\f3jarsigner\fP は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。使用可能なインタプリタオプションの一覧を表示するには、 \f2java \-h\fP または \f2java \-X\fP とコマンド行から入力します。
+.LP
+.TP 3
+\-tsa url
+\f2「\-tsa http://example.tsa.url」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。URL \f2http://example.tsa.url\fP は、TSA (Time Stamping Authority) の場所を特定します。これは、 \f2\-tsacert\fP オプションで検出された URL をオーバーライドします。 \f2\-tsa\fP オプションでは、TSA の公開鍵証明書をキーストアに配置する必要はありません。
+.LP
+タイムスタンプを生成するために、 \f2jarsigner\fP は、
+.na
+\f2RFC 3161\fP @
+.fi
+http://www.ietf.org/rfc/rfc3161.txt で定義されている タイムスタンププロトコル (TSP) を使用して TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンは署名ブロックファイルの署名とともに保存されます。
+.LP
+.TP 3
+\-tsacert alias
+\f2「\-tsacert alias」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。 \f2alias\fP は、キーストア内の現在有効な TSA の公開鍵証明書を特定します。エントリの証明書で、TSA の場所を特定する URL を含む Subject Information Access 拡張機能が確認されます。
+.LP
+TSA の公開鍵証明書は、 \f2\-tsacert を使った場合、キーストアに配置されている必要があります。\fP.
+.LP
+.TP 3
+\-altsigner class
+代替署名機構を使用することを指定します。完全修飾クラス名は、com.sun.jarsigner.ContentSigner 抽象クラスを拡張するクラスファイルを \f2特定します。\fP. このクラスファイルへのパスは、 \f2\-altsignerpath\fP オプションによって定義されます。 \f2\-altsigner\fP オプションが使用されると、 \f2jarsigner\fP は、指定されたクラスが提供する署名機構を使用します。そうでない場合、 \f2jarsigner\fP はデフォルトの署名機構を使用します。
+.LP
+たとえば、 \f2com.sun.sun.jarsigner.AuthSigner\fP という名前のクラスが提供する署名機構を使用するには、 \f2jarsigner\fP オプション \f2「\-altsigner com.sun.jarsigner.AuthSigner」を使用します。\fP
+.LP
+.TP 3
+\-altsignerpath classpathlist
+クラスファイル (そのクラスファイル名は前述の \f2\-altsigner\fP オプションで指定される) およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。クラスファイルが JAR ファイル内にある場合、以下の例のように JAR ファイルへのパスが指定されます。
+.LP
+絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP に複数のパスや JAR ファイルが含まれる場合には、それらを Solaris の場合はコロン (\f2:\fP) で、Windows の場合はセミコロン (\f2;\fP) でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。
+.LP
+クラスファイルを含む、JAR ファイルへのパスを指定する例を示します。
+.nf
+\f3
+.fl
+\-altsignerpath /home/user/lib/authsigner.jar
+.fl
+\fP
+.fi
+.LP
+JAR ファイル名が含まれていることに注意してください。
+.LP
+クラスファイルを含む JAR ファイルへのパスを指定する例を示します。
+.nf
+\f3
+.fl
+\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/
+.fl
+\fP
+.fi
+.LP
+JAR ファイル名は含まれていないことに留意してください。
+.TP 3
+\-strict
+署名または検証処理中に、何らかの警告メッセージが表示される場合があります。コマンド行でこのオプションを指定すると、見つかった警告メッセージがツールの終了コードに反映されます。詳細は「警告」の項を参照してください。
+.TP 3
+\-verbose:sub\-options
+検証処理で、 \f2\-verbose\fP オプションは、表示する情報の量を決定するサブオプションを取ります。 \f2\-certs\fP も指定した場合、デフォルトモード (またはサブオプション all) では、エントリが処理されるたびにそれらの各エントリが表示され、そのあとに JAR ファイルの各署名者の証明書情報も表示されます。 \f2\-certs\fP と \f2\-verbose:grouped\fP サブオプションを指定した場合、同じ署名者情報を持つエントリとその証明書情報が、いっしょにグループ化されて表示されます。 \f2\-certs\fP と \f2\-verbose:summary\fP サブオプションを指定した場合、同じ署名者情報を持つエントリとその証明書情報がいっしょにグループ化されて表示されますが、各エントリの詳細が「1 つのエントリ (およびそれ以上)」として要約されて表示されます。詳細は例の項を参照してください。
+.RE
+
+.LP
+.SH "例"
+.LP
+.SS
+JAR ファイルの署名
+.LP
+.LP
+bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。キーストアは、mystore という名前で、C ドライブの working ディレクトリにあり、キーストアのパスワードは mypass、\f2jane\fP の非公開鍵のパスワードは j638klm とします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-storepass myspass
+.fl
+ \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+上のコマンドでは \f2\-sigfile\fP が指定されていないため、署名付き JAR ファイルに格納される .SF ファイルと .DSA ファイルの名前は、別名からデフォルト名がつけられます。つまり、それらの名前は \f2JANE.SF\fP および \f2JANE.DSA\fP になります。
+.LP
+.LP
+ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、上のコマンドを短縮して次のように入力できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore
+.fl
+ \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+デフォルトのキーストア (ホームディレクトリ内の .keystore という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を省略できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+最後に、入力 JAR ファイル (\f2bundle.jar\fP) を署名付き JAR ファイルで単純に上書きする場合は、次のように \f2\-signedjar\fP オプションを指定する必要はありません。
+.LP
+.nf
+\f3
+.fl
+ jarsigner bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.SS
+署名付き JAR ファイルの検証
+.LP
+.LP
+次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが改変されていないことを確認するためのコマンド例です。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-verify sbundle.jar
+.fl
+\fP
+.fi
+
+.LP
+.LP
+検証が成功すると、次のようなメッセージが表示されます。
+.LP
+.nf
+\f3
+.fl
+ jar verified.
+.fl
+\fP
+.fi
+
+.LP
+.LP
+というプロンプトが表示されます。検証が成功しなかった場合は、エラーメッセージが表示されます。
+.LP
+.LP
+\-verbose オプションを使うと、 \f2より多くの情報が\fP 表示されます。\-verbose オプション付きで \f3jarsigner\fP \f2を使用する例とその出力例を、\fP 次に示します。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-verify \-verbose sbundle.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
+.fl
+ smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.SS
+証明書情報を使った検証
+.LP
+.LP
+検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。次に例を示します。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
+.fl
+ 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
+.fl
+ smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
+.fl
+
+.fl
+ X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
+.fl
+ X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.LP
+署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の場合は、次のように表示されます。
+.LP
+.nf
+\f3
+.fl
+ PGP, (bob)
+.fl
+\fP
+.fi
+
+.LP
+.SS
+アイデンティティーデータベースの署名者を含む JAR ファイルの検証
+.LP
+.LP
+JAR ファイルが、JDK 1.1 の \f3javakey\fP ツールを使って署名されている場合、署名者はアイデンティティーデータベース内の別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、アイデンティティーデータベース内の別名とキーストア内の別名の両方によって署名されている場合は、k と i の両方が表示されます。
+.LP
+.LP
+\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。たとえば、
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
+.fl
+ 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
+.fl
+ smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
+.fl
+
+.fl
+ X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
+.fl
+ X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+ i = アイデンティティースコープで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.LP
+別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティーデータベースの別名です。
+.LP
+.SH "警告"
+.LP
+署名/検証処理中には、jarsigner からさまざまな警告が表示される可能性があります。これらの警告コードは次のように定義されています。
+.nf
+\f3
+.fl
+ hasExpiringCert 2
+.fl
+ この JAR に含まれるエントリの署名者の証明書が 6 か月以内に期限切れになります
+.fl
+
+.fl
+ hasExpiredCert 4
+.fl
+ この JAR に含まれるエントリの署名者の証明書が期限切れになっています。
+.fl
+
+.fl
+ notYetValidCert 4
+.fl
+ この JAR に含まれるエントリの署名者の証明書がまだ有効になっていません。
+.fl
+
+.fl
+ chainNotValidated 4
+.fl
+ この JAR に含まれるエントリの証明書チェーンの検証を正しく行えません。
+.fl
+
+.fl
+ badKeyUsa ge 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の KeyUsage 拡張がコードの署名を許可していません。
+.fl
+
+.fl
+ badExtendedKeyUsage 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の ExtendedKeyUsage 拡張が
+.fl
+ コードの署名を許可していません。
+.fl
+
+.fl
+ badNetscapeCertType 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の NetscapeCertType 拡張が
+.fl
+ コードの署名を許可していません。
+.fl
+
+.fl
+ hasUnsignedEntry 16
+.fl
+ この JAR には、完全性チェックが行われていない署名なしエントリが含まれています。
+.fl
+
+.fl
+ notSignedByAlias 32
+.fl
+ この JAR には、指定された別名によって署名されていない署名付きエントリが含まれています
+.fl
+
+.fl
+ aliasNotInStore 32
+.fl
+ この JAR には、このキーストアの別名によって署名されていない署名付きエントリが含まれています
+.fl
+
+.fl
+\fP
+.fi
+
+.LP
+.LP
+\f2\-strict\fP オプションを指定した場合、検出された警告の OR を取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書の keyUsage 拡張でファイルの署名が許可されていない場合、終了コード 12 (=4+8) が返されます。
+.LP
+.LP
+\f3注\fP: UNIX で使用可能な値は 0 から 255 だけであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。
+.LP
+.nf
+\f3
+.fl
+failure 1
+.fl
+\fP
+.fi
+
+.LP
+.SS
+JDK 1.1 との互換性
+.LP
+.LP
+\f3keytool\fP ツールと \f3jarsigner\fP ツールは、JDK 1.1 で提供されていた \f3javakey\fP ツールを完全に置き換えるものです。これらの新しいツールは、キーストアと非公開鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fP より多くのを機能を備えています。
+.LP
+.LP
+新しいキーストアアーキテクチャーは、\f3javakey\fP が作成して管理していたアイデンティティーデータベースに代わるものです。キーストア形式と、JDK 1.1 の \f3javakey\fP が使っていたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。
+.LP
+.RS 3
.TP 2
o
-\f3jarsigner\fP \f3javakey\fP篏帥ｃ臀峨 JAR ＜ゃ罎荐若с障ｃjarsigner Java 2 SDK 若鴻≪с JDK 1.1 ≪ゃ潟ｃｃ若若帥若鴻臀峨ュ茯茘絲乗院茵с障
+\f3keytool\fP の \f2\-identitydb\fP コマンドを使うと、アイデンティティーデータベースの情報をキーストアにインポートできます。
+.TP 2
+o
+\f3jarsigner\fP は、以前に \f3javakey\fP を使って署名された JAR ファイルに署名を付けることができます。
+.TP 2
+o
+\f3jarsigner\fP は、\f3javakey\fPを使って署名された JAR ファイルを検証できます。したがって、jarsigner は、Java 2 SDK のキーストアではなく JDK 1.1 のアイデンティティーデータベースからの署名者別名を認識し、これらを対象に処理を行うことができます。
.RE
.LP
.LP
-罨＜茵JDK 1.1.x х讐 JAR ＜ゃJava 2 若с宴腓冴障
+次の表は、JDK 1.1.x で署名された JAR ファイルが、Java 2 プラットフォームでどのように扱われるかを示しています。
.LP
.LP
.TS
@@ -160,7 +1053,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3JAR ＜ゃ帥ゃ\fP
+\f3JAR ファイルのタイプ\fP
.br
.di
.nr a| \n(dn
@@ -176,7 +1069,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f31.1 若帥若劫≪ゃ潟ｃｃ\fP
+\f31.1 データベース内のアイデンティティー\fP
.br
.di
.nr b| \n(dn
@@ -192,7 +1085,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f31.1 若帥若鴻 Java 2 Platform 若鴻≪ゃ潟若篆♂若с≪ゃ潟ｃｃ (4)\fP
+\f31.1 データベースから Java 2 Platform キーストアにインポートされる信頼できるアイデンティティー (4)\fP
.br
.di
.nr c| \n(dn
@@ -208,7 +1101,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(83 .ll \n(83u
.in 0
-\f3激若＜ゃ≪ゃ潟ｃｃ/ュ号┤筝\fP
+\f3ポリシーファイルがアイデンティティー/別名に特権を与える\fP
.br
.di
.nr d| \n(dn
@@ -224,7 +1117,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr e| \n(dn
@@ -240,7 +1133,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr f| \n(dn
@@ -256,7 +1149,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr g| \n(dn
@@ -272,7 +1165,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-/篆♂若с
+あり/信頼できない
.br
.di
.nr h| \n(dn
@@ -288,7 +1181,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤ (3)
+すべてのコードに与えられるデフォルトの特権(3)
.br
.di
.nr i| \n(dn
@@ -304,7 +1197,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-/篆♂若с
+あり/信頼できない
.br
.di
.nr j| \n(dn
@@ -320,7 +1213,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤ (1,3)
+すべてのコードに与えられるデフォルトの特権(1,3)
.br
.di
.nr k| \n(dn
@@ -336,7 +1229,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤激若＜ゃт号┤
+すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権
.br
.di
.nr l| \n(dn
@@ -352,7 +1245,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤激若＜ゃт号┤ (2)
+すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権(2)
.br
.di
.nr m| \n(dn
@@ -363,46 +1256,46 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨 JAR
+.nr 38 \w署名のない JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 38 \n(a-
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -413,63 +1306,63 @@
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.nr 82 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
.82
.rm 82
.nr 38 \n(c-
.if \n(82<\n(38 .nr 82 \n(38
.nr 83 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
.83
.rm 83
.nr 38 \n(d-
.if \n(83<\n(38 .nr 83 \n(38
.nr 84 0
-.nr 38 \w\f3筝号┤\fP
+.nr 38 \w\f3与えられる特権\fP
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤
+.nr 38 \wすべての特権
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤ (1)
+.nr 38 \wすべての特権 (1)
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤ (1)
+.nr 38 \wすべての特権 (1)
.if \n(84<\n(38 .nr 84 \n(38
.84
.rm 84
@@ -503,7 +1396,7 @@
.nr 44 \n(83+(3*\n(38)
.nr 84 +\n(44
.nr TW \n(84
-.if t .if \n(TW>\n(.li .tm Table at line 185 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1078 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -528,7 +1421,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3筝号┤\fP
+\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3与えられる特権\fP
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -565,7 +1458,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -581,7 +1474,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名のない JAR\h'|\n(41u'なし\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -597,7 +1490,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'あり\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -615,7 +1508,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -640,7 +1533,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'\h'|\n(42u'なし\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -663,7 +1556,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'あり\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -679,7 +1572,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'あり\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -693,15 +1586,15 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'すべての特権
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'あり\h'|\n(43u'なし\h'|\n(44u'すべての特権 (1)
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'なし\h'|\n(43u'あり\h'|\n(44u'すべての特権 (1)
.fc
.nr T. 1
.T# 1
@@ -724,894 +1617,43 @@
.LP
.LP
-羈 \-
+注 \-
.LP
.RS 3
.TP 3
1.
-激若＜ゃ≪ゃ潟ｃｃ/ュゃ荐翫若鴻≪ゃ潟若激若＜ゃ荐絎筝号┤綽荀障
+ポリシーファイル内にアイデンティティー/別名についての言及がある場合、それをキーストアにインポートして、ポリシーファイルの設定が与えられた特権に反映されるようにする必要があります。
.TP 3
2.
-激若＜ゃ/若鴻≪腟水≪ゃ潟ｃｃ若若帥若劫篆♂若с≪ゃ潟ｃｃ若障
+ポリシーファイル/キーストアの組み合わせは、アイデンティティーデータベース内の信頼できるアイデンティティーよりも優先されます。
.TP 3
3.
-Java 2 若с篆♂若с≪ゃ潟ｃｃ若∴障
+Java 2 プラットフォームでは、信頼できないアイデンティティーは無視されます。
.TP 3
4.
-Java 2 SDK 若鴻≪ゃ潟若с篆♂若с≪ゃ潟ｃｃ若с
-.RE
-
-.LP
-.SS
-若鴻≪ュ
-.LP
-.RS 3
-
-.LP
-.LP
-若鴻≪鴻潟筝ュ篁≪祉鴻障
-.LP
-.LP
-\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁臀峨綽荀泣若鴻≪潟ュ絎綽荀障違罨＜箴working ｃ mystore 若鴻≪障ュ duke ∫ｄ泣篏帥ｃMyJARFile.jar JAR ＜ゃ臀峨篁障阪＜ゃ絎сMyJARFile.jar 臀峨篁 JAR ＜ゃｃ筝吾障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-storepass myspass
-.fl
- \-keypass dukekeypasswd MyJARFile.jar duke
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻≪鴻若т茘激с鴻≪鴻若 (筝箴с mypass) 絎綽荀障潟潟茵с鴻≪鴻若絎鴻若ュ羆障罕泣若鴻√с鴻若ｃ篆茘激泣鴻若 (筝箴с dukekeypasswd) 絎綽荀障 潟潟茵ч泣鴻若絎障絎鴻若篆絖鴻若ｃ翫泣鴻若ュ羆障
-.LP
-.RE
-.SS
-若鴻≪贋
-.LP
-.RS 3
-
-.LP
-.LP
-\f3jarsigner\fP 篏睡若鴻≪ URL 絎 \f2\-keystore\fP 激с潟障若鴻≪с若吟若若ｃ \f2.keystore\fP ＜ゃ主障 若吟若若ｃ\f2user.home\fP 激鴻ｃ若ｃ羆冴障障Solaris 激鴻翫\f2user.home\fP с若吟若若ｃｃ障
-.LP
-.LP
-\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP ＜純羝＜障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP ＜純羝＜障\f2NONE\fP \f2KeyStore\fP ＜ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
-.LP
-.RE
-.SS
-若鴻≪絎茖
-.LP
-.RS 3
-
-.LP
-.LP
-\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
-.LP
-.LP
-憜若鴻≪絎茖篏睡\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若障\f2KeyStore\fP public 篏睡純сJava 2 SDK 若吟若 KeyStore 篏帥ｃ祉祉ャｃ若≪宴若激с潟篏с障
-.LP
-.LP
-若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪＜ゃ絎茖障絎茖с泣ャ鴻若ｃ篆茘激若鴻√篏翫с (泣ャ) 鴻若ｃ篆茘激障
-.LP
-.LP
-若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface ＜純絎臂障 ＜純ゃ絎茖違障сゃJava Security API ｃ≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сｃ若鴻≪絎茖箴
-.na
-\f2Java 垸≪若ｃ主ゃ絎茖号\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
-.LP
-.LP
-≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance ＜＜純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
-.LP
-.LP
-\f3keytool\fP 篁紙＜ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝＜若鴻≪贋＜ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
-.LP
-.LP
-\f3jarsigner\fP \f3keytool\fP 翫\f2\-storetype\fP 激с潟篏帥ｃ潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP 翫[Edit] ＜ャ若 [Change Keystore] 潟潟篏帥ｃ若鴻≪帥ゃ絎с障
-.LP
-.LP
-若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャｃ若ｃ若＜ゃф絎 \f2keystore.type\fP ｃ若ゃ冴ャ若鴻≪絎茖御障祉ャｃ若ｃ若＜ゃ\f2java.security\fP SDK 祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
-.LP
-.LP
-若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
-.LP
-.LP
-\f2KeyStore\fP 鴻с \f2getDefaultType\fP static ＜純絎臂≪宴若激с潟≪＜純篏帥 \f2keystore.type\fP ｃ若ゃ緇с障罨＜潟若若鴻≪帥ゃ (\f2keystore.type\fP ｃ若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
-.LP
-.nf
-\f3
-.fl
- KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャｃ若ｃ若＜ゃ罨＜茵ｃ絎障
-.LP
-.nf
-\f3
-.fl
- keystore.type=jks
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
-.LP
-.LP
-若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨＜紊眼障
-.LP
-.nf
-\f3
-.fl
- keystore.type=pkcs12
-.fl
-\fP
-.fi
-
-.LP
-.LP
-PKCS#11 ゃ宴若吾篏睡翫荅括完ゃJava PKCS#11 Reference Guide
-.na
-\f2KeyTool and JarSigner\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner膀с
-.LP
-.RE
-.RE
-.SS
-泣若≪眼冴
-.LP
-.RS 3
-
-.LP
-.LP
-с\f3jarsigner\fP 罨＜＜≪眼冴篏帥ｃ JAR ＜ゃ臀峨障
-.LP
-.RS 3
-.TP 2
-o
-SHA\-1 ゃ吾с鴻≪眼冴篏帥ｃ DSA (吾帥臀峨≪眼冴)
-.TP 2
-o
-MD5 ゃ吾с鴻≪眼冴篏帥ｃ RSA ≪眼冴
+Java 2 SDK キーストアにインポートできるのは、信頼できるアイデンティティーだけです。
.RE
.LP
-.LP
-隙臀峨泣泣 DSA 泣с翫\f3jarsigner\fP SHA1withDSA ≪眼冴篏帥ｃ JAR ＜ゃ臀峨篁障臀峨泣 RSA 泣с翫\f3jarsigner\fP MD5withRSA ≪眼冴篏帥ｃ JAR ＜ゃ臀峨篁障
-.LP
-.LP
-臀峨≪眼冴\f2\-sigalg\fP 激с潟篏帥ｃ若若ゃс障
-.LP
-.RE
-.SS
-臀峨篁 JAR ＜ゃ
-.LP
-.RS 3
-
-.LP
-.LP
-\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁翫阪臀峨篁 JAR ＜ゃュ JAR ＜ゃс罨＜ 2 ゃ菴遵＜ゃ META\-INF ｃ臀鴻違障
-.LP
-.RS 3
-.TP 2
-o
-.SF ≦宍絖篁臀峨＜ゃ
-.TP 2
-o
-.DSA ≦宍絖篁臀峨＜ゃ
-.RE
-
-.LP
-.LP
- 2 ゃ＜ゃ若鴻＜ゃ\f2\-sigFile\fP 激с潟ゃ篏障違罨＜激с潟絎障
-.LP
-.nf
-\f3
-.fl
- \-sigFile MKSIGN
-.fl
-\fP
-.fi
-
-.LP
-.LP
-翫＜ゃ MKSIGN.SF MKSIGN.DSA 障
-.LP
-.LP
-潟潟茵 \f2\-sigfile\fP 激с潟絎ｃ翫.SF ＜ゃ .DSA ＜ゃ若鴻＜ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨＜ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀＜ゃ篏障篏睡с絖≪＜医筝膩 (_)ゃ潟с
-.LP
-\f3臀峨 (.SF) ＜ゃ\fP
-.LP
-.RS 3
-
-.LP
-.LP
-臀峨＜ゃ (.SF ＜ゃ) \f3jarsigner\fP х讐篁 JAR ＜ゃ絽吾障с鴻＜ゃ篌若障ゃ障с鴻＜ゃ罕.SF ＜ゃJAR ＜ゃ障純若鴻＜ゃ罨＜ 3 ゃ茵障
-.LP
-.RS 3
-.TP 2
-o
-＜ゃ
-.TP 2
-o
-篏帥ゃ吾с鴻≪眼冴 (SHA)
-.TP 2
-o
-SHA ゃ吾с鴻
-.RE
-
-.LP
-.LP
-с鴻＜ゃсSHA ゃ吾с鴻ゃ純若鴻＜ゃゃ若帥ゃ吾с鴻 (激) с筝鴻.SF ＜ゃс純若鴻＜ゃゃ吾с鴻ゃс鴻＜ゃ筝荅峨純若鴻＜ゃ絲上 3 茵激ャс
-.LP
-.LP
-臀峨＜ゃсс鴻＜ゃ篏激ャ障障緇菴違JAR ＜ゃ罎荐若ц若絖ｃ罎荐若純ｃ障
-.LP
-.RE
-\f3臀峨 (.DSA) ＜ゃ\fP
-.LP
-.RS 3
-
-.LP
-.LP
-.SF ＜ゃ臀峨篁臀峨 .DSA ＜ゃ臀障.DSA ＜ゃ若鴻≪荐惹吾障荐惹吾с若潟膃垸綵≪у障障 荐惹吾障荐惹吾с若潟臀峨篏帥泣絲上泣茯荐若障
-.LP
-.RE
-.RE
-.SS
-臀峨帥ゃ鴻帥潟
-.LP
-.RS 3
-
-.LP
-.LP
-J2SE 5.0 若鴻 \f2jarsigner\fP 若JAR ＜ゃ臀峨臀峨帥ゃ鴻帥潟恰主с障\f2jarsigner\fP 篁ｆ睡讐罘罕泣若障篏ュ純с臀峨罨＜激с潟ｃ九勝障
-.LP
-.RS 3
-.TP 2
-o
-\f2\-tsa url\fP
-.TP 2
-o
-\f2\-tsacert alias\fP
-.TP 2
-o
-\f2\-altsigner class\fP
-.TP 2
-o
-\f2\-altsignerpath classpathlist\fP
-.RE
-
-.LP
-.LP
-激с潟荅括完ゃ緇菴違激с潟膀с
-.LP
-.RE
-.SS
-JAR ＜ゃ罎荐
-.LP
-.RS 3
-
-.LP
-.LP
-JAR ＜ゃ罎荐若臀峨鴻сょ讐篁ュ JAR ＜ゃ＜ゃ紊眼翫сJAR ＜ゃ罎荐若罨＜ц障
-.LP
-.RS 3
-.TP 3
-1.
-.SF ＜ゃ篏臀峨罎荐若障
-.LP
-с臀峨 (.DSA) ＜ゃ主臀峨絎泣絲上泣篏帥ｃс腆肴障 .DSA ＜ゃ泣荐惹 (障荐惹吾с若) 障障障с臀峨絲上臀峨 (.SF) ＜ゃ鴻臀峨с茯帥鴻.SF ＜ゃ劫腆肴障
-.TP 3
-2.
-.SF ＜ゃ潟ゃ吾с鴻с鴻絲上祉激с潟腦罎荐若障
-.LP
-.SF ＜ゃс鴻＜ゃ篏激ャ主若у障障若絖翫弱激ャ絎с鴻＜ゃ激ャ筝眼罎荐若с障激ャ筝眼翫罨＜蚊帥障
-.LP
-激ャ筝眼翫合ｃ号篏帥ｃ罎荐若茵障 隙.SF ＜ゃ純若鴻＜ゃ宴祉激с潟激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼腆肴障 (臀峨 (.SF) ＜ゃ)
-.LP
-.SF ＜ゃ若主с鴻＜ゃ激ャ絎с鴻＜ゃ激ャ筝眼翫臀峨 ( .SF ＜ゃ) 緇JAR ＜ゃ 1 や札筝＜ゃ菴遵 (\f2jar\fP 若篏睡) 醇с障\f2jar\fP 若篏帥ｃ＜ゃ菴遵翫с鴻＜ゃ紊眼障 (違＜ゃ祉激с潟菴遵).SF ＜ゃ紊眼障翫.SF ＜ゃ寂札紊祉激с潟主激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼臀峨 JAR ＜ゃ絖＜ゃ＜＜ゃ紊眼罎荐若宴障
-.TP 3
-3.
-JAR ＜ゃ＜ゃ＜.SF ＜ゃ潟ゅ＜ゃ茯粋昭帥障茯粋昭推賢＜ゃゃ吾с鴻荐膊腟с鴻祉激с喝荅峨＜ゃゃ吾с鴻罸莠障2 ゃゃ吾с鴻с違с翫罎荐若紊掩障
-.RE
-
-.LP
-.LP
-罎荐若祉鴻筝с紊с罎荐若若榊翫罎荐若祉鴻筝罩≪祉ャｃ寂紊鴻若障鴻若祉ャｃ寂紊\f3jarsigner\fP ｃ茵腓冴障
-.LP
-.RE
-.SS
-1 ゃ JAR ＜ゃ絲乗院茲違臀峨
-.LP
-.RS 3
-
-.LP
-.LP
-1 ゃ JAR ＜ゃ絲障 \f3jarsigner\fP 若茲医絎茵絎茵潟違若吟若ュ絎違JAR ＜ゃ茲違若吟若臀峨篁с障
-.LP
-.nf
-\f3
-.fl
- jarsigner myBundle.jar susan
-.fl
- jarsigner myBundle.jar kevin
-.fl
-\fP
-.fi
-
-.LP
-.LP
-JAR ＜ゃ茲医臀峨翫 JAR ＜ゃ .SF ＜ゃ .DSA ＜ゃ絲障茲医障障 .SF ＜ゃ .DSA ＜ゃ絲障1 臀峨絲障 1 や障ｃ筝箴у阪 JAR ＜ゃ罨＜ゃ＜ゃ障障
-.LP
-.nf
-\f3
-.fl
- SUSAN.SF
-.fl
- SUSAN.DSA
-.fl
- KEVIN.SF
-.fl
- KEVIN.DSA
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈:JAR ＜ゃсJDK 1.1 \f3javakey\fP 若х臀峨 \f3jarsigner\fP х臀峨羞桁с障ゃ障с \f3javakey\fP 篏帥ｃ臀峨篁 JAR ＜ゃ\f3jarsigner\fP 篏帥ｃ臀峨篁с障
-.LP
-.RE
-.SH "激с"
-.LP
-
-.LP
-.LP
-篁ヤс\f3jarsigner\fP 激с潟ゃ茯障羈:
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-激с喝ゃ壕 (\-) 篁
-.TP 2
-o
-激с潟篁紙綺ф絎с
-.TP 2
-o
-ゃ帥篏絎 (激с潟) 若吟若絎綽荀
-.TP 2
-o
-\f2\-keystore\fP\f2\-storepass\fP\f2\-keypass\fP\f2\-sigfile\fP\f2\-sigalg\fP\f2\-digestalg\fP \f2\-signedjar\fP 激с潟篏睡сJAR ＜ゃ臀峨篁翫с 激с潟JAR ＜ゃ罎荐若翫篏睡с罕ュ潟潟茵ф絎JAR ＜ゃ臀峨篁翫с
-.RE
-
-.LP
-.RS 3
-.TP 3
-\-keystore url
-若鴻≪贋腓冴 URL 絎障若吟若若ｃ＜ゃ \f2.keystore\fP с 若吟若若ｃuser.home 激鴻ｃ若ｃ羆冴障障
-.LP
-臀峨若鴻≪綽荀с 若鴻≪絖翫篁ュ祉若鴻≪篏睡翫若鴻≪腓榊絎綽荀障
-.LP
-罎荐若若鴻≪綽荀障 若鴻≪絎若鴻≪絖 \f2\-verbose\fP 激с潟絎翫JAR ＜ゃ罎荐若篏帥荐惹吾若鴻≪絖ゃ菴遵宴阪障
-.LP
-羈:\f2\-keystore\fP 綣違URL 篁ｃ＜ゃ () 絎с障 ＜ゃ () 絎翫file:URL 宴障違罨＜絎с障
-.nf
-\f3
-.fl
- \-keystore \fP\f4filePathAndName\fP\f3
-.fl
-\fP
-.fi
-罨＜絎宴障
-.nf
-\f3
-.fl
- \-keystore file:\fP\f4filePathAndName\fP\f3
-.fl
-\fP
-.fi
-JRE \f2$JAVA_HOME/lib/security\fP ｃ主 \f2java.security\fP 祉ャｃ若ｃ若＜ゃ Sun PKCS#11 ゃ荐絎翫keytool jarsigner PKCS#11 若潟冴ャ篏с障 罨＜激с潟絎障
-.RS 3
-.TP 2
-o
-\f2\-keystore NONE\fP
+jar(1) ツールのドキュメント
.TP 2
o
-\f2\-storetype PKCS11\fP
-.RE
-違罨＜潟潟荐絎 PKCS#11 若潟絎鴻筝荀ц；腓冴障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore NONE \-storetype PKCS11 \-list
-.fl
-
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-storetype storetype
-ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障若鴻≪帥ゃ祉ャｃ若ｃ若＜ゃ keystore.type ｃ若ゃф絎帥ゃс ゃ\f2java.security.KeyStore\fP static \f2getDefaultType\fP ＜純у緇с障
-.LP
-\f2\-storepass\fP 激с潟篏帥ｃ PCKS#11 若潟 PIN 絎с障篏絎ｃ翫keytool jarsigner 若吟若若 PIN ュ羆障若潟篆茘激茯荐若 (絨 PIN 篏茯水罘) 翫\f2\-protected\fP 激с潟絎綽荀障鴻若激с潟絎綽荀障
-.TP 3
-\-storepass password
-若鴻≪≪祉鴻綽荀鴻若絎障激с潟綽荀JAR ＜ゃ臀峨篁с (JAR ＜ゃ罎荐若筝荀)臀峨篁潟潟茵 \f2\-storepass\fP 激с潟絎ｃ翫鴻若ュ羆障
-.LP
-羈:鴻翫障祉ャｃ寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
-.TP 3
-\-keypass password
-潟潟茵ф絎ュ絲上若鴻≪潟泣篆茘激篏帥鴻若絎障\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁鴻若綽荀с潟潟茵с鴻若絎綽荀鴻若鴻≪鴻若違翫鴻若ュ羆障
-.LP
-羈:鴻翫障祉ャｃ寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
-.TP 3
-\-sigfile file
-.SF ＜ゃ .DSA ＜ゃ篏帥若鴻＜ゃ絎障違\f2file\fP DUKESIGN 絎 .SF ＜ゃ .DSA ＜ゃ DUKESIGN.SF DUKESIGN.DSA 障 ＜ゃ臀峨篁 JAR ＜ゃ META\-INF ｃ臀障
-.LP
-\f2file\fP 篏睡с絖a\-zA\-Z0\-9_\-сゃ障絖医筝膩潟ゃ潟篏睡с障羈:.SF .DSA ＜ゃс絨絖鴻紊ф絖紊障
-.LP
-潟潟茵 \f2\-sigfile\fP 激с潟絎ｃ翫.SF ＜ゃ .DSA ＜ゃ若鴻＜ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨＜ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀＜ゃ篏障
-.TP 3
-\-sigalg algorithm
-.RS 3
-
-.LP
-JAR ＜ゃ臀峨篏睡臀峨≪眼冴絎障
-.LP
-罔羣臀峨≪眼冴筝荀сゃJava Cryptography Architecture
-.na
-\f2Appendix A \fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс≪眼冴JAR ＜ゃ臀峨篏睡腱絲泣篋сс違障激с潟絎ｃ翫腱絲泣帥ゃ綽 SHA1withDSAMD5withRSA 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥ｃ絎綽荀障 с翫潟潟絎茵紊掩障
-.LP
-.RE
-.TP 3
-\-digestalg algorithm
-.RS 3
-JAR ＜ゃ潟ゃ吾с鴻篏睡＜祉若吾ゃ吾с鴻≪眼冴絎障
-.LP
-罔羣＜祉若吾ゃ吾с鴻≪眼冴筝荀сゃJava Cryptography Architecture
-.na
-\f2Appendix A \fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс激с潟絎ｃ翫SHA\-1 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥ｃ絎綽荀障 с翫潟潟絎茵紊掩障
-.LP
-.RE
-.TP 3
-\-signedjar file
-臀峨篁 JAR ＜ゃ絎障
-.LP
-潟潟茵у絎ｃ翫ュ JAR ＜ゃ (臀峨絲乗院 JAR ＜ゃ) 篏帥障 翫ュ JAR ＜ゃ臀峨篁 JAR ＜ゃｃ筝吾障
-.TP 3
-\-verify
-潟潟茵с激с潟絎翫絎 JAR ＜ゃ罎荐若障JAR ＜ゃ吾臀峨茵障 罎荐若jar 罎荐若障 ＜祉若吾茵腓冴障臀峨 JAR ＜ゃ障泣若≪眼冴 (RSA ゃゃ潟鴻若腟篋翫 RSA ) 篏帥ｃ臀峨 JAR ＜ゃ罎荐若jar 臀峨障(臀峨荀ゃ罕茹ｆс障)＜祉若吾茵腓冴障
-.LP
-臀峨篁 JAR ＜ゃ\f3jarsigner\fP 障 JDK 1.1 \f3javakey\fP 若筝≧鴻篏帥ｃ罎荐若с障
-.LP
-罎荐若ゃ荅括完JAR ＜ゃ罎荐若с
-.TP 3
-\-certs
-潟潟茵с\f2\-verify\fP \f2\-verbose\fP 激с潟激с潟絎翫JAR ＜ゃ臀峨荐惹御宴阪障荐惹御宴罨＜障障
-.RS 3
-.TP 2
-o
-臀峨泣荐惹 (.DSA ＜ゃ主) 荐惹吾腮蕁
-.TP 2
-o
-荐惹吾 X.509 荐惹 (ゃ障\f2java.security.cert.X509Certificate\fP ゃ潟鴻帥潟) с翫臀峨茘ュ
-.RE
-.LP
-若鴻≪腆肴茵障潟潟茵с若鴻≪ゃ絎翫若鴻≪＜ゃ違罎祉障臀峨泣荐惹吾若鴻√潟筝眼翫罨＜宴茵腓冴障
-.RS 3
+keytool(1) ツールのドキュメント
.TP 2
o
-臀峨荅峨若鴻≪潟ュ ュ綣су蚊障障若鴻≪с JDK 1.1 ≪ゃ潟ｃｃ若若帥若鴻掩ャ臀峨翫綣сс鎀ф綣су蚊障障
-.RE
-.TP 3
-\-verbose
-潟潟茵с激с潟絎翫\f3jarsigner\fP 激≪若у篏JAR 臀峨障罎荐若画倶≪菴遵宴阪障
-.TP 3
-\-internalsf
-篁ュJAR ＜ゃ臀峨 .DSA (臀峨) ＜ゃ筝 .SF ＜ゃ (臀峨＜ゃ) 絎潟若膃垸綵≪у障障篏紊眼障篏紊眼憜с阪 JAR ＜ゃ篏泣ゃ冴絨с .SF ＜ゃ .DSA ＜ゃ障ｃ障潟潟茵 \f2\-internalsf\fP 激с潟絎篁ュ篏障\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
-.TP 3
-\-sectionsonly
-潟潟茵с激с潟絎翫JAR ＜ゃ臀峨 .SF ＜ゃ (臀峨＜ゃ) с鴻＜ゃ篏激ャ若菴遵障翫.SF ＜ゃ障JAR ＜ゃ純若鴻＜ゃ≪宴潟激ャс 荅括完臀峨 (.SF) ＜ゃс
-.LP
-с茵с鴻＜ゃ篏激ャ若菴遵障若絖翫JAR ＜ゃ罎荐惹障弱激ャс鴻＜ゃ篏激ャ絎筝眼腆肴障激ャ筝眼翫罎荐若罨＜蚊帥障激ャ筝眼翫合ｃ号篏帥ｃ罎荐若茵障 隙.SF ＜ゃ純若鴻＜ゃ宴祉激с潟激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼腆肴障
-.LP
-荅括完JAR ＜ゃ罎荐若с
-.LP
-\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
-.TP 3
-\-protected
-\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
-.RE
-.RS 3
-.TP 3
-\-provider provider\-class\-name
-泣若鴻ゃ祉ャｃ若ｃ若＜ゃ (\f2java.security\fP) 鴻ャｃ垸泣若鴻ゃ鴻帥若鴻＜ゃ絎障
-.LP
-\f2\-providerArg\fP \f2ConfigFilePath\fP 激с潟腟水篏睡障 keytool jarsigner ゃゃ潟鴻若障 (с\f2ConfigFilePath\fP 若活┃絎＜ゃ吾鴻с)祉ャｃ若ｃ若＜ゃ Sun PKCS#11 ゃ荐絎翫 PKCS#11 若鴻≪筝荀ц；腓冴潟潟箴罨＜腓冴障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
-jarsigner \-keystore NONE \-storetype PKCS11 \\
-.fl
- \-providerClass sun.security.pkcs11.SunPKCS11 \\
-.fl
- \-providerArg /foo/bar/token.config \\
-.fl
- \-list
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-providerName providerName
-\f2java.security\fP 祉ャｃ若ｃ若＜ゃ 2 や札筝ゃ荐絎翫\f2\-providerName\fP 激с潟篏帥ｃ劫ゃゃ潟鴻帥潟鴻御с障激с潟綣違ゃс
-.LP
-Sun PKCS#11 ゃ翫\f2providerName\fP \f2SunPKCS11\-\fP\f2TokenName\fP 綵√障 с\f2TokenName\fPゃゃ潟鴻帥潟鴻罕･絨乗с 荅括完
.na
-\f2罕絮с茵\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSс違篁ヤ潟潟с･絨乗 \f2SmartCard\fP PKCS#11 若鴻≪ゃゃ潟鴻帥潟鴻絎鴻鴻障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
-jarsigner \-keystore NONE \-storetype PKCS11 \\
-.fl
- \-providerName SunPKCS11\-SmartCard \\
-.fl
- \-list
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-Jjavaoption
-絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋･羝＜障(\f3jarsigner\fP 絎 Java ゃ潟帥帥絲障若с激с潟腥榊純с障激с潟絎茵医障＜≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц；腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
-.LP
-.TP 3
-\-tsa url
-JAR ＜ゃ臀峨潟潟茵\f2\-tsa http://example.tsa.url\fP茵腓冴翫臀峨帥ゃ鴻帥潟障URL \f2http://example.tsa.url\fP TSA (Time Stamping Authority) 贋劫障\f2\-tsacert\fP 激с潟ф冴 URL 若若ゃ障\f2\-tsa\fP 激с潟сTSA 笈┝吾若鴻≪臀綽荀障
-.LP
-帥ゃ鴻帥潟\f2jarsigner\fP
-.na
-\f2RFC 3161\fP @
-.fi
-http://www.ietf.org/rfc/rfc3161.txt у臂 TSP (Time\-Stamp Protocol) 篏睡 TSA 篆＜障TSA 菴帥ゃ鴻帥潟若潟臀峨＜ゃ臀峨篆絖障
-.LP
-.TP 3
-\-tsacert alias
-JAR ＜ゃ臀峨潟潟茵\f2\-tsacert alias\fP茵腓冴翫臀峨帥ゃ鴻帥潟障\f2alias\fP 若鴻√憜鴻 TSA 笈┝吾劫障潟荐惹吾сTSA 贋劫 URL Subject Information Access ≦宍罘純腆肴障
-.LP
-TSA 笈┝吾\f2\-tsacert\fP 篏帥ｃ翫若鴻≪臀綽荀障
-.LP
-.TP 3
-\-altsigner class
-篁ｆ睡讐罘罕篏睡絎障絎篆蕋障劫\f2com.sun.jarsigner.ContentSigner\fP abstract 鴻≦宍鴻＜ゃ劫障鴻＜ゃ吾鴻\f2\-altsignerpath\fP 激с潟ｃ絎臂障\f2\-altsigner\fP 激с潟篏睡翫\f2jarsigner\fP 絎鴻箴臀峨罘罕篏睡障障\f2jarsigner\fP 臀峨罘罕篏睡障
-.LP
-違\f2com.sun.sun.jarsigner.AuthSigner\fP 鴻箴臀峨罘罕篏睡\f2jarsigner\fP 激с潟\f2\-altsigner com.sun.jarsigner.AuthSigner\fP篏睡障
-.LP
-.TP 3
-\-altsignerpath classpathlist
-鴻＜ゃ (鴻＜ゃ筝荐 \f2\-altsigner\fP 激с潟ф絎) 潟箴絖 JAR ＜ゃ吾鴻絎障鴻＜ゃ JAR ＜ゃ翫篁ヤ箴 JAR ＜ゃ吾鴻絎障
-.LP
-腟九障鴻障憜ｃ後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR ＜ゃс障 翫鴻障 JAR ＜ゃSolaris 翫潟 (\f2:\fP)Windows 翫祉潟 (\f2;\fP) у阪障鴻с罎膣≪劫翫激с潟筝荀с
-.LP
-鴻＜ゃJAR ＜ゃ吾鴻絎箴腓冴障
-.RS 3
-
-.LP
-.LP
-\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
-.LP
-.RE
-.LP
-JAR ＜ゃ障羈
-.LP
-鴻＜ゃ JAR ＜ゃ吾鴻絎箴腓冴障
-.RS 3
-.LP
-\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
-.LP
-.RE
-.LP
-JAR ＜ゃ障
-.RE
-.SH "箴"
-.LP
-
-.LP
-.SS
-JAR ＜ゃ臀峨
-.LP
-.RS 3
-
-.LP
-.LP
-bundle.jar JAR ＜ゃ障 ＜ゃ若鴻≪ュ jane с若吟若泣篏帥ｃ臀峨篁障若鴻≪mystore сC ゃ working ｃ若鴻≪鴻若 mypass\f2jane\fP 泣鴻若 j638klm 障翫罨＜潟潟絎茵JAR ＜ゃ臀峨篁 sbundle.jar 臀峨篁 JAR ＜ゃ篏с障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-storepass myspass
-.fl
- \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-筝潟潟с \f2\-sigfile\fP 激с潟絎臀峨篁 JAR ＜ゃ主 .SF ＜ゃ .DSA ＜ゃュゃ障ゃ障\f2JANE.SF\fP \f2JANE.DSA\fP 障
-.LP
-.LP
-鴻≪鴻若泣鴻若уュ翫筝潟潟膰罨＜ュс障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore
-.fl
- \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻 (若ｃ .keystore 若鴻) 篏睡翫罨＜腓冴若鴻≪絎ャс障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-障臀峨篁 JAR ＜ゃуュ JAR ＜ゃ (\f2bundle.jar\fP) 筝吾翫\f2\-signedjar\fP 激с潟絎ャс障
-.LP
-.nf
-\f3
-.fl
- jarsigner bundle.jar jane
-.fl
-\fP
+\f4jarsigner\fP\f2 ツールの使用例については、\fP @
.fi
-.RE
-
-.LP
-.SS
-臀峨篁 JAR ＜ゃ罎荐
-.LP
-.RS 3
-
-.LP
-.LP
-罨＜腓冴臀峨篁 JAR ＜ゃ罎荐若臀峨鴻 JAR ＜ゃ劫腆肴潟潟箴с
-.LP
-.nf
-\f3
-.fl
- jarsigner \-verify sbundle.jar
-.fl
-\fP
-.fi
-
-.LP
-.LP
-罎荐若罨＜＜祉若吾茵腓冴障
-.LP
-.nf
-\f3
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-＜祉若吾茵腓冴障罎荐若ｃ翫若＜祉若吾茵腓冴障
-.LP
-.LP
-\f2\-verbose\fP 激с潟篏帥紊宴茵腓冴障罨＜腓冴\f2\-verbose\fP 激с潟絎 \f3jarsigner\fP 絎茵箴阪腟с
-.LP
-.nf
-\f3
-.fl
- jarsigner \-verify \-verbose sbundle.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
-.fl
- smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
+http://download.oracle.com/javase/tutorial/index.html
+.na
+\f2「Java チュートリアル」\fP\f4の\fP @
.fi
-
-.LP
-.SS
-荐惹御宴篏帥ｃ罎荐
-.LP
-.LP
-罎荐惹\f2\-verify\fP \f2\-verbose\fP 激с潟 \f2\-certs\fP 激с潟絎翫JAR ＜ゃ臀峨荐惹御宴阪障 荐惹吾帥ゃ臀峨茘ュ (X.509 荐惹吾翫) JAR ＜ゃ泣荐惹吾若鴻≪潟泣荐惹吾筝眼翫綣су蚊障臀峨若鴻√ュ障障罨＜箴腓冴障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
-.fl
- 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
-.fl
- smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
-.fl
-
-.fl
- X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
-.fl
- X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-臀峨荐惹吾 X.509 荐惹吾с翫茘ュ宴茵腓冴障翫荐惹吾帥ゃュ茵腓冴障違荐惹吾 PGP 荐惹吾сュ bob 翫罨＜茵腓冴障
-.LP
-.nf
-\f3
-.fl
- PGP, (bob)
-.fl
-\fP
-.fi
-
-.LP
-.SS
-≪ゃ潟ｃｃ若若帥若鴻臀峨 JAR ＜ゃ罎荐
-.LP
-.LP
-JAR ＜ゃJDK 1.1 \f3javakey\fP 若篏帥ｃ臀峨翫臀峨≪ゃ潟ｃｃ若若帥若劫ュс 翫罎荐若阪 i 荐垩障障JAR ＜ゃ≪ゃ潟ｃｃ若若帥若劫ュ若鴻√ュ筝≧鴻ｃ臀峨翫k i 筝≧鴻茵腓冴障
-.LP
-.LP
-\f2\-certs\fP 激с潟絎翫若鴻≪ュ綣су蚊障絲障≪ゃ潟ｃｃ若若帥若劫ュ茹綣су蚊障茵腓冴障箴腓冴障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
-.fl
- 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
-.fl
- smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
-.fl
-
-.fl
- X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
-.fl
- X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
- i = 1 や札筝荐惹吾≪ゃ潟ｃｃ若鴻潟若ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-ュ duke 茹綣су蚊障сュ若鴻≪ュс≪ゃ潟ｃｃ若若帥若鴻ュс
-.LP
-.RE
-.SH "∫ｉ"
-.LP
-
-.LP
-.RS 3
-.TP 2
-o
-jar(1) 若ャ＜潟
-.TP 2
-o
-keytool(1) 若ャ＜潟
-.TP 2
-o
-\f3jarsigner\fP 若篏睡箴ゃ
-.na
-\f4Java Tutorial\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/index.html
-.na
-\f4Security\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/security/index.html
+http://download.oracle.com/javase/tutorial/index.html「Security」\f3を参照\fP
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/java.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/java.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,29 +19,29 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH java 1 "02 Jun 2010"
+.TH java 1 "14 Apr 2011"
.LP
-.SH ""
-java \- Java ≪宴若激с活儀若
+.SH "名前"
+java \- Java アプリケーション起動ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
+.SH "形式"
.LP
.nf
\f3
@@ -54,88 +54,78 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
class
-若喝冴鴻
+呼び出されるクラスの名前
.TP 3
file.jar
-若喝冴 JAR ＜ゃ綽 \f2\-jar\fP 篏睡
+呼び出される JAR ファイルの名前。必ず \f2\-jar\fP とともに使用する
.TP 3
argument
-\f3main\fP ∽違羝＜綣
+\f3main\fP 関数に渡される引数
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3java\fP 若Java ≪宴若激с潟莎桁障java 若Java Runtime Environment 莎桁絎鴻若鴻 \f3main\fP ＜純若喝冴Java ≪宴若激с潟莎桁障
+\f3java\fP ツールは、Java アプリケーションを起動します。java ツールは、Java Runtime Environment を起動したあと、指定されたクラスをロードし、そのクラスの \f3main\fP メソッドを呼び出すことにより、Java アプリケーションを起動します。
.LP
.LP
-＜純public static 絎ｈ綽荀障 障ゃ菴障 \f2String\fP ＜若帥絎с違障＜純絎ｈ罨＜ｃ違障
+このメソッドは、public および static として宣言する必要があります。 また、値を返してはいけません。 さらに、 \f2String\fP 配列をパラメータとして指定できなければなりません。メソッドの宣言は、次のようになっていなければなりません。
.LP
.nf
\f3
.fl
- public static void main(String args[])
+public static void main(String args[])
.fl
\fP
.fi
.LP
.LP
-с潟潟茵激с割札紊綣違若喝冴鴻障絎絎劫篏睡綽荀障\f3\-jar\fP 激с潟絎翫潟潟茵激с割札紊綣違≪宴若激с潟鴻＜ゃ純若鴻＜ゃ \f3JAR\fP ≪若ゃ障 翫с鴻 \f3Main\-Class\fP 若ф絎鴻莎桁鴻障
+デフォルトでは、コマンド行オプション以外の最初の引数が、呼び出されるクラスの名前になります。この名前には、完全指定のクラス名を使用する必要があります。\f3\-jar\fP オプションを指定した場合、コマンド行オプション以外の最初の引数が、アプリケーションのクラスファイルとリソースファイルを含む \f3JAR\fP アーカイブの名前になります。この場合、マニフェストの \f3Main\-Class\fP ヘッダーで指定されたクラスが起動クラスになります。
.LP
.LP
-Java Runtime 若鴻鴻鴻ゃ潟鴻若≦宍罘純潟若吟若鴻鴻 3 膊莎桁鴻篁篏睡鴻罎膣≪障
+Java Runtime は、ブートストラップクラスパス、インストール型拡張機能、およびユーザークラスパスの 3 箇所から起動クラスと他の使用されているクラスを検索します。
.LP
.LP
-劫障 JAR ＜ゃ潟潟茵激с割札紊綣違\f3main\fP ∽違羝＜障
+クラス名または JAR ファイル名のあとにある、コマンド行オプション以外の引数は、\f3main\fP 関数に渡されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-莎桁若憜絎茵医喝ャ若鴻с泣若罔羣激с潟障障篁潟激潟憜絎茖с罔羣激с潟祉泣若障 絨ャ若鴻у眼醇с障
+起動ツールには、現在の実行環境および将来のリリースでサポートされる標準オプションがあります。また、仮想マシンの現在の実装では、非標準オプションのセットもサポートされます。これは、将来のリリースで変更される可能性があります。
.LP
-.SH "罔羣激с"
-.LP
-
+.SH "標準オプション"
.LP
.RS 3
.TP 3
\-client
.LP
-Java HotSpot Client VM 御障64 絲上 JDK 憝鴻с激с潟∴篁ｃ Java Hotspot Server VM 篏睡障
+Java HotSpot Client VM を選択します。64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。
.LP
- VM 御ゃ
+デフォルトの VM の選択については、
.na
-\f2泣若 \- 鴻激潟罎冴\fP @
+\f2「サーバー \- クラスマシンの検出」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。
.TP 3
\-server
.LP
-Java HotSpot Server VM 御障64 絲上 JDK 筝с泣若 Java Hotspot Server VM с\-server 激с潟藥御障
+Java HotSpot Server VM を選択します。64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。
.LP
- VM 御ゃ
+デフォルトの VM の選択については、
.na
-\f2泣若 \- 鴻激潟罎冴\fP @
+\f2「サーバー \- クラスマシンの検出」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。
.TP 3
\-agentlib:libname[=options]
-ゃｃ若吾с潟ゃ \f2libname\fP 若障 井＜絎障
+ネイティブエージェントライブラリ \f2libname\fP をロードします。たとえば次のように指定します。
.LP
\-agentlib:hprof
.LP
@@ -143,57 +133,57 @@
.LP
\-agentlib:hprof=help
.LP
-荅括完ゃ
+詳細については、
.na
-\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
+\f2「JVMTI エージェントのコマンド行オプション」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
+http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。
.TP 3
\-agentpath:pathname[=options]
-劫篏睡若ｃ若吾с潟ゃ若障荅括完ゃ
+フルパス名を使用して、ネーティブエージェントライブラリをロードします。詳細については、
.na
-\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
+\f2「JVMTI エージェントのコマンド行オプション」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
+http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。
.TP 3
\-classpath classpath
.TP 3
\-cp classpath
-鴻＜ゃ罎膣≪ｃJAR ≪若ゃ ZIP ≪若ゃ鴻絎障鴻鴻潟潟 (\f3:\fP) у阪障\f3\-classpath\fP 障 \f3\-cp\fP 絎激с潟ゃｃ \f3CLASSPATH\fP 医紊違荐絎若若ゃ障
+クラスファイルを検索するディレクトリ、JAR アーカイブ、および ZIP アーカイブのリストを指定します。クラスパスの各エントリはコロン (\f3:\fP) で区切ります。\f3\-classpath\fP または \f3\-cp\fP を指定すると、このオプションの値によって \f3CLASSPATH\fP 環境変数の設定がオーバーライドされます。
.LP
-\f3\-classpath\fP \f3\-cp\fP 篏睡\f3CLASSPATH\fP 荐絎翫若吟若鴻鴻憜ｃ (\f4.\fP) 障
+\f3\-classpath\fP も \f3\-cp\fP も使用されず、\f3CLASSPATH\fP も設定されていない場合、ユーザークラスパスは現在のディレクトリ (\f4.\fP) になります。
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。* だけから成る \f2クラスパスエントリは、\fP カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.LP
-鴻鴻荅括完
+クラスパスの詳細は、
.na
-\f2鴻鴻荐絎\fP @
+\f2「クラスパスの設定」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。
.TP 3
\-Dproperty=value
-激鴻ｃ若ゃ荐絎障
+システムプロパティーの値を設定します。
.TP 3
\-d32
.TP 3
\-d64
- 32 医64 医с違絎茵荀羆障荀羆医ゃ潟鴻若泣若翫若怨障
+それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。
.LP
-憜Java HotSpot Server VM 64 篏泣若\-d64 篏睡 \-server 激с潟藥鴻障ｃ\-d64 篏睡\-client激с潟∴障篁罕絨ャ若鴻с紊眼醇с障
+現在のところ、Java HotSpot Server VM だけが 64 ビットの操作をサポートしており、\-server オプションを使用する場合は、\-d64 も一緒に使用する必要があります。したがって、\-d64 使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。
.LP
-\f3\-d32\fP \f3\-d64\fP ＜絎翫32 医у茵障篁罕絨ャ若鴻с紊眼醇с障
+\f3\-d32\fP と \f3\-d64\fP がどちらも指定されていない場合は、デフォルトとして、32 ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。
.TP 3
-\-enableassertions[:<package name>"..."| :<class name> ]
+\-enableassertions[:<package name>"..." | :<class name> ]
.TP 3
-\-ea[:<package name>"..."| :<class name> ]
-≪泣若激с潟鴻障≪泣若激с潟с≦鴻ｃ障
+\-ea[:<package name>"..." | :<class name> ]
+アサーションを有効にします。アサーションは、デフォルトでは無効になっています。
.LP
-綣違 \f3enableassertions\fP 障 \f3\-ea\fP 絎≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟鴻障綣違\f2...\fP絎憜篏罐ｃ宴若後с≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟鴻障
+引数なしの \f3enableassertions\fP または \f3\-ea\fP を指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが有効になります。
.LP
-筝潟潟茵鴻ゃゃ潟鴻帥潟鴻茲井絎翫絎鴻ゃ鴻若障ｃ違宴若 \f2com.wombat.fruitbat\fP (泣宴若吾) с帥≪泣若激с潟鴻違絎茵罨＜潟潟篏睡障
+単一コマンド行にこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ \f2com.wombat.fruitbat\fP (サブパッケージを含む) 内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。
.nf
\f3
.fl
@@ -202,151 +192,156 @@
\fP
.fi
.LP
-\f3\-enableassertions\fP \f3\-ea\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟鴻ャ鴻ゃ障 \f3\-enablesystemassertions\fP с
+\f3\-enableassertions\fP および \f3\-ea\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを有効にするために、別のスイッチが用意されています。このあとの \f3\-enablesystemassertions\fP を参照してください。
.TP 3
-\-disableassertions[:<package name>"..."| :<class name> ]
+\-disableassertions[:<package name>"..." | :<class name> ]
.TP 3
-\-da[:<package name>"..."| :<class name> ]
-≪泣若激с潟≦鴻障荐絎с
+\-da[:<package name>"..." | :<class name> ]
+アサーションを無効にします。これがデフォルトです。
.LP
-綣違 \f3disableassertions\fP 障 \f3\-da\fP 絎≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟≦鴻障綣違\f2...\fP絎憜篏罐ｃ宴若後с≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟≦鴻障
+引数なしの \f3disableassertions\fP または \f3\-da\fP を指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが無効になります。
.LP
-宴若 \f2com.wombat.fruitbat\fP с≪泣若激с潟鴻 \f2com.wombat.fruitbat.Brickbat\fP с≪泣若激с潟≦鴻с違絎茵罨＜潟潟篏睡障
+パッケージ \f2com.wombat.fruitbat\fP 内ではアサーションを有効にし、クラス \f2com.wombat.fruitbat.Brickbat\fP 内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。
.nf
\f3
.fl
-java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat <Main Class>
+java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat \fP\f4<Main Class>\fP\f3
.fl
\fP
.fi
.LP
-\f3\-disableassertions\fP \f3\-da\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟≦鴻ャ鴻ゃ障 \f3\-disablesystemassertions\fP с
+\f3\-disableassertions\fP および \f3\-da\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを無効にするために、別のスイッチが用意されています。このあとの \f3\-disablesystemassertions\fP を参照してください。
.TP 3
\-enablesystemassertions
.TP 3
\-esa
-鴻激鴻劫с≪泣若激с潟鴻障 ゃ障激鴻鴻ゃ≪泣若激с潟鴻若帥鴻 \f2true\fP 荐絎障
+すべてのシステムクラス内でアサーションを有効にします。つまり、システムクラスについてアサーションのデフォルトステータスを \f2true\fP に設定します。
.TP 3
\-disablesystemassertions
.TP 3
\-dsa
-鴻激鴻劫с≪泣若激с潟≦鴻障
-.LP
+すべてのシステムクラス内でアサーションを無効にします。
.TP 3
\-jar
-JAR ＜ゃ祉違絎茵障綣違莎桁鴻сJAR ＜ゃ障激с潟罘純JAR ＜ゃс鴻\f3Main\-Class:\fP\f4classname\fP\f3\fP綵√茵絎綽荀障\f2classname\fP ≪宴若激с潟紮篏臀罘純 \f2public\ static\ void\ main(String[]\ args)\fP ＜純鴻絎障JAR ＜ゃс鴻ゃjar(1)
+JAR ファイルにカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR ファイルの名前にします。このオプションが機能するには、JAR ファイルのマニフェストに\f3「Main\-Class:\fP\f4classname\fP\f3」\fPという形式の行を指定する必要があります。\f2classname\fP には、アプリケーションの開始位置として機能する \f2public\ static\ void\ main(String[]\ args)\fP メソッドを含むクラスを指定します。JAR ファイルとそのマニフェストについては、jar(1)と、
.na
-\f2Java ャ若≪\fP @
+\f2Java チュートリアル\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jarTrail: Jar Filesс
+http://download.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。
.LP
-激с潟篏睡絎 JAR ＜ゃ鴻若吟若鴻純若鴻若吟若鴻鴻祉荐絎∴障
+このオプションを使用すると、指定した JAR ファイルがすべてのユーザークラスのソースになり、ユーザークラスパスのほかの設定は無視されます。
.LP
-Solaris 8 сjava \-jar激с潟у茵с JAR ＜ゃ絎茵罔祉篆障 java \-jar篏睡у茵純с
+Solaris 8 では、「java \-jar」オプションで実行できる JAR ファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。Java Archive (JAR) ファイル
.na
-\f2Java Archive (JAR) ＜ゃ\fP @
+ @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/index.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html
.TP 3
\-javaagent:jarpath[=options]
-Java 違潟域茯若吾с潟若障
+Java プログラミング言語エージェントをロードします。 java.lang.instrument を参照してください。
.na
-\f2java.lang.instrument\fP @
+ @
.fi
-http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html с
+http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html
+.TP 3
+\-jre\-restrict\-search
+ユーザープライベートな JRE をバージョン検索に含めます。
+.TP 3
+\-no\-jre\-restrict\-search
+ユーザープライベートな JRE をバージョン検索から除外します。
.TP 3
\-verbose
.TP 3
\-verbose:class
-鴻若潟鴻≪宴茵腓冴障
+クラスがロードされるたびにクラスに関する情報を表示します。
.TP 3
\-verbose:gc
-若吾潟激с潟ゃ潟榊潟怨障
+ガベージコレクションイベントが発生するたびに報告します。
.TP 3
\-verbose:jni
-ゃｃ＜純篏睡潟篁 Java Native Interface (JNI) ≪ｃｃ若≪宴怨障
+ネイティブメソッドの使用およびその他の Java Native Interface (JNI) アクティビティーに関する情報を報告します。
.TP 3
\-version
-若吾с恰宴茵腓冴腟篋障
+バージョン情報を表示して終了します。
.TP 3
\-version:release
-潟潟茵絎鴻障 JAR ＜ゃ\f2release\fP ф絎若吾с潟綽荀腓冴障莎桁 java 潟潟若吾с潟絎絎鴻羣ら絎茖激鴻筝цゃｃ翫絎茖篏睡障
+コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。
.LP
-\f2release\fP с劫若吾с潟絎сс若吾с恰絖若違若吾с潟鴻絎с障若吾с恰絖ゃ若吾с括蚊腥榊純у阪ｃ綵√綺鋌鴻с若吾с括蚊若吾с ID若吾с ID 緇≪鴻帥鴻 (*) 篁若吾с ID 緇壕 (+) 篁2 ゃ若吾с括蚊≪潟泣潟 (&) х障≪鴻帥鴻ｃ剛眼壕垩絎若吾с割札筝≪潟泣潟 2 ゃ若吾с括蚊茫腥潟障箴腓冴障
+\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。
.nf
\f3
.fl
-\-version:"1.5.0_04 1.5*&1.5.1_02+"
+\-version:"1.6.0_13 1.6*&1.6.0_10+"
.fl
\fP
.fi
-筝荐潟若吾с 1.5.0_04障 1.5.1_02 篁ヤ 1.5 若吾с ID ｃ鴻ゃ若吾с潟鴻障 JAR ＜ゃ綽荀с 若吾с恰絖ｳ絲罕絎臂ゃJava Network Launching Protocol & API Specification (JSR\-56)Appendix Aс
+上記の意味は、バージョン 1.6.0_13、1.6 をバージョン ID プレフィックスに持つ 1.6.0_10 以上のバージョン、のいずれかをクラスまたは JAR ファイルが必要としている、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol & API Specification (JSR\-56)」の「Appendix A」を参照してください。
.LP
-JAR ＜ゃ翫絽吾若吾с活篁吟潟潟茵絎JAR ＜ゃс鴻絎ｨ絅障
+JAR ファイルの場合は通常、バージョン要件をコマンド行に指定するよりも、JAR ファイルのマニフェスト内に指定することが推奨されています。
.LP
-激с潟篏睡≪荀激惹宴ゃ緇菴違羈膀с
+このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。
.TP 3
\-showversion
-若吾с恰宴茵腓冴膓茵障
+バージョン情報を表示して続行します。
.TP 3
\-?
.TP 3
\-help
-篏睡羈茵腓冴腟篋障
+使用法を表示して終了します。
+.TP 3
+\-splash:imagepath
+\f2imagepath\fP に指定された画像を含むスプラッシュ画面を表示します。
.TP 3
\-X
-罔羣激с潟≪宴茵腓冴腟篋障
+非標準オプションに関する情報を表示して終了します。
.RE
.LP
.SS
-罔羣激с
-.LP
-.RS 3
-
+非標準オプション
.LP
.RS 3
.TP 3
\-Xint
-ゃ潟帥水≪若у篏障ゃｃ潟若吾潟潟ゃ≦鴻鴻ゃ潟若ゃ潟帥帥ｃ絎茵障Java HotSpot VM 絲上潟潟ゃ箴若潟剛鴻≪若с絎憗障
+インタプリタ専用モードで動作します。ネイティブコードへのコンパイルは無効になり、すべてのバイトコードがインタプリタによって実行されます。Java HotSpot VM に対応するコンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。
.TP 3
\-Xbatch
-違潟潟潟ゃ≦鴻障絽吾VM с違潟潟潟ゃ腟篋障с＜純違潟帥鴻潟潟ゃゃ潟帥帥≪若с＜純絎茵障\f2\-Xbatch\fP 違絎違潟潟潟ゃ≦鴻鴻＜純潟潟ゃ絎篋障с≪違潟帥鴻障
+バックグラウンドコンパイルを無効にします。通常、VM では、バックグラウンドコンパイルが終了するまで、メソッドをバックグラウンドタスクとしてコンパイルし、インタプリタモードでメソッドを実行します。\f2\-Xbatch\fP フラグを指定すると、バックグラウンドコンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンドタスクとして処理されます。
.TP 3
\-Xbootclasspath:bootclasspath
-若鴻＜ゃ｢ｃJAR ≪若ゃ ZIP ≪若ゃ潟潟у阪ｃ鴻ф絎障絎鴻絖若鴻＜ゃJDK 障若鴻＜ゃ篁ｃ篏睡障\f2羈: rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava Runtime Environment ゃ潟若ゃ祉潟拷障\fP
+ブートクラスファイルを探すディレクトリ、JAR アーカイブ、および ZIP アーカイブをコロンで区切ったリストで指定します。指定したパスに存在するブートクラスファイルが、Java プラットフォーム JDK に含まれるブートクラスファイルの代わりに使用されます。\f2注: rt.jar 内のクラスをオーバーライドする目的でこのオプションを使用するアプリケーションは、システムに配置しないでください。Java Runtime Environment バイナリコードライセンス違反になります。\fP
.TP 3
\-Xbootclasspath/a:path
-ｃJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪ｃ絎障 鴻若鴻鴻鴻菴遵障
+ディレクトリ、JAR アーカイブ、および ZIP アーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップクラスパスのあとに追加されます。
.TP 3
\-Xbootclasspath/p:path
-ｃJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪ｃ絎障 鴻若鴻鴻鴻菴遵障\f2羈 rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava Runtime Environment ゃ潟若ゃ祉潟拷障\fP
+ディレクトリ、JAR アーカイブ、および ZIP アーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップクラスパスの前に追加されます。\f2注: rt.jar 内のクラスをオーバーライドする目的でこのオプションを使用するアプリケーションは、システムに配置しないでください。Java Runtime Environment バイナリコードライセンス違反になります。\fP
.TP 3
\-Xcheck:jni
-Java Native Interface (JNI) 罘純絲障菴遵с茵障隙Java 篁潟激潟 JNI 荀羆JNI ∽違羝＜＜若帥絎茵医若帥罎荐若障≦鴻若帥荀ゃｃ翫ゃｃ潟若馹腓冴Java 篁潟激潟翫順若榊腟篋障激с潟篏睡若潟剛筝篋潟障
+Java Native Interface (JNI) 機能に対して追加チェックを行います。具体的には、Java 仮想マシンは JNI 要求を処理する前に、JNI 関数に渡されるパラメータと、実行環境のデータを検証します。無効なデータが見つかった場合は、ネイティブコードに問題があることを示しているため、Java 仮想マシンは致命的エラーを発生して終了します。このオプションを使用すると、パフォーマンス低下が予想されます。
.TP 3
\-Xfuture
-鴻＜ゃ綵√ｳ絲с障筝篏篋с篆ゃJDK 篁潟激潟絎茵綵√сJDK 純с≪若吾с 1.1.x 絎茵с腮綺ｳ絲ｃ障\f3\-Xfuture\fP 違絎鴻＜ゃ綵√篁罕吾羣綣桁ｳ絲с鴻障Java ≪宴若激с活儀若絨ャ若鴻сｳ絲с違潟若冴違篏睡с障
+クラスとファイルの形式を厳密にチェックします。下位互換性を保つため、JDK の仮想マシンが実行するデフォルトの形式チェックは、JDK ソフトウェアのバージョン 1.1.x が実行するチェックと同程度の厳密さになっています。\f3\-Xfuture\fP フラグを指定すると、クラスファイル形式の仕様への準拠を強化するためのより厳密なチェックが有効になります。Java アプリケーション起動ツールの将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときにはこのフラグを使用することをお勧めします。
.TP 3
\-Xnoclassgc
-鴻若吾潟激с潟≦鴻障激с潟篏睡若羝帥鴻＜≪若緇篏＜≪寂戎紜紊с障翫≪宴若激с潟ｃ OutOfMemoryError 鴻若醇с障
+クラスのガベージコレクションを無効にします。このオプションを使用すると、ロード済みクラスからメモリーが回復されることがなくなるため、全体的なメモリー使用量が増大します。この場合、アプリケーションによっては OutOfMemoryError がスローされる可能性があります。
.TP 3
\-Xincgc
-ゃ潟＜潟帥若吾潟帥鴻障ゃ潟＜潟帥若吾潟帥с≦鴻ｃ障 鴻違絎茵筝若吾潟激с潟筝罩≪榊障ゃ潟＜潟帥若吾潟帥違絎茵翫違с祉笈遵篏筝障
+インクリメンタルガーベジコレクタを有効にします。インクリメンタルガベージコレクタは、デフォルトでは無効になっています。 有効にすると、プログラムの実行中にガベージコレクションによる一時停止が発生しなくなります。インクリメンタルガベージコレクタは、プログラムと同時に実行することがあり、この場合、プログラムの利用できるプロセッサ能力が低下します。
.TP 3
\-Xloggc:file
-\-verbose:gc 罕若吾潟激с潟ゃ潟榊潟怨障若帥 \f2file\fP 荐蚊障\f2\-verbose:gc\fP 絎怨宴祉怨ゃ潟若吾潟激с潟ゃ潟腟 (腱篏) 篁障
+\-verbose:gc と同様にガベージコレクションイベントが発生するたびに報告しますが、そのデータを \f2file\fP に記録します。\f2\-verbose:gc\fP を指定したときに報告される情報のほかに、報告される各イベントの先頭に、最初のガベージコレクションイベントからの経過時間 (秒単位) が付け加えられます。
.LP
-若綽膈ｃ JVM 絎茵綺篏筝帥＜ゃ主絽吾若＜ゃ激鴻＜ゃ激鴻羣＜ゃ荅違＜ゃ若帥綣膓荐蚊障激с潟 \f2\-verbose:gc\fP 筝≧鴻潟潟茵絎翫激с潟障
-.LP
+ネットワークの応答時間によって JVM の実行速度が低下するのを避けるため、このファイルの格納先は、常にローカルファイルシステムにしてください。ファイルシステムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引き続き記録されます。このオプションと \f2\-verbose:gc\fP の両方がコマンド行に指定されている場合は、このオプションが優先されます。
.TP 3
\-Xmsn
-＜≪弱蚊綵若泣ゃ冴ゃ違ф絎障絎ゃ1M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 ＜ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
-.br
-箴:
-.RS 3
-
+メモリー割り当てプールの初期サイズをバイト数で指定します。指定する値は、1M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「
+.na
+\f2HotSpot Ergonomics\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/vm/gc\-ergonomics.html」を参照してください。
.LP
+例:
.nf
\f3
.fl
@@ -356,19 +351,19 @@
.fl
\-Xms6m
.fl
-
+
.fl
\fP
.fi
-.RE
.TP 3
\-Xmxn
-＜≪弱蚊綵若紊с泣ゃ冴ゃ違ф絎障絎ゃ2M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 ＜ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
+メモリー割り当てプールの最大サイズをバイト数で指定します。指定する値は、2M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「
+.na
+\f2HotSpot Ergonomics\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/vm/gc\-ergonomics.html」を参照してください。
.br
-箴:
-.RS 3
-
-.LP
+例:
.nf
\f3
.fl
@@ -378,96 +373,105 @@
.fl
\-Xmx80m
.fl
-
+
.fl
\fP
.fi
-.RE
-Solaris 7 Solaris 8 SPARC 若翫ゃ筝 4000m 若若綣сSolaris 2.6 x86 若翫 2000m 若若綣сLinux 若翫筝 2000m 若若綣с
+Solaris 7 および Solaris 8 SPARC プラットフォームの場合のこの値の上限は、およそ 4000m からオーバーヘッドの量を引いたものです。Solaris 2.6 および x86 プラットフォームの場合の上限は、およそ 2000m からオーバーヘッドの量を引いたものです。Linux プラットフォームの場合の上限は、およそ 2000m からオーバーヘッドの量を引いたものです。
.TP 3
\-Xprof
-絎茵筝違＜ゃ＜ゃ潟違若帥罔羣阪阪障激с潟違榊若ｃｃ若箴障 腮弱激鴻с篏睡с障
-.LP
+実行中のプログラムのプロファイルを生成し、プロファイルデータを標準出力に出力します。このオプションは、プログラム開発用のユーティリティーとして提供されています。 本番稼動システムでの使用を目的としたものではありません。
.TP 3
\-Xrs
-Java 篁潟激 (JVM) 若ｃ潟違激鴻激違篏睡羝障
+Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの使用を減らします。
.LP
-篁ュ若鴻сJava ≪宴若激с潟腱綺閫ｃ激ｃ潟激ｃ潟罘純菴遵障罘純JVM 腦句篋翫с激ｃ恰若吟若若潟≪潟若 (若帥若号･膓若冴) 絎茵с障
+以前のリリースでは、Java アプリケーションを秩序正しくシャットダウンするためのシャットダウンフック機能が追加されました。この機能により、JVM が突然終了した場合でも、シャットダウン時にユーザークリーンアップコード (データベース接続のクローズなど) を実行できるようになりました。
.LP
-Sun JVM 激違ｃｃJVM 医幻腟篋激ｃ潟絎茖障JVM SIGHUPSIGINT SIGTERM 篏睡激ｃ潟絎茵紮障
+Sun の JVM は、シグナルをキャッチすることによって、JVM の異常終了のためのシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、および SIGTERM を使用して、シャットダウンフックの実行を開始します。
.LP
-JVM 違с鴻鴻帥潟1.2 罘純絎憗罕罘罕篏睡障Sun JVM 鴻潟絎茵 SIGQUIT 篏睡障
+JVM は、デバッグの目的でスレッドスタックをダンプするという、1.2 より前からある機能を実現するためにも、同様の機構を使用します。Sun の JVM は、スレッドダンプを実行するために SIGQUIT を使用します。
.LP
-JVM 莨若с≪宴若激с潟 SIGINT SIGTERM 激違紫綽荀JVM 激違潟冴醇с障\f3\-Xrs\fP 潟潟茵激с潟篏睡馹絲上с障Sun JVM 絲障 \f3\-Xrs\fP 篏睡SIGINTSIGTERMSIGHUP SIGQUIT 絲障激違鴻 JVM ｃ紊眼激違絲障激違潟ゃ潟鴻若障
+JVM を埋め込んでいるアプリケーションが SIGINT や SIGTERM などのシグナルを頻繁にトラップする必要があると、JVM そのもののシグナルハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fP コマンド行オプションを使用すると、この問題に対処できます。Sun の JVM に対して \f3\-Xrs\fP を使用すると、SIGINT、SIGTERM、SIGHUP、および SIGQUIT に対するシグナルマスクは JVM によって変更されず、これらのシグナルに対するシグナルハンドラはインストールされません。
.LP
-\f3\-Xrs\fP 絎翫罨＜ 2 ゃ綵演帥障
+\f3\-Xrs\fP を指定した場合、次の 2 つの影響があります。
.RS 3
.TP 2
o
-SIGQUIT 鴻潟с
+SIGQUIT によるスレッドダンプを利用できない
.TP 2
o
-激ｃ潟絎茵JVM 腟篋鴻 System.exit() 若喝冴若吟若潟若眼ц綽荀
+シャットダウンフック処理の実行は、JVM が終了しようとしている時点で System.exit() を呼び出すなどして、ユーザーコード側で行う必要がある
.RE
.TP 3
\-Xssn
-鴻鴻帥泣ゃ冴荐絎障
+スレッドのスタックサイズを設定します。
.TP 3
\-XX:+UseAltSigs
-VM с \f2SIGUSR1\fP \f2SIGUSR2\fP 篏睡障\f2SIGUSR1\fP \f2SIGUSR2\fP 激違ｉ≪宴若激с潟 腴九翫障\f2\-XX:+UseAltSigs\fP 激с潟VM \f2SIGUSR1\fP \f2SIGUSR2\fP 篁ュ激違篏睡障
+VM ではデフォルトで \f2SIGUSR1\fP および \f2SIGUSR2\fP を使用しますが、\f2SIGUSR1\fP および \f2SIGUSR2\fP をシグナル連鎖するアプリケーションと 競合する場合があります。\f2\-XX:+UseAltSigs\fP オプションは、VM にデフォルトとして \f2SIGUSR1\fP と \f2SIGUSR2\fP 以外のシグナルを使用させます。
.RE
.LP
-.RE
-.SH "羈"
+.SH "注"
+.LP
.LP
-
+\f3\-version:\fP\f2release\fP コマンド行オプションでは、どんなに複雑にリリースを指定してもかまいません。ただし、現実的なリリース指定の限られたサブセットを使用するだけでも適切なポリシーを表現できるため、それらのサブセットのみが完全にサポートされます。それらのポリシーを次に示します。
.LP
-\f3\-version:\fP\f2release\fP 潟潟茵激с潟с茲若鴻絎障障憜若号絎泣祉篏睡с激若茵憗с泣祉帥絎泣若障激若罨＜腓冴障
.RS 3
.TP 3
1.
-篁紙若吾с潟 激с潟篏睡ц；憗с障
+任意のバージョン。これは、このオプションを使用しないことで表現できます。
.TP 3
2.
-劫若吾с ID 紊с篁紙若吾с潟 罨＜箴腓冴障
+ある特定のバージョン ID よりも大きい任意のバージョン。次に例を示します。
.nf
\f3
.fl
-"1.5.0_03+"
+"1.6.0_10+"
.fl
\fP
.fi
-.LP
-翫1.5.0_03 紊с篁紙若吾с潟篏睡障 絎若吾с潟х劫ゃ潟帥с若鴻絨ャ (違篆罩ｃ) 翫箴水с
+この場合、 \f21.6.0_10\fP よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。
.TP 3
3.
-劫若吾с ID 紊с若吾с潟 若鴻＜筝ｃ狗箴腓冴障
+ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。
.nf
\f3
.fl
-"1.5.0_03+&1.5*"
+"1.6.0_10+&1.6*"
.fl
\fP
.fi
.TP 3
4.
-筝 2 障 3 OR茵憗箴腓冴障
+上の項目 2 と項目 3 の「OR」式。次に例を示します。
.nf
\f3
.fl
-"1.4.2_05+&1.4* 1.5+"
+"1.6.0_10+&1.6* 1.7+"
.fl
\fP
.fi
- 2 篌若障紊眼劫若 (1.5) уャ紊眼篁ュ若鴻≪若с純ｃ翫箴水с
+これは項目 2 に似ていますが、ある変更が特定のリリース (1.7) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。
.RE
.LP
-.SH "∫ｉ"
+.SH "終了ステータス"
+.LP
+.LP
+一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいは Java 仮想マシンから例外がスローされた場合です。ただし Java アプリケーションは、API 呼び出し \f2System.exit(exitValue)\fP を使用して任意の値を返すことを選択することもできます。
.LP
+.RS 3
+.TP 2
+o
+\f20\fP: 正常終了
+.TP 2
+o
+\f2>0\fP: エラーが発生した
+.RE
.LP
+.SH "関連項目"
+.LP
.RS 3
.TP 2
o
@@ -484,19 +488,19 @@
.TP 2
o
.na
-\f2Java ≦宍罘純若若\fP @
+\f2「Java 拡張機能フレームワーク」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.TP 2
o
.na
-\f2祉ャｃ若\fP @
+\f2「セキュリティー」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
.TP 2
o
.na
-\f2HotSpot VM Specific Options\fP @
+\f2「HotSpot VM Specific Options」\fP @
.fi
http://java.sun.com/docs/hotspot/VMOptions.html
.RE
--- a/jdk/src/linux/doc/man/ja/javac.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javac.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,325 +19,423 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javac 1 "02 Jun 2010"
+.TH javac 1 "14 Apr 2011"
.LP
-.SH ""
-javac \- Java 違潟域茯潟潟ゃ
+.SH "名前"
+javac \- Java プログラミング言語コンパイラ
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-潟潟茵綣違＜ゃ
+コマンド行引数ファイル
.TP 2
o
-羈
+注釈処理
.TP 2
o
-罎膣
+型の検索
.TP 2
o
-違ｃゃ潟帥с若
+プログラマティックインタフェース
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
\fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]
.fl
-
+
.fl
.fi
.LP
.LP
-綣違筝с
-.LP
-.RS 3
-
+引数は順不同です。
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
sourcefiles
-潟潟ゃ 1 や札筝純若鴻＜ゃ (MyClass.java )
+コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
.TP 3
classes
-羈絲乗院 1 や札筝 (MyPackage.MyClass )
+注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)
.TP 3
@argfiles
-激с潟純若鴻＜ゃ 1 や札筝＜ゃ＜ゃ筝с\f2\-J\fP 激с潟絎с障
+オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では \f2\-J\fP オプションは指定できません。
.RE
.LP
-.RE
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javac\fP 若Java 違潟域茯ц菴違鴻ゃ潟帥с若鴻絎臂茯水ゃ潟若鴻＜ゃ潟潟ゃ障障Java 純若鴻＜ゃ潟劫羈茵障
+\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
.LP
.LP
-純若鴻潟若＜ゃ \f3javac\fP 羝＜罨＜ 2 ゃ号障
+ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
.LP
.RS 3
.TP 2
o
-純若鴻＜ゃ違絨翫＜ゃ潟潟茵х贋･絎障
+ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
.TP 2
o
-純若鴻＜ゃ違紊翫＜ゃ腥榊純障壕у阪ｃ1 ゃ＜ゃ障罨＜鴻＜ゃ \f3@\fP 篁\f3javac\fP 潟潟茵ф絎障
+ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
.RE
.LP
.LP
-純若鴻潟若＜ゃ \f2.java\fP ≦宍絖鴻＜ゃ \f2.class\fP ≦宍絖ｃ違障 障純若鴻＜ゃ鴻＜ゃ＜荅峨鴻絲上若ｃ違障違\f2MyClass\fP 鴻\f2MyClass.java\fP 純若鴻＜ゃ荐菴違障 純若鴻＜ゃ\f2MyClass.class\fP ゃ潟若鴻＜ゃ潟潟ゃ障
+ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、 \f2MyClass\fP という名前のクラスは、 \f2MyClass.java\fP という名前のソースファイルに記述します。このソースファイルは、 \f2MyClass.class\fP という名前のバイトコードクラスファイルにコンパイルされます。
.LP
.LP
-鴻絎臂菴遵鴻＜ゃ障鴻＜ゃ\f2MyClass$MyInnerClass.class\fP 紊劫劫腟水障
+内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、 \f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
.LP
.LP
-純若鴻＜ゃ宴若吾若ｃ若臀綽荀障違鴻純若鴻＜ゃ \f3/workspace\fP 臀翫\f2com.mysoft.mypack.MyClass\fP 純若鴻潟若 \f3/workspace/com/mysoft/mypack/MyClass.java\fP 綽荀障
+ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、 \f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
.LP
.LP
-с潟潟ゃ鴻＜ゃ絲上純若鴻＜ゃｃ臀障ャ阪ｃ絎\f3\-d\fP 篏睡障 (激с潟)
+デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとのオプションを参照)。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-潟潟ゃ憜榊医с泣若絨ャ若鴻с泣若罔羣激с潟祉障篁ュ罔羣激с潟憜篁潟激潟潟潟潟ゃ絎茖堺激с潟с絨ャ紊眼醇с障罔羣激с潟\f3\-X\fP у障障
+コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
.LP
.SS
-罔羣激с
-.LP
-.RS 3
-
+標準オプション
.LP
.RS 3
.TP 3
\-Akey[=value]
-羈祉泣羝＜激с潟javac ｃ贋･茹ｉ祉泣ｃ篏睡障 \f2key\fP 1 ゃ障茲違茘ュ.у阪ｃ絎
+注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
.TP 3
-\-cp path 障 \-classpath path
-若吟若鴻＜ゃ (翫ｃ) 羈祉泣純若鴻＜ゃ罎膣√贋絎障鴻鴻 \f3CLASSPATH\fP 医紊違若吟若鴻鴻若若ゃ障\f3CLASSPATH\fP\f3\-cp\fP\f3\-classpath\fP 絎翫若吟若鴻鴻憜ｃ障荅括完
-.na
-\f2鴻鴻荐絎\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+\-cp path または \-classpath path
+ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、「クラスパスの設定」を参照してください。
.LP
-\f3\-sourcepath\fP 激с潟絎翫純若鴻＜ゃ若吟若鴻鴻罎膣≪障
+\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
.LP
-\f3\-processorpath\fP 激с潟絎翫羈祉泣若吟若鴻鴻罎膣≪障
+\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障
-.br
-.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障\f3羈:\fP潟潟茵医罕ｃ\f2javac \-cp "*.jar" MyClass.java\fP ゃ若絖綣膃у蚊障違翫障
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます。
+.LP
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。 \f2*\fP だけから成るクラスパスエントリは、現在のディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。\f3注:\fP コマンド行環境の構成によっては、 \f2javac \-cp "*.jar" MyClass.java\fP などのように、ワイルドカード文字を引用符で囲むことが必要な場合もあります。
.TP 3
\-Djava.ext.dirs=directories
-ゃ潟鴻若≦宍罘純篏臀若若ゃ障
+インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-Djava.endorsed.dirs=directories
-粋罔羣鴻篏臀若若ゃ障
+承認された標準パスの位置をオーバーライドします。
.TP 3
\-d directory
-鴻＜ゃ阪ｃ荐絎障ｃс絖綽荀障 \f3javac\fP ｃ篏障鴻宴若吾筝с翫\f3javac\fP 綽荀綽ｃ篏宴若後泣ｃ鴻＜ゃ臀障違\f3\-d /home/myclasses\fP 絎鴻 \f2com.mypackage.MyClass\fP с翫鴻＜ゃ \f2/home/myclasses/com/mypackage/MyClass.class\fP 障
+クラスファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
.LP
-\f3\-d\fP 絎ｃ翫\f3javac\fP 鴻＜ゃ純若鴻＜ゃｃ主障
+\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
.LP
-\f3羈:\fP\f3\-d\fP ф絎ｃ若吟若鴻鴻菴遵障
+\f3注:\fP \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
.TP 3
\-deprecation
-ｨ絅＜潟若鴻篏睡障若若ゃ潟茯茵腓冴障\f3\-deprecation\fP 絎翫\f3javac\fP ｨ絅＜潟若鴻篏睡障若若ゃ純若鴻＜ゃ荀膣茵腓冴障\f3\-deprecation\fP \f3\-Xlint:deprecation\fP ヨ；荐с
+推奨されないメンバーやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバーやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
.TP 3
\-encoding encoding
-純若鴻＜ゃ潟潟若ｃ潟医 (\f2EUC\-JP\fP \f2UTF\-8\fP ) 絎障\f3\-encoding\fP 絎翫若潟潟若帥篏帥障
+ソースファイルのエンコーディング名 ( \f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
+.TP 3
+\-endorseddirs directories
+承認された標準パスの位置をオーバーライドします。
+.TP 3
+\-extdirs directories
+\f2ext\fP ディレクトリの位置をオーバーライドします。\f2directories\fP 変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。見つかったすべての JAR アーカイブは自動的にクラスパスの一部になります。
+.LP
+クロスコンパイル (異なる Java プラットフォームに実装されたブートストラップクラスや拡張機能クラスに対してコンパイルを行う) を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細は、「クロスコンパイルオプション」を参照してください。
.TP 3
\-g
-絮紊違鴻井宴障с茵垩潟純若鴻＜ゃ宴障
+局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
.TP 3
\-g:none
-井宴障
+デバッグ情報を生成しません。
.TP 3
\-g:{keyword list}
-潟潟у阪若若鴻絎劫腮蕁井宴障罨＜若若鴻с
+コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
.RS 3
.TP 3
source
-純若鴻＜ゃ井
+ソースファイルのデバッグ情報
.TP 3
lines
-茵垩井
+行番号のデバッグ情報
.TP 3
vars
-絮紊違井
+局所変数のデバッグ情報
.RE
.TP 3
\-help
-罔羣激с潟綵√茵腓冴障
+標準オプションの形式を表示します。
.TP 3
\-implicit:{class,none}
-藥若純若鴻＜ゃ絲障鴻＜ゃ九勝障鴻＜ゃ\f3\-implicit:class\fP 篏睡障鴻＜ゃ吟\f3\-implicit:none\fP 篏睡障 激с潟絎ｃ翫篏鴻＜ゃ障翫鴻＜ゃ羈絎茵潟潟ゃ茘肴障 激с潟腓榊荐絎翫茘肴障 罎膣≪с
+暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。
+.TP 3
+\-Joption
+\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
+.LP
+\f3注:\fP \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものではありません。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
.TP 3
\-nowarn
-茘＜祉若吾≦鴻障 \f3\-Xlint:none\fP 潟с
+警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
.TP 3
\-proc: {none,only}
-羈潟潟ゃ筝≧鴻絎茵九勝障\f3\-proc:none\fP 羈с潟潟ゃ絎茵潟障\f3\-proc:only\fP 羈絎茵緇膓潟潟ゃ障ｃ鎘茵潟障
+注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
.TP 3
\-processor class1[,class2,class3...]
-絎茵羈祉泣絎翫罎膣√ャ障
+実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
.TP 3
\-processorpath path
-羈祉泣罎膣√贋絎障 激с潟篏睡ｃ翫鴻劫с祉泣罎膣≪茵障
+注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
.TP 3
\-s dir
-純若鴻＜ゃ主ｃ絎障ｃс絖綽荀障 \f3javac\fP 篏障鴻宴若吾筝ｃ翫潟潟ゃ純若鴻＜ゃ宴若後泣ｃ主障 綽荀綽ｃ篏障違若吟若 \f3\-s /home/mysrc\fP 絎鴻 \f2com.mypackage.MyClass\fP сｃ翫純若鴻＜ゃ \f2/home/mysrc/com/mypackage/MyClass.java\fP 主障
+生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
.TP 3
\-source release
-篁純若鴻潟若若吾с潟絎障\f2release\fP 罨＜ゃ絎с障
+受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
.RS 3
.TP 3
1.3
-潟潟ゃсJDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
+このコンパイラでは、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
.TP 3
1.4
-JDK 1.4 уャ≪泣若激с潟潟若篁障
+JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
.TP 3
1.5
-JDK 5 уャ膩霡違割荐茯罘純潟若篁障
+JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。
.TP 3
5
-1.5 臂с
+1.5 と同義です。
.TP 3
1.6
-ゃсJava SE 6 с荐茯絲障紊眼絨ャ障с純若鴻＜ゃ潟潟若ｃ潟違若篁ュ茘с若怨障
+これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
.TP 3
6
-1.6 臂с
+1.6 と同義です。
+.TP 3
+1.7
+JDK 7 で導入された機能を含むコードを受け付けます。
+.TP 3
+7
+1.7 と同義です。
.RE
.TP 3
\-sourcepath sourcepath
-鴻障ゃ潟帥с若鴻絎臂罎膣≪純若鴻潟若鴻絎障若吟若鴻鴻罕純若鴻鴻茲違潟潟 (\f3:\fP) у阪障 純若鴻鴻潟ｃJAR ≪若ゃ障 ZIP ≪若ゃ絎с障宴若吾篏帥ｃ翫ｃ障≪若ゃ若劫宴若後違障
+クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
.LP
-\f3羈:\fP\ 鴻鴻鴻с純若鴻荀ゃｃ翫鴻潟潟ゃ絲乗院障罎膣≪с
+\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
.TP 3
\-verbose
-荅括完阪茵腓冴障若鴻潟潟潟ゃ純若鴻＜ゃ宴阪障
+詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
+.TP 3
+\-version
+バージョン情報を出力します。
+.TP 3
+\-Werror
+警告が発生した場合にコンパイルを終了します。
.TP 3
\-X
-罔羣激с潟≪宴茵腓冴腟篋障
+非標準オプションに関する情報を表示して終了します。
.RE
.LP
-.RE
.SS
-鴻潟潟ゃ激с
-.LP
-.RS 3
-
+クロスコンパイルオプション
.LP
.LP
-с鴻潟潟ゃ\f3javac\fP 羞私若若鴻鴻恰≦宍罘純鴻絲障茵障\f3javac\fP 違 Java 若絎茖若鴻鴻恰≦宍罘純鴻絲障潟潟ゃ茵鴻潟潟ゃ泣若障鴻潟潟ゃ茵翫\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥荀с 鴻潟潟ゃ箴с
+デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。
.LP
.RS 3
.TP 3
\-target version
-絎若吾с潟 VM 帥若蚊鴻＜ゃ障鴻＜ゃ絎帥若蚊篁ラ若吾с潟с篏障若吾с潟 VM с篏障鴻帥若蚊\f31.1\fP\f31.2\fP\f31.3\fP\f31.4\fP\f31.5\fP (\f35\fP ) \f31.6\fP (\f36\fP ) с
+指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、\f31.6\fP (\f36\fP も可)、および \f31.7\fP (\f37\fP も可) です。
.LP
-\f3\-target\fP 罨＜ \f3\-source\fP ゃｃ羆冴障障
+\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
.RS 3
.TP 2
o
-\-source \f3絎ｃ\fP翫\-target ゃ \f31.6\fP 障
+\-source が\f3指定されなかった\fP場合、\-target の値は \f31.7\fP になります。
.TP 2
o
-\-source \f31.2\fP 翫\-target ゃ \f31.4\fP 障
+\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
-\-source \f31.3\fP 翫\-target ゃ \f31.4\fP 障
+\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
-\-source \f3篁ュゃ翫鴻\fP\\\-target ゃ \f3\-source\fP ゃ障
+\-source が\f3それ以外の値の場合はすべて\fP、\f3\\\-target\fP の値は \f3\-source\fP の値になります。
.RE
.TP 3
\-bootclasspath bootclasspath
-絎筝ｃ若鴻絲障鴻潟潟ゃ茵障若吟若鴻鴻罕若鴻鴻茲違潟潟 (\f3:\fP) у阪障 若鴻鴻潟ｃJAR ≪若ゃ障 ZIP ≪若ゃ絎с障
-.TP 3
-\-extdirs directories
-絎≦宍罘純ｃ絲障鴻潟潟ゃ茵障\f2directories\fP 潟潟у阪ｃｃ鴻絎障絎ｃ JAR ≪若ゃ鴻＜ゃ罎膣≪障
+指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
.RE
.LP
-.RE
.SS
-罔羣激с
-.LP
-.RS 3
-
+非標準オプション
.LP
.RS 3
.TP 3
\-Xbootclasspath/p:path
-若鴻鴻鴻菴遵障
+ブートストラップクラスパスの前に追加します。
.TP 3
\-Xbootclasspath/a:path
-若鴻鴻鴻緇菴遵障
+ブートストラップクラスパスの後ろに追加します。
.TP 3
\-Xbootclasspath/:path
-若鴻鴻＜ゃ篏臀若若ゃ障
+ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-Xlint
-ｨ絅鴻茘鴻障若鴻с純鴻茘ｨ絅障
+推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。
+.TP 3
+\-Xlint:all
+推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。
.TP 3
\-Xlint:none
-Java 荐茯篁罕с絎鴻茘≦鴻障
+Java 言語仕様では指定されていないすべての警告を無効にします。
+.TP 3
+\-Xlint:name
+警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。
.TP 3
\-Xlint:\-name
-茘 \f2name\fP ≦鴻障 \f2name\fP \f3\-Xlint:\fP\f2name\fP 篏睡с茘障 茘罨＜с
+警告 \f2name\fP を無効にします。このオプションで無効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。
+.TP 3
+\-Xmaxerrs number
+印刷するエラーの最大数を設定します。
.TP 3
-\-Xlint:unchecked
-Java 荐茯篁罕ф絎罎糸茘荅括完腓冴障
+\-Xmaxwarns number
+印刷する警告の最大数を設定します。
.TP 3
-\-Xlint:path
-絖 (classpathsourcepath ) ｃゃ茘障
+\-Xstdout filename
+コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
.TP 3
-\-Xlint:serial
-\f2serialVersionUID\fP 絎臂翫純鴻茘障
+\-Xprefer:{newer,source}
+ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。SOURCE の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fP \f2を使用してください\fP。
+.TP 3
+\-Xpkginfo:{always,legacy,nonempty}
+パッケージ情報ファイルの処理を指定します。
.TP 3
-\-Xlint:finally
-罩ｅ幻絎篋с \f2finally\fP 膀ゃ茘障
+\-Xprint
+指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
.TP 3
-\-Xlint:fallthrough
-fall\-through 宴若鴻 \f2switch\fP с罎冴絲障茘＜祉若吾茵腓冴障Fall\-through 宴若鴻\f2switch\fP 緇宴若鴻ゃ宴若鴻с 潟若 \f2break\fP 障障 潟若絎茵宴若鴻罨＜宴若鴻悟Щ障違 \f2switch\fP \f2case 1\fP 膓潟若\f2break\fP хｃ障
-.RS 3
+\-XprintProcessorInfo
+ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
+.TP 3
+\-XprintRounds
+初回および後続の注釈処理ラウンドに関する情報を出力します。
+.RE
.LP
+.SS
+\-Xlint オプションを使って有効または無効にできる警告
+.LP
+.LP
+\f3\-Xlint:\fP\f2name\fP オプションを使って警告 \f2name\fP を有効にします。ただし、\f2name\fP は次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fP オプションを使って警告 \f2name\fP を無効にできます。
+.LP
+.RS 3
+.TP 3
+cast
+不要で冗長なキャストについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+String s = (String)"Hello!"
+.fl
+\fP
+.fi
+.TP 3
+classfile
+クラスファイルの内容に関連した問題について警告します。
+.TP 3
+deprecation
+非推奨項目の使用について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ java.util.Date myDate = new java.util.Date();
+.fl
+ int currentDay = myDate.getDay();
+.fl
+\fP
+.fi
+.LP
+メソッド \f2java.util.Date.getDay\fP は JDK 1.1 以降は推奨されていません。
+.TP 3
+dep\-ann
+\f2@deprecated\fP Javadoc コメントでドキュメント化されているが、 \f2@Deprecated\fP 注釈が付いていない項目について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ /**
+.fl
+ * @deprecated As of Java SE 7, replaced by {@link #newMethod()}
+.fl
+ */
+.fl
+
+.fl
+ public static void deprecatedMethood() { }
+.fl
+
+.fl
+ public static void newMethod() { }
+.fl
+\fP
+.fi
+.TP 3
+divzero
+一定の整数 0 で除算されることについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+ int divideByZero = 42 / 0;
+.fl
+\fP
+.fi
+.TP 3
+empty
+\f2if\fP 文以降が空の文であることについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+class E {
+.fl
+ void m() {
+.fl
+ if (true) ;
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.TP 3
+fallthrough
+fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
.nf
\f3
.fl
@@ -347,7 +445,7 @@
.fl
System.out.println("1");
.fl
- // No break; statement here.
+ // No break statement here.
.fl
case 2:
.fl
@@ -355,96 +453,375 @@
.fl
}
.fl
-
+\fP
+.fi
+.LP
+このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
+.TP 3
+finally
+正常に完了できない \f2finally\fP 節について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ public static int m() {
+.fl
+ try {
+.fl
+ throw new NullPointerException();
+.fl
+ } catch (NullPointerException e) {
+.fl
+ System.err.println("Caught NullPointerException.");
+.fl
+ return 1;
+.fl
+ } finally {
+.fl
+ return 0;
+.fl
+ }
+.fl
+ }
+.fl
+\fP
+.fi
+.LP
+この例では、コンパイラは \f2finally\fP ブロックに関する警告を生成します。このメソッドが呼び出されると、値 1 ではなく \f20\fP が \f2返されます\fP。 \f2finally\fP ブロックは、 \f2try\fP ブロックが終了すると必ず実行されます。この例では、制御が \f2catch\fP に移された場合、メソッドは終了します。ただし、 \f2finally\fP ブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。
+.TP 3
+options
+コマンド行オプションの使用に関する問題について警告します。この種の警告の例については、「クロスコンパイルの例」を参照してください。
+.TP 3
+overrides
+メソッドのオーバーライドに関する問題について警告します。たとえば、次の 2 つのクラスがあるとします。
+.nf
+\f3
+.fl
+public class ClassWithVarargsMethod {
+.fl
+ void varargsMethod(String... s) { }
+.fl
+}
+.fl
+\fP
+.fi
+.nf
+\f3
+.fl
+public class ClassWithOverridingMethod extends ClassWithVarargsMethod {
+.fl
+ @Override
+.fl
+ void varargsMethod(String[] s) { }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次のような警告を生成します。
+.nf
+\f3
+.fl
+warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod overrides varargsMethod(String...) in ClassWithVarargsMethod; overriding method is missing '...'
+.fl
+\fP
+.fi
+.LP
+コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。メソッド \f2ClassWithVarargsMethod.varargsMethod\fP では、コンパイラは varargs の仮パラメータ \f2String... s\fP を仮パラメータ \f2String[] s\fP に変換します。String[] s は、メソッド \f2ClassWithOverridingMethod.varargsMethod\fP の仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。
+.TP 3
+path
+コマンド行での無効なパス要素と存在しないパスディレクトリについて警告します (クラスパス、ソースパスなどのパス関連)。このような警告を \f2@SuppressWarnings\fP 注釈で抑制することはできません。次に例を示します。
+.nf
+\f3
+.fl
+javac \-Xlint:path \-classpath /nonexistentpath Example.java
+.fl
+\fP
+.fi
+.TP 3
+processing
+注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでその型の例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。
+.LP
+\f3ソースファイル \fP\f4AnnoProc.java\fP:
+.nf
+\f3
+.fl
+import java.util.*;
+.fl
+import javax.annotation.processing.*;
+.fl
+import javax.lang.model.*;
+.fl
+import javax.lang.model.element.*;
+.fl
+
+.fl
+@SupportedAnnotationTypes("NotAnno")
+.fl
+public class AnnoProc extends AbstractProcessor {
+.fl
+ public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv) {
+.fl
+ return true;
+.fl
+ }
+.fl
+
+.fl
+ public SourceVersion getSupportedSourceVersion() {
+.fl
+ return SourceVersion.latest();
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+\f3ソースファイル \fP\f4AnnosWithoutProcessors.java\fP\f3:\fP
+.nf
+\f3
+.fl
+@interface Anno { }
+.fl
+
+.fl
+@Anno
+.fl
+class AnnosWithoutProcessors { }
+.fl
+\fP
+.fi
+.LP
+次のコマンドは、注釈プロセッサ \f2AnnoProc\fP をコンパイルし、この注釈プロセッサをソースファイル \f2AnnosWithoutProcessors.java\fP に対して実行します。
+.nf
+\f3
+.fl
+% javac AnnoProc.java
+.fl
+% javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java
+.fl
+\fP
+.fi
+.LP
+コンパイラがソースファイル \f2AnnosWithoutProcessors.java\fP に対して注釈プロセッサを実行すると、次の警告が生成されます。
+.nf
+\f3
+.fl
+warning: [processing] No processor claimed any of these annotations: Anno
.fl
\fP
.fi
-.RE
-潟若潟潟ゃ \f2\-Xlint:fallthrough\fP 違篏睡翫潟潟ゃ 綵荅蚊宴若鴻茵垩fall\-through 宴若鴻醇с腓冴茘肴障
+.LP
+この問題を解決するには、クラス \f2AnnosWithoutProcessors\fP で定義および使用される注釈の名前を \f2Anno\fP から \f2NotAnno\fP に変更します。
.TP 3
-\-Xmaxerrs number
-医激若紊ф違荐絎障
+rawtypes
+raw 型に対する未検査操作について警告します。特にこのオプションは、型引数を持たないパラメータ化された型を使用するユーザーに対して警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。
+.nf
+\f3
+.fl
+void countElements(List l) { ... }
+.fl
+\fP
+.fi
+.LP
+次の文では、 \f2rawtypes\fP 警告は生成されません。
+.nf
+\f3
+.fl
+void countElements(List<?> l) { ... }
+.fl
+\fP
+.fi
+.LP
+\f2List\fP は raw 型です。ただし、 \f2List<?>\fP はアンバウンド形式のワイルドカードのパラメータ化された型です。 \f2List\fP はパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、 \f2List\fP の仮引数はアンバウンド形式のワイルドカード (\f2?\fP) を使ってその仮型パラメータとして指定されます。つまり、 \f2countElements\fP メソッドは \f2List\fP インタフェースのどのインスタンス化も受け付けることができます。
.TP 3
-\-Xmaxwarns number
-医激茘紊ф違荐絎障
-.TP 3
-\-Xstdout filename
-潟潟ゃ＜祉若吾絎＜ゃ障с潟潟ゃ＜祉若吾 \f2System.err\fP 障
+serial
+直列化可能クラスに \f2serialVersionUID\fP 定義がないことを警告します。次に例を示します。
+.nf
+\f3
+.fl
+public class PersistentTime implements Serializable
+.fl
+{
+.fl
+ private Date time;
+.fl
+
+.fl
+ public PersistentTime() {
+.fl
+ time = Calendar.getInstance().getTime();
+.fl
+ }
+.fl
+
+.fl
+ public Date getTime() {
+.fl
+ return time;
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [serial] serializable class PersistentTime has no definition of serialVersionUID
+.fl
+\fP
+.fi
+.LP
+直列化可能クラスが \f2serialVersionUID\fP という名前のフィールドを明示的に宣言しない場合、直列化ランタイムは「Java オブジェクト直列化仕様」で説明されているように、クラスのさまざまな側面に基づいて、クラスの \f2serialVersionUID\fP のデフォルト値を計算します。ただし、すべての直列化可能クラスが \f2serialVersionUID\fP 値を明示的に宣言することを強くお勧めします。これは、 \f2serialVersionUID\fP 値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、直列化復元中に予期しない \f2InvalidClassExceptions\fP が発生する可能性があるためです。したがって、Java コンパイラの実装が異なっても \f2serialVersionUID\fP 値の一貫性を確保にするには、直列化可能クラスが \f2serialVersionUID\fP 値を明示的に宣言する必要があります。
.TP 3
-\-Xprefer:{newer,source}
-絲障純若鴻＜ゃ鴻＜ゃ筝≧鴻荀ゃｃ翫＜＜ゃ茯水鴻絎障 (罎膣≪)\f2\-Xprefer:newer\fP 篏睡翫絲障純若鴻＜ゃ鴻＜ゃ違鴻茯水障 ()\f2\-Xprefer:source\fP激с潟篏睡翫純若鴻＜ゃ茯水障\f2SOURCE\fP 篆絖激若篏帥ｃ絎ｈ羈篁紙羈祉泣≪祉鴻с翫\f2\-Xprefer:source\fP篏睡
+static
+static の使用に関する問題について警告します。次に例を示します。
+.nf
+\f3
+.fl
+class XLintStatic {
+.fl
+ static void m1() { }
+.fl
+ void m2() { this.m1(); }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [static] static method should be qualified by type name, XLintStatic, instead of by an expression
+.fl
+\fP
+.fi
+.LP
+この問題を解決するために、次のように static メソッド \f2m1\fP を呼び出すことができます。
+.nf
+\f3
+.fl
+XLintStatic.m1();
+.fl
+\fP
+.fi
+.LP
+あるいは、 \f2static\fP キーワードをメソッド \f2m1\fP の宣言から削除することもできます。
.TP 3
-\-Xprint
-絎鴻茵憗亥у阪障 羈潟潟ゃ＜絎茵障阪綵√紊眼醇с障
+try
+try\-with\-resources 文を含む、 \f2try\fP ブロックの使用に関する問題について警告します。たとえば、try 文で宣言されたリソース \f2ac\fP が使用されないために、 \f2次の文に対して警告が\fP 生成されます。
+.nf
+\f3
+.fl
+try ( AutoCloseable ac = getResource() ) {
+.fl
+ // do nothing
+.fl
+}
+.fl
+\fP
+.fi
.TP 3
-\-XprintProcessorInfo
-劫祉泣箴若羈≪宴阪障
+unchecked
+Java 言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。
+.nf
+\f3
+.fl
+ List l = new ArrayList<Number>();
+.fl
+ List<String> ls = l; // unchecked warning
+.fl
+\fP
+.fi
+.LP
+型の消去中に、型 \f2ArrayList<Number>\fP および \f2List<String>\fP はそれぞれ \f2ArrayList\fP および \f2List\fP になります。
+.LP
+変数 \f2ls\fP にはパラメータ化された型 \f2List<String>\fP が指定されています。l によって参照される \f2List\fP \f2が\fP \f2ls\fP に代入されると、コンパイラは未検査警告を生成します。コンパイラは \f2l\fP が \f2List<String>\fP 型を参照するかどうかをコンパイル時に判断できません。また、JVM が実行時にそれを判断できないことも認識しています。l は List<String> 型を参照しません。その結果、ヒープ汚染が発生します。
+.LP
+詳しく説明すると、ヒープ汚染状態が発生するのは、 \f2List\fP オブジェクト \f2l\fP (その static 型は \f2List<Number>\fP) が別の \f2List\fP オブジェクト \f2ls\fP (異なる static 型 \f2List<String>\fP を持つ) に代入される場合です。しかし、コンパイラではこの代入を未だに許可しています。総称をサポートしない Java SE のバージョンとの下位互換性を確保するために、この代入を許可する必要があります。型消去のために、 \f2List<Number>\fP と \f2List<String>\fP は \f2List\fP になります。その結果、コンパイラはオブジェクト \f2l\fP ( \f2List\fP という raw 型を持つ) をオブジェクト \f2ls\fPに代入することを許可します。
.TP 3
-\-XprintRounds
-喝膓羈潟≪宴阪障
+varargs
+可変引数 (varargs) メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。
+.nf
+\f3
+.fl
+public class ArrayBuilder {
+.fl
+ public static <T> void addToList (List<T> listArg, T... elements) {
+.fl
+ for (T x : elements) {
+.fl
+ listArg.add(x);
+.fl
+ }
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは、メソッド \f2ArrayBuilder.addToList\fP の定義に関する次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [varargs] Possible heap pollution from parameterized vararg type T
+.fl
+\fP
+.fi
+.LP
+コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。しかし、Java プログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド \f2ArrayBuilder.addToList\fP では、コンパイラは varargs の仮パラメータ \f2T... elements\fP を仮パラメータ \f2T[] elements\fP(配列) に変換します。しかし、型消去のために、コンパイラは varargs の仮パラメータを \f2Object[] elements\fP に変換します。その結果、ヒープ汚染が発生する可能性があります。
.RE
.LP
-.RE
-.SS
-\-J 激с
+.SH "コマンド行引数ファイル"
.LP
-.RS 3
-
.LP
-.RS 3
-.TP 3
-\-Joption
-\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟 \f3\-X\fP у障ｃ障\f3javac\fP 罔羣激с潟с障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+javac のコマンド行を短くしたり簡潔にしたりするために、 \f2javac\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
.LP
-\f3羈:\fP \ \f3CLASSPATH\fP\f3\-classpath\fP\f3\-bootclasspath\fP \f3\-extdirs\fP \f3javac\fP 絎茵篏帥鴻絎с障号с潟潟ゃ絎茖篏絽吾≧潟с絽吾演冴篌眼障号篏帥綽荀翫\f3\-J\fP 激с潟篏帥ｃ綽荀激с潟緇 \f3java\fP 莎桁若羝＜
-.RE
-
.LP
-.RE
-.SH "潟潟茵綣違＜ゃ"
-.LP
-
+引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
.LP
.LP
-\f2javac\fP 潟潟茵膂≧\f2javac\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝＜ゃ絎с障号篏帥若ｃ潟違激鴻筝с篁紙激 javac 潟潟篏с障
-.LP
-.LP
-綣違＜ゃjavac 激с潟純若鴻＜ゃ宴腟水荐菴違с障＜ゃ綣違鴻若鴻障壕у阪障＜ゃ腥榊純障翫＜ゃ篏篋綣膃у蚊帥障
+引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
.LP
.LP
-綣違＜ゃ＜ゃ憜ｃ荀後障鴻障綣違＜ゃ篏臀荀後障鴻с障綣違＜ゃ＜ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
+javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
+.LP
+.SS
+引数ファイルを 1 つ指定する例
.LP
.LP
-javac 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障javac \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
-.LP
-.SS
-綣違＜ゃ 1 ゆ絎箴
-.LP
-.LP
-\f2argfile\fP 綣違＜ゃ鴻 javac 綣違主翫罨＜絎障
+\f2「argfile」という名前の引数ファイルに\fPすべての javac 引数を格納する場合は、次のように指定します。
.LP
.nf
\f3
.fl
- % \fP\f3javac @argfile\fP
-.fl
-
+% \fP\f3javac @argfile\fP
.fl
.fi
.LP
.LP
-綣違＜ゃ罨＜箴хず 2 ゃ＜ゃ絎鴻筝≧鴻ャс障
+この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
.LP
.SS
-綣違＜ゃ 2 ゆ絎箴
+引数ファイルを 2 つ指定する例
.LP
.LP
-違javac 激с括 1 ＜ゃ純若鴻＜ゃ 1 ＜ゃ2 ゃ綣違＜ゃ篏с障鴻с茵膓膓絖篏睡障
+たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
.LP
.LP
-篁ヤ絎鴻 \f2options\fP ＜ゃ篏障
+以下の内容を含む \f2options\fP というファイルを作成します。
.LP
.nf
\f3
@@ -455,14 +832,14 @@
.fl
\-sourcepath /java/pubs/ws/1.3/src/share/classes
.fl
-
+
.fl
\fP
.fi
.LP
.LP
-篁ヤ絎鴻 \f2classes\fP ＜ゃ篏障
+以下の内容を含む \f2classes\fP というファイルを作成します。
.LP
.nf
\f3
@@ -473,120 +850,104 @@
.fl
MyClass3.java
.fl
-
+
.fl
\fP
.fi
.LP
.LP
-罨＜潟潟篏睡 \f3javac\fP 絎茵障
+次のコマンドを使用して \f3javac\fP を実行します。
.LP
.nf
\f3
.fl
% \fP\f3javac @options @classes\fP
.fl
-
+
.fl
.fi
.LP
.SS
-剛綣違＜ゃ箴
+パス付きの引数ファイルの例
.LP
.LP
-綣違＜ゃ鴻絎с障 ＜ゃ絎＜ゃ憜篏罐ｃ荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
+引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。
.LP
.nf
\f3
.fl
- % \fP\f3javac @path1/options @path2/classes\fP
-.fl
-
+% \fP\f3javac @path1/options @path2/classes\fP
.fl
.fi
.LP
-.SH "羈"
+.SH "注釈処理"
.LP
-
+.LP
+\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
.LP
.LP
-\f3javac\fP 羈贋･泣若腴羈若с \f3apt\fP 篏睡綽荀障
+注釈処理の API は、 \f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
+.LP
+.SS
+注釈処理の概要
.LP
.LP
-羈 API \f2javax.annotation.processing\fP \f2javax.lang.model\fP 宴若吾泣宴若後絎臂障
-.LP
-.SS
-羈网荀
+\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META\-INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
.LP
.LP
-\f3\-proc:none\fP 激с潟ｃ羈≦劫潟潟ゃ篏睡純鴻羈祉泣罎膣≪障罎膣≪鴻 \f3\-processorpath\fP 激с潟篏帥ｃ絎с障 罎膣≪鴻絎ｃ翫若吟若鴻鴻篏睡障祉泣罎膣≪罎膣≪剛
-.br
-\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
-.br
-泣若鴻ゃ罕＜ゃ冴ャ茵障＜ゃ篏睡鴻羈祉泣1 茵 1 ゃゅ障ャ号\f3\-processor\fP 激с潟篏帥ｃ祉泣腓榊絎с障
+コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
.LP
.LP
-潟潟ゃ潟潟茵純若鴻＜ゃ鴻莎井祉с羈絖腆肴腟祉泣絲障茵祉泣羈с腆肴障筝眼荀ゃｃ翫祉泣若喝冴障祉泣荳羈荀羆с障 翫羈絲障ャ祉泣荀ゃ荅帥茵障鴻羈荀羆障潟潟ゃ篁ヤ祉泣罎膣≪茵障
+いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
.LP
.LP
-祉泣ｃ違純若鴻＜ゃ羈 2 潟紮障違鴻純若鴻＜ゃ莎井祉罕羈障篁ュ潟у若喝冴祉泣鴻緇膓潟с若喝冴障違純若鴻＜ゃ障х障
-.LP
-.LP
-潟ф違純若鴻＜ゃｃ翫羈祉泣 1 若喝冴綽荀絎茵罘篌筝障 緇\f3\-proc:only\fP 激с潟篏睡潟潟ゃ純若鴻＜ゃ鴻純若鴻＜ゃ潟潟ゃ障
+あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
.LP
.SS
-藥若純若鴻＜ゃ
+暗黙的にロードされたソースファイル
.LP
.LP
-潟潟ゃ筝ｃ純若鴻＜ゃ潟潟ゃャ純若鴻＜ゃ藥若違翫障 (罎膣≪)＜ゃ憝鴻с羈絲乗院障с羈絎茵ゆ藥若純若鴻＜ゃ 1 ゃс潟潟ゃ翫潟潟ゃ茘肴障茘吟号ゃ\-implicit 激с潟с
+コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードすることが必要な場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
.LP
-.SH "罎膣"
-.LP
-
+.SH "型の検索"
.LP
.LP
-純若鴻＜ゃ潟潟ゃ翫潟潟茵ф絎純若鴻＜ゃ絎臂荀ゃ潟潟ゃ絽吾≪宴綽荀障潟潟ゃ純若鴻＜ゃт戎鴻障ゃ潟帥с若鴻≦宍鴻障ゃ潟帥с若鴻絎茖鴻障ゃ潟帥с若鴻鴻ゃ宴綽荀障純若鴻＜ゃф腓榊荐膓帥宴箴鴻ゃ潟帥с若鴻障障
+ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
.LP
.LP
-違\f3java.applet.Applet\fP 泣鴻翫\f3≪\fP腑刻\f3java.awt.Panel\fP\f3java.awt.Container\fP\f3java.awt.Component\fP\f3java.lang.Object\fP鐚篏睡障
+たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、\f3アプレットの\fP祖先のクラス（\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP）を使用していることになります。
.LP
.LP
-潟潟ゃ宴綽荀絎臂純若鴻＜ゃ障鴻＜ゃ｢障障若鴻鴻≦宍罘純鴻罎膣≪膓若吟若鴻 (с潟ｃ) 罎膣≪障若吟若鴻鴻\f3CLASSPATH\fP 医紊違荐絎絎臂障 \f3\-classpath\fP 潟潟茵激с潟篏帥ｃ荐絎障荅括完
-.na
-\f2鴻鴻荐絎\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、「クラスパスの設定」を参照してください。
.LP
.LP
-\-sourcepath 激с潟絎翫潟潟ゃ絎鴻純若鴻＜ゃ罎膣≪障 篁ュ翫若吟若鴻鴻鴻＜ゃ純若鴻＜ゃ筝≧鴻罎膣≪障
+\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
.LP
.LP
-\f3\-bootclasspath\fP 激с潟 \f3\-extdirs\fP 激с潟篏帥ャ若鴻鴻≦宍罘純鴻絎с障 鴻潟潟ゃ激с潟с
+\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。このあとの「クロスコンパイルオプション」を参照してください。
.LP
.LP
-罎膣≪緇腟鴻＜ゃ純若鴻＜ゃ障筝≧鴻с翫障筝≧鴻荀ゃｃ翫＜篏睡鴻 \-Xprefer 激с潟с潟潟ゃ腓冴с障\f3newer\fP 絎翫潟潟ゃ 2 ゃ＜ゃ違鴻篏睡障\f3source\fP 絎翫潟潟ゃ純若鴻＜ゃ篏睡障 \f3newer\fP с
+型の検索に成功したときに得られる結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
.LP
.LP
-罎膣∵篏ｃ障 \f3\-Xprefer\fP 荐絎腟綽荀純若鴻＜ゃ荀ゃｃ翫潟潟ゃ純若鴻＜ゃ茯水綽荀宴緇障潟潟ゃс純若鴻＜ゃ潟潟ゃ茵障\-implicit 激с潟篏帥違篏絎с障\f3none\fP 絎翫純若鴻＜ゃ鴻＜ゃ障\f3class\fP 絎翫純若鴻＜ゃ鴻＜ゃ障
+型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
.LP
.LP
-潟潟ゃ羈絎篋緇宴綽荀с茯茘翫障宴純若鴻＜ゃ荀ゃ \f3\-implicit\fP 激с潟絎翫＜ゃ羈絲乗院潟潟ゃ潟潟ゃ若吟若茘障茘≦鴻(＜ゃ羈絲乗院) ＜ゃ潟潟茵絎純若鴻＜ゃ絲障鴻＜ゃ鴻 \f3\-implicit\fP 激с潟篏帥ｃ絎障
+コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識しない場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
.LP
-.SH "違ｃゃ潟帥с若"
-.LP
-
+.SH "プログラマティックインタフェース"
.LP
.LP
-\f3javac\fP \f2javax.tools\fP 宴若後鴻ゃ潟帥с若鴻ｃ絎臂違 Java Compiler API 泣若障
+\f3javac\fP は、 \f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
.LP
.SS
-箴
+例
.LP
.LP
-潟潟茵絎綣違篏帥ｃ潟潟ゃ絎茵罨＜潟若篏睡障
+コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
.LP
.nf
\f3
@@ -595,29 +956,24 @@
.fl
int rc = javac.run(null, null, null, args);
.fl
-
-.fl
\fP
.fi
.LP
.LP
-翫罔羣阪鴻若鴻荐堺＜祉若吾吾冴潟潟茵若喝冴 \f3javac\fP 菴腟篋潟若菴障
+この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
.LP
.LP
-\f2javax.tools.JavaCompiler\fP ゃ潟帥с若剛祉＜純篏帥違荐堺＜祉若吾＜ゃ茯水/吾莨若水九勝茵障
+\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
.LP
.SS
-уゃ潟帥с若
-.LP
-.RS 3
-
+旧式のインタフェース
.LP
.LP
-\f3羈:\fP \ API 筝篏篋с腆坂罧障 違潟若с綽菴違 Java Compiler API 篏睡
+\f3注:\fP この API は、下位互換性を確保するためだけに残されています。新しいコードでは、必ず前述の Java Compiler API を使用してください。
.LP
.LP
-\f2com.sun.tools.javac.Main\fP 鴻違潟潟ゃ若喝冴 static ＜純 2 ょ障 罨＜腓冴障
+\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。それらを次に示します。
.LP
.nf
\f3
@@ -626,38 +982,29 @@
.fl
public static int compile(String[] args, PrintWriter out);
.fl
-
-.fl
\fP
.fi
.LP
.LP
-\f2args\fP ＜若帥javac 違絽御検篁紙潟潟茵綣違茵障 网荀ゃ冴綵√膀с
+\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。その概要については、前出の「形式」節を参照してください。
.LP
.LP
-\f2out\fP ＜若帥潟潟ゃ荐堺＜祉若吾阪腓冴障
+\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
.LP
.LP
-祉ゃ\f3javac\fP 腟篋ゃс
+戻り値は、\f3javac\fP の終了値と同じです。
.LP
.LP
- \f2com.sun.tools.javac\fP у障宴若 (綣 \f2com.sun.tools.javac\fP 泣宴若吾ャ) 障\f3篁\fP鴻＜純絎сゃс紊眼醇с障
+名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
.LP
-.RE
-.SH "箴"
+.SH "例"
.LP
.SS
-膂≦違潟潟ゃ
-.LP
-.RS 3
-
+簡単なプログラムのコンパイル
.LP
.LP
-\f2Hello.java\fP 純若鴻＜ゃс\f3greetings.Hello\fP 鴻絎臂障\f2greetings\fP ｃ純若鴻＜ゃ鴻＜ゃ筝≧鴻宴若吾ｃс憜ｃ筝障箴с若吟若鴻鴻篏睡с障障\f3\-d\fP 篏帥ｃャ阪ｃ絎綽荀障
-.LP
-.RS 3
-
+\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。 \f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
.LP
.nf
\f3
@@ -704,24 +1051,14 @@
.fl
Hello Everyone
.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-茲違純若鴻＜ゃ潟潟ゃ
-.LP
-.RS 3
-
+複数のソースファイルのコンパイル
.LP
.LP
-罨＜箴с宴若 \f2greetings\fP 鴻純若鴻＜ゃ潟潟ゃ障
-.LP
-.RS 3
-
+次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
.LP
.nf
\f3
@@ -742,26 +1079,14 @@
.fl
Aloha.java GutenTag.java Hello.java Hi.java
.fl
-
-.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-若吟若鴻鴻絎
-.LP
-.RS 3
-
+ユーザークラスパスの指定
.LP
.LP
-筝箴純若鴻＜ゃ 1 ゃ紊眼紊翫＜ゃ潟潟ゃ障
-.LP
-.RS 3
-
+上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
.LP
.nf
\f3
@@ -772,34 +1097,22 @@
.fl
% \f3javac greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f2greetings.Hi\fP \f2greetings\fP 宴若後祉鴻с潟潟ゃ鴻｢綽荀障筝箴с若吟若鴻鴻宴若吾ｃｃс潟潟ゃ罩ｅ幻絎茵障憜ｃ≫＜ゃ潟潟ゃ翫若吟若鴻鴻 \f2/examples\fP 菴遵綽荀障若吟若鴻鴻潟菴遵\f3CLASSPATH\fP 荐絎号障с \f3\-classpath\fP 激с潟篏帥障
-.LP
-.RS 3
-
+\f2greetings.Hi\fP は、 \f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
.LP
.nf
\f3
.fl
% \fP\f3javac \-classpath /examples /examples/greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-綺 \f2greetings.Hi\fP 紊眼若若ｃｃ若篏帥翫若若ｃｃ若若吟若鴻鴻≪祉鴻сｃ綽荀障
-.LP
-.RS 3
-
+再度 \f2greetings.Hi\fP を変更してバナーユーティリティーを使うようにした場合は、このバナーユーティリティーもユーザークラスパスを通じてアクセスできるようになっている必要があります。
.LP
.nf
\f3
@@ -808,41 +1121,25 @@
.fl
/examples/greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f2greetings\fP 鴻絎茵\f2greetings\fP \f2greetings\fP 篏帥鴻筝≧鴻≪祉鴻с綽荀障
-.LP
-.RS 3
-
+\f2greetings\fP 内のクラスを実行するには、 \f2greetings\fP と、それが使うクラスの両方にアクセスできる必要があります。
.LP
.nf
\f3
.fl
% \fP\f3java \-classpath /examples:/lib/Banners.jar greetings.Hi\fP
.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-純若鴻＜ゃ鴻＜ゃ
-.LP
-.RS 3
-
+ソースファイルとクラスファイルの分離
.LP
.LP
-鴻紊ц閞＜吾с翫純若鴻＜ゃ鴻＜ゃャｃ臀箴水障鴻＜ゃ阪ャ絎\f3\-d\fP 篏帥障純若鴻＜ゃ若吟若鴻鴻с\f3\-sourcepath\fP 篏帥ｃ潟潟ゃ純若鴻＜ゃ荀ゃс障
-.LP
-.RS 3
-
+特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
.LP
.nf
\f3
@@ -877,83 +1174,78 @@
.fl
Base.class GoodBye.class
.fl
-
-.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f3羈:\fP \ 潟潟茵с \f2src/farewells/Base.java\fP 絎障＜ゃ潟潟ゃｃ潟潟ゃ障潟潟ゃｈ\f3\-verbose\fP 激с潟篏帥障
+\f3注:\fP コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
.LP
-.RE
.SS
-鴻潟潟ゃ箴
-.LP
-.RS 3
-
+クロスコンパイルの例
.LP
.LP
-с\f3javac\fP 篏帥ｃ1.5 VM 筝у茵潟若潟潟ゃ障
-.LP
-.RS 3
-
+ここでは、\f3javac\fP を使って、1.6 VM 上で実行するコードをコンパイルします。
.LP
.nf
\f3
.fl
-% \fP\f3javac \-target 1.5 \-bootclasspath jdk1.5.0/lib/rt.jar \\
+% \fP\f3javac \-source 1.6 \-target 1.6 \-bootclasspath jdk1.6.0/lib/rt.jar \\
.fl
\-extdirs "" OldCode.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f3\-target 1.5\fP 激с潟1.5 VM 篋с鴻＜ゃ障с\f3javac\fP JDK 6 潟潟ゃ障
+\f2\-source 1.6\fP オプションにより、 \f2OldCode.java\fP のコンパイルにはバージョン 1.6 (または 6) の Java プログラミング言語が使用されます。\f3\-target 1.6\fP オプションにより、1.6 VM と互換性のあるクラスファイルが生成されます。ほとんどの場合、\f3\-target\fP オプションの値は \f3\-source\fP オプションの値になります。この例では、\f3\-target\fP オプションを省略できます。
.LP
.LP
-Java 若 JDK \f3javac\fP сJava 2 SDK 若鴻鴻絲障潟潟ゃ茵сJava 2 SDK с JDK 1.5 若鴻鴻絲障潟潟ゃ茵絎綽荀障\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥ｃ絎障絎茵1.5 VM 絖 Java 2 若 API 絲上潟潟ゃ茵違絎茵絎潟榊障
+\f3\-bootclasspath\fP オプションを使用して、適切なバージョンのブートストラップクラス ( \f2rt.jar\fP ライブラリ) を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。
.LP
-.RE
-.SH "∫ｉ"
+.nf
+\f3
+.fl
+% \fP\f3javac \-source 1.6 OldCode.java\fP
+.fl
+warning: [options] bootstrap class path not set in conjunction with \-source 1.6
+.fl
+.fi
+
.LP
-
+.LP
+適切なバージョンのブートストラップクラスを指定しない場合、コンパイラは古い言語仕様 (この例では、バージョン 1.6 の Java プログラミング言語) を新しいブートストラップクラスと組み合わせて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラスファイルが古いプラットフォーム (この場合は Java SE 6) で動作しない可能性があります。
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2The javac Guide\fP @
+\f2「The javac Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jdb(1) \- Java
+「jdb(1) \- Java デバッガ」
.TP 2
o
-javah(1) \- C 若鴻帥＜ゃ吾с若帥
+「javah(1) \- C ヘッダーとスタブファイルジェネレータ」
.TP 2
o
-javap(1) \- 鴻＜ゃ≪祉潟
+「javap(1) \- クラスファイル逆アセンブラ」
.TP 2
o
-javadoc(1) \- Java API ャ＜潟吾с若帥
+「javadoc(1) \- Java API ドキュメントジェネレータ」
.TP 2
o
-jar(1) \- JAR ≪若ゃ若
+「jar(1) \- JAR アーカイブツール」
.TP 2
o
.na
-\f2Java ≦宍罘純若若\fP @
+\f2「Java 拡張機能フレームワーク」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.RE
--- a/jdk/src/linux/doc/man/ja/javadoc.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javadoc.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,328 +19,244 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javadoc 1 "02 Jun 2010"
-.SH ""
-javadoc \- Java API ャ＜潟吾с若
-.RS 3
-
-.LP
-.LP
-Java 純若鴻＜ゃAPI ャ＜潟 HTML 若吾障ャ＜潟х換篁 Javadoc 箴Sun Solaris 篏睡翫с
-.LP
-.RE
-.SH "綵√"
-.LP
+.TH javadoc 1 "14 Apr 2011"
+.SH "名前"
+javadoc \- Java API ドキュメントジェネレータ
+.LP
+Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、 Solaris を使用した場合のものです。
+.SH "形式"
.LP
\f4javadoc\fP\f2\ [\ \fP\f2options\fP\f2\ ]\ [\ packagenames\ ]\ [\ sourcefilenames\ ]\ [\ \-subpackages\fP\ \f2pkg1:pkg2:...\fP\f2\ ]\ [\ \fP\f2@argfiles\fP\f2\ ]\fP
.LP
-.LP
-綣違絎綺篁紙сJavadoc 若с絲乗院 \f2.java\fP ＜ゃ羆阪号荅括完ゃ純若鴻＜ゃс
-.LP
-.RS 3
-
-.LP
+引数を指定する順序は任意です。Javadoc ツールでの、処理対象の .java ファイルを決定する方法の詳細については、「ソースファイルの処理」\f2を参照\fPしてください。
.RS 3
.TP 3
options
-ャ＜潟ц潟潟茵激с潟сJavadoc 激с潟罔羣篏睡羈ゃ篏睡箴с
+このドキュメントで説明されているコマンド行オプションです。Javadoc オプションの標準的な使用法については、「使用例」を参照してください。
.TP 3
packagenames
-鴻若鴻у阪筝ｃ宴若後с 違\f2java.lang\ java.lang.reflect\ java.awt\fP 絎障ャ＜潟宴若吾ャ絎綽荀障ゃ若篏睡筝с 絽亥\-subpackages 篏睡障Javadoc 若\f2\-sourcepath\fP 篏帥ｃ宴若後罎膣≪障1 や札筝宴若吾ャ＜潟箴с
+スペースで区切られた一連のパッケージ名です。たとえば、 \f2java.lang\ java.lang.reflect\ java.awt のように指定します\fP。ドキュメント化するパッケージを個別に指定する必要があります。ワイルドカードは使用不可です。再帰的処理のためには、\-subpackages を使用します。Javadoc ツールは、\f2\-sourcepath\fP を使用してこれらのパッケージ名を検索します。「1 つ以上のパッケージのドキュメント化」の例を参照してください。
.TP 3
sourcefilenames
-鴻若鴻у阪筝ｃ純若鴻＜ゃс＜ゃ鴻у障障≪鴻帥鴻 (*) ゃ若с障 Javadoc 若＜ゃ.java≦宍絖х≦宍絖ゃ絎鴻劫с鴻＜ゃс (
+スペースで区切られた一連のソースファイル名です。 各ファイルは、パスで始まります。アスタリスク (*) などのワイルドカードを含めることができます。Javadoc ツールが処理するのは、ファイル名が「.java」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです (
.na
-\f2Identifiers\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)ｃゃ潟 (\f2X\-Buffer\fP ) 篁≦鴻絖篁ｃ＜ゃャ＜潟絲乗院ゅс障鴻＜ゃ潟若＜ゃ翫箴水с 純若鴻＜ゃ絎鴻ｃjavadoc ＜ゃ罎膣≪贋羆冴障障Javadoc 若純若鴻＜ゃ罎膣≪ \f2\-sourcepath\fP 篏帥障後障鴻憜ｃ後障鴻с \f2Button.java\fP 羝＜\f2./Button.java\fP 羝＜с純若鴻＜ゃ鴻ф絎\f2/home/src/java/awt/Graphics*.java\fP 障1 や札筝鴻ャ＜潟箴с障宴若吾鴻ャ＜潟箴宴若後純若鴻＜ゃ羞桁с障
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)。したがって、ハイフンを含む名前 ( \f2X\-Buffer\fP など) や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。ソースファイル名の前に指定したパスによって、javadoc がそのファイルを検索する場所が決まります。Javadoc ツールは、これらのソースファイル名を検索するときには \f2\-sourcepath\fP を使用しません。相対パスは現在のディレクトリを起点とするため、 \f2Button.java\fP を渡すことは、 \f2./Button.java\fP を渡すことと同じです。ソースファイル名をフルパスで指定すると、 \f2/home/src/java/awt/Graphics*.java のようになります\fP。 「1 つ以上のクラスのドキュメント化」の例を参照してください。また、「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。
.TP 3
\-subpackages pkg1:pkg2:...
-純若鴻＜ゃ絎宴若吾潟泣宴若後絽亥ャ＜潟障宴若後障純若鴻＜ゃ絎綽荀障
+ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。パッケージ名またはソースファイル名を指定する必要はありません。
.TP 3
@argfiles
-Javadoc 激с潟宴若後潟純若鴻＜ゃ篁紙綺т研鴻鴻障 1 や札筝＜ゃс＜ゃ筝сゃ若 (*) \f2\-J\fP 激с潟絎с障
-.RE
-
-.LP
+Javadoc オプション、パッケージ名、およびソースファイル名を任意の順序で並べたリストが含まれる 1 つ以上のファイルです。ワイルドカード (*) や \f2\-J\fP オプションは、このファイルの中では指定できません。
.RE
-.SH " 茯"
-.LP
-.LP
-\f3Javadoc\fP 若筝ｃ Java 純若鴻＜ゃ絎ｈ潟ャ＜潟若激с潟潟＜潟茹ｆс public 鴻protected 鴻ャ絖 (水鴻ゃ)ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ゃ茯筝ｃ HTML 若吾障障API (≪宴若激с潟違潟違ゃ潟帥с若) ャ＜潟筝ｃ純若鴻＜ゃ絎茖ャ＜潟篏睡с障
-.LP
-.LP
-Javadoc 若宴若後篏純若鴻＜ゃ障筝≧鴻絲障絎茵с障javadoc 若宴若後篏絲障絎茵翫筝篏ｃ絽亥 \f2\-subpackages\fP 篏睡宴若後腓榊鴻羝＜障純若鴻＜ゃ絲障 javadoc 絎茵翫筝ｃ純若 (\f2.java\fP) ＜ゃ羝＜障隙箴ャ＜潟緇膣剛障罨＜Javadoc 純若鴻＜ゃゃ茯障
-.LP
+.SH " 説明"
+.LP
+\f3Javadoc\fP ツールは、一連の Java ソースファイルにある宣言およびドキュメンテーションコメントを解析し、デフォルトでは public クラス、protected クラス、入れ子にされたクラス (匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。
+.LP
+Javadoc ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fP を使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々ソースファイルに対して javadoc を実行する場合は、一連のソース (.\f2.java\fP) ファイル名を渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadoc によるソースファイルの処理について説明します。
.SS
-純若鴻＜ゃ
-.LP
-.LP
-Javadoc 若絨障 \f2.java\fP 篁＜ゃ篁ュ純若鴻＜ゃц篁＜ゃ障純若鴻＜ゃ腓榊羝＜ｃ Javadoc 若絎茵翫 \f2.java\fP ＜ゃ罩ｇ∈絎с障紊肴号с篏罐障 宴若後羝＜祉膂≦с純若鴻＜ゃ腓榊絎Javadoc 若 3 ゃ号у茵с障号(1) 宴若後羝＜(2) \f2\-subpackages\fP 篏睡(3) 純若鴻＜ゃゃ若篏睡 (\f2*.java\fP) 号с号篏睡翫Javadoc 若\f2.java\fP ＜ゃ罨＜鴻荀篁吟羣翫＜ゃ障
-.LP
+ソースファイルの処理
+.LP
+Javadoc ツールは、末尾が「\f2.java\fP」のファイルを処理するだけでなく、「ソースファイル」で説明するその他のファイルも処理します。個々のソースファイル名を明示的に渡すことによって Javadoc ツールを実行する場合、どの \f2.java\fP ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソースファイル名を明示的に指定しなくても、Javadoc ツールは 3 つの方法で実行できます。その方法とは、(1) パッケージ名を渡す、(2) \f2\-subpackages\fP を使用する、(3) ソースファイル名でワイルドカードを使用する (\f2*.java\fP)、の 3 つです。これらの場合、Javadoc ツールが「\f2.java\fP」ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合だけです。
.RS 3
.TP 2
o
- \f2.java\fP ･絨乗ゃ絎鴻劫ｃ (鴻絖ゃ
+名前から接尾辞「\f2.java\fP」を取り除くと実際に有効なクラス名になっている (有効な文字については
.na
-\f2Identifiers\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)
.TP 2
o
-純若鴻若若後丞ｃ鴻阪絖紊絎鴻宴若後ｃ
+ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている
.TP 2
o
-宴若御鴻宴若後障 (ф絎)
+パッケージ文には有効なパッケージ名が含まれる (前項目で指定)
.RE
-
-.LP
-.LP
-\f3潟\fP \- Javadoc 若絎茵筝絎茵сャ＜潟宴若吾鴻潟＜潟若絲障娯с潟菴遵障潟罨＜贋菴遵障
-.LP
+.LP
+\f3リンクの処理\fP \- Javadoc ツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。
.RS 3
.TP 2
o
-絎ｈ (祉ゃ綣違ｃ若)
+宣言 (戻り値の型、引数の型、フィールドの型)
.TP 2
o
-\f2@see\fP 帥違 [∫ｉ] 祉激с
+\f2@see\fP タグから生成された [関連項目] セクション
.TP 2
o
-\f2{@link}\fP 帥違ゃ潟ゃ潟鴻
+\f2{@link}\fP タグから生成されたインラインテキスト
.TP 2
o
-\f2@throws\fP 帥違箴紊
+\f2@throws\fP タグから生成された例外の名前
.TP 2
o
-"ゃ潟帥с若鴻＜潟若絲障 [絎臂] 潟鴻＜潟若絲障 [若若ゃ] 潟
+インタフェースのメンバーに対する「定義」リンクと、クラスのメンバーに対する「オーバーライド」リンク
.TP 2
o
-宴若吾鴻潟＜潟若网荀若
+パッケージ、クラス、およびメンバーを列挙している概要テーブル
.TP 2
o
-宴若吾潟鴻膓帥
+パッケージおよびクラスの継承ツリー
.TP 2
o
-膣√
+索引
.RE
-
-.LP
-.LP
-潟潟茵ф絎ｃ鴻ゃ√鴻 (ャ鴻) 絲障ゃ若潟菴遵\f2\-link\fP \f2\-linkoffline\fP 激с潟с障
-.LP
-.LP
-\f3篁ゃ荅括完\fP \- Javadoc 若絎茵潟 1 ゃ絎ャ＜潟篏障 ャ＜潟菴遵с障 ゃ障Javadoc 若篁ュ絎茵腟篆罩ｃ絎鴻贋･腟水ャс障菴違篁ュ絎茵腟絲障潟菴遵с障
-.LP
-.LP
-絎茖筝宴Javadoc 若絎茵 java 潟潟ゃ綽荀java 潟潟ゃ箴絖障Javadoc 若 \f2javac\fP 筝若喝冴絎ｈ潟潟ゃ＜潟若絎茖∴障Javadoc 若拷絮ゃ鴻莟絲茵憗鴻篏睡≫罕膀宴 HTML 障Javadoc 若純若鴻潟若ャ＜潟若激с潟潟＜潟若吟若箴ャ＜潟緇障
-.LP
-.LP
-Javadoc 若＜純篏膣膕鴻帥＜ゃс \f2.java\fP 純若鴻＜ゃ絲障絎茵с障ｃAPI 篏絎茖荐菴違荐荐罧級сャ＜潟若激с潟潟＜潟荐菴違 javadoc 若絎茵с障
-.LP
-.LP
-潟潟ゃ箴絖ｃHTML 阪絎絎茖罩ｇ∈絲上障 絎絎茖腓榊純若鴻潟若с藥純若鴻潟若箴絖翫障違Javadoc 若\f2.class\fP ＜ゃ絖純若鴻潟若絖
+.LP
+コマンド行で指定しなかったクラスについての既存のテキスト (別に生成したテキスト) に対してハイパーリンクを追加するには、\f2\-link\fP および \f2\-linkoffline\fP オプションを利用できます。
+.LP
+\f3その他の処理についての詳細\fP \- Javadoc ツールは、実行するたびに 1 つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadoc ツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。ただし、前述のように、以前の実行結果に対してリンクを追加することはできます。
+.LP
+実装上の理由から、Javadoc ツールは、処理を実行するために java コンパイラを必要とし、java コンパイラに依存しています。Javadoc ツールは、 \f2javac\fP の一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。Javadoc ツールは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報から HTML を生成します。さらに、Javadoc ツールは、ソースコードのドキュメンテーションコメントから、ユーザーの提供したドキュメントも取得します。
+.LP
+実際には、Javadoc ツールは、メソッド本体を持たない純粋なスタブファイルであるような \f2.java\fP ソースファイルでも動作します。したがって、API の作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーションコメントを記述して javadoc ツールを実行できます。
+.LP
+コンパイラに依存することによって、HTML 出力は、実際の実装に正確に対応します。実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。たとえば、Javadoc ツールは、.class ファイルには存在するがソースコードには存在しない
.na
-\f2潟潟鴻\fP @
+\f2デフォルトコンストラクタ\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 荐茯篁罕祉激с 8.6.7) ャ＜潟障
-.LP
-.LP
-絽吾Javadoc 若с純若鴻＜ゃ潟若筝絎障若с翫сャ＜潟с障違激ャ若ｃ潟違絎篋ャ＜潟с障違Java 荐茯篁罕処院＜純鴻篏処院絎ｈ違障若罎冴javac 潟潟ゃ罩≪障Javadoc 若茘冴膓茵障Javadoc 若ャ＜潟若激с潟潟＜潟堺с茵障ャ＜潟若激с潟潟＜潟荅潟с綽荀翫DocCheck 篏睡
-.LP
-.LP
-Javadoc 若ャ＜潟罕罕膀с鴻鴻若障Javadoc 若若鴻鴻≦宍罘純障若吟若鴻鴻с鴻罎膣≪с違障荅括完
+http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 言語仕様のセクション 8.6.7) \f2をドキュメント化\fP します。
+.LP
+通常、Javadoc ツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、Java 言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。このエラーを検出すると、javac コンパイラは停止しますが、Javadoc ツールは警告を出さずに処理を続行します。Javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、DocCheck ドックレットを使用してください。
+.LP
+Javadoc ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadoc ツールは、ブートストラップクラス、拡張機能、またはユーザークラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、
.na
-\f2鴻罎膣∽号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlс絽吾篏鴻≦宍罘純若Javadoc 若鴻劫臀鏆荀障
-.LP
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadoc ツールのクラスパス内に置く必要があります。
.SS
-Javadoc
-.LP
-.LP
-Javadoc 若阪絎鴻綵√篏帥ｃ鴻帥ゃ冴с障Javadoc 若罔羣若違腟粋昭帥障 罔羣HTML 綵√ API ャ＜潟障罔羣篆罩ｃ障泣劫HTMLXMLMIFRTF 絅純帥阪綵√荐菴違純с篏睡羈ゃ罨＜с
-.LP
+Javadoc のドックレット
+.LP
+Javadoc ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadoc ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。標準ドックレットは、HTML 形式の API ドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTF などの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。
.RS 3
.TP 2
o
.na
-\f2Javadoc \fP @
+\f2Javadoc のドックレット\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
.TP 2
o
-\f2\-doclet\fP 潟潟茵激с
+\f2\-doclet\fP コマンド行オプション
.RE
-
-.LP
-.LP
-\f2\-doclet\fP 潟潟茵激с潟с鴻帥絎翫Javadoc 若罔羣篏睡障javadoc 若篏睡≫鋎睡с潟潟茵激с潟障罔羣с祉ゃ潟潟茵激с潟菴遵障＜激с潟ゃ激с潟ц障
-.LP
+.LP
+\f2\-doclet\fP コマンド行オプションでカスタムドックレットが指定されていない場合、Javadoc ツールは、デフォルトの標準ドックレットを使用します。javadoc ツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。
.SS
-∫ｃャ＜潟潟
-.LP
+関連ドキュメントおよびドックレット
.RS 3
.TP 2
o
.na
-\f2Javadoc 純罘遵七\fP @
+\f2Javadoc に施された拡張機能\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc ц申壕鴻荅括完
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc 1.4 で追加された改良点の詳細
.TP 2
o
.na
\f2Javadoc FAQ\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html \- 紫絲莖絲障膈Javadoc ∫ｃ若ゃ宴潟違炊号
+http://java.sun.com/j2se/javadoc/faq/index.html \- 頻繁に寄せられる質問に対する回答、Javadoc 関連のツールについての情報、およびバグの回避方法
.TP 2
o
.na
\f2How to Write Doc Comments for Javadoc\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ャ＜潟若激с潟潟＜潟荐菴井号≪ Sun 荀靘
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ドキュメンテーションコメントの記述方法に関する Sun の規約
.TP 2
o
.na
\f2Requirements for Writing API Specifications\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java 2 若篁罕荐菴違篏睡罔羣荀篁吟宴純若鴻＜ゃャ＜潟若激с潟潟＜潟綵√ API 篁罕荐菴違翫篁綵√ц菴違翫綵合＜障罎荐弱純≪泣若激с潟羣宴若吾鴻ゃ潟帥с若鴻ｃ若潟＜純ゃ荀篁吟絎障
+http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java SE プラットフォーム仕様を記述する際に使用された標準要件この情報は、ソースファイルのドキュメンテーションコメント形式で API 仕様を記述する場合にも、その他の形式で記述する場合にも役立ちます。検証可能なアサーションを満たすパッケージ、クラス、インタフェース、フィールド、およびメソッドについての要件を定めています。
.TP 2
o
.na
-\f2ャ＜潟若激с潟潟＜潟篁罕\fP @
+\f2ドキュメンテーションコメントの仕様\fP @
.fi
-http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ャ＜潟若激с潟潟＜潟吾篁罕ゃJava Language Specification (James GoslingBill JoyGuy Steele 沿) 膃 18 腴Documentation Commentsс腴膃 2 сゃ障
+http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ドキュメンテーションコメントのオリジナル仕様については、『Java Language Specification』 (James Gosling、Bill Joy、Guy Steele 共著) の初版の第 18 章「Documentation Comments」を参照してください。この章は、第 2 版では削除されました。
.TP 2
o
.na
-\f2DocCheck \fP @
+\f2DocCheck ドックレット\fP @
.fi
-http://java.sun.com/javadoc/doccheck \- 純若鴻＜ゃャ＜潟若激с潟潟＜潟с罎冴若筝罩ｃ若障Sun Doc Check 若ｃｃ若筝сSun Doc Check 若ｃｃ若筝с
+http://java.sun.com/javadoc/doccheck \- ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Check ユーティリティーの一部です。
.TP 2
o
.na
-\f2MIF \fP @
+\f2MIF ドックレット\fP @
.fi
-http://java.sun.com/javadoc/mifdoclet \- MIFFrameMakerPDF 後 API ャ＜潟障MIF Adobe FrameMaker 篋ゆ後с
+http://java.sun.com/javadoc/mifdoclet \- MIF、FrameMaker、PDF の書式で API ドキュメントを自動生成します。MIF は Adobe FrameMaker の交換書式です。
.RE
-
-.LP
.SS
-茯
-.LP
-.LP
-\f2ャ＜潟若激с潟潟＜潟\fP\f2doc 潟＜潟\fP\f2筝肢\fP\f2帥違\fP\f2帥違\fP\f2ゃ潟ゃ潟帥違\fP茯ゃャ＜潟若激с潟潟＜潟ц障罨＜篁茯Javadoc 若潟潟鴻х劫潟＜障
-.LP
+用語
+.LP
+\f2「ドキュメンテーションコメント」\fP、\f2「doc コメント」\fP、\f2「主説明」\fP、\f2「タグ」\fP、\f2「ブロックタグ」\fP、および\f2「インラインタグ」\fPの用語については、「ドキュメンテーションコメント」で説明します以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。
.RS 3
.TP 3
-ャ＜潟 (generated document)
-javadoc 若 Java 純若鴻潟若ャ＜潟若激с潟潟＜潟ャ＜潟сャ＜潟 HTML 綵√с罔羣ｃ篏障
+生成ドキュメント (generated document)
+javadoc ツールが Java ソースコード内のドキュメンテーションコメントから生成したドキュメントのことです。デフォルトの生成ドキュメントは HTML 形式で、標準ドックレットによって作成されます。
.LP
.TP 3
- (name)
-Java 荐茯ф吾違荀膣ゃ障宴若吾鴻ゃ潟帥с若鴻ｃ若潟潟鴻帥障＜純с\f2java.lang.String.equals(java.lang.Object)\fP 絎篆蕋障\f2equals(Object)\fP 篆蕋障с障
+名前 (name)
+Java 言語で書かれたプログラム要素の名前、つまりパッケージ、クラス、インタフェース、フィールド、コンストラクタ、またはメソッドの名前のことです。名前は、 \f2java.lang.String.equals(java.lang.Object)\fP のような完全修飾名にすることも、 \f2equals(Object)\fP のような部分修飾名にすることもできます。
.LP
.TP 3
-ャ＜潟 (documented classes)
-javadoc 若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻сャ＜潟純若鴻＜ゃ篏睡純с違純若鴻＜ゃ障宴若後 javadoc 潟潟羝＜≪祉剛信蕋上 (publicprotectedpackage\-private 障 private) ｃｃ水違障ャ＜潟鴻javadoc 若阪腟粋昭障鴻ゃ障鴻若違障
+ドキュメント化されるクラス (documented classes)
+javadoc ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。ドキュメント化するには、ソースファイルが使用可能でなければならず、ソースファイル名またはパッケージ名を javadoc コマンドに渡され、アクセス修飾子 (public、protected、package\-private または private) によってフィルタ処理されないようにしなければなりません。ドキュメント化されるクラスは、javadoc ツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。
.LP
.TP 3
- (included classes)
-若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻сャ＜潟鴻
+包含クラス (included classes)
+ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」と同じ。
.LP
.TP 3
-ゅ (excluded classes)
-若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻с
+除外クラス (excluded classes)
+ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。
.LP
.TP 3
-с (referenced classes)
-ャ＜潟鴻潟ゃ潟帥с若鴻絎臂 (絎茖) 障ャ＜潟若激с潟潟＜潟筝ф腓榊с鴻潟ゃ潟帥с若鴻сс箴祉ゃ＜若帥ｃ鴻≦宍鴻絎茖ゃ潟帥с若鴻ゃ潟若鴻＜純篏т戎鴻@see{@link}{@linkplain}{@inheritDoc} 帥違障絎臂
+参照クラス (referenced classes)
+ドキュメント化されるクラスおよびインタフェースの定義 (実装) またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc} タグなどがあります。この定義は
.na
\f21.3\fP @
.fi
-http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses 紊眼障javadoc 若絎茵Javadoc 若鴻鴻潟鴻劫鴻с鴻＜≪若若綽荀障с鴻荀ゃ翫鴻荀ゃ障茘茵腓冴障Javadoc 若鴻絖＜潟若絎絎ゅャ綽荀鴻宴.class ＜ゃ綣冴с障
+http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses から変更されています。javadoc ツールを実行するときは、Javadoc のブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。Javadoc ツールは、クラスの存在とそのメンバーの完全指定の名前を判別するのに必要なすべての情報を、.class ファイルから引き出すことができます。
.LP
.TP 3
-紊с (external referenced classes)
-с鴻＜javadoc 若絎茵筝ャ＜潟鴻сゃ障鴻潟潟茵 Javadoc 若羝＜障ャ＜潟с鴻潟膊紊с障紊潟若違障違\f2java.awt\fP 宴若吾絲障 Javadoc 若絎茵翫\f2Object\fP \f2java.lang\fP 鴻鴻紊с鴻障紊с鴻潟\f2\-link\fP \f2\-linkoffline\fP 激с潟篏睡障紊с鴻絽吾純若鴻潟＜潟 javadoc 若絎茵ус荀劫彰障翫潟＜潟膓帥с障
+外部参照クラス (external referenced classes)
+参照クラスのうち、javadoc ツールの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンド行で Javadoc ツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。たとえば、Javadoc ツールの実行対象が \f2java.awt\fP パッケージのみである場合、 \f2java.lang\fP 内のすべてのクラス ( \f2Object\fPなど) が外部参照クラスになります。外部参照クラスにリンクするには、 \f2\-link\fP および \f2\-linkoffline\fP オプションを使用します。外部参照クラスには、通常そのソースコメントを javadoc ツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。
.RE
-
-.LP
-.SH "純若鴻＜ゃ"
-.LP
-.LP
-Javadoc 若4 腮蕁違純若鴻＜ゃ阪腟障＜ゃ鴻 Java 荐茯純若鴻＜ゃ (\f2.java\fP)宴若吾潟＜潟＜ゃ网荀潟＜潟＜ゃ潟篁＜ゃс障ャ＜潟純若鴻若絖翫鴻＜ゃ潟若＜ゃゃ茯障
-.LP
+.SH "ソースファイル"
+.LP
+Javadoc ツールは 4 種類の異なる「ソース」ファイルから出力を生成します。その 4 種類とは、クラスの Java 言語ソースファイル (\f2.java\fP)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートファイルについても説明します。
.SS
-鴻純若鴻潟若＜ゃ
-.LP
-.LP
-鴻障ゃ潟帥с若鴻潟＜潟若ャ＜潟若激с潟潟＜潟ゃс \f2.java\fP ＜ゃ篆障ャ＜潟若激с潟潟＜潟荅括完ャ＜潟若激с潟潟＜潟с
-.LP
+クラスソースコードファイル
+.LP
+それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーションコメントを持つことができ、それを \f2.java\fP ファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。
.SS
-宴若吾潟＜潟＜ゃ
-.LP
-.LP
-宴若吾ャ＜潟若激с潟潟＜潟ゃс絨純若鴻＜ゃ篆障 絎鴻Javadoc 若ｃ网荀若吾腟粋昭障障潟＜潟絽吾宴若後篏綵障ャ＜潟荐菴違障
-.LP
-.LP
-宴若吾潟＜潟＜ゃ篏翫潟＜潟主罨＜ 2 ゃ＜ゃ御с障
-.LP
+パッケージコメントファイル
+.LP
+それぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。
+.LP
+パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。
.RS 3
.TP 2
o
-\f2package\-info.java\fP \- 宴若後ｈ宴若御絵宴若吾潟＜潟 Javadoc 帥違主с障＜ゃ JDK 5.0 уャсpackage.html ｨ絅障
+\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは一般に、package.html よりも推奨されます。
.TP 2
o
-\f2package.html\fP \- 主с宴若吾潟＜潟 Javadoc 帥違с 宴若御絵主с障
+\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。
.RE
-
-.LP
-.LP
-宴若吾筝 \f2package.html\fP ＜ゃ筝 \f2package\-info.java\fP ＜ゃゃс障筝≧鴻ゃс障＜＜ゃ \f2.java\fP ＜ゃ純若鴻弱宴若吾ｃ臀
-.LP
-.LP
-\f4package\-info.java\fP \- ＜ゃ罨＜罕宴若吾潟＜潟主с障 潟＜潟宴若後ｈ臀障
-.LP
-.LP
-File:\f2java/applet/package\-info.java\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+各パッケージでは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを選択できますが、その両方を選択することはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。
+.LP
+\f4package\-info.java\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントはパッケージ宣言の前に配置します。
+.LP
+File: \f2java/applet/package\-info.java\fP
.nf
\f3
.fl
/**
.fl
- * Provides the classes necessary to create an
+ * Provides the classes necessary to create an
.fl
* applet and the classes an applet uses
.fl
@@ -372,285 +288,91 @@
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 352 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
-
-.LP
-.LP
-潟＜潟阪絖 \f2/**\fP \f2/*\fP 荐菴違綽荀障筝茵茵≪鴻帥鴻ャ障障
-.LP
-.LP
-\f4package.html\fP \- ＜ゃ罨＜罕宴若吾潟＜潟主с障 潟＜潟 \f2<body>\fP 荀膣臀障
-.LP
-.LP
-File:\f2java/applet/package.html\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+コメント区切り文字の \f2/**\fP と \f2/*\fP は存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。
+.LP
+\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。
+.LP
+File: \f2java/applet/package.html\fP
.nf
\f3
.fl
-<HTML>
-.fl
-<BODY>
-.fl
-Provides the classes necessary to create an applet and the
-.fl
-classes an applet uses to communicate with its applet context.
-.fl
-<p>
+<HTML> <BODY> Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.<p>
.fl
The applet framework involves two entities: the applet
.fl
-and the applet context. An applet is an embeddable
-.fl
-window (see the {@link java.awt.Panel} class) with a
-.fl
-few extra methods that the applet context can use to
-.fl
-initialize, start, and stop the applet.
-.fl
-
-.fl
-@since 1.0
-.fl
-@see java.awt
-.fl
-</BODY>
-.fl
-</HTML>
+and the applet context. An applet is an embeddable window (see the {@link java.awt.Panel} class) with a few extra methods that the applet context can use to initialize, start, and stop the applet.@since 1.0 @see java.awt </BODY> </HTML>
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 405 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-40
-
-.LP
-.LP
-絽吾 HTML ＜ゃс宴若後ｈс鴻羈宴若吾潟＜潟＜ゃ絎鴻祉鴻潟＜潟罕 HTML ц菴違障ャ＜潟若激с潟潟＜潟潟＜潟阪絖с \f2/**\fP \f2*/\fP活≪鴻帥鴻с潟＜潟吾翫宴若吾网荀\f2<body>\fP 帥ゃ篁鴻障宴若吾帥違с障祉ャ＜潟若激с潟潟＜潟罕鴻帥違筝肢臀違障宴若吾潟＜潟＜ゃ \f2@see\fP 帥違菴遵翫絎絎篏睡綽荀障荅括完
+.LP
+これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述しますが、1 つだけ例外があります。それは、このドキュメンテーションコメントには、コメント区切り文字 である \f2/**\fP と \f2*/\fP 、および行頭のアスタリスクを含めてはならない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、 \f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、すべてのブロックタグは、主説明のあとに置かなければなりません。 \f2@see\fP タグをパッケージコメントファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、
.na
-\f2package.html\fP 箴 @
+\f2package.html\fPの例 @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsс
-.LP
-.LP
-\f3宴若吾潟＜潟＜ゃ\fP \- Javadoc 若絎茵宴若吾潟＜潟＜ゃ罎膣≪＜ゃ荀ゃ罨＜茵障
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsを参照してください。
+.LP
+\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。
.RS 3
.TP 2
o
-с潟＜潟潟若 (\f2package.html\fP 翫с違\f2<body>\fP \f2</body>\fP HTML 帥違絎鴻鴻潟若\f2<head>\fP \f2<title>\fP 純若鴻＜ゃ篏罔荐菴違宴臀с緇ャ＜潟若激с潟筝茵腓冴)
+処理できるようにコメントをコピーする( \f2package.html\fP の場合であれば、 \f2<body>\fP と \f2</body>\fP HTML タグの間にある内容をすべてコピーする。 \f2<head>\fP セクションを含め、そこに \f2<title>\fP やソースファイルの著作権記述などの情報を配置することもできるが、生成後のドキュメンテーションにはそれらは一切表示されない)
.TP 2
o
-宴若吾帥違違鴻
+パッケージタグがあれば、すべて処理する
.TP 2
o
-宴若吾网荀若吾緇鴻水ャ (箴:
+生成したパッケージの概要ページの最後に、処理したテキストを挿入する (例:
.na
-\f2宴若吾网荀\fP @
+\f2パッケージの概要\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html)
.TP 2
o
-宴若吾网荀若吾宴若吾潟＜潟潟若网荀若吾宴若吾鴻宴若後宴若吾潟＜潟菴遵 (箴:
+パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例:
.na
-\f2网荀荀膣\fP @
+\f2概要の要約\fP @
.fi
-http://java.sun.com/javase/6/docs/api/overview\-summary.html)絨障鴻＜潟若筝肢絨障荀ｃゆ
+http://java.sun.com/javase/6/docs/api/overview\-summary.html)。文の末尾は、クラスやメンバーの主説明の最初の文の末尾と同じ規則によって判断される
.RE
-
-.LP
.SS
-网荀潟＜潟＜ゃ
-.LP
-.LP
-ャ＜潟≪宴若激с潟障宴若吾祉网荀ャ＜潟若激с潟潟＜潟ゃс絨純若鴻＜ゃ篆障 絎鴻Javadoc 若ｃ网荀若吾腟粋昭障障潟＜潟絽吾≪宴若激с潟障宴若吾祉篏綵障ャ＜潟荐菴違障
-.LP
-.LP
-网荀潟＜潟＜ゃ篏翫＜ゃ篁紙篁篁紙贋臀с障絽吾＜ゃ \f4overview.html\fP 純若鴻若筝篏臀障違\f2java.applet\fP 宴若吾純若鴻＜ゃ \f2/home/user/src/java/applet\fP ｃ障翫\f2/home/user/src/overview.html\fP 网荀潟＜潟＜ゃ篏с障
-.LP
-.LP
-違宴若吾祉絲障 javadoc 茲医絎茵翫 1 ゃ純若鴻＜ゃ祉絲障茲違网荀潟＜潟＜ゃ篏с障違ャ＜潟若激с括 \-private 絎 javadoc 1 絎茵ャ＜潟若激с括激с潟絎у綺絎茵с障翫网荀潟＜潟＜ゃ 1 сャ＜潟若激с潟障荐菴違с障
-.LP
-.LP
-网荀潟＜潟＜ゃ絎鴻菴違宴若吾潟＜潟＜ゃ罕HTML ц菴違 1 ゃ紊сャ＜潟若激с潟潟＜潟с荅括完菴違茯с荀鴻膵違菴潟＜潟荐菴違翫≪宴若激с潟障宴若吾祉荀膣\f2<body>\fP 帥ゃ篁鴻障网荀帥違с障 ャ＜潟若激с潟潟＜潟ゃゃ潟ゃ潟帥 (\f2{@link}\fP ) 篁ュ鴻帥違筝肢臀鏆荀障\f2@see\fP 帥違菴遵翫絎絎篏睡違障
-.LP
-.LP
-Javadoc 若絎茵\-overview 激с潟篏帥ｃ网荀潟＜潟＜ゃ絎障＜ゃ宴若吾潟＜潟＜ゃ障
-.LP
+概要コメントファイル
+.LP
+ドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。
+.LP
+概要コメントファイルを作成するには、ファイルに任意の名前 (通常は \f4overview.html\fP) を付け、それを任意の場所 (通常はソースツリーの最上位) に配置できます。たとえば、 \f2java.applet\fP パッケージのソースファイルが \f2/home/user/src/java/applet\fP ディレクトリに格納されていれば、概要コメントファイルは \f2/home/user/src/overview.html に作成できます\fP。
+.LP
+異なるパッケージのセットに対して javadoc を複数回実行する場合は、同じ 1 つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。たとえば、内部ドキュメンテーション用に \-private を指定して javadoc を 1 回実行したあと、公開ドキュメンテーション用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメントファイルの 1 文目で、そのドキュメンテーションを公開用または内部用として記述できます。
+.LP
+概要コメントファイルの内容は、前述のパッケージコメントファイルと同様、HTML で記述された 1 つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、 \f2<body>\fP と最初の文の間にタイトルその他のテキストを含めないようにします。概要タグを含めることができます。ほかのドキュメンテーションコメントと同じく、 \f2{@link}\fP などのインラインタグを除くすべてのタグは、主説明のあとに配置する必要があります。 \f2@see\fP タグを追加する場合には、完全修飾名を使用する必要があります。
+.LP
+Javadoc ツールの実行時に、\-overview オプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。
.RS 3
.TP 2
o
-\f2<body>\fP 帥違 \f2</body>\fP 帥違鴻絎鴻潟若
+\f2<body>\fP タグと \f2</body>\fP タグの間にあるすべての内容を処理対象としてコピーする
.TP 2
o
-网荀帥違違鴻
+概要タグがあれば、すべて処理する
.TP 2
o
-网荀若吾緇鴻水ャ (箴:
+生成した概要ページの最後に、処理したテキストを挿入する (例:
.na
-\f2网荀荀膣\fP @
+\f2概要の要約\fP @
.fi
http://java.sun.com/javase/6/docs/api/overview\-summary.html)
.TP 2
o
-网荀若吾网荀潟＜潟潟若
+概要ページの先頭に、概要コメントの最初の文をコピーする
.RE
-
-.LP
.SS
-篁＜ゃ
-.LP
-.LP
-純若鴻Javadoc 若ｃｃ潟若篁篁紙＜ゃс障筝＜ゃ違ｃ＜ゃ泣潟 Java 純若 (.java) 潟 (.class) ＜ゃ絎鴻絽吾 Java 純若鴻＜ゃャ＜潟若激с潟潟＜潟綵演帥腴 HTML ＜ゃ障
-.LP
-.LP
-＜ゃ純若鴻＜ゃ \f4doc\-files\fP ｃ臀障 ｃ純若鴻＜ゃ篁紙宴若吾ｃ筝篏с障泣ｃ宴若吾 1 ょс障ゃ＜若吾泣潟潟若純若鴻＜ゃ.class ＜ゃ≪ HTML ＜ゃｃ主с障違帥潟ゃ＜若 \f2button.gif\fP \f2java.awt.Button\fP 鴻ャ＜潟翫＜ゃ \f2/home/user/src/java/awt/doc\-files/\fP ｃ臀障\f2doc\-files\fP ｃ \f2/home/user/src/java/doc\-files\fP 臀с障 \f2java\fP 宴若吾сｃ純若鴻＜ゃャｃс
-.LP
-.LP
-＜ゃ吾潟鴻腓榊荐菴違綽荀障 Javadoc 若＜ゃ荀ｃ絎鴻潟若с違\f2Button.java\fP ャ＜潟若激с潟潟＜潟潟罨＜障
-.LP
+その他の未処理のファイル
+.LP
+ソースには、Javadoc ツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。一般に、このようなファイルには、グラフィックファイル、サンプルの Java ソース (.java) およびクラス (.class) ファイル、内容が通常の Java ソースファイルのドキュメンテーションコメントの影響を受けない独立した HTML ファイルなどがあります。
+.LP
+処理されないファイルを含めるには、\f4doc\-files\fP という名前のディレクトリ内にそれらのファイルを配置します。このディレクトリは、ソースファイルが格納された任意のパッケージディレクトリのサブディレクトリにします。このようなサブディレクトリは、パッケージごとに 1 つ用意できます。イメージ、サンプルコード、ソースファイル、.class ファイル、アプレット、および HTML ファイルをこのディレクトリに格納できます。たとえば、ボタンの画像 \f2button.gif\fP を \f2java.awt.Button\fP クラスのドキュメンテーションに含める場合には、そのファイルを \f2/home/user/src/java/awt/doc\-files/\fP ディレクトリ内に配置します。なお、 \f2doc\-files\fP ディレクトリを \f2/home/user/src/java/doc\-files\fP に配置することはできません。なぜなら、 \f2java\fP はパッケージではないからです。つまり、java に直接含まれているソースファイルは 1 つも存在していません。
+.LP
+これらの未処理のファイルへのリンクは、すべて明示的に記述する必要があります。これは、Javadoc ツールがそれらのファイルを見ずに、単にディレクトリとその内容を生成先にコピーするだけだからです。たとえば、 \f2Button.java\fP のドキュメンテーションコメント内のリンクは、次のようになります。
.nf
\f3
.fl
@@ -664,23 +386,16 @@
.fl
\fP
.fi
-
-.LP
.SS
-鴻＜ゃ潟潟若＜ゃ
-.LP
-.LP
-筝肴鴻＜ゃ潟潟若＜ゃ絲上純若鴻＜ゃ菴純若鴻若篆絖荀障ゃ障純若鴻＜ゃｃ障泣ｃ篆絖с
-.LP
-.LP
-ャ純若鴻＜ゃф腓榊羝＜ Javadoc 若絎茵翫鴻＜ゃ潟潟若＜ゃ括ゅс障宴若後障ゃ若ф検翫篁ヤ若緇ｃ鴻＜ゃ潟潟若＜ゃ綽荀障
-.LP
-.LP
-鴻＜ゃ潟若＜ゃ鴻＜ゃ罩ｅс潟潟ゃ純純若鴻＜ゃс絲障潟若＜ゃс鴻с 潟若＜ゃ.javaхс障
-.LP
-.LP
-\f3鴻＜ゃ\fP \- 肴紊宴若吾潟潟ゃ純у茵純鴻＜ゃ宴若吾純若鴻＜ゃｃ臀障鴻＜ゃ宴若吾純若鴻＜ゃ宴若吾ャ宴若吾絮障 (鴻＜ゃ package 鴻若＜潟障純若鴻ャ package 鴻若＜潟)倶с潟潟茵ф絎純若鴻宴若後絎純若鴻ャ＜潟鴻＜ゃ茘障若綣莎激障鴻＜ゃ泣ｃ臀綽荀障\f2com.package1\fP 菴遵翫鴻＜ゃゃ潟障宴若後≦鴻泣ｃ臀障
-.LP
+テストファイルおよびテンプレートファイル
+.LP
+一部の開発者から、テストファイルおよびテンプレートファイルを対応するソースファイルの近くのソースツリーに保存したいという要望がありました。つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに保存したいということです。
+.LP
+個別のソースファイル名で明示的に渡して Javadoc ツールを実行する場合は、テストファイルおよびテンプレートファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイルおよびテンプレートファイルが処理されないようにする必要があります。
+.LP
+テストファイルとテンプレートファイルの違いは、テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、テンプレートファイルは、そうではないという点です。ただし、テンプレートファイルも「.java」で終わることができます。
+.LP
+\f3テストファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテストファイルをそのパッケージのソースファイルと同じディレクトリに配置したいと考えています。しかしテストファイルは、名前なしパッケージなど、ソースファイルパッケージとは別のパッケージに属させたいとも考えています (そのため、テストファイルには package ステートメントがないか、またはソースとは別の package ステートメントがある)。このような状況では、コマンド行で指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テストファイルは警告またはエラーを引き起こします。そのようなテストファイルはサブディレクトリに配置する必要があります。たとえば、 \f2com.package1\fP 内のソースファイルに対するテストファイルを追加する場合は次のように、ハイフンを含んでいるためにパッケージ名としては無効であるようなサブディレクトリ内に、それらのファイルを配置します。
.nf
\f3
.fl
@@ -688,248 +403,189 @@
.fl
\fP
.fi
-
-.LP
-.LP
-Javadoc 若с茘 test ｃ鴻障
-.LP
-.LP
-鴻＜ゃ doc 潟＜潟障翫罨＜ゃ若鴻純若鴻＜ゃф検鴻＜ゃャ＜潟Javadoc 若ュ絎茵с荐絎с障 違\f2com/package1/test\-files/*.java\fP с
-.LP
-.LP
-\f3純若鴻＜ゃ潟若\fP \- 潟若＜ゃ.javaх障潟若＜ゃ潟潟ゃс障純若鴻ｃ篆純若鴻＜ゃ潟若翫＜ゃゃ (\f2Buffer\-Template.java\fP ) 篁筝罩ｃ Java 絖篏睡障 с障Javadoc 若.java･絨乗ゃ 罩ｈ劫с純若鴻＜ゃсс (
+.LP
+こうすると、Javadoc ツールでは警告なしで test ディレクトリをスキップします。
+.LP
+テストファイルに doc コメントが含まれる場合、次のようにワイルドカードを含んだテストソースファイル名で渡してテストファイルのドキュメントを生成するように、Javadoc ツールを別個に実行できるように設定できます。たとえば、 \f2com/package1/test\-files/*.java などです\fP。
+.LP
+\f3ソースファイルのテンプレート\fP \- テンプレートファイルの名前は「.java」で終わることもありますが、テンプレートファイルはコンパイルできません。ソースディレクトリ内に保持したいソースファイルのテンプレートがある場合は、 \f2Buffer\-Template.java\fP のようにハイフンやその他の無効な Java 文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadoc ツールが処理するのは、「.java」接尾辞を除いた名前が 正規のクラス名であるソースファイルだけであるためです (
.na
-\f2茘ュ\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
-.LP
-.SH "＜ゃ"
-.LP
-.LP
-сjavadoc 若HTML 綵√ャ＜潟罔羣篏帥障篁ヤ腮蕁＜ゃ障 HTML 若吾＜ゃ後障javadoc ＜ゃ鴻ゃ潟帥с若鴻＜с (\f2package\-summary.html\fP ) 2 腮蕁障緇違若＜ゃ違若＜ゃ腴九ゃ潟障障
-.LP
-.LP
-\f3堺絎鴻若\fP
-.LP
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625参照)。
+.SH "生成されるファイル"
+.LP
+デフォルトでは、javadoc ツールは、HTML 形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。それぞれの HTML ページは、個々のファイルに相当します。javadoc が生成するファイルの名前には、クラスやインタフェースの名前にちなんだものと、そうでないもの ( \f2package\-summary.html など\fP) の 2 種類があります。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。
+.LP
+\f3基本内容ページ\fP
.RS 3
.TP 2
o
-ャ＜潟鴻障ゃ潟帥с若鴻 1 ゃ\f3鴻若吾障ゃ潟帥с若鴻若\fP (\f2劫\fP\f2.html\fP)
-.TP 2
-o
-ャ＜潟宴若吾 1 ゃ\f3宴若吾若\fP (\f2package\-summary.html\fP)Javadoc 若純若鴻若宴若吾ｃ \f2package.html\fP 障 \f2package\-info.java\fP ＜ゃ違筝 HTML 鴻若吾腟水ャ障
-.TP 2
-o
-宴若吾祉篏絲障 1 ゃ\f3网荀若\fP (\f2overview\-summary.html\fP)ャ＜潟若吾障Javadoc 若\f2\-overview\fP 激с潟ф絎＜ゃ HTML 鴻若吾腟水ャ障若吾＜ゃjavadoc 茲違宴若後羝＜翫篏障荅括完HTML 若с
-.RE
-
-.LP
-.LP
-\f3娯с若\fP
-.LP
-.RS 3
-.TP 2
-o
-\f3宴若吾祉篏絲障 1 ゃ拷絮ゃ若\fP (\f2overview\-tree.html\fP)若吾茵腓冴蚊若激с潟若 [网荀] [絮ゃ] 障
+ドキュメント化するクラスまたはインタフェースごとに 1 つの\f3クラスページまたはインタフェースページ\fP (\f2クラス名\fP\f2.html\fP)
.TP 2
o
-\f3宴若吾 1 ゃ拷絮ゃ若\fP (\f2package\-tree.html\fP) 劫宴若吾鴻障ゃ潟帥с若鴻若吾茵腓冴[絮ゃ] 宴若吾拷絮ゃ茵腓冴障
-.TP 2
-o
-\f3宴若吾 1 ゃ [篏睡] 若\fP (\f2package\-use.html\fP)\f3鴻潟ゃ潟帥с若鴻 1 ゃゃ [篏睡] 若\fP (\f2class\-use/\fP\f2劫\fP\f2.html\fP)若吾劫鴻ゃ潟帥с若鴻障宴若吾筝篏帥ｃ宴若吾鴻＜純潟潟鴻帥潟ｃ若ゃ荐菴違障鴻障ゃ潟帥с若 A 箴 [篏睡] 若吾A 泣鴻A 絎ｈｃ若A 菴＜純A ＜若帥ゃ＜純潟潟潟鴻帥茵腓冴障 若吾茵腓冴障宴若吾鴻障ゃ潟帥с若鴻若吾腱糸蚊若激с潟若 [篏睡] 潟障
-.TP 2
-o
-\f3ｨ絅 API 若\fP (\f2deprecated\-list.html\fP) ｨ絅鴻筝荀ц；腓冴障ｨ絅筝壕 API 絖篏睡ｨ絅 API с絽吾臀腓冴障ｨ絅 API 絨ャ絎茖сゃ醇с障
+ドキュメント化するパッケージごとに 1 つの\f3パッケージページ\fP (\f2package\-summary.html\fP)。Javadoc ツールは、 \f2package.html\fP または \f2package\-info.java\fP という名前のファイル内の HTML テキストをすべて組み入れます。
.TP 2
o
-\f3絎違ｃ若ゃ若\fP (\f2constant\-values.html\fP) static ｃ若ょс
-.TP 2
-o
-\f3翫若若\fP (\f2serialized\-form.html\fP) 翫喝純鴻с鴻翫ｃ若潟＜純≪茯障宴API 篏帥肴с絎茖茵肴綽荀宴с蚊若激с潟若若吾吾潟障翫鴻腱糸鴻茯 [∫ｉ] 祉激с潟 [翫綵√] 宴緇с障罔羣翫綵√若吾障Serializable 絎茖 public 障 public 鴻腟粋昭障\f2readObject\fP ＜純\f2writeObject\fP ＜純翫ｃ若 \f2@serial\fP 帥違\f2@serialField\fP 帥違\f2@serialData\fP 帥違ャ＜潟若激с潟潟＜潟腟粋昭障障翫純 public 鴻ゅ鴻障鴻絮宴若吾 \f2@serial exclude\fP 帥違ф絎障 翫純 package private 鴻鴻障鴻絮宴若吾 \f2@serial include\fP 帥違ф絎障若吾с 1.4 с\f2\-private\fP 激с潟絎 javadoc 若絎茵public 鴻 private 鴻絎翫鴻с障
-.TP 2
-o
-\f3膣√\fP (\f2index\-*.html\fP) 鴻劫ゃ潟帥с若劫潟潟鴻水ｃ若潟＜純≪＜筝с障膣√Unicode 宴初障 1 ゃ＜ゃ絖 (沿翫 A Z) ャ＜ゃс障
+パッケージのセット全体に対して 1 つの\f3概要ページ\fP (\f2overview\-summary.html\fP)。これは、生成ドキュメントの先頭ページになります。Javadoc ツールは、\f2\-overview\fP オプションで指定されたファイル内の HTML テキストをすべて組み入れます。このページのファイルは、javadoc に複数のパッケージ名を渡した場合にだけ作成されます。詳細は、「HTML フレーム」を参照してください。
.RE
-
-.LP
-.LP
-\f3泣若＜ゃ\fP
-.LP
+.LP
+\f3相互参照ページ\fP
.RS 3
.TP 2
o
-\f3若\fP (\f2help\-doc.html\fP) 蚊若激с潟若菴違若吾≪茯荐莠障\f2\-helpfile\fP 篏帥＜ゃ篁ｃ鴻帥＜ゃ箴с障
-.TP 2
-o
-茵腓榊 HTML 若篏 1 ゃ \f3index.html ＜ゃ\fP＜ゃ若篁若吾茵腓冴翫若障＜ゃ篏鴻絎鴻障障
+\f3パッケージのセット全体に対して 1 つのクラス階層ページ\fP (\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーションバーの [概要] をクリックしてから、[階層ツリー] をクリックします。
.TP 2
o
-茲違\f3若＜ゃ\fP (\f2*\-frame.html\fP) 宴若吾鴻潟ゃ潟帥с若鴻鴻障障 HTML 若茵腓冴篏睡障
+\f3パッケージごとに 1 つのクラス階層ページ\fP (\f2package\-tree.html\fP)。これを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、[階層ツリー] をクリックしてそのパッケージの階層を表示させます。
.TP 2
o
-\f3宴若吾鴻\fP＜ゃ (\f2package\-list\fP) \f2\-link\fP 激с潟 \f2\-linkoffline\fP 激с潟т戎障HTML ＜ゃс鴻＜ゃс潟≪祉鴻с障
-.TP 2
-o
-\f3鴻帥ゃ激若\fP＜ゃ (\f2stylesheet.css\fP) 若娯ゃ荀膣ゃ蚊潟＜潟泣ゃ冴潟鴻帥ゃ渇臀九勝障
+\f3パッケージごとに 1 つの [使用] ページ\fP (\f2package\-use.html\fP) と、クラスおよびインタフェースごとに 1 つずつの [使用] ページ (\f2class\-use/\fP\f2クラス名\fP\f2.html\fP)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。クラスまたはインタフェース A を例にして考えると、その [使用] ページには、A のサブクラス、A として宣言されたフィールド、A を返すメソッド、A 型のパラメータを持つメソッドおよびコンストラクタが表示されます。 このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの [使用] リンクをクリックします。
.TP 2
o
-\f3doc\-files\fP ｃ ｃ潟若ゃ＜若吾泣潟潟若純若鴻潟若＜ゃ鴻主障＜ゃJavadoc 若ｃ＜ゃ javadoc 帥違ｃ∴障ｃ純若鴻若筝翫睡障
+\f3非推奨 API ページ\fP (\f2deprecated\-list.html\fP)。推奨されない名前がすべて一覧表示されます。非推奨名は、一般に改良された API が存在するために使用が推奨されていない API の名前であり、通常、それに置き換わる名前が提示されています。非推奨 API は、将来の実装では削除される可能性があります。
+.TP 2
+o
+\f3定数フィールド値ページ\fP (\f2constant\-values.html\fP)。static フィールドの値用です。
+.TP 2
+o
+\f3直列化された形式ページ\fP (\f2serialized\-form.html\fP)。直列化可能かつ外部化可能なクラスに関する情報用です。これらの各クラスには、直列化フィールドおよびメソッドに関する説明があります。これらの情報は、API を使う開発者ではなく、再実装を行う開発者に必要な情報です。ナビゲーションバーにこのページへのリンクはありませんが、直列化されたクラスに移動して、そのクラスの説明にある「関連項目」セクションで「直列化された形式」をクリックすると、この情報を取得できます。標準ドックレットは直列化された形式ページを自動生成します。Serializable を実装するすべてのクラス (public または 非 public) が含まれるほか、 \f2readObject\fP メソッドや \f2writeObject\fP メソッド、直列化されるフィールド、および \f2@serial\fP、\f2@serialField\fP、\f2@serialData\fP タグからのドキュメンテーションコメントも含まれます。public 直列化可能クラスを除外するには、そのクラス (またはそのパッケージ) を \f2@serial exclude\fP でマークします。package\-private 直列化可能クラスを含めるには、そのクラス (またはそのパッケージ) を \f2@serial include\fP でマークします。バージョン 1.4 では \f2\-private\fP オプションの指定なしで javadoc ツールを実行することにより、public クラスおよび private クラスの完全に直列化されたクラスを生成できます。
+.TP 2
+o
+\f3索引\fP (\f2index\-*.html\fP)。すべてのクラス、インタフェース、コンストラクタ、フィールド、およびメソッドの名前がアルファベット順に並んでいます。索引は、Unicode を扱えるように国際化されています。1 つのファイルとして生成することも、先頭文字 (英語の場合 A ~ Z) ごとに別々のファイルとして生成することもできます。
.RE
-
-.LP
-.LP
-\f3HTML 若\fP
-.LP
-.LP
-Javadoc 若筝潟腓冴2 3 ゃ HTML 若障1 ゃ宴若吾翫 (障宴若吾翫) 宴若吾筝荀сャｃ篏綽荀違若篏障筝宴若吾絮純若鴻＜ゃ (*.java) 障筝宴若後綣違 javadoc 潟潟羝＜翫綏眼鴻筝荀с茵腓冴若 (C) 1 ゃ篏障Javadoc 茲違宴若後羝＜翫网荀若 (Detail) 鴻宴若吾筝荀ц；腓冴膃 3 若 (P) 篏障网荀若吾＜ゃ\f2overview\-summary.html\fP сｃ＜ゃ2 や札筝宴若後羝＜翫篏障[若] 潟overview\-summary.html 茵腓冴若ャс障
-.LP
-.LP
-HTML 若ｃ翫劫若医激潟鴻若若若鴻違羈若若鴻筝若障紊吟с√違若若吾若篏帥ｃ若鴻若[医] ＜ャ若潟潟篏帥ｃ若医激с障
-.LP
-.nf
-\f3
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- |C| Detail | |P| Detail |
-.fl
- | | | | | |
-.fl
- | | | |\-| |
-.fl
- | | | |C| |
-.fl
- | | | | | |
-.fl
- | | | | | |
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- javadoc *.java javadoc java.lang java.awt
-.fl
-\fP
-.fi
-
-.LP
-.LP
-HTML 若綽荀ｃ罨＜＜＜ゃ紮若吾若障
-.LP
+.LP
+\f3サポートファイル\fP
.RS 3
.TP 2
o
-\f2index.html\fP (若)
+\f3ヘルプページ\fP (\f2help\-doc.html\fP)。ナビゲーションバーや前述の各ページに関する説明が記載されています。デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供するには、\f2\-helpfile\fP を使用します。
+.TP 2
+o
+表示用の HTML フレームを作成する 1 つの \f3index.html ファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。
+.TP 2
+o
+複数の\f3フレームファイル\fP (\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTML フレームを表示するときに使用されます。
+.TP 2
+o
+\f3パッケージリスト\fPファイル (\f2package\-list\fP)。 \f2\-link\fP および \f2\-linkoffline\fP オプションで使用されます。これは、HTML ファイルではなくテキストファイルであり、どのリンクからもアクセスできません。
+.TP 2
+o
+\f3スタイルシート\fPファイル (\f2stylesheet.css\fP)。生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。
.TP 2
o
-\f2overview\-summary.html\fP (若)
+\f3doc\-files\fP ディレクトリ。生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。これらのファイルは、Javadoc ツールによって処理されないため、ファイル内に ｊavadoc タグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。
.RE
-
-.LP
-.LP
-\f3＜ゃ罕\fP
-.LP
-.LP
-鴻＜ゃ潟ゃ潟帥с若鴻＜ゃJava 純若鴻＜ゃ潟鴻＜ゃｃ絮ゃ膩障1 ゃ泣宴若吾ゃ 1 ゃｃ罕障
-.LP
-.LP
-違\f2java.applet.Applet\fP 鴻絲障ャ＜潟\f2java/applet/Applet.html\fP 主障ｃ \f2apidocs\fP java.applet 宴若吾＜ゃ罕筝罕膀障菴違frame茯＜ゃ鴻綏筝障綏筝若茵腓冴障篁ュ HTML ＜ゃ鴻勀眼若茵腓冴障
-.LP
+.LP
+\f3HTML フレーム\fP
+.LP
+Javadoc ツールは、下の図に示すように、2 ~ 3 つの HTML フレームを生成します。1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。単一のパッケージに属するソースファイル (*.java) または単一のパッケージ名を引数として javadoc コマンドに渡す場合は、左側の列にクラスの一覧を表示するフレーム (C) 1 つだけが作成されます。Javadoc に複数のパッケージ名を渡した場合は、概要ページ (Detail) に加えて、すべてのパッケージを一覧表示する第 3 のフレーム (P) が作成されます。この概要ページのファイル名は、 \f2overview\-summary.html です\fP。したがって、このファイルは、2 つ以上のパッケージ名を渡した場合にだけ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.html を最初に表示すると、フレームを省略できます。
+.LP
+HTML フレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、「印刷」メニューコマンドを使ってそのフレームを印刷したりできます。
+.LP
+HTML フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。
.RS 3
-
-.LP
-.LP
-羈 \- 筝絮ゅ潟сｃ\f3紊絖\fP (\f3bold\fP) хず障≪鴻帥鴻 (\f2*\fP) javadoc 吾綣違宴若後с純若鴻＜ゃ (*.java) с翫ャ＜ゃ潟ｃ腓冴障障綣違純若鴻＜ゃ翫\f2package\-list\fP 篏障絎鴻腥冴сdoc\-files ｃ純若鴻弱絖翫帥篏障
-.LP
+.TP 2
+o
+\f2index.html\fP (フレームあり)
+.TP 2
+o
+\f2overview\-summary.html\fP (フレームなし)
.RE
+.LP
+\f3生成されるファイルの構造\fP
+.LP
+生成されるクラスファイルおよびインタフェースファイルは、Java ソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1 つのサブパッケージにつき 1 つのディレクトリ、という構造になります。
+.LP
+たとえば、 \f2java.applet.Applet\fP クラス用に生成されたドキュメントは、 \f2java/applet/Applet.html\fP に格納されます。生成先のディレクトリの名前が \f2apidocs\fP だとすると、java.applet パッケージのファイル構造は、その下に構築されます。前述のように、「frame」という語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外の HTML ファイルは、すべて右側のフレームに表示されます。
+.LP
+注 \- 下の階層図で、ディレクトリは\f3太字\fP (bold) で示してあります。アスタリスク (\f2*\fP) は、javadoc への引数がパッケージ名ではなくソースファイル名 (*.java) である場合に省略されるファイルおよびディレクトリを示しています。また、引数がソースファイル名の場合、 \f2package\-list\fP は作成されますが、その中身は空です。doc\-files ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。
.nf
\f3
.fl
.fl
-\fP\f3apidocs\fP 筝篏ｃ
-.fl
- index.html HTML 若荐絎若
-.fl
- * overview\-summary.html 宴若吾鴻 荀膣
-.fl
- overview\-tree.html 宴若吾拷絮ゃ鴻
-.fl
- deprecated\-list.html 宴若吾ｨ絅 API 鴻
-.fl
- constant\-values.html 宴若吾 static ｃ若ゃ鴻
-.fl
- serialized\-form.html 宴若吾翫綵√鴻
-.fl
- * overview\-frame.html 宴若吾鴻 綏筝若茵腓冴
-.fl
- allclasses\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
-.fl
- help\-doc.html 若吾罕腓冴若吟若茵腓冴
-.fl
- index\-all.html \-splitindex 激с潟т膣√
-.fl
- \f3index\-files\fP \-splitindex 激с潟絎篏ｃ
-.fl
- index\-<number>.html \-splitindex 激с潟絎篏膣√＜ゃ
-.fl
- package\-list 宴若後鴻 紊с茹ｆ浦篏睡
-.fl
- stylesheet.css 潟蚊臀絎臂 HTML 鴻帥ゃ激若
-.fl
- \f3java\fP 宴若吾ｃ
-.fl
- \f3applet\fP 泣宴若吾ｃ
-.fl
- Applet.html Applet 鴻若
-.fl
- AppletContext.html AppletContext ゃ潟帥с若鴻若
-.fl
- AppletStub.html AppletStub ゃ潟帥с若鴻若
-.fl
- AudioClip.html AudioClip ゃ潟帥с若鴻若
-.fl
- * package\-summary.html 宴若吾鴻鴻 荀膣
-.fl
- * package\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
-.fl
- * package\-tree.html 宴若吾拷絮ゃ鴻
-.fl
- package\-use 宴若吾篏睡贋鴻
-.fl
- \f3doc\-files\fP ゃ＜若吾泣潟＜ゃ主ｃ
-.fl
- \f3class\-use\fP API 篏睡贋若吾主ｃ
-.fl
- Applet.html Applet 鴻篏睡若
-.fl
- AppletContext.html AppletContext ゃ潟帥с若鴻篏睡若
-.fl
- AppletStub.html AppletStub ゃ潟帥с若鴻篏睡若
-.fl
- AudioClip.html AudioClip ゃ潟帥с若鴻篏睡若
-.fl
- \f3src\-html\fP 純若鴻潟若ｃ
-.fl
- \f3java\fP 宴若吾ｃ
-.fl
- \f3applet\fP 泣宴若吾ｃ
-.fl
- Applet.html Applet 純若鴻潟若若
-.fl
- AppletContext.html AppletContext 純若鴻潟若若
-.fl
- AppletStub.html AppletStub 純若鴻潟若若
-.fl
- AudioClip.html AudioClip 純若鴻潟若若
+\fP\f3apidocs\fP 最上位ディレクトリ
+.fl
+ index.html HTML フレームを設定する初期ページ
+.fl
+ * overview\-summary.html 全パッケージのリスト。先頭文による要約付き
+.fl
+ overview\-tree.html 全パッケージのクラス階層のリスト
+.fl
+ deprecated\-list.html 全パッケージの非推奨 API のリスト
+.fl
+ constant\-values.html 全パッケージの static フィールドの値のリスト
+.fl
+ serialized\-form.html 全パッケージの直列化された形式のリスト
+.fl
+ * overview\-frame.html 全パッケージのリスト。左上のフレームで使用される
+.fl
+ allclasses\-frame.html 全パッケージの全クラスのリスト。左下のフレームで使用される
+.fl
+ help\-doc.html これらのページの構成を示すユーザーヘルプのリスト
+.fl
+ index\-all.html \-splitindex オプションを指定しなかった場合に作成されるデフォルトの索引
+.fl
+ \f3index\-files\fP \-splitindex オプションを指定した場合に作成されるディレクトリ
+.fl
+ index\-<number>.html \-splitindex オプションを指定した場合に作成される索引ファイル
+.fl
+ package\-list パッケージ名のリスト。外部参照を解決するためだけに使用される
+.fl
+ stylesheet.css フォント、色、配置を定義する HTML スタイルシート
+.fl
+ \f3java\fP パッケージディレクトリ
+.fl
+ \f3applet\fP サブパッケージディレクトリ
+.fl
+ Applet.html Applet クラスのページ
+.fl
+ AppletContext.html AppletContext インタフェースのページ
+.fl
+ AppletStub.html AppletStub インタフェースのページ
+.fl
+ AudioClip.html AudioClip インタフェースのページ
+.fl
+ * package\-summary.html このパッケージのクラスのリスト。先頭文による要約付き
+.fl
+ * package\-frame.html このパッケージのクラスのリスト。左下のフレームで使用される
+.fl
+ * package\-tree.html このパッケージのクラス階層のリスト
+.fl
+ package\-use このパッケージが使用されている場所のリスト
+.fl
+ \f3doc\-files\fP 画像やサンプルファイルを保持するディレクトリ
+.fl
+ \f3class\-use\fP API が使用されている場所のページを保持するディレクトリ
+.fl
+ Applet.html Applet クラスの使用に関するページ
+.fl
+ AppletContext.html AppletContext インタフェースの使用に関するページ
+.fl
+ AppletStub.html AppletStub インタフェースの使用に関するページ
+.fl
+ AudioClip.html AudioClip インタフェースの使用に関するページ
+.fl
+ \f3src\-html\fP ソースコードディレクトリ
+.fl
+ \f3java\fP パッケージディレクトリ
+.fl
+ \f3applet\fP サブパッケージディレクトリ
+.fl
+ Applet.html Applet ソースコードのページ
+.fl
+ AppletContext.html AppletContext ソースコードのページ
+.fl
+ AppletStub.html AppletStub ソースコードのページ
+.fl
+ AudioClip.html AudioClip ソースコードのページ
.fl
.fi
-
-.LP
.SS
- API 絎ｈ
-.LP
-.LP
-Javadoc 若鴻ゃ潟帥с若鴻ｃ若潟潟鴻帥潟＜純茯 API 絎ｈ障 絎ｈ API 絎ｈс違\f2Boolean\fP 鴻絎ｈ罨＜障
-.LP
+生成される API 宣言
+.LP
+Javadoc ツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、その API 用の宣言を生成します。たとえば、 \f2Boolean\fP クラスの宣言は、次のようになります。
.LP
\f2public final class Boolean\fP
.br
@@ -937,29 +593,20 @@
.br
\f2implements Serializable\fP
.LP
-.LP
-障\f2Boolean.valueOf\fP ＜純絎ｈ罨＜障
-.LP
+また、 \f2Boolean.valueOf\fP メソッドの宣言は、次のようになります。
.LP
\f2public static Boolean valueOf(String s)\fP
.LP
-.LP
-Javadoc 若篆蕋上 \f2public\fP\f2protected\fP\f2private\fP\f2abstract\fP\f2final\fP\f2static\fP\f2transient\fP \f2volatile\fP 腟粋昭с障\f2synchronized\fP \f2native\fP 腟粋昭с障緇 2 ゃ篆蕋上絎茖荅括完荀API 篁罕障障
-.LP
-.LP
-API с筝茵с祉潟ｃ鴻ゃ若若 \f2synchronized\fP 箴絖с潟＜潟筝肢ャ＜潟綽荀障 違1 ゃ \f2Enumeration\fP 茲違鴻筝茵篏睡с潟＜潟荐菴違障ャ＜潟祉潟ｃ鴻絎憗号荐菴違鴻с障違\f2Hashtable\fP 鴻絲障絎с綽荀障鴻若鴻＜純違絎憗с絎号障宴у罔罧鏆荀障 違蕭綺筝茵с箴障
-.LP
-.SH "ャ＜潟若激с潟潟＜潟"
-.LP
-.LP
-吾ャ＜潟若激с潟潟＜潟篁罕∫ｉс
-.LP
+Javadoc ツールでは、修飾子 \f2public\fP、 \f2protected\fP、 \f2private\fP、 \f2abstract\fP、 \f2final\fP、 \f2static\fP、 \f2transient\fP、および \f2volatile\fP は組み込めますが、 \f2synchronized\fP と \f2native\fP は組み込めません。これら後者の 2 つの修飾子は、実装の詳細と見なされているため、API 仕様には含まれません。
+.LP
+API では、並行性セマンティクスについて、キーワード \f2synchronized\fP に依存するのではなく、コメントの主説明としてドキュメント化すべきです。 \f2たとえば、「1 つの Enumeration を\fP 複数のスレッドから並行して使用することはできない」などと記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述するべきではありません。たとえば、 \f2Hashtable\fP はスレッドに対して安全である必要がありますが、「エクスポートされるすべてのメソッドを同期化すればそれを実現できる」のようには指定する根拠はありません。バケットレベルで内部的に同期化する権利を残しておく必要があります。そうすれば、より高度な並行性が提供されます。
+.SH "ドキュメンテーションコメント"
+.LP
+オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。
.SS
-純若鴻潟若吾潟＜潟水
-.LP
-.LP
-純若鴻潟若篁紙鴻ゃ潟帥с若鴻＜純潟潟鴻帥障ｃ若絎ｈャ＜潟若激с潟潟＜潟 ("doc comments") 荐菴違с障宴若吾ャ＜潟若激с潟潟＜潟篏с障 罕ュ慌違障网荀ャ＜潟若激с潟潟＜潟篏с障ャ＜潟若激с潟潟＜潟綣Javadoc 潟＜潟若違障 (茯罔∫ｃ篏睡羈)ャ＜潟若激с潟潟＜潟潟＜潟紮障腓冴絖 \f2/**\fP 潟＜潟腟腓冴絖 \f2*/\fP 絖ф障茵≪鴻帥鴻茵荐菴違с障 荅括完篁ヤц障潟＜潟鴻茲域ｃ荐菴違с障
-.LP
+ソースコードへのコメントの挿入
+.LP
+ソースコードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーションコメント ("doc comments") を記述することができます。各パッケージにドキュメンテーションコメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadoc コメント」と呼ばれています (この用語は商標関連の使用法に違反)。ドキュメンテーションコメントは、コメントを始まりを示す文字列 \f2/**\fP と、コメントを終わりを示す文字列 \f2*/\fP の間にある文字から構成されます。行の先頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。
.nf
\f3
.fl
@@ -973,26 +620,19 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜ 1 茵荐菴違鴻若鴻膀膣с障
-.LP
+.LP
+次のようにして 1 行に記述すると、スペースを節約できます。
.nf
\f3
.fl
-/** This comment takes up only one line. */
+/** This comment takes up only one line.*/
.fl
\fP
.fi
-
-.LP
-.LP
-\f3潟＜潟臀\fP \- ャ＜潟若激с潟潟＜潟鴻ゃ潟帥с若鴻潟潟鴻帥＜純障ｃ若絎ｈ翫臀茯茘障 鴻箴＜純箴潟ｃ若箴с＜純篏臀ャ＜潟若激с潟潟＜潟∴障javadoc 若с1 ゃ絎ｈゃ 1 ゃャ＜潟若激с潟潟＜潟茯茘障
-.LP
-.LP
-鴻潟＜潟鴻絎ｈ \f2import\fP 臀障с荐菴違с 鴻潟＜潟∴障
-.LP
+.LP
+\f3コメントの配置\fP \- ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。javadoc ツールでは、1 つの宣言文につき 1 つのドキュメンテーションコメントだけが認識されます。
+.LP
+よくある間違いは、クラスコメントとクラス宣言の間に \f2import\fP 文を置いてしまうことです。このような記述はしないでください。このようなクラスコメントは無視されます。
.nf
\f3
.fl
@@ -1014,11 +654,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3ャ＜潟若激с潟潟＜潟筝肢帥違祉激с潟膓\fP \- 潟＜潟紮阪絖с \f2/**\fP 帥違祉激с潟障с筝肢障帥違祉激с潟絖 \f2@\fP с茵у臂帥違紮障障 (茵≪鴻帥鴻腥榊純活阪絖 \f2/**\fP ゃ)筝肢荐菴違帥違祉激с潟潟＜潟荐菴違с障筝肢帥違祉激с割札膓с障帥違綣違茲域ｃ荐菴違с障帥違違狗障 篏荐菴違с帥違1 荐菴違с帥違障箴違罨＜ \f2@see\fP 帥違祉激с潟紮障障
-.LP
+.LP
+\f3ドキュメンテーションコメントは主説明のあとにタグセクションが続く \- コメントの開始区切り文字である\fP \f2/**\fP のあとからタグセクションまでが主説明になります。タグセクションは、行の先頭にある最初の \f2@\fP で定義される最初のブロックタグから始まります (先頭のアスタリスク、空白、先頭の区切り文字 \f2/**\fP は除く)。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1 回しか記述できないタグがあります。たとえば、次の \f2@see\fP は、タグセクションを開始しています。
.nf
\f3
.fl
@@ -1032,11 +669,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3帥違ゃ潟ゃ潟帥\fP \- 帥違Javadoc сャ＜潟若激с潟潟＜潟劫ャ若若с\f2@tag\fP 荐菴違帥 (鴻帥潟≪潟帥違若違) ゃ潟ゃ潟帥 (\f2{@tag}\fP 筝綣су蚊ц菴) 2 腮蕁帥違障帥違罩ｃ頵ｉ茵≪鴻帥鴻腥榊純阪絖 (\f2/**\fP) ゃ茵臀違障鴻篁ュ篏臀 \f2@\fP 絖篏睡帥違紮茹ｉ潟障茵 \f2@\fP 絖篏睡帥違茹ｉHTML 潟ｃｃ若\f2@\fP篏睡帥違絲上篁鴻障 鴻帥違罨＜帥違障ャ＜潟若激с潟潟＜潟緇障с荐菴違鴻 (帥違潟＜潟阪絖ゃ) с∫ｃ鴻茲域ｃ荐菴違с障ゃ潟ゃ潟帥違鴻荐菴違с贋с違с臀с罩ｃ頵ｉ障罨＜潟若箴帥 \f2@deprecated\fP ゃ潟ゃ潟帥 \f2{@link}\fP 障障
-.LP
+.LP
+\f3ブロックタグとインラインタグ\fP \- \f2「タグ」\fPは、Javadoc が処理できる、ドキュメンテーションコメント内の特別なキーワードです。タグには 2 種類あります。1 つは @tag のように表記されるブロックタグ \f2(「標準タグ」とも呼ばれる)、\fP もう 1 つは {@tag} のように中括弧で囲まれるインラインタグ \f2です\fP。ブロックタグが正しく解釈されるためには、行の先頭のアスタリスク、空白、区切り文字 (\f2/**\fP) を除いて、行の先頭に置かなければなりません。これは、 \f2@\fP 文字をテキスト内の別の場所で使用した場合にはタグの開始として解釈されないことを意味しています。行の先頭で \f2@\fP 文字を使用してもそれが解釈されないようにするには、HTML エンティティー \f2@\fP を使用します。それぞれのブロックタグには、対応付けられたテキストがあります。このテキストは、タグのあとから、次のタグの前、またはドキュメンテーションコメントの最後までの間に記述されたテキスト (タグやコメント区切り文字を除く) です。この関連テキストは複数行にわたって記述できます。インラインタグは、テキストを記述できる場所であればどこにでも置くことができ、正しく解釈されます。次の例にはブロックタグ \f2@deprecated\fP とインラインタグ \f2{@link}\fP が含まれています。
.nf
\f3
.fl
@@ -1048,17 +682,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3潟＜潟 HTML ц菴違\fP \- 鴻 HTML 綵√ц菴違違障 HTML 潟ｃｃ若篏帥綽荀 HTML 帥違篏睡с潟障荐菴違 HTML 若吾с潟篏睡吟泣若篁紙若吾с潟篏睡с障 罔羣鴻宴若ｃ潟違鴻帥ゃ激若 (CSS) 若鴻 (ャ＜潟若激с潟潟＜潟篁ュ) HTML 3.2 羣潟若篏障若祉絲上＜ゃHTML 4.0荐菴違障
-.LP
-.LP
-違絨 (\f2<\fP) 潟紊с (\f2>\fP) 荐垩\f2<\fP \f2>\fP 荐菴違綽荀障罕≪潟泣潟 (\f2&\fP) \f2&\fP 荐菴違綽荀障罨＜箴с若 HTML 帥 \f2<b>\fP 篏帥ｃ障
-.LP
-.LP
-罨＜ャ＜潟若激с潟潟＜潟腓冴障
-.LP
+.LP
+\f3コメントは HTML で記述する\fP \- テキストは HTML 形式で記述しなければなりません。これは、HTML のエンティティーを使う必要があること、および HTML タグを使用できることを意味します。記述する HTML のバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディングスタイルシート (CSS) とフレームを含め、すべての部分 (ドキュメンテーションコメント以外の部分) で HTML 3.2 に準拠したコードを生成するように作成されています。ただし、フレームセット対応のため、生成される各ファイルには「HTML 4.0」と記述されます。
+.LP
+たとえば、より小さい (\f2<\fP) 記号およびより大きい (\f2>\fP) 記号のエンティティーは、 \f2<\fP および \f2>\fP と記述すべきです。同様に、アンパサンド (\f2&\fP) は \f2&\fP と記述すべきです。次の例ではボールドの HTML タグ \f2<b>\fP が示されています。
+.LP
+次に、ドキュメンテーションコメントを示します。
.nf
\f3
.fl
@@ -1072,20 +701,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3茵≪鴻帥鴻\fP \- Javadoc ャ＜潟若激с潟潟＜潟茹ｆ茵≪鴻帥鴻 (\f2*\fP) 鴻贋障 障≪鴻帥鴻 (\f2*\fP) 腥榊純帥贋障若吾с 1.4 茵≪鴻帥鴻ャ腥榊醇絖ゃ障潟若箴贋･ャ＜潟若激с潟潟＜潟 \f2<PRE>\fP 帥医若鴻ゃ潟潟篆障絽吾吟腥榊醇絖帥筝緇茹ｉ障ゃ潟潟阪絖 \f2/**\fP 障 \f2<PRE>\fP 帥違綏絲障
-.LP
-.LP
-\f3\fP \- ャ＜潟若激с潟潟＜潟絎ｈ潟ｃｃ若≪膂≧ゅ荀膣с綽荀障翫鴻若鴻帥障壕膓 (宴若沿荐絎翫)障帥違篏臀х障Javadoc 若ｃ HTML 若吾＜潟若网荀潟若障
-.LP
-.LP
-\f3茲違ｃ若絎ｈ\fP \- Java с1 ゃц違ｃ若絎ｈс障 1 ゃャ＜潟若激с潟潟＜潟荐菴違с障 潟＜潟鴻ｃ若絲障潟若障ｃｃ若ャ＜潟若激с潟潟＜潟荐菴違綽荀翫ｃ若ャуｈ違障違罨＜ャ＜潟若激с潟潟＜潟1 ゃ絎ｈ荐菴違筝с 翫絎ｈ 2 ゃс障
-.LP
-.RS 3
-
-.LP
+.LP
+\f3行頭のアスタリスク\fP \- javadoc によるドキュメンテーションコメントの解析時に、各行の先頭にあるアスタリスク (\f2*\fP) 文字は破棄されます。最初のアスタリスク (\f2*\fP) 文字より前にある空白やタブも破棄されます。バージョン 1.4 からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーションコメントの \f2<PRE>\fP タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は左マージンになります (区切り文字 \f2/**\fP または \f2<PRE>\fP タグではなく)。
+.LP
+\f3最初の文\fP \- 各ドキュメンテーションコメントの最初の文は、宣言されているエンティティーに関する簡潔かつ完全な要約文である必要があります。この「最初の文」は、直後にスペース、タブ、または改行が続く最初のピリオド (ロケールが英語に設定されている場合)、または最初のタグがある位置で終わります。最初の文は、Javadoc ツールによって HTML ページの最初にあるメンバーの概要の部分にコピーされます。
+.LP
+\f3複数フィールドの宣言\fP \- Java では、1 つの文で複数のフィールドを宣言できます。ただし、この文には、1 つのドキュメンテーションコメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。たとえば、次のドキュメンテーションコメントは、1 つの宣言として記述すると不適切です。この場合は、宣言を 2 つに分けることをお勧めします。
.nf
\f3
.fl
@@ -1099,145 +720,105 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.LP
-筝荐潟若罨＜ャ＜潟障
-.LP
-.RS 3
-
-.LP
+.LP
+上記のコードからは、次のようなドキュメントが生成されます。
.nf
\f3
.fl
public int \fP\f3x\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
.nf
\f3
.fl
public int \fP\f3y\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
-.RE
-.LP
-\f3荀冴帥違鴻鋎睡\fP \- ＜潟若絲障ャ＜潟若激с潟潟＜潟荐菴違<H1> <H2> HTML 荀冴帥違鴻鋎帥с Javadoc 若絎罕ャ＜潟篏с罕帥違篏帥ャ＜潟綵√綵演帥障鴻宴若吾潟＜潟с荀冴帥違篏帥ｃ罕腟睡障障
-.LP
+.LP
+\f3見出しタグはなるべく使用しない\fP \- メンバーに対してドキュメンテーションコメントを記述するときには、<H1> や <H2> などの HTML 見出しタグは、なるべく使わないでください。 Javadoc ツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。
.SS
-＜純潟＜潟潟
-.LP
-.LP
-Javadoc 若罨＜ 2 ゃ翫鴻潟ゃ潟帥с若鴻＜純潟＜潟潟若障膓帥罘純障潟潟鴻帥ｃ若喝ャ絖鴻ャ＜潟若激с潟潟＜潟膓帥障
-.LP
+メソッドコメントの自動コピー
+.LP
+Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。
.RS 3
.TP 2
o
-\f3潟＜潟膓帥荀ゃ鴻\fP \- 筝肢障 \f2@return\fP 帥違\f2@param\fP 帥違\f2@throws\fP 帥違＜純潟＜潟цゃ翫Javadoc 若若若ゃ＜純障絎茖翫＜純絲上筝肢障帥違潟＜潟罨＜≪眼冴緇ｃ潟若障
-.LP
-ｳ絲劫＜若帥 \f2@param\fP 帥違荀ゃ翫＜若帥潟＜潟筝篏膓翠絮ゃ＜純潟若障劫箴紊 \f2@throws\fP 帥違荀ゃ翫箴紊絎ｈ翫 \f2@throws\fP 帥違潟若障
-.LP
-篏若吾с 1.3 篁ュ篏絲丞хс 障с若吾с潟с筝肢障帥違絖違潟＜潟筝膓帥障с
+\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、 \f2@return\fP タグ、 \f2@param\fP タグ、または \f2@throws\fP タグがメソッドコメントに見つからない場合、Javadoc ツールは、オーバーライドまたは実装している場合はその対象となるメソッドから、対応する主説明またはタグコメントを、次のアルゴリズムに従ってコピーします。
+.LP
+厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、その例外が宣言されている場合にかぎり、 \f2@throws\fP タグがコピーされます。
+.LP
+この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。
.TP 2
o
-\f3{@inheritDoc} 帥違ゃ潟＜潟腓榊膓帥\fP \- ゃ潟ゃ潟帥 \f2{@inheritDoc}\fP ＜純筝肢障 \f2@return\fP\f2@param\fP\f2@throws\fP 帥違潟＜潟水ャ障 膓帥絲上筝肢障帥違潟＜潟膊潟若障
+\f3{@inheritDoc} タグを含むコメントを明示的に継承する\fP \- インラインタグ \f2{@inheritDoc}\fP を、メソッドの主説明内または \f2@return\fP、 \f2@param\fP 、 \f2@throws\fP のいずれかのタグコメント内に挿入します。対応する継承された主説明またはタグコメントがその位置にコピーされます。
.RE
-
-.LP
-.LP
-ャ＜潟若激с潟潟＜潟絎潟若膓帥＜純純若鴻＜ゃ \-sourcepath ф絎鴻臀綽荀障潟潟茵с鴻宴若吾羝＜綽荀障鴻鴻ャ＜潟鴻с違ｃ 1.3.x 篁ュ若鴻違障
-.LP
-.LP
-\f3鴻潟ゃ潟帥с若鴻膓\fP \- 鴻潟ゃ潟帥с若鴻膓帥罨＜ 3 ゃ翫潟＜潟膓帥茵障
-.LP
+.LP
+ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。
+.LP
+\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。
.RS 3
.TP 2
o
-鴻＜純鴻若若鴻＜純若若ゃ
+クラスのメソッドがスーパークラスのメソッドをオーバーライドしている
.TP 2
o
-ゃ潟帥с若鴻＜純鴻若若ゃ潟帥с若鴻＜純若若ゃ
+インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている
.TP 2
o
-鴻＜純ゃ潟帥с若鴻＜純絎茖
+クラスのメソッドがインタフェースのメソッドを実装している
.RE
-
-.LP
-.LP
- 2 ゃ宴若 (＜純若若ゃ翫) сJavadoc 若潟＜潟膓帥若若ゃ＜純ャ＜潟若若ゃ絨頳冴若若ゃ＜純吾潟吾莨若帥障
-.LP
-.LP
-3 ょ宴若 (劫鴻＜純ゃ潟帥с若鴻＜純絎茖翫) сjavadoc 若若若ゃ＜純ャ＜潟絎臂絨頳冴絎茖＜純吾潟吾莨若帥障潟＜潟膓帥障
-.LP
-.LP
-\f3＜純茯膓帥≪眼冴\fP \- ＜純ャ＜潟若激с潟潟＜潟荐菴違翫障 {@inheritDoc} 帥違翫Javadoc 若罨＜≪眼冴篏睡潟＜潟罎膣≪障 ≪眼冴ｃャ＜潟若激с潟潟＜潟罎膣≪с荐荐鴻若若鴻ゃ潟帥с若鴻ｃ障
-.LP
+.LP
+最初の 2 つのケース (メソッドがオーバーライドしている場合) では、Javadoc ツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。
+.LP
+3 つ目のケース (特定のクラスのメソッドがインタフェースのメソッドを実装している場合) では、javadoc ツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。
+.LP
+\f3メソッドの説明が継承されるアルゴリズム\fP \- あるメソッドにドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、Javadoc ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。 このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。
.RS 3
.TP 3
1.
-贋･絎茖 (障≦宍) ゃ潟帥с若鴻＜純絎ｈ implements (障 extends) 若若糸眼綺с1 ゃよ帥鴻＜純ゃ荀ゃｃャ＜潟若激с潟潟＜潟｡
+直接に実装されている (または、拡張されている) インタフェースを、メソッドの宣言で implements (または extends) キーワードのあとに登場する順序で、1 つずつ調べる。このメソッドについて最初に見つかったドキュメンテーションコメントを採用する
.TP 3
2.
- 1 сャ＜潟若激с潟潟＜潟荀ゃｃ翫贋･絎茖 (障≦宍) ゃ潟帥с若鴻絲障≪眼冴篏絽亥 (綺 1 сゃ潟帥с若鴻茯帥鴻綺)
+手順 1 でドキュメンテーションコメントが見つからなかった場合は、直接実装されている (または、拡張されている) インタフェースのそれぞれに対して、このアルゴリズム全体を再帰的に適用する (その際の順序は、手順 1 でインタフェースを調べたときの順序と同じ)
.TP 3
3.
- 2 сャ＜潟若激с潟潟＜潟荀ゃｃ翫с鴻 Object 篁ュ鴻с (ゃ潟帥с若鴻с) 翫罨＜
+手順 2 でドキュメンテーションコメントが見つからなかった場合で、このクラスが Object 以外のクラスである (インタフェースではない) 場合は、次のように処理する
.RS 3
.TP 3
a.
-鴻若若鴻＜純ゃャ＜潟若激с潟潟＜潟荐菴違違潟＜潟｡
+スーパークラスにこのメソッドについてのドキュメンテーションコメントが記述されていれば、そのコメントを採用する
.TP 3
b.
- 3a сャ＜潟若激с潟潟＜潟荀ゃｃ翫鴻若若鴻絲障≪眼冴篏
+手順 3a でドキュメンテーションコメントが見つからなかった場合は、スーパークラスに対して、このアルゴリズム全体を適用する
.RE
.RE
-
-.LP
-.SH "javadoc 帥"
-.LP
-.LP
-Javadoc 若Java ャ＜潟若激с潟潟＜潟莨若障劫ャ帥違茹ｆ障ャ＜潟若激с潟帥違篏帥後眼ｃ絎 API ャ＜潟純若鴻潟若с障帥違箴∴ (\f2@\fP) у障紊ф絖絨絖阪ャ障 帥違絎紊ф絖絨絖篏睡荐菴違綽荀障帥違茵 (茵腥榊純ュ純≪鴻帥鴻ゃ) 臀違障ｄ帥違 1 障荐菴違障違\f2@see\fP 帥違茲違翫鴻 1 障荐菴違障
-.LP
-.LP
-帥違 2 ゃ帥ゃ障
-.LP
+.SH "javadoc タグ"
+.LP
+Javadoc ツールは、Java のドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーションタグを使うと、書式の整った完全な API ドキュメントをソースコードから自動的に生成できます。タグは「アットマーク」記号 (\f2@\fP) で始まり、大文字と小文字の区別があります。タグは、大文字と小文字を使用して、表示されているとおりに入力する必要があります。タグは、行の先頭 (先行する空白と省略可能なアスタリスクは除く) に置かなければなりません。慣例として、同じ名前のタグは 1 か所にまとめて記述するようにします。たとえば、 \f2@see\fP タグはすべて同じ場所に配置します。
+.LP
+タグには 2 つのタイプがあります。
.RS 3
.TP 2
o
-\f3帥\fP \- 筝肢膓帥違祉激с喝粋菴医純帥違\f2@tag\fP 綵√障
+\f3ブロックタグ\fP \- 主説明に続くタグセクション内にのみ記述可能。ブロックタグは、 \f2@tag\fP の形式をとります。
.TP 2
o
-\f3ゃ潟ゃ潟帥\fP \- 潟＜潟筝肢障帥違潟＜潟荐菴医純ゃ潟ゃ潟帥違\f2{@tag}\fP 筝綣су蚊帥障
+\f3インラインタグ\fP \- 主説明内、またはブロックタグのコメント内に記述可能。インラインタグは、 \f2{@tag}\fP.のように中括弧で囲みます。
.RE
-
-.LP
-.LP
-篁緇若鴻уャ帥違ゃ
+.LP
+今後のリリースで導入されるタグについては、
.na
-\f2Proposed Javadoc Tags\fP @
+\f2「Proposed Javadoc Tags」\fP @
.fi
-http://java.sun.com/j2se/javadoc/proposed\-tags.htmlс
-.LP
-.LP
-憝鴻ф鴻帥違罨＜с
-.LP
-.RS 3
-
-.LP
+http://java.sun.com/j2se/javadoc/proposed\-tags.htmlを参照してください。
+.LP
+現時点で有効なタグは、次のとおりです。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -1267,7 +848,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f3絨ャ JDK/SDK 若吾с\fP
+\f3導入された JDK/SDK のバージョン\fP
.br
.di
.nr a| \n(dn
@@ -1278,7 +859,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3帥\fP
+.nr 38 \w\f3タグ\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f2@author\fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -1373,7 +954,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 1124 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 867 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1392,7 +973,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3帥\fP\h'|\n(41u'
+\&\h'|\n(40u'\f3タグ\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -1486,74 +1067,38 @@
.rm a+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
-
-.LP
-.RE
-.LP
-鴻帥帥違ゃ\-tag 激с潟с
-.LP
+.LP
+カスタムタグについては、\-tag オプションを参照してください。
.RS 3
.TP 3
@author\ name\-text
-\-author 激с潟篏帥翫ャ＜潟菴遵絎 \f2name\-text\fP 吾莨若帥障1 ゃャ＜潟若激с潟潟＜潟茲違 \f2@author\fP 帥違с障1 ゃ \f2@author\fP 帥違 1 ゃ絎1 ゃ帥違茲違絎с障翫Javadoc 若ｃ潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹ｆャ＜潟障障潟若障ｃ潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
+\-author オプションが使用されている場合、指定された \f2name\-text\fP を含む [作成者] エントリを生成ドキュメントに追加します。1 つのドキュメンテーションコメントに複数の \f2@author\fP タグを含めることができます。1 つの \f2@author\fP タグに 1 つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-荅括完ゃ帥違篏睡с贋
+.LP
+詳細については、「タグを使用できる場所」および
.na
-\f2@author 帥違ャ＜潟\fP @
+\f2@author タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorс
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorを参照してください。
+.LP
.RS 3
.TP 3
-@deprecated\ deprecated\-text
-.RS 3
-
-.LP
-.LP
-羈: JDK 5.0
-.na
-\f2@Deprecated 羈\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html篏帥ｃ劫違荀膣ｨ絅с障
-.LP
-.RE
+@deprecated\ deprecated\-text 注: @Deprecated 注釈を使って特定のプログラム要素を非推奨にできます。
.RE
-.RS 3
-
-.LP
-.LP
- API 篏膓障 API 篏睡鴻с腓冴潟＜潟菴遵障Javadoc 若\f2deprecated\-text\fP 筝肢腱糸ゃ帥若茘ｨ絅障菴遵障帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.LP
-.LP
-\f2deprecated\-text\fP с絨 API ｨ絅ｃ篁ｆ推戎鴻 API 茯腓冴綽荀障Javadoc 若网荀祉激с潟膣√潟若障с API ｨ絅宴茯с障障篁ｃ API 腓冴 \f2{@link}\fP 帥 (Javadoc 1.2 篁ラ翫) 綽荀障 罨＜荐菴違障
-.LP
-.LP
-荅括完ゃ
+.LP
+この API は動作し続けますが、この API を使用するべきではないことを示すコメントを追加します。Javadoc ツールは、 \f2deprecated\-text\fP を主説明の前に移動してイタリックにし、その前にボールドの警告「推奨されません。」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.LP
+\f2deprecated\-text\fP の最初の文では、少なくとも、その API が推奨されなくなった時期と、代替使用するべき API を読者に提示する必要があります。Javadoc ツールは、この最初の文だけを、概要セクションと索引にコピーします。そのあとの文では、その API が推奨されない理由を説明することもできます。代わりのAPI を指し示す \f2{@link}\fP タグ ( Javadoc 1.2 以降の場合) を含めるべきです。
+.LP
+詳細については、
.na
-\f2@deprecated 帥違ャ＜潟\fP @
+\f2@deprecated タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedを参照してください。
.RS 3
.TP 2
o
-Javadoc 1.2 篁ラс\f2{@link}\fP 帥違篏睡障綽荀贋ゃ潟ゃ潟с潟篏с障箴腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+Javadoc 1.2 以降では \f2{@link}\fP タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。たとえば、
.nf
\f3
.fl
@@ -1567,106 +1112,71 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.RS 3
.TP 2
o
-Javadoc 1.1 с \f2@deprecated\fP 帥違絲障 \f2@see\fP 帥 (ゃ潟ゃ潟с) 荐菴違罔羣綵√с
+Javadoc 1.1 の場合の標準形式は、 \f2@see\fP タグ (インラインは不可) を \f2@deprecated\fP タグごとに作成することです。
.RE
-
-.LP
-.LP
-ｨ絅帥違ゃ荅括完
+.LP
+推奨されないタグについての詳細は、
.na
-\f2@deprecated 帥\fP @
+\f2@deprecated タグ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlャ＜潟с
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。
+.LP
.RS 3
.TP 3
{@code\ text}
-\f2<code>{@literal}</code>\fP 膈с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-鴻 HTML 若≪障ャ絖ｃ javadoc 帥違茹ｉ\f2text\fP \f2code\fP 潟ц；腓冴障 doc 潟＜潟с＜若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟ｃｃ (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟＜潟鴻
-.LP
+\f2<code>{@literal}</code>\fP と同等です。
+.LP
+テキストを \f2HTML マークアップ\fP または \f2入れ子になった javadoc タグ\fP として解釈せずに、text をコードフォントで表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント
.nf
\f3
.fl
\fP\f4{@code A<B>C}\fP\f3
.fl
+
+.fl
+\fP
+.fi
+.LP
+は、生成された HTML ページで、次のようにそのまま表示されます。
+.nf
+\f3
+.fl
+ \fP\f4A<B>C\fP\f3
+.fl
+
+.fl
+\fP
+.fi
+.LP
+ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。
+.LP
+コードフォントなしで同じ機能を実現するには、\f2{@literal}\fP を使用します。
+.LP
+.TP 3
+{@docRoot}
+生成されるページから見た、生成ドキュメントの (生成先の) ルートディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの下部から著作権のページにリンクします。
+.LP
+この \f2{@docRoot}\fP タグは、コマンド行でもドキュメンテーションコメント内でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.RS 3
+.TP 3
+1.
+コマンド行では、ヘッダー、フッター、またはボトムノートは次のように定義します。
+.nf
+\f3
+.fl
+ javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
+.fl
.fl
\fP
.fi
-
-.LP
-.LP
- HTML 若吾с罨＜障乗；腓冴障
-.LP
-.nf
-\f3
-.fl
- \fP\f4A<B>C\fP\f3
-.fl
-
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈鴻鴻\f2<B>\fP 紊絖с茹ｉ障潟若潟障
-.LP
-.LP
-潟若潟у罘純絎憗\f2{@literal}\fP 篏睡障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.TP 3
-{@docRoot}
-若吾荀ャ＜潟 () 若ｃ吾後障鴻茵障帥違篏罔若吾篌腓障眼鴻若吾с＜ゃ腟粋昭箴水с絽吾若吾筝篏罔若吾潟障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
- \f2{@docRoot}\fP 帥違潟潟茵ャ＜潟若激с潟潟＜潟筝с篏睡с障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.LP
-.RS 3
-.TP 3
-1.
-潟潟茵с若帥若障若罨＜絎臂障
-.nf
-\f3
-.fl
- javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
-.fl
-
-.fl
-\fP
-.fi
-.LP
-\- \f2{@docRoot}\fP 翫筝 Makefile 違с筝綣 { } 絖鴻宴若綽荀障違Inprise MAKE 若吾с 5.2 Windows 筝у茵翫\f2{{@docRoot}}\fP筝綣с篋綽荀障\f2\-bottom\fP 激с潟絲障綣違筝綣膃с篋綣膃у蚊綽荀障 \f2href\fP 綣違ゃ蚊綣膃ャ障
+.LP
+注 \- \f2{@docRoot}\fP を Makefile 内でこのように利用する場合、一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする必要があります。たとえば、Inprise MAKE バージョン 5.2 を Windows 上で実行する場合は、 \f2{{@docRoot}} のように、中括弧を二重にする必要があります\fP。さらに、 \f2\-bottom\fP などのオプションに対する引数を、単一引用符ではなく二重引用符で囲む必要もあります ( \f2href\fP の引数を囲む引用符は省略)。
.TP 3
2.
-ャ＜潟若激с潟潟＜潟筝с罨＜篏睡障
+ドキュメンテーションコメントの中では、次のように使用します。
.nf
\f3
.fl
@@ -1676,16 +1186,13 @@
.fl
*/
.fl
-
+
.fl
\fP
.fi
.RE
-
-.LP
-.LP
-帥違綽荀宴ャ＜潟泣宴若吾羞宴ら絮ゆｃ主с罨＜箴腓冴障
-.LP
+.LP
+このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。次に例を示します。
.nf
\f3
.fl
@@ -1695,201 +1202,118 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜茹ｆ浦障
-.LP
+.LP
+次のように解決されます。
.nf
\f3
.fl
- <a href="../../copyright.html"> java/lang/Object.java 翫
+ <a href="../../copyright.html"> java/lang/Object.java の場合
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-
-.LP
+.LP
+かつ
.nf
\f3
.fl
- <a href="../../../copyright.html"> java/lang/ref/Reference.java 翫
+ <a href="../../../copyright.html"> java/lang/ref/Reference.java の場合
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
.TP 3
@exception\ class\-name\ description
-\f2@exception\fP 帥違\f2@throws\fP 帥違臂с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2@exception\fP タグは \f2@throws\fP と同義です。
+.LP
.TP 3
{@inheritDoc}\
-ｃ菴膓水純鴻障絎茖純ゃ潟帥с若鴻帥違憜ャ＜潟若激с潟潟＜潟ャ＜潟膓 (潟) 障罘純羆潟＜潟膓帥若筝篏荐菴違潟若鴻篏帥ｃ荐菴違с障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-帥違ャ＜潟若激с潟潟＜潟罨＜篏臀с炊鴻с
-.LP
+もっとも近い継承可能なクラスまたは実装可能なインタフェースから、このタグの現在のドキュメンテーションコメントに、ドキュメントを継承 (コピー) します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使って記述することができます。
+.LP
+このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。
.RS 3
.TP 2
o
-＜純筝肢翫筝肢筝篏絮ゃ鴻障ゃ潟帥с若鴻潟若
+メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる
.TP 2
o
-＜純 @return@param@throws 帥違鴻綣医翫帥違鴻筝篏絮ゃ絲上帥違潟若
+メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる
.RE
-
-.LP
-.LP
-膓翠絮ゃс潟＜潟荀ゃ号≪罩ｇ∈茯ゃ＜純潟＜潟潟若с帥違荀ゃ翫潟＜潟膀ц若綽膓帥羆冴障障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。
+.LP
.TP 3
-{@link\ \ package.class#member\ \ label}\
-茵腓冴鴻 \f2label\fP ゃ潟ゃ潟潟水ャ障 \f2label\fP с鴻絎宴若吾鴻障＜潟若ャ＜潟若激с潟腓冴障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-帥違\f2@see\fP 帥違鋍若障 ＜帥違\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP с篁鴻с鴻罕障ｃс紊с\f2{@link}\fP 潟 [∫ｉ] 祉激с潟臀сゃ潟ゃ潟潟с障ゃ潟ゃ潟鴻祉阪ャ\f2{@link}\fP 帥違緇筝綣с荐菴違障筝с}篏帥綽荀翫HTML 潟ｃｃ若}篏帥障
-.LP
-.LP
-1 ゃ筝т戎с \f2{@link}\fP 帥違違狗障帥違ャ＜潟若激с潟潟＜潟筝肢障 @deprecated@return@param 篁紙帥違鴻т戎с障
-.LP
-.LP
-違罨＜潟＜潟с \f2getComponentAt(int, int)\fP ＜純с障
-.LP
+{@link\ package.class#member\ label}
+表示テキスト \f2label\fP とのインラインリンクを挿入します。label は、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.LP
+このタグは \f2@see\fP と非常によく似ています。どちらも、\f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の参照の仕方が同じで、有効な構文もまったく同じです。大きな違いは、 \f2{@link}\fP では、[関連項目] セクションにリンクが配置される代わりに、インラインのリンクが生成されるという点です。また、インラインテキストのほかの部分と区別するために、 \f2{@link}\fP タグの最初と最後に中括弧を記述します。ラベルの中で「}」を使う必要がある場合は、HTML エンティティーの「}」を使います。
+.LP
+1 文内で使用可能な \f2{@link}\fP タグの数に制限はありません。このタグは、ドキュメンテーションコメントの主説明部分、または @deprecated、@return、@param などの任意のタグのテキスト部分で使うことができます。
+.LP
+たとえば、次のコメントでは \f2getComponentAt(int, int)\fP メソッドを参照しています。
.nf
\f3
.fl
-{@link #getComponentAt(int, int) getComponentAt} ＜純篏睡障
+{@link #getComponentAt(int, int) getComponentAt} メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-罔羣с筝荐潟＜潟罨＜ HTML 障 (潟＜潟宴若吾ャ鴻с翫)
-.LP
+.LP
+標準ドックレットでは、上記のコメントから次の HTML が生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。
.nf
\f3
.fl
-<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> ＜純篏睡障
+<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
- HTML Web 若娯с罨＜茵腓冴障
-.LP
+.LP
+この HTML は、Web ページ上では次のように表示されます。
.nf
\f3
.fl
-getComponentAt ＜純篏睡障
+getComponentAt メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-\f2{@link}\fP ャ＜潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
-.LP
-.LP
-荅括完ゃ
+.LP
+\f2{@link}\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。
+.LP
+詳細については、
.na
-\f2{@link} 帥違ャ＜潟\fP @
+\f2{@link} タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}с
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}を参照してください。
+.LP
.TP 3
{@linkplain\ package.class#member\ label}
-潟潟若潟с若潟鴻ц；腓冴剛札紊 \f2{@link}\fP с若潟鴻ц菴違箴水с箴:
-.RE
-
-.LP
-.RS 3
-
-.LP
+リンクのラベルがコードフォントではなくプレーンテキストで表示される点以外は \f2{@link}\fP と同じです。ラベルがプレーンテキストで記述されていると便利です。次の例を参照してください。例:
.nf
\f3
.fl
- {@linkplain add() the overridden method} с
+ {@linkplain add() the overridden method} を参照してください。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-篁ヤ茵腓冴障
-.LP
-.RS 3
-
-.LP
-.LP
-the overridden method с
-.LP
-.RE
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+これは以下のように表示されます。
+.LP
+the overridden method を参照してください。
+.LP
.TP 3
{@literal\ text}
-鴻 HTML 若≪障ャ絖ｃ javadoc 帥違茹ｉ\f2text\fP 茵腓冴障 doc 潟＜潟с＜若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟ｃｃ (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟＜潟鴻
-.RE
-
-.LP
-.RS 3
-
-.LP
+テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、 \f2text\fP を表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント
.nf
\f3
.fl
@@ -1899,40 +1323,22 @@
.fl
\fP
.fi
-
-.LP
-.LP
- HTML 若吾吟ф＜障乗；腓冴障
-.LP
-.LP
-\f2\ \ \ \ \ \fPA<B>C
-.LP
-.LP
-羈鴻鴻\f2<B>\fP 紊絖с茹ｉ障 (潟若潟)
-.LP
-.LP
-潟若潟у罘純絎憗\f2{@code}\fP 篏睡障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+は、生成された HTML ページはブラウザで次のようにそのまま表示されます。
+.LP
+\f2\ \ \ \ \ \fPA<B>C
+.LP
+ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。
+.LP
+コードフォントで同じ機能を実現するには、\f2{@code}\fP を使用します。
+.LP
.TP 3
@param\ parameter\-name description
-絎 \f2parameter\-name\fP 絎 \f2description\fP 篏睡＜若帥Parameters祉激с潟菴遵障doc 潟＜潟荐菴違\f2description\fP 茲域膓с障帥違＜純潟潟鴻帥障鴻 doc 潟＜潟с炊鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2parameter\-name\fP ＜純障潟潟鴻帥с＜若帥鴻＜純障潟潟鴻帥帥ゃ＜若帥障絮掩綣сс＜若水蚊＜若帥篏睡絎障
-.LP
-.LP
-鴻＜若帥箴:
-.LP
+指定された \f2parameter\-name\fP のあとに指定された \f2description\fP が続くパラメータを、[パラメータ] セクションに追加します。ドキュメンテーションコメントを記述するときには、 \f2description\fP を複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスの doc コメント内でのみ有効です。
+.LP
+\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。山括弧でパラメータ名を囲むと、型パラメータを使用することを 指定します。
+.LP
+クラスの型パラメータの例:
.nf
\f3
.fl
@@ -1950,11 +1356,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-＜純＜若帥箴:
-.LP
+.LP
+メソッドの型パラメータの例:
.nf
\f3
.fl
@@ -1978,125 +1381,87 @@
.fl
\fP
.fi
-
-.LP
-.LP
-荅括完ゃ
+.LP
+詳細については、
.na
-\f2@param 帥違ャ＜潟\fP @
+\f2@param タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramを参照してください。
+.LP
.TP 3
@return\ description
-[祉] 祉激с潟菴遵\f2description\fP 鴻吾莨若帥障鴻с祉ゃ緇ゃ膀蚊ゃ荐菴違綽荀障帥違＜純ャ＜潟若激с潟潟＜潟с炊鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-荅括完ゃ
+[戻り値] セクションを追加して、 \f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。
+.LP
+詳細については、
.na
-\f2@return 帥違ャ＜潟\fP @
+\f2@return タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnを参照してください。
+.LP
.TP 3
-@see\ \ reference
-[∫ｉ] 荀冴菴遵\f2reference\fP 潟障鴻潟吾莨若帥障1 ゃャ＜潟若激с潟潟＜潟篁紙違 \f2@see\fP 帥違絎с障 鴻 \f2@see\fP 帥違絎鴻荀冴筝違若障\f2@see\fP 帥違罨＜ 3 腮蕁綵√障 ｃ鋎帥3 綵√с帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с宴若吾鴻障＜潟若絲障ゃ潟ゃ潟潟筝水ャ号\f2{@link}\fP с
+@see\ reference
+「関連項目」見出しを追加し、 \f2reference を指すリンクか、またはテキストエントリを書き込みます\fP。ドキュメンテーションコメントには任意の数の \f2@see\fP タグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。 \f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバーに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。
.RS 3
.TP 3
@see "string"
-\f2string\fP 鴻潟菴遵障潟障\f2string\fP 悟障 URL с≪祉鴻с宴усJavadoc 若絖篋綣膃 (\f2"\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
+\f2string のテキストエントリを追加します\fP。リンクは生成されません。 \f2string\fP は、書籍または URL ではアクセスできない情報の参照先です。Javadoc ツールは、最初の文字が二重引用符 (\f2"\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。たとえば、
.nf
\f3
.fl
@see "The Java Programming Language"
.fl
-
-.fl
-\fP
-.fi
-.LP
-罨＜鴻障
-.RE
-.RS 3
-.RS 3
-
-.LP
-.RS 3
-.TP 3
-∫ｉ:
-The Java Programming Language
-.RE
-
-.LP
-.RE
-.RE
-.TP 3
-@see <a href="URL#value">label</a>
-\f2URL\fP#\f2value\fP у臂潟菴遵障\f2URL\fP#\f2value\fP 後 URL 障腟九 URL сJavadoc 若絖絨荐 (\f2<\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
-.nf
-\f3
-.fl
- @see <a href="spec.html#section">Java Spec</a>
-.fl
.fl
\fP
.fi
.LP
-罨＜潟障
-.RS 3
-.RS 3
-.TP 3
-∫ｉ:
-Java Spec
-.RE
+これは次のようなテキストを生成します。
.RE
.RE
.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
+.RS 3
+.RS 3
.RS 3
.TP 3
+関連項目:
+The Java Programming Language
+.RE
+.RE
+.TP 3
+@see <a href="URL#value">label</a>
+\f2URL\fP#\f2value\fP で定義されたとおりにリンクを追加します。 \f2URL\fP#\f2value\fP は相対 URL または絶対 URL です。Javadoc ツールは、最初の文字が「より小さい」記号 (\f2<\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。たとえば、
+.nf
+\f3
+.fl
+ @see <a href="spec.html#section">Java Spec</a>
+.fl
+\fP
+.fi
+これは次のようなリンクを生成します。
+.RS 3
+.TP 3
+関連項目:
+Java Spec
+.RE
+.TP 3
@see\ package.class#member\ label
-絎ゃс Java 荐茯＜潟若ゃャ＜潟潟茵腓冴鴻 \f2label\fP 菴遵障\f2label\fP ュ純с \f2label\fP ャ潟＜潟若膰茵腓冴障 茵腓冴号с\-noqualifier 篏睡茵腓冴鴻宴若後篏ゃ障茵腓冴鴻違茵腓冴鴻絎翫篏帥障
-.LP
-若吾с 1.2 с <code> HTML 帥医茵腓冴障 1.2.2 篏睡<code> 絽吾茵腓冴鴻蚊＜с障障
+可視のテキスト \f2label\fP を持つリンクを追加します。このリンクは、参照先となる、指定された Java 言語の名前のドキュメンテーションを指します。 \f2label\fP は省略可能です。label を省略すると、リンク先のメンバーの名前が適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。\-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。
+.LP
+バージョン 1.2 だけは、ラベルではなく、名前が <code> HTML タグ内に自動的に表示されます。 1.2.2 からは、ラベルを使用するか、しないかにかかわらず、<code> は常に表示テキストを囲むかたちで、含まれます。
.LP
.RS 3
.TP 2
o
-\f4package.class\fP\f4#\fP\f4member\fP с篁紙鴻違荀膣絎障 ゃ障宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純障ｃ若с ＜潟弱若激ｃ若荐 (\f2#\fP) х舟障\f2class\fP 篁紙障ャ絖鴻障ゃ潟帥с若鴻茵障\f2member\fP 篁紙潟潟鴻帥＜純障ｃ若 (ャ絖鴻障ゃ潟帥с若鴻с) 茵障絎ャ＜潟鴻障翫Javadoc 若吾潟篏障紊с鴻吾潟篏\f2\-link\fP 激с潟篏帥障с鴻絮ャ＜潟с祉 2 ゃ綵√ \f2@see\fP 帥違篏帥障綣違ゃ絎ц潟顄障
-.TP 2
-o
-\f4label\fP ュ純鴻с潟茵腓冴障\f2label\fP 腥榊純с障\f2label\fP ャ\f2package.class.member\fP 憜鴻潟宴若吾綽膰茵腓冴障 茵腓冴号с
+\f4package.class\fP\f4#\fP\f4member\fP には、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名ーの前のドットは、シャープ記号 (\f2#\fP) で置き換えます。 \f2class\fP は、任意のトップレベルまたは入れ子にされたクラスまたはインタフェースを表します。 \f2member\fP は、任意のコンストラクタ、メソッドまたはフィールド (入れ子にされたクラスまたはインタフェースではない) を表します。指定した名前が、ドキュメント化されているクラスに含まれている場合、Javadoc ツールは、その名前へのリンクを自動的に作成します。外部参照クラスへのリンクを作成するには、\f2\-link\fP オプションを使います。参照先のクラスに属していない名前のドキュメンテーションを参照するには、残り 2 つの \f2@see\fP 形式のうちのどちらかを使用します。この引数については、このあとの「名前の指定」で詳しく説明します。
.TP 2
o
-腥榊醇絖\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP 阪絖с綣с眼腥榊醇絖茹ｉ＜純＜若翠腥榊醇絖ャ障障
+\f4label\fP は、省略可能なテキストで、リンクのラベルとして表示されます。 \f2label\fP には空白を含めることができます。 \f2label\fP を省略すると、\f2package.class.member\fP が、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。
+.TP 2
+o
+空白が、 \f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。
.RE
.LP
-\f3箴\fP \- 箴с\f2Character\fP 鴻 \f2@see\fP 帥違\f2String\fP 鴻 \f2equals\fP ＜純с障帥違 \f2String#equals(Object)\fP \f2equals\fP 筝≧鴻綣違障障
-.RS 3
-
-.LP
+\f3例\fP \- この例では、 \f2@see\fP タグ ( \f2Character\fP クラス内) が String クラスの \f2equals\fP メソッド \f2を参照\fP しています。このタグには名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。
.nf
\f3
.fl
@@ -2106,62 +1471,33 @@
.fl
*/
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-罔羣罨＜ HTML 障
-.RS 3
-
-.LP
+標準ドックレットは、次のような HTML を生成します。
.nf
\f3
.fl
<dl>
.fl
-<dt><b>See also:</b>
+<dt><b>See Also:</b>
.fl
<dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
.fl
</dl>
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-吟с罨＜茵腓冴潟鴻障
-.RS 3
+これは、ブラウザでは次のように表示され、ラベルがリンクテキストになります。
.RS 3
.TP 3
-∫ｉ:
+関連項目:
equals
.RE
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.LP
-\f3絎\fP \- 帥違絎 \f2package.class\fP\f2#\fP\f2member\fP \f2java.lang.String#toUpperCase()\fP 絎絎\f2String#toUpperCase()\fP \f2#toUpperCase()\fP 絎с障絎絎翫Javadoc 若Java 潟潟ゃ絽吾罎膣∫綺с罎膣≪障荅括完@see 罎膣∫綺с＜純茲違綣違綣с眼с亥榊純с障
-.LP
-.LP
-絎絎鴻ュ絖違羝純若鴻潟若茯帥с罨＜茵障障綵√腓冴障 茵筝с\f2Class\fP 鴻障ゃ潟帥с若鴻\f2Type\fP 鴻ゃ潟帥с若鴻障堺若水 \f2method\fP ＜純障潟潟鴻帥絎с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.RS 3
+.LP
+\f3名前の指定\fP \- この \f2package.class\fP\f2#\fP\f2member\fP という名前は、 \f2java.lang.String#toUpperCase()\fP のような完全修飾名にすることも、 \f2String#toUpperCase()\fP や \f2#toUpperCase()\fP のような非完全修飾名にすることもできます。名前が完全指定されていない場合、Javadoc ツールは、Java コンパイラの通常の検索順序でその名前を検索します。詳細は、このあとの「@see の検索順序」を参照してください。名前には、メソッドの複数の引数の間など、括弧の内側であれば空白を含めることができます。
+.LP
+「部分的に指定」した短い名前を指定することの利点は、入力する文字数が減ることや、ソースコードが読みやすくなることです。次の表に、さまざまな形式の名前を示します。ここで、 \f2Class\fP にはクラスまたはインタフェースを、 \f2Type\fP にはクラス、インタフェース、配列、または基本データ型を、 \f2method\fP にはメソッドまたはコンストラクタを、それぞれ指定できます。
+.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2191,7 +1527,7 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 筝綵√\fP
+\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 の一般的な形式\fP
.br
.di
.nr a| \n(dn
@@ -2207,9 +1543,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3憜鴻＜潟若с\fP
+\f3現在のクラスのメンバーを参照する\fP
.br
-\f2@see\fP\ \f2#\fP\f2field\fP
+\f2@see\fP\ \f2#\fP\f2フィールド\fP
.br
\f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2233,21 +1569,21 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3憜障ゃ潟若宴若吾ャ鴻с\fP
+\f3現在の、またはインポートされたパッケージの別のクラスを参照する\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2フィールド\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
.br
\f2@see\fP\ \f2Class.NestedClass\fP
.br
-\f2@see\fP\ \f2Class\fP
+\f2@see\fP\ \f2クラス\fP
.br
.di
.nr c| \n(dn
@@ -2263,9 +1599,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3ャ宴若吾荀膣с\fP\ (絎篆蕋)
+\f3別のパッケージの要素を参照する\fP\ (完全修飾)
.br
-\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2フィールド\fP
.br
\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2279,7 +1615,7 @@
.br
\f2@see\fP\ \f2package.Class\fP
.br
-\f2@see\fP\ \f2package\fP
+\f2@see\fP\ \f2パッケージ\fP
.br
.di
.nr d| \n(dn
@@ -2308,7 +1644,7 @@
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 1860 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1358 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2396,74 +1732,52 @@
.rm d+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-58
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-筝茵絲障茖莇割罨＜腓冴障
-.LP
+.LP
+上の表に対する補足事項を次に示します。
.RS 3
.TP 2
o
-腮蕁綵√ (宴若吾鴻) 翫Javadoc 若憜鴻絮ゃ罎膣≪障ゃ障憜鴻ゃ潟帥с若鴻鴻若若鴻鴻若若ゃ潟帥с若鴻障憜鴻ゃ潟帥с若鴻蚊с鴻ゃ潟帥с若鴻＜潟若罎膣≪障 (罎膣∽ 1 3)憜宴若吾祉祉宴若吾罎膣≪障 (罎膣∽ 4 5)
+最初の種類の形式 (パッケージとクラスを省略) の場合、Javadoc ツールは、現在のクラスの階層だけを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、または現在のクラスかインタフェースを囲んでいるクラスかインタフェースからメンバーを検索します (このあとの検索手順 1 ~ 3)。現在のパッケージのほかの部分や、ほかのパッケージは検索しません (検索手順 4 ~ 5)。
.TP 2
o
-＜純障潟潟鴻帥絎綣с篁 (\f2getValue\fP ) 篏睡翫ｃ若絖違Javadoc 若＜純絲障罩ｃ潟篏障 綣с綣違菴遵篆茘＜祉若吾阪障＜純若若若翫Javadoc 若罎膣≪ф荀ゃｃ＜純潟障 腟ｃ劫с障
-.TP 2
-o
-ャ絖鴻筝荐綵√翫\f2inner\fPс\f2outer\fP\f2.\fP\f2inner\fP絎違障
+メソッドまたはコンストラクタの指定時に、 \f2getValue\fP のように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadoc ツールによってその名前へのリンクが正しく作成されますが、括弧や引数の追加をユーザーに促すための警告メッセージが表示されます。このメソッドがオーバーロードされている場合、Javadoc ツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。
.TP 2
o
-с菴違鴻鴻＜潟若阪 (\f2.\fP) с激ｃ若荐 (\f2#\fP) 篏睡羈絎Javadoc 若障茹ｆ浦с障 鴻ャ絖鴻宴若吾潟泣宴若吾阪篏睡障Javadoc 若с筝荐怨合蚊綺障違с罩ｃ頵ｆ障 翫с茘茵腓冴障
+入れ子になったクラスは、すべての形式について、 \f2outer\fP\f2.\fP\f2inner\fP として指定する必要があります。単純に \f2inner\fP とはしないでください。
+.TP 2
+o
+すでに述べたように、\f2クラスとメンバーとの間の区切り文字としては、\fPドット (\f2.\fP) ではなくシャープ文字 (#) を使用します。このように指定すると、Javadoc ツールは、あいまいさを解決できます。ドットは、クラス、入れ子にされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されます。ただし、Javadoc ツールでは一般に許容範囲が広く、あいまいさがなければ、ドットでも正しく解析されます。その場合でも警告は表示されます。
.RE
-
-.LP
-.LP
-\f3@see 罎膣∫綺\fP \- Javadoc 若純若鴻＜ゃ (.java)宴若吾＜ゃ (package.html 障 package\-info.java)障网荀＜ゃ (overview.html) 筝糸眼 \f2@see\fP 帥違障緇 2 ゃ＜ゃс絎絎 \f2@see\fP 帥違絎違障純若鴻＜ゃс絎絎障絎絎с障
-.LP
-.LP
-Javadoc 若\f2.java\fP ＜ゃу絎с荐菴違 \f2@see\fP 帥違荀ゃJava 潟潟ゃ綺ф絎罎膣≪障 Javadoc 若劫腥咲障罎冴障 純若鴻潟若若絖с罎膣∫綺Java 荐茯篁罕膃 2 膃 6 腴Namesфｅ絎臂障Javadoc 若∫ｃ鴻宴若吾潟ゃ潟若鴻宴若吾鴻罎膣≪障隙罨＜綺ф膣≪障
-.LP
+.LP
+\f3@see の検索順序\fP \- Javadoc ツールは、ソースファイル (.java)、パッケージファイル (package.html または package\-info.java) または概要ファイル (overview.html) に含まれる \f2@see\fP タグを処理します。後者の 2 つのファイルでは、完全指定の名前を \f2@see\fP タグに指定しなければなりません。ソースファイルでは、完全指定の名前、または部分指定の名前を指定できます。
+.LP
+Javadoc ツールは、完全指定でない名前が記述された \f2@see\fP タグを \f2.java ファイル内で見つけると、\fP Java コンパイラと同じ順序で指定された名前を検索します。 ただし、Javadoc ツールは、特定の名前空間のあいまいさを検出しません。 これは、ソースコードにこれらのエラーが存在していないことを前提としているためです。この検索順序は、Java 言語仕様第 2 版の第 6 章「Names」で正式に定義されています。Javadoc ツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてから名前を検索します。具体的には、次の順序で検索します。
.RS 3
.TP 3
1.
-憜鴻障ゃ潟帥с若
+現在のクラスまたはインタフェース
.TP 3
2.
-紊眼蚊с鴻ゃ潟帥с若 (ｃ菴罎膣)
+外側を囲んでいるクラスとインタフェース (もっとも近いものから検索)
.TP 3
3.
-鴻若若鴻鴻若若ゃ潟帥с若 (ｃ菴罎膣)
+スーパークラスとスーパーインタフェース (もっとも近いものから検索)
.TP 3
4.
-憜宴若
+現在のパッケージ
.TP 3
5.
-ゃ潟若宴若吾鴻潟ゃ潟帥с若 (import 綺緇ｃ罎膣)
+インポートされているパッケージ、クラス、およびインタフェース (import 文の順序に従って検索)
.RE
-
-.LP
-.LP
-Javadoc 若鴻ゃ 1 3 絽亥筝眼荀ゃ障ф膣≪膓障ゃ障障憜鴻罎膣≪罨＜鴻蚊с E 罎膣≪罨＜ E 鴻若若鴻罎膣≪罨＜ E 蚊с鴻罎膣≪障 4 5 с1 ゃ宴若後鴻障ゃ潟帥с若鴻罎膣≪綺羆冴障ｃ障 綺潟潟ゃｃ違障 5 сJavadoc 若java.lang 罎膣≪障 宴若吾鴻違ゃ潟若с
-.LP
-.LP
-Javadoc 若綽泣鴻罎膣≪障 障javadoc 絎茵筝祉宴若吾ャ＜潟翫с祉宴若吾罎膣≪障違\f2@see\fP 帥違 \f2java.awt.event.KeyEvent\fP 劫ｃ\f2java.awt\fP 宴若吾с翫Javadoc 鴻ゃ潟若宴若吾罎膣≪障
-.LP
-.LP
-\f3茵腓冴号\fP \- \f2label\fP ャ\f2package.class.member\fP 茵腓冴障筝package.class.member 憜鴻潟宴若吾綽膰障膰綽荀絨茵腓冴с違\f2String.toUpperCase()\fP ＜純鴻＜潟若吾с祉鴻＜潟若吾с障翫劫茵腓冴緇宴若鴻с (罨＜茵)
-.LP
-.LP
-宴若後綺ゃ\-noqualifier 篏睡障
+.LP
+Javadoc ツールは、各クラスについて手順 1 ~ 3 を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にそのクラスを囲んでいるクラス E を検索し、その次に E のスーパークラスを検索し、さらにその次に E を囲んでいるクラスを検索します。 手順 4 と 5 では、1 つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません。その順序は、個々のコンパイラによって異なります。手順 5 では、Javadoc ツールは、java.lang を検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。
+.LP
+Javadoc ツールは、必ずしもサブクラスを検索するとは限りません。また、javadoc の実行中にほかのパッケージのドキュメントが生成される場合でも、ほかのパッケージを検索しません。たとえば、 \f2@see\fP タグが \f2java.awt.event.KeyEvent\fP クラス内に含まれていて、 \f2java.awt\fP パッケージ内のある名前を参照していても、そのクラス内でそのパッケージがインポートされないかぎり、javadoc はそのパッケージ内での検索を行いません。
+.LP
+\f3名前が表示される方法\fP \- \f2label\fP を省略した場合は、\f2package.class.member\fP が表示されます。一般に、package.class.member は、現在のクラスおよびパッケージに応じて適切に短縮されます。「短縮される」とは、必要最小限の名前だけが表示されるということです。たとえば、 \f2String.toUpperCase()\fP メソッドに、同じクラスのメンバーへの参照とほかのクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースだけです (次の表を参照)。
+.LP
+パッケージ名を広域的に削除するには、\-noqualifier を使用します。
.br
-
-.LP
-.RE
-.RS 3
-.RS 3
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2493,7 +1807,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f4String.toUpperCase()\fP\f3 с箴\fP
+\f4String.toUpperCase() での例\fP
.br
.di
.nr a| \n(dn
@@ -2509,7 +1823,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違鴻＜潟若с
+\f2@see\fP タグが同じクラス、同じパッケージのメンバーを参照している
.br
.di
.nr b| \n(dn
@@ -2525,7 +1839,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2toLowerCase()\fP (劫)
+\f2toLowerCase()\fP (クラス名は省略)
.br
.di
.nr c| \n(dn
@@ -2541,7 +1855,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違ャ鴻＜潟若с
+\f2@see\fP タグが異なるクラス、同じパッケージのメンバーを参照している
.br
.di
.nr d| \n(dn
@@ -2573,7 +1887,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2Character.toLowerCase(char)\fP (宴若後ャ劫)
+\f2Character.toLowerCase(char)\fP (パッケージ名は省略し、クラス名を含む)
.br
.di
.nr f| \n(dn
@@ -2589,7 +1903,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違ャ鴻＜潟若с
+\f2@see\fP タグが異なるクラス、異なるパッケージのメンバーを参照している
.br
.di
.nr g| \n(dn
@@ -2621,7 +1935,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2java.io.File.exists()\fP (宴若後劫)
+\f2java.io.File.exists()\fP (パッケージ名とクラス名を含む)
.br
.di
.nr i| \n(dn
@@ -2632,7 +1946,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3с腮蕁\fP
+.nr 38 \w\f3参照の種類\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
@@ -2654,7 +1968,7 @@
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 82 0
-.nr 38 \w\f3茵腓冴\fP
+.nr 38 \w\f3表示される名前\fP
.if \n(82<\n(38 .nr 82 \n(38
.82
.rm 82
@@ -2676,7 +1990,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 1958 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1434 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2695,7 +2009,7 @@
.ta \n(80u \n(81u \n(82u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3с腮蕁\fP\h'|\n(41u'\h'|\n(42u'\f3茵腓冴\fP
+\&\h'|\n(40u'\f3参照の種類\fP\h'|\n(41u'\h'|\n(42u'\f3表示される名前\fP
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -2814,22 +2128,14 @@
.rm i+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f3@see 箴\fP
+.LP
+\f3@see の例\fP
.br
-勀眼潟＜潟\f2@see\fP 帥違ャ宴若 (\f2java.applet.Applet\fP ) 劫翫茵腓冴腓冴障
-.LP
+右側のコメントは、 \f2@see\fP タグが \f2java.applet.Applet\fP のような別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。
.nf
\f3
.fl
- ∫ｉ:
+ 関連項目:
.fl
@see java.lang.String // String \fP\f3
.fl
@@ -2849,121 +2155,68 @@
.fl
@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
.fl
-
-.fl
\fP
.fi
-
-.LP
-.LP
-\f2@see\fP ャ＜潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
-.LP
-.LP
-荅括完ゃ
+\f2@see\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。
+.LP
+詳細については、
.na
-\f2@see 帥違ャ＜潟\fP @
+\f2@see タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeを参照してください。
.RE
-.LP
-
+.RE
.LP
.RS 3
.TP 3
@serial\ field\-description | include | exclude
-翫純ｃ若ャ＜潟若激с潟潟＜潟т戎障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2field\-description\fP (ュ) сｃ若潟茯緇ゃ鴻腓冴綽荀障綽荀綽茲違茵羝＜ｃ茯荐菴違с障罔羣宴翫綵√若吾菴遵障
-.LP
-.LP
-鴻翫違翫純ｃ若鴻菴遵翫筝肢菴遵若吾с潟茘ャ菴遵綽荀障
-.LP
-.LP
-\f2include\fP \f2exclude\fP 綣違翫綵√若吾鴻障宴若吾ゅ腓冴障綣違罨＜号障
-.LP
+デフォルトの直列化可能フィールドのドキュメンテーションコメントで使用します。
+.LP
+\f2field\-description\fP (省略可能) では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式のページに追加します。
+.LP
+クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。
+.LP
+\f2include\fP および \f2exclude\fP 引数は、直列化された形式のページにクラスまたはパッケージを含めるか除外するかを示します。これらの引数には、次のような効果があります。
.RS 3
.TP 2
o
-\f2Serializable\fP 絎茖 public 障 protected 鴻絽吾若吾障 鴻障鴻絮宴若吾 \f2@serial exclude\fP ф絎若吾ゅ障
+\f2Serializable\fP を実装している public または protected クラスは、そのクラス (またはそのパッケージ) が \f2@serial exclude\fP としてマークされていないかぎり、含められます。
.TP 2
o
-\f2Serializable\fP 絎茖 private 障 package private 鴻絽吾若吾ゅ障 鴻障鴻絮宴若吾 \f2@serial include\fP ф絎若吾障
+\f2Serializable\fP を実装している private または package\-private クラスは、そのクラス (またはそのパッケージ) が \f2@serial include\fP として マークされていないかぎり、除外されます。
.RE
-
-.LP
-.LP
-箴: \f2javax.swing\fP 宴若吾\f2@serial exclude\fP ф絎障 (\f2package.html\fP 障 \f2package\-info.java\fP )public \f2java.security.BasicPermission\fP \f2@serial exclude\fP ф絎障package private \f2java.util.PropertyPermissionCollection\fP \f2@serial include\fP ф絎障
-.LP
-.LP
-鴻ф絎 @serial 帥違宴若吾ф絎 @serial 帥違若若ゃ障
-.LP
-.LP
-帥違篏睡羈ゃ荅括完篏睡箴Java 吾с翫篁罕膃 1.6 膀
+.LP
+例: \f2javax.swing\fP パッケージは \f2@serial exclude\fP ( \f2package.html\fP または \f2package\-info.java\fP内) としてマークされています。public クラス \f2java.security.BasicPermission\fP は \f2@serial exclude\fP としてマークされています。package\-private クラス \f2java.util.PropertyPermissionCollection\fP は \f2@serial include\fP としてマークされています。
+.LP
+クラスレベルで指定された @serial タグは、パッケージレベルで指定された @serial タグをオーバーライドします。
+.LP
+これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節
.na
-\f2鴻翫純ｃ若潟若帥後\fP @
+\f2「クラスの直列化可能なフィールドおよびデータの文書化」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlс障
+http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、
.na
-\f2翫 FAQ\fP @
-.fi
-http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingс FAQ \-private 鴻ゃ絎 javadoc 絎茵 private ｃ若 @serial 帥違荀ゃ javadoc 茘茵腓冴筝莖吾膈荐莠障翫綵√鋌罕鴻翫
-.na
-\f2Sun 篁罕\fP @
+\f2「直列化の FAQ」\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingも参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、
+.na
+\f2「Sun の仕様」\fP @
+.fi
+http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlも参照してください。
+.LP
.TP 3
@serialField\ field\-name\ field\-type\ field\-description
-\f2Serializable\fP 鴻 \f2serialPersistentFields\fP ＜潟若 \f2ObjectStreamField\fP 潟潟若潟ャ＜潟障 \f2ObjectStreamField\fP 潟潟若潟絲障 \f2@serialField\fP 帥違 1 や戎綽荀障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+Serializable \f2クラスの\fP serialPersistentFields \f2メンバーの\fP ObjectStreamField コンポーネント \f2をドキュメント化\fP します。1 つの \f2@serialField\fP タグを各 \f2ObjectStreamField\fP コンポーネントで使用すべきです。
+.LP
.TP 3
@serialData\ data\-description
-\f2data\-description\fP 翫綵√с若帥綺茯鴻с若帥鴻\f2writeObject\fP ＜純ｃ吾莨若障ュ純若帥 \f2Externalizable.writeExternal\fP ＜純ｃ吾莨若障鴻若 (阪鴻) 障障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2@serialData\fP 帥違\f2writeObject\fP\f2readObject\fP\f2writeExternal\fP\f2readExternal\fP\f2writeReplace\fP \f2readResolve\fP ＜純ャ＜潟若激с潟潟＜潟т戎с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2data\-description\fP は、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、 \f2writeObject\fP メソッドによって書き込まれる省略可能なデータ、および \f2Externalizable.writeExternal\fP メソッドによって書き込まれるすべてのデータ (基底クラスも含む) が含まれます。
+.LP
+\f2@serialData\fP タグは、 \f2writeObject\fP、 \f2readObject\fP、 \f2writeExternal\fP、 \f2readExternal\fP、 \f2writeReplace\fP、および \f2readResolve\fP メソッドのドキュメンテーションコメント内で使用できます。
+.LP
.TP 3
@since\ since\-text
-ャ＜潟 [絨ャ若吾с] 荀冴菴遵絎 \f2since\-text\fP 吾莨若帥障鴻劫ャ罕障帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с帥違劫紊眼障罘純\f2since\-text\fP 腓冴純с≪若剛札絖潟障箴腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+生成ドキュメントに [導入されたバージョン] 見出しを追加し、指定された \f2since\-text\fP を書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。このタグは、特定の変更または機能が、 \f2since\-text に示されたソフトウェアリリース以降、存在していることを意味します\fP。たとえば、
.nf
\f3
.fl
@@ -2973,52 +2226,26 @@
.fl
\fP
.fi
-
-.LP
-.LP
-Java 若純若鴻潟若翫帥違Java 若 API 篁罕若吾с潟腓冴障 紊眼罘純＜潟劫茖菴遵腓冴障茲違 @since 帥違篏睡с茲違 @author 帥違宴障違荀膣茲違 API т戎翫茲違帥違篏睡с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。
+.LP
.TP 3
-@throws\ class\-name\ description\
-\f2@throws\fP 帥違 \f2@exception\fP 帥違臂сャ＜潟 [箴紊] 絨頳冴菴遵\f2class\-name\fP \f2description\fP 鴻吾莨若帥障\f2class\-name\fP ＜純鴻若醇с箴紊с帥違＜純潟潟鴻帥 doc 潟＜潟с炊鴻с鴻絎絎ц菴違翫Javadoc 若罎膣∫綺緇ｃ鴻｢障障違箴紊 doc 潟＜潟с茲違 \f2@throws\fP 帥違篏睡с障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-鴻с羝推紊ャ＜潟\f2@throws\fP 帥違 throws 膀箴紊絖翫@throws 帥違ャ＜潟сJavadoc 若ｃ箴紊 HTML 阪茯ц菴遵障
-.LP
-.LP
-若若ゃ＜純т紊腓榊絎ｈ翫帥\f2@throws\fP ャ＜潟若激с潟＜純泣鴻潟若障ゃ潟帥с若鴻＜純絎茖＜純潟若翫罕с@throws ャ＜潟若激с潟膓帥{@inheritDoc} 篏睡с障
-.LP
-.LP
-荅括完ゃ
+@throws\ class\-name\ description
+\f2@throws\fP タグと \f2@exception\fP タグは同義です。生成ドキュメントに「例外」小見出しを追加して、 \f2class\-name\fP および \f2description\fP のテキストを書き込みます。 \f2class\-name\fP は、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタの doc コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、Javadoc ツールは、検索順序に従ってクラスを探します。同じまたは異なる例外の doc コメントで、複数の \f2@throws\fP タグを使用できます。
+.LP
+すべてのチェック済み例外がドキュメント化されるようにするために、 \f2@throws\fP タグが throws 節内の例外用に存在しない場合は、@throws タグのあるドキュメントであるかのように、Javadoc ツールによって例外が HTML 出力に説明なしで自動的に追加されます。
+.LP
+オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、 \f2@throws\fP ドキュメンテーションがそのメソッドからサブクラスにコピーされます。インタフェースメソッドから実装メソッドにコピーされる場合も同様です。@throws にドキュメンテーションを継承させるには、{@inheritDoc} を使用できます。
+.LP
+詳細については、
.na
-\f2@throws 帥違ャ＜潟\fP @
+\f2@throws タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionを参照してください。
+.LP
.TP 3
{@value\ package.class#field}
-\f2{@value}\fP ｃ若 doc 潟＜潟 綣違т戎翫絎違ゃ茵腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+\f2{@value}\fP が静的フィールドの doc コメントで 引数なしで使用されている場合、その定数の値が表示されます。
.nf
\f3
.fl
@@ -3034,11 +2261,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-篁紙 doc 潟＜潟у \f2package.class#field\fP т戎翫絎絎違ゃ茵腓冴障
-.LP
+.LP
+任意のドキュメンテーションコメント内で引数 \f2package.class#field\fP ありで使用された場合は、その指定された定数の値が表示されます。
.nf
\f3
.fl
@@ -3056,448 +2280,130 @@
.fl
\fP
.fi
-
-.LP
-.LP
-綣 \f2package.class#field\fP @see 綣違筝綵√障＜潟若ｃ若違鴻違障
-.LP
-.LP
-絎違сゃ
+.LP
+引数 \f2package.class#field\fP は、@see 引数と同一の形式になります。ただし、メンバーが静的フィールドになければならない点が異なります。
+.LP
+これらの定数での値は、
.na
-\f2絎違ｃ若\fP @
+\f2定数フィールド値\fP @
.fi
-http://java.sun.com/javase/6/docs/api/constant\-values.html若吾茵腓冴障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/javase/6/docs/api/constant\-values.htmlページにも表示されます。
+.LP
.TP 3
@version\ version\-text
-\-version 激с潟篏帥翫ャ＜潟 [若吾с] 絨頳冴菴遵絎 \f2version\-text\fP 吾莨若帥障帥違潟若障純с≪憜若吾с括垩篆潟障 絲障@since 潟若絨ャ若吾с括垩篆障\f2version\-text\fP 劫ャ罕障若吾с潟帥違篏睡с贋茯帥鴻帥違篏睡с贋с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-1 ゃャ＜潟若激с潟潟＜潟茲違 \f2@version\fP 帥違с障綽荀綽\f2@version\fP 帥違 1 ゃ若吾с括垩絎帥違茲違若吾с括垩絎с障翫Javadoc 若ｃ潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹ｆャ＜潟障障潟若障ｃ潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
-.LP
-.LP
-荅括完ゃ
+\-version オプションが使用されると、生成ドキュメントに [バージョン] 小見出しを追加し、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。 \f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。
+.LP
+1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。意味が失われない範囲内で、1 つの \f2@version\fP タグに 1 つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が名前の間に挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
+.LP
+詳細については、
.na
-\f2@version 帥違ャ＜潟\fP @
+\f2@version タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionを参照してください。
.RE
-.LP
.SS
-帥違篏睡с贋
-.LP
-с帥違篏睡с贋ゃ茯障\f2@see\fP\f2@since\fP\f2@deprecated\fP\f2{@link}\fP\f2{@linkplain}\fP \f2{@docroot}\fP 帥違鴻 doc 潟＜潟т戎с障
-.RS 3
-
-.LP
+タグを使用できる場所
+.LP
+ここでは、タグを使用できる場所について説明します。すべてのドキュメンテーションコメントで使用可能なタグは次のとおりです。 \f2@see\fP、 \f2@since\fP、 \f2@deprecated\fP、 \f2{@link}\fP、 \f2{@linkplain}\fP、および \f2{@docroot}\fP。
.SS
-网荀ャ＜潟若激с潟帥
-.LP
-.LP
-网荀帥違网荀若吾ャ＜潟若激с潟潟＜潟т戎с帥違с ャ＜潟若激с潟潟＜潟絽 \f2overview.html\fP 純若鴻＜ゃ障祉ャ＜潟若激с潟潟＜潟翫罕帥違筝肢т戎綽荀障
-.LP
-.LP
-\f3羈\fP \- 若吾с 1.2 с网荀ャ＜潟 \f2{@link}\fP 帥違違障鴻罩ｃ頫腓冴障潟荐絎障憜\f2{@docRoot}\fP 帥違网荀ャ＜潟с篏障
-.LP
+概要のドキュメンテーションタグ
+.LP
+概要タグは、概要ページのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは、通常 \f2overview.html\fP という名前のソースファイル内にあります。 ほかのドキュメンテーションコメントの場合と同様に、これらのタグは、主説明のあとで使う必要があります。
+.LP
+\f3注\fP \- バージョン 1.2 では、概要ドキュメント内の \f2{@link}\fP タグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、 \f2{@docRoot}\fP タグは、概要ドキュメント内では動作しません。
+.LP
+\f3概要タグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3网荀帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2279 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3网荀帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-宴若吾ャ＜潟若激с潟帥
-.LP
-.LP
-宴若吾帥違宴若吾ャ＜潟若激с潟潟＜潟т戎с帥違с ャ＜潟若激с潟潟＜潟\f2package.html\fP 障 \f2package\-info.java\fP 純若鴻＜ゃ障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
-.LP
+パッケージドキュメンテーションタグ
+.LP
+パッケージタグは、パッケージのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは \f2package.html\fP または \f2package\-info.java\fP という名前のソースファイル内にあります。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。
+.LP
+\f3パッケージタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3宴若吾帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2315 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3宴若吾帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-鴻潟ゃ潟帥с若鴻ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜鴻障ゃ潟帥с若鴻ャ＜潟若激с潟潟＜潟т戎с帥違腓冴障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
-.LP
+クラスおよびインタフェースドキュメンテーションタグ
+.LP
+次に、クラスまたはインタフェースのドキュメンテーションコメントで使用できるタグを示します。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。
+.LP
+\f3クラスおよびインタフェースタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3鴻潟ゃ潟帥с若鴻帥\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2355 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3罨＜鴻潟＜潟箴腓冴障\fP
-.LP
+\f3次にクラスコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3533,137 +2439,44 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-ｃ若ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜ｃ若ャ＜潟若激с潟潟＜潟т戎с帥違腓冴障
-.LP
+フィールドドキュメンテーションタグ
+.LP
+次に、フィールドのドキュメンテーションコメントで使用できるタグを示します。
+.LP
+\f3フィールドタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@serialField\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-\f2{@value}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3ｃ若帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2436 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3ｃ若帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@serialField\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
+.TP 2
+o
+\f2{@value}\fP
.RE
-\f3罨＜ｃ若潟＜潟箴腓冴障\fP
-.LP
+\f3次にフィールドコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3679,170 +2492,50 @@
.fl
int x = 1263732;
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-潟潟鴻帥潟＜純ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜潟潟鴻帥障＜純ャ＜潟若激с潟潟＜潟ц；腓冴с帥違腓冴障 \f2@return\fP 潟潟鴻帥с茵腓冴с\f2{@inheritDoc}\fP 茵腓冴狗障\f2@serialData\fP 帥違劫翫＜純 doc 潟＜潟с推戎с障
-.LP
+コンストラクタおよびメソッドドキュメンテーションタグ
+.LP
+次に、コンストラクタまたはメソッドのドキュメンテーションコメントで使用できるタグを示します。ただし、 \f2@return\fP はコンストラクタでは使用できず、 \f2{@inheritDoc}\fP には特定の制限があります。 \f2@serialData\fP タグは特定の直列化メソッドの doc コメントでのみ使用できます。
+.LP
+\f3メソッドおよびコンストラクタタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3＜純潟潟潟鴻帥帥\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@param\fP
-.br
-\f2@return\fP
-.br
-\f2@throws\fP \f2@exception\fP
-.br
-\f2@serialData\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@inheritDoc}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2503 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-30
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@param\fP
+.TP 2
+o
+\f2@return\fP
+.TP 2
+o
+\f2@throws\fP と \f2@exception\fP
+.TP 2
+o
+\f2@serialData\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@inheritDoc}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3罨＜＜純ャ＜潟若激с潟潟＜潟箴腓冴障\fP
-.LP
+\f3次にメソッドのドキュメンテーションコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3874,22 +2567,13 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-.RE
-.SH "激с"
-.LP
-.LP
-javadoc 若篏帥ｃ阪羆阪障Javadoc 若\-doclet 激с潟с鴻帥絎翫篁ュ罔羣篏帥障Javadoc 若篁紙篏睡с潟潟茵激с潟障 激с潟ゃJavadoc 激с潟ц障罔羣с祉ゃ菴遵潟潟茵激с潟箴障 激с潟ゃ罔羣箴激с潟ц障激с喝紊ф絖絨絖阪ャ障 激с潟綣違с紊ф絖絨絖阪ャ障
-.LP
-.LP
-激с潟罨＜腓冴障
-.LP
-.RS 3
-
-.LP
+.SH "オプション"
+.LP
+javadoc ツールは、ドックレットを使って出力を決定します。Javadoc ツールは、\-doclet オプションでカスタムドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使います。Javadoc ツールには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、このあとの「Javadoc オプション」で説明します。標準ドックレットでは、このほかに、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、そのあとの「標準ドックレットが提供するオプション」で説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。
+.LP
+オプションは次のとおりです。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -4043,6 +2727,8 @@
.br
\-\f2sourcepath\fP
.br
+\-sourcetab
+.br
\-splitindex
.br
\-stylesheetfile
@@ -4055,6 +2741,8 @@
.br
\-tagletpath
.br
+\-top
+.br
\-title
.br
\-use
@@ -4101,7 +2789,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 2680 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 2009 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4157,54 +2845,49 @@
.rm b+
.rm c+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
-
-.LP
-.RE
-.LP
-\f2ゃ帥\fPхず激с潟Javadoc 堺激с潟сJavadoc 若潟潟ｃ箴鴻т戎с障罔羣篏ゃ帥с激с潟箴障
-.LP
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-127
+.LP
+\f2イタリック\fP で示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。
.SS
-Javadoc 激с
-.LP
+Javadoc オプション
.RS 3
.TP 3
\-overview \ path/filename
-Javadoc 絲障\f2path/filename\fP ф絎純若鴻＜ゃ网荀ャ＜潟鴻緇鴻网荀若 (\f2overview\-summary.html\fP) 臀絎障\f2path/filename\fP \f2\-sourcepath\fP 吾後障鴻с
-.LP
-\f2filename\fP \f2path\fP 篁紙贋絎с障絽吾\f2overview.html\fP 篁純若鴻弱筝篏宴若吾ｃｃ臀障贋臀\f2\-sourcepath\fP ｃ＜ゃ腓冴с宴若吾ャ＜潟 \f2path\fP 筝荀障違\f2java.lang\fP 宴若吾純若鴻若 \f2/src/classes/java/lang/\fP 翫网荀＜ゃ \f2/src/classes/overview.html\fP 臀с障篏睡箴с
-.LP
-\f2path/filename\fP ф絎＜ゃゃ网荀潟＜潟＜ゃс
-.LP
-网荀若吾篏Javadoc 茲違宴若後羝＜翫с荅括完HTML 若с
-.LP
-网荀若吾帥ゃ\f2\-doctitle\fP ｃ荐絎障
+Javadoc に対して、\f2path/filename\fP で指定された「ソース」ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ (\f2overview\-summary.html\fP) に配置するように指定します。 \f2path/filename\fP は、カレントディレクトリからの相対パスです。
+.LP
+\f2filename\fPで任意の名前を使用し、\f2path\fP で任意の配置先を選択することも可能ですが、通常は \f2overview.html\fP という名前を付け、ソースツリー内の最上位パッケージディレクトリを含むディレクトリ内に配置します。この場所に配置すると、パッケージをドキュメント化するときに \f2path\fP を指定する必要がなくなります。なぜなら、 \f2\-sourcepath\fP によってこのファイルが指し示されるからです。たとえば、 \f2java.lang\fP パッケージのソースツリーが \f2/src/classes/java/lang/\fP の場合、概要ファイルを \f2/src/classes/overview.html\fP に配置できます。「使用例」を参照してください。
+.LP
+\f2path/filename\fP で指定するファイルについては、「概要コメントファイル」を参照してください。
+.LP
+概要ページが作成されるのは、Javadoc に複数のパッケージ名を渡した場合だけです。詳細は、「HTML フレーム」を参照してください。
+.LP
+概要ページのタイトルは、\f2\-doctitle\fP によって設定されます。
.LP
.TP 3
\-public
-public 鴻潟＜潟若茵腓冴障
+public クラスおよびメンバーだけを表示します。
.LP
.TP 3
\-protected
-protected public 鴻＜潟若茵腓冴障荐絎с
+protected および public のクラスとメンバーだけを表示します。これがデフォルトです。
.LP
.TP 3
\-package
-packageprotected public 鴻＜潟若茵腓冴障
+package、protected、および public のクラスとメンバーだけを表示します。
.LP
.TP 3
\-private
-鴻鴻＜潟若茵腓冴障
+すべてのクラスとメンバーを表示します。
.LP
.TP 3
\-help
-潟ゃ潟茵腓冴障 Javadoc 潟潟茵激с潟筝荀ц；腓冴障
+オンラインヘルプを表示します。Javadoc とドックレットのコマンド行オプションが一覧表示されます。
.LP
.TP 3
\-doclet\ class
-ャ＜潟篏帥莎桁鴻＜ゃ絎障絎絎絎阪絎鴻綵√絎臂障\f4\-doclet\fP 激с潟篏帥翫Javadoc 罔羣篏帥ｃ HTML 綵√障鴻\f2start(Root)\fP ＜純障違障莎桁鴻吾鴻\f2\-docletpath\fP 激с潟ｃ絎臂障
-.LP
-違MIF 若喝冴罨＜絎障
+ドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。完全指定の名前を指定してください。このドックレットにより、出力の内容と形式が定義されます。\f4\-doclet\fP オプションが使われていない場合、Javadoc は、標準ドックレットを使ってデフォルトの HTML 形式を生成します。このクラスには \f2start(Root)\fP が含まれている必要があります。この起動クラスへのパスは \f2\-docletpath\fP オプションによって定義されます。
+.LP
+たとえば、MIF ドックレットを呼び出すには、次のように指定します。
.nf
\f3
.fl
@@ -4213,17 +2896,17 @@
\fP
.fi
.LP
-劫絎茵絎箴ゃ
+特定のドックレットを実行した完全な例については、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
.LP
.TP 3
\-docletpath\ classpathlist
-\f2\-doclet\fP 激с潟ф絎紮鴻＜ゃ潟箴絖鴻 jar ＜ゃ吾鴻絎障紮鴻＜ゃ jar ＜ゃ翫篁ヤ箴 jar ＜ゃ鴻絎障腟九障鴻障憜ｃ後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR ＜ゃс障 翫鴻障 JAR ＜ゃSolaris 翫潟 (:)Windows 翫祉潟 (;) у阪障紮鴻с罎膣≪劫翫激с潟筝荀с
-.LP
-jar ＜ゃ吾鴻箴紮鴻＜ゃ障障jar ＜ゃ障鴻羈
+\f2\-doclet\fP オプションで指定されたドックレット開始クラスファイル、 およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。開始クラスファイルが jar ファイル内にある場合、以下の例のように jar ファイルのパスが指定されます。絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP には、複数のパスまたは JAR ファイルを含めることができます。 その場合、各パスまたは JAR ファイルを、Solaris の場合にはコロン (:)、Windows の場合にはセミコロン (;) で区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。
+.LP
+jar ファイルへのパスの例には、ドックレット開始クラスファイルが含まれています。jar ファイル名が含まれている点に注目してください。
.nf
\f3
.fl
@@ -4231,7 +2914,7 @@
.fl
\fP
.fi
-紮鴻＜ゃ鴻箴鴻＜ゃャ鴻羈
+ドックレット開始クラスファイルのパスの例。クラスファイル名が省略されている点に注目してください。
.nf
\f3
.fl
@@ -4239,212 +2922,40 @@
.fl
\fP
.fi
-劫絎茵絎箴ゃ
+特定のドックレットを実行した完全な例については、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
.LP
.TP 3
\-1.1
-\f2罘純Javadoc 1.4 сゃ障篁ｆ炊純障激с潟Javadoc 1.1 ｃ紊荀罘純ゃャ＜潟篏с ャ絖鴻泣若障激с潟綽荀翫Javadoc 1.2 障 1.3 篏睡\fP
+\f2この機能は Javadoc 1.4 から削除されました。代替機能はありません。このオプションは、Javadoc 1.1 によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした。入れ子のクラスはサポートされていません。このオプションが必要な場合は、Javadoc 1.2 または 1.3 を使用してください。\fP
.LP
.TP 3
\-source release
-篁純若鴻潟若若吾с潟絎障\f2release\fP 罨＜ゃ絎с障
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80 81
-.nr 34 \n(.lu
-.eo
-.am 81
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.5 уャ膩霡違割荐茯罘純潟若篁障\f3\-source\fP 違絎潟潟ゃ 1.5 篏障
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.4 уャ≪泣若激с潟潟若篁障
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di c+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
-.br
-.di
-.nr c| \n(dn
-.nr c- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 31 0
-.nr 32 0
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.5\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.4\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.3\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.80
-.rm 80
-.nr 60 \n(31
-.nr 38 \n(60+\n(32
-.if \n(38>\n(80 .nr 80 \n(38
-.if \n(38<\n(80 .nr 60 +(\n(80-\n(38)/2
-.nr 81 0
-.81
-.rm 81
-.nr 38 \n(a-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(b-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(c-
-.if \n(81<\n(38 .nr 81 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr 60 +\n(40
-.nr 41 \n(80+(3*\n(38)
-.nr 81 +\n(41
-.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 2790 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.5\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.4\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(c|u+\n(.Vu
-.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.3\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.c+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.rm c+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
-.LP
-javac с潟若潟潟ゃ篏睡ゃ絲上 \f2release\fP ゃ篏睡障
+受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
+.RS 3
+.TP 2
+o
+\f31.5\fP \- javadoc は、JDK 1.5 で導入された総称などの言語機能を含むコードを受け付けます。\f3\-source\fP フラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5 のものになります。
+.TP 2
+o
+\f31.4\fP Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
+.TP 2
+o
+\f31.3\fP Javadoc は、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
+.RE
+.LP
+javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。
.LP
.TP 3
\-sourcepath\ sourcepathlist
-\f2javadoc\fP 潟潟宴若後障 \f2\-subpackages\fP 羝＜純若鴻＜ゃ (\f2.java\fP) 罎膣≪鴻絎障\f2sourcepathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎剛札筝鴻泣ｃ罎膣≪障激с潟篏帥ｃャ＜潟純若鴻＜ゃ篏臀с篏ャ＜潟ャ＜潟純若鴻＜ゃ膓帥潟＜潟ゃ純若鴻＜ゃ篏臀腆肴с障
-.LP
-\f2\-sourcepath\fP 激с潟javadoc 潟潟宴若後羝＜篏睡с障 \f2javadoc\fP 潟潟羝＜ \f2.java\fP ＜ゃ鴻罎膣≪障\f2.java\fP ＜ゃ罎膣≪＜ゃｃ cd ｃ腱糸障＜ゃ鴻障 (1 や札筝鴻ャ＜潟)\f2\-sourcepath\fP ャ翫Javadoc 鴻鴻篏帥ｃ純若鴻＜ゃ罎膣≪障 (\-classpath )ｃ \-sourcepath 鴻鴻ゃс\-classpath ャ宴若後 Javadoc 羝＜Javadoc 憜ｃ潟泣ｃ純若鴻＜ゃ罎膣≪障
-.LP
-\f2sourcepathlist\fP ャ＜潟宴若後純若鴻若若ｃ荐絎障違\f2com.mypackage\fP 宴若吾ャ＜潟翫純若鴻＜ゃ罨＜贋障
+パッケージ名または \-subpackages を javadoc コマンドに渡すときは、ソースファイル (.\f2.java\fP) を見つけるための \f2検索パス\fP を指定 \f2します\fP 。\f2sourcepathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使って、ドキュメント化されるソースファイルの位置だけでなく、それ自体はドキュメント化されないがドキュメント化されるソースファイルから継承されたコメントを持つソースファイルの位置も確認できます。
+.LP
+\f2\-sourcepath\fP オプションを使用できるのは、javadoc コマンドにパッケージ名を渡す場合だけです。このパスからは、javadoc コマンドに渡された \f2.java\fP ファイルは \f2検索\fP されません。 \f2.java\fP ファイルを検索するには、そのファイルのあるディレクトリに cd によって移動するか、または各ファイルの先頭にパスを含めます (「1 つ以上のクラスのドキュメント化」を参照)。 \f2\-sourcepath\fP が省略された場合、Javadoc は、クラスパスを使ってソースファイルを検索します (\-classpath を参照)。したがって、デフォルトの \-sourcepath は、クラスパスの値です。\-classpath も省略してパッケージ名を Javadoc に渡すと、Javadoc は現在のディレクトリおよびそのサブディレクトリからソースファイルを検索します。
+.LP
+\f2sourcepathlist\fP には、ドキュメント化するパッケージ名のソースツリーのルートディレクトリを設定します。たとえば、 \f2com.mypackage\fP という名前のパッケージをドキュメント化する場合に、そのソースファイルが次の場所にあるとします。
.nf
\f3
.fl
@@ -4452,16 +2963,16 @@
.fl
\fP
.fi
-翫罨＜ \f2sourcepath\fP \f2/home/user/src\fPゃ障 \f2com/mypackage\fP ｃ絎宴若後 \f2com.mypackage\fP 絎障
+このとき次のように、 \f2sourcepath\fP を、com/mypackage を含むディレクトリである \f2/home/user/src\fP に指定したあと、 パッケージ名 \f2com.mypackage\fP を指定します。
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP
.fl
.fi
-号純若鴻鴻ゃ宴若後ｇ (荐) \\紊宴若吾 (C:\\user\\src\\com\\mypackage) 茹ｃ膂≦с\f2/home/user/src/com/mypackage\fP.
-.LP
-2 ゃ純若鴻鴻荐絎罨＜障
+この方法は、ソースパスの値とパッケージ名を連結して、ドットを (円記号) 「\\」に変えると、パッケージのフルパス \f2/home/user/src/com/mypackage になることを理解すると簡単です\fP。
+.LP
+2 つのソースパスを設定するには、次のようにします。
.nf
\f3
.fl
@@ -4471,132 +2982,124 @@
.LP
.TP 3
\-classpath\ classpathlist
-Javadoc с (\f2.class\fP ＜ゃ) 罎膣≪鴻絎障 с鴻ャ＜潟鴻鴻ｃс鴻鴻с\f2classpathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣ｃ罎膣≪障\f2classpathlist\fP 絎
+javadoc が参照クラス (\f2.class\fP ファイル) の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスから参照されるすべてのクラスを指します。\f2classpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。 Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。classpathlist を指定するときは、
.na
-\f2鴻\fP @
+\f2クラスパス\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalャ＜潟腓冴緇ｃ
-.LP
-\f2\-sourcepath\fP ャ翫Javadoc 若\f2\-classpath\fP 篏帥ｃ鴻＜ゃс純若鴻＜ゃ罎膣≪障 (筝篏篋с)ｃ純若鴻＜ゃ鴻＜ゃャ鴻罎膣≪綽荀翫\f2\-sourcepath\fP \f2\-classpath\fP 筝≧鴻篏帥障
-.LP
-違\f2com.mypackage\fP ャ＜潟翫純若鴻＜ゃｃ \f2/home/user/src/com/mypackage\fP 宴若吾 \f2/home/user/lib\fP ゃ篏帥с違罨＜絎障
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalのドキュメントにある指示 \f2に従ってください\fP。
+.LP
+\f2\-sourcepath\fP が省略されると、Javadoc ツールはクラスファイルを検索するときだけでなく、ソースファイルを検索するときにも \f2\-classpath\fP を使用します (下位互換性のため)。したがって、ソースファイルとクラスファイルを別々のパスから検索する必要がある場合は、 \f2\-sourcepath\fP と \f2\-classpath の両方を使います\fP.。
+.LP
+たとえば、 \f2com.mypackage\fP をドキュメント化する場合に、そのソースファイルがディレクトリ \f2/home/user/src/com/mypackage\fP 内に格納されており、このパッケージが \f2/home/user/lib\fP 内のライブラリに依存しているとします。このとき次のように指定します。
.nf
\f3
.fl
% \fP\f3javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage\fP
.fl
.fi
-祉若罕\f2\-classpath\fP 絎翫CLASSPATH 医紊違荐絎違Javadoc 若医紊違篏帥障＜荐絎翫Javadoc 若憜ｃ鴻罎膣≪障
-.LP
-Javadoc 若≦宍罘純鴻潟若鴻鴻∫ｃJavadoc 若 \f2\-classpath\fP 篏睡若吟若鴻罎膣≪号ゃ荅括完
+\f2\-classpath\fP が指定されなかった場合、Javadoc ツールはほかのツールと同じく、CLASSPATH 環境変数が設定されていればその値を使用します。どちらも設定されていない場合、Javadoc ツールは現在のディレクトリからクラスを検索します。
+.LP
+Javadoc ツールが \f2\-classpath\fP を使用してユーザークラスを検索する方法について、拡張クラスやブートストラップクラスと関連付けて説明している情報を入手するには、
.na
-\f2鴻罎膣∽号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html荀с
-.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。
+.LP
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。* だけから成る \f2クラスパスエントリは、\fP カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.LP
.TP 3
\-subpackages\ \ package1:package2:...
-純若鴻＜ゃ絎宴若吾潟泣宴若後絽亥ャ＜潟障激с潟純若鴻潟若違泣宴若吾菴遵箴水с違泣宴若吾腟粋昭障障 \f2package\fP 綣違篁紙筝篏泣宴若 (\f2java\fP ) 障絎絎宴若 (\f2javax.swing\fP ) 障純若鴻＜ゃ綽荀障綣違潟潟у阪障 (鴻若ｃ潟違激鴻)ゃ若筝荀с (篏睡筝)宴若吾罎膣√贋絎\f2\-sourcepath\fP 篏睡障激с潟純若鴻＜ゃц純若鴻若宴若吾絮純若鴻＜ゃу醜腴＜障
-.LP
-箴腓冴障
+ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソースコードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。各 \f2package\fP 引数は、任意の最上位サブパッケージ ( \f2java\fP など) または完全修飾パッケージ ( \f2javax.swing\fP など) になります。ソースファイルを含める必要はありません。引数は、コロンで区切られます (すべてのオペレーティングシステム)。ワイルドカードは不要です (使用不可)。パッケージの検索場所を指定するには、\f2\-sourcepath\fP を使用します。このオプションは、「ソースファイルの処理」で説明したとおり、ソースツリーにあるがパッケージには属していないソースファイルを処理しないので役立ちます。
+.LP
+たとえば、
.nf
\f3
.fl
% \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
.fl
.fi
-潟潟java潟javax.swing宴若吾泣宴若後ャ＜潟障
-.LP
-\f2\-exclude\fP \f2\-subpackages\fP 篏睡劫宴若吾ゅс障
+このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。
+.LP
+\f2\-subpackages\fP と \f2\-exclude\fP を組み合わせて使用すると、特定のパッケージを除外できます。
.LP
.TP 3
\-exclude\ \ packagename1:packagename2:...
-絎宴若吾泣宴若吾 \f2\-subpackages\fP ｃ篏鴻≧＞散ゅ障ｻ \f2\-subpackages\fP 激с潟絎ｃ腟粋昭障宴若吾障絨ョ粋昭障宴若吾ゅ絲乗院障箴腓冴障
+指定されたパッケージとそのサブパッケージを \f2\-subpackages\fP によって作成されたリストから無条件に除外します。 過去の \f2\-subpackages\fP オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。 次に例を示します。
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
.fl
.fi
-＜\f2java.io\fP\f2java.util\fP\f2java.math\fP 腟粋昭障障\f2java.net\fP \f2java.lang\fP 篁ヤ宴若吾ゅ障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
+この場合、 \f2java.io\fP、 \f2java.util\fP、 \f2java.math\fP などが含められ、 \f2java.net\fP と \f2java.lang\fP をルートに持つパッケージが除外されます。この場合、 \f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP も除外される点に注意してください。
.LP
.TP 3
\-bootclasspath\ classpathlist
-若鴻絖鴻絎障若鴻絽吾Java 若潟≪鴻с若鴻鴻Javadoc 若純若鴻＜ゃ鴻＜ゃ｢篏帥罎膣≪鴻筝с荅括完
+ブートクラスが存在するパスを指定します。ブートクラスとは、通常、Java プラットフォームのコアクラスのことです。ブートクラスパスは、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、
.na
-\f2javac javadoc 鴻罎膣≪号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesс\f2classpathlist\fP 茲違ｃ潟 (:) у阪障
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。コロン (:) を、 \f2classpathlist\fP 内のディレクトリ間の区切り文字として使用します。
.LP
.TP 3
\-extdirs\ dirlist
-≦宍罘純鴻絖ｃ絎障≦宍罘純鴻Java ≦宍罘醇罕篏帥鴻鴻сextdirs Javadoc 若純若鴻＜ゃ鴻＜ゃ｢篏帥罎膣≪鴻筝с荅括完菴違 \f2\-classpath\fP с\f2dirlist\fP 茲違ｃ潟 (:) у阪障
+拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java 拡張機能機構を使うすべてのクラスです。extdirs は、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、前述の \f2\-classpath\fP を参照してください。コロン (:) を、 \f2dirlist\fP 内のディレクトリ間の区切り文字として使用します。
.LP
.TP 3
\-verbose
-javadoc 絎茵筝荅括完＜祉若吾茵腓冴障verbose 激с潟絎純若鴻＜ゃ若ャ＜潟 (純若鴻＜ゃ 1 ゃ＜祉若)潟純若＜祉若吾茵腓冴障verbose 激с潟絎 Java 純若鴻＜ゃ茹ｆ荀 (腱篏) 菴遵＜祉若吾茵腓冴障
+javadoc の実行中に詳細なメッセージを表示します。verbose オプションを指定しないと、ソースファイルのロード時、ドキュメントの生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時にメッセージが表示されます。verbose オプションを指定すると、各 Java ソースファイルの解析に要した時間 (ミリ秒単位) など、追加のメッセージが表示されます。
.LP
.TP 3
\-quiet
-若＜祉若吾障茘＜祉若娯札紊＜祉若吾吟茘若茵腓冴劫障若吾с恰絖吟障
+エラーメッセージまたは警告メッセージ以外のメッセージを抑制し、警告とエラーだけが表示されるようにして、これらを特定しやすくします。バージョン文字列も抑制します。
.LP
.TP 3
\-breakiterator\
-沿荐茯宴若堺≪眼冴с
+英語の最初の文の末尾を決定する際に、英語用のロケール固有のアルゴリズムではなく、
.na
\f2java.text.BreakIterator\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html 初紜篏睡掩腟ゆ障 (篁鴻宴若с \f2BreakIterator\fP 篏睡)\f2\fP宴若吾鴻障＜潟若筝肢сс宴若吾鴻障＜潟若荀膣潟若≪＜ゃ潟鴻潟若障
-.LP
-JDK 1.2 篁ラBreakIterator 鴻沿ゃ鴻荐茯腟ゆс篏睡障ｃ1.2 篁ラс\f2\-breakiterator\fP 激с潟掩篁ュ号障掩罨＜≪眼冴障
+http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html の国際化された文境界を使用します (ほかのすべてのロケールではすでに \f2BreakIterator\fP が使用されている)。\f2「最初の文」\fPとは、パッケージ、クラス、またはメンバーの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバーの要約にコピーされ、アルファベット順のインデックスにコピーされます。
+.LP
+JDK 1.2 以降、BreakIterator クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、 \f2\-breakiterator\fP オプションは、1.2 以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。
.RS 3
.TP 2
o
-掩阪≪眼冴 \- 腥榊純障 HTML 帥 (\f2<P>\fP ) 膓у罩≪
+英文のデフォルトの文区切りアルゴリズム \- 空白または HTML ブロックタグ ( \f2<P>\fP など) が続くピリオドで停止する
.TP 2
o
-breakiterator 阪≪眼冴 \- 筝罨＜茯紊ф絖у障翫腥榊醇絖膓霳障膃у罩≪≪眼冴с祉ヨ；荐 (The serial no. is validMr. Smith)HTML 帥違医障荐垩у障с罩≪HTML 帥違莨若障翫с../filename緇у罩≪
+breakiterator 文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止する。このアルゴリズムでは「The serial no. is valid」など、ほとんどの省略表記が処理されますが、「Mr. Smith」などは処理されません。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する
.RE
-.RS 3
-
-.LP
-.LP
-羈: 1.5.0 1.4.x 荐 breakiterator 茘＜祉若吾ゃ阪≪眼冴紊眼障ゃ障\\\-breakiterator 激с潟1.5.0 сс障ゃ障罨＜＜吾ｃ若若鴻(1.5.0) с紊眼篁ュｃ障ゃ障純若鴻潟若紊眼1.4.x с breakiterator 茘ゅｻ翫с1.5.0 篏綽荀茘羔羯障 祉宴breakiterator ＜綽荀篋с純若鴻紊眼鴻莢紊сｃс篁吟х罕篏羞隙恒荅潟障
-.LP
-.RE
+.LP
+注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\\\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。この件で皆様に余分の手間をおかけし、混乱を招いたことをお詫びいたします。
.TP 3
\-locale\ language_country_variant
-.RS 3
-.LP
-\f3荀\fP \- \f2\-locale\fP 激с潟罔羣箴鴻激с潟障篁篁紙箴鴻激с潟 (綏) 絎綽荀障蚊若激с潟若沿ц；腓冴障潟潟茵激с潟絎綺箴絖障
-.LP
-.RE
-.LP
-Javadoc ャ＜潟篏帥宴若絎障綣違java.util.Locale ャ＜潟ц宴若絎障違\f2en_US\fP (沿膠喝)\f2en_US_WIN\fP (Windows т戎沿) 絎障
-.LP
-宴若絎絎宴若純若鴻＜ゃ Javadoc ｃ御＜祉若 (蚊若激с潟若鴻茵荀冴＜ゃ罨＜stylesheet.css 潟＜潟絖) 篏帥障障≪＜純若鴻純若恰絨障ゅャ阪絖絎宴若ｃ羆冴障障激с潟ャ＜潟鴻純若鴻＜ゃф絎ャ＜潟若激с潟潟＜潟鴻宴若羆阪с障
+.LP
+\f3重要\fP \- \f2\-locale\fP オプションは、\f2標準ドックレットが提供するすべてのオプション\fP、またはその他の任意のドックレットの提供するすべてのオプションより前 (左側) に指定する必要があります。そうしないと、ナビゲーションバーが英語で表示されます。このコマンド行オプションだけは、指定する順序に依存します。
+.LP
+Javadoc がドキュメントを生成するときに使うロケールを指定します。この引数は次のような、java.util.Locale のドキュメンテーションで説明されているロケールの名前です。 \f2en_US\fP (英語、米国) または \f2en_US_WIN\fP (Windows で使用される英語)。
+.LP
+ロケールを指定すると、指定したロケールのリソースファイルが Javadoc によって選択されて、メッセージ (ナビゲーションバー、リストと表の見出し、ヘルプファイルの目次、stylesheet.css のコメントなどの文字列) のために使われます。また、アルファベット順にソートされるリストのソート順、および最初の文の末尾を判別するための文の区切り文字も、指定したロケールによって決まります。ただし、このオプションは、ドキュメント化されるクラスのソースファイル内で指定されているドキュメンテーションコメントのテキストのロケールを決定するものではありません。
.LP
.TP 3
\-encoding\ name
-純若鴻＜ゃ潟潟若ｃ潟違 (\f2EUCJIS/SJIS\fP ) 絎障激с潟絎翫若潟潟若帥篏帥障
-.LP
-\-docencoding \-charset с
+ソースファイルのエンコーディングの名前 ( \f2EUCJIS/SJIS\fP など) を指定します。 このオプションが指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
+.LP
+\-docencoding および \-charset も参照してください。
.LP
.TP 3
\-Jflag
-javadoc 絎茵絎茵激鴻 java \f2flag\fP 贋･羝＜障\f2J\fP \f2flag\fP 腥榊純ャ障違ャ＜潟激鴻 32M ゃ＜≪若腆坂鏆荀翫Java \f2\-Xmx\fP 激с潟罨＜若喝冴障 \f2\-Xms\fP ュ純с ＜≪若泣ゃ冴荐絎激с潟с綽荀＜≪若絨泣ゃ冴ｃ翫箴水с
+javadoc を実行する実行時システム java に、\f2flag\fP を直接渡します。 \f2J\fP と \f2flag\fP の間に空白を入れないように注意してください。たとえば、生成ドキュメントの処理用として32M バイトのメモリーをシステムで確保しておく必要がある場合には、java の \f2\-Xmx\fP オプションを次のように呼び出します。\f2\-Xms\fP は省略可能です。これは、メモリーの初期サイズを設定するだけのオプションで、メモリーの最低必要量がわかっている場合に便利です。
.nf
\f3
.fl
% \fP\f3javadoc \-J\-Xmx32m \-J\-Xms32m\fP \f3com.mypackage\fP
.fl
.fi
-篏睡 javadoc 若吾с潟腆肴罨＜ java \f2\-version\fP激с潟若喝冴障
+使用している javadoc のバージョンを確認するには、次のように Java の\f2「\-version」\fPオプションを呼び出します。
.nf
\f3
.fl
@@ -4607,17 +3110,16 @@
Classic VM (build JDK\-1.2\-V, green threads, sunwjit)
.fl
.fi
-阪鴻若罔羣若吾с括垩障障
+出力ストリームには標準ドックレットのバージョン番号が含まれます。
.RE
.SS
-罔羣箴激с
-.LP
+標準ドックレットが提供するオプション
.RS 3
.TP 3
\-d\ directory
- HTML ＜ゃ篆絖ｃ絎障(d (destination))激с潟ャ＜ゃ憜ｃ篆絖障 \f2directory\fP 腟九障ｃ障憜篏罐ｃ後障ｃ絎с障若吾с 1.4 сjavadoc 絎茵ｃ篏障
-.LP
-違罨＜箴с\f2com.mypackage\fP 宴若吾ャ＜潟腟 \f2/home/user/doc/\fP ｃ篆絖障
+生成された HTML ファイルを保存する生成先ディレクトリを指定します(「d」は「生成先 (destination)」の意味)。このオプションを省略すると、生成されたファイルは現在のディレクトリに保存されます。値 \f2directory\fP には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。バージョン 1.4 では、javadoc を実行すると生成先ディレクトリが自動的に作成されます。
+.LP
+たとえば次の場合、パッケージ \f2com.mypackage\fP のドキュメントが生成され、その結果が \f2/home/user/doc/\fP ディレクトリに保存されます。
.nf
\f3
.fl
@@ -4627,50 +3129,50 @@
.LP
.TP 3
\-use
-ャ＜潟鴻潟宴若吾 1 ゃ [篏睡] 若吾腟粋昭帥障若吾劫鴻障宴若吾 API 篏帥ｃ宴若吾鴻＜純潟潟鴻帥潟ｃ若荐菴違障違 C 箴 C 篏帥ｃC 泣鴻C 絎ｈｃ若C 菴＜純潟 C ＜若帥ゃ＜純潟潟鴻帥障
-.LP
-違String [篏睡] 若吾篏茵腓冴荀帥障\f2java.awt.Font\fP 鴻 \f2getName()\fP ＜純\f2String\fP 菴障ｃ\f2getName()\fP \f2String\fP 篏帥ｃс\f2String\fP [篏睡] 若吾＜純障
-.LP
-ャ＜潟 API 篏睡сｃ絎茖ャ＜潟障＜純絎茖筝 \f2String\fP 篏帥ｃ綣違絖ｃ絖菴翫\f2String\fP 篏睡帥障
-.LP
- [篏睡] 若吾≪祉鴻鴻障宴若吾腱糸蚊若激с潟若 [篏睡] 潟障
+ドキュメント化されるクラスおよびパッケージごとに 1 つの「使用」ページを組み込みます。このページには、その特定のクラスまたはパッケージの API を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラス C を例にとると、クラス C を使っているものとしては、C のサブクラス、C として宣言されているフィールド、C を返すメソッド、および、型 C のパラメータを持つメソッドとコンストラクタがあります。
+.LP
+たとえば、String の [使用] ページに何が表示されるかを見てみましょう。java.awt.Font クラスの \f2getName()\fP メソッドは、 \f2String\fP 型の値を \f2返します\fP。したがって、 \f2getName()\fP は \f2String\fP を使用しているので、String の [使用] ページに \f2このメソッドが表示されます\fP。
+.LP
+ただし、ドキュメント化されるのは API の使用だけであって、実装はドキュメント化されません。あるメソッドが、その実装の中で \f2String\fP を使っていても、引数として文字列をとったり、文字列を返したりしない場合は、 \f2String\fP の「使用」とはみなされません。
+.LP
+生成された [使用] ページにアクセスするには、目的のクラスまたはパッケージに移動し、ナビゲーションバーの [使用] リンクをクリックします。
.TP 3
\-version
-ャ＜潟@version 鴻腟粋昭帥障鴻сャ障篏睡 Javadoc 若若吾с潟腆肴\f2\-J\-version\fP 激с潟篏睡障
+生成ドキュメントに、@version のテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している Javadoc ツールのバージョンを確認するには \f2\-J\-version\fP オプションを使用します。
.LP
.TP 3
\-author
-ャ＜潟@author 鴻腟粋昭帥障
+生成ドキュメントに、@author のテキストを組み込みます。
.LP
.TP 3
\-splitindex
-膣√＜ゃ≪＜茲違＜ゃ蚊絖 1 ゃ＜ゃ≪＜篁ュ絖у障膣√潟 1 ゃ＜ゃ篏障
+索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる索引エントリ用に 1 つのファイルを作成します。
.LP
.TP 3
\-windowtitle\ title
-HTML <title> 帥違臀帥ゃ絎障絎帥ゃｃ潟帥ゃ若吾絲障篏吟若 (羂ャ) 茵腓冴障帥ゃ HTML 帥違с 帥ゃ HTML 帥違障吟帥違罩ｃ頵ｉс障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障\-windowtitle ャ翫Javadoc 若激с潟篁ｃ \-doctitle ゃ篏帥障
+HTML の <title> タグに配置するタイトルを指定します。指定したタイトルは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク (お気に入り) に表示されます。このタイトルには HTML タグを含めないでください。タイトルに HTML タグが含まれていると、ブラウザがタグを正しく解釈できません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。\-windowtitle が省略されている場合、Javadoc ツールは、このオプションの代わりに \-doctitle の値を使います。
.nf
\f3
.fl
- % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
+ % \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
.fl
.fi
.TP 3
\-doctitle\ title
-网荀＜ゃ筝菴臀帥ゃ絎障帥ゃ筝紊 1 荀冴筝蚊若激с潟若筝臀障\f2title\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル 1 の見出しとして、上部ナビゲーションバーのすぐ下に置かれます。\f2title\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
.nf
\f3
.fl
- % \fP\f3javadoc \-doctitle "Java (TM)" com.mypackage\fP
+ % \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
.fl
.fi
.TP 3
\-title\ title
-\f3激с潟憜絖障\fPJavadoc 1.2 若睡絖障激с潟\f2\-doctitle\fP 紊眼障紊眼宴激с潟ｃ潟帥ゃсャ＜潟帥ゃ絎臂腆冴с
+\f3このオプションはもう存在していません。\fPこのオプションは Javadoc 1.2 のベータ版にしか存在していませんでした。このオプションの名前は \f2\-doctitle\fP に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。
.LP
.TP 3
\-header\ header
-阪＜ゃ筝腴臀若鴻絎障若筝蚊若激с潟若勀眼臀障\f2header\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2header\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの上端に配置するヘッダーテキストを指定します。ヘッダーは、上部ナビゲーションバーの右側に配置されます。\f2header\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2header\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
.nf
\f3
.fl
@@ -4680,73 +3182,77 @@
.LP
.TP 3
\-footer\ footer
-阪＜ゃ筝腴臀帥若鴻絎障帥若筝蚊若激с潟若勀眼臀障 \f2footer\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2footer\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの下端に配置するフッターテキストを指定します。フッターは、下部ナビゲーションバーの右側に配置されます。\f2footer\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2footer\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+.LP
+.TP 3
+\-top
+各出力ファイルの上端に配置するテキストを指定します。
.LP
.TP 3
\-bottom\ text
-阪＜ゃ筝臀鴻絎障鴻筝蚊若激с潟若筝若吾筝臀障\f2text\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2text\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーションバーより下の、ページの最下部に配置されます。 \f2text\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。引用符を \f2text\fP 内で使用する場合、引用符をエスケープしなければならない可能性があります。
.LP
.TP 3
\-link\ extdocURL
-javadoc √紊с鴻ャ＜潟若激с潟吾潟篏障綣違 1 ゃ障
+javadoc により生成された既存の外部参照クラスのドキュメンテーションへのリンクを作成します。引数を 1 つとります。
.LP
.RS 3
.TP 2
o
-\f4extdocURL\fP 潟絎javadoc ｃ紊ャ＜潟ｃ腟九 URL 障後 URL ст腓冴障ｃ宴若吾鴻＜ゃ絖違障 絖翫\f2\-linkoffline\fP 篏睡障Javadoc 若\f2宴若吾鴻\fP＜ゃ宴若後茯水宴若吾 URL 潟障Javadoc 若絎茵篏 \f2<A HREF>\fP 潟 \f2extdocURL\fP ゃ障障潟若障ｃ\f2extdocURL\fP ＜ゃ吾 URL сｃ吾 URLс違障
-.LP
-\f2extdocURL\fP 吾腟九障潟篏睡若吟若ャ＜潟篁紙 Web 泣ゃ筝ャ＜潟潟с障 後鞘臀吾潟с翫後障潟篏睡с障後障潟篏睡翫\f2\-d\fP 篏帥ｃｃ潟宴若吾ｃ後障鴻絎綽荀障
-.LP
-絽吾腟九障潟絎翫\f2http:\fP潟篏睡障Web 泣若若＜ゃ激鴻潟翫\f2file:\fP 潟篏睡с障号鴻若吟若＜ゃ激鴻掩ャ＜潟≪祉鴻綽荀翫篁ュ篏睡с
-.LP
-翫若ｃ潟違激鴻с腟九 URL 後 URL http:若鴻file:若鴻鴻激ャ阪絖篏睡障 (
+\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。あとで例を示します。このディレクトリ内にパッケージリストファイルが存在していなければなりません。 存在しない場合は、\f2\-linkoffline\fP を使用します。Javadoc ツールは、 \f2package\-list\fP ファイルからパッケージ名を読み取ったあと、その URL でそれらのパッケージにリンクします。Javadoc ツールの実行時に、\f2extdocURL\fP の値がそのまま、作成された \f2<A HREF>\fP リンク内にコピーされます。したがって、\f2extdocURL\fP はファイルへの URL ではなく「ディレクトリへの URL」でなければなりません。
+.LP
+\f2extdocURL\fP への絶対リンクを使用すると、ユーザーのドキュメントを任意の Web サイト上のドキュメントにリンクできます。相対位置へリンクするだけでよい場合は相対リンクを使用できます。相対リンクの場合、ユーザーが渡す値は、( \f2\-d\fP で指定された) 生成先ディレクトリから、リンク先となるパッケージを含むディレクトリへの相対パスにすべきです。
+.LP
+通常、絶対リンクを指定する場合は、 \f2http:\fP リンクを使用します。Web サーバーを持たないファイルシステムにリンクする場合は、 \f2file: リンクを使用できます。\fP ただし、この方法は、すべてのユーザーが生成された同じファイルシステムを共有するドキュメントにアクセスする必要がある場合以外は使用しないでください。
+.LP
+すべての場合、すべてのオペレーティングシステムで、絶対 URL と相対 URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します (
.na
\f2URL Memo\fP @
.fi
-http://www.ietf.org/rfc/rfc1738.txt ф絎)
+http://www.ietf.org/rfc/rfc1738.txt で指定)。
.RS 3
.TP 3
-http:若鴻腟九障潟:
+http: ベースの絶対リンク:
\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-file:若鴻腟九障潟:
+file: ベースの絶対リンク:
\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-後障潟:
+相対リンク:
\f2\-link <directory>/<directory>/.../<name>\fP
.RE
.RE
.LP
-javadoc 絎茵茲違 \f2\-link\fP 激с潟絎茲違ャ＜潟吾潟篏с障 \f3\-linkoffline 障 \-link 御\fP
+javadoc の 1 回の実行で複数の \f2\-link\fP オプションを指定すれば、複数のドキュメントへのリンクを作成できます。 \f3\-linkoffline または \-link の選択\fP
.br
-\f2\-link\fP 篏睡翫:
+\f2\-link\fPを使用する場合:
.RS 3
.TP 2
o
-紊 API ャ＜潟吾後障鴻篏睡翫
+外部 API ドキュメントへの相対パスを使用する場合
.TP 2
o
-紊 API ャ＜潟吾腟九 URL 篏睡翫 (違 URL ･膓茯水茵激сｃ荐怨翫)
+外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されている場合)
.RE
-罨＜翫\f2\-linkoffline\fP 激с潟篏睡障
+\f2\-linkoffline\fP を使用する場合:
.RS 3
.TP 2
o
-違 URL ･膓茯水茵激сｃ荐怨翫紊 API ャ＜潟吾腟九 URL 篏睡翫倶潟ャ＜潟＜ゃ≪若眼翫榊障
+外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されていない場合)このような状況は、リンク先のドキュメントがファイアウォールの向こう側にある場合に発生します。
.RE
.LP
-\f3紊ャ＜潟吾腟九障潟篏睡箴\fP \-
+\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2java.lang\fP、 \f2java.io\fP 、その他の Java プラットフォームパッケージ (
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
+\f2http://java.sun.com/javase/6/docs/api/\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api \f2java.lang\fP\f2java.io\fP篁 Java 2 若宴若吾潟翫障 罨＜潟潟\f2com.mypackage\fP 宴若吾ャ＜潟 Java 2 若宴若吾吾潟障ャ＜潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP \f2\-d\fP 篁激с潟茵腓冴障
+http://java.sun.com/javase/6/docs/api 内) にリンクする場合を考えます。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP や \f2\-d\fP など、その他のオプションは示していません。
.nf
\f3
.fl
- % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
+ % \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
.fl
.fi
-\f3紊ャ＜潟吾後障潟篏睡箴\fP \- 2 ゃ宴若吾ャ＜潟 Javadoc 若茲医絎茵腟с障 ャ＜潟後障鴻у蚊障箴翫2 ゃ宴若吾API с \f2com.apipackage\fP SPI (泣若鴻ゃゃ潟帥с若) с \f2com.spipackage\fP сャ＜潟主 \f2docs/api/com/apipackage\fP 宴若吾 \f2docs/spi/com/spipackage\fP 宴若吾сAPI 宴若吾ャ＜潟с憜ｃ \f2docs\fP с翫罨＜潟潟絎茵ｃ API ャ＜潟吾潟 SPI 宴若吾ャ＜潟障
+\f3外部ドキュメントへの相対リンクの使用例\fP \- 2 つのパッケージがあり、そのドキュメントが Javadoc ツールを複数回実行した結果生成されたものであるとします。さらに、これらのドキュメントが相対パスで分割されているとします。この例の場合、パッケージは、API である \f2com.apipackage\fP と、SPI (サービスプロバイダインタフェース) である \f2com.spipackage\fP です。ドキュメントの格納先は、 \f2docs/api/com/apipackage\fP と \f2docs/spi/com/spipackage\fP です。API パッケージのドキュメントはすでに生成済みで、 \f2docs\fP がカレントディレクトリになっていると仮定すると、API ドキュメントへのリンクを含む SPI パッケージをドキュメント化するには、次のコマンドを実行します。
.nf
\f3
.fl
@@ -4754,43 +3260,43 @@
.fl
.fi
.LP
-\f2\-link\fP 綣違ｃ (\f2docs/spi\fP) 後障鴻с
-.LP
-\f3荅括完\fP \- \f2\-link\fP 激с潟篏帥潟若сJavadoc 篁絎茵сャ＜潟鴻潟с障潟鴻若吾腱糸с HTML 若吾贋茯帥鴻贋 \f2extdocURL\fP 絎綽荀障激с潟篏帥違泣若若ｃ若ャ＜潟\f2http://java.sun.com\fP \f2java.*\fP ャ＜潟潟с障
-.LP
-篁絎茵 Javadoc ｃャ＜潟 API 絲乗院潟篏翫\f2\-link\fP 激с潟ャ障\f2\-link\fP 激с潟絎翫Javadoc 若紊сャ＜潟吾潟篏障ャ＜潟絖喝翫贋ゅャсс
-.LP
-激с潟сャ＜潟茲違贋潟篏с障
-.LP
-障激с潟篏帥茲違宴若悟召鴻潟篏с障ゃ障筝綣宴若吾絲障 javadoc 絎茵ャ筝綣宴若吾絲障 javadoc 絎茵 2 ゃ宴若悟召鴻潟篏с障
-.LP
-\f3鴻ф号\fP \- 紊с鴻吾潟鴻с鎘茵腓冴罨＜号с鴻с綽荀障＜純篏с鴻ссс障\f2import\fP 障絎ｈус綽荀障罨＜ \f2java.io.File\fP с号箴腓冴障
+\f2\-link\fP の引数は、生成先ディレクトリ (\f2docs/spi\fP) からの相対パスです。
+.LP
+\f3詳細\fP \- \f2\-link\fP オプションを使うと、「コードからは参照されていても、Javadoc の今回の実行ではドキュメント化されない」というクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらの HTML ページがある場所を調べ、その場所を \f2extdocURL\fP に指定する必要があります。これにより、たとえば、サードパーティーのドキュメントから \f2http://java.sun.com 上の java.*\fP のドキュメントへのリンクが \f2可能となります\fP。
+.LP
+今回の実行で Javadoc によって生成されるドキュメント内の API だけを対象に \f2リンクを作成する場合は、\fP \-link オプションを省略します。 \f2\-link\fP オプションが指定されていない場合、Javadoc ツールは、外部参照されたドキュメントへのリンクを作成しません。これは、そのドキュメントが存在するかどうか、および存在する場合はその場所を判別できないからです。
+.LP
+このオプションでは、生成ドキュメント内の複数の場所にリンクを作成できます。
+.LP
+もう 1 つの用途は、パッケージセット間でのクロスリンクです。一方のパッケージセットに対して javadoc を実行したあと、他方のパッケージセットに対して javadoc を再度実行することにより、両セット間で双方向のリンクを作成できます。
+.LP
+\f3クラスの参照方法\fP \- 外部参照クラスへのリンクを、テキストラベルだけではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するだけでは十分ではありません。それらのクラスは、 \f2import\fP 文、宣言のいずれの場所で参照されている必要があります。Here are examples of how the class \f2java.io.File\fP can be referenced:
.RS 3
.TP 2
o
-鴻腮蕁 \f2import\fP 翫: ゃ若ゃ潟若腓榊ゃ潟若障 \f2java.lang.*\fP 絲障ゃ潟若違罨＜医с
+すべての種類の \f2import\fP 文の場合: ワイルドカードによるインポート、名前による明示的なインポート、または \f2java.lang.* に対する自動的なインポート\fP。たとえば、次のようにすれば十分です。
.br
\f2import java.io.*;\fP
.br
-1.3.x 1.2.x с腓榊ゃ潟若сゃ若ゃ潟若ゃ潟若 \f2java.lang.*\fP 篏睡с障
+1.3.x および 1.2.x では、名前による明示的なインポートだけです。ワイルドカードによるインポート文も、 \f2java.lang.* の自動インポートも使用できません\fP。
.TP 2
o
-絎ｈ翫:
+宣言の場合:
.br
\f2void foo(File f) {}\fP
.br
-с篏睡＜純潟潟鴻帥ｃ若鴻障ゃ潟帥с若鴻祉ゃ障＜若帥臀\f2implements\fP\f2extends\fP障 \f2throws\fP 臀障
+この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースの戻り値の型またはパラメータの型に置くか、 \f2implements\fP、 \f2extends\fP 、または \f2throws\fP 文に置きます。
.RE
.LP
-腟\f2\-link\fP 激с潟篏睡狗茯ゃｃ茵腓冴紊潟紊亥榊醇с障鴻ゃ若鴻潟篁茵腓冴障潟茵腓冴茘潟茯茘с障鴻罩ｃсｃ潟菴遵ｃ絎号筝ц綵荅蚊鴻ゃ潟若с
-.LP
-\f3宴若吾鴻\fP \- \f2\-link\fP 激с潟\f2package\-list\fP ＜ゃ荀羆障 ＜ゃJavadoc 若ｃ\f2\-link\fP ｃ絎 URL 絖障\f2package\-list\fP ＜ゃ贋ャ＜潟宴若吾鴻ャｃ膣鴻＜ゃс箴сJavadoc 若絎 URL \f2package\-list\fP ＜ゃ｢宴若後茯粋昭с URL 宴若吾吾潟篏障
-.LP
-違Java 若 v5.0 API 宴若吾鴻
+重要な結果として、 \f2\-link\fP オプションの使用時に、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキストリンクが付けられずに表示されます。これらのリンクが表示する警告から、このリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するためのもっとも安全な方法は上で説明したとおり、当該のクラスをインポートすることです。
+.LP
+\f3パッケージリスト\fP \- \f2\-link\fP オプションが正しく機能するには、Javadoc ツールによって生成される \f2package\-list\fP という名前のファイルが、ユーザーが \f2\-link\fP に指定した URL に存在している必要があります。 \f2package\-list\fP ファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキストファイルです。前の例では、Javadoc ツールは、指定された URL で \f2package\-list\fP という名前のファイルを検索し、パッケージ名を読み込んだあと、その URL にあるそれらのパッケージへのリンクを作成しました。
+.LP
+たとえば、Java SE 6 API のパッケージリストは
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list 罨＜絎鴻у障ｃ障
+http://java.sun.com/javase/6/docs/api/package\-list にあり、次のような内容で始まっています。
.nf
\f3
.fl
@@ -4808,64 +3314,64 @@
.fl
java.awt.font
.fl
- 篁 ...
+ その他
.fl
\fP
.fi
.LP
-\f2\-link\fP 激с潟絎 javadoc 絎茵翫紊с鴻絮荀ゃjavadoc 潟綵≪у阪障筝鴻\f2\-link\fP 激с潟絎翫絎 \f2extdocURL\fP \f2package\-list\fP ＜ゃ荅峨宴若後罎膣≪障宴若後荀ゃ\f2extdocURL\fP 篁障
-.LP
-鴻潟罩ｃ閟純紊с鴻ャ＜潟絎 URL 絖違障Javadoc 若絎 package\-list 絖茯帥鴻с絎 URL 若吾絖с障
-.LP
-\f3茲違潟\fP \- 茲違 \f2\-link\fP 激с潟絎篁紙違紊ャ＜潟絲障潟荐絎с障Javadoc 1.2 茲違 \f2\-link\fP 激с潟絎с違障 1.2.2 т信罩ｃ障
-.LP
-潟紊ャ＜潟罨＜ャ潟激с潟絎障
-.LP
-\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2...\fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
-.LP
-\f2extdocURL1\fP\f2extdocURL2\fP... \f2extdocURLn\fP 紊ャ＜潟若若 \f2package\-list\fP ＜ゃャｃ障
-.LP
-\f3鴻潟\fP \- 障 2 や札筝ャ＜潟鴻潟翫若鴻綽荀障ゃ障ャ＜潟ゃ \f2package\-list\fP 絖翫ャ＜潟絲障 javadoc 若絎茵鴻с2 ャ＜潟 \f2package\-list\fP 障絖障ｃ紊潟篏2 ャ＜潟сャ＜潟眼綽荀障
-.LP
-翫ャ＜潟ャ＜潟 \f2package\-list\fP 篏с 宴若後鴻＜翫package\-list тс障罨＜2 ャ＜潟紊潟障綽荀紊 \f2package\-list\fP ＜ゃ絖翫Javadoc 若茘茵腓冴障
+\f2\-link\fP オプションを指定せずに javadoc を実行した場合、外部参照クラスに属する名前を見つけると、javadoc はその名前をリンクを持たない形で出力します。一方、 \f2\-link\fP オプションが指定された場合、Javadoc ツールは、 \f2指定された\fP \f2extdocURL\fP の場所にある package\-list ファイル内で、そのパッケージ名を検索します。パッケージ名が見つかると、\f2extdocURL\fP が名前の前に付加されます。
+.LP
+すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定した URL に存在していなければなりません。Javadoc ツールは、指定された package\-list が存在するかどうかを調べるだけで、指定された URL に目的のページが存在するかどうかはチェックしません。
+.LP
+\f3複数のリンク\fP \- 複数の \f2\-link\fP オプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1.2 には、複数の \f2\-link\fP コマンドを指定できないというバグがあります。これは 1.2.2 で修正されました。
+.LP
+リンクする外部ドキュメントごとに、次のように別々のリンクオプションを指定します。
+.LP
+\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2... \fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
+.LP
+\f2extdocURL1\fP、\f2extdocURL2\fP、... \f2extdocURLn\fP は、それぞれ外部ドキュメントのルートを指し、各ルートには、 \f2package\-list\fP という名前のファイルが入っています。
+.LP
+\f3クロスリンク\fP \- まだ生成されていない 2 つ以上のドキュメントをクロスリンクする場合は、「ブートストラップ」が必要になります。つまり、どのドキュメントについても \f2package\-list\fP が存在していない場合は、最初のドキュメントに対して Javadoc ツールを実行する時点で、2 番目のドキュメントの \f2package\-list\fP はまだ存在していません。したがって、外部リンクを作成するには、2 番目のドキュメントを生成したあとで、最初のドキュメントを生成し直す必要があります。
+.LP
+この場合、最初のドキュメント生成の目的は、 \f2package\-list\fP を作成することです。パッケージ名をすべて把握している場合は、package\-list を手動で作成してもかまいません。次に、2 番目のドキュメントとその外部リンクを生成します。必要な外部の \f2package\-list\fP ファイルが存在しない場合は、Javadoc ツールから警告が出力されます。
.LP
.TP 3
\-linkoffline\ extdocURL\ packagelistLoc
-激с潟\f2\-link\fP 激с潟紊с ＜javadoc ｃ紊с鴻ャ＜潟吾潟篏障Javadoc 若篏ゃ潟ｃ (Web ･膓篏帥ｃャ＜潟≪祉鴻с)Web 筝ャ＜潟潟\f2\-linkoffline\fP 激с潟篏睡障
-.LP
-ｳ絲紊ャ＜潟 \f2package\-list\fP ＜ゃ≪祉鴻с障＜ゃ \f2extdocURL\fP ф絎贋違贋 (絽吾\f2packageListLoc\fP ф絎純若贋) 絖\f2\-linkoffline\fP 篏睡障ｃ\f2extdocURL\fP WWW 筝с≪祉鴻с翫\f2\-linkoffline\fP 絎ャ＜潟 javadoc 若 Web ･膓с違句障
-.LP
-ャ＜潟贋違潟違篏睡純с宴若吾祉篏絲障 javadoc 絎茵紊眼筝宴若吾絲障 javadoc 絎茵障 贋違＜ゃ吾＜ゃ祉水ャс障箴хず障
-.LP
-\f2\-linkoffline\fP 激с潟綣違 2 ゅ障 綣違 \f2<a href>\fP 潟腟粋昭障絖絎綣違2 綣違 \f2package\-list\fP 罎膣√贋絎綣違с
+このオプションは \f2\-link\fP のバリエーションの 1 つです。どちらも、外部参照クラスの javadoc 生成ドキュメントへのリンクを作成します。Javadoc \f2ツール自体が\fP オフラインになっているとき (Web 接続を使ってドキュメントにアクセスできないとき)、Web 上のドキュメントにリンクするには、\-linkoffline オプションを使用します。
+.LP
+厳密には、 \f2外部\fP ドキュメントの \f2package\-list\fP ファイルにアクセスできないとき、またはこのファイルが \f2extdocURL\fP で指定された場所とは異なる場所 (通常、\f2packageListLoc\fP で指定可能なローカルな場所) に存在するとき、\-linkoffline を使用します。したがって、WWW 経由でしか \f2extdocURL\fP にアクセスできない場合、 \f2\-linkoffline\fP を指定することにより、ドキュメントの生成時に Javadoc ツールが Web に接続できなければならないという制約がなくなります。
+.LP
+さらに、ドキュメントを更新するための「ハッキング」としての使用も可能です。パッケージのセット全体に対して javadoc を実行したあと、変更した一部のパッケージだけに対して javadoc を実行します。こうして、更新されたファイルを、オリジナルのファイルセットに挿入できるようにします。例をあとで示します。
+.LP
+\f2\-linkoffline\fP オプションは引数を 2 つ取ります。1 つは、 \f2<a href>\fP リンクに組み込まれる文字列を表す引数、もう 1 つは \f2package\-list\fP の検索場所を示す引数です。
.RS 3
.TP 2
o
-\f4extdocURL\fP 潟絎javadoc ｃ紊ャ＜潟ｃ腟九 URL 障後 URL с後障潟篏睡翫\f2\-d\fP 篏帥ｃｃ潟宴若吾若後障鴻絎綽荀障荅括完\f2\-link\fP 激с潟 \f2extdocURL\fP с
+\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。相対リンクの場合、その値は、( \f2\-d\fP で指定された) 生成先ディレクトリからリンク先パッケージのルートへの相対パスにすべきです。詳細は、\-link オプションの \f2extdocURL\fP \f2を参照\fP してください。
.TP 2
o
-\f4packagelistLoc\fP 紊ャ＜潟 \f2package\-list\fP ＜ゃャｃｃ鴻障 URL 絎障URL (http: 障 file:)or file:)＜ゃ鴻＜с障障障腟九障鴻後障鴻＜с絎с障後障鴻翫javadoc 絎茵潟ｃ後障鴻絎障\f2package\-list\fP ＜ゃс
+\f4packagelistLoc\fP は、外部ドキュメントの \f2package\-list\fP ファイルを含むディレクトリへのパスまたは URL です。これは、URL (http: または file:) でもファイルパスでもかまいませんし、絶対パスでも相対パスでもかまいません。相対パスの場合は、javadoc が実行されるカレントディレクトリからの相対パスとして指定します。ファイル名 \f2package\-list\fP は含めないでください。
.RE
.LP
-javadoc 1 絎茵с茲違 \f2\-linkoffline\fP 激с潟絎с障1.2.2 茲違激с潟絎с障с
-.LP
-\f3紊ャ＜潟吾腟九障潟篏帥ｃ箴\fP \- \f2http://java.sun.com/j2se/1.5.0/docs/api\fP \f2java.lang\fP\f2java.io\fP潟篁 Java 2 若宴若吾潟Web ≪祉鴻с 翫ゃ帥障翫吟
+1 回の javadoc 実行で複数の \f2\-linkoffline\fP オプションを指定できます。1.2.2 より前は、複数のオプションを指定することはできませんでした。
+.LP
+\f3外部ドキュメントへの絶対リンクの使用例\fP \- http://java.sun.com/javase/6/docs/api 内の \f2java.lang\fP、 \f2java.io\fP 、およびその他の Java SE プラットフォームパッケージ \f2にリンクしたくても\fP Web にアクセスできない場合を考えます。ブラウザで \f2、\fP
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list \f2package\-list\fP ＜ゃ若ｃ篆絖障 2 綣 \f2packagelistLoc\fP 若潟若贋絎障箴с宴若吾鴻＜ゃ潟ｃ "\f2.\fP" 篆絖障罨＜潟潟Java 2 若 API 吾潟\f2com.mypackage\fP 宴若吾ャ＜潟障ャ＜潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP 篁綽荀激с潟茵腓冴障
+http://java.sun.com/javase/6/docs/api/package\-list にある package\-list ファイルを開き、それをローカルディレクトリに保存し、第 2 引数 \f2packagelistLoc\fP でこのローカルコピーへのパスを指定します。この例では、パッケージリストファイルはカレントディレクトリ "\f2.\fP" に保存されています。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP など、その他の必要オプションは示されていません。
.nf
\f3
.fl
-% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
+% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
.fl
.fi
.LP
-\f3紊ャ＜潟吾後障潟篏睡箴\fP \- 絽吾\f2\-linkoffline\fP 後障鴻絎障 \f2\-link\fP усс\f2\-linkoffline\fP 篏睡\f2package\-list\fP 絽吾若＜ゃ絎障 後障潟篏睡潟＜ゃ絽吾若＜ゃ絎障ｃ\f2\-linkoffline\fP 2 ゃ綣違ャ鴻絎綽荀障2 ゃ綣違筝с翫\f2\-link\fP 篏睡с障\f2\-link\fP 後障潟箴с
-.LP
-\f4package\-list\fP\f3 ＜ゃт\fP \- \f2package\-list\fP ＜ゃ障絖ャ＜潟潟宴若後ｃ翫＜ゃт\f2packagelistLoc\fP с鴻絎с障\f2com.apipackage\fP \f2com.spipackage\fP 宴若吾鴻絖冴箴с号宴若後ｃ障違紊ャ＜潟潟ャ＜潟綽荀翫箴水с障\f2package\-list\fP ＜ゃ Javadoc 1.0 1.1 х宴若後 \f2package\-list\fP ＜ゃ篏号障罕2 ゃ篌腓障 \f2package\-list\fP ＜ゃ掩с鴻潟荐絎ャ＜潟若鴻純с
-.LP
-\f3茲違ャ＜潟吾潟\fP \- \f2\-linkoffline\fP уャ＜潟 1 ゃゆ絎障 罨＜箴с激с潟茵障
+\f3外部ドキュメントへの相対リンクの使用例\fP \- \f2\-linkoffline\fP で相対パスを使用することは、あまりありません。理由は単純で、通常は \f2\-link\fP で十分だからです。 \f2\-linkoffline\fP を使用する際、 \f2package\-list\fP には通常ローカルのファイルを指定します。 相対リンクを使用する際も、リンク先のファイルには通常ローカルのファイルを指定します。したがって、 \f2\-linkoffline の 2 つの引数に別々のパスを指定する必要はありません\fP。2 つの引数が同一である場合は、 \f2\-link\fP を使用できます。 \f2\-link\fP の相対リンクの例を参照してください。
+.LP
+\f4package\-list\fP\f3 ファイルを手動で作成\fP \- \f2package\-list\fP ファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルを自分で作成し、packagelistLoc \f2でそのパスを指定することができます。\fPcom.apipackage が最初に生成される時点で \f2com.spipackage\fP のパッケージリストが存在していなかったという、 \f2前出のケースが\fP 一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、Javadoc 1.0 または 1.1 で生成されたパッケージの \f2package\-list\fP ファイルを作成する必要がある場合にも、この方法が使えます。これらのバージョンでは、 \f2package\-list\fP ファイルは生成されていませんでした。同様に、2 つの企業が未公開の \f2package\-list\fP ファイルを共有すれば、クロスリンクを含むドキュメントを同時にリリースすることも可能となります。
+.LP
+\f3複数のドキュメントへのリンク\fP \- 参照先となる生成ドキュメントごとに \f2\-linkoffline\fP を 1 回ずつ含めることができます。わかりやすくするために、オプションごとに改行して示しています。
.LP
\f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP
.br
@@ -4873,24 +3379,24 @@
.br
\f2\ \ \ \ \ \ \ \ \ \ ...\fP
.LP
-\f3ャ＜潟贋\fP \- 菴違 \f2\-linkoffline\fP 激с潟蚊ゃ吾с紊ч宴若吾障с弱篏絲障 javadoc 絎茵絎篋翫罨＜絎茵с絨紊眼純若鴻若鋇絲障 javadoc 絎茵翫箴水сャ＜潟若激с潟潟＜潟絲障紊眼絎ｈ紊眼翫炊ｃс潟違с純若鴻潟若絎ｈ菴遵ゃ障紊眼翫膣√宴若吾若膓帥＜潟若鴻[篏睡] 若吾贋с潟紕障
-.LP
-障篁絎茵т戎違ｃ (\f2update\fP) 篏障ｃ \f2html\fP 障ｃ膣箴с\f2html\fP ｃ荀ｃ腱糸 (cd) 障\f2\-linkoffline\fP 綣違潟ｃ "." 絎2 綣違 \f2html\fP 吾後障鴻絎障 с\f2package\-list\fP 罎膣≪障 贋医丞с宴若吾宴若後絎
+\f3ドキュメントの更新\fP \- 前述の \f2\-linkoffline\fP オプションのもうひとつの用途は、プロジェクトに大量のパッケージが含まれていて、すでにツリー全体に対して javadoc の実行が完了している場合に、次の実行では、少量の変更を手早く加えたあと、ソースツリーのごく一部に対してだけ javadoc を再実行する場合に便利です。これは、ドキュメンテーションコメントに対してだけ変更を加え、宣言は変更しない場合にのみ正しく処理されるので、ハッキングのようなものです。ソースコードの宣言を追加、削除、または変更した場合は、索引、パッケージツリー、継承されるメンバーのリスト、「使用」ページなどの場所で、リンクが壊れることがあります。
+.LP
+まず、この新しい小さな実行用として、新しい生成先ディレクトリ ( \f2update\fP と命名) を作成します。元の生成先ディレクトリの名前が \f2html\fP だったとします。もっとも単純な例では、 \f2html ディレクトリの親ディレクトリに移動 (cd) します\fP。 \f2\-linkoffline\fP の第 1 引数をカレントディレクトリ「.」に設定し、第 2 引数を、package\-list が含まれている \f2html\fP への相対パスに設定し、 \f2更新するパッケージのパッケージ名のみを\fP渡します。
.nf
\f3
.fl
% \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP
.fl
.fi
-Javadoc 若腟篋緇\f2update/com/package\fP 鴻若吾潟若 (网荀膣√ゃ)\f2html/com/package\fP ＜ゃ筝吾障
+Javadoc ツリーの終了後、 \f2update/com/package\fP 内の生成されたクラスのページをコピーし (概要や索引は除く)、 \f2html/com/package 内の元のファイルに上書きします\fP。
.LP
.TP 3
\-linksource\
-純若鴻＜ゃ (茵垬) HTML 若吾с潟篏罔羣 HTML ャ＜潟純若鴻＜ゃ吾潟菴遵障潟純若鴻＜ゃ絎ｈ鴻ゃ潟帥с若鴻潟潟鴻帥＜純ｃ若絲障篏障潟潟鴻帥鴻絲障篏障
-.LP
-\f3激с潟\fP\f4\-public\fP\f3\fP\f4\-package\fP\f3\fP\f4\-protected\fP\f3\fP\f4\-private\fP\f3 激с潟≫鴻ｃ若＜純篏腟粋昭障純若鴻＜ゃ鴻絎茖荅括完障\fP\f2\-private\fP 激с潟絎鴻ゃ潟帥с若鴻筝潟篁≪祉鴻с障
-.LP
-潟絎ｈ茘ュ筝篏障違\f2Button\fP 鴻純若鴻潟若潟Button茯筝篏障
+各ソースファイル (行番号付き) の HTML バージョンを作成し、標準 HTML ドキュメントからソースファイルへのリンクを追加します。リンクは、ソースファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルトコンストラクタ、生成されたクラスに対しては作成されません。
+.LP
+\f3このオプションは、\fP\f4\-public\fP\f3、 \fP\f4\-package\fP\f3、 \fP\f4\-protected\fP\f3 、 \fP\f4\-private\fP\f3 の各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソースファイル内のすべての非公開実装の詳細を公開します。\fP\f2\-private\fP オプションも併せて指定しないかぎり、非公開のすべてのクラスやインタフェースにリンク経由でアクセスできるとはかぎりません。
+.LP
+各リンクは、その宣言内の識別子名の上に作成されます。たとえば、 \f2Button\fP クラスのソースコードへのリンクは、「Button」という語の上に作成されます。
.nf
\f3
.fl
@@ -4902,7 +3408,7 @@
.fl
\fP
.fi
-Button 鴻 \f2getLabel()\fP ＜純純若鴻潟若吾潟getLabel茯筝篏障
+また、Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。
.nf
\f3
.fl
@@ -4913,26 +3419,21 @@
.LP
.TP 3
\-group\ groupheading\ packagepattern:packagepattern:...
-网荀若吾茲違宴若吾絎違若違若茵篏障違若ャ \f2\-group\fP 激с潟ф絎障違若潟潟茵ф絎綺с若吾茵腓冴障 違若с宴若吾≪＜筝鴻障絎 \f2\-group\fP 激с潟\f2packagepattern\fP 綣鴻筝眼宴若吾荀冴 \f2groupheading\fP 1 ゃ茵障茵腓冴障
+概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の \f2\-group\fP オプションで指定します。これらのグループは、コマンド行で指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。ある特定の \f2\-group\fP オプションでは、 \f2packagepattern\fP 式のリストに一致するパッケージが、 \f2groupheading\fP という見出しの表に表示されます。
.RS 3
.TP 2
o
-\f4groupheading\fP 篁紙鴻絎с腥榊純с障絎鴻違若茵荀冴障
+\f4groupheading\fP には、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。
.TP 2
o
-\f4packagepattern\fP 篁紙宴若後障篁紙宴若後膓 1 ゃ≪鴻帥鴻 (\f2*\fP) 絎с障≪鴻帥鴻篁紙絖筝眼潟ゃ若сゃ若絎с≪鴻帥鴻с1 ゃ違若潟 (\f2:\fP) у阪ｃ茲違帥若潟с障
+\f4packagepattern\fP には、任意のパッケージ名、または任意のパッケージ名の先頭部分とそれに続く 1 つのアスタリスク (\f2*\fP) を指定できます。 アスタリスクは、「任意の文字に一致する」という意味のワイルドカードです。ワイルドカードとして指定できるのは、アスタリスクだけです。1 つのグループには、コロン (\f2:\fP) で区切って複数のパターンを含めることができます。
.RE
-.RS 3
-
-.LP
-.LP
-\f3羈: 帥若潟帥若潟鴻с≪鴻帥鴻篏帥翫\fP\f4"java.lang*:java.util"\fP\f3 帥若潟鴻綣膃у蚊綽荀障\fP
-.LP
-.RE
-.LP
-\f2\-group\fP 激с潟絎翫鴻宴若吾宴若吾荀冴 1 ゃ違若ャ障ャ＜潟宴若吾筝絎違若違若ャ宴若吾翫宴若吾篁宴若吾荀冴ょ腴違若ャ障
-.LP
-違罨＜激с潟絎ャ＜潟 5 ゃ宴若吾潟≪宴若吾≦宍罘純宴若吾潟篁宴若吾障java.lang*с緇絎羈 java.lang.*ャjava.lang 宴若吾ゅ障
+.LP
+\f3注: パターンやパターンリスト内でアスタリスクを使う場合は、 \fP\f4"java.lang*:java.util" のように、パターンリストを引用符で囲む必要があります。\fP
+.LP
+ユーザーが \f2\-group\fP オプションを 1 つも指定しなかった場合、「パッケージ」という見出しの 1 つのグループ内に、すべてのパッケージが配置されます。ドキュメント化されるパッケージの中に、指定したグループのどのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。
+.LP
+たとえば、次のようにオプションを指定すると、ドキュメント化される 5 つのパッケージは、コアパッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.lang パッケージは除外されることになります。
.nf
\f3
.fl
@@ -4943,56 +3444,52 @@
java.lang java.lang.reflect java.util javax.servlet java.new\fP
.fl
.fi
-腟罨＜違若茵障
-.RS 3
+この結果、次のようなグループ化が行われます。
.RS 3
.TP 3
-潟≪宴若
+コアパッケージ
\f2java.lang\fP
\f2java.lang.reflect\fP
\f2java.util\fP
.TP 3
-≦宍罘純宴若
+拡張機能パッケージ
\f2javax.servlet\fP
.TP 3
-篁宴若
+その他のパッケージ
\f2java.new\fP
.RE
-
-.LP
-.RE
.LP
.TP 3
\-nodeprecated
-ｨ絅 API ャ＜潟障激с潟絎\-nodeprecatedlist 激с潟絎翫号ャ＜潟祉篏сｨ絅 API 障激с潟潟若荐菴違ｨ絅潟若ｃ羂ｃ翫箴水с
+推奨されない API をドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlist オプションを指定した場合と同じ効果があることに加えて、ドキュメントのほかの部分全体でも、推奨されない API が生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。
.LP
.TP 3
\-nodeprecatedlist
-ｨ絅 API 鴻＜ゃ (deprecated\-list.html)潟蚊若激с潟若若吾吾潟障ャ＜潟祉сｨ絅 API 障激с潟ｨ絅 API 純若鴻潟若障蚊若激с潟若ｃ荀翫箴水с
+推奨されない API のリストを含むファイル (deprecated\-list.html)、およびナビゲーションバーのそのページへのリンクが生成されないようにします。ただし、ドキュメントのほかの部分では、推奨されない API が生成されます。このオプションは、推奨されない API がソースコードに含まれておらず、ナビゲーションバーをすっきりと見せたい場合に便利です。
.LP
.TP 3
\-nosince
-ャ＜潟@since 帥違絲上絨ャ若吾с潟 祉激с潟ャ障
+生成ドキュメントから、@since タグに対応する「導入されたバージョン」 セクションを省略します。
.LP
.TP 3
\-notree
-ャ＜潟鴻潟ゃ潟帥с若鴻絮ゃ若吾ャ障若吾蚊若激с潟若若帥潟≪祉鴻с障с絮ゃ障
+生成されるドキュメントからクラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。
.LP
.TP 3
\-noindex
-ャ＜潟膣√ャ障с膣√障
+生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。
.LP
.TP 3
\-nohelp
-阪若吾筝筝蚊若激с潟若 [] 潟ャ障
+出力の各ページの最上部と最下部にあるナビゲーションバーから「ヘルプ」リンクを省略します。
.LP
.TP 3
\-nonavbar
-若吾筝筝茵腓冴蚊若激с潟若若潟帥若障激с潟bottom 激с潟綵演帥筝障\f2\-nonavbar\fP 激с潟医激＜ゃ PostScript 障 PDF 紊翫絎鴻荀с蚊若激с潟綽荀翫箴水с
+生成されるページの最上部と最下部に表示されるナビゲーションバー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottom オプションには影響を与えません。 \f2\-nonavbar\fP オプションは、印刷するためだけにファイルを PostScript または PDF に変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。
.LP
.TP 3
\-helpfile\ path/filename
-筝筝蚊若激с潟若 [] 潟潟篁ｆ帥＜ゃ \f2path/filename\fP 鴻絎障激с潟絎翫Javadoc 若若潟若＜ゃ \f2help\-doc.html\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP ＜ゃс絎с\f2help\-doc.html\fP 絎障箴腓冴障
+上部と下部のナビゲーションバーの「ヘルプ」リンクのリンク先となる代替ヘルプファイル \f2path/filename\fP のパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているヘルプファイル \f2help\-doc.html\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2help\-doc.html には限定されません。\fP Javadoc ツールは、ナビゲーションバー内のリンクを必要に応じて調整します。次に例を示します。
.nf
\f3
.fl
@@ -5001,7 +3498,7 @@
.fi
.TP 3
\-stylesheetfile\ path/filename
-篁ｆ HTML 鴻帥ゃ激若＜ゃ鴻絎障激с潟絎翫Javadoc 若若潟若鴻帥ゃ激若＜ゃ \f2stylesheet.css\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP ＜ゃс絎с\f2stylesheet.css\fP 絎障箴腓冴障
+代替 HTML スタイルシートファイルのパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているスタイルシートファイル \f2stylesheet.css\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2stylesheet.css には限定されません\fP。たとえば、
.nf
\f3
.fl
@@ -5010,22 +3507,22 @@
.fi
.TP 3
\-serialwarn
-@serial 帥違翫潟潟ゃ茘障сJavadoc 1.2.2 篁ラ若吾с潟с翫茘障1.2.2 若吾с潟с茘障激с潟篏睡翫茘茵腓冴с翫純ｃ若 \f2writeExternal\fP ＜純ャ＜潟綵合＜障
+@serial タグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 以降のバージョンでは、直列化の警告は生成されません1.2.2 より前の初期バージョンでは、警告が生成されます。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと \f2writeExternal\fP メソッドを適切にドキュメント化するのに役立ちます。
.LP
.TP 3
\-charset\ name
-ャ＜潟 HTML 絖祉絎障
+このドキュメント用の HTML 文字セットを指定します。この名前は、
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets тｨ絅 MIME с違障箴腓冴障
+http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。たとえば、
.nf
\f3
.fl
% \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
.fl
.fi
-鴻若吾罨＜茵水ャ障
+生成されるすべてのページの先頭に、次の行が挿入されます。
.nf
\f3
.fl
@@ -5033,34 +3530,34 @@
.fl
\fP
.fi
- META 帥違ゃ
+この META タグについては、
.na
-\f2HTML 罔羣\fP @
+\f2HTML の標準\fP @
.fi
-http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 4137321) с
-.LP
-\-encoding \-docencoding с
+http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 および 4137321) を参照してください。
+.LP
+\-encoding および \-docencoding も参照してください。
.LP
.TP 3
\-docencoding\ name
- HTML ＜ゃ潟潟若ｃ潟違絎障
+生成される HTML ファイルのエンコーディングを指定します。この名前は、
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets тｨ絅 MIME с違障激с潟ャ \-encoding 篏睡翫 HTML ＜ゃ潟潟若\-encoding ｃ羆冴障箴:
+http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。このオプションを省略しながら \-encoding を使用した場合、生成される HTML ファイルのエンコードは、\-encoding によって決められます。例:
.nf
\f3
.fl
% \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
.fl
.fi
-\-encoding \-charset с
+\-encoding および \-charset も参照してください。
.LP
.TP 3
\-keywords
-HTML ＜帥若若帥違鴻＜ゃ菴遵障帥違＜帥帥違罎膣≪泣若潟吾潟若吾荀ゃ翫綵合＜障ゃ潟帥若篏罎膣≪紊泣若潟吾潟若吾＜帥帥違茯ょ＜帥帥違茯帥鴻障 筝鴻罎膣≪荳 Web 泣ゃ絎篌罐с泣若潟吾潟＜帥帥違茯帥鴻ｃ＜緇障
-.LP
-＜帥帥違鴻絎篆蕋上ｃ若潟＜純篆蕋障障障潟潟鴻帥劫с障障違 String 罨＜若若ч紮障
+HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。
+.LP
+メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。
.nf
\f3
.fl
@@ -5077,29 +3574,29 @@
.LP
.TP 3
\-tag\ \ tagname:Xaoptcmf:"taghead"
-Javadoc 若ャ＜潟若激с潟潟＜潟綣違 1 ゅ膣鴻帥帥 \f2@\fP\f2tagname\fP 茹ｉс障Javadoc 若帥医鴻с茵сс純若鴻潟若鴻鴻帥帥違 \f2\-tag\fP 激с潟腟粋昭с障篁絎茵у阪帥違\f2X\fP 篁≦鴻障
-.LP
-潟 (\f4:\fP) 絽吾阪絖障\f2tagname\fP с潟潟篏睡帥医с潟潟篏睡с
-.LP
-\f2\-tag\fP 激с潟帥違荀冴taghead紊絖у阪障 罨＜茵激с潟綣違ф絎鴻膓障 篁ヤ箴с帥違罕綣違鴻ゃ潟ゃ潟帥違с障 ゃ潟ゃ潟帥違茹ｉ障阪綣違 1 ゅ罔羣帥 (\f2@return\fP\f2@author\fP ) 阪鋍若障\f2taghead\fP ャ\f2tagname\fP 荀冴茵腓冴障
-.LP
-\f3帥違臀\fP \- 綣違 \f4Xaoptcmf\fP 純若鴻潟若帥違臀с篏臀\f2X\fP 篏帥ｃ帥違≦鴻с劫障帥違臀篏臀狗翫 \f4a\fP 絎障 篁ュ絖腟水純с \f4X\fP (帥違≦劫)
+Javadoc ツールがドキュメンテーションコメント内の引数を 1 つ取る単純なカスタムブロックタグ \f2@\fP\f2tagname\fP を解釈できるようにします。Javadoc ツールはタグ名の「スペルチェック」を行うことができるので、ソースコード内に存在するすべてのカスタムタグについて、 \f2\-tag\fP オプションを含めることが重要です。今回の実行では出力されないタグは、X を付けて無効 \f2にします\fP。
+.LP
+コロン (\f4:\fP) が常に区切り文字になります。tagname \f2でコロンを使用する方法については、\fP 「タグ名でのコロンの使用」を参照してください。
+.LP
+\f2\-tag\fP オプションは、タグの見出し「taghead」を太字で出力します。 その次の行には、このオプションの引数で指定したテキストが続きます。 以下の例を参照してください。ブロックタグと同様、この引数のテキストにはインラインタグを含めることができます。このインラインタグも解釈されます。出力は、引数を 1 つ取る標準のタグ ( \f2@return\fP や \f2@author\fP など) の出力とよく似ています。\f2taghead\fP を省略すると、\f2tagname\fP が見出しとして表示されます。
+.LP
+\f3タグの配置\fP \- 引数の \f4Xaoptcmf\fP 部分は、ソースコード内のタグを配置できる位置と、 を使ってこのタグを無効にできるかどうかを特定します。 \f2X\fP). タグの配置位置を制限しない場合は \f4a\fP を指定します。それ以外の文字の組み合わせも可能です。 \f4X\fP (タグの無効化)
.br
-\f4a\fP (鴻篏臀)
+\f4a\fP (すべて)
.br
-\f4o\fP (网荀)
+\f4o\fP (概要)
.br
-\f4p\fP (宴若)
+\f4p\fP (パッケージ)
.br
-\f4t\fP (＜鴻潟ゃ潟帥с若)
+\f4t\fP (型、つまりクラスとインタフェース)
.br
-\f4c\fP (潟潟鴻)
+\f4c\fP (コンストラクタ)
.br
-\f4m\fP (＜純)
+\f4m\fP (メソッド)
.br
-\f4f\fP (ｃ若)
-.LP
-\f3激潟違帥違箴\fP \- 純若鴻潟若篁紙篏臀т戎ф帥違帥違激с潟箴腓冴障
+\f4f\fP (フィールド)
+.LP
+\f3シングルタグの例\fP \- ソースコード内の任意の位置で使用できるタグのタグオプションの例を示します。
.nf
\f3
.fl
@@ -5107,7 +3604,7 @@
.fl
\fP
.fi
-@todo 潟潟鴻帥＜純ｃ若帥т戎翫篁ヤ激с潟篏睡障
+@todo をコンストラクタ、メソッド、フィールドのみで使用する場合は、以下のオプションを使用します。
.nf
\f3
.fl
@@ -5115,7 +3612,7 @@
.fl
\fP
.fi
-筝箴緇潟 (\f2:\fP) ＜若水阪絖с荀冴鴻筝ｃ障 (篁ヤ箴)罨＜箴\f2@todo\fP 帥違純若鴻潟若с帥違激с潟篏睡障
+上の例の最後のコロン (\f2:\fP) は、パラメータ区切り子ですが、見出しテキストの一部になっています (以下の例を参照)。次の例のように、 \f2@todo\fP タグを含むソースコードでは、いずれかのタグオプションを使用します。
.nf
\f3
.fl
@@ -5123,7 +3620,7 @@
.fl
\fP
.fi
-\f3帥医潟潟篏睡\fP \- 潟 (:) 鴻激ャс鴻宴若潟潟帥医篏睡с障ャ＜潟若激с潟潟＜潟筝с罨＜篏睡障
+\f3タグ名にコロンを使用する\fP \- コロン (:) をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーションコメントの中では、次のように使用します。
.nf
\f3
.fl
@@ -5135,7 +3632,7 @@
.fl
\fP
.fi
-с帥違激с潟篏睡
+でこのタグオプションを使用すると、
.nf
\f3
.fl
@@ -5143,9 +3640,9 @@
.fl
\fP
.fi
-\f3帥医鴻с (帥違≦劫)\fP \- 純若鴻潟若臀筝鴻帥帥違阪吟翫障翫純若鴻潟若鴻帥違臀阪吟帥違鴻阪吟帥違≦鴻障帥違≦鴻\f2X\fP 絎障絎帥違鴻障 Javadoc 若罎冴帥違ュ鴻ャ帥違с劫с障ャ帥違罎冴翫Javadoc 若茘阪障
-.LP
-с臀ゃ \f2X\fP 菴遵с障 違\f2X\fP ゃс帥違鴻с障違@todo 帥違阪吟翫罨＜絎障
+\f3タグ名のスペルチェック (タグの無効化)\fP \- ソースコード内に配置した一部のカスタムタグの出力を抑制したい場合があります。この場合も、ソースコード内にすべてのタグを配置し、出力を抑制しないタグを有効にし、出力を抑制するタグを無効にします。 \f2X\fP が存在する場合はタグが無効になり、存在しない場合はタグが有効になります。これにより、Javadoc ツールは、検出したタグが入力ミスなどによる未知のタグであるかどうかを特定できます。未知のタグを検出した場合、Javadoc ツールは警告を出力します。
+.LP
+すでに配置されている値に \f2X\fP を追加できます。こうしておけば、 \f2X を削除するだけでタグを有効にすることができます\fP。たとえば、@todo タグの出力を抑制したい場合、次のように指定します。
.nf
\f3
.fl
@@ -5153,7 +3650,7 @@
.fl
\fP
.fi
-膣絎号障
+さらに単純な指定方法もあります。
.nf
\f3
.fl
@@ -5162,13 +3659,13 @@
\fP
.fi
.LP
-罕 \f2\-tag todo:X\fP \f2@todo\fP taglet у臂翫鴻с
-.LP
-\f3帥違綺\fP \- \f2\-tag\fP ( \f2\-taglet\fP) 激с潟綺ｃ阪綺羆阪障鴻帥帥違罔羣帥違腟水篏睡с障罔羣帥違帥違激с潟綺羆阪若鴻с罔羣帥医帥篏睡障(罔羣帥違絨頳冴紊眼с障)ゃ篁ヤ箴ц障
-.LP
-\f2\-tag\fP 翫\f2\-taglet\fP 篏臀ｃ綺羆阪障帥違筝≧鴻絖翫潟潟茵緇祉綺羆阪障帥違帥違潟潟茵絎с違\f2\-taglet\fP \f2\-tag\fP 筝≧鴻 todo ｃ翫潟潟茵緇祉綺羆阪障
-.LP
-\f3帥違絎祉箴\fP \- 箴с阪ParametersThrowsTo Do水ャ障X 篏睡@example 純若鴻潟若篁絎茵с阪帥違с絎障@argfile 篏睡翫罨＜綣違＜ゃャ茵帥違臀с障 茵膓膓腓冴絖筝荀с
+構文 \f2\-tag todo:X\fP は、 \f2@todo\fP がタグレットで定義されていても有効です。
+.LP
+\f3タグの順序\fP \- \f2\-tag\fP (および \f2\-taglet\fP) オプションの順序によって、タグの出力順が決まります。カスタムタグと標準タグを組み合わせて使用することもできます。標準タグのタグオプションは、順序を決定するためだけのプレースホルダです。これらは標準タグ名のみを使用します。(標準タグの小見出しは変更できません。)これについては、以下の例で説明します。
+.LP
+\f2\-tag\fP が存在しない場合は、 \f2\-taglet\fP の位置によってその順序が決まります。タグが両方とも存在する場合、コマンド行の最後にあるほうがその順序を決定します。これは、タグやタグレットがコマンド行に指定された順番に処理されるためです。たとえば、 \f2\-taglet\fP と \f2\-tag\fP の両方が todo という名前を持っている場合、コマンド行の最後にあるほうが順序を決定します。
+.LP
+\f3タグの完全セットの例\fP \- この例では、出力の「Parameters」と「Throws」の間に「To Do」を挿入します。X を使用して、@example が、ソースコード内の今回の実行では出力されないタグであることを指定します。@argfile を使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます。行の継続を示す文字は不要です。
.nf
\f3
.fl
@@ -5187,37 +3684,37 @@
\fP
.fi
.LP
-javadoc ャ＜潟若激с潟潟＜潟茹ｆ罎冴帥違＜罔羣帥違с \f2\-tag\fP \f2\-taglet\fP ф検帥違сャ帥違荀障 翫茘鴻若障
-.LP
-罔羣帥違綺с鴻主障\f2\-tag\fP 激с潟篏睡鴻菴遵帥違≧羣帥違篏臀篏臀腱糸障ゃ障罔羣帥違 \f2\-tag\fP 激с潟篁違篏臀臀障障障
-.LP
-\f3腴九\fP \- 堺腥咲蚊宴若吾篏睡 \f2com.mycompany.todo\fP (.) 阪遵荀篏睡障Sun 篁緇障罔羣帥違篏障若吟若篏帥違Sun 箴帥違篏若若ゃ障ゃ障若吟若 \f2@todo\fP 帥違障帥違篏翫Sun 罔羣帥違篏帥違障帥違篏篆障
-.LP
-\f3羈 vs. Javadoc 帥\fP \- 筝菴遵綽荀若≪ャ＜潟若激с潟綵演帥筝ャ＜潟若激с潟с翫若≪ javadoc 帥違鴻с 篁ュ翫羈鴻с
+javadoc がドキュメンテーションコメントを解析する際に検索されたタグのうち、標準タグでも、 \f2\-tag\fP や \f2\-taglet\fP で渡されたタグでもないものはすべて未知のタグとみなされ、警告がスローされます。
+.LP
+標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。 \f2\-tag\fP オプションを使用すると、このリストに追加されるタグ、すなわち標準タグの位置がデフォルトの位置から移動します。つまり、標準タグに \f2\-tag\fP オプションを付けなければ、これらはデフォルトの位置に配置されたままになります。
+.LP
+\f3競合の回避\fP \- 固有の名前空間を細かく分けるには、パッケージに使用されている \f2com.mycompany.todo という名前のように、ドット (.) を区切り記号とする名前を使います\fP。Oracle は、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracle が提供する同じ名前のタグの動作をオーバーライドします。つまり、 \f2@todo\fP という名前のタグまたはタグレットをユーザーが作成した場合、Oracle がその後同じ名前の標準タグを作成したとしても、その動作は常にユーザーが定義した動作と同じになります。
+.LP
+\f3注釈 vs. Javadoc タグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメンテーションに影響を与えたりドキュメンテーションを生成したりするためのものである場合、そのマークアップは javadoc タグにすべきです。それ以外の場合は注釈にすべきです。
.na
-\f2Comparing Annotations and Javadoc Tags\fP @
+\f2「Comparing Annotations and Javadoc Tags」\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsс
-.LP
-\-taglet 激с潟篏睡茲帥違鴻帥ゃ潟ゃ潟帥違 篏с障
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsを参照してください。
+.LP
+\-taglet オプションを使用して、より複雑なブロックタグやカスタムインラインタグを 作成することができます。
.LP
.TP 3
\-taglet\ \ class
-帥違ャ＜潟篏帥莎桁鴻＜ゃ絎障鴻絎絎絎帥違鴻帥帥違鴻綣違違絎臂障帥違綣違篁阪障紊ャ＜潟泣潟帥違ゃ篁ヤс
+そのタグのドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。クラスの完全指定名を指定してください。このタグレットは、カスタムタグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプルタグレットについては、以下を参照してください。
.RS 3
.TP 2
o
.na
-\f2帥違网荀\fP @
+\f2「タグレットの概要」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
.RE
.LP
-帥違罔羣帥違障ゃ潟ゃ潟帥違т梢с帥違篁紙違綣違с障 障鴻紊絖膊≧吾篏鴻＜ゃ吾冴篁祉鴻紮鴻帥篏絎茖с障
-.LP
-帥違ф絎с帥違臀贋臀綵√帥с篁鴻羆阪ｃ茵障帥違篏睡鴻鴻劫ゃ絎茵с障帥違鴻＜ゃ阪ャ祉鴻若篏緇障
-.LP
-帥違鴻絎\f2\-tagletpath\fP 激с潟篏睡障篁ヤ若吾ParameterThrowsTo Do帥違水ャ箴с
+タグレットは、ブロックタグまたはインラインタグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。
+.LP
+タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。
+.LP
+タグレットのパスを指定するには、\f2\-tagletpath\fP オプションを使用します。以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。
.nf
\f3
.fl
@@ -5238,25 +3735,25 @@
\fP
.fi
.LP
-\f2\-tag\fP 激с潟篁ｃ \f2\-taglet\fP 激с潟篏睡с障茯帥\f2\-tag\fP 激с潟篏睡祉с
+また、 \f2\-taglet\fP オプションを \f2\-tag\fP オプションの代わりに使用することもできますが、そうすると可読性が低下する可能性があります。
.LP
.TP 3
\-tagletpath\ \ tagletpathlist
-taglet 鴻＜ゃ (.class) 罎膣≪鴻絎障\f2tagletpathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣ｃ罎膣≪障
+taglet クラスファイル (.class) の検索パスを指定します。\f2tagletpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。
.LP
.TP 3
\-docfilessubdirs\
-\f2doc\-files\fP ｃ羞宴潟若鴻障ゃ障潟弱泣ｃ鴻潟潟潟潟若障違\f2doc\-files/example/images\fP ｃ筝＜ゃ潟若障с泣ｃゅ絎純с
+「\f2doc\-files\fP」ディレクトリの深いコピーを有効にします。つまり、コピー先には、サブディレクトリとすべてのコンテンツがコピーされます。たとえば、ディレクトリ \f2doc\-files/example/images\fP とそのすべての内容がコピーされます。ここでも、サブディレクトリを除外する指定が可能です。
.LP
.TP 3
\-excludedocfilessubdir\ \ name1:name2...
-絎 \f2doc\-files\fP 泣ｃゅ障SCCS 篁純若鴻潟若九勝泣ｃ潟若蚊障
+「\f2doc\-files\fP」の、指定された名前のサブディレクトリをすべて除外します。これにより、SCCS とその他のソースコード制御サブディレクトリのコピーを防ぎます。
.LP
.TP 3
\-noqualifier\ \ all\ | \ packagename1:packagename2:...
-阪劫宴若後 (宴若娯信蕋上) ャ障\f2\-noqualifier\fP 綣違 \f2all\fP 絎翫鴻宴若娯信蕋上鴻ャ障 ゃ茲違宴若後潟潟у阪ｃゃ若絎с障鴻障ゃ潟帥с若劫茵腓冴篏臀宴若後ゃ障
-.LP
-罨＜箴с鴻宴若娯信蕋上ャ障
+出力されるクラス名の先頭のパッケージ名 (パッケージ修飾子) を省略します。 \f2\-noqualifier\fP の引数は、「\f2all\fP」(すべてのパッケージ修飾子が省略される)、修飾子として削除すべきパッケージのコロン区切りリスト (ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。
+.LP
+次の例では、すべてのパッケージ修飾子を省略します。
.nf
\f3
.fl
@@ -5264,7 +3761,7 @@
.fl
\fP
.fi
-罨＜箴с宴若娯信蕋上 java.lang java.io ャ障
+次の例では、パッケージ修飾子 java.lang および java.io を省略します。
.nf
\f3
.fl
@@ -5272,7 +3769,7 @@
.fl
\fP
.fi
-罨＜箴сjava у障宴若娯信蕋上 com.sun 泣宴若 (javax с) ャ障
+次の例では、java で始まるパッケージ修飾子と com.sun というサブパッケージ (javax ではない) を省略します。
.nf
\f3
.fl
@@ -5280,63 +3777,54 @@
.fl
\fP
.fi
-宴若娯信蕋上筝荐篏緇ｃ茵腓冴翫障 荅括完茵腓堺号с荀\f2\-noqualifier\fP 篏睡鴻с
+パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、 \f2\-noqualifier\fP を使用するかどうかにかかわらず有効です。
.LP
.TP 3
\-notimestamp\
-帥ゃ鴻帥潟吟障 若後菴 HTML HTML 潟＜潟с帥ゃ鴻帥潟障Javadoc 2 ゃ純若鴻若鴻у茵絲障 diff 絎茵激с潟篏睡帥ゃ鴻帥潟ｃ diff 榊т梢с (激с潟篏睡若吾 diff 障)帥ゃ鴻帥潟 Javadoc 若吾с括垩障罨＜障
+タイムスタンプが抑制されます。各ページ先頭近くにある、生成された HTML 内の HTML コメントでタイムスタンプが隠されます。Javadoc を 2 つのソースベースで実行し、それらに対して diff を実行するときにこのオプションを使用すると、タイムスタンプによって diff が発生しなくなるので便利です (このオプションを使用しないと、各ページで diff になります)。タイムスタンプには Javadoc のバージョン番号が含まれており、次のようになります。
.nf
\f3
.fl
- <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
+ <!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
.fl
\fP
.fi
.LP
.TP 3
\-nocomment\
-筝肢潟鴻帥違潟＜潟篏吟絎ｈ障激с潟違ｃ純若鴻＜ゃ違吾с罧級с鴻宴 HTML ャ＜潟篏с障
+主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。このオプションにより、元は異なる目的のためだったソースファイルを再利用し、新しいプロジェクトの早い段階でスケルトン HTML ドキュメントを作成できるようになりました。
+.LP
+.TP 3
+\-sourcetab tabLength
+ソース内で各タブが獲得する空白の数を指定します。
.RE
-.SH "潟潟茵綣違＜ゃ"
-.LP
-.LP
-\f2javadoc\fP 潟潟茵膂≧\f2javadoc\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) ャｃ 1 や札筝＜ゃ絎с障違若ｃ潟違激鴻筝с篁紙激 javadoc 潟潟篏с障
-.LP
-.LP
-綣違＜ゃjavac 激с潟純若鴻＜ゃ宴腟水荐菴違с障＜ゃ綣違鴻若鴻障壕у阪障＜ゃ腥榊純障翫＜ゃ篏篋綣膃у蚊帥障
-.LP
-.LP
-綣違＜ゃ＜ゃ憜ｃ荀後障鴻障綣違＜ゃ篏臀荀後障鴻с障綣違＜ゃ＜ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
-.LP
-.LP
-javadoc 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障javadoc \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
-.LP
+.SH "コマンド行引数ファイル"
+.LP
+javadoc のコマンド行を短くしたり簡潔にしたりするために、 \f2javadoc\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) が入った 1 つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティングシステム上でも、任意の長さの javadoc コマンドを作成できます。
+.LP
+引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
+.LP
+引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
+.LP
+javadoc を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javadoc は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
.SS
-綣違＜ゃ 1 ゆ絎箴
-.LP
-.LP
-\f2argfile\fP 綣違＜ゃ鴻 Javadoc 綣違主罨＜篏睡с障
-.LP
+引数ファイルを 1 つ指定する例
+.LP
+次のように、「\f2argfile\fP」という名前の単一の引数ファイル内に、Javadoc のすべての引数を格納します。
.nf
\f3
.fl
% \fP\f3javadoc @argfile\fP
.fl
.fi
-
-.LP
-.LP
-綣違＜ゃ罨＜箴хず 2 ゃ＜ゃ絎鴻筝≧鴻ャс障
-.LP
+.LP
+この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
.SS
-綣違＜ゃ 2 ゆ絎箴
-.LP
-.LP
-Javadoc 激с括 1 ゃ純若鴻＜ゃ 1 ゃ2 ゃ綣違＜ゃ篏罨＜篏睡с障鴻с茵膓膓絖篏睡障
-.LP
-.LP
-篁ヤ絎鴻 \f2options\fP ＜ゃ篏障
-.LP
+引数ファイルを 2 つ指定する例
+.LP
+2 つの引数ファイルを作成できます。1 つは Javadoc オプション用、もう 1 つはパッケージ名またはソースファイル名用です。なお、次のリストでは行継続文字を使用していません。
+.LP
+次の内容を含む、「\f2options\fP」という名前のファイルを作成します。
.nf
\f3
.fl
@@ -5346,27 +3834,24 @@
.fl
\-splitindex
.fl
- \-windowtitle 'Java 2 Platform v1.3 API Specification'
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification'
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
-.fl
- \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
+ \-windowtitle 'Java SE 7 API Specification'
+.fl
+ \-doctitle 'Java SE 7 API Specification'
+.fl
+ \-header '<b>Java(TM) SE 7</b>'
+.fl
+ \-bottom 'Copyright © 1993\-2011 Oracle and/or its affiliates. All rights reserved.'
.fl
\-group "Core Packages" "java.*"
.fl
- \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
-.fl
- \-sourcepath /java/pubs/ws/1.5/src/share/classes
+ \-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
+.fl
+ \-sourcepath /java/pubs/ws/1.7.0/src/share/classes
.fl
\fP
.fi
-
-.LP
-.LP
-篁ヤ絎鴻 \f2packages\fP ＜ゃ篏障
-.LP
+.LP
+次の内容を含む、「\f2packages\fP」という名前のファイルを作成します。
.nf
\f3
.fl
@@ -5378,115 +3863,89 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜潟潟篏睡 javadoc 絎茵障
-.LP
+.LP
+そのあと、次のコマンドを使用して javadoc を実行します。
.nf
\f3
.fl
% \fP\f3javadoc @options @packages\fP
.fl
.fi
-
-.LP
.SS
-剛綣違＜ゃ箴
-.LP
-.LP
-綣違＜ゃ鴻絎с障 ＜ゃ絎＜ゃ憜篏罐ｃ荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
-.LP
+パス付きの引数ファイルの例
+.LP
+引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。
.nf
\f3
.fl
% \fP\f3javadoc @path1/options @path2/packages\fP
.fl
.fi
-
-.LP
.SS
-激с潟綣違箴
-.LP
-.LP
-罨＜Javadoc 激с潟絲障綣違綣違＜ゃ主箴腓冴障с\f2\-bottom\fP 箴筝障 激с潟激綣違絎с障激с潟鴻綣違罨＜絎鴻\f2bottom\fP ＜ゃ篏障
-.LP
+オプションの引数の例
+.LP
+次に、Javadoc オプションに対する引数だけを引数ファイルに格納する例を示します。ここでは \f2\-bottom\fP オプションを使用します。というのも、引数が長くなる可能性があるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。
.nf
\f3
.fl
-'<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a
-.fl
-bug or feature</a><br><br>Java is a trademark or registered trademark of
-.fl
-Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-2000 Sun
-.fl
-Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
-All Rights Reserved.</font>'
+<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜ Javadoc 若絎茵障
-.LP
+.LP
+そのあと、次のようにして Javadoc ツールを実行します。
.nf
\f3
.fl
% \fP\f3javadoc \-bottom @bottom @packages\fP
.fl
.fi
-
-.LP
-.LP
-障綣違＜ゃ \f2\-bottom\fP 激с潟腟粋昭с違罨＜絎茵с障
-.LP
+.LP
+あるいは、引数ファイルの先頭に \f2\-bottom\fP オプションも組み込んだあと、次のように実行してもかまいません。
.nf
\f3
.fl
% \fP\f3javadoc @bottom @packages\fP
.fl
.fi
-.SH ""
-絎茵
-.SH "Javadoc 絎茵"
-.LP
-.LP
-\f3若吾с括\fP \- javadoc 若吾с括垩ゅャ\f3javadoc \-J\-version\fP 篏睡障阪鴻若罔羣若吾с括垩障障\f2\-quiet\fP х≦鴻с障
-.LP
-.LP
-\f3違ゃ潟帥с若\fP \- Java 荐茯ц菴違違 Javadoc 若莎桁篏睡障ゃ潟帥с若鴻 \f2com.sun.tools.javadoc.Main\fP 障 (javadoc ュ)荅括完
-.na
-\f2罔羣\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyс
-.LP
-.LP
-\f3絎茵\fP \- 筝荐茯罔羣 HTML 若喝冴с鴻帥若喝冴\-doclet \-docletpath 激с潟篏睡障劫絎茵絎箴ゃ
+.SH "名前"
+実行
+.SH "Javadoc の実行"
+.LP
+\f3バージョン番号\fP \- javadoc のバージョン番号を判別するには、\f3javadoc \-J\-version\fP を使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。その出力を無効にするには、 \f2\-quiet\fP を使用します。
+.LP
+\f3公開プログラムインタフェース\fP \- Java 言語で記述されたプログラムから Javadoc ツールを起動するとき使用します。このインタフェースは \f2com.sun.tools.javadoc.Main にあります\fP (javadoc は再入可能)。詳細は、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2「標準ドックレット」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。
+.LP
+\f3ドックレットの実行\fP \- 下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、
+.na
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
-.LP
-.SH "膂≦箴"
-.LP
-.LP
-javadoc 宴若後篏絲障絎茵純若鴻＜ゃ絲障絎茵с障宴若後宴若後絲上ｃ＜障罨＜箴с純若鴻＜ゃ \f2/home/src/java/awt/*.java\fP 障ｃ \f2/home/html\fP с
-.LP
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
+.SH "簡単な例"
+.LP
+javadoc は、パッケージ全体に対して実行することも、個々のソースファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソースファイルは \f2/home/src/java/awt/*.java にあります\fP。生成先ディレクトリは \f2/home/html です\fP。
.SS
-1 や札筝宴若吾ャ＜潟
-.LP
-.LP
-宴若吾ャ＜潟宴若吾純若鴻＜ゃ (\f2*.java\fP) 宴若吾ゃｃ絖違障宴若後茲違茘ュф (\f2java.awt.color\fP 茘ュу阪) 翫緇膓茘ュ筝篏泣ｃ絲上違障 (\f2java/awt/color\fP )1 ゃ宴若吾茲違純若鴻＜ゃ違贋 2 ゃｃ若主純с (\f2src1/java/awt/color\fP \f2src2/java/awt/color\fP ) 翫\f2\-sourcepath\fP ｃ筝≧鴻贋絎違障
-.LP
-.LP
-javadoc 絎茵\f2cd\fP 潟潟篏帥ｃｃ紊眼障 \f2\-sourcepath\fP 激с潟篏睡障篁ヤ箴с筝≧鴻号ゃ茯障
-.LP
+1 つ以上のパッケージのドキュメント化
+.LP
+あるパッケージをドキュメント化するには、そのパッケージのソースファイル (\f2*.java\fP) を、そのパッケージと同じ名前のディレクトリ内に格納する必要があります。パッケージ名が ( \f2java.awt.color\fP のようにドットで区切られた) いくつかの識別子から構成されている場合、右側の識別子に進むたびに、その識別子がより深いサブディレクトリに対応している必要があります ( \f2java/awt/color\fP など)。 単一パッケージのソースファイルを 2 グループに分け、異なる場所にあるそのような 2 つのディレクトリツリー内にそれぞれ格納してもかまいません。ただし、その両方のディレクトリへのパスを、 \f2\-sourcepath\fP に設定する必要があります。例: \f2src1/java/awt/color\fP および \f2src2/java/awt/color\fP。
+.LP
+javadoc を実行するには、 \f2cd\fP を使用してディレクトリを変更するか、 \f2\-sourcepath\fP オプションを使用します。以下の例では、両方の方法について説明します。
.RS 3
.TP 2
o
-\f3宴若 1 \- 1 や札筝宴若吾莎桁絽亥絎茵\fP \- 箴с javadoc 篁紙ｃ絎茵с\-sourcepath 篏睡絽亥 \-subpackages (1.4 違激с) 篏睡障\f2java\fP 泣宴若 (\f2java.net\fP \f2java.lang\fP 若宴若吾ゃ) 障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
+\f3ケース 1 \- 1 つ以上のパッケージからの起動を再帰的に実行\fP \- この例では javadoc が任意のディレクトリから実行できるように、\-sourcepath を使用し、再帰的処理のために \-subpackages (1.4 の新オプション) を使用します。これは、 \f2java\fP ディレクトリのサブパッケージをたどりますが、その際に、 \f2java.net\fP と \f2java.lang\fP をルートに持つパッケージは除外されます。このとき、 \f2java.lang のサブパッケージ\fPである java.lang.ref も \f2除外されます\fP。
.nf
\f3
.fl
@@ -5494,10 +3953,10 @@
.fl
.fi
.LP
-篁宴若吾若綏≦\f2java:javax:org.xml.sax\fP \f2\-subpackages\fP 綣違菴遵障
+ほかのパッケージツリーも下方にたどるには、 \f2java:javax:org.xml.sax のように、\fP それらのパッケージの名前を \-subpackages \f2の引数の末尾に追加します\fP。
.TP 2
o
-\f3宴若 2 \- 若純若鴻ｃ腱祉ｃ腓榊宴若吾絲障絎茵\fP \- 絎絎宴若後荀ｃ腱祉障罨＜ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障
+\f3ケース 2 \- ルートソースディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全指定のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5508,7 +3967,7 @@
.fi
.TP 2
o
-\f3宴若 3 \- 篁紙ｃ絎茵 純若鴻＜ゃ 1 ゃｃ弱\fP \- 宴若鴻с憜ｃсｃ障障筝篏宴若吾荀ｃ \f2\-sourcepath\fP 絎ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障
+\f3ケース 3 \- 任意のディレクトリから実行。ソースファイルは 1 つのディレクトリツリー内にある\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。最上位パッケージの親ディレクトリを \f2\-sourcepath\fP に指定し、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5517,7 +3976,7 @@
.fi
.TP 2
o
-\f3宴若 4 \- 篁紙ｃ絎茵 純若鴻＜ゃ茲違ｃ弱\fP \- 宴若 3 篌若障宴若吾茲違ｃ若絖障若若吾鴻 \f2\-sourcepath\fP 絎 (潟潟у阪)ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障1 ゃ宴若吾鴻純若鴻＜ゃ1 ゃ若ｃ筝絖違障 純若鴻鴻絎贋цゃ医с
+\f3ケース 4 \- 任意のディレクトリから実行。ソースファイルは複数のディレクトリツリー内にある\fP \- これはケース 3 と似ていますが、パッケージが複数のディレクトリツリーに存在します。それぞれのツリーのルートへのパスを \f2\-sourcepath\fP に指定し (コロンで区切る)、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。1 つのパッケージのすべてのソースファイルが、1 つのルートディレクトリの下に存在しなければならない、ということはありません。ソースパスとして指定された場所のどこかで見つかれば十分です。
.nf
\f3
.fl
@@ -5525,21 +3984,16 @@
.fl
.fi
.RE
-
-.LP
-.LP
-腟: 筝荐宴若鴻с\f2java.awt\fP \f2java.awt.event\fP 宴若後 public protected 鴻ゃ潟帥с若鴻ゃHTML 綵√ャ＜潟絎ｃ (\f2/home/html\fP) HTML ＜ゃ篆絖障2 や札筝宴若吾сャ＜潟宴若吾鴻鴻鴻潟＜ゃ潟鴻若吾 3 ゃ若ゃ障
-.LP
+.LP
+結果: すべてのケースでパッケージ \f2java.awt\fP および \f2java.awt.event\fP 内の public および protected クラスとインタフェースについて、HTML 形式のドキュメントが生成され、指定された生成先ディレクトリ (\f2/home/html\fP) に HTML ファイルが保存されます。2 つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラスページという 3 つのフレームを持つことになります。
.SS
-1 や札筝鴻ャ＜潟
-.LP
-.LP
-障1 や札筝純若鴻＜ゃ (\f2.java\fP) 羝＜Javadoc 若絎茵с障javadoc 罨＜ 2 ゃ＜号у茵с障 1 ゃ\f2cd\fP 潟潟сｃ紊眼号 1 ゃ \f2.java\fP ＜ゃ吾鴻絎絎号с後障鴻憜ｃ莎欠鴻障純若鴻＜ゃ羝＜\f2\-sourcepath\fP 激с潟∴障≪鴻帥鴻 (*) 潟潟茵ゃ若篏睡鴻違若絎с障
-.LP
+1 つ以上のクラスのドキュメント化
+.LP
+また、1 つ以上のソースファイル (\f2.java\fP) を渡して、Javadoc ツールを実行することもできます。javadoc は、次の 2 つの方法のいずれかで実行できます。1 つは \f2cd\fP を使用してディレクトリを変更する方法、もう 1 つは \f2.java\fP ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソースファイル名を渡すときは、 \f2\-sourcepath\fP オプションは無視されます。アスタリスク (*) のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。
.RS 3
.TP 2
o
-\f3宴若 1 \- 純若鴻ｃ腱祉\fP \- \f2.java\fP ＜ゃｃ腱祉障罨＜ャ＜潟 1 や札筝純若鴻＜ゃ絎 javadoc 絎茵障
+\f3ケース 1 \- ソースディレクトリに移る\fP \- \f2.java\fP ファイルのあるディレクトリに移ります。次に、ドキュメント化する 1 つ以上のソースファイルの名前を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5548,10 +4002,10 @@
% \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP
.fl
.fi
-箴с \f2Button\fP \f2Canvas\fP喝 \f2Graphics\fP у障鴻ゃHTML 綵√ャ＜潟障宴若後с純若鴻＜ゃ javadoc 綣違羝＜сャ＜潟鴻鴻＜ゃ潟若吾 2 ゃ若ゃ障
+この例では、クラス \f2Button\fP と \f2Canvas\fP 、および名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。パッケージ名ではなくソースファイルが javadoc に引数として渡されているので、ドキュメントは、クラスのリストとメインページという 2 つのフレームを持つことになります。
.TP 2
o
-\f3宴若 2 \- 宴若吾若ｃ腱祉\fP \- 若茲違泣宴若吾純若鴻＜ゃャ＜潟翫箴水с宴若吾若ｃ腱祉純若鴻＜ゃ若鴻絎障
+\f3ケース 2 \- パッケージのルートディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソースファイルをドキュメント化する場合に便利です。パッケージのルートディレクトリに移り、各ソースファイルを、ルートからのパスとともに指定します。
.nf
\f3
.fl
@@ -5560,103 +4014,88 @@
% \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP
.fl
.fi
-箴с\f2Button\fP 鴻 \f2Applet\fP 鴻ゃHTML 綵√ャ＜潟障
+この例では、クラス \f2Button\fP および \f2Applet について、HTML 形式のドキュメントが生成されます\fP。
.TP 2
o
-\f3宴若 3 \- 篁紙ｃ\fP \- 宴若鴻с憜ｃсｃ障障ャ＜潟 \f2.java\fP ＜ゃ吾腟九障 (障憜ｃ後障) 絎 javadoc 絎茵障
+\f3ケース 3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する .java ファイルへの絶対パス (またはカレントディレクトリからの相対パス) を指定して \f2javadoc\fP を実行します。
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java\fP
.fl
.fi
-箴с \f2Button\fP \f2Graphics\fP у障鴻ゃHTML 綵√ャ＜潟障
+この例では、クラス \f2Button\fP と、名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。
.RE
-
-.LP
.SS
-宴若吾鴻ャ＜潟
-.LP
-.LP
-宴若後篏鴻絎ャ＜潟с障罨＜菴違 2 ゃ箴腟水箴腓冴障\f2\-sourcepath\fP 宴若吾吾鴻絲障篏睡с障鴻鴻絲障篏睡с障
-.LP
+パッケージとクラスのドキュメント化
+.LP
+パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に前述の 2 つの例を組み合わせた例を示します。 \f2\-sourcepath\fP は、パッケージへのパスに対しては使用できますが、個々のクラスのパスに対しては使用できません。
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java\fP
.fl
.fi
-
-.LP
-.LP
-箴с宴若 \f2java.awt\fP \f2Applet\fP ゃHTML 綵√ャ＜潟障Javadoc 若\f2Applet\fP 宴若後\f2Applet.java\fP 純若鴻＜ゃ宴若後ｈ (絎ｈ翫) ゅャ障
-.LP
-.SH "篏睡箴"
-.LP
-.LP
-Javadoc 若紊箴水激с潟筝祉激с潟紫篏帥障х換篁Java 若 API 絲障 Javadoc 若絎茵篏睡絎潟潟сJava 2 Platform, Standard Edition, v1.2 絖膣 1500 public protected 鴻ゃャ＜潟180M ゃ＜≪若篏睡障
-.LP
-.LP
-箴 2 ｲ莠障 箴潟潟茵絎茵с2 箴 Makefile 絎茵с激с潟綣違腟九障鴻篏睡篁紙ｃ \f2javadoc\fP 潟潟絎茵с障
-.LP
+.LP
+この例では、パッケージ \f2java.awt\fP とクラス \f2Applet について、HTML 形式のドキュメントが生成されます\fP。Javadoc ツールは、 \f2Applet.java ソースファイル内にパッケージ宣言があれば、\fP その宣言に基づいて \f2Applet のパッケージ名を\fP 判定します。
+.SH "使用例"
+.LP
+Javadoc ツールには多くの便利なオプションがあり、その中にはほかのオプションよりも頻繁に使われるものがあります。ここで紹介するのは、Java プラットフォーム API に対して Javadoc ツールを実行するときに使用する実際のコマンドです。ここでは、Java SE Platform, Standard Edition, v1.2 の (約) 1500 個の public および protected クラスのドキュメントを生成するために、180M バイトのメモリーを使用します。
+.LP
+同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。オプションの引数で絶対パスが使用されているため、同じ \f2javadoc\fP コマンドをどのディレクトリからでも実行できます。
.SS
-潟潟茵箴
-.LP
-.LP
-罨＜潟潟茵箴 900 絖莇DOS 激с紊с障狗帥潟潟茵綣違＜ゃ篏睡障 障激с鴻荐菴違障
-.LP
+コマンド行の例
+.LP
+次の例は、DOS などの一部のシェルでは長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェルスクリプトを記述します。
.nf
\f3
.fl
-% javadoc \-sourcepath /java/jdk/src/share/classes \\
-.fl
- \-overview /java/jdk/src/share/classes/overview.html \\
-.fl
- \-d /java/jdk/build/api \\
-.fl
- \-use \\
-.fl
- \-splitIndex \\
-.fl
- \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification' \\
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
-.fl
- \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
-a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
-.fl
-Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
-.fl
-901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
+% javadoc \-sourcepath /java/jdk/src/share/classes \\
+.fl
+ \-overview /java/jdk/src/share/classes/overview.html \\
+.fl
+ \-d /java/jdk/build/api \\
+.fl
+ \-use \\
+.fl
+ \-splitIndex \\
+.fl
+ \-windowtitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-doctitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-header '<b>Java(TM) SE 7</b>' \\
+.fl
+ \-bottom '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>' \\
.fl
\-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
.fl
- \-group "Extension Packages" "javax.*" \\
-.fl
- \-J\-Xmx180m \\
+ \-group "Extension Packages" "javax.*" \\
+.fl
+ \-J\-Xmx180m \\
.fl
@packages
.fl
\fP
.fi
-
-.LP
-.LP
-筝荐潟潟с\f2packages\fP 絲乗院宴若後 (\f2java.applet java.lang\fP ) ャｃ＜ゃс激с潟筝綣膃у蚊障綣違眼壕絖水ャс障違箴潟種若鴻翫\f2\-bottom\fP 激с潟壕絖ゃ羈с
-.LP
+.LP
+上記のコマンドで、 \f2packages\fP は、処理対象のパッケージ名 ( \f2java.applet java.lang\fP など) が入っているファイルの名前です。各オプションの、単一引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー＆ペーストする場合は、 \f2\-bottom\fP オプションから改行文字を削除してください。さらに、このあとの「注」も参照してください。
.SS
-Makefile 箴
-.LP
-.LP
-сGNU Makefile 箴腓冴障Windows Makefile 箴ゃ
+Makefile の例
+.LP
+ここでは、GNU Makefile の例を示します。Windows の Makefile の例については、
.na
-\f2Windows Makefile 篏号\fP @
+\f2Windows の Makefile の作成方法\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#makefilesс
-.LP
+http://java.sun.com/j2se/javadoc/faq/index.html#makefilesを参照してください。
.nf
\f3
.fl
@@ -5692,101 +4131,83 @@
.fl
.fl
-WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
-.fl
-DOCTITLE = 'Java(TM) 2 Platform v1.2 API Specification'
-.fl
-HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
-.fl
-BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
- a bug or feature</a><br><br>Java is a trademark or registered trademark
-.fl
- of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
-.fl
- Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
- All Rights Reserved.</font>'
+WINDOWTITLE = 'Java(TM) SE 7 API Specification'
+.fl
+DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
+.fl
+HEADER = '<b>Java(TM) SE 7</font>'
+.fl
+BOTTOM = '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>'
.fl
GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
.fl
GROUPEXT = '"Extension Packages" "javax.*"'
.fl
-SRCDIR = '/java/jdk/1.2/src/share/classes'
+SRCDIR = '/java/jdk/1.7.0/src/share/classes'
.fl
\fP
.fi
-
-.LP
-.LP
-Makefile 綣違筝綣膃у蚊帥障
-.LP
-.LP
-\f3羈\fP
-.LP
+.LP
+Makefile の引数は、単一引用符で囲みます。
+.LP
+\f3注\fP
.RS 3
.TP 2
o
-\f2\-windowtitle\fP 激с潟ャJavadoc 若ｃャ＜潟帥ゃｃ潟帥ゃ潟若障\f2\-windowtitle\fP 鴻堺 \f2\-doctitle\fP с HTML 帥違篏睡障 HTML 帥違ｃ潟帥ゃ障障鴻茵腓冴障障
+\-windowtitle \f2オプションを省略すると、\fP Javadoc ツールによってドキュメントタイトルがウィンドウタイトルにコピーされます。 \f2\-windowtitle\fP のテキストは基本的に \f2\-doctitle\fP のものと同じですが、HTML タグを含まない点が異なります。これは、HTML タグが raw テキストとしてウィンドウタイトル内に表示されるのを防ぐためです。
.TP 2
o
-箴 \f2\-footer\fP 激с潟ャJavadoc 若ｃ若鴻帥若潟若障
+ここで行っているように \f2\-footer\fP オプションを省略すると、Javadoc ツールによってヘッダーのテキストがフッターにコピーされます。
.TP 2
o
-箴с綽荀障\-\f2classpath\fP \-\f2link\fP 荀激с潟с
+この例では必要ありませんが、\-\f2classpath\fP と \-\f2link\fP も重要なオプションです。
.RE
-
-.LP
-.SH "激ャ若ｃ潟"
-.LP
+.SH "トラブルシューティング"
.SS
-筝激ャ若ｃ潟
-.LP
+一般的なトラブルシューティング
.RS 3
.TP 2
o
-\f3Javadoc FAQ\fP \- 筝違潟激ャ若ｃ潟違潟
+\f3Javadoc FAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、
.na
-\f2Javadoc FAQ\fP @
+\f2「Javadoc FAQ」\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#B усс障
+http://java.sun.com/j2se/javadoc/faq/index.html#B で参照できます。
.TP 2
o
-\f3違喝狗篋\fP \- 違筝Important Bug Fixes and Changes ссс障
+\f3バグおよび制限事項\fP \- バグの一部は、「Important Bug Fixes and Changes」 でも参照できます。
.TP 2
o
-\f3若吾с括\fP \- 若吾с括垩с
+\f3バージョン番号\fP \- 「バージョン番号」を参照してください。
.TP 2
o
-\f3鴻鴻ャ＜潟\fP \- 宴若吾ャ＜潟Javadoc 鴻劫ф＜ゃ帥茯粋昭帥障違＜ゃゃ潟\-сjavadoc ＜ゃ茹ｆ蚊с障
+\f3有効なクラスだけをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadoc は、有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、javadoc によるファイルの解析を防ぐことができます。
.RE
-
-.LP
.SS
-若茘
-.LP
-.LP
-若活＜祉若吾＜ゃ絎ｈ茵 (ャ＜潟若激с潟潟＜潟劫茵с) 茵垩障障
-.LP
+エラーと警告
+.LP
+エラーおよび警告メッセージには、ファイル名と宣言行 (ドキュメンテーションコメント内の特定の行ではない) の行番号が含まれます。
.RS 3
.TP 2
o
-\f2"error:cannot read:Class1.java"\fP Javadoc 若潟ｃ Class1.java 鴻若障腟九障鴻障後障鴻茵腓冴劫箴翫 \f2./Class1.java\fP с
+\f2"error: cannot read: Class1.java"\fP Javadoc ツールはカレントディレクトリに Class1.java クラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合 \f2./Class1.java と同じです\fP。
.RE
-
-.LP
-.SH "医"
-.LP
+.SH "環境"
.RS 3
.TP 3
CLASSPATH
-Javadoc 若吟若鴻＜ゃ｢篏帥鴻絎医紊違с医紊違\f2\-classpath\fP 激с潟ｃ若若ゃ障ｃ罨＜潟潟у阪障
+Javadoc がユーザークラスのファイルを探すときに使うパスを指定する環境変数です。この環境変数は、 \f2\-classpath\fP オプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。
.:/home/classes:/usr/local/java/classes
.RE
-
-.LP
-.SH "∫ｉ"
-.LP
+.SH "関連項目"
.RS 3
.TP 2
o
@@ -5806,7 +4227,7 @@
.TP 2
o
.na
-\f2Javadoc 若若\fP @
+\f2Javadoc のホームページ\fP @
.fi
http://java.sun.com/j2se/javadoc/index.jsp
.TP 2
@@ -5818,16 +4239,14 @@
.TP 2
o
.na
-\f2鴻鴻荐絎\fP @
+\f2クラスパスの設定\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
.TP 2
o
.na
-\f2javac javadoc 鴻罎膣≪号\fP @
+\f2javac と javadoc がクラスを検索する方法\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
.RE
-
-.LP
--- a/jdk/src/linux/doc/man/ja/javah.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javah.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,82 +19,67 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javah 1 "02 Jun 2010"
+.TH javah 1 "14 Apr 2011"
.LP
-.SH ""
-javah \- C 若鴻帥＜ゃ吾с若
-.LP
-.RS 3
-
+.SH "名前"
+javah \- C ヘッダーとスタブファイルジェネレータ
.LP
.LP
-\f3javah\fP Java 鴻 C 若＜ゃ C 純若鴻＜ゃ篏障＜ゃJava 違潟域茯ф吾潟若C 篁荐茯ф吾潟若･膓潟若娯篏障
+\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
.fl
-javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
-.fl
\fP
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javah\fP ゃｃ＜純絎茖綽荀 C 若純若鴻＜ゃ障篏若純若鴻＜ゃゃｃ純若鴻潟若吾сゃ潟鴻帥潟劫違с C 違ｃ篏睡障.h ＜ゃ絲上鴻筝眼臀ゆ篏絎臂帥障罕篏ｃ若鴻ゃ潟鴻帥潟劫違絲上障
-.LP
-.LP
-若＜ゃ筝уｈ罕篏鴻羇丞障\f3javah\fP 羝＜鴻宴若吾筝翫宴若後若＜ゃ罕篏筝≧鴻篁障筝膩 (_) 阪絖篏睡障
+\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。
.LP
.LP
-с \f3javah\fP 潟潟茵鴻鴻若＜ゃ篏憜ｃ＜ゃ臀障純若鴻＜ゃ篏\f2\-stubs\fP 激с潟篏睡1 ゃ＜ゃ筝鴻鴻鴻腟ｇ\f2\-o\fP 激с潟篏睡
-.LP
-.LP
-違ゃｃ＜純ゃ潟帥с若鴻с Java Native Interface (JNI) 惹宴障鴻帥＜ゃ綽荀障 憜с\f3javah\fP JNI 綵√ゃｃ＜純綽荀ゃｃ＜純罘純帥ゃ障 с\f3javah\fP JNI 綵√у阪腟 .h ＜ゃ主障
+ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。
.LP
.LP
-\f3javah_g\fP jdb(1) \f3javah\fP 若吾с潟с
+デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。
+.LP
.LP
-.SH "激с"
+新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-o outputfile
-潟潟茵鴻鴻鴻絲障腟若障純若鴻＜ゃｇ \f2outputfile\fP 主障\f3\-o\fP 障 \f3\-d\fP ＜筝鴻篏帥障
+コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して \f2outputfile\fP に格納します。\f3\-o\fP または \f3\-d\fP のどちらか一方だけが使われます。
.TP 3
\-d directory
-\f3javah\fP 若＜ゃ障鴻帥＜ゃ篆絖ｃ荐絎障\f3\-d\fP 障 \f3\-o\fP ＜筝鴻篏帥障
+\f3javah\fP がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。\f3\-d\fP または \f3\-o\fP のどちらか一方だけが使われます。
.TP 3
\-stubs
-\f3javah\fP Java 吾с＜ゃ C 絎ｈ障
+\f3javah\fP が、Java オブジェクトファイルから C 宣言を生成します。
.TP 3
\-verbose
-荅括完阪絎篏＜ゃ倶≪＜祉若吾\f3javah\fP 罔羣阪阪障
+詳細出力を指定し、作成ファイルの状態に関するメッセージを、\f3javah\fP が標準出力に出力します。
.TP 3
\-help
-\f3javah\fP 篏睡羈ゃ＜祉若吾阪障
+\f3javah\fP の使用法についてのヘルプメッセージを出力します。
.TP 3
\-version
-\f3javah\fP 若吾с恰宴阪障
+\f3javah\fP のバージョン情報を出力します。
.TP 3
\-jni
-JNI 綵√ゃｃ＜ゃ罘純帥ゃ阪＜ゃ\f3javah\fP 篏障罔羣阪с\f3\-jni\fP 篏睡激с潟с
+JNI 形式のネイティブファイル機能プロトタイプを含む出力ファイルを、\f3javah\fP が作成します。これは標準出力であるため、\f3\-jni\fP の使用はオプションです。
.TP 3
\-classpath path
-鴻｢ \f3javah\fP 篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
+クラスを探すために \f3javah\fP が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -102,7 +87,7 @@
.fl
\fP
.fi
-箴腓冴障
+次に例を示します。
.nf
\f3
.fl
@@ -111,33 +96,31 @@
\fP
.fi
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。 \f2*\fP だけから成るクラスパスエントリは、現在のディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.TP 3
\-bootclasspath path
-若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR ＜ゃ 潟 Java 2 若絎茖鴻с
+ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-old
-ゃ JDK1.0 綵√若＜ゃ絎障
+古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
.TP 3
\-force
-阪＜ゃ絽吾吾莨若障絎障
+出力ファイルが常に書き込まれるように指定します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割されています。
.nf
\f3
.fl
@@ -148,11 +131,9 @@
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1)java(1)jdb(1)javap(1)javadoc(1)
+javac(1)、java(1)、jdb(1)、javap(1)、javadoc(1)
.LP
--- a/jdk/src/linux/doc/man/ja/javap.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javap.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javap 1 "02 Jun 2010"
+.TH javap 1 "14 Apr 2011"
.LP
-.SH ""
-javap \- Java 鴻＜ゃ≪祉潟
-.LP
-.RS 3
-
+.SH "名前"
+javap \- Java クラスファイル逆アセンブラ
.LP
.LP
-鴻＜ゃ≪祉潟障
+クラスファイルを逆アセンブルします。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,15 +39,10 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javap\fP 潟潟鴻＜ゃ≪祉潟障阪絎激с潟違障激с潟絎翫\f3javap\fP 宴若吾羝＜鴻 protected public ｃ若＜純阪障 \f3javap\fP 阪罔羣阪茵腓冴障違罨＜劫ｈ潟潟ゃ障
-.LP
-.RS 3
-
+\f3javap\fP コマンドは、クラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。たとえば、次のクラス宣言をコンパイルするとします。
.LP
.nf
\f3
@@ -96,14 +85,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3javap DocFooter\fP 阪罨＜障
-.LP
-.RS 3
-
+\f3javap DocFooter\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
@@ -126,14 +111,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3javap \-c DocFooter\fP 阪罨＜障
-.LP
-.RS 3
-
+\f3javap \-c DocFooter\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
@@ -244,41 +225,35 @@
.fl
\fP
.fi
-.RE
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-\-help
-\f3javap\fP ＜祉若吾阪障
+\-help \-\-help \-?
+\f3javap\fP のヘルプメッセージを出力します。
+.TP 3
+\-version
+バージョン情報を表示します。
.TP 3
\-l
-茵垩絮紊違若茵腓冴障
-.TP 3
-\-b
-JDK 1.1 \f3javap\fP 筝篏篋с篆荐若障
+行番号と局所変数テーブルを表示します。
.TP 3
\-public
-public 鴻潟＜潟若茵腓冴障
+public クラスおよびメンバーだけを表示します。
.TP 3
\-protected
-protected public 鴻＜潟若茵腓冴障
+protected および public のクラスとメンバーだけを表示します。
.TP 3
\-package
-packageprotected public 鴻＜潟若茵腓冴障荐絎с
+package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。
.TP 3
-\-private
-鴻鴻＜潟若茵腓冴障
+\-private \-p
+すべてのクラスとメンバーを表示します。
.TP 3
\-Jflag
-潟帥ゃ激鴻贋･ \f2flag\fP 羝＜障篏睡箴罨＜腓冴障
-.RS 3
-
-.LP
+ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
.nf
\f3
.fl
@@ -288,23 +263,28 @@
.fl
\fP
.fi
-.RE
.TP 3
\-s
-激違ｃ若阪障
+内部の型シグニチャーを出力します。
+.TP 3
+\-sysinfo
+処理中のクラスのシステム情報 (パス、サイズ、日付、MD5 ハッシュ) を表示します。
+.TP 3
+\-constants
+static final 定数を表示します。
.TP 3
\-c
-鴻＜純≪祉潟潟若 Java ゃ潟若巡擦茵腓冴障
+クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
.na
-\f2Java Virtual Machine Specification\fP @
+\f2「Java Virtual Machine Specification」\fP @
.fi
-http://java.sun.com/docs/books/vmspec/ャ＜潟障
+http://java.sun.com/docs/books/vmspec/にドキュメント化されています。
.TP 3
\-verbose
-＜純鴻帥泣ゃ冴 \f2locals\fP \f2args\fP 違阪障
+メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
.TP 3
\-classpath path
-\f3javap\fP 鴻｢篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
+\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -312,7 +292,7 @@
.fl
\fP
.fi
-箴腓冴障
+次に例を示します。
.nf
\f3
.fl
@@ -322,24 +302,19 @@
.fi
.TP 3
\-bootclasspath path
-若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR ＜ゃ 潟 Java 2 若絎茖鴻с
+ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-extdirs dirs
-ゃ潟鴻若≦宍罘純罎膣≪贋若若ゃ障The default location for extensions is the value of \f2java.ext.dirs\fP.
+インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障 罨＜箴腓冴障
-.RS 3
-
-.LP
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.nf
\f3
.fl
@@ -348,14 +323,11 @@
\fP
.fi
.RE
-.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1) java(1)jdb(1)javah(1)javadoc(1)
+javac(1)、java(1)、jdb(1)、javah(1)、javadoc(1)
.LP
--- a/jdk/src/linux/doc/man/ja/javaws.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javaws.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,30 +19,18 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javaws 1 "02 Jun 2010"
+.TH javaws 1 "14 Apr 2011"
.LP
-.SH ""
-\f2javaws\fP 潟潟茵
+.SH "名前"
+\f2javaws\fP コマンド行
+.LP
+.SH "名前"
.LP
.LP
-\
-.LP
-.SS
-NAME
-.LP
-.RS 3
-
-.LP
+\f2javaws\fP \- Java Web Start 起動コマンド
.LP
-\f2javaws\fP \- Java Web Start 莎桁潟潟
-.LP
-.RE
-.SS
-綵√
-.LP
-.RS 3
-
+.SH "形式"
.LP
.LP
\f2javaws [run\-options] <jnlp>\fP
@@ -50,309 +38,185 @@
.LP
\f2javaws [control\-options]\fP
.LP
-.RE
-.SS
-＜若
-.LP
-.RS 3
-
+.SH "パラメータ"
.LP
.LP
\f2[run\-options]\fP
.LP
-.RS 3
-
-.LP
.LP
-潟潟茵絎茵激с潟 絎茵激с潟篁紙綺ф絎с障腮激с潟ゃ筝 絎茵激с潟с
+コマンド行実行オプション。実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。
.LP
-.RE
.LP
\f2<jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-JNLP (Java Network Launching Protocol) ＜ゃ鴻障 URL (Uniform Resource Locator) ＜с
+JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。
.LP
-.RE
.LP
\f2[control\-options]\fP
.LP
-.RS 3
-
-.LP
-.LP
-潟潟茵九勝激с潟 九勝激с潟篁紙綺ф絎с障腮激с潟ゃ筝 九勝激с潟с
.LP
-.RE
-.RE
-.SS
-茯
+コマンド行制御オプション。制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。
.LP
-.RS 3
-
+.SH "説明"
.LP
.LP
-\f2javaws\fP 潟潟JNLP (Java Network Launching Protocol) ＜潟劫茖с Java Web Start 莎桁障Java Web Start 若筝у篏 Java ≪宴若激с潟障≪莎桁障
-.LP
-.LP
-JNLP ＜ゃ絎\f2javaws\fP JNLP ＜ゃ絎 Java ≪宴若激с潟障≪莎桁障
+\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。
.LP
.LP
-\f2javaws\fP 莎桁若憜若鴻с泣若 1 腟激с潟障激с潟絨ャ若鴻сゃ醇с障
+JNLP ファイルが指定された場合、 \f2javaws\fP は、その JNLP ファイルで指定された Java アプリケーション/アプレットを起動します。
+.LP
.LP
-.RE
-.SS
-絎茵激с
+\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
.LP
-.RS 3
-
+.SH "実行オプション"
.LP
.LP
\f2\-offline\fP
.LP
-.RS 3
-
-.LP
.LP
-Java Web Start ゃ潟≪若у茵障
+Java Web Start をオフラインモードで実行します。
.LP
-.RE
.LP
\f2\-Xnosplash\fP
.LP
-.RS 3
-
-.LP
.LP
-鴻激ョ脂≪茵腓冴≦鴻障
+最初のスプラッシュ画面の表示を無効にします。
.LP
-.RE
.LP
\f2\-open <arguments>\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎JNLP ＜ゃ綣違 \f2\-open <arguments>\fP 臀障
+このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。
.LP
-.RE
.LP
\f2\-print <arguments>\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎JNLP ＜ゃ綣違 \f2\-print <arguments>\fP 臀障
+このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。
.LP
-.RE
.LP
\f2\-online\fP
.LP
-.RS 3
-
-.LP
.LP
-潟ゃ潟≪若у茵障 (篏)
+オンラインモードで実行します (デフォルトの動作)。
.LP
-.RE
.LP
\f2\-wait\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎≪宴若激с潟腟篋障 \f2javaws\fP 祉鴻腟篋障
+このオプションを指定した場合、 \f2javaws\fP プロセスは、アプリケーションが終了するまで終了しません。Windows プラットフォーム上では、このオプションは説明したとおりに機能しません。
.LP
-.RE
.LP
\f2\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-菴遵阪茵腓冴障
+追加の出力を表示します。
.LP
-.RE
.LP
\f2\-J<option>\fP
.LP
-.RS 3
-
-.LP
.LP
-vm 激с潟茖障
+vm にオプションを補います。
.LP
-.RE
.LP
\f2\-system\fP
.LP
-.RS 3
-
-.LP
-.LP
-≪宴若激с潟激鴻ｃ激ャ水茵障
.LP
-.RE
-.RE
-.SS
-九勝激с
+アプリケーションをシステムキャッシュからのみ実行します。
.LP
-.RS 3
-
+.SH "制御オプション"
.LP
.LP
\f2\-viewer\fP
.LP
-.RS 3
-
+.LP
+Java コントロールパネルでキャッシュビューアを表示します。
.LP
.LP
-Java 潟潟若сｃ激ャャ若≪茵腓冴障
+\f2\-clearcache\fP
+.LP
.LP
-.RE
+インストールされていないすべてのアプリケーションをキャッシュから削除します。
+.LP
.LP
\f2\-userConfig <property name>\fP
.LP
-.RS 3
-
-.LP
.LP
-絎ｃ若≪障
+指定された配備プロパティーをクリアします。
.LP
-.RE
.LP
\f2\-userConfig <property name> <property value>\fP
.LP
-.RS 3
-
-.LP
.LP
-絎ｃ若絎ゃ荐絎障
+指定された配備プロパティーを指定された値に設定します。
.LP
-.RE
.LP
\f2\-uninstall\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ鴻≪宴若激с潟ゃ障
+キャッシュからすべてのアプリケーションを削除します。
.LP
-.RE
.LP
\f2\-uninstall <jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ≪宴若激с潟ゃ障
+キャッシュからアプリケーションを削除します。
.LP
-.RE
.LP
\f2\-import [import\-options] <jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ≪宴若激с潟ゃ潟若障
+キャッシュにアプリケーションをインポートします。
.LP
-.RE
-\f3ゃ潟若激с\fP
+.SH "インポートオプション"
.LP
.LP
\f2\-silent\fP
.LP
-.RS 3
-
-.LP
.LP
-泣ゃ潟≪若сゃ潟若障 (UI 茵腓冴障)
+サイレントモードでインポートします (UI は表示されません)。
.LP
-.RE
.LP
\f2\-system\fP
.LP
-.RS 3
-
-.LP
.LP
-激鴻ｃ激ャ≪宴若激с潟ゃ潟若障
+システムキャッシュにアプリケーションをインポートします。
.LP
-.RE
.LP
\f2\-codebase <url>\fP
.LP
-.RS 3
-
-.LP
.LP
-篁紙 codebase 純若鴻緇障
+任意の codebase からリソースを取得します。
.LP
-.RE
.LP
\f2\-shortcut\fP
.LP
-.RS 3
-
-.LP
.LP
-若吟取┗絎鴻潟激с若ゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
+ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。
.LP
-.RE
.LP
\f2\-association\fP
.LP
-.RS 3
-
-.LP
-.LP
-若吟取┗絎鴻潟∫ｄゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
.LP
-.RE
-.RE
-.SS
-＜ゃ
+ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。
.LP
-.RS 3
-
+.SH "ファイル"
.LP
.LP
-若吟若ｃ激ャ激鴻ｃ激ャ deployment.properties ＜ゃゃ
+ユーザーキャッシュ、システムキャッシュ、および deployment.properties ファイルについては、
.na
-\f2激鴻潟若吟若ｃ\fP @
+\f2システムレベルおよびユーザーレベルのプロパティー\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。
.LP
-.RE
-.SS
-荅括完
-.LP
-.RS 3
-
+.SH "詳細情報"
.LP
.LP
-Java Web Start 荅括完
+Java Web Start の詳細は、
.na
-\f2Java Web Start\fP @
+\f2「Java Web Start」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。
.LP
-.RS 3
-
-.LP
-.LP
-\
-.LP
-.RE
-.RE
--- a/jdk/src/linux/doc/man/ja/jconsole.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jconsole.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jconsole 1 "02 Jun 2010"
+.TH jconsole 1 "14 Apr 2011"
.LP
-.SH ""
-jconsole \- Java ｈ括∞潟潟純若
+.SH "名前"
+jconsole \- Java 監視および管理コンソール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -58,63 +56,60 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
-.br
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
connection = pid | host:port | jmxUrl
.RS 3
-\f2pid\fP\ \ \ 若 Java VM 祉 IDJava VM jconsole 絎茵若吟 ID 若吟 ID 篏睡絎茵綽荀障荅括完ゃ
+.TP 2
+o
+\f2pid\fPローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、
.na
-\f2JMX ｈ括∞\fP @
+\f2「JMX 監視および管理」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
-.br
-\f2host\fP:\f2port\fP\ \ Java VM 絎茵鴻激鴻JVM 莎桁激鴻ｃ \f2com.sun.management.jmxremote.port\fP ф絎若垩荅括完ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
+.TP 2
+o
+\f2host\fP:\f2port\fP Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、
.na
-\f2JMX ｈ括∞\fP @
+\f2「JMX 監視および管理」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
-.br
-\f2jmxUrl\fP ･膓 JMX 若吾с潟≪鴻 ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
+.TP 2
+o
+\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。これについては、
.na
\f2JMXServiceURL\fP @
.fi
-http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html с
+http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。
.RE
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jconsole\fP 潟潟若激潟障≪若激割 Java ≪宴若激с潟篁潟激潟ｈ膊∞茵違ｃ潟潟純若若莎桁障
+\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。
.LP
.LP
-Windows 筝с\f3jconsole\fP 潟潟純若ｃ潟∫ｄ障宴 \f3jconsole\fP 潟潟紊掩惹宴腓冴ゃ≪違鴻茵腓冴障
+Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-interval=n
-贋育 \f2n\fP 腱荐絎障 ( 4 腱)
+更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。
.TP 3
-\-notile\
-ｃ潟帥ゃ潟違障 (茲違･膓)
+\-notile
+最初にウィンドウをタイリングしません (複数の接続のため)。
.TP 3
-\-pluginpath\ plugins
-JConsole 違ゃ潟罎膣√ｃ障 JAR ＜ゃ鴻絎障\f2plugins\fP 鴻罨＜ゃ罕＜ゃ
+\-pluginpath plugins
+JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
.br
.nf
\f3
@@ -124,36 +119,36 @@
\fP
.fi
.LP
-
+これには、
.na
\f2com.sun.tools.jconsole.JConsolePlugin\fP @
.fi
-http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html 鴻絎茖鴻絎篆蕋障劫絎茵違ゃ潟 1 茵ゅ障障
+http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
.TP 3
-\-version\
-若吾с恰宴阪腟篋障
+\-version
+バージョン情報を出力して終了します。
.TP 3
-\-help\
-＜祉若吾阪腟篋障
+\-help
+ヘルプメッセージを出力して終了します。
.TP 3
-\-J<flag>\
-jconsole 絎茵 Java 篁潟激潟 <flag> 羝＜障
+\-J<flag>
+jconsole が実行されている Java 仮想マシンに <flag> を渡します。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2jconsole 篏睡\fP @
+\f2JConsole の使用\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
.TP 2
o
.na
-\f2Java 若ｈ括∞\fP @
+\f2「Java プラットフォームの監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
.RE
--- a/jdk/src/linux/doc/man/ja/jdb.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jdb.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jdb 1 "02 Jun 2010"
+.TH jdb 1 "14 Apr 2011"
.LP
-.SH ""
-jdb \- Java
-.LP
-.RS 3
-
+.SH "名前"
+jdb \- Java デバッガ
.LP
.LP
-\f3jdb\fP Java 荐茯違違荀ゃ篆罩ｃ篏睡若с
+\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,41 +39,32 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-罨＜腓冴潟潟茵激с
+次に示すコマンド行オプション
.TP 3
class
-違紮鴻
+デバッグを開始するクラスの名前
.TP 3
arguments
-\f2class\fP \f2main()\fP ＜純羝＜綣
+class の \f2main()\fP メソッドに渡す \f2引数\fP
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-Java \f3jdb\fP Java 合膂≦潟潟茵с
+Java デバッガ \f3jdb\fP は、Java クラス用の簡単なコマンド行デバッガです。
.na
\f2Java Platform Debugger Architecture\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html 荀荀絎茵若障≪若 Java Virtual Machine 罎祉違茵с障
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html を視覚的に実行し、ローカルまたはリモートの Java Virtual Machine の検査とデバッグを行うことができます。
.LP
.SS
-jdb 祉激с潟紮
-.LP
-.RS 3
-
+jdb セッションの開始
.LP
.LP
-jdb 祉激с潟紮障障号障ｃ紫篏帥違≪宴若激с潟＜ゃ潟鴻篏睡\f3jdb\fP 違 Java 篁潟激 (VM) 莎桁号с潟潟茵с \f3java\fP 篁ｃ \f3jdb\fP 潟潟ュ障違≪宴若激с潟＜ゃ潟鴻 MyClass 翫JDB 医с違罨＜潟潟篏睡障
+jdb セッションを開始するにはさまざまな方法があります。もっとも頻繁に使われるのは、デバッグするアプリケーションのメインクラスを使用して、\f3jdb\fP から新しい Java 仮想マシン (VM) を起動する方法です。コマンド行で、\f3java\fP の代わりに \f3jdb\fP コマンドを入力します。たとえば、アプリケーションのメインクラスが MyClass の場合は、JDB 環境でデバッグするときに次のコマンドを使用します。
.LP
.nf
\f3
@@ -91,10 +76,10 @@
.LP
.LP
-号ц儀\f3jdb\fP 絎＜若帥篏帥ｃ 2 ょ Java VM 若喝冴障 罨＜絎鴻若鴻巡擦絎茵 VM 罩≪障
+この方法で起動すると、\f3jdb\fP は、指定されたパラメータを使って 2 つ目の Java VM を呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前に VM を停止させます。
.LP
.LP
-\f3jdb\fP 1 ゃ篏睡号с莎桁 Java VM jdb ･膓сjdb ･膓 VM 絎茵筝莎桁罕罨＜腓冴障ゃ潟祉鴻亥ゃ若･膓腮蕁絎障
+\f3jdb\fP のもう 1 つの使用方法は、すでに起動している Java VM に jdb を接続することです。jdb が接続する VM を、その実行中に起動するための構文を次に示します。これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
.LP
.nf
\f3
@@ -106,7 +91,7 @@
.LP
.LP
-違罨＜潟潟MyClass ≪宴若激с潟絎茵\f3jdb\fP с≪宴若激с潟･膓с障
+たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。
.LP
.nf
\f3
@@ -118,7 +103,7 @@
.LP
.LP
-罨＜潟潟篏睡\f3jdb\fP VM ･膓с障
+次のコマンドを使用して、\f3jdb\fP を VM に接続できます。
.LP
.nf
\f3
@@ -130,45 +115,42 @@
.LP
.LP
-翫\f3jdb\fP 違 VM 莎桁篁ｃ√ VM ･膓\f3jdb\fP 潟潟茵MyClass絎障
+この場合、\f3jdb\fP は新しい VM を起動する代わりに既存の VM に接続されるため、\f3jdb\fP コマンド行には「MyClass」は指定しません。
.LP
.LP
- VM ･膓祉障障号鴻 \f3jdb\fP с泣若障･膓激с潟ゃJava Platform Debugger Architecture
+デバッガを VM に接続するにはほかにもさまざまな方法があり、すべて \f3jdb\fP でサポートされています。接続オプションについては、Java Platform Debugger Architecture の
.na
-\f2ャ＜潟\fP @
+\f2ドキュメント\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс\f3jdb\fP т戎 J2SE 1.4.2 篁ュ VM 莎桁号ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
.na
-\f21.4.2 ャ＜潟\fP @
+\f21.4.2 のドキュメント\fP @
.fi
-http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlс
+http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlを参照してください。
.LP
.SS
-堺 jdb 潟潟
+基本 jdb コマンド
.LP
.LP
-堺 \f3jdb\fP 潟潟筝荀с腓冴障Java 泣若潟潟篁ュ \f3jdb\fP \f2help\fP 潟潟篏睡茵腓冴с障
-.LP
-.RS 3
-
+基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。
.LP
.RS 3
.TP 3
-help 障 ?
-ｃ荀 \f3jdb\fP 潟潟 \f2help\fP 茯茘潟潟鴻膂≧茯篁茵腓冴障
+help または ?
+もっとも重要な \f3jdb\fP コマンド \f2help\fP は、認識されたコマンドのリストに簡潔な説明を付けて表示します。
.TP 3
run
-\f3jdb\fP 莎桁綽荀若ゃ潟荐絎潟潟篏睡違≪宴若激с潟絎茵紮с障潟潟√ VM ･膓翫違違≪宴若激с潟 \f3jdb\fP 莎桁篏睡с障
+\f3jdb\fP を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、デバッグするアプリケーションの実行を開始できます。このコマンドは、既存の VM に接続している場合とは異なり、デバッグするアプリケーションが \f3jdb\fP から起動したときにだけ使用できます。
.TP 3
cont
-若ゃ潟箴紊障鴻絎茵с違≪宴若激с潟絎茵膓膓障
+ブレークポイント、例外、またはステップ実行のあとで、デバッグするアプリケーションの実行を継続します。
.TP 3
print
-Java 吾с潟ｃゃ茵腓冴障ｃ紊違障ｃ若翫絎ゃ阪障吾с翫茯阪障吾сゃ篁ラ \f2dump\fP 潟潟茯с
+Java オブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の \f2dump\fP コマンドの説明を参照してください。
.LP
-\f2羈:絮紊違茵腓冴紊違鴻 \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP 激с潟с潟潟ゃ違障
+\f2注: 局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされている必要があります。
.LP
-\f2print\fP с＜純若喝冴紊違膂≦ Java 綣泣若障 罨＜箴腓冴障
+\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。次に例を示します。
.RS 3
.TP 2
o
@@ -178,25 +160,22 @@
\f2print myObj.myInstanceField\fP
.TP 2
o
-\f2print i + j + k\fP (ij k ｃсｃ若障絮紊違)
+\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか)
.TP 2
o
-\f2print myObj.myMethod()\fP (myMethod null 篁ュ菴翫)
+\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合)
.TP 2
o
\f2print new java.lang.String("Hello").length()\fP
.RE
.TP 3
dump
-ｃゃ翫潟潟 \f2print\fP с吾с翫吾с絎臂ｃ若憜ゃ阪障static ｃ若 instance ｃ若阪障
+プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。
.LP
-\f2dump\fP 潟潟с\f2print\fP 潟潟綣泣若障
+\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。
.TP 3
threads
-憜絎茵筝鴻筝荀ц；腓冴障鴻憜倶潟祉潟潟篏睡сゃ潟鴻阪障 罨＜箴腓冴障
-.RS 3
-
-.LP
+現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。次に例を示します。
.nf
\f3
.fl
@@ -204,163 +183,144 @@
.fl
\fP
.fi
-.RE
-箴с鴻ゃ潟鴻 4 с鴻 java.lang.Thread ゃ潟鴻帥潟鴻с 鴻mainс憜絎茵筝с
+この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。スレッドの名前は「main」であり、現在実行中です。
.TP 3
thread
-憜鴻鴻御障紊 \f3jdb\fP 潟潟憜鴻荐絎冴ャ絎茵障鴻\f2threads\fP 潟潟ц鴻ゃ潟鴻絎障
+現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。
.TP 3
where
-綣違絎 \f2where\fP 絎茵憜鴻鴻帥潟障 \f2where all\fP 潟潟憜鴻違若鴻鴻帥鴻潟障 \f2where\fP \f2threadindex\fP 絎鴻鴻帥潟障
+\f2引数を指定しないで\fP where を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックをすべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。
.LP
-憜鴻 (若ゃ潟 \f2suspend\fP 潟潟ｃ) 筝翫絮紊違ｃ若 \f2print\fP 潟潟 \f2dump\fP 潟潟ц；腓冴с障\f2up\fP 潟潟 \f2down\fP 潟潟с鴻帥若潟吾吟с障
+現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。
.RE
.LP
-.RE
.SS
-若ゃ潟
-.LP
-.RS 3
-
+ブレークポイント
.LP
.LP
-若ゃ潟茵垩障＜純巡擦 \f3jdb\fP 荐絎с障 罨＜箴腓冴障
+ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。次に例を示します。
.LP
.RS 3
.TP 2
o
-\f2stop at MyClass:22\fP (MyClass 障純若鴻＜ゃ 22 茵巡擦若ゃ潟荐絎)
+\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定)
.TP 2
o
-\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP ＜純若ゃ潟荐絎)
+\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定)
.TP 2
o
-\f2stop in MyClass.<init>\fP (<init> MyClass 潟潟鴻帥茘)
+\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別)
.TP 2
o
-\f2stop in MyClass.<clinit>\fP (<clinit> MyClass 潟若茘)
+\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別)
.RE
.LP
.LP
-＜純若若若翫＜純綣違絎若ゃ潟絲障＜純御違障違\f2MyClass.myMethod(int,java.lang.String)\fP障\f2MyClass.myMethod()\fP絎障
+メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにしなければなりません。たとえば、「\f2MyClass.myMethod(int,java.lang.String)\fP」または「\f2MyClass.myMethod()\fP」と指定します。
.LP
.LP
-\f2clear\fP 潟潟\f2clear\ MyClass:45\fP罕篏睡若ゃ潟ゃ障\f2clear\fP 篏睡綣違絎с潟潟篏睡憜荐絎鴻若ゃ潟茵腓冴障\f2cont\fP 潟潟絎茵膓膓障
+\f2clear\fP コマンドは、「\f2clear\ MyClass:45\fP」のような構文を使用してブレークポイントを削除します。\f2clear\fP を使用するか、引数を指定しないでコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\f2cont\fP コマンドは実行を継続します。
.LP
-.RE
.SS
-鴻絎茵
-.LP
-.RS 3
-
+ステップ実行
.LP
.LP
-\f2step\fP 潟潟憜鴻帥若障若喝冴＜純с罨＜茵絎茵障\f2next\fP 潟潟憜鴻帥若罨＜茵絎茵障
+\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。
.LP
-.RE
.SS
-箴紊
-.LP
-.RS 3
-
+例外
.LP
.LP
-鴻若鴻若喝冴鴻帥筝 catch 翫箴紊榊VM 絽吾箴紊若鴻阪腟篋障\f3jdb\fP 医у茵翫箴紊榊 \f3jdb\fP 九勝祉障罨＜\f3jdb\fP 篏睡箴紊荐堺障
+スローしているスレッドの呼び出しスタック上のどこにも catch 文がない場合に例外が発生すると、VM は通常、例外トレースを出力して終了します。ただし、\f3jdb\fP 環境で実行している場合は、例外が発生すると \f3jdb\fP に制御が戻ります。次に、\f3jdb\fP を使用して例外の原因を診断します。
.LP
.LP
-違\f2catch java.io.FileNotFoundException\fP障\f2catch mypackage.BigTroubleException\fP \f2catch\fP 潟潟篏睡違≪宴若激с潟祉箴紊鴻若罩≪障箴紊劫 (障泣) ゃ潟鴻帥潟鴻翫≪宴若激с潟箴紊鴻若贋у罩≪障
+たとえば、「\f2catch java.io.FileNotFoundException\fP」または「\f2catch mypackage.BigTroubleException\fP」のように \f2catch\fP コマンドを使用すると、デバッグされたアプリケーションは、ほかの例外がスローされたときに停止します。例外が特定のクラス (またはサブクラス) のインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。
.LP
.LP
-\f2ignore\fP 潟潟篏帥篁ュ \f2catch\fP 潟潟号≦鴻障
+\f2ignore\fP コマンドを使うと、以前の \f2catch\fP コマンドの効果が無効になります。
.LP
.LP
-\f2羈:\fP\f2ignore\fP 潟潟с違 VM 箴紊∴箴紊∴障
+\f2注: \fP\f2ignore\fP コマンドでは、デバッグされる VM は例外を無視せず、デバッガだけが例外を無視します。
.LP
-.RE
-.RE
-.SH "潟潟茵激с"
-.LP
-
+.SH "コマンド行オプション"
.LP
.LP
-潟潟茵 Java ≪宴若激с活儀若篁ｃ \f3jdb\fP 篏睡翫\f3jdb\fP \f2\-D\fP\f2\-classpath\fP\f2\-X<option>\fP java 潟潟違激с潟ャ障
+コマンド行で Java アプリケーション起動ツールの代わりに \f3jdb\fP を使用する場合、\f3jdb\fP は、\f2\-D\fP、\f2\-classpath\fP、\f2\-X<option>\fP など、java コマンドと同じ数のオプションを受け入れます。
.LP
.LP
-\f3jdb\fP 祉罨＜激с潟ャ障
+\f3jdb\fP は、そのほかに次のオプションを受け入れます。
.LP
.RS 3
.TP 3
\-help
-＜祉若吾茵腓冴障
+ヘルプメッセージを表示します。
.TP 3
\-sourcepath <dir1:dir2:...>
-絎鴻篏睡純若鴻＜ゃ罎膣≪障激с潟絎翫鴻.篏帥障
+指定されたパスを使用して、ソースファイルを検索します。このオプションが指定されていない場合は、デフォルトパスの「.」が使われます。
.TP 3
\-attach <address>
-･膓罘罕篏睡с絎茵筝 VM ･膓障
+デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続します。
.TP 3
\-listen <address>
-絎茵筝 VM 罔羣潟帥篏帥ｃ絎≪鴻･膓緇罘障
+実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
.TP 3
\-listenany
-絎茵筝 VM 罔羣潟帥篏帥ｃ純篁紙≪鴻･膓緇罘障
+実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
.TP 3
\-launch
-違≪宴若激с潟 jdb 莎桁緇＜莎桁障激с潟ｃ\f2run\fP 潟潟篏睡綽荀障違≪宴若激с潟莎桁緇≪宴若激с潟鴻若翫罩≪障鴻с綽荀若ゃ潟荐絎\f2cont\fP 篏睡絎茵膓膓с障
+デバッグするアプリケーションを jdb の起動後ただちに起動します。このオプションによって、\f2run\fP コマンドを使用する必要がなくなります。デバッグするアプリケーションは、起動後、初期アプリケーションクラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\f2cont\fP を使用して実行を継続できます。
.TP 3
\-listconnectors
- VM ус潟帥筝荀ц；腓冴障
+この VM で利用できるコネクタを一覧表示します。
.TP 3
\-connect <connector\-name>:<name1>=<value1>,...
-筝荀ц；腓冴綣違ゃ絎潟帥篏帥ｃ帥若蚊 VM ･膓障
+一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
.TP 3
\-dbgtrace [flags]
-jdb 井宴阪障
+jdb のデバッグ情報を出力します。
.TP 3
\-tclient
-Java HotSpot(tm) VM (ゃ≪潟) с≪宴若激с潟絎茵障
+Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
.TP 3
\-tserver
-Java HotSpot(tm) VM (泣若) с≪宴若激с潟絎茵障
+Java HotSpot(tm) VM (サーバー) 内でアプリケーションを実行します。
.TP 3
\-Joption
-jdb 絎茵篏睡 Java 篁潟激潟 \f2option\fP 羝＜障(≪宴若激с Java 篁潟激潟絲障激с潟\f3run\fP 潟潟羝＜)違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される)。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.LP
-違茵 VM ･膓篁ｆ炊罕絲障篁激с潟泣若障篁･膓激с潟ゃJava Platform Debugger Architecture
+デバッガとデバッグを行う VM を接続するための代替機構に対して、その他のオプションがサポートされています。その他の接続オプションについては、Java Platform Debugger Architecture の
.na
-\f2ャ＜潟\fP @
+\f2ドキュメント\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。
.LP
.SS
-医乗院祉鴻荵∫激с
+デバッグ対象のプロセスに転送されるオプション
.LP
.RS 3
.TP 3
\-v \-verbose[:class|gc|jni]
-激≪若障
+冗長モードにします。
.TP 3
\-D<name>=<value>
-激鴻ｃ若荐絎障
+システムプロパティーを設定します。
.TP 3
\-classpath <directories separated by ":">
-鴻罎膣≪ｃ筝荀ц；腓冴障
+クラスを検索するディレクトリを一覧表示します。
.TP 3
\-X<option>
-罔羣帥若蚊 VM 激с潟с
+非標準ターゲット VM オプションです。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1)java(1)javah(1)javap(1)javadoc(1)
+javac(1)、java(1)、javah(1)、javap(1)、javadoc(1)
.LP
--- a/jdk/src/linux/doc/man/ja/jhat.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jhat.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jhat 1 "02 Jun 2010"
+.TH jhat 1 "14 Apr 2011"
.LP
-.SH ""
-jhat \- Java 若茹ｆ若
+.SH "名前"
+jhat \- Java ヒープ解析ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -58,88 +56,90 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
-.br
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
heap\-dump\-file
-阪乗院 Java ゃ若潟＜ゃ茲違若潟潟＜ゃ翫foo.hprof#3＜ゃ緇#<number>篁с＜ゃ劫潟絎с障
-.SH "茯"
+ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
+.RE
+
+.LP
+.SH "説明"
.LP
.LP
-\f3jhat\fP 潟潟java 若潟＜ゃ茹ｆWeb 泣若若莎桁障 jhat 篏帥違絅純帥 Web 吟篏帥ｃ若潟冴с障 jhat ∝ャ鴻Foo鴻ゃ潟鴻帥潟鴻茵腓冴ｃ篋荐荐祉\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) 泣若障OQL jhat ｃ茵腓冴 OQL 若吾≪祉鴻с障若篏睡翫OQL http://localhost:7000/oqlhelp/ у純с
+\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバーを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
.LP
.LP
-Java 若潟ゃ号障
+Java のヒープダンプを生成するには、いくつかの方法があります。
.LP
.RS 3
.TP 2
o
-jmap(1) \-dump 激с潟篏帥ｃ絎茵若潟緇
+jmap(1) の \-dump オプションを使って実行時にヒープダンプを取得する。
.TP 2
o
-jconsole(1) 激с潟篏帥ｃ
+jconsole(1) のオプションを使って
.na
\f2HotSpotDiagnosticMXBean\fP @
.fi
-http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 腟宴у茵若潟緇
+http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 経由で実行時にヒープダンプを取得する。
.TP 2
o
-\-XX:+HeapDumpOnOutOfMemoryError VM 激с潟絎OutOfMemoryError 鴻惹若潟
+\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
.TP 2
o
.na
\f2hprof\fP @
.fi
-http://java.sun.com/developer/technicalArticles/Programming/HPROF.html 篏睡
+http://java.sun.com/developer/technicalArticles/Programming/HPROF.html を使用する。
.RE
.LP
.LP
-\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
+\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
-.SH "激с"
+.SH "オプション"
+.LP
.RS 3
.TP 3
\-stack false/true
-吾с蚊綵若喝冴鴻帥菴処掘≦鴻障若潟у蚊綵泣ゃ宴篏睡с翫違 false 荐絎綽荀障 true с
+オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
.TP 3
\-refs false/true
-吾с吾с菴処掘≦鴻障 true сс若鴻吾сゃゃ潟 (絎吾сゃ潟吾с ц障篆≦с若違) 荐膊障
+オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる) が計算されます。
.TP 3
\-port port\-number
-jhat HTTP 泣若若若荐絎障 7000 с
+jhat の HTTP サーバーのポートを設定します。デフォルトは 7000 です。
.TP 3
\-exclude exclude\-file
-育純吾сゅ鴻若帥＜潟若筝荀с＜ゃ絎障違＜ゃ \f2java.lang.String.value\fP 障翫劫吾сo育純吾с鴻荐膊\f2java.lang.String.value\fP ｃ若∫ｃс鴻障
+「到達可能なオブジェクト」のクエリから除外すべきデータメンバーの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
.TP 3
\-baseline baseline\-dump\-file
-若鴻ゃ潟若潟絎障筝≧鴻若潟у吾с ID ゃ吾с域с若障篁吾с域若障違 2 ゃ若潟罸莠綵合＜障
+ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
.TP 3
\-debug int
-若違荐絎障0 医阪潟障紊сゃ荐絎激≪若障
+このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
.TP 3
-\-version\
-若吾с括垩怨腟篋障
+\-version
+バージョン番号を報告したあと、終了します。
.TP 3
-\-h\
-＜祉若吾阪腟篋障
+\-h
+ヘルプメッセージを出力して終了します。
.TP 3
-\-help\
-＜祉若吾阪腟篋障
+\-help
+ヘルプメッセージを出力して終了します。
.TP 3
-\-J<flag>\
-jhat 絎茵 Java 篁潟激潟 <flag> 羝＜障違512M ゃ紊с若泣ゃ冴篏睡\-J\-Xmx512m 障
+\-J<flag>
+jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
+.LP
.RS 3
.TP 2
o
@@ -150,9 +150,10 @@
.TP 2
o
.na
-\f2hprof \- 若 CPU ＜ゃ潟違若\fP @
+\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE
-.RE
+
+.LP
--- a/jdk/src/linux/doc/man/ja/jinfo.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jinfo.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jinfo 1 "02 Jun 2010"
+.TH jinfo 1 "14 Apr 2011"
.LP
-.SH ""
-jinfo \- 罕
+.SH "名前"
+jinfo \- 構成情報
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -60,98 +58,100 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
option
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
+.RE
+
+.LP
.RS 3
.TP 3
pid
-阪罕宴祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+出力する構成情報のプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
+
+.LP
.RS 3
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.RE
+
+.LP
.RS 3
.TP 3
core
-阪罕宴潟≪＜ゃ
+出力する構成情報のコアファイル。
.RE
+
+.LP
.RS 3
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
-.RE
-.RS 3
-.TP 3
-server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
-.RE
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.RE
.LP
-.SH "茯"
-.LP
-
-.LP
-.LP
-\f3jinfo\fP 絎 Java 祉鴻潟≪＜ゃ障≪若違泣若若 Java 罕宴阪障罕宴Java 激鴻ｃ若 Java 篁潟激潟潟潟茵違罕障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
-.br
-
-.LP
-.RS 3
-
-.LP
-jinfo \-J\-d64 \-sysprops pid
-.RE
-.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 筝 jinfo с泣若絎茵筝祉鴻 \-flag 激с潟с\fP
-.LP
-.SH "激с"
-.LP
-
-.LP
.RS 3
.TP 3
-<激с潟>
-潟潟茵違激鴻ｃ弱ゃ≪阪障
+server\-id
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
+.RE
+
+.LP
+.SH "説明"
+.LP
+.LP
+\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
+.br
+jinfo \-J\-d64 \-sysprops pid
+.LP
+.LP
+\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
+.LP
+.LP
+\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
+.SH "オプション"
+.LP
+.RS 3
+.TP 3
+<オプションなし>
+コマンド行フラグを、システムプロパティー名と値のペアとともに出力します。
.br
.TP 3
\-flag name
-絎潟潟茵違ゃ阪障
+指定されたコマンド行フラグの名前と値を出力します。
.br
.TP 3
\-flag [+|\-]name
-絎若潟潟茵違鴻障≦鴻障
+指定されたブール型のコマンド行フラグを有効または無効にします。
.br
.TP 3
\-flag name=value
-絎潟潟茵違絎ゃ荐絎障
+指定されたコマンド行フラグを指定された値に設定します。
.br
.TP 3
\-flags
-JVM 羝＜潟潟茵違≪у阪障
+JVM に渡されるコマンド行フラグをペアで出力します。
.br
.TP 3
\-sysprops
-Java 激鴻ｃ若ゃ≪阪障
+Java システムプロパティーを名前と値のペアとして出力します。
.br
.TP 3
\-h
-＜祉若吾阪障
+ヘルプメッセージを出力します。
.TP 3
\-help
-＜祉若吾阪障
+ヘルプメッセージを出力します。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/linux/doc/man/ja/jmap.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jmap.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jmap 1 "02 Jun 2010"
+.TH jmap 1 "14 Apr 2011"
.LP
-.SH ""
-jmap \- ＜≪若
+.SH "名前"
+jmap \- メモリーマップ
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -60,46 +58,39 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
option
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
.TP 3
pid
-医激＜≪若祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.br
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.br
.TP 3
core
-医激＜≪若潟≪＜ゃ
+印刷するメモリーマップのコアファイル。
.br
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.br
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jmap\fP 絎祉鴻潟≪＜ゃ障≪若違泣若若援吾с＜≪若障若＜≪若荅括完医激障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
-.LP
-.RS 3
-
+\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.LP
.nf
\f3
@@ -108,76 +99,66 @@
.fl
\fP
.fi
-.RE
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障\fP
+.LP
+\f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
+.LP
+.LP
+\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
.br
.LP
-Windows 若筝т戎純筝 jmap 綵√罨＜с
-.RS 3
-
-.LP
-jmap \-dump:<\f2dump\-options\fP> pid
-.RE
-
-.RS 3
-
-.LP
-jmap \-histo[:live] pid
-.RE
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-<激с潟>
-激с潟篏睡翫\f3jmap\fP 援吾с潟違医激障帥若蚊 VM 若援吾с紮≪鴻潟違泣ゃ冴喝援吾с＜ゃ鴻医激障Solaris \f3pmap\fP 若ｃｃ若蕁篌若障
+<オプションなし>
+オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris \f3pmap\fP ユーティリティーと類似しています。
.br
.TP 3
\-dump:[live,]format=b,file=<filename>
-Java 若 hprof ゃ綵√ filename 潟障\f2live\fP 泣激с潟ュ純с絎翫若х絖筝吾с帥潟障若潟с＜ゃ jhat(1) (Java Heap Analysis Tool) 篏帥ｃ茯水障
+Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。
.br
.TP 3
\-finalizerinfo
-＜ゃゃ冴緇ｃ吾с≪宴阪障
+ファイナライズを待っているオブジェクトに関する情報を出力します。
.br
.TP 3
\-heap
-若泣若医激障篏睡 GC ≪眼冴若罕割篁ｃ若篏睡医激障
+ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。
.br
.TP 3
\-histo[:live]
-若鴻違医激障Java 鴻吾с違ゃ篏с＜≪若泣ゃ冴喝篆蕋障劫医激障VM 劫*･莨篁医激障\f2live\fP 泣激с潟絎翫絖筝吾с帥潟障
+ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
.br
.TP 3
\-permstat
-Permanent 筝篁ｃ Java 若鴻若守∫ｃ腟沿若帥医激障鴻若若倶≪鴻荀鴻若若潟鴻若若若鴻違泣ゃ冴医激障intern 絖違泣ゃ冴阪障
+Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。
.br
.TP 3
\-F
-綣桁 (Force)pid 綽膈翫jmap \-dump 障 jmap \-histo 激с潟篏睡障≪若с\f2live\fP 泣激с潟泣若障
+強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
.br
.TP 3
\-h
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-J<flag>
-jmap 絎茵 Java 篁潟激潟 <flag> 羝＜障
+jmap が実行されている Java 仮想マシンに <flag> を渡します。
.br
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/linux/doc/man/ja/jps.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jps.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,43 +19,41 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jps 1 "02 Jun 2010"
+.TH jps 1 "14 Apr 2011"
.LP
-.SH ""
-jps \- Java 篁潟激潟祉鴻鴻若帥鴻若
+.SH "名前"
+jps \- Java 仮想マシンプロセスステータスツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-鴻茘ュ
+ホスト識別子
.TP 2
o
-阪綵√
+出力形式
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -67,79 +65,70 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
hostid
-祉鴻若鴻鴻茘ュ\f2hostid\fP 篆＜潟若垩絎茖堺篁若帥絎激с潟潟潟若潟с障
+プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jps\fP 若帥若蚊激鴻筝ц羝 HotSpot Java 篁潟激 (JVM) 筝荀ц；腓冴障若ц；腓冴с若宴≪祉号┤ｃ JVM ≪絎障
+\f3jps\fP ツールは、ターゲットシステム上で計測された HotSpot Java 仮想マシン (JVM) を一覧表示します。このツールで表示できるレポート情報は、アクセス権を持った JVM に関するものに限定されます。
.LP
.LP
-\f2hostid\fP 絎 \f3jps\fP 絎茵翫若鴻ц羝 JVM 罎膣≪障\f2hostid\fP 絎莎桁翫絎潟若篏睡絎鴻筝 JVM 罎膣≪障\f3jstatd\fP 祉鴻帥若蚊鴻筝у茵喝障
+\f2hostid\fP を指定せずに \f3jps\fP を実行した場合、ローカルホストで計測された JVM が検索されます。\f2hostid\fP を指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上の JVM を検索します。\f3jstatd\fP プロセスがターゲットホスト上で実行されていると想定されます。
.LP
.LP
-\f3jps\fP 潟潟帥若蚊激鴻ц羝 JVM ゃ若 VM 茘ュゃ障 \f2lvmid\fP 若障\f3lvmid\fP 綽с障筝 JVM 祉鴻絲障若ｃ潟違激鴻祉壕ュс激с潟絎翫\f3jps\fP ｃ Java ≪宴若激с潟 \f2lvmid\fP 筝荀ц；腓冴≪宴若激с潟劫障 JAR ＜ゃ膂≦綵√хず障膂≦綵√劫 JAR ＜ゃс鴻宴若御宴障 JAR ＜ゃ号宴ャ障
+\f3jps\fP コマンドは、ターゲットシステムで計測された各 JVM について、ローカル VM 識別子、つまり \f2lvmid\fP をレポートします。\f3lvmid\fP は、必須ではありませんが、一般的には JVM プロセスに対するオペレーティングシステムのプロセス識別子です。オプションを指定しない場合、\f3jps\fP によって、各 Java アプリケーションの \f2lvmid\fP が一覧表示され、それぞれにアプリケーションのクラス名または JAR ファイル名が簡単な形式で示されます。この簡単な形式のクラス名と JAR ファイル名では、クラスのパッケージ情報または JAR ファイルパス情報が省略されています。
.LP
.LP
-\f3jps\fP 潟潟\f3Java\fP 莎桁若篏睡\f2main\fP ＜純羝＜劫綣違罎膣≪障莎桁若篏睡帥若蚊 JVM 莎桁翫\f2main\fP ＜純羝＜劫 (障 JAR ＜ゃ) 綣違с障翫\f3jps\fP 潟潟main ＜純御検劫 (障 JAR ＜ゃ) 綣違絲障絖 \f2Unknown\fP 阪障
+\f3jps\fP コマンドは、\f3Java\fP 起動ツールを使用して \f2main\fP メソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲット JVM を起動した場合は、 \f2main\fP メソッドに渡されるクラス名 (または JAR ファイル名) と引数は利用できません。この場合、\f3jps\fP コマンドは、main メソッドへ渡されるクラス名 (または JAR ファイル名) と引数に対して、文字列 \f2Unknown\fP を出力します。
.LP
.LP
-\f3jps\fP 潟潟х JVM 鴻潟潟絎茵筝私筝≪祉号┤冴ャ狗翫障潟潟若ｃ潟違激鴻≪祉劫九勝罘罕羆阪冴ャ筝私≪祉号┤筝 JVM 筝荀ц；腓冴障
+\f3jps\fP コマンドで生成される JVM のリストは、このコマンドを実行する主体に与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティングシステム独自のアクセス制御機構による決定に基づいて、主体にアクセス権が与えられている JVM だけを一覧表示します。
.LP
.LP
-\f3羈:\fP 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jps\fP 潟潟с潟潟阪紊眼激с潟紊違泣若障絨ャ激с潟紊眼障綮罩≪醇с障
+\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。
.LP
.RS 3
.TP 3
\-q
-若 VM 茘ュ鴻\f2main\fP ＜純羝＜劫JAR ＜ゃ喝違阪九勝障
+クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。
.TP 3
\-m
-main ＜純羝＜綣違阪障阪腟粋昭障 JVM 絲障 null 障
+main メソッドに渡される引数を出力します。この出力は、組み込まれている JVM に対して null になることもあります。
.TP 3
\-l
-≪宴若激с潟筝肢鴻宴若後障≪宴若激с潟 JAR ＜ゃ吾劫阪障
+アプリケーションの主要なクラスのフルパッケージ名、またはアプリケーションの JAR ファイルへのフルパス名を出力します。
.TP 3
\-v
-JVM 羝＜綣違阪障
+JVM に渡される引数を出力します。
.TP 3
\-V
-違＜ゃ (.hotspotrc ＜ゃ障 \-XX:Flags=<\f2filename\fP> 綣違ф絎＜ゃ) JVM 羝＜綣違阪障
+フラグファイル (.hotspotrc ファイルまたは \-XX:Flags=<\f2filename\fP> の引数で指定されたファイル) を通じて JVM に渡される引数を出力します。
.TP 3
\-Joption
-\f3jps\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f3jps\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
.SS
-鴻茘ュ
-.LP
-.RS 3
-
+ホスト識別子
.LP
.LP
-鴻茘ュゃ障 \f2hostid\fP 帥若蚊激鴻腓冴絖с\f2hostid\fP 絖罕紊чURI 罕絲上障
+ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
@@ -155,26 +144,23 @@
.RS 3
.TP 3
protocol
-篆＜潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
+通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
hostname
-帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
+ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
-≪若泣若若篆＜若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP ＜若帥宴絎茖ｃ違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
+リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
-＜若帥宴絎茖ｃ違障若潟翫ｃ若∴障\f3rmi\fP 潟翫＜若帥≪若鴻筝 RMI ≪若吾с腓冴絖障jstatd(1) 潟潟ゃ\f3\-n\fP 激с潟с
+このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を示す文字列になります。jstatd(1) コマンドについては、\f3\-n\fP オプションを参照してください。
.RE
.LP
-.RE
-.SH "阪綵√"
-.LP
-
+.SH "出力形式"
.LP
.LP
-\f3jps\fP 潟潟阪罨＜帥若潟緇障
+\f3jps\fP コマンドの出力は、次のパターンに従います。
.LP
.nf
\f3
@@ -188,22 +174,20 @@
.LP
.LP
-鴻阪若潟腥榊純у阪障\f2arg\fP 筝х榊純篏睡絎絎篏臀＜若帥綣違潟違障障
+すべての出力トークンは空白で区切ります。\f2arg\fP の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。
.br
.br
-\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jps\fP 阪茹ｆ鴻篏с障\f3jps\fP 阪茹ｆ鴻篏若絨ャ若鴻с篏鴻紊眼綽荀篋羝障
+\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jps\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jps\fP 出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトを変更する必要が予測されます。
.br
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-膀с\f3jps\fP 潟潟箴腓冴障
+この節では、\f3jps\fP コマンドの例を示します。
.LP
.LP
-若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+ローカルホスト上で計測された JVM を一覧表示する場合:
.LP
.nf
\f3
@@ -228,10 +212,10 @@
.LP
.LP
-≪若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
-箴с\f3jstat\fP 泣若若 RMI 吾鴻障ャ紊 \f3rmiregistry\fP 祉鴻≪若鴻若 (若 1099) у茵喝障障若鴻≪若鴻吾鴻≪祉号┤ｃ喝障箴\f2\-l\fP 激с潟障劫障 JAR ＜ゃ荅括完綵√у阪障
+この例では、\f3jstat\fP サーバーと、その内部 RMI レジストリまたは別の外部 \f3rmiregistry\fP プロセスのいずれかとが、リモートホストのデフォルトポート (ポート 1099) で実行されていると想定しています。また、ローカルホストが、リモートホストへの有効なアクセス権を持っていることも想定しています。この例には、\f2\-l\fP オプションも含まれ、クラス名または JAR ファイル名を詳細な形式で出力します。
.LP
.nf
\f3
@@ -240,7 +224,7 @@
.br
.fl
-3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
+3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@@ -252,10 +236,10 @@
.LP
.LP
-RMI 吾鴻с若篏睡≪若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+RMI レジストリにデフォルトではないポートを使用して、リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
-箴с RMI 吾鴻若 2002 ゃ潟 \f3jstatd\fP 泣若若≪若鴻筝у茵喝障障\f2\-m\fP 激с潟篏睡筝荀ц；腓冴 Java ≪宴若激с潟 \f2main\fP ＜純羝＜綣違腟粋昭с障
+この例では、内部 RMI レジストリがポート 2002 にバインドされた \f3jstatd\fP サーバーが、リモートホスト上で実行していると想定しています。また、\f2\-m\fP オプションを使用して、一覧表示されたそれぞれの Java アプリケーションの \f2main\fP メソッドに渡される引数を組み込んでいます。
.LP
.nf
\f3
@@ -264,7 +248,7 @@
.br
.fl
-3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
+3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@@ -273,21 +257,21 @@
.fi
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jstat(1) \- Java 篁潟激括輝荐若睡ｈ若
+「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
-jstatd(1) \- 篁潟激 jstat 若≪潟
+「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
-rmiregistry(1) \- Java ≪若吾с吾鴻
+「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/jrunscript.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jrunscript.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 2006, 2011, 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
@@ -19,40 +19,38 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jrunscript 1 "02 Jun 2010"
+.TH jrunscript 1 "14 Apr 2011"
.LP
-.SH ""
-jrunscript \- 潟潟茵鴻激с
+.SH "名前"
+jrunscript \- コマンド行スクリプトシェル
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-綣
+引数
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -62,85 +60,77 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
arguments
-綣違篏睡翫激с潟障潟潟翫荐菴違
+引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jrunscript\fP 潟潟茵鴻激сс jrunscript 絲乗怨 (茯水 \- 荅箴 \- 阪) ≪若 (\-f 激с) ≪若筝≧鴻鴻絎茵泣若障鴻荐茯箴絖激сс篏睡荐茯 JavaScript с\-l 激с潟篏帥違祉荐茯絎с障jrunscript Java 鴻荐茯篆＜ｃ｢羆違潟違鴻帥ゃ泣若障
+\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
.LP
.LP
-\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
+\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-classpath path
-鴻≪祉劫乗院若吟若 .class ＜ゃ罎膣√贋絎障
+スクリプトからのアクセス対象となるユーザーの .class ファイルの検索場所を指定します。
.TP 3
\-cp path
-\-classpath \f2path\fP 臂с
+\-classpath \f2path\fP と同義です。
.TP 3
\-Dname=value
-Java 激鴻ｃ若荐絎障
+Java のシステムプロパティーを設定します。
.TP 3
\-J<flag>
-jrunscript 絎茵 Java 篁潟激潟 <flag> 羝＜障
+jrunscript が実行されている Java 仮想マシンに <flag> を渡します。
.TP 3
\-l language
-絎鴻荐茯篏睡障с JavaScript 篏睡障祉鴻荐茯篏睡絲上鴻潟吾潟 JAR ＜ゃ絎綽荀障 \-cp\-classpath 激с潟篏睡障
+指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。
.TP 3
\-e script
-絎鴻荅箴＜障激с潟篏帥違潟潟茵鴻絎1 茵鴻絎茵с障
+指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
.TP 3
\-encoding encoding
-鴻＜ゃ茯水篏睡絖潟潟若ｃ潟違絎障
+スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
.TP 3
\-f script\-file
-絎鴻＜ゃ荅箴＜障 (≪若)
+指定されたスクリプトファイルを評価します (バッチモード)。
.TP 3
\-f \-
-罔羣ュ鴻茯水荅箴＜障 (絲乗怨≪若)
+標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
.TP 3
\-help\
-＜祉若吾阪腟篋障
+ヘルプメッセージを出力して終了します。
.TP 3
\-?\
-＜祉若吾阪腟篋障
+ヘルプメッセージを出力して終了します。
.TP 3
\-q\
-純鴻鴻潟吾潟筝荀ц；腓冴腟篋障
+利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
.RE
.LP
-.SH "綣"
+.SH "引数"
.LP
.LP
-[arguments...] 絖 \f3\-e\fP\f3\-f\fP 激с潟篏睡ｃ翫綣違鴻＜ゃ篁綣違絖翫鴻綣違羝＜障[arguments..] 篏睡 \f3\-e\fP\f3\-f\fP 激с潟篏睡翫鴻 [arguments..] 鴻綣違羝＜障[arguments..]\f3\-e\fP\f3\-f\fP 絖ｃ翫絲乗怨≪若篏睡障鴻鴻綣違篏睡arguments String 潟吾喝違篏睡障
-.LP
-.SH "箴"
+[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] と、\f3\-e\fP または \f3\-f\fP が使用されている場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
.LP
-\f3ゃ潟ゃ潟鴻絎茵\fP
+.SH "例"
.LP
-.RS 3
-
+.SS
+インラインスクリプトの実行
.LP
.nf
\f3
@@ -151,13 +141,10 @@
.fl
\fP
.fi
-.RE
.LP
-\f3絎荐茯篏睡絎鴻＜ゃ荅箴＜\fP
-.LP
-.RS 3
-
+.SS
+指定された言語を使用し、指定されたスクリプトファイルを評価する
.LP
.nf
\f3
@@ -166,42 +153,42 @@
.fl
\fP
.fi
-.RE
.LP
-\f3絲乗怨≪若\fP
-.LP
-.RS 3
-
+.SS
+対話型モード
.LP
.nf
\f3
.fl
jrunscript
.fl
-js>print('hello world');
+js> print('Hello World\\n');
+.fl
+Hello World
.fl
-hello world
+js> 34 + 55
.fl
-js>34 + 55
+89.0
.fl
-89
+js> t = new java.lang.Thread(function() { print('Hello World\\n'); })
+.fl
+Thread[Thread\-0,5,main]
.fl
-js> thread(function() { print('hello world'); }
+js> t.start()
.fl
-hello world
+js> Hello World
+.fl
+
.fl
js>
.fl
\fP
.fi
-.RE
.LP
-\f3鴻綣違絎鴻＜ゃ絎茵\fP
-.LP
-.RS 3
-
+.SS
+スクリプト引数を指定してスクリプトファイルを実行する
.LP
.nf
\f3
@@ -210,13 +197,12 @@
.fl
\fP
.fi
-.RE
.LP
-test.js 絎茵絲乗院鴻＜ゃсarg1arg2 arg3 鴻綣違鴻羝＜障鴻arguments篏帥ｃ≪祉鴻с障
-.SH "∫ｉ"
+test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
+.SH "関連項目"
.LP
.LP
-JavaScript 篏睡翫jrunscript 若吟弱臂鴻荅箴＜ゃ腟粋昭翠∽違腟粋昭帥吾с障 JavaScript 腟粋昭炊純ゃjsdocs с
+JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
.LP
--- a/jdk/src/linux/doc/man/ja/jsadebugd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jsadebugd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,31 +19,29 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jsadebugd 1 "02 Jun 2010"
+.TH jsadebugd 1 "14 Apr 2011"
.LP
-.SH ""
-jsadebugd \- 泣若鴻≪ｃ若若吾с潟違若≪
+.SH "名前"
+jsadebugd \- サービスアビリティーエージェントデバッグデーモン
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -55,14 +53,12 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
pid
-違泣若若･膓祉鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障筝祉鴻･膓с違泣若若ゃ潟鴻帥潟鴻1 ゃ狗障
+デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。
.RE
.LP
@@ -74,37 +70,32 @@
.LP
.RS 3
.TP 3
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元になる Java 実行可能ファイルです。
.RE
.LP
.RS 3
.TP 3
core
-違泣若若･膓潟≪＜ゃс
+デバッグサーバーを接続するコアファイルです。
.RE
.LP
.RS 3
.TP 3
server\-id
-茲違違泣若若筝激割у茵翫綽荀激с喝堺 ID с ID ≪若ゃ≪潟･膓違泣若若劫篏睡綽荀障 ID 筝激喝тс違障
+複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。
.RE
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jsadebugd\fP Java 祉鴻障潟≪＜ゃ･膓違泣若若罘純障jstack(1)jmap(1) jinfo(1) ≪若ゃ≪潟Java Remote Method Invocation (RMI) 篏睡泣若若･膓с障\f2jsadebugd\fP 莎桁罨＜絎
+\f3jsadebugd\fP は、Java プロセスまたはコアファイルに接続し、デバッグサーバーとして機能します。jstack(1)、jmap(1)、および jinfo(1) などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用しているサーバーに接続できます。 \f2jsadebugd\fP を起動する前に、次のようにして
.na
\f2rmiregistry\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi 莎桁綽荀障
-.LP
-.RS 3
-
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi を起動する必要があります。
.LP
.nf
\f3
@@ -113,16 +104,18 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-с\f2$JAVA_HOME\fP JDK ゃ潟鴻若ｃсrmiregistry 莎桁翫jsadebugd 罔羣 (1099) 若 rmiregistry ц儀障違泣若若SIGINT 篆＜ (Ctrl+C 若) 罩≪с障
+ここで、 \f2$JAVA_HOME\fP は JDK インストールディレクトリです。rmiregistry が起動していない場合、jsadebugd は標準 (1099) ポートの rmiregistry を内部で起動します。デバッグサーバーは、SIGINT を送信する (Ctrl+C を押す) ことにより停止できます。
.LP
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障 jsadebugd 憝鴻сWindows 若с篏睡с障\fP
+\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
+.LP
.LP
-.SH "∫ｉ"
+次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/linux/doc/man/ja/jstack.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jstack.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,41 +19,39 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstack 1 "02 Jun 2010"
+.TH jstack 1 "14 Apr 2011"
.LP
-.SH ""
-jstack \- 鴻帥若
+.SH "名前"
+jstack \- スタックトレース
.br
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.br
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-∝ャ
+既知のバグ
.br
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -67,51 +65,44 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.LP
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障激с潟с
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
.LP
.RS 3
.TP 3
pid
-医激鴻帥若鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
.LP
.RS 3
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.br
.TP 3
core
-医激鴻帥若鴻潟≪＜ゃс
+印刷するスタックトレースのコアファイルです。
.br
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.RE
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jstack\fP 絎 Java 祉鴻潟≪＜ゃ障≪若違泣若若絲障 Java 鴻 Java 鴻帥若鴻医激障Java 若劫＜純bci(ゃ潟若ゃ潟)活 (純翫) 医激障\-m 激с潟篏睡jstack 鴻鴻 Java 若ゃｃ若筝≧鴻pc(違潟) 医激障ゃｃ若pcｃ菴ゃｃ激潟 (純翫) 医激障C++ 茹ｅ茹ｈВゃ障C++ 茹ｈВゃ潟潟阪 \f3c++filt\fP ゃ障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
+\f3jstack\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーに対する Java スレッドの Java スタックトレースを印刷します。Java フレームごとに、フルクラス名、メソッド名、「bci」(バイトコードインデックス)、および行番号 (利用可能な場合) が印刷されます。\-m オプションを使用すると、jstack は、すべてのスレッドの Java フレームとネイティブフレームの両方を、「pc」(プログラムカウンタ) とともに印刷します。ネイティブフレームごとに、「pc」にもっとも近いネイティブシンボル (利用可能な場合) が印刷されます。C++ 分解名は分解解除されません。C++ 名を分解解除するには、このコマンドの出力を \f3c++filt\fP にパイプします。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.br
.LP
-.RS 3
-
-.LP
.nf
\f3
.fl
@@ -119,51 +110,43 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 若筝т戎純筝 jstack 綵√罨＜с\fP
+\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
+.LP
.LP
-.nf
-\f3
-.fl
-\fP\f3 jstack [\-l] pid \fP
-.fl
-.fi
-
+次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-F
-jstack [\-l] pid綽膈翫鴻帥潟綣桁吟障
+「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。
.TP 3
\-l
-桁就綣鴻 java.util.concurrent
+長形式のリスト。所有 java.util.concurrent の
.na
-\f2с激潟ゃ\fP @
+\f2所有できるシンクロナイザ\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html筝荀сゃ菴遵宴医激障
+http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。
.TP 3
\-m
-羞桁≪若 (Java 潟ゃｃ C/C++ 若筝≧) 鴻帥若鴻医激障
+混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。
.TP 3
\-h
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
-＜祉若吾医激障
+ヘルプメッセージを出力します。
.br
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -181,11 +164,9 @@
.RE
.LP
-.SH "∝ャ"
-.LP
-
+.SH "既知のバグ"
.LP
.LP
-羞桁≪若鴻帥若 (\-m 激с割戎) ≪若違泣若若с罘純障
+混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。
.LP
--- a/jdk/src/linux/doc/man/ja/jstat.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jstat.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,44 +19,46 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstat 1 "02 Jun 2010"
+.TH jstat 1 "14 Apr 2011"
.LP
-.SH ""
-jstat \- Java 篁潟激括輝荐若睡ｈ若
+.SH "名前"
+jstat \- Java 仮想マシン統計データ監視ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-篁潟激活ュ
+仮想マシン識別子
.TP 2
o
-激с
-.br
-\ \ \- 筝激с
-.br
-\ \ \- 阪激с
+オプション
+.RS 3
+.TP 2
+*
+一般的なオプション
+.TP 2
+*
+出力オプション
+.RE
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -66,56 +68,49 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
generalOption
-т戎筝潟潟茵激с潟с (\-help\-options障 \-version)
+単独で使用する一般的なコマンド行オプションです (\-help、\-options、または \-version)。
.TP 3
outputOptions
-筝 \f2statOption\fP \-t\-h \-J 激с潟腟水1 ゃ障茲違阪激с潟с
+単一の \f2statOption\fP と、\-t、\-h、および \-J オプションのいずれかを組み合わせた、1 つまたは複数の出力オプションです。
.TP 3
vmid
-帥若蚊 Java 篁潟激 (JVM) 腓冴絖с篁潟激活ュс筝罕罨＜障
+ターゲットの Java 仮想マシン (JVM) を示す文字列である仮想マシン識別子です。一般的な構文は次のようになります。
.nf
\f3
.fl
[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
.fl
.fi
-vmid 絖罕紊чURI 罕絲上障\f2vmid\fP 若 JVM 茵膣贋違篆＜潟若垩割絎茖堺ゃ腓冴茲罕障с障障違障荅括完篁潟激活ュс
+vmid 文字列の構文の大部分は、URI の構文に対応しています。\f2vmid\fP は、ローカル JVM を表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、さまざまに異なります。詳細は、「仮想マシン識別子」を参照してください。
.TP 3
interval[s|ms]
-腱 (s) 障腱 (ms) ≧絎篏с泣潟潟育с篏腱с\ 罩ｃ贋違с違障\ 絎翫\f3jstat\fP interval 阪障
+秒 (s) またはミリ秒 (ms) のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数でなければなりません。これが指定された場合、\f3jstat\fP は interval ごとに出力を生成します。
.TP 3
count
-茵腓冴泣潟違сゃ♂с ゃ障\f3jstat\fP 帥若蚊 JVM 腟篋障с障 \f3jstat\fP 潟潟腟篋障с腟沿若帥茵腓冴障 罩ｃ贋医ゃ篏睡綽荀障
+表示するサンプル数です。デフォルト値は無限です。つまり、\f3jstat\fP は、ターゲット JVM が終了するまで、または \f3jstat\fP コマンドが終了するまで、統計データを表示します。正の整数でなければなりません。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jstat\fP 若荐臀 HotSpot Java 篁潟激 (JVM) 若潟合輝荐若帥茵腓冴障帥若蚊 JVM 篁潟激活ュゃ障筝荐 \f2vmid\fP 激с潟ｃ茘ャ障
+\f3jstat\fP ツールは、設置されている HotSpot Java 仮想マシン (JVM) のパフォーマンス統計データを表示します。ターゲット JVM は、仮想マシン識別子、つまり下記の \f2vmid\fP オプションによって識別されます。
.LP
.LP
-\f3羈\fP: 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注\fP: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.br
.LP
.SS
-篁潟激活ュ
-.LP
-.RS 3
-
+仮想マシン識別子
.LP
.LP
-\f2vmid\fP 絖罕紊чURI 罕絲上障
+\f2vmid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
@@ -128,79 +123,73 @@
.RS 3
.TP 3
protocol
-篆＜潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
+通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
lvmid
-帥若蚊 JVM 若篁潟激活ュс\f2lvmid\fP 激鴻筝 JVM 筝茘ャ若堺ゃс\f2lvmid\fP 篁潟激活ュ筝綽荀膣с\f2lvmid\fP 腟九障с障筝帥若蚊 JVM 祉鴻絲障若ｃ潟違激鴻祉壕ュсjps(1) 潟潟篏睡\f2lvmid\fP 絎с障障Unix 若с\f3ps\fP 潟潟篏睡Windows с Windows 帥鴻若吾ｃ若篏睡\f2lvmid\fP 絎с障
+ターゲット JVM のローカル仮想マシン識別子です。\f2lvmid\fP は、システム上の JVM を一意に識別するプラットフォーム固有の値です。\f2lvmid\fP は、仮想マシン識別子の唯一の必須要素です。\f2lvmid\fP は、絶対というわけではありませんが、一般的にはターゲット JVM プロセスに対するオペレーティングシステムのプロセス識別子です。jps(1) コマンドを使用して、\f2lvmid\fP を指定できます。また、Unix プラットフォームでは\f3ps\fP コマンドを使用して、Windows では Windows タスクマネージャーを使用して、\f2lvmid\fP を指定できます。
.TP 3
hostname
-帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
+ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
-≪若泣若若篆＜若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP ＜若帥宴絎茖ｃ違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
+リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
-＜若帥宴絎茖ｃ違障若潟翫ｃ若∴障\f3rmi\fP 潟翫＜若帥≪若鴻筝 RMI 純若鴻吾с腓冴障
+このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合は、このパラメータは、リモートホスト上の RMI リソースオブジェクトの名前を示します。
.RE
.LP
-.RE
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jstat\fP 潟潟筝激с潟阪激с潟 2 ゃ帥ゃ激с潟泣若障筝激с潟篏睡翫\f3jstat\fP 膂≦篏睡潟若吾с恰宴茵腓冴障阪激с潟с腟沿若水阪絎鴻綵√絎障
+\f3jstat\fP コマンドは、一般的なオプションと出力オプションの 2 つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fP は簡単な使用率およびバージョン情報を表示します。出力オプションでは、統計データ出力の内容と形式を指定します。
.br
.LP
.LP
-\f3羈\fP: 鴻激с潟罘純絨ャ若鴻у眼障綮罩≪醇с障
+\f3注\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。
.LP
.SS
-筝激с
+一般的なオプション
.LP
.LP
-筝激с潟絎翫篁激с潟障＜若帥筝絎с障
+いずれかの一般的なオプションを指定した場合、他のオプションまたはパラメータは一切指定できません。
.LP
.RS 3
.TP 3
\-help
-＜祉若吾茵腓冴障
+ヘルプメッセージを表示します。
.TP 3
\-version
-若吾с恰宴茵腓冴障
+バージョン情報を表示します。
.TP 3
\-options
-腟沿若帥激с潟筝荀ц；腓冴障筝荐阪激с潟膀с
+統計データオプションを一覧表示します。下記の「出力オプション」の節を参照してください。
.RE
.LP
.SS
-阪激с
-.LP
-.RS 3
-
+出力オプション
.LP
.LP
-筝激с潟絎翫阪激с潟絎с障阪激с潟\f3jstat\fP 阪絎鴻喝就綣絎筝 \f2statOption\fP 篁阪激с (\-h\-t \-J) ф障\ \f2statOption\fP 荐菴違綽荀障
+一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\f3jstat\fP の出力の内容および形式を指定し、単一の \f2statOption\fP と、他のいずれかの出力オプション (\-h、\-t、および \-J) とで構成されます。\f2statOption\fP は最初に記述する必要があります。
.LP
.LP
-阪腥榊純у阪若綵√ф障帥ゃ荐取茯荐障 \f3\-h\fP 激с潟篏睡若茵腓冴糸墾荐絎障\ 絽吾弱激с潟違ｃ翫с筝莢障筝2 ゃ激с潟у篏睡違2 ゃ若帥純若鴻障
+出力は、各列が空白で区切られたテーブルの形式で構成されます。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\f3\-h\fP オプションを使用します。列のヘッダー名は一般に、オプション間で一貫性が保たれています。一般に、2 つのオプションで同じ名前の列が使用されていれば、2 つの列のデータソースは同じになります。
.LP
.LP
-\f3\-t\fP 激с潟篏睡\f2Timestamp\fP 篁帥ゃ鴻帥潟阪茵腓冴障\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏ц；腓冴障帥ゃ鴻帥潟膕上墾障障荀ｃ違紊ч莢激ｃ激鴻с鴻鴻宴吾ャ若綮吟紊障
+\f3\-t\fP オプションを使用すると、 \f2Timestamp というラベルの付いたタイムスタンプの列が、\fP 出力の最初の列として表示されます。 \f2Timestamp\fP 列には、ターゲット JVM の起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、さまざまな要因によって異なり、大量の負荷のかかったシステムでのスレッドスケジュールの遅延により変動します。
.LP
.LP
-\f2interval\fP \f2count\fP ＜若帥篏睡\f3jstat\fP 阪茵腓冴糸墾違絎障
+\f2interval\fP および \f2count\fP パラメータを使用して、\f3jstat\fP がその出力を表示する頻度と回数をそれぞれ指定します。
.LP
.LP
-\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jstat\fP 阪茹ｆ鴻篏с障\f3jstat\fP 阪茹ｆ鴻篏翫若絨ャ若鴻с鴻紊眼違
+\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jstat\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jstat\fP 出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更しなければならないことに留意してください。
.LP
.RS 3
.TP 3
\-statOption
-\f3jstat\fP 茵腓冴腟沿若炊宴絎障罨＜茵純激с潟筝荀ц；腓冴障 劫若ゃ潟鴻若ゃ激с潟筝荀ц；腓冴筝激с潟 \f3\-options\fP 篏睡障
+\f3jstat\fP が表示する統計データ情報を指定します。次の表に、利用可能なオプションの一覧を示します。ある特定のプラットフォームインストールのオプションを一覧表示するには、一般的なオプションの \f3\-options\fP を使用します。
.br
.br
.LP
@@ -232,7 +221,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-鴻若若篏≪腟沿若
+クラスローダーの動作に関する統計データ
.br
.di
.nr a| \n(dn
@@ -248,7 +237,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HotSpot Just\-in\-Time 潟潟ゃ篏≪腟沿若
+HotSpot Just\-in\-Time コンパイラの動作に関する統計データ
.br
.di
.nr b| \n(dn
@@ -264,7 +253,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟若篏≪腟沿若
+ガベージコレクトされたヒープの動作に関する統計データ
.br
.di
.nr c| \n(dn
@@ -280,7 +269,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-筝篁ｃ絎拷絲上≪腟沿若
+世代ごとの容量と対応する領域に関する統計データ
.br
.di
.nr d| \n(dn
@@ -296,7 +285,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括輝荐若帥网荀 (\f3\-gcutil\fP ) 翫括憜 (純翫) 若吾潟激с潟ゃ潟
+ガベージコレクション統計データの概要 (\f3\-gcutil\fP と同じ) と、直前および現在 (適用可能な場合) のガベージコレクションイベントの原因
.br
.di
.nr e| \n(dn
@@ -312,7 +301,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ篏≪腟沿若
+New 世代の動作に関する統計データ
.br
.di
.nr f| \n(dn
@@ -328,7 +317,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ泣ゃ冴絲上≪腟沿若
+New 世代のサイズと対応する領域に関する統計データ
.br
.di
.nr g| \n(dn
@@ -344,7 +333,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ Permanent 筝篁ｃ篏≪腟沿若
+Old 世代および Permanent 世代の動作に関する統計データ
.br
.di
.nr h| \n(dn
@@ -360,7 +349,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ泣ゃ冴≪腟沿若
+Old 世代のサイズに関する統計データ
.br
.di
.nr i| \n(dn
@@ -376,7 +365,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ泣ゃ冴≪腟沿若
+Permanent 世代のサイズに関する統計データ
.br
.di
.nr j| \n(dn
@@ -392,7 +381,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括輝荐若帥网荀
+ガベージコレクション統計データの概要
.br
.di
.nr k| \n(dn
@@ -408,7 +397,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HotSpot 潟潟ゃ号腟沿若
+HotSpot コンパイル方法の統計データ
.br
.di
.nr l| \n(dn
@@ -419,7 +408,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wclass
.if \n(80<\n(38 .nr 80 \n(38
@@ -448,7 +437,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茵腓阪絎\fP
+.nr 38 \w\f3表示内容\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -486,7 +475,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 259 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 248 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -503,7 +492,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茵腓阪絎\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3表示内容\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -716,30 +705,26 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-52
.TP 3
\-h n
-\f2n\fP 泣潟 (阪茵) 若茵腓冴 \f2n\fP 罩ｃ贋医ゃゃ 0 若帥茵筝若茵腓冴
+\f2n\fP サンプル (出力行) ごとに列ヘッダーを表示。 ただし、\f2n\fP は正の整数値。デフォルト値は 0。 このとき、データの最初の行の上に列ヘッダーが表示される
.TP 3
\-t n
-帥ゃ鴻帥潟阪茵腓冴帥ゃ鴻帥潟帥若蚊 JVM 莎桁腟
+タイムスタンプ列を出力の最初の列として表示。タイムスタンプは、ターゲット JVM の起動時からの経過時間
.TP 3
-\-J javaOption
-\f2javaOption\fP \f3java\fP ≪宴若激с活儀若御検違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟絎鴻ゃjava(1)ャ＜潟с
+\-JjavaOption
+\f2javaOption\fP を \f3java\fP アプリケーション起動ツールへ渡す。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。オプションの完全なリストについては、「java(1)」のドキュメントを参照してください。
.RE
.LP
-.RE
.SS
-statOption 阪
-.LP
-.RS 3
-
+statOption と出力
.LP
.LP
-篁ラ茵с\f3jstat\fP \f2statOption\fP 阪ゃ网荀腓冴障
+以降の表では、\f3jstat\fP が \f2statOption\fP ごとに出力する列について概要を示します。
.br
.LP
.SS
-\-class 激с
+\-class オプション
.LP
.LP
.TS
@@ -770,7 +755,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若鴻
+ロードされたクラスの数
.br
.di
.nr a| \n(dn
@@ -786,7 +771,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若 K ゃ
+ロードされた K バイト数
.br
.di
.nr b| \n(dn
@@ -802,7 +787,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≪潟若鴻
+アンロードされたクラスの数
.br
.di
.nr c| \n(dn
@@ -818,7 +803,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≪潟若 K ゃ
+アンロードされた K バイト数
.br
.di
.nr d| \n(dn
@@ -834,7 +819,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-鴻若≪潟若荀
+クラスのロードやアンロード処理に要した時間
.br
.di
.nr e| \n(dn
@@ -845,9 +830,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w鴻若若腟沿若
+.nr 38 \wクラスローダーの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wLoaded
.if \n(80<\n(38 .nr 80 \n(38
@@ -862,7 +847,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -886,7 +871,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 313 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 298 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -903,11 +888,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'鴻若若腟沿若\h'|\n(41u'
+\&\h'|\n(40u'クラスローダーの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1002,7 +987,7 @@
.LP
.SS
-\-compiler 激с
+\-compiler オプション
.LP
.LP
.TS
@@ -1033,7 +1018,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎茵潟潟ゃ帥鴻
+実行されたコンパイルタスクの数
.br
.di
.nr a| \n(dn
@@ -1049,7 +1034,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊掩潟潟ゃ帥鴻
+失敗したコンパイルタスクの数
.br
.di
.nr b| \n(dn
@@ -1065,7 +1050,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≦鴻潟潟ゃ帥鴻
+無効にされたコンパイルタスクの数
.br
.di
.nr c| \n(dn
@@ -1081,7 +1066,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ帥鴻絎茵荀
+コンパイルタスクの実行に要した時間
.br
.di
.nr d| \n(dn
@@ -1097,7 +1082,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇紊掩潟潟ゃ潟潟ゃ帥ゃ
+最後に失敗したコンパイルのコンパイルタイプ
.br
.di
.nr e| \n(dn
@@ -1113,7 +1098,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇紊掩潟潟ゃ劫＜純
+最後に失敗したコンパイルのクラス名とメソッド
.br
.di
.nr f| \n(dn
@@ -1124,9 +1109,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wHotSpot Just\-In\-Time 潟潟ゃ腟沿若
+.nr 38 \wHotSpot Just\-In\-Time コンパイラの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wCompiled
.if \n(80<\n(38 .nr 80 \n(38
@@ -1143,7 +1128,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -1169,7 +1154,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 349 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 334 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1186,11 +1171,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'HotSpot Just\-In\-Time 潟潟ゃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'HotSpot Just\-In\-Time コンパイラの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1302,7 +1287,7 @@
.LP
.SS
-\-gc 激с
+\-gc オプション
.LP
.LP
.TS
@@ -1333,7 +1318,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -1349,7 +1334,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr b| \n(dn
@@ -1365,7 +1350,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (KB)
+Survivor 領域 0 の使用率 (KB)
.br
.di
.nr c| \n(dn
@@ -1381,7 +1366,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (KB)
+Survivor 領域 1 の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -1397,7 +1382,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -1413,7 +1398,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (KB)
+Eden 領域の使用率 (KB)
.br
.di
.nr f| \n(dn
@@ -1429,7 +1414,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -1445,7 +1430,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (KB)
+Old 領域の使用率 (KB)
.br
.di
.nr h| \n(dn
@@ -1461,7 +1446,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -1477,7 +1462,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (KB)
+Permanent 領域の使用率 (KB)
.br
.di
.nr j| \n(dn
@@ -1493,7 +1478,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr k| \n(dn
@@ -1509,7 +1494,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr l| \n(dn
@@ -1525,7 +1510,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr m| \n(dn
@@ -1541,7 +1526,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr n| \n(dn
@@ -1552,9 +1537,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w若吾潟若腟沿若
+.nr 38 \wガベージコレクトされたヒープの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0C
.if \n(80<\n(38 .nr 80 \n(38
@@ -1589,9 +1574,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -1633,7 +1618,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 419 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 404 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1650,11 +1635,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'若吾潟若腟沿若\h'|\n(41u'
+\&\h'|\n(40u'ガベージコレクトされたヒープの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1850,7 +1835,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(m|u+\n(.Vu
.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1906,7 +1891,7 @@
.LP
.SS
-\-gccapacity 激с
+\-gccapacity オプション
.LP
.LP
.TS
@@ -1937,7 +1922,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ絨鎘拷 (KB)
+New 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -1953,7 +1938,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ紊у拷 (KB)
+New 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -1969,7 +1954,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ憜絎拷 (KB)
+New 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -1985,7 +1970,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -2001,7 +1986,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -2017,7 +2002,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr f| \n(dn
@@ -2033,7 +2018,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ絨鎘拷 (KB)
+Old 世代の最小容量 (KB)
.br
.di
.nr g| \n(dn
@@ -2049,7 +2034,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ紊у拷 (KB)
+Old 世代の最大容量 (KB)
.br
.di
.nr h| \n(dn
@@ -2065,7 +2050,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ憜絎拷 (KB)
+Old 世代の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -2081,7 +2066,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr j| \n(dn
@@ -2097,7 +2082,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ絨鎘拷 (KB)
+Permanent 世代の最小容量 (KB)
.br
.di
.nr k| \n(dn
@@ -2113,7 +2098,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ紊у拷 (KB)
+Permanent 世代の最大容量 (KB)
.br
.di
.nr l| \n(dn
@@ -2129,7 +2114,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ憜絎拷 (KB)
+Permanent 世代の現在の容量 (KB)
.br
.di
.nr m| \n(dn
@@ -2145,7 +2130,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr n| \n(dn
@@ -2161,7 +2146,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr o| \n(dn
@@ -2172,9 +2157,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w＜≪若若筝篁ｃ渇絎拷
+.nr 38 \wメモリープール世代および領域容量
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wNGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -2211,9 +2196,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2257,7 +2242,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 493 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 478 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2274,11 +2259,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'＜≪若若筝篁ｃ渇絎拷\h'|\n(41u'
+\&\h'|\n(40u'メモリープール世代および領域容量\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -2522,7 +2507,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.fc
.nr T. 1
.T# 1
@@ -2547,10 +2532,10 @@
.LP
.SS
-\-gccause 激с
+\-gccause オプション
.LP
.LP
-激с潟\f3\-gcutil\fP 激с潟若吾潟激с括輝荐若帥网荀茵腓冴障緇若吾潟激с潟ゃ潟 (純翫) 憜若吾潟激с潟ゃ潟障障\f3\-gcutil\fP т荀ц；腓冴篁激с潟с罨＜菴遵障
+このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。
.LP
.LP
.TS
@@ -2581,7 +2566,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇若吾潟激с潟
+最後のガベージコレクションの原因
.br
.di
.nr a| \n(dn
@@ -2597,7 +2582,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-憜若吾潟激с潟
+現在のガベージコレクションの原因
.br
.di
.nr b| \n(dn
@@ -2608,9 +2593,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wGC ゃ潟若吾潟激с括輝荐若
+.nr 38 \wGC イベントを含むガベージコレクション統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wLGCC
.if \n(80<\n(38 .nr 80 \n(38
@@ -2619,7 +2604,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2637,7 +2622,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 516 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 501 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2654,11 +2639,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'GC ゃ潟若吾潟激с括輝荐若\h'|\n(41u'
+\&\h'|\n(40u'GC イベントを含むガベージコレクション統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -2702,7 +2687,7 @@
.LP
.SS
-\-gcnew 激с
+\-gcnew オプション
.LP
.LP
.TS
@@ -2733,7 +2718,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -2749,7 +2734,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr b| \n(dn
@@ -2765,7 +2750,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (KB)
+Survivor 領域 0 の使用率 (KB)
.br
.di
.nr c| \n(dn
@@ -2781,7 +2766,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (KB)
+Survivor 領域 1 の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -2797,7 +2782,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊ф水ャ
+最大殿堂入りしきい値
.br
.di
.nr e| \n(dn
@@ -2813,7 +2798,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
- Survivor 泣ゃ (KB)
+適切な Survivor サイズ (KB)
.br
.di
.nr f| \n(dn
@@ -2829,7 +2814,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -2845,7 +2830,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (KB)
+Eden 領域の使用率 (KB)
.br
.di
.nr h| \n(dn
@@ -2861,7 +2846,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr i| \n(dn
@@ -2877,7 +2862,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr j| \n(dn
@@ -2888,9 +2873,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wNew 筝篁ｃ腟沿若
+.nr 38 \wNew 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0C
.if \n(80<\n(38 .nr 80 \n(38
@@ -2917,9 +2902,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w罧水ャ
+.nr 38 \w殿堂入りしきい値
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2953,7 +2938,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 570 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 555 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2970,11 +2955,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'New 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'New 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3042,7 +3027,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'TT\h'|\n(41u'罧水ャ
+\&\h'|\n(40u'TT\h'|\n(41u'殿堂入りしきい値
.ne \n(e|u+\n(.Vu
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3158,7 +3143,7 @@
.LP
.SS
-\-gcnewcapacity 激с
+\-gcnewcapacity オプション
.LP
.LP
.TS
@@ -3181,16 +3166,15 @@
.rm 80 81
.nr 34 \n(.lu
.eo
-.am 80
+.am 81
.br
.di a+
.35
.ft \n(.f
.ll \n(34u*1u/3u
-.if \n(.l<\n(80 .ll \n(80u
+.if \n(.l<\n(81 .ll \n(81u
.in 0
-NGCMN\ \ \ \ \ \ \ \ \ T}~T{
-New 筝篁ｃ絨鎘拷 (KB)
+New 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -3206,7 +3190,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ紊у拷 (KB)
+New 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -3222,7 +3206,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ憜絎拷 (KB)
+New 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -3238,7 +3222,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 紊у拷 (KB)
+Survivor 領域 0 の最大容量 (KB)
.br
.di
.nr d| \n(dn
@@ -3254,7 +3238,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -3270,7 +3254,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 紊у拷 (KB)
+Survivor 領域 1 の最大容量 (KB)
.br
.di
.nr f| \n(dn
@@ -3286,7 +3270,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -3302,7 +3286,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 紊у拷 (KB)
+Eden 領域の最大容量 (KB)
.br
.di
.nr h| \n(dn
@@ -3318,7 +3302,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -3334,7 +3318,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr j| \n(dn
@@ -3345,13 +3329,15 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wNew 筝篁ｉ泣ゃ冴腟沿若
+.nr 38 \wNew 世代領域サイズの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGCMX \ \ \
+.nr 38 \wNGCMN
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGC \ \ \
+.nr 38 \wNGCMX
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \wNGC
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0CMX
.if \n(80<\n(38 .nr 80 \n(38
@@ -3371,15 +3357,15 @@
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
+.nr 38 \n(a-
+.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(b-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(c-
@@ -3408,7 +3394,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 626 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 609 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -3425,21 +3411,21 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'New 筝篁ｉ泣ゃ冴腟沿若\h'|\n(41u'
+\&\h'|\n(40u'New 世代領域サイズの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'
+\&\h'|\n(40u'NGCMN\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
-.nr 37 \n(40u
+.nr 37 \n(41u
.in +\n(37u
.a+
.in -\n(37u
@@ -3451,7 +3437,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'NGCMX \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGCMX\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -3467,7 +3453,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'NGC \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGC\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -3593,7 +3579,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.fc
.nr T. 1
.T# 1
@@ -3609,11 +3595,11 @@
.rm i+
.rm j+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
.LP
.SS
-\-gcold 激с
+\-gcold オプション
.LP
.LP
.TS
@@ -3644,7 +3630,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -3660,7 +3646,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (KB)
+Permanent 領域の使用率 (KB)
.br
.di
.nr b| \n(dn
@@ -3676,7 +3662,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -3692,7 +3678,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (KB)
+Old 領域の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -3708,7 +3694,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -3724,7 +3710,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -3740,7 +3726,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -3751,9 +3737,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wOld Permanent 筝篁ｃ腟沿若
+.nr 38 \wOld および Permanent 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wPC
.if \n(80<\n(38 .nr 80 \n(38
@@ -3774,9 +3760,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -3804,7 +3790,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 668 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 651 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -3821,11 +3807,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Old Permanent 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Old および Permanent 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3909,7 +3895,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3958,7 +3944,7 @@
.LP
.SS
-\-gcoldcapacity 激с
+\-gcoldcapacity オプション
.LP
.LP
.TS
@@ -3989,7 +3975,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ絨鎘拷 (KB)
+Old 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -4005,7 +3991,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ紊у拷 (KB)
+Old 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -4021,7 +4007,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ憜絎拷 (KB)
+Old 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -4037,7 +4023,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -4053,7 +4039,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -4069,7 +4055,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -4085,7 +4071,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -4096,9 +4082,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wOld 筝篁ｃ腟沿若
+.nr 38 \wOld 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wOGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -4119,9 +4105,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4149,7 +4135,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 710 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 693 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4166,11 +4152,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Old 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Old 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4254,7 +4240,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4303,7 +4289,7 @@
.LP
.SS
-\-gcpermcapacity 激с
+\-gcpermcapacity オプション
.LP
.LP
.TS
@@ -4334,7 +4320,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ絨鎘拷 (KB)
+Permanent 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -4350,7 +4336,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ紊у拷 (KB)
+Permanent 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -4366,7 +4352,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ憜絎拷 (KB)
+Permanent 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -4382,7 +4368,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -4398,7 +4384,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -4414,7 +4400,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -4430,7 +4416,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -4441,9 +4427,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wPermanent 筝篁ｃ腟沿若
+.nr 38 \wPermanent 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wPGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -4464,9 +4450,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4494,7 +4480,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 752 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 735 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4511,11 +4497,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Permanent 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Permanent 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4599,7 +4585,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4648,7 +4634,7 @@
.LP
.SS
-\-gcutil 激с
+\-gcutil オプション
.LP
.LP
.TS
@@ -4679,7 +4665,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (憜絎拷絲障若祉潟若)
+Survivor 領域 0 の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr a| \n(dn
@@ -4695,7 +4681,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (憜絎拷絲障若祉潟若)
+Survivor 領域 1 の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr b| \n(dn
@@ -4711,7 +4697,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (憜絎拷絲障若祉潟若)
+Eden 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr c| \n(dn
@@ -4727,7 +4713,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (憜絎拷絲障若祉潟若)
+Old 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr d| \n(dn
@@ -4743,7 +4729,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (憜絎拷絲障若祉潟若)
+Permanent 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr e| \n(dn
@@ -4759,7 +4745,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr f| \n(dn
@@ -4775,7 +4761,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr g| \n(dn
@@ -4791,7 +4777,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr h| \n(dn
@@ -4807,7 +4793,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr i| \n(dn
@@ -4818,9 +4804,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w若吾潟激с括輝荐若帥网荀
+.nr 38 \wガベージコレクション統計データの概要
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0
.if \n(80<\n(38 .nr 80 \n(38
@@ -4845,9 +4831,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4879,7 +4865,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 802 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 785 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4896,11 +4882,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'若吾潟激с括輝荐若帥网荀\h'|\n(41u'
+\&\h'|\n(40u'ガベージコレクション統計データの概要\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5016,7 +5002,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(h|u+\n(.Vu
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5067,7 +5053,7 @@
.LP
.SS
-\-printcompilation 激с
+\-printcompilation オプション
.LP
.LP
.TS
@@ -5098,7 +5084,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎茵潟潟ゃ帥鴻
+実行されたコンパイルタスクの数
.br
.di
.nr a| \n(dn
@@ -5114,7 +5100,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜純ゃ潟若ゃ
+メソッドのバイトコードのバイト数
.br
.di
.nr b| \n(dn
@@ -5130,7 +5116,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ号劫劫＜純劫с腥咲阪絖.с/篏睡＜純絎劫＜純с 2 ゃｃ若綵√HotSpot \- \f3XX:+PrintComplation\fP 激с潟絲上
+コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」の代わりに「/」が使用される。メソッド名は、指定されたクラス内のメソッドである。これらの 2 つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fP オプションと対応している
.br
.di
.nr c| \n(dn
@@ -5141,24 +5127,24 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wHotSpot 潟潟ゃ号腟沿若
+.nr 38 \wHotSpot コンパイル方法の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wCompiled
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w泣ゃ
+.nr 38 \wサイズ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w
+.nr 38 \w型
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w＜純
+.nr 38 \wメソッド
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w潟潟ゃ帥ゃ
+.nr 38 \wコンパイルタイプ
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -5178,7 +5164,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 828 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 811 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -5195,11 +5181,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'HotSpot 潟潟ゃ号腟沿若\h'|\n(41u'
+\&\h'|\n(40u'HotSpot コンパイル方法の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5221,7 +5207,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'泣ゃ\h'|\n(41u'
+\&\h'|\n(40u'サイズ\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -5235,13 +5221,13 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'潟潟ゃ帥ゃ
+\&\h'|\n(40u'型\h'|\n(41u'コンパイルタイプ
.ne \n(c|u+\n(.Vu
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'＜純\h'|\n(41u'
+\&\h'|\n(40u'メソッド\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -5263,19 +5249,16 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
.LP
-.SS
-
-.LP
-.SH ""
+.SH "例"
.LP
.LP
-с21891 \f2lvmid\fP ゃ若 JVM ｈ箴腓冴障
+この項では、21891 の \f2lvmid\fP を持つローカル JVM を監視する例を示します。
.LP
.SS
-gcutil 激с潟篏睡
+gcutil オプションの使用
.LP
.LP
-箴\f2lvmid\fP 21891 ･膓250 腱 7 ゃ泣潟緇\f3\-gcutil\fP 激с潟с絎緇ｃ阪茵腓冴障
+この例は、\f2lvmid\fP 21891 に接続して、250 ミリ秒間隔で 7 つのサンプルを取得し、\f3\-gcutil\fP オプションでの指定に従って出力を表示します。
.LP
.nf
\f3
@@ -5320,13 +5303,13 @@
.LP
.LP
-箴阪ャ筝篁ｃ潟激с潟 3 4 泣潟ц腓冴障潟激с潟 0.001 腱ｃ吾с Eden (E) Old (O) 若Old 篏睡 9.49% 9.51% 紜障Survivor 潟激с喝 12.44% 篏睡障潟激с喝 7.74% 篏睡障
+この例の出力は、若い世代のコレクションが 3 番目と 4 番目のサンプル間で行われたことを示しています。コレクションには 0.001 秒かかっており、オブジェクトが Eden 領域 (E) から Old 領域 (O) に昇格したため、Old 領域の使用率は 9.49% から 9.51% に増加しています。Survivor 領域は、コレクション前は 12.44% が使用されていましたが、コレクション後は 7.74% しか使用されていません。
.LP
.SS
-惹絖膵違菴
+列ヘッダー文字列の繰り返し
.LP
.LP
-箴\f2lvmid\fP 21891 ･膓250 腱с泣潟緇\f3\-gcutil\fP 激с潟с絎緇ｃ阪茵腓冴障\f3\-h3\fP 激с潟篏睡若帥 3 茵茵腓冴若阪障
+この例は、\f2lvmid\fP 21891 に接続して、250 ミリ秒間隔でサンプルを取得し、\f3\-gcutil\fP オプションでの指定に従って出力を表示します。さらに、\f3\-h3\fP オプションを使用して、データが 3 行表示されるごとに列ヘッダーを出力します。
.LP
.nf
\f3
@@ -5379,16 +5362,16 @@
.LP
.LP
-箴с惹絖膵違菴荀祉2 3 泣潟 Young GC 茵障膓膓 0.001 腱с潟激с潟сSurvivor 0 篏睡 (S0U) Survivor 泣ゃ (DSS) 莇ゃ若帥罎冴障腟吾сOld 筝篁 (阪茵腓) 御若罧水ャ (TT) 31 2 檎若障
+この例では、ヘッダー文字列の繰り返しが見られるほかにも、2 番目と 3 番目のサンプル間で Young GC が行われたことがわかります。この継続時間は 0.001 秒でした。このコレクションでは、Survivor 領域 0 の使用率 (S0U) が適切な Survivor サイズ (DSS) を超過することになるライブデータが検出されました。この結果、オブジェクトは、Old 世代 (この出力には非表示) へ昇格され、殿堂入りしきい値 (TT) が、31 から 2 へ降格されました。
.LP
.LP
-ャ潟激с潟5 6 泣潟ц障潟激с潟сSurvivor 祉荀罧水ャゃ 31 祉障
+別のコレクションが、5 番目と 6 番目のサンプル間で行われています。このコレクションでは、Survivor がほとんど見られず、殿堂入りしきい値を 31 に戻しました。
.LP
.SS
-泣潟帥ゃ鴻帥潟水
+サンプルごとのタイムスタンプの挿入
.LP
.LP
-箴\f2lvmid\fP 21891 御･膓250 腱 3 ゃ泣潟緇障\f3\-t\fP 激с潟篏睡泣潟帥ゃ鴻帥潟茵腓冴障
+この例は、\f2lvmid\fP 21891 へ接続し、250 ミリ秒間隔で 3 つのサンプルを取得しています。\f3\-t\fP オプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。
.LP
.nf
\f3
@@ -5417,13 +5400,13 @@
.LP
.LP
-\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏с若障\f3\-gcoldcapacity\fP 阪с蚊綵荀羆障取羆筝≧鴻羣若≦宍Old 筝篁ｃ絎拷 (OGC) Old 絎拷 (OC) 紜障Old 筝篁ｃ絎拷 (OGC) 81 GC (FGC) 緇11696 KB 13820 KB 後障Old 筝篁 (渇) 紊у拷60544 KB (OGCMX) с障≦宍с篏茖罧障
+\f2Timestamp\fP 列には、ターゲット JVM の起動時からの経過時間が、秒単位でレポートされています。さらに、\f3\-gcoldcapacity\fP 出力では、割り当て要求または昇格要求あるいはその両方を満たすためにヒープが拡張するごとに、Old 世代の容量 (OGC) と Old 領域の容量 (OC) とが増加していることがわかります。Old 世代の容量 (OGC) は、81 番目のフル GC (FGC) 後に、11696 KB から 13820 KB へ増加しています。Old 世代 (および領域) の最大容量は、60544 KB (OGCMX) なので、まだ拡張できる余裕が残されています。
.LP
.SS
-≪若 JVM ゃ潟鴻ャ＜潟若激с潟ｈ
+リモート JVM のインストゥルメンテーションの監視
.LP
.LP
-箴\f3\-gcutil\fP 激с潟篏睡\f2remote.domain\fP 激鴻筝 \f2lvmid\fP 40496 ･膓泣潟腱篏х≧緇障
+この例は、\f3\-gcutil\fP オプションを使用して、\f2remote.domain\fP というシステム上の \f2lvmid\fP 40496 に接続し、サンプルを秒単位で無期限に取得しています。
.LP
.nf
\f3
@@ -5440,24 +5423,23 @@
.LP
.LP
-\f2lvmid\fP ≪若鴻腟\f240496@remote.domain\fP \f2vmid\fP 罕障腟 \f2vmid\fP \f3rmi\fP 潟篏睡≪若鴻筝 \f3jstatd\fP 泣若若篆＜障\f3jstatd\fP 泣若若\f3rmiregistry\fP 篏睡 \f3rmiregistry\fP 若 (若 1099) ゃ潟 \f2remote.domain\fP 臀障
+\f2lvmid\fP は、リモートホストの名前と結合されて、\f240496@remote.domain\fP の \f2vmid\fP を構成しています。結果として、この \f2vmid\fP は、\f3rmi\fP プロトコルを使用して、リモートホスト上のデフォルトの \f3jstatd\fP サーバーと通信します。\f3jstatd\fP サーバーは、\f3rmiregistry\fP を使用して、デフォルトの \f3rmiregistry\fP ポート (ポート 1099) にバインドされた \f2remote.domain\fP に配置されれます。
.LP
-.RE
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
+「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
-jstatd(1) \- 篁潟激 jstat 若≪潟
+「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
-rmiregistry(1) \- Java ≪若吾с吾鴻
+「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/jstatd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/jstatd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,43 +19,41 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstatd 1 "02 Jun 2010"
+.TH jstatd 1 "14 Apr 2011"
.LP
-.SH ""
-jstatd \- 篁潟激 jstat 若≪
+.SH "名前"
+jstatd \- 仮想マシン jstat デーモン
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-祉ャｃ
+セキュリティー
.TP 2
o
-≪若ゃ潟帥с若
+リモートインタフェース
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -68,72 +66,64 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟激с潟篁紙綺ф絎с障茲障障激с潟翫緇絎激с潟障
+コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jstatd\fP 若荐羝 HotSpot Java 篁潟激 (JVM) 篏腟篋ｈ若激鴻筝у茵 Java 篁潟激潟≪若ｈ若･膓сゃ潟帥с若鴻箴 RMI 泣若若≪宴若激с潟с
+\f3jstatd\fP ツールは、計測された HotSpot Java 仮想マシン (JVM) の作成と終了を監視し、ローカルシステム上で実行している Java 仮想マシンに、リモート監視ツールが接続できるようにするためのインタフェースを提供する RMI サーバーアプリケーションです。
.LP
.LP
-\f3jstatd\fP 泣若若с若鴻 RMI 吾鴻絖綽荀障\f3jstatd\fP 泣若若若障 \f2\-p port\fP 激с潟ф絎若筝 RMI 吾鴻･膓障RMI 吾鴻荀ゃ翫\f2\-p port\fP 激с潟ф絎若障 \f2\-p port\fP ャ翫 RMI 吾鴻ゃ潟 \f3jstatd\fP ≪宴若激с喝1 ゃ RMI 吾鴻篏障 RMI 吾鴻篏\f2\-nr\fP 激с潟絎ｃ胼罩≪с障
+\f3jstatd\fP サーバーでは、ローカルホストに RMI レジストリが存在することが必要になります。\f3jstatd\fP サーバーは、デフォルトポートまたは \f2\-p port\fP オプションで指定されたポート上の RMI レジストリに接続しようとします。RMI レジストリが見つからない場合、\f2\-p port\fP オプションで指定されたポート、または \f2\-p port\fP が省略されている場合は、デフォルト RMI レジストリにバインドされた \f3jstatd\fP アプリケーション内に、1 つの RMI レジストリが作成されます。内部 RMI レジストリの作成は、\f2\-nr\fP オプションを指定することによって禁止することができます。
.LP
.LP
-\f3羈:\fP 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jstatd\fP 潟潟罨＜激с潟泣若障
+\f3jstatd\fP コマンドは次のオプションをサポートしています。
.LP
.RS 3
.TP 3
\-nr
-√ RMI 吾鴻荀ゃ翫\f2jstatd\fP 祉劫 RMI 吾鴻篏障
+既存の RMI レジストリが見つからない場合、\f2jstatd\fP プロセス内に内部 RMI レジストリを作成しないようにします。
.TP 3
\-p\ port
-RMI 吾鴻篋潟若垩с 荀ゃ翫\f2\-nr\fP 絎遺障
+RMI レジストリがあると予想されるポート番号です。 見つからない場合は、\f2\-nr\fP が指定されていなければ作成されます。
.TP 3
\-n\ rminame
-RMI 吾鴻≪若 RMI 吾сゃ潟с \f2JStatRemoteHost\fP с茲違 \f3jstatd\fP 泣若若鴻筝ц儀翫泣若若鴻若 RMI 吾с激с潟絎ｃ筝с障激с潟篏睡翫ｈゃ≪潟 \f2hostid\fP \f2vmid\fP 絖筝泣若弱綽荀障
+RMI レジストリにおいて、リモート RMI オブジェクトがバインドされる名前です。デフォルト名は \f2JStatRemoteHost\fP です。複数の \f3jstatd\fP サーバーが同じホスト上で起動している場合、各サーバーのエクスポートした RMI オブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、監視クライアントの \f2hostid\fP および \f2vmid\fP 文字列に、その一意のサーバー名を含める必要があります。
.TP 3
\-Joption
-\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
-.SH "祉ャｃ"
-.LP
-
+.SH "セキュリティー"
.LP
.LP
-\f3jstatd\fP 泣若若鴻ゃｃ≪祉号┤ JVM ｈс障ｃ\f3jstatd\fP 祉鴻帥若蚊 JVM 若吟取若у茵綽荀障筝若吟取若Unix(TM) 若鴻激鴻 \f2root\fP 若吟若激鴻筝篁紙 JVM ｃ鴻若ゃ潟鴻ャ＜潟若激с潟吾≪祉号┤ｃ障莖若у茵 \f3jstatd\fP 祉鴻激鴻筝鴻 JVM ｈс障祉ャｃ寂ャ馹莎激障
+\f3jstatd\fP サーバーは、有効なネイティブアクセス権を持つ JVM だけを監視できます。したがって、\f3jstatd\fP プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。一部のユーザー資格は、UNIX(TM) ベースのシステムにおける \f2root\fP ユーザーのように、システム上の任意の JVM によってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行している \f3jstatd\fP プロセスは、システム上のすべての JVM を監視できますが、セキュリティー上の別の問題が起こります。
+.LP
+.LP
+\f3jstatd\fP サーバーは、リモートクライアントの認証を一切与えません。そのため、\f3jstatd\fP サーバープロセスを実行すると、\f3jstatd\fP プロセスがアクセス権を持つすべての JVM によるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境的に望ましくない場合があります。 特に実稼働環境または安全でないネットワークでは、\f3jstatd\fP プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。
.LP
.LP
-\f3jstatd\fP 泣若若≪若ゃ≪潟茯荐若筝筝障\f3jstatd\fP 泣若若祉鴻絎茵\f3jstatd\fP 祉鴻≪祉号┤ゃ鴻 JVM ゃ潟鴻ャ＜潟若激с潟鴻若若筝鴻若吟若障♂峨倶医障翫障 鴻絎腮弱医障絎с若с\f3jstatd\fP 祉鴻莎桁若祉ャｃ若激若罎荐綽荀障
+\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の
+.na
+\f2ポリシーファイルの構文\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。
.LP
.LP
-\f3jstatd\fP 泣若若篁祉ャｃ若若吾ｃ若ゃ潟鴻若翫RMISecurityPolicy ゃ潟鴻帥潟鴻ゃ潟鴻若障 祉ャｃ若激若＜ゃ絎綽荀障激若＜ゃ激弱茖
-.na
-\f2激若＜ゃ罕\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html羣綽荀障
-.LP
-.LP
-罨＜激若＜ゃ翫\f3jstatd\fP 泣若若筝祉ャｃ寂紊篏睡絎茵с障激若鴻潟若若鴻吾≪祉号┤茯激若怨墾篏с\f3jstatd\fP 泣若若絎茵篏綽荀≪祉号┤茯激若怨墾蕭ｃ障
+次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。
.LP
.nf
\f3
@@ -155,7 +145,7 @@
.LP
.LP
-激若篏睡鴻 \f2jstatd.all.policy\fP ＜ゃ潟若罨＜ \f3jstatd\fP 泣若若絎茵障
+このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。
.LP
.nf
\f3
@@ -169,27 +159,23 @@
.LP
.LP
-ｳ祉ャｃ若絎純泣ゃ翫鴻帥激若＜ゃ篏睡劫篆♂若с鴻障若≪祉鴻狗с障 号IP ≪鴻贋紙障祉ャｃ若馹ゃ鴻帥ゃ冴激若＜ゃс絲上с翫\f3jstatd\fP 泣若若絎茵\f3jstat\fP \f3jps\fP 若若т戎ｃ絎号障
+より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。
.LP
-.SH "≪若ゃ潟帥с若"
-.LP
-
+.SH "リモートインタフェース"
.LP
.LP
-\f3jstatd\fP 祉鴻鴻若ゃ潟帥с若鴻冴с紊眼篋絎с若吟若渇肴ゃ潟帥с若鴻吾吾莨若帥茵с
+\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-罨＜ \f3jstatd\fP 莎桁箴膣剛障\f3jstatd\fP 鴻ｃ泣若若違潟ц莎桁障
+次に \f3jstatd\fP を起動する例を紹介します。\f3jstatd\fP スクリプトによって、サーバーはバックグラウンドで自動的に起動します。
.LP
.SS
- RMI 吾鴻篏睡
+内部 RMI レジストリの使用
.LP
.LP
-箴 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障箴с RMI 吾鴻若 (若 1099) 篁泣若若ゃ潟喝障
+この例は、内部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。この例では、デフォルトの RMI レジストリポート (ポート 1099) には、他のサーバーはバインドされていないと想定しています。
.LP
.nf
\f3
@@ -201,10 +187,10 @@
.LP
.SS
-紊 RMI 吾鴻篏睡
+外部 RMI レジストリの使用
.LP
.LP
-箴紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -218,7 +204,7 @@
.LP
.LP
-箴若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -232,7 +218,7 @@
.LP
.LP
-箴AlternateJstatdServerName ゃ潟若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -246,10 +232,10 @@
.LP
.SS
-ゃ潟祉 RMI 吾鴻篏胼罩
+インプロセス RMI レジストリの作成の禁止
.LP
.LP
-箴RMI 吾鴻荀ゃ翫 RMI 吾鴻篏 \f3jstatd\fP 莎桁茵障箴сRMI 吾鴻с絎茵喝障絎茵翫荅峨若＜祉若吾茵腓冴障
+この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。
.LP
.nf
\f3
@@ -261,10 +247,10 @@
.LP
.SS
-RMI 井純劫
+RMI ログ機能の有効化
.LP
.LP
-箴RMI 井純鴻 \f3jstatd\fP 莎桁茵障号激ャ若ｃ潟違障泣若惹柑ｈ綵合＜障
+この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。
.LP
.nf
\f3
@@ -275,25 +261,25 @@
.fi
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
+「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
-jstat(1) \- Java 篁潟激括輝荐若睡ｈ若
+「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
-
+「
.na
\f2rmiregistry\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java ≪若吾с吾鴻
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/linux/doc/man/ja/jvisualvm.1 Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,126 @@
+." Copyright (c) 2008, 2010, 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.
+."
+.TH jvisualvm 1 "14 Apr 2011"
+
+.LP
+.SH "名前"
+\f2jvisualvm\fP \- Java 仮想マシンの監視、トラブルシューティング、およびプロファイリングツール
+.LP
+.RS 3
+.TP 2
+o
+形式
+.TP 2
+o
+パラメータ
+.TP 2
+o
+説明
+.TP 2
+o
+オプション
+.TP 2
+o
+使用方法
+.TP 2
+o
+関連項目
+.RE
+
+.LP
+.SH "形式"
+.LP
+.nf
+\f3
+.fl
+ \fP\f3jvisualvm\fP [ \f2options\fP ]
+.fl
+.fi
+
+.LP
+.SH "パラメータ"
+.LP
+.LP
+オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、このあとの「オプション」を参照してください。
+.LP
+.SH " 説明"
+.LP
+.LP
+Java VisualVM は、指定された Java 仮想マシン (JVM(*)) で Java テクノロジベースのアプリケーション (Java アプリケーション) が実行されているときに、その Java アプリケーションに関する詳細な情報を提供する直感的なグラフィカルユーザーインタフェースです。Java VisualVM という名前は、Java VisualVM が JVM ソフトウェアに関する情報を「視覚的に」提供するという事実に由来しています。
+.LP
+.LP
+Java VisualVM は、いくつかの監視、トラブルシューティング、およびプロファイリングユーティリティーを 1 つのツールに統合します。たとえば、スタンドアロンツール \f2jmap\fP、 \f2jinfo\fP、 \f2jstat\fP 、および \f2jstack\fP で提供されている機能のほとんどが、Java VisualVM に組み込まれています。JConsole ツールによって提供される一部の機能など、ほかの機能はオプションのプラグインとして追加できます。
+.LP
+.SH "オプション"
+.LP
+.LP
+次のオプションは、Java VisualVM を起動したときに実行可能になります。
+.LP
+.RS 3
+.TP 3
+\-J<jvm_option>\
+この \f2<jvm_option>\fP を JVM ソフトウェアに渡します。
+.RE
+
+.LP
+.SH "使用方法"
+.LP
+.LP
+Java VisualVM は、Java アプリケーションの開発者がアプリケーションのトラブルシューティングを行なったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVM を使用すると、開発者はヒープダンプの生成および解析、メモリーリークの特定、ガベージコレクションの実行および監視、およびメモリーと CPU の簡易プロファイリングの実行が可能になります。Java VisualVM の機能を拡張するプラグインもいくつかあります。たとえば、JConsole ツールのほとんどの機能は、MBeans タブおよび JConsole Plug\-in Wrapper プラグインを介して使用できます。標準の Java VisualVM プラグインのカタログから選択するには、Java VisualVM メニューの「ツール」>「プラグイン」を選択します。
+.LP
+.LP
+Java VisualVM を起動するには、次のコマンドを実行します。
+.LP
+.nf
+\f3
+.fl
+% jvisualvm \fP\f4<options>\fP\f3
+.fl
+\fP
+.fi
+
+.LP
+.SH "関連項目"
+.LP
+.LP
+Java VisualVM の詳細は、次のページを参照してください。
+.LP
+.RS 3
+.TP 2
+o
+.na
+\f2Java VisualVM 開発者のサイト\fP @
+.fi
+https://visualvm.dev.java.net
+.TP 2
+o
+.na
+\f2Java SE プラットフォームでの Java VisualVM のドキュメント\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/visualvm/index.html
+.RE
+
+.LP
+.LP
+\f2(* 「Java 仮想マシン」と「JVM」という用語は、Java プラットフォームの仮想マシンを意味しています。)\fP
+.LP
+
--- a/jdk/src/linux/doc/man/ja/keytool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/keytool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1998-2010 keytool tool, 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
@@ -19,20 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH keytool 1 "02 Jun 2010"
+.TH keytool 1 "14 Apr 2011"
.LP
-.SH ""
-keytool \- 泣荐惹吾膊∞若
+.SH "名前"
+keytool \- 鍵と証明書の管理ツール
.LP
-.RS 3
-
.LP
-垸泣X.509 荐惹吾с若潟割拭若с荐惹吾若鴻 (若帥若) 膊∞障
-.RE
-.SH "綵√"
+暗号化鍵、X.509 証明書チェーン、および信頼できる証明書を含むキーストア (データベース) を管理します。
.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -43,48 +39,44 @@
.LP
.LP
-Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障 荅括完ゃ紊雁鴻膀с篁ュ絎臂潟潟綣膓泣若障
+Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。
.LP
-.SH "茯"
+.SH "説明"
.LP
-
+\f3keytool\fP は、鍵と証明書を管理するためのユーティリティーです。keytool を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザーまたはサービスに対して自分自身を認証すること) や、データの整合性と証明書に関するサービスを利用することができます。keytool では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。
.LP
-\f3keytool\fP 泣荐惹吾膊∞若ｃｃ若сkeytool 篏帥泣泣≪渇∫ｃ荐惹吾膊∞吾帥臀峨篏帥ｃ綏沿荐 (祉若吟若障泣若鴻絲障荳茯荐若) 若帥翫с荐惹吾≪泣若鴻с障keytool с篆∞御泣 (荐惹吾綵≪) ｃ激ャс障
-.LP
-荐惹吾潟ｃｃ (篋榊篌腓障) 吾帥臀峨篁吾с 荐惹吾祉潟ｃｃ若 (潟篁) 劫ャゃｃ吾障(荐惹吾)若帥吾帥臀峨篁翫吾帥臀峨罎荐若с若帥翫с潟若帥ссс障若帥翫с若帥紊眼劫潟障 障若帥с若帥若帥篏臀峨腱違篋榊絎羝＜若帥с潟障
+「証明書」とは、あるエンティティー (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティーの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「整合性」とは、データが変更されたり、改変されたりしていないことを意味します。 また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。
.LP
.LP
-障\f3keytool\fP 篏帥違DES 絲丞О垸/緇垸т戎腱絲泣膊∞с障
+また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。
.LP
.LP
-\f3keytool\fP 泣荐惹吾\f2若鴻≪\fP主障
+\f3keytool\fP は、鍵と証明書を\f2「キーストア」\fPに格納します。
.LP
-.SH "潟潟激с潟≪羈"
-.LP
-
+.SH "コマンドとオプションに関する注"
.LP
.LP
-篁ヤс潟潟激с潟ゃ茯障羈:
+以下では、コマンドとそのオプションについて説明します。注:
.LP
.RS 3
.TP 2
o
-潟潟潟激с喝ゃ壕 (\-) 篁
+どのコマンド名およびオプション名にも先頭にマイナス記号 (\-) が付く
.TP 2
o
-潟潟激с潟篁紙綺ф絎с
+各コマンドのオプションは任意の順序で指定できる
.TP 2
o
-ゃ帥篏ｃ鴻障筝綣с茹綣су蚊障鴻絎綽荀
+イタリック体になっていないすべての項目、または中括弧か角括弧で囲まれているすべての項目は、そのとおりに指定する必要がある
.TP 2
o
-激с潟蚊筝綣с筝激с潟潟潟茵ф絎ｃ翫ゃ篏帥潟筝綣с\f2\-v\fP\f2\-rfc\fP \f2\-J\fP 激с潟蚊篏帥激с潟潟潟茵ф絎翫炊潟 (ゃ障激с潟激с活篏絎篁ュゃ絖)
+オプションを囲む中括弧は、一般に、そのオプションをコマンド行で指定しなかった場合に、デフォルト値が使われることを意味する。中括弧は、 \f2\-v\fP、 \f2\-rfc\fP、および \f2\-J\fP オプションを囲むのにも使われるが、これらのオプションはコマンド行で指定された場合にのみ意味を持つ (つまり、これらのオプションには、オプション自体を指定しないこと以外に「デフォルト値」は存在しない)
.TP 2
o
-激с潟蚊茹綣с激с潟潟潟茵ф絎ｃ翫ゃュ羆潟\f2\-keypass\fP 激с潟潟潟茵ф絎ｃ翫\f3keytool\fP 若鴻≪鴻若/腱絲泣緇荅帥 若吟若荅帥紊掩翫/腱絲泣ュ羆
+オプションを囲む角括弧は、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味する。( \f2\-keypass\fP オプションの場合、オプションをコマンド行で指定しなかった場合は、\f3keytool\fP がまずキーストアのパスワードから非公開/秘密鍵の復元を試みる。 ユーザーは、この試みが失敗した場合に非公開/秘密鍵のパスワードの入力を求められる
.TP 2
o
-ゃ帥篏絎 (激с潟) 若吟若絎綽荀違\f2\-printcert\fP 潟潟綵√罨＜с
+イタリック体の項目の実際の値 (オプションの値) は、ユーザーが指定する必要があるたとえば、 \f2\-printcert\fP コマンドの形式は次のとおりである
.nf
\f3
.fl
@@ -93,7 +85,7 @@
\fP
.fi
.LP
-\f2\-printcert\fP 潟潟絎\f2cert_file\fP 篁ｃ絎＜ゃ絎罨＜箴腓冴
+\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。次に例を示す
.nf
\f3
.fl
@@ -103,10 +95,10 @@
.fi
.TP 2
o
-激с潟ゃ腥榊 (鴻若) 障翫ゃ綣膃у蚊綽荀
+オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある
.TP 2
o
-\f2\-help\fP 潟潟潟潟с違罨＜潟潟茵絎
+\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする
.nf
\f3
.fl
@@ -114,7 +106,8 @@
.fl
\fP
.fi
-罨＜絎с
+.LP
+これは、次のように指定することと同じです。
.nf
\f3
.fl
@@ -126,12 +119,11 @@
.LP
.SS
-激с潟
+オプションのデフォルト値
+.LP
.LP
-.RS 3
-
+オプションのデフォルト値は、次のとおりです。
.LP
-激с潟ゃ罨＜с
.nf
\f3
.fl
@@ -141,19 +133,25 @@
.fl
\-keyalg
.fl
- "DSA" (\fP\f3\-genkeypair\fP\f3 篏睡翫)
+ "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合)
.fl
- "DES" (\fP\f3\-genseckey\fP\f3 篏睡翫)
+ "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合)
.fl
.fl
\-keysize
.fl
- 1024 (\fP\f3\-genkeypair\fP\f3 篏睡翫)
+ 2048 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "RSA" の場合)
+.fl
+ 1024 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "DSA" の場合)
+.fl
+ 256 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "EC" の場合)
.fl
- 56 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DES" 翫)
+ 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合)
.fl
- 168 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DESede" 翫)
+ 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合)
+.fl
+
.fl
.fl
@@ -161,320 +159,933 @@
.fl
.fl
-\-keystore \fP\f4若吟若若ｃ \fP\f4.keystore\fP\f3 ＜ゃ\fP\f3
+\-keystore ユーザーのホームディレクトリの \fP\f4.keystore\fP\f3 というファイル
.fl
.fl
-\-storetype \fP\f4祉ャｃ若ｃ若＜ゃkeystore.typeｃ若ゃс
+\-storetype セキュリティープロパティーファイルの「keystore.type」プロパティーの値で、
.fl
- \fP\f4java.security.KeyStore\fP\f3 \fP\f4getDefaultType\fP\f3 ＜純菴\fP\f3
+ java.security.KeyStore の静的な getDefaultType メソッドから返される \fP\f4 \fP\f3
+.fl
+ \fP\f4 \fP\f3
.fl
.fl
-\-file \fP\f4茯粋昭帥翫罔羣ュ吾莨若帥翫罔羣阪\fP\f3
+\-file 読み込みの場合は標準入力、書き込みの場合は標準出力
.fl
.fl
\-protected false
.fl
-
-.fl
\fP
.fi
.LP
-/泣≪臀峨≪眼冴 (\f2\-sigalg\fP 激с) 冴泣≪眼冴羇丞障冴泣 DSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ SHA1withDSA 冴泣 RSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ MD5withRSA 障御純 \f2\-keyalg\fP \f2\-sigalg\fP 絎筝荀сゃ
-.na
-\f2Java Cryptography Architecture API Specification & Reference\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс
-.RE
-.SS
-筝激с
+.LP
+公開/非公開鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。
.LP
.RS 3
+.TP 2
+o
+基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションのデフォルト値は SHA1withDSA になり、
+.TP 2
+o
+基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withRSA になり、
+.TP 2
+o
+基になる非公開鍵が EC タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withECDSA になります。
+.RE
.LP
-\f2\-v\fP 激с潟\f2\-help\fP 潟潟ゃ鴻潟潟т戎с障激с潟絎翫潟潟激≪若у茵荅括完荐惹御宴阪障
.LP
-障\f2\-J\fP\f2javaoption\fP 激с潟篁紙潟潟т戎с障激с潟絎翫絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋･羝＜障激с潟腥榊純с障激с潟絎茵医障＜≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц；腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
+選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、
+.na
+\f2「Java Cryptography Architecture API Specification & Reference」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。
+.LP
+.SS
+一般オプション
.LP
.LP
-罨＜激с潟若鴻≪絲障篏茵鴻潟潟ф絎с障
+\f2\-v\fP オプションは、 \f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。
+.LP
+.LP
+また、 \f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。
+.LP
+.LP
+次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。
.LP
.RS 3
.TP 3
\-storetype storetype
-篆蕋上ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障
+.LP
+この修飾子は、インスタンスを生成するキーストアのタイプを指定します。
.TP 3
\-keystore keystore
-若鴻≪贋絎障
.LP
-劫 \f3keytool\fP 潟潟絎茵JKS 鴻≪帥ゃ篏睡ゃ若鴻≪＜ゃ障絖ｃ翫違若鴻≪＜ゃ篏障違\f2keytool \-genkeypair\fP 絎茵 \f2\-keystore\fP 激с潟絎ｃ翫\f2.keystore\fP 若鴻≪＜ゃ若吟若若ｃ障絖違篏障罕\f2\-keystore \fP\f2ks_file\fP 激с潟絎 \f2ks_file\fP 絖ｃ翫＜ゃ篏障
-.LP
-\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP ＜純羝＜障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP ＜純羝＜障\f2NONE\fP \f2KeyStore\fP ＜ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
-.TP 3
-\-storepass storepass
-若鴻≪翫с篆茘激篏帥鴻若絎障
-.LP
-\f2storepass\fP 6 絖篁ヤ綽荀障絎鴻若若鴻≪絎鴻≪祉鴻鴻潟潟т戎障腮潟潟絎茵潟潟茵 \f2\-storepass\fP 激с潟絎ｃ翫鴻若ュ羆障
-.LP
-若鴻≪宴冴翫鴻若ャс障 鴻若ャ冴宴翫сссс茘茵腓冴障
-.TP 3
-\-providerName provider_name
-祉ャｃ若ｃ若＜ゃ障垸泣若鴻ゃ劫篏睡障
-.TP 3
-\-providerClass provider_class_name
-垸泣若鴻ゃ祉ャｃ若ｃ若＜ゃ絎鴻帥若鴻＜ゃ絎篏帥障
-.TP 3
-\-providerArg provider_arg
-\f2\-providerClass\fP 腟水篏睡障\f2provider_class_name\fP 潟潟鴻帥絲障ュ純絖ュ綣違茵障
-.TP 3
-\-protected
-\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
-.RE
-
+キーストアの場所を指定します。
.LP
-.RE
-.SH "潟潟"
-.LP
-
-.LP
-.SS
-若鴻≪吾若帥篏障菴遵
-.LP
-.RS 3
-
+特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、 \f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、 \f2.keystore\fP という名前のデフォルトキーストアファイルがユーザーのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、 \f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。
.LP
-.RS 3
-.TP 3
-\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-泣 (泣渇∫ｃ) 障泣 X.509 v3 綏援讐荐惹吾с障 荐惹吾筝荀膣よ┝吾с若潟主障荐惹吾с若潟泣\f2alias\fP х劫違若鴻≪潟主障
-.LP
-\f2keyalg\fP 泣≪篏帥≪眼冴絎\f2keysize\fP 泣泣ゃ冴絎障 \f2sigalg\fP 綏援讐荐惹吾臀峨篁篏帥≪眼冴絎障≪眼冴\f2keyalg\fP 篋сс違障
-.LP
-\f2dname\fP \f2alias\fP ∫ｄ綏援讐荐惹吾 \f2issuer\fP ｃ若 \f2subject\fP ｃ若篏帥 X.500 茘ュ絎障潟潟茵цュ絎ｃ翫茘ュュ羆障
-.LP
-\f2keypass\fP 泣≪＜泣篆茘激篏帥鴻若絎障鴻若絎ｃ翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
-.LP
-\f2valDays\fP 荐惹吾号ユ違絎障
-.LP
-潟潟篁ュ若鴻с \f2\-genkey\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-genkeypair\fP 篏睡с障
+\f2\-keystore\fP オプションからの入力ストリームは、 \f2KeyStore.load\fP メソッドに渡されます。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではなく、たとえば、ハードウェアトークンデバイスに置かれている場合に指定します。
.TP 3
-\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-腱絲泣 \f2alias\fP х劫違 \f2KeyStore.SecretKeyEntry\fP 主障
-.LP
-\f2keyalg\fP 腱絲泣篏睡≪眼冴\f2keysize\fP 泣泣ゃ冴絎障\f2keypass\fP 腱絲泣篆茘激篏睡鴻若с鴻若絎ｃ翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
-.TP 3
-\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-＜ゃ \f2cert_file\fP 荐惹吾障荐惹吾с若 (荐惹吾с若潟翫PKCS#7 綵√綽膈ф箴) 茯粋昭帥\f2alias\fP ｃ劫若鴻≪潟主障＜ゃ絎翫罔羣ュ荐惹吾障 PKCS#7 綽膈茯粋昭帥障
-.LP
-\f3keytool\fP сX.509 v1v2v3 荐惹吾潟PKCS#7 綵√荐惹吾罕 PKCS#7 綵√荐惹吾с若潟ゃ潟若с障ゃ潟若若帥ゃ膃垸劫障阪順垸劫 (Base64 膃垸若違) ＜ф箴綽荀障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障膃垸劫翫荐惹吾\-\-\-\-\-BEGINу障絖ч紮\-\-\-\-\-ENDу障絖х篋違障
-.LP
-荐惹吾ゃ潟若罨＜ 2 ゃ障
-.RS 3
-.TP 3
-1.
-篆♂若с荐惹吾鴻荐惹吾菴遵
-.TP 3
-2.
-CA 荐惹悟讐荀羆 (\-certreq 潟潟) 篆＜腟CA ｃ荐惹綽膈ゃ潟若
-.RE
+\-storepass[:env|:file] argument
.LP
-＜腮蕁ゃ潟若茵\f2\-alias\fP 激с潟ゃｃ絎障
-.RS 3
-.TP 3
-1.
-\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障翫ュ若鴻√с絖障ュс絖翫ュ篆♂若с荐惹吾с絖с\f3keytool\fP 若阪荐惹吾ゃ潟若茵障
-.TP 3
-2.
-\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障
-.RE
-\f3違篆♂若с荐惹吾ゃ潟若\fP
-.RS 3
-
-.LP
-.LP
-\f3keytool\fP 若鴻≪荐惹吾菴遵若鴻√с絖篆♂若с荐惹吾篏帥ｃゃ潟若荐惹吾 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟罕膀荅帥障
+キーストアの整合性を保護するために使うパスワードを指定します。
.LP
-.LP
-\f2\-trustcacerts\fP 激с潟絎翫菴遵荐惹吾篆♂若с cacerts ＜ゃ障荐惹吾с若潟荀障
-.LP
-.LP
-\f3keytool\fP ゃ潟若荐惹吾綏援讐荐惹 (若鴻≪障 cacerts ＜ゃ障綏援讐荐惹) 潟障с篆♂若鴻罕膀紊掩翫ゃ潟若荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾ｃ潟若潟祉 (篆♂若с) 掩 (荐惹吾篋冴) ユｃ潟若潟罸莠障篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障荅括完篆♂若с荐惹吾ゃ潟若≪羈鋋сゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
-.LP
-.RE
-\f3荐惹綽膈ゃ潟若\fP
-.RS 3
-.LP
-荐惹綽膈ゃ潟若若鴻√篆♂若с荐惹吾 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪＜ゃф荐惹吾篏帥ｃ荐惹綽膈罎祉障
-.LP
-.LP
-荐惹綽膈篆♂若с羆阪号罨＜с
-.LP
+修飾子 \f2env\fP または \f2file\fP を指定しない場合、パスワードの値は \f2argument\fP になります。この値は、6 文字以上にする必要があります。それ以外の場合、パスワードは次のように取得されます。
.RS 3
.TP 2
o
-\f3荐惹綽膈筝 X.509 荐惹吾с翫\fP\f3keytool\fP 荐惹綽膈 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟腆榊荅帥障荐惹綽膈荐惹綽膈茯荐若篏帥荐惹吾絮ゆ\f2alias\fP 違荐惹吾с若潟綵∽障篆♂若с若潟腆榊翫荐惹綽膈ゃ潟若障翫\f3keytool\fP 荐惹吾阪若吟若罎荐若羆潟茵腓冴障 若吟若荐惹綽膈篆♂惹сゆ筝純с絽吾育ｃс
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
.TP 2
o
-\f3荐惹綽膈 PKCS#7 綵√荐惹吾с若潟с翫\fP\f3keytool\fP 障с若潟筝号帥若吟若荐惹吾若 CA 綏援讐荐惹吾緇荐惹綽膈障若 CA 荐惹吾若鴻√障 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪＜ゃ篆♂若с荐惹吾鴻罸莠筝眼茯帥鴻障筝眼荀ゃｃ翫若 CA 荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾ｃ潟若潟祉 (篆♂若с) 掩 (若 CA 荳) ユｃ潟若潟罸莠障ゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+\f3注\fP: \f2\-keypass\fP、 \f2\-srckeypass\fP、 \f2\-destkeypass\fP \f2\-srcstorepass\fP、 \f2\-deststorepass\fP などのパスワードを必要とするその他のオプションはすべて、 \f2env\fP と \f2file\fP 修飾子を受け付けます。パスワードオプションと修飾子は、必ずコロン (\f2:\fP) で区切ってください。
+.LP
+パスワードは、キーストアの内容にアクセスするすべてのコマンドで使われます。この種のコマンドを実行するときに、コマンド行で \f2\-storepass\fP オプションを指定しなかった場合は、パスワードの入力を求められます。
+.LP
+キーストアから情報を取り出す場合は、パスワードを省略できます。 パスワードを省略すると、取り出す情報の整合性をチェックできないので、警告が表示されます。
+.TP 3
+\-providerName provider_name
+.LP
+セキュリティープロパティーファイル内に含まれる暗号化サービスプロバイダ名を特定するために使用されます。
+.TP 3
+\-providerClass provider_class_name
+.LP
+暗号化サービスプロバイダがセキュリティープロパティーファイルに指定されていないときは、そのマスタークラスファイルの名前を指定するときに使われます。
+.TP 3
+\-providerArg provider_arg
+.LP
+\f2\-providerClass\fP と組み合わせて使用します。\f2provider_class_name\fP のコンストラクタに対する省略可能な文字列入力引数を表します。
+.TP 3
+\-protected
+.LP
+\f2true\fP または \f2false\fP のいずれか。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
+.LP
+注: \f2\-importkeystore\fP コマンドには 2 つのキーストアが関係しているため、2 つのオプション、つまり \f2\-srcprotected\fP と \f2\-destprotected\fP がソースキーストアとターゲットキーストアにそれぞれ指定されます。
+.TP 3
+\-ext {name{:critical}{=value}}
+.LP
+X.509 証明書エクステンションを示します。このオプションを \-genkeypair および \-gencert で使用して、生成される証明書または \f2\-certreq\fP にエクステンションを埋め込み、証明書要求で要求されるエクステンションを示すことができます。このオプションは、複数回使用できます。name には、サポートされているエクステンション名 (下記を参照) または任意の OID 番号を指定できます。value を指定した場合は、エクステンションのパラメータを示します。省略した場合は、エクステンションのデフォルト値 (定義されている場合) を示すか、またはエクステンションにパラメータは必要ありません。 \f2:critical\fP 修飾子を指定した場合は、エクステンションの isCritical 属性が true であることを示します。それ以外の場合は false であることを示します。:critical の代わりに : \f2:c\fP を使用できます。 .
.RE
.LP
.LP
-荐惹後膈泣 \f2alias\fP 筝с主若吟若泣筝眼翫ゃ荐惹吾с若潟綽膈違荐惹吾с若潟х舟障篁ュ荐惹吾с若潟違荐惹吾с若潟х舟с鴻 \f2keypass\fPゃ障荅峨潟泣篆茘激鴻若絎翫с鴻若絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
-.LP
-.RE
+現在、keytool は次の名前のエクステンションをサポートしています (大文字と小文字は区別されない)。
.LP
-潟潟篁ュ若鴻с \f2\-import\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-importcert\fP 篏睡с障
-.TP 3
-\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-純若鴻若鴻≪帥若蚊若鴻≪吾筝潟障鴻潟ゃ潟若障
-.LP
-\f2srcalias\fP 激с潟絎翫潟潟ュх劫筝潟帥若蚊若鴻≪ゃ潟若障\f2destalias\fP 腟宴с帥若蚊ュ絎ｃ翫\f2srcalias\fP 帥若蚊ュ篏睡障純若鴻潟鴻若т茘激翫\f2srckeypass\fP 篏帥ｃ潟緇障\f2srckeypass\fP 絎ｃ翫\f3keytool\fP \f2srcstorepass\fP 篏帥ｃ潟緇障\f2srcstorepass\fP 絎ｃ罩ｃｃ翫若吟若鴻若ュ羆障帥若蚊潟 \f2destkeypass\fP ｃ篆茘激障\f2destkeypass\fP 絎ｃ翫帥若蚊潟純若鴻潟鴻若ｃ篆茘激障
.LP
-\f2srcalias\fP 激с潟絎ｃ翫純若鴻若鴻√鴻潟帥若蚊若鴻√ゃ潟若障帥若蚊潟絲上純若鴻潟ュ筝主障純若鴻潟鴻若т茘激翫\f2srcstorepass\fP 篏帥ｃ潟緇障\f2srcstorepass\fP 絎ｃ罩ｃｃ翫若吟若鴻若ュ羆障純若鴻若鴻√潟帥ゃ帥若蚊若鴻≪с泣若翫潟帥若蚊若鴻≪主若榊翫若吟若潟鴻膓茵筝御羆障帥若蚊潟純若鴻潟鴻若ｃ篆茘激障
-.LP
-帥若蚊ュ帥若蚊若鴻√с絖翫若吟若潟筝吾違ュ筝ф違潟篏御羆障
+.TS
+.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
+.de 35
+.ps \n(.s
+.vs \n(.vu
+.in \n(.iu
+.if \n(.u .fi
+.if \n(.j .ad
+.if \n(.j=0 .na
+..
+.nf
+.nr #~ 0
+.if n .nr #~ 0.6n
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.fc
+.nr 33 \n(.s
+.rm 80 81
+.nr 34 \n(.lu
+.eo
+.am 80
+.br
+.di a+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+BC または BasicConstraints
+.br
+.di
+.nr a| \n(dn
+.nr a- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di b+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+完全な形は「ca:{true|false}[,pathlen:<len>]」で、<len> は「ca:true,pathlen:<len>」の省略表記です。 省略すると、「ca:true」の意味になります
+.br
+.di
+.nr b| \n(dn
+.nr b- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di c+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+usage(,usage)*。usage には、digitalSignature、 nonRepudiation (contentCommitment)、keyEncipherment、dataEncipherment、keyAgreement、keyCertSign、cRLSign、encipherOnly、decipherOnly のいずれかを指定できます。Usage は、あいまいさがなければ、最初の数文字 (たとえば、digitalSignature を dig に) またはキャメルケーススタイル (たとえば、 digitalSignature を dS に、cRLSign を cRLS に) に 短縮できます。Usage の大文字と小文字は区別されません。
+.br
+.di
+.nr c| \n(dn
+.nr c- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di d+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+EKU または ExtendedkeyUsage
+.br
+.di
+.nr d| \n(dn
+.nr d- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di e+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+usage(,usage)*。usage には、anyExtendedKeyUsage、 serverAuth、clientAuth、codeSigning、emailProtection、 timeStamping、OCSPSigning、または任意の OID 文字列のいずれかを指定できます。 名前付きの usage は、あいまいさがなければ、 最初の数文字またはキャメルケーススタイルに 短縮できます。Usage の大文字と小文字は区別されません。
+.br
+.di
+.nr e| \n(dn
+.nr e- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di f+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+SAN または SubjectAlternativeName
+.br
+.di
+.nr f| \n(dn
+.nr f- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di g+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+type:value(,type:value)*。type には、EMAIL、URI、DNS、IP、または OID を指定できます。value は、type の文字列形式の値です。
+.br
+.di
+.nr g| \n(dn
+.nr g- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di h+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+IAN または IssuerAlternativeName
+.br
+.di
+.nr h| \n(dn
+.nr h- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di i+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+SubjectAlternativeName と同じです
+.br
+.di
+.nr i| \n(dn
+.nr i- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di j+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+SIA または SubjectInfoAccess
+.br
+.di
+.nr j| \n(dn
+.nr j- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di k+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+method:location\-type:location\-value (,method:location\-type:location\-value)*。 method には、「timeStamping」、「caRepository」、または任意の OID を指定できます。location\-type および location\-value には、SubjectAlternativeName エクステンションでサポートされる任意の type:value を指定できます。
+.br
+.di
+.nr k| \n(dn
+.nr k- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di l+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+AIA または AuthorityInfoAccess
+.br
+.di
+.nr l| \n(dn
+.nr l- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di m+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+SubjectInfoAccess と同じです。method には、「ocsp」、「caIssuers」、または任意の OID を指定できます。
+.br
+.di
+.nr m| \n(dn
+.nr m- \n(dl
+..
+.ec \
+.35
+.nf
+.ll \n(34u
+.nr 80 0
+.nr 38 \w\f3名前\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \wKU または KeyUsage
+.if \n(80<\n(38 .nr 80 \n(38
+.80
+.rm 80
+.nr 38 \n(a-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(d-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(f-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(h-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(j-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(l-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 81 0
+.nr 38 \w\f3値\fP
+.if \n(81<\n(38 .nr 81 \n(38
+.81
+.rm 81
+.nr 38 \n(b-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(c-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(e-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(g-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(i-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(k-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(m-
+.if \n(81<\n(38 .nr 81 \n(38
+.35
+.nf
+.ll \n(34u
+.nr 38 1n
+.nr 79 0
+.nr 40 \n(79+(0*\n(38)
+.nr 80 +\n(40
+.nr 41 \n(80+(3*\n(38)
+.nr 81 +\n(41
+.nr TW \n(81
+.if t .if \n(TW>\n(.li .tm Table at line 325 file Input is too wide - \n(TW units
+.fc
+.nr #T 0-1
+.nr #a 0-1
+.eo
+.de T#
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.mk ##
+.nr ## -1v
+.ls 1
+.ls
+..
+.ec
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3名前\fP\h'|\n(41u'\f3値\fP
+.ne \n(a|u+\n(.Vu
+.ne \n(b|u+\n(.Vu
+.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
+.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.a+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.b+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(c|u+\n(.Vu
+.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'KU または KeyUsage\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.c+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(d|u+\n(.Vu
+.ne \n(e|u+\n(.Vu
+.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
+.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.d+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.e+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(f|u+\n(.Vu
+.ne \n(g|u+\n(.Vu
+.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
+.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.f+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.g+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(h|u+\n(.Vu
+.ne \n(i|u+\n(.Vu
+.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
+.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.h+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.i+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(j|u+\n(.Vu
+.ne \n(k|u+\n(.Vu
+.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
+.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.j+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.k+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(l|u+\n(.Vu
+.ne \n(m|u+\n(.Vu
+.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
+.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.l+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.m+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.fc
+.nr T. 1
+.T# 1
+.35
+.rm a+
+.rm b+
+.rm c+
+.rm d+
+.rm e+
+.rm f+
+.rm g+
+.rm h+
+.rm i+
+.rm j+
+.rm k+
+.rm l+
+.rm m+
+.TE
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
+
.LP
-\f2\-noprompt\fP 絎翫若吟若違帥若蚊ュュ羆障√潟帥若蚊ュц筝吾障緇ゃ潟若с潟鴻茘阪障
-.RE
-.RE
+.LP
+OID 名の場合、OCTET STRING タイプと長さのバイトを除外したエクステンションについては、値は extnValue の HEX ダンプの DER エンコーディングです。HEX 文字列では、標準の HEX 数 (0\-9、a\-f、A\-F) 以外の文字は無視されます。したがって、 \f2「01:02:03:04」\fP と \f2「01020304」の両方とも\fP 同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。
+.LP
+.LP
+\f2\-gencert\fP でのみ使用する「honored」という特別な名前は、証明書要求に含まれるエクステンションを優先する方法を示します。この名前の値は、 \f2「all」\fP (要求されるすべてのエクステンションが優先される)、 \f2「name{:[critical|non\-critical]}」\fP (名前付きのエクステンションが優先されるが、別の isCritical 属性を使用する)、および \f2「\-name」\fP (「all」とともに使用し、例外を示す) のコンマ区切りリストです。デフォルトでは、要求されるエクステンションは優先されません。
+.LP
+.LP
+\-ext 優先のオプションに加え、別の名前の、または OID \-ext のオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前 (または OID) を優先される値でも使用した場合は、その値と重要性が要求に含まれるものをオーバーライドします。
+.LP
+.LP
+subjectKeyIdentifier エクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifier が常に作成されます。
+.LP
+.LP
+\f3注:\fP ユーザーは、エクステンション (および証明書のほかのフィールド) の組み合わせによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細については、「証明書の準拠に関する注意事項」を参照してください。
+.LP
+.SH "コマンド"
+.LP
.SS
-若帥鴻若
-.LP
-.RS 3
-
+キーストアへのデータの作成または追加
.LP
.RS 3
.TP 3
-\-certreq {\-alias alias} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+\-gencert {\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+証明書要求ファイル ( \f2keytool \-certreq\fP コマンドで作成できる) に応答して証明書を生成します。このコマンドは、\f2infile\fP から (省略した場合は、標準入力から) 要求を読み込み、別名の非公開鍵を使ってその要求に署名して、X.509 証明書を \f2outfile\fP に (省略した場合は、標準出力に) 出力します。 \f2\-rfc\fP を指定した場合、出力形式は BASE64 符号化の PEM になります。それ以外の場合は、バイナリ DER が作成されます。
+.LP
+\f2sigalg\fP には、証明書に署名を付けるときに使うアルゴリズムを指定します。\f2startdate\fP は、証明書が有効になる開始時刻/日付です。\f2valDays\fP には、証明書の有効日数を指定します。
+.LP
+\f2dname\fP を指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書要求からの名前が使用されます。
+.LP
+\f2ext\fP は、証明書に埋め込まれる X.509 エクステンションを示します。\-ext の文法については、「一般オプション」を参照してください。
+.LP
+\f2\-gencert\fP コマンドを使用すると、証明書チェーンを作成できます。次の例では、 \f2e1\fP という証明書を作成します。この証明書の証明書チェーンには、3 つの証明書が含まれています。
+.LP
+次のコマンドは、ca、ca1、ca2、および e1 の 4 つの鍵ペアを作成します。
+.nf
+\f3
+.fl
+keytool \-alias ca \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias ca1 \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias ca2 \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias e1 \-dname CN=E1 \-genkeypair
+.fl
+\fP
+.fi
+.LP
+次の 2 つのコマンドは、署名付き証明書のチェーンを作成します。 \f2ca\fP は ca1 に署名し、 \f2ca1 signs ca2\fP に署名します。すべて自己発行です。
+.nf
+\f3
+.fl
+keytool \-alias ca1 \-certreq | keytool \-alias ca \-gencert \-ext san=dns:ca1 | keytool \-alias ca1 \-importcert
+.fl
+keytool \-alias ca2 \-certreq | $KT \-alias ca1 \-gencert \-ext san=dns:ca2 | $KT \-alias ca2 \-importcert
+.fl
+\fP
+.fi
.LP
-PKCS#10 綵√篏帥ｃ荐惹悟讐荀羆 (CSR) 障
+次のコマンドは、証明書 e1 を作成してファイル e1.cert に格納します。この証明書は ca2 によって署名されます。その結果、e1 の証明書チェーンには ca、ca1、および ca2 が含まれることになります。
+.nf
+\f3
+.fl
+keytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1.cert
+.fl
+\fP
+.fi
+.TP 3
+\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+鍵のペア (公開鍵および関連する非公開鍵) を生成します。公開鍵は X.509 v3 自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと非公開鍵は、\f2alias\fP で特定される新しいキーストアエントリに格納されます。
+.LP
+\f2keyalg\fP は鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fP は生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。
+.LP
+\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の issuer フィールドと subject フィールドとして使う X.500 識別名を指定します。 コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。
+.LP
+\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。
+.LP
+\f2startdate\fP には、証明書の発行時刻を指定します。これは、X.509 証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。
.LP
-CSR 荐惹悟肴絮 (CA) 篆＜сCA 荐惹梧羆 (絽吾ゃ潟) 茯荐若荐惹吾障荐惹吾с若潟菴障 荐惹吾障荐惹吾с若潟若鴻√√荐惹吾с若 ( 1 ゃ綏援讐荐惹吾罕) 臀篏帥障
+オプションの値は、次の 2 つの形式のいずれかで設定できます。
+.RS 3
+.TP 3
+1.
+([+\-]\f2nnn\fP[ymdHMS])+
+.TP 3
+2.
+[yyyy/mm/dd] [HH:MM:SS]
+.RE
+.LP
+最初の形式では、発行時刻は、指定される値だけ現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号 (「+」) は時間が進むことを、マイナス記号 (「\-」) は時間が戻ることを意味しています。移る時間は \f2nnn\fP で、単位は年、月、日、時間、分、または秒です (それぞれ、1 文字の「y」、「m」、「d」、「H」、「M」、または「S」で示されている)。下位の各値で \f2java.util.GregorianCalendar.add(int field, int amount)\fP メソッドを使うことで、発行時刻の追加の値が左から右へ計算されます。たとえば、 \f2「\-startdate \-1y+1m\-1d」\fPと指定すると、開始時刻は次のようになります。
+.nf
+\f3
+.fl
+ Calendar c = new GregorianCalendar();
+.fl
+ c.add(Calendar.YEAR, \-1);
+.fl
+ c.add(Calendar.MONTH, 1);
+.fl
+ c.add(Calendar.DATE, \-1);
+.fl
+ return c.getTime()
+.fl
+\fP
+.fi
+.LP
+2 番目の形式では、ユーザーは、年/月/日と時間:分:秒の 2 つの部分で厳密な開始時刻を設定します (地元の時間帯を使用)。ユーザーは、1 つの部分だけを指定できます。これは、もう 1 つの部分は現在の日付 (または時刻) と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります (短い場合は 0 で埋める)。日付と時刻の両方が指定された状態で、2 つの部分の間に空白文字が 1 つ (1 つだけ) あります。時間は常に 24 時間形式で指定してください。
+.LP
+オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で 1 回指定できます。
+.LP
+\f2valDays\fP には、証明書の有効日数を指定します ( \f2\-startdate\fP で指定された日付、または \f2\-startdate\fP が指定されていない場合は現在の日付から始まる)。
.LP
-\f2alias\fP ∫ｄ泣 X.500 茘ュPKCS#10 荐惹梧羆篏篏帥障泣若鴻√с鴻若ｃ篆茘激с泣≪祉鴻鴻若箴綽荀障潟潟茵 \f2keypass\fP 絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
+このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\fP を使用することをお勧めします。
+.TP 3
+\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+秘密鍵を生成し、それを新しい \f2KeyStore.SecretKeyEntry\fP (\f2alias\fP で特定される) 内に格納します。
+.LP
+\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。
+.TP 3
+\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+ファイル \f2cert_file\fP から証明書または証明書チェーン (証明書チェーンの場合は、PKCS#7 形式の応答または一連の X.509 証明書で提供されるもの) を読み込み、\f2alias\fP によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または証明書チェーンを読み込みます。
+.LP
+\f3keytool\fP では、X.509 v1、v2、v3 の証明書、および、PKCS#7 形式の証明書から構成されている PKCS#7 形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式 (Base64 符号化とも呼ばれる) のどちらかで提供する必要があります。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了しなければなりません。
.LP
-\f2sigalg\fP CSR 臀峨篁篏帥≪眼冴絎障
+証明書のインポートには、次の 2 つの目的があります。
+.RS 3
+.TP 3
+1.
+信頼できる証明書のリストに証明書を追加する
+.TP 3
+2.
+CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする
+.RE
+.LP
+どちらの種類のインポートを行うかは、 \f2\-alias\fP オプションの値によって指定します。
+.RS 3
+.TP 3
+1.
+\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内にすでに存在していてはいけません。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。
+.TP 3
+2.
+.LP
+\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。
+.RE
+\f3新しい信頼できる証明書のインポート\fP
+.LP
+\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼のチェーンの構築を試みます。
+.LP
+\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できるすなわち cacerts という名前のファイルに含まれる証明書のチェーンと見なされます。
+.LP
+\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかのなんらかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
+\f3証明応答のインポート\fP
+.LP
+「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\-trustcacerts オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。
.LP
-CSR ＜ゃ \f2certreq_file\fP 主障＜ゃ絎翫罔羣阪 CSR 阪障
+証明応答が信頼できるかどうかを決定する方法は次のとおりです。
+.RS 3
+.TP 2
+o
+\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。
+.TP 2
+o
+\f3証明応答が PKCS#7 形式の証明書チェーンまたは一連の X.509 証明書である場合\fP、チェーンは、ユーザーの証明書が最初に、0 以上の CA 証明書がその次にくるように並べられます。チェーンが自己署名のルート CA 証明書で終わり、 \f2\-trustcacerts\fP オプションが指定されている場合、\f3keytool\fP は、その証明書と、キーストア内または「cacerts」キーストアファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルート CA 証明書で終わっておらず、 \f2\-trustcacerts\fP オプションが指定されている場合、\f3keytool\fP は、キーストア内または「cacerts」キーストアファイル内の信頼できる証明書から自己署名のルート CA 証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、 \f2\-noprompt\fP オプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。
+.RE
+.LP
+証明書応答内の公開鍵が \f2alias\fP の下にすでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを新しい証明書チェーンで置き換えることができるのは、有効な \f2keypass\fP、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
+.LP
+このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。
+.TP 3
+\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+ソースキーストアからターゲットキーストアへ、単一のエントリまたはすべてのエントリをインポートします。
+.LP
+\f2srcalias\fP オプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲットキーストアにインポートします。\f2destalias\fP 経由でターゲット別名が指定されなかった場合、\f2srcalias\fP がターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\f2srckeypass\fP を使ってそのエントリが回復されます。\f2srckeypass\fP が指定されなかった場合、\f3keytool\fP は \f2srcstorepass\fP を使ってそのエントリを回復しようとします。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットエントリは \f2destkeypass\fP によって保護されます。\f2destkeypass\fP が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。
+.LP
+\f2srcalias\fP オプションが指定されなかった場合、ソースキーストア内のすべてのエントリがターゲットキーストア内にインポートされます。各ターゲットエントリは対応するソースエントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\f2srcstorepass\fP を使ってそのエントリが回復されます。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。
+.LP
+ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。
.LP
-CA 綽膈ゃ潟若\f2importcert\fP 潟潟篏帥障
+\f2\-noprompt\fP を指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。
+.TP 3
+\-printcertreq {\-file file}
+.LP
+PKCS #10 形式の証明書要求の内容を出力します。この要求は、keytool \-certreq コマンドで生成できます。このコマンドは、file から要求を読み込みます。file が省略されている場合は、標準入力から読み込みます。
+.RE
+
+.LP
+.SS
+データのエクスポート
+.LP
+.RS 3
+.TP 3
+\-certreq {\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+PKCS#10 形式を使って証明書署名要求 (CSR) を生成します。
+.LP
+CSR は、証明書発行局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明書チェーンを送り返します。 この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。
+.LP
+\f2alias\fP に関連付けられた非公開鍵は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。dname が指定されている場合は、それが CSR で主体として使用されます。それ以外の場合は、別名に関連付けられた X.500 識別名が使用されます。
+.LP
+\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。
+.LP
+CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。
+.LP
+CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。
.TP 3
\-exportcert {\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP ∫ｄ荐惹吾 (若鴻≪) 茯粋昭帥＜ゃ \f2cert_file\fP 主障
+\f2alias\fP に関連付けられた証明書を (キーストアから) 読み込み、ファイル \f2cert_file\fP に格納します。
.LP
-＜ゃ絎翫罔羣阪荐惹吾阪障
+ファイルが指定されていない場合は、標準出力に証明書が出力されます。
.LP
-сゃ膃垸劫荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\-rfc オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
.LP
-\f2alias\fP 篆♂若с荐惹吾с翫荅峨荐惹吾阪障篁ュ翫\f2alias\fP ∫ｄ荐惹吾с若潟ら泣潟с障翫с若喝荐惹吾菴障荐惹吾\f2alias\fP ｃ茵潟ｃｃ若泣茯荐若荐惹吾с
+\f2alias\fP が、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\f2alias\fP は、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\f2alias\fP によって表されるエンティティーの公開鍵を認証する証明書です。
.LP
-潟潟篁ュ若鴻с \f2\-export\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-exportcert\fP 篏睡с障
+このコマンドは、以前のリリースでは \f2\-export\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-exportcert\fP を使用することをお勧めします。
.RE
.LP
-.RE
.SS
-若帥茵腓
-.LP
-.RS 3
-
+データの表示
.LP
.RS 3
.TP 3
\-list {\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP х劫若鴻≪潟絎鴻 (罔羣阪) 阪障ュ絎翫若鴻√篏絎鴻茵腓冴障
+\f2alias\fP で特定されるキーストアエントリの内容を (標準出力に) 出力します。別名が指定されていない場合は、キーストア全体の内容が表示されます。
.LP
-潟潟с荐惹吾 MD5 ｃ潟若潟茵腓冴障\f2\-v\fP 激с潟絎翫肴激≪垩≦宍罘純篁宴篋咲茯с綵√ц┝吾茵腓冴障\f2\-rfc\fP 激с潟絎翫阪順垸劫ц┝吾絎鴻茵腓冴障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+このコマンドは、デフォルトでは証明書の SHA1 フィンガープリントを表示します。 \f2\-v\fP オプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。 \f2\-rfc\fP オプションが指定されている場合は、出力可能符号化方式で証明書の内容が表示されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
.LP
-\f2\-v\fP 激с潟 \f2\-rfc\fP 激с潟絎с障
+\f2\-v\fP オプションと \f2\-rfc\fP オプションを同時に指定することはできません。
.TP 3
-\-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
+\-printcert {\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}
+.LP
+ファイル \f2cert_file\fP、\f2host:port\fP にある SSL サーバー、または署名付き JAR ファイル \f2JAR_file\fP ( \f2\-jarfile\fP オプションを指定) から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準の HTTPS ポート 443 が想定されます。 \f2\-sslserver\fP および \f2\-file\fP オプションを同時に指定することはできません。同時に指定すると、エラーが報告されます。オプションが指定されていない場合は、標準入力から証明書を読み込みます。
.LP
-＜ゃ
+\f2\-rfc\fP が指定されている場合、keytool は、インターネット RFC 1421 標準で定義されているように、PEM モードで証明書を出力します。
+.LP
+ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネット RFC 1421 標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。
.LP
-ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+SSL サーバーがファイアウォールの背後にある場合は、 \f2\-J\-Dhttps.proxyHost=proxyhost\fP と \f2\-J\-Dhttps.proxyPort=proxyport\fP をコマンド行で指定して、プロキシトンネリングを使用できます。詳細は、
+.na
+\f2「JSSE リファレンスガイド」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。
.LP
-羈:潟潟若鴻≪≫篏障
+\f3注\fP: このオプションはキーストアとは関係なく使用できます。
+.TP 3
+\-printcrl \-file crl_ {\-v}
+.LP
+ファイル \f2crl_file\fP から証明書の取り消しリスト (CRL) を読み込みます。
+.LP
+証明書の取り消しリスト (CRL) は、デジタル証明書を発行した証明書発行局 (CA) によって取り消されたデジタル証明書のリストです。CA は、\f2crl_file\fP を生成します。
+.LP
+\f3注\fP: このオプションはキーストアとは関係なく使用できます。
.RE
.LP
-.RE
.SS
-若鴻≪膊∞
-.LP
-.RS 3
-
+キーストアの管理
.LP
.RS 3
.TP 3
\-storepasswd [\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
.LP
-若鴻≪絎鴻翫с篆茘激篏帥鴻若紊眼障\f2new_storepass\fP 違鴻若絎障 \f2new_storepass\fP 6 絖篁ヤс違障
+キーストアの内容の整合性を保護するために使うパスワードを変更します。\f2new_storepass\fP には、新しいパスワードを指定します。new_storepass は、6 文字以上でなければなりません。
.TP 3
\-keypasswd {\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
.LP
-\f2alias\fP ｃ劫/腱絲泣篆茘激鴻若\f2old_keypass\fP \f2new_keypass\fP 紊眼障 \f2new_keypass\fP 6 絖篁ヤс違障
+\f2alias\fP によって特定される非公開/秘密鍵を保護するためのパスワードを、\f2old_keypass\fP から \f2new_keypass\fP に変更します。new_keypass は、6 文字以上でなければなりません。
.LP
-潟潟茵 \f2\-keypass\fP 激с潟絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
+コマンド行で \f2\-keypass\fP オプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。
.LP
-潟潟茵 \f2\-new\fP 激с潟絎ｃ翫違鴻若ュ羆障
+コマンド行で \f2\-new\fP オプションを指定しなかった場合は、新しいパスワードの入力を求められます。
.TP 3
\-delete [\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP ｃ劫潟若鴻≪ゃ障潟潟茵уュ絎ｃ翫ュュ羆障
+\f2alias\fP によって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。
.TP 3
\-changealias {\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
.LP
-絎 \f2alias\fP 違ュ \f2destalias\fP 吾√若鴻≪潟腱糸障帥若蚊ュ絎ｃ翫潟潟ュ羆障潟潟鴻若т茘激翫\-keypass激с括宴с鴻若絎с障泣鴻若絎ｃ翫\f2storepass\fP (絎翫) 障荅帥障荅帥紊掩若吟若鴻若ュ羆障
+指定された \f2alias\fP から新しい別名 \f2destalias\fP へ、既存のキーストアエントリを移動します。ターゲット別名が指定されなかった場合、このコマンドはその入力を求めます。元のエントリがエントリパスワードで保護されていた場合、「\-keypass」オプション経由でそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\f2storepass\fP (指定された場合) がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。
.RE
.LP
-.RE
.SS
-茵腓
-.LP
-.RS 3
-
+ヘルプの表示
.LP
.RS 3
.TP 3
\-help
.LP
-堺潟潟激с潟筝荀с茵腓冴障
+基本的なコマンドとそのオプションの一覧を表示します。
+.LP
+特定のコマンドの詳細については、次のように入力してください。 \f2command_name\fP はコマンドの名前です。
+.nf
+\f3
+.fl
+ keytool \-\fP\f4command_name\fP\f3 \-help
+.fl
+\fP
+.fi
.RE
.LP
-.RE
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-с泣≪割拭若с潟ｃｃ若荐惹吾膊∞若鴻≪篏翫箴腓冴障
+ここでは、自分の鍵のペアおよび信頼できるエンティティーからの証明書を管理するためのキーストアを作成する場合を例として示します。
.LP
.SS
-泣≪
-.LP
-.RS 3
-
+鍵のペアの生成
.LP
.LP
-障若鴻≪篏泣≪綽荀障罨＜腓冴絎茵潟潟箴с
+まず、キーストアを作成して鍵のペアを生成する必要があります。次に示すのは、実行するコマンドの例です。
.LP
.nf
\f3
.fl
- keytool \-genkeypair \-dname "cn=Mark Jones, ou=JavaSoft, o=Sun, c=US"
+ keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US"
.fl
\-alias business \-keypass kpi135 \-keystore /working/mykeystore
.fl
@@ -485,16 +1096,16 @@
.LP
.LP
-羈:潟潟 1 茵ュ違障箴ц域ュ茯帥с
+注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。
.LP
.LP
-箴сworking ｃ mykeystore 若鴻≪篏 (若鴻≪障絖篁絎)篏若鴻≪鴻若 ab987c 蚊綵障泣泣≪絲上潟ｃｃ若茘ュ腱違Mark Jones腟膵篏JavaSoft腟膵Sun2 絖順垩USс泣泣泣ゃ冴＜ 1024 с泣篏 DSA 窮≪眼冴篏睡障
+この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアにパスワード ab987c を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
.LP
.LP
-潟潟泣茘ュ宴綏援讐荐惹 ( SHA1withDSA 臀峨≪眼冴篏睡) 篏障荐惹吾号 180 ャс 荐惹吾ュbusinessх劫若鴻≪潟泣∫ｄ障泣鴻若kpi135蚊綵障
+このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵にはパスワード「kpi135」が割り当てられます。
.LP
.LP
-激с潟ゃ篏帥翫筝腓冴潟潟紊ус障絎激с潟 1 ゃ絎潟潟絎茵純с ゃゃ激с潟с激с潟絎違ゃ篏帥綽荀ゃゃュ羆障違罨＜ュс障
+オプションのデフォルト値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。 デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。
.LP
.nf
\f3
@@ -505,19 +1116,17 @@
.fi
.LP
-翫mykey ュс若鴻≪潟篏違泣≪ 90 ラ鴻荐惹吾潟主障潟若ｃ .keystore 若鴻≪臀障若鴻≪障絖翫篏障茘ュ宴若鴻≪鴻若渇泣鴻若ゃュ羆障
.LP
-篁ヤс激с潟絎 \f2\-genkeypair\fP 潟潟絎茵箴腓冴障 宴ュ羆翫腓冴 \f2\-genkeypair\fP 潟潟ゃュ障 (違泣鴻若 kpi135 絎)
-.LP
-.RE
-.SS
-荐惹悟肴絮絲障臀峨篁荐惹吾荀羆
-.LP
-.RS 3
-
+この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。
.LP
.LP
-憝鴻ф1 綏援讐荐惹吾с荐惹吾荐惹悟肴絮 (CA) 臀峨篁違祉若吟若荐惹吾篆♂若с醇с蕭障CA 臀峨緇障荐惹悟讐荀羆 (CSR) 障 違罨＜障
+以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、非公開鍵のパスワードには kpi135 と指定)。
+.LP
+.SS
+証明書発行局に対する署名付き証明書の要求
+.LP
+.LP
+現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に証明書発行局 (CA) の署名が付いていれば、ほかのユーザーから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。
.LP
.nf
\f3
@@ -528,41 +1137,39 @@
.fi
.LP
-CSR (ュmykeyｃ劫潟ｃｃ若 CSR) 篏MarkJ.csr ＜ゃ臀障＜ゃVeriSign CA 冴障 CA 荀羆 (絽吾ゃ潟) 茯荐若荀羆泣茯荐若臀峨篁荐惹吾菴障翫ｃCA 荐惹吾с若潟菴障 荐惹吾с若潟с荐惹吾с若喝臀峨泣茯荐若障
-.RE
+.LP
+CSR (デフォルト別名「mykey」によって特定されるエンティティーの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。
+.LP
.SS
-CA 荐惹吾ゃ潟若
-.LP
-.RS 3
-
+CA からの証明書のインポート
.LP
.LP
-篏綏援讐荐惹吾荐惹吾с若潟х舟綽荀障 荐惹吾с若潟с荐惹吾若CA 莎欠鴻с若喝罨＜荐惹吾臀峨泣茯荐若障
+作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CA を起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。
.LP
.LP
-CA 荐惹綽膈ゃ潟若若鴻≪(importcert 潟潟 ц) \f2cacerts\fP 若鴻≪＜ゃ 1 や札筝篆♂若с荐惹吾綽荀障
+CA からの証明応答をインポートするには、キーストアか、 \f2cacerts\fP キーストアファイル (importcert コマンドで説明) 内に 1 つ以上の「信頼できる証明書」がある必要があります。
.LP
.RS 3
.TP 2
o
-荐惹綽膈荐惹吾с若潟翫с若潟荐惹 ( CA 泣茯荐若若CA 荐惹) 綽荀
+証明応答が証明書チェーンの場合は、チェーンのトップの証明書 (その CA の公開鍵を認証する「ルート」CA の証明書) だけを必要とする
.TP 2
o
-荐惹綽膈筝荐惹吾翫荐惹吾臀峨 CA 肴荐惹吾綽荀с荐惹吾綏援讐翫荐惹吾臀峨荐惹吾綽荀 綏援讐若CA 荐惹吾障с荐惹吾綽荀
+証明応答が単一の証明書の場合は、証明書に署名した CA の発行用の証明書が必要で、その証明書が自己署名されない場合は、さらにその証明書の署名者用の証明書を必要とする。 このようにして自己署名される「ルート」CA の証明書までそれぞれ証明書を必要とする
.RE
.LP
.LP
-cacerts 若鴻≪＜ゃ5 ゃ VeriSign 若 CA 荐惹吾倶у肴激сVeriSign 荐惹吾篆♂若с荐惹吾若鴻√ゃ潟若綽荀障祉 CA 絲障臀峨篁荐惹吾荀羆 CA 泣茯荐若荐惹吾cacerts 障菴遵翫荅峨 CA 荐惹吾篆♂若с荐惹吾ゃ潟若綽荀障
+cacerts キーストアファイルは、いくつかの VeriSign ルート CA 証明書を含んだ状態で出荷されているので、VeriSign の証明書を、信頼できる証明書としてキーストア内にインポートする必要はないかもしれません。ただし、ほかの CA に対して署名付き証明書を要求していて、この CA の公開鍵を認証する証明書が、cacerts にまだ追加されていない場合は、該当する CA からの証明書を、「信頼できる証明書」としてインポートする必要があります。
.LP
.LP
-絽吾CA 荐惹吾綏援讐荐惹吾障祉 CA ｃ臀峨荐惹吾с (緇翫荅峨祉 CA 泣茯荐若荐惹吾綽荀)違ABC 篌罐 CA 障 CA 泣茯荐若綏援讐荐惹吾 ABCCA.cer ＜ゃABC ユ障
+通常、CA からの証明書は、自己署名証明書、またはほかの CA によって署名された証明書です (後者の場合は、該当するほかの CA の公開鍵を認証する証明書も必要)。たとえば、ABC という企業が CA だとします。このとき、この CA の公開鍵を認証する自己署名証明書と考えられる ABCCA.cer という名前のファイルを、ABC から入手したとします。
.LP
.LP
-篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障障荐惹吾絎鴻茵腓冴 (\f3keytool\fP \f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f3keytool\fP \f2\-importcert\fP 潟潟篏睡)茵腓冴荐惹吾ｃ潟若潟緇ｃ潟若潟筝眼腆肴障荐惹吾篆＜篋榊ｇ機篋榊腓冴 (障絎泣吾ｃ腓冴) ｃ潟若潟筝潟潟ц；腓冴ｃ潟若潟罸莠障ｃ潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙ｃ臀峨鴻篆♂若障
+「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。まず、証明書の内容を表示し (\f3keytool\fP \f2\-printcert\fP コマンドを使用するか、または \-noprompt オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。
.LP
.LP
-ABCCA.cer 鴻荐惹吾篆♂若翫荐惹吾若鴻≪菴遵с障 違罨＜障
+ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。
.LP
.nf
\f3
@@ -573,19 +1180,17 @@
.fi
.LP
-ABCCA.cer ＜ゃ若帥篆♂若с荐惹吾潟若鴻√篏荅峨潟 abc ュ蚊綵障
-.RE
+.LP
+ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。
+.LP
.SS
-CA 荐惹綽膈ゃ潟若
-.LP
-.RS 3
-
+CA からの証明応答のインポート
.LP
.LP
-荐惹悟讐荀羆阪 CA 泣茯荐若荐惹吾ゃ潟若 (障腮荐惹吾с cacerts ＜ゃ絖翫)荐惹綽膈ゃ潟若綏援讐荐惹吾荐惹吾с若潟х舟с障荐惹吾с若潟CA 綽膈с若潟翫荐惹悟讐荀羆絲障綽膈 CA 菴荐惹吾с若潟с 障CA 綽膈筝荐惹吾翫荐惹綽膈ゃ潟若若鴻√障 cacerts 若鴻≪＜ゃс絖篆♂若с荐惹吾篏帥ｃ罕膀荐惹吾с若潟с
+証明書署名要求の提出先の CA の公開鍵を認証する証明書をインポートしたあとは (または同種の証明書がすでに cacerts ファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。この証明書チェーンは、CA の応答がチェーンの場合、証明書署名要求に対する応答として CA から送り返された証明書チェーンです。 また、CA の応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または cacerts キーストアファイル内にすでに存在する信頼できる証明書とを使って構築した証明書チェーンです。
.LP
.LP
-違荐惹悟讐荀羆 VeriSign 篆＜障菴荐惹吾 VSMarkJ.cer 罨＜綽膈ゃ潟若с障
+たとえば、証明書署名要求を VeriSign に送信したとします。送り返された証明書の名前が VSMarkJ.cer だとすると、次のようにして応答をインポートできます。
.LP
.nf
\f3
@@ -594,18 +1199,16 @@
.fl
\fP
.fi
-.RE
.LP
.SS
-泣茯荐若荐惹吾鴻若
+公開鍵を認証する証明書のエクスポート
+.LP
.LP
-.RS 3
-
+たとえば、jarsigner(1) ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。
.LP
-違jarsigner(1) 篏帥ｃ Java ARchive (JAR) ＜ゃ臀峨障 JAR ＜ゃゃ≪潟ｃ篏帥障ゃ≪潟眼с臀峨茯荐若障
.LP
-ゃ≪潟臀峨茯荐若号 1 ゃ障泣荐惹吾篆♂若с潟ゃ≪潟若鴻≪ゃ潟若号障荐惹吾鴻若ゃ≪潟箴障違罨＜荐惹吾 \f2MJ.cer\fP ＜ゃ潟若障 潟mykeyュ篏帥障
+クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。このエントリには「mykey」という別名が使われているとします。
.LP
.nf
\f3
@@ -616,24 +1219,22 @@
.fi
.LP
-荐惹吾臀峨篁 JAR ＜ゃユゃ≪潟\f3jarsigner\fP 若篏帥ｃ臀峨茯荐若с障
-.RE
+.LP
+証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。
+.LP
.SS
-若鴻≪ゃ潟若
-.LP
-.RS 3
-
+キーストアのインポート
.LP
.LP
-潟潟importkeystore篏帥違若鴻≪篏ャ若鴻√ゃ潟若с障 泣荐惹吾ｃ純若鴻若鴻√鴻潟筝潟潟篏帥ｃ帥若蚊若鴻√ゃ潟若潟障潟潟篏帥違違帥ゃ若鴻√障潟ゃ潟若с障ゃ潟若帥若蚊若鴻√違潟鴻ュ (腱絲泣泣翫) 篆茘欠鴻若＜障純若鴻若鴻√泣腱絲泣緇馹榊翫\f3keytool\fP 若吟若鴻若ュ羆障潟潟ュ茲罎冴若吟若違ュュ羆障 若吟若違ュ絎膣√ュ筝吾 \f3keytool\fP 荐怨с障
+コマンド「importkeystore」を使えば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使ってターゲットキーストア内にインポートされることを意味します。このコマンドを使えば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲットキーストア内の新しいエントリはすべて、元と同じ別名および (秘密鍵や非公開鍵の場合は) 保護用パスワードを持ちます。ソースキーストア内の非公開鍵や秘密鍵の回復時に問題が発生した場合、\f3keytool\fP はユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを \f3keytool\fP に許可することもできます。
.LP
.LP
-違絽吾 JKS 帥ゃ若鴻 key.jks 潟 PKCS #11 帥ゃ若с≪若鴻若鴻√ゃ潟若罨＜潟潟篏睡с障
+たとえば、通常の JKS タイプのキーストア key.jks 内のエントリを PKCS #11 タイプのハードウェアベースのキーストア内にインポートするには、次のコマンドを使用できます。
.LP
.nf
\f3
.fl
-keytool \-importkeystore
+ keytool \-importkeystore
.fl
\-srckeystore key.jks \-destkeystore NONE
.fl
@@ -646,12 +1247,12 @@
.LP
.LP
-障importkeystore 潟潟篏帥違純若鴻若鴻√筝潟帥若蚊若鴻≪ゃ潟若с障翫筝荐箴хず激с潟ゃ潟若絲乗院ュ絎綽荀障srcalias 激с潟絎翫帥若蚊ュ潟潟茵絎с祉腱絲/泣篆茘欠鴻若帥若蚊篆茘欠鴻若絎с障違潟障ｃ頫腓冴 \f3keytool\fP 潟潟肴с障\f3keytool\fP 潟潟鴻＜ゃ絽吾箴水с 罨＜箴腓冴障
+また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。そうすれば、プロンプトのまったく表示されない \f3keytool\fP コマンドを発行できます。これは、\f3keytool\fP コマンドをスクリプトファイルに含める際に非常に便利です。次に例を示します。
.LP
.nf
\f3
.fl
-keytool \-importkeystore
+ keytool \-importkeystore
.fl
\-srckeystore key.jks \-destkeystore NONE
.fl
@@ -667,55 +1268,74 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.SH "茯茘"
-.LP
.LP
.SS
-若鴻
+一般的な SSL サーバー用の証明書の生成
+.LP
+.LP
+次に、3 つのエンティティー、つまりルート CA (root)、中間 CA (ca)、および SSL サーバー (server) 用の鍵ペアと証明書を生成する keytool コマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとして RSA を指定することをお勧めします。
.LP
-.RS 3
+.nf
+\f3
+.fl
+keytool \-genkeypair \-keystore root.jks \-alias root \-ext bc:c
+.fl
+keytool \-genkeypair \-keystore ca.jks \-alias ca \-ext bc:c
+.fl
+keytool \-genkeypair \-keystore server.jks \-alias server
+.fl
+
+.fl
+keytool \-keystore root.jks \-alias root \-exportcert \-rfc > root.pem
+.fl
+
+.fl
+keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore ca.jks \-certreq \-alias ca | keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore root.jks \-gencert \-alias root \-ext BC=0 \-rfc > ca.pem
+.fl
+keytool \-keystore ca.jks \-importcert \-alias ca \-file ca.pem
+.fl
+
+.fl
+keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore server.jks \-certreq \-alias server | keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore ca.jks \-gencert \-alias ca \-ext ku:c=dig,kE \-rfc > server.pem
+.fl
+cat root.pem ca.pem server.pem | keytool \-keystore server.jks \-importcert \-alias server
+.fl
+\fP
+.fi
.LP
-若鴻≪垸泣荐惹吾主罘純с
-.RE
+.SH "用語と警告"
+.LP
+.SS
+KeyStore
+.LP
+.LP
+キーストアは、暗号化の鍵と証明書を格納するための機能です。
+.LP
.RS 3
.TP 2
o
-.TP 2
-o
-\f3若鴻≪潟\fP
-.RS 3
-
+\f3キーストアのエントリ\fP
.LP
-若鴻≪違帥ゃ潟с障\f3keytool\fP сｃ膀蚊綺潟帥ゃ罨＜ 2 ゃс
+キーストアには異なるタイプのエントリを含めることができます。\f3keytool\fP でもっとも適用範囲の広いエントリタイプは、次の 2 つです。
.RS 3
.TP 3
1.
-\f3泣潟\fP \- 潟絽吾荀垸泣宴篆障宴荐怨≪祉鴻蚊篆茘激綵≪ф主障筝腮潟主泣腱絲泣絲上泣荐惹吾с若潟篌眼泣с\f3keytool\fP 筝≧鴻帥ゃ潟с絲障\f3jarsigner\fP 若緇帥ゃ潟ゃ障泣∫ｄ荐惹吾с若潟帥障
+\f3鍵のエントリ\fP \- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。 一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う非公開鍵です。\f3keytool\fP がこの両方のタイプのエントリを処理できるのに対し、\f3jarsigner\fP ツールは後者のタイプのエントリ、つまり非公開鍵とそれに関連付けられた証明書チェーンのみを処理します。
.TP 3
2.
-\f3篆♂若с荐惹吾潟\fP \- 潟膃筝笈┝吾 1 ゅс障荐惹吾篆♂若с荐惹吾若違障 荐惹後泣荐惹吾Subject() ｃ劫≪ゃ潟ｃｃ若掩ャс若鴻≪篆♂若с荐惹吾肴荐惹吾臀峨篁ｃ絎鴻篆荐若障
-.RE
-
-.LP
+\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を 1 つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。 それは、証明書内の公開鍵が、証明書の「Subject」(所有者) によって特定されるアイデンティティーに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。
.RE
.TP 2
o
-\f3若鴻≪ュ\fP
-.RS 3
+\f3キーストアの別名\fP
.LP
-若鴻≪鴻潟 (泣割拭若с荐惹) 筝ュ篁≪祉鴻障
-.LP
+キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。
.LP
-ュ絎\-genseckey 潟潟篏帥ｃ腱絲泣\-genkeypair 潟潟篏帥ｃ泣 (泣) \-importcert 潟潟篏帥ｃ荐惹吾障荐惹吾с若潟篆♂若с荐惹吾鴻菴遵劫潟ｃｃ若若鴻≪菴遵翫с篁ュ\f3keytool\fP 潟潟с潟ｃｃ若с翫絎ュ篏睡綽荀障
-.LP
+別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明書チェーンを信頼できる証明書のリストに追加したりするなど、特定のエンティティーをキーストアに追加する場合です。これ以後、\f3keytool\fP コマンドでエンティティーを参照する場合は、このときに指定した別名を使用する必要があります。
.LP
-違\f2duke\fP ュ篏帥ｃ違泣泣≪泣綏援讐荐惹 (荐惹吾с若潟) с障 翫罨＜潟潟絎茵障
-.LP
+たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明書チェーン」を参照) でラップするとします。 この場合は、次のコマンドを実行します。
.nf
\f3
.fl
@@ -723,9 +1343,8 @@
.fl
\fP
.fi
-
.LP
-с鴻若 dukekeypasswd 絎障 篁ュュ \f2duke\fP ∫ｄ泣≪祉鴻潟潟絎茵鴻若綽荀障duke 泣鴻若紊眼罨＜潟潟絎茵障
+ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 duke 連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。 duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。
.nf
\f3
.fl
@@ -733,49 +1352,37 @@
.fl
\fP
.fi
-
-.LP
-鴻若dukekeypasswd newpass 紊眼障
.LP
-羈 \-鴻翫障絎сｃ激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с綽荀鴻若激с潟潟潟茵ф絎ｃ翫鴻若ュ羆障
+パスワードが、dukekeypasswd から newpass に変更されます。
.LP
-.RE
+注: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
.TP 2
o
-\f3若鴻≪絎茖\fP
-.RS 3
-\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
+\f3キーストアの実装\fP
.LP
-憜\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若若鴻≪絎茖篏睡障\f2KeyStore\fP public 篏睡純сJDK 若吟若 \f2KeyStore\fP 篏帥ｃ祉祉ャｃ若≪宴若激с潟篏с障
-.LP
+\f2KeyStore\fP クラス ( \f2java.security\fP パッケージで提供される) には、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
.LP
-若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪＜ゃ絎茖障絎茖с泣ャ鴻若ｃ篆茘激若鴻√篏翫с (泣ャ) 鴻若ｃ篆茘激障
-.LP
+現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。 \f2KeyStore\fP は public として使用可能なので、JDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。
.LP
-若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface ＜純絎臂障 ＜純ゃ絎茖違障сゃJava Security API ｃ≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сｃ若鴻≪絎茖箴
-.na
-\f2Java(TM) 垸≪若ｃ主ゃ絎茖号\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
-.LP
+キーストアには、Oracle が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。
.LP
-≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance ＜＜純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√/腱絲泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
-.LP
+キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが、「プロバイダ」が実装する必要のある Service Provider Interface のメソッドを定義しています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、
+.na
+\f2「Java(TM) 暗号化アーキテクチャー用プロバイダの実装方法」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
.LP
-\f3keytool\fP 篁紙＜ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝＜若鴻≪贋＜ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
-.LP
-.LP
-\f3keytool\fP \f3jarsigner\fP 翫\f2\-storetype\fP 激с潟篏帥ｃ潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP翫若鴻≪＜ャ若ｃ若鴻≪帥ゃ絎с障
-.LP
+アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。 キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。
.LP
-若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャｃ若ｃ若＜ゃф絎 \f2keystore.type\fP ｃ若ゃ冴ャ若鴻≪絎茖御障祉ャｃ若ｃ若＜ゃ\f2java.security\fP с祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
+\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
.LP
+\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fPの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。
.LP
-若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
-.LP
+キーストアのタイプを明示的に指定しない場合、keytool、jarsigner、および policytool の各ツールは、セキュリティープロパティーファイル内で指定された \f2keystore.type\fP プロパティーの値に基づいてキーストアの実装を選択します。セキュリティープロパティーファイルは、\f2java.security\fP という名前でセキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
.LP
-\f2KeyStore\fP 鴻с \f2getDefaultType\fP static ＜純絎臂≪宴若激с潟≪＜純篏帥 \f2keystore.type\fP ｃ若ゃ緇с障罨＜潟若若鴻≪帥ゃ (\f2keystore.type\fP ｃ若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
+各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
.LP
+\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ ( \f2keystore.type\fP プロパティーで指定されたタイプ) のインスタンスを生成します。
.nf
\f3
.fl
@@ -783,11 +1390,8 @@
.fl
\fP
.fi
-
.LP
-.LP
-若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャｃ若ｃ若＜ゃ罨＜茵ｃ絎障
-.LP
+デフォルトのキーストアタイプは JKS (Oracle が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。
.nf
\f3
.fl
@@ -795,14 +1399,10 @@
.fl
\fP
.fi
-
-.LP
.LP
-若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障
-.LP
+各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。
.LP
-違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨＜紊眼障
-.LP
+たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
.nf
\f3
.fl
@@ -810,561 +1410,163 @@
.fl
\fP
.fi
+.LP
+注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
+.RE
.LP
-羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
-.RE
-.RE
.SS
-荐惹
+証明書
.LP
-.RS 3
-
-.LP
-\f3荐惹\fP (\f3笈┝\fP若) 潟ｃｃ (肴) 吾帥臀峨篁吾с 荐惹吾祉潟ｃｃ (臀峨) (潟篁) 劫ャゃｃ吾障
-.RE
+\f3証明書\fP (\f3公開鍵証明書\fPとも呼ぶ) とは、あるエンティティー (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティー (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。
.RS 3
.TP 2
o
-.TP 2
-o
-\f3荐惹吾茯\fP
-.RS 3
-
-.LP
+\f3証明書の用語\fP
.RS 3
.TP 3
-
-泣劫潟ｃｃ若∫ｄ違с 泣荅峨潟ｃｃ若篆♂若с≫ゅ荀鴻篋冴絲障潟с泣臀峨罎荐若篏帥障
+公開鍵
+.LP
+公開鍵は、特定のエンティティーに関連付けられた数です。公開鍵は、該当するエンティティーとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。
.TP 3
-吾帥臀峨
-若帥\f2吾帥臀峨\fP若帥潟ｃｃ若≪ゃ潟ｃｃ若潟ｃｃ若若帥絎鴻ゃャｃ荐惹臀峨主障潟ｃｃ若泣篏帥ｃ若帥臀峨篁若帥初筝純障
+デジタル署名
+.LP
+データが「デジタル署名」されると、そのデータは、エンティティーの「アイデンティティー」と、そのエンティティーがデータの内容について知っていることを証明する署名とともに格納されます。エンティティーの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。
.TP 3
-≪ゃ潟ｃｃ
-潟ｃｃ若劫∝ャ号с激鴻ｃ泣≪ゃ潟ｃｃ若障 泣祉Unix UID 糸＜若≪鴻X.509 茘ュ障障≪ゃ潟ｃｃ若с障
+アイデンティティー
+.LP
+エンティティーを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティーにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティーとすることができます。
.TP 3
-臀峨
-臀峨若帥冴潟ｃｃ (臀峨 荐惹吾≪肴若違) 泣篏帥ｃ荐膊障
-.TP 3
-
-泣劫潟ｃｃ若ャｃ違с違潟ｃｃ若泣障泣祉ャ腱絲ｃ障 泣泣鴻究垸激鴻у障ｃ絖障DSA 後究垸激鴻翫1 ゃ泣罩ｇ∈ 1 ゃ泣絲上障泣臀峨荐膊篏帥障
+署名
+.LP
+署名は、なんらかのデータを基にエンティティー (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。
.TP 3
-潟ｃｃ
-潟潟ｃ若篋冴腟膵違潟潟ャ若帥篌罐茵筝絎綺т拭若絲乗院障障障
+非公開鍵
+.LP
+非公開鍵は特定のエンティティーだけが知っている数のことで、この数のことを、そのエンティティーの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。
+.TP 3
+エンティティー
+.LP
+エンテンティーは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。
.RE
-
.LP
-.LP
-究垸сц蟹筝若吟若泣≪祉鴻綽荀障紊ц閞＜若医с篋篆＜潟ｃｃ守т札≫綣膓腆榊篁絎篏帥鴻泣篆♂若с吾絖篁絎筝純с泣絽≪馹茹ｆ浦荐惹吾罅障憜с荐惹悟肴絮 (CA)篆♂若с膃筝罘純障CA 祉潟ｃｃ若荐惹吾臀峨 (肴) 茵冴篆♂若篁祉潟ｃｃ (篌罐) сCA 羈緇筝絅膣с鴻や拭若с荐惹吾篏宴障
+公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティー間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「証明書発行局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティーの証明書に署名する (発行する) 行為を、信頼して任されているエンティティー (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。
.na
\f2VeriSign\fP @
.fi
-http://www.verisign.com/
+http://www.verisign.com/、
.na
\f2Thawte\fP @
.fi
-http://www.thawte.com/
+http://www.thawte.com/、
.na
\f2Entrust\fP @
.fi
-http://www.entrust.com/ 紊 CA 絖障Netscape Microsoft 茯荐若泣若若Entrust CA 茖遵絮腟膵у違荐惹悟肴絮吟純с
-.LP
-.LP
-\f3keytool\fP 篏帥荐惹吾茵腓冴ゃ潟若潟鴻若茵с障障綏援讐荐惹吾с障
+http://www.entrust.com/ をはじめ、多くの CA が存在します。Microsoft の認証サーバー、Entrust の CA 製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。
.LP
+\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。
.LP
-憜\f3keytool\fP X.509 荐惹吾絲乗院障
-.LP
-.RE
+現在、\f3keytool\fP は X.509 証明書を対象にしています。
.TP 2
o
-\f3X.509 荐惹\fP
-.RS 3
-X.509 荀若с荐惹吾宴絎臂宴荐惹吾吾莨若号 (若水就綣) ゃ荐菴違障荐惹吾鴻若帥ASN.1/DER 若違 2 ゃ∫ｈ若篏帥ｃ膃垸障\f2Abstract Syntax Notation 1\fP 若帥ゃ荐菴違障\f2Definite Encoding Rules\fP 若帥篆絖活拶号ゃ荐菴違障
+\f3X.509 証明書\fP
.LP
-鴻 X.509 荐惹吾臀峨祉罨＜若帥с障
+X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。
.LP
+すべての X.509 証明書は、署名のほかに次のデータを含んでいます。
.RS 3
.TP 3
-若吾с
-荐惹吾 X.509 荀若若吾с潟劫障 荐惹吾絎с宴若吾с潟ｃ違障障с3 ゃ若吾с潟絎臂障\f3keytool\fP сv1v2 v3 荐惹吾ゃ潟若鴻若純сkeytool v3 荐惹吾с
+バージョン
.LP
-X.509 Version 11988 綛眼綺ｃ筝с
+証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。keytool が生成するのは、v3 の証明書です。
+.LP
+「X.509 Version 1」は、1988 年から利用されて広く普及しており、もっとも一般的です。
.LP
-X.509 Version 2сSubject 肴усSubject 肴筝顑ュ网綽泣絨ャ障祉荐惹吾＜ゃ吾с篏睡荐惹吾т茘ュ篏帥綣激ｨ絅障Version 2 荐惹吾綺篏帥障
+「X.509 Version 2」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。
.LP
-X.509 Version 3ｃ違 (1996 綛) 荀若с鴻潟激с潟网綽泣泣若障鴻潟激с潟茯違с絎臂с荐惹吾с障憜篏帥筝鴻潟激с潟KeyUsage (臀峨絨泣篏睡劫狗)AlternativeNames (DNS 糸＜若≪鴻IP ≪鴻祉≪ゃ潟ｃｃ若泣∫ｄс) 障鴻潟激с潟critical 若篁鴻潟激с潟с篏睡臂ャс障違critical 若KeyCertSign 荐絎 KeyUsage 鴻潟激с潟荐惹吾障翫荐惹吾 SSL 篆＞賢腓冴荐惹吾障 荐惹吾鴻潟激с潟ｃ∫ｃ泣荐惹吾臀峨絨絎SSL с篏睡сс
+「X.509 Version 3」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、KeyUsage (「署名専用」など、鍵の使用を特定の目的に制限する)、AlternativeNames (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティーを公開鍵に関連付けることができる) などがあります。エクステンションには、critical というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。
.TP 3
-激≪
-荐惹吾篏潟ｃｃ若潟ｃｃ若肴祉荐惹吾阪ャ荐惹吾激≪垩蚊綵障宴障障号т戎障 違荐惹吾羔激≪垩荐惹吾羔鴻 (CRL) 主障
+シリアル番号
+.LP
+証明書を作成したエンティティーは、そのエンティティーが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。
.TP 3
-臀峨≪眼冴茘ュ
-荐惹吾臀峨篁 CA 篏帥ｃ≪眼冴劫障
+署名アルゴリズム識別子
+.LP
+証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。
.TP 3
-肴
-荐惹吾臀峨篁潟ｃｃ若 X.500 茘ュс潟ｃｃ若絽吾 CA с荐惹吾篏帥荐惹吾臀峨篁潟ｃｃ若篆♂若潟障若ゃ障 CA 荐惹吾翫ｃ肴荳荐惹吾臀峨篁鴻羈
+発行者名
+.LP
+証明書に署名を付けたエンティティーの X.500 識別名です。エンティティーは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティーを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。
.TP 3
-号
-荐惹吾鴻障紮ユ腟篋ユｃ絎亥 100 綛眼傑障御号荐惹吾吾臀峨篏帥泣綣桁墾荐惹吾蕁障障荀х違障号篏睡泣翫潟ｃｃ若泣篆♂若с緇с
+有効期間
+.LP
+各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティーが公開鍵を信頼できると期待される期間です。
.TP 3
-Subject
-荐惹吾у泣茘ャ潟ｃｃ若с X.500 罔羣篏帥сゃ潟帥若篏т喝障潟ｃｃ若 X.500 茘ュ (DN) с 罨＜箴腓冴障
+Subject 名
+.LP
+証明書で公開鍵が識別されているエンティティーの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティーの X.500 識別名 (DN) です。次に例を示します。
.nf
\f3
.fl
- CN=Java Duke, OU=Java Software Division, O=Sun Microsystems Inc, C=US
+ CN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US
.fl
\fP
.fi
-筝私腱違腟膵篏腟膵純茵障
-.TP 3
-Subject 究
-篁潟ｃｃ若泣≪眼冴茘ュс ≪眼冴茘ュс泣絲障篏帥究垸激鴻渇∫ｃ泣＜若帥絎障
-.RE
-
-.LP
-.RE
-.TP 2
-o
-\f3荐惹吾с若\fP
-.RS 3
-.LP
-\f3keytool\fP с泣渇∫ｃ荐惹吾с若潟若鴻≪泣潟篏膊∞с障潟с泣絲上泣с若潟荐惹吾障障
-.LP
.LP
-泣篏 (\-genkeypair 潟潟)綏援讐荐惹吾 1 ゃ荀膣с若潟紮障綏援讐荐惹吾肴 (臀峨) 筝私 (荐惹吾ц荐若泣＞源) с荐惹吾с\f2\-genkeypair\fP 潟潟若喝冴違泣泣≪篏泣絽吾綏援讐荐惹吾с障
-.LP
-.LP
-荐惹悟讐荀羆 (CSR) (\-certreq 潟潟)CSR 荐惹悟肴絮 (CA) 篆＜CA 綽膈ゃ潟若 (\-importcert 潟潟)綏援讐荐惹吾荐惹吾с若潟ｃ臀障с若潟緇Subject 泣茯荐若 CA 肴荐惹 (綽膈) сс若喝荐惹吾CA泣茯荐若荐惹吾с
-.LP
-.LP
-CA 泣茯荐若荐惹吾紊翫綏援讐荐惹 (ゃ障 CA 荳泣茯荐若荐惹) сс若潟荐惹吾障翫ｃCA 荐惹吾с若潟菴障翫с若喝緇荐惹 (CA ｃ臀峨泣潟泣茯荐若荐惹) 紊障с若喝荐惹吾CSR 篆≦ CA ャCA ｃ臀峨CSR 篆≦ CA 泣茯荐若荐惹吾障с若喝荐惹吾罨＜ CA 泣茯荐若荐惹吾障 篁ヤ罕綏援讐若荐惹吾障сс若潟膓障ｃс若喝 (荐惹娯札緇) 荐惹吾сс若喝罨＜荐惹吾臀峨泣茯荐若障
-.LP
+これらはそれぞれ主体の通称、組織単位、組織、国を表します。
+.TP 3
+Subject の公開鍵情報
.LP
-紊 CA с若潟泣若肴羝帥荐惹吾菴障 鴻筝 CA 絖絮ゆ翫上蕁с翫若鴻≪с主篆♂若с荐惹御宴荐惹吾с若潟腆榊綽荀障
-.LP
-.LP
-ャ綽膈綵√ (PKCS#7 у臂綵√) с肴羝粋┝吾荐惹吾с若潟泣若障障\f3keytool\fP с＜綽膈綵√宴с障
-.LP
-.LP
- (若) CA 荐惹吾綏援讐荐惹吾с若泣絲障篆♂若若荐惹梧篏絨冴с (違VeriSign 若 CA 茘ュ篏帥ｃ綏援讐荐惹吾篏篏茯違с)域祉掩掩ャс若 CA 泣綺ャ障若 CA 泣荐惹吾主宴荐惹吾綵√у若с障 ゃ障荐惹吾若 CA 泣吟紵篏с若 CA 荐惹吾若鴻≪菴遵荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 激с潟篏睡)茵腓冴ｃ潟若潟域若 CA Web 若吾ユ∝ャｃ潟若潟罸莠綽荀障
-.LP
+名前を付けられたエンティティーの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。
.RE
.TP 2
o
-\f3cacerts 荐惹吾＜ゃ\fP
-.RS 3
+\f3証明書チェーン\fP
+.LP
+\f3keytool\fP では、非公開鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。
.LP
-\f3cacerts\fP 荐惹吾＜ゃ祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
+鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含むチェーンが開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。 \f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。
.LP
-.LP
-cacerts ＜ゃCA 荐惹吾激鴻篏若鴻≪с激鴻膊∞若鴻≪帥ゃ jks 絎с\f3keytool\fP 篏帥ｃ＜ゃ罕膊∞茵с障cacerts 若鴻≪＜ゃ罨＜ュ X.500 茘ュゃゃ若 CA 荐惹吾倶у肴激障
+このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が証明書発行局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。チェーン内のその前の証明書は、「CA」の公開鍵を認証する証明書です。
.LP
-.RS 3
-.TP 2
-*
-\f3Alias\fP:thawtepersonalfreemailca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-freemail@thawte.com,
-.br
-CN=Thawte Personal Freemail CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepersonalbasicca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-basic@thawte.com,
-.br
-CN=Thawte Personal Basic CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepersonalpremiumca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-premium@thawte.com,
-.br
-CN=Thawte Personal Premium CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawteserverca
-.br
-\f3Owner DN\fP:EmailAddress=server\-certs@thawte.com,
-.br
-CN=Thawte Server CA, OU=Certification Services Division,
-.br
-O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepremiumserverca
-.br
-\f3Owner DN\fP:EmailAddress=premium\-server@thawte.com,
-.br
-CN=Thawte Premium Server CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:verisignclass1ca
-.br
-\f3Owner DN\fP:OU=Class 1 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2ca
-.br
-\f3Owner DN\fP:OU=Class 2 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3ca
-.br
-\f3Owner DN\fP:OU=Class 3 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignserverca
-.br
-\f3Owner DN\fP:OU=Secure Server Certification Authority,
-.br
-O="RSA Data Security, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass1g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 1 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass1g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 2 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
-.br
-OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 3 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
-.br
-OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:baltimorecodesigningca
-.br
-\f3Owner DN\fP:CN=Baltimore CyberTrust Code Signing Root,
-.br
-OU=CyberTrust, O=Baltimore, C=IE
-.TP 2
-*
-\f3Alias\fP:gtecybertrustglobalca
-.br
-\f3Owner DN\fP:CN=GTE CyberTrust Global Root,
-.br
-OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
-.TP 2
-*
-\f3Alias\fP:baltimorecybertrustca
-.br
-\f3Owner DN\fP:CN=Baltimore CyberTrust Root,
-.br
-OU=CyberTrust, O=Baltimore, C=IE
-.TP 2
-*
-\f3Alias\fP:gtecybertrust5ca
-.br
-\f3Owner DN\fP:CN=GTE CyberTrust Root 5,
-.br
-OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
-.TP 2
-*
-\f3Alias\fP:entrustclientca
-.br
-\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/Client_CA_Info/CPS incorp. by ref. limits liab.,
-.br
-O=Entrust.net, C=US
-.TP 2
-*
-\f3Alias\fP:entrustglobalclientca
-.br
-\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
-.br
-OU=(c) 2000 Entrust.net Limited,
-.br
-OU=www.entrust.net/GCCA_CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:entrust2048ca
-.br
-\f3Owner DN\fP:CN=Entrust.net Certification Authority (2048),
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:entrustsslca
-.br
-\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net, C=US
-.TP 2
-*
-\f3Alias\fP:entrustgsslca
-.br
-\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
-.br
-OU=(c) 2000 Entrust.net Limited,
-.br
-OU=www.entrust.net/SSL_CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:godaddyclass2ca
-.br
-\f3Owner DN\fP:OU=Go Daddy Class 2 Certification Authority,
-.br
-O="The Go Daddy Group, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:starfieldclass2ca
-.br
-\f3Owner DN\fP:OU=Starfield Class 2 Certification Authority,
-.br
-O="Starfield Technologies, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:valicertclass2ca
-.br
-\f3Owner DN\fP:EMAILADDRESS=info@valicert.com,
-.br
-CN=http://www.valicert.com/,
-.br
-OU=ValiCert Class 2 Policy Validation Authority,
-.br
-O="ValiCert, Inc.", L=ValiCert Validation Network
-.TP 2
-*
-\f3Alias\fP:geotrustglobalca
-.br
-\f3Owner DN\fP:CN=GeoTrust Global CA,
-.br
-O=GeoTrust Inc., C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureca
-.br
-\f3Owner DN\fP:OU=Equifax Secure Certificate Authority,
-.br
-O=Equifax, C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureebusinessca1
-.br
-\f3Owner DN\fP:CN=Equifax Secure eBusiness CA\-1,
-.br
-O=Equifax Secure Inc., C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureebusinessca2
-.br
-\f3Owner DN\fP:OU=Equifax Secure eBusiness CA\-2,
-.br
-O=Equifax Secure, C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureglobalebusinessca1
-.br
-\f3Owner DN\fP:CN=Equifax Secure Global eBusiness CA\-1,
-.br
-O=Equifax Secure Inc., C=US
-.TP 2
-*
-\f3Alias\fP:soneraclass1ca
-.br
-\f3Owner DN\fP:CN=Sonera Class1 CA, O=Sonera, C=FI
-.TP 2
-*
-\f3Alias\fP:soneraclass2ca
-.br
-\f3Owner DN\fP:CN=Sonera Class2 CA, O=Sonera, C=FI
-.TP 2
-*
-\f3Alias\fP:comodoaaaca
-.br
-\f3Owner DN\fP:CN=AAA Certificate Services,
-.br
-O=Comodo CA Limited, L=Salford, ST=Greater Manchester, C=GB
-.TP 2
-*
-\f3Alias\fP:addtrustclass1ca
-.br
-\f3Owner DN\fP:CN=AddTrust Class 1 CA Root,
-.br
-OU=AddTrust TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:addtrustexternalca
-.br
-\f3Owner DN\fP:CN=AddTrust External CA Root,
-.br
-OU=AddTrust External TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:addtrustqualifiedca
-.br
-\f3Owner DN\fP:CN=AddTrust Qualified CA Root,
-.br
-OU=AddTrust TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:utnuserfirsthardwareca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Hardware,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utnuserfirstclientauthemailca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Client Authentication and Email,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utndatacorpsgcca
-.br
-\f3Owner DN\fP:CN=UTN \- DATACorp SGC,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utnuserfirstobjectca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Object,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.RE
-
+CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これはチェーンの最初の証明書になります。場合によっては、CA が証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、チェーン内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次の CA の鍵を認証する証明書になります。 以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の (最初の証明書以後の) 各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。
+.LP
+多くの CA は、チェーンをサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。
.LP
-.LP
-cacerts 若鴻≪＜ゃ鴻若changeit с激鴻膊∞SDK ゃ潟鴻若緇＜ゃ鴻若≪祉号┤紊眼綽荀障
-.LP
-.RS 3
-
-.LP
-
+別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。
.LP
-\f3荀:\fP\f4cacerts\fP\f3 ＜ゃ腆肴\fP
-.br
-
-.LP
-\f2cacerts\fP ＜ゃ CA 臀峨割潟ｃｃ若吾荐惹悟肴潟ｃｃ若篆♂若\f2cacerts\fP ＜ゃ膊∞茵綽荀障\f2cacerts\fP ＜ゃ篆♂若 CA 荐惹吾障違障若吟若荳莢篁祉\f2cacerts\fP ＜ゃ潟篆♂若с若 CA 荐惹吾罎荐若篆♂惹с≪羆阪茵障篆♂若с CA 荐惹吾 \f2cacerts\fP ＜ゃゃ\f2keytool\fP 潟潟ゃ激с潟篏睡障\f2cacerts\fP ＜ゃ JRE ゃ潟鴻若ｃ障＜ゃ膩≪祉号┤翫激鴻膊∞ｇ機
-.br
-
-.LP
-.RE
-
-.LP
-.RE
+トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し ( \f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。
.TP 2
o
-\f3ゃ潟帥若 RFC 1421 荐惹悟垸荀\fP
-.RS 3
+\f3cacerts 証明書ファイル\fP
+.LP
+\f3cacerts\fP という名前の証明書ファイルは、セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
.LP
-紊翫荐惹吾ゃ膃垸сゃ潟帥若 RFC 1421 荀若у臂阪順垸劫篏帥ｃ主障Base 64 膃垸若違荐惹後就綣с糸＜若篁罘罕祉≪宴若激с潟荐惹吾絎号鴻若с障
-.LP
+cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、ルート CA 証明書のデフォルトセットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。
+.nf
+\f3
+.fl
+keytool \-list \-keystore \fP\f4java.home\fP\f3/lib/security/cacerts
+.fl
+\fP
+.fi
.LP
-\f2\-importcert\fP 潟潟 \f2\-printcert\fP 潟潟с綵√荐惹吾ゃ膃垸荐惹吾茯粋昭с障
-.LP
+cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。
.LP
-\f2\-exportcert\fP 潟潟ссゃ膃垸荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障
+\f3重要: \fP\f4cacerts\fP\f3 ファイルを確認してください\fP: \f2cacerts\fP ファイル内の CA は、署名および他のエンティティーへの証明書発行のためのエンティティーとして信頼されるため、 \f2cacerts\fP ファイルの管理は慎重に行う必要があります。 \f2cacerts\fP ファイルには、信頼する CA の証明書だけが含まれていなければなりません。ユーザーは、自身の責任において、 \f2cacerts\fP ファイルにバンドルされている信頼できるルート CA 証明書を検証し、信頼性に関する独自の決定を行います。信頼できない CA 証明書を \f2cacerts\fP ファイルから削除するには、 \f2keytool\fP コマンドの削除オプションを使用します。 \f2cacerts\fP ファイルは JRE のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。
+.TP 2
+o
+\f3インターネット RFC 1421 証明書符号化規格\fP
.LP
+多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。
.LP
-\f2\-list\fP 潟潟сц┝吾 MD5 ｃ潟若潟阪障\f2\-v\fP 激с潟絎篋咲茯с綵√ц┝吾阪障 筝鴻\f2\-rfc\fP 激с潟絎阪順垸劫ц┝吾阪障
+\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。
.LP
+\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。 ただし、 \f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。
.LP
-阪順垸劫х垸荐惹吾罨＜茵у障障
+\f2\-list\fP コマンドでは、デフォルトで証明書の SHA1 フィンガープリントが出力されます。 \f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、 \f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。
.LP
+出力可能符号化方式で符号化された証明書は、次の行で始まります。
.nf
\f3
.fl
@@ -1372,11 +1574,8 @@
.fl
\fP
.fi
-
.LP
-.LP
-緇罨＜茵х障
-.LP
+最後は、次の行で終わります。
.nf
\f3
.fl
@@ -1385,40 +1584,38 @@
\fP
.fi
.RE
-.RE
.LP
.SS
-X.500 茘ュ
+X.500 識別名
+.LP
.LP
-.RS 3
-
+X.500 識別名は、エンティティーを特定するために使われます。たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。
.LP
-X.500 茘ュ潟ｃｃ若劫篏帥障 違X.509 荐惹吾 \f2subject\fP ｃ若 \f2issuer\fP (臀峨) ｃ若ф絎X.500 茘ュс \f3keytool\fP 罨＜泣若泣若障
.RS 3
.TP 2
o
-\f2commonName\fP \- 篋冴腱違 Susan Jones
+\f2commonName\fP \- 人の通称。 「Susan Jones」など
.TP 2
o
-\f2organizationUnit\fP \- 絨腟膵 (茯蚊) 腱違 篁ラ
+\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。 「仕入部」など
.TP 2
o
-\f2organizationName\fP \- 紊с腟膵腱違 ABCSystems, Inc.
+\f2organizationName\fP \- 大きな組織の名称。 「ABCSystems, Inc.」など
.TP 2
o
-\f2localityName\fP \- 医 (遵) Palo Alto
+\f2localityName\fP \- 地域 (都市) 名。 「Palo Alto」など
.TP 2
o
-\f2stateName\fP \- 綏障井劫 California
+\f2stateName\fP \- 州名または地方名。 「California」など
.TP 2
o
-\f2country\fP \- 2 絖順垩 CH
+\f2country\fP \- 2 文字の国番号。 「CH」など
.RE
.LP
.LP
-\f2\-genkeypair\fP 潟潟 \f2\-dname\fP 激с潟ゃ茘ュ絖絎翫罨＜綵√ф絎綽荀障
+\-genkeypair コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、 次の形式で指定する必要があります。
.LP
.nf
\f3
@@ -1430,12 +1627,12 @@
.LP
.LP
-ゃ帥篏絎絎ゃ茵障 膰綵≪若若潟罨＜с
+イタリック体の項目は、実際に指定する値を表します。 短縮形のキーワードの意味は、次のとおりです。
.LP
.nf
\f3
.fl
- CN=commonName
+ CN=commonName
.fl
OU=organizationUnit
.fl
@@ -1452,22 +1649,24 @@
.LP
.LP
-罨＜腓冴茘ュ絖箴с
+次に示すのは、識別名文字列の例です。
.LP
.nf
\f3
.fl
-CN=Mark Smith, OU=JavaSoft, O=Sun, L=Cupertino, S=California, C=US
+CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US
.fl
\fP
.fi
.LP
-罨＜絖篏帥ｃ潟潟箴с
+.LP
+次は、この文字列を使ったコマンドの例です。
+.LP
.nf
\f3
.fl
-keytool \-genkeypair \-dname "CN=Mark Smith, OU=JavaSoft, O=Sun, L=Cupertino,
+keytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino,
.fl
S=California, C=US" \-alias mark
.fl
@@ -1476,45 +1675,43 @@
.LP
.LP
-若若膰綵≪с紊ф絖絨絖阪ャ障違CNcn Cn 宴障
+キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。
.LP
.LP
-筝鴻若若絎綺潟泣潟潟若潟筝腓冴綺ф絎綽荀障泣潟潟若潟鴻絎綽荀障違罨＜筝泣潟潟若潟絎с障
+一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。
.LP
.nf
\f3
.fl
-CN=Steve Meier, OU=SunSoft, O=Sun, C=US
+CN=Steve Meier, OU=Java, O=Oracle, C=US
.fl
\fP
.fi
.LP
.LP
-茘ュ絖ゃ潟潟障翫潟潟茵ф絖絎罨＜潟潟絖 \\ с鴻宴若綽荀障
+識別名文字列の値にコンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。
.LP
.nf
\f3
.fl
- cn=peter schuster, o=Sun Microsystems\\, Inc., o=sun, c=us
+ cn=Peter Schuster, ou=Java\\, Product Development, o=Oracle, c=US
.fl
\fP
.fi
.LP
.LP
-茘ュ絖潟潟茵ф絎綽荀障茘ュ綽荀潟潟絎茵潟潟茵цュ絎ｃ翫泣潟潟若潟ュ羆障翫潟潟絖 \\ с鴻宴若綽荀障
+識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。
.LP
-.RE
.SS
-篆♂若с荐惹吾ゃ潟若≪羈鋋
+信頼できる証明書のインポートに関する注意事項
.LP
-.RS 3
-
+.LP
+重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。
.LP
-荀:篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾絎鴻茯帥鴻
.LP
-障荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f2\-import\fP 潟潟篏睡)茵腓冴荐惹吾ｃ潟若潟緇ｃ潟若潟筝眼腆肴障違若吟若荐惹吾荐惹吾 \f2/tmp/cert\fP с＜ゃ主障翫篆♂若с荐惹吾鴻荐惹吾菴遵\f2\-printcert\fP 潟潟絎茵ｃ潟若潟茵腓冴с障 違罨＜障
+まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
.LP
.nf
\f3
@@ -1535,90 +1732,93 @@
.fl
SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
.fl
+ SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+.fl
+ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+.fl
\fP
.fi
.LP
-罨＜荐惹吾篆＜篋榊ｇ機篋榊腓冴ｃ潟若潟筝潟潟ц；腓冴ｃ潟若潟罸莠障ｃ潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙ｃ臀峨鴻 (紙潟ゃ鴻＜ゃ JAR ＜ゃ) 篆♂若障
+.LP
+次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。
.LP
-羈:荐惹吾ゃ潟若綽 \f2\-printcert\fP 潟潟絎茵違с障 若鴻√篆♂若с荐惹吾鴻荐惹吾菴遵 \f2\-importcert\fP 潟潟絎茵荐惹吾宴茵腓冴腆肴羆＜祉若吾茵腓冴障ゃ潟若篏鴻т賢罩≪с障腆肴＜祉若吾茵腓冴\f2\-importcert\fP 潟潟 \f2\-noprompt\fP 激с潟絎絎茵翫с\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
+.LP
+注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
.LP
-.RE
.SS
-鴻若≪羈鋋
+パスワードに関する注意事項
.LP
-.RS 3
-
+.LP
+キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。
.LP
.LP
-若鴻≪絲障篏茵祉潟潟с鴻≪鴻若綽荀с障筝潟潟с/腱絲泣鴻若綽荀障
-.LP
-.LP
-鴻若潟潟茵ф絎с障 (鴻≪鴻若 \f2\-storepass\fP 激с潟泣鴻若 \f2\-keypass\fP 激с潟篏睡)鴻翫障絎сｃ激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с
+パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
.LP
.LP
-綽荀鴻若激с潟潟潟茵ф絎ｃ翫鴻若ュ羆障
+必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
+.LP
+.SS
+証明書の準拠に関する注意事項
+.LP
.LP
-.RE
-.SH "∫ｉ"
+インターネット標準の
+.na
+\f2RFC 5280\fP @
+.fi
+http://tools.ietf.org/rfc/rfc5280.txt では、X.509 証明書が準拠するプロファイルを定義しています。このプロファイルには、証明書のフィールドやエクステンションで有効な値や値の組み合わせが含まれています。\f3keytool\fP では、これらのすべての規則が適用されているわけではないので、標準に準拠しない証明書が生成される可能性があり、そのような証明書は JRE やほかのアプリケーションで拒否されることがあります。ユーザーは、 \f2\-dname\fP や \f2\-ext\fP などで適正なオプションを指定するようにしてください。
.LP
-
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-.LP
-jar(1) 若ャ＜潟
+jar(1) ツールのドキュメント
.TP 2
o
-.LP
-jarsigner(1) 若ャ＜潟
+jarsigner(1) ツールのドキュメント
.TP 2
o
-.LP
-\f3keytool\fP 篏睡箴ゃ
.na
-\f4Java Tutorial\fP @
+\f4keytool\fP\f2 の使用例については、\fP @
.fi
-http://java.sun.com/docs/books/tutorial
+http://download.oracle.com/javase/tutorial/security/index.html
.na
-\f4Security\fP @
+\f2「Java Tutorial」\fP\f4の\fP @
.fi
-http://java.sun.com/docs/books/tutorial/security/index.html
+http://download.oracle.com/javase/tutorial/「Security」\f3を参照\fP
.RE
.LP
-.SH "紊雁"
-.LP
-
+.SH "変更点"
.LP
.LP
-Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障
+Java SE 6 で keytool のコマンドインタフェースが変更されました。
.LP
.LP
-\f3keytool\fP 若吟若鴻若ュュ絎鴻茵腓冴障若吟若鴻若ュュ絎鴻腆肴сｃ若鴻≪鴻若荐絎泣鴻若紊眼鴻若荐絎紊眼茵潟鴻若ュ羆障
+\f3keytool\fP は、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。
.LP
.LP
-紊眼潟潟筝紊眼違綮罩≪ャ＜潟荐莠ｃ障篁ュ鴻潟潟 (紊眼綮罩≪筝≧) 若鴻с綣膓泣若篁緇若鴻с泣若篋絎сkeytool 潟潟ゃ潟帥с若鴻鴻紊雁鴻网荀罨＜腓冴障
+変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。
.LP
.LP
-紊眼潟潟:
+名前が変更されたコマンド:
.LP
.RS 3
.TP 2
o
-\f2\-export\fP \f2\-exportcert\fP 紊
+\f2\-export\fP の名前が \f2\-exportcert に変更\fP
.TP 2
o
-\f2\-genkey\fP \f2\-genkeypair\fP 紊
+\f2\-genkey\fP の名前が \f2\-genkeypair に変更\fP
.TP 2
o
-\f2\-import\fP \f2\-importcert\fP 紊
+\f2\-import\fP の名前が \f2\-importcert に変更\fP
.RE
.LP
.LP
-綮罩≪ャ＜潟荐莠ｃ潟潟:
+廃止されてドキュメントに記載されなくなったコマンド:
.LP
.RS 3
.TP 2
@@ -1626,19 +1826,19 @@
.na
\f2\-keyclone\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#keycloneCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#keycloneCmd
.TP 2
o
.na
\f2\-identitydb\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#identitydbCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#identitydbCmd
.TP 2
o
.na
\f2\-selfcert\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#selfcertCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#selfcertCmd
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/native2ascii.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/native2ascii.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1997, 2010, 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
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH native2ascii 1 "02 Jun 2010"
+.TH native2ascii 1 "14 Apr 2011"
.LP
-.SH ""
-native2ascii \- ゃｃ \- ASCII 潟潟若
-.LP
-.RS 3
-
+.SH "名前"
+native2ascii \- ネイティブ \- ASCII コンバータ
.LP
.LP
-ゃｃ潟若 (Latin 1 Unicode 篁ュ) ＜ゃ Unicode 潟若紊障
+サポートされる文字エンコーディングの文字のファイルを ASCII または Unicode エスケープあるいはその両方のファイルに変換します。その逆の変換も行います。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -44,36 +38,34 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-Java 潟潟ゃ潟篁 Java 若Latin\-1 障 Unicode 潟若 (\\udddd 茵荐) 絖＜ゃс障 \f2native2ascii\fP 篁ュ絖潟若＜ゃ Latin\-1 障 Unicode 潟若＜ゃ紊障
+\f2native2ascii\fP Java 実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCII でエンコードされたファイルに変換します。ASCII 文字セットの一部でないすべての文字で Unicode エスケープ (「\\uxxxx」の表記) を使用します。このプロセスは、ISO\-8859\-1 文字セットに含まれない文字が含まれているプロパティーファイルで必要です。このツールは、その逆の変換を実行することもできます。
.LP
.LP
-\f2outputfile\fP ャ翫罔羣阪阪障\f2inputfile\fP ャ翫罔羣ュュ障
+\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、 \f2inputfile\fP を省略した場合、標準入力から入力されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-reverse
-茵障ゃ障Latin\-1 障 Unicode 潟若＜ゃゃｃ潟若紊障
+逆の処理を行います。つまり、ISO\-8859\-1 で Unicode エスケープを使ってエンコードされたファイルを、Java 実行環境でサポートされる文字エンコーディングのファイルに変換します。
.br
.br
.TP 3
\-encoding encoding_name
-紊т戎潟若絎障潟若激鴻ｃ若 \f2file.encoding\fP 緇障\f2encoding_name\fP 絖
+変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング ( \f2java.nio.charset.Charset.defaultCharset\fP メソッドで定義される) が使用されます。 \f2encoding_name\fP 文字列は、
.na
-\f4泣若潟潟若ｃ潟違\fP @
+\f4「サポートされている文字列エンコーディング」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlャ＜潟腓冴泣若潟潟若ｃ潟違茵緇綽荀障
+http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlドキュメントに示されている、Java 実行環境でサポートされる文字エンコーディングの名前にする必要があります。
+.br
+.br
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
--- a/jdk/src/linux/doc/man/ja/orbd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/orbd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,29 +19,23 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH orbd 1 "02 Jun 2010"
+.TH orbd 1 "14 Apr 2011"
.LP
-.SH ""
+.SH "名前"
orbd \- The Object Request Broker Daemon
.LP
-.RS 3
-
+.LP
+\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。
.LP
.LP
-\f3orbd\fP ゃ≪潟 CORBA 医泣若若膓吾с罎膣≪若喝冴篏睡障
-.LP
-.LP
-\f3∫ｉ:\fP
+\f3関連項目:\fP
.na
-\f2若泣若\fP @
+\f2ネームサービス\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -52,42 +46,40 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3orbd\fP 若障泣若若若吾ｃ若篏帥ゃ≪潟 CORBA 医с泣若寂膓吾с罎膣≪若喝冴с障膓泣若若若泣若鴻膓吾сс肴泣若若若垩篁ｃ OBRD 若垩吾сс障膓吾сс吾сс ORBD 若垩罨＜鴻障
+\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。
.LP
.RS 3
.TP 2
o
-若泣若鴻吾сс泣若若ゃ帥ゃ♂≫吾сс紮ゃ潟鴻若若泣若鴻泣若若若泣若鴻肴障緇泣若若紮障激ｃ潟違ORBD ゃс若喝冴ゃ≪潟罩ｃ吾сс菴障
+ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。
.TP 2
o
-ゃ≪潟筝綺若潟違泣若鴻吾сс≪綽荀緇泣若若ゃ帥ゃ紊眼♂≫сс
+クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる
.RE
.LP
.LP
-ORBD 泣若若若吾ｃ若≪祉鴻servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激ｃ潟茵潟潟茵ゃ潟帥с若鴻с泣若若若吾ｃ若荅括完ゃャ＜潟\f2泣若若若吾ｃ若\fPс
+ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。
.LP
.LP
-\f2orbd\fP 莎桁若泣若鴻莎桁障若泣若鴻ゃ
+\f2orbd\fP を起動すると、ネームサービスも起動されます。ネームサービスについては、
.na
-\f2若泣若鴻\fP @
+\f2「ネームサービス」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
-.SH "激с"
+.SH "オプション"
.LP
.SS
-綽激с
+必須オプション
.LP
.RS 3
.TP 3
\-ORBInitialPort nameserverport
-若泣若若莎桁若垩絎障\f2orbd\fP 莎桁若筝х篆∴羆緇罘障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 (綽)
+ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須)
.RE
.LP
@@ -95,75 +87,75 @@
.LP
.SS
-篁激с
+その他のオプション
.LP
.RS 3
.TP 3
\-port port
-ORBD 莎桁若絎障 ORBD 若с膓吾с絲障荀羆障若ゃ 1049 с 若垩膓 Interoperable Object References (IOR) 若ｃ若菴遵障(ュ)
+ORBD を起動するポートを指定します。ORBD は、このポートで、持続オブジェクトに対する要求を受け取ります。このポートのデフォルト値は 1049 です。このポート番号が、持続 Interoperable Object References (IOR). のポートフィールドに追加されます。(省略可)
.RE
.LP
.RS 3
.TP 3
\-defaultdb directory
-ORBD 膓主ｃ \f2orb.db\fP 篏若鴻ｃ絎障激с潟絎翫ゃ./orb.db障(ュ)
+ORBD 持続格納ディレクトリ \f2orb.db\fP が作成されるベースディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」となります。(省略可)
.RE
.LP
.RS 3
.TP 3
\-serverPollingTime milliseconds
-\f2servertool\fP 篏睡脂蚊膓泣若若罩ｅ幻篏 ORBD 腆肴違絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
+\f2servertool\fP を使用して登録された持続サーバーが正常に動作していることを ORBD が確認する回数を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE
.LP
.RS 3
.TP 3
\-serverStartupDelay milliseconds
-\f2servertool\fP 篏睡脂蚊膓泣若若莎桁篏臀荵∫箴紊篆＜障с ORBD 緇罘絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
+\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE
.LP
.RS 3
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.TP 3
.RE
.LP
-.SH "若泣若鴻莎桁罩"
+.SH "ネームサービスの起動と停止"
.LP
.LP
-若泣若鴻
+ネームサービスは、
.na
-\f2CORBA 吾с\fP @
+\f2CORBA オブジェクト\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object若潟違純 CORBA 泣若鴻с 若潟違吾ссゃ潟純障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にする CORBA サービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。
.na
-\f2若ゃ潟ｃ潟違\fP @
+\f2「ネームバインディング」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding若泣若鴻主ゃ≪潟筝吾сс緇с障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingはネームサービスに格納され、クライアントは名前を与えて目的のオブジェクト参照を取得できます。
.LP
.LP
-ORBD ゃ≪潟障泣若若絎茵莎桁障ORBD 膓若泣若鴻割若泣若鴻腟粋昭障障 ＜ COS 若泣若鴻絎茖с
+ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。
.LP
.LP
-\f3膓若泣若\fP若潟違潟潟鴻絲障膓с箴障ゃ障宴泣若鴻罩≪莎桁緇膓泣若鴻絎潟榊翫с緇с障ORBD 莎桁膓若泣若鴻若潟違潟潟鴻違緇鴻ゃ≪潟泣若若ゃ潟ｃ潟違篆障
+\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。
.LP
.LP
\
.LP
.LP
-筝篏篋сс若吾с潟 JDK 罌宴\f3筝若泣若\fP篁若鴻 J2SE 罌宴障筝若泣若鴻с若泣若鴻絎茵筝帥若潟違潟潟鴻篆障泣若鴻筝若潟違潟潟鴻紊宴障
+下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。
.LP
.LP
-\f2\-ORBInitialPort\fP 綣違\f2orbd\fP 綽潟潟茵綣違с若泣若鴻絎茵若垩荐絎篏帥障篁ヤ茯сJava\ IDL Object Request Broker Daemon 若 1050 篏睡с障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
+\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。
.LP
.LP
-UNIX 潟潟激с \f2orbd\fP 莎桁罨＜ュ障
+UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.nf
\f3
@@ -175,7 +167,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -187,7 +179,7 @@
.LP
.LP
- ORBD 絎茵泣若若ゃ≪潟≪宴若激с潟絎茵с障ゃ≪潟泣若若≪宴若激с潟絎茵若泣若鴻絎茵若 (綽荀翫激喝) 茯茘綽荀障絎憗 1 ゃ号罨＜潟若≪宴若激с潟菴遵с
+これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。
.LP
.nf
\f3
@@ -205,7 +197,7 @@
.LP
.LP
-箴с若泣若鴻鴻 MyHost 若 1050 筝у茵障ャ号潟潟茵泣若若障ゃ≪潟≪宴若激с潟絎茵若垩障激喝筝≧鴻絎号障違罨＜潟潟茵激с潟篏睡HelloApplication莎桁с障
+この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。
.LP
.nf
\f3
@@ -217,35 +209,35 @@
.LP
.LP
-若泣若鴻罩≪若ｃ潟違激鴻潟潟篏睡障 違Solaris с \f2pkill orbd\fP 篏睡\f2orbd\fP 絎茵 DOS ｃ潟с \f2Ctrl+C\fP 若篏睡障筝若泣若鴻翫泣若鴻腟篋若泣若鴻脂蚊羔ｻ翫障Java IDL 若泣若鴻腓榊罩≪障у茵障
+ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。
.LP
.LP
-ORDB 障若泣若鴻荅括完ゃ
+ORDB に含まれるネームサービスの詳細については、
.na
-\f2若泣若鴻\fP @
+\f2「ネームサービス」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
-.SH "泣若若若吾ｃ"
+.SH "サーバーマネージャー"
.LP
.LP
-ORBD 泣若若若吾ｃ若≪祉鴻膓泣若若絎茵servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激ｃ潟茵潟潟茵ゃ潟帥с若鴻сservertool 篏睡泣若若莎桁翫\f2orbd\fP 絎茵贋若鴻ц儀綽荀障泣若若違若у茵若潟潟鴻若帥若鴻篆絖宴≦鴻泣若鴻罩ｃ篏障
+ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\f2orbd\fP が実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカルコンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
.LP
.SS
-泣若若若吾ｃ:箴
+サーバーマネージャー: 例
.LP
.LP
-∝
+デモ用の
.na
-\f2泣潟ャ若≪\fP @
+\f2サンプルチュートリアル\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html篏睡ャ若≪緇ｃ\f2idlj\fP 潟潟ゃ \f2javac\fP 潟潟ゃ絎茵障泣若若若吾ｃ若絎茵罨＜緇ｃ≪宴若激с潟絎茵障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラを実行します。サーバーマネージャーを実行するには、次の手順に従ってアプリケーションを実行します。
.LP
.LP
-\f2orbd\fP 莎桁障
+\f2orbd\fP を起動します。
.LP
.LP
-UNIX 潟潟激с \f2orbd\fP 莎桁罨＜ュ障
+UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.LP
\
@@ -260,7 +252,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -272,13 +264,13 @@
.LP
.LP
-\f21050\fP 若泣若若絎茵若с\f2\-ORBInitialPort\fP 綽荀潟潟茵綣違сSolaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
+\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。
.LP
.LP
-\f2servertool\fP 莎桁障
+\f2servertool\fP を起動します。
.LP
.LP
-Hello 泣若若莎桁罨＜ュ障
+Hello サーバーを起動するには、次のように入力します。
.LP
.nf
\f3
@@ -290,21 +282,21 @@
.LP
.LP
-罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障\f2servertool\fP 若泣若若若筝ц儀綽荀障
+前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。\f2servertool\fP は、ネームサーバーと同じポート上で起動する必要があります。
.LP
.LP
-\f2servertool\fP 潟潟茵ゃ潟帥с若鴻茵腓冴障
+\f2servertool\fP コマンド行インタフェースが表示されます。
.LP
.LP
.LP
.LP
-\f2servertool\fP 潟 Hello 泣若若莎桁障
+\f2servertool\fP プロンプトから Hello サーバーを起動します。
.LP
.nf
\f3
.fl
- servertool > register \-server HelloServer \-classpath . \-applicationName
+ servertool > register \-server HelloServer \-classpath .\-applicationName
.fl
HelloServerApName
.fl
@@ -313,13 +305,13 @@
.LP
.LP
-\f2servertool\fP ｃ泣若若脂蚊HelloServerApName泣若若蚊綵泣若 ID 茵腓冴障
+\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。
.LP
.LP
.LP
.LP
-ャ腴ｃ潟障潟ゃ≪潟≪宴若激с潟絎茵障
+別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。
.LP
.LP
\
@@ -334,10 +326,10 @@
.LP
.LP
-箴 \f2\-ORBInitialHost localhost\fP ャс障 若泣若若 Hello ゃ≪潟筝鴻筝у篏с若泣若若ャ鴻у篏翫IDL 若泣若若篏鴻 \f2\-ORBInitialHost\fP \f2nameserverhost\fP ф絎障
+この例の \f2\-ORBInitialHost localhost\fP は省略することができます。ネームサーバーが Hello クライアントとして同一ホスト上で動作しているからです。ネームサーバーが別のホストで動作している場合は、IDL ネームサーバーが動作しているホストを \f2\-ORBInitialHost\fP \f2nameserverhost\fP で指定します。
.LP
.LP
-罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障
+前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。
.LP
.LP
\
@@ -346,21 +338,21 @@
\
.LP
.LP
-泣若若若吾ｃ若篏腟篋若泣若 (\f2orbd\fP) \f2servertool\fP 罩≪腟篋
+サーバーマネージャーの操作が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を停止するか終了してください。
.LP
.LP
-DOS 潟 \f2orbd\fP 激ｃ潟泣若若絎茵ｃ潟御 \f2Ctrl+C\fP ュ障UNIX 激с \f2orbd\fP 激ｃ潟祉鴻罎冴腟篋 (kill) 障泣若若腓榊罩≪障с若喝冴緇罘倶膓障
+DOS プロンプトで \f2orbd\fP をシャットダウンするには、サーバーを実行しているウィンドウを選択して \f2Ctrl+C\fP と入力します。UNIX シェルで \f2orbd\fP をシャットダウンするには、プロセスを検出して終了 (kill) します。サーバーを明示的に停止するまでは、呼び出し待機状態が続きます。
.LP
.LP
-\f2servertool\fP 激ｃ潟\f2quit\fP ュ若若 \f2Enter\fP 若若障
+\f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2若泣若\fP @
+\f2ネームサービス\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.br
--- a/jdk/src/linux/doc/man/ja/pack200.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/pack200.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,99 +19,79 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH pack200 1 "02 Jun 2010"
+.TH pack200 1 "14 Apr 2011"
.LP
-.SH ""
-pack200 \- JAR 若
+.SH "名前"
+pack200 \- JAR パックツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-腟篋鴻若帥
+終了ステータス
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-茯
+注意事項
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
.LP
.LP
-激с潟絎綺羆冴障障潟潟茵障 properties ＜ゃ絎緇激с潟篁ュ絎鴻激с潟障
-.LP
-.RS 3
-
+オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
output\-file
-阪＜ゃ
+出力ファイルの名前。
.TP 3
JAR\-file
-ュ＜ゃ
+入力ファイルの名前。
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f2pack200\fP 若Java \f2gzip\fP х軒違篏睡JAR ＜ゃ \f2pack200\fP х軒＜ゃ紊 Java ≪宴若激с潟с\f2pack200\fP ＜ゃ蕭х軒＜ゃс絽綛膀膣潟若膰贋･с障
+\f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
.LP
.LP
-\f2pack200\fP 若х軒潟吾潟荐絎緇茯炊眼茵激с潟障
+\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
.LP
.SS
-筝篏睡号:
-.LP
-.RS 3
-
+一般的な使用方法:
.LP
.LP
\f2% pack200 myarchive.pack.gz myarchive.jar\fP
.LP
-.RE
-.LP
-箴с \f2pack200\fP 荐絎с\f2myarchive.pack.gz\fP 篏障
.LP
-.SH "激с"
+この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。
.LP
-
+.SH "オプション"
.LP
.LP
\f4\-r \-\-repack\fP
.LP
-.RS 3
-
.LP
-.LP
-\f2myarchive.jar\fP ＜ゃ緇≪潟JAR ＜ゃ障＜ゃ\f2jarsigner(1)\fP 若ュ＜ゃ篏睡с障
-.LP
-.RS 3
-
+ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
.LP
.LP
\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
@@ -119,158 +99,122 @@
.LP
\f2% pack200 \-\-repack myarchive.jar\fP
.LP
-.RE
-.RE
.LP
\f4\-g \-\-no\-gzip\fP
.LP
-.RS 3
-
.LP
-.LP
-\f2pack200\fP ＜ゃ障激с潟絎х軒若篏睡綽荀障 障帥若蚊激鴻с絲上х軒茹ｉゃ若篏睡綽荀障
-.LP
-.RS 3
-
+\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
.LP
.LP
\f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP
.LP
-.RE
-.RE
.LP
\f4\-G \-\-strip\-debug\fP
.LP
-.RS 3
-
+.LP
+出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
.LP
.LP
-阪亥絮сゃ障絲乗院絮с\f2SourceFile\fP\f2LineNumberTable\fP\f2LocalVariableTable\fP \f2LocalVariableTypeTable\fP 障絮сゃ違潟若ゃ潟鴻若泣ゃ冴絨障罘純狗障
+\f4\-\-keep\-file\-order\fP
+.LP
.LP
-.RE
+入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。
+.LP
.LP
\f4\-O \-\-no\-keep\-file\-order\fP
.LP
-.RS 3
-
-.LP
.LP
-若鴻荀膣筝号帥荵∫障障JAR ｃゃ障潟若泣ゃ冴絨障ゃ潟鴻 JAR ＜ゃ罘純罩ｅ幻篏障
+パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
.LP
-.RE
.LP
\f4\-Svalue \-\-segment\-limit=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-ゃ≪若ゃ祉違＜潟篋潟帥若蚊泣ゃ N (ゃ篏) сN ゃ篁ヤ綽荀筝ュ＜ゃ
+この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが
.br
-腴≪若ゃ祉違＜潟蚊綵障違号箴сゃ \f2\-1\fP 翫鴻ュ＜ゃ筝綏紊с祉違＜潟障 筝鴻ゃ \f20\fP 翫鴻祉違＜潟 1 ゃょ障≪若ゃ祉違＜潟泣ゃ冴紊с医ぇ祉莎激х軒蕭障祉違＜潟紊ч＜≪若綽荀障
+N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
.LP
.LP
-祉違＜潟泣ゃ冴祉違＜潟ц拶ュ＜ゃ泣ゃ冴＜ゃ泣ゃ冴潟篁荵∫ｃ若ｃ篋羝障
+各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。
.LP
.LP
-泣ゃ冴 \f21000000\fP (100 筝ゃ) с罔羣泣ゃ冴ュ JAR ＜ゃ筝祉違＜潟ц拶с泣ゃ冴с若潟≪潟若＜≪取篁吟狗茯蚊障
+デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。
.LP
.LP
-狗茯蚊 10M ゃ JAR ＜ゃ絽吾 10% 腮綺泣ゃ冴障 若с紊с Java 若 (祉違＜潟狗膣 10 ) 綽荀翫障
+この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
.LP
-.RE
.LP
\f4\-Evalue \-\-effort=\fP\f2value\fP
.LP
-.RS 3
-
+.LP
+単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
.LP
.LP
-筝 10 我医ゃ絎翫若絎х軒с≪若ゃх軒障 \f21\fP 翫х軒綺х軒祉蕭障 \f29\fP 翫х軒綺х軒蕭障号 \f20\fP 絎翫 JAR ＜ゃх軒х贋･潟若障JSR 200 罔羣с鴻≪潟若号≪若ゃ篏鴻鴻若茹ｃ綽荀障
-.LP
+デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。
.LP
-ゃ \f25\fP с 翫罔羣с綺х軒茵障
-.LP
-.RE
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-ゃ筝吾ュ宴篆障 荵∫≪若ゃ泣ゃ冴紊с障純:
+デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。
.LP
.RS 3
.TP 3
true
.TP 3
false
-＜翫с若若激с潟潟阪≪若ゃ荐絎障 ≪若ゃ荀膣若激с潟潟荵∫障
+どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
.RE
.LP
.RS 3
.TP 3
keep
-ュ JAR 若激с潟潟篆障 ()
+入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。)
.RE
.LP
-.RE
.LP
\f4\-mvalue \-\-modification\-time=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-純:
+返される値は次のどれかになります。
.LP
.RS 3
.TP 3
latest
-若≪若ゃ潟腟贋井祉祉違＜潟鴻潟腟贋井祉劫障筝ゃ祉違＜潟筝荵∫祉違＜潟潟障翫鴻ゃ潟鴻若＜ゃ筝ヤ荐絎馹障≪若ゃ荵∫泣ゃ冴絨絨с障
+パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
.TP 3
keep
-ュ JAR 贋井祉篆障 ()
+入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。)
.RE
.LP
-.RE
.LP
\f4\-Pfile \-\-pass\-file=\fP\f2file\fP
.LP
-.RS 3
-
-.LP
.LP
-＜ゃх軒ゃ篏ц拶絎障激с潟膵違菴篏睡茲違＜ゃ絎с障劫紊茵障 激鴻＜ゃ阪絖 JAR ＜ゃ阪絖\f2/\fPх舟с＜ゃJAR ＜ゃ絖絎筝眼違障file ｃ絎翫ｃ鴻＜ゃ荵∫障
+ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
.LP
-.RE
.LP
\f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP
.LP
-.RS 3
-
.LP
-.LP
-篏≦鴻障 違筝絮с鴻＜ゃ絎≪激с潟ц拶障≪激с潟絎純:
+デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
error
-\f2pack200\fP 篏紊掩茹ｈ茵腓冴障
+\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
-絮с障羈: VM 綽絮сゃ鴻若若絎潟榊障
+属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.TP 3
pass
-絮с罎冴翫劫篏 1 ゃ純若鴻荵∫障
+この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
.RE
.LP
-.RE
.LP
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
.br
@@ -280,42 +224,32 @@
.br
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
.LP
-.RS 3
-
.LP
-.LP
- 4 ゃ激с潟с鴻潟ｃｃ若 Class 絮сField 絮сMethod 絮сCode 絮с絮сゃ≪絎с障attribute\-name ゃ≪障≪激с潟絎臂絮с絎障≪激с潟絎純:
+これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
-(筝ゃ≪絖)
-ゃ≪荐茯JSR 200 篁罕絎臂障
+some\-layout\-string
+レイアウト言語は、JSR 200 仕様に定義されています。
.LP
-箴: \f2\-\-class\-attribute=SourceFile=RUH\fP
+例: \f2\-\-class\-attribute=SourceFile=RUH\fP
.TP 3
error
-絮с罎冴翫pack200 篏紊掩茹ｈ茵腓冴障
+この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
-絮с罎冴翫絮с阪ゃ障羈: VM 綽絮сゃ鴻若若絎潟榊障
+この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.RE
.LP
.LP
-箴: \f2\-\-class\-attribute=CompilationID=pass\fP 絮с鴻＜ゃ荵∫障 若篁≪激с潟茵障
+例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。
.LP
-.RE
.LP
\f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP
.LP
-.RS 3
-
.LP
-.LP
-潟潟茵若 Java ｃ若障荐絎＜ゃ絎с障
-.LP
-.RS 3
-
+コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。
.LP
.LP
\f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP
@@ -340,70 +274,54 @@
.br
\f2segment.limit=\-1\fP
.LP
-.RE
-.RE
-.RS 3
-
-.LP
.LP
\f4\-v \-\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-絨＜祉若吾阪障激с潟茲井絎激＜祉若吾阪障
+最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
-.RE
.LP
\f4\-q \-\-quiet\fP
.LP
-.RS 3
-
-.LP
.LP
-＜祉若吾茵腓冴篏障
+メッセージを表示せずに動作します。
.LP
-.RE
.LP
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
.LP
-.RS 3
-
+.LP
+出力メッセージのログファイルを指定します。
+.LP
+.LP
+\f4\-? \-h \-\-help\fP
.LP
.LP
-阪＜祉若吾違＜ゃ絎障
+このコマンドに関するヘルプ情報を出力します。
.LP
-.RE
.LP
-\f4\-Joption\fP
+\f4\-V \-\-version\fP
.LP
-.RS 3
-
+.LP
+このコマンドに関するバージョン情報を出力します。
.LP
.LP
-\f2pack200\fP ｃ若喝冴 Java 莎桁若激с潟羝＜障違\f2\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟 \f2\-X\fP у障ｃ障\f2pack200\fP 罔羣激с潟с障\f2\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f4\-J\fP\f2option\fP
+.LP
.LP
-.RE
-.RE
-.SH "腟篋鴻若帥"
+\f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.LP
-
+.SH "終了ステータス"
.LP
.LP
-罨＜腟篋ゃ菴障
-.LP
-.RS 3
-
+次の終了値が返されます。
.LP
.LP
-\f2\ 0\fP ""
+\f2\ 0\fP 正常終了した場合
.LP
.LP
-\f2>0\fP ""
+\f2>0\fP エラーが発生した場合
.LP
-.RE
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -412,35 +330,33 @@
.TP 2
o
.na
-\f2Java SE ャ＜潟\fP @
+\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
-\f2Java ゃ \- Pack200\fP @
+\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
-jar(1) \- Java Archive 若
+jar(1) \- Java Archive ツール」
.TP 2
o
-jarsigner(1) \- JAR 臀峨恰荐若若
+jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
-\f2attributes(5)\fP ャ≪若
+\f2attributes(5) の\fP マニュアルページ
.RE
.LP
-.SH "羈鋋"
-.LP
-
+.SH "注意事項"
.LP
.LP
-潟潟 \f2pack(1)\fP 羞桁сヨ遵с
+このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。
.LP
.LP
-SDK 篁絮 Java SE API 篁罕檎荀ゃｃ翫篁罕
+SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP
--- a/jdk/src/linux/doc/man/ja/policytool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/policytool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,84 +19,82 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH policytool 1 "02 Jun 2010"
+.TH policytool 1 "14 Apr 2011"
.LP
-.SH ""
-policytool \- PolicyTool 膊∞ GUI 若ｃｃ
+.SH "名前"
+policytool \- PolicyTool 管理 GUI ユーティリティー
.LP
-\f3policytool\fP 若ｃｃ GUI 腟宴у緇若吟弱ュ冴ャ若潟鴻激若＜ゃ茯炊吾障
+\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.RS 3
.TP 3
\
.TP 3
-policytool 膊∞若ｃｃ若絎茵障
+policytool 管理者ユーティリティーを実行します
\f4policytool\fP
.TP 3
-policytool 絎茵絎激若＜ゃ茯粋昭帥障
-\f4policytool\fP\f2 [\-file\ \fP\f2filename\fP\f2]\fP
+policytool を実行し、指定されたポリシーファイルを読み込みます
+\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP
.TP 3
\
.TP 3
-荀膣罨＜с
+以下にそれぞれの意味を示します。
.RS 3
.TP 3
file
-若激若＜ゃ茯粋昭 \f2policytool\fP 腓冴障
+ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
.TP 3
filename
-＜ゃ
+ファイル名
.RE
-.SH "茯"
+.SH "説明"
.LP
-\f3policytool\fP 若吟若若激若＜ゃ絎鴻膊∞純 GUI с荅括完ゃ
+\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、
.na
-\f2激若＜ゃ篏括∞若\fP @
+\f2「ポリシーファイル作成および管理ツール」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlс
-.SH "激с"
+http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。
+.SH "オプション"
.RS 3
.TP 3
file
-\f2filename\fP 茯粋昭帥障
-.SH "∫ｉ"
+\f2filename\fP を読み込みます。
+.SH "関連項目"
.na
-\f2Default Policy Implementation and Syntax\fP @
+\f2「Default Policy Implementation and Syntax」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
.br
.na
-\f2Policy Tool Users' Guide\fP @
+\f2「Policy Tool Users' Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
.br
.na
-\f2Security Permissions\fP @
+\f2「Security Permissions」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
.br
.na
-\f2Security Overview\fP @
+\f2「Security Overview」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
.br
--- a/jdk/src/linux/doc/man/ja/rmic.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/rmic.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmic 1 "02 Jun 2010"
+.TH rmic 1 "14 Apr 2011"
.LP
-.SH ""
-rmic \- Java RMI 潟潟ゃ
-.LP
-.RS 3
-
+.SH "名前"
+rmic \- Java RMI コンパイラ
.LP
.LP
-\f3rmic\fP ｃJRMP 障 IIOP 潟篏睡≪若吾с鴻帥鴻宴潟 Tie 鴻障障OMG IDL 障
+\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,12 +39,10 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmic\fP 潟潟ゃｃ≪若吾с鴻帥鴻宴潟鴻＜ゃ (JRMP 潟)潟鴻帥 Tie 鴻＜ゃ腟水 (IIOP 潟) 障≪若吾с絎茖鴻с鴻＜ゃJava 違潟域茯鴻潟潟ゃ障≪若絎茖鴻\f2java.rmi.Remote\fP ゃ潟帥с若鴻絎茖鴻с\f3rmic\fP 潟潟с劫鴻 \f3javac\fP 潟潟с潟潟ゃゅ宴若後絎綽荀障違鴻＜ゃ \f2HelloImpl\fP \f3rmic\fP 絎茵罨＜障
+\f3rmic\fP コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\f2java.rmi.Remote\fP インタフェースを実装するクラスです。\f3rmic\fP コマンドでのクラス名は、そのクラスが \f3javac\fP コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 \f2HelloImpl\fP で \f3rmic\fP を実行するには、次のようにします。
.LP
.nf
\f3
@@ -62,37 +54,32 @@
.LP
.LP
-\f2HelloImpl_Stub.class\fP ＜ゃ鴻宴若後篁 \f2hello\fP 泣ｃ篏障
+\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。
.LP
.LP
-≪若吾с鴻宴潟 JRMP 潟泣若弱眼潟ｃｃ若с絎≪若吾с絎茖若喝冴＜純帥障
+リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。
.LP
.LP
-≪若吾сTie鴻宴潟罕泣若弱眼潟ｃｃ若сIIOP 潟篏帥ｃゃ≪潟篆＜障
+リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。
.LP
.LP
-鴻帥≪若吾сゃ≪潟眼с篁ｇс 鴻帥≪若吾с＜純若喝冴絎≪若吾с絽檎泣若若篆＜綵劫蚊＜障ｃゃ≪潟≪若吾с吾с絎若鴻帥吾с障
-.LP
-.LP
- \f3rmic\fP с1.2 JRMP 鴻帥潟若吾с潟篏睡鴻帥鴻障 \f2\-v1.2\fP 激с潟絎翫篏с(5.0 篁ュс \f2\-vcompat\fP 激с潟сｃ羈) IIOP 潟鴻帥 Tie 鴻 \f2\-iiop\fP 激с潟篏睡障
+「スタブ」とは、リモートオブジェクトのクライアント側での代理です。スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。
.LP
.LP
-鴻帥≪若ゃ潟帥с若鴻絎茖≪若吾с絎茖絮ゃ潟帥с若鴻絎茖障JRMP 鴻帥≪若吾с篏絎茖≪若ゃ潟帥с若鴻絎茖сゃ≪潟ｃ鴻с Java 違潟域茯腟粋昭障羲膊絖篏睡с障IIOP 翫\f2PortableRemoteObject.narrow\fP ＜純篏帥違障
+デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。
+.LP
.LP
-.SH "激с"
+スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、\f2PortableRemoteObject.narrow\fP メソッドを使わなければなりません。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-bootclasspath path
-若鴻鴻＜ゃ篏臀若若ゃ障
+ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-classpath path
-\f3rmic\fP 鴻｢鴻絎障激с潟 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
-.RS 3
-
-.LP
+\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -100,11 +87,7 @@
.fl
\fP
.fi
-.RE
-箴腓冴障
-.RS 3
-
-.LP
+例を示します。
.nf
\f3
.fl
@@ -112,13 +95,9 @@
.fl
\fP
.fi
-.RE
.TP 3
\-d directory
-拷絮ゃ阪ｃ若絎障激с潟篏帥違鴻帥鴻宴潟 Tie ＜ゃ主ｃ絎с障違罨＜篏帥障
-.RS 3
-
-.LP
+生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。
.nf
\f3
.fl
@@ -126,49 +105,43 @@
.fl
\fP
.fi
-.RE
-\f2MyClass\fP 緇鴻帥鴻宴潟鴻 \f2/java/classes/foo\fP ｃ臀障\f2\-d\fP 激с潟絎翫\f2\-d\ .\fP絎荀障帥若蚊鴻宴若檎絮ゃ憜ｃ篏鴻帥Tie潟鴻宴潟＜ゃｃ主障(篁ュ若吾с潟 \f3rmic\fP с\f2\-d\fP 絎翫宴若檎絮ゃ篏阪＜ゃ鴻憜ｃ贋･主)
+MyClass から取得した \f2スタブとスケルトンクラスを\fP \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。)
.br
\
.TP 3
\-extdirs path
-ゃ潟鴻若≦宍罘純篏臀若若ゃ障
+インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-g
-絮紊違鴻井宴障с茵垽宴障
-.LP
+局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。
.TP 3
\-idl
-\f2rmic\fP ｃ絎鴻喝с鴻 OMG IDL 障IDL с違潟域茯箴絖絎ｈс吾с API 絎с障IDL ＜純潟若帥篁罕篏睡障 CORBA ゃ潟ｃ潟違箴篁紙荐茯с＜純潟若帥篏喝若喝冴茵с障荐茯Java C++ 障障荅括完
+\f2rmic\fP によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、
.na
\f2Java Language to IDL Mapping\fP @
.fi
-http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) с
+http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。
.LP
-\f2\-idl\fP 激с潟篏帥祉激с潟絎с障
+\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
-\-always 障 \-alwaysgenerate
-√鴻帥Tie IDL ュ鴻違с綣桁句眼障
+\-always または \-alwaysgenerate
+既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-factory
- IDL factory 若若篏帥障
+生成された IDL で factory キーワードを使います。
.TP 3
\-idlModule\ fromJavaPackage[.class]\ toIDLModule
-IDLEntity 宴若吾絎障箴腓冴障 \f2\-idlModule foo.bar my::real::idlmod\fP
+IDLEntity パッケージのマップを指定します。例を示します。 \f2\-idlModule foo.bar my::real::idlmod\fP
.TP 3
\-idlFile\ fromJavaPackage[.class]\ toIDLFile
-IDLEntity ＜ゃ絎障箴腓冴障 \f2\-idlFile test.pkg.X TEST16.idl\fP\
+IDLEntity ファイルのマップを指定します。例を示します。 \f2\-idlFile test.pkg.X TEST16.idl\fP\
.RE
-.LP
.TP 3
\-iiop
-\f2rmic\fP ｃJRMP 鴻帥鴻宴潟鴻篁ｃIIOP 鴻帥 Tie 鴻障鴻帥鴻≪若吾с若激сゃ≪潟泣若若若喝冴篆＜篏帥障≪若ゃ潟帥с若鴻鴻帥鴻綽荀с 鴻帥鴻ｃ≪若ゃ潟帥с若鴻絎茖障ゃ≪潟с≪若吾сс絎鴻帥с障帥ゃ鴻泣若弱眼х若若喝冴絎茖鴻ｃ鴻篏帥障絎茖鴻帥ゃ鴻綽荀с
+\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。
.LP
-\f2\-iiop\fP 篏帥ｃ \f2rmic\fP 若喝冴罨＜遵荀靘羣鴻帥 Tie 障
-.RS 3
-
-.LP
+\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。
.nf
\f3
.fl
@@ -182,66 +155,60 @@
.fl
\fP
.fi
-.RE
.LP
-\f2\-iiop\fP 激с潟篏帥祉激с潟絎с障
+\f2\-iiop\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
-\-always 障 \-alwaysgenerate
-√鴻帥Tie IDL ュ鴻違с綣桁句眼障
+\-always または \-alwaysgenerate
+既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-nolocalstubs
-祉鴻ゃ≪潟泣若若絲障鴻帥篏障
+同じプロセスのクライアントとサーバーに対して最適化されたスタブを作成しません。
.TP 3
\-noValueMethods
-\f2\-idl\fP 激с潟篏帥違障肴 IDL \f2valuetype\fP ＜純喝絖菴遵障＜純喝絖\f2valuetype\fP 翫激с潟с \f2\-idl\fP 激с潟篏帥 \f2\-noValueMethods\fP 激с潟絎障
+これは \f2\-idl\fP オプションとともに使われなければなりません。発行された IDL に、\f2valuetype\fP メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、\f2valuetype\fP の場合はオプションです。 \f2\-idl\fP オプションを使うときは、 \f2\-noValueMethods\fP オプションを指定しない限り生成されます。
.TP 3
\-poa
-膓帥 \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP \f2org.omg.PortableServer.Servant\fP 紊障
+継承が \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP から \f2org.omg.PortableServer.Servant\fP に変わります。
.LP
.na
\f2Portable Object Adapter\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) \f2PortableServer\fP ≪吾ャ若ゃｃ \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違＜純箴障 ＜純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫ｃ泣若潟篏九勝若吟若若若ゃ障OMG IDL to Java Language Mapping SpecificationCORBA V 2.3.1 ptc/00\-01\-08.pdf 羣障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は Java の \f2org.omg.PortableServer.Servant\fP クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。
.RE
.TP 3
\-J
-\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝＜障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
+\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。
.TP 3
-\-keep 障 \-keepgenerated
-鴻帥鴻宴潟障 Tie 鴻 \f2.java\fP 純若鴻＜ゃ \f2.class\fP ＜ゃｃ罧障
+\-keep または \-keepgenerated
+スタブ、スケルトン、または Tie クラスのための \f2.java\fP ソースファイルを \f2.class\fP ファイルと同じディレクトリに残します。
.TP 3
\-nowarn
-茘障激с潟絎潟潟ゃ茘茵腓冴障
-.LP
+警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。
+.TP 3
+\-nowrite
+コンパイルしたクラスをファイルシステムに書き込みません。
.TP 3
\-vcompat
-1.1 1.2 筝≧鴻 JRMP 鴻帥潟若吾с潟篋с鴻帥潟鴻宴潟鴻篏障(5.0 篁ュ若鴻с激с潟)鴻帥鴻JDK 1.1 篁潟激潟若 1.1 鴻帥潟若吾с潟篏睡JDK 1.2 篁ラ篁潟激潟若 1.2 鴻帥潟若吾с潟篏睡障鴻宴潟鴻с1.1 1.2 筝≧鴻鴻帥潟若吾с潟泣若障鴻筝≧鴻篏≪若泣若泣ゃ冴紊с障
+1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(5.0 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。
.TP 3
\-verbose
-潟潟ゃ潟若潟潟ゃ鴻若鴻＜ゃゃ＜祉若吾茵腓冴障
-.LP
+コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。
.TP 3
\-v1.1
-1.1 JRMP 鴻帥潟若吾с潟帥鴻帥潟鴻宴潟鴻障激с潟篏睡сJDK 1.1 \f3rmic\fP 若х≪違若с (ゃ鴻若ｃ潟違篏睡) √鴻帥鴻絲障翫篋с鴻帥鴻翫с
-.LP
+1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。
.TP 3
\-v1.2
-() 1.2 JRMP 鴻帥潟若吾с潟帥鴻帥鴻障鴻宴潟鴻 1.2 鴻帥潟若吾с潟т戎с激с潟с鴻宴潟鴻障鴻帥鴻JDK 1.1 篁潟激潟若篏障
+(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障罨＜箴腓冴障
-.RS 3
-
-.LP
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.nf
\f3
.fl
@@ -250,15 +217,12 @@
\fP
.fi
.RE
-.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-java(1)javac(1)
+java(1)、javac(1)、
.na
\f2CLASSPATH\fP @
.fi
--- a/jdk/src/linux/doc/man/ja/rmid.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/rmid.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmid 1 "02 Jun 2010"
+.TH rmid 1 "14 Apr 2011"
.LP
-.SH ""
-rmid \- Java RMI 莎桁激鴻若≪
-.LP
-.RS 3
-
+.SH "名前"
+rmid \- Java RMI 起動システムデーモン
.LP
.LP
-\f3rmid\fP ц儀激鴻若≪潟紮吾с篁潟激 (VM) 脂蚊莎桁с障
+\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,23 +39,21 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmid\fP 若莎桁激鴻若≪潟紮障莎桁激鴻若≪潟紮с莎桁純吾с莎桁激鴻脂蚊VM ц儀с障莎桁純≪若吾с篏帥ｃ違篏号荅括完
+\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、
.na
-\f2Java RMI 篁罕\fP @
+\f2「Java RMI 仕様」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html
+http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび
.na
-\f2莎桁ャ若≪\fP @
+\f2「起動のチュートリアル」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。
.LP
.LP
-若≪潟莎桁罨＜祉ャｃ若激若＜ゃ絎 \f2rmid\fP 潟潟絎茵障
+デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。
.LP
.nf
\f3
@@ -73,23 +65,23 @@
.LP
.LP
-\f3羈:\fP\f2rmid\fP Sun 絎茖絎茵翫с祉ャｃ若激若＜ゃ絎綽荀障 莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡с \f2rmid\fP 罎荐若сс鴻\f2ActivationGroupDesc\fP 潟潟鴻帥羝＜ \f2CommandEnvironment\fP 篁紙 \f2Properties\fP ｃ絎潟潟潟激с潟\f2rmid\fP 祉ャｃ若激若＜ゃ筝ф腓榊荐怨綽荀障\f2sun.rmi.activation.execPolicy\fP ｃ若ゃ莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡сゆ \f2rmid\fP 篏睡激若羆阪障
+\f3注:\fP \f2rmid\fP の Sun の 実装を実行する場合、デフォルトでは、セキュリティーポリシーファイルを指定する必要があります。それは、 \f2rmid\fP が起動グループ用に VM を起動するために各 \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを検証できるようにするためです。特に、ActivationGroupDesc のコンストラクタに渡される \f2CommandEnvironment\fP や任意の \f2Properties\fP によって指定される \f2コマンドおよび\fPオプションは、 \f2rmid\fP のセキュリティーポリシーファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fP プロパティーの値は、 \f2起動グループ用に VM を\fP 起動するために \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを判断するときに rmid が使用するポリシーを決定します。
.LP
.LP
-\f2rmid\fP 荐絎у茵罨＜茵障
+\f2rmid\fP をデフォルト設定で実行すると、次のような処理が行われます。
.LP
.RS 3
.TP 2
o
-≪ｃ若帥莎桁若 1098 у吾鴻莎桁
+アクティベータを起動し、デフォルトポート 1098 で内部レジストリを起動する
.TP 2
o
-吾鴻筝с\f2ActivationSystem\fP \f2java.rmi.activation.ActivationSystem\fP ゃ潟
+この内部レジストリの中で、 \f2ActivationSystem\fP を \f2java.rmi.activation.ActivationSystem という名前に\fP バインドする
.RE
.LP
.LP
-吾鴻祉若絎\f2rmid\fP 莎桁 \f2\-port\fP 激с潟絎違障罨＜箴腓冴障
+レジストリにほかのポートを指定するには、rmid の起動時に \f2\-port\fP オプションを \f2指定しなければなりません\fP。次に例を示します。
.LP
.nf
\f3
@@ -101,44 +93,42 @@
.LP
.LP
-潟潟莎桁激鴻若≪潟紮吾鴻若 1099 с吾鴻紮障
+このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート 1099 でレジストリを開始します。
.LP
.SS
-rmid inetd/xinetd 紮
+rmid を inetd/xinetd から開始する
.LP
.LP
-\f2rmid\fP 潟潟茵紮\f2inetd\fP (Solaris 翫)障 \f2xinetd\fP (Linux) 罕 \f2rmid\fP 綽荀綽紮号障
+\f2rmid\fP をコマンド行から開始するには、 \f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux の場合) を構成して \f2rmid\fP を必要に応じて開始する方法もあります。
.LP
.LP
-\f2rmid\fP 紮\f2System.inheritedChannel\fP ＜純若喝冴膓帥ｃ潟 (\f2inetd\fP/\f2xinetd\fP 膓) 緇障膓帥ｃ潟 \f2null\fP с\f2java.nio.channels.ServerSocketChannel\fP ゃ潟鴻帥潟鴻сｃ翫\f2rmid\fP ｃ潟 \f2inetd\fP/\f2xinetd\fP ｃ莎桁сゆ菴違莎桁障
+\f2rmid\fP を開始すると、System.inheritedChannel メソッドを呼び出して、継承されたチャンネル ( \f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。 継承されたチャンネルが \f2null\fP であるか、 \f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、 \f2rmid\fP rmid はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
.LP
.LP
-膓帥ｃ潟 \f2ServerSocketChannel\fP ゃ潟鴻帥潟鴻с翫鴻若≪若吾сゃ障 \f2java.rmi.activation.ActivationSystem\fP ゃ潟吾鴻 \f2java.rmi.activation.Activator\fP ≪若吾с絲障荀羆篆＜泣若若純宴\f2ServerSocketChannel\fP 緇 \f2java.net.ServerSocket\fP \f2rmid\fP с篏睡障≪若с\f2rmid\fP 篏罨＜ゃ 潟潟茵莎桁翫с
+継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、 \f2rmid\fP はエクスポートするリモートオブジェクト、つまり java.rmi.activation.ActivationSystem がバインドされているレジストリと java.rmi.activation.Activator リモートオブジェクトに対する要求を受信するサーバーソケットとして、ServerSocketChannel から取得した java.net.ServerSocket を使用します。 このモードでは、 \f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。
.LP
.RS 3
.TP 2
o
-\f2System.err\fP 絲障阪＜ゃゃ＜ゃ \f2java.io.tmpdir\fP 激鴻ｃ若ф絎ｃ (絽吾 \f2/var/tmp\fP 障 \f2/tmp\fP) ＜ゃ･莨 \f2rmid\-err\fP с･絨乗 \f2"tmp"\fP с
+\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。ファイル名の接頭辞は \f2"rmid\-err"\fP で、接尾辞は \f2"tmp"\fP である
.TP 2
o
-\f2\-port\fP 激с潟激с潟絎\f2rmid\fP 若＜祉若吾冴腟篋
+\f2\-port\fP オプションは拒否される。このオプションを指定すると、 \f2rmid\fP はエラーメッセージを出して終了する
.TP 2
o
-\f2\-log\fP 激с潟綽激с潟絎\f2rmid\fP 若＜祉若吾冴腟篋
+\f2\-log\fP オプションは必須。このオプションを指定しないと、 \f2rmid\fP はエラーメッセージを出して終了する
.RE
.LP
.LP
-綽荀綽泣若鴻紮荐絎荅括完ゃ\f2inetd\fP (Solaris) 障 \f2xinetd\fP (Linux) ャ≪若吾с
+必要に応じてサービスを開始するように設定する詳細については、 \f2inetd\fP (Solaris) または \f2xinetd\fP (Linux) のマニュアルページを参照してください。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-C<someCommandLineOption>
-\f2rmid\fP 絖祉 (莎桁違若) 篏絖祉鴻潟潟茵綣違羝＜激с潟絎障違罨＜絎莎桁激鴻若 潟ｃ篁潟激潟ｃ若羝＜с障
+\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各仮想マシンにプロパティーを渡すことができます。
.nf
\f3
.fl
@@ -146,7 +136,7 @@
.fl
\fP
.fi
-潟潟茵綣違絖祉鴻羝＜罘純違茵翫箴水с違罨＜潟潟絎茵с障
+コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。
.nf
\f3
.fl
@@ -154,11 +144,11 @@
.fl
\fP
.fi
-潟潟鴻絖 VM с泣若弱若喝冴違篏障
+このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。
.LP
.TP 3
\-J<someCommandLineOption>
-\f2rmid\fP 絎茵 \f2java\fP ゃ潟帥帥羝＜激с潟絎障違\f2rmid\fP \f2rmid.policy\fP 激若＜ゃ篏睡絎\f2rmid\fP 潟潟茵 \f2\-J\fP 激с潟篏帥ｃ\f2java.security.policy\fP ｃ若絎臂障 罨＜箴腓冴障
+rmid を実行している \f2java\fP インタプリタに渡すオプションを指定します。 たとえば、 \f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、rmid のコマンド行で \f2\-J\fP オプションを使って、 \f2java.security.policy\fP プロパティーを定義します。 次に例を示します。
.nf
\f3
.fl
@@ -168,16 +158,15 @@
.fi
.TP 3
\-J\-Dsun.rmi.activation.execPolicy=<policy>
-莎桁違若絎茵 VM 莎桁篏睡潟潟潟潟潟茵激с潟с\f2rmid\fP ｡激若絎障激с潟Java RMI 莎桁若≪潟 Sun 絎茖絖羈潟潟茵ｃ若絎翫腟 \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP 絎翫障\f2<policy>\fP 絎純ゃ\f2default\fP\f2<policyClassName>\fP障 \f2none\fP с ゃゃ茯障
-.LP
+起動グループが実行されることになる VM の起動に使用するコマンドおよびコマンド行オプションをチェックするために、 \f2rmid\fP が採用するポリシーを指定します。このオプションは、Java RMI 起動デーモンの Sun の実装だけに存在することに注意してください。コマンド行にこのプロパティーを指定しない場合、結果は \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP を指定した場合と同じになります。\f2<policy>\fP に指定可能な値は、\f2default\fP、\f2<policyClassName>\fP、または \f2none\fP です。
.RS 3
.TP 2
o
-\f3default (障ｃ若絎翫)\fP
+\f3default (または、このプロパティーが「指定されていない」場合)\fP
.LP
- \f2execPolicy\fP 翫\f2rmid\fP 絎茵с\f2rmid\fP 篏睡 祉ャｃ若激若＜ゃ筝с絎茵罔 \f2rmid\fP 筝潟潟潟潟潟茵激с潟с絎茵激若т戎с莎桁違若絎茖с
+デフォルトの \f2execPolicy\fP の場合、 \f2rmid\fP が実行できるのは、 \f2rmid\fP が使用するセキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。
.LP
-\f2rmid\fP 莎桁違若 VM 莎桁違若ゃ脂蚊莎桁違若荐菴医с \f2ActivationGroupDesc\fP 宴篏睡障違若荐菴医\f2ActivationGroupDesc.CommandEnvironment\fP 絎障 (ュ) 莎桁違若紮潟潟潟潟茵菴遵с潟潟茵激с潟障障с\f2rmid\fP \f2java.home\fP \f2java\fP 潟潟篏睡障違若荐菴医激с潟潟潟茵菴遵ｃ若若若ゃ障障 ｃ若罨＜絎臂障
+\f2rmid は、\fP 起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、 \f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、 \f2rmid は\fP java.home にある \f2java\fP コマンドを使用します。 グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。このプロパティーは、次のように定義します。
.nf
\f3
.fl
@@ -186,33 +175,33 @@
\fP
.fi
.LP
-≪祉号┤ \f2com.sun.rmi.rmid.ExecPermission\fP 篏睡違若荐菴医 \f2CommandEnvironment\fP ф絎潟潟絎茵莎桁違若紮罔\f2rmid\fP 絲障荐怨с障≪祉号┤ \f2com.sun.rmi.rmid.ExecOptionPermission\fP 篏睡違若荐菴医сｃ若若若ゃ絎潟潟茵激с潟障 \f2CommandEnvironment\fP с激с潟絎潟潟茵激с潟莎桁違若紮 \f2rmid\fP 篏睡с障
+アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、 \f2rmid\fP に対して、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに rmid が使用できるようになります。
.LP
-\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障
+\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。
.RS 3
.TP 3
ExecPermission
-\f2ExecPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟絎茵罔茵障
+\f2ExecPermission\fP クラスは、起動グループを開始するために \f2rmid が\fP 特定の「コマンド」を実行する権限を表します。
.LP
-\f3罕\fP
+\f3構文\fP
.br
-\f2ExecPermission\fP \f2rmid\fP 絎茵荐怨潟潟劫с/* (/＜ゃ阪絖 \f2File.separatorChar\fP) х劫ｃ障鴻＜ゃ腓冴障/\-х劫ｃ障鴻＜ゃ泣ｃ (絽亥) 腓冴障劫劫ャ若潟<<ALL FILES>>絎翫\f3篁紙\fP＜ゃ腓冴障
+\f2ExecPermission\fP の「名前」は、 \f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 File.separatorChar) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。 「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。
.LP
-\f3羈:\fP* 1 ゆ絎劫憜ｃ鴻＜ゃ茵障 障\- 1 ゆ絎劫憜ｃ鴻＜ゃ憜ｃ障鴻＜ゃ泣ｃ (絽亥) 茵障
+\f3注:\fP 「*」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルを表します。また、「\-」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルと、現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
.TP 3
ExecOptionPermission
-\f2ExecOptionPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟茵激с潟篏睡с罔茵障\f2ExecOptionPermission\fP 潟潟茵激с潟ゃс
+\f2ExecOptionPermission\fP クラスは、起動グループを開始するときに \f2rmid は、起動グループを開始するコマンドをまったく検証しません。\fP 特定のコマンド行「オプション」を使用できる権限を表します。 \f2ExecOptionPermission\fP の「名前」は、コマンド行オプションの値です。
.LP
-\f3罕\fP
+\f3構文\fP
.br
-激с潟сゃ若絎泣若障≪鴻帥鴻ゃ若茵障 ≪鴻帥鴻激с喝篏睡с障 ゃ障篁紙激с潟茵с障 障激с喝絨障篏睡с障 .=翫≪鴻帥鴻絎綽荀障
+オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。
.LP
-箴腓冴障*\-Dfoo.*\-Da.b.c=*鴻с*foo\-Da*bab*≦鴻с
+例を示します。「*」、「\-Dfoo.*」、「\-Da.b.c=*」は有効ですが、「*foo」、「\-Da*b」、「ab*」は無効です。
.TP 3
-rmid 激若＜ゃ
-\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障≪祉号┤с \f2rmid\fP с≪祉号┤羆荐怨絎с
+rmid のポリシーファイル
+\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。これらのアクセス権をチェックするのは \f2rmid\fP だけなので、これらのアクセス権を汎用的に許可しても安全です。
.LP
-\f2rmid\fP 腮絎茵罔荐怨激若＜ゃ箴罨＜腓冴障
+rmid に各種の実行権限を許可するポリシーファイルの例を、次に示します。
.nf
\f3
.fl
@@ -220,13 +209,7 @@
.fl
permission com.sun.rmi.rmid.ExecPermission
.fl
- "/files/apps/java/jdk1.2.2/solaris/bin/java";
-.fl
-
-.fl
- permission com.sun.rmi.rmid.ExecPermission
-.fl
- "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
+ "/files/apps/java/jdk1.7.0/solaris/bin/java";
.fl
.fl
@@ -256,29 +239,21 @@
.fl
\fP
.fi
- 2 ゃ篁筝≪祉号┤\f2rmid\fP 絲障劫腓榊絎 \f2java\fP 潟潟 \f2java_g\fP 潟潟 1.2.2 若吾с潟絎茵荐怨障с\f2java.home\fP 若吾с潟 \f2java\fP 潟潟 (\f2rmid\fP 篏睡若吾с) 篏睡潟潟激若＜ゃф絎綽荀障3 ≪祉号┤\f2rmid\fP 絲障ｃ \f2/files/apps/rmidcmds\fP 篁紙潟潟絎茵罔荐怨障
-.LP
-4 ≪祉号┤ \f2ExecOptionPermission\fP \f2rmid\fP 絲障祉ャｃ若激若＜ゃ \f2/files/policies/group.policy\fP 絎臂莎桁違若紮荐怨障5 ≪祉号┤莎桁違若 \f2java.security.debug\fP ｃ若篏睡荐怨障緇≪祉号┤莎桁違若 \f2sun.rmi\fP ｃ弱絮ゅ篁紙ｃ若篏睡荐怨障
+最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンド ( \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
.LP
-激若＜ゃ絎 \f2rmid\fP 莎桁\f2rmid\fP 潟潟茵 \f2java.security.policy\fP ｃ若絎綽荀障 罨＜箴腓冴障
-.RS 3
-
+3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。
.LP
+ポリシーファイルを指定して \f2rmid\fP を起動するには、rmid のコマンド行で \f2java.security.policy\fP プロパティーを指定する必要があります。 次に例を示します。
.LP
-\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
-.LP
+\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
.RE
-.RE
-.TP 2
-o
-.LP
.TP 2
o
\f4<policyClassName>\fP
.LP
-篏с荵с緇翫膊∞\f2rmid\fP 莎桁\f2checkExecCommand\fP ＜純絮鴻絎rmid 絎茵潟潟сс障
+デフォルトの動作では十分な柔軟性が得られない場合、管理者は、 \f2rmid\fP の起動時に、 \f2checkExecCommand\fP メソッドが所属するクラスの名前を指定して、rmid が実行するコマンドをチェックすることができます。
.LP
-\f2policyClassName\fP 綣違潟潟鴻帥＜罨＜ \f2checkExecCommand\fP ＜純絎茖 public 鴻絎障
+\f2policyClassName\fP には、引数なしのコンストラクタを持ち、次のような \f2checkExecCommand\fP メソッドを実装している public クラスを指定します。
.nf
\f3
.fl
@@ -290,22 +265,21 @@
.fl
\fP
.fi
-莎桁違若紮\f2rmid\fP 激若 \f2checkExecCommand\fP ＜純若喝冴障莎桁違若荐菴医莎桁違若紮絎潟潟＜純羝＜障\f2checkExecCommand\fP \f2SecurityException\fP 鴻若\f2rmid\fP 莎桁違若紮吾с莎桁荅茵若喝冴眼 \f2ActivationException\fP 鴻若障
-.LP
+起動グループを開始する前に、 \f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。 \f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、 \f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。
.TP 2
o
\f3none\fP
.LP
-\f2sun.rmi.activation.execPolicy\fP ｃ若ゃnone翫\f2rmid\fP 莎桁違若紮潟潟障ｃ閌荐若障
+\f2sun.rmi.activation.execPolicy\fP プロパティーの値が「none」の場合、 \f2rmid\fP は、起動グループを開始するコマンドをまったく検証しません。
.RE
.LP
.TP 3
\-log dir
-莎桁激鴻若≪潟若帥若鴻渇∫ｆ宴吾莨若篏帥ｃ絎障с\f2rmid\fP 潟潟絎茵ｃ\f2log\fP 違ｃ篏障
+起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに、 \f2log\fP というログディレクトリが作成されます。
.LP
.TP 3
\-port port
-\f2rmid\fP 吾鴻篏帥若絎障莎桁激鴻若≪潟吾鴻筝с\f2java.rmi.activation.ActivationSystem\fP \f2ActivationSystem\fP ゃ潟障ｃ若激割 \f2ActivationSystem\fP 罨＜ \f2Naming.lookup\fP ＜純若喝冴ｃ緇с障
+\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、 \f2java.rmi.activation.ActivationSystem\fP という名前でActivationSystem をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。
.nf
\f3
.fl
@@ -322,16 +296,16 @@
.fi
.TP 3
\-stop
-\f2\-port\fP 激с潟ｃ絎若憜 \f2rmid\fP 若喝冴罩≪障若絎翫若 1098 у茵 \f2rmid\fP 罩≪障
+\-port オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。 ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。
.RE
-.SH "医紊"
+
.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障箴腓冴障
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。
.nf
\f3
.fl
@@ -342,15 +316,13 @@
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-rmic(1)
+rmic(1)、
.na
\f2CLASSPATH\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathjava(1)
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1)
.LP
--- a/jdk/src/linux/doc/man/ja/rmiregistry.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/rmiregistry.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,18 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmiregistry 1 "02 Jun 2010"
+.TH rmiregistry 1 "14 Apr 2011"
.LP
-.SH ""
-rmiregistry \- Java ≪若吾с吾鴻
+.SH "名前"
+rmiregistry \- Java リモートオブジェクトレジストリ
.LP
.RS 3
+\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。
+.RE
.LP
-.LP
-\f3rmiregistry\fP 潟潟憜鴻絎若筝≪若吾с吾鴻紮障
-.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,52 +41,43 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmiregistry\fP 潟潟憜鴻絎 \f2port\fP 筝≪若吾с吾鴻篏紮障\f2port\fP 絎ャ翫吾鴻若 1099 ч紮障\f3rmiregistry\fP 潟潟阪罘純障絽吾違潟у茵障箴腓冴障
+\f3rmiregistry\fP コマンドは、現在のホストの指定 \f2port\fP 上にリモートオブジェクトレジストリを作成し、開始します。\f2port\fP の指定を省略した場合、レジストリはポート 1099 で開始します。\f3rmiregistry\fP コマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。例を示します。
.LP
.LP
\f2rmiregistry&\fP
.LP
.LP
-≪若吾с吾鴻若鴻若泣若鴻с 筝鴻 RMI 泣若若≪若吾сゃ潟篏睡障罨＜若潟≪若鴻ゃ≪潟≪若吾с罎膣≪≪若＜純若喝冴茵障
+リモートオブジェクトレジストリは、ブートストラップのネームサービスです。同一ホストの RMI サーバーが、リモートオブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモートホストのクライアントはリモートオブジェクトを検索し、リモートメソッドの呼び出しを行います。
.LP
.LP
-吾鴻筝≪若吾с篏臀絎障 с≪宴若激с潟＜純若喝冴綽荀障篁ｃｃ吾с≪宴若激с恰絎泣若箴篁吾с｢障
+レジストリは、一般的に、最初のリモートオブジェクトの位置を指定します。 そこで、アプリケーションはメソッドを呼び出す必要があります。代わって、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
.LP
.LP
-\f2java.rmi.registry.LocateRegistry\fP 鴻＜純若鴻障若鴻若у篏吾鴻緇篏睡障
+\f2java.rmi.registry.LocateRegistry\fP クラスのメソッドは、ローカルホスト、またはローカルホストとポートで動作するレジストリを取得するために使用されます。
.LP
.LP
-\f2java.rmi.Naming\fP 鴻 URL 若鴻＜純吾鴻у篏篁紙鴻潟若鴻筝≪若吾с罎膣≪篏睡障≪若吾с膣 (絖) ゃ潟違ゃ潟 (ゃゃ潟若若ゃ) 障 障≪若吾с≪潟ゃ潟吾鴻ゃ潟 URL 阪障
+\f2java.rmi.Naming\fP クラスの URL ベースのメソッドは、レジストリで動作し、任意のホストおよびローカルホスト上のリモートオブジェクトの検索に使用されます。リモートオブジェクトに単純な (文字列) 名前をバインドしたり、新しい名前をリバインド (古いバインドにオーバーライド) します。またリモートオブジェクトをアンバインドしたり、レジストリにバインドされた URL を出力します。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-J
-\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝＜障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
+\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
-
-.LP
-.LP
-java(1)
+java(1)、
.na
\f2java.rmi.registry.LocateRegistry\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html
+http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および
.na
\f2java.rmi.Naming\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
-.LP
-
+http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
--- a/jdk/src/linux/doc/man/ja/schemagen.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/schemagen.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,110 +19,106 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH schemagen 1 "02 Jun 2010"
+.TH schemagen 1 "14 Apr 2011"
.LP
-.SH ""
-schemagen \- XML ゃ潟 Java(TM) ≪若ｃ若鴻若吾с若
-.LP
-.LP
-\f3篁罕若吾с:\fP 2.1
-.br
-\f3絎茖若吾с:\fP 2.1.3
-.LP
-.SS
-schemagen 莎桁
+.SH "名前"
+schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ
.LP
.LP
-鴻若吾с若帥若吟若若 \f2bin\fP ｃ \f2schemagen\fP 激с鴻篏帥ｃ莎桁с障
+\f3仕様バージョン:\fP 2.1
+.br
+\f3実装バージョン:\fP 2.1.3
.LP
-.LP
-憜鴻若吾с若帥Java 純若鴻＜ゃ鴻＜ゃс障
+.SH "schemagen の起動"
.LP
.LP
-障鴻若吾с若帥絎茵 Ant 帥鴻障
+スキーマジェネレータを起動するには、ユーザーのプラットフォームの bin ディレクトリ内にある \f2適切な schemagen シェルスクリプト\fP を使用 \f2します\fP 。
+.LP
+.LP
+現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
+.LP
+.LP
+また、スキーマジェネレータを実行するための Ant タスクも用意されています。
.na
-\f2schemagen Ant 篏睡\fP @
+\f2schemagen を Ant とともに使用する\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlс
-.LP
-.RS 3
-
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。
.LP
.nf
\f3
.fl
% schemagen.sh Foo.java Bar.java ...
.fl
-羈: Writing schema1.xsd
+Note: Writing schema1.xsd
.fl
\fP
.fi
-.RE
.LP
.LP
-若吟若 Java 純若/鴻祉鴻с翫激鴻 CLASSPATH 医紊亥宴с鴻≪祉鴻сｃ \f2\-classpath\fP/\f2\-cp\fP 激с潟篏帥ｃ鴻若絎綽荀障鴻若若榊障
-.LP
-.RS 3
-
+ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP を使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
.LP
-\f3潟潟茵激с\fP
-.LP
-.RS 3
-
+.SS
+コマンド行オプション
.LP
.nf
\f3
.fl
-篏睡号: schemagen [\-options ...] <java files>
+使用方法: schemagen [\-options ...] <java files>
.fl
.fl
-激с:
+オプション:
+.fl
+ \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します。
.fl
- \-d <path> : 祉泣 javac 鴻＜ゃ臀贋絎障
+ \-cp <path> : ユーザー指定ファイルの検索場所を指定します。
+.fl
+ \-classpath <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
- \-cp <path> : 若吟惹絎＜ゃ罎膣√贋絎障
+ \-encoding <encoding> : apt/javac 呼び出しに使用されるエンコーディングを指定します。
+.fl
+
.fl
- \-classpath <path> : 若吟惹絎＜ゃ罎膣√贋絎障
+ \-episode <file> : 個別コンパイル用のエピソードファイルを生成します。
.fl
- \-help : 篏睡号≪＜祉若吾茵腓冴障
+ \-version : バージョン情報を表示します。
+.fl
+ \-help : この使用方法に関するメッセージを表示します。
.fl
\fP
.fi
-.RE
.LP
-.RE
-.SS
-純若鴻＜ゃ
+.SH "生成されるリソースファイル"
.LP
.LP
-憜鴻若吾с若帥膣Java 劫ус腥咲 1 ゃ鴻若＜ゃ篏障鴻若＜ゃ九勝号憝鴻с絖障
+現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、
.na
-\f2鴻若吾с若帥 Ant 帥鴻\fP @
+\f2スキーマジェネレータの ant タスク\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html篏睡
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlを使用してください。
.LP
-.SH "∫ｉ"
+.SH "名前"
+関連項目
.LP
.RS 3
.TP 2
o
-鴻若吾с若帥絎茵 (schemagen):[
+スキーマジェネレータの実行 (schemagen): [
.na
-\f2潟潟茵巡擦\fP @
+\f2コマンド行の命令\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html、
.na
-\f2SchemaGen Ant 篏睡\fP @
+\f2SchemaGen を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
.TP 2
o
.na
-\f2XML ゃ潟 JavaTM ≪若ｃ (JAXB)\fP @
+\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
--- a/jdk/src/linux/doc/man/ja/serialver.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/serialver.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH serialver 1 "02 Jun 2010"
+.TH serialver 1 "14 Apr 2011"
.LP
-.SH ""
-serialver \- 激≪若吾с潟潟潟
-.LP
-.RS 3
-
+.SH "名前"
+serialver \- シリアルバージョンコマンド
.LP
.LP
-\f3serialver\fP 潟潟 \f2serialVersionUID\fP 菴障
+\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,74 +39,54 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-ャ＜潟ц潟潟茵激с潟с
+このドキュメントで説明されているコマンド行オプションです。
.TP 3
classnames
-1 や札筝劫с
+1 つ以上のクラス名です。
.RE
.LP
-.RE
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3serialver\fP 1 や札筝鴻 \f2serialVersionUID\fP 絮鴻吾潟若綵√ц障綣違絎у若喝冴篏睡号茵腓冴障
+\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-\-classpath <: у阪ｃ zip jar ＜ゃ>
-≪宴若激с潟鴻潟純若鴻罎膣≪鴻荐絎障
+\-classpath <: で区切られたディレクトリと zip や jar ファイル>
+アプリケーションのクラスおよびリソースの検索パスを設定します。
.RE
.LP
.RS 3
.TP 3
\-show
-膂≦若吟若ゃ潟帥с若鴻茵腓冴障絎絎劫ュEnter 若 [Show] 帥潟若激≪若吾с UID 茵腓冴障
+簡単なユーザーインタフェースを表示します。完全指定のクラス名を入力して、Enter キーか「Show」ボタンを押し、シリアルバージョン UID を表示します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "羈"
-.LP
-
+.SH "注"
.LP
.LP
-\f3serialver\fP 潟潟絎鴻篁潟激喝茯粋昭у障с祉ャｃ若若吾ｃ若荐絎茵障篆♂若с鴻 \f3serialver\fP 絎茵翫罨＜激с潟篏帥ｃ祉ャｃ若若吾ｃ若荐絎с障
-.LP
-.RS 3
-
+\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。
.LP
.LP
\f2\-J\-Djava.security.manager\fP
.LP
-.RE
.LP
-障綽荀с違罨＜激с潟篏帥ｃ祉ャｃ若激若絎с障
-.LP
-.RS 3
-
+また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。
.LP
.LP
\f2\-J\-Djava.security.policy=<policy file>\fP
.LP
-.RE
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
.na
--- a/jdk/src/linux/doc/man/ja/servertool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/servertool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,20 +19,14 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH servertool 1 "02 Jun 2010"
+.TH servertool 1 "14 Apr 2011"
.LP
-.SH ""
-servertool \- Java(TM) IDL 泣若若若
-.LP
-.RS 3
-
+.SH "名前"
+servertool \- Java(TM) IDL サーバーツール
.LP
-\f3servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障
-.RE
-.SH "綵√"
-.LP
-
+\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。
+.SH "形式"
.LP
.nf
\f3
@@ -44,84 +38,76 @@
.LP
.LP
-潟潟ュ \f2servertool\fP 莎桁潟潟茵若 \f2servertool >\fP 潟茵腓冴障\f2servertool >\fP 潟潟潟ュ障
+コマンドを入力しないで \f2servertool\fP を起動すると、コマンド行ツールとして \f2servertool >\fP プロンプトが表示されます。\f2servertool >\fP プロンプトにコマンドを入力します。
.LP
.LP
-潟潟ュ \f2servertool\fP 莎桁Java IDL 泣若若若莎桁潟潟絎茵腟篋障
+コマンドを入力して \f2servertool\fP を起動すると、Java IDL サーバーツールが起動し、コマンドを実行して終了します。
.LP
.LP
-\f2\-ORBInitialPort\fP \f2nameserverport\fP 激с潟\f3綽\fPс\f2nameserverport\fP ゃ\f2orbd\fP 絎茵篆∴羆緇罘若絎綽荀障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 \f2nameserverport\fP 1024 障 1024 紊с若篏睡с障
+\f2\-ORBInitialPort\fP \f2nameserverport\fP オプションは\f3必須\fPです。 \f2nameserverport\fP の値には、\f2orbd\fP が実行され、着信要求を待機しているポートを指定する必要があります。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、\f2nameserverport\fPとして 1024 以上のポート番号を使用することをお勧めします。
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f2servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障祉泣若若≪障障腟沿宴緇潟潟箴障
+\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-ORBInitialHost nameserverhost
-若泣若若絎茵篆∴羆緇罘鴻激潟絎障激с潟絎翫\f2nameserverhost\fP \f2localhost\fP 荐絎障\f2orbd\fP \f2servertool\fP 違激割у茵翫\f2orbd\fP 絎茵鴻 IP ≪鴻絎綽荀障
+ネームサーバーが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、\f2nameserverhost\fP はデフォルトで \f2localhost\fP に設定されます。\f2orbd\fP と \f2servertool\fP が異なるマシン上で実行されている場合は、\f2orbd\fP が実行されているホストの名前と IP アドレスを指定する必要があります。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.SH "潟潟"
-.LP
-
+.SH "コマンド"
.LP
.RS 3
.TP 3
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
-Object Request Broker Daemon (ORBD) 域膓泣若若脂蚊障泣若若脂蚊翫脂蚊莎桁障潟潟ｃ\f2\-server\fP 激с潟цャ泣若若＜ゃ潟劫сゃ潟鴻若＜純若喝冴障ゃ潟鴻若＜純\f2public static void install(org.omg.CORBA.ORB)\fP ｃ綽荀障ゃ潟鴻若＜純激с潟с若帥若鴻鴻若篏泣若若ゃ潟鴻若篏肴絎с障
+Object Request Broker Daemon (ORBD) に新規持続サーバーを登録します。サーバーが未登録の場合、登録して起動します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でインストールメソッドが呼び出されます。このインストールメソッドは、\f2public static void install(org.omg.CORBA.ORB)\fP になっている必要があります。インストールメソッドは、オプションであり、データベーススキーマの作成などの独自のサーバーインストール動作を開発者が指定できます。
.TP 3
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-泣若 ID 障≪宴若激с喝篏睡ORBD 泣若若脂蚊茹ｉゃ障潟潟ｃ\f2\-server\fP 激с潟цャ泣若若＜ゃ潟劫с≪潟ゃ潟鴻若＜純若喝冴障≪潟ゃ潟鴻若＜純\f2public static void uninstall(org.omg.CORBA.ORB)\fP ｃ綽荀障≪潟ゃ潟鴻若＜純激с潟сゃ潟鴻若＜純篏羔泣若若≪潟ゃ潟鴻若篏肴絎с障
+サーバー ID またはアプリケーション名を使用して、ORBD のサーバーの登録を解除します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でアンインストールメソッドが呼び出されます。このアンインストールメソッドは、\f2public static void uninstall(org.omg.CORBA.ORB)\fP になっている必要があります。アンインストールメソッドは、オプションであり、インストールメソッドの動作の取り消しなどの独自のサーバーアンインストール動作を開発者が指定できます。
.TP 3
getserverid \-applicationName\ <application\ name>
-≪宴若激с潟∫ｄ泣若 ID 菴障
+アプリケーションに関連付けられているサーバー ID を返します。
.TP 3
list
-ORBD 脂蚊鴻膓泣若若≪宴筝荀ц；腓冴障
+ORBD に登録されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
listappnames
-憜 ORBD 脂蚊鴻泣若若≪宴若激с喝筝荀ц；腓冴障
+現在 ORBD に登録されているすべてのサーバーのアプリケーション名を一覧表示します。
.TP 3
listactive
-ORDB ｃ莎桁憜絎茵鴻膓泣若若≪宴筝荀ц；腓冴障
+ORDB によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
-脂蚊泣若若т鴻 ORB 劫ゃ腴 (若) 罎冴障泣若若絎茵翫莎桁障腴鴻絎翫泣若若 ORB ∫ｄ plain 障 non\-protected 腴鴻菴障
+登録されたサーバーで作成したすべての ORB の特定の型について端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。端点の型が指定されていない場合、サーバーの ORB ごとに関連付けられている plain 型 または non\-protected 型の端点が返されます。
.TP 3
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
-脂蚊泣若若劫 ORB х脂蚊腴 (若) 罎冴障泣若若絎茵翫莎桁障\f2orbid\fP 絎翫ゃ""\f2orbid\fP蚊綵障ORB 腥堺絖 \f2orbid\fP т翫脂蚊若鴻菴障
+登録されたサーバーの特定の ORB で登録された端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。\f2orbid\fP が指定されていない場合は、デフォルト値の「""」が\f2orbid\fPに割り当てられます。ORB が空文字列の \f2orbid\fP で作成されている場合、登録したポートがすべて返されます。
.TP 3
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-泣若寂絎臂 ORB ORBId 筝荀ц；腓冴障ORBId 泣若若т ORB 絖с泣若若絎茵翫莎桁障
+サーバー上に定義された ORB の ORBId を一覧表示します。ORBId はサーバーで作成された ORB の文字列名です。サーバーが実行されていない場合、起動されます。
.TP 3
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-ORBD 脂蚊≪ｃ泣若若罩≪障潟潟絎茵筝\f2\-serverid\fP ＜若帥障 \f2\-applicationName\fP ＜若帥ф絎劫絎臂 \f2shutdown()\fP ＜純若喝冴泣若若祉鴻罩ｃ罩≪障
+ORBD に登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\f2\-serverid\fP パラメータまたは \f2\-applicationName\fP パラメータで指定されたクラス内に定義された \f2shutdown()\fP メソッドも呼び出されてサーバープロセスを正しく停止します。
.TP 3
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-ORBD 脂蚊泣若若莎桁障泣若若絎茵翫潟潟с泣若若莎桁障泣若若с絎茵翫若吟若若＜祉若吾菴障
+ORBD に登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーを起動します。サーバーがすでに実行されている場合は、ユーザーにエラーメッセージが返されます。
.TP 3
help
-泣若若泣若若若т戎с鴻潟潟茵腓冴障
+サーバーがサーバーツールで使用できるすべてのコマンドを表示します。
.TP 3
quit
-泣若若若腟篋障
+サーバーツールを終了します。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
orbd(1)
--- a/jdk/src/linux/doc/man/ja/tnameserv.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/tnameserv.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,59 +19,59 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH tnameserv 1 "02 Jun 2010"
+.TH tnameserv 1 "14 Apr 2011"
.LP
-.SH ""
-Java IDL:筝若泣若 \- \f2tnameserv\fP
+.SH "名前"
+Java IDL: 一時ネームサービス \- \f2tnameserv\fP
.LP
.LP
-ャ＜潟сJava IDL 筝若泣若 \f2tnameserv\fP 篏睡号ゃ茯障Java IDL Object Request Broker Daemon (ORBD) 障障ORBD 若鴻泣若鴻筝若泣若鴻\f3膓\fP若泣若鴻潟泣若若若吾ｃ若若≪潟祉鴻сJava IDL 鴻ャ若≪с ORBD 篏睡障筝若泣若鴻篏睡箴с\f2orbd\fP 篁ｃ \f2tnameserv\fP 篏睡с障\f2orbd\fP 若荅括完ゃ\f2orbd\fP orbd(1)障
+このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には、Object Request Broker Daemon (ORBD) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャーを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD を使用していますが、一時ネームサービスを使用する例では、\f2orbd\fP の代わりに \f2tnameserv\fP を使用できます。\f2orbd\fP ツールの詳細については、orbd の orbd(1)または
.na
-\f2ORBD 障 Java IDL 若泣若\fP @
+\f2ORBD に含まれる Java IDL ネームサービス\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html≪с
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。
.LP
.LP
-с篁ヤゃ茯障
+ここでは、以下の項目について説明します。
.LP
.RS 3
.TP 2
o
-Java\ IDL 筝若泣若
+Java\ IDL 一時ネームサービス
.TP 2
o
-Java\ IDL 筝若泣若鴻莎桁
+Java\ IDL 一時ネームサービスの起動
.TP 2
o
-Java\ IDL 筝若泣若鴻罩
+Java\ IDL 一時ネームサービスの停止
.TP 2
o
-泣潟ゃ≪潟:腥咲吾吾с菴遵
+サンプルクライアント: 名前空間へのオブジェクトの追加
.TP 2
o
-泣潟ゃ≪潟:腥咲
+サンプルクライアント: 名前空間のブラウズ
.RE
.LP
-.SH "Java\ IDL 筝若泣若"
+.SH "Java IDL 一時ネームサービス"
.LP
.LP
-CORBA COS (Common Object Services) 若泣若鴻＜ゃ激鴻＜ゃ絲障ｃ罕箴吾сс絲障惹ｃ箴障Java IDL 筝若泣若鴻с \f2tnameserv\fP COS 若泣若鴻篁罕膣綵≪у茖с
+CORBA の COS (Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDL の一時ネームサービスである \f2tnameserv\fP は、COS ネームサービスの仕様を単純な形で実装したものです。
.LP
.LP
-吾сс腥咲ф主吾сс≪若ゃ潟ｃ潟違若違障若ゃ潟ｃ潟違若潟違潟潟鴻腟粋昭с障若潟違潟潟鴻篏若ゃ潟ｃ潟違с＜ゃ激鴻泣ｃ膩罘純＜障鴻ゃ潟ｃ潟違若潟違潟潟鴻主障腥咲若潟違潟潟鴻筝膓ゃ潟ｃ潟違с 篁ュ若潟違潟潟鴻Java IDL 若潟違泣若鴻祉鴻罩≪莎桁紊宴障
+オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納されます。名前空間において、初期ネーミングコンテキストは唯一の持続的バインディングです。それ以外のネーミングコンテキストは、Java IDL のネーミングサービスプロセスが停止し、再起動されると失われます。
.LP
.LP
-≪障≪宴若激с潟 COS 若泣若鴻篏睡 ORB 若泣若鴻篏鴻若ャｃ若泣若鴻絖若潟違潟潟鴻≪祉鴻с違障若泣若鴻Java\ IDL 若泣若鴻с篁 COS 羣若泣若鴻с障障
+アプレットまたはアプリケーションから COS ネームサービスを使用するためには、その ORB はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの文字列化された初期ネーミングコンテキストにアクセスできなければなりません。ネームサービスは、Java IDL のネームサービスでもその他の COS 準拠のネームサービスでもかまいません。
.LP
-.SH "Java\ IDL 筝若泣若鴻莎桁"
+.SH "Java IDL 一時ネームサービスの起動"
.LP
.LP
-Java\ IDL 若泣若鴻若泣若鴻篏睡≪宴若激с潟障≪莎桁違障Java\ IDL 茖遵ゃ潟鴻若Java IDL 若泣若鴻莎桁鴻 (Solaris: \f2tnameserv\fP) 絎茵純＜ゃ (Windows NT: \f2tnameserv.exe\fP) 篏障違潟у篏若泣若鴻莎桁
+Java IDL ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。バックグラウンドで動作するように、ネームサービスを起動してください。
.LP
.LP
-鴻絎翫Java IDL 若泣若鴻ORB \f2resolve_initial_references()\fP ＜純 \f2list_initial_references()\fP ＜純絎茖篏睡若鴻潟絲障若 900 у罘障
+特に指定しない場合、Java IDL ネームサービスは、ORB の \f2resolve_initial_references()\fP メソッドと \f2list_initial_references()\fP メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
.LP
.nf
\f3
@@ -83,7 +83,7 @@
.LP
.LP
-若泣若若若絎翫с若 900 篏睡障Solaris 純с≪絎茵1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 1050 ャ若絎若泣若鴻違潟у茵UNIX 潟潟激сф＜ュ障
+ネームサーバーポートを指定しない場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアの実行時は、1024 より小さいポートでプロセスを開始する場合、root ユーザーになる必要があります。このため、1024 または 1024 よりも大きいポート番号を使用することをお勧めします。1050 のように別のポートを指定し、ネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルで次のように入力します。
.LP
.nf
\f3
@@ -95,7 +95,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -107,32 +107,32 @@
.LP
.LP
-若泣若若ゃ≪潟違若垩ャ綽荀障ORB 吾с篏 \f2org.omg.CORBA.ORBInitialPort\fP ｃ若違若垩荐絎障
+ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティーに新しいポート番号を設定します。
.LP
.SS
-違激割сゃ≪潟泣若若絎茵
+異なるマシン上でのクライアントとサーバーの実行
.LP
.LP
-Java IDL RMI\-IIOP 祉ャ若≪с若泣若鴻泣若若潟ゃ≪潟鴻榊激割у茵障絎翫ゃ≪潟泣若若若泣若鴻違鴻筝у茵紊障
+Java IDL と RMI\-IIOP のほとんどのチュートリアルでは、ネームサービス、サーバー、およびクライアントはすべて開発用のマシン上で実行されます。実際に配備する場合には、クライアントとサーバーを、ネームサービスとは異なるホスト上で実行することが多くなります。
.LP
.LP
-ゃ≪潟泣若若若泣若鴻荀ゃゃ≪潟泣若若若泣若鴻絎茵若垩鴻茯茘綽荀障ゃ≪潟泣若若＜ゃ \f2org.omg.CORBA.ORBInitialPort\fP ｃ若 \f2org.omg.CORBA.ORBInitialHost\fP ｃ若若泣若鴻絎茵若垩激潟荐絎障箴
+クライアントとサーバーがネームサービスを見つけるには、クライアントとサーバーが、ネームサービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP プロパティーと \f2org.omg.CORBA.ORBInitialHost\fP プロパティーをネームサービスが実行されているポートの番号とマシンの名前に設定します。この例は、
.na
-\f2RMI\-IIOP 篏帥ｃ Hello World 箴\fP @
+\f2「RMI\-IIOP を使った Hello World の例」に示されています。\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html腓冴障潟潟茵激с \f2\-ORBInitialPort\fP \f2nameserverport#\fP \f2\-ORBInitialHost\fP \f2nameserverhostname\fP 篏睡ゃ≪潟泣若若絲障若泣若鴻｢贋絎с障
+http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlコマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使用して、クライアントとサーバーに対してネームサービスを探す場所を指定することもできます。
.na
-\f2Java IDL: 2 伹激割у茵 Hello World 違\fP @
+\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html 潟潟茵激с潟篏睡絎号腓冴障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。
.LP
.LP
-違筝若泣若 \f2tnameserv\fP 鴻 \f2nameserverhost\fP 若 1050 筝у茵障ゃ≪潟鴻 \f2clienthost\fP 筝у茵泣若若鴻 \f2serverhost\fP 筝у茵障
+たとえば、一時ネームサービス \f2tnameserv\fP が、ホスト \f2nameserverhost\fP のポート 1050 上で実行されているとします。さらに、クライアントがホスト \f2clienthost\fP 上で実行され、サーバーはホスト \f2serverhost\fP 上で実行されているとします。
.LP
.RS 3
.TP 2
o
-罨＜鴻 \f2nameserverhost\fP 筝 \f2tnameserv\fP 莎桁障
+次のように、ホスト \f2nameserverhost\fP 上で \f2tnameserv\fP を起動します。
.nf
\f3
.fl
@@ -144,7 +144,7 @@
.fi
.TP 2
o
-\f2serverhost\fP 筝с泣若若莎桁障
+\f2serverhost\fP 上でサーバーを起動します。
.nf
\f3
.fl
@@ -154,7 +154,7 @@
.fi
.TP 2
o
-\f2clienthost\fP 筝сゃ≪潟莎桁障
+\f2clienthost\fP 上でクライアントを起動します。
.nf
\f3
.fl
@@ -166,38 +166,34 @@
.LP
.SS
-\-J 激с
+\-J オプション
.LP
-潟潟茵激с潟\f2tnameserve\fP 篏睡с障
-.RS 3
-
-.LP
+このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。
.RS 3
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.RE
-.SH "Java\ IDL 筝若泣若鴻罩"
+.SH "Java IDL 一時ネームサービスの停止"
.LP
.LP
-Java IDL 若泣若鴻罩≪Unix 翫\f2kill\fP 若ｃ潟違激鴻潟潟篏帥Windows 翫\f2Ctrl\-C\fP 篏帥障若泣若鴻腓榊罩≪障с若喝冴緇罘倶膓障泣若鴻腟篋Java\ IDL 若泣若鴻脂蚊紊宴障
+Java IDL ネームサービスを停止するには、Unix の場合は、\f2kill\fP などのオペレーティングシステムのコマンドを使い、Windows の場合は、\f2Ctrl\-C\fP を使います。ネームサービスを明示的に停止するまでは、呼び出し待機状態が続きます。なお、サービスを終了させると、Java IDL ネームサービスに登録されている名前は失われます。
.LP
-.SH "泣潟ゃ≪潟:腥咲吾吾с菴遵"
+.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
.LP
.LP
-罨＜腓冴泣潟違腥咲菴遵号腓冴с泣潟違障障倶у篏筝若泣若鴻ゃ≪潟с罨＜膣若篏с
+次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
.LP
.nf
\f3
.fl
\fP\f3
.fl
- \fP\f4\fP\f3
+ \fP\f4初期\fP\f3
.fl
- \fP\f4若潟違潟潟鴻\fP\f3
+ \fP\f4ネーミングコンテキスト\fP\f3
.fl
/ \\
.fl
@@ -215,7 +211,7 @@
.LP
.LP
-箴с\f3plans\fP 吾сс\f3Personal\fP \f3calendar\fP \f3schedule\fP 2 ゃ吾сс若潟違潟潟鴻с
+この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。
.LP
.nf
\f3
@@ -242,7 +238,7 @@
.fi
.LP
-菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨＜潟若с若垩ゃ≪潟違ャ障
+前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。
.nf
\f3
.fl
@@ -258,7 +254,7 @@
.fi
.LP
-罨＜潟若с若潟違潟潟鴻緇 \f3ctx\fP 篁ｅャ障2 茵с\f3ctx\fP 若吾с \f3objref\fP 潟若障 \f3objref\fP с障障蚊綵腥咲菴遵障
+次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この objref には、あとでさまざまな名前を割り当てて名前空間に追加します。
.nf
\f3
.fl
@@ -274,7 +270,7 @@
.fi
.LP
-罨＜潟若сtext plans 篏若吾ссゃ潟障緇\f2rebind\fP 篏睡若潟違潟潟鴻筝 "plans" 菴遵障\f2rebind\fP ＜純篏睡違\f2bind\fP 篏睡翫榊箴紊榊違篏綺膵違菴絎茵с障
+次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、rebind を使用して初期ネーミングコンテキストの下に \f2plans を追加しています\fP。 \f2rebind\fP メソッドを使用すれば、bind を使用した場合に発生する例外を発生させずに、 \f2このプログラムを何度も繰り返し実行できます\fP。
.nf
\f3
.fl
@@ -292,7 +288,7 @@
.fi
.LP
-罨＜潟若сdirectory Personal 若潟違潟潟鴻篏障腟緇吾с \f3ctx2\fP ゃ潟若潟違潟潟鴻菴遵障
+次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
.nf
\f3
.fl
@@ -310,7 +306,7 @@
.fi
.LP
-罧潟若с若吾сс schedule calendar с若潟違潟潟鴻 "Personal" (\f3ctx2\fP) ゃ潟障
+残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。
.nf
\f3
.fl
@@ -350,10 +346,10 @@
.fi
.LP
-.SH "泣潟ゃ≪潟:腥咲"
+.SH "サンプルクライアント: 名前空間のブラウズ"
.LP
.LP
-罨＜泣潟違с腥咲冴号腓冴障
+次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
.LP
.nf
\f3
@@ -380,7 +376,7 @@
.fi
.LP
-菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨＜潟若с若垩ゃ≪潟違ャ障
+前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。
.nf
\f3
.fl
@@ -400,7 +396,7 @@
.fi
.LP
-罨＜潟若с若潟違潟潟鴻緇障
+次のコードでは、初期ネーミングコンテキストを取得しています。
.nf
\f3
.fl
@@ -414,7 +410,7 @@
.fi
.LP
-\f2list\fP ＜純若潟違潟潟鴻菴遵ゃ潟ｃ潟違鴻障翫紊 1000 障сゃ潟ｃ潟違若潟違潟潟鴻 BindingListHolder 菴障 罧ゃ潟ｃ潟違BindingIteratorHolder 菴障
+\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
.nf
\f3
.fl
@@ -430,7 +426,7 @@
.fi
.LP
-罨＜潟若с菴 BindingListHolder ゃ潟ｃ潟違緇障ゃ潟ｃ潟違翫違腟篋障
+次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
.nf
\f3
.fl
@@ -444,7 +440,7 @@
.fi
.LP
-罧潟若сゃ潟ｃ潟違絲障若茵阪障
+残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
.nf
\f3
.fl
--- a/jdk/src/linux/doc/man/ja/unpack200.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/unpack200.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,159 +19,125 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH unpack200 1 "02 Jun 2010"
+.TH unpack200 1 "14 Apr 2011"
.LP
-.SH ""
-unpack200 \- JAR ≪潟若
+.SH "名前"
+unpack200 \- JAR アンパックツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-腟篋鴻若帥
+終了ステータス
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-茯
+注意事項
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
.LP
.LP
-激с潟絎綺羆冴障障潟潟茵絎緇激с潟篁ュ絎鴻激с潟障
-.LP
-.RS 3
-
+オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
input\-file
-ュ＜ゃ ュ＜ゃ絽吾pack200 gzip ＜ゃ pack200 ＜ゃс祉0 荐絎 pack200(1) 篏 JAR ＜ゃュ＜ゃ篏睡с障 翫ュ＜ゃ絎鴻 Pack200 若若阪 JAR ＜ゃ潟若障
+入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
.TP 3
JAR\-file
-阪 JAR ＜ゃ
+出力 JAR ファイル名。
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f2unpack200\fP \f2pack200\fP(1) т＜ゃ JAR ＜ゃ紊ゃｃ絎茖с筝篏睡号:
-.LP
-.RS 3
-
+\f2unpack200\fP は、pack200(1) で作成されたパックファイルを JAR ファイルに変換する \f2ネイティブ実装\fPです。一般的な使用方法:
.LP
.LP
\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
.LP
-.RE
-.LP
-箴с \f2unpack200\fP 荐絎с\f2myarchive.jar\fP \f2myarchive.pack.gz\fP 篏障
-.LP
-.SH "激с"
.LP
-.SS
-罔羣激с
+この例では、 \f2デフォルトの unpack200 設定で、myarchive.pack.gz\fP から \f2myarchive.jar\fP が \f2作成されます\fP 。
.LP
-.RS 3
-
+.SH "オプション"
.LP
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-JAR ＜ゃ鴻潟 \f2true\fP\f2false\fP\f2keep\fP 若激с潟荐絎障≪若 \f2keep\fP с\f2true\fP 障 \f2false\fP 翫篏若若ゃ阪 JAR ＜ゃ鴻潟若激с潟≪若荐絎障
-.LP
-.RE
-.RE
-.SS
-罔羣激с
-.LP
-.RS 3
-
+JAR ファイル内のすべてのエントリに \f2true\fP 、 \f2false\fP、 \f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。 \f2true\fP または \f2false 場合、\fPデフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
.LP
.LP
\f4\-r \-\-remove\-pack\-file\fP
.LP
-.RS 3
-
-.LP
.LP
-ュ＜ゃゃ障
+入力パックファイルを削除します。
.LP
-.RE
.LP
\f4\-v \-\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-絨＜祉若吾阪障激с潟茲井絎激＜祉若吾阪障
+最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
-.RE
.LP
\f4\-q \-\-quiet\fP
.LP
-.RS 3
-
-.LP
.LP
-＜祉若吾茵腓冴篏障
+メッセージを表示せずに動作します。
.LP
-.RE
.LP
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
.LP
-.RS 3
-
+.LP
+出力メッセージのログファイルを指定します。
+.LP
+.LP
+\f4\-? \-h \-\-help\fP
.LP
.LP
-阪＜祉若吾違＜ゃ絎障
+このコマンドに関するヘルプ情報を出力します。
+.LP
.LP
-.RE
-.RE
-.SH "腟篋鴻若帥"
+\f4\-V \-\-version\fP
.LP
-
+.LP
+このコマンドに関するバージョン情報を出力します。
.LP
.LP
-罨＜腟篋ゃ菴障
+\f4\-J\fP\f2option\fP
+.LP
.LP
-.RS 3
-
+unpack200 によって呼び出される Java 起動ツールに \f2オプション\fP を \f2渡します\fP。
+.LP
+.SH "終了ステータス"
.LP
.LP
-\f2\ 0\fP " "
+次の終了値が返されます。
.LP
.LP
-\f2>0\fP " "
+\f2\ 0\fP " 成功"
+.LP
.LP
-.RE
-.SH "∫ｉ"
+\f2>0\fP " エラー"
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -180,35 +146,33 @@
.TP 2
o
.na
-\f2Java SE ャ＜潟\fP @
+\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
-\f2Java ゃ \- Pack200\fP @
+\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
-jar(1) \- Java Archive 若
+jar(1) \- Java Archive ツール」
.TP 2
o
-jarsigner(1) \- JAR 臀峨恰荐若若
+jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
-\f2attributes(5)\fP ャ≪若
+\f2attributes(5)\fP のマニュアルページ
.RE
.LP
-.SH "羈鋋"
-.LP
-
+.SH "注意事項"
.LP
.LP
-潟潟 \f2unpack(1)\fP 羞桁сヨ遵с
+このコマンドと \f2unpack(1) を\fP混同しないでください。これらは別製品です。
.LP
.LP
-SDK 篁絮 Java SE API 篁罕檎荀ゃｃ翫篁罕
+SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP
--- a/jdk/src/linux/doc/man/ja/wsgen.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/wsgen.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,30 +19,24 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH wsgen 1 "02 Jun 2010"
-.SH ""
-wsgen \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
-.RS 3
-
+.TH wsgen 1 "14 Apr 2011"
+.SH "名前"
+wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
-.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3絎茖若吾с:\fP 2.1.1
-.LP
+\f3実装バージョン:\fP 2.1.1
.LP
-\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若ｃ＜障若Web 泣若鴻潟ゃ潟絎茖 (SEI) 茯水Web 泣若鴻若喝冴綽荀鴻≪若ｃ＜障
-.LP
-.RE
-.SH "网荀"
+\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
+.SH "概要"
.LP
-\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若ｃ＜障若Web 泣若鴻潟ゃ潟鴻茯水Web 泣若鴻若喝冴綽荀鴻≪若ｃ＜障JAXWS 2.1.1 RI wsgen Ant 帥鴻障荅括完
+\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイントクラスを読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。JAXWS 2.1.1 RI には wsgen Ant タスクも用意されています。詳細は、
.na
-\f2Wsgen Ant 帥鴻\fP @
+\f2Wsgen Ant タスク\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlを参照してください。
.LP
-.SH "wsgen 莎桁"
+.SH "wsgen の起動"
.RS 3
.TP 2
o
@@ -69,7 +63,7 @@
.RE
.LP
-.SH "罕"
+.SH "構文"
.nf
\f3
.fl
@@ -80,7 +74,7 @@
\fP
.fi
.LP
-罨＜茵\f2wsgen\fP 激с潟腓冴障
+次の表に、 \f2wsgen\fP のオプションを示します。
.br
.LP
.TS
@@ -111,7 +105,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ュ鴻＜ゃ罎膣√贋絎障
+入力クラスファイルの検索場所を指定します
.br
.di
.nr a| \n(dn
@@ -127,7 +121,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2\-classpath <path>\fP
+\-classpath <path> \f2と同じです\fP
.br
.di
.nr b| \n(dn
@@ -143,7 +137,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-阪＜ゃ主贋絎
+生成される出力ファイルを格納する場所を指定します
.br
.di
.nr c| \n(dn
@@ -159,7 +153,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵с障
+ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
.br
.di
.nr d| \n(dn
@@ -175,7 +169,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-茵腓冴障
+ヘルプを表示します
.br
.di
.nr e| \n(dn
@@ -191,7 +185,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜ゃ篆障
+生成されたファイルを保持します
.br
.di
.nr f| \n(dn
@@ -207,7 +201,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \-wsdl 激с潟腟水篏睡障WSDL 純若鴻＜ゃ主贋絎障
+常に \-wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
.br
.di
.nr g| \n(dn
@@ -223,7 +217,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-純若鴻＜ゃ主贋絎
+生成されるソースファイルを格納する場所を指定する
.br
.di
.nr h| \n(dn
@@ -239,7 +233,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ絎茵≪＜祉若吾阪障
+コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr i| \n(dn
@@ -255,7 +249,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾с恰宴阪障激с潟篏睡翫若吾с恰宴阪с絽吾絎茵障
+バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
.br
.di
.nr j| \n(dn
@@ -271,7 +265,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2wsgen\fP с WSDL ＜ゃ障違ュ純с絎翫 \f2wsgen\fP WSDL ＜ゃ障違絽吾潟ゃ潟肴 WSDL сс篏睡障\f2protocol\fP ュ純с\f2wsdl:binding\fP т戎鴻潟絎篏睡障鴻潟罨＜с\f2soap1.1\fP \f2Xsoap1.2\fP \f2soap1.1\fP с\f2Xsoap1.2\fP 罔羣с\f2\-extension\fP 激с潟腟水篏睡с障
+デフォルトでは \f2wsgen\fP は WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は \f2wsgen\fP が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。 \f2protocol\fP は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\fP。有効なプロトコルは次のとおりです。 \f2soap1.1\fP と \f2Xsoap1.2\fP。デフォルトは \f2soap1.1\fP です。 \f2Xsoap1.2\fP は標準ではないため、 \f2\-extension\fP オプションと組み合わせないと使用できません。
.br
.di
.nr k| \n(dn
@@ -287,7 +281,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:service\fP 絎篏睡障箴 : \f2\-servicename "{http://mynamespace/}MyService"\fP
+常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:service\fP の名前を指定するために使用します。例: \f2\-servicename "{http://mynamespace/}MyService"\fP
.br
.di
.nr l| \n(dn
@@ -303,7 +297,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:port\fP 絎篏睡障箴 : \f2\-portname "{http://mynamespace/}MyPort"\fP
+常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:port\fP の名前を指定するために使用します。例: \f2\-portname "{http://mynamespace/}MyPort"\fP
.br
.br
.di
@@ -315,7 +309,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -346,7 +340,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -386,7 +380,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 143 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 137 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -403,7 +397,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -633,7 +627,7 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
.LP
-.SH "箴"
+.SH "例"
.nf
\f3
.fl
@@ -641,7 +635,7 @@
.fl
.fi
.LP
-\f3stock\fP ｃ @WebService 羈篁StockService 綽荀若鴻障
+\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。
.nf
\f3
.fl
@@ -649,7 +643,7 @@
.fl
.fi
.LP
-SOAP 1.1 WSDL @WebService 羈篁 Java stock.StockService 鴻若障
+SOAP 1.1 WSDL と、@WebService 注釈が付けられた Java クラス stock.StockService のスキーマが生成されます。
.nf
\f3
.fl
@@ -657,6 +651,6 @@
.fl
.fi
.LP
-SOAP 1.2 WSDL 障
+SOAP 1.2 WSDL が生成されます。
.LP
-泣若鴻 JAXWS 潟帥ゃｃ WSDL 堺 WSDL 綽荀障
+サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。
--- a/jdk/src/linux/doc/man/ja/wsimport.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/wsimport.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,44 +19,44 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH wsimport 1 "02 Jun 2010"
-.SH ""
-wsimport \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
+.TH wsimport 1 "14 Apr 2011"
+.SH "名前"
+wsimport \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3絎茖若吾с:\fP 2.1.1
+\f3実装バージョン:\fP 2.1.1
.br
-.SH "网荀"
+.SH "概要"
.LP
-\f2wsimport\fP 若罨＜ JAX\-WS 若帥≪若ｃ＜障
+\f2wsimport\fP ツールは、次のような JAX\-WS ポータブルアーティファクトを生成します。
.RS 3
.TP 2
o
-泣若鴻潟ゃ潟ゃ潟帥с若 (SEI)
+サービスエンドポイントインタフェース (SEI)
.TP 2
o
-泣若
+サービス
.TP 2
o
-wsdl:fault 箴紊 (絖翫)
+wsdl:fault からマップされる例外クラス (存在する場合)
.TP 2
o
-綽膈 wsdl:message 羇丞綽膈 Bean (絖翫)
+応答 wsdl:message から派生する非同期応答 Bean (存在する場合)
.TP 2
o
-JAX\-B ゃ帥ゃ (鴻若 Java )
+JAX\-B が生成する値タイプ (スキーマの型からマップされた Java クラス)
.RE
.LP
-≪若ｃ＜WSDL ャ＜潟鴻若ャ＜潟潟潟ゃ潟絎茖 WAR ＜ゃ宴若後с障障wsimport Ant 帥鴻障
+これらのアーティファクトは、WSDL ドキュメント、スキーマドキュメント、およびエンドポイント実装とともに WAR ファイル内にパッケージ化して配備することができます。また、wsimport Ant タスクも用意されています。
.na
-\f2Wsimport Ant 帥鴻\fP @
+\f2wsimport Ant タスク\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlを参照してください。
.br
.LP
-.SH "wsimport 莎桁"
+.SH "wsimport の起動"
.RS 3
.TP 2
o
@@ -77,7 +77,7 @@
.RE
.LP
-.SH "罕"
+.SH "構文"
.nf
\f3
.fl
@@ -86,7 +86,7 @@
\fP
.fi
.LP
-罨＜茵\f2wsimport\fP 激с潟腓冴障
+次の表に、 \f2wsimport\fP のオプションを示します。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -116,7 +116,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-阪＜ゃ主贋絎障
+生成される出力ファイルを格納する場所を指定します
.br
.di
.nr a| \n(dn
@@ -132,7 +132,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊 JAX\-WS 障 JAXB ゃ潟ｃ潟違＜ゃ絎障 (\f2<file>\fP \f2\-b\fP 綽荀)
+外部の JAX\-WS または JAXB バインディングファイルを指定します ( \f2<file>\fP ごとに \f2\-b\fP が必要となる)
.br
.di
.nr b| \n(dn
@@ -148,7 +148,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-激с潟 JAXB 鴻若潟潟ゃ羝＜障
+このオプションを JAXB スキーマコンパイラに渡します
.br
.di
.nr c| \n(dn
@@ -164,11 +164,11 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊潟ｃｃ弱с茹ｆ浦帥違＜ゃ絎障 TR9401XCatalogOASIS XML Catalog 綵√泣若障
+外部エンティティー参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。
.na
-\f2帥\fP @
+\f2カタログ\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlャ＜潟茯帥\f3帥\fP泣潟с
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlのドキュメントをお読みになり、\f3カタログ\fPのサンプルを参照してください。
.br
.di
.nr d| \n(dn
@@ -184,7 +184,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵醇с障
+ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
.br
.di
.nr e| \n(dn
@@ -200,7 +200,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-茵腓冴障
+ヘルプを表示します
.br
.di
.nr f| \n(dn
@@ -232,7 +232,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HTTP 激泣若若絎障 (若 8080)
+HTTP プロキシサーバーを指定します (デフォルトのポートは 8080)
.br
.di
.nr h| \n(dn
@@ -248,7 +248,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜ゃ篆障
+生成されたファイルを保持します
.br
.di
.nr i| \n(dn
@@ -264,7 +264,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻 WSDL/鴻若ゃ潟ｃ潟違鴻帥ゃ冴 篁罕ц鎘宴若後≪眼冴障
+このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべての WSDL/スキーマバインディングカスタマイズや、 仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます
.br
.di
.nr j| \n(dn
@@ -280,7 +280,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-純若鴻＜ゃ主贋絎障
+生成されるソースファイルを格納する場所を指定する
.br
.di
.nr k| \n(dn
@@ -296,7 +296,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ絎茵≪＜祉若吾阪障
+コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr l| \n(dn
@@ -312,7 +312,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾с恰宴阪障
+バージョン情報を出力します
.br
.di
.nr m| \n(dn
@@ -344,7 +344,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2@WebServiceClient.wsdlLocation\fP
+\f2@WebServiceClient.wsdlLocation\fP 値
.br
.di
.nr o| \n(dn
@@ -360,7 +360,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎 JAX\-WS 篁罕若吾с潟緇ｃ潟若障若吾с 2.0 сJAX\-WS 2.0 篁罕羣潟若障
+指定された JAX\-WS 仕様バージョンに従ってコードを生成します。バージョン 2.0 では、JAX\-WS 2.0 仕様に準拠したコードを生成します。
.br
.di
.nr p| \n(dn
@@ -376,7 +376,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-wsimport 阪吟障
+wsimport 出力を抑制します
.br
.di
.nr q| \n(dn
@@ -387,7 +387,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-d <directory> \fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -422,7 +422,7 @@
.nr 38 \n(n-
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -483,7 +483,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -766,13 +766,294 @@
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-72
.LP
-\f2\-b\fP 激с潟篏帥ｃ茲違 JAX\-WS JAXB ゃ潟ｃ潟違＜ゃ絎с障 ＜ゃ篏帥ｃ宴若後 Bean 障障鴻帥ゃ冴純с JAX\-WS JAXB ゃ潟ｃ潟違＜ゃ荅括完
+\-b オプションを使って、複数の JAX\-WS および JAXB バインディングファイル \f2を指定できます。\fP これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。JAX\-WS および JAXB バインディングファイルの詳細は、
.na
-\f2鴻帥ゃ冴ャ≪\fP @
+\f2カスタマイズマニュアル\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlを参照してください。
+.LP
+次の表に、 \f2wsimport\fP の非標準オプションを示します。
.LP
-.SH "箴"
+.TS
+.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
+.de 35
+.ps \n(.s
+.vs \n(.vu
+.in \n(.iu
+.if \n(.u .fi
+.if \n(.j .ad
+.if \n(.j=0 .na
+..
+.nf
+.nr #~ 0
+.if n .nr #~ 0.6n
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.fc
+.nr 33 \n(.s
+.rm 80 81
+.nr 34 \n(.lu
+.eo
+.am 81
+.br
+.di a+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+要求または応答メッセージにバインドされないヘッダーを Java メソッドのパラメータにマップします
+.br
+.di
+.nr a| \n(dn
+.nr a- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di b+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://username:password@example.org/stock?wsdl
+.br
+.di
+.nr b| \n(dn
+.nr b- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di c+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+デバッグ情報を出力します
+.br
+.di
+.nr c| \n(dn
+.nr c- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di d+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+\f3\-Xno\-addressing\-databinding\fP
+.br
+.di
+.nr d| \n(dn
+.nr d- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di e+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+W3C \f2EndpointReferenceType\fP と Java のバインディングを有効にします
+.br
+.di
+.nr e| \n(dn
+.nr e- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di f+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+生成された Java ファイルをコンパイルしません
+.br
+.di
+.nr f| \n(dn
+.nr f- \n(dl
+..
+.ec \
+.35
+.nf
+.ll \n(34u
+.nr 80 0
+.nr 38 \w\f3オプション\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-XadditionalHeaders\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xauthfile <file>\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xdebug\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xnocompile\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.80
+.rm 80
+.nr 38 \n(d-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 81 0
+.nr 38 \w\f3説明\fP
+.if \n(81<\n(38 .nr 81 \n(38
+.81
+.rm 81
+.nr 38 \n(a-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(b-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(c-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(e-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(f-
+.if \n(81<\n(38 .nr 81 \n(38
+.35
+.nf
+.ll \n(34u
+.nr 38 1n
+.nr 79 0
+.nr 40 \n(79+(0*\n(38)
+.nr 80 +\n(40
+.nr 41 \n(80+(3*\n(38)
+.nr 81 +\n(41
+.nr TW \n(81
+.if t .if \n(TW>\n(.li .tm Table at line 199 file Input is too wide - \n(TW units
+.fc
+.nr #T 0-1
+.nr #a 0-1
+.eo
+.de T#
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.mk ##
+.nr ## -1v
+.ls 1
+.ls
+..
+.ec
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
+.ne \n(a|u+\n(.Vu
+.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-XadditionalHeaders\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.a+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(b|u+\n(.Vu
+.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xauthfile <file>\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.b+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(c|u+\n(.Vu
+.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xdebug\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.c+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(d|u+\n(.Vu
+.ne \n(e|u+\n(.Vu
+.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
+.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.d+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.e+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(f|u+\n(.Vu
+.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xnocompile\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.f+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.fc
+.nr T. 1
+.T# 1
+.35
+.rm a+
+.rm b+
+.rm c+
+.rm d+
+.rm e+
+.rm f+
+.TE
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
+
+.LP
+.SH "例"
.nf
\f3
.fl
@@ -780,6 +1061,6 @@
.fl
.fi
.LP
-Java ≪若ｃ＜\f2http://stockquote.xyz/quote?wsdl\fP ゃ潟若с≪若ｃ＜潟潟ゃ障
+Java アーティファクトを生成し、 \f2http://stockquote.xyz/quote?wsdl\fP をインポートすることで、それらのアーティファクトをコンパイルします。
.br
--- a/jdk/src/linux/doc/man/ja/xjc.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/xjc.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,266 +19,277 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH xjc 1 "02 Jun 2010"
+.TH xjc 1 "14 Apr 2011"
.LP
.ad c
-.SH ""
-xjc \- XML ゃ潟 Java(TM) ≪若ｃ
+.SH "名前"
+xjc \- XML バインドのための Java(TM) アーキテクチャー
.br
-ゃ潟ｃ潟違潟潟ゃ
+バインディングコンパイラ
.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3＜潟劫茖 (RI) 若吾с:\fP 2.1.3 .ad l
+\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l
.LP
-.SH "xjc 莎桁"
+.SH "xjc の起動"
.LP
.LP
-ゃ潟ｃ潟違潟潟ゃ莎桁篏睡若綽 \f2bin\fP ｃ \f2xjc\fP 激с鴻篏睡障障ゃ潟ｃ潟違潟潟ゃ絎茵 Ant 帥鴻障
+バインディングコンパイラを起動するには、使用するプラットフォームに応じた bin ディレクトリ内の \f2xjc\fP シェルスクリプト \f2を\fP 使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。
.na
-\f2xjc Ant 篏睡\fP @
+\f2xjc を Ant とともに使用する\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlс
-.LP
-.RS 3
-
+https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。
.LP
.LP
\f2% xjc \-help\fP
.LP
-.RE
-\f3阪\fP
-.LP
-.RS 3
-
+.SS
+出力
.LP
.nf
\f3
.fl
-Usage: xjc [\-options ...] <schema_file/URL/dir> ... [\-b <bindinfo>] ...
+Usage: xjc [\-options ...] <schema file/URL/dir/jar> ... [\-b <bindinfo>] ...
+.fl
+If dir is specified, all schema files in it will be compiled.
+.fl
+If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled.
.fl
Options:
.fl
- \-nv : do not perform strict validation of the input schema(s)
+ \-nv : do not perform strict validation of the input schema(s)
.fl
- \-extension : allow vendor extensions \- do not strictly follow the
+ \-extension : allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
.fl
- Compatibility Rules and App E.2 from the JAXB Spec
+ \-b <file/dir> : specify external bindings files (each <file> must have its own \-b); if a directory is given, **/*.xjb is searched
.fl
- \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
+ \-d <dir> : generated files will go into this directory
+.fl
+ \-p <pkg> : specifies the target package
.fl
- If a directory is given, **/*.xjb is searched
+ \-httpproxy <proxy> : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
.fl
- \-d <dir> : generated files will go into this directory
+ \-httpproxyfile <f> : works like \-httpproxy but takes the argument in a file to protect password
.fl
- \-p <pkg> : specifies the target package
+ \-classpath <arg> : specify where to find user class files
.fl
- \-httpproxy <proxy> : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort
+ \-catalog <file> : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
.fl
- \-httpproxyfile <file>: set the proxy string (same format as above).
+ \-readOnly : generated files will be in read\-only mode
.fl
- \-classpath <arg> : specify where to find user class files
+ \-npa : suppress generation of package level annotations (**/package\-info.java)
+.fl
+ \-no\-header : suppress generation of a file header with timestamp
.fl
- \-catalog <file> : specify catalog files to resolve external entity references
+ \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features
.fl
- support TR9401, XCatalog, and OASIS XML Catalog format.
+ \-xmlschema : treat input as W3C XML Schema (default)
.fl
- \-readOnly : generated files will be in read\-only mode
+ \-relaxng : treat input as RELAX NG (experimental,unsupported)
.fl
- \-npa : suppress generation of package level annotations (**/package\-info.java)
+ \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
.fl
- \-no\-header : suppress generation of a file header with timestamp
+ \-dtd : treat input as XML DTD (experimental,unsupported)
.fl
- \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
+ \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+.fl
+ \-verbose : be extra verbose
.fl
- \-xmlschema : treat input as W3C XML Schema (default)
+ \-quiet : suppress compiler output
.fl
- \-relaxng : treat input as RELAX NG (experimental,unsupported)
+ \-help : display this help message
.fl
- \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
+ \-version : display version information
+.fl
+
.fl
- \-dtd : treat input as XML DTD (experimental,unsupported)
+
.fl
- \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+Extensions:
.fl
- \-verbose : be extra verbose
+ \-Xlocator : enable source location support for generated code
.fl
- \-quiet : suppress compiler output
+ \-Xsync\-methods : generate accessor methods with the 'synchronized' keyword
.fl
- \-help : display this help message
+ \-mark\-generated : mark the generated code as @javax.annotation.Generated
.fl
- \-version : display version information
+ \-episode <FILE> : generate the episode file for separate compilation
.fl
\fP
.fi
-.RE
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-nv
-сXJC ゃ潟ｃ潟違潟潟ゃ純若鴻鴻若ｳ絲罎荐若絎茵障激с潟篏睡ｳ絲鴻若罎荐若≦鴻障ゃ潟ｃ潟違潟潟ゃ罎荐若筝絎茵с障 ｳ絲с罎荐若絎茵с
+デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
.TP 3
\-extension
-сXJC ゃ潟ｃ潟違潟潟ゃJAXB 篁罕Compatibility腴ц荀ｳ絲綣桁吟障篁 E.2 JAXB v1.0 у泣若筝ｃ W3C XML 鴻若罘純絎臂障 翫ｃ鴻ゃф鴻\-extension≪若с罘純篏睡с障障ｳ絲≪若с篁罕絎臂ゃ潟ｃ潟違鴻帥ゃ冴帥篏睡с障\-extension鴻ゃ絎違JAXB Vendor Extension 篏睡с障
+デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
.TP 3
\-b <file>
-紊ゃ潟ｃ潟違＜ゃ 1 ゃ障茲井絎障(ゃ潟ｃ潟違＜ゃ\f2\-b\fP鴻ゃ絎綽荀障)紊ゃ潟ｃ潟違＜ゃ罕絽吾荵с茲違鴻若鴻帥ゃ冴障 1 ゃゃ潟ｃ潟違＜ゃ篏睡鴻帥ゃ冴茲違ゃ潟ｃ潟違＜ゃ蚊с障 罨＜箴腓冴障
-.RS 3
-
-.LP
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
+処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに \f2「\-b」\fP スイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる 1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。 \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
.br
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
-.RE
-障潟潟茵鴻若＜ゃゃ潟ｃ潟違＜ゃ絎篁紙с
+\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
.TP 3
\-d <dir>
-сXJC ゃ潟ｃ潟違潟潟ゃJava 潟潟潟鴻憜ｃ障激с潟篏睡篁ｆ水阪ｃ絎с障阪ｃ絖綽荀障 XJC ゃ潟ｃ潟違潟潟ゃｃ篏障
+デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
.TP 3
\-p <pkg>
-潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻ゃ潟ｃ潟違鴻帥ゃ冴篁罕ц鎘宴若後≪眼冴障
+このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
.TP 3
\-httpproxy <proxy>
-HTTP/HTTPS 激絎障綵√ [user[:password]@]proxyHost[:proxyPort] с緇ャ \f2\-host\fP \f2\-port\fP 筝篏篋с＜潟劫茖с泣若障ｨ絅障激с潟ф絎鴻若\f2top\fP 潟潟篏睡若吟若祉若吟若茵腓冴с綣違с羈祉ャｃ若蕭罨＜ \f2\-httpproxyfile\fP 篏睡
+HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、 \f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティーを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
.TP 3
\-httpproxyfile <file>
-HTTP/HTTPS 激＜ゃ腟宴ф絎障綵√筝荐с＜ゃ絎鴻若祉若吟若茵腓冴с障
+HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
.TP 3
\-classpath <arg>
-\f2<jxb:javaType>\fP \f2<xjc:superClass>\fP 鴻帥ゃ冴篏睡ゃ≪潟≪宴若激с潟鴻＜ゃ罎膣√贋絎障
+<jxb:javaType> および <xjc:superClass> \f2カスタマイズが使用する\fP クライアントアプリケーションの \f2クラスファイルの検索場所を\fP 指定します。
.TP 3
\-catalog <file>
-紊潟ｃｃ弱с茹ｆ浦帥違＜ゃ絎障TR9401XCatalog OASIS XML Catalog 綵√泣若障荅括完XML Entity and URI Resolversャ＜潟с\f2帥違障\fP泣潟≪宴若激с潟茯帥鴻
+外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、 \f2カタログリゾルバの\fP サンプルアプリケーションを調べてください。
.TP 3
\-readOnly
-сXJC ゃ潟ｃ潟違潟潟ゃ Java 純若鴻＜ゃ吾莨若帥篆茘激障激с潟篏睡XJC ゃ潟ｃ潟違潟潟ゃ Java 純若鴻綣桁句茯水絨障
+デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
.TP 3
\-npa
-宴若吾羈 **/package\-info.java 吟障鴻ゃ篏睡潟若с羈祉羝帥鴻障
+パッケージレベルの注釈を **/package\-info.java に生成することを抑制します。このスイッチを使用して生成するコードでは、これらの注釈がほかの生成済みクラスに内部化されます。
.TP 3
\-no\-header
-紊絨＜≪帥ゃ鴻帥潟＜ゃ若潟＜潟吟障激с潟篏睡潟若障
+多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。
.TP 3
\-target 2.0
- JAXB 2.1 罘純箴絖潟若障潟若 JAXB 2.0 潟帥ゃ (JavaSE 6 ) у茵с障
+なんらかの JAXB 2.1 機能に依存するコードを生成しないようにします。これにより、生成されたコードを JAXB 2.0 ランタイム (JavaSE 6 など) で実行できます。
.TP 3
\-xmlschema
-ュ鴻若 W3C XML 鴻若 () 荀障鴻ゃ絎ュ鴻若 W3C XML 鴻若荀障
+入力スキーマを W3C XML スキーマ (デフォルト) と見なします。このスイッチを指定しなくても、入力スキーマは W3C XML スキーマと見なされます。
.TP 3
\-relaxng
-ュ鴻若 RELAX NG 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-relaxng\-compact
-ュ鴻若 RELAX NG х軒罕障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-dtd
-ュ鴻若 XML DTD 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-wsdl
-ュ WSDL 宴鴻若潟潟ゃ障 (荅薑泣若)
+入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
.TP 3
\-quiet
-我宴茘潟潟ゃ阪吟障
+進捗情報や警告など、コンパイラの出力を抑制します。
.TP 3
\-verbose
-宴＜祉若吾阪劫主榊鴻帥若鴻茵腓冴罐泣激障
+情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
.TP 3
\-help
-潟潟ゃ鴻ゃ网荀茵腓冴障
+コンパイラスイッチの概要を表示します。
.TP 3
\-version
-潟潟ゃ若吾с恰宴茵腓冴障
+コンパイラのバージョン情報を表示します。
.TP 3
<schema file/URL/dir>
-潟潟ゃ絲乗院 1 ゃ障茲違鴻若＜ゃ絎障若吟若ｃ絎翫xjc ｃ莎井祉цゃｃ鴻鴻若＜ゃ潟潟ゃ障
+コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
.RE
+
+.LP
.SS
-ｨ絅潟潟茵激с潟喝ゃ潟潟茵激с潟网荀
+非標準のコマンド行オプション
.LP
.RS 3
+.TP 3
+\-Xlocator
+生成されたコードでは、非整列化のあとに Java Bean インスタンスに含まれるソース XML に関する SAX Locator 情報が公開されます。
+.TP 3
+\-Xsync\-methods
+生成されたすべてのメソッドシグニチャーに \f2同期された\fP キーワードが含められます。
+.TP 3
+\-mark\-generated
+生成されたコードに注釈 \f2@javax.annotation.Generated\fP を付けます。
+.TP 3
+\-episode <file>
+コンパイルごとに指定されたエピソードファイルを生成します。
+.RE
.LP
+.SS
+非推奨コマンド行オプションおよび削除されたコマンド行オプション
+.LP
.RS 3
.TP 3
\-host & \-port
-激с潟ｨ絅\f3\-httpproxy\fP 激с潟х舟障激с潟筝篏篋с腆坂у膓泣若障ャ＜潟荐莠絨ャ若鴻уゃ醇с障
+これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
.TP 3
\-use\-runtime
-JAXB 2.0 篁罕хЩ罎с潟帥ゃ荀鎘JAXB RI **/impl/runtime 宴若吾綽荀障鴻ゃ筝荀ゃ障
+JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
.TP 3
\-source
-\-source 篋с鴻ゃJAXB 2.0 Early Access уャ障鴻ゃJAXB 2.0 篁緇若鴻ゃ障1.0.x 潟若綽荀翫1.0.x 潟若若鴻ゃ潟鴻若篏睡
-.TP 3
-\-Xlocator & \-Xsync\-methods
-鴻ゃ憝鴻с≦劫障罘純絨ャャ潟若箴篋絎с
+\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。このスイッチは、JAXB 2.0 の今後のリリースから削除されることになりました。1.0.x コードを生成する必要がある場合は、1.0.x コードベースのインストールを使用してください。
.RE
.LP
-.RE
.SS
-潟潟ゃ狗
+コンパイラの制限
.LP
.LP
-絽吾∫ｃ鴻鴻若ゃ潟ｃ潟違潟潟ゃ鴻ゃ絎 1 ゃ篏潟潟ゃｃ絎с
+通常は、関連するすべてのスキーマを、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
.LP
.LP
-xjc 絎茵罨＜腓冴狗羈狗祉xjc 篏綺若喝冴茲違鴻若潟潟ゃ翫翠障
+xjc を実行するときは、次に示す制限に注意してください。これらの制限のほとんどは、xjc を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
.LP
.RS 3
.TP 2
o
-茲違鴻若潟潟ゃ翫帥若蚊 Java 宴若後罨＜篏荀羈
+複数のスキーマを同時にコンパイルする場合は、ターゲットの Java パッケージ名に次の優先順位の規則が適用されることに注意してください。
.RS 3
.TP 3
1.
-\f2\-p\fP潟潟茵激с潟ｃ障
+「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
.TP 3
2.
-<\f2jaxb:package\fP> 鴻帥ゃ
+<\f2jaxb:package\fP> のカスタマイズ
.TP 3
3.
-\f2targetNamespace\fP 絎ｈ翫篁罕絎臂 \f2targetNamespace\fP \-> Java 宴若後≪眼冴障
+\f2targetNamespace\fP が宣言されている場合は、 \f2仕様に定義されている targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
.TP 3
4.
-\f2targetNamespace\fP 絎ｈ翫"generated" 若潟若宴若吾篏睡障
+\f2targetNamespace\fP が宣言されていない場合は、「generated」という名前のハードコードされたパッケージを使用します。
.RE
.TP 2
o
-腥咲茲違 <\f2jaxb:schemaBindings\fP> ゃ筝罩ｃс 1 ゃ帥若蚊腥咲 2 ゃ鴻若違 Java 宴若吾潟潟ゃс障
+名前空間ごとに複数の <\f2jaxb:schemaBindings\fP> を持つことは不正です。このため、1 つのターゲット名前空間内の 2 つのスキーマを異なる Java パッケージにコンパイルすることはできません。
.TP 2
o
-1 ゃ Java 宴若吾潟潟ゃ鴻鴻若XJC ゃ潟ｃ潟違潟潟ゃ篆＜綽荀障 ャ潟潟ゃс篋篏障
+1 つの Java パッケージにコンパイルされるすべてのスキーマは、XJC バインディングコンパイラに同時に送信する必要があります。個別にコンパイルすることはできず、予期したとおりに動作しません。
.TP 2
o
-茲違鴻若＜ゃ障荀膣臀違若潟潟ゃ綽荀障
+複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-潟潟茵с潟潟若帥絎茵 (XJC):[
+コマンド行でのコンバータの実行 (XJC): [
.na
-\f2潟潟茵巡擦\fP @
+\f2コマンド行の命令\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html
+https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html、
.na
-\f2xjc Ant 篏睡\fP @
+\f2xjc を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
.TP 2
o
.na
-\f2XML ゃ潟 JavaTM ≪若ｃ (JAXB)\fP @
+\f2XML バインドのための Java アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk.properties Wed Jul 05 17:42:56 2017 +0200
@@ -56,9 +56,9 @@
FileChooser.renameFileButtonText=Rename File
FileChooser.renameFileButtonMnemonic=82
FileChooser.cancelButtonText=Cancel
-FileChooser.cancelButtonMnemonic=67
+#FileChooser.cancelButtonMnemonic=67
FileChooser.saveButtonText=OK
-FileChooser.saveButtonMnemonic=79
+#FileChooser.saveButtonMnemonic=79
FileChooser.openButtonText=OK
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=Save
@@ -79,5 +79,5 @@
FileChooser.renameFileErrorTitle=Error
FileChooser.renameFileErrorText=Error renaming file "{0}" to "{1}"
-OptionPane.okButtonMnemonic=79
-OptionPane.cancelButtonMnemonic=67
+#OptionPane.okButtonMnemonic=79
+#OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_de.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_de.properties Wed Jul 05 17:42:56 2017 +0200
@@ -24,7 +24,7 @@
GTKColorChooserPanel.hueMnemonic=70
GTKColorChooserPanel.redText=Rot:
-GTKColorChooserPanel.redMnemonic=79
+GTKColorChooserPanel.redMnemonic=82
GTKColorChooserPanel.saturationText=S\u00E4ttigung:
GTKColorChooserPanel.saturationMnemonic=83
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Fehler
FileChooser.renameFileErrorText=Fehler beim Umbenennen der Datei "{0}" in "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=OK
OptionPane.okButtonMnemonic=79
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Abbrechen
OptionPane.cancelButtonMnemonic=65
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_es.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_es.properties Wed Jul 05 17:42:56 2017 +0200
@@ -30,7 +30,7 @@
GTKColorChooserPanel.saturationMnemonic=83
GTKColorChooserPanel.greenText=Verde:
-GTKColorChooserPanel.greenMnemonic=86
+GTKColorChooserPanel.greenMnemonic=69
GTKColorChooserPanel.valueText=Valor:
GTKColorChooserPanel.valueMnemonic=86
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Error
FileChooser.renameFileErrorText=Error al cambiar el nombre del archivo "{0}" a "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=Aceptar
OptionPane.okButtonMnemonic=65
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Cancelar
OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_fr.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_fr.properties Wed Jul 05 17:42:56 2017 +0200
@@ -30,7 +30,7 @@
GTKColorChooserPanel.saturationMnemonic=83
GTKColorChooserPanel.greenText=Vert :
-GTKColorChooserPanel.greenMnemonic=86
+GTKColorChooserPanel.greenMnemonic=69
GTKColorChooserPanel.valueText=Valeur :
GTKColorChooserPanel.valueMnemonic=86
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Erreur
FileChooser.renameFileErrorText=Erreur lors du changement de nom du fichier "{0}" en "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=OK
OptionPane.okButtonMnemonic=79
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Annuler
OptionPane.cancelButtonMnemonic=65
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_it.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_it.properties Wed Jul 05 17:42:56 2017 +0200
@@ -30,7 +30,7 @@
GTKColorChooserPanel.saturationMnemonic=83
GTKColorChooserPanel.greenText=Verde:
-GTKColorChooserPanel.greenMnemonic=86
+GTKColorChooserPanel.greenMnemonic=69
GTKColorChooserPanel.valueText=Valore:
GTKColorChooserPanel.valueMnemonic=86
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Errore
FileChooser.renameFileErrorText=Errore durante la ridenominazione del file "{0}" in "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=OK
OptionPane.okButtonMnemonic=79
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Annulla
OptionPane.cancelButtonMnemonic=65
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_ja.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_ja.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.deleteFileButtonMnemonic=76
FileChooser.renameFileButtonText=\u30D5\u30A1\u30A4\u30EB\u306E\u540D\u524D\u5909\u66F4(R)
FileChooser.renameFileButtonMnemonic=82
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=OK(O)
+FileChooser.saveButtonText=OK
FileChooser.saveButtonMnemonic=79
-FileChooser.openButtonText=OK(O)
+FileChooser.openButtonText=OK
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u4FDD\u5B58
FileChooser.openDialogTitleText=\u958B\u304F
@@ -79,6 +79,6 @@
FileChooser.renameFileErrorTitle=\u30A8\u30E9\u30FC
FileChooser.renameFileErrorText=\u30D5\u30A1\u30A4\u30EB"{0}"\u306E"{1}"\u3078\u306E\u5909\u66F4\u4E2D\u306B\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F
-OptionPane.okButtonMnemonic=79
-OptionPane.cancelButtonMnemonic=67
+#OptionPane.okButtonMnemonic=79
+#OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_ko.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_ko.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.deleteFileButtonMnemonic=76
FileChooser.renameFileButtonText=\uD30C\uC77C \uC774\uB984 \uBC14\uAFB8\uAE30(R)
FileChooser.renameFileButtonMnemonic=82
-FileChooser.cancelButtonText=\uCDE8\uC18C(C)
+FileChooser.cancelButtonText=\uCDE8\uC18C
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\uD655\uC778(O)
+FileChooser.saveButtonText=\uD655\uC778
FileChooser.saveButtonMnemonic=79
-FileChooser.openButtonText=\uD655\uC778(O)
+FileChooser.openButtonText=\uD655\uC778
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\uC800\uC7A5
FileChooser.openDialogTitleText=\uC5F4\uAE30
@@ -79,6 +79,6 @@
FileChooser.renameFileErrorTitle=\uC624\uB958
FileChooser.renameFileErrorText="{0}" \uD30C\uC77C\uC758 \uC774\uB984\uC744 "{1}"(\uC73C)\uB85C \uBC14\uAFB8\uB294 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.
-OptionPane.okButtonMnemonic=79
-OptionPane.cancelButtonMnemonic=67
+#OptionPane.okButtonMnemonic=79
+#OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_pt_BR.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_pt_BR.properties Wed Jul 05 17:42:56 2017 +0200
@@ -30,7 +30,7 @@
GTKColorChooserPanel.saturationMnemonic=83
GTKColorChooserPanel.greenText=Verde:
-GTKColorChooserPanel.greenMnemonic=86
+GTKColorChooserPanel.greenMnemonic=68
GTKColorChooserPanel.valueText=Valor:
GTKColorChooserPanel.valueMnemonic=86
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Erro
FileChooser.renameFileErrorText=Erro ao renomear o arquivo "{0}" por "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=OK
OptionPane.okButtonMnemonic=79
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Cancelar
OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_sv.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_sv.properties Wed Jul 05 17:42:56 2017 +0200
@@ -39,7 +39,7 @@
GTKColorChooserPanel.blueMnemonic=66
GTKColorChooserPanel.colorNameText=F\u00E4rgnamn:
-GTKColorChooserPanel.colorNameMnemonic=78
+GTKColorChooserPanel.colorNameMnemonic=70
@@ -79,6 +79,10 @@
FileChooser.renameFileErrorTitle=Fel
FileChooser.renameFileErrorText=Fel vid namn\u00E4ndring av fil "{0}" till "{1}"
+# dummy resource added for translation automation
+OptionPane.okButtonText=OK
OptionPane.okButtonMnemonic=79
+# dummy resource added for translation automation
+OptionPane.cancelButtonText=Avbryt
OptionPane.cancelButtonMnemonic=65
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_zh_CN.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_zh_CN.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.deleteFileButtonMnemonic=76
FileChooser.renameFileButtonText=\u91CD\u547D\u540D\u6587\u4EF6(R)
FileChooser.renameFileButtonMnemonic=82
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\u786E\u5B9A(O)
+FileChooser.saveButtonText=\u786E\u5B9A
FileChooser.saveButtonMnemonic=79
-FileChooser.openButtonText=\u786E\u5B9A(O)
+FileChooser.openButtonText=\u786E\u5B9A
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u4FDD\u5B58
FileChooser.openDialogTitleText=\u6253\u5F00
@@ -79,6 +79,6 @@
FileChooser.renameFileErrorTitle=\u9519\u8BEF
FileChooser.renameFileErrorText=\u5C06\u6587\u4EF6 "{0}" \u91CD\u547D\u540D\u4E3A "{1}" \u65F6\u51FA\u9519
-OptionPane.okButtonMnemonic=79
-OptionPane.cancelButtonMnemonic=67
+#OptionPane.okButtonMnemonic=79
+#OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_zh_TW.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/java/swing/plaf/gtk/resources/gtk_zh_TW.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.deleteFileButtonMnemonic=76
FileChooser.renameFileButtonText=\u91CD\u65B0\u547D\u540D\u6A94\u6848(R)
FileChooser.renameFileButtonMnemonic=82
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\u78BA\u5B9A(O)
+FileChooser.saveButtonText=\u78BA\u5B9A
FileChooser.saveButtonMnemonic=79
-FileChooser.openButtonText=\u78BA\u5B9A(O)
+FileChooser.openButtonText=\u78BA\u5B9A
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u5132\u5B58
FileChooser.openDialogTitleText=\u958B\u555F
@@ -79,6 +79,6 @@
FileChooser.renameFileErrorTitle=\u932F\u8AA4
FileChooser.renameFileErrorText=\u5C07\u6A94\u6848 "{0}" \u91CD\u65B0\u547D\u540D\u70BA "{1}" \u6642\u51FA\u73FE\u932F\u8AA4
-OptionPane.okButtonMnemonic=79
-OptionPane.cancelButtonMnemonic=67
+#OptionPane.okButtonMnemonic=79
+#OptionPane.cancelButtonMnemonic=67
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic.properties Wed Jul 05 17:42:56 2017 +0200
@@ -57,11 +57,11 @@
Specify a different file name.
FileChooser.acceptAllFileFilterText=All Files
FileChooser.cancelButtonText=Cancel
-FileChooser.cancelButtonMnemonic=67
+#FileChooser.cancelButtonMnemonic=67 // not needed?
FileChooser.saveButtonText=Save
-FileChooser.saveButtonMnemonic=83
+FileChooser.saveButtonMnemonic=83 // not needed?
FileChooser.openButtonText=Open
-FileChooser.openButtonMnemonic=79
+FileChooser.openButtonMnemonic=79 //not needed?
FileChooser.saveDialogTitleText=Save
FileChooser.openDialogTitleText=Open
FileChooser.updateButtonText=Update
@@ -121,11 +121,11 @@
ColorChooser.rgbNameText=RGB
ColorChooser.rgbMnemonic=71
ColorChooser.rgbRedText=Red
-ColorChooser.rgbRedMnemonic=68
+ColorChooser.rgbRedMnemonic=68 // not needed?
ColorChooser.rgbGreenText=Green
-ColorChooser.rgbGreenMnemonic=78
+ColorChooser.rgbGreenMnemonic=78 // not needed?
ColorChooser.rgbBlueText=Blue
-ColorChooser.rgbBlueMnemonic=66
+ColorChooser.rgbBlueMnemonic=66 // not needed?
ColorChooser.rgbAlphaText=Alpha
ColorChooser.rgbHexCodeText=Color Code
ColorChooser.rgbHexCodeMnemonic=67
@@ -146,9 +146,9 @@
OptionPane.noButtonText=No
OptionPane.noButtonMnemonic=78
OptionPane.okButtonText=OK
-OptionPane.okButtonMnemonic=0
+#OptionPane.okButtonMnemonic=0
OptionPane.cancelButtonText=Cancel
-OptionPane.cancelButtonMnemonic=0
+#OptionPane.cancelButtonMnemonic=0
OptionPane.titleText=Select an Option
# Title for the dialog for the showInputDialog methods. Only used if
# the developer uses one of the variants that doesn't take a title.
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_de.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_de.properties Wed Jul 05 17:42:56 2017 +0200
@@ -144,10 +144,10 @@
OptionPane.yesButtonMnemonic=74
OptionPane.noButtonText=Nein
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=Abbrechen(0)
-OptionPane.cancelButtonMnemonic=0
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=Abbrechen
+OptionPane.cancelButtonMnemonic=A
OptionPane.titleText=Option ausw\u00E4hlen
# Title for the dialog for the showInputDialog methods. Only used if
# the developer uses one of the variants that doesn't take a title.
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_es.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_es.properties Wed Jul 05 17:42:56 2017 +0200
@@ -144,10 +144,10 @@
OptionPane.yesButtonMnemonic=83
OptionPane.noButtonText=No
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=Cancelar (0)
-OptionPane.cancelButtonMnemonic=0
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=Cancelar
+OptionPane.cancelButtonMnemonic=C
OptionPane.titleText=Seleccionar una Opci\u00F3n
# Title for the dialog for the showInputDialog methods. Only used if
# the developer uses one of the variants that doesn't take a title.
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_fr.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_fr.properties Wed Jul 05 17:42:56 2017 +0200
@@ -144,10 +144,10 @@
OptionPane.yesButtonMnemonic=79
OptionPane.noButtonText=Non
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=Annuler (0)
-OptionPane.cancelButtonMnemonic=0
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=Annuler
+OptionPane.cancelButtonMnemonic=A
OptionPane.titleText=S\u00E9lectionner une option
# Title for the dialog for the showInputDialog methods. Only used if
# the developer uses one of the variants that doesn't take a title.
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_ja.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_ja.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.renameErrorText={0}\u306E\u540D\u524D\u3092\u5909\u66F4\u3067\u304D\u307E\u305B\u3093
FileChooser.renameErrorFileExistsText={0}\u306E\u540D\u524D\u3092\u5909\u66F4\u3067\u304D\u307E\u305B\u3093: \u6307\u5B9A\u3057\u305F\u540D\u524D\u306E\u30D5\u30A1\u30A4\u30EB\u306F\u3059\u3067\u306B\u5B58\u5728\u3057\u307E\u3059\u3002\u5225\u306E\u30D5\u30A1\u30A4\u30EB\u540D\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002
FileChooser.acceptAllFileFilterText=\u3059\u3079\u3066\u306E\u30D5\u30A1\u30A4\u30EB
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\u4FDD\u5B58(S)
+FileChooser.saveButtonText=\u4FDD\u5B58
FileChooser.saveButtonMnemonic=83
-FileChooser.openButtonText=\u958B\u304F(O)
+FileChooser.openButtonText=\u958B\u304F
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u4FDD\u5B58
FileChooser.openDialogTitleText=\u958B\u304F
@@ -105,25 +105,25 @@
# constant, and an index into the text to render the mnemonic as. The
# mnemonic is xxxMnemonic and the index of the character to underline is
# xxxDisplayedMnemonicIndex.
-ColorChooser.hsvNameText=HSV(H)
+ColorChooser.hsvNameText=HSV
ColorChooser.hsvMnemonic=72
ColorChooser.hsvHueText=\u8272\u76F8
ColorChooser.hsvSaturationText=\u5F69\u5EA6
ColorChooser.hsvValueText=\u5024
ColorChooser.hsvTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.hslNameText=HSL(L)
+ColorChooser.hslNameText=HSL
ColorChooser.hslMnemonic=76
ColorChooser.hslHueText=\u8272\u76F8
ColorChooser.hslSaturationText=\u5F69\u5EA6
ColorChooser.hslLightnessText=\u660E\u5EA6
ColorChooser.hslTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.rgbNameText=RGB(G)
+ColorChooser.rgbNameText=RGB
ColorChooser.rgbMnemonic=71
-ColorChooser.rgbRedText=\u8D64(D)
+ColorChooser.rgbRedText=\u8D64
ColorChooser.rgbRedMnemonic=68
-ColorChooser.rgbGreenText=\u7DD1(N)
+ColorChooser.rgbGreenText=\u7DD1
ColorChooser.rgbGreenMnemonic=78
-ColorChooser.rgbBlueText=\u9752(B)
+ColorChooser.rgbBlueText=\u9752
ColorChooser.rgbBlueMnemonic=66
ColorChooser.rgbAlphaText=\u30A2\u30EB\u30D5\u30A1
ColorChooser.rgbHexCodeText=\u8272\u30B3\u30FC\u30C9(C)
@@ -144,9 +144,9 @@
OptionPane.yesButtonMnemonic=89
OptionPane.noButtonText=\u3044\u3044\u3048(N)
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=\u53D6\u6D88(0)
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=\u53D6\u6D88
OptionPane.cancelButtonMnemonic=0
OptionPane.titleText=\u30AA\u30D7\u30B7\u30E7\u30F3\u306E\u9078\u629E
# Title for the dialog for the showInputDialog methods. Only used if
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_ko.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_ko.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.renameErrorText={0}\uC758 \uC774\uB984\uC744 \uBC14\uAFC0 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.
FileChooser.renameErrorFileExistsText={0}\uC758 \uC774\uB984\uC744 \uBC14\uAFC0 \uC218 \uC5C6\uC74C: \uC9C0\uC815\uD55C \uC774\uB984\uC744 \uC0AC\uC6A9\uD558\uB294 \uD30C\uC77C\uC774 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB2E4\uB978 \uD30C\uC77C \uC774\uB984\uC744 \uC9C0\uC815\uD558\uC2ED\uC2DC\uC624.
FileChooser.acceptAllFileFilterText=\uBAA8\uB4E0 \uD30C\uC77C
-FileChooser.cancelButtonText=\uCDE8\uC18C(C)
+FileChooser.cancelButtonText=\uCDE8\uC18C
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\uC800\uC7A5(S)
+FileChooser.saveButtonText=\uC800\uC7A5
FileChooser.saveButtonMnemonic=83
-FileChooser.openButtonText=\uC5F4\uAE30(O)
+FileChooser.openButtonText=\uC5F4\uAE30
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\uC800\uC7A5
FileChooser.openDialogTitleText=\uC5F4\uAE30
@@ -105,25 +105,25 @@
# constant, and an index into the text to render the mnemonic as. The
# mnemonic is xxxMnemonic and the index of the character to underline is
# xxxDisplayedMnemonicIndex.
-ColorChooser.hsvNameText=HSV(H)
+ColorChooser.hsvNameText=HSV
ColorChooser.hsvMnemonic=72
ColorChooser.hsvHueText=\uC0C9\uC870
ColorChooser.hsvSaturationText=\uCC44\uB3C4
ColorChooser.hsvValueText=\uAC12
ColorChooser.hsvTransparencyText=\uD22C\uBA85
-ColorChooser.hslNameText=HSL(L)
+ColorChooser.hslNameText=HSL
ColorChooser.hslMnemonic=76
ColorChooser.hslHueText=\uC0C9\uC870
ColorChooser.hslSaturationText=\uCC44\uB3C4
ColorChooser.hslLightnessText=\uBC1D\uAE30
ColorChooser.hslTransparencyText=\uD22C\uBA85
-ColorChooser.rgbNameText=RGB(G)
+ColorChooser.rgbNameText=RGB
ColorChooser.rgbMnemonic=71
-ColorChooser.rgbRedText=\uBE68\uAC04\uC0C9(D)
+ColorChooser.rgbRedText=\uBE68\uAC04\uC0C9
ColorChooser.rgbRedMnemonic=68
-ColorChooser.rgbGreenText=\uB179\uC0C9(N)
+ColorChooser.rgbGreenText=\uB179\uC0C9
ColorChooser.rgbGreenMnemonic=78
-ColorChooser.rgbBlueText=\uD30C\uB780\uC0C9(B)
+ColorChooser.rgbBlueText=\uD30C\uB780\uC0C9
ColorChooser.rgbBlueMnemonic=66
ColorChooser.rgbAlphaText=\uC54C\uD30C
ColorChooser.rgbHexCodeText=\uC0C9\uC0C1 \uCF54\uB4DC(C)
@@ -144,9 +144,9 @@
OptionPane.yesButtonMnemonic=89
OptionPane.noButtonText=\uC544\uB2C8\uC624(N)
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=\uCDE8\uC18C(0)
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=\uCDE8\uC18C
OptionPane.cancelButtonMnemonic=0
OptionPane.titleText=\uC635\uC158 \uC120\uD0DD
# Title for the dialog for the showInputDialog methods. Only used if
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_pt_BR.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_pt_BR.properties Wed Jul 05 17:42:56 2017 +0200
@@ -144,10 +144,10 @@
OptionPane.yesButtonMnemonic=83
OptionPane.noButtonText=N\u00E3o
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=Cancelar(0)
-OptionPane.cancelButtonMnemonic=0
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=Cancelar
+OptionPane.cancelButtonMnemonic=C
OptionPane.titleText=Selecionar uma Op\u00E7\u00E3o
# Title for the dialog for the showInputDialog methods. Only used if
# the developer uses one of the variants that doesn't take a title.
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_sv.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_sv.properties Wed Jul 05 17:42:56 2017 +0200
@@ -96,7 +96,7 @@
ColorChooser.cancelText=Avbryt
ColorChooser.resetText=\u00C5terst\u00E4ll
# VK_XXX constant for 'ColorChooser.resetText' button to make mnemonic
-ColorChooser.resetMnemonic=82
+ColorChooser.resetMnemonic=84
ColorChooser.sampleText=Exempeltext Exempeltext
ColorChooser.swatchesNameText=Prov
ColorChooser.swatchesMnemonic=80
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_zh_CN.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_zh_CN.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.renameErrorText=\u65E0\u6CD5\u91CD\u547D\u540D{0}
FileChooser.renameErrorFileExistsText=\u65E0\u6CD5\u91CD\u547D\u540D{0}: \u5DF2\u5B58\u5728\u5177\u6709\u6240\u6307\u5B9A\u540D\u79F0\u7684\u6587\u4EF6\u3002\u8BF7\u6307\u5B9A\u5176\u4ED6\u6587\u4EF6\u540D\u3002
FileChooser.acceptAllFileFilterText=\u6240\u6709\u6587\u4EF6
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\u4FDD\u5B58(S)
+FileChooser.saveButtonText=\u4FDD\u5B58
FileChooser.saveButtonMnemonic=83
-FileChooser.openButtonText=\u6253\u5F00(O)
+FileChooser.openButtonText=\u6253\u5F00
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u4FDD\u5B58
FileChooser.openDialogTitleText=\u6253\u5F00
@@ -105,25 +105,25 @@
# constant, and an index into the text to render the mnemonic as. The
# mnemonic is xxxMnemonic and the index of the character to underline is
# xxxDisplayedMnemonicIndex.
-ColorChooser.hsvNameText=HSV(H)
+ColorChooser.hsvNameText=HSV
ColorChooser.hsvMnemonic=72
ColorChooser.hsvHueText=\u8272\u8C03
ColorChooser.hsvSaturationText=\u9971\u548C\u5EA6
ColorChooser.hsvValueText=\u503C
ColorChooser.hsvTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.hslNameText=HSL(L)
+ColorChooser.hslNameText=HSL
ColorChooser.hslMnemonic=76
ColorChooser.hslHueText=\u8272\u8C03
ColorChooser.hslSaturationText=\u9971\u548C\u5EA6
ColorChooser.hslLightnessText=\u4EAE\u5EA6
ColorChooser.hslTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.rgbNameText=RGB(G)
+ColorChooser.rgbNameText=RGB
ColorChooser.rgbMnemonic=71
-ColorChooser.rgbRedText=\u7EA2\u8272(D)
+ColorChooser.rgbRedText=\u7EA2\u8272
ColorChooser.rgbRedMnemonic=68
-ColorChooser.rgbGreenText=\u7EFF\u8272(N)
+ColorChooser.rgbGreenText=\u7EFF\u8272
ColorChooser.rgbGreenMnemonic=78
-ColorChooser.rgbBlueText=\u84DD\u8272(B)
+ColorChooser.rgbBlueText=\u84DD\u8272
ColorChooser.rgbBlueMnemonic=66
ColorChooser.rgbAlphaText=Alpha
ColorChooser.rgbHexCodeText=\u989C\u8272\u4EE3\u7801(C)
@@ -144,9 +144,9 @@
OptionPane.yesButtonMnemonic=89
OptionPane.noButtonText=\u5426(N)
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=\u53D6\u6D88(0)
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=\u53D6\u6D88
OptionPane.cancelButtonMnemonic=0
OptionPane.titleText=\u9009\u62E9\u4E00\u4E2A\u9009\u9879
# Title for the dialog for the showInputDialog methods. Only used if
--- a/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_zh_TW.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/com/sun/swing/internal/plaf/basic/resources/basic_zh_TW.properties Wed Jul 05 17:42:56 2017 +0200
@@ -55,11 +55,11 @@
FileChooser.renameErrorText=\u7121\u6CD5\u91CD\u65B0\u547D\u540D {0}
FileChooser.renameErrorFileExistsText=\u7121\u6CD5\u91CD\u65B0\u547D\u540D {0}: \u5DF2\u7D93\u5B58\u5728\u60A8\u6240\u6307\u5B9A\u540D\u7A31\u7684\u6A94\u6848\u3002\u8ACB\u6307\u5B9A\u4E0D\u540C\u7684\u540D\u7A31\u3002
FileChooser.acceptAllFileFilterText=\u6240\u6709\u6A94\u6848
-FileChooser.cancelButtonText=\u53D6\u6D88(C)
+FileChooser.cancelButtonText=\u53D6\u6D88
FileChooser.cancelButtonMnemonic=67
-FileChooser.saveButtonText=\u5132\u5B58(S)
+FileChooser.saveButtonText=\u5132\u5B58
FileChooser.saveButtonMnemonic=83
-FileChooser.openButtonText=\u958B\u555F(O)
+FileChooser.openButtonText=\u958B\u555F
FileChooser.openButtonMnemonic=79
FileChooser.saveDialogTitleText=\u5132\u5B58
FileChooser.openDialogTitleText=\u958B\u555F
@@ -105,25 +105,25 @@
# constant, and an index into the text to render the mnemonic as. The
# mnemonic is xxxMnemonic and the index of the character to underline is
# xxxDisplayedMnemonicIndex.
-ColorChooser.hsvNameText=HSV(H)
+ColorChooser.hsvNameText=HSV
ColorChooser.hsvMnemonic=72
ColorChooser.hsvHueText=\u8272\u8ABF
ColorChooser.hsvSaturationText=\u5F69\u5EA6
ColorChooser.hsvValueText=\u6578\u503C
ColorChooser.hsvTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.hslNameText=HSL(L)
+ColorChooser.hslNameText=HSL
ColorChooser.hslMnemonic=76
ColorChooser.hslHueText=\u8272\u8ABF
ColorChooser.hslSaturationText=\u5F69\u5EA6
ColorChooser.hslLightnessText=\u4EAE\u5EA6
ColorChooser.hslTransparencyText=\u900F\u660E\u5EA6
-ColorChooser.rgbNameText=RGB(G)
+ColorChooser.rgbNameText=RGB
ColorChooser.rgbMnemonic=71
-ColorChooser.rgbRedText=\u7D05(D)
+ColorChooser.rgbRedText=\u7D05
ColorChooser.rgbRedMnemonic=68
-ColorChooser.rgbGreenText=\u7DA0(N)
+ColorChooser.rgbGreenText=\u7DA0
ColorChooser.rgbGreenMnemonic=78
-ColorChooser.rgbBlueText=\u85CD(B)
+ColorChooser.rgbBlueText=\u85CD
ColorChooser.rgbBlueMnemonic=66
ColorChooser.rgbAlphaText=Alpha
ColorChooser.rgbHexCodeText=\u984F\u8272\u4EE3\u78BC(C)
@@ -144,9 +144,9 @@
OptionPane.yesButtonMnemonic=89
OptionPane.noButtonText=\u5426(N)
OptionPane.noButtonMnemonic=78
-OptionPane.okButtonText=OK(0)
-OptionPane.okButtonMnemonic=0
-OptionPane.cancelButtonText=\u53D6\u6D88(0)
+OptionPane.okButtonText=OK
+OptionPane.okButtonMnemonic=O
+OptionPane.cancelButtonText=\u53D6\u6D88
OptionPane.cancelButtonMnemonic=0
OptionPane.titleText=\u9078\u53D6\u4E00\u500B\u9078\u9805
# Title for the dialog for the showInputDialog methods. Only used if
--- a/jdk/src/share/classes/java/util/jar/JarFile.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/java/util/jar/JarFile.java Wed Jul 05 17:42:56 2017 +0200
@@ -37,7 +37,6 @@
import sun.security.action.GetPropertyAction;
import sun.security.util.ManifestEntryVerifier;
import sun.misc.SharedSecrets;
-import sun.security.util.SignatureFileVerifier;
/**
* The <code>JarFile</code> class is used to read the contents of a jar file
@@ -179,7 +178,7 @@
byte[] b = getBytes(manEntry);
man = new Manifest(new ByteArrayInputStream(b));
if (!jvInitialized) {
- jv = new JarVerifier(b, man);
+ jv = new JarVerifier(b);
}
} else {
man = new Manifest(super.getInputStream(manEntry));
@@ -298,7 +297,10 @@
if (names != null) {
for (int i = 0; i < names.length; i++) {
String name = names[i].toUpperCase(Locale.ENGLISH);
- if (SignatureFileVerifier.isBlockOrSF(name)) {
+ if (name.endsWith(".DSA") ||
+ name.endsWith(".RSA") ||
+ name.endsWith(".EC") ||
+ name.endsWith(".SF")) {
// Assume since we found a signature-related file
// that the jar is signed and that we therefore
// need a JarVerifier and Manifest
@@ -327,17 +329,17 @@
if (names != null) {
for (int i = 0; i < names.length; i++) {
JarEntry e = getJarEntry(names[i]);
- if (!e.isDirectory() &&
- SignatureFileVerifier.isBlock(names[i])) {
+ if (!e.isDirectory()) {
if (mev == null) {
mev = new ManifestEntryVerifier
(getManifestFromReference());
}
- String key = names[i].substring(
- 0, names[i].lastIndexOf("."));
- jv.verifyBlock(names[i],
- getBytes(e),
- super.getInputStream(getJarEntry(key + ".SF")));
+ byte[] b = getBytes(e);
+ if (b != null && b.length > 0) {
+ jv.beginEntry(e, mev);
+ jv.update(b.length, b, 0, b.length, mev);
+ jv.update(-1, null, 0, 0, mev);
+ }
}
}
}
--- a/jdk/src/share/classes/java/util/jar/JarInputStream.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/java/util/jar/JarInputStream.java Wed Jul 05 17:42:56 2017 +0200
@@ -95,7 +95,7 @@
man.read(new ByteArrayInputStream(bytes));
closeEntry();
if (doVerify) {
- jv = new JarVerifier(bytes, man);
+ jv = new JarVerifier(bytes);
mev = new ManifestEntryVerifier(man);
}
return (JarEntry)super.getNextEntry();
--- a/jdk/src/share/classes/java/util/jar/JarVerifier.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/java/util/jar/JarVerifier.java Wed Jul 05 17:42:56 2017 +0200
@@ -48,18 +48,35 @@
/* a table mapping names to code signers, for jar entries that have
had their actual hashes verified */
- private Map verifiedSigners;
+ private Hashtable verifiedSigners;
/* a table mapping names to code signers, for jar entries that have
passed the .SF/.DSA/.EC -> MANIFEST check */
- private Map sigFileSigners;
+ private Hashtable sigFileSigners;
+
+ /* a hash table to hold .SF bytes */
+ private Hashtable sigFileData;
+
+ /** "queue" of pending PKCS7 blocks that we couldn't parse
+ * until we parsed the .SF file */
+ private ArrayList pendingBlocks;
/* cache of CodeSigner objects */
private ArrayList signerCache;
+ /* Are we parsing a block? */
+ private boolean parsingBlockOrSF = false;
+
+ /* Are we done parsing META-INF entries? */
+ private boolean parsingMeta = true;
+
/* Are there are files to verify? */
private boolean anyToVerify = true;
+ /* The output stream to use when keeping track of files we are interested
+ in */
+ private ByteArrayOutputStream baos;
+
/** The ManifestDigester object */
private volatile ManifestDigester manDig;
@@ -75,20 +92,20 @@
/** collect -DIGEST-MANIFEST values for blacklist */
private List manifestDigests;
- /** The manifest object */
- Manifest man = null;
-
- public JarVerifier(byte rawBytes[], Manifest man) {
- this.man = man;
+ public JarVerifier(byte rawBytes[]) {
manifestRawBytes = rawBytes;
- sigFileSigners = new HashMap();
- verifiedSigners = new HashMap();
+ sigFileSigners = new Hashtable();
+ verifiedSigners = new Hashtable();
+ sigFileData = new Hashtable(11);
+ pendingBlocks = new ArrayList();
+ baos = new ByteArrayOutputStream();
manifestDigests = new ArrayList();
}
/**
- * This method scans to see which entry we're parsing and keeps
- * various state information depending on the file being parsed.
+ * This method scans to see which entry we're parsing and
+ * keeps various state information depending on what type of
+ * file is being parsed.
*/
public void beginEntry(JarEntry je, ManifestEntryVerifier mev)
throws IOException
@@ -112,6 +129,30 @@
* b. digest mismatch between the actual jar entry and the manifest
*/
+ if (parsingMeta) {
+ String uname = name.toUpperCase(Locale.ENGLISH);
+ if ((uname.startsWith("META-INF/") ||
+ uname.startsWith("/META-INF/"))) {
+
+ if (je.isDirectory()) {
+ mev.setEntry(null, je);
+ return;
+ }
+
+ if (SignatureFileVerifier.isBlockOrSF(uname)) {
+ /* We parse only DSA, RSA or EC PKCS7 blocks. */
+ parsingBlockOrSF = true;
+ baos.reset();
+ mev.setEntry(null, je);
+ }
+ return;
+ }
+ }
+
+ if (parsingMeta) {
+ doneWithMeta();
+ }
+
if (je.isDirectory()) {
mev.setEntry(null, je);
return;
@@ -147,7 +188,11 @@
throws IOException
{
if (b != -1) {
- mev.update((byte)b);
+ if (parsingBlockOrSF) {
+ baos.write(b);
+ } else {
+ mev.update((byte)b);
+ }
} else {
processEntry(mev);
}
@@ -162,7 +207,11 @@
throws IOException
{
if (n != -1) {
- mev.update(b, off, n);
+ if (parsingBlockOrSF) {
+ baos.write(b, off, n);
+ } else {
+ mev.update(b, off, n);
+ }
} else {
processEntry(mev);
}
@@ -174,10 +223,101 @@
private void processEntry(ManifestEntryVerifier mev)
throws IOException
{
- JarEntry je = mev.getEntry();
- if ((je != null) && (je.signers == null)) {
- je.signers = mev.verify(verifiedSigners, sigFileSigners);
- je.certs = mapSignersToCertArray(je.signers);
+ if (!parsingBlockOrSF) {
+ JarEntry je = mev.getEntry();
+ if ((je != null) && (je.signers == null)) {
+ je.signers = mev.verify(verifiedSigners, sigFileSigners);
+ je.certs = mapSignersToCertArray(je.signers);
+ }
+ } else {
+
+ try {
+ parsingBlockOrSF = false;
+
+ if (debug != null) {
+ debug.println("processEntry: processing block");
+ }
+
+ String uname = mev.getEntry().getName()
+ .toUpperCase(Locale.ENGLISH);
+
+ if (uname.endsWith(".SF")) {
+ String key = uname.substring(0, uname.length()-3);
+ byte bytes[] = baos.toByteArray();
+ // add to sigFileData in case future blocks need it
+ sigFileData.put(key, bytes);
+ // check pending blocks, we can now process
+ // anyone waiting for this .SF file
+ Iterator it = pendingBlocks.iterator();
+ while (it.hasNext()) {
+ SignatureFileVerifier sfv =
+ (SignatureFileVerifier) it.next();
+ if (sfv.needSignatureFile(key)) {
+ if (debug != null) {
+ debug.println(
+ "processEntry: processing pending block");
+ }
+
+ sfv.setSignatureFile(bytes);
+ sfv.process(sigFileSigners, manifestDigests);
+ }
+ }
+ return;
+ }
+
+ // now we are parsing a signature block file
+
+ String key = uname.substring(0, uname.lastIndexOf("."));
+
+ if (signerCache == null)
+ signerCache = new ArrayList();
+
+ if (manDig == null) {
+ synchronized(manifestRawBytes) {
+ if (manDig == null) {
+ manDig = new ManifestDigester(manifestRawBytes);
+ manifestRawBytes = null;
+ }
+ }
+ }
+
+ SignatureFileVerifier sfv =
+ new SignatureFileVerifier(signerCache,
+ manDig, uname, baos.toByteArray());
+
+ if (sfv.needSignatureFileBytes()) {
+ // see if we have already parsed an external .SF file
+ byte[] bytes = (byte[]) sigFileData.get(key);
+
+ if (bytes == null) {
+ // put this block on queue for later processing
+ // since we don't have the .SF bytes yet
+ // (uname, block);
+ if (debug != null) {
+ debug.println("adding pending block");
+ }
+ pendingBlocks.add(sfv);
+ return;
+ } else {
+ sfv.setSignatureFile(bytes);
+ }
+ }
+ sfv.process(sigFileSigners, manifestDigests);
+
+ } catch (IOException ioe) {
+ // e.g. sun.security.pkcs.ParsingException
+ if (debug != null) debug.println("processEntry caught: "+ioe);
+ // ignore and treat as unsigned
+ } catch (SignatureException se) {
+ if (debug != null) debug.println("processEntry caught: "+se);
+ // ignore and treat as unsigned
+ } catch (NoSuchAlgorithmException nsae) {
+ if (debug != null) debug.println("processEntry caught: "+nsae);
+ // ignore and treat as unsigned
+ } catch (CertificateException ce) {
+ if (debug != null) debug.println("processEntry caught: "+ce);
+ // ignore and treat as unsigned
+ }
}
}
@@ -214,15 +354,15 @@
* Force a read of the entry data to generate the
* verification hash.
*/
- try (InputStream s = jar.getInputStream(entry)) {
+ try {
+ InputStream s = jar.getInputStream(entry);
byte[] buffer = new byte[1024];
int n = buffer.length;
while (n != -1) {
n = s.read(buffer, 0, buffer.length);
}
+ s.close();
} catch (IOException e) {
- // Ignore. When an exception is thrown, code signer
- // will not be assigned.
}
}
return getCodeSigners(name);
@@ -268,7 +408,11 @@
*/
void doneWithMeta()
{
+ parsingMeta = false;
anyToVerify = !sigFileSigners.isEmpty();
+ baos = null;
+ sigFileData = null;
+ pendingBlocks = null;
signerCache = null;
manDig = null;
// MANIFEST.MF is always treated as signed and verified,
@@ -279,41 +423,6 @@
}
}
- /**
- * Verifies a PKCS7 SignedData block
- * @param key name of block
- * @param block the pkcs7 file
- * @param ins the clear data
- */
- void verifyBlock(String key, byte[] block, InputStream ins) {
- try {
- if (signerCache == null)
- signerCache = new ArrayList();
-
- if (manDig == null) {
- synchronized(manifestRawBytes) {
- if (manDig == null) {
- manDig = new ManifestDigester(manifestRawBytes);
- manifestRawBytes = null;
- }
- }
- }
- SignatureFileVerifier sfv =
- new SignatureFileVerifier(signerCache, man,
- manDig, key, block);
-
- if (sfv.needSignatureFile()) {
- // see if we have already parsed an external .SF file
- sfv.setSignatureFile(ins);
- }
- sfv.process(sigFileSigners, manifestDigests);
- } catch (Exception e) {
- if (debug != null) {
- e.printStackTrace();
- }
- }
- }
-
static class VerifierStream extends java.io.InputStream {
private InputStream is;
@@ -444,7 +553,10 @@
* but this handles a CodeSource of any type, just in case.
*/
CodeSource[] sources = mapSignersToCodeSources(cs.getLocation(), getJarCodeSigners(), true);
- List sourceList = Arrays.asList(sources);
+ List sourceList = new ArrayList();
+ for (int i = 0; i < sources.length; i++) {
+ sourceList.add(sources[i]);
+ }
int j = sourceList.indexOf(cs);
if (j != -1) {
CodeSigner[] match;
--- a/jdk/src/share/classes/sun/applet/resources/MsgAppletViewer_sv.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/applet/resources/MsgAppletViewer_sv.java Wed Jul 05 17:42:56 2017 +0200
@@ -73,7 +73,7 @@
{"appletviewer.parse.warning.embed.requiresheight", "Varning: <embed>-taggen kr\u00E4ver ett h\u00F6jdattribut."},
{"appletviewer.parse.warning.embed.requireswidth", "Varning: <embed>-taggen kr\u00E4ver ett breddattribut."},
{"appletviewer.parse.warning.appnotLongersupported", "Varning: <app>-taggen st\u00F6ds inte l\u00E4ngre, anv\u00E4nd <applet> ist\u00E4llet:"},
- {"appletviewer.usage", "Syntax: appletviewer <alternativ> url:er \n\nd\u00E4r <alternativ> inkluderar:\n -debug Startar appletvisning i Java-fels\u00F6kningen\n -encoding <kodning> Anger teckenkodning som anv\u00E4nds i HTML-filer\n -J<k\u00F6rningsflagga> \u00D6verf\u00F6r argument till Java-tolkningen\n\nAlternativet -J \u00E4r inte standard och kan \u00E4ndras utan f\u00F6reg\u00E5ende meddelande."},
+ {"appletviewer.usage", "Syntax: appletviewer-<alternativ> url:er \n\nd\u00E4r <alternativ> inkluderar:\n -debug Startar appletvisning i Java-fels\u00F6kningen\n -encoding <kodning> Anger teckenkodning som anv\u00E4nds i HTML-filer\n -J<k\u00F6rningsflagga> \u00D6verf\u00F6r argument till Java-tolkningen\n\nAlternativet -J \u00E4r inte standard och kan \u00E4ndras utan f\u00F6reg\u00E5ende meddelande."},
{"appletviewer.main.err.unsupportedopt", "Alternativ som inte st\u00F6ds: {0}"},
{"appletviewer.main.err.unrecognizedarg", "Ok\u00E4nt argument: {0}"},
{"appletviewer.main.err.dupoption", "Duplicerat alternativ: {0}"},
@@ -152,7 +152,7 @@
{"appletprops.label.unsignedapplet", "Till\u00E5t osignerade appletar:"},
{"appletprops.choice.unsignedapplet.no", "Nej"},
{"appletprops.choice.unsignedapplet.yes", "Ja"},
- {"appletprops.button.apply", "Till\u00E4mpa"},
+ {"appletprops.button.apply", "Anv\u00E4nd"},
{"appletprops.button.cancel", "Avbryt"},
{"appletprops.button.reset", "\u00C5terst\u00E4ll"},
{"appletprops.apply.exception", "Kunde inte spara egenskaper: {0}"},
--- a/jdk/src/share/classes/sun/print/resources/serviceui_fr.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/print/resources/serviceui_fr.properties Wed Jul 05 17:42:56 2017 +0200
@@ -49,7 +49,7 @@
label.source.mnemonic=C
label.status=Statut :
label.username=Nom utilisateur :
-label.username.mnemonic=U
+label.username.mnemonic=O
label.millimetres=(mm)
label.inches=(po)
label.topmargin=haut
@@ -62,7 +62,7 @@
label.rightmargin.mnemonic=D
#
radiobutton.color=Couleur
-radiobutton.color.mnemonic=U
+radiobutton.color.mnemonic=C
radiobutton.draftq=Brouillon
radiobutton.draftq.mnemonic=L
radiobutton.duplex=Duplex
@@ -70,7 +70,7 @@
radiobutton.highq=Max.
radiobutton.highq.mnemonic=X
radiobutton.landscape=Paysage
-radiobutton.landscape.mnemonic=S
+radiobutton.landscape.mnemonic=Y
radiobutton.monochrome=Monochrome
radiobutton.monochrome.mnemonic=M
radiobutton.normalq=Normal
--- a/jdk/src/share/classes/sun/print/resources/serviceui_pt_BR.properties Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/print/resources/serviceui_pt_BR.properties Wed Jul 05 17:42:56 2017 +0200
@@ -15,10 +15,10 @@
button.ok=OK
button.print=Imprimir
button.properties=Propriedades...
-button.properties.mnemonic=R
+button.properties.mnemonic=D
#
checkbox.collate=Agrupar
-checkbox.collate.mnemonic=A
+checkbox.collate.mnemonic=R
checkbox.jobsheets=P\u00E1gina com Banner
checkbox.jobsheets.mnemonic=B
checkbox.printtofile=Imprimir em Arquivo
@@ -38,7 +38,7 @@
label.numcopies=N\u00FAmero de c\u00F3pias:
label.numcopies.mnemonic=O
label.priority=Prioridade:
-label.priority.mnemonic=R
+label.priority.mnemonic=P
label.psname=Nome:
label.psname.mnemonic=N
label.pstype=Tipo:
@@ -59,7 +59,7 @@
label.leftmargin=esquerda:
label.leftmargin.mnemonic=Q
label.rightmargin=direita
-label.rightmargin.mnemonic=R
+label.rightmargin.mnemonic=D
#
radiobutton.color=Cor
radiobutton.color.mnemonic=O
@@ -68,7 +68,7 @@
radiobutton.duplex=Duplex
radiobutton.duplex.mnemonic=D
radiobutton.highq=Alta
-radiobutton.highq.mnemonic=A
+radiobutton.highq.mnemonic=T
radiobutton.landscape=Paisagem
radiobutton.landscape.mnemonic=P
radiobutton.monochrome=Monocrom\u00E1tico
@@ -76,7 +76,7 @@
radiobutton.normalq=Normal
radiobutton.normalq.mnemonic=N
radiobutton.oneside=Um Lado
-radiobutton.oneside.mnemonic=O
+radiobutton.oneside.mnemonic=L
radiobutton.portrait=Retrato
radiobutton.portrait.mnemonic=R
radiobutton.rangeall=Tudo
@@ -86,7 +86,7 @@
radiobutton.revlandscape=Paisagem Invertida
radiobutton.revlandscape.mnemonic=N
radiobutton.revportrait=Retrato Invertido
-radiobutton.revportrait.mnemonic=I
+radiobutton.revportrait.mnemonic=E
radiobutton.tumble=Virar
radiobutton.tumble.mnemonic=V
# The vkMnemonics correspond with the constants defined in KeyEvent, eg
@@ -96,7 +96,7 @@
tab.general=Geral
tab.general.vkMnemonic=71
tab.pagesetup=Configura\u00E7\u00E3o de P\u00E1gina
-tab.pagesetup.vkMnemonic=80
+tab.pagesetup.vkMnemonic=67
#
error.pagerange=Faixa de p\u00E1ginas inv\u00E1lida; insira novamente os valores (por exemplo, 1-3,5,7-10)
error.destination=Nome de arquivo inv\u00E1lido; tente novamente
--- a/jdk/src/share/classes/sun/security/pkcs/PKCS7.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/security/pkcs/PKCS7.java Wed Jul 05 17:42:56 2017 +0200
@@ -38,7 +38,6 @@
import sun.security.util.*;
import sun.security.x509.AlgorithmId;
import sun.security.x509.CertificateIssuerName;
-import sun.security.x509.KeyUsageExtension;
import sun.security.x509.X509CertImpl;
import sun.security.x509.X509CertInfo;
import sun.security.x509.X509CRLImpl;
@@ -493,7 +492,7 @@
// CRLs (optional)
if (crls != null && crls.length != 0) {
// cast to X509CRLImpl[] since X509CRLImpl implements DerEncoder
- Set<X509CRLImpl> implCRLs = new HashSet<>(crls.length);
+ Set<X509CRLImpl> implCRLs = new HashSet<X509CRLImpl>(crls.length);
for (X509CRL crl: crls) {
if (crl instanceof X509CRLImpl)
implCRLs.add((X509CRLImpl) crl);
@@ -531,168 +530,6 @@
}
/**
- * Verifying signed data using an external chunked data source.
- */
- public static class PKCS7Verifier {
-
- private final SignerInfo si; // Signer to verify
- private final MessageDigest md; // MessageDigest object for chunks
- private final Signature sig; // Signature object for chunks
-
- private PKCS7Verifier(SignerInfo si, MessageDigest md, Signature sig) {
- this.si = si;
- this.md = md;
- this.sig = sig;
- }
-
- public static PKCS7Verifier from(PKCS7 block, SignerInfo si) throws
- SignatureException, NoSuchAlgorithmException {
-
- try {
- MessageDigest md = null;
- Signature sig;
-
- ContentInfo content = block.getContentInfo();
- String digestAlgname = si.getDigestAlgorithmId().getName();
-
- // if there are authenticate attributes, feed data chunks to
- // the message digest. In this case, pv.md is not null
- if (si.authenticatedAttributes != null) {
- // first, check content type
- ObjectIdentifier contentType = (ObjectIdentifier)
- si.authenticatedAttributes.getAttributeValue(
- PKCS9Attribute.CONTENT_TYPE_OID);
- if (contentType == null ||
- !contentType.equals(content.contentType))
- return null; // contentType does not match, bad SignerInfo
-
- // now, check message digest
- byte[] messageDigest = (byte[])
- si.authenticatedAttributes.getAttributeValue(
- PKCS9Attribute.MESSAGE_DIGEST_OID);
-
- if (messageDigest == null) // fail if there is no message digest
- return null;
-
- md = MessageDigest.getInstance(digestAlgname);
- }
-
- // put together digest algorithm and encryption algorithm
- // to form signing algorithm
- String encryptionAlgname =
- si.getDigestEncryptionAlgorithmId().getName();
-
- // Workaround: sometimes the encryptionAlgname is actually
- // a signature name
- String tmp = AlgorithmId.getEncAlgFromSigAlg(encryptionAlgname);
- if (tmp != null) encryptionAlgname = tmp;
- String algname = AlgorithmId.makeSigAlg(
- digestAlgname, encryptionAlgname);
-
- sig = Signature.getInstance(algname);
- X509Certificate cert = si.getCertificate(block);
-
- if (cert == null) {
- return null;
- }
- if (cert.hasUnsupportedCriticalExtension()) {
- throw new SignatureException("Certificate has unsupported "
- + "critical extension(s)");
- }
-
- // Make sure that if the usage of the key in the certificate is
- // restricted, it can be used for digital signatures.
- // XXX We may want to check for additional extensions in the
- // future.
- boolean[] keyUsageBits = cert.getKeyUsage();
- if (keyUsageBits != null) {
- KeyUsageExtension keyUsage;
- try {
- // We don't care whether or not this extension was marked
- // critical in the certificate.
- // We're interested only in its value (i.e., the bits set)
- // and treat the extension as critical.
- keyUsage = new KeyUsageExtension(keyUsageBits);
- } catch (IOException ioe) {
- throw new SignatureException("Failed to parse keyUsage "
- + "extension");
- }
-
- boolean digSigAllowed = ((Boolean)keyUsage.get(
- KeyUsageExtension.DIGITAL_SIGNATURE)).booleanValue();
-
- boolean nonRepuAllowed = ((Boolean)keyUsage.get(
- KeyUsageExtension.NON_REPUDIATION)).booleanValue();
-
- if (!digSigAllowed && !nonRepuAllowed) {
- throw new SignatureException("Key usage restricted: "
- + "cannot be used for "
- + "digital signatures");
- }
- }
-
- PublicKey key = cert.getPublicKey();
- sig.initVerify(key);
- return new PKCS7Verifier(si, md, sig);
- } catch (IOException e) {
- throw new SignatureException("IO error verifying signature:\n" +
- e.getMessage());
-
- } catch (InvalidKeyException e) {
- throw new SignatureException("InvalidKey: " + e.getMessage());
-
- }
- }
-
- public void update(byte[] data, int off, int end)
- throws SignatureException {
- if (md != null) {
- md.update(data, off, end-off);
- } else {
- sig.update(data, off, end-off);
- }
- }
-
- public SignerInfo verify() throws SignatureException {
- try {
- // if there are authenticate attributes, get the message
- // digest and compare it with the digest of data
- if (md != null) {
- // now, check message digest
- byte[] messageDigest = (byte[])
- si.authenticatedAttributes.getAttributeValue(
- PKCS9Attribute.MESSAGE_DIGEST_OID);
-
- byte[] computedMessageDigest = md.digest();
-
- if (!MessageDigest.isEqual(
- messageDigest, computedMessageDigest)) {
- return null;
- }
-
- // message digest attribute matched
- // digest of original data
-
- // the data actually signed is the DER encoding of
- // the authenticated attributes (tagged with
- // the "SET OF" tag, not 0xA0).
- byte[] dataSigned = si.authenticatedAttributes.getDerEncoding();
- sig.update(dataSigned);
- }
-
- if (sig.verify(si.getEncryptedDigest())) {
- return si;
- }
-
- } catch (IOException e) {
- throw new SignatureException("IO error verifying signature:\n" +
- e.getMessage());
- }
- return null;
- }
- }
-
- /**
* This verifies a given SignerInfo.
*
* @param info the signer information.
@@ -717,16 +554,19 @@
public SignerInfo[] verify(byte[] bytes)
throws NoSuchAlgorithmException, SignatureException {
- List<SignerInfo> intResult = new ArrayList<>();
+ Vector<SignerInfo> intResult = new Vector<SignerInfo>();
for (int i = 0; i < signerInfos.length; i++) {
SignerInfo signerInfo = verify(signerInfos[i], bytes);
if (signerInfo != null) {
- intResult.add(signerInfo);
+ intResult.addElement(signerInfo);
}
}
- if (!intResult.isEmpty()) {
- return intResult.toArray(new SignerInfo[intResult.size()]);
+ if (intResult.size() != 0) {
+
+ SignerInfo[] result = new SignerInfo[intResult.size()];
+ intResult.copyInto(result);
+ return result;
}
return null;
}
--- a/jdk/src/share/classes/sun/security/pkcs/SignerInfo.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/security/pkcs/SignerInfo.java Wed Jul 05 17:42:56 2017 +0200
@@ -230,7 +230,7 @@
if (userCert == null)
return null;
- ArrayList<X509Certificate> certList = new ArrayList<>();
+ ArrayList<X509Certificate> certList = new ArrayList<X509Certificate>();
certList.add(userCert);
X509Certificate[] pkcsCerts = block.getCertificates();
@@ -276,20 +276,132 @@
/* Returns null if verify fails, this signerInfo if
verify succeeds. */
SignerInfo verify(PKCS7 block, byte[] data)
- throws NoSuchAlgorithmException, SignatureException {
+ throws NoSuchAlgorithmException, SignatureException {
+
+ try {
+
+ ContentInfo content = block.getContentInfo();
+ if (data == null) {
+ data = content.getContentBytes();
+ }
+
+ String digestAlgname = getDigestAlgorithmId().getName();
+
+ byte[] dataSigned;
+
+ // if there are authenticate attributes, get the message
+ // digest and compare it with the digest of data
+ if (authenticatedAttributes == null) {
+ dataSigned = data;
+ } else {
+
+ // first, check content type
+ ObjectIdentifier contentType = (ObjectIdentifier)
+ authenticatedAttributes.getAttributeValue(
+ PKCS9Attribute.CONTENT_TYPE_OID);
+ if (contentType == null ||
+ !contentType.equals(content.contentType))
+ return null; // contentType does not match, bad SignerInfo
+
+ // now, check message digest
+ byte[] messageDigest = (byte[])
+ authenticatedAttributes.getAttributeValue(
+ PKCS9Attribute.MESSAGE_DIGEST_OID);
+
+ if (messageDigest == null) // fail if there is no message digest
+ return null;
+
+ MessageDigest md = MessageDigest.getInstance(digestAlgname);
+ byte[] computedMessageDigest = md.digest(data);
+
+ if (messageDigest.length != computedMessageDigest.length)
+ return null;
+ for (int i = 0; i < messageDigest.length; i++) {
+ if (messageDigest[i] != computedMessageDigest[i])
+ return null;
+ }
+
+ // message digest attribute matched
+ // digest of original data
+
+ // the data actually signed is the DER encoding of
+ // the authenticated attributes (tagged with
+ // the "SET OF" tag, not 0xA0).
+ dataSigned = authenticatedAttributes.getDerEncoding();
+ }
+
+ // put together digest algorithm and encryption algorithm
+ // to form signing algorithm
+ String encryptionAlgname =
+ getDigestEncryptionAlgorithmId().getName();
- PKCS7.PKCS7Verifier p7v = PKCS7.PKCS7Verifier.from(block, this);
- if (p7v == null) return null;
- if (data == null) {
- try {
- data = block.getContentInfo().getContentBytes();
- } catch (IOException e) {
- throw new SignatureException("IO error verifying signature:\n" +
- e.getMessage());
+ // Workaround: sometimes the encryptionAlgname is actually
+ // a signature name
+ String tmp = AlgorithmId.getEncAlgFromSigAlg(encryptionAlgname);
+ if (tmp != null) encryptionAlgname = tmp;
+ String algname = AlgorithmId.makeSigAlg(
+ digestAlgname, encryptionAlgname);
+
+ Signature sig = Signature.getInstance(algname);
+ X509Certificate cert = getCertificate(block);
+
+ if (cert == null) {
+ return null;
+ }
+ if (cert.hasUnsupportedCriticalExtension()) {
+ throw new SignatureException("Certificate has unsupported "
+ + "critical extension(s)");
}
+
+ // Make sure that if the usage of the key in the certificate is
+ // restricted, it can be used for digital signatures.
+ // XXX We may want to check for additional extensions in the
+ // future.
+ boolean[] keyUsageBits = cert.getKeyUsage();
+ if (keyUsageBits != null) {
+ KeyUsageExtension keyUsage;
+ try {
+ // We don't care whether or not this extension was marked
+ // critical in the certificate.
+ // We're interested only in its value (i.e., the bits set)
+ // and treat the extension as critical.
+ keyUsage = new KeyUsageExtension(keyUsageBits);
+ } catch (IOException ioe) {
+ throw new SignatureException("Failed to parse keyUsage "
+ + "extension");
+ }
+
+ boolean digSigAllowed = ((Boolean)keyUsage.get(
+ KeyUsageExtension.DIGITAL_SIGNATURE)).booleanValue();
+
+ boolean nonRepuAllowed = ((Boolean)keyUsage.get(
+ KeyUsageExtension.NON_REPUDIATION)).booleanValue();
+
+ if (!digSigAllowed && !nonRepuAllowed) {
+ throw new SignatureException("Key usage restricted: "
+ + "cannot be used for "
+ + "digital signatures");
+ }
+ }
+
+ PublicKey key = cert.getPublicKey();
+ sig.initVerify(key);
+
+ sig.update(dataSigned);
+
+ if (sig.verify(encryptedDigest)) {
+ return this;
+ }
+
+ } catch (IOException e) {
+ throw new SignatureException("IO error verifying signature:\n" +
+ e.getMessage());
+
+ } catch (InvalidKeyException e) {
+ throw new SignatureException("InvalidKey: " + e.getMessage());
+
}
- p7v.update(data, 0, data.length);
- return p7v.verify();
+ return null;
}
/* Verify the content of the pkcs7 block. */
--- a/jdk/src/share/classes/sun/security/util/ManifestEntryVerifier.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/security/util/ManifestEntryVerifier.java Wed Jul 05 17:42:56 2017 +0200
@@ -191,8 +191,8 @@
*
*
*/
- public CodeSigner[] verify(Map<String, CodeSigner[]> verifiedSigners,
- Map<String, CodeSigner[]> sigFileSigners)
+ public CodeSigner[] verify(Hashtable<String, CodeSigner[]> verifiedSigners,
+ Hashtable<String, CodeSigner[]> sigFileSigners)
throws JarException
{
if (skip) {
--- a/jdk/src/share/classes/sun/security/util/SignatureFileManifest.java Mon May 02 09:36:45 2011 -0700
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,251 +0,0 @@
-/*
- * Copyright (c) 2011, 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. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * 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.
- */
-
-package sun.security.util;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.Arrays;
-import java.util.jar.Attributes;
-import java.util.jar.Manifest;
-
-/**
- * This class provides streaming mode reading of manifest files.
- * Used by {@link SignatureFileVerifier}.
- */
-class SignatureFileManifest extends Manifest {
-
- /*
- * Reading a manifest into this object by calling update(byte[]) on chunks.
- * During the reading, the bytes are saved in (@code current} until a line
- * is complete and the key-value pair is saved in {@code currentAttr}. When
- * a section is complete, {@code consumeAttr} is called to merge
- * {@code currentAttr} into main attributes or a named entry.
- */
-
- // Internal state during update() style reading
- // 0. not in update mode
- // 1, in update mode but main attributes not completed yet
- // 2. main attributes completed, still reading the entries
- private int state = 0;
-
- // The partial line read
- private byte[] current;
-
- // Number of bytes in current
- private int currentPos = 0;
-
- // The current Attribute
- private Attributes currentAttr;
-
- /**
- * Reads a manifest in chunks.
- * <p>
- * This method must be called in a row, reading chunks from a single
- * manifest file by order. After all chunks are read, caller must call
- * {@code update(null)} to fully consume the manifest.
- * <p>
- * The entry names and attributes read will be merged in with the current
- * manifest entries. The {@link #read} method cannot be called inside a
- * row of update calls.
- * <p>
- * Along with the calls, caller can call {@link #getMainAttributes()},
- * {@link #getAttributes(java.lang.String)} or {@link #getEntries()}
- * to get already available contents. However, in order not to return
- * partial result, when the main attributes in the new manifest is not
- * consumed completely, {@link #getMainAttributes()} throws an
- * {@code IllegalStateException}. When a certain named entry is not
- * consumed completely, {@link #getAttributes(java.lang.String)}
- * returns the old {@code Attributes} for the name (if it exists).
- *
- * @param data null for last call, otherwise, feeding chunks
- * @param offset offset into data to begin read
- * @param length length of data after offset to read
- * @exception IOException if an I/O error has occurred
- * @exception IllegalStateException if {@code update(null)} is called
- * without any previous {@code update(non-null)} call
- */
- public void update(byte[] data, int offset, int length) throws IOException {
-
- // The last call
- if (data == null) {
- if (state == 0) {
- throw new IllegalStateException("No data to update");
- }
- // We accept manifest not ended with \n or \n\n
- if (hasLastByte()) {
- consumeCurrent();
- }
- // We accept empty lines at the end
- if (!currentAttr.isEmpty()) {
- consumeAttr();
- }
- state = 0; // back to non-update state
- current = null;
- currentAttr = null;
- return;
- }
-
- // The first call
- if (state == 0) {
- current = new byte[1024];
- currentAttr = super.getMainAttributes(); // the main attribute
- state = 1;
- }
-
- int end = offset + length;
-
- while (offset < end) {
- switch (data[offset]) {
- case '\r':
- break; // always skip
- case '\n':
- if (hasLastByte() && lastByte() == '\n') { // new section
- consumeCurrent();
- consumeAttr();
- if (state == 1) {
- state = 2;
- }
- currentAttr = new Attributes(2);
- } else {
- if (hasLastByte()) {
- // save \n into current but do not parse,
- // there might be a continuation later
- ensureCapacity();
- current[currentPos++] = data[offset];
- } else if (state == 1) {
- // there can be multiple empty lines between
- // sections, but cannot be at the beginning
- throw new IOException("invalid manifest format");
- }
- }
- break;
- case ' ':
- if (!hasLastByte()) {
- throw new IOException("invalid manifest format");
- } else if (lastByte() == '\n') {
- currentPos--; // continuation, remove last \n
- } else { // a very normal ' '
- ensureCapacity();
- current[currentPos++] = data[offset];
- }
- break;
- default:
- if (hasLastByte() && lastByte() == '\n') {
- // The start of a new pair, not continuation
- consumeCurrent(); // the last line read
- }
- ensureCapacity();
- current[currentPos++] = data[offset];
- break;
- }
- offset++;
- }
- }
-
- /**
- * Returns the main Attributes for the Manifest.
- * @exception IllegalStateException the main attributes is being read
- * @return the main Attributes for the Manifest
- */
- public Attributes getMainAttributes() {
- if (state == 1) {
- throw new IllegalStateException();
- }
- return super.getMainAttributes();
- }
-
- /**
- * Reads the Manifest from the specified InputStream. The entry
- * names and attributes read will be merged in with the current
- * manifest entries.
- *
- * @param is the input stream
- * @exception IOException if an I/O error has occurred
- * @exception IllegalStateException if called between two {@link #update}
- * calls
- */
- public void read(InputStream is) throws IOException {
- if (state != 0) {
- throw new IllegalStateException("Cannot call read between updates");
- }
- super.read(is);
- }
-
- /*
- * ---------- Helper methods -----------------
- */
-
- private void ensureCapacity() {
- if (currentPos >= current.length-1) {
- current = Arrays.copyOf(current, current.length*2);
- }
- }
-
- private boolean hasLastByte() {
- return currentPos > 0;
- }
-
- private byte lastByte() {
- return current[currentPos-1];
- }
-
- // Parse current as key:value and save into currentAttr.
- // There MUST be something inside current.
- private void consumeCurrent() throws IOException {
- // current normally has a \n end, except for the last line
- if (current[currentPos-1] == '\n') currentPos--;
- for (int i=0; i<currentPos; i++) {
- if (current[i] == ':') {
- String key = new String(current, 0, 0, i);
- i++;
- while (i < currentPos && current[i] == ' ') { i++; }
- String value = new String(current, i, currentPos-i, "UTF-8");
- currentAttr.putValue(key, value);
- currentPos = 0;
- return;
- }
- }
- throw new IOException("invalid header field");
- }
-
- // Merge currentAttr into Manifest
- private void consumeAttr() throws IOException {
- // Only needed for named entries. For the main attribute, key/value
- // is added into attr directly, but since getMainAttributes() throws
- // an exception, the partial data is not leaked.
- if (state != 1) {
- String name = currentAttr.getValue("Name");
- if (name != null) {
- currentAttr.remove(new Attributes.Name("Name"));
- Attributes old = getAttributes(name);
- if (old != null) old.putAll(currentAttr);
- else getEntries().put(name, currentAttr);
- } else {
- throw new IOException("invalid manifest format");
- }
- }
- }
-}
--- a/jdk/src/share/classes/sun/security/util/SignatureFileVerifier.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/security/util/SignatureFileVerifier.java Wed Jul 05 17:42:56 2017 +0200
@@ -55,8 +55,8 @@
/** the PKCS7 block for this .DSA/.RSA/.EC file */
private PKCS7 block;
- // the content of the raw .SF file as an InputStream
- private InputStream sfStream;
+ /** the raw bytes of the .SF file */
+ private byte sfBytes[];
/** the name of the signature block file, uppercased and without
* the extension (.DSA/.RSA/.EC)
@@ -66,9 +66,6 @@
/** the ManifestDigester */
private ManifestDigester md;
- /** The MANIFEST.MF */
- private Manifest man;
-
/** cache of created MessageDigest objects */
private HashMap<String, MessageDigest> createdDigests;
@@ -86,7 +83,6 @@
* @param rawBytes the raw bytes of the signature block file
*/
public SignatureFileVerifier(ArrayList<CodeSigner[]> signerCache,
- Manifest man,
ManifestDigester md,
String name,
byte rawBytes[])
@@ -98,18 +94,13 @@
try {
obj = Providers.startJarVerification();
block = new PKCS7(rawBytes);
- byte[] contentData = block.getContentInfo().getData();
- if (contentData != null) {
- sfStream = new ByteArrayInputStream(contentData);
- }
+ sfBytes = block.getContentInfo().getData();
certificateFactory = CertificateFactory.getInstance("X509");
} finally {
Providers.stopJarVerification(obj);
}
this.name = name.substring(0, name.lastIndexOf("."))
.toUpperCase(Locale.ENGLISH);
-
- this.man = man;
this.md = md;
this.signerCache = signerCache;
}
@@ -117,13 +108,31 @@
/**
* returns true if we need the .SF file
*/
- public boolean needSignatureFile()
+ public boolean needSignatureFileBytes()
{
- return sfStream == null;
+
+ return sfBytes == null;
}
- public void setSignatureFile(InputStream ins) {
- this.sfStream = ins;
+
+ /**
+ * returns true if we need this .SF file.
+ *
+ * @param name the name of the .SF file without the extension
+ *
+ */
+ public boolean needSignatureFile(String name)
+ {
+ return this.name.equalsIgnoreCase(name);
+ }
+
+ /**
+ * used to set the raw bytes of the .SF file when it
+ * is external to the signature block file.
+ */
+ public void setSignatureFile(byte sfBytes[])
+ {
+ this.sfBytes = sfBytes;
}
/**
@@ -136,18 +145,12 @@
* Signature File or PKCS7 block file name
*/
public static boolean isBlockOrSF(String s) {
- return s.endsWith(".SF") || isBlock(s);
- }
-
- /**
- * Utility method used by JarVerifier to determine PKCS7 block
- * files names that are supported
- *
- * @param s file name
- * @return true if the input file name is a PKCS7 block file name
- */
- public static boolean isBlock(String s) {
- return s.endsWith(".DSA") || s.endsWith(".RSA") || s.endsWith(".EC");
+ // we currently only support DSA and RSA PKCS7 blocks
+ if (s.endsWith(".SF") || s.endsWith(".DSA") ||
+ s.endsWith(".RSA") || s.endsWith(".EC")) {
+ return true;
+ }
+ return false;
}
/** get digest from cache */
@@ -177,7 +180,7 @@
*
*
*/
- public void process(Map<String, CodeSigner[]> signers,
+ public void process(Hashtable<String, CodeSigner[]> signers,
List manifestDigests)
throws IOException, SignatureException, NoSuchAlgorithmException,
JarException, CertificateException
@@ -194,86 +197,31 @@
}
- private void processImpl(Map<String, CodeSigner[]> signers,
+ private void processImpl(Hashtable<String, CodeSigner[]> signers,
List manifestDigests)
throws IOException, SignatureException, NoSuchAlgorithmException,
JarException, CertificateException
{
- SignatureFileManifest sf = new SignatureFileManifest();
- InputStream ins = sfStream;
+ Manifest sf = new Manifest();
+ sf.read(new ByteArrayInputStream(sfBytes));
- byte[] buffer = new byte[4096];
- int sLen = block.getSignerInfos().length;
- boolean mainOK = false; // main attributes of SF is available...
- boolean manifestSigned = false; // and it matches MANIFEST.MF
- BASE64Decoder decoder = new BASE64Decoder();
+ String version =
+ sf.getMainAttributes().getValue(Attributes.Name.SIGNATURE_VERSION);
- PKCS7.PKCS7Verifier[] pvs = new PKCS7.PKCS7Verifier[sLen];
- for (int i=0; i<sLen; i++) {
- pvs[i] = PKCS7.PKCS7Verifier.from(block, block.getSignerInfos()[i]);
+ if ((version == null) || !(version.equalsIgnoreCase("1.0"))) {
+ // XXX: should this be an exception?
+ // for now we just ignore this signature file
+ return;
}
- /*
- * Verify SF in streaming mode. The chunks of the file are fed into
- * the Manifest object sf and all PKCS7Verifiers. As soon as the main
- * attributes is available, we'll check if manifestSigned is true. If
- * yes, there is no need to fill in sf's entries field, since it should
- * be identical to entries in man.
- */
- while (true) {
- int len = ins.read(buffer);
- if (len < 0) {
- if (!manifestSigned) {
- sf.update(null, 0, 0);
- }
- break;
- } else {
- for (int i=0; i<sLen; i++) {
- if (pvs[i] != null) pvs[i].update(buffer, 0, len);
- }
- // Continue reading if verifyManifestHash fails (or, the
- // main attributes is not available yet)
- if (!manifestSigned) {
- sf.update(buffer, 0, len);
- if (!mainOK) {
- try {
- Attributes attr = sf.getMainAttributes();
- String version = attr.getValue(
- Attributes.Name.SIGNATURE_VERSION);
+ SignerInfo[] infos = block.verify(sfBytes);
- if ((version == null) ||
- !(version.equalsIgnoreCase("1.0"))) {
- // XXX: should this be an exception?
- // for now we just ignore this signature file
- return;
- }
-
- mainOK = true;
- manifestSigned = verifyManifestHash(
- sf, md, decoder, manifestDigests);
- } catch (IllegalStateException ise) {
- // main attributes not available yet
- }
- }
- }
- }
- }
- List<SignerInfo> intResult = new ArrayList<>(sLen);
- for (int i = 0; i < sLen; i++) {
- if (pvs[i] != null) {
- SignerInfo signerInfo = pvs[i].verify();
- if (signerInfo != null) {
- intResult.add(signerInfo);
- }
- }
- }
- if (intResult.isEmpty()) {
+ if (infos == null) {
throw new SecurityException("cannot verify signature block file " +
name);
}
- SignerInfo[] infos =
- intResult.toArray(new SignerInfo[intResult.size()]);
+ BASE64Decoder decoder = new BASE64Decoder();
CodeSigner[] newSigners = getSigners(infos, block);
@@ -281,37 +229,26 @@
if (newSigners == null)
return;
+ Iterator<Map.Entry<String,Attributes>> entries =
+ sf.getEntries().entrySet().iterator();
+
+ // see if we can verify the whole manifest first
+ boolean manifestSigned = verifyManifestHash(sf, md, decoder, manifestDigests);
+
// verify manifest main attributes
if (!manifestSigned && !verifyManifestMainAttrs(sf, md, decoder)) {
throw new SecurityException
("Invalid signature file digest for Manifest main attributes");
}
- Iterator<Map.Entry<String,Attributes>> entries;
-
- if (manifestSigned) {
- if (debug != null) {
- debug.println("full manifest signature match, "
- + "update signer info from MANIFEST.MF");
- }
- entries = man.getEntries().entrySet().iterator();
- } else {
- if (debug != null) {
- debug.println("full manifest signature unmatch, "
- + "update signer info from SF file");
- }
- entries = sf.getEntries().entrySet().iterator();
- }
-
- // go through each section
-
+ // go through each section in the signature file
while(entries.hasNext()) {
Map.Entry<String,Attributes> e = entries.next();
String name = e.getKey();
if (manifestSigned ||
- (verifySection(e.getValue(), name, md, decoder))) {
+ (verifySection(e.getValue(), name, md, decoder))) {
if (name.startsWith("./"))
name = name.substring(2);
@@ -656,6 +593,7 @@
if (set == subset)
return true;
+ boolean match;
for (int i = 0; i < subset.length; i++) {
if (!contains(set, subset[i]))
return false;
@@ -675,6 +613,8 @@
if ((oldSigners == null) && (signers == newSigners))
return true;
+ boolean match;
+
// make sure all oldSigners are in signers
if ((oldSigners != null) && !isSubSet(oldSigners, signers))
return false;
@@ -698,7 +638,7 @@
}
void updateSigners(CodeSigner[] newSigners,
- Map<String, CodeSigner[]> signers, String name) {
+ Hashtable<String, CodeSigner[]> signers, String name) {
CodeSigner[] oldSigners = signers.get(name);
--- a/jdk/src/share/classes/sun/tools/jconsole/resources/JConsoleResources_ja.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/tools/jconsole/resources/JConsoleResources_ja.java Wed Jul 05 17:42:56 2017 +0200
@@ -103,9 +103,9 @@
{"CPUUsageFormat","CPU\u4F7F\u7528\u7387: {0}%"},
{"Cancel","\u53D6\u6D88"},
{"Cascade", "\u91CD\u306D\u3066\u8868\u793A(C)"},
- {"Cascade.mnemonic", "C"},
+ {"Cascade.mnemonic", 'C'},
{"Chart:", "\u30C1\u30E3\u30FC\u30C8(C):"},
- {"Chart:.mnemonic", "C"},
+ {"Chart:.mnemonic", 'C'},
{"Class path","\u30AF\u30E9\u30B9\u30D1\u30B9"},
{"Class","\u30AF\u30E9\u30B9"},
{"ClassName","ClassName"},
@@ -122,7 +122,7 @@
{"CompositeData","CompositeData"},
{"Config","\u69CB\u6210"},
{"Connect", "\u63A5\u7D9A(C)"},
- {"Connect.mnemonic", "C"},
+ {"Connect.mnemonic", 'C'},
{"Connect...","\u63A5\u7D9A..."},
{"ConnectDialog.connectButton.toolTip", "Java\u4EEE\u60F3\u30DE\u30B7\u30F3\u306B\u63A5\u7D9A"},
{"ConnectDialog.accessibleDescription", "\u30ED\u30FC\u30AB\u30EB\u307E\u305F\u306F\u30EA\u30E2\u30FC\u30C8\u306EJava\u4EEE\u60F3\u30DE\u30B7\u30F3\u3078\u306E\u65B0\u898F\u63A5\u7D9A\u3092\u884C\u3046\u30C0\u30A4\u30A2\u30ED\u30B0"},
@@ -133,7 +133,7 @@
{"Connected. Click to disconnect.","\u63A5\u7D9A\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u30AF\u30EA\u30C3\u30AF\u3059\u308B\u3068\u5207\u65AD\u3057\u307E\u3059\u3002"},
{"Connection failed","\u63A5\u7D9A\u306B\u5931\u6557\u3057\u307E\u3057\u305F"},
{"Connection", "\u63A5\u7D9A(C)"},
- {"Connection.mnemonic", "C"},
+ {"Connection.mnemonic", 'C'},
{"Connection name", "\u63A5\u7D9A\u540D"},
{"ConnectionName (disconnected)","{0} (\u5207\u65AD\u6E08)"},
{"Constructor","\u30B3\u30F3\u30B9\u30C8\u30E9\u30AF\u30BF"},
@@ -150,7 +150,7 @@
{"Descriptor", "\u8A18\u8FF0\u5B50"},
{"Details", "\u8A73\u7D30"},
{"Detect Deadlock", "\u30C7\u30C3\u30C9\u30ED\u30C3\u30AF\u306E\u691C\u51FA(D)"},
- {"Detect Deadlock.mnemonic", "D"},
+ {"Detect Deadlock.mnemonic", 'D'},
{"Detect Deadlock.toolTip", "\u30C7\u30C3\u30C9\u30ED\u30C3\u30AF\u6E08\u30B9\u30EC\u30C3\u30C9\u306E\u691C\u51FA"},
{"Dimension is not supported:","\u6B21\u5143\u306F\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u3066\u3044\u307E\u305B\u3093:"},
{"Discard chart", "\u30C1\u30E3\u30FC\u30C8\u306E\u7834\u68C4"},
@@ -168,7 +168,7 @@
{"Error:","\u30A8\u30E9\u30FC:"},
{"Event","\u30A4\u30D9\u30F3\u30C8"},
{"Exit", "\u7D42\u4E86(X)"},
- {"Exit.mnemonic", "X"},
+ {"Exit.mnemonic", 'X'},
{"Fail to load plugin", "\u8B66\u544A: \u30D7\u30E9\u30B0\u30A4\u30F3\u306E\u30ED\u30FC\u30C9\u306B\u5931\u6557\u3057\u307E\u3057\u305F: {0}"},
{"FileChooser.fileExists.cancelOption", "\u53D6\u6D88"},
{"FileChooser.fileExists.message", "<html><center>\u30D5\u30A1\u30A4\u30EB\u306F\u3059\u3067\u306B\u5B58\u5728\u3057\u3066\u3044\u307E\u3059:<br>{0}<br>\u7F6E\u63DB\u3057\u3066\u3082\u3088\u308D\u3057\u3044\u3067\u3059\u304B\u3002"},
@@ -193,16 +193,16 @@
{"Help.AboutDialog.masthead.title", "JConsole\u306B\u3064\u3044\u3066"},
{"Help.AboutDialog.title", "JConsole: \u8A73\u7D30"},
{"Help.AboutDialog.userGuideLink", "JConsole\u30E6\u30FC\u30B6\u30FC\u30FB\u30AC\u30A4\u30C9(U):<br>{0}"},
- {"Help.AboutDialog.userGuideLink.mnemonic", "U"},
+ {"Help.AboutDialog.userGuideLink.mnemonic", 'U'},
{"Help.AboutDialog.userGuideLink.url", "http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html"},
{"HelpMenu.About.title", "JConsole\u306B\u3064\u3044\u3066(A)"},
- {"HelpMenu.About.title.mnemonic", "A"},
+ {"HelpMenu.About.title.mnemonic", 'A'},
{"HelpMenu.UserGuide.title", "\u30AA\u30F3\u30E9\u30A4\u30F3\u30FB\u30E6\u30FC\u30B6\u30FC\u30FB\u30AC\u30A4\u30C9(U)"},
- {"HelpMenu.UserGuide.title.mnemonic", "U"},
+ {"HelpMenu.UserGuide.title.mnemonic", 'U'},
{"HelpMenu.title", "\u30D8\u30EB\u30D7(H)"},
- {"HelpMenu.title.mnemonic", "H"},
+ {"HelpMenu.title.mnemonic", 'H'},
{"Hotspot MBeans...", "Hotspot MBeans(H)..."},
- {"Hotspot MBeans....mnemonic", "H"},
+ {"Hotspot MBeans....mnemonic", 'H'},
{"Hotspot MBeans.dialog.accessibleDescription", "Hotspot MBeans\u306E\u7BA1\u7406\u7528\u30C0\u30A4\u30A2\u30ED\u30B0"},
{"Impact","\u5F71\u97FF"},
{"Info","\u60C5\u5831"},
@@ -222,7 +222,7 @@
{"Live Threads","\u5B9F\u884C\u4E2D\u306E\u30B9\u30EC\u30C3\u30C9"},
{"Loaded", "\u30ED\u30FC\u30C9\u6E08"},
{"Local Process:", "\u30ED\u30FC\u30AB\u30EB\u30FB\u30D7\u30ED\u30BB\u30B9(L):"},
- {"Local Process:.mnemonic", "L"},
+ {"Local Process:.mnemonic", 'L'},
{"Look and Feel","Look&Feel"},
{"Masthead.font", "Dialog-PLAIN-25"},
{"Management Not Enabled","<b>\u6CE8\u610F</b>: \u7BA1\u7406\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306F\u3053\u306E\u30D7\u30ED\u30BB\u30B9\u3067\u306F\u6709\u52B9\u5316\u3055\u308C\u307E\u305B\u3093\u3002"},
@@ -233,20 +233,20 @@
{"MBeanOperationInfo","MBeanOperationInfo"},
{"MBeans","MBeans"},
{"MBeansTab.clearNotificationsButton", "\u30AF\u30EA\u30A2(C)"},
- {"MBeansTab.clearNotificationsButton.mnemonic", "C"},
+ {"MBeansTab.clearNotificationsButton.mnemonic", 'C'},
{"MBeansTab.clearNotificationsButton.toolTip", "\u901A\u77E5\u306E\u30AF\u30EA\u30A2"},
{"MBeansTab.compositeNavigationMultiple", "\u30B3\u30F3\u30DD\u30B8\u30C3\u30C8\u30FB\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3{0}/{1}"},
{"MBeansTab.compositeNavigationSingle", "\u30B3\u30F3\u30DD\u30B8\u30C3\u30C8\u30FB\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3"},
{"MBeansTab.refreshAttributesButton", "\u30EA\u30D5\u30EC\u30C3\u30B7\u30E5(R)"},
- {"MBeansTab.refreshAttributesButton.mnemonic", "R"},
+ {"MBeansTab.refreshAttributesButton.mnemonic", 'R'},
{"MBeansTab.refreshAttributesButton.toolTip", "\u5C5E\u6027\u306E\u30EA\u30D5\u30EC\u30C3\u30B7\u30E5"},
{"MBeansTab.subscribeNotificationsButton", "\u30B5\u30D6\u30B9\u30AF\u30E9\u30A4\u30D6(S)"},
- {"MBeansTab.subscribeNotificationsButton.mnemonic", "S"},
+ {"MBeansTab.subscribeNotificationsButton.mnemonic", 'S'},
{"MBeansTab.subscribeNotificationsButton.toolTip", "\u901A\u77E5\u30EA\u30B9\u30CB\u30F3\u30B0\u306E\u958B\u59CB"},
{"MBeansTab.tabularNavigationMultiple", "\u30BF\u30D6\u30FB\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3{0}/{1}"},
{"MBeansTab.tabularNavigationSingle", "\u30BF\u30D6\u30FB\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3"},
{"MBeansTab.unsubscribeNotificationsButton", "\u30B5\u30D6\u30B9\u30AF\u30E9\u30A4\u30D6\u89E3\u9664(U)"},
- {"MBeansTab.unsubscribeNotificationsButton.mnemonic", "U"},
+ {"MBeansTab.unsubscribeNotificationsButton.mnemonic", 'U'},
{"MBeansTab.unsubscribeNotificationsButton.toolTip", "\u901A\u77E5\u30EA\u30B9\u30CB\u30F3\u30B0\u306E\u505C\u6B62"},
{"Manage Hotspot MBeans in: ", "Hotspot MBeans\u306E\u7BA1\u7406: "},
{"Max","\u6700\u5927"},
@@ -263,7 +263,7 @@
{"Message","\u30E1\u30C3\u30BB\u30FC\u30B8"},
{"Method successfully invoked", "\u30E1\u30BD\u30C3\u30C9\u304C\u6B63\u5E38\u306B\u8D77\u52D5\u3055\u308C\u307E\u3057\u305F"},
{"Minimize All", "\u3059\u3079\u3066\u6700\u5C0F\u5316(M)"},
- {"Minimize All.mnemonic", "M"},
+ {"Minimize All.mnemonic", 'M'},
{"Minus Version", "\u3053\u308C\u306F{0}\u306E\u30D0\u30FC\u30B8\u30E7\u30F3{1}\u3067\u3059"},
{"Monitor locked",
" - \u30ED\u30C3\u30AF\u6E08{0}\n"},
@@ -279,7 +279,7 @@
{"Name State LockName LockOwner",
"\u540D\u524D: {0}\n\u72B6\u614B: {2}\u306E{1}\u3001\u6240\u6709\u8005: {3}\n"},
{"New Connection...", "\u65B0\u898F\u63A5\u7D9A(N)..."},
- {"New Connection....mnemonic", "N"},
+ {"New Connection....mnemonic", 'N'},
{"New value applied","\u9069\u7528\u3055\u308C\u305F\u65B0\u898F\u5024"},
{"No attribute selected","\u5C5E\u6027\u304C\u9078\u629E\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"},
{"No deadlock detected","\u30C7\u30C3\u30C9\u30ED\u30C3\u30AF\u304C\u691C\u51FA\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"},
@@ -305,19 +305,19 @@
{"OverviewPanel.plotter.accessibleName", "{0}\u306E\u30C1\u30E3\u30FC\u30C8\u3002"},
{"Parameter", "\u30D1\u30E9\u30E1\u30FC\u30BF"},
{"Password: ", "\u30D1\u30B9\u30EF\u30FC\u30C9(P): "},
- {"Password: .mnemonic", "P"},
+ {"Password: .mnemonic", 'P'},
{"Password.accessibleName", "\u30D1\u30B9\u30EF\u30FC\u30C9"},
{"Peak","\u30D4\u30FC\u30AF"},
{"Perform GC", "GC\u306E\u5B9F\u884C(G)"},
- {"Perform GC.mnemonic", "G"},
+ {"Perform GC.mnemonic", 'G'},
{"Perform GC.toolTip", "\u30AC\u30D9\u30FC\u30B8\u30FB\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u306E\u30EA\u30AF\u30A8\u30B9\u30C8"},
{"Plotter.accessibleName", "\u30C1\u30E3\u30FC\u30C8"},
{"Plotter.accessibleName.keyAndValue", "{0}={1}\n"},
{"Plotter.accessibleName.noData", "\u30C7\u30FC\u30BF\u304C\u30D7\u30ED\u30C3\u30C8\u3055\u308C\u307E\u305B\u3093\u3002"},
{"Plotter.saveAsMenuItem", "\u540D\u524D\u3092\u4ED8\u3051\u3066\u30C7\u30FC\u30BF\u3092\u4FDD\u5B58(A)..."},
- {"Plotter.saveAsMenuItem.mnemonic", "A"},
+ {"Plotter.saveAsMenuItem.mnemonic", 'A'},
{"Plotter.timeRangeMenu", "\u6642\u9593\u7BC4\u56F2(T)"},
- {"Plotter.timeRangeMenu.mnemonic", "T"},
+ {"Plotter.timeRangeMenu.mnemonic", 'T'},
{"Problem adding listener","\u30EA\u30B9\u30CA\u30FC\u8FFD\u52A0\u4E2D\u306E\u554F\u984C"},
{"Problem displaying MBean", "MBean\u8868\u793A\u4E2D\u306E\u554F\u984C"},
{"Problem invoking", "\u547C\u51FA\u3057\u4E2D\u306E\u554F\u984C"},
@@ -329,11 +329,11 @@
{"Received","\u53D7\u4FE1\u6E08"},
{"Reconnect","\u518D\u63A5\u7D9A"},
{"Remote Process:", "\u30EA\u30E2\u30FC\u30C8\u30FB\u30D7\u30ED\u30BB\u30B9(R):"},
- {"Remote Process:.mnemonic", "R"},
+ {"Remote Process:.mnemonic", 'R'},
{"Remote Process.textField.accessibleName", "\u30EA\u30E2\u30FC\u30C8\u30FB\u30D7\u30ED\u30BB\u30B9"},
{"Remove","\u524A\u9664"},
{"Restore All", "\u3059\u3079\u3066\u5FA9\u5143(R)"},
- {"Restore All.mnemonic", "R"},
+ {"Restore All.mnemonic", 'R'},
{"Return value", "\u623B\u308A\u5024"},
{"ReturnType", "ReturnType"},
{"SeqNum","SeqNum"},
@@ -364,9 +364,9 @@
{"ThreadTab.threadPlotter.accessibleName", "\u30B9\u30EC\u30C3\u30C9\u6570\u306E\u30C1\u30E3\u30FC\u30C8\u3002"},
{"Threshold","\u3057\u304D\u3044\u5024"},
{"Tile", "\u4E26\u3079\u3066\u8868\u793A(T)"},
- {"Tile.mnemonic", "T"},
+ {"Tile.mnemonic", 'T'},
{"Time Range:", "\u6642\u9593\u7BC4\u56F2(T):"},
- {"Time Range:.mnemonic", "T"},
+ {"Time Range:.mnemonic", 'T'},
{"Time", "\u6642\u9593"},
{"TimeStamp","TimeStamp"},
{"Total Loaded", "\u30ED\u30FC\u30C9\u6E08\u5408\u8A08"},
@@ -387,7 +387,7 @@
{"remoteTF.usage","<b>\u4F7F\u7528\u65B9\u6CD5</b>: <hostname>:<port>\u307E\u305F\u306Fservice:jmx:<protocol>:<sap>"},
{"Used","\u4F7F\u7528\u6E08"},
{"Username: ", "\u30E6\u30FC\u30B6\u30FC\u540D(U): "},
- {"Username: .mnemonic", "U"},
+ {"Username: .mnemonic", 'U'},
{"Username.accessibleName", "\u30E6\u30FC\u30B6\u30FC\u540D"},
{"UserData","UserData"},
{"Virtual Machine","\u4EEE\u60F3\u30DE\u30B7\u30F3"},
@@ -400,8 +400,8 @@
{"Verbose Output.toolTip", "\u30AF\u30E9\u30B9\u8AAD\u8FBC\u307F\u30B7\u30B9\u30C6\u30E0\u3067\u8A73\u7D30\u51FA\u529B\u3092\u6709\u52B9\u306B\u3059\u308B"},
{"View value", "\u5024\u306E\u8868\u793A"},
{"View","\u8868\u793A"},
- {"Window", "\u30A6\u30A3\u30F3\u30C9\u30A6"},
- {"Window.mnemonic", "W"},
+ {"Window", "\u30A6\u30A3\u30F3\u30C9\u30A6(W)"},
+ {"Window.mnemonic", 'W'},
{"Windows","\u30A6\u30A3\u30F3\u30C9\u30A6"},
{"Writable","\u66F8\u8FBC\u307F\u53EF\u80FD"},
{"You cannot drop a class here", "\u30AF\u30E9\u30B9\u3092\u3053\u3053\u306B\u30C9\u30ED\u30C3\u30D7\u3067\u304D\u307E\u305B\u3093"},
--- a/jdk/src/share/classes/sun/tools/jconsole/resources/JConsoleResources_zh_CN.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/share/classes/sun/tools/jconsole/resources/JConsoleResources_zh_CN.java Wed Jul 05 17:42:56 2017 +0200
@@ -102,10 +102,10 @@
{"CPU Usage","CPU \u5360\u7528\u7387"},
{"CPUUsageFormat","CPU \u5360\u7528\u7387: {0}%"},
{"Cancel","\u53D6\u6D88"},
- {"Cascade", "\u7EA7\u8054(C)"},
- {"Cascade.mnemonic", "C"},
+ {"Cascade", "\u5C42\u53E0(C)"},
+ {"Cascade.mnemonic", 'C'},
{"Chart:", "\u56FE\u8868(C):"},
- {"Chart:.mnemonic", "C"},
+ {"Chart:.mnemonic", 'C'},
{"Class path","\u7C7B\u8DEF\u5F84"},
{"Class","\u7C7B"},
{"ClassName","ClassName"},
@@ -122,7 +122,7 @@
{"CompositeData","CompositeData"},
{"Config","\u914D\u7F6E"},
{"Connect", "\u8FDE\u63A5(C)"},
- {"Connect.mnemonic", "C"},
+ {"Connect.mnemonic", 'C'},
{"Connect...","\u8FDE\u63A5..."},
{"ConnectDialog.connectButton.toolTip", "\u8FDE\u63A5\u5230 Java \u865A\u62DF\u673A"},
{"ConnectDialog.accessibleDescription", "\u7528\u4E8E\u4E0E\u672C\u5730\u6216\u8FDC\u7A0B Java \u865A\u62DF\u673A\u5EFA\u7ACB\u65B0\u8FDE\u63A5\u7684\u5BF9\u8BDD\u6846"},
@@ -133,7 +133,7 @@
{"Connected. Click to disconnect.","\u5DF2\u8FDE\u63A5\u3002\u5355\u51FB\u53EF\u65AD\u5F00\u8FDE\u63A5\u3002"},
{"Connection failed","\u8FDE\u63A5\u5931\u8D25"},
{"Connection", "\u8FDE\u63A5(C)"},
- {"Connection.mnemonic", "C"},
+ {"Connection.mnemonic", 'C'},
{"Connection name", "\u8FDE\u63A5\u540D\u79F0"},
{"ConnectionName (disconnected)","{0} (\u5DF2\u65AD\u5F00\u8FDE\u63A5)"},
{"Constructor","\u6784\u9020\u5668"},
@@ -150,7 +150,7 @@
{"Descriptor", "\u63CF\u8FF0\u7B26"},
{"Details", "\u8BE6\u7EC6\u8D44\u6599"},
{"Detect Deadlock", "\u68C0\u6D4B\u6B7B\u9501(D)"},
- {"Detect Deadlock.mnemonic", "D"},
+ {"Detect Deadlock.mnemonic", 'D'},
{"Detect Deadlock.toolTip", "\u68C0\u6D4B\u5904\u4E8E\u6B7B\u9501\u72B6\u6001\u7684\u7EBF\u7A0B"},
{"Dimension is not supported:","\u4E0D\u652F\u6301\u7EF4:"},
{"Discard chart", "\u653E\u5F03\u56FE\u8868"},
@@ -168,7 +168,7 @@
{"Error:","\u9519\u8BEF:"},
{"Event","\u4E8B\u4EF6"},
{"Exit", "\u9000\u51FA(X)"},
- {"Exit.mnemonic", "X"},
+ {"Exit.mnemonic", 'X'},
{"Fail to load plugin", "\u8B66\u544A: \u65E0\u6CD5\u52A0\u8F7D\u63D2\u4EF6: {0}"},
{"FileChooser.fileExists.cancelOption", "\u53D6\u6D88"},
{"FileChooser.fileExists.message", "<html><center>\u6587\u4EF6\u5DF2\u5B58\u5728:<br>{0}<br>\u662F\u5426\u8981\u66FF\u6362?"},
@@ -193,17 +193,17 @@
{"Help.AboutDialog.masthead.title", "\u5173\u4E8E JConsole"},
{"Help.AboutDialog.title", "JConsole: \u5173\u4E8E"},
{"Help.AboutDialog.userGuideLink", "JConsole \u7528\u6237\u6307\u5357(U):<br>{0}"},
- {"Help.AboutDialog.userGuideLink.mnemonic", "U"},
+ {"Help.AboutDialog.userGuideLink.mnemonic", 'U'},
{"Help.AboutDialog.userGuideLink.url", "http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html"},
{"HelpMenu.About.title", "\u5173\u4E8E JConsole(A)"},
- {"HelpMenu.About.title.mnemonic", "A"},
+ {"HelpMenu.About.title.mnemonic", 'A'},
{"HelpMenu.UserGuide.title", "\u8054\u673A\u7528\u6237\u6307\u5357(U)"},
- {"HelpMenu.UserGuide.title.mnemonic", "U"},
+ {"HelpMenu.UserGuide.title.mnemonic", 'U'},
{"HelpMenu.title", "\u5E2E\u52A9(H)"},
- {"HelpMenu.title.mnemonic", "H"},
- {"Hotspot MBeans...", "\u70ED\u70B9 MBean(H)..."},
- {"Hotspot MBeans....mnemonic", "H"},
- {"Hotspot MBeans.dialog.accessibleDescription", "\u7528\u4E8E\u7BA1\u7406\u70ED\u70B9 MBean \u7684\u5BF9\u8BDD\u6846"},
+ {"HelpMenu.title.mnemonic", 'H'},
+ {"Hotspot MBeans...", "HotSpot MBean(H)..."},
+ {"Hotspot MBeans....mnemonic", 'H'},
+ {"Hotspot MBeans.dialog.accessibleDescription", "\u7528\u4E8E\u7BA1\u7406 HotSpot MBean \u7684\u5BF9\u8BDD\u6846"},
{"Impact","\u5F71\u54CD"},
{"Info","\u4FE1\u606F"},
{"INFO","INFO"},
@@ -222,7 +222,7 @@
{"Live Threads","\u6D3B\u52A8\u7EBF\u7A0B"},
{"Loaded", "\u5DF2\u52A0\u8F7D"},
{"Local Process:", "\u672C\u5730\u8FDB\u7A0B(L):"},
- {"Local Process:.mnemonic", "L"},
+ {"Local Process:.mnemonic", 'L'},
{"Look and Feel","\u5916\u89C2"},
{"Masthead.font", "Dialog-PLAIN-25"},
{"Management Not Enabled","<b>\u6CE8</b>: \u672A\u5BF9\u6B64\u8FDB\u7A0B\u542F\u7528\u7BA1\u7406\u4EE3\u7406\u3002"},
@@ -233,22 +233,22 @@
{"MBeanOperationInfo","MBeanOperationInfo"},
{"MBeans","MBean"},
{"MBeansTab.clearNotificationsButton", "\u6E05\u9664(C)"},
- {"MBeansTab.clearNotificationsButton.mnemonic", "C"},
+ {"MBeansTab.clearNotificationsButton.mnemonic", 'C'},
{"MBeansTab.clearNotificationsButton.toolTip", "\u6E05\u9664\u901A\u77E5"},
{"MBeansTab.compositeNavigationMultiple", "\u7EC4\u5408\u5BFC\u822A{0}/{1}"},
{"MBeansTab.compositeNavigationSingle", "\u7EC4\u5408\u5BFC\u822A"},
{"MBeansTab.refreshAttributesButton", "\u5237\u65B0(R)"},
- {"MBeansTab.refreshAttributesButton.mnemonic", "R"},
+ {"MBeansTab.refreshAttributesButton.mnemonic", 'R'},
{"MBeansTab.refreshAttributesButton.toolTip", "\u5237\u65B0\u5C5E\u6027"},
{"MBeansTab.subscribeNotificationsButton", "\u8BA2\u9605(S)"},
- {"MBeansTab.subscribeNotificationsButton.mnemonic", "S"},
+ {"MBeansTab.subscribeNotificationsButton.mnemonic", 'S'},
{"MBeansTab.subscribeNotificationsButton.toolTip", "\u5F00\u59CB\u76D1\u542C\u901A\u77E5"},
{"MBeansTab.tabularNavigationMultiple", "\u8868\u683C\u5F0F\u5BFC\u822A{0}/{1}"},
{"MBeansTab.tabularNavigationSingle", "\u8868\u683C\u5F0F\u5BFC\u822A"},
{"MBeansTab.unsubscribeNotificationsButton", "\u53D6\u6D88\u8BA2\u9605(U)"},
- {"MBeansTab.unsubscribeNotificationsButton.mnemonic", "U"},
+ {"MBeansTab.unsubscribeNotificationsButton.mnemonic", 'U'},
{"MBeansTab.unsubscribeNotificationsButton.toolTip", "\u505C\u6B62\u76D1\u542C\u901A\u77E5"},
- {"Manage Hotspot MBeans in: ", "\u7BA1\u7406\u4EE5\u4E0B\u4F4D\u7F6E\u7684\u70ED\u70B9 MBean: "},
+ {"Manage Hotspot MBeans in: ", "\u7BA1\u7406\u4EE5\u4E0B\u4F4D\u7F6E\u7684 HotSpot MBean: "},
{"Max","\u6700\u5927\u503C"},
{"Maximum heap size","\u6700\u5927\u5806\u5927\u5C0F"},
{"Memory","\u5185\u5B58"},
@@ -263,7 +263,7 @@
{"Message","\u6D88\u606F"},
{"Method successfully invoked", "\u5DF2\u6210\u529F\u8C03\u7528\u65B9\u6CD5"},
{"Minimize All", "\u5168\u90E8\u6700\u5C0F\u5316(M)"},
- {"Minimize All.mnemonic", "M"},
+ {"Minimize All.mnemonic", 'M'},
{"Minus Version", "\u8FD9\u662F{0}\u7248\u672C {1}"},
{"Monitor locked",
" - \u5DF2\u9501\u5B9A{0}\n"},
@@ -279,7 +279,7 @@
{"Name State LockName LockOwner",
"\u540D\u79F0: {0}\n\u72B6\u6001: {2}\u4E0A\u7684{1}, \u62E5\u6709\u8005: {3}\n"},
{"New Connection...", "\u65B0\u5EFA\u8FDE\u63A5(N)..."},
- {"New Connection....mnemonic", "N"},
+ {"New Connection....mnemonic", 'N'},
{"New value applied","\u5DF2\u5E94\u7528\u65B0\u503C"},
{"No attribute selected","\u672A\u9009\u62E9\u5C5E\u6027"},
{"No deadlock detected","\u672A\u68C0\u6D4B\u5230\u6B7B\u9501"},
@@ -305,19 +305,19 @@
{"OverviewPanel.plotter.accessibleName", "{0}\u7684\u56FE\u8868\u3002"},
{"Parameter", "\u53C2\u6570"},
{"Password: ", "\u53E3\u4EE4(P): "},
- {"Password: .mnemonic", "P"},
+ {"Password: .mnemonic", 'P'},
{"Password.accessibleName", "\u53E3\u4EE4"},
{"Peak","\u5CF0\u503C"},
{"Perform GC", "\u6267\u884C GC(G)"},
- {"Perform GC.mnemonic", "G"},
+ {"Perform GC.mnemonic", 'G'},
{"Perform GC.toolTip", "\u8BF7\u6C42\u5783\u573E\u6536\u96C6"},
{"Plotter.accessibleName", "\u56FE\u8868"},
{"Plotter.accessibleName.keyAndValue", "{0}={1}\n"},
{"Plotter.accessibleName.noData", "\u672A\u7ED8\u5236\u6570\u636E\u3002"},
{"Plotter.saveAsMenuItem", "\u5C06\u6570\u636E\u53E6\u5B58\u4E3A(A)..."},
- {"Plotter.saveAsMenuItem.mnemonic", "A"},
+ {"Plotter.saveAsMenuItem.mnemonic", 'A'},
{"Plotter.timeRangeMenu", "\u65F6\u95F4\u8303\u56F4(T)"},
- {"Plotter.timeRangeMenu.mnemonic", "T"},
+ {"Plotter.timeRangeMenu.mnemonic", 'T'},
{"Problem adding listener","\u6DFB\u52A0\u76D1\u542C\u7A0B\u5E8F\u65F6\u51FA\u73B0\u95EE\u9898"},
{"Problem displaying MBean", "\u663E\u793A MBean \u65F6\u51FA\u73B0\u95EE\u9898"},
{"Problem invoking", "\u8C03\u7528\u65F6\u51FA\u73B0\u95EE\u9898"},
@@ -329,11 +329,11 @@
{"Received","\u6536\u5230"},
{"Reconnect","\u91CD\u65B0\u8FDE\u63A5"},
{"Remote Process:", "\u8FDC\u7A0B\u8FDB\u7A0B(R):"},
- {"Remote Process:.mnemonic", "R"},
+ {"Remote Process:.mnemonic", 'R'},
{"Remote Process.textField.accessibleName", "\u8FDC\u7A0B\u8FDB\u7A0B"},
{"Remove","\u5220\u9664"},
{"Restore All", "\u5168\u90E8\u8FD8\u539F(R)"},
- {"Restore All.mnemonic", "R"},
+ {"Restore All.mnemonic", 'R'},
{"Return value", "\u8FD4\u56DE\u503C"},
{"ReturnType", "ReturnType"},
{"SeqNum","SeqNum"},
@@ -364,9 +364,9 @@
{"ThreadTab.threadPlotter.accessibleName", "\u8868\u793A\u7EBF\u7A0B\u6570\u7684\u56FE\u8868\u3002"},
{"Threshold","\u9608\u503C"},
{"Tile", "\u5E73\u94FA(T)"},
- {"Tile.mnemonic", "T"},
+ {"Tile.mnemonic", 'T'},
{"Time Range:", "\u65F6\u95F4\u8303\u56F4(T):"},
- {"Time Range:.mnemonic", "T"},
+ {"Time Range:.mnemonic", 'T'},
{"Time", "\u65F6\u95F4"},
{"TimeStamp","TimeStamp"},
{"Total Loaded", "\u52A0\u8F7D\u603B\u6570"},
@@ -387,7 +387,7 @@
{"remoteTF.usage","<b>\u7528\u6CD5</b>: <hostname>:<port> \u6216 service:jmx:<protocol>:<sap>"},
{"Used","\u5DF2\u7528"},
{"Username: ", "\u7528\u6237\u540D(U): "},
- {"Username: .mnemonic", "U"},
+ {"Username: .mnemonic", 'U'},
{"Username.accessibleName", "\u7528\u6237\u540D"},
{"UserData","UserData"},
{"Virtual Machine","\u865A\u62DF\u673A"},
@@ -401,7 +401,7 @@
{"View value", "\u89C6\u56FE\u503C"},
{"View","\u89C6\u56FE"},
{"Window", "\u7A97\u53E3(W)"},
- {"Window.mnemonic", "W"},
+ {"Window.mnemonic", 'W'},
{"Windows","Windows"},
{"Writable","\u53EF\u5199"},
{"You cannot drop a class here", "\u65E0\u6CD5\u5220\u9664\u6B64\u5904\u7684\u7C7B"},
--- a/jdk/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,54 +19,44 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH appletviewer 1 "02 Jun 2010"
+.TH appletviewer 1 "14 Apr 2011"
.LP
-.SH ""
-appletviewer \- Java ≪ャ若
-.LP
-.RS 3
-
+.SH "名前"
+appletviewer \- Java アプレットビューア
.LP
.LP
-\f3appletviewer\fP 潟潟 Web 吟紊с≪絎茵障
+\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3appletviewer\fP 潟潟 \f2urls\fP 絎ャ＜潟純若鴻･膓ャ＜潟с≪ｃ潟ц；腓冴障羈: \f2urls\fP ｃсャ＜潟\f2OBJECT\fP\f2EMBED\fP障 \f2APPLET\fP 帥違с≪с翫\f3appletviewer\fP 篏茵障\f3appletviewer\fP с泣若 HTML 帥違荅括完ゃ
+\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注: \f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
.na
-\f2≪ャ若≪帥違\fP @
+\f2「アプレットビューアのタグ」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlс
+http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlを参照してください。
.LP
.LP
-\f3羈:\fP \f3appletviewer\fP RFC2396 ц鎘鴻宴若罘罕緇ｃ膃垸 URL 綽荀障泣若膃垸 URL с＜ゃゃRFC2396 絎号х垸茹ｉゃ鏆荀障
+\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-debug
-Java jdb(1) с≪ャ若≪紮障 ャ＜潟筝≪違с障
+Java デバッガ jdb(1) でアプレットビューアを開始します。これにより、ドキュメント中のアプレットをデバッグすることができます。
.TP 3
\-encoding \ \ encoding name
-ュ HTML ＜ゃ潟潟若ｃ潟医絎障
+入力 HTML ファイルのエンコーディング名を指定します。
.TP 3
\-Jjavaoption
-絖 \f2javaoption\fP appletviewer 絎茵 Java ゃ潟帥帥 1 ゃ綣違羝＜障綣違鴻若鴻障茲違綣違綣違鴻･莨 \f3\-J\fP у阪綽荀障潟潟ゃ絎茵医障＜≪若鴻с
+文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数にスペースを含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリーの利用に有効です。
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/apt.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/apt.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,102 +19,133 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH apt 1 "02 Jun 2010"
+.TH apt 1 "14 Apr 2011"
.LP
.SH "NAME"
.LP
.LP
-\f2apt\fP \- 羈若
+\f2apt\fP \- 注釈処理ツール
.LP
-.SH "綵√"
+.SH "形式"
.LP
.LP
-\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...][\f2javac option\fP] sourcefiles [@files]
+\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...] [\f2javac option\fP] sourcefiles [@files]
.LP
-.SH "＜若"
+.SH "パラメータ"
.LP
.LP
-激с潟筝с劫激с潟＜若帥ゃ筝荐激с潟с
+オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。
.LP
.RS 3
.TP 3
sourcefiles
-若1 ゃ障茲違絲乗院純若鴻＜ゃ
+ゼロ、1 つ、または複数の処理対象のソースファイル
.TP 3
@files
-純若鴻＜ゃ障篁激с潟筝荀ц；腓冴 1 ゃ障茲違＜ゃ
+ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル
.RE
.LP
-.SH "茯"
+.SH "説明"
.LP
.LP
-羈若 \f2apt\fP 違 API 泣若ゃ潟鴻ｃ若罕違羈障\f2apt\fP API 罕膀純若鴻若鴻с違罕≪茯水絨ャ若箴障 API 膩霡違菴遵緇Java(TM) 違潟域茯激鴻罩ｃ≪荐荐障\f2apt\fP 違純若鴻潟若篁＜ゃ篏羈祉泣絎茵障罨＜\f2apt\fP 純若鴻＜ゃ純若鴻＜ゃ筝≧鴻潟潟ゃ冴罐純障若ゃ潟帥с若鴻篏睡 API API \f2com.sun.mirror\fP 泣宴若吾с
+注釈処理ツール \f2apt\fP は、新しいリフレクト API とサポートインフラストラクチャーから構成され、プログラム注釈を処理します。\f2apt\fP リフレクト API は、 構築時のソースベースで、プログラム構造に関する読み取り専用ビューを提供します。これらのリフレクト API は、総称を追加した後に、Java(TM) プログラミング言語の型システムを正しくモデル化するように設計されています。最初に、\f2apt\fP は、新しいソースコードと他のファイルを作成する注釈プロセッサを実行します。次に、\f2apt\fP は、元のソースファイルと生成したソースファイルの両方をコンパイルするため、開発が楽になります。ツールとのインタフェースに使用されるリフレクト API などの API は、\f2com.sun.mirror\fP のサブパッケージです。
.LP
.LP
-若罘純≪荅括完\f2apt\fP 篏睡堺号ゃ
+ツールの機能に関する詳細と、\f2apt\fP を使用した開発方法については、
.na
-\f4\fP\f4apt\fP\f3 ラ\fP @
+\f4「apt 入門」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。
.LP
.RS 3
.TP 3
-羈:
-\f2apt\fP 罘純\f2javac(1)\fP 若筝ｃ羈ゃ潟鴻ｃ若腟粋昭障鴻 Java 潟潟ゃт戎с罔羣障違ゃ潟鴻ｃ若荐茯≪ Java 若筝ｃ羈 API 箴絖障羈祉泣冴違 API \f2javac\fP 若冴ャ茵с障
+注:
+\f2apt\fP の機能は、\f2javac(1)\fP ツールの一部となった注釈処理インフラストラクチャーに組み込まれ、すべての Java コンパイラで使用できるように標準化されました。この新しいインフラストラクチャーは、言語モデルおよび Java プラットフォームの一部となった注釈処理 API に依存します。注釈プロセッサの開発は、新しい API および \f2javac\fP ツールに基づいて行うようお勧めします。
.RE
.LP
-.SH "激с"
+.SH "オプション"
.LP
.SS
-apt 堺激с
+apt 固有のオプション
.LP
.RS 3
.TP 3
\-s dir
-祉泣純若鴻＜ゃ臀ｃ若絎障 ＜ゃ宴若吾腥咲冴ャ泣ｃ臀障
+プロセッサの生成するソースファイルを置くディレクトリルートを指定します。 ファイルは、パッケージの名前空間に基づいてサブディレクトリに置かれます。
.TP 3
\-nocompile
-純若鴻＜ゃ鴻＜ゃ潟潟ゃ障
+ソースファイルをクラスファイルにコンパイルしません。
.TP 3
\-print
-絎帥ゃ鴻茵憗阪障 羈障潟潟ゃ茵障
+指定したタイプのテキスト表現を出力します。 注釈処理またはコンパイルは行いません。
.TP 3
\-A[key[=val]]
-羈祉泣御検激с潟с 激с潟\f2apt\fP 贋･茹ｉс祉泣ｃ篏睡с紊障
+注釈プロセッサへ渡すオプションです。 このオプションは、\f2apt\fP が直接解釈するのではなく、それぞれのプロセッサによって使用できるように変えられます。
.TP 3
\-factorypath path
-羈祉泣＜罎膣≪贋絎障 激с潟篏睡翫鴻鴻＜罎膣≪障
+注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。
.TP 3
\-factory classname
-篏睡羈祉泣＜с 罎冴祉鴻ャ障
+使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。
+.TP 3
+\-version
+バージョン情報を出力します。
+.TP 3
+\-X
+非標準オプションに関する情報を表示します。
.RE
.LP
.SS
-javac 援激с
+javac と共用するオプション
.LP
.RS 3
.TP 3
\-d dir
-祉泣 javac 鴻＜ゃ臀贋絎障
+プロセッサと javac 生成のクラスファイルを置く場所を指定します。
.TP 3
-\-cp path or \-classpath path
-若吟若鴻＜ゃ羈祉泣＜罎膣≪贋絎障\f2\-factorypath\fP 絎翫鴻鴻＜罎膣≪障
+\-cp path または \-classpath path
+ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。
.RE
.LP
.LP
-\f2javac\fP 激с潟荅括完ゃjavac(1) ャ≪若吾с
+\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。
+.LP
+.SS
+非標準オプション
.LP
-.SH "羈"
+.RS 3
+.TP 3
+\-XListAnnotationTypes
+注釈の型に検出されるリスト.
+.TP 3
+\-XListDeclarations
+指定および宣言がインクルードされるリスト.
+.TP 3
+\-XPrintAptRounds
+初期および再帰的な \f2apt\fP ラウンドに関する情報を出力する.
+.TP 3
+\-XPrintFactoryInfo
+処理を要求するファクトリの注釈に関する情報を出力する.
+.TP 3
+\-XclassesAsDecls
+クラスファイルとソースファイルの両方を、処理対象の宣言として処理します。
+.RE
+
.LP
.LP
-\f2apt\fP 罘純\f2javac\fP 箴罔羣羈ゃ潟鴻ｃ若腟粋昭障障篁緇 JDK 若鴻с\f2apt\fP 渇∫ｃ API 泣若筝罩≪醇с障
+\f3注\fP: これらは非標準オプションなので、予告なく変更される可能性があります。
+.LP
+.SH "注"
.LP
-.SH "∫ｉ"
+.LP
+\f2apt\fP の機能は、\f2javac\fP により提供される標準注釈処理インフラストラクチャーに組み込まれました。今後の JDK リリースでは、\f2apt\fP および関連する API のサポートが中止する可能性があります。
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/solaris/doc/sun/man/man1/ja/extcheck.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/extcheck.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH extcheck 1 "02 Jun 2010"
+.TH extcheck 1 "14 Apr 2011"
.LP
-.SH ""
-extcheck \- jar 腴九罎冴若ｃｃ
-.LP
-.RS 3
-
+.SH "名前"
+extcheck \- jar の競合検出ユーティリティー
.LP
.LP
-\f3extcheck\fP 帥若蚊 jar ＜ゃ憜ゃ潟鴻若≦宍罘純 jar ＜ゃ若吾с潟腴九罎冴障
+\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,39 +39,33 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3extcheck\fP 若ｃｃ若絎 Jar ＜ゃ帥ゃ潟若吾с潟 Java(TM) 2 SDK ゃ潟鴻若≦宍罘純腴九с障≦宍罘純ゃ潟鴻若若ｃｃ若篏帥ｃ若吾с潟違≦宍罘純сゃ潟鴻若茯帥鴻с障
+\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。
.LP
.LP
-\f3extcheck\fP 若ｃｃ若\f2targetfile.jar\fP ＜ゃс鴻 \f2Specification\-title\fP \f2Specification\-version\fP ≦宍罘純ｃ憜ゃ潟鴻若鴻 Jar ＜ゃ絲上若罸莠障с≦宍罘純ｃ\f2jre/lib/ext\fP с\f3extcheck\fP 若ｃｃ若\f2java.lang.Package.isCompatibleWith\fP ＜純罕号с若吾с括垩罸莠障
-.LP
-.LP
-腴九罎冴翫帥若潟潟若 \f20\fP с
+\f3extcheck\fP ユーティリティーは、targetfile.jar ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされている \f2すべての Jar ファイル内の\fP 対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。
.LP
.LP
-≦宍罘純ｃ jar ＜ゃс鴻筝 \f2Specification\-title\fP喝筝障違 \f2Specification\-version\fP 垩翫若с若潟若菴障\f2targetfile.jar\fP с鴻 \f2Specification\-title\fP 障 \f2Specification\-version\fP 絮с翫若с若潟若菴障
+競合が検出されない場合のリターンコードは \f20\fP です。
+.LP
.LP
-.SH "激с"
+拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP 、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。 \f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-verbose
-≦宍罘純ｃ Jar ＜ゃс筝荀ц；腓冴障障帥若蚊 jar ＜ゃс鴻絮с括九 jar ＜ゃゃ怨障
+拡張機能ディレクトリ内の Jar ファイルを、チェック時に一覧表示します。また、ターゲット jar ファイルのマニフェストの属性、および競合する jar ファイルについても報告します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
jar(1)
--- a/jdk/src/solaris/doc/sun/man/man1/ja/idlj.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/idlj.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,20 +19,14 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH idlj 1 "02 Jun 2010"
+.TH idlj 1 "14 Apr 2011"
.LP
-.SH ""
-idlj \- IDL\-to\-Java 潟潟ゃ
-.LP
-.RS 3
-
+.SH "名前"
+idlj \- IDL\-to\-Java コンパイラ
.LP
-\f3idlj\fP 絎 IDL ＜ゃ Java ゃ潟ｃ潟違障
-.RE
-.SH "綵√"
-.LP
-
+\f3idlj\fP は、指定された IDL ファイルから Java バインディングを生成します。
+.SH "形式"
.LP
.nf
\f3
@@ -44,68 +38,118 @@
.LP
.LP
-\f2idl\-file\fP ゃ潟帥с若劫臂荐茯 (IDL) 絎臂ャｃ＜ゃс\f2options\fP 篁紙с\f2idl\-file\fP 絎違障
-.LP
-.SH "茯"
+\f2idl\-file\fP は、インタフェース定義言語 (IDL) による定義が入ったファイルの名前です。\f2options\fP の順番は任意ですが、\f2idl\-file\fP よりも前に指定しなければなりません。
.LP
-
+.SH "説明"
.LP
-IDL\-to\-Java 潟潟ゃ絎 IDL ＜ゃゃ Java ゃ潟ｃ潟違障 ゃ潟ｃ潟違荅括完
+.LP
+IDL\-to\-Java コンパイラは、指定された IDL ファイルについて Java バインディングを生成します。バインディングの詳細は、
.na
\f2OMG IDL to Java Language Mapping Specification\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html сIDL\-to\-Java 潟潟ゃ篁ュ若鴻筝\f2idltojava\fP ｃ障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html を参照してください。IDL\-to\-Java コンパイラの以前のリリースの中には、\f2idltojava\fP という名前だったものがあります。
+.LP
.SS
-ゃ≪潟ゃ潟ｃ潟違潟泣若若ゃ潟ｃ潟違肴
+クライアントバインディングおよびサーバーバインディングの発行
+.LP
+.LP
+My.idl という名前の IDL ファイルに対して Java バインディングを生成するには、次のコマンドを実行します。
.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
+.LP
+.LP
+これにより、クライアント側のバインディングが生成されます。このコマンドは、次のコマンドと等価です。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient\fP My.idl
+.fl
+.fi
.LP
-My.idl IDL ＜ゃ絲障 Java ゃ潟ｃ潟違罨＜潟潟絎茵障 \f2idlj My.idl\fP
.LP
-ゃ≪潟眼ゃ潟ｃ潟違障 潟潟罨＜潟潟膈箴＜с \f2idlj \fP\f4\-fclient\fP\f2 My.idl\fP
+クライアント側のバインディングには、サーバー側のスケルトンは組み込まれていません。インタフェースに対してサーバー側のバインディングを生成するには、次のコマンドを実行します。
.LP
-ゃ≪潟眼ゃ潟ｃ潟違泣若弱眼鴻宴潟腟粋昭障障ゃ潟帥с若鴻絲障泣若弱眼ゃ潟ｃ潟違罨＜潟潟絎茵障 \f2idlj \fP\f4\-fserver\fP\f2 My.idl\fP
-.LP
-泣若弱眼ゃ潟ｃ潟違ゃ≪潟眼ゃ潟ｃ潟違鴻宴潟腟粋昭障障 鴻 \f2POA\fP (膓帥≪) 鴻сゃ≪潟眼泣若弱眼筝≧鴻ゃ潟ｃ潟違翫罨＜潟潟 (膈箴) ＜ 1 ゃ篏睡障 \f2idlj \fP\f4\-fclient \-fserver\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fserver\fP My.idl
+.fl
+.fi
+
.LP
.LP
-泣若弱眼≪2 ゃ≪純с膓帥≪Tie 紮茘蚊≪с
+サーバー側のバインディングには、クライアント側のバインディングのほかに、スケルトンも含まれています。これらはすべて、 \f2POA\fP (つまり継承モデル) クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド (どれも等価) のうちの 1 つを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient \-fserver\fP My.idl
+.fl
+idlj \f3\-fall\fP My.idl
+.fl
+.fi
+
.LP
.LP
-泣若弱眼≪腱紙純泣若潟膓帥≪с\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2MyPOA.java\fP ＜ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyPOA\fP 膓帥綽荀障
+サーバー側で可能なモデルは 2 つあります。継承モデルと Tie 委譲モデルです。
.LP
.LP
-\f2MyPOA.java\fP
+デフォルトのサーバー側のモデルは、「移殖可能サーバント継承モデル」です。\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2MyPOA.java\fP というファイルが生成されます。この実装は \f2My\fP に提供し、\f2MyPOA\fP を継承する必要があります。
+.LP
+.LP
+\f2MyPOA.java\fP は
.na
\f2org.omg.PortableServer.Servant\fP @
.fi
-http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html ≦宍鴻若若鴻鴻宴潟с鴻宴潟絎茖 IDL ゃ潟帥с若鴻∫ｄ \f2InvokeHandler\fP ゃ潟帥с若鴻若激с潟ゃ潟帥с若鴻絎茖障
+http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html を拡張するストリームベースのスケルトンで、スケルトンが実装する IDL インタフェースに関連付けられている \f2InvokeHandler\fP インタフェースとオペレーションインタフェースを実装します。
.LP
.LP
.na
\f2Portable Object Adapter (POA)\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html \f2PortableServer\fP ≪吾ャ若ゃｃ \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違＜純箴障 ＜純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫ｃ泣若潟篏九勝若吟若若若ゃ障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は Java の \f2org.omg.PortableServer.Servant\fP クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。
+.LP
+.LP
+継承モデルのもう 1 つのオプションは、\f2\-oldImplBase\fP フラグを使用することで、J2SE 1.4 より前のバージョンの Java プログラミング言語と互換性のあるサーバー側バインディングを生成することです。ただし、\f2\-oldImplBase\fP フラグを使用するのは、標準的な手法ではありません。これらの API は今後非推奨になる予定です。このフラグを使用するのは、J2SE 1.3 で記述された既存のサーバーとの互換性が必要な場合だけです。その場合には既存の MAKEFILE を変更し、\f2idlj\fP コンパイラに \f2\-oldImplBase\fP フラグを追加する必要があります。そうしないと、POA ベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次のコマンドを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-fclient \-fserver\fP \f3\-oldImplBase\fP My.idl
+.fl
+idlj \f3\-fall\fP \f3\-oldImplBase\fP My.idl
+.fl
+.fi
+
.LP
.LP
-膓帥≪ 1 ゃ激с潟\f2\-oldImplBase\fP 違篏睡J2SE 1.4 若吾с潟 Java 違潟域茯篋с泣若弱眼ゃ潟ｃ潟違с\f2\-oldImplBase\fP 違篏睡罔羣羈с障 API ｨ絅障違篏睡J2SE 1.3 ц菴違√泣若若篋с篆ゅ翫с翫√ MAKEFILE 紊眼 \f2idlj\fP 潟潟ゃ \f2\-oldImplBase\fP 違菴遵綽荀障 違菴遵翫POA 若鴻泣若弱眼潟違障筝篏篋с泣若弱眼ゃ潟ｃ潟違罨＜潟潟篏睡障
+\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2_MyImplBase.java\fP というファイルが生成されます。\f2My\fP に対してその実装を提供し、この実装は \f2_MyImplBase\fP から継承しなければなりません。
.LP
-\f2idlj \fP\f4\-fclient \-fserver\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fall\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
.LP
-\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2_MyImplBase.java\fP ＜ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyImplBase\fP 膓帥違障
+もう 1 つのサーバー側モデルは、Tie モデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tie とスケルトンを同時に生成することはできないため、それらは別々に生成しなければなりません。次のコマンドによって、Tie モデル用のバインディングが生成されます。
.LP
- 1 ゃ泣若弱眼≪Tie ≪若違с泣若弱眼≪紮茘蚊≪сTie 鴻宴潟сャ違障罨＜潟潟ｃTie ≪ゃ潟ｃ潟違障
+.nf
+\f3
+.fl
+idlj \fP\f3\-fall\fP My.idl
+.fl
+idlj \f3\-fallTIE\fP My.idl
+.fl
+.fi
+
.LP
-\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-fallTIE\fP\f2 My.idl\fP
.LP
-\f2My\fP ゃ潟帥с若鴻翫筝荐 2 潟潟\f2MyPOATie.java\fP 障\f2MyPOATie\fP 潟潟鴻帥\f2delegate\fP 障箴с POA ≪篏睡潟潟鴻帥 \f2poa\fP 綽荀с\f2delegate\fP 絲障絎茖箴違障絎茖 \f2MyOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2MyPOATie\fP у茖違障違罨＜障
+\f2My\fP というインタフェースの場合、上記の 2 番目のコマンドにより、\f2MyPOATie.java\fP が生成されます。\f2MyPOATie\fP のコンストラクタは、\f2delegate\fP を取ります。この例では、デフォルトの POA モデルを使用しているため、コンストラクタにも \f2poa\fP が必要です。\f2delegate\fP に対して実装を提供しなければなりませんが、この実装は \f2MyOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2MyPOATie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。
+.LP
.nf
\f3
.fl
@@ -143,16 +187,24 @@
.fi
.LP
-篁絎茖膓帥違翫罔羣膓帥≪с Tie ≪篏睡障Java 翫ゃ潟帥с若鴻膓帥違狗障鴻膓帥篏睡с鴻 1 ゃс膓帥≪篏睡翫鴻障Tie ≪篏睡翫鴻篏睡若吟若т戎с障･с 1 ゅャ罨鴻障ゃ障＜純若喝冴篏＜純若喝冴榊障
.LP
-IDL 若吾с潟 J2SE 1.4 若吾с潟 Java 荐茯吾潟違篋с泣若弱眼 Tie ≪ゃ潟ｃ潟違罨＜潟潟篏睡障
-.LP
-\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fall\fP\f2 My.idl\fP
-.br
-\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fallTIE\fP\f2 My.idl\fP
+他の実装から継承しなければならない場合、標準の継承モデルではなく Tie モデルを使用することがあります。Java の場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは 1 つだけです。継承モデルを使用した場合は、そのスロットが占有されます。Tie モデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが 1 つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼び出しが 1 回発生します。
.LP
.LP
-\f2My\fP ゃ潟帥с若鴻翫 \f2My_Tie.java\fP 障\f2My_Tie\fP 潟潟鴻帥\f2impl\fP 障\f2impl\fP 絲障絎茖箴違障絎茖 \f2HelloOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2My_Tie\fP у茖違障違罨＜障
+IDL のバージョンから J2SE 1.4 より前のバージョンの Java 言語へのマッピングと互換性のある、サーバー側の Tie モデルのバインディングを生成するには、次のコマンドを使用します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-oldImplBase\fP \f3\-fall\fP My.idl
+.fl
+idlj \f3\-oldImplBase\fP \f3\-fallTIE\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+\f2My\fP というインタフェースの場合、これにより \f2My_Tie.java\fP が生成されます。\f2My_Tie\fP のコンストラクタは、\f2impl\fP を取ります。\f2impl\fP に対して実装を提供しなければなりませんが、その実装は \f2HelloOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2My_Tie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。
.LP
.nf
\f3
@@ -183,201 +235,383 @@
.fi
.LP
-.RE
.SS
-肴＜ゃ篁ｆ推臀絎
+発行されたファイルの代替位置の指定
+.LP
+.LP
+発行されたファイルをカレントディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。
.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj \fP\f3\-td /altdir\fP My.idl
+.fl
+.fi
.LP
-肴＜ゃ潟ｃ篁ュｃ臀罨＜潟潟с潟潟ゃ若喝冴障
-.RS 3
+.LP
+\f2My\fP インタフェースの場合、バインディングは、\f2./My.java\fP ではなく、\f2/altdir/My.java\fP などに発行されます。
+.LP
+.SS
+インクルードファイルの代替位置の指定
+.LP
+.LP
+\f2My.idl\fP にもう 1 つの IDL ファイル \f2MyOther.idl\fP がインクルードされている場合、コンパイラは、ローカルディレクトリに \f2MyOther.idl\fP があるものと想定します。もしそのファイルが、たとえば \f2/includes\fP にある場合は、次のようなコマンドでコンパイラを呼び出します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-i /includes\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+また、もし \f2My.idl\fP に、たとえば \f2/moreIncludes\fP にある \f2Another.idl\fP もインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-i /includes \-i /moreIncludes\fP My.idl
+.fl
+.fi
.LP
-\f2idlj \fP\f4\-td /altdir\fP\f2 My.idl\fP
-.RE
-\f2My\fP ゃ潟帥с若鴻翫ゃ潟ｃ潟違\f2./My.java\fP с\f2/altdir/My.java\fP 肴障
-.RE
-.SS
-ゃ潟若＜ゃ篁ｆ推臀絎
+.LP
+このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルードファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATH にリストされているディレクトリ内に \f2idl.config\fP という名前のファイルを作成します。その \f2idl.config\fP の中に、次のような形式の行を入れます。
.LP
-.RS 3
+.nf
+\f3
+.fl
+includes=/includes;/moreIncludes
+.fl
+\fP
+.fi
.LP
-\f2My.idl\fP 1 ゃ IDL ＜ゃ \f2MyOther.idl\fP ゃ潟若翫潟潟ゃ若ｃ \f2MyOther.idl\fP 喝障＜ゃ \f2/includes\fP 翫罨＜潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes\fP\f2 My.idl\fP
.LP
-障 \f2My.idl\fP \f2/moreIncludes\fP \f2Another.idl\fP ゃ潟若с違罨＜潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes \-i /moreIncludes\fP\f2 My.idl\fP
-.LP
-綵√сゃ潟若絎潟潟激茲障 сゃ潟若＜ゃ罎膣≪贋潟潟ゃ腓冴ャ号障号医紊違鴻篌若障CLASSPATH 鴻ｃ \f2idl.config\fP ＜ゃ篏障 \f2idl.config\fP 筝罨＜綵√茵ャ障 \f2includes=/includes;/moreIncludes\fP
-.LP
-潟潟ゃ＜ゃ罎膣≪ゃ潟若鴻茯粋昭帥障箴сｃ阪絖祉潟 (;) ｃ障阪絖若ｃ違障違Windows 若с祉潟潟сUnix 若с潟潟с \f2ゃ潟若\fP荅括完ゃ
+コンパイラは、このファイルを検索し、インクルードリストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン (;) になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windows プラットフォームではセミコロンですが、Unix プラットフォームではコロンです。 \f2インクルード\fPの詳細については、
.na
-\f2CLASSPATH 荐絎\fP @
+\f2CLASSPATH の設定\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#general с
-.RE
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#general を参照してください。
+.LP
.SS
-ゃ潟若＜ゃ絲障ゃ潟ｃ潟違肴
+インクルードファイルに対するバインディングの発行
+.LP
+.LP
+デフォルトでは、コマンド行に指定した IDL ファイルで定義されているインタフェースや構造体などについてのみ、Java バインディングが生成されます。インクルードされたファイルで定義されている型については、Java バインディングは生成されません。たとえば、次の 2 つの IDL ファイルについて考えてみましょう。
+.LP
+
+.LP
+.LP
+\f4My.idl\fP
.LP
-.RS 3
+.nf
+\f3
+.fl
+#include <MyOther.idl>
+.fl
+interface My
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
.LP
-с潟潟茵絎 IDL ＜ゃу臂ゃ潟帥с若鴻罕篏ゃ帥Java ゃ潟ｃ潟違障ゃ潟若＜ゃу臂ゃJava ゃ潟ｃ潟違障違罨＜ 2 ゃ IDL ＜ゃゃ帥障 \f4My.idl\fP
+
.LP
-\f2#include <MyOther.idl>\fP
-.br
-\f2interface My\fP
-.br
-\f2{\fP
-.br
-\f2};\fP
-.br
-\f4MyOther.idl\fP
+.LP
+\f4MyOther.idl\fP
.LP
-\f2interface MyOther\fP
-.br
-\f2{\fP
-.br
-\f2};\fP\
-.LP
-罨＜潟潟с\f2My\fP 絲障 Java ゃ潟ｃ潟違障 \f2idlj My.idl\fP
-.LP
-\f2My.idl\fP у臂\f2My.idl\fP ゃ潟若＜ゃ (箴с \f2MyOther.idl\fP) у臂鴻ゃ Java ゃ潟ｃ潟違罨＜潟潟篏睡障 \f2idlj \fP\f4\-emitAll\fP\f2 My.idl\fP
+.nf
+\f3
+.fl
+interface MyOther
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
+
.LP
-荀≪羈違障違若鴻潟若絎 \f2#include\fP 菴違障 \f2#include\fP ゃ潟若荀с障絲障篁絎臂蚊障鴻潟若絎 \f2#include\fP 綵潟с \f2#include\fP 障 ゃ障ゃ潟若＜ゃ潟若＜ゃ障丈絎絲障 Java ゃ潟ｃ潟違肴障罨＜箴腓冴障 \f4My.idl\fP
+
.LP
-\f2#include <MyOther.idl>\fP
-.br
-\f2interface My\fP
-.br
-\f2{\fP
-.br
-\f2\ #include <Embedded.idl>\fP
-.br
-\f2};\ \fP \f4MyOther.idl\fP
.LP
-\f2interface MyOther\fP
-.br
-\f2{\fP
-.br
-\f2};\ \fP \f4Embedded.idl\fP
-.LP
-\f2enum E {one, two, three};\fP\
-.LP
-罨＜潟潟絎茵 \f2idlj My.idl\fP
+次のコマンドでは、\f2My\fP に対する Java バインディングだけが生成されます。
.LP
-罨＜筝ｃ Java ＜ゃ障 \f2./MyHolder.java\fP
-.br
-\f2./MyHelper.java\fP
-.br
-\f2./_MyStub.java\fP
-.br
-\f2./MyPackage\fP
-.br
-\f2./MyPackage/EHolder.java\fP
-.br
-\f2./MyPackage/EHelper.java\fP
-.br
-\f2./MyPackage/E.java\fP
-.br
-\f2./My.java\fP
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
.LP
-ゃ潟若荀 \f2#include\fP 絎臂\f2MyOther.java\fP 障綵潟с \f2#include\fP у臂\f2E.java\fP 障\f2Embedded.idl\fP \f2My\fP ゃ潟帥с若鴻鴻潟若ゃ潟若\f2My\fP 鴻潟若 (ゃ障\f2MyPackage\fP ) 障
.LP
-筝荐箴 \f2\-emitAll\fP 違篏睡違ゃ潟若鴻＜ゃ鴻肴障
+\f2My.idl\fP で定義されている型と、\f2My.idl\fP にインクルードされたファイル (この例では \f2MyOther.idl\fP) で定義されている型すべてについて Java バインディングを生成するには、次のコマンドを使用します。
.LP
-.RE
-.SS
-宴若吾･莨水
-.LP
-.RS 3
+.nf
+\f3
+.fl
+idlj \fP\f3\-emitAll\fP My.idl
+.fl
+.fi
.LP
-ABC 篌腓障篏罐罨＜ IDL ＜ゃ罕膀障
-.br
-\f4Widgets.idl\fP
.LP
-\f2module Widgets\fP
-.br
-\f2{\fP
-.br
-\f2\ interface W1 {...};\fP
-.br
-\f2\ interface W2 {...};\fP
-.br
-\f2};\fP\
+このデフォルトの規則に関して注意しなければならないことがあります。グローバルスコープに指定した \f2#include\fP 文は、前述のとおりに処理されます。これらの \f2#include\fP 文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した \f2#include\fP 文は、本当の意味での \f2#include\fP 文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対して Java バインディングが発行されます。次はその例です。
.LP
-＜ゃ絲障 IDL\-to\-Java 潟潟ゃ絎茵\f2W1\fP \f2W2\fP 絲障 Java ゃ潟ｃ潟違 \f2Widgets\fP 宴若後障罐ｄ篌腓障宴若吾\f2com.<篌腓上>\fP 宴若後臀ｃ障\f2Widgets\fP 宴若吾с筝сｄ緇宴若吾 \f2com.abc.Widgets\fP 綽荀障宴若御･莨 \f2Widgets\fP ≪吾ャ若篁罨＜潟潟絎茵障 \f2idlj \fP\f4\-pkgPrefix Widgets com.abc\fP\f2 Widgets.idl\fP
-.LP
-\f2Widgets.idl\fP ゃ潟若 IDL ＜ゃ翫潟潟 \f2\-pkgPrefix\fP 違綽荀с違絎 IDL ＜ゃ\f2com.abc.Widgets\fP 宴若吾с\f2Widgets\fP 宴若吾罎膣≪障
-.LP
-･莨綽荀宴若吾ゃ翫菴違 \f2idl.config\fP ＜ゃф･莨絎膂≦с宴若吾･莨絎茵罨＜綵√ц菴違障
-.LP
-\f2PkgPrefix.<type>=<prefix>\fP
-.LP
-ｃ筝荐箴翫罨＜荐菴違障 \f2PkgPrefix.Widgets=com.abc\fP
+
.LP
.LP
-激с潟篏睡吾 ID 綵演帥障
-.LP
-.RE
-.SS
-潟潟ゃ激潟絎臂
-.LP
-.RS 3
-
+\f4My.idl\fP
.LP
-潟潟ゃ激潟 IDL ＜ゃу臂翫激潟絎臂綽荀障 違ゃ潟ｃ潟医違潟若腟水ャ篏睡障罨＜潟潟 \f2idlj \fP\f4\-d\fP\f2 MYDEF My.idl\fP
-.LP
-\f2My.idl\fP \f2#define MYDEF\fP 茵絎翫膈箴＜с
-.RE
-.SS
-√ゃ潟ｃ潟違篆
-.LP
-.RS 3
+.nf
+\f3
+.fl
+#include <MyOther.idl>
+.fl
+interface My
+.fl
+{
+.fl
+ #include <Embedded.idl>
+.fl
+};
+.fl
+\fP
+.fi
.LP
-Java ゃ潟ｃ潟違＜ゃс絖翫\f2\-keep\fP 違絎潟潟ゃ筝吾帥с障сс絖鴻＜ゃ障＜ゃ鴻帥ゃ冴翫 (絎鴻罩ｇ∈с篁ュ鴻帥ゃ冴帥)\f2\-keep\fP 激с潟с罨＜潟潟 \f2idlj \fP\f4\-keep\fP\f2 My.idl\fP
-.LP
-ゃ≪潟眼ゃ潟ｃ潟違с障絖鴻肴障
-.RE
-.SS
-潟潟ゃ我倶茵腓
-.LP
-.RS 3
.LP
-IDL\-to\-Java 潟潟ゃ絎茵罧級х倶＜祉若吾障激≪若 (＜祉若吾紊≪若) \f2\-v\fP 激с潟篏睡障 \f2idlj \fP\f4\-v\fP\f2 My.idl\fP
+.LP
+\f4MyOther.idl\fP
.LP
-с潟潟ゃ激≪若с絎茵障
-.RE
-.SS
-若吾с恰宴茵腓
+.nf
+\f3
+.fl
+interface MyOther
+.fl
+{
+.fl
+};
+.fl
+\fP
+.fi
+
.LP
-.RS 3
.LP
.LP
-IDL\-to\-Java 潟潟ゃ若吾с潟茵腓冴潟潟茵 \f2\-version\fP 激с潟絎障
+\f4Embedded.idl\fP
+.LP
+.nf
+\f3
+.fl
+enum E {one, two, three};
+.fl
+\fP
+.fi
+
+.LP
+
+.LP
+.LP
+このとき、次のコマンドを実行すると、
+.LP
+.nf
+\f3
+.fl
+idlj My.idl
+.fl
+\fP
+.fi
+
.LP
.LP
-\f2idlj \-version\fP
+次のような一連の Java ファイルが生成されます。
+.LP
+.nf
+\f3
+.fl
+./MyHolder.java
+.fl
+./MyHelper.java
+.fl
+./_MyStub.java
+.fl
+./MyPackage
+.fl
+./MyPackage/EHolder.java
+.fl
+./MyPackage/EHelper.java
+.fl
+./MyPackage/E.java
+.fl
+./My.java
+.fl
+\fP
+.fi
+
+.LP
+.LP
+インポート文と見なされる \f2#include\fP に定義されているため、\f2MyOther.java\fP は生成されません。ただし、本当の意味での \f2#include\fP で定義されているため、\f2E.java\fP は生成されます。さらに、\f2Embedded.idl\fP が \f2My\fP インタフェースのスコープ内にインクルードされていたため、\f2My\fP のスコープ内 (つまり、\f2MyPackage\fP 内) に生成されています。
+.LP
+.LP
+上記の例で \f2\-emitAll\fP フラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。
+.LP
+.SS
+パッケージの接頭辞の挿入
+.LP
+.LP
+ABC という名前の会社のために作業していて、次のような IDL ファイルを構築したとしましょう。
+.LP
+
+.LP
+.LP
+\f4Widgets.idl\fP
+.LP
+.nf
+\f3
+.fl
+module Widgets
+.fl
+{
+.fl
+ interface W1 {...};
+.fl
+ interface W2 {...};
+.fl
+};
+.fl
+\fP
+.fi
+
+.LP
+
.LP
.LP
-若吾с恰宴潟潟ゃｃゃ潟ｃ潟医吾莨若障障激с潟潟潟茵絎篁ュ激с潟絎鴻∴障
+このファイルに対して IDL\-to\-Java コンパイラを実行すると、\f2W1\fP および \f2W2\fP に対する Java バインディングが \f2Widgets\fP パッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<会社名>\fP という名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fP パッケージでは不十分です。慣例に従うには、パッケージを \f2com.abc.Widgets\fP にする必要があります。このパッケージ接頭辞を \f2Widgets\fP モジュールに付加するには、次のコマンドを実行します。
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-pkgPrefix Widgets com.abc\fP Widgets.idl
+.fl
+.fi
+
+.LP
+.LP
+\f2Widgets.idl\fP をインクルードしている IDL ファイルがある場合は、そのコマンドにも \f2\-pkgPrefix\fP フラグが必要です。このフラグを指定しないと、その IDL ファイルは、\f2com.abc.Widgets\fP パッケージではなく、\f2Widgets\fP パッケージを検索することになります。
+.LP
+.LP
+接頭辞が必要なパッケージがいくつもある場合は、前述の \f2idl.config\fP ファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。
+.LP
+.nf
+\f3
+.fl
+PkgPrefix.<type>=<prefix>
+.fl
+\fP
+.fi
+
+.LP
+したがって、上記の例の場合は、次のように記述します。
+.nf
+\f3
+.fl
+PkgPrefix.Widgets=com.abc
+.fl
+\fP
+.fi
+
+.LP
+.LP
+このオプションを使用しても、リポジトリ ID は影響を受けません。
+.LP
+.SS
+コンパイル前のシンボルの定義
+.LP
+.LP
+コンパイル用のシンボルが IDL ファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグコードを組み入れるときに使用します。次のコマンドは、
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-d\fP MYDEF My.idl
+.fl
+.fi
+
+.LP
.LP
-.RE
-.SH "激с"
+\f2My.idl\fP 内に \f2#define MYDEF\fP という行を指定した場合と等価です。
+.LP
+.SS
+既存のバインディングの保持
+.LP
+.LP
+Java バインディングファイルがすでに存在する場合は、\f2\-keep\fP フラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合 (ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\-keep オプションは有用です。次のコマンドは、
+.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-keep\fP My.idl
+.fl
+.fi
+
+.LP
+.LP
+クライアント側のバインディングで、まだ存在しないものをすべて発行します。
+.LP
+.SS
+コンパイルの進捗状況の表示
+.LP
+.LP
+IDL\-to\-Java コンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モード (メッセージが多いモード) にするには、\f2\-v\fP オプションを使用します。
.LP
+.nf
+\f3
+.fl
+idlj \fP\f3\-v\fP My.idl
+.fl
+.fi
.LP
+.LP
+デフォルトでは、コンパイラは冗長モードでは実行されません。
+.LP
+.SS
+バージョン情報の表示
+.LP
+.LP
+IDL\-to\-Java コンパイラのビルドバージョンを表示するには、コマンド行で \f2\-version\fP オプションを指定します。
+.LP
+.nf
+\f3
+.fl
+idlj \-version
+.fl
+\fP
+.fi
+
+.LP
+.LP
+バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。
+.LP
+.SH "オプション"
+.LP
.RS 3
.TP 3
\-d symbol
-激с潟IDL ＜ゃ罨＜茵菴遵翫膈箴＜с
-.RS 3
-
-.LP
+このオプションは、IDL ファイルに次のような行を追加した場合と等価です。
.nf
\f3
.fl
@@ -385,33 +619,32 @@
.fl
\fP
.fi
-.RE
.TP 3
\-emitAll
-\f2#include\fP ＜ゃу臂鴻肴障
+#include ファイル 内で定義されているものも含めて、 \f2すべての型を\fP 発行します。
.TP 3
\-fside
-肴ゃ潟ｃ潟違絎臂障 \f2side\fP \f2client\fP\f2server\fP\f2serverTIE\fP\f2all\fP\f2allTIE\fP ＜с\f2\-fserverTIE\fP 障 \f2\-fallTIE\fP 激с潟絎紮茘蚊≪鴻宴潟肴障違絎ｃ翫\f2\-fclient\fP 絎荀障
+発行するバインディングを定義します。\f2side\fP は \f2client\fP、\f2server\fP、\f2serverTIE\fP、\f2all\fP、\f2allTIE\fP のいずれかになります。\f2\-fserverTIE\fP または \f2\-fallTIE\fP オプションを指定すると、委譲モデルスケルトンが発行されます。このフラグを指定しなかった場合は、\f2\-fclient\fP が指定されたものと見なされます。
.TP 3
\-i include\-path
-сゃ潟若＜ゃ潟ｃ罎膣≪障激с潟絎祉ｃ菴遵с障
+デフォルトでは、インクルードファイルはカレントディレクトリから検索されます。このオプションを指定すると、ほかのディレクトリを追加できます。
.TP 3
\-keep
-＜ゃс絖翫＜ゃ筝吾障с筝吾障
+生成されるファイルがすでに存在している場合は、そのファイルが上書きされません。デフォルトでは、上書きされます。
.TP 3
\-noWarn
-茘＜祉若吾茵腓冴障
+警告メッセージを表示しないようにします。
.TP 3
\-oldImplBase
-v1.4 JDK ORB 篋с鴻宴潟障сPOA 膓帥≪泣若弱眼ゃ潟ｃ潟違障激с潟絎\f2ImplBase\fP 膓帥≪鴻с泣若弱眼ゃ潟ｃ潟違сゃ若吾с潟 Java 違潟域茯筝篏篋с緇障
+v1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。デフォルトでは、POA 継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\f2ImplBase\fP 継承モデルのクラスであるサーバー側バインディングが生成されるので、古いバージョンの Java プログラミング言語との下位互換性が得られます。
.TP 3
\-pkgPrefix type prefix
-\f2type\fP ＜ゃ鴻潟若ф冴翫絲障鴻＜ゃゃ Java 宴若後 \f2prefix\fP ･莨篁障\f2type\fP ≪吾ャ若膣≪吾ャ若紊眼у臂 IDL 膣＜с
+\f2type\fP がファイルスコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成される Java パッケージ名に \f2prefix\fP という接頭辞が付加されます。\f2type\fP は、トップレベルモジュールの単純名か、どのモジュールよりも外側で定義された IDL 型の単純名のどちらかです。
.TP 3
\-pkgTranslate type package
-茘ュ筝≪吾ャ若 \f2type\fP 罎冴 Java 宴若後鴻＜ゃゃ茘ュ筝 \f2package\fP х舟障 \f2pkgPrefix\fP 紊眼障\f2type\fP ≪吾ャ若障鴻≪吾ャ若紊у臂 IDL 膣с 絎宴若後罩ｇ∈筝眼違障
+識別子の中にモジュール名 type が検出されると、生成される Java パッケージ内のすべてのファイルについて、識別子の中のその名前が package で置き換えられます。最初に \f2pkgPrefix\fP を変更します。\f2type\fP は、トップレベルのモジュール、またはすべてのモジュールの外部で定義された IDL 型の単純名です。そして、完全なパッケージ名に正確に一致しなければなりません。
.LP
-1 ゃ茘ュ筝ц違紊翫ｃ激吾違障違罨＜綣違絎翫
+1 つの識別子の中で複数の変換がマッチする場合は、もっとも長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、
.nf
\f3
.fl
@@ -420,89 +653,85 @@
\fP
.fi
.LP
-罨＜紊絎純障
+次のような変換が実施されます。
.nf
\f3
.fl
-foo => bar
+foo => bar
.fl
-foo.boo => bar.boo
+foo.boo => bar.boo
.fl
-foo.baz => buzz.fizz
+foo.baz => buzz.fizz
.fl
-foo.baz.bar => buzz.fizz.bar
+foo.baz.bar => buzz.fizz.bar
.fl
\fP
.fi
.LP
-罨＜宴若後紊с障
+次のパッケージ名を変換することはできません。
.RS 3
.TP 2
o
\f2org\fP
.TP 2
o
-\f2org.omg\fP障 \f2org.omg\fP 泣宴若
+\f2org.omg\fP、または \f2org.omg\fP のサブパッケージ
.RE
.LP
-宴若後紊篋с潟若障 \f2\-pkgTranslate\fP 綣違宴若吾篏睡若宴障
+これらのパッケージ名を変換しようとすると、互換性のないコードが生成されます。そして、\f2\-pkgTranslate\fP のあとの最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。
.TP 3
\-skeletonName xxx%yyy
-\f2xxx%yyy\fP 鴻宴潟篁帥若潟篏睡障罨＜с
+\f2xxx%yyy\fP が、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。
.RS 3
.TP 2
o
-\f2POA\fP 阪鴻翫%POA(\f2\-fserver\fP 障 \f2\-fall\fP)
+\f2POA\fP 基底クラスの場合は「%POA」(\f2\-fserver\fP または \f2\-fall\fP)
.TP 2
o
-\f2oldImplBase\fP 鴻翫_%ImplBase(\f2\-oldImplBase\fP (\f2\-fserver\fP 障 \f2\-fall\fP))
+\f2oldImplBase\fP クラスの場合は「_%ImplBase」(\f2\-oldImplBase\fP かつ (\f2\-fserver\fP または \f2\-fall\fP))
.RE
.TP 3
\-td dir
-阪ｃ潟ｃс\f2dir\fP 篏睡障
+出力ディレクトリとして、カレントディレクトリではなく、\f2dir\fP が使用されます。
.TP 3
\-tieName xxx%yyy
-帥若潟緇ｃ Tie 篁障罨＜с
+このパターンに従って Tie に名前が付けられます。デフォルトは次のとおりです。
.RS 3
.TP 2
o
-\f2POA\fP Tie 阪鴻翫%POATie(\f2\-fserverTie\fP 障 \f2\-fallTie\fP)
+\f2POA\fP Tie 基底クラスの場合は「%POATie」(\f2\-fserverTie\fP または \f2\-fallTie\fP)
.TP 2
o
-\f2oldImplBase\fP Tie 鴻翫%_Tie(\f2\-oldImplBase\fP (\f2\-fserverTie\fP 障 \f2\-fallTie\fP))
+\f2oldImplBase\fP Tie クラスの場合は「%_Tie」(\f2\-oldImplBase\fP かつ (\f2\-fserverTie\fP または \f2\-fallTie\fP))
.RE
.TP 3
-\-verbose
-激≪若障
+\-nowarn, \-verbose
+冗長モードになります。
.TP 3
\-version
-若吾с恰宴茵腓冴腟篋障
+バージョン情報を表示して終了します。
.RE
.LP
-激с潟荅括完ゃ茯祉激с潟с
-.SH "句"
-.LP
-
+各オプションの詳細については、「説明」のセクションを参照してください。
+.SH "制約"
.LP
.RS 3
.TP 2
o
-違若鴻潟若鴻宴若茘ュIDL ｃ \f2Object\fP 障 \f2ValueBase\fP 膓眼сｃ障茘ュゃ激潟若篋若茘ュ絎臂荐怨絎臂筝吾障障箙句с
+グローバルスコープ内のエスケープされた識別子は、IDL プリミティブ型の \f2Object\fP または \f2ValueBase\fP と同じ綴りであってはなりません。これらの識別子については、シンボルテーブルが事前にロードされており、これらの識別子の再定義を許可すると元の定義が上書きされてしまいます。これは、おそらく恒久的な制約です。
.TP 2
o
-\f2fixed\fP IDL 泣若障
+\f2fixed\fP という IDL 型はサポートされていません。
.RE
.LP
-.SH "∝ャ馹"
-.LP
-
+.SH "既知の問題点"
.LP
.RS 3
.TP 2
o
-違若茘ュゃゃ潟若障篋若 impl 若喝冴箴紊障 \f2ServerDelegate\fP DSI 潟若 \f2NullPointerException\fP с
+グローバル識別子についてインポートが生成されません。予期されないローカル impl を呼び出すと、例外を受け取ります。 しかし、その原因は、\f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP にあるようです。
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jar.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jar.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,104 +19,93 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jar 1 "02 Jun 2010"
+.TH jar 1 "14 Apr 2011"
.LP
-.SH ""
-jar \- Java ARchive 若
+.SH "名前"
+jar \- Java ARchive ツール
.LP
-\f3jar\fP 茲違＜ゃ 1 ゃ JAR ≪若ゃ＜ゃ腟障
+\f3jar\fP は複数のファイルを 1 つの JAR アーカイブファイルに結合します。
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-潟潟茵綣違＜ゃ
+コマンド行引数ファイル
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.RS 3
.TP 3
-JAR ＜ゃ篏
+JAR ファイルの作成
\f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ贋
+JAR ファイルの更新
\f4jar u\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ遵
+JAR ファイルの抽出
\f4jar x\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ絎鴻茵綵√筝荀ц；腓
+JAR ファイルの内容の表形式による一覧表示
\f4jar t\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
.TP 3
-JAR ＜ゃ吾ゃ潟鴻菴遵
+JAR ファイルへのインデックスの追加
\f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
.RE
.LP
.LP
-茯
-.LP
-.RS 3
-
+説明
.LP
.RS 3
.TP 3
cuxtiv0Mmfe
-\f2jar\fP 潟潟九勝激с
+\f2jar\fP コマンドを制御するオプション
.TP 3
jarfile
-篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)障絎鴻筝荀ц；腓 (\f2t\fP) 絲乗院 JAR ＜ゃ\f2f\fP 激с潟＜ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュJAR ＜ゃ緇 (x t 翫)罔羣阪吾JAR ＜ゃ篆＜障(c u 翫)
+作成 (\f2c\fP)、更新 (\f2u\fP)、抽出 (\f2x\fP)、または目次表示 (\f2t\fP) の対象となる JAR ファイル。\f2f\fP オプションとファイル名 \f2jarfile\fP とがペアになります。 つまり、片方を記述すれば、もう一方も記述する必要があります。 \f2f\fP と \f2jarfile\fP を省略すると、標準入力から「JAR ファイル」が取得されるか (x および t の場合)、標準出力へ「JAR ファイル」が送信されます(c および u の場合)。
.TP 3
inputfiles
-\f2jarfile\fP 腟 (c u 翫)\f2jarfile\fP 遵 (x 翫) 障筝荀ц；腓 (t 翫) 腥榊純у阪＜ゃ障ｃ鴻ｃ絽亥障＜ゃ激с \f2O\fP (若) 篏睡х軒障
+\f2jarfile\fP に結合されるか (c および u の場合)、\f2jarfile\fP から抽出 (x の場合) または一覧表示 (t の場合) される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション \f20\fP (ゼロ) を使用しないかぎり圧縮されます。
.TP 3
manifest
-\f2name\fP\f2:\fP\f2value\fP ≪JAR ＜ゃ MANIFEST.MF 障√с鴻＜ゃ\f2\-m\fP 激с潟＜ゃ \f2manifest\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
+JAR ファイルの MANIFEST.MF 内に含めるべき \f2name\fP\f2:\fP \f2value\fP ペアが含まれている既存のマニフェストファイル。\f2m\fP オプションとファイル名 \f2manifest\fP とがペアになります。つまり、片方を記述すれば、もう一方も記述する必要があります。\f3m\fP、\f3f\fP、および \f3e\fP の出現順序は、\f2manifest\fP、\f2jarfile\fP、\f2entrypoint\fP の出現順序と一致する必要があります。
.TP 3
entrypoint
-絎茵 JAR ＜ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟荐絎鴻\f2\-e\fP 激с潟 entrypoint 絲障ｃ障 ＜絎翫筝≧鴻絎綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
+実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして設定するクラスの名前。\f2\-e\fP オプションと entrypoint は対になっています。どちらかを指定する場合は両方とも指定する必要があります。\f3m\fP、\f3f\fP、および \f3e\fP の出現順序は、\f2manifest\fP、\f2jarfile\fP、\f2entrypoint\fP の出現順序と一致する必要があります。
.TP 3
\-C\ dir
-膓 \f2inputfiles\fP 綣違ｃ \f2dir\fP 娯紊眼障\f2\-C\ \fP\f2dir\fP \f2inputfiles\fP 祉茲遺戎с障
+これに続く \f2inputfiles\fP 引数を処理する間、ディレクトリを \f2dir\fP へ一時的に変更します。 \f2\-C\ \fP\f2\-\ dir\fP \f2inputfiles\fP のセットは複数使用できます。
.TP 3
\-Joption
-Java 絎茵医御検激с潟\f2\-J\fP \f2option\fP 腥榊純ャс
+Java 実行環境へ渡されるオプション。\f2\-J\fP と \f2option\fP の間には空白を入れないでください。
.RE
.LP
-.RE
-.SH "茯"
+.SH "説明"
.LP
-
-.LP
-\f3jar\fP 若茲違＜ゃ 1 ゃ JAR ≪若ゃ＜ゃ腟障 \f3jar\fP ZIP
+\f3jar\fP ツールは複数のファイルを 1 つの JAR アーカイブファイルに結合します。\f3jar\fP は、ZIP および
.na
\f2ZLIB\fP @
.fi
-http://www.gzip.org/zlib/ х軒綵√若鴻羆≪若ゃ喝х軒若с \f3jar\fP 若筝祉ゃ Java ≪≪宴若激с潟 1 ≪若ゃ腟怨с≪≪宴若激с潟潟潟若潟 (＜ゃゃ＜若吾潟泣潟) 1 ゃ≪若ゃ腟Java 若吾с潟 (吟) 潟潟若潟 1 HTTP 潟吟激с潟с潟若с潟潟若潟違･膓綽荀障ｃ潟若違紊у羝障 障\f3jar\fP ＜ゃх軒с潟若障障＜ゃ潟≪篏臀峨吾莨若с絽茯荐若純障jar 若罕\f2tar\fP 潟潟罕祉弱с\f3JAR\fP ≪若ゃх軒鴻鴻潟篏睡с障
+http://www.gzip.org/zlib/ 圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし \f3jar\fP ツールの主な目的は、いくつかの Java アプレットやアプリケーションを 1 個のアーカイブに統合することです。アプレットやアプリケーションのコンポーネント (ファイル、イメージ、およびサウンド) が 1 つのアーカイブに結合されていると、Java エージェント (ブラウザなど) は、それらのコンポーネントを 1 回の HTTP トランザクションでダウンロードすることができ、コンポーネントごとに新しい接続を必要とすることがありません。これにより、ダウンロード時間が大幅に短縮されます。また、\f3jar\fP はファイルの圧縮も行うので、ダウンロード時間がさらに短縮されます。また、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるので、配布元の認証が可能になります。jar ツールの構文は、\f2tar\fP コマンドの構文とほぼ同じです。\f3JAR\fP アーカイブは、圧縮されているかどうかにかかわらず、クラスパスのエントリとして使用できます。
.LP
-茲違＜ゃ JAR ＜ゃ悟筝篏睡羈罨＜с
-.LP
-.RS 3
-
+複数のファイルを JAR ファイルへ結合する一般的な使用法は次のとおりです。
.LP
.nf
\f3
@@ -125,19 +114,15 @@
.fl
\fP
.fi
-.RE
.LP
-箴с憜ｃ (.class) ＜ゃ鴻\f2myFile.jar\fP ＜ゃ主障jar 若\f2META\-INF/MANIFEST.MF\fP с鴻＜ゃ潟障絽吾JAR ＜ゃ潟障с鴻＜ゃ≪若ゃ≪＜炊宴絎ｈ若帥 \f2name\ :\ value\fP ≪主障jar 若с鴻＜ゃ＜炊宴主号荅括完ゃ
+この例では、現在のディレクトリにあるクラス (.class) ファイルがすべて、\f2myFile.jar\fP という名前のファイルに格納されます。jar ツールは自動的に、 \f2META\-INF/MANIFEST.MF\fP という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを \f2name\ :\ value\fP ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、「
.na
\f2JAR file specification\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifestс
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest」を参照してください。
.LP
-√с鴻＜ゃ主 \f2name\ :\ value\fP ≪ JAR ＜ゃ綽荀翫＜ゃ罨＜ \f2\-m\fP 激с潟篏帥ｃ絎障
-.LP
-.RS 3
-
+既存のマニフェストファイル内に格納された \f2name\ :\ value\fP ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。
.LP
.nf
\f3
@@ -146,20 +131,16 @@
.fl
\fP
.fi
-.RE
.LP
-√с鴻＜ゃ壕絖хｃ綽荀障 с鴻＜ゃ壕絖хｃ翫\f3jar\fP 緇茵茹ｆ障
+既存のマニフェストファイルは改行文字で終わっている必要があります。マニフェストファイルが改行文字で終わっていないと、\f3jar\fP はその最終行を解析しません。
.br
.LP
.br
.LP
-\f3羈:\ \fP潟潟茵 \f2cmf\fP с \f2cfm\fP 絎 jar 潟潟 (m \-f 激с潟) 翫\f3jar\fP 潟潟茵障 JAR ≪若ゃ絎膓с鴻＜ゃ絎綽荀障 罨＜箴腓冴障
-.RS 3
-
-.LP
+\f3注:\ \fPコマンド行に \f2cmf\fP ではなく \f2cfm\fP が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず JAR アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。 次に例を示します。
.nf
\f3
.fl
@@ -167,15 +148,11 @@
.fl
\fP
.fi
-.RE
.LP
-с鴻RFC822 ASCII 綵√ц鎘鴻綵√сс鴻＜ゃ絎鴻膂≦茵腓冴括隈с障
+マニフェストは、RFC822 ASCII 形式で規定されたテキスト形式であるため、マニフェストファイルの内容を簡単に表示および編集できます。
.LP
-JAR ＜ゃ＜ゃ遵冴翫\f2x\fP 篏睡障
-.LP
-.RS 3
-
+JAR ファイルからファイルを抽出する場合は、 \f2x\fP を使用します。
.LP
.nf
\f3
@@ -184,14 +161,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-jar ＜ゃャ＜ゃ遵冴翫＜ゃ絎障
-.LP
-.RS 3
-
+jar ファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。
.LP
.nf
\f3
@@ -200,18 +173,14 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-JDK 若吾с 1.3 篁ラ\f2jar\fP 若ｃｃ若
+JDK のバージョン 1.3 以降から、\f2jar\fP ユーティリティーで
.na
\f2JarIndex\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex 泣若障 JarIndex 篏睡≪宴若激с潟鴻若若 JAR ＜ゃ鴻若合筝障≪宴若激с潟障≪茲違 JAR ＜ゃ潟翫鴻若綽荀 JAR ＜ゃ篁ュ潟若潟若潟茵障若潟鴻違 \f2\-i\fP 激с潟絎 \f2jar\fP 絎茵鴻障激с潟篏帥絎 JAR ＜ゃ潟＜ゃ＜ゃ潟＜ゃ箴絖鴻 JAR ＜ゃゃ宴若娯臀宴障 ＜ゃ潟＜ゃ箴絖 JAR ＜ゃJAR ＜ゃ潟＜ゃс鴻 \f2Class\-Path\fP 絮с絎鏆荀障
-.LP
-.RS 3
-
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index がサポートされています。 JarIndex を使用すると、アプリケーションのクラスローダーで JAR ファイルからクラスがロードされるときの効率が向上します。アプリケーションまたはアプレットが複数の JAR ファイルにバンドルされている場合は、クラスがロードされるときに、必要な JAR ファイル以外のダウンロードおよびオープンは行われません。このパフォーマンスの最適化は、新しい \f2\-i\fP オプションを指定して \f2jar\fP を実行すると有効になります。このオプションを使うと、指定した JAR メインファイルと、そのメインファイルが依存しているすべての JAR ファイルについて、パッケージ位置情報が生成されます。メインファイルが依存している JAR ファイルは、JAR メインファイルのマニフェストの \f2Class\-Path\fP 属性に指定しておく必要があります。
.LP
.nf
\f3
@@ -220,52 +189,42 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-箴с\f2INDEX.LIST\fP ＜ゃ \f2main.jar\fP \f2META\-INF\fP ｃ水ャ障
+この例では、 \f2INDEX.LIST\fP ファイルが \f2main.jar\fP の \f2META\-INF\fP ディレクトリ内に挿入されます。
.br
.br
-＜ゃ主宴篏睡≪宴若激с潟鴻若若合鴻若障 ゃ潟鴻＜ゃ篏臀宴主号荅括完 \f2JarIndex\fP 篁罕с
+このファイルに格納されている情報を使用して、アプリケーションのクラスローダーは、効率的にクラスをロードします。インデックスファイルに位置情報を格納する方法の詳細は、「JarIndex 仕様」を参照してください。
.br
.br
-ｃ潟若障 \f2dir1\fP ＜ゃх軒罔羣阪阪膓罔羣ュ \f2dir2\fP 遵冴障 (筝≧鴻 \f2jar\fP 潟潟 \f2\-f\fP 激с潟) 罨＜箴腓冴障
-.LP
-.RS 3
-
+ディレクトリをコピーするには、まず \f2dir1\fP 内のファイルを圧縮して \f2stdout\fP に出力し、続いて \f2stdin\fP から抽出して \f2dir2\fP に出力します (\f2\-f\fP オプションはどちらの \f2jar\fP コマンドでも省略)。
.LP
.nf
\f3
.fl
-% (cd dir1; jar c .) | (cd dir2; jar x)
+% (cd dir1; jar c .)| (cd dir2; jar x)
.fl
\fP
.fi
-.RE
.LP
.LP
-\f2jar\fP 篏帥ｃ JAR ＜ゃ JAR ＜ゃс鴻篏潟潟泣潟腆肴箴с障
+\f2jar\fP を使用して JAR ファイルや JAR マニフェストファイルを操作するサンプルコマンドを確認したい場合は、後述の「例」を参照してください。また、「
.na
\f2Java Tutorial\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jar JAR 潟若鴻с
+http://download.oracle.com/javase/tutorial/deployment/jar」の JAR コースも参照してください。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
c
-\f2jarfile\fP ф違≪若ゃ＜ゃ篏 (\f2f\fP 絎翫)罔羣阪т障 (\f2f\fP \f2jarfile\fP ャ翫)\f2inputfiles\fP ф絎＜ゃｃ≪若ゃ菴遵障
+f が指定された場合は \f2jarfile\fP という名前の \f2新しい\fP アーカイブファイルを \f2作成し、\fP f と \f2jarfile\fP が省略された場合は標準出力に情報を出力します。\f2inputfiles\fP で指定されたファイルとディレクトリを、このアーカイブに追加します。
.TP 3
u
-\f2inputfiles\fP ф絎＜ゃｃ菴遵√＜ゃ \f2jarfile\fP 贋違障 (\f2f\fP 絎翫) 箴腓冴障
-.RS 3
-
-.LP
+f が指定されている場合に、既存ファイル \f2jarfile\fP を \f2更新する目的で、\fP \f2inputfiles\fP に指定されたファイルやディレクトリを追加します。次に例を示します。
.nf
\f3
.fl
@@ -273,11 +232,7 @@
.fl
\fP
.fi
-.RE
-筝潟潟＜ゃ \f2foo.class\fP √ JAR ＜ゃ \f2foo.jar\fP 菴遵障罨＜箴腓冴\f2\-u\fP 激с潟с鴻潟贋違с障
-.RS 3
-
-.LP
+上のコマンドは、ファイル \f2foo.class\fP を既存の JAR ファイル \f2foo.jar\fP に追加します。次の例に示すように、\f2\-u\fP オプションは、マニフェストエントリも更新できます。
.nf
\f3
.fl
@@ -285,20 +240,16 @@
.fl
\fP
.fi
-.RE
-\f2foo.jar\fP с鴻с鴻 \f2name:value\fP ≪ф贋違障
+\f2foo.jar\fP マニフェストをマニフェスト内の \f2name:value\fP ペアで更新します。
.TP 3
x
-\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)＜ゃｃ遵冴障\f2inputfiles\fP 絎翫絎＜ゃｃ遵冴障絎違鴻＜ゃｃ遵冴障遵冴＜ゃユ≪若ゃц┃絎с
+f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、ファイルやディレクトリを抽出します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが抽出されます。指定されていなければ、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。
.TP 3
t
-\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)絎鴻茵綵√т荀ц；腓冴障\f2inputfiles\fP 絎翫絎＜ゃｃ筝荀ц；腓冴障絎違鴻＜ゃｃ筝荀ц；腓冴障
+f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、目次を表示します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが一覧表示されます。指定されていなければ、すべてのファイルとディレクトリが一覧表示されます。
.TP 3
i
-絎 \f2jarfile\fP 箴絖 JAR ＜ゃゃゃ潟号宴障箴腓冴障
-.RS 3
-
-.LP
+指定された \f2jarfile\fP と、それに依存する JAR ファイルについて、インデックス情報を生成します。たとえば、
.nf
\f3
.fl
@@ -306,29 +257,25 @@
.fl
\fP
.fi
-.RE
.LP
-筝潟潟\f2foo.jar\fP \f2INDEX.LIST\fP ＜ゃ障 ＜ゃ\f2foo.jar\fP \f2foo.jar\fP \f2Class\-Path\fP 絮с絎鴻 JAR ＜ゃャｃ宴若吾篏臀宴吾莨若障障 ゃ潟鴻箴с
+上のコマンドは、\f2foo.jar\fP 内に \f2INDEX.LIST\fP ファイルを生成します。 このファイルには、\f2foo.jar\fP と、\f2foo.jar\fP の \f2Class\-Path\fP 属性に指定されたすべての JAR ファイルに入っている各パッケージの位置情報が書き込まれています。インデックスの例を参照してください。
.TP 3
f
-篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)ゃ潟壕申 (\f2i\fP)障茵腓 (\f2t\fP) 絲乗院＜ゃ \f2jarfile\fP 絎障\f2f\fP 激с潟＜ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュ JAR ＜ゃ篏睡 (x t 翫)罔羣阪 jar ＜ゃ 篆＜障 (c u 翫)
+次の各処理の対象となるファイル \f2jarfile\fP を指定します。作成 (\f2c\fP)、更新 (\f2u\fP)、抽出 (\f2x\fP)、インデックス追加 (\f2i\fP)、または表示 (\f2t\fP)。\f2f\fP オプションとファイル名 \f2jarfile\fP とがペアになります。 つまり、片方を記述すれば、もう一方も記述する必要があります。Omitting \f2f\fP と \f2jarfile\fP を省略すると、x や t の場合は \f2標準入力\fPから JAR ファイル名が取得され、c や u の場合は \f2標準出力\fP に JAR ファイルが送信されます。
.TP 3
v
-荅括完阪罔羣阪障т腓冴障
+詳細な出力を標準出力に生成します。あとで例を示します。
.TP 3
0
-(若) ZIP х軒篏睡篆絖障
+(ゼロ) ZIP による圧縮を使用せずに、保存します。
.TP 3
M
-с鴻＜ゃ潟篏障 (c u 翫) 障с鴻＜ゃ潟絖翫ゃ障 (u 翫)
+マニフェストファイルエントリを作成しません (c および u の場合)。または、マニフェストファイルエントリが存在する場合にそれを削除します (u の場合)。
.TP 3
m
-\f2META\-INF/MANIFEST.MF\fP ＜ゃф絎с鴻＜ゃ \f2manifest\fP \f2name :value\fP 絮с≪腟粋昭帥障су \f2jar\fP \f2name\ :\ value\fP ≪菴遵障у翫\f2jar\fP ゃ贋違障
+\f2META\-INF/MANIFEST.MF\fP のファイルで指定したマニフェストファイル \f2manifest\fP の \f2name : value\fP の属性ペアを組み込みます。 \f2jar\fP は、すでに同じ名前で存在しないかぎり、その \f2name:value\fP ペアを追加します。同じ名前で存在する場合、 \f2jar\fP はその値を更新します。
.LP
-潟潟茵с\f3m\fP \f3f\fP 絖\f2manifest\fP \f2jarfile\fP ュ綺綺ц菴違綽荀障違罨＜篏帥障
-.RS 3
-
-.LP
+コマンド行で、\f3m\fP と \f3f\fP の文字は、\f2manifest\fP と \f2jarfile\fP の入力順序と同じ順序で記述する必要があります。たとえば、次のようにして使います。
.nf
\f3
.fl
@@ -336,22 +283,17 @@
.fl
\fP
.fi
-.RE
-с鴻障с鴻劫ャ \f2name\ :\ value\fP 絮с≪菴遵с障違潟惹宴若吾с恰宴宴若吾激若潟違障 JAR 潟≪宴若激с潟絎茵絮с菴遵с障\f4\-m\fP 激с潟篏睡箴ゃJava Tutorial
+デフォルトのマニフェストには含まれないマニフェストに、特別な目的の \f2name\ :\ value\fP の属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージシーリング、または JAR にバンドルされたアプリケーションを実行するための属性を追加できます。「Java Tutorial」の「
.na
\f2JAR Files\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jar/潟若鴻с
-.LP
+http://download.oracle.com/javase/tutorial/deployment/jar/」コースを参照し、 \f4\-m\fP オプションの使用例を確認してください。
.TP 3
e
-絎茵 JAR ＜ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟\f2entrypoint\fP 荐絎障激с潟篏睡с鴻＜ゃ \f2Main\-Class\fP 絮уゃ篏障筝吾障 激с潟JAR ＜ゃ篏筝障贋遺賢篏睡с障 激с潟篏帥違с鴻＜ゃ膩障篏≪宴若激с潟潟ゃ潟絎с障
+実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして、\f2entrypoint\fP を設定します。このオプションを使用すると、マニフェストファイル内の \f2Main\-Class\fP 属性値が作成または上書きされます。このオプションは、JAR ファイルの作成中または更新中に使用できます。このオプションを使えば、マニフェストファイルを編集または作成することなしに、アプリケーションのエントリポイントを指定できます。
.br
.br
-違罨＜潟潟 \f2Main.jar\fP 篏障с鴻＜ゃ \f2Main\-Class\fP 絮уゃ \f2Main\fP 荐絎障
-.RS 3
-
-.LP
+たとえば、次のコマンドでは \f2Main.jar\fP が作成されますが、その際、マニフェスト内の \f2Main\-Class\fP 属性値は \f2Main\fP に設定されます。
.nf
\f3
.fl
@@ -359,12 +301,8 @@
.fl
\fP
.fi
-.RE
.LP
-罨＜潟潟絎茵 java 潟帥ゃ贋･≪宴若激с潟莎桁с障
-.RS 3
-
-.LP
+次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。
.nf
\f3
.fl
@@ -372,11 +310,7 @@
.fl
\fP
.fi
-.RE
-潟ゃ潟劫劫宴若後絖翫潟ゃ潟阪絖 (.) 障鴻激 (/) 篏睡с障違\f2Main.class\fP \f2foo\fP 宴若後絖翫罨＜潟ゃ潟絎с障
-.RS 3
-
-.LP
+あるパッケージ内にエントリポイントのクラス名が含まれている場合、ドット (「.」) 、スラッシュ (「/」) のいずれかの文字をその区切り文字として使用できます。たとえば、 \f2Main.class\fP が \f2foo\fP という名前のパッケージに含まれている場合、エントリポイントは次のようにして指定できます。
.nf
\f3
.fl
@@ -384,11 +318,7 @@
.fl
\fP
.fi
-.RE
-障
-.RS 3
-
-.LP
+または
.nf
\f3
.fl
@@ -396,18 +326,14 @@
.fl
\fP
.fi
-.RE
-\f3羈:\ \fP \f2\-m\fP 激с潟 \f2\-e\fP 激с潟筝≧鴻絎翫絎с鴻 \f2Main\-Class\fP 絮с障\f2Main.class\fP 絎障ｃ若榊JAR 篏障贋医医幻腟篋障
+\f3注:\ \fP \f2\-m\fP オプションと \f2\-e\fP オプションの両方を同時に指定した場合、指定したマニフェストにも \f2Main\-Class\fP 属性が含まれていれば、 \f2Main.class\fP の指定があいまいになってエラーや発生し、JAR の作成処理や更新処理が異常終了します。
.LP
.TP 3
\-C \ dir
-\f2jar\fP 潟潟絎茵筝緇膓 \f2inputfiles\fP 綣違筝ｃ紊眼障 (\f2cd\fP\ \f2dir\fP)UNIX \f2tar\fP 若ｃｃ若 \f2\-C\fP 激с潟罘純蕁篌若障
+\f2jar\fP コマンドの実行中に後続の \f2inputfiles\fP 引数を処理するときに、一時的にディレクトリを変更します (cd \f2dir\fP)。この処理は、UNIX の \f2tar\fP ユーティリティーの \f2\-C\fP オプションの機能に類似しています。
.br
.br
-違罨＜潟潟\f2classes\fP ｃ腱糸ｃ \f2bar.class\fP \f2foo.jar\fP 菴遵障
-.RS 3
-
-.LP
+たとえば、次のコマンドは、\f2classes\fP ディレクトリに移動し、そのディレクトリから \f2bar.class\fP を \f2foo.jar\fP に追加します。
.nf
\f3
.fl
@@ -415,23 +341,15 @@
.fl
\fP
.fi
-.RE
-罨＜潟潟с\f2classes\fP ｃ腱糸\f2classes\fP ｃ鴻＜ゃ \f2foo.jar\fP 菴遵障 (jar ＜ゃ classes ｃ篏障) 罨＜ｃ祉ｃ\f2bin\fP ｃ腱糸\f2xyz.class\fP \f2foo.jar\fP 菴遵障
-.RS 3
-
-.LP
+次のコマンドでは、\f2classes\fP ディレクトリに移動し、\f2classes\fP ディレクトリ内のすべてのファイルを \f2foo.jar\fP に追加します (jar ファイルには classes ディレクトリを作成しません)。次に元のディレクトリに戻ってから、\f2bin\fP ディレクトリに移動し、\f2xyz.class\fP を \f2foo.jar\fP に追加します。
.nf
\f3
.fl
-jar uf foo.jar \-C classes . \-C bin xyz.class
+jar uf foo.jar \-C classes .\-C bin xyz.class
.fl
\fP
.fi
-.RE
-\f2classes\fP \f2bar1\fP \f2bar2\fP 篆翫\f2jar tf foo.jar\fP 篏睡JAR ＜ゃ罨＜荀膣障
-.RS 3
-
-.LP
+\f2classes\fP にファイル \f2bar1\fP と \f2bar2\fP が格納されている場合に、 \f2jar tf foo.jar\fP 使用したときの JAR ファイルの中身を、次に示します。
.nf
\f3
.fl
@@ -447,30 +365,24 @@
.fl
\fP
.fi
-.RE
.LP
.TP 3
\-Joption
-Java 絎茵医 \f2option\fP 羝＜障 \f2option\fP Java ≪宴若激с活儀若＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f4\-J\-Xmx48M\fP 絎紊с＜≪若 48M ゃ荐絎障\f2\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 実行環境に \f2option\fP を渡します。 \f2option\fP には、「Java アプリケーション起動ツール」のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、 \f4\-J\-Xmx48M\fP と指定すると、最大メモリーが 48M バイトに設定されます。\f2\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.SH "潟潟茵綣違＜ゃ"
-.LP
-
+.SH "コマンド行引数ファイル"
.LP
-jar 潟潟茵膂≧\f2jar\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝＜ゃ絎с障篁紙激 jar 潟潟篏с若ｃ潟違激鴻潟潟茵狗茹ｆ障障
+jar のコマンド行を短くしたり簡潔にしたりするために、jar コマンドに対する引数 (\-J オプションを除く) を含む 1 つ以上の \f2ファイルを\fP 指定することが \f2できます\fP 。これにより、任意の長さの jar コマンドを作成でき、オペレーティングシステムによるコマンド行の制限から解放されます。
.LP
-綣違＜ゃ激с潟＜ゃс障＜ゃ綣違鴻若鴻障壕у阪障綣違＜ゃ＜ゃ憜ｃ荀後障鴻障 綣違＜ゃ篏臀荀後障鴻с障ゃ若 (*) 絽吾違若ｃ潟違激鴻激сｃ絖茹ｉ障翫茹ｉ障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
+引数ファイルにはオプションとファイル名を含めることができます。ファイル内の各引数は、スペースまたは改行で区切ります。引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。ワイルドカード (*) は、通常ならばオペレーティングシステムシェルによってあらゆる文字に解釈されますが、この場合はそのようには解釈されません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
.LP
.LP
-\f2jar\fP 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障\f2jar\fP \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
+\f2jar\fP を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。 \f2jar\fP は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
.br
.br
-罨＜箴с\f2find\fP 潟潟阪＜ゃ \f2classes.list\fP 主障
-.LP
-.RS 3
-
+次の例で、 \f2classes.list\fP には、 \f2find\fP コマンドによって出力されたファイルの名前が格納されます。
.LP
.nf
\f3
@@ -478,14 +390,10 @@
% find \fP\f3.\fP \-name '*.class' \-print > classes.list
.fl
.fi
-.RE
.LP
.LP
-緇綣違＜ゃ罕篏帥ｃ \f2jar\fP 鴻羝＜\f2Classes.list\fP \f2jar\fP 潟潟絎茵с障
-.LP
-.RS 3
-
+次に、引数ファイル構文を使用して \f2classes.list\fP を jar に渡すことで、 \f2そのリスト\fP に対して \f2jar\fP コマンドを実行できます。
.LP
.nf
\f3
@@ -494,13 +402,9 @@
.fl
\fP
.fi
-.RE
.LP
-綣違＜ゃ鴻絎с障後障鴻荐菴違綣違＜ゃ鴻＜ゃ羝＜鴻絲障後丞с憜篏罐ｃ後丞障 罨＜箴腓冴障
-.RS 3
-
-.LP
+引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、現在の作業ディレクトリに相対的となります。次はその例です。
.nf
\f3
.fl
@@ -508,20 +412,14 @@
.fl
\fP
.fi
-.RE
.LP
.LP
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
-劫ｃ鴻＜ゃ≪若ゃ菴遵 (≪若ゃс絖翫絎鴻筝吾) 罨＜障\f2\-v\fP 激с潟篏睡宴荅括完絎泣ゃ冴違贋井ャ≪若ゃ＜ゃゃ荅括完宴茵腓冴障
-.RS 3
-
-.LP
+特定のディレクトリ内のすべてのファイルをアーカイブに追加する (そのアーカイブがすでに存在する場合は、その内容を上書きする) には、次のようにします。\f2\-v\fP オプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。
.nf
\f3
.fl
@@ -557,13 +455,9 @@
.fl
\fP
.fi
-.RE
.LP
-с糸若ｃ＜ゃ潟合泣ｃ翫筝 JAR ＜ゃ腟с障
-.RS 3
-
-.LP
+すでに画像、オーディオファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一の JAR ファイルに結合できます。
.nf
\f3
.fl
@@ -607,13 +501,9 @@
.fl
\fP
.fi
-.RE
.LP
-JAR ＜ゃ潟茵腓冴\f2t\fP激с潟篏睡障
-.RS 3
-
-.LP
+JAR ファイルのエントリ名を表示するには、「\f2t\fP」オプションを使用します。
.nf
\f3
.fl
@@ -641,28 +531,24 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-鴻若蕭ゃ潟鴻＜ゃ JAR ＜ゃ菴遵\f2i\fP激с潟篏睡障
+クラスロードを高速にするためにインデックスファイルを JAR ファイルに追加するには、「\f2i\fP」オプションを使用します。
.br
.br
-箴:
+例:
.br
.LP
-.RS 3
-
-.LP
-違綣≪宴若激с括娯箴絖鴻\f2main.jar\fP\f2buy.jar\fP \f2sell.jar\fP 3 ゃ JAR ＜ゃ蚊障
+たとえば、株取引アプリケーションの内部依存しているクラスを、\f2main.jar\fP、\f2buy.jar\fP、および \f2sell.jar\fP という 3 つの JAR ファイルに分割したとします。
.br
.LP
.br
.LP
-\f2main.jar\fP с鴻 \f2Class\-path\fP 絮с罨＜絎翫
+\f2main.jar\fP のマニフェストの \f2Class\-path\fP 属性に次のように指定した場合、
.nf
\f3
.fl
@@ -672,7 +558,7 @@
.fi
.LP
-\f2\-i\fP 激с潟篏睡違≪宴若激с潟鴻 茯粋昭帥蕭с障
+\f2\-i\fP オプションを使用すれば、アプリケーションのクラスの 読み込みを高速化できます。
.nf
\f3
.fl
@@ -682,38 +568,34 @@
.fi
.LP
-\f2INDEX.LIST\fP ＜ゃ \f2META\-INF\fP ｃ水ャ障腟≪宴若激с潟鴻若若ｃ鴻障 純若鴻罎膣≪茵 jar ＜ゃ潟若障
-.RE
-.SH "∫ｉ"
+\f2INDEX.LIST\fP ファイルが \f2META\-INF\fP ディレクトリに挿入されます。この結果、アプリケーションのクラスローダーによってクラスまたはリソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。
+.SH "関連項目"
.LP
-
.LP
.na
-\f2JAR ＜ゃ网荀\fP @
+\f2JAR ファイルの概要\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
-.br
-
+.LP
.LP
.na
-\f2JAR ＜ゃ篁罕\fP @
+\f2JAR ファイルの仕様\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
-.br
-
+.LP
+.LP
+.na
+\f2JarIndex の仕様\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index
+.LP
.LP
.na
-\f2Jar ゃ潟鴻\fP @
+\f2JAR チュートリアル\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex
-.br
-
+http://download.oracle.com/javase/tutorial/deployment/jar/index.html
.LP
-.na
-\f2Jar ャ若≪\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/jar (Java Software Web 泣ゃ)
-.br
-
.LP
-pack200(1)
+pack200(1)
+.LP
+
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1998, 2011, 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
@@ -19,117 +19,1010 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jarsigner 1 "02 Jun 2010"
+.TH jarsigner 1 "14 Apr 2011"
.LP
-.SH ""
-jarsigner \- JAR 臀峨恰荐若若
-.LP
-.RS 3
-
+.SH "名前"
+jarsigner \- JAR 署名および検証ツール
.LP
.LP
-Java ARchive (JAR) ＜ゃ臀峨臀峨篁 JAR ＜ゃ臀峨罎荐若障
+Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
\fP\f3jarsigner\fP [ options ] jar\-file alias
.fl
-\f3jarsigner\fP \-verify [ options ] jar\-file
+\f3jarsigner\fP \-verify [ options ] jar\-file [alias...]
.fl
.fi
.LP
-.SH "茯"
.LP
-
+jarsigner の \-verify コマンドでは、JAR ファイル名のあとに 0 個以上のキーストア別名を指定できます。キーストア別名が指定された場合、jarsigner は、JAR ファイル内の各署名付きエンティティーの検証に使用される証明書がキーストア別名のいずれかに一致することをチェックします。別名は、\-keystore で指定されたキーストア内またはデフォルトのキーストア内に定義されます。
+.LP
+.SH "説明"
.LP
.LP
-\f3jarsigner\fP 若罨＜ 2 ゃт戎障
+\f3jarsigner\fP ツールは、次の 2 つの目的で使用します。
.LP
.RS 3
.TP 3
1.
-Java ARchive (JAR) ＜ゃ臀峨篁
+Java ARchive (JAR) ファイルに署名を付ける
.TP 3
2.
-臀峨篁 JAR ＜ゃ臀峨翫с罎荐若
+署名付き JAR ファイルの署名と整合性を検証する
+.RE
+
+.LP
+.LP
+JAR 機能を使うと、クラスファイル、イメージ、サウンド、およびその他のデジタルデータを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。開発者は、jar(1) という名前のツールを使って JAR ファイルを作成できます。技術的な観点から言えば、すべての ZIP ファイルも JAR ファイルとみなすことができます。 ただし、\f3jar\fP によって作成された JAR ファイル、または \f3jarsigner\fP によって処理された JAR ファイルには、META\-INF/MANIFEST.MF ファイルが含まれています。
+.LP
+.LP
+「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティー (人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。
+.LP
+.RS 3
+.TP 2
+o
+署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、デジタル署名が本物かどうかを検証できる
+.TP 2
+o
+非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である
+.TP 2
+o
+デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの署名として機能することはない
+.TP 2
+o
+署名付きのデータは変更できない。 データが変更された場合は、その署名によってデータが本物ではないことが検証される
.RE
.LP
.LP
-JAR 罘純篏帥鴻＜ゃゃ＜若吾泣潟潟篁吾帥若帥筝＜ゃ宴若後сс＜ゃ菴ゅ号絽с障肴jar(1) 若篏帥ｃ JAR ＜ゃ篏с障茵荀括鴻荐違鴻 ZIP ＜ゃ JAR ＜ゃ帥с障 \f3jar\fP ｃ篏 JAR ＜ゃ障 \f3jarsigner\fP ｃ JAR ＜ゃMETA\-INF/MANIFEST.MF ＜ゃ障障
+ファイルに対してエンティティーの署名を生成するには、まず、エンティティーは、そのエンティティーに関連する公開鍵と非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つまたは複数の証明書も必要です。「証明書」とは、あるエンティティーが発行したデジタル署名付きの文書で、別なエンティティーの公開鍵が特定の値であることを証明しています。
+.LP
+.LP
+\f3jarsigner\fP は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1) ユーティリティーを使います。
+.LP
+.LP
+\f3jarsigner\fP は、エンティティーの非公開鍵を使って署名を生成します。署名付き JAR ファイルには特に、ファイルの署名に使用された非公開鍵に対応する公開鍵に対する、キーストア内の証明書のコピーが含まれています。\f3jarsigner\fP は、署名付き JAR ファイル内 (署名ブロックファイル内) にある証明書を使用してそのファイルのデジタル署名を検証できます。
+.LP
+.LP
+\f3jarsigner\fP はタイムスタンプを含む署名を生成するので、システムやデプロイヤ (Java Plug\-in を含む) はJAR ファイルが署名証明書の有効期間中に署名されたかどうかをチェックできます。さらに、API を使用すると、アプリケーションからタイムスタンプ情報を取得できます。
+.LP
+.LP
+現時点では、\f3jarsigner\fP で署名できるのは、JDK の jar(1) ツールで作成された JAR ファイル、または ZIP ファイルだけです。JAR ファイルは ZIP ファイルと同じですが、JAR ファイルには META\-INF/MANIFEST.MF ファイルが含まれている点が異なります。META\-INF/MANIFEST.MF ファイルは、\f3jarsigner\fP が ZIP ファイルに署名を付けるときに自動的に作成されます。
+.LP
+.LP
+デフォルトでは、\f3jarsigner\fP は JAR (または ZIP) ファイルに「署名」を付けます。署名付き JAR ファイルを「検証」する場合は、 \f2\-verify\fP オプションを指定します。
+.LP
+.SS
+キーストアの別名
+.LP
+.LP
+キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。
+.LP
+.LP
+\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、working ディレクトリの mystore という名前のキーストアに含まれる別名 duke に関連付けられた非公開鍵を使って、MyJARFile.jar という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jar は署名付きの JAR ファイルによって上書きされます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-storepass myspass
+.fl
+ \-keypass dukekeypasswd MyJARFile.jar duke
+.fl
+\fP
+.fi
+
+.LP
+.LP
+キーストアはパスワードで保護されているので、ストアのパスワード (上の例では mypass) を指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワード (上の例では dukekeypasswd) を指定する必要があります。 コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。
+.LP
+.SS
+キーストアの場所
+.LP
+.LP
+\f3jarsigner\fP には、 \f2使用するキーストアの URL を指定する \-keystore\fP があります。キーストア \f2は\fP デフォルトで、 \f2user.home\fP システムプロパティーで決まるユーザーのホームディレクトリの .keystore という名前のファイル内に格納されます。Solaris システムの場合、 \f2user.home\fP のデフォルトはユーザーの home ディレクトリになります。
+.LP
+.LP
+\-keystore オプション \f2に指定した\fP 入力ストリームが \f2KeyStore.load\fP メソッドに渡される点に注意してください。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではない場合、たとえばそれがハードウェアトークンデバイス上に存在している場合などに指定すべきです。
+.LP
+.SS
+キーストアの実装
+.LP
+.LP
+java.security パッケージ \f2で提供されている\fP KeyStore クラス \f2は、\fP キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
+.LP
+.LP
+現在、キーストアの実装を使用するものとして、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールがあります。KeyStore \f2は\fP public として使用可能なので、Java 2 SDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。
+.LP
+.LP
+キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。
.LP
.LP
-吾帥臀峨若 (臀峨絲乗院若) 潟ｃｃ (篋冴篌腓障) 泣冴ャ荐膊с吾臀峨罕吾帥臀峨紊鴻障
+キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP によって提供されるアプリケーションインタフェースが「サービスプロバイダインタフェース」 (SPI) に基づいて実装されます。つまり、対応する抽象クラス \f2KeystoreSpi\fP が同じ \f2java.security\fP パッケージ内に存在しており、このクラスによって、「プロバイダ」が実装する必要のあるサービスプロバイダインタフェースメソッドが定義されています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、
+.na
+\f2「Java 暗号化アーキテクチャー用プロバイダの実装方法」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
+.LP
+.LP
+アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの \f2実装を\fP 選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。
+.LP
+.LP
+\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
+.LP
+.LP
+\f3jarsigner\fP と \f3keytool\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアのタイプを指定できます。
+.LP
+.LP
+ユーザーがキーストアのタイプを明示的に指定しなかった場合、ツールは、単純にセキュリティープロパティーファイルで指定された \f2keystore.type\fP プロパティーの値に基づいて、キーストアの実装を選択します。このセキュリティープロパティーファイルは \f2java.security\fP と呼ばれ、SDK セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security 内に存在しています。ここで、\f2java.home\fP は実行時環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment のトップレベルディレクトリ) です。
+.LP
+.LP
+各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
+.LP
+.LP
+\f2KeyStore\fP クラスに定義されている static メソッド \f2getDefaultType\fP を使用すると、アプリケーションやアプレットから \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ \f2(keystore.type プロパティーで指定されたタイプ)\fP のインスタンスを生成します。
+.LP
+.nf
+\f3
+.fl
+ KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
+.fl
+\fP
+.fi
+
+.LP
+.LP
+デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。
+.LP
+.nf
+\f3
+.fl
+ keystore.type=jks
+.fl
+\fP
+.fi
+
+.LP
+.LP
+注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
+.LP
+.LP
+各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
+.LP
+.nf
+\f3
+.fl
+ keystore.type=pkcs12
+.fl
+\fP
+.fi
+
+.LP
+.LP
+PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」にある
+.na
+\f2「KeyTool and JarSigner」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner節を参照してください。
+.LP
+.SS
+サポートされるアルゴリズム
+.LP
+.LP
+\f3jarsigner\fP はデフォルトで、次のいずれかを使用して JAR ファイルに署名します。
.LP
.RS 3
.TP 2
o
-臀峨篏帥泣絲障泣篏帥ｃ荐膊茵с吾帥臀峨罎荐若с
+SHA1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム)
+.TP 2
+o
+SHA256 ダイジェストアルゴリズムを使用した RSA アルゴリズム
+.TP 2
+o
+SHA256 と ECDSA (楕円曲線デジタル署名アルゴリズム) を使用した EC (楕円曲線) 暗号方式アルゴリズム
+.RE
+
+.LP
+.LP
+具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、\f3jarsigner\fP は SHA1withDSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が RSA 鍵である場合、\f3jarsigner\fP は SHA256withRSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が EC 鍵である場合、\f3jarsigner\fP は SHA256withECDSA アルゴリズムを使って JAR ファイルに署名を付けます。
+.LP
+.LP
+これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。
+.LP
+.SS
+署名付き JAR ファイル
+.LP
+.LP
+\f3jarsigner\fP を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが META\-INF ディレクトリに置かれる点が異なります。
+.LP
+.RS 3
+.TP 2
+o
+.SF 拡張子の付いた署名ファイル
+.TP 2
+o
+.DSA、.RSA、または .EC を拡張子に持つ署名ブロックファイル
+.RE
+
+.LP
+.LP
+これら 2 つのファイルのベースファイル名は、 \f2\-sigFile\fP オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。
+.LP
+.nf
+\f3
+.fl
+\-sigFile MKSIGN
+.fl
+\fP
+.fi
+
+.LP
+.LP
+この場合、ファイル名はそれぞれ MKSIGN.SF と MKSIGN.DSA になります。
+.LP
+.LP
+コマンド行で \f2\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。
+.LP
+\f3署名 (.SF) ファイル\fP
+.LP
+.LP
+署名ファイル (.SF ファイル) は、\f3jarsigner\fP で署名を付けた JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、.SF ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。
+.LP
+.RS 3
+.TP 2
+o
+ファイル名
.TP 2
o
-泣篁篋冴ャ吾帥臀峨初筝純с
+使われているダイジェストアルゴリズム (SHA) の名前
+.TP 2
+o
+SHA ダイジェストの値
+.RE
+
+.LP
+.LP
+マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータのダイジェスト (ハッシュ) です。一方、.SF ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当するソースファイルに対応する 3 行のハッシュです。
+.LP
+.LP
+署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。後述の「JAR ファイルの検証」で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。
+.LP
+\f3署名ブロックファイル\fP
+.LP
+.SF ファイルには署名が付けられ、署名は署名ブロックファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。 証明書または証明書チェーンは、署名に使われた非公開鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェストアルゴリズムに応じて .DSA、.RSA、.EC のいずれかになります。
+.SS
+署名タイムスタンプ
+.LP
+.LP
+\f2jarsigner\fP ツールは、JAR ファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、 \f2jarsigner\fP は代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。
+.LP
+.RS 3
+.TP 2
+o
+\f2\-tsa url\fP
+.TP 2
+o
+\f2\-tsacert alias\fP
.TP 2
o
-吾帥臀峨臀峨篁若帥絲乗院с祉若帥臀峨罘純
+\f2\-altsigner class\fP
.TP 2
o
-臀峨篁若帥紊眼с 若帥紊眼翫臀峨ｃ若帥с罎荐若
+\f2\-altsignerpath classpathlist\fP
+.RE
+
+.LP
+.LP
+これらの各オプションの詳細については、後述の「オプション」節を参照してください。
+.LP
+.SS
+JAR ファイルの検証
+.LP
+.LP
+JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。
+.LP
+.RS 3
+.TP 3
+1.
+.SF ファイルそれ自体の署名を検証します。
+.LP
+この手順では、各署名ブロック (.DSA) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って生成されたものであることを確認します。 .DSA ファイルには、公開鍵の証明書 (または証明書チェーン) も含まれています。また、この手順では、目的の署名が、対応する署名 (.SF) ファイル内の有効な署名であるかどうかを調べ、.SF ファイルが改変されていないことも確認します。
+.TP 3
+2.
+.SF ファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突き合わせて検証します。
+.LP
+.SF ファイルには、マニフェストファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。このヘッダーが存在する場合は、ヘッダー内のハッシュが実際にマニフェストファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致する場合は、次の手順に進みます。
+.LP
+ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。具体的には、.SF ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するかどうかを確認します (「署名 (.SF) ファイル」を参照)。
+.LP
+.SF ファイルのヘッダーに格納されたマニフェストファイルのハッシュと、実際のマニフェストファイルのハッシュとが一致しない場合は、署名 (および .SF ファイル) の生成後に、JAR ファイルに 1 つ以上のファイルが追加 \f2(jar ツールを使用)\fP された可能性があります。jar \f2ツール\fP を使ってファイルを追加した場合、マニフェストファイルは変更されますが (新しいファイル用のセクションが追加される)、.SF ファイルは変更されません。この場合、.SF ファイルのヘッダー以外のセクションに格納されたハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するときは、署名の生成時に JAR ファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。
+.TP 3
+3.
+JAR ファイル内のファイルのうち、.SF ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルのダイジェストを計算し、結果をマニフェストセクション内の該当するファイルのダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない場合は検証が失敗します。
.RE
.LP
.LP
-＜ゃ絲障潟ｃｃ若臀峨障潟ｃｃ若潟ｃｃ若∫ｃ泣泣≪ゅ荀障 障泣茯荐若 1 ゃ障茲違荐惹吾綽荀с荐惹吾潟ｃｃ若肴吾帥臀峨篁吾сャ潟ｃｃ若泣劫ゃс荐惹障
-.LP
+検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティー例外がスローされます。スローされたセキュリティー例外は、\f3jarsigner\fP がキャッチして表示します。
.LP
-\f3jarsigner\fP 若鴻≪障泣荐惹御宴篏帥ｃJAR ＜ゃ吾帥臀峨障若鴻≪泣泣∫ｄ X.509 荐惹吾с若潟若帥若鴻с若鴻≪篏膊∞keytool(1) 若ｃｃ若篏帥障
-.LP
-.LP
-\f3jarsigner\fP 潟ｃｃ若泣篏帥ｃ臀峨障臀峨篁 JAR ＜ゃ＜ゃ臀峨篏睡泣絲上泣篆絖若鴻≪ｃ荐惹吾潟若障障 \f3jarsigner\fP 臀峨篁 JAR ＜ゃ吾帥臀峨＜ゃ (臀峨＜ゃ) 障荐惹吾篏帥ｃ罎荐若с障
+.SS
+1 つの JAR ファイルを対象とする複数の署名
.LP
.LP
-5.0 篁ラс\f3jarsigner\fP 帥ゃ鴻帥潟臀峨с激鴻ゃ (Java Plug\-in ) JAR ＜ゃ臀峨荐惹吾号筝臀峨сс障5.0 ц申 API 篏睡≪宴若激с潟帥ゃ鴻帥潟宴緇с障
-.LP
-.LP
-憝鴻с\f3jarsigner\fP х讐сJDK jar(1) 若т JAR ＜ゃ障 ZIP ＜ゃсJAR ＜ゃ ZIP ＜ゃсJAR ＜ゃ META\-INF/MANIFEST.MF ＜ゃ障鴻違障META\-INF/MANIFEST.MF ＜ゃ\f3jarsigner\fP ZIP ＜ゃ臀峨篁篏障
-.LP
+1 つの JAR ファイルに対して \f3jarsigner\fP ツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JAR ファイルに複数のユーザーの署名を付けることができます。
.LP
-с\f3jarsigner\fP JAR (障 ZIP) ＜ゃ臀峨篁障臀峨篁 JAR ＜ゃ罎荐若翫\f2\-verify\fP 激с潟絎障
-.LP
-.SS
-JDK 1.1 篋
-.LP
-.RS 3
+.nf
+\f3
+.fl
+ jarsigner myBundle.jar susan
+.fl
+ jarsigner myBundle.jar kevin
+.fl
+\fP
+.fi
.LP
.LP
-\f3keytool\fP 若 \f3jarsigner\fP 若JDK 1.1 ф箴 \f3javakey\fP 若絎臀с違若 \f3javakey\fP 紊罘純若鴻≪泣鴻若т茘激罘純臀峨臀峨罎荐若罘純ｃ障
+JAR ファイルが複数回署名されている場合、その JAR ファイルには .SF ファイルと .DSA ファイルの対が複数含まれることになります。 .SF ファイルと .DSA ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力される JAR ファイルには、次の名前を持つファイルが含まれます。
+.LP
+.nf
+\f3
+.fl
+ SUSAN.SF
+.fl
+ SUSAN.DSA
+.fl
+ KEVIN.SF
+.fl
+ KEVIN.DSA
+.fl
+\fP
+.fi
+
.LP
.LP
-違若鴻≪≪若ｃ若\f3javakey\fP 篏膊∞≪ゃ潟ｃｃ若若帥若鴻篁ｃс若鴻√就綣JDK 1.1 \f3javakey\fP 篏帥ｃ若帥若劫就綣筝篏篋с障罨＜純с
+注: JAR ファイルでは、JDK 1.1 の \f3javakey\fP ツールで生成された署名と \f3jarsigner\fP で生成された署名が混在できます。つまり、すでに \f3javakey\fP を使って署名が付けられている JAR ファイルに、\f3jarsigner\fP を使って署名を付けることができます。
+.LP
+.SH "オプション"
+.LP
+.LP
+以下では、\f3jarsigner\fP のオプションについて説明します。注:
.LP
.RS 3
.TP 2
o
-\f3keytool\fP \f2\-identitydb\fP 潟潟篏帥≪ゃ潟ｃｃ若若帥若鴻宴若鴻≪ゃ潟若с障
+どのオプション名にも先頭にマイナス記号 (\-) が付く
+.TP 2
+o
+オプションは任意の順序で指定できる
+.TP 2
+o
+イタリック体の項目の実際の値 (オプションの値) は、ユーザーが指定する必要がある
+.TP 2
+o
+\f2\-keystore\fP、 \f2\-storepass\fP、 \f2\-keypass\fP、 \f2\-sigfile\fP、 \f2\-sigalg\fP、 \f2\-digestalg\fP、および \f2\-signedjar\fP オプションを使用できるのは、署名付き JAR ファイルを検証する場合ではなく、JAR ファイルに署名する場合だけです。同様に、別名をコマンド行で指定するのは、JAR ファイルに署名を付ける場合だけである
+.RE
+
+.LP
+.RS 3
+.TP 3
+\-keystore url
+キーストアの場所を示す URL を指定します。デフォルトは、ユーザーのホームディレクトリ内のファイル \f2.keystore\fP です。 ユーザーのホームディレクトリは、user.home システムプロパティーによって決まります。
+.LP
+署名するときはキーストアが必要です。 このため、デフォルトのキーストアが存在しない場合、あるいはデフォルト以外のほかのキーストアを使用する場合は、キーストアを明示的に指定する必要があります。
+.LP
+検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに \f2\-verbose\fP オプションも指定されていた場合、JAR ファイルの検証に使用される証明書がそのキーストアに 1 つでも含まれているかどうかに関する追加情報が出力されます。
+.LP
+注: \f2\-keystore\fP の引数には、URL の代わりにファイル名 (とパス) を指定できます。 ファイル名 (とパス) を指定した場合は、「file:」URL として扱われます。たとえば、次のように指定できます。
+.nf
+\f3
+.fl
+ \-keystore \fP\f4filePathAndName\fP\f3
+.fl
+\fP
+.fi
+.LP
+これは、次の指定と同じものとして扱われます。
+.nf
+\f3
+.fl
+ \-keystore file:\fP\f4filePathAndName\fP\f3
+.fl
+\fP
+.fi
+.LP
+JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。
+.RS 3
+.TP 2
+o
+\f2\-keystore NONE\fP
+.TP 2
+o
+\f2\-storetype PKCS11\fP
+.RE
+.LP
+たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。
+.nf
+\f3
+.fl
+ jarsigner \-keystore NONE \-storetype PKCS11 \-list
+.fl
+
+.fl
+\fP
+.fi
+.TP 3
+\-storetype storetype
+インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストアタイプは、セキュリティープロパティーファイル内の keystore.type プロパティーの値で指定されたタイプです。この値は、 \f2java.security.KeyStore\fP の static getDefaultType メソッド \f2で取得できます。\fP.
+.LP
+\-storepass オプションを使って PCKS#11 トークンの PIN を \f2指定することも\fP できます。何も指定しなかった場合、keytool と jarsigner はユーザーにトークン PIN の 入力を求めます。トークンに保護された認証パス (専用の PIN パッドや生体読み取り機など) がある場合、\f2\-protected\fP オプションを指定する必要がありますが、パスワードオプションを指定する必要はありません。
+.TP 3
+\-storepass[:env | :file] argument
+.LP
+キーストアにアクセスするのに必要なパスワードを指定します。このオプションが必要なのは、JAR ファイルに署名を付けるときだけです (JAR ファイルを検証するときは不要)。その場合、 \f2\-storepass\fP オプションをコマンド行で指定しなかった場合は、新しいパスワードの入力を求められます。
+.LP
+修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。
+.RS 3
+.TP 2
+o
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
+.TP 2
+o
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
+.TP 3
+\-keypass[:env | :file] argument
+.LP
+コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するのに使うパスワードを指定します。\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。
+.LP
+修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。
+.RS 3
+.TP 2
+o
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
+.TP 2
+o
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
+.TP 3
+\-sigfile file
+.SF ファイルと .DSA ファイルの生成に使うベースファイル名を指定します。たとえば、\f2file\fP に DUKESIGN を指定すると、生成される .SF ファイルと .DSA ファイルの名前は、それぞれ DUKESIGN.SF と DUKESIGN.DSA になります。 これらのファイルは、署名付き JAR ファイルの META\-INF ディレクトリに置かれます。
+.LP
+\f2file\fP に使用できる文字は「a\-zA\-Z0\-9_\-」です。つまり、文字、数字、下線、およびハイフンだけを使用できます。注: .SF および .DSA のファイル名では、小文字はすべて大文字に変換されます。
+.LP
+\-sigfile \f2オプション\fP を指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
+.TP 3
+\-sigalg algorithm
+JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。
+.LP
+標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」にある
+.na
+\f2「Appendix A 」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、SHA256withRSA、SHA256withECDSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
+.TP 3
+\-digestalg algorithm
+JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。
+.LP
+標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」にある
+.na
+\f2「Appendix A 」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
+.TP 3
+\-signedjar file
+署名付き JAR ファイルの名前を指定します。
+.LP
+コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる JAR ファイル) の名前と同じ名前が使われます。 この場合、入力 JAR ファイルは署名付き JAR ファイルによって上書きされます。
+.TP 3
+\-verify
+コマンド行でこのオプションが指定されている場合は、指定された JAR ファイルが検証されます。 JAR ファイルへの署名は行われません。検証が成功すると、「jar verified」 というメッセージが表示されます。署名されていない JAR ファイル、またはサポートされていないアルゴリズム (RSA プロバイダのインストールを終了していない場合の RSA など) を使って署名された JAR ファイルを検証しようとすると、「jar is unsigned. (signatures missing or not parsable)」というメッセージが表示されます。
+.LP
+署名付き JAR ファイルは、\f3jarsigner\fP または JDK 1.1 の \f3javakey\fP ツール、あるいはその両方を使って検証できます。
+.LP
+検証についての詳細は、「JAR ファイルの検証」を参照してください。
+.TP 3
+\-certs
+コマンド行で、 \f2\-verify\fP および \f2\-verbose\fP オプションとともにこのオプションを指定した場合、JAR ファイルの各署名者の証明書情報が出力に含まれます。証明書情報には次のものが含まれます。
+.RS 3
+.TP 2
+o
+署名者の公開鍵を証明する (.DSA ファイルに格納された) 証明書の種類の名前
+.TP 2
+o
+証明書が X. 証明書 (つまり、 \f2java.security.cert.X509Certificate\fP のインスタンス) である場合は、署名者の識別名
+.RE
+.LP
+キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストアファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。
+.RS 3
.TP 2
o
-\f3jarsigner\fP 篁ュ \f3javakey\fP 篏帥ｃ臀峨 JAR ＜ゃ臀峨篁с障
+署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。 ただし、キーストアではなく JDK 1.1 のアイデンティティーデータベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。
+.RE
+.TP 3
+\-certchain file
+コマンド行で指定した別名で決まるキーストアエントリの非公開鍵に関連付けられた証明書チェーンが完全でない場合に、使用すべき証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェアトークン上に格納されているが、そこには証明書チェーンの全体を保持できるだけの領域が存在していないような場合です。このファイルは一連の X.509 証明書が順に連結されたもの、PKCS#7 形式の単一データブロックのいずれかとなり、そのエンコーディング形式はバイナリエンコーディング形式、Internet RFC 1421 標準で規定される印刷可能エンコーディング形式 (BASE64 エンコーディングとも呼ばれる) のいずれかになります。
+.TP 3
+\-verbose
+コマンド行でこのオプションが指定されている場合、\f3jarsigner\fP は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出力します。
+.TP 3
+\-internalsf
+以前は、JAR ファイルの署名時に生成された .DSA (署名ブロック) ファイルの中に、生成された .SF ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この動作は変更されました。この動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、デフォルトでは .SF ファイルが .DSA ファイルに含まれないようになっています。ただし、 \f2\-internalsf\fP オプションをコマンド行で指定すると、以前と同じように動作します。\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP
+.TP 3
+\-sectionsonly
+コマンド行でこのオプションが指定されている場合、JAR ファイルの署名時に生成される .SF ファイル (署名ファイル) には、マニフェストファイル全体のハッシュを含むヘッダーは追加されません。この場合、.SF ファイルに含まれるのは、JAR ファイル内の各ソースファイルに関する情報およびハッシュだけです。詳細は、「署名 (.SF) ファイル」を参照してください。
+.LP
+デフォルトでは、最適化を行うために、マニフェストファイル全体のハッシュを含むヘッダーが追加されます。ヘッダーが存在する場合は、JAR ファイルの検証時に、まずヘッダー内のハッシュが、マニフェストファイル全体のハッシュと実際に一致するかどうかが確認されます。ハッシュが一致する場合、検証は次の手順に進みます。ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。 具体的には、.SF ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の対応するセクションのハッシュと一致するかどうかを確認します。
+.LP
+詳細は、「JAR ファイルの検証」を参照してください。
+.LP
+\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP
+.TP 3
+\-protected
+\f2true\fP または \f2false\fP。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値を \f2true\fP に指定してください。
+.TP 3
+\-providerClass provider\-class\-name
+サービスプロバイダがセキュリティープロパティーファイル (\f2java.security\fP) のリストに入っていないときに、暗号化サービスプロバイダのマスタークラスファイルの名前を指定します。
+.LP
+\f2\-providerArg\fP \f2ConfigFilePath\fP オプションと組み合わせて使用します。keytool と jarsigner はプロバイダを動的にインストールします (ここで、\f2ConfigFilePath\fP はトークン設定ファイルへのパスです)。セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されていない場合に PKCS#11 キーストアを一覧表示するコマンドの例を次に示します。
+.nf
+\f3
+.fl
+jarsigner \-keystore NONE \-storetype PKCS11 \\
+.fl
+ \-providerClass sun.security.pkcs11.SunPKCS11 \\
+.fl
+ \-providerArg /foo/bar/token.config \\
+.fl
+ \-list
+.fl
+\fP
+.fi
+.TP 3
+\-providerName providerName
+\f2java.security\fP セキュリティープロパティーファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前です。
+.LP
+Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP という形式になります。 ここで「\f2TokenName\fP」は、プロバイダインスタンスが構成された名前の接尾辞です。 詳細は
+.na
+\f2構成属性の表\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSを参照してください。たとえば、以下のコマンドでは、名前接尾辞 \f2SmartCard\fP の PKCS#11 キーストアプロバイダインスタンスの内容をリストします。
+.nf
+\f3
+.fl
+jarsigner \-keystore NONE \-storetype PKCS11 \\
+.fl
+ \-providerName SunPKCS11\-SmartCard \\
+.fl
+ \-list
+.fl
+\fP
+.fi
+.TP 3
+\-Jjavaoption
+指定された \f2javaoption\fP 文字列を Java インタプリタに直接渡します。\f3jarsigner\fP は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。使用可能なインタプリタオプションの一覧を表示するには、 \f2java \-h\fP または \f2java \-X\fP とコマンド行から入力します。
+.LP
+.TP 3
+\-tsa url
+\f2「\-tsa http://example.tsa.url」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。URL \f2http://example.tsa.url\fP は、TSA (Time Stamping Authority) の場所を特定します。これは、 \f2\-tsacert\fP オプションで検出された URL をオーバーライドします。 \f2\-tsa\fP オプションでは、TSA の公開鍵証明書をキーストアに配置する必要はありません。
+.LP
+タイムスタンプを生成するために、 \f2jarsigner\fP は、
+.na
+\f2RFC 3161\fP @
+.fi
+http://www.ietf.org/rfc/rfc3161.txt で定義されている タイムスタンププロトコル (TSP) を使用して TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンは署名ブロックファイルの署名とともに保存されます。
+.LP
+.TP 3
+\-tsacert alias
+\f2「\-tsacert alias」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。 \f2alias\fP は、キーストア内の現在有効な TSA の公開鍵証明書を特定します。エントリの証明書で、TSA の場所を特定する URL を含む Subject Information Access 拡張機能が確認されます。
+.LP
+TSA の公開鍵証明書は、 \f2\-tsacert を使った場合、キーストアに配置されている必要があります。\fP.
+.LP
+.TP 3
+\-altsigner class
+代替署名機構を使用することを指定します。完全修飾クラス名は、com.sun.jarsigner.ContentSigner 抽象クラスを拡張するクラスファイルを \f2特定します。\fP. このクラスファイルへのパスは、 \f2\-altsignerpath\fP オプションによって定義されます。 \f2\-altsigner\fP オプションが使用されると、 \f2jarsigner\fP は、指定されたクラスが提供する署名機構を使用します。そうでない場合、 \f2jarsigner\fP はデフォルトの署名機構を使用します。
+.LP
+たとえば、 \f2com.sun.sun.jarsigner.AuthSigner\fP という名前のクラスが提供する署名機構を使用するには、 \f2jarsigner\fP オプション \f2「\-altsigner com.sun.jarsigner.AuthSigner」を使用します。\fP
+.LP
+.TP 3
+\-altsignerpath classpathlist
+クラスファイル (そのクラスファイル名は前述の \f2\-altsigner\fP オプションで指定される) およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。クラスファイルが JAR ファイル内にある場合、以下の例のように JAR ファイルへのパスが指定されます。
+.LP
+絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP に複数のパスや JAR ファイルが含まれる場合には、それらを Solaris の場合はコロン (\f2:\fP) で、Windows の場合はセミコロン (\f2;\fP) でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。
+.LP
+クラスファイルを含む、JAR ファイルへのパスを指定する例を示します。
+.nf
+\f3
+.fl
+\-altsignerpath /home/user/lib/authsigner.jar
+.fl
+\fP
+.fi
+.LP
+JAR ファイル名が含まれていることに注意してください。
+.LP
+クラスファイルを含む JAR ファイルへのパスを指定する例を示します。
+.nf
+\f3
+.fl
+\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/
+.fl
+\fP
+.fi
+.LP
+JAR ファイル名は含まれていないことに留意してください。
+.TP 3
+\-strict
+署名または検証処理中に、何らかの警告メッセージが表示される場合があります。コマンド行でこのオプションを指定すると、見つかった警告メッセージがツールの終了コードに反映されます。詳細は「警告」の項を参照してください。
+.TP 3
+\-verbose:sub\-options
+検証処理で、 \f2\-verbose\fP オプションは、表示する情報の量を決定するサブオプションを取ります。 \f2\-certs\fP も指定した場合、デフォルトモード (またはサブオプション all) では、エントリが処理されるたびにそれらの各エントリが表示され、そのあとに JAR ファイルの各署名者の証明書情報も表示されます。 \f2\-certs\fP と \f2\-verbose:grouped\fP サブオプションを指定した場合、同じ署名者情報を持つエントリとその証明書情報が、いっしょにグループ化されて表示されます。 \f2\-certs\fP と \f2\-verbose:summary\fP サブオプションを指定した場合、同じ署名者情報を持つエントリとその証明書情報がいっしょにグループ化されて表示されますが、各エントリの詳細が「1 つのエントリ (およびそれ以上)」として要約されて表示されます。詳細は例の項を参照してください。
+.RE
+
+.LP
+.SH "例"
+.LP
+.SS
+JAR ファイルの署名
+.LP
+.LP
+bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。キーストアは、mystore という名前で、C ドライブの working ディレクトリにあり、キーストアのパスワードは mypass、\f2jane\fP の非公開鍵のパスワードは j638klm とします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-storepass myspass
+.fl
+ \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+上のコマンドでは \f2\-sigfile\fP が指定されていないため、署名付き JAR ファイルに格納される .SF ファイルと .DSA ファイルの名前は、別名からデフォルト名がつけられます。つまり、それらの名前は \f2JANE.SF\fP および \f2JANE.DSA\fP になります。
+.LP
+.LP
+ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、上のコマンドを短縮して次のように入力できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore
+.fl
+ \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+デフォルトのキーストア (ホームディレクトリ内の .keystore という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を省略できます。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-signedjar sbundle.jar bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.LP
+最後に、入力 JAR ファイル (\f2bundle.jar\fP) を署名付き JAR ファイルで単純に上書きする場合は、次のように \f2\-signedjar\fP オプションを指定する必要はありません。
+.LP
+.nf
+\f3
+.fl
+ jarsigner bundle.jar jane
+.fl
+\fP
+.fi
+
+.LP
+.SS
+署名付き JAR ファイルの検証
+.LP
+.LP
+次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが改変されていないことを確認するためのコマンド例です。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-verify sbundle.jar
+.fl
+\fP
+.fi
+
+.LP
+.LP
+検証が成功すると、次のようなメッセージが表示されます。
+.LP
+.nf
+\f3
+.fl
+ jar verified.
+.fl
+\fP
+.fi
+
+.LP
+.LP
+というプロンプトが表示されます。検証が成功しなかった場合は、エラーメッセージが表示されます。
+.LP
+.LP
+\-verbose オプションを使うと、 \f2より多くの情報が\fP 表示されます。\-verbose オプション付きで \f3jarsigner\fP \f2を使用する例とその出力例を、\fP 次に示します。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-verify \-verbose sbundle.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
+.fl
+ smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.SS
+証明書情報を使った検証
+.LP
+.LP
+検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。次に例を示します。
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
+.fl
+ 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
+.fl
+ smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
+.fl
+
+.fl
+ X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
+.fl
+ X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.LP
+署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の場合は、次のように表示されます。
+.LP
+.nf
+\f3
+.fl
+ PGP, (bob)
+.fl
+\fP
+.fi
+
+.LP
+.SS
+アイデンティティーデータベースの署名者を含む JAR ファイルの検証
+.LP
+.LP
+JAR ファイルが、JDK 1.1 の \f3javakey\fP ツールを使って署名されている場合、署名者はアイデンティティーデータベース内の別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、アイデンティティーデータベース内の別名とキーストア内の別名の両方によって署名されている場合は、k と i の両方が表示されます。
+.LP
+.LP
+\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。たとえば、
+.LP
+.nf
+\f3
+.fl
+ jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
+.fl
+
+.fl
+ 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
+.fl
+ 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
+.fl
+ 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
+.fl
+ 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
+.fl
+ 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
+.fl
+ smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
+.fl
+
+.fl
+ X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
+.fl
+ X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
+.fl
+
+.fl
+ s = 署名が検証されました
+.fl
+ m = マニフェストにエントリが記載されています
+.fl
+ k = キーストアで 1 つ以上の証明書が見つかりました
+.fl
+ i = アイデンティティースコープで 1 つ以上の証明書が見つかりました
+.fl
+
+.fl
+ JAR が検証されました。
+.fl
+\fP
+.fi
+
+.LP
+.LP
+別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティーデータベースの別名です。
+.LP
+.SH "警告"
+.LP
+署名/検証処理中には、jarsigner からさまざまな警告が表示される可能性があります。これらの警告コードは次のように定義されています。
+.nf
+\f3
+.fl
+ hasExpiringCert 2
+.fl
+ この JAR に含まれるエントリの署名者の証明書が 6 か月以内に期限切れになります
+.fl
+
+.fl
+ hasExpiredCert 4
+.fl
+ この JAR に含まれるエントリの署名者の証明書が期限切れになっています。
+.fl
+
+.fl
+ notYetValidCert 4
+.fl
+ この JAR に含まれるエントリの署名者の証明書がまだ有効になっていません。
+.fl
+
+.fl
+ chainNotValidated 4
+.fl
+ この JAR に含まれるエントリの証明書チェーンの検証を正しく行えません。
+.fl
+
+.fl
+ badKeyUsa ge 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の KeyUsage 拡張がコードの署名を許可していません。
+.fl
+
+.fl
+ badExtendedKeyUsage 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の ExtendedKeyUsage 拡張が
+.fl
+ コードの署名を許可していません。
+.fl
+
+.fl
+ badNetscapeCertType 8
+.fl
+ この JAR に含まれるエントリの署名者の証明書の NetscapeCertType 拡張が
+.fl
+ コードの署名を許可していません。
+.fl
+
+.fl
+ hasUnsignedEntry 16
+.fl
+ この JAR には、完全性チェックが行われていない署名なしエントリが含まれています。
+.fl
+
+.fl
+ notSignedByAlias 32
+.fl
+ この JAR には、指定された別名によって署名されていない署名付きエントリが含まれています
+.fl
+
+.fl
+ aliasNotInStore 32
+.fl
+ この JAR には、このキーストアの別名によって署名されていない署名付きエントリが含まれています
+.fl
+
+.fl
+\fP
+.fi
+
+.LP
+.LP
+\f2\-strict\fP オプションを指定した場合、検出された警告の OR を取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書の keyUsage 拡張でファイルの署名が許可されていない場合、終了コード 12 (=4+8) が返されます。
+.LP
+.LP
+\f3注\fP: UNIX で使用可能な値は 0 から 255 だけであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。
+.LP
+.nf
+\f3
+.fl
+failure 1
+.fl
+\fP
+.fi
+
+.LP
+.SS
+JDK 1.1 との互換性
+.LP
+.LP
+\f3keytool\fP ツールと \f3jarsigner\fP ツールは、JDK 1.1 で提供されていた \f3javakey\fP ツールを完全に置き換えるものです。これらの新しいツールは、キーストアと非公開鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fP より多くのを機能を備えています。
+.LP
+.LP
+新しいキーストアアーキテクチャーは、\f3javakey\fP が作成して管理していたアイデンティティーデータベースに代わるものです。キーストア形式と、JDK 1.1 の \f3javakey\fP が使っていたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。
+.LP
+.RS 3
.TP 2
o
-\f3jarsigner\fP \f3javakey\fP篏帥ｃ臀峨 JAR ＜ゃ罎荐若с障ｃjarsigner Java 2 SDK 若鴻≪с JDK 1.1 ≪ゃ潟ｃｃ若若帥若鴻臀峨ュ茯茘絲乗院茵с障
+\f3keytool\fP の \f2\-identitydb\fP コマンドを使うと、アイデンティティーデータベースの情報をキーストアにインポートできます。
+.TP 2
+o
+\f3jarsigner\fP は、以前に \f3javakey\fP を使って署名された JAR ファイルに署名を付けることができます。
+.TP 2
+o
+\f3jarsigner\fP は、\f3javakey\fPを使って署名された JAR ファイルを検証できます。したがって、jarsigner は、Java 2 SDK のキーストアではなく JDK 1.1 のアイデンティティーデータベースからの署名者別名を認識し、これらを対象に処理を行うことができます。
.RE
.LP
.LP
-罨＜茵JDK 1.1.x х讐 JAR ＜ゃJava 2 若с宴腓冴障
+次の表は、JDK 1.1.x で署名された JAR ファイルが、Java 2 プラットフォームでどのように扱われるかを示しています。
.LP
.LP
.TS
@@ -160,7 +1053,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3JAR ＜ゃ帥ゃ\fP
+\f3JAR ファイルのタイプ\fP
.br
.di
.nr a| \n(dn
@@ -176,7 +1069,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f31.1 若帥若劫≪ゃ潟ｃｃ\fP
+\f31.1 データベース内のアイデンティティー\fP
.br
.di
.nr b| \n(dn
@@ -192,7 +1085,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f31.1 若帥若鴻 Java 2 Platform 若鴻≪ゃ潟若篆♂若с≪ゃ潟ｃｃ (4)\fP
+\f31.1 データベースから Java 2 Platform キーストアにインポートされる信頼できるアイデンティティー (4)\fP
.br
.di
.nr c| \n(dn
@@ -208,7 +1101,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(83 .ll \n(83u
.in 0
-\f3激若＜ゃ≪ゃ潟ｃｃ/ュ号┤筝\fP
+\f3ポリシーファイルがアイデンティティー/別名に特権を与える\fP
.br
.di
.nr d| \n(dn
@@ -224,7 +1117,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr e| \n(dn
@@ -240,7 +1133,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr f| \n(dn
@@ -256,7 +1149,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤
+すべてのコードに与えられるデフォルトの特権
.br
.di
.nr g| \n(dn
@@ -272,7 +1165,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-/篆♂若с
+あり/信頼できない
.br
.di
.nr h| \n(dn
@@ -288,7 +1181,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤ (3)
+すべてのコードに与えられるデフォルトの特権(3)
.br
.di
.nr i| \n(dn
@@ -304,7 +1197,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-/篆♂若с
+あり/信頼できない
.br
.di
.nr j| \n(dn
@@ -320,7 +1213,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤ (1,3)
+すべてのコードに与えられるデフォルトの特権(1,3)
.br
.di
.nr k| \n(dn
@@ -336,7 +1229,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤激若＜ゃт号┤
+すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権
.br
.di
.nr l| \n(dn
@@ -352,7 +1245,7 @@
.ll \n(34u*1u/6u
.if \n(.l<\n(84 .ll \n(84u
.in 0
-鴻潟若筝号┤激若＜ゃт号┤ (2)
+すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権(2)
.br
.di
.nr m| \n(dn
@@ -363,46 +1256,46 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨 JAR
+.nr 38 \w署名のない JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w臀峨篁 JAR
+.nr 38 \w署名付き JAR
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 38 \n(a-
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w/篆♂若с
+.nr 38 \wあり/信頼できる
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -413,63 +1306,63 @@
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.nr 82 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(82<\n(38 .nr 82 \n(38
.82
.rm 82
.nr 38 \n(c-
.if \n(82<\n(38 .nr 82 \n(38
.nr 83 0
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wなし
.if \n(83<\n(38 .nr 83 \n(38
-.nr 38 \w
+.nr 38 \wあり
.if \n(83<\n(38 .nr 83 \n(38
.83
.rm 83
.nr 38 \n(d-
.if \n(83<\n(38 .nr 83 \n(38
.nr 84 0
-.nr 38 \w\f3筝号┤\fP
+.nr 38 \w\f3与えられる特権\fP
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤
+.nr 38 \wすべての特権
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤ (1)
+.nr 38 \wすべての特権 (1)
.if \n(84<\n(38 .nr 84 \n(38
-.nr 38 \w鴻号┤ (1)
+.nr 38 \wすべての特権 (1)
.if \n(84<\n(38 .nr 84 \n(38
.84
.rm 84
@@ -503,7 +1396,7 @@
.nr 44 \n(83+(3*\n(38)
.nr 84 +\n(44
.nr TW \n(84
-.if t .if \n(TW>\n(.li .tm Table at line 185 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1078 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -528,7 +1421,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3筝号┤\fP
+\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3与えられる特権\fP
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -565,7 +1458,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -581,7 +1474,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名のない JAR\h'|\n(41u'なし\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -597,7 +1490,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'あり\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -615,7 +1508,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -640,7 +1533,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'\h'|\n(42u'なし\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -663,7 +1556,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'なし\h'|\n(42u'あり\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -679,7 +1572,7 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'あり\h'|\n(43u'あり\h'|\n(44u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -693,15 +1586,15 @@
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'なし\h'|\n(43u'なし\h'|\n(44u'すべての特権
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'あり\h'|\n(43u'なし\h'|\n(44u'すべての特権 (1)
.ta \n(80u \n(81u \n(82u \n(83u \n(84u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
+\&\h'|\n(40u'署名付き JAR\h'|\n(41u'あり/信頼できる\h'|\n(42u'なし\h'|\n(43u'あり\h'|\n(44u'すべての特権 (1)
.fc
.nr T. 1
.T# 1
@@ -724,894 +1617,43 @@
.LP
.LP
-羈 \-
+注 \-
.LP
.RS 3
.TP 3
1.
-激若＜ゃ≪ゃ潟ｃｃ/ュゃ荐翫若鴻≪ゃ潟若激若＜ゃ荐絎筝号┤綽荀障
+ポリシーファイル内にアイデンティティー/別名についての言及がある場合、それをキーストアにインポートして、ポリシーファイルの設定が与えられた特権に反映されるようにする必要があります。
.TP 3
2.
-激若＜ゃ/若鴻≪腟水≪ゃ潟ｃｃ若若帥若劫篆♂若с≪ゃ潟ｃｃ若障
+ポリシーファイル/キーストアの組み合わせは、アイデンティティーデータベース内の信頼できるアイデンティティーよりも優先されます。
.TP 3
3.
-Java 2 若с篆♂若с≪ゃ潟ｃｃ若∴障
+Java 2 プラットフォームでは、信頼できないアイデンティティーは無視されます。
.TP 3
4.
-Java 2 SDK 若鴻≪ゃ潟若с篆♂若с≪ゃ潟ｃｃ若с
-.RE
-
-.LP
-.SS
-若鴻≪ュ
-.LP
-.RS 3
-
-.LP
-.LP
-若鴻≪鴻潟筝ュ篁≪祉鴻障
-.LP
-.LP
-\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁臀峨綽荀泣若鴻≪潟ュ絎綽荀障違罨＜箴working ｃ mystore 若鴻≪障ュ duke ∫ｄ泣篏帥ｃMyJARFile.jar JAR ＜ゃ臀峨篁障阪＜ゃ絎сMyJARFile.jar 臀峨篁 JAR ＜ゃｃ筝吾障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-storepass myspass
-.fl
- \-keypass dukekeypasswd MyJARFile.jar duke
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻≪鴻若т茘激с鴻≪鴻若 (筝箴с mypass) 絎綽荀障潟潟茵с鴻≪鴻若絎鴻若ュ羆障罕泣若鴻√с鴻若ｃ篆茘激泣鴻若 (筝箴с dukekeypasswd) 絎綽荀障 潟潟茵ч泣鴻若絎障絎鴻若篆絖鴻若ｃ翫泣鴻若ュ羆障
-.LP
-.RE
-.SS
-若鴻≪贋
-.LP
-.RS 3
-
-.LP
-.LP
-\f3jarsigner\fP 篏睡若鴻≪ URL 絎 \f2\-keystore\fP 激с潟障若鴻≪с若吟若若ｃ \f2.keystore\fP ＜ゃ主障 若吟若若ｃ\f2user.home\fP 激鴻ｃ若ｃ羆冴障障Solaris 激鴻翫\f2user.home\fP с若吟若若ｃｃ障
-.LP
-.LP
-\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP ＜純羝＜障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP ＜純羝＜障\f2NONE\fP \f2KeyStore\fP ＜ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
-.LP
-.RE
-.SS
-若鴻≪絎茖
-.LP
-.RS 3
-
-.LP
-.LP
-\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
-.LP
-.LP
-憜若鴻≪絎茖篏睡\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若障\f2KeyStore\fP public 篏睡純сJava 2 SDK 若吟若 KeyStore 篏帥ｃ祉祉ャｃ若≪宴若激с潟篏с障
-.LP
-.LP
-若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪＜ゃ絎茖障絎茖с泣ャ鴻若ｃ篆茘激若鴻√篏翫с (泣ャ) 鴻若ｃ篆茘激障
-.LP
-.LP
-若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface ＜純絎臂障 ＜純ゃ絎茖違障сゃJava Security API ｃ≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сｃ若鴻≪絎茖箴
-.na
-\f2Java 垸≪若ｃ主ゃ絎茖号\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
-.LP
-.LP
-≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance ＜＜純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
-.LP
-.LP
-\f3keytool\fP 篁紙＜ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝＜若鴻≪贋＜ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
-.LP
-.LP
-\f3jarsigner\fP \f3keytool\fP 翫\f2\-storetype\fP 激с潟篏帥ｃ潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP 翫[Edit] ＜ャ若 [Change Keystore] 潟潟篏帥ｃ若鴻≪帥ゃ絎с障
-.LP
-.LP
-若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャｃ若ｃ若＜ゃф絎 \f2keystore.type\fP ｃ若ゃ冴ャ若鴻≪絎茖御障祉ャｃ若ｃ若＜ゃ\f2java.security\fP SDK 祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
-.LP
-.LP
-若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
-.LP
-.LP
-\f2KeyStore\fP 鴻с \f2getDefaultType\fP static ＜純絎臂≪宴若激с潟≪＜純篏帥 \f2keystore.type\fP ｃ若ゃ緇с障罨＜潟若若鴻≪帥ゃ (\f2keystore.type\fP ｃ若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
-.LP
-.nf
-\f3
-.fl
- KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャｃ若ｃ若＜ゃ罨＜茵ｃ絎障
-.LP
-.nf
-\f3
-.fl
- keystore.type=jks
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
-.LP
-.LP
-若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨＜紊眼障
-.LP
-.nf
-\f3
-.fl
- keystore.type=pkcs12
-.fl
-\fP
-.fi
-
-.LP
-.LP
-PKCS#11 ゃ宴若吾篏睡翫荅括完ゃJava PKCS#11 Reference Guide
-.na
-\f2KeyTool and JarSigner\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner膀с
-.LP
-.RE
-.RE
-.SS
-泣若≪眼冴
-.LP
-.RS 3
-
-.LP
-.LP
-с\f3jarsigner\fP 罨＜＜≪眼冴篏帥ｃ JAR ＜ゃ臀峨障
-.LP
-.RS 3
-.TP 2
-o
-SHA\-1 ゃ吾с鴻≪眼冴篏帥ｃ DSA (吾帥臀峨≪眼冴)
-.TP 2
-o
-MD5 ゃ吾с鴻≪眼冴篏帥ｃ RSA ≪眼冴
+Java 2 SDK キーストアにインポートできるのは、信頼できるアイデンティティーだけです。
.RE
.LP
-.LP
-隙臀峨泣泣 DSA 泣с翫\f3jarsigner\fP SHA1withDSA ≪眼冴篏帥ｃ JAR ＜ゃ臀峨篁障臀峨泣 RSA 泣с翫\f3jarsigner\fP MD5withRSA ≪眼冴篏帥ｃ JAR ＜ゃ臀峨篁障
-.LP
-.LP
-臀峨≪眼冴\f2\-sigalg\fP 激с潟篏帥ｃ若若ゃс障
-.LP
-.RE
-.SS
-臀峨篁 JAR ＜ゃ
-.LP
-.RS 3
-
-.LP
-.LP
-\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁翫阪臀峨篁 JAR ＜ゃュ JAR ＜ゃс罨＜ 2 ゃ菴遵＜ゃ META\-INF ｃ臀鴻違障
-.LP
-.RS 3
-.TP 2
-o
-.SF ≦宍絖篁臀峨＜ゃ
-.TP 2
-o
-.DSA ≦宍絖篁臀峨＜ゃ
-.RE
-
-.LP
-.LP
- 2 ゃ＜ゃ若鴻＜ゃ\f2\-sigFile\fP 激с潟ゃ篏障違罨＜激с潟絎障
-.LP
-.nf
-\f3
-.fl
- \-sigFile MKSIGN
-.fl
-\fP
-.fi
-
-.LP
-.LP
-翫＜ゃ MKSIGN.SF MKSIGN.DSA 障
-.LP
-.LP
-潟潟茵 \f2\-sigfile\fP 激с潟絎ｃ翫.SF ＜ゃ .DSA ＜ゃ若鴻＜ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨＜ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀＜ゃ篏障篏睡с絖≪＜医筝膩 (_)ゃ潟с
-.LP
-\f3臀峨 (.SF) ＜ゃ\fP
-.LP
-.RS 3
-
-.LP
-.LP
-臀峨＜ゃ (.SF ＜ゃ) \f3jarsigner\fP х讐篁 JAR ＜ゃ絽吾障с鴻＜ゃ篌若障ゃ障с鴻＜ゃ罕.SF ＜ゃJAR ＜ゃ障純若鴻＜ゃ罨＜ 3 ゃ茵障
-.LP
-.RS 3
-.TP 2
-o
-＜ゃ
-.TP 2
-o
-篏帥ゃ吾с鴻≪眼冴 (SHA)
-.TP 2
-o
-SHA ゃ吾с鴻
-.RE
-
-.LP
-.LP
-с鴻＜ゃсSHA ゃ吾с鴻ゃ純若鴻＜ゃゃ若帥ゃ吾с鴻 (激) с筝鴻.SF ＜ゃс純若鴻＜ゃゃ吾с鴻ゃс鴻＜ゃ筝荅峨純若鴻＜ゃ絲上 3 茵激ャс
-.LP
-.LP
-臀峨＜ゃсс鴻＜ゃ篏激ャ障障緇菴違JAR ＜ゃ罎荐若ц若絖ｃ罎荐若純ｃ障
-.LP
-.RE
-\f3臀峨 (.DSA) ＜ゃ\fP
-.LP
-.RS 3
-
-.LP
-.LP
-.SF ＜ゃ臀峨篁臀峨 .DSA ＜ゃ臀障.DSA ＜ゃ若鴻≪荐惹吾障荐惹吾с若潟膃垸綵≪у障障 荐惹吾障荐惹吾с若潟臀峨篏帥泣絲上泣茯荐若障
-.LP
-.RE
-.RE
-.SS
-臀峨帥ゃ鴻帥潟
-.LP
-.RS 3
-
-.LP
-.LP
-J2SE 5.0 若鴻 \f2jarsigner\fP 若JAR ＜ゃ臀峨臀峨帥ゃ鴻帥潟恰主с障\f2jarsigner\fP 篁ｆ睡讐罘罕泣若障篏ュ純с臀峨罨＜激с潟ｃ九勝障
-.LP
-.RS 3
-.TP 2
-o
-\f2\-tsa url\fP
-.TP 2
-o
-\f2\-tsacert alias\fP
-.TP 2
-o
-\f2\-altsigner class\fP
-.TP 2
-o
-\f2\-altsignerpath classpathlist\fP
-.RE
-
-.LP
-.LP
-激с潟荅括完ゃ緇菴違激с潟膀с
-.LP
-.RE
-.SS
-JAR ＜ゃ罎荐
-.LP
-.RS 3
-
-.LP
-.LP
-JAR ＜ゃ罎荐若臀峨鴻сょ讐篁ュ JAR ＜ゃ＜ゃ紊眼翫сJAR ＜ゃ罎荐若罨＜ц障
-.LP
-.RS 3
-.TP 3
-1.
-.SF ＜ゃ篏臀峨罎荐若障
-.LP
-с臀峨 (.DSA) ＜ゃ主臀峨絎泣絲上泣篏帥ｃс腆肴障 .DSA ＜ゃ泣荐惹 (障荐惹吾с若) 障障障с臀峨絲上臀峨 (.SF) ＜ゃ鴻臀峨с茯帥鴻.SF ＜ゃ劫腆肴障
-.TP 3
-2.
-.SF ＜ゃ潟ゃ吾с鴻с鴻絲上祉激с潟腦罎荐若障
-.LP
-.SF ＜ゃс鴻＜ゃ篏激ャ主若у障障若絖翫弱激ャ絎с鴻＜ゃ激ャ筝眼罎荐若с障激ャ筝眼翫罨＜蚊帥障
-.LP
-激ャ筝眼翫合ｃ号篏帥ｃ罎荐若茵障 隙.SF ＜ゃ純若鴻＜ゃ宴祉激с潟激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼腆肴障 (臀峨 (.SF) ＜ゃ)
-.LP
-.SF ＜ゃ若主с鴻＜ゃ激ャ絎с鴻＜ゃ激ャ筝眼翫臀峨 ( .SF ＜ゃ) 緇JAR ＜ゃ 1 や札筝＜ゃ菴遵 (\f2jar\fP 若篏睡) 醇с障\f2jar\fP 若篏帥ｃ＜ゃ菴遵翫с鴻＜ゃ紊眼障 (違＜ゃ祉激с潟菴遵).SF ＜ゃ紊眼障翫.SF ＜ゃ寂札紊祉激с潟主激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼臀峨 JAR ＜ゃ絖＜ゃ＜＜ゃ紊眼罎荐若宴障
-.TP 3
-3.
-JAR ＜ゃ＜ゃ＜.SF ＜ゃ潟ゅ＜ゃ茯粋昭帥障茯粋昭推賢＜ゃゃ吾с鴻荐膊腟с鴻祉激с喝荅峨＜ゃゃ吾с鴻罸莠障2 ゃゃ吾с鴻с違с翫罎荐若紊掩障
-.RE
-
-.LP
-.LP
-罎荐若祉鴻筝с紊с罎荐若若榊翫罎荐若祉鴻筝罩≪祉ャｃ寂紊鴻若障鴻若祉ャｃ寂紊\f3jarsigner\fP ｃ茵腓冴障
-.LP
-.RE
-.SS
-1 ゃ JAR ＜ゃ絲乗院茲違臀峨
-.LP
-.RS 3
-
-.LP
-.LP
-1 ゃ JAR ＜ゃ絲障 \f3jarsigner\fP 若茲医絎茵絎茵潟違若吟若ュ絎違JAR ＜ゃ茲違若吟若臀峨篁с障
-.LP
-.nf
-\f3
-.fl
- jarsigner myBundle.jar susan
-.fl
- jarsigner myBundle.jar kevin
-.fl
-\fP
-.fi
-
-.LP
-.LP
-JAR ＜ゃ茲医臀峨翫 JAR ＜ゃ .SF ＜ゃ .DSA ＜ゃ絲障茲医障障 .SF ＜ゃ .DSA ＜ゃ絲障1 臀峨絲障 1 や障ｃ筝箴у阪 JAR ＜ゃ罨＜ゃ＜ゃ障障
-.LP
-.nf
-\f3
-.fl
- SUSAN.SF
-.fl
- SUSAN.DSA
-.fl
- KEVIN.SF
-.fl
- KEVIN.DSA
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈:JAR ＜ゃсJDK 1.1 \f3javakey\fP 若х臀峨 \f3jarsigner\fP х臀峨羞桁с障ゃ障с \f3javakey\fP 篏帥ｃ臀峨篁 JAR ＜ゃ\f3jarsigner\fP 篏帥ｃ臀峨篁с障
-.LP
-.RE
-.SH "激с"
-.LP
-
-.LP
-.LP
-篁ヤс\f3jarsigner\fP 激с潟ゃ茯障羈:
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-激с喝ゃ壕 (\-) 篁
-.TP 2
-o
-激с潟篁紙綺ф絎с
-.TP 2
-o
-ゃ帥篏絎 (激с潟) 若吟若絎綽荀
-.TP 2
-o
-\f2\-keystore\fP\f2\-storepass\fP\f2\-keypass\fP\f2\-sigfile\fP\f2\-sigalg\fP\f2\-digestalg\fP \f2\-signedjar\fP 激с潟篏睡сJAR ＜ゃ臀峨篁翫с 激с潟JAR ＜ゃ罎荐若翫篏睡с罕ュ潟潟茵ф絎JAR ＜ゃ臀峨篁翫с
-.RE
-
-.LP
-.RS 3
-.TP 3
-\-keystore url
-若鴻≪贋腓冴 URL 絎障若吟若若ｃ＜ゃ \f2.keystore\fP с 若吟若若ｃuser.home 激鴻ｃ若ｃ羆冴障障
-.LP
-臀峨若鴻≪綽荀с 若鴻≪絖翫篁ュ祉若鴻≪篏睡翫若鴻≪腓榊絎綽荀障
-.LP
-罎荐若若鴻≪綽荀障 若鴻≪絎若鴻≪絖 \f2\-verbose\fP 激с潟絎翫JAR ＜ゃ罎荐若篏帥荐惹吾若鴻≪絖ゃ菴遵宴阪障
-.LP
-羈:\f2\-keystore\fP 綣違URL 篁ｃ＜ゃ () 絎с障 ＜ゃ () 絎翫file:URL 宴障違罨＜絎с障
-.nf
-\f3
-.fl
- \-keystore \fP\f4filePathAndName\fP\f3
-.fl
-\fP
-.fi
-罨＜絎宴障
-.nf
-\f3
-.fl
- \-keystore file:\fP\f4filePathAndName\fP\f3
-.fl
-\fP
-.fi
-JRE \f2$JAVA_HOME/lib/security\fP ｃ主 \f2java.security\fP 祉ャｃ若ｃ若＜ゃ Sun PKCS#11 ゃ荐絎翫keytool jarsigner PKCS#11 若潟冴ャ篏с障 罨＜激с潟絎障
-.RS 3
-.TP 2
-o
-\f2\-keystore NONE\fP
+jar(1) ツールのドキュメント
.TP 2
o
-\f2\-storetype PKCS11\fP
-.RE
-違罨＜潟潟荐絎 PKCS#11 若潟絎鴻筝荀ц；腓冴障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore NONE \-storetype PKCS11 \-list
-.fl
-
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-storetype storetype
-ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障若鴻≪帥ゃ祉ャｃ若ｃ若＜ゃ keystore.type ｃ若ゃф絎帥ゃс ゃ\f2java.security.KeyStore\fP static \f2getDefaultType\fP ＜純у緇с障
-.LP
-\f2\-storepass\fP 激с潟篏帥ｃ PCKS#11 若潟 PIN 絎с障篏絎ｃ翫keytool jarsigner 若吟若若 PIN ュ羆障若潟篆茘激茯荐若 (絨 PIN 篏茯水罘) 翫\f2\-protected\fP 激с潟絎綽荀障鴻若激с潟絎綽荀障
-.TP 3
-\-storepass password
-若鴻≪≪祉鴻綽荀鴻若絎障激с潟綽荀JAR ＜ゃ臀峨篁с (JAR ＜ゃ罎荐若筝荀)臀峨篁潟潟茵 \f2\-storepass\fP 激с潟絎ｃ翫鴻若ュ羆障
-.LP
-羈:鴻翫障祉ャｃ寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
-.TP 3
-\-keypass password
-潟潟茵ф絎ュ絲上若鴻≪潟泣篆茘激篏帥鴻若絎障\f3jarsigner\fP 篏帥ｃ JAR ＜ゃ臀峨篁鴻若綽荀с潟潟茵с鴻若絎綽荀鴻若鴻≪鴻若違翫鴻若ュ羆障
-.LP
-羈:鴻翫障祉ャｃ寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
-.TP 3
-\-sigfile file
-.SF ＜ゃ .DSA ＜ゃ篏帥若鴻＜ゃ絎障違\f2file\fP DUKESIGN 絎 .SF ＜ゃ .DSA ＜ゃ DUKESIGN.SF DUKESIGN.DSA 障 ＜ゃ臀峨篁 JAR ＜ゃ META\-INF ｃ臀障
-.LP
-\f2file\fP 篏睡с絖a\-zA\-Z0\-9_\-сゃ障絖医筝膩潟ゃ潟篏睡с障羈:.SF .DSA ＜ゃс絨絖鴻紊ф絖紊障
-.LP
-潟潟茵 \f2\-sigfile\fP 激с潟絎ｃ翫.SF ＜ゃ .DSA ＜ゃ若鴻＜ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨＜ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀＜ゃ篏障
-.TP 3
-\-sigalg algorithm
-.RS 3
-
-.LP
-JAR ＜ゃ臀峨篏睡臀峨≪眼冴絎障
-.LP
-罔羣臀峨≪眼冴筝荀сゃJava Cryptography Architecture
-.na
-\f2Appendix A \fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс≪眼冴JAR ＜ゃ臀峨篏睡腱絲泣篋сс違障激с潟絎ｃ翫腱絲泣帥ゃ綽 SHA1withDSAMD5withRSA 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥ｃ絎綽荀障 с翫潟潟絎茵紊掩障
-.LP
-.RE
-.TP 3
-\-digestalg algorithm
-.RS 3
-JAR ＜ゃ潟ゃ吾с鴻篏睡＜祉若吾ゃ吾с鴻≪眼冴絎障
-.LP
-罔羣＜祉若吾ゃ吾с鴻≪眼冴筝荀сゃJava Cryptography Architecture
-.na
-\f2Appendix A \fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс激с潟絎ｃ翫SHA\-1 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥ｃ絎綽荀障 с翫潟潟絎茵紊掩障
-.LP
-.RE
-.TP 3
-\-signedjar file
-臀峨篁 JAR ＜ゃ絎障
-.LP
-潟潟茵у絎ｃ翫ュ JAR ＜ゃ (臀峨絲乗院 JAR ＜ゃ) 篏帥障 翫ュ JAR ＜ゃ臀峨篁 JAR ＜ゃｃ筝吾障
-.TP 3
-\-verify
-潟潟茵с激с潟絎翫絎 JAR ＜ゃ罎荐若障JAR ＜ゃ吾臀峨茵障 罎荐若jar 罎荐若障 ＜祉若吾茵腓冴障臀峨 JAR ＜ゃ障泣若≪眼冴 (RSA ゃゃ潟鴻若腟篋翫 RSA ) 篏帥ｃ臀峨 JAR ＜ゃ罎荐若jar 臀峨障(臀峨荀ゃ罕茹ｆс障)＜祉若吾茵腓冴障
-.LP
-臀峨篁 JAR ＜ゃ\f3jarsigner\fP 障 JDK 1.1 \f3javakey\fP 若筝≧鴻篏帥ｃ罎荐若с障
-.LP
-罎荐若ゃ荅括完JAR ＜ゃ罎荐若с
-.TP 3
-\-certs
-潟潟茵с\f2\-verify\fP \f2\-verbose\fP 激с潟激с潟絎翫JAR ＜ゃ臀峨荐惹御宴阪障荐惹御宴罨＜障障
-.RS 3
-.TP 2
-o
-臀峨泣荐惹 (.DSA ＜ゃ主) 荐惹吾腮蕁
-.TP 2
-o
-荐惹吾 X.509 荐惹 (ゃ障\f2java.security.cert.X509Certificate\fP ゃ潟鴻帥潟) с翫臀峨茘ュ
-.RE
-.LP
-若鴻≪腆肴茵障潟潟茵с若鴻≪ゃ絎翫若鴻≪＜ゃ違罎祉障臀峨泣荐惹吾若鴻√潟筝眼翫罨＜宴茵腓冴障
-.RS 3
+keytool(1) ツールのドキュメント
.TP 2
o
-臀峨荅峨若鴻≪潟ュ ュ綣су蚊障障若鴻≪с JDK 1.1 ≪ゃ潟ｃｃ若若帥若鴻掩ャ臀峨翫綣сс鎀ф綣су蚊障障
-.RE
-.TP 3
-\-verbose
-潟潟茵с激с潟絎翫\f3jarsigner\fP 激≪若у篏JAR 臀峨障罎荐若画倶≪菴遵宴阪障
-.TP 3
-\-internalsf
-篁ュJAR ＜ゃ臀峨 .DSA (臀峨) ＜ゃ筝 .SF ＜ゃ (臀峨＜ゃ) 絎潟若膃垸綵≪у障障篏紊眼障篏紊眼憜с阪 JAR ＜ゃ篏泣ゃ冴絨с .SF ＜ゃ .DSA ＜ゃ障ｃ障潟潟茵 \f2\-internalsf\fP 激с潟絎篁ュ篏障\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
-.TP 3
-\-sectionsonly
-潟潟茵с激с潟絎翫JAR ＜ゃ臀峨 .SF ＜ゃ (臀峨＜ゃ) с鴻＜ゃ篏激ャ若菴遵障翫.SF ＜ゃ障JAR ＜ゃ純若鴻＜ゃ≪宴潟激ャс 荅括完臀峨 (.SF) ＜ゃс
-.LP
-с茵с鴻＜ゃ篏激ャ若菴遵障若絖翫JAR ＜ゃ罎荐惹障弱激ャс鴻＜ゃ篏激ャ絎筝眼腆肴障激ャ筝眼翫罎荐若罨＜蚊帥障激ャ筝眼翫合ｃ号篏帥ｃ罎荐若茵障 隙.SF ＜ゃ純若鴻＜ゃ宴祉激с潟激ャс鴻＜ゃ絲上祉激с潟激ャ筝眼腆肴障
-.LP
-荅括完JAR ＜ゃ罎荐若с
-.LP
-\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
-.TP 3
-\-protected
-\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
-.RE
-.RS 3
-.TP 3
-\-provider provider\-class\-name
-泣若鴻ゃ祉ャｃ若ｃ若＜ゃ (\f2java.security\fP) 鴻ャｃ垸泣若鴻ゃ鴻帥若鴻＜ゃ絎障
-.LP
-\f2\-providerArg\fP \f2ConfigFilePath\fP 激с潟腟水篏睡障 keytool jarsigner ゃゃ潟鴻若障 (с\f2ConfigFilePath\fP 若活┃絎＜ゃ吾鴻с)祉ャｃ若ｃ若＜ゃ Sun PKCS#11 ゃ荐絎翫 PKCS#11 若鴻≪筝荀ц；腓冴潟潟箴罨＜腓冴障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
-jarsigner \-keystore NONE \-storetype PKCS11 \\
-.fl
- \-providerClass sun.security.pkcs11.SunPKCS11 \\
-.fl
- \-providerArg /foo/bar/token.config \\
-.fl
- \-list
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-providerName providerName
-\f2java.security\fP 祉ャｃ若ｃ若＜ゃ 2 や札筝ゃ荐絎翫\f2\-providerName\fP 激с潟篏帥ｃ劫ゃゃ潟鴻帥潟鴻御с障激с潟綣違ゃс
-.LP
-Sun PKCS#11 ゃ翫\f2providerName\fP \f2SunPKCS11\-\fP\f2TokenName\fP 綵√障 с\f2TokenName\fPゃゃ潟鴻帥潟鴻罕･絨乗с 荅括完
.na
-\f2罕絮с茵\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSс違篁ヤ潟潟с･絨乗 \f2SmartCard\fP PKCS#11 若鴻≪ゃゃ潟鴻帥潟鴻絎鴻鴻障
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
-jarsigner \-keystore NONE \-storetype PKCS11 \\
-.fl
- \-providerName SunPKCS11\-SmartCard \\
-.fl
- \-list
-.fl
-\fP
-.fi
-.RE
-.TP 3
-\-Jjavaoption
-絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋･羝＜障(\f3jarsigner\fP 絎 Java ゃ潟帥帥絲障若с激с潟腥榊純с障激с潟絎茵医障＜≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц；腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
-.LP
-.TP 3
-\-tsa url
-JAR ＜ゃ臀峨潟潟茵\f2\-tsa http://example.tsa.url\fP茵腓冴翫臀峨帥ゃ鴻帥潟障URL \f2http://example.tsa.url\fP TSA (Time Stamping Authority) 贋劫障\f2\-tsacert\fP 激с潟ф冴 URL 若若ゃ障\f2\-tsa\fP 激с潟сTSA 笈┝吾若鴻≪臀綽荀障
-.LP
-帥ゃ鴻帥潟\f2jarsigner\fP
-.na
-\f2RFC 3161\fP @
-.fi
-http://www.ietf.org/rfc/rfc3161.txt у臂 TSP (Time\-Stamp Protocol) 篏睡 TSA 篆＜障TSA 菴帥ゃ鴻帥潟若潟臀峨＜ゃ臀峨篆絖障
-.LP
-.TP 3
-\-tsacert alias
-JAR ＜ゃ臀峨潟潟茵\f2\-tsacert alias\fP茵腓冴翫臀峨帥ゃ鴻帥潟障\f2alias\fP 若鴻√憜鴻 TSA 笈┝吾劫障潟荐惹吾сTSA 贋劫 URL Subject Information Access ≦宍罘純腆肴障
-.LP
-TSA 笈┝吾\f2\-tsacert\fP 篏帥ｃ翫若鴻≪臀綽荀障
-.LP
-.TP 3
-\-altsigner class
-篁ｆ睡讐罘罕篏睡絎障絎篆蕋障劫\f2com.sun.jarsigner.ContentSigner\fP abstract 鴻≦宍鴻＜ゃ劫障鴻＜ゃ吾鴻\f2\-altsignerpath\fP 激с潟ｃ絎臂障\f2\-altsigner\fP 激с潟篏睡翫\f2jarsigner\fP 絎鴻箴臀峨罘罕篏睡障障\f2jarsigner\fP 臀峨罘罕篏睡障
-.LP
-違\f2com.sun.sun.jarsigner.AuthSigner\fP 鴻箴臀峨罘罕篏睡\f2jarsigner\fP 激с潟\f2\-altsigner com.sun.jarsigner.AuthSigner\fP篏睡障
-.LP
-.TP 3
-\-altsignerpath classpathlist
-鴻＜ゃ (鴻＜ゃ筝荐 \f2\-altsigner\fP 激с潟ф絎) 潟箴絖 JAR ＜ゃ吾鴻絎障鴻＜ゃ JAR ＜ゃ翫篁ヤ箴 JAR ＜ゃ吾鴻絎障
-.LP
-腟九障鴻障憜ｃ後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR ＜ゃс障 翫鴻障 JAR ＜ゃSolaris 翫潟 (\f2:\fP)Windows 翫祉潟 (\f2;\fP) у阪障鴻с罎膣≪劫翫激с潟筝荀с
-.LP
-鴻＜ゃJAR ＜ゃ吾鴻絎箴腓冴障
-.RS 3
-
-.LP
-.LP
-\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
-.LP
-.RE
-.LP
-JAR ＜ゃ障羈
-.LP
-鴻＜ゃ JAR ＜ゃ吾鴻絎箴腓冴障
-.RS 3
-.LP
-\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
-.LP
-.RE
-.LP
-JAR ＜ゃ障
-.RE
-.SH "箴"
-.LP
-
-.LP
-.SS
-JAR ＜ゃ臀峨
-.LP
-.RS 3
-
-.LP
-.LP
-bundle.jar JAR ＜ゃ障 ＜ゃ若鴻≪ュ jane с若吟若泣篏帥ｃ臀峨篁障若鴻≪mystore сC ゃ working ｃ若鴻≪鴻若 mypass\f2jane\fP 泣鴻若 j638klm 障翫罨＜潟潟絎茵JAR ＜ゃ臀峨篁 sbundle.jar 臀峨篁 JAR ＜ゃ篏с障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-storepass myspass
-.fl
- \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-筝潟潟с \f2\-sigfile\fP 激с潟絎臀峨篁 JAR ＜ゃ主 .SF ＜ゃ .DSA ＜ゃュゃ障ゃ障\f2JANE.SF\fP \f2JANE.DSA\fP 障
-.LP
-.LP
-鴻≪鴻若泣鴻若уュ翫筝潟潟膰罨＜ュс障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore
-.fl
- \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-若鴻 (若ｃ .keystore 若鴻) 篏睡翫罨＜腓冴若鴻≪絎ャс障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-signedjar sbundle.jar bundle.jar jane
-.fl
-\fP
-.fi
-
-.LP
-.LP
-障臀峨篁 JAR ＜ゃуュ JAR ＜ゃ (\f2bundle.jar\fP) 筝吾翫\f2\-signedjar\fP 激с潟絎ャс障
-.LP
-.nf
-\f3
-.fl
- jarsigner bundle.jar jane
-.fl
-\fP
+\f4jarsigner\fP\f2 ツールの使用例については、\fP @
.fi
-.RE
-
-.LP
-.SS
-臀峨篁 JAR ＜ゃ罎荐
-.LP
-.RS 3
-
-.LP
-.LP
-罨＜腓冴臀峨篁 JAR ＜ゃ罎荐若臀峨鴻 JAR ＜ゃ劫腆肴潟潟箴с
-.LP
-.nf
-\f3
-.fl
- jarsigner \-verify sbundle.jar
-.fl
-\fP
-.fi
-
-.LP
-.LP
-罎荐若罨＜＜祉若吾茵腓冴障
-.LP
-.nf
-\f3
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-＜祉若吾茵腓冴障罎荐若ｃ翫若＜祉若吾茵腓冴障
-.LP
-.LP
-\f2\-verbose\fP 激с潟篏帥紊宴茵腓冴障罨＜腓冴\f2\-verbose\fP 激с潟絎 \f3jarsigner\fP 絎茵箴阪腟с
-.LP
-.nf
-\f3
-.fl
- jarsigner \-verify \-verbose sbundle.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
-.fl
- smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
+http://download.oracle.com/javase/tutorial/index.html
+.na
+\f2「Java チュートリアル」\fP\f4の\fP @
.fi
-
-.LP
-.SS
-荐惹御宴篏帥ｃ罎荐
-.LP
-.LP
-罎荐惹\f2\-verify\fP \f2\-verbose\fP 激с潟 \f2\-certs\fP 激с潟絎翫JAR ＜ゃ臀峨荐惹御宴阪障 荐惹吾帥ゃ臀峨茘ュ (X.509 荐惹吾翫) JAR ＜ゃ泣荐惹吾若鴻≪潟泣荐惹吾筝眼翫綣су蚊障臀峨若鴻√ュ障障罨＜箴腓冴障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
-.fl
- 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
-.fl
- smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
-.fl
-
-.fl
- X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
-.fl
- X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-臀峨荐惹吾 X.509 荐惹吾с翫茘ュ宴茵腓冴障翫荐惹吾帥ゃュ茵腓冴障違荐惹吾 PGP 荐惹吾сュ bob 翫罨＜茵腓冴障
-.LP
-.nf
-\f3
-.fl
- PGP, (bob)
-.fl
-\fP
-.fi
-
-.LP
-.SS
-≪ゃ潟ｃｃ若若帥若鴻臀峨 JAR ＜ゃ罎荐
-.LP
-.LP
-JAR ＜ゃJDK 1.1 \f3javakey\fP 若篏帥ｃ臀峨翫臀峨≪ゃ潟ｃｃ若若帥若劫ュс 翫罎荐若阪 i 荐垩障障JAR ＜ゃ≪ゃ潟ｃｃ若若帥若劫ュ若鴻√ュ筝≧鴻ｃ臀峨翫k i 筝≧鴻茵腓冴障
-.LP
-.LP
-\f2\-certs\fP 激с潟絎翫若鴻≪ュ綣су蚊障絲障≪ゃ潟ｃｃ若若帥若劫ュ茹綣су蚊障茵腓冴障箴腓冴障
-.LP
-.nf
-\f3
-.fl
- jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
-.fl
-
-.fl
- 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
-.fl
- 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
-.fl
- 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
-.fl
- 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
-.fl
- 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
-.fl
- smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
-.fl
-
-.fl
- X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
-.fl
- X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
-.fl
-
-.fl
- s = 臀峨罎荐若障
-.fl
- m = 潟с鴻鴻障
-.fl
- k = 1 や札筝荐惹吾若鴻≪ф冴障
-.fl
- i = 1 や札筝荐惹吾≪ゃ潟ｃｃ若鴻潟若ф冴障
-.fl
-
-.fl
- jar 罎荐若障
-.fl
-\fP
-.fi
-
-.LP
-.LP
-ュ duke 茹綣су蚊障сュ若鴻≪ュс≪ゃ潟ｃｃ若若帥若鴻ュс
-.LP
-.RE
-.SH "∫ｉ"
-.LP
-
-.LP
-.RS 3
-.TP 2
-o
-jar(1) 若ャ＜潟
-.TP 2
-o
-keytool(1) 若ャ＜潟
-.TP 2
-o
-\f3jarsigner\fP 若篏睡箴ゃ
-.na
-\f4Java Tutorial\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/index.html
-.na
-\f4Security\fP @
-.fi
-http://java.sun.com/docs/books/tutorial/security/index.html
+http://download.oracle.com/javase/tutorial/index.html「Security」\f3を参照\fP
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/java.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/java.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,29 +19,29 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH java 1 "02 Jun 2010"
+.TH java 1 "14 Apr 2011"
.LP
-.SH ""
-java \- Java ≪宴若激с活儀若
+.SH "名前"
+java \- Java アプリケーション起動ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
+.SH "形式"
.LP
.nf
\f3
@@ -54,88 +54,78 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
class
-若喝冴鴻
+呼び出されるクラスの名前
.TP 3
file.jar
-若喝冴 JAR ＜ゃ綽 \f2\-jar\fP 篏睡
+呼び出される JAR ファイルの名前。必ず \f2\-jar\fP とともに使用する
.TP 3
argument
-\f3main\fP ∽違羝＜綣
+\f3main\fP 関数に渡される引数
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3java\fP 若Java ≪宴若激с潟莎桁障java 若Java Runtime Environment 莎桁絎鴻若鴻 \f3main\fP ＜純若喝冴Java ≪宴若激с潟莎桁障
+\f3java\fP ツールは、Java アプリケーションを起動します。java ツールは、Java Runtime Environment を起動したあと、指定されたクラスをロードし、そのクラスの \f3main\fP メソッドを呼び出すことにより、Java アプリケーションを起動します。
.LP
.LP
-＜純public static 絎ｈ綽荀障 障ゃ菴障 \f2String\fP ＜若帥絎с違障＜純絎ｈ罨＜ｃ違障
+このメソッドは、public および static として宣言する必要があります。 また、値を返してはいけません。 さらに、 \f2String\fP 配列をパラメータとして指定できなければなりません。メソッドの宣言は、次のようになっていなければなりません。
.LP
.nf
\f3
.fl
- public static void main(String args[])
+public static void main(String args[])
.fl
\fP
.fi
.LP
.LP
-с潟潟茵激с割札紊綣違若喝冴鴻障絎絎劫篏睡綽荀障\f3\-jar\fP 激с潟絎翫潟潟茵激с割札紊綣違≪宴若激с潟鴻＜ゃ純若鴻＜ゃ \f3JAR\fP ≪若ゃ障 翫с鴻 \f3Main\-Class\fP 若ф絎鴻莎桁鴻障
+デフォルトでは、コマンド行オプション以外の最初の引数が、呼び出されるクラスの名前になります。この名前には、完全指定のクラス名を使用する必要があります。\f3\-jar\fP オプションを指定した場合、コマンド行オプション以外の最初の引数が、アプリケーションのクラスファイルとリソースファイルを含む \f3JAR\fP アーカイブの名前になります。この場合、マニフェストの \f3Main\-Class\fP ヘッダーで指定されたクラスが起動クラスになります。
.LP
.LP
-Java Runtime 若鴻鴻鴻ゃ潟鴻若≦宍罘純潟若吟若鴻鴻 3 膊莎桁鴻篁篏睡鴻罎膣≪障
+Java Runtime は、ブートストラップクラスパス、インストール型拡張機能、およびユーザークラスパスの 3 箇所から起動クラスと他の使用されているクラスを検索します。
.LP
.LP
-劫障 JAR ＜ゃ潟潟茵激с割札紊綣違\f3main\fP ∽違羝＜障
+クラス名または JAR ファイル名のあとにある、コマンド行オプション以外の引数は、\f3main\fP 関数に渡されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-莎桁若憜絎茵医喝ャ若鴻с泣若罔羣激с潟障障篁潟激潟憜絎茖с罔羣激с潟祉泣若障 絨ャ若鴻у眼醇с障
+起動ツールには、現在の実行環境および将来のリリースでサポートされる標準オプションがあります。また、仮想マシンの現在の実装では、非標準オプションのセットもサポートされます。これは、将来のリリースで変更される可能性があります。
.LP
-.SH "罔羣激с"
-.LP
-
+.SH "標準オプション"
.LP
.RS 3
.TP 3
\-client
.LP
-Java HotSpot Client VM 御障64 絲上 JDK 憝鴻с激с潟∴篁ｃ Java Hotspot Server VM 篏睡障
+Java HotSpot Client VM を選択します。64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。
.LP
- VM 御ゃ
+デフォルトの VM の選択については、
.na
-\f2泣若 \- 鴻激潟罎冴\fP @
+\f2「サーバー \- クラスマシンの検出」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。
.TP 3
\-server
.LP
-Java HotSpot Server VM 御障64 絲上 JDK 筝с泣若 Java Hotspot Server VM с\-server 激с潟藥御障
+Java HotSpot Server VM を選択します。64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。
.LP
- VM 御ゃ
+デフォルトの VM の選択については、
.na
-\f2泣若 \- 鴻激潟罎冴\fP @
+\f2「サーバー \- クラスマシンの検出」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。
.TP 3
\-agentlib:libname[=options]
-ゃｃ若吾с潟ゃ \f2libname\fP 若障 井＜絎障
+ネイティブエージェントライブラリ \f2libname\fP をロードします。たとえば次のように指定します。
.LP
\-agentlib:hprof
.LP
@@ -143,57 +133,57 @@
.LP
\-agentlib:hprof=help
.LP
-荅括完ゃ
+詳細については、
.na
-\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
+\f2「JVMTI エージェントのコマンド行オプション」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
+http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。
.TP 3
\-agentpath:pathname[=options]
-劫篏睡若ｃ若吾с潟ゃ若障荅括完ゃ
+フルパス名を使用して、ネーティブエージェントライブラリをロードします。詳細については、
.na
-\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
+\f2「JVMTI エージェントのコマンド行オプション」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
+http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。
.TP 3
\-classpath classpath
.TP 3
\-cp classpath
-鴻＜ゃ罎膣≪ｃJAR ≪若ゃ ZIP ≪若ゃ鴻絎障鴻鴻潟潟 (\f3:\fP) у阪障\f3\-classpath\fP 障 \f3\-cp\fP 絎激с潟ゃｃ \f3CLASSPATH\fP 医紊違荐絎若若ゃ障
+クラスファイルを検索するディレクトリ、JAR アーカイブ、および ZIP アーカイブのリストを指定します。クラスパスの各エントリはコロン (\f3:\fP) で区切ります。\f3\-classpath\fP または \f3\-cp\fP を指定すると、このオプションの値によって \f3CLASSPATH\fP 環境変数の設定がオーバーライドされます。
.LP
-\f3\-classpath\fP \f3\-cp\fP 篏睡\f3CLASSPATH\fP 荐絎翫若吟若鴻鴻憜ｃ (\f4.\fP) 障
+\f3\-classpath\fP も \f3\-cp\fP も使用されず、\f3CLASSPATH\fP も設定されていない場合、ユーザークラスパスは現在のディレクトリ (\f4.\fP) になります。
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。* だけから成る \f2クラスパスエントリは、\fP カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.LP
-鴻鴻荅括完
+クラスパスの詳細は、
.na
-\f2鴻鴻荐絎\fP @
+\f2「クラスパスの設定」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。
.TP 3
\-Dproperty=value
-激鴻ｃ若ゃ荐絎障
+システムプロパティーの値を設定します。
.TP 3
\-d32
.TP 3
\-d64
- 32 医64 医с違絎茵荀羆障荀羆医ゃ潟鴻若泣若翫若怨障
+それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。
.LP
-憜Java HotSpot Server VM 64 篏泣若\-d64 篏睡 \-server 激с潟藥鴻障ｃ\-d64 篏睡\-client激с潟∴障篁罕絨ャ若鴻с紊眼醇с障
+現在のところ、Java HotSpot Server VM だけが 64 ビットの操作をサポートしており、\-server オプションを使用する場合は、\-d64 も一緒に使用する必要があります。したがって、\-d64 使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。
.LP
-\f3\-d32\fP \f3\-d64\fP ＜絎翫32 医у茵障篁罕絨ャ若鴻с紊眼醇с障
+\f3\-d32\fP と \f3\-d64\fP がどちらも指定されていない場合は、デフォルトとして、32 ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。
.TP 3
-\-enableassertions[:<package name>"..."| :<class name> ]
+\-enableassertions[:<package name>"..." | :<class name> ]
.TP 3
-\-ea[:<package name>"..."| :<class name> ]
-≪泣若激с潟鴻障≪泣若激с潟с≦鴻ｃ障
+\-ea[:<package name>"..." | :<class name> ]
+アサーションを有効にします。アサーションは、デフォルトでは無効になっています。
.LP
-綣違 \f3enableassertions\fP 障 \f3\-ea\fP 絎≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟鴻障綣違\f2...\fP絎憜篏罐ｃ宴若後с≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟鴻障
+引数なしの \f3enableassertions\fP または \f3\-ea\fP を指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが有効になります。
.LP
-筝潟潟茵鴻ゃゃ潟鴻帥潟鴻茲井絎翫絎鴻ゃ鴻若障ｃ違宴若 \f2com.wombat.fruitbat\fP (泣宴若吾) с帥≪泣若激с潟鴻違絎茵罨＜潟潟篏睡障
+単一コマンド行にこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ \f2com.wombat.fruitbat\fP (サブパッケージを含む) 内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。
.nf
\f3
.fl
@@ -202,151 +192,156 @@
\fP
.fi
.LP
-\f3\-enableassertions\fP \f3\-ea\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟鴻ャ鴻ゃ障 \f3\-enablesystemassertions\fP с
+\f3\-enableassertions\fP および \f3\-ea\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを有効にするために、別のスイッチが用意されています。このあとの \f3\-enablesystemassertions\fP を参照してください。
.TP 3
-\-disableassertions[:<package name>"..."| :<class name> ]
+\-disableassertions[:<package name>"..." | :<class name> ]
.TP 3
-\-da[:<package name>"..."| :<class name> ]
-≪泣若激с潟≦鴻障荐絎с
+\-da[:<package name>"..." | :<class name> ]
+アサーションを無効にします。これがデフォルトです。
.LP
-綣違 \f3disableassertions\fP 障 \f3\-da\fP 絎≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟≦鴻障綣違\f2...\fP絎憜篏罐ｃ宴若後с≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟≦鴻障
+引数なしの \f3disableassertions\fP または \f3\-da\fP を指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが無効になります。
.LP
-宴若 \f2com.wombat.fruitbat\fP с≪泣若激с潟鴻 \f2com.wombat.fruitbat.Brickbat\fP с≪泣若激с潟≦鴻с違絎茵罨＜潟潟篏睡障
+パッケージ \f2com.wombat.fruitbat\fP 内ではアサーションを有効にし、クラス \f2com.wombat.fruitbat.Brickbat\fP 内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。
.nf
\f3
.fl
-java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat <Main Class>
+java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat \fP\f4<Main Class>\fP\f3
.fl
\fP
.fi
.LP
-\f3\-disableassertions\fP \f3\-da\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟≦鴻ャ鴻ゃ障 \f3\-disablesystemassertions\fP с
+\f3\-disableassertions\fP および \f3\-da\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを無効にするために、別のスイッチが用意されています。このあとの \f3\-disablesystemassertions\fP を参照してください。
.TP 3
\-enablesystemassertions
.TP 3
\-esa
-鴻激鴻劫с≪泣若激с潟鴻障 ゃ障激鴻鴻ゃ≪泣若激с潟鴻若帥鴻 \f2true\fP 荐絎障
+すべてのシステムクラス内でアサーションを有効にします。つまり、システムクラスについてアサーションのデフォルトステータスを \f2true\fP に設定します。
.TP 3
\-disablesystemassertions
.TP 3
\-dsa
-鴻激鴻劫с≪泣若激с潟≦鴻障
-.LP
+すべてのシステムクラス内でアサーションを無効にします。
.TP 3
\-jar
-JAR ＜ゃ祉違絎茵障綣違莎桁鴻сJAR ＜ゃ障激с潟罘純JAR ＜ゃс鴻\f3Main\-Class:\fP\f4classname\fP\f3\fP綵√茵絎綽荀障\f2classname\fP ≪宴若激с潟紮篏臀罘純 \f2public\ static\ void\ main(String[]\ args)\fP ＜純鴻絎障JAR ＜ゃс鴻ゃjar(1)
+JAR ファイルにカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR ファイルの名前にします。このオプションが機能するには、JAR ファイルのマニフェストに\f3「Main\-Class:\fP\f4classname\fP\f3」\fPという形式の行を指定する必要があります。\f2classname\fP には、アプリケーションの開始位置として機能する \f2public\ static\ void\ main(String[]\ args)\fP メソッドを含むクラスを指定します。JAR ファイルとそのマニフェストについては、jar(1)と、
.na
-\f2Java ャ若≪\fP @
+\f2Java チュートリアル\fP @
.fi
-http://java.sun.com/docs/books/tutorial/jarTrail: Jar Filesс
+http://download.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。
.LP
-激с潟篏睡絎 JAR ＜ゃ鴻若吟若鴻純若鴻若吟若鴻鴻祉荐絎∴障
+このオプションを使用すると、指定した JAR ファイルがすべてのユーザークラスのソースになり、ユーザークラスパスのほかの設定は無視されます。
.LP
-Solaris 8 сjava \-jar激с潟у茵с JAR ＜ゃ絎茵罔祉篆障 java \-jar篏睡у茵純с
+Solaris 8 では、「java \-jar」オプションで実行できる JAR ファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。Java Archive (JAR) ファイル
.na
-\f2Java Archive (JAR) ＜ゃ\fP @
+ @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jar/index.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html
.TP 3
\-javaagent:jarpath[=options]
-Java 違潟域茯若吾с潟若障
+Java プログラミング言語エージェントをロードします。 java.lang.instrument を参照してください。
.na
-\f2java.lang.instrument\fP @
+ @
.fi
-http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html с
+http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html
+.TP 3
+\-jre\-restrict\-search
+ユーザープライベートな JRE をバージョン検索に含めます。
+.TP 3
+\-no\-jre\-restrict\-search
+ユーザープライベートな JRE をバージョン検索から除外します。
.TP 3
\-verbose
.TP 3
\-verbose:class
-鴻若潟鴻≪宴茵腓冴障
+クラスがロードされるたびにクラスに関する情報を表示します。
.TP 3
\-verbose:gc
-若吾潟激с潟ゃ潟榊潟怨障
+ガベージコレクションイベントが発生するたびに報告します。
.TP 3
\-verbose:jni
-ゃｃ＜純篏睡潟篁 Java Native Interface (JNI) ≪ｃｃ若≪宴怨障
+ネイティブメソッドの使用およびその他の Java Native Interface (JNI) アクティビティーに関する情報を報告します。
.TP 3
\-version
-若吾с恰宴茵腓冴腟篋障
+バージョン情報を表示して終了します。
.TP 3
\-version:release
-潟潟茵絎鴻障 JAR ＜ゃ\f2release\fP ф絎若吾с潟綽荀腓冴障莎桁 java 潟潟若吾с潟絎絎鴻羣ら絎茖激鴻筝цゃｃ翫絎茖篏睡障
+コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。
.LP
-\f2release\fP с劫若吾с潟絎сс若吾с恰絖若違若吾с潟鴻絎с障若吾с恰絖ゃ若吾с括蚊腥榊純у阪ｃ綵√綺鋌鴻с若吾с括蚊若吾с ID若吾с ID 緇≪鴻帥鴻 (*) 篁若吾с ID 緇壕 (+) 篁2 ゃ若吾с括蚊≪潟泣潟 (&) х障≪鴻帥鴻ｃ剛眼壕垩絎若吾с割札筝≪潟泣潟 2 ゃ若吾с括蚊茫腥潟障箴腓冴障
+\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。
.nf
\f3
.fl
-\-version:"1.5.0_04 1.5*&1.5.1_02+"
+\-version:"1.6.0_13 1.6*&1.6.0_10+"
.fl
\fP
.fi
-筝荐潟若吾с 1.5.0_04障 1.5.1_02 篁ヤ 1.5 若吾с ID ｃ鴻ゃ若吾с潟鴻障 JAR ＜ゃ綽荀с 若吾с恰絖ｳ絲罕絎臂ゃJava Network Launching Protocol & API Specification (JSR\-56)Appendix Aс
+上記の意味は、バージョン 1.6.0_13、1.6 をバージョン ID プレフィックスに持つ 1.6.0_10 以上のバージョン、のいずれかをクラスまたは JAR ファイルが必要としている、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol & API Specification (JSR\-56)」の「Appendix A」を参照してください。
.LP
-JAR ＜ゃ翫絽吾若吾с活篁吟潟潟茵絎JAR ＜ゃс鴻絎ｨ絅障
+JAR ファイルの場合は通常、バージョン要件をコマンド行に指定するよりも、JAR ファイルのマニフェスト内に指定することが推奨されています。
.LP
-激с潟篏睡≪荀激惹宴ゃ緇菴違羈膀с
+このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。
.TP 3
\-showversion
-若吾с恰宴茵腓冴膓茵障
+バージョン情報を表示して続行します。
.TP 3
\-?
.TP 3
\-help
-篏睡羈茵腓冴腟篋障
+使用法を表示して終了します。
+.TP 3
+\-splash:imagepath
+\f2imagepath\fP に指定された画像を含むスプラッシュ画面を表示します。
.TP 3
\-X
-罔羣激с潟≪宴茵腓冴腟篋障
+非標準オプションに関する情報を表示して終了します。
.RE
.LP
.SS
-罔羣激с
-.LP
-.RS 3
-
+非標準オプション
.LP
.RS 3
.TP 3
\-Xint
-ゃ潟帥水≪若у篏障ゃｃ潟若吾潟潟ゃ≦鴻鴻ゃ潟若ゃ潟帥帥ｃ絎茵障Java HotSpot VM 絲上潟潟ゃ箴若潟剛鴻≪若с絎憗障
+インタプリタ専用モードで動作します。ネイティブコードへのコンパイルは無効になり、すべてのバイトコードがインタプリタによって実行されます。Java HotSpot VM に対応するコンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。
.TP 3
\-Xbatch
-違潟潟潟ゃ≦鴻障絽吾VM с違潟潟潟ゃ腟篋障с＜純違潟帥鴻潟潟ゃゃ潟帥帥≪若с＜純絎茵障\f2\-Xbatch\fP 違絎違潟潟潟ゃ≦鴻鴻＜純潟潟ゃ絎篋障с≪違潟帥鴻障
+バックグラウンドコンパイルを無効にします。通常、VM では、バックグラウンドコンパイルが終了するまで、メソッドをバックグラウンドタスクとしてコンパイルし、インタプリタモードでメソッドを実行します。\f2\-Xbatch\fP フラグを指定すると、バックグラウンドコンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンドタスクとして処理されます。
.TP 3
\-Xbootclasspath:bootclasspath
-若鴻＜ゃ｢ｃJAR ≪若ゃ ZIP ≪若ゃ潟潟у阪ｃ鴻ф絎障絎鴻絖若鴻＜ゃJDK 障若鴻＜ゃ篁ｃ篏睡障\f2羈: rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava Runtime Environment ゃ潟若ゃ祉潟拷障\fP
+ブートクラスファイルを探すディレクトリ、JAR アーカイブ、および ZIP アーカイブをコロンで区切ったリストで指定します。指定したパスに存在するブートクラスファイルが、Java プラットフォーム JDK に含まれるブートクラスファイルの代わりに使用されます。\f2注: rt.jar 内のクラスをオーバーライドする目的でこのオプションを使用するアプリケーションは、システムに配置しないでください。Java Runtime Environment バイナリコードライセンス違反になります。\fP
.TP 3
\-Xbootclasspath/a:path
-ｃJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪ｃ絎障 鴻若鴻鴻鴻菴遵障
+ディレクトリ、JAR アーカイブ、および ZIP アーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップクラスパスのあとに追加されます。
.TP 3
\-Xbootclasspath/p:path
-ｃJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪ｃ絎障 鴻若鴻鴻鴻菴遵障\f2羈 rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava Runtime Environment ゃ潟若ゃ祉潟拷障\fP
+ディレクトリ、JAR アーカイブ、および ZIP アーカイブのパスをコロンで区切って指定します。パスはデフォルトのブートストラップクラスパスの前に追加されます。\f2注: rt.jar 内のクラスをオーバーライドする目的でこのオプションを使用するアプリケーションは、システムに配置しないでください。Java Runtime Environment バイナリコードライセンス違反になります。\fP
.TP 3
\-Xcheck:jni
-Java Native Interface (JNI) 罘純絲障菴遵с茵障隙Java 篁潟激潟 JNI 荀羆JNI ∽違羝＜＜若帥絎茵医若帥罎荐若障≦鴻若帥荀ゃｃ翫ゃｃ潟若馹腓冴Java 篁潟激潟翫順若榊腟篋障激с潟篏睡若潟剛筝篋潟障
+Java Native Interface (JNI) 機能に対して追加チェックを行います。具体的には、Java 仮想マシンは JNI 要求を処理する前に、JNI 関数に渡されるパラメータと、実行環境のデータを検証します。無効なデータが見つかった場合は、ネイティブコードに問題があることを示しているため、Java 仮想マシンは致命的エラーを発生して終了します。このオプションを使用すると、パフォーマンス低下が予想されます。
.TP 3
\-Xfuture
-鴻＜ゃ綵√ｳ絲с障筝篏篋с篆ゃJDK 篁潟激潟絎茵綵√сJDK 純с≪若吾с 1.1.x 絎茵с腮綺ｳ絲ｃ障\f3\-Xfuture\fP 違絎鴻＜ゃ綵√篁罕吾羣綣桁ｳ絲с鴻障Java ≪宴若激с活儀若絨ャ若鴻сｳ絲с違潟若冴違篏睡с障
+クラスとファイルの形式を厳密にチェックします。下位互換性を保つため、JDK の仮想マシンが実行するデフォルトの形式チェックは、JDK ソフトウェアのバージョン 1.1.x が実行するチェックと同程度の厳密さになっています。\f3\-Xfuture\fP フラグを指定すると、クラスファイル形式の仕様への準拠を強化するためのより厳密なチェックが有効になります。Java アプリケーション起動ツールの将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときにはこのフラグを使用することをお勧めします。
.TP 3
\-Xnoclassgc
-鴻若吾潟激с潟≦鴻障激с潟篏睡若羝帥鴻＜≪若緇篏＜≪寂戎紜紊с障翫≪宴若激с潟ｃ OutOfMemoryError 鴻若醇с障
+クラスのガベージコレクションを無効にします。このオプションを使用すると、ロード済みクラスからメモリーが回復されることがなくなるため、全体的なメモリー使用量が増大します。この場合、アプリケーションによっては OutOfMemoryError がスローされる可能性があります。
.TP 3
\-Xincgc
-ゃ潟＜潟帥若吾潟帥鴻障ゃ潟＜潟帥若吾潟帥с≦鴻ｃ障 鴻違絎茵筝若吾潟激с潟筝罩≪榊障ゃ潟＜潟帥若吾潟帥違絎茵翫違с祉笈遵篏筝障
+インクリメンタルガーベジコレクタを有効にします。インクリメンタルガベージコレクタは、デフォルトでは無効になっています。 有効にすると、プログラムの実行中にガベージコレクションによる一時停止が発生しなくなります。インクリメンタルガベージコレクタは、プログラムと同時に実行することがあり、この場合、プログラムの利用できるプロセッサ能力が低下します。
.TP 3
\-Xloggc:file
-\-verbose:gc 罕若吾潟激с潟ゃ潟榊潟怨障若帥 \f2file\fP 荐蚊障\f2\-verbose:gc\fP 絎怨宴祉怨ゃ潟若吾潟激с潟ゃ潟腟 (腱篏) 篁障
+\-verbose:gc と同様にガベージコレクションイベントが発生するたびに報告しますが、そのデータを \f2file\fP に記録します。\f2\-verbose:gc\fP を指定したときに報告される情報のほかに、報告される各イベントの先頭に、最初のガベージコレクションイベントからの経過時間 (秒単位) が付け加えられます。
.LP
-若綽膈ｃ JVM 絎茵綺篏筝帥＜ゃ主絽吾若＜ゃ激鴻＜ゃ激鴻羣＜ゃ荅違＜ゃ若帥綣膓荐蚊障激с潟 \f2\-verbose:gc\fP 筝≧鴻潟潟茵絎翫激с潟障
-.LP
+ネットワークの応答時間によって JVM の実行速度が低下するのを避けるため、このファイルの格納先は、常にローカルファイルシステムにしてください。ファイルシステムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引き続き記録されます。このオプションと \f2\-verbose:gc\fP の両方がコマンド行に指定されている場合は、このオプションが優先されます。
.TP 3
\-Xmsn
-＜≪弱蚊綵若泣ゃ冴ゃ違ф絎障絎ゃ1M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 ＜ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
-.br
-箴:
-.RS 3
-
+メモリー割り当てプールの初期サイズをバイト数で指定します。指定する値は、1M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「
+.na
+\f2HotSpot Ergonomics\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/vm/gc\-ergonomics.html」を参照してください。
.LP
+例:
.nf
\f3
.fl
@@ -356,19 +351,19 @@
.fl
\-Xms6m
.fl
-
+
.fl
\fP
.fi
-.RE
.TP 3
\-Xmxn
-＜≪弱蚊綵若紊с泣ゃ冴ゃ違ф絎障絎ゃ2M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 ＜ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
+メモリー割り当てプールの最大サイズをバイト数で指定します。指定する値は、2M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「
+.na
+\f2HotSpot Ergonomics\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/vm/gc\-ergonomics.html」を参照してください。
.br
-箴:
-.RS 3
-
-.LP
+例:
.nf
\f3
.fl
@@ -378,96 +373,105 @@
.fl
\-Xmx80m
.fl
-
+
.fl
\fP
.fi
-.RE
-Solaris 7 Solaris 8 SPARC 若翫ゃ筝 4000m 若若綣сSolaris 2.6 x86 若翫 2000m 若若綣сLinux 若翫筝 2000m 若若綣с
+Solaris 7 および Solaris 8 SPARC プラットフォームの場合のこの値の上限は、およそ 4000m からオーバーヘッドの量を引いたものです。Solaris 2.6 および x86 プラットフォームの場合の上限は、およそ 2000m からオーバーヘッドの量を引いたものです。Linux プラットフォームの場合の上限は、およそ 2000m からオーバーヘッドの量を引いたものです。
.TP 3
\-Xprof
-絎茵筝違＜ゃ＜ゃ潟違若帥罔羣阪阪障激с潟違榊若ｃｃ若箴障 腮弱激鴻с篏睡с障
-.LP
+実行中のプログラムのプロファイルを生成し、プロファイルデータを標準出力に出力します。このオプションは、プログラム開発用のユーティリティーとして提供されています。 本番稼動システムでの使用を目的としたものではありません。
.TP 3
\-Xrs
-Java 篁潟激 (JVM) 若ｃ潟違激鴻激違篏睡羝障
+Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの使用を減らします。
.LP
-篁ュ若鴻сJava ≪宴若激с潟腱綺閫ｃ激ｃ潟激ｃ潟罘純菴遵障罘純JVM 腦句篋翫с激ｃ恰若吟若若潟≪潟若 (若帥若号･膓若冴) 絎茵с障
+以前のリリースでは、Java アプリケーションを秩序正しくシャットダウンするためのシャットダウンフック機能が追加されました。この機能により、JVM が突然終了した場合でも、シャットダウン時にユーザークリーンアップコード (データベース接続のクローズなど) を実行できるようになりました。
.LP
-Sun JVM 激違ｃｃJVM 医幻腟篋激ｃ潟絎茖障JVM SIGHUPSIGINT SIGTERM 篏睡激ｃ潟絎茵紮障
+Sun の JVM は、シグナルをキャッチすることによって、JVM の異常終了のためのシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、および SIGTERM を使用して、シャットダウンフックの実行を開始します。
.LP
-JVM 違с鴻鴻帥潟1.2 罘純絎憗罕罘罕篏睡障Sun JVM 鴻潟絎茵 SIGQUIT 篏睡障
+JVM は、デバッグの目的でスレッドスタックをダンプするという、1.2 より前からある機能を実現するためにも、同様の機構を使用します。Sun の JVM は、スレッドダンプを実行するために SIGQUIT を使用します。
.LP
-JVM 莨若с≪宴若激с潟 SIGINT SIGTERM 激違紫綽荀JVM 激違潟冴醇с障\f3\-Xrs\fP 潟潟茵激с潟篏睡馹絲上с障Sun JVM 絲障 \f3\-Xrs\fP 篏睡SIGINTSIGTERMSIGHUP SIGQUIT 絲障激違鴻 JVM ｃ紊眼激違絲障激違潟ゃ潟鴻若障
+JVM を埋め込んでいるアプリケーションが SIGINT や SIGTERM などのシグナルを頻繁にトラップする必要があると、JVM そのもののシグナルハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fP コマンド行オプションを使用すると、この問題に対処できます。Sun の JVM に対して \f3\-Xrs\fP を使用すると、SIGINT、SIGTERM、SIGHUP、および SIGQUIT に対するシグナルマスクは JVM によって変更されず、これらのシグナルに対するシグナルハンドラはインストールされません。
.LP
-\f3\-Xrs\fP 絎翫罨＜ 2 ゃ綵演帥障
+\f3\-Xrs\fP を指定した場合、次の 2 つの影響があります。
.RS 3
.TP 2
o
-SIGQUIT 鴻潟с
+SIGQUIT によるスレッドダンプを利用できない
.TP 2
o
-激ｃ潟絎茵JVM 腟篋鴻 System.exit() 若喝冴若吟若潟若眼ц綽荀
+シャットダウンフック処理の実行は、JVM が終了しようとしている時点で System.exit() を呼び出すなどして、ユーザーコード側で行う必要がある
.RE
.TP 3
\-Xssn
-鴻鴻帥泣ゃ冴荐絎障
+スレッドのスタックサイズを設定します。
.TP 3
\-XX:+UseAltSigs
-VM с \f2SIGUSR1\fP \f2SIGUSR2\fP 篏睡障\f2SIGUSR1\fP \f2SIGUSR2\fP 激違ｉ≪宴若激с潟 腴九翫障\f2\-XX:+UseAltSigs\fP 激с潟VM \f2SIGUSR1\fP \f2SIGUSR2\fP 篁ュ激違篏睡障
+VM ではデフォルトで \f2SIGUSR1\fP および \f2SIGUSR2\fP を使用しますが、\f2SIGUSR1\fP および \f2SIGUSR2\fP をシグナル連鎖するアプリケーションと 競合する場合があります。\f2\-XX:+UseAltSigs\fP オプションは、VM にデフォルトとして \f2SIGUSR1\fP と \f2SIGUSR2\fP 以外のシグナルを使用させます。
.RE
.LP
-.RE
-.SH "羈"
+.SH "注"
+.LP
.LP
-
+\f3\-version:\fP\f2release\fP コマンド行オプションでは、どんなに複雑にリリースを指定してもかまいません。ただし、現実的なリリース指定の限られたサブセットを使用するだけでも適切なポリシーを表現できるため、それらのサブセットのみが完全にサポートされます。それらのポリシーを次に示します。
.LP
-\f3\-version:\fP\f2release\fP 潟潟茵激с潟с茲若鴻絎障障憜若号絎泣祉篏睡с激若茵憗с泣祉帥絎泣若障激若罨＜腓冴障
.RS 3
.TP 3
1.
-篁紙若吾с潟 激с潟篏睡ц；憗с障
+任意のバージョン。これは、このオプションを使用しないことで表現できます。
.TP 3
2.
-劫若吾с ID 紊с篁紙若吾с潟 罨＜箴腓冴障
+ある特定のバージョン ID よりも大きい任意のバージョン。次に例を示します。
.nf
\f3
.fl
-"1.5.0_03+"
+"1.6.0_10+"
.fl
\fP
.fi
-.LP
-翫1.5.0_03 紊с篁紙若吾с潟篏睡障 絎若吾с潟х劫ゃ潟帥с若鴻絨ャ (違篆罩ｃ) 翫箴水с
+この場合、 \f21.6.0_10\fP よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。
.TP 3
3.
-劫若吾с ID 紊с若吾с潟 若鴻＜筝ｃ狗箴腓冴障
+ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。
.nf
\f3
.fl
-"1.5.0_03+&1.5*"
+"1.6.0_10+&1.6*"
.fl
\fP
.fi
.TP 3
4.
-筝 2 障 3 OR茵憗箴腓冴障
+上の項目 2 と項目 3 の「OR」式。次に例を示します。
.nf
\f3
.fl
-"1.4.2_05+&1.4* 1.5+"
+"1.6.0_10+&1.6* 1.7+"
.fl
\fP
.fi
- 2 篌若障紊眼劫若 (1.5) уャ紊眼篁ュ若鴻≪若с純ｃ翫箴水с
+これは項目 2 に似ていますが、ある変更が特定のリリース (1.7) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。
.RE
.LP
-.SH "∫ｉ"
+.SH "終了ステータス"
+.LP
+.LP
+一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいは Java 仮想マシンから例外がスローされた場合です。ただし Java アプリケーションは、API 呼び出し \f2System.exit(exitValue)\fP を使用して任意の値を返すことを選択することもできます。
.LP
+.RS 3
+.TP 2
+o
+\f20\fP: 正常終了
+.TP 2
+o
+\f2>0\fP: エラーが発生した
+.RE
.LP
+.SH "関連項目"
+.LP
.RS 3
.TP 2
o
@@ -484,19 +488,19 @@
.TP 2
o
.na
-\f2Java ≦宍罘純若若\fP @
+\f2「Java 拡張機能フレームワーク」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.TP 2
o
.na
-\f2祉ャｃ若\fP @
+\f2「セキュリティー」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
.TP 2
o
.na
-\f2HotSpot VM Specific Options\fP @
+\f2「HotSpot VM Specific Options」\fP @
.fi
http://java.sun.com/docs/hotspot/VMOptions.html
.RE
--- a/jdk/src/solaris/doc/sun/man/man1/ja/javac.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/javac.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,325 +19,423 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javac 1 "02 Jun 2010"
+.TH javac 1 "14 Apr 2011"
.LP
-.SH ""
-javac \- Java 違潟域茯潟潟ゃ
+.SH "名前"
+javac \- Java プログラミング言語コンパイラ
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-潟潟茵綣違＜ゃ
+コマンド行引数ファイル
.TP 2
o
-羈
+注釈処理
.TP 2
o
-罎膣
+型の検索
.TP 2
o
-違ｃゃ潟帥с若
+プログラマティックインタフェース
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
\fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]
.fl
-
+
.fl
.fi
.LP
.LP
-綣違筝с
-.LP
-.RS 3
-
+引数は順不同です。
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
sourcefiles
-潟潟ゃ 1 や札筝純若鴻＜ゃ (MyClass.java )
+コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
.TP 3
classes
-羈絲乗院 1 や札筝 (MyPackage.MyClass )
+注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)
.TP 3
@argfiles
-激с潟純若鴻＜ゃ 1 や札筝＜ゃ＜ゃ筝с\f2\-J\fP 激с潟絎с障
+オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では \f2\-J\fP オプションは指定できません。
.RE
.LP
-.RE
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javac\fP 若Java 違潟域茯ц菴違鴻ゃ潟帥с若鴻絎臂茯水ゃ潟若鴻＜ゃ潟潟ゃ障障Java 純若鴻＜ゃ潟劫羈茵障
+\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
.LP
.LP
-純若鴻潟若＜ゃ \f3javac\fP 羝＜罨＜ 2 ゃ号障
+ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
.LP
.RS 3
.TP 2
o
-純若鴻＜ゃ違絨翫＜ゃ潟潟茵х贋･絎障
+ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
.TP 2
o
-純若鴻＜ゃ違紊翫＜ゃ腥榊純障壕у阪ｃ1 ゃ＜ゃ障罨＜鴻＜ゃ \f3@\fP 篁\f3javac\fP 潟潟茵ф絎障
+ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
.RE
.LP
.LP
-純若鴻潟若＜ゃ \f2.java\fP ≦宍絖鴻＜ゃ \f2.class\fP ≦宍絖ｃ違障 障純若鴻＜ゃ鴻＜ゃ＜荅峨鴻絲上若ｃ違障違\f2MyClass\fP 鴻\f2MyClass.java\fP 純若鴻＜ゃ荐菴違障 純若鴻＜ゃ\f2MyClass.class\fP ゃ潟若鴻＜ゃ潟潟ゃ障
+ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、 \f2MyClass\fP という名前のクラスは、 \f2MyClass.java\fP という名前のソースファイルに記述します。このソースファイルは、 \f2MyClass.class\fP という名前のバイトコードクラスファイルにコンパイルされます。
.LP
.LP
-鴻絎臂菴遵鴻＜ゃ障鴻＜ゃ\f2MyClass$MyInnerClass.class\fP 紊劫劫腟水障
+内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、 \f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
.LP
.LP
-純若鴻＜ゃ宴若吾若ｃ若臀綽荀障違鴻純若鴻＜ゃ \f3/workspace\fP 臀翫\f2com.mysoft.mypack.MyClass\fP 純若鴻潟若 \f3/workspace/com/mysoft/mypack/MyClass.java\fP 綽荀障
+ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、 \f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
.LP
.LP
-с潟潟ゃ鴻＜ゃ絲上純若鴻＜ゃｃ臀障ャ阪ｃ絎\f3\-d\fP 篏睡障 (激с潟)
+デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとのオプションを参照)。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-潟潟ゃ憜榊医с泣若絨ャ若鴻с泣若罔羣激с潟祉障篁ュ罔羣激с潟憜篁潟激潟潟潟潟ゃ絎茖堺激с潟с絨ャ紊眼醇с障罔羣激с潟\f3\-X\fP у障障
+コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
.LP
.SS
-罔羣激с
-.LP
-.RS 3
-
+標準オプション
.LP
.RS 3
.TP 3
\-Akey[=value]
-羈祉泣羝＜激с潟javac ｃ贋･茹ｉ祉泣ｃ篏睡障 \f2key\fP 1 ゃ障茲違茘ュ.у阪ｃ絎
+注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
.TP 3
-\-cp path 障 \-classpath path
-若吟若鴻＜ゃ (翫ｃ) 羈祉泣純若鴻＜ゃ罎膣√贋絎障鴻鴻 \f3CLASSPATH\fP 医紊違若吟若鴻鴻若若ゃ障\f3CLASSPATH\fP\f3\-cp\fP\f3\-classpath\fP 絎翫若吟若鴻鴻憜ｃ障荅括完
-.na
-\f2鴻鴻荐絎\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+\-cp path または \-classpath path
+ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、「クラスパスの設定」を参照してください。
.LP
-\f3\-sourcepath\fP 激с潟絎翫純若鴻＜ゃ若吟若鴻鴻罎膣≪障
+\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
.LP
-\f3\-processorpath\fP 激с潟絎翫羈祉泣若吟若鴻鴻罎膣≪障
+\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障
-.br
-.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障\f3羈:\fP潟潟茵医罕ｃ\f2javac \-cp "*.jar" MyClass.java\fP ゃ若絖綣膃у蚊障違翫障
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます。
+.LP
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。 \f2*\fP だけから成るクラスパスエントリは、現在のディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。\f3注:\fP コマンド行環境の構成によっては、 \f2javac \-cp "*.jar" MyClass.java\fP などのように、ワイルドカード文字を引用符で囲むことが必要な場合もあります。
.TP 3
\-Djava.ext.dirs=directories
-ゃ潟鴻若≦宍罘純篏臀若若ゃ障
+インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-Djava.endorsed.dirs=directories
-粋罔羣鴻篏臀若若ゃ障
+承認された標準パスの位置をオーバーライドします。
.TP 3
\-d directory
-鴻＜ゃ阪ｃ荐絎障ｃс絖綽荀障 \f3javac\fP ｃ篏障鴻宴若吾筝с翫\f3javac\fP 綽荀綽ｃ篏宴若後泣ｃ鴻＜ゃ臀障違\f3\-d /home/myclasses\fP 絎鴻 \f2com.mypackage.MyClass\fP с翫鴻＜ゃ \f2/home/myclasses/com/mypackage/MyClass.class\fP 障
+クラスファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
.LP
-\f3\-d\fP 絎ｃ翫\f3javac\fP 鴻＜ゃ純若鴻＜ゃｃ主障
+\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
.LP
-\f3羈:\fP\f3\-d\fP ф絎ｃ若吟若鴻鴻菴遵障
+\f3注:\fP \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
.TP 3
\-deprecation
-ｨ絅＜潟若鴻篏睡障若若ゃ潟茯茵腓冴障\f3\-deprecation\fP 絎翫\f3javac\fP ｨ絅＜潟若鴻篏睡障若若ゃ純若鴻＜ゃ荀膣茵腓冴障\f3\-deprecation\fP \f3\-Xlint:deprecation\fP ヨ；荐с
+推奨されないメンバーやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバーやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
.TP 3
\-encoding encoding
-純若鴻＜ゃ潟潟若ｃ潟医 (\f2EUC\-JP\fP \f2UTF\-8\fP ) 絎障\f3\-encoding\fP 絎翫若潟潟若帥篏帥障
+ソースファイルのエンコーディング名 ( \f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
+.TP 3
+\-endorseddirs directories
+承認された標準パスの位置をオーバーライドします。
+.TP 3
+\-extdirs directories
+\f2ext\fP ディレクトリの位置をオーバーライドします。\f2directories\fP 変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。見つかったすべての JAR アーカイブは自動的にクラスパスの一部になります。
+.LP
+クロスコンパイル (異なる Java プラットフォームに実装されたブートストラップクラスや拡張機能クラスに対してコンパイルを行う) を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細は、「クロスコンパイルオプション」を参照してください。
.TP 3
\-g
-絮紊違鴻井宴障с茵垩潟純若鴻＜ゃ宴障
+局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
.TP 3
\-g:none
-井宴障
+デバッグ情報を生成しません。
.TP 3
\-g:{keyword list}
-潟潟у阪若若鴻絎劫腮蕁井宴障罨＜若若鴻с
+コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
.RS 3
.TP 3
source
-純若鴻＜ゃ井
+ソースファイルのデバッグ情報
.TP 3
lines
-茵垩井
+行番号のデバッグ情報
.TP 3
vars
-絮紊違井
+局所変数のデバッグ情報
.RE
.TP 3
\-help
-罔羣激с潟綵√茵腓冴障
+標準オプションの形式を表示します。
.TP 3
\-implicit:{class,none}
-藥若純若鴻＜ゃ絲障鴻＜ゃ九勝障鴻＜ゃ\f3\-implicit:class\fP 篏睡障鴻＜ゃ吟\f3\-implicit:none\fP 篏睡障 激с潟絎ｃ翫篏鴻＜ゃ障翫鴻＜ゃ羈絎茵潟潟ゃ茘肴障 激с潟腓榊荐絎翫茘肴障 罎膣≪с
+暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。
+.TP 3
+\-Joption
+\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
+.LP
+\f3注:\fP \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものではありません。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
.TP 3
\-nowarn
-茘＜祉若吾≦鴻障 \f3\-Xlint:none\fP 潟с
+警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
.TP 3
\-proc: {none,only}
-羈潟潟ゃ筝≧鴻絎茵九勝障\f3\-proc:none\fP 羈с潟潟ゃ絎茵潟障\f3\-proc:only\fP 羈絎茵緇膓潟潟ゃ障ｃ鎘茵潟障
+注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
.TP 3
\-processor class1[,class2,class3...]
-絎茵羈祉泣絎翫罎膣√ャ障
+実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
.TP 3
\-processorpath path
-羈祉泣罎膣√贋絎障 激с潟篏睡ｃ翫鴻劫с祉泣罎膣≪茵障
+注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
.TP 3
\-s dir
-純若鴻＜ゃ主ｃ絎障ｃс絖綽荀障 \f3javac\fP 篏障鴻宴若吾筝ｃ翫潟潟ゃ純若鴻＜ゃ宴若後泣ｃ主障 綽荀綽ｃ篏障違若吟若 \f3\-s /home/mysrc\fP 絎鴻 \f2com.mypackage.MyClass\fP сｃ翫純若鴻＜ゃ \f2/home/mysrc/com/mypackage/MyClass.java\fP 主障
+生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
.TP 3
\-source release
-篁純若鴻潟若若吾с潟絎障\f2release\fP 罨＜ゃ絎с障
+受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
.RS 3
.TP 3
1.3
-潟潟ゃсJDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
+このコンパイラでは、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
.TP 3
1.4
-JDK 1.4 уャ≪泣若激с潟潟若篁障
+JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
.TP 3
1.5
-JDK 5 уャ膩霡違割荐茯罘純潟若篁障
+JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。
.TP 3
5
-1.5 臂с
+1.5 と同義です。
.TP 3
1.6
-ゃсJava SE 6 с荐茯絲障紊眼絨ャ障с純若鴻＜ゃ潟潟若ｃ潟違若篁ュ茘с若怨障
+これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
.TP 3
6
-1.6 臂с
+1.6 と同義です。
+.TP 3
+1.7
+JDK 7 で導入された機能を含むコードを受け付けます。
+.TP 3
+7
+1.7 と同義です。
.RE
.TP 3
\-sourcepath sourcepath
-鴻障ゃ潟帥с若鴻絎臂罎膣≪純若鴻潟若鴻絎障若吟若鴻鴻罕純若鴻鴻茲違潟潟 (\f3:\fP) у阪障 純若鴻鴻潟ｃJAR ≪若ゃ障 ZIP ≪若ゃ絎с障宴若吾篏帥ｃ翫ｃ障≪若ゃ若劫宴若後違障
+クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
.LP
-\f3羈:\fP\ 鴻鴻鴻с純若鴻荀ゃｃ翫鴻潟潟ゃ絲乗院障罎膣≪с
+\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
.TP 3
\-verbose
-荅括完阪茵腓冴障若鴻潟潟潟ゃ純若鴻＜ゃ宴阪障
+詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
+.TP 3
+\-version
+バージョン情報を出力します。
+.TP 3
+\-Werror
+警告が発生した場合にコンパイルを終了します。
.TP 3
\-X
-罔羣激с潟≪宴茵腓冴腟篋障
+非標準オプションに関する情報を表示して終了します。
.RE
.LP
-.RE
.SS
-鴻潟潟ゃ激с
-.LP
-.RS 3
-
+クロスコンパイルオプション
.LP
.LP
-с鴻潟潟ゃ\f3javac\fP 羞私若若鴻鴻恰≦宍罘純鴻絲障茵障\f3javac\fP 違 Java 若絎茖若鴻鴻恰≦宍罘純鴻絲障潟潟ゃ茵鴻潟潟ゃ泣若障鴻潟潟ゃ茵翫\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥荀с 鴻潟潟ゃ箴с
+デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。
.LP
.RS 3
.TP 3
\-target version
-絎若吾с潟 VM 帥若蚊鴻＜ゃ障鴻＜ゃ絎帥若蚊篁ラ若吾с潟с篏障若吾с潟 VM с篏障鴻帥若蚊\f31.1\fP\f31.2\fP\f31.3\fP\f31.4\fP\f31.5\fP (\f35\fP ) \f31.6\fP (\f36\fP ) с
+指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、\f31.6\fP (\f36\fP も可)、および \f31.7\fP (\f37\fP も可) です。
.LP
-\f3\-target\fP 罨＜ \f3\-source\fP ゃｃ羆冴障障
+\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
.RS 3
.TP 2
o
-\-source \f3絎ｃ\fP翫\-target ゃ \f31.6\fP 障
+\-source が\f3指定されなかった\fP場合、\-target の値は \f31.7\fP になります。
.TP 2
o
-\-source \f31.2\fP 翫\-target ゃ \f31.4\fP 障
+\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
-\-source \f31.3\fP 翫\-target ゃ \f31.4\fP 障
+\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
-\-source \f3篁ュゃ翫鴻\fP\\\-target ゃ \f3\-source\fP ゃ障
+\-source が\f3それ以外の値の場合はすべて\fP、\f3\\\-target\fP の値は \f3\-source\fP の値になります。
.RE
.TP 3
\-bootclasspath bootclasspath
-絎筝ｃ若鴻絲障鴻潟潟ゃ茵障若吟若鴻鴻罕若鴻鴻茲違潟潟 (\f3:\fP) у阪障 若鴻鴻潟ｃJAR ≪若ゃ障 ZIP ≪若ゃ絎с障
-.TP 3
-\-extdirs directories
-絎≦宍罘純ｃ絲障鴻潟潟ゃ茵障\f2directories\fP 潟潟у阪ｃｃ鴻絎障絎ｃ JAR ≪若ゃ鴻＜ゃ罎膣≪障
+指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
.RE
.LP
-.RE
.SS
-罔羣激с
-.LP
-.RS 3
-
+非標準オプション
.LP
.RS 3
.TP 3
\-Xbootclasspath/p:path
-若鴻鴻鴻菴遵障
+ブートストラップクラスパスの前に追加します。
.TP 3
\-Xbootclasspath/a:path
-若鴻鴻鴻緇菴遵障
+ブートストラップクラスパスの後ろに追加します。
.TP 3
\-Xbootclasspath/:path
-若鴻鴻＜ゃ篏臀若若ゃ障
+ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-Xlint
-ｨ絅鴻茘鴻障若鴻с純鴻茘ｨ絅障
+推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。
+.TP 3
+\-Xlint:all
+推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。
.TP 3
\-Xlint:none
-Java 荐茯篁罕с絎鴻茘≦鴻障
+Java 言語仕様では指定されていないすべての警告を無効にします。
+.TP 3
+\-Xlint:name
+警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。
.TP 3
\-Xlint:\-name
-茘 \f2name\fP ≦鴻障 \f2name\fP \f3\-Xlint:\fP\f2name\fP 篏睡с茘障 茘罨＜с
+警告 \f2name\fP を無効にします。このオプションで無効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。
+.TP 3
+\-Xmaxerrs number
+印刷するエラーの最大数を設定します。
.TP 3
-\-Xlint:unchecked
-Java 荐茯篁罕ф絎罎糸茘荅括完腓冴障
+\-Xmaxwarns number
+印刷する警告の最大数を設定します。
.TP 3
-\-Xlint:path
-絖 (classpathsourcepath ) ｃゃ茘障
+\-Xstdout filename
+コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
.TP 3
-\-Xlint:serial
-\f2serialVersionUID\fP 絎臂翫純鴻茘障
+\-Xprefer:{newer,source}
+ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。SOURCE の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fP \f2を使用してください\fP。
+.TP 3
+\-Xpkginfo:{always,legacy,nonempty}
+パッケージ情報ファイルの処理を指定します。
.TP 3
-\-Xlint:finally
-罩ｅ幻絎篋с \f2finally\fP 膀ゃ茘障
+\-Xprint
+指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
.TP 3
-\-Xlint:fallthrough
-fall\-through 宴若鴻 \f2switch\fP с罎冴絲障茘＜祉若吾茵腓冴障Fall\-through 宴若鴻\f2switch\fP 緇宴若鴻ゃ宴若鴻с 潟若 \f2break\fP 障障 潟若絎茵宴若鴻罨＜宴若鴻悟Щ障違 \f2switch\fP \f2case 1\fP 膓潟若\f2break\fP хｃ障
-.RS 3
+\-XprintProcessorInfo
+ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
+.TP 3
+\-XprintRounds
+初回および後続の注釈処理ラウンドに関する情報を出力します。
+.RE
.LP
+.SS
+\-Xlint オプションを使って有効または無効にできる警告
+.LP
+.LP
+\f3\-Xlint:\fP\f2name\fP オプションを使って警告 \f2name\fP を有効にします。ただし、\f2name\fP は次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fP オプションを使って警告 \f2name\fP を無効にできます。
+.LP
+.RS 3
+.TP 3
+cast
+不要で冗長なキャストについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+String s = (String)"Hello!"
+.fl
+\fP
+.fi
+.TP 3
+classfile
+クラスファイルの内容に関連した問題について警告します。
+.TP 3
+deprecation
+非推奨項目の使用について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ java.util.Date myDate = new java.util.Date();
+.fl
+ int currentDay = myDate.getDay();
+.fl
+\fP
+.fi
+.LP
+メソッド \f2java.util.Date.getDay\fP は JDK 1.1 以降は推奨されていません。
+.TP 3
+dep\-ann
+\f2@deprecated\fP Javadoc コメントでドキュメント化されているが、 \f2@Deprecated\fP 注釈が付いていない項目について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ /**
+.fl
+ * @deprecated As of Java SE 7, replaced by {@link #newMethod()}
+.fl
+ */
+.fl
+
+.fl
+ public static void deprecatedMethood() { }
+.fl
+
+.fl
+ public static void newMethod() { }
+.fl
+\fP
+.fi
+.TP 3
+divzero
+一定の整数 0 で除算されることについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+ int divideByZero = 42 / 0;
+.fl
+\fP
+.fi
+.TP 3
+empty
+\f2if\fP 文以降が空の文であることについて警告します。次に例を示します。
+.nf
+\f3
+.fl
+class E {
+.fl
+ void m() {
+.fl
+ if (true) ;
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.TP 3
+fallthrough
+fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
.nf
\f3
.fl
@@ -347,7 +445,7 @@
.fl
System.out.println("1");
.fl
- // No break; statement here.
+ // No break statement here.
.fl
case 2:
.fl
@@ -355,96 +453,375 @@
.fl
}
.fl
-
+\fP
+.fi
+.LP
+このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
+.TP 3
+finally
+正常に完了できない \f2finally\fP 節について警告します。次に例を示します。
+.nf
+\f3
+.fl
+ public static int m() {
+.fl
+ try {
+.fl
+ throw new NullPointerException();
+.fl
+ } catch (NullPointerException e) {
+.fl
+ System.err.println("Caught NullPointerException.");
+.fl
+ return 1;
+.fl
+ } finally {
+.fl
+ return 0;
+.fl
+ }
+.fl
+ }
+.fl
+\fP
+.fi
+.LP
+この例では、コンパイラは \f2finally\fP ブロックに関する警告を生成します。このメソッドが呼び出されると、値 1 ではなく \f20\fP が \f2返されます\fP。 \f2finally\fP ブロックは、 \f2try\fP ブロックが終了すると必ず実行されます。この例では、制御が \f2catch\fP に移された場合、メソッドは終了します。ただし、 \f2finally\fP ブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。
+.TP 3
+options
+コマンド行オプションの使用に関する問題について警告します。この種の警告の例については、「クロスコンパイルの例」を参照してください。
+.TP 3
+overrides
+メソッドのオーバーライドに関する問題について警告します。たとえば、次の 2 つのクラスがあるとします。
+.nf
+\f3
+.fl
+public class ClassWithVarargsMethod {
+.fl
+ void varargsMethod(String... s) { }
+.fl
+}
+.fl
+\fP
+.fi
+.nf
+\f3
+.fl
+public class ClassWithOverridingMethod extends ClassWithVarargsMethod {
+.fl
+ @Override
+.fl
+ void varargsMethod(String[] s) { }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次のような警告を生成します。
+.nf
+\f3
+.fl
+warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod overrides varargsMethod(String...) in ClassWithVarargsMethod; overriding method is missing '...'
+.fl
+\fP
+.fi
+.LP
+コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。メソッド \f2ClassWithVarargsMethod.varargsMethod\fP では、コンパイラは varargs の仮パラメータ \f2String... s\fP を仮パラメータ \f2String[] s\fP に変換します。String[] s は、メソッド \f2ClassWithOverridingMethod.varargsMethod\fP の仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。
+.TP 3
+path
+コマンド行での無効なパス要素と存在しないパスディレクトリについて警告します (クラスパス、ソースパスなどのパス関連)。このような警告を \f2@SuppressWarnings\fP 注釈で抑制することはできません。次に例を示します。
+.nf
+\f3
+.fl
+javac \-Xlint:path \-classpath /nonexistentpath Example.java
+.fl
+\fP
+.fi
+.TP 3
+processing
+注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでその型の例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。
+.LP
+\f3ソースファイル \fP\f4AnnoProc.java\fP:
+.nf
+\f3
+.fl
+import java.util.*;
+.fl
+import javax.annotation.processing.*;
+.fl
+import javax.lang.model.*;
+.fl
+import javax.lang.model.element.*;
+.fl
+
+.fl
+@SupportedAnnotationTypes("NotAnno")
+.fl
+public class AnnoProc extends AbstractProcessor {
+.fl
+ public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv) {
+.fl
+ return true;
+.fl
+ }
+.fl
+
+.fl
+ public SourceVersion getSupportedSourceVersion() {
+.fl
+ return SourceVersion.latest();
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+\f3ソースファイル \fP\f4AnnosWithoutProcessors.java\fP\f3:\fP
+.nf
+\f3
+.fl
+@interface Anno { }
+.fl
+
+.fl
+@Anno
+.fl
+class AnnosWithoutProcessors { }
+.fl
+\fP
+.fi
+.LP
+次のコマンドは、注釈プロセッサ \f2AnnoProc\fP をコンパイルし、この注釈プロセッサをソースファイル \f2AnnosWithoutProcessors.java\fP に対して実行します。
+.nf
+\f3
+.fl
+% javac AnnoProc.java
+.fl
+% javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java
+.fl
+\fP
+.fi
+.LP
+コンパイラがソースファイル \f2AnnosWithoutProcessors.java\fP に対して注釈プロセッサを実行すると、次の警告が生成されます。
+.nf
+\f3
+.fl
+warning: [processing] No processor claimed any of these annotations: Anno
.fl
\fP
.fi
-.RE
-潟若潟潟ゃ \f2\-Xlint:fallthrough\fP 違篏睡翫潟潟ゃ 綵荅蚊宴若鴻茵垩fall\-through 宴若鴻醇с腓冴茘肴障
+.LP
+この問題を解決するには、クラス \f2AnnosWithoutProcessors\fP で定義および使用される注釈の名前を \f2Anno\fP から \f2NotAnno\fP に変更します。
.TP 3
-\-Xmaxerrs number
-医激若紊ф違荐絎障
+rawtypes
+raw 型に対する未検査操作について警告します。特にこのオプションは、型引数を持たないパラメータ化された型を使用するユーザーに対して警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。
+.nf
+\f3
+.fl
+void countElements(List l) { ... }
+.fl
+\fP
+.fi
+.LP
+次の文では、 \f2rawtypes\fP 警告は生成されません。
+.nf
+\f3
+.fl
+void countElements(List<?> l) { ... }
+.fl
+\fP
+.fi
+.LP
+\f2List\fP は raw 型です。ただし、 \f2List<?>\fP はアンバウンド形式のワイルドカードのパラメータ化された型です。 \f2List\fP はパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、 \f2List\fP の仮引数はアンバウンド形式のワイルドカード (\f2?\fP) を使ってその仮型パラメータとして指定されます。つまり、 \f2countElements\fP メソッドは \f2List\fP インタフェースのどのインスタンス化も受け付けることができます。
.TP 3
-\-Xmaxwarns number
-医激茘紊ф違荐絎障
-.TP 3
-\-Xstdout filename
-潟潟ゃ＜祉若吾絎＜ゃ障с潟潟ゃ＜祉若吾 \f2System.err\fP 障
+serial
+直列化可能クラスに \f2serialVersionUID\fP 定義がないことを警告します。次に例を示します。
+.nf
+\f3
+.fl
+public class PersistentTime implements Serializable
+.fl
+{
+.fl
+ private Date time;
+.fl
+
+.fl
+ public PersistentTime() {
+.fl
+ time = Calendar.getInstance().getTime();
+.fl
+ }
+.fl
+
+.fl
+ public Date getTime() {
+.fl
+ return time;
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [serial] serializable class PersistentTime has no definition of serialVersionUID
+.fl
+\fP
+.fi
+.LP
+直列化可能クラスが \f2serialVersionUID\fP という名前のフィールドを明示的に宣言しない場合、直列化ランタイムは「Java オブジェクト直列化仕様」で説明されているように、クラスのさまざまな側面に基づいて、クラスの \f2serialVersionUID\fP のデフォルト値を計算します。ただし、すべての直列化可能クラスが \f2serialVersionUID\fP 値を明示的に宣言することを強くお勧めします。これは、 \f2serialVersionUID\fP 値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、直列化復元中に予期しない \f2InvalidClassExceptions\fP が発生する可能性があるためです。したがって、Java コンパイラの実装が異なっても \f2serialVersionUID\fP 値の一貫性を確保にするには、直列化可能クラスが \f2serialVersionUID\fP 値を明示的に宣言する必要があります。
.TP 3
-\-Xprefer:{newer,source}
-絲障純若鴻＜ゃ鴻＜ゃ筝≧鴻荀ゃｃ翫＜＜ゃ茯水鴻絎障 (罎膣≪)\f2\-Xprefer:newer\fP 篏睡翫絲障純若鴻＜ゃ鴻＜ゃ違鴻茯水障 ()\f2\-Xprefer:source\fP激с潟篏睡翫純若鴻＜ゃ茯水障\f2SOURCE\fP 篆絖激若篏帥ｃ絎ｈ羈篁紙羈祉泣≪祉鴻с翫\f2\-Xprefer:source\fP篏睡
+static
+static の使用に関する問題について警告します。次に例を示します。
+.nf
+\f3
+.fl
+class XLintStatic {
+.fl
+ static void m1() { }
+.fl
+ void m2() { this.m1(); }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [static] static method should be qualified by type name, XLintStatic, instead of by an expression
+.fl
+\fP
+.fi
+.LP
+この問題を解決するために、次のように static メソッド \f2m1\fP を呼び出すことができます。
+.nf
+\f3
+.fl
+XLintStatic.m1();
+.fl
+\fP
+.fi
+.LP
+あるいは、 \f2static\fP キーワードをメソッド \f2m1\fP の宣言から削除することもできます。
.TP 3
-\-Xprint
-絎鴻茵憗亥у阪障 羈潟潟ゃ＜絎茵障阪綵√紊眼醇с障
+try
+try\-with\-resources 文を含む、 \f2try\fP ブロックの使用に関する問題について警告します。たとえば、try 文で宣言されたリソース \f2ac\fP が使用されないために、 \f2次の文に対して警告が\fP 生成されます。
+.nf
+\f3
+.fl
+try ( AutoCloseable ac = getResource() ) {
+.fl
+ // do nothing
+.fl
+}
+.fl
+\fP
+.fi
.TP 3
-\-XprintProcessorInfo
-劫祉泣箴若羈≪宴阪障
+unchecked
+Java 言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。
+.nf
+\f3
+.fl
+ List l = new ArrayList<Number>();
+.fl
+ List<String> ls = l; // unchecked warning
+.fl
+\fP
+.fi
+.LP
+型の消去中に、型 \f2ArrayList<Number>\fP および \f2List<String>\fP はそれぞれ \f2ArrayList\fP および \f2List\fP になります。
+.LP
+変数 \f2ls\fP にはパラメータ化された型 \f2List<String>\fP が指定されています。l によって参照される \f2List\fP \f2が\fP \f2ls\fP に代入されると、コンパイラは未検査警告を生成します。コンパイラは \f2l\fP が \f2List<String>\fP 型を参照するかどうかをコンパイル時に判断できません。また、JVM が実行時にそれを判断できないことも認識しています。l は List<String> 型を参照しません。その結果、ヒープ汚染が発生します。
+.LP
+詳しく説明すると、ヒープ汚染状態が発生するのは、 \f2List\fP オブジェクト \f2l\fP (その static 型は \f2List<Number>\fP) が別の \f2List\fP オブジェクト \f2ls\fP (異なる static 型 \f2List<String>\fP を持つ) に代入される場合です。しかし、コンパイラではこの代入を未だに許可しています。総称をサポートしない Java SE のバージョンとの下位互換性を確保するために、この代入を許可する必要があります。型消去のために、 \f2List<Number>\fP と \f2List<String>\fP は \f2List\fP になります。その結果、コンパイラはオブジェクト \f2l\fP ( \f2List\fP という raw 型を持つ) をオブジェクト \f2ls\fPに代入することを許可します。
.TP 3
-\-XprintRounds
-喝膓羈潟≪宴阪障
+varargs
+可変引数 (varargs) メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。
+.nf
+\f3
+.fl
+public class ArrayBuilder {
+.fl
+ public static <T> void addToList (List<T> listArg, T... elements) {
+.fl
+ for (T x : elements) {
+.fl
+ listArg.add(x);
+.fl
+ }
+.fl
+ }
+.fl
+}
+.fl
+\fP
+.fi
+.LP
+コンパイラは、メソッド \f2ArrayBuilder.addToList\fP の定義に関する次の警告を生成します。
+.nf
+\f3
+.fl
+warning: [varargs] Possible heap pollution from parameterized vararg type T
+.fl
+\fP
+.fi
+.LP
+コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。しかし、Java プログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド \f2ArrayBuilder.addToList\fP では、コンパイラは varargs の仮パラメータ \f2T... elements\fP を仮パラメータ \f2T[] elements\fP(配列) に変換します。しかし、型消去のために、コンパイラは varargs の仮パラメータを \f2Object[] elements\fP に変換します。その結果、ヒープ汚染が発生する可能性があります。
.RE
.LP
-.RE
-.SS
-\-J 激с
+.SH "コマンド行引数ファイル"
.LP
-.RS 3
-
.LP
-.RS 3
-.TP 3
-\-Joption
-\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟 \f3\-X\fP у障ｃ障\f3javac\fP 罔羣激с潟с障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+javac のコマンド行を短くしたり簡潔にしたりするために、 \f2javac\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
.LP
-\f3羈:\fP \ \f3CLASSPATH\fP\f3\-classpath\fP\f3\-bootclasspath\fP \f3\-extdirs\fP \f3javac\fP 絎茵篏帥鴻絎с障号с潟潟ゃ絎茖篏絽吾≧潟с絽吾演冴篌眼障号篏帥綽荀翫\f3\-J\fP 激с潟篏帥ｃ綽荀激с潟緇 \f3java\fP 莎桁若羝＜
-.RE
-
.LP
-.RE
-.SH "潟潟茵綣違＜ゃ"
-.LP
-
+引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
.LP
.LP
-\f2javac\fP 潟潟茵膂≧\f2javac\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝＜ゃ絎с障号篏帥若ｃ潟違激鴻筝с篁紙激 javac 潟潟篏с障
-.LP
-.LP
-綣違＜ゃjavac 激с潟純若鴻＜ゃ宴腟水荐菴違с障＜ゃ綣違鴻若鴻障壕у阪障＜ゃ腥榊純障翫＜ゃ篏篋綣膃у蚊帥障
+引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
.LP
.LP
-綣違＜ゃ＜ゃ憜ｃ荀後障鴻障綣違＜ゃ篏臀荀後障鴻с障綣違＜ゃ＜ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
+javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
+.LP
+.SS
+引数ファイルを 1 つ指定する例
.LP
.LP
-javac 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障javac \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
-.LP
-.SS
-綣違＜ゃ 1 ゆ絎箴
-.LP
-.LP
-\f2argfile\fP 綣違＜ゃ鴻 javac 綣違主翫罨＜絎障
+\f2「argfile」という名前の引数ファイルに\fPすべての javac 引数を格納する場合は、次のように指定します。
.LP
.nf
\f3
.fl
- % \fP\f3javac @argfile\fP
-.fl
-
+% \fP\f3javac @argfile\fP
.fl
.fi
.LP
.LP
-綣違＜ゃ罨＜箴хず 2 ゃ＜ゃ絎鴻筝≧鴻ャс障
+この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
.LP
.SS
-綣違＜ゃ 2 ゆ絎箴
+引数ファイルを 2 つ指定する例
.LP
.LP
-違javac 激с括 1 ＜ゃ純若鴻＜ゃ 1 ＜ゃ2 ゃ綣違＜ゃ篏с障鴻с茵膓膓絖篏睡障
+たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
.LP
.LP
-篁ヤ絎鴻 \f2options\fP ＜ゃ篏障
+以下の内容を含む \f2options\fP というファイルを作成します。
.LP
.nf
\f3
@@ -455,14 +832,14 @@
.fl
\-sourcepath /java/pubs/ws/1.3/src/share/classes
.fl
-
+
.fl
\fP
.fi
.LP
.LP
-篁ヤ絎鴻 \f2classes\fP ＜ゃ篏障
+以下の内容を含む \f2classes\fP というファイルを作成します。
.LP
.nf
\f3
@@ -473,120 +850,104 @@
.fl
MyClass3.java
.fl
-
+
.fl
\fP
.fi
.LP
.LP
-罨＜潟潟篏睡 \f3javac\fP 絎茵障
+次のコマンドを使用して \f3javac\fP を実行します。
.LP
.nf
\f3
.fl
% \fP\f3javac @options @classes\fP
.fl
-
+
.fl
.fi
.LP
.SS
-剛綣違＜ゃ箴
+パス付きの引数ファイルの例
.LP
.LP
-綣違＜ゃ鴻絎с障 ＜ゃ絎＜ゃ憜篏罐ｃ荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
+引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。
.LP
.nf
\f3
.fl
- % \fP\f3javac @path1/options @path2/classes\fP
-.fl
-
+% \fP\f3javac @path1/options @path2/classes\fP
.fl
.fi
.LP
-.SH "羈"
+.SH "注釈処理"
.LP
-
+.LP
+\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
.LP
.LP
-\f3javac\fP 羈贋･泣若腴羈若с \f3apt\fP 篏睡綽荀障
+注釈処理の API は、 \f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
+.LP
+.SS
+注釈処理の概要
.LP
.LP
-羈 API \f2javax.annotation.processing\fP \f2javax.lang.model\fP 宴若吾泣宴若後絎臂障
-.LP
-.SS
-羈网荀
+\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META\-INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
.LP
.LP
-\f3\-proc:none\fP 激с潟ｃ羈≦劫潟潟ゃ篏睡純鴻羈祉泣罎膣≪障罎膣≪鴻 \f3\-processorpath\fP 激с潟篏帥ｃ絎с障 罎膣≪鴻絎ｃ翫若吟若鴻鴻篏睡障祉泣罎膣≪罎膣≪剛
-.br
-\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
-.br
-泣若鴻ゃ罕＜ゃ冴ャ茵障＜ゃ篏睡鴻羈祉泣1 茵 1 ゃゅ障ャ号\f3\-processor\fP 激с潟篏帥ｃ祉泣腓榊絎с障
+コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
.LP
.LP
-潟潟ゃ潟潟茵純若鴻＜ゃ鴻莎井祉с羈絖腆肴腟祉泣絲障茵祉泣羈с腆肴障筝眼荀ゃｃ翫祉泣若喝冴障祉泣荳羈荀羆с障 翫羈絲障ャ祉泣荀ゃ荅帥茵障鴻羈荀羆障潟潟ゃ篁ヤ祉泣罎膣≪茵障
+いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
.LP
.LP
-祉泣ｃ違純若鴻＜ゃ羈 2 潟紮障違鴻純若鴻＜ゃ莎井祉罕羈障篁ュ潟у若喝冴祉泣鴻緇膓潟с若喝冴障違純若鴻＜ゃ障х障
-.LP
-.LP
-潟ф違純若鴻＜ゃｃ翫羈祉泣 1 若喝冴綽荀絎茵罘篌筝障 緇\f3\-proc:only\fP 激с潟篏睡潟潟ゃ純若鴻＜ゃ鴻純若鴻＜ゃ潟潟ゃ障
+あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
.LP
.SS
-藥若純若鴻＜ゃ
+暗黙的にロードされたソースファイル
.LP
.LP
-潟潟ゃ筝ｃ純若鴻＜ゃ潟潟ゃャ純若鴻＜ゃ藥若違翫障 (罎膣≪)＜ゃ憝鴻с羈絲乗院障с羈絎茵ゆ藥若純若鴻＜ゃ 1 ゃс潟潟ゃ翫潟潟ゃ茘肴障茘吟号ゃ\-implicit 激с潟с
+コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードすることが必要な場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
.LP
-.SH "罎膣"
-.LP
-
+.SH "型の検索"
.LP
.LP
-純若鴻＜ゃ潟潟ゃ翫潟潟茵ф絎純若鴻＜ゃ絎臂荀ゃ潟潟ゃ絽吾≪宴綽荀障潟潟ゃ純若鴻＜ゃт戎鴻障ゃ潟帥с若鴻≦宍鴻障ゃ潟帥с若鴻絎茖鴻障ゃ潟帥с若鴻鴻ゃ宴綽荀障純若鴻＜ゃф腓榊荐膓帥宴箴鴻ゃ潟帥с若鴻障障
+ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
.LP
.LP
-違\f3java.applet.Applet\fP 泣鴻翫\f3≪\fP腑刻\f3java.awt.Panel\fP\f3java.awt.Container\fP\f3java.awt.Component\fP\f3java.lang.Object\fP鐚篏睡障
+たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、\f3アプレットの\fP祖先のクラス（\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP）を使用していることになります。
.LP
.LP
-潟潟ゃ宴綽荀絎臂純若鴻＜ゃ障鴻＜ゃ｢障障若鴻鴻≦宍罘純鴻罎膣≪膓若吟若鴻 (с潟ｃ) 罎膣≪障若吟若鴻鴻\f3CLASSPATH\fP 医紊違荐絎絎臂障 \f3\-classpath\fP 潟潟茵激с潟篏帥ｃ荐絎障荅括完
-.na
-\f2鴻鴻荐絎\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
+コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、「クラスパスの設定」を参照してください。
.LP
.LP
-\-sourcepath 激с潟絎翫潟潟ゃ絎鴻純若鴻＜ゃ罎膣≪障 篁ュ翫若吟若鴻鴻鴻＜ゃ純若鴻＜ゃ筝≧鴻罎膣≪障
+\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
.LP
.LP
-\f3\-bootclasspath\fP 激с潟 \f3\-extdirs\fP 激с潟篏帥ャ若鴻鴻≦宍罘純鴻絎с障 鴻潟潟ゃ激с潟с
+\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。このあとの「クロスコンパイルオプション」を参照してください。
.LP
.LP
-罎膣≪緇腟鴻＜ゃ純若鴻＜ゃ障筝≧鴻с翫障筝≧鴻荀ゃｃ翫＜篏睡鴻 \-Xprefer 激с潟с潟潟ゃ腓冴с障\f3newer\fP 絎翫潟潟ゃ 2 ゃ＜ゃ違鴻篏睡障\f3source\fP 絎翫潟潟ゃ純若鴻＜ゃ篏睡障 \f3newer\fP с
+型の検索に成功したときに得られる結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
.LP
.LP
-罎膣∵篏ｃ障 \f3\-Xprefer\fP 荐絎腟綽荀純若鴻＜ゃ荀ゃｃ翫潟潟ゃ純若鴻＜ゃ茯水綽荀宴緇障潟潟ゃс純若鴻＜ゃ潟潟ゃ茵障\-implicit 激с潟篏帥違篏絎с障\f3none\fP 絎翫純若鴻＜ゃ鴻＜ゃ障\f3class\fP 絎翫純若鴻＜ゃ鴻＜ゃ障
+型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
.LP
.LP
-潟潟ゃ羈絎篋緇宴綽荀с茯茘翫障宴純若鴻＜ゃ荀ゃ \f3\-implicit\fP 激с潟絎翫＜ゃ羈絲乗院潟潟ゃ潟潟ゃ若吟若茘障茘≦鴻(＜ゃ羈絲乗院) ＜ゃ潟潟茵絎純若鴻＜ゃ絲障鴻＜ゃ鴻 \f3\-implicit\fP 激с潟篏帥ｃ絎障
+コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識しない場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
.LP
-.SH "違ｃゃ潟帥с若"
-.LP
-
+.SH "プログラマティックインタフェース"
.LP
.LP
-\f3javac\fP \f2javax.tools\fP 宴若後鴻ゃ潟帥с若鴻ｃ絎臂違 Java Compiler API 泣若障
+\f3javac\fP は、 \f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
.LP
.SS
-箴
+例
.LP
.LP
-潟潟茵絎綣違篏帥ｃ潟潟ゃ絎茵罨＜潟若篏睡障
+コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
.LP
.nf
\f3
@@ -595,29 +956,24 @@
.fl
int rc = javac.run(null, null, null, args);
.fl
-
-.fl
\fP
.fi
.LP
.LP
-翫罔羣阪鴻若鴻荐堺＜祉若吾吾冴潟潟茵若喝冴 \f3javac\fP 菴腟篋潟若菴障
+この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
.LP
.LP
-\f2javax.tools.JavaCompiler\fP ゃ潟帥с若剛祉＜純篏帥違荐堺＜祉若吾＜ゃ茯水/吾莨若水九勝茵障
+\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
.LP
.SS
-уゃ潟帥с若
-.LP
-.RS 3
-
+旧式のインタフェース
.LP
.LP
-\f3羈:\fP \ API 筝篏篋с腆坂罧障 違潟若с綽菴違 Java Compiler API 篏睡
+\f3注:\fP この API は、下位互換性を確保するためだけに残されています。新しいコードでは、必ず前述の Java Compiler API を使用してください。
.LP
.LP
-\f2com.sun.tools.javac.Main\fP 鴻違潟潟ゃ若喝冴 static ＜純 2 ょ障 罨＜腓冴障
+\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。それらを次に示します。
.LP
.nf
\f3
@@ -626,38 +982,29 @@
.fl
public static int compile(String[] args, PrintWriter out);
.fl
-
-.fl
\fP
.fi
.LP
.LP
-\f2args\fP ＜若帥javac 違絽御検篁紙潟潟茵綣違茵障 网荀ゃ冴綵√膀с
+\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。その概要については、前出の「形式」節を参照してください。
.LP
.LP
-\f2out\fP ＜若帥潟潟ゃ荐堺＜祉若吾阪腓冴障
+\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
.LP
.LP
-祉ゃ\f3javac\fP 腟篋ゃс
+戻り値は、\f3javac\fP の終了値と同じです。
.LP
.LP
- \f2com.sun.tools.javac\fP у障宴若 (綣 \f2com.sun.tools.javac\fP 泣宴若吾ャ) 障\f3篁\fP鴻＜純絎сゃс紊眼醇с障
+名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
.LP
-.RE
-.SH "箴"
+.SH "例"
.LP
.SS
-膂≦違潟潟ゃ
-.LP
-.RS 3
-
+簡単なプログラムのコンパイル
.LP
.LP
-\f2Hello.java\fP 純若鴻＜ゃс\f3greetings.Hello\fP 鴻絎臂障\f2greetings\fP ｃ純若鴻＜ゃ鴻＜ゃ筝≧鴻宴若吾ｃс憜ｃ筝障箴с若吟若鴻鴻篏睡с障障\f3\-d\fP 篏帥ｃャ阪ｃ絎綽荀障
-.LP
-.RS 3
-
+\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。 \f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
.LP
.nf
\f3
@@ -704,24 +1051,14 @@
.fl
Hello Everyone
.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-茲違純若鴻＜ゃ潟潟ゃ
-.LP
-.RS 3
-
+複数のソースファイルのコンパイル
.LP
.LP
-罨＜箴с宴若 \f2greetings\fP 鴻純若鴻＜ゃ潟潟ゃ障
-.LP
-.RS 3
-
+次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
.LP
.nf
\f3
@@ -742,26 +1079,14 @@
.fl
Aloha.java GutenTag.java Hello.java Hi.java
.fl
-
-.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-若吟若鴻鴻絎
-.LP
-.RS 3
-
+ユーザークラスパスの指定
.LP
.LP
-筝箴純若鴻＜ゃ 1 ゃ紊眼紊翫＜ゃ潟潟ゃ障
-.LP
-.RS 3
-
+上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
.LP
.nf
\f3
@@ -772,34 +1097,22 @@
.fl
% \f3javac greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f2greetings.Hi\fP \f2greetings\fP 宴若後祉鴻с潟潟ゃ鴻｢綽荀障筝箴с若吟若鴻鴻宴若吾ｃｃс潟潟ゃ罩ｅ幻絎茵障憜ｃ≫＜ゃ潟潟ゃ翫若吟若鴻鴻 \f2/examples\fP 菴遵綽荀障若吟若鴻鴻潟菴遵\f3CLASSPATH\fP 荐絎号障с \f3\-classpath\fP 激с潟篏帥障
-.LP
-.RS 3
-
+\f2greetings.Hi\fP は、 \f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
.LP
.nf
\f3
.fl
% \fP\f3javac \-classpath /examples /examples/greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-綺 \f2greetings.Hi\fP 紊眼若若ｃｃ若篏帥翫若若ｃｃ若若吟若鴻鴻≪祉鴻сｃ綽荀障
-.LP
-.RS 3
-
+再度 \f2greetings.Hi\fP を変更してバナーユーティリティーを使うようにした場合は、このバナーユーティリティーもユーザークラスパスを通じてアクセスできるようになっている必要があります。
.LP
.nf
\f3
@@ -808,41 +1121,25 @@
.fl
/examples/greetings/Hi.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f2greetings\fP 鴻絎茵\f2greetings\fP \f2greetings\fP 篏帥鴻筝≧鴻≪祉鴻с綽荀障
-.LP
-.RS 3
-
+\f2greetings\fP 内のクラスを実行するには、 \f2greetings\fP と、それが使うクラスの両方にアクセスできる必要があります。
.LP
.nf
\f3
.fl
% \fP\f3java \-classpath /examples:/lib/Banners.jar greetings.Hi\fP
.fl
-
-.fl
.fi
-.RE
.LP
-.RE
.SS
-純若鴻＜ゃ鴻＜ゃ
-.LP
-.RS 3
-
+ソースファイルとクラスファイルの分離
.LP
.LP
-鴻紊ц閞＜吾с翫純若鴻＜ゃ鴻＜ゃャｃ臀箴水障鴻＜ゃ阪ャ絎\f3\-d\fP 篏帥障純若鴻＜ゃ若吟若鴻鴻с\f3\-sourcepath\fP 篏帥ｃ潟潟ゃ純若鴻＜ゃ荀ゃс障
-.LP
-.RS 3
-
+特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
.LP
.nf
\f3
@@ -877,83 +1174,78 @@
.fl
Base.class GoodBye.class
.fl
-
-.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f3羈:\fP \ 潟潟茵с \f2src/farewells/Base.java\fP 絎障＜ゃ潟潟ゃｃ潟潟ゃ障潟潟ゃｈ\f3\-verbose\fP 激с潟篏帥障
+\f3注:\fP コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
.LP
-.RE
.SS
-鴻潟潟ゃ箴
-.LP
-.RS 3
-
+クロスコンパイルの例
.LP
.LP
-с\f3javac\fP 篏帥ｃ1.5 VM 筝у茵潟若潟潟ゃ障
-.LP
-.RS 3
-
+ここでは、\f3javac\fP を使って、1.6 VM 上で実行するコードをコンパイルします。
.LP
.nf
\f3
.fl
-% \fP\f3javac \-target 1.5 \-bootclasspath jdk1.5.0/lib/rt.jar \\
+% \fP\f3javac \-source 1.6 \-target 1.6 \-bootclasspath jdk1.6.0/lib/rt.jar \\
.fl
\-extdirs "" OldCode.java\fP
.fl
-
-.fl
.fi
-.RE
.LP
.LP
-\f3\-target 1.5\fP 激с潟1.5 VM 篋с鴻＜ゃ障с\f3javac\fP JDK 6 潟潟ゃ障
+\f2\-source 1.6\fP オプションにより、 \f2OldCode.java\fP のコンパイルにはバージョン 1.6 (または 6) の Java プログラミング言語が使用されます。\f3\-target 1.6\fP オプションにより、1.6 VM と互換性のあるクラスファイルが生成されます。ほとんどの場合、\f3\-target\fP オプションの値は \f3\-source\fP オプションの値になります。この例では、\f3\-target\fP オプションを省略できます。
.LP
.LP
-Java 若 JDK \f3javac\fP сJava 2 SDK 若鴻鴻絲障潟潟ゃ茵сJava 2 SDK с JDK 1.5 若鴻鴻絲障潟潟ゃ茵絎綽荀障\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥ｃ絎障絎茵1.5 VM 絖 Java 2 若 API 絲上潟潟ゃ茵違絎茵絎潟榊障
+\f3\-bootclasspath\fP オプションを使用して、適切なバージョンのブートストラップクラス ( \f2rt.jar\fP ライブラリ) を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。
.LP
-.RE
-.SH "∫ｉ"
+.nf
+\f3
+.fl
+% \fP\f3javac \-source 1.6 OldCode.java\fP
+.fl
+warning: [options] bootstrap class path not set in conjunction with \-source 1.6
+.fl
+.fi
+
.LP
-
+.LP
+適切なバージョンのブートストラップクラスを指定しない場合、コンパイラは古い言語仕様 (この例では、バージョン 1.6 の Java プログラミング言語) を新しいブートストラップクラスと組み合わせて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラスファイルが古いプラットフォーム (この場合は Java SE 6) で動作しない可能性があります。
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2The javac Guide\fP @
+\f2「The javac Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jdb(1) \- Java
+「jdb(1) \- Java デバッガ」
.TP 2
o
-javah(1) \- C 若鴻帥＜ゃ吾с若帥
+「javah(1) \- C ヘッダーとスタブファイルジェネレータ」
.TP 2
o
-javap(1) \- 鴻＜ゃ≪祉潟
+「javap(1) \- クラスファイル逆アセンブラ」
.TP 2
o
-javadoc(1) \- Java API ャ＜潟吾с若帥
+「javadoc(1) \- Java API ドキュメントジェネレータ」
.TP 2
o
-jar(1) \- JAR ≪若ゃ若
+「jar(1) \- JAR アーカイブツール」
.TP 2
o
.na
-\f2Java ≦宍罘純若若\fP @
+\f2「Java 拡張機能フレームワーク」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.RE
--- a/jdk/src/solaris/doc/sun/man/man1/ja/javadoc.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/javadoc.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,328 +19,244 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javadoc 1 "02 Jun 2010"
-.SH ""
-javadoc \- Java API ャ＜潟吾с若
-.RS 3
-
-.LP
-.LP
-Java 純若鴻＜ゃAPI ャ＜潟 HTML 若吾障ャ＜潟х換篁 Javadoc 箴Sun Solaris 篏睡翫с
-.LP
-.RE
-.SH "綵√"
-.LP
+.TH javadoc 1 "14 Apr 2011"
+.SH "名前"
+javadoc \- Java API ドキュメントジェネレータ
+.LP
+Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、 Solaris を使用した場合のものです。
+.SH "形式"
.LP
\f4javadoc\fP\f2\ [\ \fP\f2options\fP\f2\ ]\ [\ packagenames\ ]\ [\ sourcefilenames\ ]\ [\ \-subpackages\fP\ \f2pkg1:pkg2:...\fP\f2\ ]\ [\ \fP\f2@argfiles\fP\f2\ ]\fP
.LP
-.LP
-綣違絎綺篁紙сJavadoc 若с絲乗院 \f2.java\fP ＜ゃ羆阪号荅括完ゃ純若鴻＜ゃс
-.LP
-.RS 3
-
-.LP
+引数を指定する順序は任意です。Javadoc ツールでの、処理対象の .java ファイルを決定する方法の詳細については、「ソースファイルの処理」\f2を参照\fPしてください。
.RS 3
.TP 3
options
-ャ＜潟ц潟潟茵激с潟сJavadoc 激с潟罔羣篏睡羈ゃ篏睡箴с
+このドキュメントで説明されているコマンド行オプションです。Javadoc オプションの標準的な使用法については、「使用例」を参照してください。
.TP 3
packagenames
-鴻若鴻у阪筝ｃ宴若後с 違\f2java.lang\ java.lang.reflect\ java.awt\fP 絎障ャ＜潟宴若吾ャ絎綽荀障ゃ若篏睡筝с 絽亥\-subpackages 篏睡障Javadoc 若\f2\-sourcepath\fP 篏帥ｃ宴若後罎膣≪障1 や札筝宴若吾ャ＜潟箴с
+スペースで区切られた一連のパッケージ名です。たとえば、 \f2java.lang\ java.lang.reflect\ java.awt のように指定します\fP。ドキュメント化するパッケージを個別に指定する必要があります。ワイルドカードは使用不可です。再帰的処理のためには、\-subpackages を使用します。Javadoc ツールは、\f2\-sourcepath\fP を使用してこれらのパッケージ名を検索します。「1 つ以上のパッケージのドキュメント化」の例を参照してください。
.TP 3
sourcefilenames
-鴻若鴻у阪筝ｃ純若鴻＜ゃс＜ゃ鴻у障障≪鴻帥鴻 (*) ゃ若с障 Javadoc 若＜ゃ.java≦宍絖х≦宍絖ゃ絎鴻劫с鴻＜ゃс (
+スペースで区切られた一連のソースファイル名です。 各ファイルは、パスで始まります。アスタリスク (*) などのワイルドカードを含めることができます。Javadoc ツールが処理するのは、ファイル名が「.java」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです (
.na
-\f2Identifiers\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)ｃゃ潟 (\f2X\-Buffer\fP ) 篁≦鴻絖篁ｃ＜ゃャ＜潟絲乗院ゅс障鴻＜ゃ潟若＜ゃ翫箴水с 純若鴻＜ゃ絎鴻ｃjavadoc ＜ゃ罎膣≪贋羆冴障障Javadoc 若純若鴻＜ゃ罎膣≪ \f2\-sourcepath\fP 篏帥障後障鴻憜ｃ後障鴻с \f2Button.java\fP 羝＜\f2./Button.java\fP 羝＜с純若鴻＜ゃ鴻ф絎\f2/home/src/java/awt/Graphics*.java\fP 障1 や札筝鴻ャ＜潟箴с障宴若吾鴻ャ＜潟箴宴若後純若鴻＜ゃ羞桁с障
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)。したがって、ハイフンを含む名前 ( \f2X\-Buffer\fP など) や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。ソースファイル名の前に指定したパスによって、javadoc がそのファイルを検索する場所が決まります。Javadoc ツールは、これらのソースファイル名を検索するときには \f2\-sourcepath\fP を使用しません。相対パスは現在のディレクトリを起点とするため、 \f2Button.java\fP を渡すことは、 \f2./Button.java\fP を渡すことと同じです。ソースファイル名をフルパスで指定すると、 \f2/home/src/java/awt/Graphics*.java のようになります\fP。 「1 つ以上のクラスのドキュメント化」の例を参照してください。また、「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。
.TP 3
\-subpackages pkg1:pkg2:...
-純若鴻＜ゃ絎宴若吾潟泣宴若後絽亥ャ＜潟障宴若後障純若鴻＜ゃ絎綽荀障
+ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。パッケージ名またはソースファイル名を指定する必要はありません。
.TP 3
@argfiles
-Javadoc 激с潟宴若後潟純若鴻＜ゃ篁紙綺т研鴻鴻障 1 や札筝＜ゃс＜ゃ筝сゃ若 (*) \f2\-J\fP 激с潟絎с障
-.RE
-
-.LP
+Javadoc オプション、パッケージ名、およびソースファイル名を任意の順序で並べたリストが含まれる 1 つ以上のファイルです。ワイルドカード (*) や \f2\-J\fP オプションは、このファイルの中では指定できません。
.RE
-.SH " 茯"
-.LP
-.LP
-\f3Javadoc\fP 若筝ｃ Java 純若鴻＜ゃ絎ｈ潟ャ＜潟若激с潟潟＜潟茹ｆс public 鴻protected 鴻ャ絖 (水鴻ゃ)ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ゃ茯筝ｃ HTML 若吾障障API (≪宴若激с潟違潟違ゃ潟帥с若) ャ＜潟筝ｃ純若鴻＜ゃ絎茖ャ＜潟篏睡с障
-.LP
-.LP
-Javadoc 若宴若後篏純若鴻＜ゃ障筝≧鴻絲障絎茵с障javadoc 若宴若後篏絲障絎茵翫筝篏ｃ絽亥 \f2\-subpackages\fP 篏睡宴若後腓榊鴻羝＜障純若鴻＜ゃ絲障 javadoc 絎茵翫筝ｃ純若 (\f2.java\fP) ＜ゃ羝＜障隙箴ャ＜潟緇膣剛障罨＜Javadoc 純若鴻＜ゃゃ茯障
-.LP
+.SH " 説明"
+.LP
+\f3Javadoc\fP ツールは、一連の Java ソースファイルにある宣言およびドキュメンテーションコメントを解析し、デフォルトでは public クラス、protected クラス、入れ子にされたクラス (匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。
+.LP
+Javadoc ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fP を使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々ソースファイルに対して javadoc を実行する場合は、一連のソース (.\f2.java\fP) ファイル名を渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadoc によるソースファイルの処理について説明します。
.SS
-純若鴻＜ゃ
-.LP
-.LP
-Javadoc 若絨障 \f2.java\fP 篁＜ゃ篁ュ純若鴻＜ゃц篁＜ゃ障純若鴻＜ゃ腓榊羝＜ｃ Javadoc 若絎茵翫 \f2.java\fP ＜ゃ罩ｇ∈絎с障紊肴号с篏罐障 宴若後羝＜祉膂≦с純若鴻＜ゃ腓榊絎Javadoc 若 3 ゃ号у茵с障号(1) 宴若後羝＜(2) \f2\-subpackages\fP 篏睡(3) 純若鴻＜ゃゃ若篏睡 (\f2*.java\fP) 号с号篏睡翫Javadoc 若\f2.java\fP ＜ゃ罨＜鴻荀篁吟羣翫＜ゃ障
-.LP
+ソースファイルの処理
+.LP
+Javadoc ツールは、末尾が「\f2.java\fP」のファイルを処理するだけでなく、「ソースファイル」で説明するその他のファイルも処理します。個々のソースファイル名を明示的に渡すことによって Javadoc ツールを実行する場合、どの \f2.java\fP ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソースファイル名を明示的に指定しなくても、Javadoc ツールは 3 つの方法で実行できます。その方法とは、(1) パッケージ名を渡す、(2) \f2\-subpackages\fP を使用する、(3) ソースファイル名でワイルドカードを使用する (\f2*.java\fP)、の 3 つです。これらの場合、Javadoc ツールが「\f2.java\fP」ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合だけです。
.RS 3
.TP 2
o
- \f2.java\fP ･絨乗ゃ絎鴻劫ｃ (鴻絖ゃ
+名前から接尾辞「\f2.java\fP」を取り除くと実際に有効なクラス名になっている (有効な文字については
.na
-\f2Identifiers\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)
.TP 2
o
-純若鴻若若後丞ｃ鴻阪絖紊絎鴻宴若後ｃ
+ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている
.TP 2
o
-宴若御鴻宴若後障 (ф絎)
+パッケージ文には有効なパッケージ名が含まれる (前項目で指定)
.RE
-
-.LP
-.LP
-\f3潟\fP \- Javadoc 若絎茵筝絎茵сャ＜潟宴若吾鴻潟＜潟若絲障娯с潟菴遵障潟罨＜贋菴遵障
-.LP
+.LP
+\f3リンクの処理\fP \- Javadoc ツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。
.RS 3
.TP 2
o
-絎ｈ (祉ゃ綣違ｃ若)
+宣言 (戻り値の型、引数の型、フィールドの型)
.TP 2
o
-\f2@see\fP 帥違 [∫ｉ] 祉激с
+\f2@see\fP タグから生成された [関連項目] セクション
.TP 2
o
-\f2{@link}\fP 帥違ゃ潟ゃ潟鴻
+\f2{@link}\fP タグから生成されたインラインテキスト
.TP 2
o
-\f2@throws\fP 帥違箴紊
+\f2@throws\fP タグから生成された例外の名前
.TP 2
o
-"ゃ潟帥с若鴻＜潟若絲障 [絎臂] 潟鴻＜潟若絲障 [若若ゃ] 潟
+インタフェースのメンバーに対する「定義」リンクと、クラスのメンバーに対する「オーバーライド」リンク
.TP 2
o
-宴若吾鴻潟＜潟若网荀若
+パッケージ、クラス、およびメンバーを列挙している概要テーブル
.TP 2
o
-宴若吾潟鴻膓帥
+パッケージおよびクラスの継承ツリー
.TP 2
o
-膣√
+索引
.RE
-
-.LP
-.LP
-潟潟茵ф絎ｃ鴻ゃ√鴻 (ャ鴻) 絲障ゃ若潟菴遵\f2\-link\fP \f2\-linkoffline\fP 激с潟с障
-.LP
-.LP
-\f3篁ゃ荅括完\fP \- Javadoc 若絎茵潟 1 ゃ絎ャ＜潟篏障 ャ＜潟菴遵с障 ゃ障Javadoc 若篁ュ絎茵腟篆罩ｃ絎鴻贋･腟水ャс障菴違篁ュ絎茵腟絲障潟菴遵с障
-.LP
-.LP
-絎茖筝宴Javadoc 若絎茵 java 潟潟ゃ綽荀java 潟潟ゃ箴絖障Javadoc 若 \f2javac\fP 筝若喝冴絎ｈ潟潟ゃ＜潟若絎茖∴障Javadoc 若拷絮ゃ鴻莟絲茵憗鴻篏睡≫罕膀宴 HTML 障Javadoc 若純若鴻潟若ャ＜潟若激с潟潟＜潟若吟若箴ャ＜潟緇障
-.LP
-.LP
-Javadoc 若＜純篏膣膕鴻帥＜ゃс \f2.java\fP 純若鴻＜ゃ絲障絎茵с障ｃAPI 篏絎茖荐菴違荐荐罧級сャ＜潟若激с潟潟＜潟荐菴違 javadoc 若絎茵с障
-.LP
-.LP
-潟潟ゃ箴絖ｃHTML 阪絎絎茖罩ｇ∈絲上障 絎絎茖腓榊純若鴻潟若с藥純若鴻潟若箴絖翫障違Javadoc 若\f2.class\fP ＜ゃ絖純若鴻潟若絖
+.LP
+コマンド行で指定しなかったクラスについての既存のテキスト (別に生成したテキスト) に対してハイパーリンクを追加するには、\f2\-link\fP および \f2\-linkoffline\fP オプションを利用できます。
+.LP
+\f3その他の処理についての詳細\fP \- Javadoc ツールは、実行するたびに 1 つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadoc ツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。ただし、前述のように、以前の実行結果に対してリンクを追加することはできます。
+.LP
+実装上の理由から、Javadoc ツールは、処理を実行するために java コンパイラを必要とし、java コンパイラに依存しています。Javadoc ツールは、 \f2javac\fP の一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。Javadoc ツールは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報から HTML を生成します。さらに、Javadoc ツールは、ソースコードのドキュメンテーションコメントから、ユーザーの提供したドキュメントも取得します。
+.LP
+実際には、Javadoc ツールは、メソッド本体を持たない純粋なスタブファイルであるような \f2.java\fP ソースファイルでも動作します。したがって、API の作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーションコメントを記述して javadoc ツールを実行できます。
+.LP
+コンパイラに依存することによって、HTML 出力は、実際の実装に正確に対応します。実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。たとえば、Javadoc ツールは、.class ファイルには存在するがソースコードには存在しない
.na
-\f2潟潟鴻\fP @
+\f2デフォルトコンストラクタ\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 荐茯篁罕祉激с 8.6.7) ャ＜潟障
-.LP
-.LP
-絽吾Javadoc 若с純若鴻＜ゃ潟若筝絎障若с翫сャ＜潟с障違激ャ若ｃ潟違絎篋ャ＜潟с障違Java 荐茯篁罕処院＜純鴻篏処院絎ｈ違障若罎冴javac 潟潟ゃ罩≪障Javadoc 若茘冴膓茵障Javadoc 若ャ＜潟若激с潟潟＜潟堺с茵障ャ＜潟若激с潟潟＜潟荅潟с綽荀翫DocCheck 篏睡
-.LP
-.LP
-Javadoc 若ャ＜潟罕罕膀с鴻鴻若障Javadoc 若若鴻鴻≦宍罘純障若吟若鴻鴻с鴻罎膣≪с違障荅括完
+http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 言語仕様のセクション 8.6.7) \f2をドキュメント化\fP します。
+.LP
+通常、Javadoc ツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、Java 言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。このエラーを検出すると、javac コンパイラは停止しますが、Javadoc ツールは警告を出さずに処理を続行します。Javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、DocCheck ドックレットを使用してください。
+.LP
+Javadoc ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadoc ツールは、ブートストラップクラス、拡張機能、またはユーザークラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、
.na
-\f2鴻罎膣∽号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlс絽吾篏鴻≦宍罘純若Javadoc 若鴻劫臀鏆荀障
-.LP
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadoc ツールのクラスパス内に置く必要があります。
.SS
-Javadoc
-.LP
-.LP
-Javadoc 若阪絎鴻綵√篏帥ｃ鴻帥ゃ冴с障Javadoc 若罔羣若違腟粋昭帥障 罔羣HTML 綵√ API ャ＜潟障罔羣篆罩ｃ障泣劫HTMLXMLMIFRTF 絅純帥阪綵√荐菴違純с篏睡羈ゃ罨＜с
-.LP
+Javadoc のドックレット
+.LP
+Javadoc ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadoc ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。標準ドックレットは、HTML 形式の API ドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTF などの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。
.RS 3
.TP 2
o
.na
-\f2Javadoc \fP @
+\f2Javadoc のドックレット\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
.TP 2
o
-\f2\-doclet\fP 潟潟茵激с
+\f2\-doclet\fP コマンド行オプション
.RE
-
-.LP
-.LP
-\f2\-doclet\fP 潟潟茵激с潟с鴻帥絎翫Javadoc 若罔羣篏睡障javadoc 若篏睡≫鋎睡с潟潟茵激с潟障罔羣с祉ゃ潟潟茵激с潟菴遵障＜激с潟ゃ激с潟ц障
-.LP
+.LP
+\f2\-doclet\fP コマンド行オプションでカスタムドックレットが指定されていない場合、Javadoc ツールは、デフォルトの標準ドックレットを使用します。javadoc ツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。
.SS
-∫ｃャ＜潟潟
-.LP
+関連ドキュメントおよびドックレット
.RS 3
.TP 2
o
.na
-\f2Javadoc 純罘遵七\fP @
+\f2Javadoc に施された拡張機能\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc ц申壕鴻荅括完
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc 1.4 で追加された改良点の詳細
.TP 2
o
.na
\f2Javadoc FAQ\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html \- 紫絲莖絲障膈Javadoc ∫ｃ若ゃ宴潟違炊号
+http://java.sun.com/j2se/javadoc/faq/index.html \- 頻繁に寄せられる質問に対する回答、Javadoc 関連のツールについての情報、およびバグの回避方法
.TP 2
o
.na
\f2How to Write Doc Comments for Javadoc\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ャ＜潟若激с潟潟＜潟荐菴井号≪ Sun 荀靘
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ドキュメンテーションコメントの記述方法に関する Sun の規約
.TP 2
o
.na
\f2Requirements for Writing API Specifications\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java 2 若篁罕荐菴違篏睡罔羣荀篁吟宴純若鴻＜ゃャ＜潟若激с潟潟＜潟綵√ API 篁罕荐菴違翫篁綵√ц菴違翫綵合＜障罎荐弱純≪泣若激с潟羣宴若吾鴻ゃ潟帥с若鴻ｃ若潟＜純ゃ荀篁吟絎障
+http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java SE プラットフォーム仕様を記述する際に使用された標準要件この情報は、ソースファイルのドキュメンテーションコメント形式で API 仕様を記述する場合にも、その他の形式で記述する場合にも役立ちます。検証可能なアサーションを満たすパッケージ、クラス、インタフェース、フィールド、およびメソッドについての要件を定めています。
.TP 2
o
.na
-\f2ャ＜潟若激с潟潟＜潟篁罕\fP @
+\f2ドキュメンテーションコメントの仕様\fP @
.fi
-http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ャ＜潟若激с潟潟＜潟吾篁罕ゃJava Language Specification (James GoslingBill JoyGuy Steele 沿) 膃 18 腴Documentation Commentsс腴膃 2 сゃ障
+http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ドキュメンテーションコメントのオリジナル仕様については、『Java Language Specification』 (James Gosling、Bill Joy、Guy Steele 共著) の初版の第 18 章「Documentation Comments」を参照してください。この章は、第 2 版では削除されました。
.TP 2
o
.na
-\f2DocCheck \fP @
+\f2DocCheck ドックレット\fP @
.fi
-http://java.sun.com/javadoc/doccheck \- 純若鴻＜ゃャ＜潟若激с潟潟＜潟с罎冴若筝罩ｃ若障Sun Doc Check 若ｃｃ若筝сSun Doc Check 若ｃｃ若筝с
+http://java.sun.com/javadoc/doccheck \- ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Check ユーティリティーの一部です。
.TP 2
o
.na
-\f2MIF \fP @
+\f2MIF ドックレット\fP @
.fi
-http://java.sun.com/javadoc/mifdoclet \- MIFFrameMakerPDF 後 API ャ＜潟障MIF Adobe FrameMaker 篋ゆ後с
+http://java.sun.com/javadoc/mifdoclet \- MIF、FrameMaker、PDF の書式で API ドキュメントを自動生成します。MIF は Adobe FrameMaker の交換書式です。
.RE
-
-.LP
.SS
-茯
-.LP
-.LP
-\f2ャ＜潟若激с潟潟＜潟\fP\f2doc 潟＜潟\fP\f2筝肢\fP\f2帥違\fP\f2帥違\fP\f2ゃ潟ゃ潟帥違\fP茯ゃャ＜潟若激с潟潟＜潟ц障罨＜篁茯Javadoc 若潟潟鴻х劫潟＜障
-.LP
+用語
+.LP
+\f2「ドキュメンテーションコメント」\fP、\f2「doc コメント」\fP、\f2「主説明」\fP、\f2「タグ」\fP、\f2「ブロックタグ」\fP、および\f2「インラインタグ」\fPの用語については、「ドキュメンテーションコメント」で説明します以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。
.RS 3
.TP 3
-ャ＜潟 (generated document)
-javadoc 若 Java 純若鴻潟若ャ＜潟若激с潟潟＜潟ャ＜潟сャ＜潟 HTML 綵√с罔羣ｃ篏障
+生成ドキュメント (generated document)
+javadoc ツールが Java ソースコード内のドキュメンテーションコメントから生成したドキュメントのことです。デフォルトの生成ドキュメントは HTML 形式で、標準ドックレットによって作成されます。
.LP
.TP 3
- (name)
-Java 荐茯ф吾違荀膣ゃ障宴若吾鴻ゃ潟帥с若鴻ｃ若潟潟鴻帥障＜純с\f2java.lang.String.equals(java.lang.Object)\fP 絎篆蕋障\f2equals(Object)\fP 篆蕋障с障
+名前 (name)
+Java 言語で書かれたプログラム要素の名前、つまりパッケージ、クラス、インタフェース、フィールド、コンストラクタ、またはメソッドの名前のことです。名前は、 \f2java.lang.String.equals(java.lang.Object)\fP のような完全修飾名にすることも、 \f2equals(Object)\fP のような部分修飾名にすることもできます。
.LP
.TP 3
-ャ＜潟 (documented classes)
-javadoc 若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻сャ＜潟純若鴻＜ゃ篏睡純с違純若鴻＜ゃ障宴若後 javadoc 潟潟羝＜≪祉剛信蕋上 (publicprotectedpackage\-private 障 private) ｃｃ水違障ャ＜潟鴻javadoc 若阪腟粋昭障鴻ゃ障鴻若違障
+ドキュメント化されるクラス (documented classes)
+javadoc ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。ドキュメント化するには、ソースファイルが使用可能でなければならず、ソースファイル名またはパッケージ名を javadoc コマンドに渡され、アクセス修飾子 (public、protected、package\-private または private) によってフィルタ処理されないようにしなければなりません。ドキュメント化されるクラスは、javadoc ツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。
.LP
.TP 3
- (included classes)
-若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻сャ＜潟鴻
+包含クラス (included classes)
+ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」と同じ。
.LP
.TP 3
-ゅ (excluded classes)
-若絎茵ｃ荅括完ャ＜潟鴻潟ゃ潟帥с若鴻с
+除外クラス (excluded classes)
+ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。
.LP
.TP 3
-с (referenced classes)
-ャ＜潟鴻潟ゃ潟帥с若鴻絎臂 (絎茖) 障ャ＜潟若激с潟潟＜潟筝ф腓榊с鴻潟ゃ潟帥с若鴻сс箴祉ゃ＜若帥ｃ鴻≦宍鴻絎茖ゃ潟帥с若鴻ゃ潟若鴻＜純篏т戎鴻@see{@link}{@linkplain}{@inheritDoc} 帥違障絎臂
+参照クラス (referenced classes)
+ドキュメント化されるクラスおよびインタフェースの定義 (実装) またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc} タグなどがあります。この定義は
.na
\f21.3\fP @
.fi
-http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses 紊眼障javadoc 若絎茵Javadoc 若鴻鴻潟鴻劫鴻с鴻＜≪若若綽荀障с鴻荀ゃ翫鴻荀ゃ障茘茵腓冴障Javadoc 若鴻絖＜潟若絎絎ゅャ綽荀鴻宴.class ＜ゃ綣冴с障
+http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses から変更されています。javadoc ツールを実行するときは、Javadoc のブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。Javadoc ツールは、クラスの存在とそのメンバーの完全指定の名前を判別するのに必要なすべての情報を、.class ファイルから引き出すことができます。
.LP
.TP 3
-紊с (external referenced classes)
-с鴻＜javadoc 若絎茵筝ャ＜潟鴻сゃ障鴻潟潟茵 Javadoc 若羝＜障ャ＜潟с鴻潟膊紊с障紊潟若違障違\f2java.awt\fP 宴若吾絲障 Javadoc 若絎茵翫\f2Object\fP \f2java.lang\fP 鴻鴻紊с鴻障紊с鴻潟\f2\-link\fP \f2\-linkoffline\fP 激с潟篏睡障紊с鴻絽吾純若鴻潟＜潟 javadoc 若絎茵ус荀劫彰障翫潟＜潟膓帥с障
+外部参照クラス (external referenced classes)
+参照クラスのうち、javadoc ツールの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンド行で Javadoc ツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。たとえば、Javadoc ツールの実行対象が \f2java.awt\fP パッケージのみである場合、 \f2java.lang\fP 内のすべてのクラス ( \f2Object\fPなど) が外部参照クラスになります。外部参照クラスにリンクするには、 \f2\-link\fP および \f2\-linkoffline\fP オプションを使用します。外部参照クラスには、通常そのソースコメントを javadoc ツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。
.RE
-
-.LP
-.SH "純若鴻＜ゃ"
-.LP
-.LP
-Javadoc 若4 腮蕁違純若鴻＜ゃ阪腟障＜ゃ鴻 Java 荐茯純若鴻＜ゃ (\f2.java\fP)宴若吾潟＜潟＜ゃ网荀潟＜潟＜ゃ潟篁＜ゃс障ャ＜潟純若鴻若絖翫鴻＜ゃ潟若＜ゃゃ茯障
-.LP
+.SH "ソースファイル"
+.LP
+Javadoc ツールは 4 種類の異なる「ソース」ファイルから出力を生成します。その 4 種類とは、クラスの Java 言語ソースファイル (\f2.java\fP)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートファイルについても説明します。
.SS
-鴻純若鴻潟若＜ゃ
-.LP
-.LP
-鴻障ゃ潟帥с若鴻潟＜潟若ャ＜潟若激с潟潟＜潟ゃс \f2.java\fP ＜ゃ篆障ャ＜潟若激с潟潟＜潟荅括完ャ＜潟若激с潟潟＜潟с
-.LP
+クラスソースコードファイル
+.LP
+それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーションコメントを持つことができ、それを \f2.java\fP ファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。
.SS
-宴若吾潟＜潟＜ゃ
-.LP
-.LP
-宴若吾ャ＜潟若激с潟潟＜潟ゃс絨純若鴻＜ゃ篆障 絎鴻Javadoc 若ｃ网荀若吾腟粋昭障障潟＜潟絽吾宴若後篏綵障ャ＜潟荐菴違障
-.LP
-.LP
-宴若吾潟＜潟＜ゃ篏翫潟＜潟主罨＜ 2 ゃ＜ゃ御с障
-.LP
+パッケージコメントファイル
+.LP
+それぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。
+.LP
+パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。
.RS 3
.TP 2
o
-\f2package\-info.java\fP \- 宴若後ｈ宴若御絵宴若吾潟＜潟 Javadoc 帥違主с障＜ゃ JDK 5.0 уャсpackage.html ｨ絅障
+\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは一般に、package.html よりも推奨されます。
.TP 2
o
-\f2package.html\fP \- 主с宴若吾潟＜潟 Javadoc 帥違с 宴若御絵主с障
+\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。
.RE
-
-.LP
-.LP
-宴若吾筝 \f2package.html\fP ＜ゃ筝 \f2package\-info.java\fP ＜ゃゃс障筝≧鴻ゃс障＜＜ゃ \f2.java\fP ＜ゃ純若鴻弱宴若吾ｃ臀
-.LP
-.LP
-\f4package\-info.java\fP \- ＜ゃ罨＜罕宴若吾潟＜潟主с障 潟＜潟宴若後ｈ臀障
-.LP
-.LP
-File:\f2java/applet/package\-info.java\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+各パッケージでは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを選択できますが、その両方を選択することはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。
+.LP
+\f4package\-info.java\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントはパッケージ宣言の前に配置します。
+.LP
+File: \f2java/applet/package\-info.java\fP
.nf
\f3
.fl
/**
.fl
- * Provides the classes necessary to create an
+ * Provides the classes necessary to create an
.fl
* applet and the classes an applet uses
.fl
@@ -372,285 +288,91 @@
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 352 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
-
-.LP
-.LP
-潟＜潟阪絖 \f2/**\fP \f2/*\fP 荐菴違綽荀障筝茵茵≪鴻帥鴻ャ障障
-.LP
-.LP
-\f4package.html\fP \- ＜ゃ罨＜罕宴若吾潟＜潟主с障 潟＜潟 \f2<body>\fP 荀膣臀障
-.LP
-.LP
-File:\f2java/applet/package.html\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+コメント区切り文字の \f2/**\fP と \f2/*\fP は存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。
+.LP
+\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。
+.LP
+File: \f2java/applet/package.html\fP
.nf
\f3
.fl
-<HTML>
-.fl
-<BODY>
-.fl
-Provides the classes necessary to create an applet and the
-.fl
-classes an applet uses to communicate with its applet context.
-.fl
-<p>
+<HTML> <BODY> Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.<p>
.fl
The applet framework involves two entities: the applet
.fl
-and the applet context. An applet is an embeddable
-.fl
-window (see the {@link java.awt.Panel} class) with a
-.fl
-few extra methods that the applet context can use to
-.fl
-initialize, start, and stop the applet.
-.fl
-
-.fl
-@since 1.0
-.fl
-@see java.awt
-.fl
-</BODY>
-.fl
-</HTML>
+and the applet context. An applet is an embeddable window (see the {@link java.awt.Panel} class) with a few extra methods that the applet context can use to initialize, start, and stop the applet.@since 1.0 @see java.awt </BODY> </HTML>
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 405 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-40
-
-.LP
-.LP
-絽吾 HTML ＜ゃс宴若後ｈс鴻羈宴若吾潟＜潟＜ゃ絎鴻祉鴻潟＜潟罕 HTML ц菴違障ャ＜潟若激с潟潟＜潟潟＜潟阪絖с \f2/**\fP \f2*/\fP活≪鴻帥鴻с潟＜潟吾翫宴若吾网荀\f2<body>\fP 帥ゃ篁鴻障宴若吾帥違с障祉ャ＜潟若激с潟潟＜潟罕鴻帥違筝肢臀違障宴若吾潟＜潟＜ゃ \f2@see\fP 帥違菴遵翫絎絎篏睡綽荀障荅括完
+.LP
+これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述しますが、1 つだけ例外があります。それは、このドキュメンテーションコメントには、コメント区切り文字 である \f2/**\fP と \f2*/\fP 、および行頭のアスタリスクを含めてはならない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、 \f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、すべてのブロックタグは、主説明のあとに置かなければなりません。 \f2@see\fP タグをパッケージコメントファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、
.na
-\f2package.html\fP 箴 @
+\f2package.html\fPの例 @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsс
-.LP
-.LP
-\f3宴若吾潟＜潟＜ゃ\fP \- Javadoc 若絎茵宴若吾潟＜潟＜ゃ罎膣≪＜ゃ荀ゃ罨＜茵障
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsを参照してください。
+.LP
+\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。
.RS 3
.TP 2
o
-с潟＜潟潟若 (\f2package.html\fP 翫с違\f2<body>\fP \f2</body>\fP HTML 帥違絎鴻鴻潟若\f2<head>\fP \f2<title>\fP 純若鴻＜ゃ篏罔荐菴違宴臀с緇ャ＜潟若激с潟筝茵腓冴)
+処理できるようにコメントをコピーする( \f2package.html\fP の場合であれば、 \f2<body>\fP と \f2</body>\fP HTML タグの間にある内容をすべてコピーする。 \f2<head>\fP セクションを含め、そこに \f2<title>\fP やソースファイルの著作権記述などの情報を配置することもできるが、生成後のドキュメンテーションにはそれらは一切表示されない)
.TP 2
o
-宴若吾帥違違鴻
+パッケージタグがあれば、すべて処理する
.TP 2
o
-宴若吾网荀若吾緇鴻水ャ (箴:
+生成したパッケージの概要ページの最後に、処理したテキストを挿入する (例:
.na
-\f2宴若吾网荀\fP @
+\f2パッケージの概要\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html)
.TP 2
o
-宴若吾网荀若吾宴若吾潟＜潟潟若网荀若吾宴若吾鴻宴若後宴若吾潟＜潟菴遵 (箴:
+パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例:
.na
-\f2网荀荀膣\fP @
+\f2概要の要約\fP @
.fi
-http://java.sun.com/javase/6/docs/api/overview\-summary.html)絨障鴻＜潟若筝肢絨障荀ｃゆ
+http://java.sun.com/javase/6/docs/api/overview\-summary.html)。文の末尾は、クラスやメンバーの主説明の最初の文の末尾と同じ規則によって判断される
.RE
-
-.LP
.SS
-网荀潟＜潟＜ゃ
-.LP
-.LP
-ャ＜潟≪宴若激с潟障宴若吾祉网荀ャ＜潟若激с潟潟＜潟ゃс絨純若鴻＜ゃ篆障 絎鴻Javadoc 若ｃ网荀若吾腟粋昭障障潟＜潟絽吾≪宴若激с潟障宴若吾祉篏綵障ャ＜潟荐菴違障
-.LP
-.LP
-网荀潟＜潟＜ゃ篏翫＜ゃ篁紙篁篁紙贋臀с障絽吾＜ゃ \f4overview.html\fP 純若鴻若筝篏臀障違\f2java.applet\fP 宴若吾純若鴻＜ゃ \f2/home/user/src/java/applet\fP ｃ障翫\f2/home/user/src/overview.html\fP 网荀潟＜潟＜ゃ篏с障
-.LP
-.LP
-違宴若吾祉絲障 javadoc 茲医絎茵翫 1 ゃ純若鴻＜ゃ祉絲障茲違网荀潟＜潟＜ゃ篏с障違ャ＜潟若激с括 \-private 絎 javadoc 1 絎茵ャ＜潟若激с括激с潟絎у綺絎茵с障翫网荀潟＜潟＜ゃ 1 сャ＜潟若激с潟障荐菴違с障
-.LP
-.LP
-网荀潟＜潟＜ゃ絎鴻菴違宴若吾潟＜潟＜ゃ罕HTML ц菴違 1 ゃ紊сャ＜潟若激с潟潟＜潟с荅括完菴違茯с荀鴻膵違菴潟＜潟荐菴違翫≪宴若激с潟障宴若吾祉荀膣\f2<body>\fP 帥ゃ篁鴻障网荀帥違с障 ャ＜潟若激с潟潟＜潟ゃゃ潟ゃ潟帥 (\f2{@link}\fP ) 篁ュ鴻帥違筝肢臀鏆荀障\f2@see\fP 帥違菴遵翫絎絎篏睡違障
-.LP
-.LP
-Javadoc 若絎茵\-overview 激с潟篏帥ｃ网荀潟＜潟＜ゃ絎障＜ゃ宴若吾潟＜潟＜ゃ障
-.LP
+概要コメントファイル
+.LP
+ドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。
+.LP
+概要コメントファイルを作成するには、ファイルに任意の名前 (通常は \f4overview.html\fP) を付け、それを任意の場所 (通常はソースツリーの最上位) に配置できます。たとえば、 \f2java.applet\fP パッケージのソースファイルが \f2/home/user/src/java/applet\fP ディレクトリに格納されていれば、概要コメントファイルは \f2/home/user/src/overview.html に作成できます\fP。
+.LP
+異なるパッケージのセットに対して javadoc を複数回実行する場合は、同じ 1 つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。たとえば、内部ドキュメンテーション用に \-private を指定して javadoc を 1 回実行したあと、公開ドキュメンテーション用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメントファイルの 1 文目で、そのドキュメンテーションを公開用または内部用として記述できます。
+.LP
+概要コメントファイルの内容は、前述のパッケージコメントファイルと同様、HTML で記述された 1 つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、 \f2<body>\fP と最初の文の間にタイトルその他のテキストを含めないようにします。概要タグを含めることができます。ほかのドキュメンテーションコメントと同じく、 \f2{@link}\fP などのインラインタグを除くすべてのタグは、主説明のあとに配置する必要があります。 \f2@see\fP タグを追加する場合には、完全修飾名を使用する必要があります。
+.LP
+Javadoc ツールの実行時に、\-overview オプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。
.RS 3
.TP 2
o
-\f2<body>\fP 帥違 \f2</body>\fP 帥違鴻絎鴻潟若
+\f2<body>\fP タグと \f2</body>\fP タグの間にあるすべての内容を処理対象としてコピーする
.TP 2
o
-网荀帥違違鴻
+概要タグがあれば、すべて処理する
.TP 2
o
-网荀若吾緇鴻水ャ (箴:
+生成した概要ページの最後に、処理したテキストを挿入する (例:
.na
-\f2网荀荀膣\fP @
+\f2概要の要約\fP @
.fi
http://java.sun.com/javase/6/docs/api/overview\-summary.html)
.TP 2
o
-网荀若吾网荀潟＜潟潟若
+概要ページの先頭に、概要コメントの最初の文をコピーする
.RE
-
-.LP
.SS
-篁＜ゃ
-.LP
-.LP
-純若鴻Javadoc 若ｃｃ潟若篁篁紙＜ゃс障筝＜ゃ違ｃ＜ゃ泣潟 Java 純若 (.java) 潟 (.class) ＜ゃ絎鴻絽吾 Java 純若鴻＜ゃャ＜潟若激с潟潟＜潟綵演帥腴 HTML ＜ゃ障
-.LP
-.LP
-＜ゃ純若鴻＜ゃ \f4doc\-files\fP ｃ臀障 ｃ純若鴻＜ゃ篁紙宴若吾ｃ筝篏с障泣ｃ宴若吾 1 ょс障ゃ＜若吾泣潟潟若純若鴻＜ゃ.class ＜ゃ≪ HTML ＜ゃｃ主с障違帥潟ゃ＜若 \f2button.gif\fP \f2java.awt.Button\fP 鴻ャ＜潟翫＜ゃ \f2/home/user/src/java/awt/doc\-files/\fP ｃ臀障\f2doc\-files\fP ｃ \f2/home/user/src/java/doc\-files\fP 臀с障 \f2java\fP 宴若吾сｃ純若鴻＜ゃャｃс
-.LP
-.LP
-＜ゃ吾潟鴻腓榊荐菴違綽荀障 Javadoc 若＜ゃ荀ｃ絎鴻潟若с違\f2Button.java\fP ャ＜潟若激с潟潟＜潟潟罨＜障
-.LP
+その他の未処理のファイル
+.LP
+ソースには、Javadoc ツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。一般に、このようなファイルには、グラフィックファイル、サンプルの Java ソース (.java) およびクラス (.class) ファイル、内容が通常の Java ソースファイルのドキュメンテーションコメントの影響を受けない独立した HTML ファイルなどがあります。
+.LP
+処理されないファイルを含めるには、\f4doc\-files\fP という名前のディレクトリ内にそれらのファイルを配置します。このディレクトリは、ソースファイルが格納された任意のパッケージディレクトリのサブディレクトリにします。このようなサブディレクトリは、パッケージごとに 1 つ用意できます。イメージ、サンプルコード、ソースファイル、.class ファイル、アプレット、および HTML ファイルをこのディレクトリに格納できます。たとえば、ボタンの画像 \f2button.gif\fP を \f2java.awt.Button\fP クラスのドキュメンテーションに含める場合には、そのファイルを \f2/home/user/src/java/awt/doc\-files/\fP ディレクトリ内に配置します。なお、 \f2doc\-files\fP ディレクトリを \f2/home/user/src/java/doc\-files\fP に配置することはできません。なぜなら、 \f2java\fP はパッケージではないからです。つまり、java に直接含まれているソースファイルは 1 つも存在していません。
+.LP
+これらの未処理のファイルへのリンクは、すべて明示的に記述する必要があります。これは、Javadoc ツールがそれらのファイルを見ずに、単にディレクトリとその内容を生成先にコピーするだけだからです。たとえば、 \f2Button.java\fP のドキュメンテーションコメント内のリンクは、次のようになります。
.nf
\f3
.fl
@@ -664,23 +386,16 @@
.fl
\fP
.fi
-
-.LP
.SS
-鴻＜ゃ潟潟若＜ゃ
-.LP
-.LP
-筝肴鴻＜ゃ潟潟若＜ゃ絲上純若鴻＜ゃ菴純若鴻若篆絖荀障ゃ障純若鴻＜ゃｃ障泣ｃ篆絖с
-.LP
-.LP
-ャ純若鴻＜ゃф腓榊羝＜ Javadoc 若絎茵翫鴻＜ゃ潟潟若＜ゃ括ゅс障宴若後障ゃ若ф検翫篁ヤ若緇ｃ鴻＜ゃ潟潟若＜ゃ綽荀障
-.LP
-.LP
-鴻＜ゃ潟若＜ゃ鴻＜ゃ罩ｅс潟潟ゃ純純若鴻＜ゃс絲障潟若＜ゃс鴻с 潟若＜ゃ.javaхс障
-.LP
-.LP
-\f3鴻＜ゃ\fP \- 肴紊宴若吾潟潟ゃ純у茵純鴻＜ゃ宴若吾純若鴻＜ゃｃ臀障鴻＜ゃ宴若吾純若鴻＜ゃ宴若吾ャ宴若吾絮障 (鴻＜ゃ package 鴻若＜潟障純若鴻ャ package 鴻若＜潟)倶с潟潟茵ф絎純若鴻宴若後絎純若鴻ャ＜潟鴻＜ゃ茘障若綣莎激障鴻＜ゃ泣ｃ臀綽荀障\f2com.package1\fP 菴遵翫鴻＜ゃゃ潟障宴若後≦鴻泣ｃ臀障
-.LP
+テストファイルおよびテンプレートファイル
+.LP
+一部の開発者から、テストファイルおよびテンプレートファイルを対応するソースファイルの近くのソースツリーに保存したいという要望がありました。つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに保存したいということです。
+.LP
+個別のソースファイル名で明示的に渡して Javadoc ツールを実行する場合は、テストファイルおよびテンプレートファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイルおよびテンプレートファイルが処理されないようにする必要があります。
+.LP
+テストファイルとテンプレートファイルの違いは、テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、テンプレートファイルは、そうではないという点です。ただし、テンプレートファイルも「.java」で終わることができます。
+.LP
+\f3テストファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテストファイルをそのパッケージのソースファイルと同じディレクトリに配置したいと考えています。しかしテストファイルは、名前なしパッケージなど、ソースファイルパッケージとは別のパッケージに属させたいとも考えています (そのため、テストファイルには package ステートメントがないか、またはソースとは別の package ステートメントがある)。このような状況では、コマンド行で指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テストファイルは警告またはエラーを引き起こします。そのようなテストファイルはサブディレクトリに配置する必要があります。たとえば、 \f2com.package1\fP 内のソースファイルに対するテストファイルを追加する場合は次のように、ハイフンを含んでいるためにパッケージ名としては無効であるようなサブディレクトリ内に、それらのファイルを配置します。
.nf
\f3
.fl
@@ -688,248 +403,189 @@
.fl
\fP
.fi
-
-.LP
-.LP
-Javadoc 若с茘 test ｃ鴻障
-.LP
-.LP
-鴻＜ゃ doc 潟＜潟障翫罨＜ゃ若鴻純若鴻＜ゃф検鴻＜ゃャ＜潟Javadoc 若ュ絎茵с荐絎с障 違\f2com/package1/test\-files/*.java\fP с
-.LP
-.LP
-\f3純若鴻＜ゃ潟若\fP \- 潟若＜ゃ.javaх障潟若＜ゃ潟潟ゃс障純若鴻ｃ篆純若鴻＜ゃ潟若翫＜ゃゃ (\f2Buffer\-Template.java\fP ) 篁筝罩ｃ Java 絖篏睡障 с障Javadoc 若.java･絨乗ゃ 罩ｈ劫с純若鴻＜ゃсс (
+.LP
+こうすると、Javadoc ツールでは警告なしで test ディレクトリをスキップします。
+.LP
+テストファイルに doc コメントが含まれる場合、次のようにワイルドカードを含んだテストソースファイル名で渡してテストファイルのドキュメントを生成するように、Javadoc ツールを別個に実行できるように設定できます。たとえば、 \f2com/package1/test\-files/*.java などです\fP。
+.LP
+\f3ソースファイルのテンプレート\fP \- テンプレートファイルの名前は「.java」で終わることもありますが、テンプレートファイルはコンパイルできません。ソースディレクトリ内に保持したいソースファイルのテンプレートがある場合は、 \f2Buffer\-Template.java\fP のようにハイフンやその他の無効な Java 文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadoc ツールが処理するのは、「.java」接尾辞を除いた名前が 正規のクラス名であるソースファイルだけであるためです (
.na
-\f2茘ュ\fP @
+\f2「Identifiers」\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
-.LP
-.SH "＜ゃ"
-.LP
-.LP
-сjavadoc 若HTML 綵√ャ＜潟罔羣篏帥障篁ヤ腮蕁＜ゃ障 HTML 若吾＜ゃ後障javadoc ＜ゃ鴻ゃ潟帥с若鴻＜с (\f2package\-summary.html\fP ) 2 腮蕁障緇違若＜ゃ違若＜ゃ腴九ゃ潟障障
-.LP
-.LP
-\f3堺絎鴻若\fP
-.LP
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625参照)。
+.SH "生成されるファイル"
+.LP
+デフォルトでは、javadoc ツールは、HTML 形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。それぞれの HTML ページは、個々のファイルに相当します。javadoc が生成するファイルの名前には、クラスやインタフェースの名前にちなんだものと、そうでないもの ( \f2package\-summary.html など\fP) の 2 種類があります。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。
+.LP
+\f3基本内容ページ\fP
.RS 3
.TP 2
o
-ャ＜潟鴻障ゃ潟帥с若鴻 1 ゃ\f3鴻若吾障ゃ潟帥с若鴻若\fP (\f2劫\fP\f2.html\fP)
-.TP 2
-o
-ャ＜潟宴若吾 1 ゃ\f3宴若吾若\fP (\f2package\-summary.html\fP)Javadoc 若純若鴻若宴若吾ｃ \f2package.html\fP 障 \f2package\-info.java\fP ＜ゃ違筝 HTML 鴻若吾腟水ャ障
-.TP 2
-o
-宴若吾祉篏絲障 1 ゃ\f3网荀若\fP (\f2overview\-summary.html\fP)ャ＜潟若吾障Javadoc 若\f2\-overview\fP 激с潟ф絎＜ゃ HTML 鴻若吾腟水ャ障若吾＜ゃjavadoc 茲違宴若後羝＜翫篏障荅括完HTML 若с
-.RE
-
-.LP
-.LP
-\f3娯с若\fP
-.LP
-.RS 3
-.TP 2
-o
-\f3宴若吾祉篏絲障 1 ゃ拷絮ゃ若\fP (\f2overview\-tree.html\fP)若吾茵腓冴蚊若激с潟若 [网荀] [絮ゃ] 障
+ドキュメント化するクラスまたはインタフェースごとに 1 つの\f3クラスページまたはインタフェースページ\fP (\f2クラス名\fP\f2.html\fP)
.TP 2
o
-\f3宴若吾 1 ゃ拷絮ゃ若\fP (\f2package\-tree.html\fP) 劫宴若吾鴻障ゃ潟帥с若鴻若吾茵腓冴[絮ゃ] 宴若吾拷絮ゃ茵腓冴障
-.TP 2
-o
-\f3宴若吾 1 ゃ [篏睡] 若\fP (\f2package\-use.html\fP)\f3鴻潟ゃ潟帥с若鴻 1 ゃゃ [篏睡] 若\fP (\f2class\-use/\fP\f2劫\fP\f2.html\fP)若吾劫鴻ゃ潟帥с若鴻障宴若吾筝篏帥ｃ宴若吾鴻＜純潟潟鴻帥潟ｃ若ゃ荐菴違障鴻障ゃ潟帥с若 A 箴 [篏睡] 若吾A 泣鴻A 絎ｈｃ若A 菴＜純A ＜若帥ゃ＜純潟潟潟鴻帥茵腓冴障 若吾茵腓冴障宴若吾鴻障ゃ潟帥с若鴻若吾腱糸蚊若激с潟若 [篏睡] 潟障
-.TP 2
-o
-\f3ｨ絅 API 若\fP (\f2deprecated\-list.html\fP) ｨ絅鴻筝荀ц；腓冴障ｨ絅筝壕 API 絖篏睡ｨ絅 API с絽吾臀腓冴障ｨ絅 API 絨ャ絎茖сゃ醇с障
+ドキュメント化するパッケージごとに 1 つの\f3パッケージページ\fP (\f2package\-summary.html\fP)。Javadoc ツールは、 \f2package.html\fP または \f2package\-info.java\fP という名前のファイル内の HTML テキストをすべて組み入れます。
.TP 2
o
-\f3絎違ｃ若ゃ若\fP (\f2constant\-values.html\fP) static ｃ若ょс
-.TP 2
-o
-\f3翫若若\fP (\f2serialized\-form.html\fP) 翫喝純鴻с鴻翫ｃ若潟＜純≪茯障宴API 篏帥肴с絎茖茵肴綽荀宴с蚊若激с潟若若吾吾潟障翫鴻腱糸鴻茯 [∫ｉ] 祉激с潟 [翫綵√] 宴緇с障罔羣翫綵√若吾障Serializable 絎茖 public 障 public 鴻腟粋昭障\f2readObject\fP ＜純\f2writeObject\fP ＜純翫ｃ若 \f2@serial\fP 帥違\f2@serialField\fP 帥違\f2@serialData\fP 帥違ャ＜潟若激с潟潟＜潟腟粋昭障障翫純 public 鴻ゅ鴻障鴻絮宴若吾 \f2@serial exclude\fP 帥違ф絎障 翫純 package private 鴻鴻障鴻絮宴若吾 \f2@serial include\fP 帥違ф絎障若吾с 1.4 с\f2\-private\fP 激с潟絎 javadoc 若絎茵public 鴻 private 鴻絎翫鴻с障
-.TP 2
-o
-\f3膣√\fP (\f2index\-*.html\fP) 鴻劫ゃ潟帥с若劫潟潟鴻水ｃ若潟＜純≪＜筝с障膣√Unicode 宴初障 1 ゃ＜ゃ絖 (沿翫 A Z) ャ＜ゃс障
+パッケージのセット全体に対して 1 つの\f3概要ページ\fP (\f2overview\-summary.html\fP)。これは、生成ドキュメントの先頭ページになります。Javadoc ツールは、\f2\-overview\fP オプションで指定されたファイル内の HTML テキストをすべて組み入れます。このページのファイルは、javadoc に複数のパッケージ名を渡した場合にだけ作成されます。詳細は、「HTML フレーム」を参照してください。
.RE
-
-.LP
-.LP
-\f3泣若＜ゃ\fP
-.LP
+.LP
+\f3相互参照ページ\fP
.RS 3
.TP 2
o
-\f3若\fP (\f2help\-doc.html\fP) 蚊若激с潟若菴違若吾≪茯荐莠障\f2\-helpfile\fP 篏帥＜ゃ篁ｃ鴻帥＜ゃ箴с障
-.TP 2
-o
-茵腓榊 HTML 若篏 1 ゃ \f3index.html ＜ゃ\fP＜ゃ若篁若吾茵腓冴翫若障＜ゃ篏鴻絎鴻障障
+\f3パッケージのセット全体に対して 1 つのクラス階層ページ\fP (\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーションバーの [概要] をクリックしてから、[階層ツリー] をクリックします。
.TP 2
o
-茲違\f3若＜ゃ\fP (\f2*\-frame.html\fP) 宴若吾鴻潟ゃ潟帥с若鴻鴻障障 HTML 若茵腓冴篏睡障
+\f3パッケージごとに 1 つのクラス階層ページ\fP (\f2package\-tree.html\fP)。これを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、[階層ツリー] をクリックしてそのパッケージの階層を表示させます。
.TP 2
o
-\f3宴若吾鴻\fP＜ゃ (\f2package\-list\fP) \f2\-link\fP 激с潟 \f2\-linkoffline\fP 激с潟т戎障HTML ＜ゃс鴻＜ゃс潟≪祉鴻с障
-.TP 2
-o
-\f3鴻帥ゃ激若\fP＜ゃ (\f2stylesheet.css\fP) 若娯ゃ荀膣ゃ蚊潟＜潟泣ゃ冴潟鴻帥ゃ渇臀九勝障
+\f3パッケージごとに 1 つの [使用] ページ\fP (\f2package\-use.html\fP) と、クラスおよびインタフェースごとに 1 つずつの [使用] ページ (\f2class\-use/\fP\f2クラス名\fP\f2.html\fP)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。クラスまたはインタフェース A を例にして考えると、その [使用] ページには、A のサブクラス、A として宣言されたフィールド、A を返すメソッド、A 型のパラメータを持つメソッドおよびコンストラクタが表示されます。 このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの [使用] リンクをクリックします。
.TP 2
o
-\f3doc\-files\fP ｃ ｃ潟若ゃ＜若吾泣潟潟若純若鴻潟若＜ゃ鴻主障＜ゃJavadoc 若ｃ＜ゃ javadoc 帥違ｃ∴障ｃ純若鴻若筝翫睡障
+\f3非推奨 API ページ\fP (\f2deprecated\-list.html\fP)。推奨されない名前がすべて一覧表示されます。非推奨名は、一般に改良された API が存在するために使用が推奨されていない API の名前であり、通常、それに置き換わる名前が提示されています。非推奨 API は、将来の実装では削除される可能性があります。
+.TP 2
+o
+\f3定数フィールド値ページ\fP (\f2constant\-values.html\fP)。static フィールドの値用です。
+.TP 2
+o
+\f3直列化された形式ページ\fP (\f2serialized\-form.html\fP)。直列化可能かつ外部化可能なクラスに関する情報用です。これらの各クラスには、直列化フィールドおよびメソッドに関する説明があります。これらの情報は、API を使う開発者ではなく、再実装を行う開発者に必要な情報です。ナビゲーションバーにこのページへのリンクはありませんが、直列化されたクラスに移動して、そのクラスの説明にある「関連項目」セクションで「直列化された形式」をクリックすると、この情報を取得できます。標準ドックレットは直列化された形式ページを自動生成します。Serializable を実装するすべてのクラス (public または 非 public) が含まれるほか、 \f2readObject\fP メソッドや \f2writeObject\fP メソッド、直列化されるフィールド、および \f2@serial\fP、\f2@serialField\fP、\f2@serialData\fP タグからのドキュメンテーションコメントも含まれます。public 直列化可能クラスを除外するには、そのクラス (またはそのパッケージ) を \f2@serial exclude\fP でマークします。package\-private 直列化可能クラスを含めるには、そのクラス (またはそのパッケージ) を \f2@serial include\fP でマークします。バージョン 1.4 では \f2\-private\fP オプションの指定なしで javadoc ツールを実行することにより、public クラスおよび private クラスの完全に直列化されたクラスを生成できます。
+.TP 2
+o
+\f3索引\fP (\f2index\-*.html\fP)。すべてのクラス、インタフェース、コンストラクタ、フィールド、およびメソッドの名前がアルファベット順に並んでいます。索引は、Unicode を扱えるように国際化されています。1 つのファイルとして生成することも、先頭文字 (英語の場合 A ~ Z) ごとに別々のファイルとして生成することもできます。
.RE
-
-.LP
-.LP
-\f3HTML 若\fP
-.LP
-.LP
-Javadoc 若筝潟腓冴2 3 ゃ HTML 若障1 ゃ宴若吾翫 (障宴若吾翫) 宴若吾筝荀сャｃ篏綽荀違若篏障筝宴若吾絮純若鴻＜ゃ (*.java) 障筝宴若後綣違 javadoc 潟潟羝＜翫綏眼鴻筝荀с茵腓冴若 (C) 1 ゃ篏障Javadoc 茲違宴若後羝＜翫网荀若 (Detail) 鴻宴若吾筝荀ц；腓冴膃 3 若 (P) 篏障网荀若吾＜ゃ\f2overview\-summary.html\fP сｃ＜ゃ2 や札筝宴若後羝＜翫篏障[若] 潟overview\-summary.html 茵腓冴若ャс障
-.LP
-.LP
-HTML 若ｃ翫劫若医激潟鴻若若若鴻違羈若若鴻筝若障紊吟с√違若若吾若篏帥ｃ若鴻若[医] ＜ャ若潟潟篏帥ｃ若医激с障
-.LP
-.nf
-\f3
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- |C| Detail | |P| Detail |
-.fl
- | | | | | |
-.fl
- | | | |\-| |
-.fl
- | | | |C| |
-.fl
- | | | | | |
-.fl
- | | | | | |
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- javadoc *.java javadoc java.lang java.awt
-.fl
-\fP
-.fi
-
-.LP
-.LP
-HTML 若綽荀ｃ罨＜＜＜ゃ紮若吾若障
-.LP
+.LP
+\f3サポートファイル\fP
.RS 3
.TP 2
o
-\f2index.html\fP (若)
+\f3ヘルプページ\fP (\f2help\-doc.html\fP)。ナビゲーションバーや前述の各ページに関する説明が記載されています。デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供するには、\f2\-helpfile\fP を使用します。
+.TP 2
+o
+表示用の HTML フレームを作成する 1 つの \f3index.html ファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。
+.TP 2
+o
+複数の\f3フレームファイル\fP (\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTML フレームを表示するときに使用されます。
+.TP 2
+o
+\f3パッケージリスト\fPファイル (\f2package\-list\fP)。 \f2\-link\fP および \f2\-linkoffline\fP オプションで使用されます。これは、HTML ファイルではなくテキストファイルであり、どのリンクからもアクセスできません。
+.TP 2
+o
+\f3スタイルシート\fPファイル (\f2stylesheet.css\fP)。生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。
.TP 2
o
-\f2overview\-summary.html\fP (若)
+\f3doc\-files\fP ディレクトリ。生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。これらのファイルは、Javadoc ツールによって処理されないため、ファイル内に ｊavadoc タグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。
.RE
-
-.LP
-.LP
-\f3＜ゃ罕\fP
-.LP
-.LP
-鴻＜ゃ潟ゃ潟帥с若鴻＜ゃJava 純若鴻＜ゃ潟鴻＜ゃｃ絮ゃ膩障1 ゃ泣宴若吾ゃ 1 ゃｃ罕障
-.LP
-.LP
-違\f2java.applet.Applet\fP 鴻絲障ャ＜潟\f2java/applet/Applet.html\fP 主障ｃ \f2apidocs\fP java.applet 宴若吾＜ゃ罕筝罕膀障菴違frame茯＜ゃ鴻綏筝障綏筝若茵腓冴障篁ュ HTML ＜ゃ鴻勀眼若茵腓冴障
-.LP
+.LP
+\f3HTML フレーム\fP
+.LP
+Javadoc ツールは、下の図に示すように、2 ~ 3 つの HTML フレームを生成します。1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。単一のパッケージに属するソースファイル (*.java) または単一のパッケージ名を引数として javadoc コマンドに渡す場合は、左側の列にクラスの一覧を表示するフレーム (C) 1 つだけが作成されます。Javadoc に複数のパッケージ名を渡した場合は、概要ページ (Detail) に加えて、すべてのパッケージを一覧表示する第 3 のフレーム (P) が作成されます。この概要ページのファイル名は、 \f2overview\-summary.html です\fP。したがって、このファイルは、2 つ以上のパッケージ名を渡した場合にだけ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.html を最初に表示すると、フレームを省略できます。
+.LP
+HTML フレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、「印刷」メニューコマンドを使ってそのフレームを印刷したりできます。
+.LP
+HTML フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。
.RS 3
-
-.LP
-.LP
-羈 \- 筝絮ゅ潟сｃ\f3紊絖\fP (\f3bold\fP) хず障≪鴻帥鴻 (\f2*\fP) javadoc 吾綣違宴若後с純若鴻＜ゃ (*.java) с翫ャ＜ゃ潟ｃ腓冴障障綣違純若鴻＜ゃ翫\f2package\-list\fP 篏障絎鴻腥冴сdoc\-files ｃ純若鴻弱絖翫帥篏障
-.LP
+.TP 2
+o
+\f2index.html\fP (フレームあり)
+.TP 2
+o
+\f2overview\-summary.html\fP (フレームなし)
.RE
+.LP
+\f3生成されるファイルの構造\fP
+.LP
+生成されるクラスファイルおよびインタフェースファイルは、Java ソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1 つのサブパッケージにつき 1 つのディレクトリ、という構造になります。
+.LP
+たとえば、 \f2java.applet.Applet\fP クラス用に生成されたドキュメントは、 \f2java/applet/Applet.html\fP に格納されます。生成先のディレクトリの名前が \f2apidocs\fP だとすると、java.applet パッケージのファイル構造は、その下に構築されます。前述のように、「frame」という語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外の HTML ファイルは、すべて右側のフレームに表示されます。
+.LP
+注 \- 下の階層図で、ディレクトリは\f3太字\fP (bold) で示してあります。アスタリスク (\f2*\fP) は、javadoc への引数がパッケージ名ではなくソースファイル名 (*.java) である場合に省略されるファイルおよびディレクトリを示しています。また、引数がソースファイル名の場合、 \f2package\-list\fP は作成されますが、その中身は空です。doc\-files ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。
.nf
\f3
.fl
.fl
-\fP\f3apidocs\fP 筝篏ｃ
-.fl
- index.html HTML 若荐絎若
-.fl
- * overview\-summary.html 宴若吾鴻 荀膣
-.fl
- overview\-tree.html 宴若吾拷絮ゃ鴻
-.fl
- deprecated\-list.html 宴若吾ｨ絅 API 鴻
-.fl
- constant\-values.html 宴若吾 static ｃ若ゃ鴻
-.fl
- serialized\-form.html 宴若吾翫綵√鴻
-.fl
- * overview\-frame.html 宴若吾鴻 綏筝若茵腓冴
-.fl
- allclasses\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
-.fl
- help\-doc.html 若吾罕腓冴若吟若茵腓冴
-.fl
- index\-all.html \-splitindex 激с潟т膣√
-.fl
- \f3index\-files\fP \-splitindex 激с潟絎篏ｃ
-.fl
- index\-<number>.html \-splitindex 激с潟絎篏膣√＜ゃ
-.fl
- package\-list 宴若後鴻 紊с茹ｆ浦篏睡
-.fl
- stylesheet.css 潟蚊臀絎臂 HTML 鴻帥ゃ激若
-.fl
- \f3java\fP 宴若吾ｃ
-.fl
- \f3applet\fP 泣宴若吾ｃ
-.fl
- Applet.html Applet 鴻若
-.fl
- AppletContext.html AppletContext ゃ潟帥с若鴻若
-.fl
- AppletStub.html AppletStub ゃ潟帥с若鴻若
-.fl
- AudioClip.html AudioClip ゃ潟帥с若鴻若
-.fl
- * package\-summary.html 宴若吾鴻鴻 荀膣
-.fl
- * package\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
-.fl
- * package\-tree.html 宴若吾拷絮ゃ鴻
-.fl
- package\-use 宴若吾篏睡贋鴻
-.fl
- \f3doc\-files\fP ゃ＜若吾泣潟＜ゃ主ｃ
-.fl
- \f3class\-use\fP API 篏睡贋若吾主ｃ
-.fl
- Applet.html Applet 鴻篏睡若
-.fl
- AppletContext.html AppletContext ゃ潟帥с若鴻篏睡若
-.fl
- AppletStub.html AppletStub ゃ潟帥с若鴻篏睡若
-.fl
- AudioClip.html AudioClip ゃ潟帥с若鴻篏睡若
-.fl
- \f3src\-html\fP 純若鴻潟若ｃ
-.fl
- \f3java\fP 宴若吾ｃ
-.fl
- \f3applet\fP 泣宴若吾ｃ
-.fl
- Applet.html Applet 純若鴻潟若若
-.fl
- AppletContext.html AppletContext 純若鴻潟若若
-.fl
- AppletStub.html AppletStub 純若鴻潟若若
-.fl
- AudioClip.html AudioClip 純若鴻潟若若
+\fP\f3apidocs\fP 最上位ディレクトリ
+.fl
+ index.html HTML フレームを設定する初期ページ
+.fl
+ * overview\-summary.html 全パッケージのリスト。先頭文による要約付き
+.fl
+ overview\-tree.html 全パッケージのクラス階層のリスト
+.fl
+ deprecated\-list.html 全パッケージの非推奨 API のリスト
+.fl
+ constant\-values.html 全パッケージの static フィールドの値のリスト
+.fl
+ serialized\-form.html 全パッケージの直列化された形式のリスト
+.fl
+ * overview\-frame.html 全パッケージのリスト。左上のフレームで使用される
+.fl
+ allclasses\-frame.html 全パッケージの全クラスのリスト。左下のフレームで使用される
+.fl
+ help\-doc.html これらのページの構成を示すユーザーヘルプのリスト
+.fl
+ index\-all.html \-splitindex オプションを指定しなかった場合に作成されるデフォルトの索引
+.fl
+ \f3index\-files\fP \-splitindex オプションを指定した場合に作成されるディレクトリ
+.fl
+ index\-<number>.html \-splitindex オプションを指定した場合に作成される索引ファイル
+.fl
+ package\-list パッケージ名のリスト。外部参照を解決するためだけに使用される
+.fl
+ stylesheet.css フォント、色、配置を定義する HTML スタイルシート
+.fl
+ \f3java\fP パッケージディレクトリ
+.fl
+ \f3applet\fP サブパッケージディレクトリ
+.fl
+ Applet.html Applet クラスのページ
+.fl
+ AppletContext.html AppletContext インタフェースのページ
+.fl
+ AppletStub.html AppletStub インタフェースのページ
+.fl
+ AudioClip.html AudioClip インタフェースのページ
+.fl
+ * package\-summary.html このパッケージのクラスのリスト。先頭文による要約付き
+.fl
+ * package\-frame.html このパッケージのクラスのリスト。左下のフレームで使用される
+.fl
+ * package\-tree.html このパッケージのクラス階層のリスト
+.fl
+ package\-use このパッケージが使用されている場所のリスト
+.fl
+ \f3doc\-files\fP 画像やサンプルファイルを保持するディレクトリ
+.fl
+ \f3class\-use\fP API が使用されている場所のページを保持するディレクトリ
+.fl
+ Applet.html Applet クラスの使用に関するページ
+.fl
+ AppletContext.html AppletContext インタフェースの使用に関するページ
+.fl
+ AppletStub.html AppletStub インタフェースの使用に関するページ
+.fl
+ AudioClip.html AudioClip インタフェースの使用に関するページ
+.fl
+ \f3src\-html\fP ソースコードディレクトリ
+.fl
+ \f3java\fP パッケージディレクトリ
+.fl
+ \f3applet\fP サブパッケージディレクトリ
+.fl
+ Applet.html Applet ソースコードのページ
+.fl
+ AppletContext.html AppletContext ソースコードのページ
+.fl
+ AppletStub.html AppletStub ソースコードのページ
+.fl
+ AudioClip.html AudioClip ソースコードのページ
.fl
.fi
-
-.LP
.SS
- API 絎ｈ
-.LP
-.LP
-Javadoc 若鴻ゃ潟帥с若鴻ｃ若潟潟鴻帥潟＜純茯 API 絎ｈ障 絎ｈ API 絎ｈс違\f2Boolean\fP 鴻絎ｈ罨＜障
-.LP
+生成される API 宣言
+.LP
+Javadoc ツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、その API 用の宣言を生成します。たとえば、 \f2Boolean\fP クラスの宣言は、次のようになります。
.LP
\f2public final class Boolean\fP
.br
@@ -937,29 +593,20 @@
.br
\f2implements Serializable\fP
.LP
-.LP
-障\f2Boolean.valueOf\fP ＜純絎ｈ罨＜障
-.LP
+また、 \f2Boolean.valueOf\fP メソッドの宣言は、次のようになります。
.LP
\f2public static Boolean valueOf(String s)\fP
.LP
-.LP
-Javadoc 若篆蕋上 \f2public\fP\f2protected\fP\f2private\fP\f2abstract\fP\f2final\fP\f2static\fP\f2transient\fP \f2volatile\fP 腟粋昭с障\f2synchronized\fP \f2native\fP 腟粋昭с障緇 2 ゃ篆蕋上絎茖荅括完荀API 篁罕障障
-.LP
-.LP
-API с筝茵с祉潟ｃ鴻ゃ若若 \f2synchronized\fP 箴絖с潟＜潟筝肢ャ＜潟綽荀障 違1 ゃ \f2Enumeration\fP 茲違鴻筝茵篏睡с潟＜潟荐菴違障ャ＜潟祉潟ｃ鴻絎憗号荐菴違鴻с障違\f2Hashtable\fP 鴻絲障絎с綽荀障鴻若鴻＜純違絎憗с絎号障宴у罔罧鏆荀障 違蕭綺筝茵с箴障
-.LP
-.SH "ャ＜潟若激с潟潟＜潟"
-.LP
-.LP
-吾ャ＜潟若激с潟潟＜潟篁罕∫ｉс
-.LP
+Javadoc ツールでは、修飾子 \f2public\fP、 \f2protected\fP、 \f2private\fP、 \f2abstract\fP、 \f2final\fP、 \f2static\fP、 \f2transient\fP、および \f2volatile\fP は組み込めますが、 \f2synchronized\fP と \f2native\fP は組み込めません。これら後者の 2 つの修飾子は、実装の詳細と見なされているため、API 仕様には含まれません。
+.LP
+API では、並行性セマンティクスについて、キーワード \f2synchronized\fP に依存するのではなく、コメントの主説明としてドキュメント化すべきです。 \f2たとえば、「1 つの Enumeration を\fP 複数のスレッドから並行して使用することはできない」などと記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述するべきではありません。たとえば、 \f2Hashtable\fP はスレッドに対して安全である必要がありますが、「エクスポートされるすべてのメソッドを同期化すればそれを実現できる」のようには指定する根拠はありません。バケットレベルで内部的に同期化する権利を残しておく必要があります。そうすれば、より高度な並行性が提供されます。
+.SH "ドキュメンテーションコメント"
+.LP
+オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。
.SS
-純若鴻潟若吾潟＜潟水
-.LP
-.LP
-純若鴻潟若篁紙鴻ゃ潟帥с若鴻＜純潟潟鴻帥障ｃ若絎ｈャ＜潟若激с潟潟＜潟 ("doc comments") 荐菴違с障宴若吾ャ＜潟若激с潟潟＜潟篏с障 罕ュ慌違障网荀ャ＜潟若激с潟潟＜潟篏с障ャ＜潟若激с潟潟＜潟綣Javadoc 潟＜潟若違障 (茯罔∫ｃ篏睡羈)ャ＜潟若激с潟潟＜潟潟＜潟紮障腓冴絖 \f2/**\fP 潟＜潟腟腓冴絖 \f2*/\fP 絖ф障茵≪鴻帥鴻茵荐菴違с障 荅括完篁ヤц障潟＜潟鴻茲域ｃ荐菴違с障
-.LP
+ソースコードへのコメントの挿入
+.LP
+ソースコードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーションコメント ("doc comments") を記述することができます。各パッケージにドキュメンテーションコメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadoc コメント」と呼ばれています (この用語は商標関連の使用法に違反)。ドキュメンテーションコメントは、コメントを始まりを示す文字列 \f2/**\fP と、コメントを終わりを示す文字列 \f2*/\fP の間にある文字から構成されます。行の先頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。
.nf
\f3
.fl
@@ -973,26 +620,19 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜ 1 茵荐菴違鴻若鴻膀膣с障
-.LP
+.LP
+次のようにして 1 行に記述すると、スペースを節約できます。
.nf
\f3
.fl
-/** This comment takes up only one line. */
+/** This comment takes up only one line.*/
.fl
\fP
.fi
-
-.LP
-.LP
-\f3潟＜潟臀\fP \- ャ＜潟若激с潟潟＜潟鴻ゃ潟帥с若鴻潟潟鴻帥＜純障ｃ若絎ｈ翫臀茯茘障 鴻箴＜純箴潟ｃ若箴с＜純篏臀ャ＜潟若激с潟潟＜潟∴障javadoc 若с1 ゃ絎ｈゃ 1 ゃャ＜潟若激с潟潟＜潟茯茘障
-.LP
-.LP
-鴻潟＜潟鴻絎ｈ \f2import\fP 臀障с荐菴違с 鴻潟＜潟∴障
-.LP
+.LP
+\f3コメントの配置\fP \- ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。javadoc ツールでは、1 つの宣言文につき 1 つのドキュメンテーションコメントだけが認識されます。
+.LP
+よくある間違いは、クラスコメントとクラス宣言の間に \f2import\fP 文を置いてしまうことです。このような記述はしないでください。このようなクラスコメントは無視されます。
.nf
\f3
.fl
@@ -1014,11 +654,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3ャ＜潟若激с潟潟＜潟筝肢帥違祉激с潟膓\fP \- 潟＜潟紮阪絖с \f2/**\fP 帥違祉激с潟障с筝肢障帥違祉激с潟絖 \f2@\fP с茵у臂帥違紮障障 (茵≪鴻帥鴻腥榊純活阪絖 \f2/**\fP ゃ)筝肢荐菴違帥違祉激с潟潟＜潟荐菴違с障筝肢帥違祉激с割札膓с障帥違綣違茲域ｃ荐菴違с障帥違違狗障 篏荐菴違с帥違1 荐菴違с帥違障箴違罨＜ \f2@see\fP 帥違祉激с潟紮障障
-.LP
+.LP
+\f3ドキュメンテーションコメントは主説明のあとにタグセクションが続く \- コメントの開始区切り文字である\fP \f2/**\fP のあとからタグセクションまでが主説明になります。タグセクションは、行の先頭にある最初の \f2@\fP で定義される最初のブロックタグから始まります (先頭のアスタリスク、空白、先頭の区切り文字 \f2/**\fP は除く)。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1 回しか記述できないタグがあります。たとえば、次の \f2@see\fP は、タグセクションを開始しています。
.nf
\f3
.fl
@@ -1032,11 +669,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3帥違ゃ潟ゃ潟帥\fP \- 帥違Javadoc сャ＜潟若激с潟潟＜潟劫ャ若若с\f2@tag\fP 荐菴違帥 (鴻帥潟≪潟帥違若違) ゃ潟ゃ潟帥 (\f2{@tag}\fP 筝綣су蚊ц菴) 2 腮蕁帥違障帥違罩ｃ頵ｉ茵≪鴻帥鴻腥榊純阪絖 (\f2/**\fP) ゃ茵臀違障鴻篁ュ篏臀 \f2@\fP 絖篏睡帥違紮茹ｉ潟障茵 \f2@\fP 絖篏睡帥違茹ｉHTML 潟ｃｃ若\f2@\fP篏睡帥違絲上篁鴻障 鴻帥違罨＜帥違障ャ＜潟若激с潟潟＜潟緇障с荐菴違鴻 (帥違潟＜潟阪絖ゃ) с∫ｃ鴻茲域ｃ荐菴違с障ゃ潟ゃ潟帥違鴻荐菴違с贋с違с臀с罩ｃ頵ｉ障罨＜潟若箴帥 \f2@deprecated\fP ゃ潟ゃ潟帥 \f2{@link}\fP 障障
-.LP
+.LP
+\f3ブロックタグとインラインタグ\fP \- \f2「タグ」\fPは、Javadoc が処理できる、ドキュメンテーションコメント内の特別なキーワードです。タグには 2 種類あります。1 つは @tag のように表記されるブロックタグ \f2(「標準タグ」とも呼ばれる)、\fP もう 1 つは {@tag} のように中括弧で囲まれるインラインタグ \f2です\fP。ブロックタグが正しく解釈されるためには、行の先頭のアスタリスク、空白、区切り文字 (\f2/**\fP) を除いて、行の先頭に置かなければなりません。これは、 \f2@\fP 文字をテキスト内の別の場所で使用した場合にはタグの開始として解釈されないことを意味しています。行の先頭で \f2@\fP 文字を使用してもそれが解釈されないようにするには、HTML エンティティー \f2@\fP を使用します。それぞれのブロックタグには、対応付けられたテキストがあります。このテキストは、タグのあとから、次のタグの前、またはドキュメンテーションコメントの最後までの間に記述されたテキスト (タグやコメント区切り文字を除く) です。この関連テキストは複数行にわたって記述できます。インラインタグは、テキストを記述できる場所であればどこにでも置くことができ、正しく解釈されます。次の例にはブロックタグ \f2@deprecated\fP とインラインタグ \f2{@link}\fP が含まれています。
.nf
\f3
.fl
@@ -1048,17 +682,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3潟＜潟 HTML ц菴違\fP \- 鴻 HTML 綵√ц菴違違障 HTML 潟ｃｃ若篏帥綽荀 HTML 帥違篏睡с潟障荐菴違 HTML 若吾с潟篏睡吟泣若篁紙若吾с潟篏睡с障 罔羣鴻宴若ｃ潟違鴻帥ゃ激若 (CSS) 若鴻 (ャ＜潟若激с潟潟＜潟篁ュ) HTML 3.2 羣潟若篏障若祉絲上＜ゃHTML 4.0荐菴違障
-.LP
-.LP
-違絨 (\f2<\fP) 潟紊с (\f2>\fP) 荐垩\f2<\fP \f2>\fP 荐菴違綽荀障罕≪潟泣潟 (\f2&\fP) \f2&\fP 荐菴違綽荀障罨＜箴с若 HTML 帥 \f2<b>\fP 篏帥ｃ障
-.LP
-.LP
-罨＜ャ＜潟若激с潟潟＜潟腓冴障
-.LP
+.LP
+\f3コメントは HTML で記述する\fP \- テキストは HTML 形式で記述しなければなりません。これは、HTML のエンティティーを使う必要があること、および HTML タグを使用できることを意味します。記述する HTML のバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディングスタイルシート (CSS) とフレームを含め、すべての部分 (ドキュメンテーションコメント以外の部分) で HTML 3.2 に準拠したコードを生成するように作成されています。ただし、フレームセット対応のため、生成される各ファイルには「HTML 4.0」と記述されます。
+.LP
+たとえば、より小さい (\f2<\fP) 記号およびより大きい (\f2>\fP) 記号のエンティティーは、 \f2<\fP および \f2>\fP と記述すべきです。同様に、アンパサンド (\f2&\fP) は \f2&\fP と記述すべきです。次の例ではボールドの HTML タグ \f2<b>\fP が示されています。
+.LP
+次に、ドキュメンテーションコメントを示します。
.nf
\f3
.fl
@@ -1072,20 +701,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3茵≪鴻帥鴻\fP \- Javadoc ャ＜潟若激с潟潟＜潟茹ｆ茵≪鴻帥鴻 (\f2*\fP) 鴻贋障 障≪鴻帥鴻 (\f2*\fP) 腥榊純帥贋障若吾с 1.4 茵≪鴻帥鴻ャ腥榊醇絖ゃ障潟若箴贋･ャ＜潟若激с潟潟＜潟 \f2<PRE>\fP 帥医若鴻ゃ潟潟篆障絽吾吟腥榊醇絖帥筝緇茹ｉ障ゃ潟潟阪絖 \f2/**\fP 障 \f2<PRE>\fP 帥違綏絲障
-.LP
-.LP
-\f3\fP \- ャ＜潟若激с潟潟＜潟絎ｈ潟ｃｃ若≪膂≧ゅ荀膣с綽荀障翫鴻若鴻帥障壕膓 (宴若沿荐絎翫)障帥違篏臀х障Javadoc 若ｃ HTML 若吾＜潟若网荀潟若障
-.LP
-.LP
-\f3茲違ｃ若絎ｈ\fP \- Java с1 ゃц違ｃ若絎ｈс障 1 ゃャ＜潟若激с潟潟＜潟荐菴違с障 潟＜潟鴻ｃ若絲障潟若障ｃｃ若ャ＜潟若激с潟潟＜潟荐菴違綽荀翫ｃ若ャуｈ違障違罨＜ャ＜潟若激с潟潟＜潟1 ゃ絎ｈ荐菴違筝с 翫絎ｈ 2 ゃс障
-.LP
-.RS 3
-
-.LP
+.LP
+\f3行頭のアスタリスク\fP \- javadoc によるドキュメンテーションコメントの解析時に、各行の先頭にあるアスタリスク (\f2*\fP) 文字は破棄されます。最初のアスタリスク (\f2*\fP) 文字より前にある空白やタブも破棄されます。バージョン 1.4 からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーションコメントの \f2<PRE>\fP タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は左マージンになります (区切り文字 \f2/**\fP または \f2<PRE>\fP タグではなく)。
+.LP
+\f3最初の文\fP \- 各ドキュメンテーションコメントの最初の文は、宣言されているエンティティーに関する簡潔かつ完全な要約文である必要があります。この「最初の文」は、直後にスペース、タブ、または改行が続く最初のピリオド (ロケールが英語に設定されている場合)、または最初のタグがある位置で終わります。最初の文は、Javadoc ツールによって HTML ページの最初にあるメンバーの概要の部分にコピーされます。
+.LP
+\f3複数フィールドの宣言\fP \- Java では、1 つの文で複数のフィールドを宣言できます。ただし、この文には、1 つのドキュメンテーションコメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。たとえば、次のドキュメンテーションコメントは、1 つの宣言として記述すると不適切です。この場合は、宣言を 2 つに分けることをお勧めします。
.nf
\f3
.fl
@@ -1099,145 +720,105 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.LP
-筝荐潟若罨＜ャ＜潟障
-.LP
-.RS 3
-
-.LP
+.LP
+上記のコードからは、次のようなドキュメントが生成されます。
.nf
\f3
.fl
public int \fP\f3x\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
.nf
\f3
.fl
public int \fP\f3y\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
-.RE
-.LP
-\f3荀冴帥違鴻鋎睡\fP \- ＜潟若絲障ャ＜潟若激с潟潟＜潟荐菴違<H1> <H2> HTML 荀冴帥違鴻鋎帥с Javadoc 若絎罕ャ＜潟篏с罕帥違篏帥ャ＜潟綵√綵演帥障鴻宴若吾潟＜潟с荀冴帥違篏帥ｃ罕腟睡障障
-.LP
+.LP
+\f3見出しタグはなるべく使用しない\fP \- メンバーに対してドキュメンテーションコメントを記述するときには、<H1> や <H2> などの HTML 見出しタグは、なるべく使わないでください。 Javadoc ツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。
.SS
-＜純潟＜潟潟
-.LP
-.LP
-Javadoc 若罨＜ 2 ゃ翫鴻潟ゃ潟帥с若鴻＜純潟＜潟潟若障膓帥罘純障潟潟鴻帥ｃ若喝ャ絖鴻ャ＜潟若激с潟潟＜潟膓帥障
-.LP
+メソッドコメントの自動コピー
+.LP
+Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。
.RS 3
.TP 2
o
-\f3潟＜潟膓帥荀ゃ鴻\fP \- 筝肢障 \f2@return\fP 帥違\f2@param\fP 帥違\f2@throws\fP 帥違＜純潟＜潟цゃ翫Javadoc 若若若ゃ＜純障絎茖翫＜純絲上筝肢障帥違潟＜潟罨＜≪眼冴緇ｃ潟若障
-.LP
-ｳ絲劫＜若帥 \f2@param\fP 帥違荀ゃ翫＜若帥潟＜潟筝篏膓翠絮ゃ＜純潟若障劫箴紊 \f2@throws\fP 帥違荀ゃ翫箴紊絎ｈ翫 \f2@throws\fP 帥違潟若障
-.LP
-篏若吾с 1.3 篁ュ篏絲丞хс 障с若吾с潟с筝肢障帥違絖違潟＜潟筝膓帥障с
+\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、 \f2@return\fP タグ、 \f2@param\fP タグ、または \f2@throws\fP タグがメソッドコメントに見つからない場合、Javadoc ツールは、オーバーライドまたは実装している場合はその対象となるメソッドから、対応する主説明またはタグコメントを、次のアルゴリズムに従ってコピーします。
+.LP
+厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、その例外が宣言されている場合にかぎり、 \f2@throws\fP タグがコピーされます。
+.LP
+この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。
.TP 2
o
-\f3{@inheritDoc} 帥違ゃ潟＜潟腓榊膓帥\fP \- ゃ潟ゃ潟帥 \f2{@inheritDoc}\fP ＜純筝肢障 \f2@return\fP\f2@param\fP\f2@throws\fP 帥違潟＜潟水ャ障 膓帥絲上筝肢障帥違潟＜潟膊潟若障
+\f3{@inheritDoc} タグを含むコメントを明示的に継承する\fP \- インラインタグ \f2{@inheritDoc}\fP を、メソッドの主説明内または \f2@return\fP、 \f2@param\fP 、 \f2@throws\fP のいずれかのタグコメント内に挿入します。対応する継承された主説明またはタグコメントがその位置にコピーされます。
.RE
-
-.LP
-.LP
-ャ＜潟若激с潟潟＜潟絎潟若膓帥＜純純若鴻＜ゃ \-sourcepath ф絎鴻臀綽荀障潟潟茵с鴻宴若吾羝＜綽荀障鴻鴻ャ＜潟鴻с違ｃ 1.3.x 篁ュ若鴻違障
-.LP
-.LP
-\f3鴻潟ゃ潟帥с若鴻膓\fP \- 鴻潟ゃ潟帥с若鴻膓帥罨＜ 3 ゃ翫潟＜潟膓帥茵障
-.LP
+.LP
+ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。
+.LP
+\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。
.RS 3
.TP 2
o
-鴻＜純鴻若若鴻＜純若若ゃ
+クラスのメソッドがスーパークラスのメソッドをオーバーライドしている
.TP 2
o
-ゃ潟帥с若鴻＜純鴻若若ゃ潟帥с若鴻＜純若若ゃ
+インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている
.TP 2
o
-鴻＜純ゃ潟帥с若鴻＜純絎茖
+クラスのメソッドがインタフェースのメソッドを実装している
.RE
-
-.LP
-.LP
- 2 ゃ宴若 (＜純若若ゃ翫) сJavadoc 若潟＜潟膓帥若若ゃ＜純ャ＜潟若若ゃ絨頳冴若若ゃ＜純吾潟吾莨若帥障
-.LP
-.LP
-3 ょ宴若 (劫鴻＜純ゃ潟帥с若鴻＜純絎茖翫) сjavadoc 若若若ゃ＜純ャ＜潟絎臂絨頳冴絎茖＜純吾潟吾莨若帥障潟＜潟膓帥障
-.LP
-.LP
-\f3＜純茯膓帥≪眼冴\fP \- ＜純ャ＜潟若激с潟潟＜潟荐菴違翫障 {@inheritDoc} 帥違翫Javadoc 若罨＜≪眼冴篏睡潟＜潟罎膣≪障 ≪眼冴ｃャ＜潟若激с潟潟＜潟罎膣≪с荐荐鴻若若鴻ゃ潟帥с若鴻ｃ障
-.LP
+.LP
+最初の 2 つのケース (メソッドがオーバーライドしている場合) では、Javadoc ツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。
+.LP
+3 つ目のケース (特定のクラスのメソッドがインタフェースのメソッドを実装している場合) では、javadoc ツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。
+.LP
+\f3メソッドの説明が継承されるアルゴリズム\fP \- あるメソッドにドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、Javadoc ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。 このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。
.RS 3
.TP 3
1.
-贋･絎茖 (障≦宍) ゃ潟帥с若鴻＜純絎ｈ implements (障 extends) 若若糸眼綺с1 ゃよ帥鴻＜純ゃ荀ゃｃャ＜潟若激с潟潟＜潟｡
+直接に実装されている (または、拡張されている) インタフェースを、メソッドの宣言で implements (または extends) キーワードのあとに登場する順序で、1 つずつ調べる。このメソッドについて最初に見つかったドキュメンテーションコメントを採用する
.TP 3
2.
- 1 сャ＜潟若激с潟潟＜潟荀ゃｃ翫贋･絎茖 (障≦宍) ゃ潟帥с若鴻絲障≪眼冴篏絽亥 (綺 1 сゃ潟帥с若鴻茯帥鴻綺)
+手順 1 でドキュメンテーションコメントが見つからなかった場合は、直接実装されている (または、拡張されている) インタフェースのそれぞれに対して、このアルゴリズム全体を再帰的に適用する (その際の順序は、手順 1 でインタフェースを調べたときの順序と同じ)
.TP 3
3.
- 2 сャ＜潟若激с潟潟＜潟荀ゃｃ翫с鴻 Object 篁ュ鴻с (ゃ潟帥с若鴻с) 翫罨＜
+手順 2 でドキュメンテーションコメントが見つからなかった場合で、このクラスが Object 以外のクラスである (インタフェースではない) 場合は、次のように処理する
.RS 3
.TP 3
a.
-鴻若若鴻＜純ゃャ＜潟若激с潟潟＜潟荐菴違違潟＜潟｡
+スーパークラスにこのメソッドについてのドキュメンテーションコメントが記述されていれば、そのコメントを採用する
.TP 3
b.
- 3a сャ＜潟若激с潟潟＜潟荀ゃｃ翫鴻若若鴻絲障≪眼冴篏
+手順 3a でドキュメンテーションコメントが見つからなかった場合は、スーパークラスに対して、このアルゴリズム全体を適用する
.RE
.RE
-
-.LP
-.SH "javadoc 帥"
-.LP
-.LP
-Javadoc 若Java ャ＜潟若激с潟潟＜潟莨若障劫ャ帥違茹ｆ障ャ＜潟若激с潟帥違篏帥後眼ｃ絎 API ャ＜潟純若鴻潟若с障帥違箴∴ (\f2@\fP) у障紊ф絖絨絖阪ャ障 帥違絎紊ф絖絨絖篏睡荐菴違綽荀障帥違茵 (茵腥榊純ュ純≪鴻帥鴻ゃ) 臀違障ｄ帥違 1 障荐菴違障違\f2@see\fP 帥違茲違翫鴻 1 障荐菴違障
-.LP
-.LP
-帥違 2 ゃ帥ゃ障
-.LP
+.SH "javadoc タグ"
+.LP
+Javadoc ツールは、Java のドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーションタグを使うと、書式の整った完全な API ドキュメントをソースコードから自動的に生成できます。タグは「アットマーク」記号 (\f2@\fP) で始まり、大文字と小文字の区別があります。タグは、大文字と小文字を使用して、表示されているとおりに入力する必要があります。タグは、行の先頭 (先行する空白と省略可能なアスタリスクは除く) に置かなければなりません。慣例として、同じ名前のタグは 1 か所にまとめて記述するようにします。たとえば、 \f2@see\fP タグはすべて同じ場所に配置します。
+.LP
+タグには 2 つのタイプがあります。
.RS 3
.TP 2
o
-\f3帥\fP \- 筝肢膓帥違祉激с喝粋菴医純帥違\f2@tag\fP 綵√障
+\f3ブロックタグ\fP \- 主説明に続くタグセクション内にのみ記述可能。ブロックタグは、 \f2@tag\fP の形式をとります。
.TP 2
o
-\f3ゃ潟ゃ潟帥\fP \- 潟＜潟筝肢障帥違潟＜潟荐菴医純ゃ潟ゃ潟帥違\f2{@tag}\fP 筝綣су蚊帥障
+\f3インラインタグ\fP \- 主説明内、またはブロックタグのコメント内に記述可能。インラインタグは、 \f2{@tag}\fP.のように中括弧で囲みます。
.RE
-
-.LP
-.LP
-篁緇若鴻уャ帥違ゃ
+.LP
+今後のリリースで導入されるタグについては、
.na
-\f2Proposed Javadoc Tags\fP @
+\f2「Proposed Javadoc Tags」\fP @
.fi
-http://java.sun.com/j2se/javadoc/proposed\-tags.htmlс
-.LP
-.LP
-憝鴻ф鴻帥違罨＜с
-.LP
-.RS 3
-
-.LP
+http://java.sun.com/j2se/javadoc/proposed\-tags.htmlを参照してください。
+.LP
+現時点で有効なタグは、次のとおりです。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -1267,7 +848,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f3絨ャ JDK/SDK 若吾с\fP
+\f3導入された JDK/SDK のバージョン\fP
.br
.di
.nr a| \n(dn
@@ -1278,7 +859,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3帥\fP
+.nr 38 \w\f3タグ\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f2@author\fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -1373,7 +954,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 1124 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 867 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1392,7 +973,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3帥\fP\h'|\n(41u'
+\&\h'|\n(40u'\f3タグ\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -1486,74 +1067,38 @@
.rm a+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
-
-.LP
-.RE
-.LP
-鴻帥帥違ゃ\-tag 激с潟с
-.LP
+.LP
+カスタムタグについては、\-tag オプションを参照してください。
.RS 3
.TP 3
@author\ name\-text
-\-author 激с潟篏帥翫ャ＜潟菴遵絎 \f2name\-text\fP 吾莨若帥障1 ゃャ＜潟若激с潟潟＜潟茲違 \f2@author\fP 帥違с障1 ゃ \f2@author\fP 帥違 1 ゃ絎1 ゃ帥違茲違絎с障翫Javadoc 若ｃ潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹ｆャ＜潟障障潟若障ｃ潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
+\-author オプションが使用されている場合、指定された \f2name\-text\fP を含む [作成者] エントリを生成ドキュメントに追加します。1 つのドキュメンテーションコメントに複数の \f2@author\fP タグを含めることができます。1 つの \f2@author\fP タグに 1 つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-荅括完ゃ帥違篏睡с贋
+.LP
+詳細については、「タグを使用できる場所」および
.na
-\f2@author 帥違ャ＜潟\fP @
+\f2@author タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorс
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorを参照してください。
+.LP
.RS 3
.TP 3
-@deprecated\ deprecated\-text
-.RS 3
-
-.LP
-.LP
-羈: JDK 5.0
-.na
-\f2@Deprecated 羈\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html篏帥ｃ劫違荀膣ｨ絅с障
-.LP
-.RE
+@deprecated\ deprecated\-text 注: @Deprecated 注釈を使って特定のプログラム要素を非推奨にできます。
.RE
-.RS 3
-
-.LP
-.LP
- API 篏膓障 API 篏睡鴻с腓冴潟＜潟菴遵障Javadoc 若\f2deprecated\-text\fP 筝肢腱糸ゃ帥若茘ｨ絅障菴遵障帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.LP
-.LP
-\f2deprecated\-text\fP с絨 API ｨ絅ｃ篁ｆ推戎鴻 API 茯腓冴綽荀障Javadoc 若网荀祉激с潟膣√潟若障с API ｨ絅宴茯с障障篁ｃ API 腓冴 \f2{@link}\fP 帥 (Javadoc 1.2 篁ラ翫) 綽荀障 罨＜荐菴違障
-.LP
-.LP
-荅括完ゃ
+.LP
+この API は動作し続けますが、この API を使用するべきではないことを示すコメントを追加します。Javadoc ツールは、 \f2deprecated\-text\fP を主説明の前に移動してイタリックにし、その前にボールドの警告「推奨されません。」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.LP
+\f2deprecated\-text\fP の最初の文では、少なくとも、その API が推奨されなくなった時期と、代替使用するべき API を読者に提示する必要があります。Javadoc ツールは、この最初の文だけを、概要セクションと索引にコピーします。そのあとの文では、その API が推奨されない理由を説明することもできます。代わりのAPI を指し示す \f2{@link}\fP タグ ( Javadoc 1.2 以降の場合) を含めるべきです。
+.LP
+詳細については、
.na
-\f2@deprecated 帥違ャ＜潟\fP @
+\f2@deprecated タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedを参照してください。
.RS 3
.TP 2
o
-Javadoc 1.2 篁ラс\f2{@link}\fP 帥違篏睡障綽荀贋ゃ潟ゃ潟с潟篏с障箴腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+Javadoc 1.2 以降では \f2{@link}\fP タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。たとえば、
.nf
\f3
.fl
@@ -1567,106 +1112,71 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.RS 3
.TP 2
o
-Javadoc 1.1 с \f2@deprecated\fP 帥違絲障 \f2@see\fP 帥 (ゃ潟ゃ潟с) 荐菴違罔羣綵√с
+Javadoc 1.1 の場合の標準形式は、 \f2@see\fP タグ (インラインは不可) を \f2@deprecated\fP タグごとに作成することです。
.RE
-
-.LP
-.LP
-ｨ絅帥違ゃ荅括完
+.LP
+推奨されないタグについての詳細は、
.na
-\f2@deprecated 帥\fP @
+\f2@deprecated タグ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlャ＜潟с
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。
+.LP
.RS 3
.TP 3
{@code\ text}
-\f2<code>{@literal}</code>\fP 膈с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-鴻 HTML 若≪障ャ絖ｃ javadoc 帥違茹ｉ\f2text\fP \f2code\fP 潟ц；腓冴障 doc 潟＜潟с＜若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟ｃｃ (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟＜潟鴻
-.LP
+\f2<code>{@literal}</code>\fP と同等です。
+.LP
+テキストを \f2HTML マークアップ\fP または \f2入れ子になった javadoc タグ\fP として解釈せずに、text をコードフォントで表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント
.nf
\f3
.fl
\fP\f4{@code A<B>C}\fP\f3
.fl
+
+.fl
+\fP
+.fi
+.LP
+は、生成された HTML ページで、次のようにそのまま表示されます。
+.nf
+\f3
+.fl
+ \fP\f4A<B>C\fP\f3
+.fl
+
+.fl
+\fP
+.fi
+.LP
+ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。
+.LP
+コードフォントなしで同じ機能を実現するには、\f2{@literal}\fP を使用します。
+.LP
+.TP 3
+{@docRoot}
+生成されるページから見た、生成ドキュメントの (生成先の) ルートディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの下部から著作権のページにリンクします。
+.LP
+この \f2{@docRoot}\fP タグは、コマンド行でもドキュメンテーションコメント内でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.RS 3
+.TP 3
+1.
+コマンド行では、ヘッダー、フッター、またはボトムノートは次のように定義します。
+.nf
+\f3
+.fl
+ javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
+.fl
.fl
\fP
.fi
-
-.LP
-.LP
- HTML 若吾с罨＜障乗；腓冴障
-.LP
-.nf
-\f3
-.fl
- \fP\f4A<B>C\fP\f3
-.fl
-
-.fl
-\fP
-.fi
-
-.LP
-.LP
-羈鴻鴻\f2<B>\fP 紊絖с茹ｉ障潟若潟障
-.LP
-.LP
-潟若潟у罘純絎憗\f2{@literal}\fP 篏睡障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.TP 3
-{@docRoot}
-若吾荀ャ＜潟 () 若ｃ吾後障鴻茵障帥違篏罔若吾篌腓障眼鴻若吾с＜ゃ腟粋昭箴水с絽吾若吾筝篏罔若吾潟障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
- \f2{@docRoot}\fP 帥違潟潟茵ャ＜潟若激с潟潟＜潟筝с篏睡с障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.LP
-.RS 3
-.TP 3
-1.
-潟潟茵с若帥若障若罨＜絎臂障
-.nf
-\f3
-.fl
- javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
-.fl
-
-.fl
-\fP
-.fi
-.LP
-\- \f2{@docRoot}\fP 翫筝 Makefile 違с筝綣 { } 絖鴻宴若綽荀障違Inprise MAKE 若吾с 5.2 Windows 筝у茵翫\f2{{@docRoot}}\fP筝綣с篋綽荀障\f2\-bottom\fP 激с潟絲障綣違筝綣膃с篋綣膃у蚊綽荀障 \f2href\fP 綣違ゃ蚊綣膃ャ障
+.LP
+注 \- \f2{@docRoot}\fP を Makefile 内でこのように利用する場合、一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする必要があります。たとえば、Inprise MAKE バージョン 5.2 を Windows 上で実行する場合は、 \f2{{@docRoot}} のように、中括弧を二重にする必要があります\fP。さらに、 \f2\-bottom\fP などのオプションに対する引数を、単一引用符ではなく二重引用符で囲む必要もあります ( \f2href\fP の引数を囲む引用符は省略)。
.TP 3
2.
-ャ＜潟若激с潟潟＜潟筝с罨＜篏睡障
+ドキュメンテーションコメントの中では、次のように使用します。
.nf
\f3
.fl
@@ -1676,16 +1186,13 @@
.fl
*/
.fl
-
+
.fl
\fP
.fi
.RE
-
-.LP
-.LP
-帥違綽荀宴ャ＜潟泣宴若吾羞宴ら絮ゆｃ主с罨＜箴腓冴障
-.LP
+.LP
+このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。次に例を示します。
.nf
\f3
.fl
@@ -1695,201 +1202,118 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜茹ｆ浦障
-.LP
+.LP
+次のように解決されます。
.nf
\f3
.fl
- <a href="../../copyright.html"> java/lang/Object.java 翫
+ <a href="../../copyright.html"> java/lang/Object.java の場合
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-
-.LP
+.LP
+かつ
.nf
\f3
.fl
- <a href="../../../copyright.html"> java/lang/ref/Reference.java 翫
+ <a href="../../../copyright.html"> java/lang/ref/Reference.java の場合
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
.TP 3
@exception\ class\-name\ description
-\f2@exception\fP 帥違\f2@throws\fP 帥違臂с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2@exception\fP タグは \f2@throws\fP と同義です。
+.LP
.TP 3
{@inheritDoc}\
-ｃ菴膓水純鴻障絎茖純ゃ潟帥с若鴻帥違憜ャ＜潟若激с潟潟＜潟ャ＜潟膓 (潟) 障罘純羆潟＜潟膓帥若筝篏荐菴違潟若鴻篏帥ｃ荐菴違с障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-帥違ャ＜潟若激с潟潟＜潟罨＜篏臀с炊鴻с
-.LP
+もっとも近い継承可能なクラスまたは実装可能なインタフェースから、このタグの現在のドキュメンテーションコメントに、ドキュメントを継承 (コピー) します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使って記述することができます。
+.LP
+このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。
.RS 3
.TP 2
o
-＜純筝肢翫筝肢筝篏絮ゃ鴻障ゃ潟帥с若鴻潟若
+メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる
.TP 2
o
-＜純 @return@param@throws 帥違鴻綣医翫帥違鴻筝篏絮ゃ絲上帥違潟若
+メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる
.RE
-
-.LP
-.LP
-膓翠絮ゃс潟＜潟荀ゃ号≪罩ｇ∈茯ゃ＜純潟＜潟潟若с帥違荀ゃ翫潟＜潟膀ц若綽膓帥羆冴障障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。
+.LP
.TP 3
-{@link\ \ package.class#member\ \ label}\
-茵腓冴鴻 \f2label\fP ゃ潟ゃ潟潟水ャ障 \f2label\fP с鴻絎宴若吾鴻障＜潟若ャ＜潟若激с潟腓冴障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-帥違\f2@see\fP 帥違鋍若障 ＜帥違\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP с篁鴻с鴻罕障ｃс紊с\f2{@link}\fP 潟 [∫ｉ] 祉激с潟臀сゃ潟ゃ潟潟с障ゃ潟ゃ潟鴻祉阪ャ\f2{@link}\fP 帥違緇筝綣с荐菴違障筝с}篏帥綽荀翫HTML 潟ｃｃ若}篏帥障
-.LP
-.LP
-1 ゃ筝т戎с \f2{@link}\fP 帥違違狗障帥違ャ＜潟若激с潟潟＜潟筝肢障 @deprecated@return@param 篁紙帥違鴻т戎с障
-.LP
-.LP
-違罨＜潟＜潟с \f2getComponentAt(int, int)\fP ＜純с障
-.LP
+{@link\ package.class#member\ label}
+表示テキスト \f2label\fP とのインラインリンクを挿入します。label は、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
+.LP
+このタグは \f2@see\fP と非常によく似ています。どちらも、\f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の参照の仕方が同じで、有効な構文もまったく同じです。大きな違いは、 \f2{@link}\fP では、[関連項目] セクションにリンクが配置される代わりに、インラインのリンクが生成されるという点です。また、インラインテキストのほかの部分と区別するために、 \f2{@link}\fP タグの最初と最後に中括弧を記述します。ラベルの中で「}」を使う必要がある場合は、HTML エンティティーの「}」を使います。
+.LP
+1 文内で使用可能な \f2{@link}\fP タグの数に制限はありません。このタグは、ドキュメンテーションコメントの主説明部分、または @deprecated、@return、@param などの任意のタグのテキスト部分で使うことができます。
+.LP
+たとえば、次のコメントでは \f2getComponentAt(int, int)\fP メソッドを参照しています。
.nf
\f3
.fl
-{@link #getComponentAt(int, int) getComponentAt} ＜純篏睡障
+{@link #getComponentAt(int, int) getComponentAt} メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-罔羣с筝荐潟＜潟罨＜ HTML 障 (潟＜潟宴若吾ャ鴻с翫)
-.LP
+.LP
+標準ドックレットでは、上記のコメントから次の HTML が生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。
.nf
\f3
.fl
-<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> ＜純篏睡障
+<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
- HTML Web 若娯с罨＜茵腓冴障
-.LP
+.LP
+この HTML は、Web ページ上では次のように表示されます。
.nf
\f3
.fl
-getComponentAt ＜純篏睡障
+getComponentAt メソッドを使用します。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-\f2{@link}\fP ャ＜潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
-.LP
-.LP
-荅括完ゃ
+.LP
+\f2{@link}\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。
+.LP
+詳細については、
.na
-\f2{@link} 帥違ャ＜潟\fP @
+\f2{@link} タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}с
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}を参照してください。
+.LP
.TP 3
{@linkplain\ package.class#member\ label}
-潟潟若潟с若潟鴻ц；腓冴剛札紊 \f2{@link}\fP с若潟鴻ц菴違箴水с箴:
-.RE
-
-.LP
-.RS 3
-
-.LP
+リンクのラベルがコードフォントではなくプレーンテキストで表示される点以外は \f2{@link}\fP と同じです。ラベルがプレーンテキストで記述されていると便利です。次の例を参照してください。例:
.nf
\f3
.fl
- {@linkplain add() the overridden method} с
+ {@linkplain add() the overridden method} を参照してください。
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-篁ヤ茵腓冴障
-.LP
-.RS 3
-
-.LP
-.LP
-the overridden method с
-.LP
-.RE
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+これは以下のように表示されます。
+.LP
+the overridden method を参照してください。
+.LP
.TP 3
{@literal\ text}
-鴻 HTML 若≪障ャ絖ｃ javadoc 帥違茹ｉ\f2text\fP 茵腓冴障 doc 潟＜潟с＜若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟ｃｃ (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟＜潟鴻
-.RE
-
-.LP
-.RS 3
-
-.LP
+テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、 \f2text\fP を表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント
.nf
\f3
.fl
@@ -1899,40 +1323,22 @@
.fl
\fP
.fi
-
-.LP
-.LP
- HTML 若吾吟ф＜障乗；腓冴障
-.LP
-.LP
-\f2\ \ \ \ \ \fPA<B>C
-.LP
-.LP
-羈鴻鴻\f2<B>\fP 紊絖с茹ｉ障 (潟若潟)
-.LP
-.LP
-潟若潟у罘純絎憗\f2{@code}\fP 篏睡障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+は、生成された HTML ページはブラウザで次のようにそのまま表示されます。
+.LP
+\f2\ \ \ \ \ \fPA<B>C
+.LP
+ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。
+.LP
+コードフォントで同じ機能を実現するには、\f2{@code}\fP を使用します。
+.LP
.TP 3
@param\ parameter\-name description
-絎 \f2parameter\-name\fP 絎 \f2description\fP 篏睡＜若帥Parameters祉激с潟菴遵障doc 潟＜潟荐菴違\f2description\fP 茲域膓с障帥違＜純潟潟鴻帥障鴻 doc 潟＜潟с炊鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2parameter\-name\fP ＜純障潟潟鴻帥с＜若帥鴻＜純障潟潟鴻帥帥ゃ＜若帥障絮掩綣сс＜若水蚊＜若帥篏睡絎障
-.LP
-.LP
-鴻＜若帥箴:
-.LP
+指定された \f2parameter\-name\fP のあとに指定された \f2description\fP が続くパラメータを、[パラメータ] セクションに追加します。ドキュメンテーションコメントを記述するときには、 \f2description\fP を複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスの doc コメント内でのみ有効です。
+.LP
+\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。山括弧でパラメータ名を囲むと、型パラメータを使用することを 指定します。
+.LP
+クラスの型パラメータの例:
.nf
\f3
.fl
@@ -1950,11 +1356,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-＜純＜若帥箴:
-.LP
+.LP
+メソッドの型パラメータの例:
.nf
\f3
.fl
@@ -1978,125 +1381,87 @@
.fl
\fP
.fi
-
-.LP
-.LP
-荅括完ゃ
+.LP
+詳細については、
.na
-\f2@param 帥違ャ＜潟\fP @
+\f2@param タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramを参照してください。
+.LP
.TP 3
@return\ description
-[祉] 祉激с潟菴遵\f2description\fP 鴻吾莨若帥障鴻с祉ゃ緇ゃ膀蚊ゃ荐菴違綽荀障帥違＜純ャ＜潟若激с潟潟＜潟с炊鴻с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-荅括完ゃ
+[戻り値] セクションを追加して、 \f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。
+.LP
+詳細については、
.na
-\f2@return 帥違ャ＜潟\fP @
+\f2@return タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnを参照してください。
+.LP
.TP 3
-@see\ \ reference
-[∫ｉ] 荀冴菴遵\f2reference\fP 潟障鴻潟吾莨若帥障1 ゃャ＜潟若激с潟潟＜潟篁紙違 \f2@see\fP 帥違絎с障 鴻 \f2@see\fP 帥違絎鴻荀冴筝違若障\f2@see\fP 帥違罨＜ 3 腮蕁綵√障 ｃ鋎帥3 綵√с帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с宴若吾鴻障＜潟若絲障ゃ潟ゃ潟潟筝水ャ号\f2{@link}\fP с
+@see\ reference
+「関連項目」見出しを追加し、 \f2reference を指すリンクか、またはテキストエントリを書き込みます\fP。ドキュメンテーションコメントには任意の数の \f2@see\fP タグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。 \f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバーに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。
.RS 3
.TP 3
@see "string"
-\f2string\fP 鴻潟菴遵障潟障\f2string\fP 悟障 URL с≪祉鴻с宴усJavadoc 若絖篋綣膃 (\f2"\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
+\f2string のテキストエントリを追加します\fP。リンクは生成されません。 \f2string\fP は、書籍または URL ではアクセスできない情報の参照先です。Javadoc ツールは、最初の文字が二重引用符 (\f2"\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。たとえば、
.nf
\f3
.fl
@see "The Java Programming Language"
.fl
-
-.fl
-\fP
-.fi
-.LP
-罨＜鴻障
-.RE
-.RS 3
-.RS 3
-
-.LP
-.RS 3
-.TP 3
-∫ｉ:
-The Java Programming Language
-.RE
-
-.LP
-.RE
-.RE
-.TP 3
-@see <a href="URL#value">label</a>
-\f2URL\fP#\f2value\fP у臂潟菴遵障\f2URL\fP#\f2value\fP 後 URL 障腟九 URL сJavadoc 若絖絨荐 (\f2<\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
-.nf
-\f3
-.fl
- @see <a href="spec.html#section">Java Spec</a>
-.fl
.fl
\fP
.fi
.LP
-罨＜潟障
-.RS 3
-.RS 3
-.TP 3
-∫ｉ:
-Java Spec
-.RE
+これは次のようなテキストを生成します。
.RE
.RE
.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
+.RS 3
+.RS 3
.RS 3
.TP 3
+関連項目:
+The Java Programming Language
+.RE
+.RE
+.TP 3
+@see <a href="URL#value">label</a>
+\f2URL\fP#\f2value\fP で定義されたとおりにリンクを追加します。 \f2URL\fP#\f2value\fP は相対 URL または絶対 URL です。Javadoc ツールは、最初の文字が「より小さい」記号 (\f2<\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。たとえば、
+.nf
+\f3
+.fl
+ @see <a href="spec.html#section">Java Spec</a>
+.fl
+\fP
+.fi
+これは次のようなリンクを生成します。
+.RS 3
+.TP 3
+関連項目:
+Java Spec
+.RE
+.TP 3
@see\ package.class#member\ label
-絎ゃс Java 荐茯＜潟若ゃャ＜潟潟茵腓冴鴻 \f2label\fP 菴遵障\f2label\fP ュ純с \f2label\fP ャ潟＜潟若膰茵腓冴障 茵腓冴号с\-noqualifier 篏睡茵腓冴鴻宴若後篏ゃ障茵腓冴鴻違茵腓冴鴻絎翫篏帥障
-.LP
-若吾с 1.2 с <code> HTML 帥医茵腓冴障 1.2.2 篏睡<code> 絽吾茵腓冴鴻蚊＜с障障
+可視のテキスト \f2label\fP を持つリンクを追加します。このリンクは、参照先となる、指定された Java 言語の名前のドキュメンテーションを指します。 \f2label\fP は省略可能です。label を省略すると、リンク先のメンバーの名前が適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。\-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。
+.LP
+バージョン 1.2 だけは、ラベルではなく、名前が <code> HTML タグ内に自動的に表示されます。 1.2.2 からは、ラベルを使用するか、しないかにかかわらず、<code> は常に表示テキストを囲むかたちで、含まれます。
.LP
.RS 3
.TP 2
o
-\f4package.class\fP\f4#\fP\f4member\fP с篁紙鴻違荀膣絎障 ゃ障宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純障ｃ若с ＜潟弱若激ｃ若荐 (\f2#\fP) х舟障\f2class\fP 篁紙障ャ絖鴻障ゃ潟帥с若鴻茵障\f2member\fP 篁紙潟潟鴻帥＜純障ｃ若 (ャ絖鴻障ゃ潟帥с若鴻с) 茵障絎ャ＜潟鴻障翫Javadoc 若吾潟篏障紊с鴻吾潟篏\f2\-link\fP 激с潟篏帥障с鴻絮ャ＜潟с祉 2 ゃ綵√ \f2@see\fP 帥違篏帥障綣違ゃ絎ц潟顄障
-.TP 2
-o
-\f4label\fP ュ純鴻с潟茵腓冴障\f2label\fP 腥榊純с障\f2label\fP ャ\f2package.class.member\fP 憜鴻潟宴若吾綽膰茵腓冴障 茵腓冴号с
+\f4package.class\fP\f4#\fP\f4member\fP には、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名ーの前のドットは、シャープ記号 (\f2#\fP) で置き換えます。 \f2class\fP は、任意のトップレベルまたは入れ子にされたクラスまたはインタフェースを表します。 \f2member\fP は、任意のコンストラクタ、メソッドまたはフィールド (入れ子にされたクラスまたはインタフェースではない) を表します。指定した名前が、ドキュメント化されているクラスに含まれている場合、Javadoc ツールは、その名前へのリンクを自動的に作成します。外部参照クラスへのリンクを作成するには、\f2\-link\fP オプションを使います。参照先のクラスに属していない名前のドキュメンテーションを参照するには、残り 2 つの \f2@see\fP 形式のうちのどちらかを使用します。この引数については、このあとの「名前の指定」で詳しく説明します。
.TP 2
o
-腥榊醇絖\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP 阪絖с綣с眼腥榊醇絖茹ｉ＜純＜若翠腥榊醇絖ャ障障
+\f4label\fP は、省略可能なテキストで、リンクのラベルとして表示されます。 \f2label\fP には空白を含めることができます。 \f2label\fP を省略すると、\f2package.class.member\fP が、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。
+.TP 2
+o
+空白が、 \f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。
.RE
.LP
-\f3箴\fP \- 箴с\f2Character\fP 鴻 \f2@see\fP 帥違\f2String\fP 鴻 \f2equals\fP ＜純с障帥違 \f2String#equals(Object)\fP \f2equals\fP 筝≧鴻綣違障障
-.RS 3
-
-.LP
+\f3例\fP \- この例では、 \f2@see\fP タグ ( \f2Character\fP クラス内) が String クラスの \f2equals\fP メソッド \f2を参照\fP しています。このタグには名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。
.nf
\f3
.fl
@@ -2106,62 +1471,33 @@
.fl
*/
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-罔羣罨＜ HTML 障
-.RS 3
-
-.LP
+標準ドックレットは、次のような HTML を生成します。
.nf
\f3
.fl
<dl>
.fl
-<dt><b>See also:</b>
+<dt><b>See Also:</b>
.fl
<dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
.fl
</dl>
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-吟с罨＜茵腓冴潟鴻障
-.RS 3
+これは、ブラウザでは次のように表示され、ラベルがリンクテキストになります。
.RS 3
.TP 3
-∫ｉ:
+関連項目:
equals
.RE
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.LP
-\f3絎\fP \- 帥違絎 \f2package.class\fP\f2#\fP\f2member\fP \f2java.lang.String#toUpperCase()\fP 絎絎\f2String#toUpperCase()\fP \f2#toUpperCase()\fP 絎с障絎絎翫Javadoc 若Java 潟潟ゃ絽吾罎膣∫綺с罎膣≪障荅括完@see 罎膣∫綺с＜純茲違綣違綣с眼с亥榊純с障
-.LP
-.LP
-絎絎鴻ュ絖違羝純若鴻潟若茯帥с罨＜茵障障綵√腓冴障 茵筝с\f2Class\fP 鴻障ゃ潟帥с若鴻\f2Type\fP 鴻ゃ潟帥с若鴻障堺若水 \f2method\fP ＜純障潟潟鴻帥絎с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.RS 3
+.LP
+\f3名前の指定\fP \- この \f2package.class\fP\f2#\fP\f2member\fP という名前は、 \f2java.lang.String#toUpperCase()\fP のような完全修飾名にすることも、 \f2String#toUpperCase()\fP や \f2#toUpperCase()\fP のような非完全修飾名にすることもできます。名前が完全指定されていない場合、Javadoc ツールは、Java コンパイラの通常の検索順序でその名前を検索します。詳細は、このあとの「@see の検索順序」を参照してください。名前には、メソッドの複数の引数の間など、括弧の内側であれば空白を含めることができます。
+.LP
+「部分的に指定」した短い名前を指定することの利点は、入力する文字数が減ることや、ソースコードが読みやすくなることです。次の表に、さまざまな形式の名前を示します。ここで、 \f2Class\fP にはクラスまたはインタフェースを、 \f2Type\fP にはクラス、インタフェース、配列、または基本データ型を、 \f2method\fP にはメソッドまたはコンストラクタを、それぞれ指定できます。
+.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2191,7 +1527,7 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 筝綵√\fP
+\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 の一般的な形式\fP
.br
.di
.nr a| \n(dn
@@ -2207,9 +1543,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3憜鴻＜潟若с\fP
+\f3現在のクラスのメンバーを参照する\fP
.br
-\f2@see\fP\ \f2#\fP\f2field\fP
+\f2@see\fP\ \f2#\fP\f2フィールド\fP
.br
\f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2233,21 +1569,21 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3憜障ゃ潟若宴若吾ャ鴻с\fP
+\f3現在の、またはインポートされたパッケージの別のクラスを参照する\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2フィールド\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
.br
\f2@see\fP\ \f2Class.NestedClass\fP
.br
-\f2@see\fP\ \f2Class\fP
+\f2@see\fP\ \f2クラス\fP
.br
.di
.nr c| \n(dn
@@ -2263,9 +1599,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3ャ宴若吾荀膣с\fP\ (絎篆蕋)
+\f3別のパッケージの要素を参照する\fP\ (完全修飾)
.br
-\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2フィールド\fP
.br
\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2279,7 +1615,7 @@
.br
\f2@see\fP\ \f2package.Class\fP
.br
-\f2@see\fP\ \f2package\fP
+\f2@see\fP\ \f2パッケージ\fP
.br
.di
.nr d| \n(dn
@@ -2308,7 +1644,7 @@
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 1860 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1358 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2396,74 +1732,52 @@
.rm d+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-58
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-筝茵絲障茖莇割罨＜腓冴障
-.LP
+.LP
+上の表に対する補足事項を次に示します。
.RS 3
.TP 2
o
-腮蕁綵√ (宴若吾鴻) 翫Javadoc 若憜鴻絮ゃ罎膣≪障ゃ障憜鴻ゃ潟帥с若鴻鴻若若鴻鴻若若ゃ潟帥с若鴻障憜鴻ゃ潟帥с若鴻蚊с鴻ゃ潟帥с若鴻＜潟若罎膣≪障 (罎膣∽ 1 3)憜宴若吾祉祉宴若吾罎膣≪障 (罎膣∽ 4 5)
+最初の種類の形式 (パッケージとクラスを省略) の場合、Javadoc ツールは、現在のクラスの階層だけを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、または現在のクラスかインタフェースを囲んでいるクラスかインタフェースからメンバーを検索します (このあとの検索手順 1 ~ 3)。現在のパッケージのほかの部分や、ほかのパッケージは検索しません (検索手順 4 ~ 5)。
.TP 2
o
-＜純障潟潟鴻帥絎綣с篁 (\f2getValue\fP ) 篏睡翫ｃ若絖違Javadoc 若＜純絲障罩ｃ潟篏障 綣с綣違菴遵篆茘＜祉若吾阪障＜純若若若翫Javadoc 若罎膣≪ф荀ゃｃ＜純潟障 腟ｃ劫с障
-.TP 2
-o
-ャ絖鴻筝荐綵√翫\f2inner\fPс\f2outer\fP\f2.\fP\f2inner\fP絎違障
+メソッドまたはコンストラクタの指定時に、 \f2getValue\fP のように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadoc ツールによってその名前へのリンクが正しく作成されますが、括弧や引数の追加をユーザーに促すための警告メッセージが表示されます。このメソッドがオーバーロードされている場合、Javadoc ツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。
.TP 2
o
-с菴違鴻鴻＜潟若阪 (\f2.\fP) с激ｃ若荐 (\f2#\fP) 篏睡羈絎Javadoc 若障茹ｆ浦с障 鴻ャ絖鴻宴若吾潟泣宴若吾阪篏睡障Javadoc 若с筝荐怨合蚊綺障違с罩ｃ頵ｆ障 翫с茘茵腓冴障
+入れ子になったクラスは、すべての形式について、 \f2outer\fP\f2.\fP\f2inner\fP として指定する必要があります。単純に \f2inner\fP とはしないでください。
+.TP 2
+o
+すでに述べたように、\f2クラスとメンバーとの間の区切り文字としては、\fPドット (\f2.\fP) ではなくシャープ文字 (#) を使用します。このように指定すると、Javadoc ツールは、あいまいさを解決できます。ドットは、クラス、入れ子にされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されます。ただし、Javadoc ツールでは一般に許容範囲が広く、あいまいさがなければ、ドットでも正しく解析されます。その場合でも警告は表示されます。
.RE
-
-.LP
-.LP
-\f3@see 罎膣∫綺\fP \- Javadoc 若純若鴻＜ゃ (.java)宴若吾＜ゃ (package.html 障 package\-info.java)障网荀＜ゃ (overview.html) 筝糸眼 \f2@see\fP 帥違障緇 2 ゃ＜ゃс絎絎 \f2@see\fP 帥違絎違障純若鴻＜ゃс絎絎障絎絎с障
-.LP
-.LP
-Javadoc 若\f2.java\fP ＜ゃу絎с荐菴違 \f2@see\fP 帥違荀ゃJava 潟潟ゃ綺ф絎罎膣≪障 Javadoc 若劫腥咲障罎冴障 純若鴻潟若若絖с罎膣∫綺Java 荐茯篁罕膃 2 膃 6 腴Namesфｅ絎臂障Javadoc 若∫ｃ鴻宴若吾潟ゃ潟若鴻宴若吾鴻罎膣≪障隙罨＜綺ф膣≪障
-.LP
+.LP
+\f3@see の検索順序\fP \- Javadoc ツールは、ソースファイル (.java)、パッケージファイル (package.html または package\-info.java) または概要ファイル (overview.html) に含まれる \f2@see\fP タグを処理します。後者の 2 つのファイルでは、完全指定の名前を \f2@see\fP タグに指定しなければなりません。ソースファイルでは、完全指定の名前、または部分指定の名前を指定できます。
+.LP
+Javadoc ツールは、完全指定でない名前が記述された \f2@see\fP タグを \f2.java ファイル内で見つけると、\fP Java コンパイラと同じ順序で指定された名前を検索します。 ただし、Javadoc ツールは、特定の名前空間のあいまいさを検出しません。 これは、ソースコードにこれらのエラーが存在していないことを前提としているためです。この検索順序は、Java 言語仕様第 2 版の第 6 章「Names」で正式に定義されています。Javadoc ツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてから名前を検索します。具体的には、次の順序で検索します。
.RS 3
.TP 3
1.
-憜鴻障ゃ潟帥с若
+現在のクラスまたはインタフェース
.TP 3
2.
-紊眼蚊с鴻ゃ潟帥с若 (ｃ菴罎膣)
+外側を囲んでいるクラスとインタフェース (もっとも近いものから検索)
.TP 3
3.
-鴻若若鴻鴻若若ゃ潟帥с若 (ｃ菴罎膣)
+スーパークラスとスーパーインタフェース (もっとも近いものから検索)
.TP 3
4.
-憜宴若
+現在のパッケージ
.TP 3
5.
-ゃ潟若宴若吾鴻潟ゃ潟帥с若 (import 綺緇ｃ罎膣)
+インポートされているパッケージ、クラス、およびインタフェース (import 文の順序に従って検索)
.RE
-
-.LP
-.LP
-Javadoc 若鴻ゃ 1 3 絽亥筝眼荀ゃ障ф膣≪膓障ゃ障障憜鴻罎膣≪罨＜鴻蚊с E 罎膣≪罨＜ E 鴻若若鴻罎膣≪罨＜ E 蚊с鴻罎膣≪障 4 5 с1 ゃ宴若後鴻障ゃ潟帥с若鴻罎膣≪綺羆冴障ｃ障 綺潟潟ゃｃ違障 5 сJavadoc 若java.lang 罎膣≪障 宴若吾鴻違ゃ潟若с
-.LP
-.LP
-Javadoc 若綽泣鴻罎膣≪障 障javadoc 絎茵筝祉宴若吾ャ＜潟翫с祉宴若吾罎膣≪障違\f2@see\fP 帥違 \f2java.awt.event.KeyEvent\fP 劫ｃ\f2java.awt\fP 宴若吾с翫Javadoc 鴻ゃ潟若宴若吾罎膣≪障
-.LP
-.LP
-\f3茵腓冴号\fP \- \f2label\fP ャ\f2package.class.member\fP 茵腓冴障筝package.class.member 憜鴻潟宴若吾綽膰障膰綽荀絨茵腓冴с違\f2String.toUpperCase()\fP ＜純鴻＜潟若吾с祉鴻＜潟若吾с障翫劫茵腓冴緇宴若鴻с (罨＜茵)
-.LP
-.LP
-宴若後綺ゃ\-noqualifier 篏睡障
+.LP
+Javadoc ツールは、各クラスについて手順 1 ~ 3 を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にそのクラスを囲んでいるクラス E を検索し、その次に E のスーパークラスを検索し、さらにその次に E を囲んでいるクラスを検索します。 手順 4 と 5 では、1 つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません。その順序は、個々のコンパイラによって異なります。手順 5 では、Javadoc ツールは、java.lang を検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。
+.LP
+Javadoc ツールは、必ずしもサブクラスを検索するとは限りません。また、javadoc の実行中にほかのパッケージのドキュメントが生成される場合でも、ほかのパッケージを検索しません。たとえば、 \f2@see\fP タグが \f2java.awt.event.KeyEvent\fP クラス内に含まれていて、 \f2java.awt\fP パッケージ内のある名前を参照していても、そのクラス内でそのパッケージがインポートされないかぎり、javadoc はそのパッケージ内での検索を行いません。
+.LP
+\f3名前が表示される方法\fP \- \f2label\fP を省略した場合は、\f2package.class.member\fP が表示されます。一般に、package.class.member は、現在のクラスおよびパッケージに応じて適切に短縮されます。「短縮される」とは、必要最小限の名前だけが表示されるということです。たとえば、 \f2String.toUpperCase()\fP メソッドに、同じクラスのメンバーへの参照とほかのクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースだけです (次の表を参照)。
+.LP
+パッケージ名を広域的に削除するには、\-noqualifier を使用します。
.br
-
-.LP
-.RE
-.RS 3
-.RS 3
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2493,7 +1807,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f4String.toUpperCase()\fP\f3 с箴\fP
+\f4String.toUpperCase() での例\fP
.br
.di
.nr a| \n(dn
@@ -2509,7 +1823,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違鴻＜潟若с
+\f2@see\fP タグが同じクラス、同じパッケージのメンバーを参照している
.br
.di
.nr b| \n(dn
@@ -2525,7 +1839,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2toLowerCase()\fP (劫)
+\f2toLowerCase()\fP (クラス名は省略)
.br
.di
.nr c| \n(dn
@@ -2541,7 +1855,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違ャ鴻＜潟若с
+\f2@see\fP タグが異なるクラス、同じパッケージのメンバーを参照している
.br
.di
.nr d| \n(dn
@@ -2573,7 +1887,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2Character.toLowerCase(char)\fP (宴若後ャ劫)
+\f2Character.toLowerCase(char)\fP (パッケージ名は省略し、クラス名を含む)
.br
.di
.nr f| \n(dn
@@ -2589,7 +1903,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP 帥違ャ鴻＜潟若с
+\f2@see\fP タグが異なるクラス、異なるパッケージのメンバーを参照している
.br
.di
.nr g| \n(dn
@@ -2621,7 +1935,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2java.io.File.exists()\fP (宴若後劫)
+\f2java.io.File.exists()\fP (パッケージ名とクラス名を含む)
.br
.di
.nr i| \n(dn
@@ -2632,7 +1946,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3с腮蕁\fP
+.nr 38 \w\f3参照の種類\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
@@ -2654,7 +1968,7 @@
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 82 0
-.nr 38 \w\f3茵腓冴\fP
+.nr 38 \w\f3表示される名前\fP
.if \n(82<\n(38 .nr 82 \n(38
.82
.rm 82
@@ -2676,7 +1990,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 1958 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1434 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2695,7 +2009,7 @@
.ta \n(80u \n(81u \n(82u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3с腮蕁\fP\h'|\n(41u'\h'|\n(42u'\f3茵腓冴\fP
+\&\h'|\n(40u'\f3参照の種類\fP\h'|\n(41u'\h'|\n(42u'\f3表示される名前\fP
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -2814,22 +2128,14 @@
.rm i+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f3@see 箴\fP
+.LP
+\f3@see の例\fP
.br
-勀眼潟＜潟\f2@see\fP 帥違ャ宴若 (\f2java.applet.Applet\fP ) 劫翫茵腓冴腓冴障
-.LP
+右側のコメントは、 \f2@see\fP タグが \f2java.applet.Applet\fP のような別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。
.nf
\f3
.fl
- ∫ｉ:
+ 関連項目:
.fl
@see java.lang.String // String \fP\f3
.fl
@@ -2849,121 +2155,68 @@
.fl
@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
.fl
-
-.fl
\fP
.fi
-
-.LP
-.LP
-\f2@see\fP ャ＜潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
-.LP
-.LP
-荅括完ゃ
+\f2@see\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。
+.LP
+詳細については、
.na
-\f2@see 帥違ャ＜潟\fP @
+\f2@see タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeを参照してください。
.RE
-.LP
-
+.RE
.LP
.RS 3
.TP 3
@serial\ field\-description | include | exclude
-翫純ｃ若ャ＜潟若激с潟潟＜潟т戎障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2field\-description\fP (ュ) сｃ若潟茯緇ゃ鴻腓冴綽荀障綽荀綽茲違茵羝＜ｃ茯荐菴違с障罔羣宴翫綵√若吾菴遵障
-.LP
-.LP
-鴻翫違翫純ｃ若鴻菴遵翫筝肢菴遵若吾с潟茘ャ菴遵綽荀障
-.LP
-.LP
-\f2include\fP \f2exclude\fP 綣違翫綵√若吾鴻障宴若吾ゅ腓冴障綣違罨＜号障
-.LP
+デフォルトの直列化可能フィールドのドキュメンテーションコメントで使用します。
+.LP
+\f2field\-description\fP (省略可能) では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式のページに追加します。
+.LP
+クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。
+.LP
+\f2include\fP および \f2exclude\fP 引数は、直列化された形式のページにクラスまたはパッケージを含めるか除外するかを示します。これらの引数には、次のような効果があります。
.RS 3
.TP 2
o
-\f2Serializable\fP 絎茖 public 障 protected 鴻絽吾若吾障 鴻障鴻絮宴若吾 \f2@serial exclude\fP ф絎若吾ゅ障
+\f2Serializable\fP を実装している public または protected クラスは、そのクラス (またはそのパッケージ) が \f2@serial exclude\fP としてマークされていないかぎり、含められます。
.TP 2
o
-\f2Serializable\fP 絎茖 private 障 package private 鴻絽吾若吾ゅ障 鴻障鴻絮宴若吾 \f2@serial include\fP ф絎若吾障
+\f2Serializable\fP を実装している private または package\-private クラスは、そのクラス (またはそのパッケージ) が \f2@serial include\fP として マークされていないかぎり、除外されます。
.RE
-
-.LP
-.LP
-箴: \f2javax.swing\fP 宴若吾\f2@serial exclude\fP ф絎障 (\f2package.html\fP 障 \f2package\-info.java\fP )public \f2java.security.BasicPermission\fP \f2@serial exclude\fP ф絎障package private \f2java.util.PropertyPermissionCollection\fP \f2@serial include\fP ф絎障
-.LP
-.LP
-鴻ф絎 @serial 帥違宴若吾ф絎 @serial 帥違若若ゃ障
-.LP
-.LP
-帥違篏睡羈ゃ荅括完篏睡箴Java 吾с翫篁罕膃 1.6 膀
+.LP
+例: \f2javax.swing\fP パッケージは \f2@serial exclude\fP ( \f2package.html\fP または \f2package\-info.java\fP内) としてマークされています。public クラス \f2java.security.BasicPermission\fP は \f2@serial exclude\fP としてマークされています。package\-private クラス \f2java.util.PropertyPermissionCollection\fP は \f2@serial include\fP としてマークされています。
+.LP
+クラスレベルで指定された @serial タグは、パッケージレベルで指定された @serial タグをオーバーライドします。
+.LP
+これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節
.na
-\f2鴻翫純ｃ若潟若帥後\fP @
+\f2「クラスの直列化可能なフィールドおよびデータの文書化」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlс障
+http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、
.na
-\f2翫 FAQ\fP @
-.fi
-http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingс FAQ \-private 鴻ゃ絎 javadoc 絎茵 private ｃ若 @serial 帥違荀ゃ javadoc 茘茵腓冴筝莖吾膈荐莠障翫綵√鋌罕鴻翫
-.na
-\f2Sun 篁罕\fP @
+\f2「直列化の FAQ」\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingも参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、
+.na
+\f2「Sun の仕様」\fP @
+.fi
+http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlも参照してください。
+.LP
.TP 3
@serialField\ field\-name\ field\-type\ field\-description
-\f2Serializable\fP 鴻 \f2serialPersistentFields\fP ＜潟若 \f2ObjectStreamField\fP 潟潟若潟ャ＜潟障 \f2ObjectStreamField\fP 潟潟若潟絲障 \f2@serialField\fP 帥違 1 や戎綽荀障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+Serializable \f2クラスの\fP serialPersistentFields \f2メンバーの\fP ObjectStreamField コンポーネント \f2をドキュメント化\fP します。1 つの \f2@serialField\fP タグを各 \f2ObjectStreamField\fP コンポーネントで使用すべきです。
+.LP
.TP 3
@serialData\ data\-description
-\f2data\-description\fP 翫綵√с若帥綺茯鴻с若帥鴻\f2writeObject\fP ＜純ｃ吾莨若障ュ純若帥 \f2Externalizable.writeExternal\fP ＜純ｃ吾莨若障鴻若 (阪鴻) 障障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2@serialData\fP 帥違\f2writeObject\fP\f2readObject\fP\f2writeExternal\fP\f2readExternal\fP\f2writeReplace\fP \f2readResolve\fP ＜純ャ＜潟若激с潟潟＜潟т戎с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2data\-description\fP は、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、 \f2writeObject\fP メソッドによって書き込まれる省略可能なデータ、および \f2Externalizable.writeExternal\fP メソッドによって書き込まれるすべてのデータ (基底クラスも含む) が含まれます。
+.LP
+\f2@serialData\fP タグは、 \f2writeObject\fP、 \f2readObject\fP、 \f2writeExternal\fP、 \f2readExternal\fP、 \f2writeReplace\fP、および \f2readResolve\fP メソッドのドキュメンテーションコメント内で使用できます。
+.LP
.TP 3
@since\ since\-text
-ャ＜潟 [絨ャ若吾с] 荀冴菴遵絎 \f2since\-text\fP 吾莨若帥障鴻劫ャ罕障帥違鴻ャ＜潟若激с潟潟＜潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥＜純潟ｃ若ф鴻с帥違劫紊眼障罘純\f2since\-text\fP 腓冴純с≪若剛札絖潟障箴腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+生成ドキュメントに [導入されたバージョン] 見出しを追加し、指定された \f2since\-text\fP を書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。このタグは、特定の変更または機能が、 \f2since\-text に示されたソフトウェアリリース以降、存在していることを意味します\fP。たとえば、
.nf
\f3
.fl
@@ -2973,52 +2226,26 @@
.fl
\fP
.fi
-
-.LP
-.LP
-Java 若純若鴻潟若翫帥違Java 若 API 篁罕若吾с潟腓冴障 紊眼罘純＜潟劫茖菴遵腓冴障茲違 @since 帥違篏睡с茲違 @author 帥違宴障違荀膣茲違 API т戎翫茲違帥違篏睡с障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。
+.LP
.TP 3
-@throws\ class\-name\ description\
-\f2@throws\fP 帥違 \f2@exception\fP 帥違臂сャ＜潟 [箴紊] 絨頳冴菴遵\f2class\-name\fP \f2description\fP 鴻吾莨若帥障\f2class\-name\fP ＜純鴻若醇с箴紊с帥違＜純潟潟鴻帥 doc 潟＜潟с炊鴻с鴻絎絎ц菴違翫Javadoc 若罎膣∫綺緇ｃ鴻｢障障違箴紊 doc 潟＜潟с茲違 \f2@throws\fP 帥違篏睡с障
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-鴻с羝推紊ャ＜潟\f2@throws\fP 帥違 throws 膀箴紊絖翫@throws 帥違ャ＜潟сJavadoc 若ｃ箴紊 HTML 阪茯ц菴遵障
-.LP
-.LP
-若若ゃ＜純т紊腓榊絎ｈ翫帥\f2@throws\fP ャ＜潟若激с潟＜純泣鴻潟若障ゃ潟帥с若鴻＜純絎茖＜純潟若翫罕с@throws ャ＜潟若激с潟膓帥{@inheritDoc} 篏睡с障
-.LP
-.LP
-荅括完ゃ
+@throws\ class\-name\ description
+\f2@throws\fP タグと \f2@exception\fP タグは同義です。生成ドキュメントに「例外」小見出しを追加して、 \f2class\-name\fP および \f2description\fP のテキストを書き込みます。 \f2class\-name\fP は、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタの doc コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、Javadoc ツールは、検索順序に従ってクラスを探します。同じまたは異なる例外の doc コメントで、複数の \f2@throws\fP タグを使用できます。
+.LP
+すべてのチェック済み例外がドキュメント化されるようにするために、 \f2@throws\fP タグが throws 節内の例外用に存在しない場合は、@throws タグのあるドキュメントであるかのように、Javadoc ツールによって例外が HTML 出力に説明なしで自動的に追加されます。
+.LP
+オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、 \f2@throws\fP ドキュメンテーションがそのメソッドからサブクラスにコピーされます。インタフェースメソッドから実装メソッドにコピーされる場合も同様です。@throws にドキュメンテーションを継承させるには、{@inheritDoc} を使用できます。
+.LP
+詳細については、
.na
-\f2@throws 帥違ャ＜潟\fP @
+\f2@throws タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionс
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionを参照してください。
+.LP
.TP 3
{@value\ package.class#field}
-\f2{@value}\fP ｃ若 doc 潟＜潟 綣違т戎翫絎違ゃ茵腓冴障
-.RE
-
-.LP
-.RS 3
-
-.LP
+\f2{@value}\fP が静的フィールドの doc コメントで 引数なしで使用されている場合、その定数の値が表示されます。
.nf
\f3
.fl
@@ -3034,11 +2261,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-篁紙 doc 潟＜潟у \f2package.class#field\fP т戎翫絎絎違ゃ茵腓冴障
-.LP
+.LP
+任意のドキュメンテーションコメント内で引数 \f2package.class#field\fP ありで使用された場合は、その指定された定数の値が表示されます。
.nf
\f3
.fl
@@ -3056,448 +2280,130 @@
.fl
\fP
.fi
-
-.LP
-.LP
-綣 \f2package.class#field\fP @see 綣違筝綵√障＜潟若ｃ若違鴻違障
-.LP
-.LP
-絎違сゃ
+.LP
+引数 \f2package.class#field\fP は、@see 引数と同一の形式になります。ただし、メンバーが静的フィールドになければならない点が異なります。
+.LP
+これらの定数での値は、
.na
-\f2絎違ｃ若\fP @
+\f2定数フィールド値\fP @
.fi
-http://java.sun.com/javase/6/docs/api/constant\-values.html若吾茵腓冴障
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/javase/6/docs/api/constant\-values.htmlページにも表示されます。
+.LP
.TP 3
@version\ version\-text
-\-version 激с潟篏帥翫ャ＜潟 [若吾с] 絨頳冴菴遵絎 \f2version\-text\fP 吾莨若帥障帥違潟若障純с≪憜若吾с括垩篆潟障 絲障@since 潟若絨ャ若吾с括垩篆障\f2version\-text\fP 劫ャ罕障若吾с潟帥違篏睡с贋茯帥鴻帥違篏睡с贋с
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-1 ゃャ＜潟若激с潟潟＜潟茲違 \f2@version\fP 帥違с障綽荀綽\f2@version\fP 帥違 1 ゃ若吾с括垩絎帥違茲違若吾с括垩絎с障翫Javadoc 若ｃ潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹ｆャ＜潟障障潟若障ｃ潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
-.LP
-.LP
-荅括完ゃ
+\-version オプションが使用されると、生成ドキュメントに [バージョン] 小見出しを追加し、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。 \f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。
+.LP
+1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。意味が失われない範囲内で、1 つの \f2@version\fP タグに 1 つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が名前の間に挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
+.LP
+詳細については、
.na
-\f2@version 帥違ャ＜潟\fP @
+\f2@version タグのドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionс
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionを参照してください。
.RE
-.LP
.SS
-帥違篏睡с贋
-.LP
-с帥違篏睡с贋ゃ茯障\f2@see\fP\f2@since\fP\f2@deprecated\fP\f2{@link}\fP\f2{@linkplain}\fP \f2{@docroot}\fP 帥違鴻 doc 潟＜潟т戎с障
-.RS 3
-
-.LP
+タグを使用できる場所
+.LP
+ここでは、タグを使用できる場所について説明します。すべてのドキュメンテーションコメントで使用可能なタグは次のとおりです。 \f2@see\fP、 \f2@since\fP、 \f2@deprecated\fP、 \f2{@link}\fP、 \f2{@linkplain}\fP、および \f2{@docroot}\fP。
.SS
-网荀ャ＜潟若激с潟帥
-.LP
-.LP
-网荀帥違网荀若吾ャ＜潟若激с潟潟＜潟т戎с帥違с ャ＜潟若激с潟潟＜潟絽 \f2overview.html\fP 純若鴻＜ゃ障祉ャ＜潟若激с潟潟＜潟翫罕帥違筝肢т戎綽荀障
-.LP
-.LP
-\f3羈\fP \- 若吾с 1.2 с网荀ャ＜潟 \f2{@link}\fP 帥違違障鴻罩ｃ頫腓冴障潟荐絎障憜\f2{@docRoot}\fP 帥違网荀ャ＜潟с篏障
-.LP
+概要のドキュメンテーションタグ
+.LP
+概要タグは、概要ページのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは、通常 \f2overview.html\fP という名前のソースファイル内にあります。 ほかのドキュメンテーションコメントの場合と同様に、これらのタグは、主説明のあとで使う必要があります。
+.LP
+\f3注\fP \- バージョン 1.2 では、概要ドキュメント内の \f2{@link}\fP タグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、 \f2{@docRoot}\fP タグは、概要ドキュメント内では動作しません。
+.LP
+\f3概要タグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3网荀帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2279 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3网荀帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-宴若吾ャ＜潟若激с潟帥
-.LP
-.LP
-宴若吾帥違宴若吾ャ＜潟若激с潟潟＜潟т戎с帥違с ャ＜潟若激с潟潟＜潟\f2package.html\fP 障 \f2package\-info.java\fP 純若鴻＜ゃ障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
-.LP
+パッケージドキュメンテーションタグ
+.LP
+パッケージタグは、パッケージのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは \f2package.html\fP または \f2package\-info.java\fP という名前のソースファイル内にあります。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。
+.LP
+\f3パッケージタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3宴若吾帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2315 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3宴若吾帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-鴻潟ゃ潟帥с若鴻ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜鴻障ゃ潟帥с若鴻ャ＜潟若激с潟潟＜潟т戎с帥違腓冴障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
-.LP
+クラスおよびインタフェースドキュメンテーションタグ
+.LP
+次に、クラスまたはインタフェースのドキュメンテーションコメントで使用できるタグを示します。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。
+.LP
+\f3クラスおよびインタフェースタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3鴻潟ゃ潟帥с若鴻帥\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2355 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3罨＜鴻潟＜潟箴腓冴障\fP
-.LP
+\f3次にクラスコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3533,137 +2439,44 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-ｃ若ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜ｃ若ャ＜潟若激с潟潟＜潟т戎с帥違腓冴障
-.LP
+フィールドドキュメンテーションタグ
+.LP
+次に、フィールドのドキュメンテーションコメントで使用できるタグを示します。
+.LP
+\f3フィールドタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@serialField\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-\f2{@value}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3ｃ若帥\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2436 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3ｃ若帥\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@serialField\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
+.TP 2
+o
+\f2{@value}\fP
.RE
-\f3罨＜ｃ若潟＜潟箴腓冴障\fP
-.LP
+\f3次にフィールドコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3679,170 +2492,50 @@
.fl
int x = 1263732;
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-潟潟鴻帥潟＜純ャ＜潟若激с潟帥
-.LP
-.LP
-罨＜潟潟鴻帥障＜純ャ＜潟若激с潟潟＜潟ц；腓冴с帥違腓冴障 \f2@return\fP 潟潟鴻帥с茵腓冴с\f2{@inheritDoc}\fP 茵腓冴狗障\f2@serialData\fP 帥違劫翫＜純 doc 潟＜潟с推戎с障
-.LP
+コンストラクタおよびメソッドドキュメンテーションタグ
+.LP
+次に、コンストラクタまたはメソッドのドキュメンテーションコメントで使用できるタグを示します。ただし、 \f2@return\fP はコンストラクタでは使用できず、 \f2{@inheritDoc}\fP には特定の制限があります。 \f2@serialData\fP タグは特定の直列化メソッドの doc コメントでのみ使用できます。
+.LP
+\f3メソッドおよびコンストラクタタグ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3＜純潟潟潟鴻帥帥\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@param\fP
-.br
-\f2@return\fP
-.br
-\f2@throws\fP \f2@exception\fP
-.br
-\f2@serialData\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@inheritDoc}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2503 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-30
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@param\fP
+.TP 2
+o
+\f2@return\fP
+.TP 2
+o
+\f2@throws\fP と \f2@exception\fP
+.TP 2
+o
+\f2@serialData\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@inheritDoc}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3罨＜＜純ャ＜潟若激с潟潟＜潟箴腓冴障\fP
-.LP
+\f3次にメソッドのドキュメンテーションコメントの例を示します。\fP
.nf
\f3
.fl
@@ -3874,22 +2567,13 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-.RE
-.SH "激с"
-.LP
-.LP
-javadoc 若篏帥ｃ阪羆阪障Javadoc 若\-doclet 激с潟с鴻帥絎翫篁ュ罔羣篏帥障Javadoc 若篁紙篏睡с潟潟茵激с潟障 激с潟ゃJavadoc 激с潟ц障罔羣с祉ゃ菴遵潟潟茵激с潟箴障 激с潟ゃ罔羣箴激с潟ц障激с喝紊ф絖絨絖阪ャ障 激с潟綣違с紊ф絖絨絖阪ャ障
-.LP
-.LP
-激с潟罨＜腓冴障
-.LP
-.RS 3
-
-.LP
+.SH "オプション"
+.LP
+javadoc ツールは、ドックレットを使って出力を決定します。Javadoc ツールは、\-doclet オプションでカスタムドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使います。Javadoc ツールには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、このあとの「Javadoc オプション」で説明します。標準ドックレットでは、このほかに、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、そのあとの「標準ドックレットが提供するオプション」で説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。
+.LP
+オプションは次のとおりです。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -4043,6 +2727,8 @@
.br
\-\f2sourcepath\fP
.br
+\-sourcetab
+.br
\-splitindex
.br
\-stylesheetfile
@@ -4055,6 +2741,8 @@
.br
\-tagletpath
.br
+\-top
+.br
\-title
.br
\-use
@@ -4101,7 +2789,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 2680 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 2009 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4157,54 +2845,49 @@
.rm b+
.rm c+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
-
-.LP
-.RE
-.LP
-\f2ゃ帥\fPхず激с潟Javadoc 堺激с潟сJavadoc 若潟潟ｃ箴鴻т戎с障罔羣篏ゃ帥с激с潟箴障
-.LP
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-127
+.LP
+\f2イタリック\fP で示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。
.SS
-Javadoc 激с
-.LP
+Javadoc オプション
.RS 3
.TP 3
\-overview \ path/filename
-Javadoc 絲障\f2path/filename\fP ф絎純若鴻＜ゃ网荀ャ＜潟鴻緇鴻网荀若 (\f2overview\-summary.html\fP) 臀絎障\f2path/filename\fP \f2\-sourcepath\fP 吾後障鴻с
-.LP
-\f2filename\fP \f2path\fP 篁紙贋絎с障絽吾\f2overview.html\fP 篁純若鴻弱筝篏宴若吾ｃｃ臀障贋臀\f2\-sourcepath\fP ｃ＜ゃ腓冴с宴若吾ャ＜潟 \f2path\fP 筝荀障違\f2java.lang\fP 宴若吾純若鴻若 \f2/src/classes/java/lang/\fP 翫网荀＜ゃ \f2/src/classes/overview.html\fP 臀с障篏睡箴с
-.LP
-\f2path/filename\fP ф絎＜ゃゃ网荀潟＜潟＜ゃс
-.LP
-网荀若吾篏Javadoc 茲違宴若後羝＜翫с荅括完HTML 若с
-.LP
-网荀若吾帥ゃ\f2\-doctitle\fP ｃ荐絎障
+Javadoc に対して、\f2path/filename\fP で指定された「ソース」ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ (\f2overview\-summary.html\fP) に配置するように指定します。 \f2path/filename\fP は、カレントディレクトリからの相対パスです。
+.LP
+\f2filename\fPで任意の名前を使用し、\f2path\fP で任意の配置先を選択することも可能ですが、通常は \f2overview.html\fP という名前を付け、ソースツリー内の最上位パッケージディレクトリを含むディレクトリ内に配置します。この場所に配置すると、パッケージをドキュメント化するときに \f2path\fP を指定する必要がなくなります。なぜなら、 \f2\-sourcepath\fP によってこのファイルが指し示されるからです。たとえば、 \f2java.lang\fP パッケージのソースツリーが \f2/src/classes/java/lang/\fP の場合、概要ファイルを \f2/src/classes/overview.html\fP に配置できます。「使用例」を参照してください。
+.LP
+\f2path/filename\fP で指定するファイルについては、「概要コメントファイル」を参照してください。
+.LP
+概要ページが作成されるのは、Javadoc に複数のパッケージ名を渡した場合だけです。詳細は、「HTML フレーム」を参照してください。
+.LP
+概要ページのタイトルは、\f2\-doctitle\fP によって設定されます。
.LP
.TP 3
\-public
-public 鴻潟＜潟若茵腓冴障
+public クラスおよびメンバーだけを表示します。
.LP
.TP 3
\-protected
-protected public 鴻＜潟若茵腓冴障荐絎с
+protected および public のクラスとメンバーだけを表示します。これがデフォルトです。
.LP
.TP 3
\-package
-packageprotected public 鴻＜潟若茵腓冴障
+package、protected、および public のクラスとメンバーだけを表示します。
.LP
.TP 3
\-private
-鴻鴻＜潟若茵腓冴障
+すべてのクラスとメンバーを表示します。
.LP
.TP 3
\-help
-潟ゃ潟茵腓冴障 Javadoc 潟潟茵激с潟筝荀ц；腓冴障
+オンラインヘルプを表示します。Javadoc とドックレットのコマンド行オプションが一覧表示されます。
.LP
.TP 3
\-doclet\ class
-ャ＜潟篏帥莎桁鴻＜ゃ絎障絎絎絎阪絎鴻綵√絎臂障\f4\-doclet\fP 激с潟篏帥翫Javadoc 罔羣篏帥ｃ HTML 綵√障鴻\f2start(Root)\fP ＜純障違障莎桁鴻吾鴻\f2\-docletpath\fP 激с潟ｃ絎臂障
-.LP
-違MIF 若喝冴罨＜絎障
+ドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。完全指定の名前を指定してください。このドックレットにより、出力の内容と形式が定義されます。\f4\-doclet\fP オプションが使われていない場合、Javadoc は、標準ドックレットを使ってデフォルトの HTML 形式を生成します。このクラスには \f2start(Root)\fP が含まれている必要があります。この起動クラスへのパスは \f2\-docletpath\fP オプションによって定義されます。
+.LP
+たとえば、MIF ドックレットを呼び出すには、次のように指定します。
.nf
\f3
.fl
@@ -4213,17 +2896,17 @@
\fP
.fi
.LP
-劫絎茵絎箴ゃ
+特定のドックレットを実行した完全な例については、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
.LP
.TP 3
\-docletpath\ classpathlist
-\f2\-doclet\fP 激с潟ф絎紮鴻＜ゃ潟箴絖鴻 jar ＜ゃ吾鴻絎障紮鴻＜ゃ jar ＜ゃ翫篁ヤ箴 jar ＜ゃ鴻絎障腟九障鴻障憜ｃ後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR ＜ゃс障 翫鴻障 JAR ＜ゃSolaris 翫潟 (:)Windows 翫祉潟 (;) у阪障紮鴻с罎膣≪劫翫激с潟筝荀с
-.LP
-jar ＜ゃ吾鴻箴紮鴻＜ゃ障障jar ＜ゃ障鴻羈
+\f2\-doclet\fP オプションで指定されたドックレット開始クラスファイル、 およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。開始クラスファイルが jar ファイル内にある場合、以下の例のように jar ファイルのパスが指定されます。絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP には、複数のパスまたは JAR ファイルを含めることができます。 その場合、各パスまたは JAR ファイルを、Solaris の場合にはコロン (:)、Windows の場合にはセミコロン (;) で区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。
+.LP
+jar ファイルへのパスの例には、ドックレット開始クラスファイルが含まれています。jar ファイル名が含まれている点に注目してください。
.nf
\f3
.fl
@@ -4231,7 +2914,7 @@
.fl
\fP
.fi
-紮鴻＜ゃ鴻箴鴻＜ゃャ鴻羈
+ドックレット開始クラスファイルのパスの例。クラスファイル名が省略されている点に注目してください。
.nf
\f3
.fl
@@ -4239,212 +2922,40 @@
.fl
\fP
.fi
-劫絎茵絎箴ゃ
+特定のドックレットを実行した完全な例については、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
.LP
.TP 3
\-1.1
-\f2罘純Javadoc 1.4 сゃ障篁ｆ炊純障激с潟Javadoc 1.1 ｃ紊荀罘純ゃャ＜潟篏с ャ絖鴻泣若障激с潟綽荀翫Javadoc 1.2 障 1.3 篏睡\fP
+\f2この機能は Javadoc 1.4 から削除されました。代替機能はありません。このオプションは、Javadoc 1.1 によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした。入れ子のクラスはサポートされていません。このオプションが必要な場合は、Javadoc 1.2 または 1.3 を使用してください。\fP
.LP
.TP 3
\-source release
-篁純若鴻潟若若吾с潟絎障\f2release\fP 罨＜ゃ絎с障
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80 81
-.nr 34 \n(.lu
-.eo
-.am 81
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.5 уャ膩霡違割荐茯罘純潟若篁障\f3\-source\fP 違絎潟潟ゃ 1.5 篏障
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.4 уャ≪泣若激с潟潟若篁障
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di c+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc JDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
-.br
-.di
-.nr c| \n(dn
-.nr c- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 31 0
-.nr 32 0
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.5\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.4\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.3\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.80
-.rm 80
-.nr 60 \n(31
-.nr 38 \n(60+\n(32
-.if \n(38>\n(80 .nr 80 \n(38
-.if \n(38<\n(80 .nr 60 +(\n(80-\n(38)/2
-.nr 81 0
-.81
-.rm 81
-.nr 38 \n(a-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(b-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(c-
-.if \n(81<\n(38 .nr 81 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr 60 +\n(40
-.nr 41 \n(80+(3*\n(38)
-.nr 81 +\n(41
-.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 2790 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.5\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.4\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(c|u+\n(.Vu
-.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.3\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.c+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.rm c+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
-.LP
-javac с潟若潟潟ゃ篏睡ゃ絲上 \f2release\fP ゃ篏睡障
+受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
+.RS 3
+.TP 2
+o
+\f31.5\fP \- javadoc は、JDK 1.5 で導入された総称などの言語機能を含むコードを受け付けます。\f3\-source\fP フラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5 のものになります。
+.TP 2
+o
+\f31.4\fP Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
+.TP 2
+o
+\f31.3\fP Javadoc は、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
+.RE
+.LP
+javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。
.LP
.TP 3
\-sourcepath\ sourcepathlist
-\f2javadoc\fP 潟潟宴若後障 \f2\-subpackages\fP 羝＜純若鴻＜ゃ (\f2.java\fP) 罎膣≪鴻絎障\f2sourcepathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎剛札筝鴻泣ｃ罎膣≪障激с潟篏帥ｃャ＜潟純若鴻＜ゃ篏臀с篏ャ＜潟ャ＜潟純若鴻＜ゃ膓帥潟＜潟ゃ純若鴻＜ゃ篏臀腆肴с障
-.LP
-\f2\-sourcepath\fP 激с潟javadoc 潟潟宴若後羝＜篏睡с障 \f2javadoc\fP 潟潟羝＜ \f2.java\fP ＜ゃ鴻罎膣≪障\f2.java\fP ＜ゃ罎膣≪＜ゃｃ cd ｃ腱糸障＜ゃ鴻障 (1 や札筝鴻ャ＜潟)\f2\-sourcepath\fP ャ翫Javadoc 鴻鴻篏帥ｃ純若鴻＜ゃ罎膣≪障 (\-classpath )ｃ \-sourcepath 鴻鴻ゃс\-classpath ャ宴若後 Javadoc 羝＜Javadoc 憜ｃ潟泣ｃ純若鴻＜ゃ罎膣≪障
-.LP
-\f2sourcepathlist\fP ャ＜潟宴若後純若鴻若若ｃ荐絎障違\f2com.mypackage\fP 宴若吾ャ＜潟翫純若鴻＜ゃ罨＜贋障
+パッケージ名または \-subpackages を javadoc コマンドに渡すときは、ソースファイル (.\f2.java\fP) を見つけるための \f2検索パス\fP を指定 \f2します\fP 。\f2sourcepathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使って、ドキュメント化されるソースファイルの位置だけでなく、それ自体はドキュメント化されないがドキュメント化されるソースファイルから継承されたコメントを持つソースファイルの位置も確認できます。
+.LP
+\f2\-sourcepath\fP オプションを使用できるのは、javadoc コマンドにパッケージ名を渡す場合だけです。このパスからは、javadoc コマンドに渡された \f2.java\fP ファイルは \f2検索\fP されません。 \f2.java\fP ファイルを検索するには、そのファイルのあるディレクトリに cd によって移動するか、または各ファイルの先頭にパスを含めます (「1 つ以上のクラスのドキュメント化」を参照)。 \f2\-sourcepath\fP が省略された場合、Javadoc は、クラスパスを使ってソースファイルを検索します (\-classpath を参照)。したがって、デフォルトの \-sourcepath は、クラスパスの値です。\-classpath も省略してパッケージ名を Javadoc に渡すと、Javadoc は現在のディレクトリおよびそのサブディレクトリからソースファイルを検索します。
+.LP
+\f2sourcepathlist\fP には、ドキュメント化するパッケージ名のソースツリーのルートディレクトリを設定します。たとえば、 \f2com.mypackage\fP という名前のパッケージをドキュメント化する場合に、そのソースファイルが次の場所にあるとします。
.nf
\f3
.fl
@@ -4452,16 +2963,16 @@
.fl
\fP
.fi
-翫罨＜ \f2sourcepath\fP \f2/home/user/src\fPゃ障 \f2com/mypackage\fP ｃ絎宴若後 \f2com.mypackage\fP 絎障
+このとき次のように、 \f2sourcepath\fP を、com/mypackage を含むディレクトリである \f2/home/user/src\fP に指定したあと、 パッケージ名 \f2com.mypackage\fP を指定します。
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP
.fl
.fi
-号純若鴻鴻ゃ宴若後ｇ (荐) \\紊宴若吾 (C:\\user\\src\\com\\mypackage) 茹ｃ膂≦с\f2/home/user/src/com/mypackage\fP.
-.LP
-2 ゃ純若鴻鴻荐絎罨＜障
+この方法は、ソースパスの値とパッケージ名を連結して、ドットを (円記号) 「\\」に変えると、パッケージのフルパス \f2/home/user/src/com/mypackage になることを理解すると簡単です\fP。
+.LP
+2 つのソースパスを設定するには、次のようにします。
.nf
\f3
.fl
@@ -4471,132 +2982,124 @@
.LP
.TP 3
\-classpath\ classpathlist
-Javadoc с (\f2.class\fP ＜ゃ) 罎膣≪鴻絎障 с鴻ャ＜潟鴻鴻ｃс鴻鴻с\f2classpathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣ｃ罎膣≪障\f2classpathlist\fP 絎
+javadoc が参照クラス (\f2.class\fP ファイル) の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスから参照されるすべてのクラスを指します。\f2classpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。 Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。classpathlist を指定するときは、
.na
-\f2鴻\fP @
+\f2クラスパス\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalャ＜潟腓冴緇ｃ
-.LP
-\f2\-sourcepath\fP ャ翫Javadoc 若\f2\-classpath\fP 篏帥ｃ鴻＜ゃс純若鴻＜ゃ罎膣≪障 (筝篏篋с)ｃ純若鴻＜ゃ鴻＜ゃャ鴻罎膣≪綽荀翫\f2\-sourcepath\fP \f2\-classpath\fP 筝≧鴻篏帥障
-.LP
-違\f2com.mypackage\fP ャ＜潟翫純若鴻＜ゃｃ \f2/home/user/src/com/mypackage\fP 宴若吾 \f2/home/user/lib\fP ゃ篏帥с違罨＜絎障
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalのドキュメントにある指示 \f2に従ってください\fP。
+.LP
+\f2\-sourcepath\fP が省略されると、Javadoc ツールはクラスファイルを検索するときだけでなく、ソースファイルを検索するときにも \f2\-classpath\fP を使用します (下位互換性のため)。したがって、ソースファイルとクラスファイルを別々のパスから検索する必要がある場合は、 \f2\-sourcepath\fP と \f2\-classpath の両方を使います\fP.。
+.LP
+たとえば、 \f2com.mypackage\fP をドキュメント化する場合に、そのソースファイルがディレクトリ \f2/home/user/src/com/mypackage\fP 内に格納されており、このパッケージが \f2/home/user/lib\fP 内のライブラリに依存しているとします。このとき次のように指定します。
.nf
\f3
.fl
% \fP\f3javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage\fP
.fl
.fi
-祉若罕\f2\-classpath\fP 絎翫CLASSPATH 医紊違荐絎違Javadoc 若医紊違篏帥障＜荐絎翫Javadoc 若憜ｃ鴻罎膣≪障
-.LP
-Javadoc 若≦宍罘純鴻潟若鴻鴻∫ｃJavadoc 若 \f2\-classpath\fP 篏睡若吟若鴻罎膣≪号ゃ荅括完
+\f2\-classpath\fP が指定されなかった場合、Javadoc ツールはほかのツールと同じく、CLASSPATH 環境変数が設定されていればその値を使用します。どちらも設定されていない場合、Javadoc ツールは現在のディレクトリからクラスを検索します。
+.LP
+Javadoc ツールが \f2\-classpath\fP を使用してユーザークラスを検索する方法について、拡張クラスやブートストラップクラスと関連付けて説明している情報を入手するには、
.na
-\f2鴻罎膣∽号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html荀с
-.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。
+.LP
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。* だけから成る \f2クラスパスエントリは、\fP カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.LP
.TP 3
\-subpackages\ \ package1:package2:...
-純若鴻＜ゃ絎宴若吾潟泣宴若後絽亥ャ＜潟障激с潟純若鴻潟若違泣宴若吾菴遵箴水с違泣宴若吾腟粋昭障障 \f2package\fP 綣違篁紙筝篏泣宴若 (\f2java\fP ) 障絎絎宴若 (\f2javax.swing\fP ) 障純若鴻＜ゃ綽荀障綣違潟潟у阪障 (鴻若ｃ潟違激鴻)ゃ若筝荀с (篏睡筝)宴若吾罎膣√贋絎\f2\-sourcepath\fP 篏睡障激с潟純若鴻＜ゃц純若鴻若宴若吾絮純若鴻＜ゃу醜腴＜障
-.LP
-箴腓冴障
+ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソースコードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。各 \f2package\fP 引数は、任意の最上位サブパッケージ ( \f2java\fP など) または完全修飾パッケージ ( \f2javax.swing\fP など) になります。ソースファイルを含める必要はありません。引数は、コロンで区切られます (すべてのオペレーティングシステム)。ワイルドカードは不要です (使用不可)。パッケージの検索場所を指定するには、\f2\-sourcepath\fP を使用します。このオプションは、「ソースファイルの処理」で説明したとおり、ソースツリーにあるがパッケージには属していないソースファイルを処理しないので役立ちます。
+.LP
+たとえば、
.nf
\f3
.fl
% \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
.fl
.fi
-潟潟java潟javax.swing宴若吾泣宴若後ャ＜潟障
-.LP
-\f2\-exclude\fP \f2\-subpackages\fP 篏睡劫宴若吾ゅс障
+このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。
+.LP
+\f2\-subpackages\fP と \f2\-exclude\fP を組み合わせて使用すると、特定のパッケージを除外できます。
.LP
.TP 3
\-exclude\ \ packagename1:packagename2:...
-絎宴若吾泣宴若吾 \f2\-subpackages\fP ｃ篏鴻≧＞散ゅ障ｻ \f2\-subpackages\fP 激с潟絎ｃ腟粋昭障宴若吾障絨ョ粋昭障宴若吾ゅ絲乗院障箴腓冴障
+指定されたパッケージとそのサブパッケージを \f2\-subpackages\fP によって作成されたリストから無条件に除外します。 過去の \f2\-subpackages\fP オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。 次に例を示します。
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
.fl
.fi
-＜\f2java.io\fP\f2java.util\fP\f2java.math\fP 腟粋昭障障\f2java.net\fP \f2java.lang\fP 篁ヤ宴若吾ゅ障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
+この場合、 \f2java.io\fP、 \f2java.util\fP、 \f2java.math\fP などが含められ、 \f2java.net\fP と \f2java.lang\fP をルートに持つパッケージが除外されます。この場合、 \f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP も除外される点に注意してください。
.LP
.TP 3
\-bootclasspath\ classpathlist
-若鴻絖鴻絎障若鴻絽吾Java 若潟≪鴻с若鴻鴻Javadoc 若純若鴻＜ゃ鴻＜ゃ｢篏帥罎膣≪鴻筝с荅括完
+ブートクラスが存在するパスを指定します。ブートクラスとは、通常、Java プラットフォームのコアクラスのことです。ブートクラスパスは、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、
.na
-\f2javac javadoc 鴻罎膣≪号\fP @
+\f2「クラスの検索方法」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesс\f2classpathlist\fP 茲違ｃ潟 (:) у阪障
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。コロン (:) を、 \f2classpathlist\fP 内のディレクトリ間の区切り文字として使用します。
.LP
.TP 3
\-extdirs\ dirlist
-≦宍罘純鴻絖ｃ絎障≦宍罘純鴻Java ≦宍罘醇罕篏帥鴻鴻сextdirs Javadoc 若純若鴻＜ゃ鴻＜ゃ｢篏帥罎膣≪鴻筝с荅括完菴違 \f2\-classpath\fP с\f2dirlist\fP 茲違ｃ潟 (:) у阪障
+拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java 拡張機能機構を使うすべてのクラスです。extdirs は、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、前述の \f2\-classpath\fP を参照してください。コロン (:) を、 \f2dirlist\fP 内のディレクトリ間の区切り文字として使用します。
.LP
.TP 3
\-verbose
-javadoc 絎茵筝荅括完＜祉若吾茵腓冴障verbose 激с潟絎純若鴻＜ゃ若ャ＜潟 (純若鴻＜ゃ 1 ゃ＜祉若)潟純若＜祉若吾茵腓冴障verbose 激с潟絎 Java 純若鴻＜ゃ茹ｆ荀 (腱篏) 菴遵＜祉若吾茵腓冴障
+javadoc の実行中に詳細なメッセージを表示します。verbose オプションを指定しないと、ソースファイルのロード時、ドキュメントの生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時にメッセージが表示されます。verbose オプションを指定すると、各 Java ソースファイルの解析に要した時間 (ミリ秒単位) など、追加のメッセージが表示されます。
.LP
.TP 3
\-quiet
-若＜祉若吾障茘＜祉若娯札紊＜祉若吾吟茘若茵腓冴劫障若吾с恰絖吟障
+エラーメッセージまたは警告メッセージ以外のメッセージを抑制し、警告とエラーだけが表示されるようにして、これらを特定しやすくします。バージョン文字列も抑制します。
.LP
.TP 3
\-breakiterator\
-沿荐茯宴若堺≪眼冴с
+英語の最初の文の末尾を決定する際に、英語用のロケール固有のアルゴリズムではなく、
.na
\f2java.text.BreakIterator\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html 初紜篏睡掩腟ゆ障 (篁鴻宴若с \f2BreakIterator\fP 篏睡)\f2\fP宴若吾鴻障＜潟若筝肢сс宴若吾鴻障＜潟若荀膣潟若≪＜ゃ潟鴻潟若障
-.LP
-JDK 1.2 篁ラBreakIterator 鴻沿ゃ鴻荐茯腟ゆс篏睡障ｃ1.2 篁ラс\f2\-breakiterator\fP 激с潟掩篁ュ号障掩罨＜≪眼冴障
+http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html の国際化された文境界を使用します (ほかのすべてのロケールではすでに \f2BreakIterator\fP が使用されている)。\f2「最初の文」\fPとは、パッケージ、クラス、またはメンバーの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバーの要約にコピーされ、アルファベット順のインデックスにコピーされます。
+.LP
+JDK 1.2 以降、BreakIterator クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、 \f2\-breakiterator\fP オプションは、1.2 以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。
.RS 3
.TP 2
o
-掩阪≪眼冴 \- 腥榊純障 HTML 帥 (\f2<P>\fP ) 膓у罩≪
+英文のデフォルトの文区切りアルゴリズム \- 空白または HTML ブロックタグ ( \f2<P>\fP など) が続くピリオドで停止する
.TP 2
o
-breakiterator 阪≪眼冴 \- 筝罨＜茯紊ф絖у障翫腥榊醇絖膓霳障膃у罩≪≪眼冴с祉ヨ；荐 (The serial no. is validMr. Smith)HTML 帥違医障荐垩у障с罩≪HTML 帥違莨若障翫с../filename緇у罩≪
+breakiterator 文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止する。このアルゴリズムでは「The serial no. is valid」など、ほとんどの省略表記が処理されますが、「Mr. Smith」などは処理されません。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する
.RE
-.RS 3
-
-.LP
-.LP
-羈: 1.5.0 1.4.x 荐 breakiterator 茘＜祉若吾ゃ阪≪眼冴紊眼障ゃ障\\\-breakiterator 激с潟1.5.0 сс障ゃ障罨＜＜吾ｃ若若鴻(1.5.0) с紊眼篁ュｃ障ゃ障純若鴻潟若紊眼1.4.x с breakiterator 茘ゅｻ翫с1.5.0 篏綽荀茘羔羯障 祉宴breakiterator ＜綽荀篋с純若鴻紊眼鴻莢紊сｃс篁吟х罕篏羞隙恒荅潟障
-.LP
-.RE
+.LP
+注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\\\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。この件で皆様に余分の手間をおかけし、混乱を招いたことをお詫びいたします。
.TP 3
\-locale\ language_country_variant
-.RS 3
-.LP
-\f3荀\fP \- \f2\-locale\fP 激с潟罔羣箴鴻激с潟障篁篁紙箴鴻激с潟 (綏) 絎綽荀障蚊若激с潟若沿ц；腓冴障潟潟茵激с潟絎綺箴絖障
-.LP
-.RE
-.LP
-Javadoc ャ＜潟篏帥宴若絎障綣違java.util.Locale ャ＜潟ц宴若絎障違\f2en_US\fP (沿膠喝)\f2en_US_WIN\fP (Windows т戎沿) 絎障
-.LP
-宴若絎絎宴若純若鴻＜ゃ Javadoc ｃ御＜祉若 (蚊若激с潟若鴻茵荀冴＜ゃ罨＜stylesheet.css 潟＜潟絖) 篏帥障障≪＜純若鴻純若恰絨障ゅャ阪絖絎宴若ｃ羆冴障障激с潟ャ＜潟鴻純若鴻＜ゃф絎ャ＜潟若激с潟潟＜潟鴻宴若羆阪с障
+.LP
+\f3重要\fP \- \f2\-locale\fP オプションは、\f2標準ドックレットが提供するすべてのオプション\fP、またはその他の任意のドックレットの提供するすべてのオプションより前 (左側) に指定する必要があります。そうしないと、ナビゲーションバーが英語で表示されます。このコマンド行オプションだけは、指定する順序に依存します。
+.LP
+Javadoc がドキュメントを生成するときに使うロケールを指定します。この引数は次のような、java.util.Locale のドキュメンテーションで説明されているロケールの名前です。 \f2en_US\fP (英語、米国) または \f2en_US_WIN\fP (Windows で使用される英語)。
+.LP
+ロケールを指定すると、指定したロケールのリソースファイルが Javadoc によって選択されて、メッセージ (ナビゲーションバー、リストと表の見出し、ヘルプファイルの目次、stylesheet.css のコメントなどの文字列) のために使われます。また、アルファベット順にソートされるリストのソート順、および最初の文の末尾を判別するための文の区切り文字も、指定したロケールによって決まります。ただし、このオプションは、ドキュメント化されるクラスのソースファイル内で指定されているドキュメンテーションコメントのテキストのロケールを決定するものではありません。
.LP
.TP 3
\-encoding\ name
-純若鴻＜ゃ潟潟若ｃ潟違 (\f2EUCJIS/SJIS\fP ) 絎障激с潟絎翫若潟潟若帥篏帥障
-.LP
-\-docencoding \-charset с
+ソースファイルのエンコーディングの名前 ( \f2EUCJIS/SJIS\fP など) を指定します。 このオプションが指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
+.LP
+\-docencoding および \-charset も参照してください。
.LP
.TP 3
\-Jflag
-javadoc 絎茵絎茵激鴻 java \f2flag\fP 贋･羝＜障\f2J\fP \f2flag\fP 腥榊純ャ障違ャ＜潟激鴻 32M ゃ＜≪若腆坂鏆荀翫Java \f2\-Xmx\fP 激с潟罨＜若喝冴障 \f2\-Xms\fP ュ純с ＜≪若泣ゃ冴荐絎激с潟с綽荀＜≪若絨泣ゃ冴ｃ翫箴水с
+javadoc を実行する実行時システム java に、\f2flag\fP を直接渡します。 \f2J\fP と \f2flag\fP の間に空白を入れないように注意してください。たとえば、生成ドキュメントの処理用として32M バイトのメモリーをシステムで確保しておく必要がある場合には、java の \f2\-Xmx\fP オプションを次のように呼び出します。\f2\-Xms\fP は省略可能です。これは、メモリーの初期サイズを設定するだけのオプションで、メモリーの最低必要量がわかっている場合に便利です。
.nf
\f3
.fl
% \fP\f3javadoc \-J\-Xmx32m \-J\-Xms32m\fP \f3com.mypackage\fP
.fl
.fi
-篏睡 javadoc 若吾с潟腆肴罨＜ java \f2\-version\fP激с潟若喝冴障
+使用している javadoc のバージョンを確認するには、次のように Java の\f2「\-version」\fPオプションを呼び出します。
.nf
\f3
.fl
@@ -4607,17 +3110,16 @@
Classic VM (build JDK\-1.2\-V, green threads, sunwjit)
.fl
.fi
-阪鴻若罔羣若吾с括垩障障
+出力ストリームには標準ドックレットのバージョン番号が含まれます。
.RE
.SS
-罔羣箴激с
-.LP
+標準ドックレットが提供するオプション
.RS 3
.TP 3
\-d\ directory
- HTML ＜ゃ篆絖ｃ絎障(d (destination))激с潟ャ＜ゃ憜ｃ篆絖障 \f2directory\fP 腟九障ｃ障憜篏罐ｃ後障ｃ絎с障若吾с 1.4 сjavadoc 絎茵ｃ篏障
-.LP
-違罨＜箴с\f2com.mypackage\fP 宴若吾ャ＜潟腟 \f2/home/user/doc/\fP ｃ篆絖障
+生成された HTML ファイルを保存する生成先ディレクトリを指定します(「d」は「生成先 (destination)」の意味)。このオプションを省略すると、生成されたファイルは現在のディレクトリに保存されます。値 \f2directory\fP には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。バージョン 1.4 では、javadoc を実行すると生成先ディレクトリが自動的に作成されます。
+.LP
+たとえば次の場合、パッケージ \f2com.mypackage\fP のドキュメントが生成され、その結果が \f2/home/user/doc/\fP ディレクトリに保存されます。
.nf
\f3
.fl
@@ -4627,50 +3129,50 @@
.LP
.TP 3
\-use
-ャ＜潟鴻潟宴若吾 1 ゃ [篏睡] 若吾腟粋昭帥障若吾劫鴻障宴若吾 API 篏帥ｃ宴若吾鴻＜純潟潟鴻帥潟ｃ若荐菴違障違 C 箴 C 篏帥ｃC 泣鴻C 絎ｈｃ若C 菴＜純潟 C ＜若帥ゃ＜純潟潟鴻帥障
-.LP
-違String [篏睡] 若吾篏茵腓冴荀帥障\f2java.awt.Font\fP 鴻 \f2getName()\fP ＜純\f2String\fP 菴障ｃ\f2getName()\fP \f2String\fP 篏帥ｃс\f2String\fP [篏睡] 若吾＜純障
-.LP
-ャ＜潟 API 篏睡сｃ絎茖ャ＜潟障＜純絎茖筝 \f2String\fP 篏帥ｃ綣違絖ｃ絖菴翫\f2String\fP 篏睡帥障
-.LP
- [篏睡] 若吾≪祉鴻鴻障宴若吾腱糸蚊若激с潟若 [篏睡] 潟障
+ドキュメント化されるクラスおよびパッケージごとに 1 つの「使用」ページを組み込みます。このページには、その特定のクラスまたはパッケージの API を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラス C を例にとると、クラス C を使っているものとしては、C のサブクラス、C として宣言されているフィールド、C を返すメソッド、および、型 C のパラメータを持つメソッドとコンストラクタがあります。
+.LP
+たとえば、String の [使用] ページに何が表示されるかを見てみましょう。java.awt.Font クラスの \f2getName()\fP メソッドは、 \f2String\fP 型の値を \f2返します\fP。したがって、 \f2getName()\fP は \f2String\fP を使用しているので、String の [使用] ページに \f2このメソッドが表示されます\fP。
+.LP
+ただし、ドキュメント化されるのは API の使用だけであって、実装はドキュメント化されません。あるメソッドが、その実装の中で \f2String\fP を使っていても、引数として文字列をとったり、文字列を返したりしない場合は、 \f2String\fP の「使用」とはみなされません。
+.LP
+生成された [使用] ページにアクセスするには、目的のクラスまたはパッケージに移動し、ナビゲーションバーの [使用] リンクをクリックします。
.TP 3
\-version
-ャ＜潟@version 鴻腟粋昭帥障鴻сャ障篏睡 Javadoc 若若吾с潟腆肴\f2\-J\-version\fP 激с潟篏睡障
+生成ドキュメントに、@version のテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している Javadoc ツールのバージョンを確認するには \f2\-J\-version\fP オプションを使用します。
.LP
.TP 3
\-author
-ャ＜潟@author 鴻腟粋昭帥障
+生成ドキュメントに、@author のテキストを組み込みます。
.LP
.TP 3
\-splitindex
-膣√＜ゃ≪＜茲違＜ゃ蚊絖 1 ゃ＜ゃ≪＜篁ュ絖у障膣√潟 1 ゃ＜ゃ篏障
+索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる索引エントリ用に 1 つのファイルを作成します。
.LP
.TP 3
\-windowtitle\ title
-HTML <title> 帥違臀帥ゃ絎障絎帥ゃｃ潟帥ゃ若吾絲障篏吟若 (羂ャ) 茵腓冴障帥ゃ HTML 帥違с 帥ゃ HTML 帥違障吟帥違罩ｃ頵ｉс障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障\-windowtitle ャ翫Javadoc 若激с潟篁ｃ \-doctitle ゃ篏帥障
+HTML の <title> タグに配置するタイトルを指定します。指定したタイトルは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク (お気に入り) に表示されます。このタイトルには HTML タグを含めないでください。タイトルに HTML タグが含まれていると、ブラウザがタグを正しく解釈できません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。\-windowtitle が省略されている場合、Javadoc ツールは、このオプションの代わりに \-doctitle の値を使います。
.nf
\f3
.fl
- % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
+ % \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
.fl
.fi
.TP 3
\-doctitle\ title
-网荀＜ゃ筝菴臀帥ゃ絎障帥ゃ筝紊 1 荀冴筝蚊若激с潟若筝臀障\f2title\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル 1 の見出しとして、上部ナビゲーションバーのすぐ下に置かれます。\f2title\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
.nf
\f3
.fl
- % \fP\f3javadoc \-doctitle "Java (TM)" com.mypackage\fP
+ % \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
.fl
.fi
.TP 3
\-title\ title
-\f3激с潟憜絖障\fPJavadoc 1.2 若睡絖障激с潟\f2\-doctitle\fP 紊眼障紊眼宴激с潟ｃ潟帥ゃсャ＜潟帥ゃ絎臂腆冴с
+\f3このオプションはもう存在していません。\fPこのオプションは Javadoc 1.2 のベータ版にしか存在していませんでした。このオプションの名前は \f2\-doctitle\fP に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。
.LP
.TP 3
\-header\ header
-阪＜ゃ筝腴臀若鴻絎障若筝蚊若激с潟若勀眼臀障\f2header\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2header\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの上端に配置するヘッダーテキストを指定します。ヘッダーは、上部ナビゲーションバーの右側に配置されます。\f2header\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2header\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
.nf
\f3
.fl
@@ -4680,73 +3182,77 @@
.LP
.TP 3
\-footer\ footer
-阪＜ゃ筝腴臀帥若鴻絎障帥若筝蚊若激с潟若勀眼臀障 \f2footer\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2footer\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの下端に配置するフッターテキストを指定します。フッターは、下部ナビゲーションバーの右側に配置されます。\f2footer\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2footer\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+.LP
+.TP 3
+\-top
+各出力ファイルの上端に配置するテキストを指定します。
.LP
.TP 3
\-bottom\ text
-阪＜ゃ筝臀鴻絎障鴻筝蚊若激с潟若筝若吾筝臀障\f2text\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2text\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
+各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーションバーより下の、ページの最下部に配置されます。 \f2text\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。引用符を \f2text\fP 内で使用する場合、引用符をエスケープしなければならない可能性があります。
.LP
.TP 3
\-link\ extdocURL
-javadoc √紊с鴻ャ＜潟若激с潟吾潟篏障綣違 1 ゃ障
+javadoc により生成された既存の外部参照クラスのドキュメンテーションへのリンクを作成します。引数を 1 つとります。
.LP
.RS 3
.TP 2
o
-\f4extdocURL\fP 潟絎javadoc ｃ紊ャ＜潟ｃ腟九 URL 障後 URL ст腓冴障ｃ宴若吾鴻＜ゃ絖違障 絖翫\f2\-linkoffline\fP 篏睡障Javadoc 若\f2宴若吾鴻\fP＜ゃ宴若後茯水宴若吾 URL 潟障Javadoc 若絎茵篏 \f2<A HREF>\fP 潟 \f2extdocURL\fP ゃ障障潟若障ｃ\f2extdocURL\fP ＜ゃ吾 URL сｃ吾 URLс違障
-.LP
-\f2extdocURL\fP 吾腟九障潟篏睡若吟若ャ＜潟篁紙 Web 泣ゃ筝ャ＜潟潟с障 後鞘臀吾潟с翫後障潟篏睡с障後障潟篏睡翫\f2\-d\fP 篏帥ｃｃ潟宴若吾ｃ後障鴻絎綽荀障
-.LP
-絽吾腟九障潟絎翫\f2http:\fP潟篏睡障Web 泣若若＜ゃ激鴻潟翫\f2file:\fP 潟篏睡с障号鴻若吟若＜ゃ激鴻掩ャ＜潟≪祉鴻綽荀翫篁ュ篏睡с
-.LP
-翫若ｃ潟違激鴻с腟九 URL 後 URL http:若鴻file:若鴻鴻激ャ阪絖篏睡障 (
+\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。あとで例を示します。このディレクトリ内にパッケージリストファイルが存在していなければなりません。 存在しない場合は、\f2\-linkoffline\fP を使用します。Javadoc ツールは、 \f2package\-list\fP ファイルからパッケージ名を読み取ったあと、その URL でそれらのパッケージにリンクします。Javadoc ツールの実行時に、\f2extdocURL\fP の値がそのまま、作成された \f2<A HREF>\fP リンク内にコピーされます。したがって、\f2extdocURL\fP はファイルへの URL ではなく「ディレクトリへの URL」でなければなりません。
+.LP
+\f2extdocURL\fP への絶対リンクを使用すると、ユーザーのドキュメントを任意の Web サイト上のドキュメントにリンクできます。相対位置へリンクするだけでよい場合は相対リンクを使用できます。相対リンクの場合、ユーザーが渡す値は、( \f2\-d\fP で指定された) 生成先ディレクトリから、リンク先となるパッケージを含むディレクトリへの相対パスにすべきです。
+.LP
+通常、絶対リンクを指定する場合は、 \f2http:\fP リンクを使用します。Web サーバーを持たないファイルシステムにリンクする場合は、 \f2file: リンクを使用できます。\fP ただし、この方法は、すべてのユーザーが生成された同じファイルシステムを共有するドキュメントにアクセスする必要がある場合以外は使用しないでください。
+.LP
+すべての場合、すべてのオペレーティングシステムで、絶対 URL と相対 URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します (
.na
\f2URL Memo\fP @
.fi
-http://www.ietf.org/rfc/rfc1738.txt ф絎)
+http://www.ietf.org/rfc/rfc1738.txt で指定)。
.RS 3
.TP 3
-http:若鴻腟九障潟:
+http: ベースの絶対リンク:
\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-file:若鴻腟九障潟:
+file: ベースの絶対リンク:
\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-後障潟:
+相対リンク:
\f2\-link <directory>/<directory>/.../<name>\fP
.RE
.RE
.LP
-javadoc 絎茵茲違 \f2\-link\fP 激с潟絎茲違ャ＜潟吾潟篏с障 \f3\-linkoffline 障 \-link 御\fP
+javadoc の 1 回の実行で複数の \f2\-link\fP オプションを指定すれば、複数のドキュメントへのリンクを作成できます。 \f3\-linkoffline または \-link の選択\fP
.br
-\f2\-link\fP 篏睡翫:
+\f2\-link\fPを使用する場合:
.RS 3
.TP 2
o
-紊 API ャ＜潟吾後障鴻篏睡翫
+外部 API ドキュメントへの相対パスを使用する場合
.TP 2
o
-紊 API ャ＜潟吾腟九 URL 篏睡翫 (違 URL ･膓茯水茵激сｃ荐怨翫)
+外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されている場合)
.RE
-罨＜翫\f2\-linkoffline\fP 激с潟篏睡障
+\f2\-linkoffline\fP を使用する場合:
.RS 3
.TP 2
o
-違 URL ･膓茯水茵激сｃ荐怨翫紊 API ャ＜潟吾腟九 URL 篏睡翫倶潟ャ＜潟＜ゃ≪若眼翫榊障
+外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されていない場合)このような状況は、リンク先のドキュメントがファイアウォールの向こう側にある場合に発生します。
.RE
.LP
-\f3紊ャ＜潟吾腟九障潟篏睡箴\fP \-
+\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2java.lang\fP、 \f2java.io\fP 、その他の Java プラットフォームパッケージ (
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
+\f2http://java.sun.com/javase/6/docs/api/\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api \f2java.lang\fP\f2java.io\fP篁 Java 2 若宴若吾潟翫障 罨＜潟潟\f2com.mypackage\fP 宴若吾ャ＜潟 Java 2 若宴若吾吾潟障ャ＜潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP \f2\-d\fP 篁激с潟茵腓冴障
+http://java.sun.com/javase/6/docs/api 内) にリンクする場合を考えます。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP や \f2\-d\fP など、その他のオプションは示していません。
.nf
\f3
.fl
- % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
+ % \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
.fl
.fi
-\f3紊ャ＜潟吾後障潟篏睡箴\fP \- 2 ゃ宴若吾ャ＜潟 Javadoc 若茲医絎茵腟с障 ャ＜潟後障鴻у蚊障箴翫2 ゃ宴若吾API с \f2com.apipackage\fP SPI (泣若鴻ゃゃ潟帥с若) с \f2com.spipackage\fP сャ＜潟主 \f2docs/api/com/apipackage\fP 宴若吾 \f2docs/spi/com/spipackage\fP 宴若吾сAPI 宴若吾ャ＜潟с憜ｃ \f2docs\fP с翫罨＜潟潟絎茵ｃ API ャ＜潟吾潟 SPI 宴若吾ャ＜潟障
+\f3外部ドキュメントへの相対リンクの使用例\fP \- 2 つのパッケージがあり、そのドキュメントが Javadoc ツールを複数回実行した結果生成されたものであるとします。さらに、これらのドキュメントが相対パスで分割されているとします。この例の場合、パッケージは、API である \f2com.apipackage\fP と、SPI (サービスプロバイダインタフェース) である \f2com.spipackage\fP です。ドキュメントの格納先は、 \f2docs/api/com/apipackage\fP と \f2docs/spi/com/spipackage\fP です。API パッケージのドキュメントはすでに生成済みで、 \f2docs\fP がカレントディレクトリになっていると仮定すると、API ドキュメントへのリンクを含む SPI パッケージをドキュメント化するには、次のコマンドを実行します。
.nf
\f3
.fl
@@ -4754,43 +3260,43 @@
.fl
.fi
.LP
-\f2\-link\fP 綣違ｃ (\f2docs/spi\fP) 後障鴻с
-.LP
-\f3荅括完\fP \- \f2\-link\fP 激с潟篏帥潟若сJavadoc 篁絎茵сャ＜潟鴻潟с障潟鴻若吾腱糸с HTML 若吾贋茯帥鴻贋 \f2extdocURL\fP 絎綽荀障激с潟篏帥違泣若若ｃ若ャ＜潟\f2http://java.sun.com\fP \f2java.*\fP ャ＜潟潟с障
-.LP
-篁絎茵 Javadoc ｃャ＜潟 API 絲乗院潟篏翫\f2\-link\fP 激с潟ャ障\f2\-link\fP 激с潟絎翫Javadoc 若紊сャ＜潟吾潟篏障ャ＜潟絖喝翫贋ゅャсс
-.LP
-激с潟сャ＜潟茲違贋潟篏с障
-.LP
-障激с潟篏帥茲違宴若悟召鴻潟篏с障ゃ障筝綣宴若吾絲障 javadoc 絎茵ャ筝綣宴若吾絲障 javadoc 絎茵 2 ゃ宴若悟召鴻潟篏с障
-.LP
-\f3鴻ф号\fP \- 紊с鴻吾潟鴻с鎘茵腓冴罨＜号с鴻с綽荀障＜純篏с鴻ссс障\f2import\fP 障絎ｈус綽荀障罨＜ \f2java.io.File\fP с号箴腓冴障
+\f2\-link\fP の引数は、生成先ディレクトリ (\f2docs/spi\fP) からの相対パスです。
+.LP
+\f3詳細\fP \- \f2\-link\fP オプションを使うと、「コードからは参照されていても、Javadoc の今回の実行ではドキュメント化されない」というクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらの HTML ページがある場所を調べ、その場所を \f2extdocURL\fP に指定する必要があります。これにより、たとえば、サードパーティーのドキュメントから \f2http://java.sun.com 上の java.*\fP のドキュメントへのリンクが \f2可能となります\fP。
+.LP
+今回の実行で Javadoc によって生成されるドキュメント内の API だけを対象に \f2リンクを作成する場合は、\fP \-link オプションを省略します。 \f2\-link\fP オプションが指定されていない場合、Javadoc ツールは、外部参照されたドキュメントへのリンクを作成しません。これは、そのドキュメントが存在するかどうか、および存在する場合はその場所を判別できないからです。
+.LP
+このオプションでは、生成ドキュメント内の複数の場所にリンクを作成できます。
+.LP
+もう 1 つの用途は、パッケージセット間でのクロスリンクです。一方のパッケージセットに対して javadoc を実行したあと、他方のパッケージセットに対して javadoc を再度実行することにより、両セット間で双方向のリンクを作成できます。
+.LP
+\f3クラスの参照方法\fP \- 外部参照クラスへのリンクを、テキストラベルだけではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するだけでは十分ではありません。それらのクラスは、 \f2import\fP 文、宣言のいずれの場所で参照されている必要があります。Here are examples of how the class \f2java.io.File\fP can be referenced:
.RS 3
.TP 2
o
-鴻腮蕁 \f2import\fP 翫: ゃ若ゃ潟若腓榊ゃ潟若障 \f2java.lang.*\fP 絲障ゃ潟若違罨＜医с
+すべての種類の \f2import\fP 文の場合: ワイルドカードによるインポート、名前による明示的なインポート、または \f2java.lang.* に対する自動的なインポート\fP。たとえば、次のようにすれば十分です。
.br
\f2import java.io.*;\fP
.br
-1.3.x 1.2.x с腓榊ゃ潟若сゃ若ゃ潟若ゃ潟若 \f2java.lang.*\fP 篏睡с障
+1.3.x および 1.2.x では、名前による明示的なインポートだけです。ワイルドカードによるインポート文も、 \f2java.lang.* の自動インポートも使用できません\fP。
.TP 2
o
-絎ｈ翫:
+宣言の場合:
.br
\f2void foo(File f) {}\fP
.br
-с篏睡＜純潟潟鴻帥ｃ若鴻障ゃ潟帥с若鴻祉ゃ障＜若帥臀\f2implements\fP\f2extends\fP障 \f2throws\fP 臀障
+この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースの戻り値の型またはパラメータの型に置くか、 \f2implements\fP、 \f2extends\fP 、または \f2throws\fP 文に置きます。
.RE
.LP
-腟\f2\-link\fP 激с潟篏睡狗茯ゃｃ茵腓冴紊潟紊亥榊醇с障鴻ゃ若鴻潟篁茵腓冴障潟茵腓冴茘潟茯茘с障鴻罩ｃсｃ潟菴遵ｃ絎号筝ц綵荅蚊鴻ゃ潟若с
-.LP
-\f3宴若吾鴻\fP \- \f2\-link\fP 激с潟\f2package\-list\fP ＜ゃ荀羆障 ＜ゃJavadoc 若ｃ\f2\-link\fP ｃ絎 URL 絖障\f2package\-list\fP ＜ゃ贋ャ＜潟宴若吾鴻ャｃ膣鴻＜ゃс箴сJavadoc 若絎 URL \f2package\-list\fP ＜ゃ｢宴若後茯粋昭с URL 宴若吾吾潟篏障
-.LP
-違Java 若 v5.0 API 宴若吾鴻
+重要な結果として、 \f2\-link\fP オプションの使用時に、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキストリンクが付けられずに表示されます。これらのリンクが表示する警告から、このリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するためのもっとも安全な方法は上で説明したとおり、当該のクラスをインポートすることです。
+.LP
+\f3パッケージリスト\fP \- \f2\-link\fP オプションが正しく機能するには、Javadoc ツールによって生成される \f2package\-list\fP という名前のファイルが、ユーザーが \f2\-link\fP に指定した URL に存在している必要があります。 \f2package\-list\fP ファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキストファイルです。前の例では、Javadoc ツールは、指定された URL で \f2package\-list\fP という名前のファイルを検索し、パッケージ名を読み込んだあと、その URL にあるそれらのパッケージへのリンクを作成しました。
+.LP
+たとえば、Java SE 6 API のパッケージリストは
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list 罨＜絎鴻у障ｃ障
+http://java.sun.com/javase/6/docs/api/package\-list にあり、次のような内容で始まっています。
.nf
\f3
.fl
@@ -4808,64 +3314,64 @@
.fl
java.awt.font
.fl
- 篁 ...
+ その他
.fl
\fP
.fi
.LP
-\f2\-link\fP 激с潟絎 javadoc 絎茵翫紊с鴻絮荀ゃjavadoc 潟綵≪у阪障筝鴻\f2\-link\fP 激с潟絎翫絎 \f2extdocURL\fP \f2package\-list\fP ＜ゃ荅峨宴若後罎膣≪障宴若後荀ゃ\f2extdocURL\fP 篁障
-.LP
-鴻潟罩ｃ閟純紊с鴻ャ＜潟絎 URL 絖違障Javadoc 若絎 package\-list 絖茯帥鴻с絎 URL 若吾絖с障
-.LP
-\f3茲違潟\fP \- 茲違 \f2\-link\fP 激с潟絎篁紙違紊ャ＜潟絲障潟荐絎с障Javadoc 1.2 茲違 \f2\-link\fP 激с潟絎с違障 1.2.2 т信罩ｃ障
-.LP
-潟紊ャ＜潟罨＜ャ潟激с潟絎障
-.LP
-\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2...\fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
-.LP
-\f2extdocURL1\fP\f2extdocURL2\fP... \f2extdocURLn\fP 紊ャ＜潟若若 \f2package\-list\fP ＜ゃャｃ障
-.LP
-\f3鴻潟\fP \- 障 2 や札筝ャ＜潟鴻潟翫若鴻綽荀障ゃ障ャ＜潟ゃ \f2package\-list\fP 絖翫ャ＜潟絲障 javadoc 若絎茵鴻с2 ャ＜潟 \f2package\-list\fP 障絖障ｃ紊潟篏2 ャ＜潟сャ＜潟眼綽荀障
-.LP
-翫ャ＜潟ャ＜潟 \f2package\-list\fP 篏с 宴若後鴻＜翫package\-list тс障罨＜2 ャ＜潟紊潟障綽荀紊 \f2package\-list\fP ＜ゃ絖翫Javadoc 若茘茵腓冴障
+\f2\-link\fP オプションを指定せずに javadoc を実行した場合、外部参照クラスに属する名前を見つけると、javadoc はその名前をリンクを持たない形で出力します。一方、 \f2\-link\fP オプションが指定された場合、Javadoc ツールは、 \f2指定された\fP \f2extdocURL\fP の場所にある package\-list ファイル内で、そのパッケージ名を検索します。パッケージ名が見つかると、\f2extdocURL\fP が名前の前に付加されます。
+.LP
+すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定した URL に存在していなければなりません。Javadoc ツールは、指定された package\-list が存在するかどうかを調べるだけで、指定された URL に目的のページが存在するかどうかはチェックしません。
+.LP
+\f3複数のリンク\fP \- 複数の \f2\-link\fP オプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1.2 には、複数の \f2\-link\fP コマンドを指定できないというバグがあります。これは 1.2.2 で修正されました。
+.LP
+リンクする外部ドキュメントごとに、次のように別々のリンクオプションを指定します。
+.LP
+\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2... \fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
+.LP
+\f2extdocURL1\fP、\f2extdocURL2\fP、... \f2extdocURLn\fP は、それぞれ外部ドキュメントのルートを指し、各ルートには、 \f2package\-list\fP という名前のファイルが入っています。
+.LP
+\f3クロスリンク\fP \- まだ生成されていない 2 つ以上のドキュメントをクロスリンクする場合は、「ブートストラップ」が必要になります。つまり、どのドキュメントについても \f2package\-list\fP が存在していない場合は、最初のドキュメントに対して Javadoc ツールを実行する時点で、2 番目のドキュメントの \f2package\-list\fP はまだ存在していません。したがって、外部リンクを作成するには、2 番目のドキュメントを生成したあとで、最初のドキュメントを生成し直す必要があります。
+.LP
+この場合、最初のドキュメント生成の目的は、 \f2package\-list\fP を作成することです。パッケージ名をすべて把握している場合は、package\-list を手動で作成してもかまいません。次に、2 番目のドキュメントとその外部リンクを生成します。必要な外部の \f2package\-list\fP ファイルが存在しない場合は、Javadoc ツールから警告が出力されます。
.LP
.TP 3
\-linkoffline\ extdocURL\ packagelistLoc
-激с潟\f2\-link\fP 激с潟紊с ＜javadoc ｃ紊с鴻ャ＜潟吾潟篏障Javadoc 若篏ゃ潟ｃ (Web ･膓篏帥ｃャ＜潟≪祉鴻с)Web 筝ャ＜潟潟\f2\-linkoffline\fP 激с潟篏睡障
-.LP
-ｳ絲紊ャ＜潟 \f2package\-list\fP ＜ゃ≪祉鴻с障＜ゃ \f2extdocURL\fP ф絎贋違贋 (絽吾\f2packageListLoc\fP ф絎純若贋) 絖\f2\-linkoffline\fP 篏睡障ｃ\f2extdocURL\fP WWW 筝с≪祉鴻с翫\f2\-linkoffline\fP 絎ャ＜潟 javadoc 若 Web ･膓с違句障
-.LP
-ャ＜潟贋違潟違篏睡純с宴若吾祉篏絲障 javadoc 絎茵紊眼筝宴若吾絲障 javadoc 絎茵障 贋違＜ゃ吾＜ゃ祉水ャс障箴хず障
-.LP
-\f2\-linkoffline\fP 激с潟綣違 2 ゅ障 綣違 \f2<a href>\fP 潟腟粋昭障絖絎綣違2 綣違 \f2package\-list\fP 罎膣√贋絎綣違с
+このオプションは \f2\-link\fP のバリエーションの 1 つです。どちらも、外部参照クラスの javadoc 生成ドキュメントへのリンクを作成します。Javadoc \f2ツール自体が\fP オフラインになっているとき (Web 接続を使ってドキュメントにアクセスできないとき)、Web 上のドキュメントにリンクするには、\-linkoffline オプションを使用します。
+.LP
+厳密には、 \f2外部\fP ドキュメントの \f2package\-list\fP ファイルにアクセスできないとき、またはこのファイルが \f2extdocURL\fP で指定された場所とは異なる場所 (通常、\f2packageListLoc\fP で指定可能なローカルな場所) に存在するとき、\-linkoffline を使用します。したがって、WWW 経由でしか \f2extdocURL\fP にアクセスできない場合、 \f2\-linkoffline\fP を指定することにより、ドキュメントの生成時に Javadoc ツールが Web に接続できなければならないという制約がなくなります。
+.LP
+さらに、ドキュメントを更新するための「ハッキング」としての使用も可能です。パッケージのセット全体に対して javadoc を実行したあと、変更した一部のパッケージだけに対して javadoc を実行します。こうして、更新されたファイルを、オリジナルのファイルセットに挿入できるようにします。例をあとで示します。
+.LP
+\f2\-linkoffline\fP オプションは引数を 2 つ取ります。1 つは、 \f2<a href>\fP リンクに組み込まれる文字列を表す引数、もう 1 つは \f2package\-list\fP の検索場所を示す引数です。
.RS 3
.TP 2
o
-\f4extdocURL\fP 潟絎javadoc ｃ紊ャ＜潟ｃ腟九 URL 障後 URL с後障潟篏睡翫\f2\-d\fP 篏帥ｃｃ潟宴若吾若後障鴻絎綽荀障荅括完\f2\-link\fP 激с潟 \f2extdocURL\fP с
+\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。相対リンクの場合、その値は、( \f2\-d\fP で指定された) 生成先ディレクトリからリンク先パッケージのルートへの相対パスにすべきです。詳細は、\-link オプションの \f2extdocURL\fP \f2を参照\fP してください。
.TP 2
o
-\f4packagelistLoc\fP 紊ャ＜潟 \f2package\-list\fP ＜ゃャｃｃ鴻障 URL 絎障URL (http: 障 file:)or file:)＜ゃ鴻＜с障障障腟九障鴻後障鴻＜с絎с障後障鴻翫javadoc 絎茵潟ｃ後障鴻絎障\f2package\-list\fP ＜ゃс
+\f4packagelistLoc\fP は、外部ドキュメントの \f2package\-list\fP ファイルを含むディレクトリへのパスまたは URL です。これは、URL (http: または file:) でもファイルパスでもかまいませんし、絶対パスでも相対パスでもかまいません。相対パスの場合は、javadoc が実行されるカレントディレクトリからの相対パスとして指定します。ファイル名 \f2package\-list\fP は含めないでください。
.RE
.LP
-javadoc 1 絎茵с茲違 \f2\-linkoffline\fP 激с潟絎с障1.2.2 茲違激с潟絎с障с
-.LP
-\f3紊ャ＜潟吾腟九障潟篏帥ｃ箴\fP \- \f2http://java.sun.com/j2se/1.5.0/docs/api\fP \f2java.lang\fP\f2java.io\fP潟篁 Java 2 若宴若吾潟Web ≪祉鴻с 翫ゃ帥障翫吟
+1 回の javadoc 実行で複数の \f2\-linkoffline\fP オプションを指定できます。1.2.2 より前は、複数のオプションを指定することはできませんでした。
+.LP
+\f3外部ドキュメントへの絶対リンクの使用例\fP \- http://java.sun.com/javase/6/docs/api 内の \f2java.lang\fP、 \f2java.io\fP 、およびその他の Java SE プラットフォームパッケージ \f2にリンクしたくても\fP Web にアクセスできない場合を考えます。ブラウザで \f2、\fP
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list \f2package\-list\fP ＜ゃ若ｃ篆絖障 2 綣 \f2packagelistLoc\fP 若潟若贋絎障箴с宴若吾鴻＜ゃ潟ｃ "\f2.\fP" 篆絖障罨＜潟潟Java 2 若 API 吾潟\f2com.mypackage\fP 宴若吾ャ＜潟障ャ＜潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP 篁綽荀激с潟茵腓冴障
+http://java.sun.com/javase/6/docs/api/package\-list にある package\-list ファイルを開き、それをローカルディレクトリに保存し、第 2 引数 \f2packagelistLoc\fP でこのローカルコピーへのパスを指定します。この例では、パッケージリストファイルはカレントディレクトリ "\f2.\fP" に保存されています。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP など、その他の必要オプションは示されていません。
.nf
\f3
.fl
-% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
+% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
.fl
.fi
.LP
-\f3紊ャ＜潟吾後障潟篏睡箴\fP \- 絽吾\f2\-linkoffline\fP 後障鴻絎障 \f2\-link\fP усс\f2\-linkoffline\fP 篏睡\f2package\-list\fP 絽吾若＜ゃ絎障 後障潟篏睡潟＜ゃ絽吾若＜ゃ絎障ｃ\f2\-linkoffline\fP 2 ゃ綣違ャ鴻絎綽荀障2 ゃ綣違筝с翫\f2\-link\fP 篏睡с障\f2\-link\fP 後障潟箴с
-.LP
-\f4package\-list\fP\f3 ＜ゃт\fP \- \f2package\-list\fP ＜ゃ障絖ャ＜潟潟宴若後ｃ翫＜ゃт\f2packagelistLoc\fP с鴻絎с障\f2com.apipackage\fP \f2com.spipackage\fP 宴若吾鴻絖冴箴с号宴若後ｃ障違紊ャ＜潟潟ャ＜潟綽荀翫箴水с障\f2package\-list\fP ＜ゃ Javadoc 1.0 1.1 х宴若後 \f2package\-list\fP ＜ゃ篏号障罕2 ゃ篌腓障 \f2package\-list\fP ＜ゃ掩с鴻潟荐絎ャ＜潟若鴻純с
-.LP
-\f3茲違ャ＜潟吾潟\fP \- \f2\-linkoffline\fP уャ＜潟 1 ゃゆ絎障 罨＜箴с激с潟茵障
+\f3外部ドキュメントへの相対リンクの使用例\fP \- \f2\-linkoffline\fP で相対パスを使用することは、あまりありません。理由は単純で、通常は \f2\-link\fP で十分だからです。 \f2\-linkoffline\fP を使用する際、 \f2package\-list\fP には通常ローカルのファイルを指定します。 相対リンクを使用する際も、リンク先のファイルには通常ローカルのファイルを指定します。したがって、 \f2\-linkoffline の 2 つの引数に別々のパスを指定する必要はありません\fP。2 つの引数が同一である場合は、 \f2\-link\fP を使用できます。 \f2\-link\fP の相対リンクの例を参照してください。
+.LP
+\f4package\-list\fP\f3 ファイルを手動で作成\fP \- \f2package\-list\fP ファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルを自分で作成し、packagelistLoc \f2でそのパスを指定することができます。\fPcom.apipackage が最初に生成される時点で \f2com.spipackage\fP のパッケージリストが存在していなかったという、 \f2前出のケースが\fP 一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、Javadoc 1.0 または 1.1 で生成されたパッケージの \f2package\-list\fP ファイルを作成する必要がある場合にも、この方法が使えます。これらのバージョンでは、 \f2package\-list\fP ファイルは生成されていませんでした。同様に、2 つの企業が未公開の \f2package\-list\fP ファイルを共有すれば、クロスリンクを含むドキュメントを同時にリリースすることも可能となります。
+.LP
+\f3複数のドキュメントへのリンク\fP \- 参照先となる生成ドキュメントごとに \f2\-linkoffline\fP を 1 回ずつ含めることができます。わかりやすくするために、オプションごとに改行して示しています。
.LP
\f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP
.br
@@ -4873,24 +3379,24 @@
.br
\f2\ \ \ \ \ \ \ \ \ \ ...\fP
.LP
-\f3ャ＜潟贋\fP \- 菴違 \f2\-linkoffline\fP 激с潟蚊ゃ吾с紊ч宴若吾障с弱篏絲障 javadoc 絎茵絎篋翫罨＜絎茵с絨紊眼純若鴻若鋇絲障 javadoc 絎茵翫箴水сャ＜潟若激с潟潟＜潟絲障紊眼絎ｈ紊眼翫炊ｃс潟違с純若鴻潟若絎ｈ菴遵ゃ障紊眼翫膣√宴若吾若膓帥＜潟若鴻[篏睡] 若吾贋с潟紕障
-.LP
-障篁絎茵т戎違ｃ (\f2update\fP) 篏障ｃ \f2html\fP 障ｃ膣箴с\f2html\fP ｃ荀ｃ腱糸 (cd) 障\f2\-linkoffline\fP 綣違潟ｃ "." 絎2 綣違 \f2html\fP 吾後障鴻絎障 с\f2package\-list\fP 罎膣≪障 贋医丞с宴若吾宴若後絎
+\f3ドキュメントの更新\fP \- 前述の \f2\-linkoffline\fP オプションのもうひとつの用途は、プロジェクトに大量のパッケージが含まれていて、すでにツリー全体に対して javadoc の実行が完了している場合に、次の実行では、少量の変更を手早く加えたあと、ソースツリーのごく一部に対してだけ javadoc を再実行する場合に便利です。これは、ドキュメンテーションコメントに対してだけ変更を加え、宣言は変更しない場合にのみ正しく処理されるので、ハッキングのようなものです。ソースコードの宣言を追加、削除、または変更した場合は、索引、パッケージツリー、継承されるメンバーのリスト、「使用」ページなどの場所で、リンクが壊れることがあります。
+.LP
+まず、この新しい小さな実行用として、新しい生成先ディレクトリ ( \f2update\fP と命名) を作成します。元の生成先ディレクトリの名前が \f2html\fP だったとします。もっとも単純な例では、 \f2html ディレクトリの親ディレクトリに移動 (cd) します\fP。 \f2\-linkoffline\fP の第 1 引数をカレントディレクトリ「.」に設定し、第 2 引数を、package\-list が含まれている \f2html\fP への相対パスに設定し、 \f2更新するパッケージのパッケージ名のみを\fP渡します。
.nf
\f3
.fl
% \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP
.fl
.fi
-Javadoc 若腟篋緇\f2update/com/package\fP 鴻若吾潟若 (网荀膣√ゃ)\f2html/com/package\fP ＜ゃ筝吾障
+Javadoc ツリーの終了後、 \f2update/com/package\fP 内の生成されたクラスのページをコピーし (概要や索引は除く)、 \f2html/com/package 内の元のファイルに上書きします\fP。
.LP
.TP 3
\-linksource\
-純若鴻＜ゃ (茵垬) HTML 若吾с潟篏罔羣 HTML ャ＜潟純若鴻＜ゃ吾潟菴遵障潟純若鴻＜ゃ絎ｈ鴻ゃ潟帥с若鴻潟潟鴻帥＜純ｃ若絲障篏障潟潟鴻帥鴻絲障篏障
-.LP
-\f3激с潟\fP\f4\-public\fP\f3\fP\f4\-package\fP\f3\fP\f4\-protected\fP\f3\fP\f4\-private\fP\f3 激с潟≫鴻ｃ若＜純篏腟粋昭障純若鴻＜ゃ鴻絎茖荅括完障\fP\f2\-private\fP 激с潟絎鴻ゃ潟帥с若鴻筝潟篁≪祉鴻с障
-.LP
-潟絎ｈ茘ュ筝篏障違\f2Button\fP 鴻純若鴻潟若潟Button茯筝篏障
+各ソースファイル (行番号付き) の HTML バージョンを作成し、標準 HTML ドキュメントからソースファイルへのリンクを追加します。リンクは、ソースファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルトコンストラクタ、生成されたクラスに対しては作成されません。
+.LP
+\f3このオプションは、\fP\f4\-public\fP\f3、 \fP\f4\-package\fP\f3、 \fP\f4\-protected\fP\f3 、 \fP\f4\-private\fP\f3 の各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソースファイル内のすべての非公開実装の詳細を公開します。\fP\f2\-private\fP オプションも併せて指定しないかぎり、非公開のすべてのクラスやインタフェースにリンク経由でアクセスできるとはかぎりません。
+.LP
+各リンクは、その宣言内の識別子名の上に作成されます。たとえば、 \f2Button\fP クラスのソースコードへのリンクは、「Button」という語の上に作成されます。
.nf
\f3
.fl
@@ -4902,7 +3408,7 @@
.fl
\fP
.fi
-Button 鴻 \f2getLabel()\fP ＜純純若鴻潟若吾潟getLabel茯筝篏障
+また、Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。
.nf
\f3
.fl
@@ -4913,26 +3419,21 @@
.LP
.TP 3
\-group\ groupheading\ packagepattern:packagepattern:...
-网荀若吾茲違宴若吾絎違若違若茵篏障違若ャ \f2\-group\fP 激с潟ф絎障違若潟潟茵ф絎綺с若吾茵腓冴障 違若с宴若吾≪＜筝鴻障絎 \f2\-group\fP 激с潟\f2packagepattern\fP 綣鴻筝眼宴若吾荀冴 \f2groupheading\fP 1 ゃ茵障茵腓冴障
+概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の \f2\-group\fP オプションで指定します。これらのグループは、コマンド行で指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。ある特定の \f2\-group\fP オプションでは、 \f2packagepattern\fP 式のリストに一致するパッケージが、 \f2groupheading\fP という見出しの表に表示されます。
.RS 3
.TP 2
o
-\f4groupheading\fP 篁紙鴻絎с腥榊純с障絎鴻違若茵荀冴障
+\f4groupheading\fP には、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。
.TP 2
o
-\f4packagepattern\fP 篁紙宴若後障篁紙宴若後膓 1 ゃ≪鴻帥鴻 (\f2*\fP) 絎с障≪鴻帥鴻篁紙絖筝眼潟ゃ若сゃ若絎с≪鴻帥鴻с1 ゃ違若潟 (\f2:\fP) у阪ｃ茲違帥若潟с障
+\f4packagepattern\fP には、任意のパッケージ名、または任意のパッケージ名の先頭部分とそれに続く 1 つのアスタリスク (\f2*\fP) を指定できます。 アスタリスクは、「任意の文字に一致する」という意味のワイルドカードです。ワイルドカードとして指定できるのは、アスタリスクだけです。1 つのグループには、コロン (\f2:\fP) で区切って複数のパターンを含めることができます。
.RE
-.RS 3
-
-.LP
-.LP
-\f3羈: 帥若潟帥若潟鴻с≪鴻帥鴻篏帥翫\fP\f4"java.lang*:java.util"\fP\f3 帥若潟鴻綣膃у蚊綽荀障\fP
-.LP
-.RE
-.LP
-\f2\-group\fP 激с潟絎翫鴻宴若吾宴若吾荀冴 1 ゃ違若ャ障ャ＜潟宴若吾筝絎違若違若ャ宴若吾翫宴若吾篁宴若吾荀冴ょ腴違若ャ障
-.LP
-違罨＜激с潟絎ャ＜潟 5 ゃ宴若吾潟≪宴若吾≦宍罘純宴若吾潟篁宴若吾障java.lang*с緇絎羈 java.lang.*ャjava.lang 宴若吾ゅ障
+.LP
+\f3注: パターンやパターンリスト内でアスタリスクを使う場合は、 \fP\f4"java.lang*:java.util" のように、パターンリストを引用符で囲む必要があります。\fP
+.LP
+ユーザーが \f2\-group\fP オプションを 1 つも指定しなかった場合、「パッケージ」という見出しの 1 つのグループ内に、すべてのパッケージが配置されます。ドキュメント化されるパッケージの中に、指定したグループのどのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。
+.LP
+たとえば、次のようにオプションを指定すると、ドキュメント化される 5 つのパッケージは、コアパッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.lang パッケージは除外されることになります。
.nf
\f3
.fl
@@ -4943,56 +3444,52 @@
java.lang java.lang.reflect java.util javax.servlet java.new\fP
.fl
.fi
-腟罨＜違若茵障
-.RS 3
+この結果、次のようなグループ化が行われます。
.RS 3
.TP 3
-潟≪宴若
+コアパッケージ
\f2java.lang\fP
\f2java.lang.reflect\fP
\f2java.util\fP
.TP 3
-≦宍罘純宴若
+拡張機能パッケージ
\f2javax.servlet\fP
.TP 3
-篁宴若
+その他のパッケージ
\f2java.new\fP
.RE
-
-.LP
-.RE
.LP
.TP 3
\-nodeprecated
-ｨ絅 API ャ＜潟障激с潟絎\-nodeprecatedlist 激с潟絎翫号ャ＜潟祉篏сｨ絅 API 障激с潟潟若荐菴違ｨ絅潟若ｃ羂ｃ翫箴水с
+推奨されない API をドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlist オプションを指定した場合と同じ効果があることに加えて、ドキュメントのほかの部分全体でも、推奨されない API が生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。
.LP
.TP 3
\-nodeprecatedlist
-ｨ絅 API 鴻＜ゃ (deprecated\-list.html)潟蚊若激с潟若若吾吾潟障ャ＜潟祉сｨ絅 API 障激с潟ｨ絅 API 純若鴻潟若障蚊若激с潟若ｃ荀翫箴水с
+推奨されない API のリストを含むファイル (deprecated\-list.html)、およびナビゲーションバーのそのページへのリンクが生成されないようにします。ただし、ドキュメントのほかの部分では、推奨されない API が生成されます。このオプションは、推奨されない API がソースコードに含まれておらず、ナビゲーションバーをすっきりと見せたい場合に便利です。
.LP
.TP 3
\-nosince
-ャ＜潟@since 帥違絲上絨ャ若吾с潟 祉激с潟ャ障
+生成ドキュメントから、@since タグに対応する「導入されたバージョン」 セクションを省略します。
.LP
.TP 3
\-notree
-ャ＜潟鴻潟ゃ潟帥с若鴻絮ゃ若吾ャ障若吾蚊若激с潟若若帥潟≪祉鴻с障с絮ゃ障
+生成されるドキュメントからクラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。
.LP
.TP 3
\-noindex
-ャ＜潟膣√ャ障с膣√障
+生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。
.LP
.TP 3
\-nohelp
-阪若吾筝筝蚊若激с潟若 [] 潟ャ障
+出力の各ページの最上部と最下部にあるナビゲーションバーから「ヘルプ」リンクを省略します。
.LP
.TP 3
\-nonavbar
-若吾筝筝茵腓冴蚊若激с潟若若潟帥若障激с潟bottom 激с潟綵演帥筝障\f2\-nonavbar\fP 激с潟医激＜ゃ PostScript 障 PDF 紊翫絎鴻荀с蚊若激с潟綽荀翫箴水с
+生成されるページの最上部と最下部に表示されるナビゲーションバー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottom オプションには影響を与えません。 \f2\-nonavbar\fP オプションは、印刷するためだけにファイルを PostScript または PDF に変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。
.LP
.TP 3
\-helpfile\ path/filename
-筝筝蚊若激с潟若 [] 潟潟篁ｆ帥＜ゃ \f2path/filename\fP 鴻絎障激с潟絎翫Javadoc 若若潟若＜ゃ \f2help\-doc.html\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP ＜ゃс絎с\f2help\-doc.html\fP 絎障箴腓冴障
+上部と下部のナビゲーションバーの「ヘルプ」リンクのリンク先となる代替ヘルプファイル \f2path/filename\fP のパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているヘルプファイル \f2help\-doc.html\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2help\-doc.html には限定されません。\fP Javadoc ツールは、ナビゲーションバー内のリンクを必要に応じて調整します。次に例を示します。
.nf
\f3
.fl
@@ -5001,7 +3498,7 @@
.fi
.TP 3
\-stylesheetfile\ path/filename
-篁ｆ HTML 鴻帥ゃ激若＜ゃ鴻絎障激с潟絎翫Javadoc 若若潟若鴻帥ゃ激若＜ゃ \f2stylesheet.css\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP ＜ゃс絎с\f2stylesheet.css\fP 絎障箴腓冴障
+代替 HTML スタイルシートファイルのパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているスタイルシートファイル \f2stylesheet.css\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2stylesheet.css には限定されません\fP。たとえば、
.nf
\f3
.fl
@@ -5010,22 +3507,22 @@
.fi
.TP 3
\-serialwarn
-@serial 帥違翫潟潟ゃ茘障сJavadoc 1.2.2 篁ラ若吾с潟с翫茘障1.2.2 若吾с潟с茘障激с潟篏睡翫茘茵腓冴с翫純ｃ若 \f2writeExternal\fP ＜純ャ＜潟綵合＜障
+@serial タグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 以降のバージョンでは、直列化の警告は生成されません1.2.2 より前の初期バージョンでは、警告が生成されます。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと \f2writeExternal\fP メソッドを適切にドキュメント化するのに役立ちます。
.LP
.TP 3
\-charset\ name
-ャ＜潟 HTML 絖祉絎障
+このドキュメント用の HTML 文字セットを指定します。この名前は、
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets тｨ絅 MIME с違障箴腓冴障
+http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。たとえば、
.nf
\f3
.fl
% \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
.fl
.fi
-鴻若吾罨＜茵水ャ障
+生成されるすべてのページの先頭に、次の行が挿入されます。
.nf
\f3
.fl
@@ -5033,34 +3530,34 @@
.fl
\fP
.fi
- META 帥違ゃ
+この META タグについては、
.na
-\f2HTML 罔羣\fP @
+\f2HTML の標準\fP @
.fi
-http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 4137321) с
-.LP
-\-encoding \-docencoding с
+http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 および 4137321) を参照してください。
+.LP
+\-encoding および \-docencoding も参照してください。
.LP
.TP 3
\-docencoding\ name
- HTML ＜ゃ潟潟若ｃ潟違絎障
+生成される HTML ファイルのエンコーディングを指定します。この名前は、
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets тｨ絅 MIME с違障激с潟ャ \-encoding 篏睡翫 HTML ＜ゃ潟潟若\-encoding ｃ羆冴障箴:
+http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。このオプションを省略しながら \-encoding を使用した場合、生成される HTML ファイルのエンコードは、\-encoding によって決められます。例:
.nf
\f3
.fl
% \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
.fl
.fi
-\-encoding \-charset с
+\-encoding および \-charset も参照してください。
.LP
.TP 3
\-keywords
-HTML ＜帥若若帥違鴻＜ゃ菴遵障帥違＜帥帥違罎膣≪泣若潟吾潟若吾荀ゃ翫綵合＜障ゃ潟帥若篏罎膣≪紊泣若潟吾潟若吾＜帥帥違茯ょ＜帥帥違茯帥鴻障 筝鴻罎膣≪荳 Web 泣ゃ絎篌罐с泣若潟吾潟＜帥帥違茯帥鴻ｃ＜緇障
-.LP
-＜帥帥違鴻絎篆蕋上ｃ若潟＜純篆蕋障障障潟潟鴻帥劫с障障違 String 罨＜若若ч紮障
+HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。
+.LP
+メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。
.nf
\f3
.fl
@@ -5077,29 +3574,29 @@
.LP
.TP 3
\-tag\ \ tagname:Xaoptcmf:"taghead"
-Javadoc 若ャ＜潟若激с潟潟＜潟綣違 1 ゅ膣鴻帥帥 \f2@\fP\f2tagname\fP 茹ｉс障Javadoc 若帥医鴻с茵сс純若鴻潟若鴻鴻帥帥違 \f2\-tag\fP 激с潟腟粋昭с障篁絎茵у阪帥違\f2X\fP 篁≦鴻障
-.LP
-潟 (\f4:\fP) 絽吾阪絖障\f2tagname\fP с潟潟篏睡帥医с潟潟篏睡с
-.LP
-\f2\-tag\fP 激с潟帥違荀冴taghead紊絖у阪障 罨＜茵激с潟綣違ф絎鴻膓障 篁ヤ箴с帥違罕綣違鴻ゃ潟ゃ潟帥違с障 ゃ潟ゃ潟帥違茹ｉ障阪綣違 1 ゅ罔羣帥 (\f2@return\fP\f2@author\fP ) 阪鋍若障\f2taghead\fP ャ\f2tagname\fP 荀冴茵腓冴障
-.LP
-\f3帥違臀\fP \- 綣違 \f4Xaoptcmf\fP 純若鴻潟若帥違臀с篏臀\f2X\fP 篏帥ｃ帥違≦鴻с劫障帥違臀篏臀狗翫 \f4a\fP 絎障 篁ュ絖腟水純с \f4X\fP (帥違≦劫)
+Javadoc ツールがドキュメンテーションコメント内の引数を 1 つ取る単純なカスタムブロックタグ \f2@\fP\f2tagname\fP を解釈できるようにします。Javadoc ツールはタグ名の「スペルチェック」を行うことができるので、ソースコード内に存在するすべてのカスタムタグについて、 \f2\-tag\fP オプションを含めることが重要です。今回の実行では出力されないタグは、X を付けて無効 \f2にします\fP。
+.LP
+コロン (\f4:\fP) が常に区切り文字になります。tagname \f2でコロンを使用する方法については、\fP 「タグ名でのコロンの使用」を参照してください。
+.LP
+\f2\-tag\fP オプションは、タグの見出し「taghead」を太字で出力します。 その次の行には、このオプションの引数で指定したテキストが続きます。 以下の例を参照してください。ブロックタグと同様、この引数のテキストにはインラインタグを含めることができます。このインラインタグも解釈されます。出力は、引数を 1 つ取る標準のタグ ( \f2@return\fP や \f2@author\fP など) の出力とよく似ています。\f2taghead\fP を省略すると、\f2tagname\fP が見出しとして表示されます。
+.LP
+\f3タグの配置\fP \- 引数の \f4Xaoptcmf\fP 部分は、ソースコード内のタグを配置できる位置と、 を使ってこのタグを無効にできるかどうかを特定します。 \f2X\fP). タグの配置位置を制限しない場合は \f4a\fP を指定します。それ以外の文字の組み合わせも可能です。 \f4X\fP (タグの無効化)
.br
-\f4a\fP (鴻篏臀)
+\f4a\fP (すべて)
.br
-\f4o\fP (网荀)
+\f4o\fP (概要)
.br
-\f4p\fP (宴若)
+\f4p\fP (パッケージ)
.br
-\f4t\fP (＜鴻潟ゃ潟帥с若)
+\f4t\fP (型、つまりクラスとインタフェース)
.br
-\f4c\fP (潟潟鴻)
+\f4c\fP (コンストラクタ)
.br
-\f4m\fP (＜純)
+\f4m\fP (メソッド)
.br
-\f4f\fP (ｃ若)
-.LP
-\f3激潟違帥違箴\fP \- 純若鴻潟若篁紙篏臀т戎ф帥違帥違激с潟箴腓冴障
+\f4f\fP (フィールド)
+.LP
+\f3シングルタグの例\fP \- ソースコード内の任意の位置で使用できるタグのタグオプションの例を示します。
.nf
\f3
.fl
@@ -5107,7 +3604,7 @@
.fl
\fP
.fi
-@todo 潟潟鴻帥＜純ｃ若帥т戎翫篁ヤ激с潟篏睡障
+@todo をコンストラクタ、メソッド、フィールドのみで使用する場合は、以下のオプションを使用します。
.nf
\f3
.fl
@@ -5115,7 +3612,7 @@
.fl
\fP
.fi
-筝箴緇潟 (\f2:\fP) ＜若水阪絖с荀冴鴻筝ｃ障 (篁ヤ箴)罨＜箴\f2@todo\fP 帥違純若鴻潟若с帥違激с潟篏睡障
+上の例の最後のコロン (\f2:\fP) は、パラメータ区切り子ですが、見出しテキストの一部になっています (以下の例を参照)。次の例のように、 \f2@todo\fP タグを含むソースコードでは、いずれかのタグオプションを使用します。
.nf
\f3
.fl
@@ -5123,7 +3620,7 @@
.fl
\fP
.fi
-\f3帥医潟潟篏睡\fP \- 潟 (:) 鴻激ャс鴻宴若潟潟帥医篏睡с障ャ＜潟若激с潟潟＜潟筝с罨＜篏睡障
+\f3タグ名にコロンを使用する\fP \- コロン (:) をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーションコメントの中では、次のように使用します。
.nf
\f3
.fl
@@ -5135,7 +3632,7 @@
.fl
\fP
.fi
-с帥違激с潟篏睡
+でこのタグオプションを使用すると、
.nf
\f3
.fl
@@ -5143,9 +3640,9 @@
.fl
\fP
.fi
-\f3帥医鴻с (帥違≦劫)\fP \- 純若鴻潟若臀筝鴻帥帥違阪吟翫障翫純若鴻潟若鴻帥違臀阪吟帥違鴻阪吟帥違≦鴻障帥違≦鴻\f2X\fP 絎障絎帥違鴻障 Javadoc 若罎冴帥違ュ鴻ャ帥違с劫с障ャ帥違罎冴翫Javadoc 若茘阪障
-.LP
-с臀ゃ \f2X\fP 菴遵с障 違\f2X\fP ゃс帥違鴻с障違@todo 帥違阪吟翫罨＜絎障
+\f3タグ名のスペルチェック (タグの無効化)\fP \- ソースコード内に配置した一部のカスタムタグの出力を抑制したい場合があります。この場合も、ソースコード内にすべてのタグを配置し、出力を抑制しないタグを有効にし、出力を抑制するタグを無効にします。 \f2X\fP が存在する場合はタグが無効になり、存在しない場合はタグが有効になります。これにより、Javadoc ツールは、検出したタグが入力ミスなどによる未知のタグであるかどうかを特定できます。未知のタグを検出した場合、Javadoc ツールは警告を出力します。
+.LP
+すでに配置されている値に \f2X\fP を追加できます。こうしておけば、 \f2X を削除するだけでタグを有効にすることができます\fP。たとえば、@todo タグの出力を抑制したい場合、次のように指定します。
.nf
\f3
.fl
@@ -5153,7 +3650,7 @@
.fl
\fP
.fi
-膣絎号障
+さらに単純な指定方法もあります。
.nf
\f3
.fl
@@ -5162,13 +3659,13 @@
\fP
.fi
.LP
-罕 \f2\-tag todo:X\fP \f2@todo\fP taglet у臂翫鴻с
-.LP
-\f3帥違綺\fP \- \f2\-tag\fP ( \f2\-taglet\fP) 激с潟綺ｃ阪綺羆阪障鴻帥帥違罔羣帥違腟水篏睡с障罔羣帥違帥違激с潟綺羆阪若鴻с罔羣帥医帥篏睡障(罔羣帥違絨頳冴紊眼с障)ゃ篁ヤ箴ц障
-.LP
-\f2\-tag\fP 翫\f2\-taglet\fP 篏臀ｃ綺羆阪障帥違筝≧鴻絖翫潟潟茵緇祉綺羆阪障帥違帥違潟潟茵絎с違\f2\-taglet\fP \f2\-tag\fP 筝≧鴻 todo ｃ翫潟潟茵緇祉綺羆阪障
-.LP
-\f3帥違絎祉箴\fP \- 箴с阪ParametersThrowsTo Do水ャ障X 篏睡@example 純若鴻潟若篁絎茵с阪帥違с絎障@argfile 篏睡翫罨＜綣違＜ゃャ茵帥違臀с障 茵膓膓腓冴絖筝荀с
+構文 \f2\-tag todo:X\fP は、 \f2@todo\fP がタグレットで定義されていても有効です。
+.LP
+\f3タグの順序\fP \- \f2\-tag\fP (および \f2\-taglet\fP) オプションの順序によって、タグの出力順が決まります。カスタムタグと標準タグを組み合わせて使用することもできます。標準タグのタグオプションは、順序を決定するためだけのプレースホルダです。これらは標準タグ名のみを使用します。(標準タグの小見出しは変更できません。)これについては、以下の例で説明します。
+.LP
+\f2\-tag\fP が存在しない場合は、 \f2\-taglet\fP の位置によってその順序が決まります。タグが両方とも存在する場合、コマンド行の最後にあるほうがその順序を決定します。これは、タグやタグレットがコマンド行に指定された順番に処理されるためです。たとえば、 \f2\-taglet\fP と \f2\-tag\fP の両方が todo という名前を持っている場合、コマンド行の最後にあるほうが順序を決定します。
+.LP
+\f3タグの完全セットの例\fP \- この例では、出力の「Parameters」と「Throws」の間に「To Do」を挿入します。X を使用して、@example が、ソースコード内の今回の実行では出力されないタグであることを指定します。@argfile を使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます。行の継続を示す文字は不要です。
.nf
\f3
.fl
@@ -5187,37 +3684,37 @@
\fP
.fi
.LP
-javadoc ャ＜潟若激с潟潟＜潟茹ｆ罎冴帥違＜罔羣帥違с \f2\-tag\fP \f2\-taglet\fP ф検帥違сャ帥違荀障 翫茘鴻若障
-.LP
-罔羣帥違綺с鴻主障\f2\-tag\fP 激с潟篏睡鴻菴遵帥違≧羣帥違篏臀篏臀腱糸障ゃ障罔羣帥違 \f2\-tag\fP 激с潟篁違篏臀臀障障障
-.LP
-\f3腴九\fP \- 堺腥咲蚊宴若吾篏睡 \f2com.mycompany.todo\fP (.) 阪遵荀篏睡障Sun 篁緇障罔羣帥違篏障若吟若篏帥違Sun 箴帥違篏若若ゃ障ゃ障若吟若 \f2@todo\fP 帥違障帥違篏翫Sun 罔羣帥違篏帥違障帥違篏篆障
-.LP
-\f3羈 vs. Javadoc 帥\fP \- 筝菴遵綽荀若≪ャ＜潟若激с潟綵演帥筝ャ＜潟若激с潟с翫若≪ javadoc 帥違鴻с 篁ュ翫羈鴻с
+javadoc がドキュメンテーションコメントを解析する際に検索されたタグのうち、標準タグでも、 \f2\-tag\fP や \f2\-taglet\fP で渡されたタグでもないものはすべて未知のタグとみなされ、警告がスローされます。
+.LP
+標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。 \f2\-tag\fP オプションを使用すると、このリストに追加されるタグ、すなわち標準タグの位置がデフォルトの位置から移動します。つまり、標準タグに \f2\-tag\fP オプションを付けなければ、これらはデフォルトの位置に配置されたままになります。
+.LP
+\f3競合の回避\fP \- 固有の名前空間を細かく分けるには、パッケージに使用されている \f2com.mycompany.todo という名前のように、ドット (.) を区切り記号とする名前を使います\fP。Oracle は、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracle が提供する同じ名前のタグの動作をオーバーライドします。つまり、 \f2@todo\fP という名前のタグまたはタグレットをユーザーが作成した場合、Oracle がその後同じ名前の標準タグを作成したとしても、その動作は常にユーザーが定義した動作と同じになります。
+.LP
+\f3注釈 vs. Javadoc タグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメンテーションに影響を与えたりドキュメンテーションを生成したりするためのものである場合、そのマークアップは javadoc タグにすべきです。それ以外の場合は注釈にすべきです。
.na
-\f2Comparing Annotations and Javadoc Tags\fP @
+\f2「Comparing Annotations and Javadoc Tags」\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsс
-.LP
-\-taglet 激с潟篏睡茲帥違鴻帥ゃ潟ゃ潟帥違 篏с障
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsを参照してください。
+.LP
+\-taglet オプションを使用して、より複雑なブロックタグやカスタムインラインタグを 作成することができます。
.LP
.TP 3
\-taglet\ \ class
-帥違ャ＜潟篏帥莎桁鴻＜ゃ絎障鴻絎絎絎帥違鴻帥帥違鴻綣違違絎臂障帥違綣違篁阪障紊ャ＜潟泣潟帥違ゃ篁ヤс
+そのタグのドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。クラスの完全指定名を指定してください。このタグレットは、カスタムタグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプルタグレットについては、以下を参照してください。
.RS 3
.TP 2
o
.na
-\f2帥違网荀\fP @
+\f2「タグレットの概要」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
.RE
.LP
-帥違罔羣帥違障ゃ潟ゃ潟帥違т梢с帥違篁紙違綣違с障 障鴻紊絖膊≧吾篏鴻＜ゃ吾冴篁祉鴻紮鴻帥篏絎茖с障
-.LP
-帥違ф絎с帥違臀贋臀綵√帥с篁鴻羆阪ｃ茵障帥違篏睡鴻鴻劫ゃ絎茵с障帥違鴻＜ゃ阪ャ祉鴻若篏緇障
-.LP
-帥違鴻絎\f2\-tagletpath\fP 激с潟篏睡障篁ヤ若吾ParameterThrowsTo Do帥違水ャ箴с
+タグレットは、ブロックタグまたはインラインタグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。
+.LP
+タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。
+.LP
+タグレットのパスを指定するには、\f2\-tagletpath\fP オプションを使用します。以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。
.nf
\f3
.fl
@@ -5238,25 +3735,25 @@
\fP
.fi
.LP
-\f2\-tag\fP 激с潟篁ｃ \f2\-taglet\fP 激с潟篏睡с障茯帥\f2\-tag\fP 激с潟篏睡祉с
+また、 \f2\-taglet\fP オプションを \f2\-tag\fP オプションの代わりに使用することもできますが、そうすると可読性が低下する可能性があります。
.LP
.TP 3
\-tagletpath\ \ tagletpathlist
-taglet 鴻＜ゃ (.class) 罎膣≪鴻絎障\f2tagletpathlist\fP 潟 (\f2:\fP) у阪ｃ茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣ｃ罎膣≪障
+taglet クラスファイル (.class) の検索パスを指定します。\f2tagletpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。
.LP
.TP 3
\-docfilessubdirs\
-\f2doc\-files\fP ｃ羞宴潟若鴻障ゃ障潟弱泣ｃ鴻潟潟潟潟若障違\f2doc\-files/example/images\fP ｃ筝＜ゃ潟若障с泣ｃゅ絎純с
+「\f2doc\-files\fP」ディレクトリの深いコピーを有効にします。つまり、コピー先には、サブディレクトリとすべてのコンテンツがコピーされます。たとえば、ディレクトリ \f2doc\-files/example/images\fP とそのすべての内容がコピーされます。ここでも、サブディレクトリを除外する指定が可能です。
.LP
.TP 3
\-excludedocfilessubdir\ \ name1:name2...
-絎 \f2doc\-files\fP 泣ｃゅ障SCCS 篁純若鴻潟若九勝泣ｃ潟若蚊障
+「\f2doc\-files\fP」の、指定された名前のサブディレクトリをすべて除外します。これにより、SCCS とその他のソースコード制御サブディレクトリのコピーを防ぎます。
.LP
.TP 3
\-noqualifier\ \ all\ | \ packagename1:packagename2:...
-阪劫宴若後 (宴若娯信蕋上) ャ障\f2\-noqualifier\fP 綣違 \f2all\fP 絎翫鴻宴若娯信蕋上鴻ャ障 ゃ茲違宴若後潟潟у阪ｃゃ若絎с障鴻障ゃ潟帥с若劫茵腓冴篏臀宴若後ゃ障
-.LP
-罨＜箴с鴻宴若娯信蕋上ャ障
+出力されるクラス名の先頭のパッケージ名 (パッケージ修飾子) を省略します。 \f2\-noqualifier\fP の引数は、「\f2all\fP」(すべてのパッケージ修飾子が省略される)、修飾子として削除すべきパッケージのコロン区切りリスト (ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。
+.LP
+次の例では、すべてのパッケージ修飾子を省略します。
.nf
\f3
.fl
@@ -5264,7 +3761,7 @@
.fl
\fP
.fi
-罨＜箴с宴若娯信蕋上 java.lang java.io ャ障
+次の例では、パッケージ修飾子 java.lang および java.io を省略します。
.nf
\f3
.fl
@@ -5272,7 +3769,7 @@
.fl
\fP
.fi
-罨＜箴сjava у障宴若娯信蕋上 com.sun 泣宴若 (javax с) ャ障
+次の例では、java で始まるパッケージ修飾子と com.sun というサブパッケージ (javax ではない) を省略します。
.nf
\f3
.fl
@@ -5280,63 +3777,54 @@
.fl
\fP
.fi
-宴若娯信蕋上筝荐篏緇ｃ茵腓冴翫障 荅括完茵腓堺号с荀\f2\-noqualifier\fP 篏睡鴻с
+パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、 \f2\-noqualifier\fP を使用するかどうかにかかわらず有効です。
.LP
.TP 3
\-notimestamp\
-帥ゃ鴻帥潟吟障 若後菴 HTML HTML 潟＜潟с帥ゃ鴻帥潟障Javadoc 2 ゃ純若鴻若鴻у茵絲障 diff 絎茵激с潟篏睡帥ゃ鴻帥潟ｃ diff 榊т梢с (激с潟篏睡若吾 diff 障)帥ゃ鴻帥潟 Javadoc 若吾с括垩障罨＜障
+タイムスタンプが抑制されます。各ページ先頭近くにある、生成された HTML 内の HTML コメントでタイムスタンプが隠されます。Javadoc を 2 つのソースベースで実行し、それらに対して diff を実行するときにこのオプションを使用すると、タイムスタンプによって diff が発生しなくなるので便利です (このオプションを使用しないと、各ページで diff になります)。タイムスタンプには Javadoc のバージョン番号が含まれており、次のようになります。
.nf
\f3
.fl
- <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
+ <!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
.fl
\fP
.fi
.LP
.TP 3
\-nocomment\
-筝肢潟鴻帥違潟＜潟篏吟絎ｈ障激с潟違ｃ純若鴻＜ゃ違吾с罧級с鴻宴 HTML ャ＜潟篏с障
+主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。このオプションにより、元は異なる目的のためだったソースファイルを再利用し、新しいプロジェクトの早い段階でスケルトン HTML ドキュメントを作成できるようになりました。
+.LP
+.TP 3
+\-sourcetab tabLength
+ソース内で各タブが獲得する空白の数を指定します。
.RE
-.SH "潟潟茵綣違＜ゃ"
-.LP
-.LP
-\f2javadoc\fP 潟潟茵膂≧\f2javadoc\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) ャｃ 1 や札筝＜ゃ絎с障違若ｃ潟違激鴻筝с篁紙激 javadoc 潟潟篏с障
-.LP
-.LP
-綣違＜ゃjavac 激с潟純若鴻＜ゃ宴腟水荐菴違с障＜ゃ綣違鴻若鴻障壕у阪障＜ゃ腥榊純障翫＜ゃ篏篋綣膃у蚊帥障
-.LP
-.LP
-綣違＜ゃ＜ゃ憜ｃ荀後障鴻障綣違＜ゃ篏臀荀後障鴻с障綣違＜ゃ＜ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違＜ゃ綣違 \f2@\fP 絖篏睡茲違＜ゃ絽亥茹ｉ泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝＜障莎桁若с綣違＜ゃ泣若с
-.LP
-.LP
-javadoc 絎茵綣違＜ゃ鴻＜ゃ \f2@\fP 絖篁羝＜障javadoc \f2@\fP 絖у障綣違荀ゃ＜ゃ絎鴻絮綣違鴻水ャ障
-.LP
+.SH "コマンド行引数ファイル"
+.LP
+javadoc のコマンド行を短くしたり簡潔にしたりするために、 \f2javadoc\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) が入った 1 つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティングシステム上でも、任意の長さの javadoc コマンドを作成できます。
+.LP
+引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
+.LP
+引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
+.LP
+javadoc を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javadoc は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
.SS
-綣違＜ゃ 1 ゆ絎箴
-.LP
-.LP
-\f2argfile\fP 綣違＜ゃ鴻 Javadoc 綣違主罨＜篏睡с障
-.LP
+引数ファイルを 1 つ指定する例
+.LP
+次のように、「\f2argfile\fP」という名前の単一の引数ファイル内に、Javadoc のすべての引数を格納します。
.nf
\f3
.fl
% \fP\f3javadoc @argfile\fP
.fl
.fi
-
-.LP
-.LP
-綣違＜ゃ罨＜箴хず 2 ゃ＜ゃ絎鴻筝≧鴻ャс障
-.LP
+.LP
+この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
.SS
-綣違＜ゃ 2 ゆ絎箴
-.LP
-.LP
-Javadoc 激с括 1 ゃ純若鴻＜ゃ 1 ゃ2 ゃ綣違＜ゃ篏罨＜篏睡с障鴻с茵膓膓絖篏睡障
-.LP
-.LP
-篁ヤ絎鴻 \f2options\fP ＜ゃ篏障
-.LP
+引数ファイルを 2 つ指定する例
+.LP
+2 つの引数ファイルを作成できます。1 つは Javadoc オプション用、もう 1 つはパッケージ名またはソースファイル名用です。なお、次のリストでは行継続文字を使用していません。
+.LP
+次の内容を含む、「\f2options\fP」という名前のファイルを作成します。
.nf
\f3
.fl
@@ -5346,27 +3834,24 @@
.fl
\-splitindex
.fl
- \-windowtitle 'Java 2 Platform v1.3 API Specification'
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification'
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
-.fl
- \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
+ \-windowtitle 'Java SE 7 API Specification'
+.fl
+ \-doctitle 'Java SE 7 API Specification'
+.fl
+ \-header '<b>Java(TM) SE 7</b>'
+.fl
+ \-bottom 'Copyright © 1993\-2011 Oracle and/or its affiliates. All rights reserved.'
.fl
\-group "Core Packages" "java.*"
.fl
- \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
-.fl
- \-sourcepath /java/pubs/ws/1.5/src/share/classes
+ \-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
+.fl
+ \-sourcepath /java/pubs/ws/1.7.0/src/share/classes
.fl
\fP
.fi
-
-.LP
-.LP
-篁ヤ絎鴻 \f2packages\fP ＜ゃ篏障
-.LP
+.LP
+次の内容を含む、「\f2packages\fP」という名前のファイルを作成します。
.nf
\f3
.fl
@@ -5378,115 +3863,89 @@
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜潟潟篏睡 javadoc 絎茵障
-.LP
+.LP
+そのあと、次のコマンドを使用して javadoc を実行します。
.nf
\f3
.fl
% \fP\f3javadoc @options @packages\fP
.fl
.fi
-
-.LP
.SS
-剛綣違＜ゃ箴
-.LP
-.LP
-綣違＜ゃ鴻絎с障 ＜ゃ絎＜ゃ憜篏罐ｃ荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
-.LP
+パス付きの引数ファイルの例
+.LP
+引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。
.nf
\f3
.fl
% \fP\f3javadoc @path1/options @path2/packages\fP
.fl
.fi
-
-.LP
.SS
-激с潟綣違箴
-.LP
-.LP
-罨＜Javadoc 激с潟絲障綣違綣違＜ゃ主箴腓冴障с\f2\-bottom\fP 箴筝障 激с潟激綣違絎с障激с潟鴻綣違罨＜絎鴻\f2bottom\fP ＜ゃ篏障
-.LP
+オプションの引数の例
+.LP
+次に、Javadoc オプションに対する引数だけを引数ファイルに格納する例を示します。ここでは \f2\-bottom\fP オプションを使用します。というのも、引数が長くなる可能性があるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。
.nf
\f3
.fl
-'<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a
-.fl
-bug or feature</a><br><br>Java is a trademark or registered trademark of
-.fl
-Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-2000 Sun
-.fl
-Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
-All Rights Reserved.</font>'
+<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>
.fl
\fP
.fi
-
-.LP
-.LP
-罨＜ Javadoc 若絎茵障
-.LP
+.LP
+そのあと、次のようにして Javadoc ツールを実行します。
.nf
\f3
.fl
% \fP\f3javadoc \-bottom @bottom @packages\fP
.fl
.fi
-
-.LP
-.LP
-障綣違＜ゃ \f2\-bottom\fP 激с潟腟粋昭с違罨＜絎茵с障
-.LP
+.LP
+あるいは、引数ファイルの先頭に \f2\-bottom\fP オプションも組み込んだあと、次のように実行してもかまいません。
.nf
\f3
.fl
% \fP\f3javadoc @bottom @packages\fP
.fl
.fi
-.SH ""
-絎茵
-.SH "Javadoc 絎茵"
-.LP
-.LP
-\f3若吾с括\fP \- javadoc 若吾с括垩ゅャ\f3javadoc \-J\-version\fP 篏睡障阪鴻若罔羣若吾с括垩障障\f2\-quiet\fP х≦鴻с障
-.LP
-.LP
-\f3違ゃ潟帥с若\fP \- Java 荐茯ц菴違違 Javadoc 若莎桁篏睡障ゃ潟帥с若鴻 \f2com.sun.tools.javadoc.Main\fP 障 (javadoc ュ)荅括完
-.na
-\f2罔羣\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyс
-.LP
-.LP
-\f3絎茵\fP \- 筝荐茯罔羣 HTML 若喝冴с鴻帥若喝冴\-doclet \-docletpath 激с潟篏睡障劫絎茵絎箴ゃ
+.SH "名前"
+実行
+.SH "Javadoc の実行"
+.LP
+\f3バージョン番号\fP \- javadoc のバージョン番号を判別するには、\f3javadoc \-J\-version\fP を使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。その出力を無効にするには、 \f2\-quiet\fP を使用します。
+.LP
+\f3公開プログラムインタフェース\fP \- Java 言語で記述されたプログラムから Javadoc ツールを起動するとき使用します。このインタフェースは \f2com.sun.tools.javadoc.Main にあります\fP (javadoc は再入可能)。詳細は、
.na
-\f2MIF Doclet ャ＜潟\fP @
+\f2「標準ドックレット」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。
+.LP
+\f3ドックレットの実行\fP \- 下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、
+.na
+\f2MIF Doclet のドキュメント\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
-.LP
-.SH "膂≦箴"
-.LP
-.LP
-javadoc 宴若後篏絲障絎茵純若鴻＜ゃ絲障絎茵с障宴若後宴若後絲上ｃ＜障罨＜箴с純若鴻＜ゃ \f2/home/src/java/awt/*.java\fP 障ｃ \f2/home/html\fP с
-.LP
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
+.SH "簡単な例"
+.LP
+javadoc は、パッケージ全体に対して実行することも、個々のソースファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソースファイルは \f2/home/src/java/awt/*.java にあります\fP。生成先ディレクトリは \f2/home/html です\fP。
.SS
-1 や札筝宴若吾ャ＜潟
-.LP
-.LP
-宴若吾ャ＜潟宴若吾純若鴻＜ゃ (\f2*.java\fP) 宴若吾ゃｃ絖違障宴若後茲違茘ュф (\f2java.awt.color\fP 茘ュу阪) 翫緇膓茘ュ筝篏泣ｃ絲上違障 (\f2java/awt/color\fP )1 ゃ宴若吾茲違純若鴻＜ゃ違贋 2 ゃｃ若主純с (\f2src1/java/awt/color\fP \f2src2/java/awt/color\fP ) 翫\f2\-sourcepath\fP ｃ筝≧鴻贋絎違障
-.LP
-.LP
-javadoc 絎茵\f2cd\fP 潟潟篏帥ｃｃ紊眼障 \f2\-sourcepath\fP 激с潟篏睡障篁ヤ箴с筝≧鴻号ゃ茯障
-.LP
+1 つ以上のパッケージのドキュメント化
+.LP
+あるパッケージをドキュメント化するには、そのパッケージのソースファイル (\f2*.java\fP) を、そのパッケージと同じ名前のディレクトリ内に格納する必要があります。パッケージ名が ( \f2java.awt.color\fP のようにドットで区切られた) いくつかの識別子から構成されている場合、右側の識別子に進むたびに、その識別子がより深いサブディレクトリに対応している必要があります ( \f2java/awt/color\fP など)。 単一パッケージのソースファイルを 2 グループに分け、異なる場所にあるそのような 2 つのディレクトリツリー内にそれぞれ格納してもかまいません。ただし、その両方のディレクトリへのパスを、 \f2\-sourcepath\fP に設定する必要があります。例: \f2src1/java/awt/color\fP および \f2src2/java/awt/color\fP。
+.LP
+javadoc を実行するには、 \f2cd\fP を使用してディレクトリを変更するか、 \f2\-sourcepath\fP オプションを使用します。以下の例では、両方の方法について説明します。
.RS 3
.TP 2
o
-\f3宴若 1 \- 1 や札筝宴若吾莎桁絽亥絎茵\fP \- 箴с javadoc 篁紙ｃ絎茵с\-sourcepath 篏睡絽亥 \-subpackages (1.4 違激с) 篏睡障\f2java\fP 泣宴若 (\f2java.net\fP \f2java.lang\fP 若宴若吾ゃ) 障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
+\f3ケース 1 \- 1 つ以上のパッケージからの起動を再帰的に実行\fP \- この例では javadoc が任意のディレクトリから実行できるように、\-sourcepath を使用し、再帰的処理のために \-subpackages (1.4 の新オプション) を使用します。これは、 \f2java\fP ディレクトリのサブパッケージをたどりますが、その際に、 \f2java.net\fP と \f2java.lang\fP をルートに持つパッケージは除外されます。このとき、 \f2java.lang のサブパッケージ\fPである java.lang.ref も \f2除外されます\fP。
.nf
\f3
.fl
@@ -5494,10 +3953,10 @@
.fl
.fi
.LP
-篁宴若吾若綏≦\f2java:javax:org.xml.sax\fP \f2\-subpackages\fP 綣違菴遵障
+ほかのパッケージツリーも下方にたどるには、 \f2java:javax:org.xml.sax のように、\fP それらのパッケージの名前を \-subpackages \f2の引数の末尾に追加します\fP。
.TP 2
o
-\f3宴若 2 \- 若純若鴻ｃ腱祉ｃ腓榊宴若吾絲障絎茵\fP \- 絎絎宴若後荀ｃ腱祉障罨＜ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障
+\f3ケース 2 \- ルートソースディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全指定のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5508,7 +3967,7 @@
.fi
.TP 2
o
-\f3宴若 3 \- 篁紙ｃ絎茵 純若鴻＜ゃ 1 ゃｃ弱\fP \- 宴若鴻с憜ｃсｃ障障筝篏宴若吾荀ｃ \f2\-sourcepath\fP 絎ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障
+\f3ケース 3 \- 任意のディレクトリから実行。ソースファイルは 1 つのディレクトリツリー内にある\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。最上位パッケージの親ディレクトリを \f2\-sourcepath\fP に指定し、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5517,7 +3976,7 @@
.fi
.TP 2
o
-\f3宴若 4 \- 篁紙ｃ絎茵 純若鴻＜ゃ茲違ｃ弱\fP \- 宴若 3 篌若障宴若吾茲違ｃ若絖障若若吾鴻 \f2\-sourcepath\fP 絎 (潟潟у阪)ャ＜潟 1 や札筝宴若後絎 javadoc 絎茵障1 ゃ宴若吾鴻純若鴻＜ゃ1 ゃ若ｃ筝絖違障 純若鴻鴻絎贋цゃ医с
+\f3ケース 4 \- 任意のディレクトリから実行。ソースファイルは複数のディレクトリツリー内にある\fP \- これはケース 3 と似ていますが、パッケージが複数のディレクトリツリーに存在します。それぞれのツリーのルートへのパスを \f2\-sourcepath\fP に指定し (コロンで区切る)、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。1 つのパッケージのすべてのソースファイルが、1 つのルートディレクトリの下に存在しなければならない、ということはありません。ソースパスとして指定された場所のどこかで見つかれば十分です。
.nf
\f3
.fl
@@ -5525,21 +3984,16 @@
.fl
.fi
.RE
-
-.LP
-.LP
-腟: 筝荐宴若鴻с\f2java.awt\fP \f2java.awt.event\fP 宴若後 public protected 鴻ゃ潟帥с若鴻ゃHTML 綵√ャ＜潟絎ｃ (\f2/home/html\fP) HTML ＜ゃ篆絖障2 や札筝宴若吾сャ＜潟宴若吾鴻鴻鴻潟＜ゃ潟鴻若吾 3 ゃ若ゃ障
-.LP
+.LP
+結果: すべてのケースでパッケージ \f2java.awt\fP および \f2java.awt.event\fP 内の public および protected クラスとインタフェースについて、HTML 形式のドキュメントが生成され、指定された生成先ディレクトリ (\f2/home/html\fP) に HTML ファイルが保存されます。2 つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラスページという 3 つのフレームを持つことになります。
.SS
-1 や札筝鴻ャ＜潟
-.LP
-.LP
-障1 や札筝純若鴻＜ゃ (\f2.java\fP) 羝＜Javadoc 若絎茵с障javadoc 罨＜ 2 ゃ＜号у茵с障 1 ゃ\f2cd\fP 潟潟сｃ紊眼号 1 ゃ \f2.java\fP ＜ゃ吾鴻絎絎号с後障鴻憜ｃ莎欠鴻障純若鴻＜ゃ羝＜\f2\-sourcepath\fP 激с潟∴障≪鴻帥鴻 (*) 潟潟茵ゃ若篏睡鴻違若絎с障
-.LP
+1 つ以上のクラスのドキュメント化
+.LP
+また、1 つ以上のソースファイル (\f2.java\fP) を渡して、Javadoc ツールを実行することもできます。javadoc は、次の 2 つの方法のいずれかで実行できます。1 つは \f2cd\fP を使用してディレクトリを変更する方法、もう 1 つは \f2.java\fP ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソースファイル名を渡すときは、 \f2\-sourcepath\fP オプションは無視されます。アスタリスク (*) のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。
.RS 3
.TP 2
o
-\f3宴若 1 \- 純若鴻ｃ腱祉\fP \- \f2.java\fP ＜ゃｃ腱祉障罨＜ャ＜潟 1 や札筝純若鴻＜ゃ絎 javadoc 絎茵障
+\f3ケース 1 \- ソースディレクトリに移る\fP \- \f2.java\fP ファイルのあるディレクトリに移ります。次に、ドキュメント化する 1 つ以上のソースファイルの名前を指定して javadoc を実行します。
.nf
\f3
.fl
@@ -5548,10 +4002,10 @@
% \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP
.fl
.fi
-箴с \f2Button\fP \f2Canvas\fP喝 \f2Graphics\fP у障鴻ゃHTML 綵√ャ＜潟障宴若後с純若鴻＜ゃ javadoc 綣違羝＜сャ＜潟鴻鴻＜ゃ潟若吾 2 ゃ若ゃ障
+この例では、クラス \f2Button\fP と \f2Canvas\fP 、および名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。パッケージ名ではなくソースファイルが javadoc に引数として渡されているので、ドキュメントは、クラスのリストとメインページという 2 つのフレームを持つことになります。
.TP 2
o
-\f3宴若 2 \- 宴若吾若ｃ腱祉\fP \- 若茲違泣宴若吾純若鴻＜ゃャ＜潟翫箴水с宴若吾若ｃ腱祉純若鴻＜ゃ若鴻絎障
+\f3ケース 2 \- パッケージのルートディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソースファイルをドキュメント化する場合に便利です。パッケージのルートディレクトリに移り、各ソースファイルを、ルートからのパスとともに指定します。
.nf
\f3
.fl
@@ -5560,103 +4014,88 @@
% \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP
.fl
.fi
-箴с\f2Button\fP 鴻 \f2Applet\fP 鴻ゃHTML 綵√ャ＜潟障
+この例では、クラス \f2Button\fP および \f2Applet について、HTML 形式のドキュメントが生成されます\fP。
.TP 2
o
-\f3宴若 3 \- 篁紙ｃ\fP \- 宴若鴻с憜ｃсｃ障障ャ＜潟 \f2.java\fP ＜ゃ吾腟九障 (障憜ｃ後障) 絎 javadoc 絎茵障
+\f3ケース 3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する .java ファイルへの絶対パス (またはカレントディレクトリからの相対パス) を指定して \f2javadoc\fP を実行します。
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java\fP
.fl
.fi
-箴с \f2Button\fP \f2Graphics\fP у障鴻ゃHTML 綵√ャ＜潟障
+この例では、クラス \f2Button\fP と、名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。
.RE
-
-.LP
.SS
-宴若吾鴻ャ＜潟
-.LP
-.LP
-宴若後篏鴻絎ャ＜潟с障罨＜菴違 2 ゃ箴腟水箴腓冴障\f2\-sourcepath\fP 宴若吾吾鴻絲障篏睡с障鴻鴻絲障篏睡с障
-.LP
+パッケージとクラスのドキュメント化
+.LP
+パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に前述の 2 つの例を組み合わせた例を示します。 \f2\-sourcepath\fP は、パッケージへのパスに対しては使用できますが、個々のクラスのパスに対しては使用できません。
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java\fP
.fl
.fi
-
-.LP
-.LP
-箴с宴若 \f2java.awt\fP \f2Applet\fP ゃHTML 綵√ャ＜潟障Javadoc 若\f2Applet\fP 宴若後\f2Applet.java\fP 純若鴻＜ゃ宴若後ｈ (絎ｈ翫) ゅャ障
-.LP
-.SH "篏睡箴"
-.LP
-.LP
-Javadoc 若紊箴水激с潟筝祉激с潟紫篏帥障х換篁Java 若 API 絲障 Javadoc 若絎茵篏睡絎潟潟сJava 2 Platform, Standard Edition, v1.2 絖膣 1500 public protected 鴻ゃャ＜潟180M ゃ＜≪若篏睡障
-.LP
-.LP
-箴 2 ｲ莠障 箴潟潟茵絎茵с2 箴 Makefile 絎茵с激с潟綣違腟九障鴻篏睡篁紙ｃ \f2javadoc\fP 潟潟絎茵с障
-.LP
+.LP
+この例では、パッケージ \f2java.awt\fP とクラス \f2Applet について、HTML 形式のドキュメントが生成されます\fP。Javadoc ツールは、 \f2Applet.java ソースファイル内にパッケージ宣言があれば、\fP その宣言に基づいて \f2Applet のパッケージ名を\fP 判定します。
+.SH "使用例"
+.LP
+Javadoc ツールには多くの便利なオプションがあり、その中にはほかのオプションよりも頻繁に使われるものがあります。ここで紹介するのは、Java プラットフォーム API に対して Javadoc ツールを実行するときに使用する実際のコマンドです。ここでは、Java SE Platform, Standard Edition, v1.2 の (約) 1500 個の public および protected クラスのドキュメントを生成するために、180M バイトのメモリーを使用します。
+.LP
+同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。オプションの引数で絶対パスが使用されているため、同じ \f2javadoc\fP コマンドをどのディレクトリからでも実行できます。
.SS
-潟潟茵箴
-.LP
-.LP
-罨＜潟潟茵箴 900 絖莇DOS 激с紊с障狗帥潟潟茵綣違＜ゃ篏睡障 障激с鴻荐菴違障
-.LP
+コマンド行の例
+.LP
+次の例は、DOS などの一部のシェルでは長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェルスクリプトを記述します。
.nf
\f3
.fl
-% javadoc \-sourcepath /java/jdk/src/share/classes \\
-.fl
- \-overview /java/jdk/src/share/classes/overview.html \\
-.fl
- \-d /java/jdk/build/api \\
-.fl
- \-use \\
-.fl
- \-splitIndex \\
-.fl
- \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification' \\
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
-.fl
- \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
-a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
-.fl
-Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
-.fl
-901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
+% javadoc \-sourcepath /java/jdk/src/share/classes \\
+.fl
+ \-overview /java/jdk/src/share/classes/overview.html \\
+.fl
+ \-d /java/jdk/build/api \\
+.fl
+ \-use \\
+.fl
+ \-splitIndex \\
+.fl
+ \-windowtitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-doctitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-header '<b>Java(TM) SE 7</b>' \\
+.fl
+ \-bottom '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>' \\
.fl
\-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
.fl
- \-group "Extension Packages" "javax.*" \\
-.fl
- \-J\-Xmx180m \\
+ \-group "Extension Packages" "javax.*" \\
+.fl
+ \-J\-Xmx180m \\
.fl
@packages
.fl
\fP
.fi
-
-.LP
-.LP
-筝荐潟潟с\f2packages\fP 絲乗院宴若後 (\f2java.applet java.lang\fP ) ャｃ＜ゃс激с潟筝綣膃у蚊障綣違眼壕絖水ャс障違箴潟種若鴻翫\f2\-bottom\fP 激с潟壕絖ゃ羈с
-.LP
+.LP
+上記のコマンドで、 \f2packages\fP は、処理対象のパッケージ名 ( \f2java.applet java.lang\fP など) が入っているファイルの名前です。各オプションの、単一引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー＆ペーストする場合は、 \f2\-bottom\fP オプションから改行文字を削除してください。さらに、このあとの「注」も参照してください。
.SS
-Makefile 箴
-.LP
-.LP
-сGNU Makefile 箴腓冴障Windows Makefile 箴ゃ
+Makefile の例
+.LP
+ここでは、GNU Makefile の例を示します。Windows の Makefile の例については、
.na
-\f2Windows Makefile 篏号\fP @
+\f2Windows の Makefile の作成方法\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#makefilesс
-.LP
+http://java.sun.com/j2se/javadoc/faq/index.html#makefilesを参照してください。
.nf
\f3
.fl
@@ -5692,101 +4131,83 @@
.fl
.fl
-WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
-.fl
-DOCTITLE = 'Java(TM) 2 Platform v1.2 API Specification'
-.fl
-HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
-.fl
-BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
- a bug or feature</a><br><br>Java is a trademark or registered trademark
-.fl
- of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
-.fl
- Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
- All Rights Reserved.</font>'
+WINDOWTITLE = 'Java(TM) SE 7 API Specification'
+.fl
+DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
+.fl
+HEADER = '<b>Java(TM) SE 7</font>'
+.fl
+BOTTOM = '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>'
.fl
GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
.fl
GROUPEXT = '"Extension Packages" "javax.*"'
.fl
-SRCDIR = '/java/jdk/1.2/src/share/classes'
+SRCDIR = '/java/jdk/1.7.0/src/share/classes'
.fl
\fP
.fi
-
-.LP
-.LP
-Makefile 綣違筝綣膃у蚊帥障
-.LP
-.LP
-\f3羈\fP
-.LP
+.LP
+Makefile の引数は、単一引用符で囲みます。
+.LP
+\f3注\fP
.RS 3
.TP 2
o
-\f2\-windowtitle\fP 激с潟ャJavadoc 若ｃャ＜潟帥ゃｃ潟帥ゃ潟若障\f2\-windowtitle\fP 鴻堺 \f2\-doctitle\fP с HTML 帥違篏睡障 HTML 帥違ｃ潟帥ゃ障障鴻茵腓冴障障
+\-windowtitle \f2オプションを省略すると、\fP Javadoc ツールによってドキュメントタイトルがウィンドウタイトルにコピーされます。 \f2\-windowtitle\fP のテキストは基本的に \f2\-doctitle\fP のものと同じですが、HTML タグを含まない点が異なります。これは、HTML タグが raw テキストとしてウィンドウタイトル内に表示されるのを防ぐためです。
.TP 2
o
-箴 \f2\-footer\fP 激с潟ャJavadoc 若ｃ若鴻帥若潟若障
+ここで行っているように \f2\-footer\fP オプションを省略すると、Javadoc ツールによってヘッダーのテキストがフッターにコピーされます。
.TP 2
o
-箴с綽荀障\-\f2classpath\fP \-\f2link\fP 荀激с潟с
+この例では必要ありませんが、\-\f2classpath\fP と \-\f2link\fP も重要なオプションです。
.RE
-
-.LP
-.SH "激ャ若ｃ潟"
-.LP
+.SH "トラブルシューティング"
.SS
-筝激ャ若ｃ潟
-.LP
+一般的なトラブルシューティング
.RS 3
.TP 2
o
-\f3Javadoc FAQ\fP \- 筝違潟激ャ若ｃ潟違潟
+\f3Javadoc FAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、
.na
-\f2Javadoc FAQ\fP @
+\f2「Javadoc FAQ」\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#B усс障
+http://java.sun.com/j2se/javadoc/faq/index.html#B で参照できます。
.TP 2
o
-\f3違喝狗篋\fP \- 違筝Important Bug Fixes and Changes ссс障
+\f3バグおよび制限事項\fP \- バグの一部は、「Important Bug Fixes and Changes」 でも参照できます。
.TP 2
o
-\f3若吾с括\fP \- 若吾с括垩с
+\f3バージョン番号\fP \- 「バージョン番号」を参照してください。
.TP 2
o
-\f3鴻鴻ャ＜潟\fP \- 宴若吾ャ＜潟Javadoc 鴻劫ф＜ゃ帥茯粋昭帥障違＜ゃゃ潟\-сjavadoc ＜ゃ茹ｆ蚊с障
+\f3有効なクラスだけをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadoc は、有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、javadoc によるファイルの解析を防ぐことができます。
.RE
-
-.LP
.SS
-若茘
-.LP
-.LP
-若活＜祉若吾＜ゃ絎ｈ茵 (ャ＜潟若激с潟潟＜潟劫茵с) 茵垩障障
-.LP
+エラーと警告
+.LP
+エラーおよび警告メッセージには、ファイル名と宣言行 (ドキュメンテーションコメント内の特定の行ではない) の行番号が含まれます。
.RS 3
.TP 2
o
-\f2"error:cannot read:Class1.java"\fP Javadoc 若潟ｃ Class1.java 鴻若障腟九障鴻障後障鴻茵腓冴劫箴翫 \f2./Class1.java\fP с
+\f2"error: cannot read: Class1.java"\fP Javadoc ツールはカレントディレクトリに Class1.java クラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合 \f2./Class1.java と同じです\fP。
.RE
-
-.LP
-.SH "医"
-.LP
+.SH "環境"
.RS 3
.TP 3
CLASSPATH
-Javadoc 若吟若鴻＜ゃ｢篏帥鴻絎医紊違с医紊違\f2\-classpath\fP 激с潟ｃ若若ゃ障ｃ罨＜潟潟у阪障
+Javadoc がユーザークラスのファイルを探すときに使うパスを指定する環境変数です。この環境変数は、 \f2\-classpath\fP オプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。
.:/home/classes:/usr/local/java/classes
.RE
-
-.LP
-.SH "∫ｉ"
-.LP
+.SH "関連項目"
.RS 3
.TP 2
o
@@ -5806,7 +4227,7 @@
.TP 2
o
.na
-\f2Javadoc 若若\fP @
+\f2Javadoc のホームページ\fP @
.fi
http://java.sun.com/j2se/javadoc/index.jsp
.TP 2
@@ -5818,16 +4239,14 @@
.TP 2
o
.na
-\f2鴻鴻荐絎\fP @
+\f2クラスパスの設定\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
.TP 2
o
.na
-\f2javac javadoc 鴻罎膣≪号\fP @
+\f2javac と javadoc がクラスを検索する方法\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
.RE
-
-.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/javah.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/javah.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,82 +19,67 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javah 1 "02 Jun 2010"
+.TH javah 1 "14 Apr 2011"
.LP
-.SH ""
-javah \- C 若鴻帥＜ゃ吾с若
-.LP
-.RS 3
-
+.SH "名前"
+javah \- C ヘッダーとスタブファイルジェネレータ
.LP
.LP
-\f3javah\fP Java 鴻 C 若＜ゃ C 純若鴻＜ゃ篏障＜ゃJava 違潟域茯ф吾潟若C 篁荐茯ф吾潟若･膓潟若娯篏障
+\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
.fl
javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
.fl
-javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
-.fl
\fP
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javah\fP ゃｃ＜純絎茖綽荀 C 若純若鴻＜ゃ障篏若純若鴻＜ゃゃｃ純若鴻潟若吾сゃ潟鴻帥潟劫違с C 違ｃ篏睡障.h ＜ゃ絲上鴻筝眼臀ゆ篏絎臂帥障罕篏ｃ若鴻ゃ潟鴻帥潟劫違絲上障
-.LP
-.LP
-若＜ゃ筝уｈ罕篏鴻羇丞障\f3javah\fP 羝＜鴻宴若吾筝翫宴若後若＜ゃ罕篏筝≧鴻篁障筝膩 (_) 阪絖篏睡障
+\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。
.LP
.LP
-с \f3javah\fP 潟潟茵鴻鴻若＜ゃ篏憜ｃ＜ゃ臀障純若鴻＜ゃ篏\f2\-stubs\fP 激с潟篏睡1 ゃ＜ゃ筝鴻鴻鴻腟ｇ\f2\-o\fP 激с潟篏睡
-.LP
-.LP
-違ゃｃ＜純ゃ潟帥с若鴻с Java Native Interface (JNI) 惹宴障鴻帥＜ゃ綽荀障 憜с\f3javah\fP JNI 綵√ゃｃ＜純綽荀ゃｃ＜純罘純帥ゃ障 с\f3javah\fP JNI 綵√у阪腟 .h ＜ゃ主障
+ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。
.LP
.LP
-\f3javah_g\fP jdb(1) \f3javah\fP 若吾с潟с
+デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。
+.LP
.LP
-.SH "激с"
+新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-o outputfile
-潟潟茵鴻鴻鴻絲障腟若障純若鴻＜ゃｇ \f2outputfile\fP 主障\f3\-o\fP 障 \f3\-d\fP ＜筝鴻篏帥障
+コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して \f2outputfile\fP に格納します。\f3\-o\fP または \f3\-d\fP のどちらか一方だけが使われます。
.TP 3
\-d directory
-\f3javah\fP 若＜ゃ障鴻帥＜ゃ篆絖ｃ荐絎障\f3\-d\fP 障 \f3\-o\fP ＜筝鴻篏帥障
+\f3javah\fP がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。\f3\-d\fP または \f3\-o\fP のどちらか一方だけが使われます。
.TP 3
\-stubs
-\f3javah\fP Java 吾с＜ゃ C 絎ｈ障
+\f3javah\fP が、Java オブジェクトファイルから C 宣言を生成します。
.TP 3
\-verbose
-荅括完阪絎篏＜ゃ倶≪＜祉若吾\f3javah\fP 罔羣阪阪障
+詳細出力を指定し、作成ファイルの状態に関するメッセージを、\f3javah\fP が標準出力に出力します。
.TP 3
\-help
-\f3javah\fP 篏睡羈ゃ＜祉若吾阪障
+\f3javah\fP の使用法についてのヘルプメッセージを出力します。
.TP 3
\-version
-\f3javah\fP 若吾с恰宴阪障
+\f3javah\fP のバージョン情報を出力します。
.TP 3
\-jni
-JNI 綵√ゃｃ＜ゃ罘純帥ゃ阪＜ゃ\f3javah\fP 篏障罔羣阪с\f3\-jni\fP 篏睡激с潟с
+JNI 形式のネイティブファイル機能プロトタイプを含む出力ファイルを、\f3javah\fP が作成します。これは標準出力であるため、\f3\-jni\fP の使用はオプションです。
.TP 3
\-classpath path
-鴻｢ \f3javah\fP 篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
+クラスを探すために \f3javah\fP が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -102,7 +87,7 @@
.fl
\fP
.fi
-箴腓冴障
+次に例を示します。
.nf
\f3
.fl
@@ -111,33 +96,31 @@
\fP
.fi
.LP
-箴水筝\f2*\fP 若劫鴻壕膣ｃ≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻＜ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
+便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
-違ｃ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR ＜ゃ絎障鴻＜ゃ絎ｃ鴻 JAR ＜ゃ障障\f2*\fP 鴻鴻潟潟ｃ鴻 JAR ＜ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障ｃ\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
+たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。 \f2*\fP だけから成るクラスパスエントリは、現在のディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.TP 3
\-bootclasspath path
-若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR ＜ゃ 潟 Java 2 若絎茖鴻с
+ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-old
-ゃ JDK1.0 綵√若＜ゃ絎障
+古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
.TP 3
\-force
-阪＜ゃ絽吾吾莨若障絎障
+出力ファイルが常に書き込まれるように指定します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割されています。
.nf
\f3
.fl
@@ -148,11 +131,9 @@
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1)java(1)jdb(1)javap(1)javadoc(1)
+javac(1)、java(1)、jdb(1)、javap(1)、javadoc(1)
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/javap.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/javap.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javap 1 "02 Jun 2010"
+.TH javap 1 "14 Apr 2011"
.LP
-.SH ""
-javap \- Java 鴻＜ゃ≪祉潟
-.LP
-.RS 3
-
+.SH "名前"
+javap \- Java クラスファイル逆アセンブラ
.LP
.LP
-鴻＜ゃ≪祉潟障
+クラスファイルを逆アセンブルします。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,15 +39,10 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3javap\fP 潟潟鴻＜ゃ≪祉潟障阪絎激с潟違障激с潟絎翫\f3javap\fP 宴若吾羝＜鴻 protected public ｃ若＜純阪障 \f3javap\fP 阪罔羣阪茵腓冴障違罨＜劫ｈ潟潟ゃ障
-.LP
-.RS 3
-
+\f3javap\fP コマンドは、クラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。たとえば、次のクラス宣言をコンパイルするとします。
.LP
.nf
\f3
@@ -96,14 +85,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3javap DocFooter\fP 阪罨＜障
-.LP
-.RS 3
-
+\f3javap DocFooter\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
@@ -126,14 +111,10 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3javap \-c DocFooter\fP 阪罨＜障
-.LP
-.RS 3
-
+\f3javap \-c DocFooter\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
@@ -244,41 +225,35 @@
.fl
\fP
.fi
-.RE
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-\-help
-\f3javap\fP ＜祉若吾阪障
+\-help \-\-help \-?
+\f3javap\fP のヘルプメッセージを出力します。
+.TP 3
+\-version
+バージョン情報を表示します。
.TP 3
\-l
-茵垩絮紊違若茵腓冴障
-.TP 3
-\-b
-JDK 1.1 \f3javap\fP 筝篏篋с篆荐若障
+行番号と局所変数テーブルを表示します。
.TP 3
\-public
-public 鴻潟＜潟若茵腓冴障
+public クラスおよびメンバーだけを表示します。
.TP 3
\-protected
-protected public 鴻＜潟若茵腓冴障
+protected および public のクラスとメンバーだけを表示します。
.TP 3
\-package
-packageprotected public 鴻＜潟若茵腓冴障荐絎с
+package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。
.TP 3
-\-private
-鴻鴻＜潟若茵腓冴障
+\-private \-p
+すべてのクラスとメンバーを表示します。
.TP 3
\-Jflag
-潟帥ゃ激鴻贋･ \f2flag\fP 羝＜障篏睡箴罨＜腓冴障
-.RS 3
-
-.LP
+ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
.nf
\f3
.fl
@@ -288,23 +263,28 @@
.fl
\fP
.fi
-.RE
.TP 3
\-s
-激違ｃ若阪障
+内部の型シグニチャーを出力します。
+.TP 3
+\-sysinfo
+処理中のクラスのシステム情報 (パス、サイズ、日付、MD5 ハッシュ) を表示します。
+.TP 3
+\-constants
+static final 定数を表示します。
.TP 3
\-c
-鴻＜純≪祉潟潟若 Java ゃ潟若巡擦茵腓冴障
+クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
.na
-\f2Java Virtual Machine Specification\fP @
+\f2「Java Virtual Machine Specification」\fP @
.fi
-http://java.sun.com/docs/books/vmspec/ャ＜潟障
+http://java.sun.com/docs/books/vmspec/にドキュメント化されています。
.TP 3
\-verbose
-＜純鴻帥泣ゃ冴 \f2locals\fP \f2args\fP 違阪障
+メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
.TP 3
\-classpath path
-\f3javap\fP 鴻｢篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
+\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -312,7 +292,7 @@
.fl
\fP
.fi
-箴腓冴障
+次に例を示します。
.nf
\f3
.fl
@@ -322,24 +302,19 @@
.fi
.TP 3
\-bootclasspath path
-若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR ＜ゃ 潟 Java 2 若絎茖鴻с
+ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-extdirs dirs
-ゃ潟鴻若≦宍罘純罎膣≪贋若若ゃ障The default location for extensions is the value of \f2java.ext.dirs\fP.
+インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障 罨＜箴腓冴障
-.RS 3
-
-.LP
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.nf
\f3
.fl
@@ -348,14 +323,11 @@
\fP
.fi
.RE
-.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1) java(1)jdb(1)javah(1)javadoc(1)
+javac(1)、java(1)、jdb(1)、javah(1)、javadoc(1)
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/javaws.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/javaws.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,30 +19,18 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javaws 1 "02 Jun 2010"
+.TH javaws 1 "14 Apr 2011"
.LP
-.SH ""
-\f2javaws\fP 潟潟茵
+.SH "名前"
+\f2javaws\fP コマンド行
+.LP
+.SH "名前"
.LP
.LP
-\
-.LP
-.SS
-NAME
-.LP
-.RS 3
-
-.LP
+\f2javaws\fP \- Java Web Start 起動コマンド
.LP
-\f2javaws\fP \- Java Web Start 莎桁潟潟
-.LP
-.RE
-.SS
-綵√
-.LP
-.RS 3
-
+.SH "形式"
.LP
.LP
\f2javaws [run\-options] <jnlp>\fP
@@ -50,309 +38,185 @@
.LP
\f2javaws [control\-options]\fP
.LP
-.RE
-.SS
-＜若
-.LP
-.RS 3
-
+.SH "パラメータ"
.LP
.LP
\f2[run\-options]\fP
.LP
-.RS 3
-
-.LP
.LP
-潟潟茵絎茵激с潟 絎茵激с潟篁紙綺ф絎с障腮激с潟ゃ筝 絎茵激с潟с
+コマンド行実行オプション。実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。
.LP
-.RE
.LP
\f2<jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-JNLP (Java Network Launching Protocol) ＜ゃ鴻障 URL (Uniform Resource Locator) ＜с
+JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。
.LP
-.RE
.LP
\f2[control\-options]\fP
.LP
-.RS 3
-
-.LP
-.LP
-潟潟茵九勝激с潟 九勝激с潟篁紙綺ф絎с障腮激с潟ゃ筝 九勝激с潟с
.LP
-.RE
-.RE
-.SS
-茯
+コマンド行制御オプション。制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。
.LP
-.RS 3
-
+.SH "説明"
.LP
.LP
-\f2javaws\fP 潟潟JNLP (Java Network Launching Protocol) ＜潟劫茖с Java Web Start 莎桁障Java Web Start 若筝у篏 Java ≪宴若激с潟障≪莎桁障
-.LP
-.LP
-JNLP ＜ゃ絎\f2javaws\fP JNLP ＜ゃ絎 Java ≪宴若激с潟障≪莎桁障
+\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。
.LP
.LP
-\f2javaws\fP 莎桁若憜若鴻с泣若 1 腟激с潟障激с潟絨ャ若鴻сゃ醇с障
+JNLP ファイルが指定された場合、 \f2javaws\fP は、その JNLP ファイルで指定された Java アプリケーション/アプレットを起動します。
+.LP
.LP
-.RE
-.SS
-絎茵激с
+\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
.LP
-.RS 3
-
+.SH "実行オプション"
.LP
.LP
\f2\-offline\fP
.LP
-.RS 3
-
-.LP
.LP
-Java Web Start ゃ潟≪若у茵障
+Java Web Start をオフラインモードで実行します。
.LP
-.RE
.LP
\f2\-Xnosplash\fP
.LP
-.RS 3
-
-.LP
.LP
-鴻激ョ脂≪茵腓冴≦鴻障
+最初のスプラッシュ画面の表示を無効にします。
.LP
-.RE
.LP
\f2\-open <arguments>\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎JNLP ＜ゃ綣違 \f2\-open <arguments>\fP 臀障
+このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。
.LP
-.RE
.LP
\f2\-print <arguments>\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎JNLP ＜ゃ綣違 \f2\-print <arguments>\fP 臀障
+このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。
.LP
-.RE
.LP
\f2\-online\fP
.LP
-.RS 3
-
-.LP
.LP
-潟ゃ潟≪若у茵障 (篏)
+オンラインモードで実行します (デフォルトの動作)。
.LP
-.RE
.LP
\f2\-wait\fP
.LP
-.RS 3
-
-.LP
.LP
-激с潟絎≪宴若激с潟腟篋障 \f2javaws\fP 祉鴻腟篋障
+このオプションを指定した場合、 \f2javaws\fP プロセスは、アプリケーションが終了するまで終了しません。Windows プラットフォーム上では、このオプションは説明したとおりに機能しません。
.LP
-.RE
.LP
\f2\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-菴遵阪茵腓冴障
+追加の出力を表示します。
.LP
-.RE
.LP
\f2\-J<option>\fP
.LP
-.RS 3
-
-.LP
.LP
-vm 激с潟茖障
+vm にオプションを補います。
.LP
-.RE
.LP
\f2\-system\fP
.LP
-.RS 3
-
-.LP
-.LP
-≪宴若激с潟激鴻ｃ激ャ水茵障
.LP
-.RE
-.RE
-.SS
-九勝激с
+アプリケーションをシステムキャッシュからのみ実行します。
.LP
-.RS 3
-
+.SH "制御オプション"
.LP
.LP
\f2\-viewer\fP
.LP
-.RS 3
-
+.LP
+Java コントロールパネルでキャッシュビューアを表示します。
.LP
.LP
-Java 潟潟若сｃ激ャャ若≪茵腓冴障
+\f2\-clearcache\fP
+.LP
.LP
-.RE
+インストールされていないすべてのアプリケーションをキャッシュから削除します。
+.LP
.LP
\f2\-userConfig <property name>\fP
.LP
-.RS 3
-
-.LP
.LP
-絎ｃ若≪障
+指定された配備プロパティーをクリアします。
.LP
-.RE
.LP
\f2\-userConfig <property name> <property value>\fP
.LP
-.RS 3
-
-.LP
.LP
-絎ｃ若絎ゃ荐絎障
+指定された配備プロパティーを指定された値に設定します。
.LP
-.RE
.LP
\f2\-uninstall\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ鴻≪宴若激с潟ゃ障
+キャッシュからすべてのアプリケーションを削除します。
.LP
-.RE
.LP
\f2\-uninstall <jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ≪宴若激с潟ゃ障
+キャッシュからアプリケーションを削除します。
.LP
-.RE
.LP
\f2\-import [import\-options] <jnlp>\fP
.LP
-.RS 3
-
-.LP
.LP
-ｃ激ャ≪宴若激с潟ゃ潟若障
+キャッシュにアプリケーションをインポートします。
.LP
-.RE
-\f3ゃ潟若激с\fP
+.SH "インポートオプション"
.LP
.LP
\f2\-silent\fP
.LP
-.RS 3
-
-.LP
.LP
-泣ゃ潟≪若сゃ潟若障 (UI 茵腓冴障)
+サイレントモードでインポートします (UI は表示されません)。
.LP
-.RE
.LP
\f2\-system\fP
.LP
-.RS 3
-
-.LP
.LP
-激鴻ｃ激ャ≪宴若激с潟ゃ潟若障
+システムキャッシュにアプリケーションをインポートします。
.LP
-.RE
.LP
\f2\-codebase <url>\fP
.LP
-.RS 3
-
-.LP
.LP
-篁紙 codebase 純若鴻緇障
+任意の codebase からリソースを取得します。
.LP
-.RE
.LP
\f2\-shortcut\fP
.LP
-.RS 3
-
-.LP
.LP
-若吟取┗絎鴻潟激с若ゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
+ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。
.LP
-.RE
.LP
\f2\-association\fP
.LP
-.RS 3
-
-.LP
-.LP
-若吟取┗絎鴻潟∫ｄゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
.LP
-.RE
-.RE
-.SS
-＜ゃ
+ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。
.LP
-.RS 3
-
+.SH "ファイル"
.LP
.LP
-若吟若ｃ激ャ激鴻ｃ激ャ deployment.properties ＜ゃゃ
+ユーザーキャッシュ、システムキャッシュ、および deployment.properties ファイルについては、
.na
-\f2激鴻潟若吟若ｃ\fP @
+\f2システムレベルおよびユーザーレベルのプロパティー\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。
.LP
-.RE
-.SS
-荅括完
-.LP
-.RS 3
-
+.SH "詳細情報"
.LP
.LP
-Java Web Start 荅括完
+Java Web Start の詳細は、
.na
-\f2Java Web Start\fP @
+\f2「Java Web Start」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。
.LP
-.RS 3
-
-.LP
-.LP
-\
-.LP
-.RE
-.RE
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jconsole.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jconsole.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jconsole 1 "02 Jun 2010"
+.TH jconsole 1 "14 Apr 2011"
.LP
-.SH ""
-jconsole \- Java ｈ括∞潟潟純若
+.SH "名前"
+jconsole \- Java 監視および管理コンソール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -58,63 +56,60 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
-.br
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
connection = pid | host:port | jmxUrl
.RS 3
-\f2pid\fP\ \ \ 若 Java VM 祉 IDJava VM jconsole 絎茵若吟 ID 若吟 ID 篏睡絎茵綽荀障荅括完ゃ
+.TP 2
+o
+\f2pid\fPローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、
.na
-\f2JMX ｈ括∞\fP @
+\f2「JMX 監視および管理」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
-.br
-\f2host\fP:\f2port\fP\ \ Java VM 絎茵鴻激鴻JVM 莎桁激鴻ｃ \f2com.sun.management.jmxremote.port\fP ф絎若垩荅括完ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
+.TP 2
+o
+\f2host\fP:\f2port\fP Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、
.na
-\f2JMX ｈ括∞\fP @
+\f2「JMX 監視および管理」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
-.br
-\f2jmxUrl\fP ･膓 JMX 若吾с潟≪鴻 ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
+.TP 2
+o
+\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。これについては、
.na
\f2JMXServiceURL\fP @
.fi
-http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html с
+http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。
.RE
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jconsole\fP 潟潟若激潟障≪若激割 Java ≪宴若激с潟篁潟激潟ｈ膊∞茵違ｃ潟潟純若若莎桁障
+\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。
.LP
.LP
-Windows 筝с\f3jconsole\fP 潟潟純若ｃ潟∫ｄ障宴 \f3jconsole\fP 潟潟紊掩惹宴腓冴ゃ≪違鴻茵腓冴障
+Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-interval=n
-贋育 \f2n\fP 腱荐絎障 ( 4 腱)
+更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。
.TP 3
-\-notile\
-ｃ潟帥ゃ潟違障 (茲違･膓)
+\-notile
+最初にウィンドウをタイリングしません (複数の接続のため)。
.TP 3
-\-pluginpath\ plugins
-JConsole 違ゃ潟罎膣√ｃ障 JAR ＜ゃ鴻絎障\f2plugins\fP 鴻罨＜ゃ罕＜ゃ
+\-pluginpath plugins
+JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
.br
.nf
\f3
@@ -124,36 +119,36 @@
\fP
.fi
.LP
-
+これには、
.na
\f2com.sun.tools.jconsole.JConsolePlugin\fP @
.fi
-http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html 鴻絎茖鴻絎篆蕋障劫絎茵違ゃ潟 1 茵ゅ障障
+http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
.TP 3
-\-version\
-若吾с恰宴阪腟篋障
+\-version
+バージョン情報を出力して終了します。
.TP 3
-\-help\
-＜祉若吾阪腟篋障
+\-help
+ヘルプメッセージを出力して終了します。
.TP 3
-\-J<flag>\
-jconsole 絎茵 Java 篁潟激潟 <flag> 羝＜障
+\-J<flag>
+jconsole が実行されている Java 仮想マシンに <flag> を渡します。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2jconsole 篏睡\fP @
+\f2JConsole の使用\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
.TP 2
o
.na
-\f2Java 若ｈ括∞\fP @
+\f2「Java プラットフォームの監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
.RE
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jdb.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jdb.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jdb 1 "02 Jun 2010"
+.TH jdb 1 "14 Apr 2011"
.LP
-.SH ""
-jdb \- Java
-.LP
-.RS 3
-
+.SH "名前"
+jdb \- Java デバッガ
.LP
.LP
-\f3jdb\fP Java 荐茯違違荀ゃ篆罩ｃ篏睡若с
+\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,41 +39,32 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-罨＜腓冴潟潟茵激с
+次に示すコマンド行オプション
.TP 3
class
-違紮鴻
+デバッグを開始するクラスの名前
.TP 3
arguments
-\f2class\fP \f2main()\fP ＜純羝＜綣
+class の \f2main()\fP メソッドに渡す \f2引数\fP
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-Java \f3jdb\fP Java 合膂≦潟潟茵с
+Java デバッガ \f3jdb\fP は、Java クラス用の簡単なコマンド行デバッガです。
.na
\f2Java Platform Debugger Architecture\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html 荀荀絎茵若障≪若 Java Virtual Machine 罎祉違茵с障
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html を視覚的に実行し、ローカルまたはリモートの Java Virtual Machine の検査とデバッグを行うことができます。
.LP
.SS
-jdb 祉激с潟紮
-.LP
-.RS 3
-
+jdb セッションの開始
.LP
.LP
-jdb 祉激с潟紮障障号障ｃ紫篏帥違≪宴若激с潟＜ゃ潟鴻篏睡\f3jdb\fP 違 Java 篁潟激 (VM) 莎桁号с潟潟茵с \f3java\fP 篁ｃ \f3jdb\fP 潟潟ュ障違≪宴若激с潟＜ゃ潟鴻 MyClass 翫JDB 医с違罨＜潟潟篏睡障
+jdb セッションを開始するにはさまざまな方法があります。もっとも頻繁に使われるのは、デバッグするアプリケーションのメインクラスを使用して、\f3jdb\fP から新しい Java 仮想マシン (VM) を起動する方法です。コマンド行で、\f3java\fP の代わりに \f3jdb\fP コマンドを入力します。たとえば、アプリケーションのメインクラスが MyClass の場合は、JDB 環境でデバッグするときに次のコマンドを使用します。
.LP
.nf
\f3
@@ -91,10 +76,10 @@
.LP
.LP
-号ц儀\f3jdb\fP 絎＜若帥篏帥ｃ 2 ょ Java VM 若喝冴障 罨＜絎鴻若鴻巡擦絎茵 VM 罩≪障
+この方法で起動すると、\f3jdb\fP は、指定されたパラメータを使って 2 つ目の Java VM を呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前に VM を停止させます。
.LP
.LP
-\f3jdb\fP 1 ゃ篏睡号с莎桁 Java VM jdb ･膓сjdb ･膓 VM 絎茵筝莎桁罕罨＜腓冴障ゃ潟祉鴻亥ゃ若･膓腮蕁絎障
+\f3jdb\fP のもう 1 つの使用方法は、すでに起動している Java VM に jdb を接続することです。jdb が接続する VM を、その実行中に起動するための構文を次に示します。これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
.LP
.nf
\f3
@@ -106,7 +91,7 @@
.LP
.LP
-違罨＜潟潟MyClass ≪宴若激с潟絎茵\f3jdb\fP с≪宴若激с潟･膓с障
+たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。
.LP
.nf
\f3
@@ -118,7 +103,7 @@
.LP
.LP
-罨＜潟潟篏睡\f3jdb\fP VM ･膓с障
+次のコマンドを使用して、\f3jdb\fP を VM に接続できます。
.LP
.nf
\f3
@@ -130,45 +115,42 @@
.LP
.LP
-翫\f3jdb\fP 違 VM 莎桁篁ｃ√ VM ･膓\f3jdb\fP 潟潟茵MyClass絎障
+この場合、\f3jdb\fP は新しい VM を起動する代わりに既存の VM に接続されるため、\f3jdb\fP コマンド行には「MyClass」は指定しません。
.LP
.LP
- VM ･膓祉障障号鴻 \f3jdb\fP с泣若障･膓激с潟ゃJava Platform Debugger Architecture
+デバッガを VM に接続するにはほかにもさまざまな方法があり、すべて \f3jdb\fP でサポートされています。接続オプションについては、Java Platform Debugger Architecture の
.na
-\f2ャ＜潟\fP @
+\f2ドキュメント\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс\f3jdb\fP т戎 J2SE 1.4.2 篁ュ VM 莎桁号ゃ
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
.na
-\f21.4.2 ャ＜潟\fP @
+\f21.4.2 のドキュメント\fP @
.fi
-http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlс
+http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlを参照してください。
.LP
.SS
-堺 jdb 潟潟
+基本 jdb コマンド
.LP
.LP
-堺 \f3jdb\fP 潟潟筝荀с腓冴障Java 泣若潟潟篁ュ \f3jdb\fP \f2help\fP 潟潟篏睡茵腓冴с障
-.LP
-.RS 3
-
+基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。
.LP
.RS 3
.TP 3
-help 障 ?
-ｃ荀 \f3jdb\fP 潟潟 \f2help\fP 茯茘潟潟鴻膂≧茯篁茵腓冴障
+help または ?
+もっとも重要な \f3jdb\fP コマンド \f2help\fP は、認識されたコマンドのリストに簡潔な説明を付けて表示します。
.TP 3
run
-\f3jdb\fP 莎桁綽荀若ゃ潟荐絎潟潟篏睡違≪宴若激с潟絎茵紮с障潟潟√ VM ･膓翫違違≪宴若激с潟 \f3jdb\fP 莎桁篏睡с障
+\f3jdb\fP を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、デバッグするアプリケーションの実行を開始できます。このコマンドは、既存の VM に接続している場合とは異なり、デバッグするアプリケーションが \f3jdb\fP から起動したときにだけ使用できます。
.TP 3
cont
-若ゃ潟箴紊障鴻絎茵с違≪宴若激с潟絎茵膓膓障
+ブレークポイント、例外、またはステップ実行のあとで、デバッグするアプリケーションの実行を継続します。
.TP 3
print
-Java 吾с潟ｃゃ茵腓冴障ｃ紊違障ｃ若翫絎ゃ阪障吾с翫茯阪障吾сゃ篁ラ \f2dump\fP 潟潟茯с
+Java オブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の \f2dump\fP コマンドの説明を参照してください。
.LP
-\f2羈:絮紊違茵腓冴紊違鴻 \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP 激с潟с潟潟ゃ違障
+\f2注: 局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされている必要があります。
.LP
-\f2print\fP с＜純若喝冴紊違膂≦ Java 綣泣若障 罨＜箴腓冴障
+\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。次に例を示します。
.RS 3
.TP 2
o
@@ -178,25 +160,22 @@
\f2print myObj.myInstanceField\fP
.TP 2
o
-\f2print i + j + k\fP (ij k ｃсｃ若障絮紊違)
+\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか)
.TP 2
o
-\f2print myObj.myMethod()\fP (myMethod null 篁ュ菴翫)
+\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合)
.TP 2
o
\f2print new java.lang.String("Hello").length()\fP
.RE
.TP 3
dump
-ｃゃ翫潟潟 \f2print\fP с吾с翫吾с絎臂ｃ若憜ゃ阪障static ｃ若 instance ｃ若阪障
+プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。
.LP
-\f2dump\fP 潟潟с\f2print\fP 潟潟綣泣若障
+\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。
.TP 3
threads
-憜絎茵筝鴻筝荀ц；腓冴障鴻憜倶潟祉潟潟篏睡сゃ潟鴻阪障 罨＜箴腓冴障
-.RS 3
-
-.LP
+現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。次に例を示します。
.nf
\f3
.fl
@@ -204,163 +183,144 @@
.fl
\fP
.fi
-.RE
-箴с鴻ゃ潟鴻 4 с鴻 java.lang.Thread ゃ潟鴻帥潟鴻с 鴻mainс憜絎茵筝с
+この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。スレッドの名前は「main」であり、現在実行中です。
.TP 3
thread
-憜鴻鴻御障紊 \f3jdb\fP 潟潟憜鴻荐絎冴ャ絎茵障鴻\f2threads\fP 潟潟ц鴻ゃ潟鴻絎障
+現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。
.TP 3
where
-綣違絎 \f2where\fP 絎茵憜鴻鴻帥潟障 \f2where all\fP 潟潟憜鴻違若鴻鴻帥鴻潟障 \f2where\fP \f2threadindex\fP 絎鴻鴻帥潟障
+\f2引数を指定しないで\fP where を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックをすべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。
.LP
-憜鴻 (若ゃ潟 \f2suspend\fP 潟潟ｃ) 筝翫絮紊違ｃ若 \f2print\fP 潟潟 \f2dump\fP 潟潟ц；腓冴с障\f2up\fP 潟潟 \f2down\fP 潟潟с鴻帥若潟吾吟с障
+現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。
.RE
.LP
-.RE
.SS
-若ゃ潟
-.LP
-.RS 3
-
+ブレークポイント
.LP
.LP
-若ゃ潟茵垩障＜純巡擦 \f3jdb\fP 荐絎с障 罨＜箴腓冴障
+ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。次に例を示します。
.LP
.RS 3
.TP 2
o
-\f2stop at MyClass:22\fP (MyClass 障純若鴻＜ゃ 22 茵巡擦若ゃ潟荐絎)
+\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定)
.TP 2
o
-\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP ＜純若ゃ潟荐絎)
+\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定)
.TP 2
o
-\f2stop in MyClass.<init>\fP (<init> MyClass 潟潟鴻帥茘)
+\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別)
.TP 2
o
-\f2stop in MyClass.<clinit>\fP (<clinit> MyClass 潟若茘)
+\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別)
.RE
.LP
.LP
-＜純若若若翫＜純綣違絎若ゃ潟絲障＜純御違障違\f2MyClass.myMethod(int,java.lang.String)\fP障\f2MyClass.myMethod()\fP絎障
+メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにしなければなりません。たとえば、「\f2MyClass.myMethod(int,java.lang.String)\fP」または「\f2MyClass.myMethod()\fP」と指定します。
.LP
.LP
-\f2clear\fP 潟潟\f2clear\ MyClass:45\fP罕篏睡若ゃ潟ゃ障\f2clear\fP 篏睡綣違絎с潟潟篏睡憜荐絎鴻若ゃ潟茵腓冴障\f2cont\fP 潟潟絎茵膓膓障
+\f2clear\fP コマンドは、「\f2clear\ MyClass:45\fP」のような構文を使用してブレークポイントを削除します。\f2clear\fP を使用するか、引数を指定しないでコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\f2cont\fP コマンドは実行を継続します。
.LP
-.RE
.SS
-鴻絎茵
-.LP
-.RS 3
-
+ステップ実行
.LP
.LP
-\f2step\fP 潟潟憜鴻帥若障若喝冴＜純с罨＜茵絎茵障\f2next\fP 潟潟憜鴻帥若罨＜茵絎茵障
+\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。
.LP
-.RE
.SS
-箴紊
-.LP
-.RS 3
-
+例外
.LP
.LP
-鴻若鴻若喝冴鴻帥筝 catch 翫箴紊榊VM 絽吾箴紊若鴻阪腟篋障\f3jdb\fP 医у茵翫箴紊榊 \f3jdb\fP 九勝祉障罨＜\f3jdb\fP 篏睡箴紊荐堺障
+スローしているスレッドの呼び出しスタック上のどこにも catch 文がない場合に例外が発生すると、VM は通常、例外トレースを出力して終了します。ただし、\f3jdb\fP 環境で実行している場合は、例外が発生すると \f3jdb\fP に制御が戻ります。次に、\f3jdb\fP を使用して例外の原因を診断します。
.LP
.LP
-違\f2catch java.io.FileNotFoundException\fP障\f2catch mypackage.BigTroubleException\fP \f2catch\fP 潟潟篏睡違≪宴若激с潟祉箴紊鴻若罩≪障箴紊劫 (障泣) ゃ潟鴻帥潟鴻翫≪宴若激с潟箴紊鴻若贋у罩≪障
+たとえば、「\f2catch java.io.FileNotFoundException\fP」または「\f2catch mypackage.BigTroubleException\fP」のように \f2catch\fP コマンドを使用すると、デバッグされたアプリケーションは、ほかの例外がスローされたときに停止します。例外が特定のクラス (またはサブクラス) のインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。
.LP
.LP
-\f2ignore\fP 潟潟篏帥篁ュ \f2catch\fP 潟潟号≦鴻障
+\f2ignore\fP コマンドを使うと、以前の \f2catch\fP コマンドの効果が無効になります。
.LP
.LP
-\f2羈:\fP\f2ignore\fP 潟潟с違 VM 箴紊∴箴紊∴障
+\f2注: \fP\f2ignore\fP コマンドでは、デバッグされる VM は例外を無視せず、デバッガだけが例外を無視します。
.LP
-.RE
-.RE
-.SH "潟潟茵激с"
-.LP
-
+.SH "コマンド行オプション"
.LP
.LP
-潟潟茵 Java ≪宴若激с活儀若篁ｃ \f3jdb\fP 篏睡翫\f3jdb\fP \f2\-D\fP\f2\-classpath\fP\f2\-X<option>\fP java 潟潟違激с潟ャ障
+コマンド行で Java アプリケーション起動ツールの代わりに \f3jdb\fP を使用する場合、\f3jdb\fP は、\f2\-D\fP、\f2\-classpath\fP、\f2\-X<option>\fP など、java コマンドと同じ数のオプションを受け入れます。
.LP
.LP
-\f3jdb\fP 祉罨＜激с潟ャ障
+\f3jdb\fP は、そのほかに次のオプションを受け入れます。
.LP
.RS 3
.TP 3
\-help
-＜祉若吾茵腓冴障
+ヘルプメッセージを表示します。
.TP 3
\-sourcepath <dir1:dir2:...>
-絎鴻篏睡純若鴻＜ゃ罎膣≪障激с潟絎翫鴻.篏帥障
+指定されたパスを使用して、ソースファイルを検索します。このオプションが指定されていない場合は、デフォルトパスの「.」が使われます。
.TP 3
\-attach <address>
-･膓罘罕篏睡с絎茵筝 VM ･膓障
+デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続します。
.TP 3
\-listen <address>
-絎茵筝 VM 罔羣潟帥篏帥ｃ絎≪鴻･膓緇罘障
+実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
.TP 3
\-listenany
-絎茵筝 VM 罔羣潟帥篏帥ｃ純篁紙≪鴻･膓緇罘障
+実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
.TP 3
\-launch
-違≪宴若激с潟 jdb 莎桁緇＜莎桁障激с潟ｃ\f2run\fP 潟潟篏睡綽荀障違≪宴若激с潟莎桁緇≪宴若激с潟鴻若翫罩≪障鴻с綽荀若ゃ潟荐絎\f2cont\fP 篏睡絎茵膓膓с障
+デバッグするアプリケーションを jdb の起動後ただちに起動します。このオプションによって、\f2run\fP コマンドを使用する必要がなくなります。デバッグするアプリケーションは、起動後、初期アプリケーションクラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\f2cont\fP を使用して実行を継続できます。
.TP 3
\-listconnectors
- VM ус潟帥筝荀ц；腓冴障
+この VM で利用できるコネクタを一覧表示します。
.TP 3
\-connect <connector\-name>:<name1>=<value1>,...
-筝荀ц；腓冴綣違ゃ絎潟帥篏帥ｃ帥若蚊 VM ･膓障
+一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
.TP 3
\-dbgtrace [flags]
-jdb 井宴阪障
+jdb のデバッグ情報を出力します。
.TP 3
\-tclient
-Java HotSpot(tm) VM (ゃ≪潟) с≪宴若激с潟絎茵障
+Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
.TP 3
\-tserver
-Java HotSpot(tm) VM (泣若) с≪宴若激с潟絎茵障
+Java HotSpot(tm) VM (サーバー) 内でアプリケーションを実行します。
.TP 3
\-Joption
-jdb 絎茵篏睡 Java 篁潟激潟 \f2option\fP 羝＜障(≪宴若激с Java 篁潟激潟絲障激с潟\f3run\fP 潟潟羝＜)違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される)。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.LP
-違茵 VM ･膓篁ｆ炊罕絲障篁激с潟泣若障篁･膓激с潟ゃJava Platform Debugger Architecture
+デバッガとデバッグを行う VM を接続するための代替機構に対して、その他のオプションがサポートされています。その他の接続オプションについては、Java Platform Debugger Architecture の
.na
-\f2ャ＜潟\fP @
+\f2ドキュメント\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。
.LP
.SS
-医乗院祉鴻荵∫激с
+デバッグ対象のプロセスに転送されるオプション
.LP
.RS 3
.TP 3
\-v \-verbose[:class|gc|jni]
-激≪若障
+冗長モードにします。
.TP 3
\-D<name>=<value>
-激鴻ｃ若荐絎障
+システムプロパティーを設定します。
.TP 3
\-classpath <directories separated by ":">
-鴻罎膣≪ｃ筝荀ц；腓冴障
+クラスを検索するディレクトリを一覧表示します。
.TP 3
\-X<option>
-罔羣帥若蚊 VM 激с潟с
+非標準ターゲット VM オプションです。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-javac(1)java(1)javah(1)javap(1)javadoc(1)
+javac(1)、java(1)、javah(1)、javap(1)、javadoc(1)
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jhat.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jhat.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jhat 1 "02 Jun 2010"
+.TH jhat 1 "14 Apr 2011"
.LP
-.SH ""
-jhat \- Java 若茹ｆ若
+.SH "名前"
+jhat \- Java ヒープ解析ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -58,88 +56,90 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
-.br
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
heap\-dump\-file
-阪乗院 Java ゃ若潟＜ゃ茲違若潟潟＜ゃ翫foo.hprof#3＜ゃ緇#<number>篁с＜ゃ劫潟絎с障
-.SH "茯"
+ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
+.RE
+
+.LP
+.SH "説明"
.LP
.LP
-\f3jhat\fP 潟潟java 若潟＜ゃ茹ｆWeb 泣若若莎桁障 jhat 篏帥違絅純帥 Web 吟篏帥ｃ若潟冴с障 jhat ∝ャ鴻Foo鴻ゃ潟鴻帥潟鴻茵腓冴ｃ篋荐荐祉\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) 泣若障OQL jhat ｃ茵腓冴 OQL 若吾≪祉鴻с障若篏睡翫OQL http://localhost:7000/oqlhelp/ у純с
+\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバーを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
.LP
.LP
-Java 若潟ゃ号障
+Java のヒープダンプを生成するには、いくつかの方法があります。
.LP
.RS 3
.TP 2
o
-jmap(1) \-dump 激с潟篏帥ｃ絎茵若潟緇
+jmap(1) の \-dump オプションを使って実行時にヒープダンプを取得する。
.TP 2
o
-jconsole(1) 激с潟篏帥ｃ
+jconsole(1) のオプションを使って
.na
\f2HotSpotDiagnosticMXBean\fP @
.fi
-http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 腟宴у茵若潟緇
+http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 経由で実行時にヒープダンプを取得する。
.TP 2
o
-\-XX:+HeapDumpOnOutOfMemoryError VM 激с潟絎OutOfMemoryError 鴻惹若潟
+\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
.TP 2
o
.na
\f2hprof\fP @
.fi
-http://java.sun.com/developer/technicalArticles/Programming/HPROF.html 篏睡
+http://java.sun.com/developer/technicalArticles/Programming/HPROF.html を使用する。
.RE
.LP
.LP
-\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
+\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
-.SH "激с"
+.SH "オプション"
+.LP
.RS 3
.TP 3
\-stack false/true
-吾с蚊綵若喝冴鴻帥菴処掘≦鴻障若潟у蚊綵泣ゃ宴篏睡с翫違 false 荐絎綽荀障 true с
+オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
.TP 3
\-refs false/true
-吾с吾с菴処掘≦鴻障 true сс若鴻吾сゃゃ潟 (絎吾сゃ潟吾с ц障篆≦с若違) 荐膊障
+オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる) が計算されます。
.TP 3
\-port port\-number
-jhat HTTP 泣若若若荐絎障 7000 с
+jhat の HTTP サーバーのポートを設定します。デフォルトは 7000 です。
.TP 3
\-exclude exclude\-file
-育純吾сゅ鴻若帥＜潟若筝荀с＜ゃ絎障違＜ゃ \f2java.lang.String.value\fP 障翫劫吾сo育純吾с鴻荐膊\f2java.lang.String.value\fP ｃ若∫ｃс鴻障
+「到達可能なオブジェクト」のクエリから除外すべきデータメンバーの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
.TP 3
\-baseline baseline\-dump\-file
-若鴻ゃ潟若潟絎障筝≧鴻若潟у吾с ID ゃ吾с域с若障篁吾с域若障違 2 ゃ若潟罸莠綵合＜障
+ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
.TP 3
\-debug int
-若違荐絎障0 医阪潟障紊сゃ荐絎激≪若障
+このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
.TP 3
-\-version\
-若吾с括垩怨腟篋障
+\-version
+バージョン番号を報告したあと、終了します。
.TP 3
-\-h\
-＜祉若吾阪腟篋障
+\-h
+ヘルプメッセージを出力して終了します。
.TP 3
-\-help\
-＜祉若吾阪腟篋障
+\-help
+ヘルプメッセージを出力して終了します。
.TP 3
-\-J<flag>\
-jhat 絎茵 Java 篁潟激潟 <flag> 羝＜障違512M ゃ紊с若泣ゃ冴篏睡\-J\-Xmx512m 障
+\-J<flag>
+jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
+.LP
.RS 3
.TP 2
o
@@ -150,9 +150,10 @@
.TP 2
o
.na
-\f2hprof \- 若 CPU ＜ゃ潟違若\fP @
+\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE
-.RE
+
+.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jinfo.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jinfo.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jinfo 1 "02 Jun 2010"
+.TH jinfo 1 "14 Apr 2011"
.LP
-.SH ""
-jinfo \- 罕
+.SH "名前"
+jinfo \- 構成情報
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -60,98 +58,100 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
option
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
+.RE
+
+.LP
.RS 3
.TP 3
pid
-阪罕宴祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+出力する構成情報のプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
+
+.LP
.RS 3
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.RE
+
+.LP
.RS 3
.TP 3
core
-阪罕宴潟≪＜ゃ
+出力する構成情報のコアファイル。
.RE
+
+.LP
.RS 3
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
-.RE
-.RS 3
-.TP 3
-server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
-.RE
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.RE
.LP
-.SH "茯"
-.LP
-
-.LP
-.LP
-\f3jinfo\fP 絎 Java 祉鴻潟≪＜ゃ障≪若違泣若若 Java 罕宴阪障罕宴Java 激鴻ｃ若 Java 篁潟激潟潟潟茵違罕障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
-.br
-
-.LP
-.RS 3
-
-.LP
-jinfo \-J\-d64 \-sysprops pid
-.RE
-.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 筝 jinfo с泣若絎茵筝祉鴻 \-flag 激с潟с\fP
-.LP
-.SH "激с"
-.LP
-
-.LP
.RS 3
.TP 3
-<激с潟>
-潟潟茵違激鴻ｃ弱ゃ≪阪障
+server\-id
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
+.RE
+
+.LP
+.SH "説明"
+.LP
+.LP
+\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
+.br
+jinfo \-J\-d64 \-sysprops pid
+.LP
+.LP
+\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
+.LP
+.LP
+\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
+.SH "オプション"
+.LP
+.RS 3
+.TP 3
+<オプションなし>
+コマンド行フラグを、システムプロパティー名と値のペアとともに出力します。
.br
.TP 3
\-flag name
-絎潟潟茵違ゃ阪障
+指定されたコマンド行フラグの名前と値を出力します。
.br
.TP 3
\-flag [+|\-]name
-絎若潟潟茵違鴻障≦鴻障
+指定されたブール型のコマンド行フラグを有効または無効にします。
.br
.TP 3
\-flag name=value
-絎潟潟茵違絎ゃ荐絎障
+指定されたコマンド行フラグを指定された値に設定します。
.br
.TP 3
\-flags
-JVM 羝＜潟潟茵違≪у阪障
+JVM に渡されるコマンド行フラグをペアで出力します。
.br
.TP 3
\-sysprops
-Java 激鴻ｃ若ゃ≪阪障
+Java システムプロパティーを名前と値のペアとして出力します。
.br
.TP 3
\-h
-＜祉若吾阪障
+ヘルプメッセージを出力します。
.TP 3
\-help
-＜祉若吾阪障
+ヘルプメッセージを出力します。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jmap.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jmap.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,34 +19,32 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jmap 1 "02 Jun 2010"
+.TH jmap 1 "14 Apr 2011"
.LP
-.SH ""
-jmap \- ＜≪若
+.SH "名前"
+jmap \- メモリーマップ
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -60,46 +58,39 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
option
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
.TP 3
pid
-医激＜≪若祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.br
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.br
.TP 3
core
-医激＜≪若潟≪＜ゃ
+印刷するメモリーマップのコアファイル。
.br
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.br
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jmap\fP 絎祉鴻潟≪＜ゃ障≪若違泣若若援吾с＜≪若障若＜≪若荅括完医激障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
-.LP
-.RS 3
-
+\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.LP
.nf
\f3
@@ -108,76 +99,66 @@
.fl
\fP
.fi
-.RE
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障\fP
+.LP
+\f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
+.LP
+.LP
+\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
.br
.LP
-Windows 若筝т戎純筝 jmap 綵√罨＜с
-.RS 3
-
-.LP
-jmap \-dump:<\f2dump\-options\fP> pid
-.RE
-
-.RS 3
-
-.LP
-jmap \-histo[:live] pid
-.RE
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-<激с潟>
-激с潟篏睡翫\f3jmap\fP 援吾с潟違医激障帥若蚊 VM 若援吾с紮≪鴻潟違泣ゃ冴喝援吾с＜ゃ鴻医激障Solaris \f3pmap\fP 若ｃｃ若蕁篌若障
+<オプションなし>
+オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris \f3pmap\fP ユーティリティーと類似しています。
.br
.TP 3
\-dump:[live,]format=b,file=<filename>
-Java 若 hprof ゃ綵√ filename 潟障\f2live\fP 泣激с潟ュ純с絎翫若х絖筝吾с帥潟障若潟с＜ゃ jhat(1) (Java Heap Analysis Tool) 篏帥ｃ茯水障
+Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。
.br
.TP 3
\-finalizerinfo
-＜ゃゃ冴緇ｃ吾с≪宴阪障
+ファイナライズを待っているオブジェクトに関する情報を出力します。
.br
.TP 3
\-heap
-若泣若医激障篏睡 GC ≪眼冴若罕割篁ｃ若篏睡医激障
+ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。
.br
.TP 3
\-histo[:live]
-若鴻違医激障Java 鴻吾с違ゃ篏с＜≪若泣ゃ冴喝篆蕋障劫医激障VM 劫*･莨篁医激障\f2live\fP 泣激с潟絎翫絖筝吾с帥潟障
+ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
.br
.TP 3
\-permstat
-Permanent 筝篁ｃ Java 若鴻若守∫ｃ腟沿若帥医激障鴻若若倶≪鴻荀鴻若若潟鴻若若若鴻違泣ゃ冴医激障intern 絖違泣ゃ冴阪障
+Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。
.br
.TP 3
\-F
-綣桁 (Force)pid 綽膈翫jmap \-dump 障 jmap \-histo 激с潟篏睡障≪若с\f2live\fP 泣激с潟泣若障
+強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
.br
.TP 3
\-h
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-J<flag>
-jmap 絎茵 Java 篁潟激潟 <flag> 羝＜障
+jmap が実行されている Java 仮想マシンに <flag> を渡します。
.br
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jps.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jps.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,43 +19,41 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jps 1 "02 Jun 2010"
+.TH jps 1 "14 Apr 2011"
.LP
-.SH ""
-jps \- Java 篁潟激潟祉鴻鴻若帥鴻若
+.SH "名前"
+jps \- Java 仮想マシンプロセスステータスツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-鴻茘ュ
+ホスト識別子
.TP 2
o
-阪綵√
+出力形式
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -67,79 +65,70 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
hostid
-祉鴻若鴻鴻茘ュ\f2hostid\fP 篆＜潟若垩絎茖堺篁若帥絎激с潟潟潟若潟с障
+プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jps\fP 若帥若蚊激鴻筝ц羝 HotSpot Java 篁潟激 (JVM) 筝荀ц；腓冴障若ц；腓冴с若宴≪祉号┤ｃ JVM ≪絎障
+\f3jps\fP ツールは、ターゲットシステム上で計測された HotSpot Java 仮想マシン (JVM) を一覧表示します。このツールで表示できるレポート情報は、アクセス権を持った JVM に関するものに限定されます。
.LP
.LP
-\f2hostid\fP 絎 \f3jps\fP 絎茵翫若鴻ц羝 JVM 罎膣≪障\f2hostid\fP 絎莎桁翫絎潟若篏睡絎鴻筝 JVM 罎膣≪障\f3jstatd\fP 祉鴻帥若蚊鴻筝у茵喝障
+\f2hostid\fP を指定せずに \f3jps\fP を実行した場合、ローカルホストで計測された JVM が検索されます。\f2hostid\fP を指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上の JVM を検索します。\f3jstatd\fP プロセスがターゲットホスト上で実行されていると想定されます。
.LP
.LP
-\f3jps\fP 潟潟帥若蚊激鴻ц羝 JVM ゃ若 VM 茘ュゃ障 \f2lvmid\fP 若障\f3lvmid\fP 綽с障筝 JVM 祉鴻絲障若ｃ潟違激鴻祉壕ュс激с潟絎翫\f3jps\fP ｃ Java ≪宴若激с潟 \f2lvmid\fP 筝荀ц；腓冴≪宴若激с潟劫障 JAR ＜ゃ膂≦綵√хず障膂≦綵√劫 JAR ＜ゃс鴻宴若御宴障 JAR ＜ゃ号宴ャ障
+\f3jps\fP コマンドは、ターゲットシステムで計測された各 JVM について、ローカル VM 識別子、つまり \f2lvmid\fP をレポートします。\f3lvmid\fP は、必須ではありませんが、一般的には JVM プロセスに対するオペレーティングシステムのプロセス識別子です。オプションを指定しない場合、\f3jps\fP によって、各 Java アプリケーションの \f2lvmid\fP が一覧表示され、それぞれにアプリケーションのクラス名または JAR ファイル名が簡単な形式で示されます。この簡単な形式のクラス名と JAR ファイル名では、クラスのパッケージ情報または JAR ファイルパス情報が省略されています。
.LP
.LP
-\f3jps\fP 潟潟\f3Java\fP 莎桁若篏睡\f2main\fP ＜純羝＜劫綣違罎膣≪障莎桁若篏睡帥若蚊 JVM 莎桁翫\f2main\fP ＜純羝＜劫 (障 JAR ＜ゃ) 綣違с障翫\f3jps\fP 潟潟main ＜純御検劫 (障 JAR ＜ゃ) 綣違絲障絖 \f2Unknown\fP 阪障
+\f3jps\fP コマンドは、\f3Java\fP 起動ツールを使用して \f2main\fP メソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲット JVM を起動した場合は、 \f2main\fP メソッドに渡されるクラス名 (または JAR ファイル名) と引数は利用できません。この場合、\f3jps\fP コマンドは、main メソッドへ渡されるクラス名 (または JAR ファイル名) と引数に対して、文字列 \f2Unknown\fP を出力します。
.LP
.LP
-\f3jps\fP 潟潟х JVM 鴻潟潟絎茵筝私筝≪祉号┤冴ャ狗翫障潟潟若ｃ潟違激鴻≪祉劫九勝罘罕羆阪冴ャ筝私≪祉号┤筝 JVM 筝荀ц；腓冴障
+\f3jps\fP コマンドで生成される JVM のリストは、このコマンドを実行する主体に与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティングシステム独自のアクセス制御機構による決定に基づいて、主体にアクセス権が与えられている JVM だけを一覧表示します。
.LP
.LP
-\f3羈:\fP 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jps\fP 潟潟с潟潟阪紊眼激с潟紊違泣若障絨ャ激с潟紊眼障綮罩≪醇с障
+\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。
.LP
.RS 3
.TP 3
\-q
-若 VM 茘ュ鴻\f2main\fP ＜純羝＜劫JAR ＜ゃ喝違阪九勝障
+クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。
.TP 3
\-m
-main ＜純羝＜綣違阪障阪腟粋昭障 JVM 絲障 null 障
+main メソッドに渡される引数を出力します。この出力は、組み込まれている JVM に対して null になることもあります。
.TP 3
\-l
-≪宴若激с潟筝肢鴻宴若後障≪宴若激с潟 JAR ＜ゃ吾劫阪障
+アプリケーションの主要なクラスのフルパッケージ名、またはアプリケーションの JAR ファイルへのフルパス名を出力します。
.TP 3
\-v
-JVM 羝＜綣違阪障
+JVM に渡される引数を出力します。
.TP 3
\-V
-違＜ゃ (.hotspotrc ＜ゃ障 \-XX:Flags=<\f2filename\fP> 綣違ф絎＜ゃ) JVM 羝＜綣違阪障
+フラグファイル (.hotspotrc ファイルまたは \-XX:Flags=<\f2filename\fP> の引数で指定されたファイル) を通じて JVM に渡される引数を出力します。
.TP 3
\-Joption
-\f3jps\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f3jps\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
.SS
-鴻茘ュ
-.LP
-.RS 3
-
+ホスト識別子
.LP
.LP
-鴻茘ュゃ障 \f2hostid\fP 帥若蚊激鴻腓冴絖с\f2hostid\fP 絖罕紊чURI 罕絲上障
+ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
@@ -155,26 +144,23 @@
.RS 3
.TP 3
protocol
-篆＜潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
+通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
hostname
-帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
+ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
-≪若泣若若篆＜若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP ＜若帥宴絎茖ｃ違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
+リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
-＜若帥宴絎茖ｃ違障若潟翫ｃ若∴障\f3rmi\fP 潟翫＜若帥≪若鴻筝 RMI ≪若吾с腓冴絖障jstatd(1) 潟潟ゃ\f3\-n\fP 激с潟с
+このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を示す文字列になります。jstatd(1) コマンドについては、\f3\-n\fP オプションを参照してください。
.RE
.LP
-.RE
-.SH "阪綵√"
-.LP
-
+.SH "出力形式"
.LP
.LP
-\f3jps\fP 潟潟阪罨＜帥若潟緇障
+\f3jps\fP コマンドの出力は、次のパターンに従います。
.LP
.nf
\f3
@@ -188,22 +174,20 @@
.LP
.LP
-鴻阪若潟腥榊純у阪障\f2arg\fP 筝х榊純篏睡絎絎篏臀＜若帥綣違潟違障障
+すべての出力トークンは空白で区切ります。\f2arg\fP の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。
.br
.br
-\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jps\fP 阪茹ｆ鴻篏с障\f3jps\fP 阪茹ｆ鴻篏若絨ャ若鴻с篏鴻紊眼綽荀篋羝障
+\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jps\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jps\fP 出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトを変更する必要が予測されます。
.br
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-膀с\f3jps\fP 潟潟箴腓冴障
+この節では、\f3jps\fP コマンドの例を示します。
.LP
.LP
-若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+ローカルホスト上で計測された JVM を一覧表示する場合:
.LP
.nf
\f3
@@ -228,10 +212,10 @@
.LP
.LP
-≪若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
-箴с\f3jstat\fP 泣若若 RMI 吾鴻障ャ紊 \f3rmiregistry\fP 祉鴻≪若鴻若 (若 1099) у茵喝障障若鴻≪若鴻吾鴻≪祉号┤ｃ喝障箴\f2\-l\fP 激с潟障劫障 JAR ＜ゃ荅括完綵√у阪障
+この例では、\f3jstat\fP サーバーと、その内部 RMI レジストリまたは別の外部 \f3rmiregistry\fP プロセスのいずれかとが、リモートホストのデフォルトポート (ポート 1099) で実行されていると想定しています。また、ローカルホストが、リモートホストへの有効なアクセス権を持っていることも想定しています。この例には、\f2\-l\fP オプションも含まれ、クラス名または JAR ファイル名を詳細な形式で出力します。
.LP
.nf
\f3
@@ -240,7 +224,7 @@
.br
.fl
-3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
+3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@@ -252,10 +236,10 @@
.LP
.LP
-RMI 吾鴻с若篏睡≪若鴻筝ц羝 JVM 筝荀ц；腓冴翫:
+RMI レジストリにデフォルトではないポートを使用して、リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
-箴с RMI 吾鴻若 2002 ゃ潟 \f3jstatd\fP 泣若若≪若鴻筝у茵喝障障\f2\-m\fP 激с潟篏睡筝荀ц；腓冴 Java ≪宴若激с潟 \f2main\fP ＜純羝＜綣違腟粋昭с障
+この例では、内部 RMI レジストリがポート 2002 にバインドされた \f3jstatd\fP サーバーが、リモートホスト上で実行していると想定しています。また、\f2\-m\fP オプションを使用して、一覧表示されたそれぞれの Java アプリケーションの \f2main\fP メソッドに渡される引数を組み込んでいます。
.LP
.nf
\f3
@@ -264,7 +248,7 @@
.br
.fl
-3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
+3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@@ -273,21 +257,21 @@
.fi
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jstat(1) \- Java 篁潟激括輝荐若睡ｈ若
+「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
-jstatd(1) \- 篁潟激 jstat 若≪潟
+「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
-rmiregistry(1) \- Java ≪若吾с吾鴻
+「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 2006, 2011, 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
@@ -19,40 +19,38 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jrunscript 1 "02 Jun 2010"
+.TH jrunscript 1 "14 Apr 2011"
.LP
-.SH ""
-jrunscript \- 潟潟茵鴻激с
+.SH "名前"
+jrunscript \- コマンド行スクリプトシェル
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-綣
+引数
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -62,85 +60,77 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-激с潟篏睡翫潟潟翫荐菴違
+オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
arguments
-綣違篏睡翫激с潟障潟潟翫荐菴違
+引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jrunscript\fP 潟潟茵鴻激сс jrunscript 絲乗怨 (茯水 \- 荅箴 \- 阪) ≪若 (\-f 激с) ≪若筝≧鴻鴻絎茵泣若障鴻荐茯箴絖激сс篏睡荐茯 JavaScript с\-l 激с潟篏帥違祉荐茯絎с障jrunscript Java 鴻荐茯篆＜ｃ｢羆違潟違鴻帥ゃ泣若障
+\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
.LP
.LP
-\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
+\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-classpath path
-鴻≪祉劫乗院若吟若 .class ＜ゃ罎膣√贋絎障
+スクリプトからのアクセス対象となるユーザーの .class ファイルの検索場所を指定します。
.TP 3
\-cp path
-\-classpath \f2path\fP 臂с
+\-classpath \f2path\fP と同義です。
.TP 3
\-Dname=value
-Java 激鴻ｃ若荐絎障
+Java のシステムプロパティーを設定します。
.TP 3
\-J<flag>
-jrunscript 絎茵 Java 篁潟激潟 <flag> 羝＜障
+jrunscript が実行されている Java 仮想マシンに <flag> を渡します。
.TP 3
\-l language
-絎鴻荐茯篏睡障с JavaScript 篏睡障祉鴻荐茯篏睡絲上鴻潟吾潟 JAR ＜ゃ絎綽荀障 \-cp\-classpath 激с潟篏睡障
+指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。
.TP 3
\-e script
-絎鴻荅箴＜障激с潟篏帥違潟潟茵鴻絎1 茵鴻絎茵с障
+指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
.TP 3
\-encoding encoding
-鴻＜ゃ茯水篏睡絖潟潟若ｃ潟違絎障
+スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
.TP 3
\-f script\-file
-絎鴻＜ゃ荅箴＜障 (≪若)
+指定されたスクリプトファイルを評価します (バッチモード)。
.TP 3
\-f \-
-罔羣ュ鴻茯水荅箴＜障 (絲乗怨≪若)
+標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
.TP 3
\-help\
-＜祉若吾阪腟篋障
+ヘルプメッセージを出力して終了します。
.TP 3
\-?\
-＜祉若吾阪腟篋障
+ヘルプメッセージを出力して終了します。
.TP 3
\-q\
-純鴻鴻潟吾潟筝荀ц；腓冴腟篋障
+利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
.RE
.LP
-.SH "綣"
+.SH "引数"
.LP
.LP
-[arguments...] 絖 \f3\-e\fP\f3\-f\fP 激с潟篏睡ｃ翫綣違鴻＜ゃ篁綣違絖翫鴻綣違羝＜障[arguments..] 篏睡 \f3\-e\fP\f3\-f\fP 激с潟篏睡翫鴻 [arguments..] 鴻綣違羝＜障[arguments..]\f3\-e\fP\f3\-f\fP 絖ｃ翫絲乗怨≪若篏睡障鴻鴻綣違篏睡arguments String 潟吾喝違篏睡障
-.LP
-.SH "箴"
+[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] と、\f3\-e\fP または \f3\-f\fP が使用されている場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
.LP
-\f3ゃ潟ゃ潟鴻絎茵\fP
+.SH "例"
.LP
-.RS 3
-
+.SS
+インラインスクリプトの実行
.LP
.nf
\f3
@@ -151,13 +141,10 @@
.fl
\fP
.fi
-.RE
.LP
-\f3絎荐茯篏睡絎鴻＜ゃ荅箴＜\fP
-.LP
-.RS 3
-
+.SS
+指定された言語を使用し、指定されたスクリプトファイルを評価する
.LP
.nf
\f3
@@ -166,42 +153,42 @@
.fl
\fP
.fi
-.RE
.LP
-\f3絲乗怨≪若\fP
-.LP
-.RS 3
-
+.SS
+対話型モード
.LP
.nf
\f3
.fl
jrunscript
.fl
-js>print('hello world');
+js> print('Hello World\\n');
+.fl
+Hello World
.fl
-hello world
+js> 34 + 55
.fl
-js>34 + 55
+89.0
.fl
-89
+js> t = new java.lang.Thread(function() { print('Hello World\\n'); })
+.fl
+Thread[Thread\-0,5,main]
.fl
-js> thread(function() { print('hello world'); }
+js> t.start()
.fl
-hello world
+js> Hello World
+.fl
+
.fl
js>
.fl
\fP
.fi
-.RE
.LP
-\f3鴻綣違絎鴻＜ゃ絎茵\fP
-.LP
-.RS 3
-
+.SS
+スクリプト引数を指定してスクリプトファイルを実行する
.LP
.nf
\f3
@@ -210,13 +197,12 @@
.fl
\fP
.fi
-.RE
.LP
-test.js 絎茵絲乗院鴻＜ゃсarg1arg2 arg3 鴻綣違鴻羝＜障鴻arguments篏帥ｃ≪祉鴻с障
-.SH "∫ｉ"
+test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
+.SH "関連項目"
.LP
.LP
-JavaScript 篏睡翫jrunscript 若吟弱臂鴻荅箴＜ゃ腟粋昭翠∽違腟粋昭帥吾с障 JavaScript 腟粋昭炊純ゃjsdocs с
+JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,31 +19,29 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jsadebugd 1 "02 Jun 2010"
+.TH jsadebugd 1 "14 Apr 2011"
.LP
-.SH ""
-jsadebugd \- 泣若鴻≪ｃ若若吾с潟違若≪
+.SH "名前"
+jsadebugd \- サービスアビリティーエージェントデバッグデーモン
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -55,14 +53,12 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
pid
-違泣若若･膓祉鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障筝祉鴻･膓с違泣若若ゃ潟鴻帥潟鴻1 ゃ狗障
+デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。
.RE
.LP
@@ -74,37 +70,32 @@
.LP
.RS 3
.TP 3
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元になる Java 実行可能ファイルです。
.RE
.LP
.RS 3
.TP 3
core
-違泣若若･膓潟≪＜ゃс
+デバッグサーバーを接続するコアファイルです。
.RE
.LP
.RS 3
.TP 3
server\-id
-茲違違泣若若筝激割у茵翫綽荀激с喝堺 ID с ID ≪若ゃ≪潟･膓違泣若若劫篏睡綽荀障 ID 筝激喝тс違障
+複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。
.RE
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jsadebugd\fP Java 祉鴻障潟≪＜ゃ･膓違泣若若罘純障jstack(1)jmap(1) jinfo(1) ≪若ゃ≪潟Java Remote Method Invocation (RMI) 篏睡泣若若･膓с障\f2jsadebugd\fP 莎桁罨＜絎
+\f3jsadebugd\fP は、Java プロセスまたはコアファイルに接続し、デバッグサーバーとして機能します。jstack(1)、jmap(1)、および jinfo(1) などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用しているサーバーに接続できます。 \f2jsadebugd\fP を起動する前に、次のようにして
.na
\f2rmiregistry\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi 莎桁綽荀障
-.LP
-.RS 3
-
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi を起動する必要があります。
.LP
.nf
\f3
@@ -113,16 +104,18 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-с\f2$JAVA_HOME\fP JDK ゃ潟鴻若ｃсrmiregistry 莎桁翫jsadebugd 罔羣 (1099) 若 rmiregistry ц儀障違泣若若SIGINT 篆＜ (Ctrl+C 若) 罩≪с障
+ここで、 \f2$JAVA_HOME\fP は JDK インストールディレクトリです。rmiregistry が起動していない場合、jsadebugd は標準 (1099) ポートの rmiregistry を内部で起動します。デバッグサーバーは、SIGINT を送信する (Ctrl+C を押す) ことにより停止できます。
.LP
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障 jsadebugd 憝鴻сWindows 若с篏睡с障\fP
+\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
+.LP
.LP
-.SH "∫ｉ"
+次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jstack.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jstack.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,41 +19,39 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstack 1 "02 Jun 2010"
+.TH jstack 1 "14 Apr 2011"
.LP
-.SH ""
-jstack \- 鴻帥若
+.SH "名前"
+jstack \- スタックトレース
.br
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.br
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-∝ャ
+既知のバグ
.br
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -67,51 +65,44 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.LP
-激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障激с潟с
+各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
.LP
.RS 3
.TP 3
pid
-医激鴻帥若鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
+印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
.LP
.RS 3
.TP 3
executable
-潟≪潟篏 Java 絎茵純＜ゃс
+コアダンプの作成元の Java 実行可能ファイルです。
.br
.TP 3
core
-医激鴻帥若鴻潟≪＜ゃс
+印刷するスタックトレースのコアファイルです。
.br
.TP 3
remote\-hostname\-or\-IP
-≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
+リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
-茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
+複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.RE
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3jstack\fP 絎 Java 祉鴻潟≪＜ゃ障≪若違泣若若絲障 Java 鴻 Java 鴻帥若鴻医激障Java 若劫＜純bci(ゃ潟若ゃ潟)活 (純翫) 医激障\-m 激с潟篏睡jstack 鴻鴻 Java 若ゃｃ若筝≧鴻pc(違潟) 医激障ゃｃ若pcｃ菴ゃｃ激潟 (純翫) 医激障C++ 茹ｅ茹ｈВゃ障C++ 茹ｈВゃ潟潟阪 \f3c++filt\fP ゃ障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨＜箴腓冴障
+\f3jstack\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーに対する Java スレッドの Java スタックトレースを印刷します。Java フレームごとに、フルクラス名、メソッド名、「bci」(バイトコードインデックス)、および行番号 (利用可能な場合) が印刷されます。\-m オプションを使用すると、jstack は、すべてのスレッドの Java フレームとネイティブフレームの両方を、「pc」(プログラムカウンタ) とともに印刷します。ネイティブフレームごとに、「pc」にもっとも近いネイティブシンボル (利用可能な場合) が印刷されます。C++ 分解名は分解解除されません。C++ 名を分解解除するには、このコマンドの出力を \f3c++filt\fP にパイプします。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.br
.LP
-.RS 3
-
-.LP
.nf
\f3
.fl
@@ -119,51 +110,43 @@
.fl
\fP
.fi
-.RE
.LP
.LP
-\f3羈 \- 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 若筝т戎純筝 jstack 綵√罨＜с\fP
+\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
+.LP
.LP
-.nf
-\f3
-.fl
-\fP\f3 jstack [\-l] pid \fP
-.fl
-.fi
-
+次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-F
-jstack [\-l] pid綽膈翫鴻帥潟綣桁吟障
+「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。
.TP 3
\-l
-桁就綣鴻 java.util.concurrent
+長形式のリスト。所有 java.util.concurrent の
.na
-\f2с激潟ゃ\fP @
+\f2所有できるシンクロナイザ\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html筝荀сゃ菴遵宴医激障
+http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。
.TP 3
\-m
-羞桁≪若 (Java 潟ゃｃ C/C++ 若筝≧) 鴻帥若鴻医激障
+混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。
.TP 3
\-h
-＜祉若吾医激障
+ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
-＜祉若吾医激障
+ヘルプメッセージを出力します。
.br
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -181,11 +164,9 @@
.RE
.LP
-.SH "∝ャ"
-.LP
-
+.SH "既知のバグ"
.LP
.LP
-羞桁≪若鴻帥若 (\-m 激с割戎) ≪若違泣若若с罘純障
+混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jstat.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jstat.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,44 +19,46 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstat 1 "02 Jun 2010"
+.TH jstat 1 "14 Apr 2011"
.LP
-.SH ""
-jstat \- Java 篁潟激括輝荐若睡ｈ若
+.SH "名前"
+jstat \- Java 仮想マシン統計データ監視ツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-篁潟激活ュ
+仮想マシン識別子
.TP 2
o
-激с
-.br
-\ \ \- 筝激с
-.br
-\ \ \- 阪激с
+オプション
+.RS 3
+.TP 2
+*
+一般的なオプション
+.TP 2
+*
+出力オプション
+.RE
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -66,56 +68,49 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
generalOption
-т戎筝潟潟茵激с潟с (\-help\-options障 \-version)
+単独で使用する一般的なコマンド行オプションです (\-help、\-options、または \-version)。
.TP 3
outputOptions
-筝 \f2statOption\fP \-t\-h \-J 激с潟腟水1 ゃ障茲違阪激с潟с
+単一の \f2statOption\fP と、\-t、\-h、および \-J オプションのいずれかを組み合わせた、1 つまたは複数の出力オプションです。
.TP 3
vmid
-帥若蚊 Java 篁潟激 (JVM) 腓冴絖с篁潟激活ュс筝罕罨＜障
+ターゲットの Java 仮想マシン (JVM) を示す文字列である仮想マシン識別子です。一般的な構文は次のようになります。
.nf
\f3
.fl
[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
.fl
.fi
-vmid 絖罕紊чURI 罕絲上障\f2vmid\fP 若 JVM 茵膣贋違篆＜潟若垩割絎茖堺ゃ腓冴茲罕障с障障違障荅括完篁潟激活ュс
+vmid 文字列の構文の大部分は、URI の構文に対応しています。\f2vmid\fP は、ローカル JVM を表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、さまざまに異なります。詳細は、「仮想マシン識別子」を参照してください。
.TP 3
interval[s|ms]
-腱 (s) 障腱 (ms) ≧絎篏с泣潟潟育с篏腱с\ 罩ｃ贋違с違障\ 絎翫\f3jstat\fP interval 阪障
+秒 (s) またはミリ秒 (ms) のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数でなければなりません。これが指定された場合、\f3jstat\fP は interval ごとに出力を生成します。
.TP 3
count
-茵腓冴泣潟違сゃ♂с ゃ障\f3jstat\fP 帥若蚊 JVM 腟篋障с障 \f3jstat\fP 潟潟腟篋障с腟沿若帥茵腓冴障 罩ｃ贋医ゃ篏睡綽荀障
+表示するサンプル数です。デフォルト値は無限です。つまり、\f3jstat\fP は、ターゲット JVM が終了するまで、または \f3jstat\fP コマンドが終了するまで、統計データを表示します。正の整数でなければなりません。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jstat\fP 若荐臀 HotSpot Java 篁潟激 (JVM) 若潟合輝荐若帥茵腓冴障帥若蚊 JVM 篁潟激活ュゃ障筝荐 \f2vmid\fP 激с潟ｃ茘ャ障
+\f3jstat\fP ツールは、設置されている HotSpot Java 仮想マシン (JVM) のパフォーマンス統計データを表示します。ターゲット JVM は、仮想マシン識別子、つまり下記の \f2vmid\fP オプションによって識別されます。
.LP
.LP
-\f3羈\fP: 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注\fP: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.br
.LP
.SS
-篁潟激活ュ
-.LP
-.RS 3
-
+仮想マシン識別子
.LP
.LP
-\f2vmid\fP 絖罕紊чURI 罕絲上障
+\f2vmid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
@@ -128,79 +123,73 @@
.RS 3
.TP 3
protocol
-篆＜潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
+通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
lvmid
-帥若蚊 JVM 若篁潟激活ュс\f2lvmid\fP 激鴻筝 JVM 筝茘ャ若堺ゃс\f2lvmid\fP 篁潟激活ュ筝綽荀膣с\f2lvmid\fP 腟九障с障筝帥若蚊 JVM 祉鴻絲障若ｃ潟違激鴻祉壕ュсjps(1) 潟潟篏睡\f2lvmid\fP 絎с障障Unix 若с\f3ps\fP 潟潟篏睡Windows с Windows 帥鴻若吾ｃ若篏睡\f2lvmid\fP 絎с障
+ターゲット JVM のローカル仮想マシン識別子です。\f2lvmid\fP は、システム上の JVM を一意に識別するプラットフォーム固有の値です。\f2lvmid\fP は、仮想マシン識別子の唯一の必須要素です。\f2lvmid\fP は、絶対というわけではありませんが、一般的にはターゲット JVM プロセスに対するオペレーティングシステムのプロセス識別子です。jps(1) コマンドを使用して、\f2lvmid\fP を指定できます。また、Unix プラットフォームでは\f3ps\fP コマンドを使用して、Windows では Windows タスクマネージャーを使用して、\f2lvmid\fP を指定できます。
.TP 3
hostname
-帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
+ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
-≪若泣若若篆＜若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP ＜若帥宴絎茖ｃ違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
+リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
-＜若帥宴絎茖ｃ違障若潟翫ｃ若∴障\f3rmi\fP 潟翫＜若帥≪若鴻筝 RMI 純若鴻吾с腓冴障
+このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合は、このパラメータは、リモートホスト上の RMI リソースオブジェクトの名前を示します。
.RE
.LP
-.RE
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jstat\fP 潟潟筝激с潟阪激с潟 2 ゃ帥ゃ激с潟泣若障筝激с潟篏睡翫\f3jstat\fP 膂≦篏睡潟若吾с恰宴茵腓冴障阪激с潟с腟沿若水阪絎鴻綵√絎障
+\f3jstat\fP コマンドは、一般的なオプションと出力オプションの 2 つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fP は簡単な使用率およびバージョン情報を表示します。出力オプションでは、統計データ出力の内容と形式を指定します。
.br
.LP
.LP
-\f3羈\fP: 鴻激с潟罘純絨ャ若鴻у眼障綮罩≪醇с障
+\f3注\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。
.LP
.SS
-筝激с
+一般的なオプション
.LP
.LP
-筝激с潟絎翫篁激с潟障＜若帥筝絎с障
+いずれかの一般的なオプションを指定した場合、他のオプションまたはパラメータは一切指定できません。
.LP
.RS 3
.TP 3
\-help
-＜祉若吾茵腓冴障
+ヘルプメッセージを表示します。
.TP 3
\-version
-若吾с恰宴茵腓冴障
+バージョン情報を表示します。
.TP 3
\-options
-腟沿若帥激с潟筝荀ц；腓冴障筝荐阪激с潟膀с
+統計データオプションを一覧表示します。下記の「出力オプション」の節を参照してください。
.RE
.LP
.SS
-阪激с
-.LP
-.RS 3
-
+出力オプション
.LP
.LP
-筝激с潟絎翫阪激с潟絎с障阪激с潟\f3jstat\fP 阪絎鴻喝就綣絎筝 \f2statOption\fP 篁阪激с (\-h\-t \-J) ф障\ \f2statOption\fP 荐菴違綽荀障
+一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\f3jstat\fP の出力の内容および形式を指定し、単一の \f2statOption\fP と、他のいずれかの出力オプション (\-h、\-t、および \-J) とで構成されます。\f2statOption\fP は最初に記述する必要があります。
.LP
.LP
-阪腥榊純у阪若綵√ф障帥ゃ荐取茯荐障 \f3\-h\fP 激с潟篏睡若茵腓冴糸墾荐絎障\ 絽吾弱激с潟違ｃ翫с筝莢障筝2 ゃ激с潟у篏睡違2 ゃ若帥純若鴻障
+出力は、各列が空白で区切られたテーブルの形式で構成されます。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\f3\-h\fP オプションを使用します。列のヘッダー名は一般に、オプション間で一貫性が保たれています。一般に、2 つのオプションで同じ名前の列が使用されていれば、2 つの列のデータソースは同じになります。
.LP
.LP
-\f3\-t\fP 激с潟篏睡\f2Timestamp\fP 篁帥ゃ鴻帥潟阪茵腓冴障\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏ц；腓冴障帥ゃ鴻帥潟膕上墾障障荀ｃ違紊ч莢激ｃ激鴻с鴻鴻宴吾ャ若綮吟紊障
+\f3\-t\fP オプションを使用すると、 \f2Timestamp というラベルの付いたタイムスタンプの列が、\fP 出力の最初の列として表示されます。 \f2Timestamp\fP 列には、ターゲット JVM の起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、さまざまな要因によって異なり、大量の負荷のかかったシステムでのスレッドスケジュールの遅延により変動します。
.LP
.LP
-\f2interval\fP \f2count\fP ＜若帥篏睡\f3jstat\fP 阪茵腓冴糸墾違絎障
+\f2interval\fP および \f2count\fP パラメータを使用して、\f3jstat\fP がその出力を表示する頻度と回数をそれぞれ指定します。
.LP
.LP
-\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jstat\fP 阪茹ｆ鴻篏с障\f3jstat\fP 阪茹ｆ鴻篏翫若絨ャ若鴻с鴻紊眼違
+\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jstat\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jstat\fP 出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更しなければならないことに留意してください。
.LP
.RS 3
.TP 3
\-statOption
-\f3jstat\fP 茵腓冴腟沿若炊宴絎障罨＜茵純激с潟筝荀ц；腓冴障 劫若ゃ潟鴻若ゃ激с潟筝荀ц；腓冴筝激с潟 \f3\-options\fP 篏睡障
+\f3jstat\fP が表示する統計データ情報を指定します。次の表に、利用可能なオプションの一覧を示します。ある特定のプラットフォームインストールのオプションを一覧表示するには、一般的なオプションの \f3\-options\fP を使用します。
.br
.br
.LP
@@ -232,7 +221,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-鴻若若篏≪腟沿若
+クラスローダーの動作に関する統計データ
.br
.di
.nr a| \n(dn
@@ -248,7 +237,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HotSpot Just\-in\-Time 潟潟ゃ篏≪腟沿若
+HotSpot Just\-in\-Time コンパイラの動作に関する統計データ
.br
.di
.nr b| \n(dn
@@ -264,7 +253,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟若篏≪腟沿若
+ガベージコレクトされたヒープの動作に関する統計データ
.br
.di
.nr c| \n(dn
@@ -280,7 +269,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-筝篁ｃ絎拷絲上≪腟沿若
+世代ごとの容量と対応する領域に関する統計データ
.br
.di
.nr d| \n(dn
@@ -296,7 +285,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括輝荐若帥网荀 (\f3\-gcutil\fP ) 翫括憜 (純翫) 若吾潟激с潟ゃ潟
+ガベージコレクション統計データの概要 (\f3\-gcutil\fP と同じ) と、直前および現在 (適用可能な場合) のガベージコレクションイベントの原因
.br
.di
.nr e| \n(dn
@@ -312,7 +301,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ篏≪腟沿若
+New 世代の動作に関する統計データ
.br
.di
.nr f| \n(dn
@@ -328,7 +317,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ泣ゃ冴絲上≪腟沿若
+New 世代のサイズと対応する領域に関する統計データ
.br
.di
.nr g| \n(dn
@@ -344,7 +333,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ Permanent 筝篁ｃ篏≪腟沿若
+Old 世代および Permanent 世代の動作に関する統計データ
.br
.di
.nr h| \n(dn
@@ -360,7 +349,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ泣ゃ冴≪腟沿若
+Old 世代のサイズに関する統計データ
.br
.di
.nr i| \n(dn
@@ -376,7 +365,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ泣ゃ冴≪腟沿若
+Permanent 世代のサイズに関する統計データ
.br
.di
.nr j| \n(dn
@@ -392,7 +381,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括輝荐若帥网荀
+ガベージコレクション統計データの概要
.br
.di
.nr k| \n(dn
@@ -408,7 +397,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HotSpot 潟潟ゃ号腟沿若
+HotSpot コンパイル方法の統計データ
.br
.di
.nr l| \n(dn
@@ -419,7 +408,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wclass
.if \n(80<\n(38 .nr 80 \n(38
@@ -448,7 +437,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茵腓阪絎\fP
+.nr 38 \w\f3表示内容\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -486,7 +475,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 259 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 248 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -503,7 +492,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茵腓阪絎\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3表示内容\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -716,30 +705,26 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-52
.TP 3
\-h n
-\f2n\fP 泣潟 (阪茵) 若茵腓冴 \f2n\fP 罩ｃ贋医ゃゃ 0 若帥茵筝若茵腓冴
+\f2n\fP サンプル (出力行) ごとに列ヘッダーを表示。 ただし、\f2n\fP は正の整数値。デフォルト値は 0。 このとき、データの最初の行の上に列ヘッダーが表示される
.TP 3
\-t n
-帥ゃ鴻帥潟阪茵腓冴帥ゃ鴻帥潟帥若蚊 JVM 莎桁腟
+タイムスタンプ列を出力の最初の列として表示。タイムスタンプは、ターゲット JVM の起動時からの経過時間
.TP 3
-\-J javaOption
-\f2javaOption\fP \f3java\fP ≪宴若激с活儀若御検違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟絎鴻ゃjava(1)ャ＜潟с
+\-JjavaOption
+\f2javaOption\fP を \f3java\fP アプリケーション起動ツールへ渡す。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。オプションの完全なリストについては、「java(1)」のドキュメントを参照してください。
.RE
.LP
-.RE
.SS
-statOption 阪
-.LP
-.RS 3
-
+statOption と出力
.LP
.LP
-篁ラ茵с\f3jstat\fP \f2statOption\fP 阪ゃ网荀腓冴障
+以降の表では、\f3jstat\fP が \f2statOption\fP ごとに出力する列について概要を示します。
.br
.LP
.SS
-\-class 激с
+\-class オプション
.LP
.LP
.TS
@@ -770,7 +755,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若鴻
+ロードされたクラスの数
.br
.di
.nr a| \n(dn
@@ -786,7 +771,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若 K ゃ
+ロードされた K バイト数
.br
.di
.nr b| \n(dn
@@ -802,7 +787,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≪潟若鴻
+アンロードされたクラスの数
.br
.di
.nr c| \n(dn
@@ -818,7 +803,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≪潟若 K ゃ
+アンロードされた K バイト数
.br
.di
.nr d| \n(dn
@@ -834,7 +819,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-鴻若≪潟若荀
+クラスのロードやアンロード処理に要した時間
.br
.di
.nr e| \n(dn
@@ -845,9 +830,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w鴻若若腟沿若
+.nr 38 \wクラスローダーの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wLoaded
.if \n(80<\n(38 .nr 80 \n(38
@@ -862,7 +847,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -886,7 +871,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 313 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 298 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -903,11 +888,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'鴻若若腟沿若\h'|\n(41u'
+\&\h'|\n(40u'クラスローダーの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1002,7 +987,7 @@
.LP
.SS
-\-compiler 激с
+\-compiler オプション
.LP
.LP
.TS
@@ -1033,7 +1018,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎茵潟潟ゃ帥鴻
+実行されたコンパイルタスクの数
.br
.di
.nr a| \n(dn
@@ -1049,7 +1034,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊掩潟潟ゃ帥鴻
+失敗したコンパイルタスクの数
.br
.di
.nr b| \n(dn
@@ -1065,7 +1050,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-≦鴻潟潟ゃ帥鴻
+無効にされたコンパイルタスクの数
.br
.di
.nr c| \n(dn
@@ -1081,7 +1066,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ帥鴻絎茵荀
+コンパイルタスクの実行に要した時間
.br
.di
.nr d| \n(dn
@@ -1097,7 +1082,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇紊掩潟潟ゃ潟潟ゃ帥ゃ
+最後に失敗したコンパイルのコンパイルタイプ
.br
.di
.nr e| \n(dn
@@ -1113,7 +1098,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇紊掩潟潟ゃ劫＜純
+最後に失敗したコンパイルのクラス名とメソッド
.br
.di
.nr f| \n(dn
@@ -1124,9 +1109,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wHotSpot Just\-In\-Time 潟潟ゃ腟沿若
+.nr 38 \wHotSpot Just\-In\-Time コンパイラの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wCompiled
.if \n(80<\n(38 .nr 80 \n(38
@@ -1143,7 +1128,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -1169,7 +1154,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 349 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 334 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1186,11 +1171,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'HotSpot Just\-In\-Time 潟潟ゃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'HotSpot Just\-In\-Time コンパイラの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1302,7 +1287,7 @@
.LP
.SS
-\-gc 激с
+\-gc オプション
.LP
.LP
.TS
@@ -1333,7 +1318,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -1349,7 +1334,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr b| \n(dn
@@ -1365,7 +1350,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (KB)
+Survivor 領域 0 の使用率 (KB)
.br
.di
.nr c| \n(dn
@@ -1381,7 +1366,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (KB)
+Survivor 領域 1 の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -1397,7 +1382,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -1413,7 +1398,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (KB)
+Eden 領域の使用率 (KB)
.br
.di
.nr f| \n(dn
@@ -1429,7 +1414,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -1445,7 +1430,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (KB)
+Old 領域の使用率 (KB)
.br
.di
.nr h| \n(dn
@@ -1461,7 +1446,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -1477,7 +1462,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (KB)
+Permanent 領域の使用率 (KB)
.br
.di
.nr j| \n(dn
@@ -1493,7 +1478,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr k| \n(dn
@@ -1509,7 +1494,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr l| \n(dn
@@ -1525,7 +1510,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr m| \n(dn
@@ -1541,7 +1526,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr n| \n(dn
@@ -1552,9 +1537,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w若吾潟若腟沿若
+.nr 38 \wガベージコレクトされたヒープの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0C
.if \n(80<\n(38 .nr 80 \n(38
@@ -1589,9 +1574,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -1633,7 +1618,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 419 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 404 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1650,11 +1635,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'若吾潟若腟沿若\h'|\n(41u'
+\&\h'|\n(40u'ガベージコレクトされたヒープの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1850,7 +1835,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(m|u+\n(.Vu
.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -1906,7 +1891,7 @@
.LP
.SS
-\-gccapacity 激с
+\-gccapacity オプション
.LP
.LP
.TS
@@ -1937,7 +1922,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ絨鎘拷 (KB)
+New 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -1953,7 +1938,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ紊у拷 (KB)
+New 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -1969,7 +1954,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ憜絎拷 (KB)
+New 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -1985,7 +1970,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -2001,7 +1986,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -2017,7 +2002,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr f| \n(dn
@@ -2033,7 +2018,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ絨鎘拷 (KB)
+Old 世代の最小容量 (KB)
.br
.di
.nr g| \n(dn
@@ -2049,7 +2034,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ紊у拷 (KB)
+Old 世代の最大容量 (KB)
.br
.di
.nr h| \n(dn
@@ -2065,7 +2050,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ憜絎拷 (KB)
+Old 世代の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -2081,7 +2066,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr j| \n(dn
@@ -2097,7 +2082,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ絨鎘拷 (KB)
+Permanent 世代の最小容量 (KB)
.br
.di
.nr k| \n(dn
@@ -2113,7 +2098,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ紊у拷 (KB)
+Permanent 世代の最大容量 (KB)
.br
.di
.nr l| \n(dn
@@ -2129,7 +2114,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ憜絎拷 (KB)
+Permanent 世代の現在の容量 (KB)
.br
.di
.nr m| \n(dn
@@ -2145,7 +2130,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr n| \n(dn
@@ -2161,7 +2146,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr o| \n(dn
@@ -2172,9 +2157,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w＜≪若若筝篁ｃ渇絎拷
+.nr 38 \wメモリープール世代および領域容量
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wNGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -2211,9 +2196,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2257,7 +2242,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 493 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 478 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2274,11 +2259,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'＜≪若若筝篁ｃ渇絎拷\h'|\n(41u'
+\&\h'|\n(40u'メモリープール世代および領域容量\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -2522,7 +2507,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.fc
.nr T. 1
.T# 1
@@ -2547,10 +2532,10 @@
.LP
.SS
-\-gccause 激с
+\-gccause オプション
.LP
.LP
-激с潟\f3\-gcutil\fP 激с潟若吾潟激с括輝荐若帥网荀茵腓冴障緇若吾潟激с潟ゃ潟 (純翫) 憜若吾潟激с潟ゃ潟障障\f3\-gcutil\fP т荀ц；腓冴篁激с潟с罨＜菴遵障
+このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。
.LP
.LP
.TS
@@ -2581,7 +2566,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-緇若吾潟激с潟
+最後のガベージコレクションの原因
.br
.di
.nr a| \n(dn
@@ -2597,7 +2582,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-憜若吾潟激с潟
+現在のガベージコレクションの原因
.br
.di
.nr b| \n(dn
@@ -2608,9 +2593,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wGC ゃ潟若吾潟激с括輝荐若
+.nr 38 \wGC イベントを含むガベージコレクション統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wLGCC
.if \n(80<\n(38 .nr 80 \n(38
@@ -2619,7 +2604,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2637,7 +2622,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 516 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 501 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2654,11 +2639,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'GC ゃ潟若吾潟激с括輝荐若\h'|\n(41u'
+\&\h'|\n(40u'GC イベントを含むガベージコレクション統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -2702,7 +2687,7 @@
.LP
.SS
-\-gcnew 激с
+\-gcnew オプション
.LP
.LP
.TS
@@ -2733,7 +2718,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -2749,7 +2734,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr b| \n(dn
@@ -2765,7 +2750,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (KB)
+Survivor 領域 0 の使用率 (KB)
.br
.di
.nr c| \n(dn
@@ -2781,7 +2766,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (KB)
+Survivor 領域 1 の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -2797,7 +2782,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊ф水ャ
+最大殿堂入りしきい値
.br
.di
.nr e| \n(dn
@@ -2813,7 +2798,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
- Survivor 泣ゃ (KB)
+適切な Survivor サイズ (KB)
.br
.di
.nr f| \n(dn
@@ -2829,7 +2814,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -2845,7 +2830,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (KB)
+Eden 領域の使用率 (KB)
.br
.di
.nr h| \n(dn
@@ -2861,7 +2846,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr i| \n(dn
@@ -2877,7 +2862,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr j| \n(dn
@@ -2888,9 +2873,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wNew 筝篁ｃ腟沿若
+.nr 38 \wNew 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0C
.if \n(80<\n(38 .nr 80 \n(38
@@ -2917,9 +2902,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w罧水ャ
+.nr 38 \w殿堂入りしきい値
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -2953,7 +2938,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 570 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 555 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2970,11 +2955,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'New 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'New 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3042,7 +3027,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'TT\h'|\n(41u'罧水ャ
+\&\h'|\n(40u'TT\h'|\n(41u'殿堂入りしきい値
.ne \n(e|u+\n(.Vu
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3158,7 +3143,7 @@
.LP
.SS
-\-gcnewcapacity 激с
+\-gcnewcapacity オプション
.LP
.LP
.TS
@@ -3181,16 +3166,15 @@
.rm 80 81
.nr 34 \n(.lu
.eo
-.am 80
+.am 81
.br
.di a+
.35
.ft \n(.f
.ll \n(34u*1u/3u
-.if \n(.l<\n(80 .ll \n(80u
+.if \n(.l<\n(81 .ll \n(81u
.in 0
-NGCMN\ \ \ \ \ \ \ \ \ T}~T{
-New 筝篁ｃ絨鎘拷 (KB)
+New 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -3206,7 +3190,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ紊у拷 (KB)
+New 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -3222,7 +3206,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-New 筝篁ｃ憜絎拷 (KB)
+New 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -3238,7 +3222,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 紊у拷 (KB)
+Survivor 領域 0 の最大容量 (KB)
.br
.di
.nr d| \n(dn
@@ -3254,7 +3238,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 憜絎拷 (KB)
+Survivor 領域 0 の現在の容量 (KB)
.br
.di
.nr e| \n(dn
@@ -3270,7 +3254,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 紊у拷 (KB)
+Survivor 領域 1 の最大容量 (KB)
.br
.di
.nr f| \n(dn
@@ -3286,7 +3270,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 憜絎拷 (KB)
+Survivor 領域 1 の現在の容量 (KB)
.br
.di
.nr g| \n(dn
@@ -3302,7 +3286,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 紊у拷 (KB)
+Eden 領域の最大容量 (KB)
.br
.di
.nr h| \n(dn
@@ -3318,7 +3302,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 憜絎拷 (KB)
+Eden 領域の現在の容量 (KB)
.br
.di
.nr i| \n(dn
@@ -3334,7 +3318,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr j| \n(dn
@@ -3345,13 +3329,15 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wNew 筝篁ｉ泣ゃ冴腟沿若
+.nr 38 \wNew 世代領域サイズの統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGCMX \ \ \
+.nr 38 \wNGCMN
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGC \ \ \
+.nr 38 \wNGCMX
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \wNGC
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0CMX
.if \n(80<\n(38 .nr 80 \n(38
@@ -3371,15 +3357,15 @@
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
+.nr 38 \n(a-
+.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(b-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(c-
@@ -3408,7 +3394,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 626 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 609 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -3425,21 +3411,21 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'New 筝篁ｉ泣ゃ冴腟沿若\h'|\n(41u'
+\&\h'|\n(40u'New 世代領域サイズの統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'
+\&\h'|\n(40u'NGCMN\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
-.nr 37 \n(40u
+.nr 37 \n(41u
.in +\n(37u
.a+
.in -\n(37u
@@ -3451,7 +3437,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'NGCMX \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGCMX\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -3467,7 +3453,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'NGC \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGC\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -3593,7 +3579,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.fc
.nr T. 1
.T# 1
@@ -3609,11 +3595,11 @@
.rm i+
.rm j+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
.LP
.SS
-\-gcold 激с
+\-gcold オプション
.LP
.LP
.TS
@@ -3644,7 +3630,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr a| \n(dn
@@ -3660,7 +3646,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (KB)
+Permanent 領域の使用率 (KB)
.br
.di
.nr b| \n(dn
@@ -3676,7 +3662,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -3692,7 +3678,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (KB)
+Old 領域の使用率 (KB)
.br
.di
.nr d| \n(dn
@@ -3708,7 +3694,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -3724,7 +3710,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -3740,7 +3726,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -3751,9 +3737,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wOld Permanent 筝篁ｃ腟沿若
+.nr 38 \wOld および Permanent 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wPC
.if \n(80<\n(38 .nr 80 \n(38
@@ -3774,9 +3760,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -3804,7 +3790,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 668 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 651 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -3821,11 +3807,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Old Permanent 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Old および Permanent 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3909,7 +3895,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -3958,7 +3944,7 @@
.LP
.SS
-\-gcoldcapacity 激с
+\-gcoldcapacity オプション
.LP
.LP
.TS
@@ -3989,7 +3975,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ絨鎘拷 (KB)
+Old 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -4005,7 +3991,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ紊у拷 (KB)
+Old 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -4021,7 +4007,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 筝篁ｃ憜絎拷 (KB)
+Old 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -4037,7 +4023,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 憜絎拷 (KB)
+Old 領域の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -4053,7 +4039,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -4069,7 +4055,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -4085,7 +4071,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -4096,9 +4082,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wOld 筝篁ｃ腟沿若
+.nr 38 \wOld 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wOGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -4119,9 +4105,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4149,7 +4135,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 710 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 693 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4166,11 +4152,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Old 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Old 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4254,7 +4240,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4303,7 +4289,7 @@
.LP
.SS
-\-gcpermcapacity 激с
+\-gcpermcapacity オプション
.LP
.LP
.TS
@@ -4334,7 +4320,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ絨鎘拷 (KB)
+Permanent 世代の最小容量 (KB)
.br
.di
.nr a| \n(dn
@@ -4350,7 +4336,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ紊у拷 (KB)
+Permanent 世代の最大容量 (KB)
.br
.di
.nr b| \n(dn
@@ -4366,7 +4352,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 筝篁ｃ憜絎拷 (KB)
+Permanent 世代の現在の容量 (KB)
.br
.di
.nr c| \n(dn
@@ -4382,7 +4368,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 憜絎拷 (KB)
+Permanent 領域の現在の容量 (KB)
.br
.di
.nr d| \n(dn
@@ -4398,7 +4384,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr e| \n(dn
@@ -4414,7 +4400,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr f| \n(dn
@@ -4430,7 +4416,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr g| \n(dn
@@ -4441,9 +4427,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wPermanent 筝篁ｃ腟沿若
+.nr 38 \wPermanent 世代の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wPGCMN
.if \n(80<\n(38 .nr 80 \n(38
@@ -4464,9 +4450,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4494,7 +4480,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 752 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 735 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4511,11 +4497,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'Permanent 筝篁ｃ腟沿若\h'|\n(41u'
+\&\h'|\n(40u'Permanent 世代の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4599,7 +4585,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -4648,7 +4634,7 @@
.LP
.SS
-\-gcutil 激с
+\-gcutil オプション
.LP
.LP
.TS
@@ -4679,7 +4665,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 0 篏睡 (憜絎拷絲障若祉潟若)
+Survivor 領域 0 の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr a| \n(dn
@@ -4695,7 +4681,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Survivor 1 篏睡 (憜絎拷絲障若祉潟若)
+Survivor 領域 1 の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr b| \n(dn
@@ -4711,7 +4697,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Eden 篏睡 (憜絎拷絲障若祉潟若)
+Eden 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr c| \n(dn
@@ -4727,7 +4713,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Old 篏睡 (憜絎拷絲障若祉潟若)
+Old 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr d| \n(dn
@@ -4743,7 +4729,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-Permanent 篏睡 (憜絎拷絲障若祉潟若)
+Permanent 領域の使用率 (現在の容量に対するパーセンテージ)
.br
.di
.nr e| \n(dn
@@ -4759,7 +4745,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ GC ゃ潟
+若い世代の GC イベント数
.br
.di
.nr f| \n(dn
@@ -4775,7 +4761,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ャ筝篁ｃ若吾潟激с恰
+若い世代のガベージコレクション時間
.br
.di
.nr g| \n(dn
@@ -4791,7 +4777,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с恰
+フルガベージコレクション時間
.br
.di
.nr h| \n(dn
@@ -4807,7 +4793,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾潟激с括
+ガベージコレクション総時間
.br
.di
.nr i| \n(dn
@@ -4818,9 +4804,9 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w若吾潟激с括輝荐若帥网荀
+.nr 38 \wガベージコレクション統計データの概要
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wS0
.if \n(80<\n(38 .nr 80 \n(38
@@ -4845,9 +4831,9 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w GC ゃ潟
+.nr 38 \wフル GC イベント数
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -4879,7 +4865,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 802 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 785 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4896,11 +4882,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'若吾潟激с括輝荐若帥网荀\h'|\n(41u'
+\&\h'|\n(40u'ガベージコレクション統計データの概要\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5016,7 +5002,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
+\&\h'|\n(40u'FGC\h'|\n(41u'フル GC イベント数
.ne \n(h|u+\n(.Vu
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5067,7 +5053,7 @@
.LP
.SS
-\-printcompilation 激с
+\-printcompilation オプション
.LP
.LP
.TS
@@ -5098,7 +5084,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎茵潟潟ゃ帥鴻
+実行されたコンパイルタスクの数
.br
.di
.nr a| \n(dn
@@ -5114,7 +5100,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜純ゃ潟若ゃ
+メソッドのバイトコードのバイト数
.br
.di
.nr b| \n(dn
@@ -5130,7 +5116,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ号劫劫＜純劫с腥咲阪絖.с/篏睡＜純絎劫＜純с 2 ゃｃ若綵√HotSpot \- \f3XX:+PrintComplation\fP 激с潟絲上
+コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」の代わりに「/」が使用される。メソッド名は、指定されたクラス内のメソッドである。これらの 2 つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fP オプションと対応している
.br
.di
.nr c| \n(dn
@@ -5141,24 +5127,24 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \wHotSpot 潟潟ゃ号腟沿若
+.nr 38 \wHotSpot コンパイル方法の統計データ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f3\fP
+.nr 38 \w\f3列\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wCompiled
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w泣ゃ
+.nr 38 \wサイズ
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w
+.nr 38 \w型
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w＜純
+.nr 38 \wメソッド
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w潟潟ゃ帥ゃ
+.nr 38 \wコンパイルタイプ
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -5178,7 +5164,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 828 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 811 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -5195,11 +5181,11 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'HotSpot 潟潟ゃ号腟沿若\h'|\n(41u'
+\&\h'|\n(40u'HotSpot コンパイル方法の統計データ\h'|\n(41u'
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3列\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -5221,7 +5207,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'泣ゃ\h'|\n(41u'
+\&\h'|\n(40u'サイズ\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -5235,13 +5221,13 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'潟潟ゃ帥ゃ
+\&\h'|\n(40u'型\h'|\n(41u'コンパイルタイプ
.ne \n(c|u+\n(.Vu
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'＜純\h'|\n(41u'
+\&\h'|\n(40u'メソッド\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -5263,19 +5249,16 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
.LP
-.SS
-
-.LP
-.SH ""
+.SH "例"
.LP
.LP
-с21891 \f2lvmid\fP ゃ若 JVM ｈ箴腓冴障
+この項では、21891 の \f2lvmid\fP を持つローカル JVM を監視する例を示します。
.LP
.SS
-gcutil 激с潟篏睡
+gcutil オプションの使用
.LP
.LP
-箴\f2lvmid\fP 21891 ･膓250 腱 7 ゃ泣潟緇\f3\-gcutil\fP 激с潟с絎緇ｃ阪茵腓冴障
+この例は、\f2lvmid\fP 21891 に接続して、250 ミリ秒間隔で 7 つのサンプルを取得し、\f3\-gcutil\fP オプションでの指定に従って出力を表示します。
.LP
.nf
\f3
@@ -5320,13 +5303,13 @@
.LP
.LP
-箴阪ャ筝篁ｃ潟激с潟 3 4 泣潟ц腓冴障潟激с潟 0.001 腱ｃ吾с Eden (E) Old (O) 若Old 篏睡 9.49% 9.51% 紜障Survivor 潟激с喝 12.44% 篏睡障潟激с喝 7.74% 篏睡障
+この例の出力は、若い世代のコレクションが 3 番目と 4 番目のサンプル間で行われたことを示しています。コレクションには 0.001 秒かかっており、オブジェクトが Eden 領域 (E) から Old 領域 (O) に昇格したため、Old 領域の使用率は 9.49% から 9.51% に増加しています。Survivor 領域は、コレクション前は 12.44% が使用されていましたが、コレクション後は 7.74% しか使用されていません。
.LP
.SS
-惹絖膵違菴
+列ヘッダー文字列の繰り返し
.LP
.LP
-箴\f2lvmid\fP 21891 ･膓250 腱с泣潟緇\f3\-gcutil\fP 激с潟с絎緇ｃ阪茵腓冴障\f3\-h3\fP 激с潟篏睡若帥 3 茵茵腓冴若阪障
+この例は、\f2lvmid\fP 21891 に接続して、250 ミリ秒間隔でサンプルを取得し、\f3\-gcutil\fP オプションでの指定に従って出力を表示します。さらに、\f3\-h3\fP オプションを使用して、データが 3 行表示されるごとに列ヘッダーを出力します。
.LP
.nf
\f3
@@ -5379,16 +5362,16 @@
.LP
.LP
-箴с惹絖膵違菴荀祉2 3 泣潟 Young GC 茵障膓膓 0.001 腱с潟激с潟сSurvivor 0 篏睡 (S0U) Survivor 泣ゃ (DSS) 莇ゃ若帥罎冴障腟吾сOld 筝篁 (阪茵腓) 御若罧水ャ (TT) 31 2 檎若障
+この例では、ヘッダー文字列の繰り返しが見られるほかにも、2 番目と 3 番目のサンプル間で Young GC が行われたことがわかります。この継続時間は 0.001 秒でした。このコレクションでは、Survivor 領域 0 の使用率 (S0U) が適切な Survivor サイズ (DSS) を超過することになるライブデータが検出されました。この結果、オブジェクトは、Old 世代 (この出力には非表示) へ昇格され、殿堂入りしきい値 (TT) が、31 から 2 へ降格されました。
.LP
.LP
-ャ潟激с潟5 6 泣潟ц障潟激с潟сSurvivor 祉荀罧水ャゃ 31 祉障
+別のコレクションが、5 番目と 6 番目のサンプル間で行われています。このコレクションでは、Survivor がほとんど見られず、殿堂入りしきい値を 31 に戻しました。
.LP
.SS
-泣潟帥ゃ鴻帥潟水
+サンプルごとのタイムスタンプの挿入
.LP
.LP
-箴\f2lvmid\fP 21891 御･膓250 腱 3 ゃ泣潟緇障\f3\-t\fP 激с潟篏睡泣潟帥ゃ鴻帥潟茵腓冴障
+この例は、\f2lvmid\fP 21891 へ接続し、250 ミリ秒間隔で 3 つのサンプルを取得しています。\f3\-t\fP オプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。
.LP
.nf
\f3
@@ -5417,13 +5400,13 @@
.LP
.LP
-\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏с若障\f3\-gcoldcapacity\fP 阪с蚊綵荀羆障取羆筝≧鴻羣若≦宍Old 筝篁ｃ絎拷 (OGC) Old 絎拷 (OC) 紜障Old 筝篁ｃ絎拷 (OGC) 81 GC (FGC) 緇11696 KB 13820 KB 後障Old 筝篁 (渇) 紊у拷60544 KB (OGCMX) с障≦宍с篏茖罧障
+\f2Timestamp\fP 列には、ターゲット JVM の起動時からの経過時間が、秒単位でレポートされています。さらに、\f3\-gcoldcapacity\fP 出力では、割り当て要求または昇格要求あるいはその両方を満たすためにヒープが拡張するごとに、Old 世代の容量 (OGC) と Old 領域の容量 (OC) とが増加していることがわかります。Old 世代の容量 (OGC) は、81 番目のフル GC (FGC) 後に、11696 KB から 13820 KB へ増加しています。Old 世代 (および領域) の最大容量は、60544 KB (OGCMX) なので、まだ拡張できる余裕が残されています。
.LP
.SS
-≪若 JVM ゃ潟鴻ャ＜潟若激с潟ｈ
+リモート JVM のインストゥルメンテーションの監視
.LP
.LP
-箴\f3\-gcutil\fP 激с潟篏睡\f2remote.domain\fP 激鴻筝 \f2lvmid\fP 40496 ･膓泣潟腱篏х≧緇障
+この例は、\f3\-gcutil\fP オプションを使用して、\f2remote.domain\fP というシステム上の \f2lvmid\fP 40496 に接続し、サンプルを秒単位で無期限に取得しています。
.LP
.nf
\f3
@@ -5440,24 +5423,23 @@
.LP
.LP
-\f2lvmid\fP ≪若鴻腟\f240496@remote.domain\fP \f2vmid\fP 罕障腟 \f2vmid\fP \f3rmi\fP 潟篏睡≪若鴻筝 \f3jstatd\fP 泣若若篆＜障\f3jstatd\fP 泣若若\f3rmiregistry\fP 篏睡 \f3rmiregistry\fP 若 (若 1099) ゃ潟 \f2remote.domain\fP 臀障
+\f2lvmid\fP は、リモートホストの名前と結合されて、\f240496@remote.domain\fP の \f2vmid\fP を構成しています。結果として、この \f2vmid\fP は、\f3rmi\fP プロトコルを使用して、リモートホスト上のデフォルトの \f3jstatd\fP サーバーと通信します。\f3jstatd\fP サーバーは、\f3rmiregistry\fP を使用して、デフォルトの \f3rmiregistry\fP ポート (ポート 1099) にバインドされた \f2remote.domain\fP に配置されれます。
.LP
-.RE
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
+「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
-jstatd(1) \- 篁潟激 jstat 若≪潟
+「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
-rmiregistry(1) \- Java ≪若吾с吾鴻
+「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/jstatd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jstatd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,43 +19,41 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH jstatd 1 "02 Jun 2010"
+.TH jstatd 1 "14 Apr 2011"
.LP
-.SH ""
-jstatd \- 篁潟激 jstat 若≪
+.SH "名前"
+jstatd \- 仮想マシン jstat デーモン
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-＜若
+パラメータ
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-祉ャｃ
+セキュリティー
.TP 2
o
-≪若ゃ潟帥с若
+リモートインタフェース
.TP 2
o
-箴
+例
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -68,72 +66,64 @@
.fi
.LP
-.SH "＜若"
-.LP
-
+.SH "パラメータ"
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟激с潟篁紙綺ф絎с障茲障障激с潟翫緇絎激с潟障
+コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。
.RE
.LP
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f3jstatd\fP 若荐羝 HotSpot Java 篁潟激 (JVM) 篏腟篋ｈ若激鴻筝у茵 Java 篁潟激潟≪若ｈ若･膓сゃ潟帥с若鴻箴 RMI 泣若若≪宴若激с潟с
+\f3jstatd\fP ツールは、計測された HotSpot Java 仮想マシン (JVM) の作成と終了を監視し、ローカルシステム上で実行している Java 仮想マシンに、リモート監視ツールが接続できるようにするためのインタフェースを提供する RMI サーバーアプリケーションです。
.LP
.LP
-\f3jstatd\fP 泣若若с若鴻 RMI 吾鴻絖綽荀障\f3jstatd\fP 泣若若若障 \f2\-p port\fP 激с潟ф絎若筝 RMI 吾鴻･膓障RMI 吾鴻荀ゃ翫\f2\-p port\fP 激с潟ф絎若障 \f2\-p port\fP ャ翫 RMI 吾鴻ゃ潟 \f3jstatd\fP ≪宴若激с喝1 ゃ RMI 吾鴻篏障 RMI 吾鴻篏\f2\-nr\fP 激с潟絎ｃ胼罩≪с障
+\f3jstatd\fP サーバーでは、ローカルホストに RMI レジストリが存在することが必要になります。\f3jstatd\fP サーバーは、デフォルトポートまたは \f2\-p port\fP オプションで指定されたポート上の RMI レジストリに接続しようとします。RMI レジストリが見つからない場合、\f2\-p port\fP オプションで指定されたポート、または \f2\-p port\fP が省略されている場合は、デフォルト RMI レジストリにバインドされた \f3jstatd\fP アプリケーション内に、1 つの RMI レジストリが作成されます。内部 RMI レジストリの作成は、\f2\-nr\fP オプションを指定することによって禁止することができます。
.LP
.LP
-\f3羈:\fP 若ｃｃ若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
+\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.LP
-\f3jstatd\fP 潟潟罨＜激с潟泣若障
+\f3jstatd\fP コマンドは次のオプションをサポートしています。
.LP
.RS 3
.TP 3
\-nr
-√ RMI 吾鴻荀ゃ翫\f2jstatd\fP 祉劫 RMI 吾鴻篏障
+既存の RMI レジストリが見つからない場合、\f2jstatd\fP プロセス内に内部 RMI レジストリを作成しないようにします。
.TP 3
\-p\ port
-RMI 吾鴻篋潟若垩с 荀ゃ翫\f2\-nr\fP 絎遺障
+RMI レジストリがあると予想されるポート番号です。 見つからない場合は、\f2\-nr\fP が指定されていなければ作成されます。
.TP 3
\-n\ rminame
-RMI 吾鴻≪若 RMI 吾сゃ潟с \f2JStatRemoteHost\fP с茲違 \f3jstatd\fP 泣若若鴻筝ц儀翫泣若若鴻若 RMI 吾с激с潟絎ｃ筝с障激с潟篏睡翫ｈゃ≪潟 \f2hostid\fP \f2vmid\fP 絖筝泣若弱綽荀障
+RMI レジストリにおいて、リモート RMI オブジェクトがバインドされる名前です。デフォルト名は \f2JStatRemoteHost\fP です。複数の \f3jstatd\fP サーバーが同じホスト上で起動している場合、各サーバーのエクスポートした RMI オブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、監視クライアントの \f2hostid\fP および \f2vmid\fP 文字列に、その一意のサーバー名を含める必要があります。
.TP 3
\-Joption
-\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝＜障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
-.SH "祉ャｃ"
-.LP
-
+.SH "セキュリティー"
.LP
.LP
-\f3jstatd\fP 泣若若鴻ゃｃ≪祉号┤ JVM ｈс障ｃ\f3jstatd\fP 祉鴻帥若蚊 JVM 若吟取若у茵綽荀障筝若吟取若Unix(TM) 若鴻激鴻 \f2root\fP 若吟若激鴻筝篁紙 JVM ｃ鴻若ゃ潟鴻ャ＜潟若激с潟吾≪祉号┤ｃ障莖若у茵 \f3jstatd\fP 祉鴻激鴻筝鴻 JVM ｈс障祉ャｃ寂ャ馹莎激障
+\f3jstatd\fP サーバーは、有効なネイティブアクセス権を持つ JVM だけを監視できます。したがって、\f3jstatd\fP プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。一部のユーザー資格は、UNIX(TM) ベースのシステムにおける \f2root\fP ユーザーのように、システム上の任意の JVM によってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行している \f3jstatd\fP プロセスは、システム上のすべての JVM を監視できますが、セキュリティー上の別の問題が起こります。
+.LP
+.LP
+\f3jstatd\fP サーバーは、リモートクライアントの認証を一切与えません。そのため、\f3jstatd\fP サーバープロセスを実行すると、\f3jstatd\fP プロセスがアクセス権を持つすべての JVM によるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境的に望ましくない場合があります。 特に実稼働環境または安全でないネットワークでは、\f3jstatd\fP プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。
.LP
.LP
-\f3jstatd\fP 泣若若≪若ゃ≪潟茯荐若筝筝障\f3jstatd\fP 泣若若祉鴻絎茵\f3jstatd\fP 祉鴻≪祉号┤ゃ鴻 JVM ゃ潟鴻ャ＜潟若激с潟鴻若若筝鴻若吟若障♂峨倶医障翫障 鴻絎腮弱医障絎с若с\f3jstatd\fP 祉鴻莎桁若祉ャｃ若激若罎荐綽荀障
+\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の
+.na
+\f2ポリシーファイルの構文\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。
.LP
.LP
-\f3jstatd\fP 泣若若篁祉ャｃ若若吾ｃ若ゃ潟鴻若翫RMISecurityPolicy ゃ潟鴻帥潟鴻ゃ潟鴻若障 祉ャｃ若激若＜ゃ絎綽荀障激若＜ゃ激弱茖
-.na
-\f2激若＜ゃ罕\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html羣綽荀障
-.LP
-.LP
-罨＜激若＜ゃ翫\f3jstatd\fP 泣若若筝祉ャｃ寂紊篏睡絎茵с障激若鴻潟若若鴻吾≪祉号┤茯激若怨墾篏с\f3jstatd\fP 泣若若絎茵篏綽荀≪祉号┤茯激若怨墾蕭ｃ障
+次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。
.LP
.nf
\f3
@@ -155,7 +145,7 @@
.LP
.LP
-激若篏睡鴻 \f2jstatd.all.policy\fP ＜ゃ潟若罨＜ \f3jstatd\fP 泣若若絎茵障
+このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。
.LP
.nf
\f3
@@ -169,27 +159,23 @@
.LP
.LP
-ｳ祉ャｃ若絎純泣ゃ翫鴻帥激若＜ゃ篏睡劫篆♂若с鴻障若≪祉鴻狗с障 号IP ≪鴻贋紙障祉ャｃ若馹ゃ鴻帥ゃ冴激若＜ゃс絲上с翫\f3jstatd\fP 泣若若絎茵\f3jstat\fP \f3jps\fP 若若т戎ｃ絎号障
+より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。
.LP
-.SH "≪若ゃ潟帥с若"
-.LP
-
+.SH "リモートインタフェース"
.LP
.LP
-\f3jstatd\fP 祉鴻鴻若ゃ潟帥с若鴻冴с紊眼篋絎с若吟若渇肴ゃ潟帥с若鴻吾吾莨若帥茵с
+\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。
.LP
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-罨＜ \f3jstatd\fP 莎桁箴膣剛障\f3jstatd\fP 鴻ｃ泣若若違潟ц莎桁障
+次に \f3jstatd\fP を起動する例を紹介します。\f3jstatd\fP スクリプトによって、サーバーはバックグラウンドで自動的に起動します。
.LP
.SS
- RMI 吾鴻篏睡
+内部 RMI レジストリの使用
.LP
.LP
-箴 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障箴с RMI 吾鴻若 (若 1099) 篁泣若若ゃ潟喝障
+この例は、内部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。この例では、デフォルトの RMI レジストリポート (ポート 1099) には、他のサーバーはバインドされていないと想定しています。
.LP
.nf
\f3
@@ -201,10 +187,10 @@
.LP
.SS
-紊 RMI 吾鴻篏睡
+外部 RMI レジストリの使用
.LP
.LP
-箴紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -218,7 +204,7 @@
.LP
.LP
-箴若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -232,7 +218,7 @@
.LP
.LP
-箴AlternateJstatdServerName ゃ潟若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
+この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
@@ -246,10 +232,10 @@
.LP
.SS
-ゃ潟祉 RMI 吾鴻篏胼罩
+インプロセス RMI レジストリの作成の禁止
.LP
.LP
-箴RMI 吾鴻荀ゃ翫 RMI 吾鴻篏 \f3jstatd\fP 莎桁茵障箴сRMI 吾鴻с絎茵喝障絎茵翫荅峨若＜祉若吾茵腓冴障
+この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。
.LP
.nf
\f3
@@ -261,10 +247,10 @@
.LP
.SS
-RMI 井純劫
+RMI ログ機能の有効化
.LP
.LP
-箴RMI 井純鴻 \f3jstatd\fP 莎桁茵障号激ャ若ｃ潟違障泣若惹柑ｈ綵合＜障
+この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。
.LP
.nf
\f3
@@ -275,25 +261,25 @@
.fi
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-java(1) \- Java ≪宴若激с活儀若
+「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
-jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
+「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
-jstat(1) \- Java 篁潟激括輝荐若睡ｈ若
+「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
-
+「
.na
\f2rmiregistry\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java ≪若吾с吾鴻
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java リモートオブジェクトレジストリ」
.RE
.LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/jvisualvm.1 Wed Jul 05 17:42:56 2017 +0200
@@ -0,0 +1,126 @@
+." Copyright (c) 2008, 2010, 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.
+."
+.TH jvisualvm 1 "14 Apr 2011"
+
+.LP
+.SH "名前"
+\f2jvisualvm\fP \- Java 仮想マシンの監視、トラブルシューティング、およびプロファイリングツール
+.LP
+.RS 3
+.TP 2
+o
+形式
+.TP 2
+o
+パラメータ
+.TP 2
+o
+説明
+.TP 2
+o
+オプション
+.TP 2
+o
+使用方法
+.TP 2
+o
+関連項目
+.RE
+
+.LP
+.SH "形式"
+.LP
+.nf
+\f3
+.fl
+ \fP\f3jvisualvm\fP [ \f2options\fP ]
+.fl
+.fi
+
+.LP
+.SH "パラメータ"
+.LP
+.LP
+オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、このあとの「オプション」を参照してください。
+.LP
+.SH " 説明"
+.LP
+.LP
+Java VisualVM は、指定された Java 仮想マシン (JVM(*)) で Java テクノロジベースのアプリケーション (Java アプリケーション) が実行されているときに、その Java アプリケーションに関する詳細な情報を提供する直感的なグラフィカルユーザーインタフェースです。Java VisualVM という名前は、Java VisualVM が JVM ソフトウェアに関する情報を「視覚的に」提供するという事実に由来しています。
+.LP
+.LP
+Java VisualVM は、いくつかの監視、トラブルシューティング、およびプロファイリングユーティリティーを 1 つのツールに統合します。たとえば、スタンドアロンツール \f2jmap\fP、 \f2jinfo\fP、 \f2jstat\fP 、および \f2jstack\fP で提供されている機能のほとんどが、Java VisualVM に組み込まれています。JConsole ツールによって提供される一部の機能など、ほかの機能はオプションのプラグインとして追加できます。
+.LP
+.SH "オプション"
+.LP
+.LP
+次のオプションは、Java VisualVM を起動したときに実行可能になります。
+.LP
+.RS 3
+.TP 3
+\-J<jvm_option>\
+この \f2<jvm_option>\fP を JVM ソフトウェアに渡します。
+.RE
+
+.LP
+.SH "使用方法"
+.LP
+.LP
+Java VisualVM は、Java アプリケーションの開発者がアプリケーションのトラブルシューティングを行なったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVM を使用すると、開発者はヒープダンプの生成および解析、メモリーリークの特定、ガベージコレクションの実行および監視、およびメモリーと CPU の簡易プロファイリングの実行が可能になります。Java VisualVM の機能を拡張するプラグインもいくつかあります。たとえば、JConsole ツールのほとんどの機能は、MBeans タブおよび JConsole Plug\-in Wrapper プラグインを介して使用できます。標準の Java VisualVM プラグインのカタログから選択するには、Java VisualVM メニューの「ツール」>「プラグイン」を選択します。
+.LP
+.LP
+Java VisualVM を起動するには、次のコマンドを実行します。
+.LP
+.nf
+\f3
+.fl
+% jvisualvm \fP\f4<options>\fP\f3
+.fl
+\fP
+.fi
+
+.LP
+.SH "関連項目"
+.LP
+.LP
+Java VisualVM の詳細は、次のページを参照してください。
+.LP
+.RS 3
+.TP 2
+o
+.na
+\f2Java VisualVM 開発者のサイト\fP @
+.fi
+https://visualvm.dev.java.net
+.TP 2
+o
+.na
+\f2Java SE プラットフォームでの Java VisualVM のドキュメント\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/visualvm/index.html
+.RE
+
+.LP
+.LP
+\f2(* 「Java 仮想マシン」と「JVM」という用語は、Java プラットフォームの仮想マシンを意味しています。)\fP
+.LP
+
--- a/jdk/src/solaris/doc/sun/man/man1/ja/keytool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/keytool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1998-2010 keytool tool, 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
@@ -19,20 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH keytool 1 "02 Jun 2010"
+.TH keytool 1 "14 Apr 2011"
.LP
-.SH ""
-keytool \- 泣荐惹吾膊∞若
+.SH "名前"
+keytool \- 鍵と証明書の管理ツール
.LP
-.RS 3
-
.LP
-垸泣X.509 荐惹吾с若潟割拭若с荐惹吾若鴻 (若帥若) 膊∞障
-.RE
-.SH "綵√"
+暗号化鍵、X.509 証明書チェーン、および信頼できる証明書を含むキーストア (データベース) を管理します。
.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -43,48 +39,44 @@
.LP
.LP
-Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障 荅括完ゃ紊雁鴻膀с篁ュ絎臂潟潟綣膓泣若障
+Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。
.LP
-.SH "茯"
+.SH "説明"
.LP
-
+\f3keytool\fP は、鍵と証明書を管理するためのユーティリティーです。keytool を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザーまたはサービスに対して自分自身を認証すること) や、データの整合性と証明書に関するサービスを利用することができます。keytool では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。
.LP
-\f3keytool\fP 泣荐惹吾膊∞若ｃｃ若сkeytool 篏帥泣泣≪渇∫ｃ荐惹吾膊∞吾帥臀峨篏帥ｃ綏沿荐 (祉若吟若障泣若鴻絲障荳茯荐若) 若帥翫с荐惹吾≪泣若鴻с障keytool с篆∞御泣 (荐惹吾綵≪) ｃ激ャс障
-.LP
-荐惹吾潟ｃｃ (篋榊篌腓障) 吾帥臀峨篁吾с 荐惹吾祉潟ｃｃ若 (潟篁) 劫ャゃｃ吾障(荐惹吾)若帥吾帥臀峨篁翫吾帥臀峨罎荐若с若帥翫с潟若帥ссс障若帥翫с若帥紊眼劫潟障 障若帥с若帥若帥篏臀峨腱違篋榊絎羝＜若帥с潟障
+「証明書」とは、あるエンティティー (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティーの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「整合性」とは、データが変更されたり、改変されたりしていないことを意味します。 また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。
.LP
.LP
-障\f3keytool\fP 篏帥違DES 絲丞О垸/緇垸т戎腱絲泣膊∞с障
+また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。
.LP
.LP
-\f3keytool\fP 泣荐惹吾\f2若鴻≪\fP主障
+\f3keytool\fP は、鍵と証明書を\f2「キーストア」\fPに格納します。
.LP
-.SH "潟潟激с潟≪羈"
-.LP
-
+.SH "コマンドとオプションに関する注"
.LP
.LP
-篁ヤс潟潟激с潟ゃ茯障羈:
+以下では、コマンドとそのオプションについて説明します。注:
.LP
.RS 3
.TP 2
o
-潟潟潟激с喝ゃ壕 (\-) 篁
+どのコマンド名およびオプション名にも先頭にマイナス記号 (\-) が付く
.TP 2
o
-潟潟激с潟篁紙綺ф絎с
+各コマンドのオプションは任意の順序で指定できる
.TP 2
o
-ゃ帥篏ｃ鴻障筝綣с茹綣су蚊障鴻絎綽荀
+イタリック体になっていないすべての項目、または中括弧か角括弧で囲まれているすべての項目は、そのとおりに指定する必要がある
.TP 2
o
-激с潟蚊筝綣с筝激с潟潟潟茵ф絎ｃ翫ゃ篏帥潟筝綣с\f2\-v\fP\f2\-rfc\fP \f2\-J\fP 激с潟蚊篏帥激с潟潟潟茵ф絎翫炊潟 (ゃ障激с潟激с活篏絎篁ュゃ絖)
+オプションを囲む中括弧は、一般に、そのオプションをコマンド行で指定しなかった場合に、デフォルト値が使われることを意味する。中括弧は、 \f2\-v\fP、 \f2\-rfc\fP、および \f2\-J\fP オプションを囲むのにも使われるが、これらのオプションはコマンド行で指定された場合にのみ意味を持つ (つまり、これらのオプションには、オプション自体を指定しないこと以外に「デフォルト値」は存在しない)
.TP 2
o
-激с潟蚊茹綣с激с潟潟潟茵ф絎ｃ翫ゃュ羆潟\f2\-keypass\fP 激с潟潟潟茵ф絎ｃ翫\f3keytool\fP 若鴻≪鴻若/腱絲泣緇荅帥 若吟若荅帥紊掩翫/腱絲泣ュ羆
+オプションを囲む角括弧は、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味する。( \f2\-keypass\fP オプションの場合、オプションをコマンド行で指定しなかった場合は、\f3keytool\fP がまずキーストアのパスワードから非公開/秘密鍵の復元を試みる。 ユーザーは、この試みが失敗した場合に非公開/秘密鍵のパスワードの入力を求められる
.TP 2
o
-ゃ帥篏絎 (激с潟) 若吟若絎綽荀違\f2\-printcert\fP 潟潟綵√罨＜с
+イタリック体の項目の実際の値 (オプションの値) は、ユーザーが指定する必要があるたとえば、 \f2\-printcert\fP コマンドの形式は次のとおりである
.nf
\f3
.fl
@@ -93,7 +85,7 @@
\fP
.fi
.LP
-\f2\-printcert\fP 潟潟絎\f2cert_file\fP 篁ｃ絎＜ゃ絎罨＜箴腓冴
+\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。次に例を示す
.nf
\f3
.fl
@@ -103,10 +95,10 @@
.fi
.TP 2
o
-激с潟ゃ腥榊 (鴻若) 障翫ゃ綣膃у蚊綽荀
+オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある
.TP 2
o
-\f2\-help\fP 潟潟潟潟с違罨＜潟潟茵絎
+\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする
.nf
\f3
.fl
@@ -114,7 +106,8 @@
.fl
\fP
.fi
-罨＜絎с
+.LP
+これは、次のように指定することと同じです。
.nf
\f3
.fl
@@ -126,12 +119,11 @@
.LP
.SS
-激с潟
+オプションのデフォルト値
+.LP
.LP
-.RS 3
-
+オプションのデフォルト値は、次のとおりです。
.LP
-激с潟ゃ罨＜с
.nf
\f3
.fl
@@ -141,19 +133,25 @@
.fl
\-keyalg
.fl
- "DSA" (\fP\f3\-genkeypair\fP\f3 篏睡翫)
+ "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合)
.fl
- "DES" (\fP\f3\-genseckey\fP\f3 篏睡翫)
+ "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合)
.fl
.fl
\-keysize
.fl
- 1024 (\fP\f3\-genkeypair\fP\f3 篏睡翫)
+ 2048 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "RSA" の場合)
+.fl
+ 1024 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "DSA" の場合)
+.fl
+ 256 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "EC" の場合)
.fl
- 56 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DES" 翫)
+ 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合)
.fl
- 168 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DESede" 翫)
+ 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合)
+.fl
+
.fl
.fl
@@ -161,320 +159,933 @@
.fl
.fl
-\-keystore \fP\f4若吟若若ｃ \fP\f4.keystore\fP\f3 ＜ゃ\fP\f3
+\-keystore ユーザーのホームディレクトリの \fP\f4.keystore\fP\f3 というファイル
.fl
.fl
-\-storetype \fP\f4祉ャｃ若ｃ若＜ゃkeystore.typeｃ若ゃс
+\-storetype セキュリティープロパティーファイルの「keystore.type」プロパティーの値で、
.fl
- \fP\f4java.security.KeyStore\fP\f3 \fP\f4getDefaultType\fP\f3 ＜純菴\fP\f3
+ java.security.KeyStore の静的な getDefaultType メソッドから返される \fP\f4 \fP\f3
+.fl
+ \fP\f4 \fP\f3
.fl
.fl
-\-file \fP\f4茯粋昭帥翫罔羣ュ吾莨若帥翫罔羣阪\fP\f3
+\-file 読み込みの場合は標準入力、書き込みの場合は標準出力
.fl
.fl
\-protected false
.fl
-
-.fl
\fP
.fi
.LP
-/泣≪臀峨≪眼冴 (\f2\-sigalg\fP 激с) 冴泣≪眼冴羇丞障冴泣 DSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ SHA1withDSA 冴泣 RSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ MD5withRSA 障御純 \f2\-keyalg\fP \f2\-sigalg\fP 絎筝荀сゃ
-.na
-\f2Java Cryptography Architecture API Specification & Reference\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс
-.RE
-.SS
-筝激с
+.LP
+公開/非公開鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。
.LP
.RS 3
+.TP 2
+o
+基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションのデフォルト値は SHA1withDSA になり、
+.TP 2
+o
+基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withRSA になり、
+.TP 2
+o
+基になる非公開鍵が EC タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withECDSA になります。
+.RE
.LP
-\f2\-v\fP 激с潟\f2\-help\fP 潟潟ゃ鴻潟潟т戎с障激с潟絎翫潟潟激≪若у茵荅括完荐惹御宴阪障
.LP
-障\f2\-J\fP\f2javaoption\fP 激с潟篁紙潟潟т戎с障激с潟絎翫絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋･羝＜障激с潟腥榊純с障激с潟絎茵医障＜≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц；腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
+選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、
+.na
+\f2「Java Cryptography Architecture API Specification & Reference」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。
+.LP
+.SS
+一般オプション
.LP
.LP
-罨＜激с潟若鴻≪絲障篏茵鴻潟潟ф絎с障
+\f2\-v\fP オプションは、 \f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。
+.LP
+.LP
+また、 \f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。
+.LP
+.LP
+次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。
.LP
.RS 3
.TP 3
\-storetype storetype
-篆蕋上ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障
+.LP
+この修飾子は、インスタンスを生成するキーストアのタイプを指定します。
.TP 3
\-keystore keystore
-若鴻≪贋絎障
.LP
-劫 \f3keytool\fP 潟潟絎茵JKS 鴻≪帥ゃ篏睡ゃ若鴻≪＜ゃ障絖ｃ翫違若鴻≪＜ゃ篏障違\f2keytool \-genkeypair\fP 絎茵 \f2\-keystore\fP 激с潟絎ｃ翫\f2.keystore\fP 若鴻≪＜ゃ若吟若若ｃ障絖違篏障罕\f2\-keystore \fP\f2ks_file\fP 激с潟絎 \f2ks_file\fP 絖ｃ翫＜ゃ篏障
-.LP
-\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP ＜純羝＜障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP ＜純羝＜障\f2NONE\fP \f2KeyStore\fP ＜ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
-.TP 3
-\-storepass storepass
-若鴻≪翫с篆茘激篏帥鴻若絎障
-.LP
-\f2storepass\fP 6 絖篁ヤ綽荀障絎鴻若若鴻≪絎鴻≪祉鴻鴻潟潟т戎障腮潟潟絎茵潟潟茵 \f2\-storepass\fP 激с潟絎ｃ翫鴻若ュ羆障
-.LP
-若鴻≪宴冴翫鴻若ャс障 鴻若ャ冴宴翫сссс茘茵腓冴障
-.TP 3
-\-providerName provider_name
-祉ャｃ若ｃ若＜ゃ障垸泣若鴻ゃ劫篏睡障
-.TP 3
-\-providerClass provider_class_name
-垸泣若鴻ゃ祉ャｃ若ｃ若＜ゃ絎鴻帥若鴻＜ゃ絎篏帥障
-.TP 3
-\-providerArg provider_arg
-\f2\-providerClass\fP 腟水篏睡障\f2provider_class_name\fP 潟潟鴻帥絲障ュ純絖ュ綣違茵障
-.TP 3
-\-protected
-\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
-.RE
-
+キーストアの場所を指定します。
.LP
-.RE
-.SH "潟潟"
-.LP
-
-.LP
-.SS
-若鴻≪吾若帥篏障菴遵
-.LP
-.RS 3
-
+特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、 \f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、 \f2.keystore\fP という名前のデフォルトキーストアファイルがユーザーのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、 \f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。
.LP
-.RS 3
-.TP 3
-\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-泣 (泣渇∫ｃ) 障泣 X.509 v3 綏援讐荐惹吾с障 荐惹吾筝荀膣よ┝吾с若潟主障荐惹吾с若潟泣\f2alias\fP х劫違若鴻≪潟主障
-.LP
-\f2keyalg\fP 泣≪篏帥≪眼冴絎\f2keysize\fP 泣泣ゃ冴絎障 \f2sigalg\fP 綏援讐荐惹吾臀峨篁篏帥≪眼冴絎障≪眼冴\f2keyalg\fP 篋сс違障
-.LP
-\f2dname\fP \f2alias\fP ∫ｄ綏援讐荐惹吾 \f2issuer\fP ｃ若 \f2subject\fP ｃ若篏帥 X.500 茘ュ絎障潟潟茵цュ絎ｃ翫茘ュュ羆障
-.LP
-\f2keypass\fP 泣≪＜泣篆茘激篏帥鴻若絎障鴻若絎ｃ翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
-.LP
-\f2valDays\fP 荐惹吾号ユ違絎障
-.LP
-潟潟篁ュ若鴻с \f2\-genkey\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-genkeypair\fP 篏睡с障
+\f2\-keystore\fP オプションからの入力ストリームは、 \f2KeyStore.load\fP メソッドに渡されます。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではなく、たとえば、ハードウェアトークンデバイスに置かれている場合に指定します。
.TP 3
-\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-腱絲泣 \f2alias\fP х劫違 \f2KeyStore.SecretKeyEntry\fP 主障
-.LP
-\f2keyalg\fP 腱絲泣篏睡≪眼冴\f2keysize\fP 泣泣ゃ冴絎障\f2keypass\fP 腱絲泣篆茘激篏睡鴻若с鴻若絎ｃ翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
-.TP 3
-\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-＜ゃ \f2cert_file\fP 荐惹吾障荐惹吾с若 (荐惹吾с若潟翫PKCS#7 綵√綽膈ф箴) 茯粋昭帥\f2alias\fP ｃ劫若鴻≪潟主障＜ゃ絎翫罔羣ュ荐惹吾障 PKCS#7 綽膈茯粋昭帥障
-.LP
-\f3keytool\fP сX.509 v1v2v3 荐惹吾潟PKCS#7 綵√荐惹吾罕 PKCS#7 綵√荐惹吾с若潟ゃ潟若с障ゃ潟若若帥ゃ膃垸劫障阪順垸劫 (Base64 膃垸若違) ＜ф箴綽荀障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障膃垸劫翫荐惹吾\-\-\-\-\-BEGINу障絖ч紮\-\-\-\-\-ENDу障絖х篋違障
-.LP
-荐惹吾ゃ潟若罨＜ 2 ゃ障
-.RS 3
-.TP 3
-1.
-篆♂若с荐惹吾鴻荐惹吾菴遵
-.TP 3
-2.
-CA 荐惹悟讐荀羆 (\-certreq 潟潟) 篆＜腟CA ｃ荐惹綽膈ゃ潟若
-.RE
+\-storepass[:env|:file] argument
.LP
-＜腮蕁ゃ潟若茵\f2\-alias\fP 激с潟ゃｃ絎障
-.RS 3
-.TP 3
-1.
-\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障翫ュ若鴻√с絖障ュс絖翫ュ篆♂若с荐惹吾с絖с\f3keytool\fP 若阪荐惹吾ゃ潟若茵障
-.TP 3
-2.
-\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障
-.RE
-\f3違篆♂若с荐惹吾ゃ潟若\fP
-.RS 3
-
-.LP
-.LP
-\f3keytool\fP 若鴻≪荐惹吾菴遵若鴻√с絖篆♂若с荐惹吾篏帥ｃゃ潟若荐惹吾 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟罕膀荅帥障
+キーストアの整合性を保護するために使うパスワードを指定します。
.LP
-.LP
-\f2\-trustcacerts\fP 激с潟絎翫菴遵荐惹吾篆♂若с cacerts ＜ゃ障荐惹吾с若潟荀障
-.LP
-.LP
-\f3keytool\fP ゃ潟若荐惹吾綏援讐荐惹 (若鴻≪障 cacerts ＜ゃ障綏援讐荐惹) 潟障с篆♂若鴻罕膀紊掩翫ゃ潟若荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾ｃ潟若潟祉 (篆♂若с) 掩 (荐惹吾篋冴) ユｃ潟若潟罸莠障篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障荅括完篆♂若с荐惹吾ゃ潟若≪羈鋋сゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
-.LP
-.RE
-\f3荐惹綽膈ゃ潟若\fP
-.RS 3
-.LP
-荐惹綽膈ゃ潟若若鴻√篆♂若с荐惹吾 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪＜ゃф荐惹吾篏帥ｃ荐惹綽膈罎祉障
-.LP
-.LP
-荐惹綽膈篆♂若с羆阪号罨＜с
-.LP
+修飾子 \f2env\fP または \f2file\fP を指定しない場合、パスワードの値は \f2argument\fP になります。この値は、6 文字以上にする必要があります。それ以外の場合、パスワードは次のように取得されます。
.RS 3
.TP 2
o
-\f3荐惹綽膈筝 X.509 荐惹吾с翫\fP\f3keytool\fP 荐惹綽膈 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟腆榊荅帥障荐惹綽膈荐惹綽膈茯荐若篏帥荐惹吾絮ゆ\f2alias\fP 違荐惹吾с若潟綵∽障篆♂若с若潟腆榊翫荐惹綽膈ゃ潟若障翫\f3keytool\fP 荐惹吾阪若吟若罎荐若羆潟茵腓冴障 若吟若荐惹綽膈篆♂惹сゆ筝純с絽吾育ｃс
+\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する
.TP 2
o
-\f3荐惹綽膈 PKCS#7 綵√荐惹吾с若潟с翫\fP\f3keytool\fP 障с若潟筝号帥若吟若荐惹吾若 CA 綏援讐荐惹吾緇荐惹綽膈障若 CA 荐惹吾若鴻√障 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪＜ゃ篆♂若с荐惹吾鴻罸莠筝眼茯帥鴻障筝眼荀ゃｃ翫若 CA 荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾ｃ潟若潟祉 (篆♂若с) 掩 (若 CA 荳) ユｃ潟若潟罸莠障ゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
+\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する
+.RE
+.LP
+\f3注\fP: \f2\-keypass\fP、 \f2\-srckeypass\fP、 \f2\-destkeypass\fP \f2\-srcstorepass\fP、 \f2\-deststorepass\fP などのパスワードを必要とするその他のオプションはすべて、 \f2env\fP と \f2file\fP 修飾子を受け付けます。パスワードオプションと修飾子は、必ずコロン (\f2:\fP) で区切ってください。
+.LP
+パスワードは、キーストアの内容にアクセスするすべてのコマンドで使われます。この種のコマンドを実行するときに、コマンド行で \f2\-storepass\fP オプションを指定しなかった場合は、パスワードの入力を求められます。
+.LP
+キーストアから情報を取り出す場合は、パスワードを省略できます。 パスワードを省略すると、取り出す情報の整合性をチェックできないので、警告が表示されます。
+.TP 3
+\-providerName provider_name
+.LP
+セキュリティープロパティーファイル内に含まれる暗号化サービスプロバイダ名を特定するために使用されます。
+.TP 3
+\-providerClass provider_class_name
+.LP
+暗号化サービスプロバイダがセキュリティープロパティーファイルに指定されていないときは、そのマスタークラスファイルの名前を指定するときに使われます。
+.TP 3
+\-providerArg provider_arg
+.LP
+\f2\-providerClass\fP と組み合わせて使用します。\f2provider_class_name\fP のコンストラクタに対する省略可能な文字列入力引数を表します。
+.TP 3
+\-protected
+.LP
+\f2true\fP または \f2false\fP のいずれか。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
+.LP
+注: \f2\-importkeystore\fP コマンドには 2 つのキーストアが関係しているため、2 つのオプション、つまり \f2\-srcprotected\fP と \f2\-destprotected\fP がソースキーストアとターゲットキーストアにそれぞれ指定されます。
+.TP 3
+\-ext {name{:critical}{=value}}
+.LP
+X.509 証明書エクステンションを示します。このオプションを \-genkeypair および \-gencert で使用して、生成される証明書または \f2\-certreq\fP にエクステンションを埋め込み、証明書要求で要求されるエクステンションを示すことができます。このオプションは、複数回使用できます。name には、サポートされているエクステンション名 (下記を参照) または任意の OID 番号を指定できます。value を指定した場合は、エクステンションのパラメータを示します。省略した場合は、エクステンションのデフォルト値 (定義されている場合) を示すか、またはエクステンションにパラメータは必要ありません。 \f2:critical\fP 修飾子を指定した場合は、エクステンションの isCritical 属性が true であることを示します。それ以外の場合は false であることを示します。:critical の代わりに : \f2:c\fP を使用できます。 .
.RE
.LP
.LP
-荐惹後膈泣 \f2alias\fP 筝с主若吟若泣筝眼翫ゃ荐惹吾с若潟綽膈違荐惹吾с若潟х舟障篁ュ荐惹吾с若潟違荐惹吾с若潟х舟с鴻 \f2keypass\fPゃ障荅峨潟泣篆茘激鴻若絎翫с鴻若絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
-.LP
-.RE
+現在、keytool は次の名前のエクステンションをサポートしています (大文字と小文字は区別されない)。
.LP
-潟潟篁ュ若鴻с \f2\-import\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-importcert\fP 篏睡с障
-.TP 3
-\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
-.LP
-純若鴻若鴻≪帥若蚊若鴻≪吾筝潟障鴻潟ゃ潟若障
-.LP
-\f2srcalias\fP 激с潟絎翫潟潟ュх劫筝潟帥若蚊若鴻≪ゃ潟若障\f2destalias\fP 腟宴с帥若蚊ュ絎ｃ翫\f2srcalias\fP 帥若蚊ュ篏睡障純若鴻潟鴻若т茘激翫\f2srckeypass\fP 篏帥ｃ潟緇障\f2srckeypass\fP 絎ｃ翫\f3keytool\fP \f2srcstorepass\fP 篏帥ｃ潟緇障\f2srcstorepass\fP 絎ｃ罩ｃｃ翫若吟若鴻若ュ羆障帥若蚊潟 \f2destkeypass\fP ｃ篆茘激障\f2destkeypass\fP 絎ｃ翫帥若蚊潟純若鴻潟鴻若ｃ篆茘激障
.LP
-\f2srcalias\fP 激с潟絎ｃ翫純若鴻若鴻√鴻潟帥若蚊若鴻√ゃ潟若障帥若蚊潟絲上純若鴻潟ュ筝主障純若鴻潟鴻若т茘激翫\f2srcstorepass\fP 篏帥ｃ潟緇障\f2srcstorepass\fP 絎ｃ罩ｃｃ翫若吟若鴻若ュ羆障純若鴻若鴻√潟帥ゃ帥若蚊若鴻≪с泣若翫潟帥若蚊若鴻≪主若榊翫若吟若潟鴻膓茵筝御羆障帥若蚊潟純若鴻潟鴻若ｃ篆茘激障
-.LP
-帥若蚊ュ帥若蚊若鴻√с絖翫若吟若潟筝吾違ュ筝ф違潟篏御羆障
+.TS
+.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
+.de 35
+.ps \n(.s
+.vs \n(.vu
+.in \n(.iu
+.if \n(.u .fi
+.if \n(.j .ad
+.if \n(.j=0 .na
+..
+.nf
+.nr #~ 0
+.if n .nr #~ 0.6n
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.fc
+.nr 33 \n(.s
+.rm 80 81
+.nr 34 \n(.lu
+.eo
+.am 80
+.br
+.di a+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+BC または BasicConstraints
+.br
+.di
+.nr a| \n(dn
+.nr a- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di b+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+完全な形は「ca:{true|false}[,pathlen:<len>]」で、<len> は「ca:true,pathlen:<len>」の省略表記です。 省略すると、「ca:true」の意味になります
+.br
+.di
+.nr b| \n(dn
+.nr b- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di c+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+usage(,usage)*。usage には、digitalSignature、 nonRepudiation (contentCommitment)、keyEncipherment、dataEncipherment、keyAgreement、keyCertSign、cRLSign、encipherOnly、decipherOnly のいずれかを指定できます。Usage は、あいまいさがなければ、最初の数文字 (たとえば、digitalSignature を dig に) またはキャメルケーススタイル (たとえば、 digitalSignature を dS に、cRLSign を cRLS に) に 短縮できます。Usage の大文字と小文字は区別されません。
+.br
+.di
+.nr c| \n(dn
+.nr c- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di d+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+EKU または ExtendedkeyUsage
+.br
+.di
+.nr d| \n(dn
+.nr d- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di e+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+usage(,usage)*。usage には、anyExtendedKeyUsage、 serverAuth、clientAuth、codeSigning、emailProtection、 timeStamping、OCSPSigning、または任意の OID 文字列のいずれかを指定できます。 名前付きの usage は、あいまいさがなければ、 最初の数文字またはキャメルケーススタイルに 短縮できます。Usage の大文字と小文字は区別されません。
+.br
+.di
+.nr e| \n(dn
+.nr e- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di f+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+SAN または SubjectAlternativeName
+.br
+.di
+.nr f| \n(dn
+.nr f- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di g+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+type:value(,type:value)*。type には、EMAIL、URI、DNS、IP、または OID を指定できます。value は、type の文字列形式の値です。
+.br
+.di
+.nr g| \n(dn
+.nr g- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di h+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+IAN または IssuerAlternativeName
+.br
+.di
+.nr h| \n(dn
+.nr h- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di i+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+SubjectAlternativeName と同じです
+.br
+.di
+.nr i| \n(dn
+.nr i- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di j+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+SIA または SubjectInfoAccess
+.br
+.di
+.nr j| \n(dn
+.nr j- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di k+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+method:location\-type:location\-value (,method:location\-type:location\-value)*。 method には、「timeStamping」、「caRepository」、または任意の OID を指定できます。location\-type および location\-value には、SubjectAlternativeName エクステンションでサポートされる任意の type:value を指定できます。
+.br
+.di
+.nr k| \n(dn
+.nr k- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di l+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+AIA または AuthorityInfoAccess
+.br
+.di
+.nr l| \n(dn
+.nr l- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di m+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+SubjectInfoAccess と同じです。method には、「ocsp」、「caIssuers」、または任意の OID を指定できます。
+.br
+.di
+.nr m| \n(dn
+.nr m- \n(dl
+..
+.ec \
+.35
+.nf
+.ll \n(34u
+.nr 80 0
+.nr 38 \w\f3名前\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \wKU または KeyUsage
+.if \n(80<\n(38 .nr 80 \n(38
+.80
+.rm 80
+.nr 38 \n(a-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(d-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(f-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(h-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(j-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \n(l-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 81 0
+.nr 38 \w\f3値\fP
+.if \n(81<\n(38 .nr 81 \n(38
+.81
+.rm 81
+.nr 38 \n(b-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(c-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(e-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(g-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(i-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(k-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(m-
+.if \n(81<\n(38 .nr 81 \n(38
+.35
+.nf
+.ll \n(34u
+.nr 38 1n
+.nr 79 0
+.nr 40 \n(79+(0*\n(38)
+.nr 80 +\n(40
+.nr 41 \n(80+(3*\n(38)
+.nr 81 +\n(41
+.nr TW \n(81
+.if t .if \n(TW>\n(.li .tm Table at line 325 file Input is too wide - \n(TW units
+.fc
+.nr #T 0-1
+.nr #a 0-1
+.eo
+.de T#
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.mk ##
+.nr ## -1v
+.ls 1
+.ls
+..
+.ec
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3名前\fP\h'|\n(41u'\f3値\fP
+.ne \n(a|u+\n(.Vu
+.ne \n(b|u+\n(.Vu
+.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
+.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.a+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.b+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(c|u+\n(.Vu
+.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'KU または KeyUsage\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.c+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(d|u+\n(.Vu
+.ne \n(e|u+\n(.Vu
+.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
+.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.d+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.e+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(f|u+\n(.Vu
+.ne \n(g|u+\n(.Vu
+.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
+.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.f+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.g+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(h|u+\n(.Vu
+.ne \n(i|u+\n(.Vu
+.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
+.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.h+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.i+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(j|u+\n(.Vu
+.ne \n(k|u+\n(.Vu
+.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
+.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.j+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.k+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(l|u+\n(.Vu
+.ne \n(m|u+\n(.Vu
+.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
+.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.l+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.m+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.fc
+.nr T. 1
+.T# 1
+.35
+.rm a+
+.rm b+
+.rm c+
+.rm d+
+.rm e+
+.rm f+
+.rm g+
+.rm h+
+.rm i+
+.rm j+
+.rm k+
+.rm l+
+.rm m+
+.TE
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
+
.LP
-\f2\-noprompt\fP 絎翫若吟若違帥若蚊ュュ羆障√潟帥若蚊ュц筝吾障緇ゃ潟若с潟鴻茘阪障
-.RE
-.RE
+.LP
+OID 名の場合、OCTET STRING タイプと長さのバイトを除外したエクステンションについては、値は extnValue の HEX ダンプの DER エンコーディングです。HEX 文字列では、標準の HEX 数 (0\-9、a\-f、A\-F) 以外の文字は無視されます。したがって、 \f2「01:02:03:04」\fP と \f2「01020304」の両方とも\fP 同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。
+.LP
+.LP
+\f2\-gencert\fP でのみ使用する「honored」という特別な名前は、証明書要求に含まれるエクステンションを優先する方法を示します。この名前の値は、 \f2「all」\fP (要求されるすべてのエクステンションが優先される)、 \f2「name{:[critical|non\-critical]}」\fP (名前付きのエクステンションが優先されるが、別の isCritical 属性を使用する)、および \f2「\-name」\fP (「all」とともに使用し、例外を示す) のコンマ区切りリストです。デフォルトでは、要求されるエクステンションは優先されません。
+.LP
+.LP
+\-ext 優先のオプションに加え、別の名前の、または OID \-ext のオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前 (または OID) を優先される値でも使用した場合は、その値と重要性が要求に含まれるものをオーバーライドします。
+.LP
+.LP
+subjectKeyIdentifier エクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifier が常に作成されます。
+.LP
+.LP
+\f3注:\fP ユーザーは、エクステンション (および証明書のほかのフィールド) の組み合わせによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細については、「証明書の準拠に関する注意事項」を参照してください。
+.LP
+.SH "コマンド"
+.LP
.SS
-若帥鴻若
-.LP
-.RS 3
-
+キーストアへのデータの作成または追加
.LP
.RS 3
.TP 3
-\-certreq {\-alias alias} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+\-gencert {\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+証明書要求ファイル ( \f2keytool \-certreq\fP コマンドで作成できる) に応答して証明書を生成します。このコマンドは、\f2infile\fP から (省略した場合は、標準入力から) 要求を読み込み、別名の非公開鍵を使ってその要求に署名して、X.509 証明書を \f2outfile\fP に (省略した場合は、標準出力に) 出力します。 \f2\-rfc\fP を指定した場合、出力形式は BASE64 符号化の PEM になります。それ以外の場合は、バイナリ DER が作成されます。
+.LP
+\f2sigalg\fP には、証明書に署名を付けるときに使うアルゴリズムを指定します。\f2startdate\fP は、証明書が有効になる開始時刻/日付です。\f2valDays\fP には、証明書の有効日数を指定します。
+.LP
+\f2dname\fP を指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書要求からの名前が使用されます。
+.LP
+\f2ext\fP は、証明書に埋め込まれる X.509 エクステンションを示します。\-ext の文法については、「一般オプション」を参照してください。
+.LP
+\f2\-gencert\fP コマンドを使用すると、証明書チェーンを作成できます。次の例では、 \f2e1\fP という証明書を作成します。この証明書の証明書チェーンには、3 つの証明書が含まれています。
+.LP
+次のコマンドは、ca、ca1、ca2、および e1 の 4 つの鍵ペアを作成します。
+.nf
+\f3
+.fl
+keytool \-alias ca \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias ca1 \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias ca2 \-dname CN=CA \-genkeypair
+.fl
+keytool \-alias e1 \-dname CN=E1 \-genkeypair
+.fl
+\fP
+.fi
+.LP
+次の 2 つのコマンドは、署名付き証明書のチェーンを作成します。 \f2ca\fP は ca1 に署名し、 \f2ca1 signs ca2\fP に署名します。すべて自己発行です。
+.nf
+\f3
+.fl
+keytool \-alias ca1 \-certreq | keytool \-alias ca \-gencert \-ext san=dns:ca1 | keytool \-alias ca1 \-importcert
+.fl
+keytool \-alias ca2 \-certreq | $KT \-alias ca1 \-gencert \-ext san=dns:ca2 | $KT \-alias ca2 \-importcert
+.fl
+\fP
+.fi
.LP
-PKCS#10 綵√篏帥ｃ荐惹悟讐荀羆 (CSR) 障
+次のコマンドは、証明書 e1 を作成してファイル e1.cert に格納します。この証明書は ca2 によって署名されます。その結果、e1 の証明書チェーンには ca、ca1、および ca2 が含まれることになります。
+.nf
+\f3
+.fl
+keytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1.cert
+.fl
+\fP
+.fi
+.TP 3
+\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+鍵のペア (公開鍵および関連する非公開鍵) を生成します。公開鍵は X.509 v3 自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと非公開鍵は、\f2alias\fP で特定される新しいキーストアエントリに格納されます。
+.LP
+\f2keyalg\fP は鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fP は生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。
+.LP
+\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の issuer フィールドと subject フィールドとして使う X.500 識別名を指定します。 コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。
+.LP
+\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。
+.LP
+\f2startdate\fP には、証明書の発行時刻を指定します。これは、X.509 証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。
.LP
-CSR 荐惹悟肴絮 (CA) 篆＜сCA 荐惹梧羆 (絽吾ゃ潟) 茯荐若荐惹吾障荐惹吾с若潟菴障 荐惹吾障荐惹吾с若潟若鴻√√荐惹吾с若 ( 1 ゃ綏援讐荐惹吾罕) 臀篏帥障
+オプションの値は、次の 2 つの形式のいずれかで設定できます。
+.RS 3
+.TP 3
+1.
+([+\-]\f2nnn\fP[ymdHMS])+
+.TP 3
+2.
+[yyyy/mm/dd] [HH:MM:SS]
+.RE
+.LP
+最初の形式では、発行時刻は、指定される値だけ現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号 (「+」) は時間が進むことを、マイナス記号 (「\-」) は時間が戻ることを意味しています。移る時間は \f2nnn\fP で、単位は年、月、日、時間、分、または秒です (それぞれ、1 文字の「y」、「m」、「d」、「H」、「M」、または「S」で示されている)。下位の各値で \f2java.util.GregorianCalendar.add(int field, int amount)\fP メソッドを使うことで、発行時刻の追加の値が左から右へ計算されます。たとえば、 \f2「\-startdate \-1y+1m\-1d」\fPと指定すると、開始時刻は次のようになります。
+.nf
+\f3
+.fl
+ Calendar c = new GregorianCalendar();
+.fl
+ c.add(Calendar.YEAR, \-1);
+.fl
+ c.add(Calendar.MONTH, 1);
+.fl
+ c.add(Calendar.DATE, \-1);
+.fl
+ return c.getTime()
+.fl
+\fP
+.fi
+.LP
+2 番目の形式では、ユーザーは、年/月/日と時間:分:秒の 2 つの部分で厳密な開始時刻を設定します (地元の時間帯を使用)。ユーザーは、1 つの部分だけを指定できます。これは、もう 1 つの部分は現在の日付 (または時刻) と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります (短い場合は 0 で埋める)。日付と時刻の両方が指定された状態で、2 つの部分の間に空白文字が 1 つ (1 つだけ) あります。時間は常に 24 時間形式で指定してください。
+.LP
+オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で 1 回指定できます。
+.LP
+\f2valDays\fP には、証明書の有効日数を指定します ( \f2\-startdate\fP で指定された日付、または \f2\-startdate\fP が指定されていない場合は現在の日付から始まる)。
.LP
-\f2alias\fP ∫ｄ泣 X.500 茘ュPKCS#10 荐惹梧羆篏篏帥障泣若鴻√с鴻若ｃ篆茘激с泣≪祉鴻鴻若箴綽荀障潟潟茵 \f2keypass\fP 絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
+このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\fP を使用することをお勧めします。
+.TP 3
+\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+秘密鍵を生成し、それを新しい \f2KeyStore.SecretKeyEntry\fP (\f2alias\fP で特定される) 内に格納します。
+.LP
+\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。
+.TP 3
+\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+ファイル \f2cert_file\fP から証明書または証明書チェーン (証明書チェーンの場合は、PKCS#7 形式の応答または一連の X.509 証明書で提供されるもの) を読み込み、\f2alias\fP によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または証明書チェーンを読み込みます。
+.LP
+\f3keytool\fP では、X.509 v1、v2、v3 の証明書、および、PKCS#7 形式の証明書から構成されている PKCS#7 形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式 (Base64 符号化とも呼ばれる) のどちらかで提供する必要があります。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了しなければなりません。
.LP
-\f2sigalg\fP CSR 臀峨篁篏帥≪眼冴絎障
+証明書のインポートには、次の 2 つの目的があります。
+.RS 3
+.TP 3
+1.
+信頼できる証明書のリストに証明書を追加する
+.TP 3
+2.
+CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする
+.RE
+.LP
+どちらの種類のインポートを行うかは、 \f2\-alias\fP オプションの値によって指定します。
+.RS 3
+.TP 3
+1.
+\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内にすでに存在していてはいけません。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。
+.TP 3
+2.
+.LP
+\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。
+.RE
+\f3新しい信頼できる証明書のインポート\fP
+.LP
+\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼のチェーンの構築を試みます。
+.LP
+\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できるすなわち cacerts という名前のファイルに含まれる証明書のチェーンと見なされます。
+.LP
+\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかのなんらかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
+\f3証明応答のインポート\fP
+.LP
+「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\-trustcacerts オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。
.LP
-CSR ＜ゃ \f2certreq_file\fP 主障＜ゃ絎翫罔羣阪 CSR 阪障
+証明応答が信頼できるかどうかを決定する方法は次のとおりです。
+.RS 3
+.TP 2
+o
+\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。
+.TP 2
+o
+\f3証明応答が PKCS#7 形式の証明書チェーンまたは一連の X.509 証明書である場合\fP、チェーンは、ユーザーの証明書が最初に、0 以上の CA 証明書がその次にくるように並べられます。チェーンが自己署名のルート CA 証明書で終わり、 \f2\-trustcacerts\fP オプションが指定されている場合、\f3keytool\fP は、その証明書と、キーストア内または「cacerts」キーストアファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルート CA 証明書で終わっておらず、 \f2\-trustcacerts\fP オプションが指定されている場合、\f3keytool\fP は、キーストア内または「cacerts」キーストアファイル内の信頼できる証明書から自己署名のルート CA 証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、 \f2\-noprompt\fP オプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。
+.RE
+.LP
+証明書応答内の公開鍵が \f2alias\fP の下にすでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを新しい証明書チェーンで置き換えることができるのは、有効な \f2keypass\fP、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
+.LP
+このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。
+.TP 3
+\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+ソースキーストアからターゲットキーストアへ、単一のエントリまたはすべてのエントリをインポートします。
+.LP
+\f2srcalias\fP オプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲットキーストアにインポートします。\f2destalias\fP 経由でターゲット別名が指定されなかった場合、\f2srcalias\fP がターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\f2srckeypass\fP を使ってそのエントリが回復されます。\f2srckeypass\fP が指定されなかった場合、\f3keytool\fP は \f2srcstorepass\fP を使ってそのエントリを回復しようとします。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットエントリは \f2destkeypass\fP によって保護されます。\f2destkeypass\fP が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。
+.LP
+\f2srcalias\fP オプションが指定されなかった場合、ソースキーストア内のすべてのエントリがターゲットキーストア内にインポートされます。各ターゲットエントリは対応するソースエントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\f2srcstorepass\fP を使ってそのエントリが回復されます。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。
+.LP
+ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。
.LP
-CA 綽膈ゃ潟若\f2importcert\fP 潟潟篏帥障
+\f2\-noprompt\fP を指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。
+.TP 3
+\-printcertreq {\-file file}
+.LP
+PKCS #10 形式の証明書要求の内容を出力します。この要求は、keytool \-certreq コマンドで生成できます。このコマンドは、file から要求を読み込みます。file が省略されている場合は、標準入力から読み込みます。
+.RE
+
+.LP
+.SS
+データのエクスポート
+.LP
+.RS 3
+.TP 3
+\-certreq {\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
+.LP
+PKCS#10 形式を使って証明書署名要求 (CSR) を生成します。
+.LP
+CSR は、証明書発行局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明書チェーンを送り返します。 この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。
+.LP
+\f2alias\fP に関連付けられた非公開鍵は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。dname が指定されている場合は、それが CSR で主体として使用されます。それ以外の場合は、別名に関連付けられた X.500 識別名が使用されます。
+.LP
+\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。
+.LP
+CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。
+.LP
+CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。
.TP 3
\-exportcert {\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP ∫ｄ荐惹吾 (若鴻≪) 茯粋昭帥＜ゃ \f2cert_file\fP 主障
+\f2alias\fP に関連付けられた証明書を (キーストアから) 読み込み、ファイル \f2cert_file\fP に格納します。
.LP
-＜ゃ絎翫罔羣阪荐惹吾阪障
+ファイルが指定されていない場合は、標準出力に証明書が出力されます。
.LP
-сゃ膃垸劫荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\-rfc オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
.LP
-\f2alias\fP 篆♂若с荐惹吾с翫荅峨荐惹吾阪障篁ュ翫\f2alias\fP ∫ｄ荐惹吾с若潟ら泣潟с障翫с若喝荐惹吾菴障荐惹吾\f2alias\fP ｃ茵潟ｃｃ若泣茯荐若荐惹吾с
+\f2alias\fP が、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\f2alias\fP は、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\f2alias\fP によって表されるエンティティーの公開鍵を認証する証明書です。
.LP
-潟潟篁ュ若鴻с \f2\-export\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-exportcert\fP 篏睡с障
+このコマンドは、以前のリリースでは \f2\-export\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-exportcert\fP を使用することをお勧めします。
.RE
.LP
-.RE
.SS
-若帥茵腓
-.LP
-.RS 3
-
+データの表示
.LP
.RS 3
.TP 3
\-list {\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP х劫若鴻≪潟絎鴻 (罔羣阪) 阪障ュ絎翫若鴻√篏絎鴻茵腓冴障
+\f2alias\fP で特定されるキーストアエントリの内容を (標準出力に) 出力します。別名が指定されていない場合は、キーストア全体の内容が表示されます。
.LP
-潟潟с荐惹吾 MD5 ｃ潟若潟茵腓冴障\f2\-v\fP 激с潟絎翫肴激≪垩≦宍罘純篁宴篋咲茯с綵√ц┝吾茵腓冴障\f2\-rfc\fP 激с潟絎翫阪順垸劫ц┝吾絎鴻茵腓冴障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+このコマンドは、デフォルトでは証明書の SHA1 フィンガープリントを表示します。 \f2\-v\fP オプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。 \f2\-rfc\fP オプションが指定されている場合は、出力可能符号化方式で証明書の内容が表示されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
.LP
-\f2\-v\fP 激с潟 \f2\-rfc\fP 激с潟絎с障
+\f2\-v\fP オプションと \f2\-rfc\fP オプションを同時に指定することはできません。
.TP 3
-\-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
+\-printcert {\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}
+.LP
+ファイル \f2cert_file\fP、\f2host:port\fP にある SSL サーバー、または署名付き JAR ファイル \f2JAR_file\fP ( \f2\-jarfile\fP オプションを指定) から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準の HTTPS ポート 443 が想定されます。 \f2\-sslserver\fP および \f2\-file\fP オプションを同時に指定することはできません。同時に指定すると、エラーが報告されます。オプションが指定されていない場合は、標準入力から証明書を読み込みます。
.LP
-＜ゃ
+\f2\-rfc\fP が指定されている場合、keytool は、インターネット RFC 1421 標準で定義されているように、PEM モードで証明書を出力します。
+.LP
+ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネット RFC 1421 標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。
.LP
-ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
+SSL サーバーがファイアウォールの背後にある場合は、 \f2\-J\-Dhttps.proxyHost=proxyhost\fP と \f2\-J\-Dhttps.proxyPort=proxyport\fP をコマンド行で指定して、プロキシトンネリングを使用できます。詳細は、
+.na
+\f2「JSSE リファレンスガイド」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。
.LP
-羈:潟潟若鴻≪≫篏障
+\f3注\fP: このオプションはキーストアとは関係なく使用できます。
+.TP 3
+\-printcrl \-file crl_ {\-v}
+.LP
+ファイル \f2crl_file\fP から証明書の取り消しリスト (CRL) を読み込みます。
+.LP
+証明書の取り消しリスト (CRL) は、デジタル証明書を発行した証明書発行局 (CA) によって取り消されたデジタル証明書のリストです。CA は、\f2crl_file\fP を生成します。
+.LP
+\f3注\fP: このオプションはキーストアとは関係なく使用できます。
.RE
.LP
-.RE
.SS
-若鴻≪膊∞
-.LP
-.RS 3
-
+キーストアの管理
.LP
.RS 3
.TP 3
\-storepasswd [\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
.LP
-若鴻≪絎鴻翫с篆茘激篏帥鴻若紊眼障\f2new_storepass\fP 違鴻若絎障 \f2new_storepass\fP 6 絖篁ヤс違障
+キーストアの内容の整合性を保護するために使うパスワードを変更します。\f2new_storepass\fP には、新しいパスワードを指定します。new_storepass は、6 文字以上でなければなりません。
.TP 3
\-keypasswd {\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
.LP
-\f2alias\fP ｃ劫/腱絲泣篆茘激鴻若\f2old_keypass\fP \f2new_keypass\fP 紊眼障 \f2new_keypass\fP 6 絖篁ヤс違障
+\f2alias\fP によって特定される非公開/秘密鍵を保護するためのパスワードを、\f2old_keypass\fP から \f2new_keypass\fP に変更します。new_keypass は、6 文字以上でなければなりません。
.LP
-潟潟茵 \f2\-keypass\fP 激с潟絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
+コマンド行で \f2\-keypass\fP オプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。
.LP
-潟潟茵 \f2\-new\fP 激с潟絎ｃ翫違鴻若ュ羆障
+コマンド行で \f2\-new\fP オプションを指定しなかった場合は、新しいパスワードの入力を求められます。
.TP 3
\-delete [\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
.LP
-\f2alias\fP ｃ劫潟若鴻≪ゃ障潟潟茵уュ絎ｃ翫ュュ羆障
+\f2alias\fP によって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。
.TP 3
\-changealias {\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
.LP
-絎 \f2alias\fP 違ュ \f2destalias\fP 吾√若鴻≪潟腱糸障帥若蚊ュ絎ｃ翫潟潟ュ羆障潟潟鴻若т茘激翫\-keypass激с括宴с鴻若絎с障泣鴻若絎ｃ翫\f2storepass\fP (絎翫) 障荅帥障荅帥紊掩若吟若鴻若ュ羆障
+指定された \f2alias\fP から新しい別名 \f2destalias\fP へ、既存のキーストアエントリを移動します。ターゲット別名が指定されなかった場合、このコマンドはその入力を求めます。元のエントリがエントリパスワードで保護されていた場合、「\-keypass」オプション経由でそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\f2storepass\fP (指定された場合) がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。
.RE
.LP
-.RE
.SS
-茵腓
-.LP
-.RS 3
-
+ヘルプの表示
.LP
.RS 3
.TP 3
\-help
.LP
-堺潟潟激с潟筝荀с茵腓冴障
+基本的なコマンドとそのオプションの一覧を表示します。
+.LP
+特定のコマンドの詳細については、次のように入力してください。 \f2command_name\fP はコマンドの名前です。
+.nf
+\f3
+.fl
+ keytool \-\fP\f4command_name\fP\f3 \-help
+.fl
+\fP
+.fi
.RE
.LP
-.RE
-.SH "箴"
-.LP
-
+.SH "例"
.LP
.LP
-с泣≪割拭若с潟ｃｃ若荐惹吾膊∞若鴻≪篏翫箴腓冴障
+ここでは、自分の鍵のペアおよび信頼できるエンティティーからの証明書を管理するためのキーストアを作成する場合を例として示します。
.LP
.SS
-泣≪
-.LP
-.RS 3
-
+鍵のペアの生成
.LP
.LP
-障若鴻≪篏泣≪綽荀障罨＜腓冴絎茵潟潟箴с
+まず、キーストアを作成して鍵のペアを生成する必要があります。次に示すのは、実行するコマンドの例です。
.LP
.nf
\f3
.fl
- keytool \-genkeypair \-dname "cn=Mark Jones, ou=JavaSoft, o=Sun, c=US"
+ keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US"
.fl
\-alias business \-keypass kpi135 \-keystore /working/mykeystore
.fl
@@ -485,16 +1096,16 @@
.LP
.LP
-羈:潟潟 1 茵ュ違障箴ц域ュ茯帥с
+注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。
.LP
.LP
-箴сworking ｃ mykeystore 若鴻≪篏 (若鴻≪障絖篁絎)篏若鴻≪鴻若 ab987c 蚊綵障泣泣≪絲上潟ｃｃ若茘ュ腱違Mark Jones腟膵篏JavaSoft腟膵Sun2 絖順垩USс泣泣泣ゃ冴＜ 1024 с泣篏 DSA 窮≪眼冴篏睡障
+この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアにパスワード ab987c を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
.LP
.LP
-潟潟泣茘ュ宴綏援讐荐惹 ( SHA1withDSA 臀峨≪眼冴篏睡) 篏障荐惹吾号 180 ャс 荐惹吾ュbusinessх劫若鴻≪潟泣∫ｄ障泣鴻若kpi135蚊綵障
+このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵にはパスワード「kpi135」が割り当てられます。
.LP
.LP
-激с潟ゃ篏帥翫筝腓冴潟潟紊ус障絎激с潟 1 ゃ絎潟潟絎茵純с ゃゃ激с潟с激с潟絎違ゃ篏帥綽荀ゃゃュ羆障違罨＜ュс障
+オプションのデフォルト値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。 デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。
.LP
.nf
\f3
@@ -505,19 +1116,17 @@
.fi
.LP
-翫mykey ュс若鴻≪潟篏違泣≪ 90 ラ鴻荐惹吾潟主障潟若ｃ .keystore 若鴻≪臀障若鴻≪障絖翫篏障茘ュ宴若鴻≪鴻若渇泣鴻若ゃュ羆障
.LP
-篁ヤс激с潟絎 \f2\-genkeypair\fP 潟潟絎茵箴腓冴障 宴ュ羆翫腓冴 \f2\-genkeypair\fP 潟潟ゃュ障 (違泣鴻若 kpi135 絎)
-.LP
-.RE
-.SS
-荐惹悟肴絮絲障臀峨篁荐惹吾荀羆
-.LP
-.RS 3
-
+この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。
.LP
.LP
-憝鴻ф1 綏援讐荐惹吾с荐惹吾荐惹悟肴絮 (CA) 臀峨篁違祉若吟若荐惹吾篆♂若с醇с蕭障CA 臀峨緇障荐惹悟讐荀羆 (CSR) 障 違罨＜障
+以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、非公開鍵のパスワードには kpi135 と指定)。
+.LP
+.SS
+証明書発行局に対する署名付き証明書の要求
+.LP
+.LP
+現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に証明書発行局 (CA) の署名が付いていれば、ほかのユーザーから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。
.LP
.nf
\f3
@@ -528,41 +1137,39 @@
.fi
.LP
-CSR (ュmykeyｃ劫潟ｃｃ若 CSR) 篏MarkJ.csr ＜ゃ臀障＜ゃVeriSign CA 冴障 CA 荀羆 (絽吾ゃ潟) 茯荐若荀羆泣茯荐若臀峨篁荐惹吾菴障翫ｃCA 荐惹吾с若潟菴障 荐惹吾с若潟с荐惹吾с若喝臀峨泣茯荐若障
-.RE
+.LP
+CSR (デフォルト別名「mykey」によって特定されるエンティティーの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。
+.LP
.SS
-CA 荐惹吾ゃ潟若
-.LP
-.RS 3
-
+CA からの証明書のインポート
.LP
.LP
-篏綏援讐荐惹吾荐惹吾с若潟х舟綽荀障 荐惹吾с若潟с荐惹吾若CA 莎欠鴻с若喝罨＜荐惹吾臀峨泣茯荐若障
+作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CA を起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。
.LP
.LP
-CA 荐惹綽膈ゃ潟若若鴻≪(importcert 潟潟 ц) \f2cacerts\fP 若鴻≪＜ゃ 1 や札筝篆♂若с荐惹吾綽荀障
+CA からの証明応答をインポートするには、キーストアか、 \f2cacerts\fP キーストアファイル (importcert コマンドで説明) 内に 1 つ以上の「信頼できる証明書」がある必要があります。
.LP
.RS 3
.TP 2
o
-荐惹綽膈荐惹吾с若潟翫с若潟荐惹 ( CA 泣茯荐若若CA 荐惹) 綽荀
+証明応答が証明書チェーンの場合は、チェーンのトップの証明書 (その CA の公開鍵を認証する「ルート」CA の証明書) だけを必要とする
.TP 2
o
-荐惹綽膈筝荐惹吾翫荐惹吾臀峨 CA 肴荐惹吾綽荀с荐惹吾綏援讐翫荐惹吾臀峨荐惹吾綽荀 綏援讐若CA 荐惹吾障с荐惹吾綽荀
+証明応答が単一の証明書の場合は、証明書に署名した CA の発行用の証明書が必要で、その証明書が自己署名されない場合は、さらにその証明書の署名者用の証明書を必要とする。 このようにして自己署名される「ルート」CA の証明書までそれぞれ証明書を必要とする
.RE
.LP
.LP
-cacerts 若鴻≪＜ゃ5 ゃ VeriSign 若 CA 荐惹吾倶у肴激сVeriSign 荐惹吾篆♂若с荐惹吾若鴻√ゃ潟若綽荀障祉 CA 絲障臀峨篁荐惹吾荀羆 CA 泣茯荐若荐惹吾cacerts 障菴遵翫荅峨 CA 荐惹吾篆♂若с荐惹吾ゃ潟若綽荀障
+cacerts キーストアファイルは、いくつかの VeriSign ルート CA 証明書を含んだ状態で出荷されているので、VeriSign の証明書を、信頼できる証明書としてキーストア内にインポートする必要はないかもしれません。ただし、ほかの CA に対して署名付き証明書を要求していて、この CA の公開鍵を認証する証明書が、cacerts にまだ追加されていない場合は、該当する CA からの証明書を、「信頼できる証明書」としてインポートする必要があります。
.LP
.LP
-絽吾CA 荐惹吾綏援讐荐惹吾障祉 CA ｃ臀峨荐惹吾с (緇翫荅峨祉 CA 泣茯荐若荐惹吾綽荀)違ABC 篌罐 CA 障 CA 泣茯荐若綏援讐荐惹吾 ABCCA.cer ＜ゃABC ユ障
+通常、CA からの証明書は、自己署名証明書、またはほかの CA によって署名された証明書です (後者の場合は、該当するほかの CA の公開鍵を認証する証明書も必要)。たとえば、ABC という企業が CA だとします。このとき、この CA の公開鍵を認証する自己署名証明書と考えられる ABCCA.cer という名前のファイルを、ABC から入手したとします。
.LP
.LP
-篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障障荐惹吾絎鴻茵腓冴 (\f3keytool\fP \f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f3keytool\fP \f2\-importcert\fP 潟潟篏睡)茵腓冴荐惹吾ｃ潟若潟緇ｃ潟若潟筝眼腆肴障荐惹吾篆＜篋榊ｇ機篋榊腓冴 (障絎泣吾ｃ腓冴) ｃ潟若潟筝潟潟ц；腓冴ｃ潟若潟罸莠障ｃ潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙ｃ臀峨鴻篆♂若障
+「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。まず、証明書の内容を表示し (\f3keytool\fP \f2\-printcert\fP コマンドを使用するか、または \-noprompt オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。
.LP
.LP
-ABCCA.cer 鴻荐惹吾篆♂若翫荐惹吾若鴻≪菴遵с障 違罨＜障
+ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。
.LP
.nf
\f3
@@ -573,19 +1180,17 @@
.fi
.LP
-ABCCA.cer ＜ゃ若帥篆♂若с荐惹吾潟若鴻√篏荅峨潟 abc ュ蚊綵障
-.RE
+.LP
+ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。
+.LP
.SS
-CA 荐惹綽膈ゃ潟若
-.LP
-.RS 3
-
+CA からの証明応答のインポート
.LP
.LP
-荐惹悟讐荀羆阪 CA 泣茯荐若荐惹吾ゃ潟若 (障腮荐惹吾с cacerts ＜ゃ絖翫)荐惹綽膈ゃ潟若綏援讐荐惹吾荐惹吾с若潟х舟с障荐惹吾с若潟CA 綽膈с若潟翫荐惹悟讐荀羆絲障綽膈 CA 菴荐惹吾с若潟с 障CA 綽膈筝荐惹吾翫荐惹綽膈ゃ潟若若鴻√障 cacerts 若鴻≪＜ゃс絖篆♂若с荐惹吾篏帥ｃ罕膀荐惹吾с若潟с
+証明書署名要求の提出先の CA の公開鍵を認証する証明書をインポートしたあとは (または同種の証明書がすでに cacerts ファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。この証明書チェーンは、CA の応答がチェーンの場合、証明書署名要求に対する応答として CA から送り返された証明書チェーンです。 また、CA の応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または cacerts キーストアファイル内にすでに存在する信頼できる証明書とを使って構築した証明書チェーンです。
.LP
.LP
-違荐惹悟讐荀羆 VeriSign 篆＜障菴荐惹吾 VSMarkJ.cer 罨＜綽膈ゃ潟若с障
+たとえば、証明書署名要求を VeriSign に送信したとします。送り返された証明書の名前が VSMarkJ.cer だとすると、次のようにして応答をインポートできます。
.LP
.nf
\f3
@@ -594,18 +1199,16 @@
.fl
\fP
.fi
-.RE
.LP
.SS
-泣茯荐若荐惹吾鴻若
+公開鍵を認証する証明書のエクスポート
+.LP
.LP
-.RS 3
-
+たとえば、jarsigner(1) ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。
.LP
-違jarsigner(1) 篏帥ｃ Java ARchive (JAR) ＜ゃ臀峨障 JAR ＜ゃゃ≪潟ｃ篏帥障ゃ≪潟眼с臀峨茯荐若障
.LP
-ゃ≪潟臀峨茯荐若号 1 ゃ障泣荐惹吾篆♂若с潟ゃ≪潟若鴻≪ゃ潟若号障荐惹吾鴻若ゃ≪潟箴障違罨＜荐惹吾 \f2MJ.cer\fP ＜ゃ潟若障 潟mykeyュ篏帥障
+クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。このエントリには「mykey」という別名が使われているとします。
.LP
.nf
\f3
@@ -616,24 +1219,22 @@
.fi
.LP
-荐惹吾臀峨篁 JAR ＜ゃユゃ≪潟\f3jarsigner\fP 若篏帥ｃ臀峨茯荐若с障
-.RE
+.LP
+証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。
+.LP
.SS
-若鴻≪ゃ潟若
-.LP
-.RS 3
-
+キーストアのインポート
.LP
.LP
-潟潟importkeystore篏帥違若鴻≪篏ャ若鴻√ゃ潟若с障 泣荐惹吾ｃ純若鴻若鴻√鴻潟筝潟潟篏帥ｃ帥若蚊若鴻√ゃ潟若潟障潟潟篏帥違違帥ゃ若鴻√障潟ゃ潟若с障ゃ潟若帥若蚊若鴻√違潟鴻ュ (腱絲泣泣翫) 篆茘欠鴻若＜障純若鴻若鴻√泣腱絲泣緇馹榊翫\f3keytool\fP 若吟若鴻若ュ羆障潟潟ュ茲罎冴若吟若違ュュ羆障 若吟若違ュ絎膣√ュ筝吾 \f3keytool\fP 荐怨с障
+コマンド「importkeystore」を使えば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使ってターゲットキーストア内にインポートされることを意味します。このコマンドを使えば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲットキーストア内の新しいエントリはすべて、元と同じ別名および (秘密鍵や非公開鍵の場合は) 保護用パスワードを持ちます。ソースキーストア内の非公開鍵や秘密鍵の回復時に問題が発生した場合、\f3keytool\fP はユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを \f3keytool\fP に許可することもできます。
.LP
.LP
-違絽吾 JKS 帥ゃ若鴻 key.jks 潟 PKCS #11 帥ゃ若с≪若鴻若鴻√ゃ潟若罨＜潟潟篏睡с障
+たとえば、通常の JKS タイプのキーストア key.jks 内のエントリを PKCS #11 タイプのハードウェアベースのキーストア内にインポートするには、次のコマンドを使用できます。
.LP
.nf
\f3
.fl
-keytool \-importkeystore
+ keytool \-importkeystore
.fl
\-srckeystore key.jks \-destkeystore NONE
.fl
@@ -646,12 +1247,12 @@
.LP
.LP
-障importkeystore 潟潟篏帥違純若鴻若鴻√筝潟帥若蚊若鴻≪ゃ潟若с障翫筝荐箴хず激с潟ゃ潟若絲乗院ュ絎綽荀障srcalias 激с潟絎翫帥若蚊ュ潟潟茵絎с祉腱絲/泣篆茘欠鴻若帥若蚊篆茘欠鴻若絎с障違潟障ｃ頫腓冴 \f3keytool\fP 潟潟肴с障\f3keytool\fP 潟潟鴻＜ゃ絽吾箴水с 罨＜箴腓冴障
+また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。そうすれば、プロンプトのまったく表示されない \f3keytool\fP コマンドを発行できます。これは、\f3keytool\fP コマンドをスクリプトファイルに含める際に非常に便利です。次に例を示します。
.LP
.nf
\f3
.fl
-keytool \-importkeystore
+ keytool \-importkeystore
.fl
\-srckeystore key.jks \-destkeystore NONE
.fl
@@ -667,55 +1268,74 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.SH "茯茘"
-.LP
.LP
.SS
-若鴻
+一般的な SSL サーバー用の証明書の生成
+.LP
+.LP
+次に、3 つのエンティティー、つまりルート CA (root)、中間 CA (ca)、および SSL サーバー (server) 用の鍵ペアと証明書を生成する keytool コマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとして RSA を指定することをお勧めします。
.LP
-.RS 3
+.nf
+\f3
+.fl
+keytool \-genkeypair \-keystore root.jks \-alias root \-ext bc:c
+.fl
+keytool \-genkeypair \-keystore ca.jks \-alias ca \-ext bc:c
+.fl
+keytool \-genkeypair \-keystore server.jks \-alias server
+.fl
+
+.fl
+keytool \-keystore root.jks \-alias root \-exportcert \-rfc > root.pem
+.fl
+
+.fl
+keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore ca.jks \-certreq \-alias ca | keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore root.jks \-gencert \-alias root \-ext BC=0 \-rfc > ca.pem
+.fl
+keytool \-keystore ca.jks \-importcert \-alias ca \-file ca.pem
+.fl
+
+.fl
+keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore server.jks \-certreq \-alias server | keytool \-storepass \fP\f4<storepass>\fP\f3 \-keystore ca.jks \-gencert \-alias ca \-ext ku:c=dig,kE \-rfc > server.pem
+.fl
+cat root.pem ca.pem server.pem | keytool \-keystore server.jks \-importcert \-alias server
+.fl
+\fP
+.fi
.LP
-若鴻≪垸泣荐惹吾主罘純с
-.RE
+.SH "用語と警告"
+.LP
+.SS
+KeyStore
+.LP
+.LP
+キーストアは、暗号化の鍵と証明書を格納するための機能です。
+.LP
.RS 3
.TP 2
o
-.TP 2
-o
-\f3若鴻≪潟\fP
-.RS 3
-
+\f3キーストアのエントリ\fP
.LP
-若鴻≪違帥ゃ潟с障\f3keytool\fP сｃ膀蚊綺潟帥ゃ罨＜ 2 ゃс
+キーストアには異なるタイプのエントリを含めることができます。\f3keytool\fP でもっとも適用範囲の広いエントリタイプは、次の 2 つです。
.RS 3
.TP 3
1.
-\f3泣潟\fP \- 潟絽吾荀垸泣宴篆障宴荐怨≪祉鴻蚊篆茘激綵≪ф主障筝腮潟主泣腱絲泣絲上泣荐惹吾с若潟篌眼泣с\f3keytool\fP 筝≧鴻帥ゃ潟с絲障\f3jarsigner\fP 若緇帥ゃ潟ゃ障泣∫ｄ荐惹吾с若潟帥障
+\f3鍵のエントリ\fP \- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。 一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う非公開鍵です。\f3keytool\fP がこの両方のタイプのエントリを処理できるのに対し、\f3jarsigner\fP ツールは後者のタイプのエントリ、つまり非公開鍵とそれに関連付けられた証明書チェーンのみを処理します。
.TP 3
2.
-\f3篆♂若с荐惹吾潟\fP \- 潟膃筝笈┝吾 1 ゅс障荐惹吾篆♂若с荐惹吾若違障 荐惹後泣荐惹吾Subject() ｃ劫≪ゃ潟ｃｃ若掩ャс若鴻≪篆♂若с荐惹吾肴荐惹吾臀峨篁ｃ絎鴻篆荐若障
-.RE
-
-.LP
+\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を 1 つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。 それは、証明書内の公開鍵が、証明書の「Subject」(所有者) によって特定されるアイデンティティーに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。
.RE
.TP 2
o
-\f3若鴻≪ュ\fP
-.RS 3
+\f3キーストアの別名\fP
.LP
-若鴻≪鴻潟 (泣割拭若с荐惹) 筝ュ篁≪祉鴻障
-.LP
+キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。
.LP
-ュ絎\-genseckey 潟潟篏帥ｃ腱絲泣\-genkeypair 潟潟篏帥ｃ泣 (泣) \-importcert 潟潟篏帥ｃ荐惹吾障荐惹吾с若潟篆♂若с荐惹吾鴻菴遵劫潟ｃｃ若若鴻≪菴遵翫с篁ュ\f3keytool\fP 潟潟с潟ｃｃ若с翫絎ュ篏睡綽荀障
-.LP
+別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明書チェーンを信頼できる証明書のリストに追加したりするなど、特定のエンティティーをキーストアに追加する場合です。これ以後、\f3keytool\fP コマンドでエンティティーを参照する場合は、このときに指定した別名を使用する必要があります。
.LP
-違\f2duke\fP ュ篏帥ｃ違泣泣≪泣綏援讐荐惹 (荐惹吾с若潟) с障 翫罨＜潟潟絎茵障
-.LP
+たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明書チェーン」を参照) でラップするとします。 この場合は、次のコマンドを実行します。
.nf
\f3
.fl
@@ -723,9 +1343,8 @@
.fl
\fP
.fi
-
.LP
-с鴻若 dukekeypasswd 絎障 篁ュュ \f2duke\fP ∫ｄ泣≪祉鴻潟潟絎茵鴻若綽荀障duke 泣鴻若紊眼罨＜潟潟絎茵障
+ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 duke 連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。 duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。
.nf
\f3
.fl
@@ -733,49 +1352,37 @@
.fl
\fP
.fi
-
-.LP
-鴻若dukekeypasswd newpass 紊眼障
.LP
-羈 \-鴻翫障絎сｃ激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с綽荀鴻若激с潟潟潟茵ф絎ｃ翫鴻若ュ羆障
+パスワードが、dukekeypasswd から newpass に変更されます。
.LP
-.RE
+注: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
.TP 2
o
-\f3若鴻≪絎茖\fP
-.RS 3
-\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
+\f3キーストアの実装\fP
.LP
-憜\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若若鴻≪絎茖篏睡障\f2KeyStore\fP public 篏睡純сJDK 若吟若 \f2KeyStore\fP 篏帥ｃ祉祉ャｃ若≪宴若激с潟篏с障
-.LP
+\f2KeyStore\fP クラス ( \f2java.security\fP パッケージで提供される) には、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
.LP
-若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪＜ゃ絎茖障絎茖с泣ャ鴻若ｃ篆茘激若鴻√篏翫с (泣ャ) 鴻若ｃ篆茘激障
-.LP
+現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。 \f2KeyStore\fP は public として使用可能なので、JDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。
.LP
-若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface ＜純絎臂障 ＜純ゃ絎茖違障сゃJava Security API ｃ≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сｃ若鴻≪絎茖箴
-.na
-\f2Java(TM) 垸≪若ｃ主ゃ絎茖号\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
-.LP
+キーストアには、Oracle が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。
.LP
-≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance ＜＜純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√/腱絲泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
-.LP
+キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが、「プロバイダ」が実装する必要のある Service Provider Interface のメソッドを定義しています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、
+.na
+\f2「Java(TM) 暗号化アーキテクチャー用プロバイダの実装方法」\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
.LP
-\f3keytool\fP 篁紙＜ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝＜若鴻≪贋＜ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
-.LP
-.LP
-\f3keytool\fP \f3jarsigner\fP 翫\f2\-storetype\fP 激с潟篏帥ｃ潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP翫若鴻≪＜ャ若ｃ若鴻≪帥ゃ絎с障
-.LP
+アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。 キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。
.LP
-若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャｃ若ｃ若＜ゃф絎 \f2keystore.type\fP ｃ若ゃ冴ャ若鴻≪絎茖御障祉ャｃ若ｃ若＜ゃ\f2java.security\fP с祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
+\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
.LP
+\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fPの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。
.LP
-若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
-.LP
+キーストアのタイプを明示的に指定しない場合、keytool、jarsigner、および policytool の各ツールは、セキュリティープロパティーファイル内で指定された \f2keystore.type\fP プロパティーの値に基づいてキーストアの実装を選択します。セキュリティープロパティーファイルは、\f2java.security\fP という名前でセキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
.LP
-\f2KeyStore\fP 鴻с \f2getDefaultType\fP static ＜純絎臂≪宴若激с潟≪＜純篏帥 \f2keystore.type\fP ｃ若ゃ緇с障罨＜潟若若鴻≪帥ゃ (\f2keystore.type\fP ｃ若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
+各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
.LP
+\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ ( \f2keystore.type\fP プロパティーで指定されたタイプ) のインスタンスを生成します。
.nf
\f3
.fl
@@ -783,11 +1390,8 @@
.fl
\fP
.fi
-
.LP
-.LP
-若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャｃ若ｃ若＜ゃ罨＜茵ｃ絎障
-.LP
+デフォルトのキーストアタイプは JKS (Oracle が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。
.nf
\f3
.fl
@@ -795,14 +1399,10 @@
.fl
\fP
.fi
-
-.LP
.LP
-若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障
-.LP
+各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。
.LP
-違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨＜紊眼障
-.LP
+たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
.nf
\f3
.fl
@@ -810,561 +1410,163 @@
.fl
\fP
.fi
+.LP
+注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
+.RE
.LP
-羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
-.RE
-.RE
.SS
-荐惹
+証明書
.LP
-.RS 3
-
-.LP
-\f3荐惹\fP (\f3笈┝\fP若) 潟ｃｃ (肴) 吾帥臀峨篁吾с 荐惹吾祉潟ｃｃ (臀峨) (潟篁) 劫ャゃｃ吾障
-.RE
+\f3証明書\fP (\f3公開鍵証明書\fPとも呼ぶ) とは、あるエンティティー (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティー (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。
.RS 3
.TP 2
o
-.TP 2
-o
-\f3荐惹吾茯\fP
-.RS 3
-
-.LP
+\f3証明書の用語\fP
.RS 3
.TP 3
-
-泣劫潟ｃｃ若∫ｄ違с 泣荅峨潟ｃｃ若篆♂若с≫ゅ荀鴻篋冴絲障潟с泣臀峨罎荐若篏帥障
+公開鍵
+.LP
+公開鍵は、特定のエンティティーに関連付けられた数です。公開鍵は、該当するエンティティーとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。
.TP 3
-吾帥臀峨
-若帥\f2吾帥臀峨\fP若帥潟ｃｃ若≪ゃ潟ｃｃ若潟ｃｃ若若帥絎鴻ゃャｃ荐惹臀峨主障潟ｃｃ若泣篏帥ｃ若帥臀峨篁若帥初筝純障
+デジタル署名
+.LP
+データが「デジタル署名」されると、そのデータは、エンティティーの「アイデンティティー」と、そのエンティティーがデータの内容について知っていることを証明する署名とともに格納されます。エンティティーの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。
.TP 3
-≪ゃ潟ｃｃ
-潟ｃｃ若劫∝ャ号с激鴻ｃ泣≪ゃ潟ｃｃ若障 泣祉Unix UID 糸＜若≪鴻X.509 茘ュ障障≪ゃ潟ｃｃ若с障
+アイデンティティー
+.LP
+エンティティーを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティーにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティーとすることができます。
.TP 3
-臀峨
-臀峨若帥冴潟ｃｃ (臀峨 荐惹吾≪肴若違) 泣篏帥ｃ荐膊障
-.TP 3
-
-泣劫潟ｃｃ若ャｃ違с違潟ｃｃ若泣障泣祉ャ腱絲ｃ障 泣泣鴻究垸激鴻у障ｃ絖障DSA 後究垸激鴻翫1 ゃ泣罩ｇ∈ 1 ゃ泣絲上障泣臀峨荐膊篏帥障
+署名
+.LP
+署名は、なんらかのデータを基にエンティティー (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。
.TP 3
-潟ｃｃ
-潟潟ｃ若篋冴腟膵違潟潟ャ若帥篌罐茵筝絎綺т拭若絲乗院障障障
+非公開鍵
+.LP
+非公開鍵は特定のエンティティーだけが知っている数のことで、この数のことを、そのエンティティーの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。
+.TP 3
+エンティティー
+.LP
+エンテンティーは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。
.RE
-
.LP
-.LP
-究垸сц蟹筝若吟若泣≪祉鴻綽荀障紊ц閞＜若医с篋篆＜潟ｃｃ守т札≫綣膓腆榊篁絎篏帥鴻泣篆♂若с吾絖篁絎筝純с泣絽≪馹茹ｆ浦荐惹吾罅障憜с荐惹悟肴絮 (CA)篆♂若с膃筝罘純障CA 祉潟ｃｃ若荐惹吾臀峨 (肴) 茵冴篆♂若篁祉潟ｃｃ (篌罐) сCA 羈緇筝絅膣с鴻や拭若с荐惹吾篏宴障
+公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティー間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「証明書発行局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティーの証明書に署名する (発行する) 行為を、信頼して任されているエンティティー (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。
.na
\f2VeriSign\fP @
.fi
-http://www.verisign.com/
+http://www.verisign.com/、
.na
\f2Thawte\fP @
.fi
-http://www.thawte.com/
+http://www.thawte.com/、
.na
\f2Entrust\fP @
.fi
-http://www.entrust.com/ 紊 CA 絖障Netscape Microsoft 茯荐若泣若若Entrust CA 茖遵絮腟膵у違荐惹悟肴絮吟純с
-.LP
-.LP
-\f3keytool\fP 篏帥荐惹吾茵腓冴ゃ潟若潟鴻若茵с障障綏援讐荐惹吾с障
+http://www.entrust.com/ をはじめ、多くの CA が存在します。Microsoft の認証サーバー、Entrust の CA 製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。
.LP
+\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。
.LP
-憜\f3keytool\fP X.509 荐惹吾絲乗院障
-.LP
-.RE
+現在、\f3keytool\fP は X.509 証明書を対象にしています。
.TP 2
o
-\f3X.509 荐惹\fP
-.RS 3
-X.509 荀若с荐惹吾宴絎臂宴荐惹吾吾莨若号 (若水就綣) ゃ荐菴違障荐惹吾鴻若帥ASN.1/DER 若違 2 ゃ∫ｈ若篏帥ｃ膃垸障\f2Abstract Syntax Notation 1\fP 若帥ゃ荐菴違障\f2Definite Encoding Rules\fP 若帥篆絖活拶号ゃ荐菴違障
+\f3X.509 証明書\fP
.LP
-鴻 X.509 荐惹吾臀峨祉罨＜若帥с障
+X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。
.LP
+すべての X.509 証明書は、署名のほかに次のデータを含んでいます。
.RS 3
.TP 3
-若吾с
-荐惹吾 X.509 荀若若吾с潟劫障 荐惹吾絎с宴若吾с潟ｃ違障障с3 ゃ若吾с潟絎臂障\f3keytool\fP сv1v2 v3 荐惹吾ゃ潟若鴻若純сkeytool v3 荐惹吾с
+バージョン
.LP
-X.509 Version 11988 綛眼綺ｃ筝с
+証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。keytool が生成するのは、v3 の証明書です。
+.LP
+「X.509 Version 1」は、1988 年から利用されて広く普及しており、もっとも一般的です。
.LP
-X.509 Version 2сSubject 肴усSubject 肴筝顑ュ网綽泣絨ャ障祉荐惹吾＜ゃ吾с篏睡荐惹吾т茘ュ篏帥綣激ｨ絅障Version 2 荐惹吾綺篏帥障
+「X.509 Version 2」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。
.LP
-X.509 Version 3ｃ違 (1996 綛) 荀若с鴻潟激с潟网綽泣泣若障鴻潟激с潟茯違с絎臂с荐惹吾с障憜篏帥筝鴻潟激с潟KeyUsage (臀峨絨泣篏睡劫狗)AlternativeNames (DNS 糸＜若≪鴻IP ≪鴻祉≪ゃ潟ｃｃ若泣∫ｄс) 障鴻潟激с潟critical 若篁鴻潟激с潟с篏睡臂ャс障違critical 若KeyCertSign 荐絎 KeyUsage 鴻潟激с潟荐惹吾障翫荐惹吾 SSL 篆＞賢腓冴荐惹吾障 荐惹吾鴻潟激с潟ｃ∫ｃ泣荐惹吾臀峨絨絎SSL с篏睡сс
+「X.509 Version 3」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、KeyUsage (「署名専用」など、鍵の使用を特定の目的に制限する)、AlternativeNames (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティーを公開鍵に関連付けることができる) などがあります。エクステンションには、critical というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。
.TP 3
-激≪
-荐惹吾篏潟ｃｃ若潟ｃｃ若肴祉荐惹吾阪ャ荐惹吾激≪垩蚊綵障宴障障号т戎障 違荐惹吾羔激≪垩荐惹吾羔鴻 (CRL) 主障
+シリアル番号
+.LP
+証明書を作成したエンティティーは、そのエンティティーが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。
.TP 3
-臀峨≪眼冴茘ュ
-荐惹吾臀峨篁 CA 篏帥ｃ≪眼冴劫障
+署名アルゴリズム識別子
+.LP
+証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。
.TP 3
-肴
-荐惹吾臀峨篁潟ｃｃ若 X.500 茘ュс潟ｃｃ若絽吾 CA с荐惹吾篏帥荐惹吾臀峨篁潟ｃｃ若篆♂若潟障若ゃ障 CA 荐惹吾翫ｃ肴荳荐惹吾臀峨篁鴻羈
+発行者名
+.LP
+証明書に署名を付けたエンティティーの X.500 識別名です。エンティティーは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティーを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。
.TP 3
-号
-荐惹吾鴻障紮ユ腟篋ユｃ絎亥 100 綛眼傑障御号荐惹吾吾臀峨篏帥泣綣桁墾荐惹吾蕁障障荀х違障号篏睡泣翫潟ｃｃ若泣篆♂若с緇с
+有効期間
+.LP
+各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティーが公開鍵を信頼できると期待される期間です。
.TP 3
-Subject
-荐惹吾у泣茘ャ潟ｃｃ若с X.500 罔羣篏帥сゃ潟帥若篏т喝障潟ｃｃ若 X.500 茘ュ (DN) с 罨＜箴腓冴障
+Subject 名
+.LP
+証明書で公開鍵が識別されているエンティティーの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティーの X.500 識別名 (DN) です。次に例を示します。
.nf
\f3
.fl
- CN=Java Duke, OU=Java Software Division, O=Sun Microsystems Inc, C=US
+ CN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US
.fl
\fP
.fi
-筝私腱違腟膵篏腟膵純茵障
-.TP 3
-Subject 究
-篁潟ｃｃ若泣≪眼冴茘ュс ≪眼冴茘ュс泣絲障篏帥究垸激鴻渇∫ｃ泣＜若帥絎障
-.RE
-
-.LP
-.RE
-.TP 2
-o
-\f3荐惹吾с若\fP
-.RS 3
-.LP
-\f3keytool\fP с泣渇∫ｃ荐惹吾с若潟若鴻≪泣潟篏膊∞с障潟с泣絲上泣с若潟荐惹吾障障
-.LP
.LP
-泣篏 (\-genkeypair 潟潟)綏援讐荐惹吾 1 ゃ荀膣с若潟紮障綏援讐荐惹吾肴 (臀峨) 筝私 (荐惹吾ц荐若泣＞源) с荐惹吾с\f2\-genkeypair\fP 潟潟若喝冴違泣泣≪篏泣絽吾綏援讐荐惹吾с障
-.LP
-.LP
-荐惹悟讐荀羆 (CSR) (\-certreq 潟潟)CSR 荐惹悟肴絮 (CA) 篆＜CA 綽膈ゃ潟若 (\-importcert 潟潟)綏援讐荐惹吾荐惹吾с若潟ｃ臀障с若潟緇Subject 泣茯荐若 CA 肴荐惹 (綽膈) сс若喝荐惹吾CA泣茯荐若荐惹吾с
-.LP
-.LP
-CA 泣茯荐若荐惹吾紊翫綏援讐荐惹 (ゃ障 CA 荳泣茯荐若荐惹) сс若潟荐惹吾障翫ｃCA 荐惹吾с若潟菴障翫с若喝緇荐惹 (CA ｃ臀峨泣潟泣茯荐若荐惹) 紊障с若喝荐惹吾CSR 篆≦ CA ャCA ｃ臀峨CSR 篆≦ CA 泣茯荐若荐惹吾障с若喝荐惹吾罨＜ CA 泣茯荐若荐惹吾障 篁ヤ罕綏援讐若荐惹吾障сс若潟膓障ｃс若喝 (荐惹娯札緇) 荐惹吾сс若喝罨＜荐惹吾臀峨泣茯荐若障
-.LP
+これらはそれぞれ主体の通称、組織単位、組織、国を表します。
+.TP 3
+Subject の公開鍵情報
.LP
-紊 CA с若潟泣若肴羝帥荐惹吾菴障 鴻筝 CA 絖絮ゆ翫上蕁с翫若鴻≪с主篆♂若с荐惹御宴荐惹吾с若潟腆榊綽荀障
-.LP
-.LP
-ャ綽膈綵√ (PKCS#7 у臂綵√) с肴羝粋┝吾荐惹吾с若潟泣若障障\f3keytool\fP с＜綽膈綵√宴с障
-.LP
-.LP
- (若) CA 荐惹吾綏援讐荐惹吾с若泣絲障篆♂若若荐惹梧篏絨冴с (違VeriSign 若 CA 茘ュ篏帥ｃ綏援讐荐惹吾篏篏茯違с)域祉掩掩ャс若 CA 泣綺ャ障若 CA 泣荐惹吾主宴荐惹吾綵√у若с障 ゃ障荐惹吾若 CA 泣吟紵篏с若 CA 荐惹吾若鴻≪菴遵荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 激с潟篏睡)茵腓冴ｃ潟若潟域若 CA Web 若吾ユ∝ャｃ潟若潟罸莠綽荀障
-.LP
+名前を付けられたエンティティーの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。
.RE
.TP 2
o
-\f3cacerts 荐惹吾＜ゃ\fP
-.RS 3
+\f3証明書チェーン\fP
+.LP
+\f3keytool\fP では、非公開鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。
.LP
-\f3cacerts\fP 荐惹吾＜ゃ祉ャｃ若ｃ若ｃ \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医ｃ (SDK \f2jre\fP ｃ障 Java 2 Runtime Environment 筝篏ｃ) с
+鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含むチェーンが開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。 \f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。
.LP
-.LP
-cacerts ＜ゃCA 荐惹吾激鴻篏若鴻≪с激鴻膊∞若鴻≪帥ゃ jks 絎с\f3keytool\fP 篏帥ｃ＜ゃ罕膊∞茵с障cacerts 若鴻≪＜ゃ罨＜ュ X.500 茘ュゃゃ若 CA 荐惹吾倶у肴激障
+このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が証明書発行局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。チェーン内のその前の証明書は、「CA」の公開鍵を認証する証明書です。
.LP
-.RS 3
-.TP 2
-*
-\f3Alias\fP:thawtepersonalfreemailca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-freemail@thawte.com,
-.br
-CN=Thawte Personal Freemail CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepersonalbasicca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-basic@thawte.com,
-.br
-CN=Thawte Personal Basic CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepersonalpremiumca
-.br
-\f3Owner DN\fP:EmailAddress=personal\-premium@thawte.com,
-.br
-CN=Thawte Personal Premium CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawteserverca
-.br
-\f3Owner DN\fP:EmailAddress=server\-certs@thawte.com,
-.br
-CN=Thawte Server CA, OU=Certification Services Division,
-.br
-O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:thawtepremiumserverca
-.br
-\f3Owner DN\fP:EmailAddress=premium\-server@thawte.com,
-.br
-CN=Thawte Premium Server CA,
-.br
-OU=Certification Services Division,
-.br
-O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
-.TP 2
-*
-\f3Alias\fP:verisignclass1ca
-.br
-\f3Owner DN\fP:OU=Class 1 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2ca
-.br
-\f3Owner DN\fP:OU=Class 2 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3ca
-.br
-\f3Owner DN\fP:OU=Class 3 Public Primary Certification Authority,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignserverca
-.br
-\f3Owner DN\fP:OU=Secure Server Certification Authority,
-.br
-O="RSA Data Security, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass1g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 1 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass1g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 2 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass2g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
-.br
-OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3g2ca
-.br
-\f3Owner DN\fP:OU=VeriSign Trust Network,
-.br
-OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
-.br
-OU=Class 3 Public Primary Certification Authority \- G2,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:verisignclass3g3ca
-.br
-\f3Owner DN\fP:CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
-.br
-OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
-.br
-OU=VeriSign Trust Network,
-.br
-O="VeriSign, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:baltimorecodesigningca
-.br
-\f3Owner DN\fP:CN=Baltimore CyberTrust Code Signing Root,
-.br
-OU=CyberTrust, O=Baltimore, C=IE
-.TP 2
-*
-\f3Alias\fP:gtecybertrustglobalca
-.br
-\f3Owner DN\fP:CN=GTE CyberTrust Global Root,
-.br
-OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
-.TP 2
-*
-\f3Alias\fP:baltimorecybertrustca
-.br
-\f3Owner DN\fP:CN=Baltimore CyberTrust Root,
-.br
-OU=CyberTrust, O=Baltimore, C=IE
-.TP 2
-*
-\f3Alias\fP:gtecybertrust5ca
-.br
-\f3Owner DN\fP:CN=GTE CyberTrust Root 5,
-.br
-OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
-.TP 2
-*
-\f3Alias\fP:entrustclientca
-.br
-\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/Client_CA_Info/CPS incorp. by ref. limits liab.,
-.br
-O=Entrust.net, C=US
-.TP 2
-*
-\f3Alias\fP:entrustglobalclientca
-.br
-\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
-.br
-OU=(c) 2000 Entrust.net Limited,
-.br
-OU=www.entrust.net/GCCA_CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:entrust2048ca
-.br
-\f3Owner DN\fP:CN=Entrust.net Certification Authority (2048),
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:entrustsslca
-.br
-\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
-.br
-OU=(c) 1999 Entrust.net Limited,
-.br
-OU=www.entrust.net/CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net, C=US
-.TP 2
-*
-\f3Alias\fP:entrustgsslca
-.br
-\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
-.br
-OU=(c) 2000 Entrust.net Limited,
-.br
-OU=www.entrust.net/SSL_CPS incorp. by ref. (limits liab.),
-.br
-O=Entrust.net
-.TP 2
-*
-\f3Alias\fP:godaddyclass2ca
-.br
-\f3Owner DN\fP:OU=Go Daddy Class 2 Certification Authority,
-.br
-O="The Go Daddy Group, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:starfieldclass2ca
-.br
-\f3Owner DN\fP:OU=Starfield Class 2 Certification Authority,
-.br
-O="Starfield Technologies, Inc.", C=US
-.TP 2
-*
-\f3Alias\fP:valicertclass2ca
-.br
-\f3Owner DN\fP:EMAILADDRESS=info@valicert.com,
-.br
-CN=http://www.valicert.com/,
-.br
-OU=ValiCert Class 2 Policy Validation Authority,
-.br
-O="ValiCert, Inc.", L=ValiCert Validation Network
-.TP 2
-*
-\f3Alias\fP:geotrustglobalca
-.br
-\f3Owner DN\fP:CN=GeoTrust Global CA,
-.br
-O=GeoTrust Inc., C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureca
-.br
-\f3Owner DN\fP:OU=Equifax Secure Certificate Authority,
-.br
-O=Equifax, C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureebusinessca1
-.br
-\f3Owner DN\fP:CN=Equifax Secure eBusiness CA\-1,
-.br
-O=Equifax Secure Inc., C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureebusinessca2
-.br
-\f3Owner DN\fP:OU=Equifax Secure eBusiness CA\-2,
-.br
-O=Equifax Secure, C=US
-.TP 2
-*
-\f3Alias\fP:equifaxsecureglobalebusinessca1
-.br
-\f3Owner DN\fP:CN=Equifax Secure Global eBusiness CA\-1,
-.br
-O=Equifax Secure Inc., C=US
-.TP 2
-*
-\f3Alias\fP:soneraclass1ca
-.br
-\f3Owner DN\fP:CN=Sonera Class1 CA, O=Sonera, C=FI
-.TP 2
-*
-\f3Alias\fP:soneraclass2ca
-.br
-\f3Owner DN\fP:CN=Sonera Class2 CA, O=Sonera, C=FI
-.TP 2
-*
-\f3Alias\fP:comodoaaaca
-.br
-\f3Owner DN\fP:CN=AAA Certificate Services,
-.br
-O=Comodo CA Limited, L=Salford, ST=Greater Manchester, C=GB
-.TP 2
-*
-\f3Alias\fP:addtrustclass1ca
-.br
-\f3Owner DN\fP:CN=AddTrust Class 1 CA Root,
-.br
-OU=AddTrust TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:addtrustexternalca
-.br
-\f3Owner DN\fP:CN=AddTrust External CA Root,
-.br
-OU=AddTrust External TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:addtrustqualifiedca
-.br
-\f3Owner DN\fP:CN=AddTrust Qualified CA Root,
-.br
-OU=AddTrust TTP Network, O=AddTrust AB, C=SE
-.TP 2
-*
-\f3Alias\fP:utnuserfirsthardwareca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Hardware,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utnuserfirstclientauthemailca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Client Authentication and Email,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utndatacorpsgcca
-.br
-\f3Owner DN\fP:CN=UTN \- DATACorp SGC,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.TP 2
-*
-\f3Alias\fP:utnuserfirstobjectca
-.br
-\f3Owner DN\fP:CN=UTN\-USERFirst\-Object,
-.br
-OU=http://www.usertrust.com, O=The USERTRUST Network,
-.br
-L=Salt Lake City, ST=UT, C=US
-.RE
-
+CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これはチェーンの最初の証明書になります。場合によっては、CA が証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、チェーン内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次の CA の鍵を認証する証明書になります。 以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の (最初の証明書以後の) 各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。
+.LP
+多くの CA は、チェーンをサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。
.LP
-.LP
-cacerts 若鴻≪＜ゃ鴻若changeit с激鴻膊∞SDK ゃ潟鴻若緇＜ゃ鴻若≪祉号┤紊眼綽荀障
-.LP
-.RS 3
-
-.LP
-
+別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。
.LP
-\f3荀:\fP\f4cacerts\fP\f3 ＜ゃ腆肴\fP
-.br
-
-.LP
-\f2cacerts\fP ＜ゃ CA 臀峨割潟ｃｃ若吾荐惹悟肴潟ｃｃ若篆♂若\f2cacerts\fP ＜ゃ膊∞茵綽荀障\f2cacerts\fP ＜ゃ篆♂若 CA 荐惹吾障違障若吟若荳莢篁祉\f2cacerts\fP ＜ゃ潟篆♂若с若 CA 荐惹吾罎荐若篆♂惹с≪羆阪茵障篆♂若с CA 荐惹吾 \f2cacerts\fP ＜ゃゃ\f2keytool\fP 潟潟ゃ激с潟篏睡障\f2cacerts\fP ＜ゃ JRE ゃ潟鴻若ｃ障＜ゃ膩≪祉号┤翫激鴻膊∞ｇ機
-.br
-
-.LP
-.RE
-
-.LP
-.RE
+トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し ( \f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。
.TP 2
o
-\f3ゃ潟帥若 RFC 1421 荐惹悟垸荀\fP
-.RS 3
+\f3cacerts 証明書ファイル\fP
+.LP
+\f3cacerts\fP という名前の証明書ファイルは、セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
.LP
-紊翫荐惹吾ゃ膃垸сゃ潟帥若 RFC 1421 荀若у臂阪順垸劫篏帥ｃ主障Base 64 膃垸若違荐惹後就綣с糸＜若篁罘罕祉≪宴若激с潟荐惹吾絎号鴻若с障
-.LP
+cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、ルート CA 証明書のデフォルトセットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。
+.nf
+\f3
+.fl
+keytool \-list \-keystore \fP\f4java.home\fP\f3/lib/security/cacerts
+.fl
+\fP
+.fi
.LP
-\f2\-importcert\fP 潟潟 \f2\-printcert\fP 潟潟с綵√荐惹吾ゃ膃垸荐惹吾茯粋昭с障
-.LP
+cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。
.LP
-\f2\-exportcert\fP 潟潟ссゃ膃垸荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障
+\f3重要: \fP\f4cacerts\fP\f3 ファイルを確認してください\fP: \f2cacerts\fP ファイル内の CA は、署名および他のエンティティーへの証明書発行のためのエンティティーとして信頼されるため、 \f2cacerts\fP ファイルの管理は慎重に行う必要があります。 \f2cacerts\fP ファイルには、信頼する CA の証明書だけが含まれていなければなりません。ユーザーは、自身の責任において、 \f2cacerts\fP ファイルにバンドルされている信頼できるルート CA 証明書を検証し、信頼性に関する独自の決定を行います。信頼できない CA 証明書を \f2cacerts\fP ファイルから削除するには、 \f2keytool\fP コマンドの削除オプションを使用します。 \f2cacerts\fP ファイルは JRE のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。
+.TP 2
+o
+\f3インターネット RFC 1421 証明書符号化規格\fP
.LP
+多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。
.LP
-\f2\-list\fP 潟潟сц┝吾 MD5 ｃ潟若潟阪障\f2\-v\fP 激с潟絎篋咲茯с綵√ц┝吾阪障 筝鴻\f2\-rfc\fP 激с潟絎阪順垸劫ц┝吾阪障
+\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。
.LP
+\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。 ただし、 \f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。
.LP
-阪順垸劫х垸荐惹吾罨＜茵у障障
+\f2\-list\fP コマンドでは、デフォルトで証明書の SHA1 フィンガープリントが出力されます。 \f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、 \f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。
.LP
+出力可能符号化方式で符号化された証明書は、次の行で始まります。
.nf
\f3
.fl
@@ -1372,11 +1574,8 @@
.fl
\fP
.fi
-
.LP
-.LP
-緇罨＜茵х障
-.LP
+最後は、次の行で終わります。
.nf
\f3
.fl
@@ -1385,40 +1584,38 @@
\fP
.fi
.RE
-.RE
.LP
.SS
-X.500 茘ュ
+X.500 識別名
+.LP
.LP
-.RS 3
-
+X.500 識別名は、エンティティーを特定するために使われます。たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。
.LP
-X.500 茘ュ潟ｃｃ若劫篏帥障 違X.509 荐惹吾 \f2subject\fP ｃ若 \f2issuer\fP (臀峨) ｃ若ф絎X.500 茘ュс \f3keytool\fP 罨＜泣若泣若障
.RS 3
.TP 2
o
-\f2commonName\fP \- 篋冴腱違 Susan Jones
+\f2commonName\fP \- 人の通称。 「Susan Jones」など
.TP 2
o
-\f2organizationUnit\fP \- 絨腟膵 (茯蚊) 腱違 篁ラ
+\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。 「仕入部」など
.TP 2
o
-\f2organizationName\fP \- 紊с腟膵腱違 ABCSystems, Inc.
+\f2organizationName\fP \- 大きな組織の名称。 「ABCSystems, Inc.」など
.TP 2
o
-\f2localityName\fP \- 医 (遵) Palo Alto
+\f2localityName\fP \- 地域 (都市) 名。 「Palo Alto」など
.TP 2
o
-\f2stateName\fP \- 綏障井劫 California
+\f2stateName\fP \- 州名または地方名。 「California」など
.TP 2
o
-\f2country\fP \- 2 絖順垩 CH
+\f2country\fP \- 2 文字の国番号。 「CH」など
.RE
.LP
.LP
-\f2\-genkeypair\fP 潟潟 \f2\-dname\fP 激с潟ゃ茘ュ絖絎翫罨＜綵√ф絎綽荀障
+\-genkeypair コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、 次の形式で指定する必要があります。
.LP
.nf
\f3
@@ -1430,12 +1627,12 @@
.LP
.LP
-ゃ帥篏絎絎ゃ茵障 膰綵≪若若潟罨＜с
+イタリック体の項目は、実際に指定する値を表します。 短縮形のキーワードの意味は、次のとおりです。
.LP
.nf
\f3
.fl
- CN=commonName
+ CN=commonName
.fl
OU=organizationUnit
.fl
@@ -1452,22 +1649,24 @@
.LP
.LP
-罨＜腓冴茘ュ絖箴с
+次に示すのは、識別名文字列の例です。
.LP
.nf
\f3
.fl
-CN=Mark Smith, OU=JavaSoft, O=Sun, L=Cupertino, S=California, C=US
+CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US
.fl
\fP
.fi
.LP
-罨＜絖篏帥ｃ潟潟箴с
+.LP
+次は、この文字列を使ったコマンドの例です。
+.LP
.nf
\f3
.fl
-keytool \-genkeypair \-dname "CN=Mark Smith, OU=JavaSoft, O=Sun, L=Cupertino,
+keytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino,
.fl
S=California, C=US" \-alias mark
.fl
@@ -1476,45 +1675,43 @@
.LP
.LP
-若若膰綵≪с紊ф絖絨絖阪ャ障違CNcn Cn 宴障
+キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。
.LP
.LP
-筝鴻若若絎綺潟泣潟潟若潟筝腓冴綺ф絎綽荀障泣潟潟若潟鴻絎綽荀障違罨＜筝泣潟潟若潟絎с障
+一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。
.LP
.nf
\f3
.fl
-CN=Steve Meier, OU=SunSoft, O=Sun, C=US
+CN=Steve Meier, OU=Java, O=Oracle, C=US
.fl
\fP
.fi
.LP
.LP
-茘ュ絖ゃ潟潟障翫潟潟茵ф絖絎罨＜潟潟絖 \\ с鴻宴若綽荀障
+識別名文字列の値にコンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。
.LP
.nf
\f3
.fl
- cn=peter schuster, o=Sun Microsystems\\, Inc., o=sun, c=us
+ cn=Peter Schuster, ou=Java\\, Product Development, o=Oracle, c=US
.fl
\fP
.fi
.LP
.LP
-茘ュ絖潟潟茵ф絎綽荀障茘ュ綽荀潟潟絎茵潟潟茵цュ絎ｃ翫泣潟潟若潟ュ羆障翫潟潟絖 \\ с鴻宴若綽荀障
+識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。
.LP
-.RE
.SS
-篆♂若с荐惹吾ゃ潟若≪羈鋋
+信頼できる証明書のインポートに関する注意事項
.LP
-.RS 3
-
+.LP
+重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。
.LP
-荀:篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾絎鴻茯帥鴻
.LP
-障荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f2\-import\fP 潟潟篏睡)茵腓冴荐惹吾ｃ潟若潟緇ｃ潟若潟筝眼腆肴障違若吟若荐惹吾荐惹吾 \f2/tmp/cert\fP с＜ゃ主障翫篆♂若с荐惹吾鴻荐惹吾菴遵\f2\-printcert\fP 潟潟絎茵ｃ潟若潟茵腓冴с障 違罨＜障
+まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
.LP
.nf
\f3
@@ -1535,90 +1732,93 @@
.fl
SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE
.fl
+ SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:
+.fl
+ 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4
+.fl
\fP
.fi
.LP
-罨＜荐惹吾篆＜篋榊ｇ機篋榊腓冴ｃ潟若潟筝潟潟ц；腓冴ｃ潟若潟罸莠障ｃ潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙ｃ臀峨鴻 (紙潟ゃ鴻＜ゃ JAR ＜ゃ) 篆♂若障
+.LP
+次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。
.LP
-羈:荐惹吾ゃ潟若綽 \f2\-printcert\fP 潟潟絎茵違с障 若鴻√篆♂若с荐惹吾鴻荐惹吾菴遵 \f2\-importcert\fP 潟潟絎茵荐惹吾宴茵腓冴腆肴羆＜祉若吾茵腓冴障ゃ潟若篏鴻т賢罩≪с障腆肴＜祉若吾茵腓冴\f2\-importcert\fP 潟潟 \f2\-noprompt\fP 激с潟絎絎茵翫с\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
+.LP
+注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
.LP
-.RE
.SS
-鴻若≪羈鋋
+パスワードに関する注意事項
.LP
-.RS 3
-
+.LP
+キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。
.LP
.LP
-若鴻≪絲障篏茵祉潟潟с鴻≪鴻若綽荀с障筝潟潟с/腱絲泣鴻若綽荀障
-.LP
-.LP
-鴻若潟潟茵ф絎с障 (鴻≪鴻若 \f2\-storepass\fP 激с潟泣鴻若 \f2\-keypass\fP 激с潟篏睡)鴻翫障絎сｃ激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с
+パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
.LP
.LP
-綽荀鴻若激с潟潟潟茵ф絎ｃ翫鴻若ュ羆障
+必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
+.LP
+.SS
+証明書の準拠に関する注意事項
+.LP
.LP
-.RE
-.SH "∫ｉ"
+インターネット標準の
+.na
+\f2RFC 5280\fP @
+.fi
+http://tools.ietf.org/rfc/rfc5280.txt では、X.509 証明書が準拠するプロファイルを定義しています。このプロファイルには、証明書のフィールドやエクステンションで有効な値や値の組み合わせが含まれています。\f3keytool\fP では、これらのすべての規則が適用されているわけではないので、標準に準拠しない証明書が生成される可能性があり、そのような証明書は JRE やほかのアプリケーションで拒否されることがあります。ユーザーは、 \f2\-dname\fP や \f2\-ext\fP などで適正なオプションを指定するようにしてください。
.LP
-
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-.LP
-jar(1) 若ャ＜潟
+jar(1) ツールのドキュメント
.TP 2
o
-.LP
-jarsigner(1) 若ャ＜潟
+jarsigner(1) ツールのドキュメント
.TP 2
o
-.LP
-\f3keytool\fP 篏睡箴ゃ
.na
-\f4Java Tutorial\fP @
+\f4keytool\fP\f2 の使用例については、\fP @
.fi
-http://java.sun.com/docs/books/tutorial
+http://download.oracle.com/javase/tutorial/security/index.html
.na
-\f4Security\fP @
+\f2「Java Tutorial」\fP\f4の\fP @
.fi
-http://java.sun.com/docs/books/tutorial/security/index.html
+http://download.oracle.com/javase/tutorial/「Security」\f3を参照\fP
.RE
.LP
-.SH "紊雁"
-.LP
-
+.SH "変更点"
.LP
.LP
-Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障
+Java SE 6 で keytool のコマンドインタフェースが変更されました。
.LP
.LP
-\f3keytool\fP 若吟若鴻若ュュ絎鴻茵腓冴障若吟若鴻若ュュ絎鴻腆肴сｃ若鴻≪鴻若荐絎泣鴻若紊眼鴻若荐絎紊眼茵潟鴻若ュ羆障
+\f3keytool\fP は、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。
.LP
.LP
-紊眼潟潟筝紊眼違綮罩≪ャ＜潟荐莠ｃ障篁ュ鴻潟潟 (紊眼綮罩≪筝≧) 若鴻с綣膓泣若篁緇若鴻с泣若篋絎сkeytool 潟潟ゃ潟帥с若鴻鴻紊雁鴻网荀罨＜腓冴障
+変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。
.LP
.LP
-紊眼潟潟:
+名前が変更されたコマンド:
.LP
.RS 3
.TP 2
o
-\f2\-export\fP \f2\-exportcert\fP 紊
+\f2\-export\fP の名前が \f2\-exportcert に変更\fP
.TP 2
o
-\f2\-genkey\fP \f2\-genkeypair\fP 紊
+\f2\-genkey\fP の名前が \f2\-genkeypair に変更\fP
.TP 2
o
-\f2\-import\fP \f2\-importcert\fP 紊
+\f2\-import\fP の名前が \f2\-importcert に変更\fP
.RE
.LP
.LP
-綮罩≪ャ＜潟荐莠ｃ潟潟:
+廃止されてドキュメントに記載されなくなったコマンド:
.LP
.RS 3
.TP 2
@@ -1626,19 +1826,19 @@
.na
\f2\-keyclone\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#keycloneCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#keycloneCmd
.TP 2
o
.na
\f2\-identitydb\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#identitydbCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#identitydbCmd
.TP 2
o
.na
\f2\-selfcert\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#selfcertCmd
+http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html#selfcertCmd
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Wed Jul 05 17:42:56 2017 +0200
@@ -1,4 +1,4 @@
-." Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1997, 2010, 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
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH native2ascii 1 "02 Jun 2010"
+.TH native2ascii 1 "14 Apr 2011"
.LP
-.SH ""
-native2ascii \- ゃｃ \- ASCII 潟潟若
-.LP
-.RS 3
-
+.SH "名前"
+native2ascii \- ネイティブ \- ASCII コンバータ
.LP
.LP
-ゃｃ潟若 (Latin 1 Unicode 篁ュ) ＜ゃ Unicode 潟若紊障
+サポートされる文字エンコーディングの文字のファイルを ASCII または Unicode エスケープあるいはその両方のファイルに変換します。その逆の変換も行います。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -44,36 +38,34 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-Java 潟潟ゃ潟篁 Java 若Latin\-1 障 Unicode 潟若 (\\udddd 茵荐) 絖＜ゃс障 \f2native2ascii\fP 篁ュ絖潟若＜ゃ Latin\-1 障 Unicode 潟若＜ゃ紊障
+\f2native2ascii\fP Java 実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCII でエンコードされたファイルに変換します。ASCII 文字セットの一部でないすべての文字で Unicode エスケープ (「\\uxxxx」の表記) を使用します。このプロセスは、ISO\-8859\-1 文字セットに含まれない文字が含まれているプロパティーファイルで必要です。このツールは、その逆の変換を実行することもできます。
.LP
.LP
-\f2outputfile\fP ャ翫罔羣阪阪障\f2inputfile\fP ャ翫罔羣ュュ障
+\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、 \f2inputfile\fP を省略した場合、標準入力から入力されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-reverse
-茵障ゃ障Latin\-1 障 Unicode 潟若＜ゃゃｃ潟若紊障
+逆の処理を行います。つまり、ISO\-8859\-1 で Unicode エスケープを使ってエンコードされたファイルを、Java 実行環境でサポートされる文字エンコーディングのファイルに変換します。
.br
.br
.TP 3
\-encoding encoding_name
-紊т戎潟若絎障潟若激鴻ｃ若 \f2file.encoding\fP 緇障\f2encoding_name\fP 絖
+変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング ( \f2java.nio.charset.Charset.defaultCharset\fP メソッドで定義される) が使用されます。 \f2encoding_name\fP 文字列は、
.na
-\f4泣若潟潟若ｃ潟違\fP @
+\f4「サポートされている文字列エンコーディング」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlャ＜潟腓冴泣若潟潟若ｃ潟違茵緇綽荀障
+http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlドキュメントに示されている、Java 実行環境でサポートされる文字エンコーディングの名前にする必要があります。
+.br
+.br
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/orbd.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/orbd.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,29 +19,23 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH orbd 1 "02 Jun 2010"
+.TH orbd 1 "14 Apr 2011"
.LP
-.SH ""
+.SH "名前"
orbd \- The Object Request Broker Daemon
.LP
-.RS 3
-
+.LP
+\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。
.LP
.LP
-\f3orbd\fP ゃ≪潟 CORBA 医泣若若膓吾с罎膣≪若喝冴篏睡障
-.LP
-.LP
-\f3∫ｉ:\fP
+\f3関連項目:\fP
.na
-\f2若泣若\fP @
+\f2ネームサービス\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -52,42 +46,40 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3orbd\fP 若障泣若若若吾ｃ若篏帥ゃ≪潟 CORBA 医с泣若寂膓吾с罎膣≪若喝冴с障膓泣若若若泣若鴻膓吾сс肴泣若若若垩篁ｃ OBRD 若垩吾сс障膓吾сс吾сс ORBD 若垩罨＜鴻障
+\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。
.LP
.RS 3
.TP 2
o
-若泣若鴻吾сс泣若若ゃ帥ゃ♂≫吾сс紮ゃ潟鴻若若泣若鴻泣若若若泣若鴻肴障緇泣若若紮障激ｃ潟違ORBD ゃс若喝冴ゃ≪潟罩ｃ吾сс菴障
+ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。
.TP 2
o
-ゃ≪潟筝綺若潟違泣若鴻吾сс≪綽荀緇泣若若ゃ帥ゃ紊眼♂≫сс
+クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる
.RE
.LP
.LP
-ORBD 泣若若若吾ｃ若≪祉鴻servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激ｃ潟茵潟潟茵ゃ潟帥с若鴻с泣若若若吾ｃ若荅括完ゃャ＜潟\f2泣若若若吾ｃ若\fPс
+ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。
.LP
.LP
-\f2orbd\fP 莎桁若泣若鴻莎桁障若泣若鴻ゃ
+\f2orbd\fP を起動すると、ネームサービスも起動されます。ネームサービスについては、
.na
-\f2若泣若鴻\fP @
+\f2「ネームサービス」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
-.SH "激с"
+.SH "オプション"
.LP
.SS
-綽激с
+必須オプション
.LP
.RS 3
.TP 3
\-ORBInitialPort nameserverport
-若泣若若莎桁若垩絎障\f2orbd\fP 莎桁若筝х篆∴羆緇罘障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 (綽)
+ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須)
.RE
.LP
@@ -95,75 +87,75 @@
.LP
.SS
-篁激с
+その他のオプション
.LP
.RS 3
.TP 3
\-port port
-ORBD 莎桁若絎障 ORBD 若с膓吾с絲障荀羆障若ゃ 1049 с 若垩膓 Interoperable Object References (IOR) 若ｃ若菴遵障(ュ)
+ORBD を起動するポートを指定します。ORBD は、このポートで、持続オブジェクトに対する要求を受け取ります。このポートのデフォルト値は 1049 です。このポート番号が、持続 Interoperable Object References (IOR). のポートフィールドに追加されます。(省略可)
.RE
.LP
.RS 3
.TP 3
\-defaultdb directory
-ORBD 膓主ｃ \f2orb.db\fP 篏若鴻ｃ絎障激с潟絎翫ゃ./orb.db障(ュ)
+ORBD 持続格納ディレクトリ \f2orb.db\fP が作成されるベースディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」となります。(省略可)
.RE
.LP
.RS 3
.TP 3
\-serverPollingTime milliseconds
-\f2servertool\fP 篏睡脂蚊膓泣若若罩ｅ幻篏 ORBD 腆肴違絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
+\f2servertool\fP を使用して登録された持続サーバーが正常に動作していることを ORBD が確認する回数を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE
.LP
.RS 3
.TP 3
\-serverStartupDelay milliseconds
-\f2servertool\fP 篏睡脂蚊膓泣若若莎桁篏臀荵∫箴紊篆＜障с ORBD 緇罘絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
+\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE
.LP
.RS 3
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.TP 3
.RE
.LP
-.SH "若泣若鴻莎桁罩"
+.SH "ネームサービスの起動と停止"
.LP
.LP
-若泣若鴻
+ネームサービスは、
.na
-\f2CORBA 吾с\fP @
+\f2CORBA オブジェクト\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object若潟違純 CORBA 泣若鴻с 若潟違吾ссゃ潟純障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にする CORBA サービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。
.na
-\f2若ゃ潟ｃ潟違\fP @
+\f2「ネームバインディング」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding若泣若鴻主ゃ≪潟筝吾сс緇с障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingはネームサービスに格納され、クライアントは名前を与えて目的のオブジェクト参照を取得できます。
.LP
.LP
-ORBD ゃ≪潟障泣若若絎茵莎桁障ORBD 膓若泣若鴻割若泣若鴻腟粋昭障障 ＜ COS 若泣若鴻絎茖с
+ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。
.LP
.LP
-\f3膓若泣若\fP若潟違潟潟鴻絲障膓с箴障ゃ障宴泣若鴻罩≪莎桁緇膓泣若鴻絎潟榊翫с緇с障ORBD 莎桁膓若泣若鴻若潟違潟潟鴻違緇鴻ゃ≪潟泣若若ゃ潟ｃ潟違篆障
+\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。
.LP
.LP
\
.LP
.LP
-筝篏篋сс若吾с潟 JDK 罌宴\f3筝若泣若\fP篁若鴻 J2SE 罌宴障筝若泣若鴻с若泣若鴻絎茵筝帥若潟違潟潟鴻篆障泣若鴻筝若潟違潟潟鴻紊宴障
+下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。
.LP
.LP
-\f2\-ORBInitialPort\fP 綣違\f2orbd\fP 綽潟潟茵綣違с若泣若鴻絎茵若垩荐絎篏帥障篁ヤ茯сJava\ IDL Object Request Broker Daemon 若 1050 篏睡с障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
+\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。
.LP
.LP
-UNIX 潟潟激с \f2orbd\fP 莎桁罨＜ュ障
+UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.nf
\f3
@@ -175,7 +167,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -187,7 +179,7 @@
.LP
.LP
- ORBD 絎茵泣若若ゃ≪潟≪宴若激с潟絎茵с障ゃ≪潟泣若若≪宴若激с潟絎茵若泣若鴻絎茵若 (綽荀翫激喝) 茯茘綽荀障絎憗 1 ゃ号罨＜潟若≪宴若激с潟菴遵с
+これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。
.LP
.nf
\f3
@@ -205,7 +197,7 @@
.LP
.LP
-箴с若泣若鴻鴻 MyHost 若 1050 筝у茵障ャ号潟潟茵泣若若障ゃ≪潟≪宴若激с潟絎茵若垩障激喝筝≧鴻絎号障違罨＜潟潟茵激с潟篏睡HelloApplication莎桁с障
+この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。
.LP
.nf
\f3
@@ -217,35 +209,35 @@
.LP
.LP
-若泣若鴻罩≪若ｃ潟違激鴻潟潟篏睡障 違Solaris с \f2pkill orbd\fP 篏睡\f2orbd\fP 絎茵 DOS ｃ潟с \f2Ctrl+C\fP 若篏睡障筝若泣若鴻翫泣若鴻腟篋若泣若鴻脂蚊羔ｻ翫障Java IDL 若泣若鴻腓榊罩≪障у茵障
+ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。
.LP
.LP
-ORDB 障若泣若鴻荅括完ゃ
+ORDB に含まれるネームサービスの詳細については、
.na
-\f2若泣若鴻\fP @
+\f2「ネームサービス」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
-.SH "泣若若若吾ｃ"
+.SH "サーバーマネージャー"
.LP
.LP
-ORBD 泣若若若吾ｃ若≪祉鴻膓泣若若絎茵servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激ｃ潟茵潟潟茵ゃ潟帥с若鴻сservertool 篏睡泣若若莎桁翫\f2orbd\fP 絎茵贋若鴻ц儀綽荀障泣若若違若у茵若潟潟鴻若帥若鴻篆絖宴≦鴻泣若鴻罩ｃ篏障
+ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\f2orbd\fP が実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカルコンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
.LP
.SS
-泣若若若吾ｃ:箴
+サーバーマネージャー: 例
.LP
.LP
-∝
+デモ用の
.na
-\f2泣潟ャ若≪\fP @
+\f2サンプルチュートリアル\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html篏睡ャ若≪緇ｃ\f2idlj\fP 潟潟ゃ \f2javac\fP 潟潟ゃ絎茵障泣若若若吾ｃ若絎茵罨＜緇ｃ≪宴若激с潟絎茵障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラを実行します。サーバーマネージャーを実行するには、次の手順に従ってアプリケーションを実行します。
.LP
.LP
-\f2orbd\fP 莎桁障
+\f2orbd\fP を起動します。
.LP
.LP
-UNIX 潟潟激с \f2orbd\fP 莎桁罨＜ュ障
+UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.LP
\
@@ -260,7 +252,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -272,13 +264,13 @@
.LP
.LP
-\f21050\fP 若泣若若絎茵若с\f2\-ORBInitialPort\fP 綽荀潟潟茵綣違сSolaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
+\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。
.LP
.LP
-\f2servertool\fP 莎桁障
+\f2servertool\fP を起動します。
.LP
.LP
-Hello 泣若若莎桁罨＜ュ障
+Hello サーバーを起動するには、次のように入力します。
.LP
.nf
\f3
@@ -290,21 +282,21 @@
.LP
.LP
-罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障\f2servertool\fP 若泣若若若筝ц儀綽荀障
+前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。\f2servertool\fP は、ネームサーバーと同じポート上で起動する必要があります。
.LP
.LP
-\f2servertool\fP 潟潟茵ゃ潟帥с若鴻茵腓冴障
+\f2servertool\fP コマンド行インタフェースが表示されます。
.LP
.LP
.LP
.LP
-\f2servertool\fP 潟 Hello 泣若若莎桁障
+\f2servertool\fP プロンプトから Hello サーバーを起動します。
.LP
.nf
\f3
.fl
- servertool > register \-server HelloServer \-classpath . \-applicationName
+ servertool > register \-server HelloServer \-classpath .\-applicationName
.fl
HelloServerApName
.fl
@@ -313,13 +305,13 @@
.LP
.LP
-\f2servertool\fP ｃ泣若若脂蚊HelloServerApName泣若若蚊綵泣若 ID 茵腓冴障
+\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。
.LP
.LP
.LP
.LP
-ャ腴ｃ潟障潟ゃ≪潟≪宴若激с潟絎茵障
+別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。
.LP
.LP
\
@@ -334,10 +326,10 @@
.LP
.LP
-箴 \f2\-ORBInitialHost localhost\fP ャс障 若泣若若 Hello ゃ≪潟筝鴻筝у篏с若泣若若ャ鴻у篏翫IDL 若泣若若篏鴻 \f2\-ORBInitialHost\fP \f2nameserverhost\fP ф絎障
+この例の \f2\-ORBInitialHost localhost\fP は省略することができます。ネームサーバーが Hello クライアントとして同一ホスト上で動作しているからです。ネームサーバーが別のホストで動作している場合は、IDL ネームサーバーが動作しているホストを \f2\-ORBInitialHost\fP \f2nameserverhost\fP で指定します。
.LP
.LP
-罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障
+前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。
.LP
.LP
\
@@ -346,21 +338,21 @@
\
.LP
.LP
-泣若若若吾ｃ若篏腟篋若泣若 (\f2orbd\fP) \f2servertool\fP 罩≪腟篋
+サーバーマネージャーの操作が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を停止するか終了してください。
.LP
.LP
-DOS 潟 \f2orbd\fP 激ｃ潟泣若若絎茵ｃ潟御 \f2Ctrl+C\fP ュ障UNIX 激с \f2orbd\fP 激ｃ潟祉鴻罎冴腟篋 (kill) 障泣若若腓榊罩≪障с若喝冴緇罘倶膓障
+DOS プロンプトで \f2orbd\fP をシャットダウンするには、サーバーを実行しているウィンドウを選択して \f2Ctrl+C\fP と入力します。UNIX シェルで \f2orbd\fP をシャットダウンするには、プロセスを検出して終了 (kill) します。サーバーを明示的に停止するまでは、呼び出し待機状態が続きます。
.LP
.LP
-\f2servertool\fP 激ｃ潟\f2quit\fP ュ若若 \f2Enter\fP 若若障
+\f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
-\f2若泣若\fP @
+\f2ネームサービス\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.br
--- a/jdk/src/solaris/doc/sun/man/man1/ja/pack200.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/pack200.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,99 +19,79 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH pack200 1 "02 Jun 2010"
+.TH pack200 1 "14 Apr 2011"
.LP
-.SH ""
-pack200 \- JAR 若
+.SH "名前"
+pack200 \- JAR パックツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-腟篋鴻若帥
+終了ステータス
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-茯
+注意事項
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
.LP
.LP
-激с潟絎綺羆冴障障潟潟茵障 properties ＜ゃ絎緇激с潟篁ュ絎鴻激с潟障
-.LP
-.RS 3
-
+オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
options
-潟潟茵激с潟
+コマンド行オプション。
.TP 3
output\-file
-阪＜ゃ
+出力ファイルの名前。
.TP 3
JAR\-file
-ュ＜ゃ
+入力ファイルの名前。
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f2pack200\fP 若Java \f2gzip\fP х軒違篏睡JAR ＜ゃ \f2pack200\fP х軒＜ゃ紊 Java ≪宴若激с潟с\f2pack200\fP ＜ゃ蕭х軒＜ゃс絽綛膀膣潟若膰贋･с障
+\f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
.LP
.LP
-\f2pack200\fP 若х軒潟吾潟荐絎緇茯炊眼茵激с潟障
+\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
.LP
.SS
-筝篏睡号:
-.LP
-.RS 3
-
+一般的な使用方法:
.LP
.LP
\f2% pack200 myarchive.pack.gz myarchive.jar\fP
.LP
-.RE
-.LP
-箴с \f2pack200\fP 荐絎с\f2myarchive.pack.gz\fP 篏障
.LP
-.SH "激с"
+この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。
.LP
-
+.SH "オプション"
.LP
.LP
\f4\-r \-\-repack\fP
.LP
-.RS 3
-
.LP
-.LP
-\f2myarchive.jar\fP ＜ゃ緇≪潟JAR ＜ゃ障＜ゃ\f2jarsigner(1)\fP 若ュ＜ゃ篏睡с障
-.LP
-.RS 3
-
+ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
.LP
.LP
\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
@@ -119,158 +99,122 @@
.LP
\f2% pack200 \-\-repack myarchive.jar\fP
.LP
-.RE
-.RE
.LP
\f4\-g \-\-no\-gzip\fP
.LP
-.RS 3
-
.LP
-.LP
-\f2pack200\fP ＜ゃ障激с潟絎х軒若篏睡綽荀障 障帥若蚊激鴻с絲上х軒茹ｉゃ若篏睡綽荀障
-.LP
-.RS 3
-
+\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
.LP
.LP
\f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP
.LP
-.RE
-.RE
.LP
\f4\-G \-\-strip\-debug\fP
.LP
-.RS 3
-
+.LP
+出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
.LP
.LP
-阪亥絮сゃ障絲乗院絮с\f2SourceFile\fP\f2LineNumberTable\fP\f2LocalVariableTable\fP \f2LocalVariableTypeTable\fP 障絮сゃ違潟若ゃ潟鴻若泣ゃ冴絨障罘純狗障
+\f4\-\-keep\-file\-order\fP
+.LP
.LP
-.RE
+入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。
+.LP
.LP
\f4\-O \-\-no\-keep\-file\-order\fP
.LP
-.RS 3
-
-.LP
.LP
-若鴻荀膣筝号帥荵∫障障JAR ｃゃ障潟若泣ゃ冴絨障ゃ潟鴻 JAR ＜ゃ罘純罩ｅ幻篏障
+パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
.LP
-.RE
.LP
\f4\-Svalue \-\-segment\-limit=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-ゃ≪若ゃ祉違＜潟篋潟帥若蚊泣ゃ N (ゃ篏) сN ゃ篁ヤ綽荀筝ュ＜ゃ
+この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが
.br
-腴≪若ゃ祉違＜潟蚊綵障違号箴сゃ \f2\-1\fP 翫鴻ュ＜ゃ筝綏紊с祉違＜潟障 筝鴻ゃ \f20\fP 翫鴻祉違＜潟 1 ゃょ障≪若ゃ祉違＜潟泣ゃ冴紊с医ぇ祉莎激х軒蕭障祉違＜潟紊ч＜≪若綽荀障
+N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
.LP
.LP
-祉違＜潟泣ゃ冴祉違＜潟ц拶ュ＜ゃ泣ゃ冴＜ゃ泣ゃ冴潟篁荵∫ｃ若ｃ篋羝障
+各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。
.LP
.LP
-泣ゃ冴 \f21000000\fP (100 筝ゃ) с罔羣泣ゃ冴ュ JAR ＜ゃ筝祉違＜潟ц拶с泣ゃ冴с若潟≪潟若＜≪取篁吟狗茯蚊障
+デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。
.LP
.LP
-狗茯蚊 10M ゃ JAR ＜ゃ絽吾 10% 腮綺泣ゃ冴障 若с紊с Java 若 (祉違＜潟狗膣 10 ) 綽荀翫障
+この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
.LP
-.RE
.LP
\f4\-Evalue \-\-effort=\fP\f2value\fP
.LP
-.RS 3
-
+.LP
+単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
.LP
.LP
-筝 10 我医ゃ絎翫若絎х軒с≪若ゃх軒障 \f21\fP 翫х軒綺х軒祉蕭障 \f29\fP 翫х軒綺х軒蕭障号 \f20\fP 絎翫 JAR ＜ゃх軒х贋･潟若障JSR 200 罔羣с鴻≪潟若号≪若ゃ篏鴻鴻若茹ｃ綽荀障
-.LP
+デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。
.LP
-ゃ \f25\fP с 翫罔羣с綺х軒茵障
-.LP
-.RE
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-ゃ筝吾ュ宴篆障 荵∫≪若ゃ泣ゃ冴紊с障純:
+デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。
.LP
.RS 3
.TP 3
true
.TP 3
false
-＜翫с若若激с潟潟阪≪若ゃ荐絎障 ≪若ゃ荀膣若激с潟潟荵∫障
+どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
.RE
.LP
.RS 3
.TP 3
keep
-ュ JAR 若激с潟潟篆障 ()
+入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。)
.RE
.LP
-.RE
.LP
\f4\-mvalue \-\-modification\-time=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-純:
+返される値は次のどれかになります。
.LP
.RS 3
.TP 3
latest
-若≪若ゃ潟腟贋井祉祉違＜潟鴻潟腟贋井祉劫障筝ゃ祉違＜潟筝荵∫祉違＜潟潟障翫鴻ゃ潟鴻若＜ゃ筝ヤ荐絎馹障≪若ゃ荵∫泣ゃ冴絨絨с障
+パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
.TP 3
keep
-ュ JAR 贋井祉篆障 ()
+入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。)
.RE
.LP
-.RE
.LP
\f4\-Pfile \-\-pass\-file=\fP\f2file\fP
.LP
-.RS 3
-
-.LP
.LP
-＜ゃх軒ゃ篏ц拶絎障激с潟膵違菴篏睡茲違＜ゃ絎с障劫紊茵障 激鴻＜ゃ阪絖 JAR ＜ゃ阪絖\f2/\fPх舟с＜ゃJAR ＜ゃ絖絎筝眼違障file ｃ絎翫ｃ鴻＜ゃ荵∫障
+ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
.LP
-.RE
.LP
\f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP
.LP
-.RS 3
-
.LP
-.LP
-篏≦鴻障 違筝絮с鴻＜ゃ絎≪激с潟ц拶障≪激с潟絎純:
+デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
error
-\f2pack200\fP 篏紊掩茹ｈ茵腓冴障
+\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
-絮с障羈: VM 綽絮сゃ鴻若若絎潟榊障
+属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.TP 3
pass
-絮с罎冴翫劫篏 1 ゃ純若鴻荵∫障
+この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
.RE
.LP
-.RE
.LP
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
.br
@@ -280,42 +224,32 @@
.br
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
.LP
-.RS 3
-
.LP
-.LP
- 4 ゃ激с潟с鴻潟ｃｃ若 Class 絮сField 絮сMethod 絮сCode 絮с絮сゃ≪絎с障attribute\-name ゃ≪障≪激с潟絎臂絮с絎障≪激с潟絎純:
+これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
-(筝ゃ≪絖)
-ゃ≪荐茯JSR 200 篁罕絎臂障
+some\-layout\-string
+レイアウト言語は、JSR 200 仕様に定義されています。
.LP
-箴: \f2\-\-class\-attribute=SourceFile=RUH\fP
+例: \f2\-\-class\-attribute=SourceFile=RUH\fP
.TP 3
error
-絮с罎冴翫pack200 篏紊掩茹ｈ茵腓冴障
+この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
-絮с罎冴翫絮с阪ゃ障羈: VM 綽絮сゃ鴻若若絎潟榊障
+この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.RE
.LP
.LP
-箴: \f2\-\-class\-attribute=CompilationID=pass\fP 絮с鴻＜ゃ荵∫障 若篁≪激с潟茵障
+例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。
.LP
-.RE
.LP
\f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP
.LP
-.RS 3
-
.LP
-.LP
-潟潟茵若 Java ｃ若障荐絎＜ゃ絎с障
-.LP
-.RS 3
-
+コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。
.LP
.LP
\f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP
@@ -340,70 +274,54 @@
.br
\f2segment.limit=\-1\fP
.LP
-.RE
-.RE
-.RS 3
-
-.LP
.LP
\f4\-v \-\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-絨＜祉若吾阪障激с潟茲井絎激＜祉若吾阪障
+最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
-.RE
.LP
\f4\-q \-\-quiet\fP
.LP
-.RS 3
-
-.LP
.LP
-＜祉若吾茵腓冴篏障
+メッセージを表示せずに動作します。
.LP
-.RE
.LP
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
.LP
-.RS 3
-
+.LP
+出力メッセージのログファイルを指定します。
+.LP
+.LP
+\f4\-? \-h \-\-help\fP
.LP
.LP
-阪＜祉若吾違＜ゃ絎障
+このコマンドに関するヘルプ情報を出力します。
.LP
-.RE
.LP
-\f4\-Joption\fP
+\f4\-V \-\-version\fP
.LP
-.RS 3
-
+.LP
+このコマンドに関するバージョン情報を出力します。
.LP
.LP
-\f2pack200\fP ｃ若喝冴 Java 莎桁若激с潟羝＜障違\f2\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障激с潟 \f2\-X\fP у障ｃ障\f2pack200\fP 罔羣激с潟с障\f2\-J\fP 篏帥ｃJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
+\f4\-J\fP\f2option\fP
+.LP
.LP
-.RE
-.RE
-.SH "腟篋鴻若帥"
+\f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.LP
-
+.SH "終了ステータス"
.LP
.LP
-罨＜腟篋ゃ菴障
-.LP
-.RS 3
-
+次の終了値が返されます。
.LP
.LP
-\f2\ 0\fP ""
+\f2\ 0\fP 正常終了した場合
.LP
.LP
-\f2>0\fP ""
+\f2>0\fP エラーが発生した場合
.LP
-.RE
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -412,35 +330,33 @@
.TP 2
o
.na
-\f2Java SE ャ＜潟\fP @
+\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
-\f2Java ゃ \- Pack200\fP @
+\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
-jar(1) \- Java Archive 若
+jar(1) \- Java Archive ツール」
.TP 2
o
-jarsigner(1) \- JAR 臀峨恰荐若若
+jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
-\f2attributes(5)\fP ャ≪若
+\f2attributes(5) の\fP マニュアルページ
.RE
.LP
-.SH "羈鋋"
-.LP
-
+.SH "注意事項"
.LP
.LP
-潟潟 \f2pack(1)\fP 羞桁сヨ遵с
+このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。
.LP
.LP
-SDK 篁絮 Java SE API 篁罕檎荀ゃｃ翫篁罕
+SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/policytool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/policytool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,84 +19,82 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH policytool 1 "02 Jun 2010"
+.TH policytool 1 "14 Apr 2011"
.LP
-.SH ""
-policytool \- PolicyTool 膊∞ GUI 若ｃｃ
+.SH "名前"
+policytool \- PolicyTool 管理 GUI ユーティリティー
.LP
-\f3policytool\fP 若ｃｃ GUI 腟宴у緇若吟弱ュ冴ャ若潟鴻激若＜ゃ茯炊吾障
+\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-∫ｉ
+関連項目
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.RS 3
.TP 3
\
.TP 3
-policytool 膊∞若ｃｃ若絎茵障
+policytool 管理者ユーティリティーを実行します
\f4policytool\fP
.TP 3
-policytool 絎茵絎激若＜ゃ茯粋昭帥障
-\f4policytool\fP\f2 [\-file\ \fP\f2filename\fP\f2]\fP
+policytool を実行し、指定されたポリシーファイルを読み込みます
+\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP
.TP 3
\
.TP 3
-荀膣罨＜с
+以下にそれぞれの意味を示します。
.RS 3
.TP 3
file
-若激若＜ゃ茯粋昭 \f2policytool\fP 腓冴障
+ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
.TP 3
filename
-＜ゃ
+ファイル名
.RE
-.SH "茯"
+.SH "説明"
.LP
-\f3policytool\fP 若吟若若激若＜ゃ絎鴻膊∞純 GUI с荅括完ゃ
+\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、
.na
-\f2激若＜ゃ篏括∞若\fP @
+\f2「ポリシーファイル作成および管理ツール」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlс
-.SH "激с"
+http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。
+.SH "オプション"
.RS 3
.TP 3
file
-\f2filename\fP 茯粋昭帥障
-.SH "∫ｉ"
+\f2filename\fP を読み込みます。
+.SH "関連項目"
.na
-\f2Default Policy Implementation and Syntax\fP @
+\f2「Default Policy Implementation and Syntax」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
.br
.na
-\f2Policy Tool Users' Guide\fP @
+\f2「Policy Tool Users' Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
.br
.na
-\f2Security Permissions\fP @
+\f2「Security Permissions」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
.br
.na
-\f2Security Overview\fP @
+\f2「Security Overview」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
.br
--- a/jdk/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/rmic.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmic 1 "02 Jun 2010"
+.TH rmic 1 "14 Apr 2011"
.LP
-.SH ""
-rmic \- Java RMI 潟潟ゃ
-.LP
-.RS 3
-
+.SH "名前"
+rmic \- Java RMI コンパイラ
.LP
.LP
-\f3rmic\fP ｃJRMP 障 IIOP 潟篏睡≪若吾с鴻帥鴻宴潟 Tie 鴻障障OMG IDL 障
+\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,12 +39,10 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmic\fP 潟潟ゃｃ≪若吾с鴻帥鴻宴潟鴻＜ゃ (JRMP 潟)潟鴻帥 Tie 鴻＜ゃ腟水 (IIOP 潟) 障≪若吾с絎茖鴻с鴻＜ゃJava 違潟域茯鴻潟潟ゃ障≪若絎茖鴻\f2java.rmi.Remote\fP ゃ潟帥с若鴻絎茖鴻с\f3rmic\fP 潟潟с劫鴻 \f3javac\fP 潟潟с潟潟ゃゅ宴若後絎綽荀障違鴻＜ゃ \f2HelloImpl\fP \f3rmic\fP 絎茵罨＜障
+\f3rmic\fP コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\f2java.rmi.Remote\fP インタフェースを実装するクラスです。\f3rmic\fP コマンドでのクラス名は、そのクラスが \f3javac\fP コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 \f2HelloImpl\fP で \f3rmic\fP を実行するには、次のようにします。
.LP
.nf
\f3
@@ -62,37 +54,32 @@
.LP
.LP
-\f2HelloImpl_Stub.class\fP ＜ゃ鴻宴若後篁 \f2hello\fP 泣ｃ篏障
+\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。
.LP
.LP
-≪若吾с鴻宴潟 JRMP 潟泣若弱眼潟ｃｃ若с絎≪若吾с絎茖若喝冴＜純帥障
+リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。
.LP
.LP
-≪若吾сTie鴻宴潟罕泣若弱眼潟ｃｃ若сIIOP 潟篏帥ｃゃ≪潟篆＜障
+リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。
.LP
.LP
-鴻帥≪若吾сゃ≪潟眼с篁ｇс 鴻帥≪若吾с＜純若喝冴絎≪若吾с絽檎泣若若篆＜綵劫蚊＜障ｃゃ≪潟≪若吾с吾с絎若鴻帥吾с障
-.LP
-.LP
- \f3rmic\fP с1.2 JRMP 鴻帥潟若吾с潟篏睡鴻帥鴻障 \f2\-v1.2\fP 激с潟絎翫篏с(5.0 篁ュс \f2\-vcompat\fP 激с潟сｃ羈) IIOP 潟鴻帥 Tie 鴻 \f2\-iiop\fP 激с潟篏睡障
+「スタブ」とは、リモートオブジェクトのクライアント側での代理です。スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。
.LP
.LP
-鴻帥≪若ゃ潟帥с若鴻絎茖≪若吾с絎茖絮ゃ潟帥с若鴻絎茖障JRMP 鴻帥≪若吾с篏絎茖≪若ゃ潟帥с若鴻絎茖сゃ≪潟ｃ鴻с Java 違潟域茯腟粋昭障羲膊絖篏睡с障IIOP 翫\f2PortableRemoteObject.narrow\fP ＜純篏帥違障
+デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。
+.LP
.LP
-.SH "激с"
+スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、\f2PortableRemoteObject.narrow\fP メソッドを使わなければなりません。
.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-bootclasspath path
-若鴻鴻＜ゃ篏臀若若ゃ障
+ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-classpath path
-\f3rmic\fP 鴻｢鴻絎障激с潟 CLASSPATH 医紊域┃絎筝吾障ｃ潟潟у蚊障ｃ\f2path\fP 筝綵√罨＜障
-.RS 3
-
-.LP
+\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@@ -100,11 +87,7 @@
.fl
\fP
.fi
-.RE
-箴腓冴障
-.RS 3
-
-.LP
+例を示します。
.nf
\f3
.fl
@@ -112,13 +95,9 @@
.fl
\fP
.fi
-.RE
.TP 3
\-d directory
-拷絮ゃ阪ｃ若絎障激с潟篏帥違鴻帥鴻宴潟 Tie ＜ゃ主ｃ絎с障違罨＜篏帥障
-.RS 3
-
-.LP
+生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。
.nf
\f3
.fl
@@ -126,49 +105,43 @@
.fl
\fP
.fi
-.RE
-\f2MyClass\fP 緇鴻帥鴻宴潟鴻 \f2/java/classes/foo\fP ｃ臀障\f2\-d\fP 激с潟絎翫\f2\-d\ .\fP絎荀障帥若蚊鴻宴若檎絮ゃ憜ｃ篏鴻帥Tie潟鴻宴潟＜ゃｃ主障(篁ュ若吾с潟 \f3rmic\fP с\f2\-d\fP 絎翫宴若檎絮ゃ篏阪＜ゃ鴻憜ｃ贋･主)
+MyClass から取得した \f2スタブとスケルトンクラスを\fP \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。)
.br
\
.TP 3
\-extdirs path
-ゃ潟鴻若≦宍罘純篏臀若若ゃ障
+インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-g
-絮紊違鴻井宴障с茵垽宴障
-.LP
+局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。
.TP 3
\-idl
-\f2rmic\fP ｃ絎鴻喝с鴻 OMG IDL 障IDL с違潟域茯箴絖絎ｈс吾с API 絎с障IDL ＜純潟若帥篁罕篏睡障 CORBA ゃ潟ｃ潟違箴篁紙荐茯с＜純潟若帥篏喝若喝冴茵с障荐茯Java C++ 障障荅括完
+\f2rmic\fP によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、
.na
\f2Java Language to IDL Mapping\fP @
.fi
-http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) с
+http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。
.LP
-\f2\-idl\fP 激с潟篏帥祉激с潟絎с障
+\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
-\-always 障 \-alwaysgenerate
-√鴻帥Tie IDL ュ鴻違с綣桁句眼障
+\-always または \-alwaysgenerate
+既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-factory
- IDL factory 若若篏帥障
+生成された IDL で factory キーワードを使います。
.TP 3
\-idlModule\ fromJavaPackage[.class]\ toIDLModule
-IDLEntity 宴若吾絎障箴腓冴障 \f2\-idlModule foo.bar my::real::idlmod\fP
+IDLEntity パッケージのマップを指定します。例を示します。 \f2\-idlModule foo.bar my::real::idlmod\fP
.TP 3
\-idlFile\ fromJavaPackage[.class]\ toIDLFile
-IDLEntity ＜ゃ絎障箴腓冴障 \f2\-idlFile test.pkg.X TEST16.idl\fP\
+IDLEntity ファイルのマップを指定します。例を示します。 \f2\-idlFile test.pkg.X TEST16.idl\fP\
.RE
-.LP
.TP 3
\-iiop
-\f2rmic\fP ｃJRMP 鴻帥鴻宴潟鴻篁ｃIIOP 鴻帥 Tie 鴻障鴻帥鴻≪若吾с若激сゃ≪潟泣若若若喝冴篆＜篏帥障≪若ゃ潟帥с若鴻鴻帥鴻綽荀с 鴻帥鴻ｃ≪若ゃ潟帥с若鴻絎茖障ゃ≪潟с≪若吾сс絎鴻帥с障帥ゃ鴻泣若弱眼х若若喝冴絎茖鴻ｃ鴻篏帥障絎茖鴻帥ゃ鴻綽荀с
+\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。
.LP
-\f2\-iiop\fP 篏帥ｃ \f2rmic\fP 若喝冴罨＜遵荀靘羣鴻帥 Tie 障
-.RS 3
-
-.LP
+\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。
.nf
\f3
.fl
@@ -182,66 +155,60 @@
.fl
\fP
.fi
-.RE
.LP
-\f2\-iiop\fP 激с潟篏帥祉激с潟絎с障
+\f2\-iiop\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
-\-always 障 \-alwaysgenerate
-√鴻帥Tie IDL ュ鴻違с綣桁句眼障
+\-always または \-alwaysgenerate
+既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-nolocalstubs
-祉鴻ゃ≪潟泣若若絲障鴻帥篏障
+同じプロセスのクライアントとサーバーに対して最適化されたスタブを作成しません。
.TP 3
\-noValueMethods
-\f2\-idl\fP 激с潟篏帥違障肴 IDL \f2valuetype\fP ＜純喝絖菴遵障＜純喝絖\f2valuetype\fP 翫激с潟с \f2\-idl\fP 激с潟篏帥 \f2\-noValueMethods\fP 激с潟絎障
+これは \f2\-idl\fP オプションとともに使われなければなりません。発行された IDL に、\f2valuetype\fP メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、\f2valuetype\fP の場合はオプションです。 \f2\-idl\fP オプションを使うときは、 \f2\-noValueMethods\fP オプションを指定しない限り生成されます。
.TP 3
\-poa
-膓帥 \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP \f2org.omg.PortableServer.Servant\fP 紊障
+継承が \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP から \f2org.omg.PortableServer.Servant\fP に変わります。
.LP
.na
\f2Portable Object Adapter\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) \f2PortableServer\fP ≪吾ャ若ゃｃ \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違＜純箴障 ＜純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫ｃ泣若潟篏九勝若吟若若若ゃ障OMG IDL to Java Language Mapping SpecificationCORBA V 2.3.1 ptc/00\-01\-08.pdf 羣障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は Java の \f2org.omg.PortableServer.Servant\fP クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。
.RE
.TP 3
\-J
-\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝＜障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
+\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。
.TP 3
-\-keep 障 \-keepgenerated
-鴻帥鴻宴潟障 Tie 鴻 \f2.java\fP 純若鴻＜ゃ \f2.class\fP ＜ゃｃ罧障
+\-keep または \-keepgenerated
+スタブ、スケルトン、または Tie クラスのための \f2.java\fP ソースファイルを \f2.class\fP ファイルと同じディレクトリに残します。
.TP 3
\-nowarn
-茘障激с潟絎潟潟ゃ茘茵腓冴障
-.LP
+警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。
+.TP 3
+\-nowrite
+コンパイルしたクラスをファイルシステムに書き込みません。
.TP 3
\-vcompat
-1.1 1.2 筝≧鴻 JRMP 鴻帥潟若吾с潟篋с鴻帥潟鴻宴潟鴻篏障(5.0 篁ュ若鴻с激с潟)鴻帥鴻JDK 1.1 篁潟激潟若 1.1 鴻帥潟若吾с潟篏睡JDK 1.2 篁ラ篁潟激潟若 1.2 鴻帥潟若吾с潟篏睡障鴻宴潟鴻с1.1 1.2 筝≧鴻鴻帥潟若吾с潟泣若障鴻筝≧鴻篏≪若泣若泣ゃ冴紊с障
+1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(5.0 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。
.TP 3
\-verbose
-潟潟ゃ潟若潟潟ゃ鴻若鴻＜ゃゃ＜祉若吾茵腓冴障
-.LP
+コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。
.TP 3
\-v1.1
-1.1 JRMP 鴻帥潟若吾с潟帥鴻帥潟鴻宴潟鴻障激с潟篏睡сJDK 1.1 \f3rmic\fP 若х≪違若с (ゃ鴻若ｃ潟違篏睡) √鴻帥鴻絲障翫篋с鴻帥鴻翫с
-.LP
+1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。
.TP 3
\-v1.2
-() 1.2 JRMP 鴻帥潟若吾с潟帥鴻帥鴻障鴻宴潟鴻 1.2 鴻帥潟若吾с潟т戎с激с潟с鴻宴潟鴻障鴻帥鴻JDK 1.1 篁潟激潟若篏障
+(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。
.RE
.LP
-.SH "医紊"
-.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障罨＜箴腓冴障
-.RS 3
-
-.LP
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.nf
\f3
.fl
@@ -250,15 +217,12 @@
\fP
.fi
.RE
-.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-java(1)javac(1)
+java(1)、javac(1)、
.na
\f2CLASSPATH\fP @
.fi
--- a/jdk/src/solaris/doc/sun/man/man1/ja/rmid.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/rmid.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmid 1 "02 Jun 2010"
+.TH rmid 1 "14 Apr 2011"
.LP
-.SH ""
-rmid \- Java RMI 莎桁激鴻若≪
-.LP
-.RS 3
-
+.SH "名前"
+rmid \- Java RMI 起動システムデーモン
.LP
.LP
-\f3rmid\fP ц儀激鴻若≪潟紮吾с篁潟激 (VM) 脂蚊莎桁с障
+\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,23 +39,21 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmid\fP 若莎桁激鴻若≪潟紮障莎桁激鴻若≪潟紮с莎桁純吾с莎桁激鴻脂蚊VM ц儀с障莎桁純≪若吾с篏帥ｃ違篏号荅括完
+\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、
.na
-\f2Java RMI 篁罕\fP @
+\f2「Java RMI 仕様」\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html
+http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび
.na
-\f2莎桁ャ若≪\fP @
+\f2「起動のチュートリアル」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlс
+http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。
.LP
.LP
-若≪潟莎桁罨＜祉ャｃ若激若＜ゃ絎 \f2rmid\fP 潟潟絎茵障
+デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。
.LP
.nf
\f3
@@ -73,23 +65,23 @@
.LP
.LP
-\f3羈:\fP\f2rmid\fP Sun 絎茖絎茵翫с祉ャｃ若激若＜ゃ絎綽荀障 莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡с \f2rmid\fP 罎荐若сс鴻\f2ActivationGroupDesc\fP 潟潟鴻帥羝＜ \f2CommandEnvironment\fP 篁紙 \f2Properties\fP ｃ絎潟潟潟激с潟\f2rmid\fP 祉ャｃ若激若＜ゃ筝ф腓榊荐怨綽荀障\f2sun.rmi.activation.execPolicy\fP ｃ若ゃ莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡сゆ \f2rmid\fP 篏睡激若羆阪障
+\f3注:\fP \f2rmid\fP の Sun の 実装を実行する場合、デフォルトでは、セキュリティーポリシーファイルを指定する必要があります。それは、 \f2rmid\fP が起動グループ用に VM を起動するために各 \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを検証できるようにするためです。特に、ActivationGroupDesc のコンストラクタに渡される \f2CommandEnvironment\fP や任意の \f2Properties\fP によって指定される \f2コマンドおよび\fPオプションは、 \f2rmid\fP のセキュリティーポリシーファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fP プロパティーの値は、 \f2起動グループ用に VM を\fP 起動するために \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを判断するときに rmid が使用するポリシーを決定します。
.LP
.LP
-\f2rmid\fP 荐絎у茵罨＜茵障
+\f2rmid\fP をデフォルト設定で実行すると、次のような処理が行われます。
.LP
.RS 3
.TP 2
o
-≪ｃ若帥莎桁若 1098 у吾鴻莎桁
+アクティベータを起動し、デフォルトポート 1098 で内部レジストリを起動する
.TP 2
o
-吾鴻筝с\f2ActivationSystem\fP \f2java.rmi.activation.ActivationSystem\fP ゃ潟
+この内部レジストリの中で、 \f2ActivationSystem\fP を \f2java.rmi.activation.ActivationSystem という名前に\fP バインドする
.RE
.LP
.LP
-吾鴻祉若絎\f2rmid\fP 莎桁 \f2\-port\fP 激с潟絎違障罨＜箴腓冴障
+レジストリにほかのポートを指定するには、rmid の起動時に \f2\-port\fP オプションを \f2指定しなければなりません\fP。次に例を示します。
.LP
.nf
\f3
@@ -101,44 +93,42 @@
.LP
.LP
-潟潟莎桁激鴻若≪潟紮吾鴻若 1099 с吾鴻紮障
+このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート 1099 でレジストリを開始します。
.LP
.SS
-rmid inetd/xinetd 紮
+rmid を inetd/xinetd から開始する
.LP
.LP
-\f2rmid\fP 潟潟茵紮\f2inetd\fP (Solaris 翫)障 \f2xinetd\fP (Linux) 罕 \f2rmid\fP 綽荀綽紮号障
+\f2rmid\fP をコマンド行から開始するには、 \f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux の場合) を構成して \f2rmid\fP を必要に応じて開始する方法もあります。
.LP
.LP
-\f2rmid\fP 紮\f2System.inheritedChannel\fP ＜純若喝冴膓帥ｃ潟 (\f2inetd\fP/\f2xinetd\fP 膓) 緇障膓帥ｃ潟 \f2null\fP с\f2java.nio.channels.ServerSocketChannel\fP ゃ潟鴻帥潟鴻сｃ翫\f2rmid\fP ｃ潟 \f2inetd\fP/\f2xinetd\fP ｃ莎桁сゆ菴違莎桁障
+\f2rmid\fP を開始すると、System.inheritedChannel メソッドを呼び出して、継承されたチャンネル ( \f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。 継承されたチャンネルが \f2null\fP であるか、 \f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、 \f2rmid\fP rmid はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
.LP
.LP
-膓帥ｃ潟 \f2ServerSocketChannel\fP ゃ潟鴻帥潟鴻с翫鴻若≪若吾сゃ障 \f2java.rmi.activation.ActivationSystem\fP ゃ潟吾鴻 \f2java.rmi.activation.Activator\fP ≪若吾с絲障荀羆篆＜泣若若純宴\f2ServerSocketChannel\fP 緇 \f2java.net.ServerSocket\fP \f2rmid\fP с篏睡障≪若с\f2rmid\fP 篏罨＜ゃ 潟潟茵莎桁翫с
+継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、 \f2rmid\fP はエクスポートするリモートオブジェクト、つまり java.rmi.activation.ActivationSystem がバインドされているレジストリと java.rmi.activation.Activator リモートオブジェクトに対する要求を受信するサーバーソケットとして、ServerSocketChannel から取得した java.net.ServerSocket を使用します。 このモードでは、 \f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。
.LP
.RS 3
.TP 2
o
-\f2System.err\fP 絲障阪＜ゃゃ＜ゃ \f2java.io.tmpdir\fP 激鴻ｃ若ф絎ｃ (絽吾 \f2/var/tmp\fP 障 \f2/tmp\fP) ＜ゃ･莨 \f2rmid\-err\fP с･絨乗 \f2"tmp"\fP с
+\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。ファイル名の接頭辞は \f2"rmid\-err"\fP で、接尾辞は \f2"tmp"\fP である
.TP 2
o
-\f2\-port\fP 激с潟激с潟絎\f2rmid\fP 若＜祉若吾冴腟篋
+\f2\-port\fP オプションは拒否される。このオプションを指定すると、 \f2rmid\fP はエラーメッセージを出して終了する
.TP 2
o
-\f2\-log\fP 激с潟綽激с潟絎\f2rmid\fP 若＜祉若吾冴腟篋
+\f2\-log\fP オプションは必須。このオプションを指定しないと、 \f2rmid\fP はエラーメッセージを出して終了する
.RE
.LP
.LP
-綽荀綽泣若鴻紮荐絎荅括完ゃ\f2inetd\fP (Solaris) 障 \f2xinetd\fP (Linux) ャ≪若吾с
+必要に応じてサービスを開始するように設定する詳細については、 \f2inetd\fP (Solaris) または \f2xinetd\fP (Linux) のマニュアルページを参照してください。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-C<someCommandLineOption>
-\f2rmid\fP 絖祉 (莎桁違若) 篏絖祉鴻潟潟茵綣違羝＜激с潟絎障違罨＜絎莎桁激鴻若 潟ｃ篁潟激潟ｃ若羝＜с障
+\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各仮想マシンにプロパティーを渡すことができます。
.nf
\f3
.fl
@@ -146,7 +136,7 @@
.fl
\fP
.fi
-潟潟茵綣違絖祉鴻羝＜罘純違茵翫箴水с違罨＜潟潟絎茵с障
+コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。
.nf
\f3
.fl
@@ -154,11 +144,11 @@
.fl
\fP
.fi
-潟潟鴻絖 VM с泣若弱若喝冴違篏障
+このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。
.LP
.TP 3
\-J<someCommandLineOption>
-\f2rmid\fP 絎茵 \f2java\fP ゃ潟帥帥羝＜激с潟絎障違\f2rmid\fP \f2rmid.policy\fP 激若＜ゃ篏睡絎\f2rmid\fP 潟潟茵 \f2\-J\fP 激с潟篏帥ｃ\f2java.security.policy\fP ｃ若絎臂障 罨＜箴腓冴障
+rmid を実行している \f2java\fP インタプリタに渡すオプションを指定します。 たとえば、 \f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、rmid のコマンド行で \f2\-J\fP オプションを使って、 \f2java.security.policy\fP プロパティーを定義します。 次に例を示します。
.nf
\f3
.fl
@@ -168,16 +158,15 @@
.fi
.TP 3
\-J\-Dsun.rmi.activation.execPolicy=<policy>
-莎桁違若絎茵 VM 莎桁篏睡潟潟潟潟潟茵激с潟с\f2rmid\fP ｡激若絎障激с潟Java RMI 莎桁若≪潟 Sun 絎茖絖羈潟潟茵ｃ若絎翫腟 \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP 絎翫障\f2<policy>\fP 絎純ゃ\f2default\fP\f2<policyClassName>\fP障 \f2none\fP с ゃゃ茯障
-.LP
+起動グループが実行されることになる VM の起動に使用するコマンドおよびコマンド行オプションをチェックするために、 \f2rmid\fP が採用するポリシーを指定します。このオプションは、Java RMI 起動デーモンの Sun の実装だけに存在することに注意してください。コマンド行にこのプロパティーを指定しない場合、結果は \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP を指定した場合と同じになります。\f2<policy>\fP に指定可能な値は、\f2default\fP、\f2<policyClassName>\fP、または \f2none\fP です。
.RS 3
.TP 2
o
-\f3default (障ｃ若絎翫)\fP
+\f3default (または、このプロパティーが「指定されていない」場合)\fP
.LP
- \f2execPolicy\fP 翫\f2rmid\fP 絎茵с\f2rmid\fP 篏睡 祉ャｃ若激若＜ゃ筝с絎茵罔 \f2rmid\fP 筝潟潟潟潟潟茵激с潟с絎茵激若т戎с莎桁違若絎茖с
+デフォルトの \f2execPolicy\fP の場合、 \f2rmid\fP が実行できるのは、 \f2rmid\fP が使用するセキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。
.LP
-\f2rmid\fP 莎桁違若 VM 莎桁違若ゃ脂蚊莎桁違若荐菴医с \f2ActivationGroupDesc\fP 宴篏睡障違若荐菴医\f2ActivationGroupDesc.CommandEnvironment\fP 絎障 (ュ) 莎桁違若紮潟潟潟潟茵菴遵с潟潟茵激с潟障障с\f2rmid\fP \f2java.home\fP \f2java\fP 潟潟篏睡障違若荐菴医激с潟潟潟茵菴遵ｃ若若若ゃ障障 ｃ若罨＜絎臂障
+\f2rmid は、\fP 起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、 \f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、 \f2rmid は\fP java.home にある \f2java\fP コマンドを使用します。 グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。このプロパティーは、次のように定義します。
.nf
\f3
.fl
@@ -186,33 +175,33 @@
\fP
.fi
.LP
-≪祉号┤ \f2com.sun.rmi.rmid.ExecPermission\fP 篏睡違若荐菴医 \f2CommandEnvironment\fP ф絎潟潟絎茵莎桁違若紮罔\f2rmid\fP 絲障荐怨с障≪祉号┤ \f2com.sun.rmi.rmid.ExecOptionPermission\fP 篏睡違若荐菴医сｃ若若若ゃ絎潟潟茵激с潟障 \f2CommandEnvironment\fP с激с潟絎潟潟茵激с潟莎桁違若紮 \f2rmid\fP 篏睡с障
+アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、 \f2rmid\fP に対して、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに rmid が使用できるようになります。
.LP
-\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障
+\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。
.RS 3
.TP 3
ExecPermission
-\f2ExecPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟絎茵罔茵障
+\f2ExecPermission\fP クラスは、起動グループを開始するために \f2rmid が\fP 特定の「コマンド」を実行する権限を表します。
.LP
-\f3罕\fP
+\f3構文\fP
.br
-\f2ExecPermission\fP \f2rmid\fP 絎茵荐怨潟潟劫с/* (/＜ゃ阪絖 \f2File.separatorChar\fP) х劫ｃ障鴻＜ゃ腓冴障/\-х劫ｃ障鴻＜ゃ泣ｃ (絽亥) 腓冴障劫劫ャ若潟<<ALL FILES>>絎翫\f3篁紙\fP＜ゃ腓冴障
+\f2ExecPermission\fP の「名前」は、 \f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 File.separatorChar) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。 「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。
.LP
-\f3羈:\fP* 1 ゆ絎劫憜ｃ鴻＜ゃ茵障 障\- 1 ゆ絎劫憜ｃ鴻＜ゃ憜ｃ障鴻＜ゃ泣ｃ (絽亥) 茵障
+\f3注:\fP 「*」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルを表します。また、「\-」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルと、現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
.TP 3
ExecOptionPermission
-\f2ExecOptionPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟茵激с潟篏睡с罔茵障\f2ExecOptionPermission\fP 潟潟茵激с潟ゃс
+\f2ExecOptionPermission\fP クラスは、起動グループを開始するときに \f2rmid は、起動グループを開始するコマンドをまったく検証しません。\fP 特定のコマンド行「オプション」を使用できる権限を表します。 \f2ExecOptionPermission\fP の「名前」は、コマンド行オプションの値です。
.LP
-\f3罕\fP
+\f3構文\fP
.br
-激с潟сゃ若絎泣若障≪鴻帥鴻ゃ若茵障 ≪鴻帥鴻激с喝篏睡с障 ゃ障篁紙激с潟茵с障 障激с喝絨障篏睡с障 .=翫≪鴻帥鴻絎綽荀障
+オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。
.LP
-箴腓冴障*\-Dfoo.*\-Da.b.c=*鴻с*foo\-Da*bab*≦鴻с
+例を示します。「*」、「\-Dfoo.*」、「\-Da.b.c=*」は有効ですが、「*foo」、「\-Da*b」、「ab*」は無効です。
.TP 3
-rmid 激若＜ゃ
-\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障≪祉号┤с \f2rmid\fP с≪祉号┤羆荐怨絎с
+rmid のポリシーファイル
+\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。これらのアクセス権をチェックするのは \f2rmid\fP だけなので、これらのアクセス権を汎用的に許可しても安全です。
.LP
-\f2rmid\fP 腮絎茵罔荐怨激若＜ゃ箴罨＜腓冴障
+rmid に各種の実行権限を許可するポリシーファイルの例を、次に示します。
.nf
\f3
.fl
@@ -220,13 +209,7 @@
.fl
permission com.sun.rmi.rmid.ExecPermission
.fl
- "/files/apps/java/jdk1.2.2/solaris/bin/java";
-.fl
-
-.fl
- permission com.sun.rmi.rmid.ExecPermission
-.fl
- "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
+ "/files/apps/java/jdk1.7.0/solaris/bin/java";
.fl
.fl
@@ -256,29 +239,21 @@
.fl
\fP
.fi
- 2 ゃ篁筝≪祉号┤\f2rmid\fP 絲障劫腓榊絎 \f2java\fP 潟潟 \f2java_g\fP 潟潟 1.2.2 若吾с潟絎茵荐怨障с\f2java.home\fP 若吾с潟 \f2java\fP 潟潟 (\f2rmid\fP 篏睡若吾с) 篏睡潟潟激若＜ゃф絎綽荀障3 ≪祉号┤\f2rmid\fP 絲障ｃ \f2/files/apps/rmidcmds\fP 篁紙潟潟絎茵罔荐怨障
-.LP
-4 ≪祉号┤ \f2ExecOptionPermission\fP \f2rmid\fP 絲障祉ャｃ若激若＜ゃ \f2/files/policies/group.policy\fP 絎臂莎桁違若紮荐怨障5 ≪祉号┤莎桁違若 \f2java.security.debug\fP ｃ若篏睡荐怨障緇≪祉号┤莎桁違若 \f2sun.rmi\fP ｃ弱絮ゅ篁紙ｃ若篏睡荐怨障
+最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンド ( \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
.LP
-激若＜ゃ絎 \f2rmid\fP 莎桁\f2rmid\fP 潟潟茵 \f2java.security.policy\fP ｃ若絎綽荀障 罨＜箴腓冴障
-.RS 3
-
+3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。
.LP
+ポリシーファイルを指定して \f2rmid\fP を起動するには、rmid のコマンド行で \f2java.security.policy\fP プロパティーを指定する必要があります。 次に例を示します。
.LP
-\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
-.LP
+\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
.RE
-.RE
-.TP 2
-o
-.LP
.TP 2
o
\f4<policyClassName>\fP
.LP
-篏с荵с緇翫膊∞\f2rmid\fP 莎桁\f2checkExecCommand\fP ＜純絮鴻絎rmid 絎茵潟潟сс障
+デフォルトの動作では十分な柔軟性が得られない場合、管理者は、 \f2rmid\fP の起動時に、 \f2checkExecCommand\fP メソッドが所属するクラスの名前を指定して、rmid が実行するコマンドをチェックすることができます。
.LP
-\f2policyClassName\fP 綣違潟潟鴻帥＜罨＜ \f2checkExecCommand\fP ＜純絎茖 public 鴻絎障
+\f2policyClassName\fP には、引数なしのコンストラクタを持ち、次のような \f2checkExecCommand\fP メソッドを実装している public クラスを指定します。
.nf
\f3
.fl
@@ -290,22 +265,21 @@
.fl
\fP
.fi
-莎桁違若紮\f2rmid\fP 激若 \f2checkExecCommand\fP ＜純若喝冴障莎桁違若荐菴医莎桁違若紮絎潟潟＜純羝＜障\f2checkExecCommand\fP \f2SecurityException\fP 鴻若\f2rmid\fP 莎桁違若紮吾с莎桁荅茵若喝冴眼 \f2ActivationException\fP 鴻若障
-.LP
+起動グループを開始する前に、 \f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。 \f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、 \f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。
.TP 2
o
\f3none\fP
.LP
-\f2sun.rmi.activation.execPolicy\fP ｃ若ゃnone翫\f2rmid\fP 莎桁違若紮潟潟障ｃ閌荐若障
+\f2sun.rmi.activation.execPolicy\fP プロパティーの値が「none」の場合、 \f2rmid\fP は、起動グループを開始するコマンドをまったく検証しません。
.RE
.LP
.TP 3
\-log dir
-莎桁激鴻若≪潟若帥若鴻渇∫ｆ宴吾莨若篏帥ｃ絎障с\f2rmid\fP 潟潟絎茵ｃ\f2log\fP 違ｃ篏障
+起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに、 \f2log\fP というログディレクトリが作成されます。
.LP
.TP 3
\-port port
-\f2rmid\fP 吾鴻篏帥若絎障莎桁激鴻若≪潟吾鴻筝с\f2java.rmi.activation.ActivationSystem\fP \f2ActivationSystem\fP ゃ潟障ｃ若激割 \f2ActivationSystem\fP 罨＜ \f2Naming.lookup\fP ＜純若喝冴ｃ緇с障
+\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、 \f2java.rmi.activation.ActivationSystem\fP という名前でActivationSystem をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。
.nf
\f3
.fl
@@ -322,16 +296,16 @@
.fi
.TP 3
\-stop
-\f2\-port\fP 激с潟ｃ絎若憜 \f2rmid\fP 若喝冴罩≪障若絎翫若 1098 у茵 \f2rmid\fP 罩≪障
+\-port オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。 ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。
.RE
-.SH "医紊"
+
.LP
-
+.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
-若吟弱臂鴻吾鴻激鴻絎障ｃ潟潟у蚊障箴腓冴障
+ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。
.nf
\f3
.fl
@@ -342,15 +316,13 @@
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
-rmic(1)
+rmic(1)、
.na
\f2CLASSPATH\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathjava(1)
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1)
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,18 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH rmiregistry 1 "02 Jun 2010"
+.TH rmiregistry 1 "14 Apr 2011"
.LP
-.SH ""
-rmiregistry \- Java ≪若吾с吾鴻
+.SH "名前"
+rmiregistry \- Java リモートオブジェクトレジストリ
.LP
.RS 3
+\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。
+.RE
.LP
-.LP
-\f3rmiregistry\fP 潟潟憜鴻絎若筝≪若吾с吾鴻紮障
-.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,52 +41,43 @@
.fi
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3rmiregistry\fP 潟潟憜鴻絎 \f2port\fP 筝≪若吾с吾鴻篏紮障\f2port\fP 絎ャ翫吾鴻若 1099 ч紮障\f3rmiregistry\fP 潟潟阪罘純障絽吾違潟у茵障箴腓冴障
+\f3rmiregistry\fP コマンドは、現在のホストの指定 \f2port\fP 上にリモートオブジェクトレジストリを作成し、開始します。\f2port\fP の指定を省略した場合、レジストリはポート 1099 で開始します。\f3rmiregistry\fP コマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。例を示します。
.LP
.LP
\f2rmiregistry&\fP
.LP
.LP
-≪若吾с吾鴻若鴻若泣若鴻с 筝鴻 RMI 泣若若≪若吾сゃ潟篏睡障罨＜若潟≪若鴻ゃ≪潟≪若吾с罎膣≪≪若＜純若喝冴茵障
+リモートオブジェクトレジストリは、ブートストラップのネームサービスです。同一ホストの RMI サーバーが、リモートオブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモートホストのクライアントはリモートオブジェクトを検索し、リモートメソッドの呼び出しを行います。
.LP
.LP
-吾鴻筝≪若吾с篏臀絎障 с≪宴若激с潟＜純若喝冴綽荀障篁ｃｃ吾с≪宴若激с恰絎泣若箴篁吾с｢障
+レジストリは、一般的に、最初のリモートオブジェクトの位置を指定します。 そこで、アプリケーションはメソッドを呼び出す必要があります。代わって、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
.LP
.LP
-\f2java.rmi.registry.LocateRegistry\fP 鴻＜純若鴻障若鴻若у篏吾鴻緇篏睡障
+\f2java.rmi.registry.LocateRegistry\fP クラスのメソッドは、ローカルホスト、またはローカルホストとポートで動作するレジストリを取得するために使用されます。
.LP
.LP
-\f2java.rmi.Naming\fP 鴻 URL 若鴻＜純吾鴻у篏篁紙鴻潟若鴻筝≪若吾с罎膣≪篏睡障≪若吾с膣 (絖) ゃ潟違ゃ潟 (ゃゃ潟若若ゃ) 障 障≪若吾с≪潟ゃ潟吾鴻ゃ潟 URL 阪障
+\f2java.rmi.Naming\fP クラスの URL ベースのメソッドは、レジストリで動作し、任意のホストおよびローカルホスト上のリモートオブジェクトの検索に使用されます。リモートオブジェクトに単純な (文字列) 名前をバインドしたり、新しい名前をリバインド (古いバインドにオーバーライド) します。またリモートオブジェクトをアンバインドしたり、レジストリにバインドされた URL を出力します。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-J
-\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝＜障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
+\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
-
-.LP
-.LP
-java(1)
+java(1)、
.na
\f2java.rmi.registry.LocateRegistry\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html
+http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および
.na
\f2java.rmi.Naming\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
-.LP
-
+http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
--- a/jdk/src/solaris/doc/sun/man/man1/ja/schemagen.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/schemagen.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,110 +19,106 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH schemagen 1 "02 Jun 2010"
+.TH schemagen 1 "14 Apr 2011"
.LP
-.SH ""
-schemagen \- XML ゃ潟 Java(TM) ≪若ｃ若鴻若吾с若
-.LP
-.LP
-\f3篁罕若吾с:\fP 2.1
-.br
-\f3絎茖若吾с:\fP 2.1.3
-.LP
-.SS
-schemagen 莎桁
+.SH "名前"
+schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ
.LP
.LP
-鴻若吾с若帥若吟若若 \f2bin\fP ｃ \f2schemagen\fP 激с鴻篏帥ｃ莎桁с障
+\f3仕様バージョン:\fP 2.1
+.br
+\f3実装バージョン:\fP 2.1.3
.LP
-.LP
-憜鴻若吾с若帥Java 純若鴻＜ゃ鴻＜ゃс障
+.SH "schemagen の起動"
.LP
.LP
-障鴻若吾с若帥絎茵 Ant 帥鴻障
+スキーマジェネレータを起動するには、ユーザーのプラットフォームの bin ディレクトリ内にある \f2適切な schemagen シェルスクリプト\fP を使用 \f2します\fP 。
+.LP
+.LP
+現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
+.LP
+.LP
+また、スキーマジェネレータを実行するための Ant タスクも用意されています。
.na
-\f2schemagen Ant 篏睡\fP @
+\f2schemagen を Ant とともに使用する\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlс
-.LP
-.RS 3
-
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。
.LP
.nf
\f3
.fl
% schemagen.sh Foo.java Bar.java ...
.fl
-羈: Writing schema1.xsd
+Note: Writing schema1.xsd
.fl
\fP
.fi
-.RE
.LP
.LP
-若吟若 Java 純若/鴻祉鴻с翫激鴻 CLASSPATH 医紊亥宴с鴻≪祉鴻сｃ \f2\-classpath\fP/\f2\-cp\fP 激с潟篏帥ｃ鴻若絎綽荀障鴻若若榊障
-.LP
-.RS 3
-
+ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP を使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
.LP
-\f3潟潟茵激с\fP
-.LP
-.RS 3
-
+.SS
+コマンド行オプション
.LP
.nf
\f3
.fl
-篏睡号: schemagen [\-options ...] <java files>
+使用方法: schemagen [\-options ...] <java files>
.fl
.fl
-激с:
+オプション:
+.fl
+ \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します。
.fl
- \-d <path> : 祉泣 javac 鴻＜ゃ臀贋絎障
+ \-cp <path> : ユーザー指定ファイルの検索場所を指定します。
+.fl
+ \-classpath <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
- \-cp <path> : 若吟惹絎＜ゃ罎膣√贋絎障
+ \-encoding <encoding> : apt/javac 呼び出しに使用されるエンコーディングを指定します。
+.fl
+
.fl
- \-classpath <path> : 若吟惹絎＜ゃ罎膣√贋絎障
+ \-episode <file> : 個別コンパイル用のエピソードファイルを生成します。
.fl
- \-help : 篏睡号≪＜祉若吾茵腓冴障
+ \-version : バージョン情報を表示します。
+.fl
+ \-help : この使用方法に関するメッセージを表示します。
.fl
\fP
.fi
-.RE
.LP
-.RE
-.SS
-純若鴻＜ゃ
+.SH "生成されるリソースファイル"
.LP
.LP
-憜鴻若吾с若帥膣Java 劫ус腥咲 1 ゃ鴻若＜ゃ篏障鴻若＜ゃ九勝号憝鴻с絖障
+現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、
.na
-\f2鴻若吾с若帥 Ant 帥鴻\fP @
+\f2スキーマジェネレータの ant タスク\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html篏睡
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlを使用してください。
.LP
-.SH "∫ｉ"
+.SH "名前"
+関連項目
.LP
.RS 3
.TP 2
o
-鴻若吾с若帥絎茵 (schemagen):[
+スキーマジェネレータの実行 (schemagen): [
.na
-\f2潟潟茵巡擦\fP @
+\f2コマンド行の命令\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html
+https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html、
.na
-\f2SchemaGen Ant 篏睡\fP @
+\f2SchemaGen を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
.TP 2
o
.na
-\f2XML ゃ潟 JavaTM ≪若ｃ (JAXB)\fP @
+\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
--- a/jdk/src/solaris/doc/sun/man/man1/ja/serialver.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/serialver.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH serialver 1 "02 Jun 2010"
+.TH serialver 1 "14 Apr 2011"
.LP
-.SH ""
-serialver \- 激≪若吾с潟潟潟
-.LP
-.RS 3
-
+.SH "名前"
+serialver \- シリアルバージョンコマンド
.LP
.LP
-\f3serialver\fP 潟潟 \f2serialVersionUID\fP 菴障
+\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
.LP
-.RE
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.nf
\f3
@@ -45,74 +39,54 @@
.LP
.RS 3
-
-.LP
-.RS 3
.TP 3
options
-ャ＜潟ц潟潟茵激с潟с
+このドキュメントで説明されているコマンド行オプションです。
.TP 3
classnames
-1 や札筝劫с
+1 つ以上のクラス名です。
.RE
.LP
-.RE
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f3serialver\fP 1 や札筝鴻 \f2serialVersionUID\fP 絮鴻吾潟若綵√ц障綣違絎у若喝冴篏睡号茵腓冴障
+\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
-\-classpath <: у阪ｃ zip jar ＜ゃ>
-≪宴若激с潟鴻潟純若鴻罎膣≪鴻荐絎障
+\-classpath <: で区切られたディレクトリと zip や jar ファイル>
+アプリケーションのクラスおよびリソースの検索パスを設定します。
.RE
.LP
.RS 3
.TP 3
\-show
-膂≦若吟若ゃ潟帥с若鴻茵腓冴障絎絎劫ュEnter 若 [Show] 帥潟若激≪若吾с UID 茵腓冴障
+簡単なユーザーインタフェースを表示します。完全指定のクラス名を入力して、Enter キーか「Show」ボタンを押し、シリアルバージョン UID を表示します。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
-.SH "羈"
-.LP
-
+.SH "注"
.LP
.LP
-\f3serialver\fP 潟潟絎鴻篁潟激喝茯粋昭у障с祉ャｃ若若吾ｃ若荐絎茵障篆♂若с鴻 \f3serialver\fP 絎茵翫罨＜激с潟篏帥ｃ祉ャｃ若若吾ｃ若荐絎с障
-.LP
-.RS 3
-
+\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。
.LP
.LP
\f2\-J\-Djava.security.manager\fP
.LP
-.RE
.LP
-障綽荀с違罨＜激с潟篏帥ｃ祉ャｃ若激若絎с障
-.LP
-.RS 3
-
+また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。
.LP
.LP
\f2\-J\-Djava.security.policy=<policy file>\fP
.LP
-.RE
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
.LP
.na
--- a/jdk/src/solaris/doc/sun/man/man1/ja/servertool.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/servertool.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,20 +19,14 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH servertool 1 "02 Jun 2010"
+.TH servertool 1 "14 Apr 2011"
.LP
-.SH ""
-servertool \- Java(TM) IDL 泣若若若
-.LP
-.RS 3
-
+.SH "名前"
+servertool \- Java(TM) IDL サーバーツール
.LP
-\f3servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障
-.RE
-.SH "綵√"
-.LP
-
+\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。
+.SH "形式"
.LP
.nf
\f3
@@ -44,84 +38,76 @@
.LP
.LP
-潟潟ュ \f2servertool\fP 莎桁潟潟茵若 \f2servertool >\fP 潟茵腓冴障\f2servertool >\fP 潟潟潟ュ障
+コマンドを入力しないで \f2servertool\fP を起動すると、コマンド行ツールとして \f2servertool >\fP プロンプトが表示されます。\f2servertool >\fP プロンプトにコマンドを入力します。
.LP
.LP
-潟潟ュ \f2servertool\fP 莎桁Java IDL 泣若若若莎桁潟潟絎茵腟篋障
+コマンドを入力して \f2servertool\fP を起動すると、Java IDL サーバーツールが起動し、コマンドを実行して終了します。
.LP
.LP
-\f2\-ORBInitialPort\fP \f2nameserverport\fP 激с潟\f3綽\fPс\f2nameserverport\fP ゃ\f2orbd\fP 絎茵篆∴羆緇罘若絎綽荀障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 \f2nameserverport\fP 1024 障 1024 紊с若篏睡с障
+\f2\-ORBInitialPort\fP \f2nameserverport\fP オプションは\f3必須\fPです。 \f2nameserverport\fP の値には、\f2orbd\fP が実行され、着信要求を待機しているポートを指定する必要があります。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、\f2nameserverport\fPとして 1024 以上のポート番号を使用することをお勧めします。
.LP
-.SH "茯"
-.LP
-
+.SH "説明"
.LP
.LP
-\f2servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障祉泣若若≪障障腟沿宴緇潟潟箴障
+\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-ORBInitialHost nameserverhost
-若泣若若絎茵篆∴羆緇罘鴻激潟絎障激с潟絎翫\f2nameserverhost\fP \f2localhost\fP 荐絎障\f2orbd\fP \f2servertool\fP 違激割у茵翫\f2orbd\fP 絎茵鴻 IP ≪鴻絎綽荀障
+ネームサーバーが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、\f2nameserverhost\fP はデフォルトで \f2localhost\fP に設定されます。\f2orbd\fP と \f2servertool\fP が異なるマシン上で実行されている場合は、\f2orbd\fP が実行されているホストの名前と IP アドレスを指定する必要があります。
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.SH "潟潟"
-.LP
-
+.SH "コマンド"
.LP
.RS 3
.TP 3
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
-Object Request Broker Daemon (ORBD) 域膓泣若若脂蚊障泣若若脂蚊翫脂蚊莎桁障潟潟ｃ\f2\-server\fP 激с潟цャ泣若若＜ゃ潟劫сゃ潟鴻若＜純若喝冴障ゃ潟鴻若＜純\f2public static void install(org.omg.CORBA.ORB)\fP ｃ綽荀障ゃ潟鴻若＜純激с潟с若帥若鴻鴻若篏泣若若ゃ潟鴻若篏肴絎с障
+Object Request Broker Daemon (ORBD) に新規持続サーバーを登録します。サーバーが未登録の場合、登録して起動します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でインストールメソッドが呼び出されます。このインストールメソッドは、\f2public static void install(org.omg.CORBA.ORB)\fP になっている必要があります。インストールメソッドは、オプションであり、データベーススキーマの作成などの独自のサーバーインストール動作を開発者が指定できます。
.TP 3
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-泣若 ID 障≪宴若激с喝篏睡ORBD 泣若若脂蚊茹ｉゃ障潟潟ｃ\f2\-server\fP 激с潟цャ泣若若＜ゃ潟劫с≪潟ゃ潟鴻若＜純若喝冴障≪潟ゃ潟鴻若＜純\f2public static void uninstall(org.omg.CORBA.ORB)\fP ｃ綽荀障≪潟ゃ潟鴻若＜純激с潟сゃ潟鴻若＜純篏羔泣若若≪潟ゃ潟鴻若篏肴絎с障
+サーバー ID またはアプリケーション名を使用して、ORBD のサーバーの登録を解除します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でアンインストールメソッドが呼び出されます。このアンインストールメソッドは、\f2public static void uninstall(org.omg.CORBA.ORB)\fP になっている必要があります。アンインストールメソッドは、オプションであり、インストールメソッドの動作の取り消しなどの独自のサーバーアンインストール動作を開発者が指定できます。
.TP 3
getserverid \-applicationName\ <application\ name>
-≪宴若激с潟∫ｄ泣若 ID 菴障
+アプリケーションに関連付けられているサーバー ID を返します。
.TP 3
list
-ORBD 脂蚊鴻膓泣若若≪宴筝荀ц；腓冴障
+ORBD に登録されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
listappnames
-憜 ORBD 脂蚊鴻泣若若≪宴若激с喝筝荀ц；腓冴障
+現在 ORBD に登録されているすべてのサーバーのアプリケーション名を一覧表示します。
.TP 3
listactive
-ORDB ｃ莎桁憜絎茵鴻膓泣若若≪宴筝荀ц；腓冴障
+ORDB によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
-脂蚊泣若若т鴻 ORB 劫ゃ腴 (若) 罎冴障泣若若絎茵翫莎桁障腴鴻絎翫泣若若 ORB ∫ｄ plain 障 non\-protected 腴鴻菴障
+登録されたサーバーで作成したすべての ORB の特定の型について端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。端点の型が指定されていない場合、サーバーの ORB ごとに関連付けられている plain 型 または non\-protected 型の端点が返されます。
.TP 3
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
-脂蚊泣若若劫 ORB х脂蚊腴 (若) 罎冴障泣若若絎茵翫莎桁障\f2orbid\fP 絎翫ゃ""\f2orbid\fP蚊綵障ORB 腥堺絖 \f2orbid\fP т翫脂蚊若鴻菴障
+登録されたサーバーの特定の ORB で登録された端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。\f2orbid\fP が指定されていない場合は、デフォルト値の「""」が\f2orbid\fPに割り当てられます。ORB が空文字列の \f2orbid\fP で作成されている場合、登録したポートがすべて返されます。
.TP 3
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-泣若寂絎臂 ORB ORBId 筝荀ц；腓冴障ORBId 泣若若т ORB 絖с泣若若絎茵翫莎桁障
+サーバー上に定義された ORB の ORBId を一覧表示します。ORBId はサーバーで作成された ORB の文字列名です。サーバーが実行されていない場合、起動されます。
.TP 3
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-ORBD 脂蚊≪ｃ泣若若罩≪障潟潟絎茵筝\f2\-serverid\fP ＜若帥障 \f2\-applicationName\fP ＜若帥ф絎劫絎臂 \f2shutdown()\fP ＜純若喝冴泣若若祉鴻罩ｃ罩≪障
+ORBD に登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\f2\-serverid\fP パラメータまたは \f2\-applicationName\fP パラメータで指定されたクラス内に定義された \f2shutdown()\fP メソッドも呼び出されてサーバープロセスを正しく停止します。
.TP 3
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
-ORBD 脂蚊泣若若莎桁障泣若若絎茵翫潟潟с泣若若莎桁障泣若若с絎茵翫若吟若若＜祉若吾菴障
+ORBD に登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーを起動します。サーバーがすでに実行されている場合は、ユーザーにエラーメッセージが返されます。
.TP 3
help
-泣若若泣若若若т戎с鴻潟潟茵腓冴障
+サーバーがサーバーツールで使用できるすべてのコマンドを表示します。
.TP 3
quit
-泣若若若腟篋障
+サーバーツールを終了します。
.RE
.LP
-.SH "∫ｉ"
-.LP
-
+.SH "関連項目"
.LP
orbd(1)
--- a/jdk/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,59 +19,59 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH tnameserv 1 "02 Jun 2010"
+.TH tnameserv 1 "14 Apr 2011"
.LP
-.SH ""
-Java IDL:筝若泣若 \- \f2tnameserv\fP
+.SH "名前"
+Java IDL: 一時ネームサービス \- \f2tnameserv\fP
.LP
.LP
-ャ＜潟сJava IDL 筝若泣若 \f2tnameserv\fP 篏睡号ゃ茯障Java IDL Object Request Broker Daemon (ORBD) 障障ORBD 若鴻泣若鴻筝若泣若鴻\f3膓\fP若泣若鴻潟泣若若若吾ｃ若若≪潟祉鴻сJava IDL 鴻ャ若≪с ORBD 篏睡障筝若泣若鴻篏睡箴с\f2orbd\fP 篁ｃ \f2tnameserv\fP 篏睡с障\f2orbd\fP 若荅括完ゃ\f2orbd\fP orbd(1)障
+このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には、Object Request Broker Daemon (ORBD) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャーを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD を使用していますが、一時ネームサービスを使用する例では、\f2orbd\fP の代わりに \f2tnameserv\fP を使用できます。\f2orbd\fP ツールの詳細については、orbd の orbd(1)または
.na
-\f2ORBD 障 Java IDL 若泣若\fP @
+\f2ORBD に含まれる Java IDL ネームサービス\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html≪с
+http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。
.LP
.LP
-с篁ヤゃ茯障
+ここでは、以下の項目について説明します。
.LP
.RS 3
.TP 2
o
-Java\ IDL 筝若泣若
+Java\ IDL 一時ネームサービス
.TP 2
o
-Java\ IDL 筝若泣若鴻莎桁
+Java\ IDL 一時ネームサービスの起動
.TP 2
o
-Java\ IDL 筝若泣若鴻罩
+Java\ IDL 一時ネームサービスの停止
.TP 2
o
-泣潟ゃ≪潟:腥咲吾吾с菴遵
+サンプルクライアント: 名前空間へのオブジェクトの追加
.TP 2
o
-泣潟ゃ≪潟:腥咲
+サンプルクライアント: 名前空間のブラウズ
.RE
.LP
-.SH "Java\ IDL 筝若泣若"
+.SH "Java IDL 一時ネームサービス"
.LP
.LP
-CORBA COS (Common Object Services) 若泣若鴻＜ゃ激鴻＜ゃ絲障ｃ罕箴吾сс絲障惹ｃ箴障Java IDL 筝若泣若鴻с \f2tnameserv\fP COS 若泣若鴻篁罕膣綵≪у茖с
+CORBA の COS (Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDL の一時ネームサービスである \f2tnameserv\fP は、COS ネームサービスの仕様を単純な形で実装したものです。
.LP
.LP
-吾сс腥咲ф主吾сс≪若ゃ潟ｃ潟違若違障若ゃ潟ｃ潟違若潟違潟潟鴻腟粋昭с障若潟違潟潟鴻篏若ゃ潟ｃ潟違с＜ゃ激鴻泣ｃ膩罘純＜障鴻ゃ潟ｃ潟違若潟違潟潟鴻主障腥咲若潟違潟潟鴻筝膓ゃ潟ｃ潟違с 篁ュ若潟違潟潟鴻Java IDL 若潟違泣若鴻祉鴻罩≪莎桁紊宴障
+オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納されます。名前空間において、初期ネーミングコンテキストは唯一の持続的バインディングです。それ以外のネーミングコンテキストは、Java IDL のネーミングサービスプロセスが停止し、再起動されると失われます。
.LP
.LP
-≪障≪宴若激с潟 COS 若泣若鴻篏睡 ORB 若泣若鴻篏鴻若ャｃ若泣若鴻絖若潟違潟潟鴻≪祉鴻с違障若泣若鴻Java\ IDL 若泣若鴻с篁 COS 羣若泣若鴻с障障
+アプレットまたはアプリケーションから COS ネームサービスを使用するためには、その ORB はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの文字列化された初期ネーミングコンテキストにアクセスできなければなりません。ネームサービスは、Java IDL のネームサービスでもその他の COS 準拠のネームサービスでもかまいません。
.LP
-.SH "Java\ IDL 筝若泣若鴻莎桁"
+.SH "Java IDL 一時ネームサービスの起動"
.LP
.LP
-Java\ IDL 若泣若鴻若泣若鴻篏睡≪宴若激с潟障≪莎桁違障Java\ IDL 茖遵ゃ潟鴻若Java IDL 若泣若鴻莎桁鴻 (Solaris: \f2tnameserv\fP) 絎茵純＜ゃ (Windows NT: \f2tnameserv.exe\fP) 篏障違潟у篏若泣若鴻莎桁
+Java IDL ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。バックグラウンドで動作するように、ネームサービスを起動してください。
.LP
.LP
-鴻絎翫Java IDL 若泣若鴻ORB \f2resolve_initial_references()\fP ＜純 \f2list_initial_references()\fP ＜純絎茖篏睡若鴻潟絲障若 900 у罘障
+特に指定しない場合、Java IDL ネームサービスは、ORB の \f2resolve_initial_references()\fP メソッドと \f2list_initial_references()\fP メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
.LP
.nf
\f3
@@ -83,7 +83,7 @@
.LP
.LP
-若泣若若若絎翫с若 900 篏睡障Solaris 純с≪絎茵1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 1050 ャ若絎若泣若鴻違潟у茵UNIX 潟潟激сф＜ュ障
+ネームサーバーポートを指定しない場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアの実行時は、1024 より小さいポートでプロセスを開始する場合、root ユーザーになる必要があります。このため、1024 または 1024 よりも大きいポート番号を使用することをお勧めします。1050 のように別のポートを指定し、ネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルで次のように入力します。
.LP
.nf
\f3
@@ -95,7 +95,7 @@
.LP
.LP
-Windows MS\-DOS 激鴻潟с罨＜ュ障
+Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@@ -107,32 +107,32 @@
.LP
.LP
-若泣若若ゃ≪潟違若垩ャ綽荀障ORB 吾с篏 \f2org.omg.CORBA.ORBInitialPort\fP ｃ若違若垩荐絎障
+ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティーに新しいポート番号を設定します。
.LP
.SS
-違激割сゃ≪潟泣若若絎茵
+異なるマシン上でのクライアントとサーバーの実行
.LP
.LP
-Java IDL RMI\-IIOP 祉ャ若≪с若泣若鴻泣若若潟ゃ≪潟鴻榊激割у茵障絎翫ゃ≪潟泣若若若泣若鴻違鴻筝у茵紊障
+Java IDL と RMI\-IIOP のほとんどのチュートリアルでは、ネームサービス、サーバー、およびクライアントはすべて開発用のマシン上で実行されます。実際に配備する場合には、クライアントとサーバーを、ネームサービスとは異なるホスト上で実行することが多くなります。
.LP
.LP
-ゃ≪潟泣若若若泣若鴻荀ゃゃ≪潟泣若若若泣若鴻絎茵若垩鴻茯茘綽荀障ゃ≪潟泣若若＜ゃ \f2org.omg.CORBA.ORBInitialPort\fP ｃ若 \f2org.omg.CORBA.ORBInitialHost\fP ｃ若若泣若鴻絎茵若垩激潟荐絎障箴
+クライアントとサーバーがネームサービスを見つけるには、クライアントとサーバーが、ネームサービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP プロパティーと \f2org.omg.CORBA.ORBInitialHost\fP プロパティーをネームサービスが実行されているポートの番号とマシンの名前に設定します。この例は、
.na
-\f2RMI\-IIOP 篏帥ｃ Hello World 箴\fP @
+\f2「RMI\-IIOP を使った Hello World の例」に示されています。\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html腓冴障潟潟茵激с \f2\-ORBInitialPort\fP \f2nameserverport#\fP \f2\-ORBInitialHost\fP \f2nameserverhostname\fP 篏睡ゃ≪潟泣若若絲障若泣若鴻｢贋絎с障
+http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlコマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使用して、クライアントとサーバーに対してネームサービスを探す場所を指定することもできます。
.na
-\f2Java IDL: 2 伹激割у茵 Hello World 違\fP @
+\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html 潟潟茵激с潟篏睡絎号腓冴障
+http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。
.LP
.LP
-違筝若泣若 \f2tnameserv\fP 鴻 \f2nameserverhost\fP 若 1050 筝у茵障ゃ≪潟鴻 \f2clienthost\fP 筝у茵泣若若鴻 \f2serverhost\fP 筝у茵障
+たとえば、一時ネームサービス \f2tnameserv\fP が、ホスト \f2nameserverhost\fP のポート 1050 上で実行されているとします。さらに、クライアントがホスト \f2clienthost\fP 上で実行され、サーバーはホスト \f2serverhost\fP 上で実行されているとします。
.LP
.RS 3
.TP 2
o
-罨＜鴻 \f2nameserverhost\fP 筝 \f2tnameserv\fP 莎桁障
+次のように、ホスト \f2nameserverhost\fP 上で \f2tnameserv\fP を起動します。
.nf
\f3
.fl
@@ -144,7 +144,7 @@
.fi
.TP 2
o
-\f2serverhost\fP 筝с泣若若莎桁障
+\f2serverhost\fP 上でサーバーを起動します。
.nf
\f3
.fl
@@ -154,7 +154,7 @@
.fi
.TP 2
o
-\f2clienthost\fP 筝сゃ≪潟莎桁障
+\f2clienthost\fP 上でクライアントを起動します。
.nf
\f3
.fl
@@ -166,38 +166,34 @@
.LP
.SS
-\-J 激с
+\-J オプション
.LP
-潟潟茵激с潟\f2tnameserve\fP 篏睡с障
-.RS 3
-
-.LP
+このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。
.RS 3
.TP 3
\-Joption
-Java 篁潟激潟 \f2option\fP 羝＜障 \f2option\fP java(1)＜潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪＜≪若 48M ゃ荐絎障\f3\-J\fP 篏帥ｃ緇絎茵医激с潟羝＜頫障
+Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
-.RE
-.SH "Java\ IDL 筝若泣若鴻罩"
+.SH "Java IDL 一時ネームサービスの停止"
.LP
.LP
-Java IDL 若泣若鴻罩≪Unix 翫\f2kill\fP 若ｃ潟違激鴻潟潟篏帥Windows 翫\f2Ctrl\-C\fP 篏帥障若泣若鴻腓榊罩≪障с若喝冴緇罘倶膓障泣若鴻腟篋Java\ IDL 若泣若鴻脂蚊紊宴障
+Java IDL ネームサービスを停止するには、Unix の場合は、\f2kill\fP などのオペレーティングシステムのコマンドを使い、Windows の場合は、\f2Ctrl\-C\fP を使います。ネームサービスを明示的に停止するまでは、呼び出し待機状態が続きます。なお、サービスを終了させると、Java IDL ネームサービスに登録されている名前は失われます。
.LP
-.SH "泣潟ゃ≪潟:腥咲吾吾с菴遵"
+.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
.LP
.LP
-罨＜腓冴泣潟違腥咲菴遵号腓冴с泣潟違障障倶у篏筝若泣若鴻ゃ≪潟с罨＜膣若篏с
+次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
.LP
.nf
\f3
.fl
\fP\f3
.fl
- \fP\f4\fP\f3
+ \fP\f4初期\fP\f3
.fl
- \fP\f4若潟違潟潟鴻\fP\f3
+ \fP\f4ネーミングコンテキスト\fP\f3
.fl
/ \\
.fl
@@ -215,7 +211,7 @@
.LP
.LP
-箴с\f3plans\fP 吾сс\f3Personal\fP \f3calendar\fP \f3schedule\fP 2 ゃ吾сс若潟違潟潟鴻с
+この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。
.LP
.nf
\f3
@@ -242,7 +238,7 @@
.fi
.LP
-菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨＜潟若с若垩ゃ≪潟違ャ障
+前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。
.nf
\f3
.fl
@@ -258,7 +254,7 @@
.fi
.LP
-罨＜潟若с若潟違潟潟鴻緇 \f3ctx\fP 篁ｅャ障2 茵с\f3ctx\fP 若吾с \f3objref\fP 潟若障 \f3objref\fP с障障蚊綵腥咲菴遵障
+次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この objref には、あとでさまざまな名前を割り当てて名前空間に追加します。
.nf
\f3
.fl
@@ -274,7 +270,7 @@
.fi
.LP
-罨＜潟若сtext plans 篏若吾ссゃ潟障緇\f2rebind\fP 篏睡若潟違潟潟鴻筝 "plans" 菴遵障\f2rebind\fP ＜純篏睡違\f2bind\fP 篏睡翫榊箴紊榊違篏綺膵違菴絎茵с障
+次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、rebind を使用して初期ネーミングコンテキストの下に \f2plans を追加しています\fP。 \f2rebind\fP メソッドを使用すれば、bind を使用した場合に発生する例外を発生させずに、 \f2このプログラムを何度も繰り返し実行できます\fP。
.nf
\f3
.fl
@@ -292,7 +288,7 @@
.fi
.LP
-罨＜潟若сdirectory Personal 若潟違潟潟鴻篏障腟緇吾с \f3ctx2\fP ゃ潟若潟違潟潟鴻菴遵障
+次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
.nf
\f3
.fl
@@ -310,7 +306,7 @@
.fi
.LP
-罧潟若с若吾сс schedule calendar с若潟違潟潟鴻 "Personal" (\f3ctx2\fP) ゃ潟障
+残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。
.nf
\f3
.fl
@@ -350,10 +346,10 @@
.fi
.LP
-.SH "泣潟ゃ≪潟:腥咲"
+.SH "サンプルクライアント: 名前空間のブラウズ"
.LP
.LP
-罨＜泣潟違с腥咲冴号腓冴障
+次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
.LP
.nf
\f3
@@ -380,7 +376,7 @@
.fi
.LP
-菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨＜潟若с若垩ゃ≪潟違ャ障
+前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。
.nf
\f3
.fl
@@ -400,7 +396,7 @@
.fi
.LP
-罨＜潟若с若潟違潟潟鴻緇障
+次のコードでは、初期ネーミングコンテキストを取得しています。
.nf
\f3
.fl
@@ -414,7 +410,7 @@
.fi
.LP
-\f2list\fP ＜純若潟違潟潟鴻菴遵ゃ潟ｃ潟違鴻障翫紊 1000 障сゃ潟ｃ潟違若潟違潟潟鴻 BindingListHolder 菴障 罧ゃ潟ｃ潟違BindingIteratorHolder 菴障
+\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
.nf
\f3
.fl
@@ -430,7 +426,7 @@
.fi
.LP
-罨＜潟若с菴 BindingListHolder ゃ潟ｃ潟違緇障ゃ潟ｃ潟違翫違腟篋障
+次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
.nf
\f3
.fl
@@ -444,7 +440,7 @@
.fi
.LP
-罧潟若сゃ潟ｃ潟違絲障若茵阪障
+残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
.nf
\f3
.fl
--- a/jdk/src/solaris/doc/sun/man/man1/ja/unpack200.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/unpack200.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,159 +19,125 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH unpack200 1 "02 Jun 2010"
+.TH unpack200 1 "14 Apr 2011"
.LP
-.SH ""
-unpack200 \- JAR ≪潟若
+.SH "名前"
+unpack200 \- JAR アンパックツール
.LP
.RS 3
.TP 2
o
-綵√
+形式
.TP 2
o
-茯
+説明
.TP 2
o
-激с
+オプション
.TP 2
o
-腟篋鴻若帥
+終了ステータス
.TP 2
o
-∫ｉ
+関連項目
.TP 2
o
-茯
+注意事項
.RE
.LP
-.SH "綵√"
-.LP
-
+.SH "形式"
.LP
.LP
\f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
.LP
.LP
-激с潟絎綺羆冴障障潟潟茵絎緇激с潟篁ュ絎鴻激с潟障
-.LP
-.RS 3
-
+オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
input\-file
-ュ＜ゃ ュ＜ゃ絽吾pack200 gzip ＜ゃ pack200 ＜ゃс祉0 荐絎 pack200(1) 篏 JAR ＜ゃュ＜ゃ篏睡с障 翫ュ＜ゃ絎鴻 Pack200 若若阪 JAR ＜ゃ潟若障
+入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
.TP 3
JAR\-file
-阪 JAR ＜ゃ
+出力 JAR ファイル名。
.RE
.LP
-.RE
-.SH " 茯"
-.LP
-
+.SH " 説明"
.LP
.LP
-\f2unpack200\fP \f2pack200\fP(1) т＜ゃ JAR ＜ゃ紊ゃｃ絎茖с筝篏睡号:
-.LP
-.RS 3
-
+\f2unpack200\fP は、pack200(1) で作成されたパックファイルを JAR ファイルに変換する \f2ネイティブ実装\fPです。一般的な使用方法:
.LP
.LP
\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
.LP
-.RE
-.LP
-箴с \f2unpack200\fP 荐絎с\f2myarchive.jar\fP \f2myarchive.pack.gz\fP 篏障
-.LP
-.SH "激с"
.LP
-.SS
-罔羣激с
+この例では、 \f2デフォルトの unpack200 設定で、myarchive.pack.gz\fP から \f2myarchive.jar\fP が \f2作成されます\fP 。
.LP
-.RS 3
-
+.SH "オプション"
.LP
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
-.RS 3
-
.LP
-.LP
-JAR ＜ゃ鴻潟 \f2true\fP\f2false\fP\f2keep\fP 若激с潟荐絎障≪若 \f2keep\fP с\f2true\fP 障 \f2false\fP 翫篏若若ゃ阪 JAR ＜ゃ鴻潟若激с潟≪若荐絎障
-.LP
-.RE
-.RE
-.SS
-罔羣激с
-.LP
-.RS 3
-
+JAR ファイル内のすべてのエントリに \f2true\fP 、 \f2false\fP、 \f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。 \f2true\fP または \f2false 場合、\fPデフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
.LP
.LP
\f4\-r \-\-remove\-pack\-file\fP
.LP
-.RS 3
-
-.LP
.LP
-ュ＜ゃゃ障
+入力パックファイルを削除します。
.LP
-.RE
.LP
\f4\-v \-\-verbose\fP
.LP
-.RS 3
-
-.LP
.LP
-絨＜祉若吾阪障激с潟茲井絎激＜祉若吾阪障
+最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
-.RE
.LP
\f4\-q \-\-quiet\fP
.LP
-.RS 3
-
-.LP
.LP
-＜祉若吾茵腓冴篏障
+メッセージを表示せずに動作します。
.LP
-.RE
.LP
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
.LP
-.RS 3
-
+.LP
+出力メッセージのログファイルを指定します。
+.LP
+.LP
+\f4\-? \-h \-\-help\fP
.LP
.LP
-阪＜祉若吾違＜ゃ絎障
+このコマンドに関するヘルプ情報を出力します。
+.LP
.LP
-.RE
-.RE
-.SH "腟篋鴻若帥"
+\f4\-V \-\-version\fP
.LP
-
+.LP
+このコマンドに関するバージョン情報を出力します。
.LP
.LP
-罨＜腟篋ゃ菴障
+\f4\-J\fP\f2option\fP
+.LP
.LP
-.RS 3
-
+unpack200 によって呼び出される Java 起動ツールに \f2オプション\fP を \f2渡します\fP。
+.LP
+.SH "終了ステータス"
.LP
.LP
-\f2\ 0\fP " "
+次の終了値が返されます。
.LP
.LP
-\f2>0\fP " "
+\f2\ 0\fP " 成功"
+.LP
.LP
-.RE
-.SH "∫ｉ"
+\f2>0\fP " エラー"
+.LP
+.SH "関連項目"
.LP
.RS 3
.TP 2
@@ -180,35 +146,33 @@
.TP 2
o
.na
-\f2Java SE ャ＜潟\fP @
+\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
-\f2Java ゃ \- Pack200\fP @
+\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
-jar(1) \- Java Archive 若
+jar(1) \- Java Archive ツール」
.TP 2
o
-jarsigner(1) \- JAR 臀峨恰荐若若
+jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
-\f2attributes(5)\fP ャ≪若
+\f2attributes(5)\fP のマニュアルページ
.RE
.LP
-.SH "羈鋋"
-.LP
-
+.SH "注意事項"
.LP
.LP
-潟潟 \f2unpack(1)\fP 羞桁сヨ遵с
+このコマンドと \f2unpack(1) を\fP混同しないでください。これらは別製品です。
.LP
.LP
-SDK 篁絮 Java SE API 篁罕檎荀ゃｃ翫篁罕
+SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP
--- a/jdk/src/solaris/doc/sun/man/man1/ja/wsgen.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/wsgen.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,30 +19,24 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH wsgen 1 "02 Jun 2010"
-.SH ""
-wsgen \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
-.RS 3
-
+.TH wsgen 1 "14 Apr 2011"
+.SH "名前"
+wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
-.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3絎茖若吾с:\fP 2.1.1
-.LP
+\f3実装バージョン:\fP 2.1.1
.LP
-\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若ｃ＜障若Web 泣若鴻潟ゃ潟絎茖 (SEI) 茯水Web 泣若鴻若喝冴綽荀鴻≪若ｃ＜障
-.LP
-.RE
-.SH "网荀"
+\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
+.SH "概要"
.LP
-\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若ｃ＜障若Web 泣若鴻潟ゃ潟鴻茯水Web 泣若鴻若喝冴綽荀鴻≪若ｃ＜障JAXWS 2.1.1 RI wsgen Ant 帥鴻障荅括完
+\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイントクラスを読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。JAXWS 2.1.1 RI には wsgen Ant タスクも用意されています。詳細は、
.na
-\f2Wsgen Ant 帥鴻\fP @
+\f2Wsgen Ant タスク\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlを参照してください。
.LP
-.SH "wsgen 莎桁"
+.SH "wsgen の起動"
.RS 3
.TP 2
o
@@ -69,7 +63,7 @@
.RE
.LP
-.SH "罕"
+.SH "構文"
.nf
\f3
.fl
@@ -80,7 +74,7 @@
\fP
.fi
.LP
-罨＜茵\f2wsgen\fP 激с潟腓冴障
+次の表に、 \f2wsgen\fP のオプションを示します。
.br
.LP
.TS
@@ -111,7 +105,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-ュ鴻＜ゃ罎膣√贋絎障
+入力クラスファイルの検索場所を指定します
.br
.di
.nr a| \n(dn
@@ -127,7 +121,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2\-classpath <path>\fP
+\-classpath <path> \f2と同じです\fP
.br
.di
.nr b| \n(dn
@@ -143,7 +137,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-阪＜ゃ主贋絎
+生成される出力ファイルを格納する場所を指定します
.br
.di
.nr c| \n(dn
@@ -159,7 +153,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵с障
+ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
.br
.di
.nr d| \n(dn
@@ -175,7 +169,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-茵腓冴障
+ヘルプを表示します
.br
.di
.nr e| \n(dn
@@ -191,7 +185,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜ゃ篆障
+生成されたファイルを保持します
.br
.di
.nr f| \n(dn
@@ -207,7 +201,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \-wsdl 激с潟腟水篏睡障WSDL 純若鴻＜ゃ主贋絎障
+常に \-wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
.br
.di
.nr g| \n(dn
@@ -223,7 +217,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-純若鴻＜ゃ主贋絎
+生成されるソースファイルを格納する場所を指定する
.br
.di
.nr h| \n(dn
@@ -239,7 +233,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ絎茵≪＜祉若吾阪障
+コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr i| \n(dn
@@ -255,7 +249,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾с恰宴阪障激с潟篏睡翫若吾с恰宴阪с絽吾絎茵障
+バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
.br
.di
.nr j| \n(dn
@@ -271,7 +265,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2wsgen\fP с WSDL ＜ゃ障違ュ純с絎翫 \f2wsgen\fP WSDL ＜ゃ障違絽吾潟ゃ潟肴 WSDL сс篏睡障\f2protocol\fP ュ純с\f2wsdl:binding\fP т戎鴻潟絎篏睡障鴻潟罨＜с\f2soap1.1\fP \f2Xsoap1.2\fP \f2soap1.1\fP с\f2Xsoap1.2\fP 罔羣с\f2\-extension\fP 激с潟腟水篏睡с障
+デフォルトでは \f2wsgen\fP は WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は \f2wsgen\fP が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。 \f2protocol\fP は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\fP。有効なプロトコルは次のとおりです。 \f2soap1.1\fP と \f2Xsoap1.2\fP。デフォルトは \f2soap1.1\fP です。 \f2Xsoap1.2\fP は標準ではないため、 \f2\-extension\fP オプションと組み合わせないと使用できません。
.br
.di
.nr k| \n(dn
@@ -287,7 +281,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:service\fP 絎篏睡障箴 : \f2\-servicename "{http://mynamespace/}MyService"\fP
+常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:service\fP の名前を指定するために使用します。例: \f2\-servicename "{http://mynamespace/}MyService"\fP
.br
.di
.nr l| \n(dn
@@ -303,7 +297,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:port\fP 絎篏睡障箴 : \f2\-portname "{http://mynamespace/}MyPort"\fP
+常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:port\fP の名前を指定するために使用します。例: \f2\-portname "{http://mynamespace/}MyPort"\fP
.br
.br
.di
@@ -315,7 +309,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -346,7 +340,7 @@
.80
.rm 80
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -386,7 +380,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 143 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 137 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -403,7 +397,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -633,7 +627,7 @@
.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
.LP
-.SH "箴"
+.SH "例"
.nf
\f3
.fl
@@ -641,7 +635,7 @@
.fl
.fi
.LP
-\f3stock\fP ｃ @WebService 羈篁StockService 綽荀若鴻障
+\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。
.nf
\f3
.fl
@@ -649,7 +643,7 @@
.fl
.fi
.LP
-SOAP 1.1 WSDL @WebService 羈篁 Java stock.StockService 鴻若障
+SOAP 1.1 WSDL と、@WebService 注釈が付けられた Java クラス stock.StockService のスキーマが生成されます。
.nf
\f3
.fl
@@ -657,6 +651,6 @@
.fl
.fi
.LP
-SOAP 1.2 WSDL 障
+SOAP 1.2 WSDL が生成されます。
.LP
-泣若鴻 JAXWS 潟帥ゃｃ WSDL 堺 WSDL 綽荀障
+サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。
--- a/jdk/src/solaris/doc/sun/man/man1/ja/wsimport.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/wsimport.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,44 +19,44 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH wsimport 1 "02 Jun 2010"
-.SH ""
-wsimport \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
+.TH wsimport 1 "14 Apr 2011"
+.SH "名前"
+wsimport \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3絎茖若吾с:\fP 2.1.1
+\f3実装バージョン:\fP 2.1.1
.br
-.SH "网荀"
+.SH "概要"
.LP
-\f2wsimport\fP 若罨＜ JAX\-WS 若帥≪若ｃ＜障
+\f2wsimport\fP ツールは、次のような JAX\-WS ポータブルアーティファクトを生成します。
.RS 3
.TP 2
o
-泣若鴻潟ゃ潟ゃ潟帥с若 (SEI)
+サービスエンドポイントインタフェース (SEI)
.TP 2
o
-泣若
+サービス
.TP 2
o
-wsdl:fault 箴紊 (絖翫)
+wsdl:fault からマップされる例外クラス (存在する場合)
.TP 2
o
-綽膈 wsdl:message 羇丞綽膈 Bean (絖翫)
+応答 wsdl:message から派生する非同期応答 Bean (存在する場合)
.TP 2
o
-JAX\-B ゃ帥ゃ (鴻若 Java )
+JAX\-B が生成する値タイプ (スキーマの型からマップされた Java クラス)
.RE
.LP
-≪若ｃ＜WSDL ャ＜潟鴻若ャ＜潟潟潟ゃ潟絎茖 WAR ＜ゃ宴若後с障障wsimport Ant 帥鴻障
+これらのアーティファクトは、WSDL ドキュメント、スキーマドキュメント、およびエンドポイント実装とともに WAR ファイル内にパッケージ化して配備することができます。また、wsimport Ant タスクも用意されています。
.na
-\f2Wsimport Ant 帥鴻\fP @
+\f2wsimport Ant タスク\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlを参照してください。
.br
.LP
-.SH "wsimport 莎桁"
+.SH "wsimport の起動"
.RS 3
.TP 2
o
@@ -77,7 +77,7 @@
.RE
.LP
-.SH "罕"
+.SH "構文"
.nf
\f3
.fl
@@ -86,7 +86,7 @@
\fP
.fi
.LP
-罨＜茵\f2wsimport\fP 激с潟腓冴障
+次の表に、 \f2wsimport\fP のオプションを示します。
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -116,7 +116,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-阪＜ゃ主贋絎障
+生成される出力ファイルを格納する場所を指定します
.br
.di
.nr a| \n(dn
@@ -132,7 +132,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊 JAX\-WS 障 JAXB ゃ潟ｃ潟違＜ゃ絎障 (\f2<file>\fP \f2\-b\fP 綽荀)
+外部の JAX\-WS または JAXB バインディングファイルを指定します ( \f2<file>\fP ごとに \f2\-b\fP が必要となる)
.br
.di
.nr b| \n(dn
@@ -148,7 +148,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-激с潟 JAXB 鴻若潟潟ゃ羝＜障
+このオプションを JAXB スキーマコンパイラに渡します
.br
.di
.nr c| \n(dn
@@ -164,11 +164,11 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-紊潟ｃｃ弱с茹ｆ浦帥違＜ゃ絎障 TR9401XCatalogOASIS XML Catalog 綵√泣若障
+外部エンティティー参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。
.na
-\f2帥\fP @
+\f2カタログ\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlャ＜潟茯帥\f3帥\fP泣潟с
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlのドキュメントをお読みになり、\f3カタログ\fPのサンプルを参照してください。
.br
.di
.nr d| \n(dn
@@ -184,7 +184,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵醇с障
+ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
.br
.di
.nr e| \n(dn
@@ -200,7 +200,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-茵腓冴障
+ヘルプを表示します
.br
.di
.nr f| \n(dn
@@ -232,7 +232,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-HTTP 激泣若若絎障 (若 8080)
+HTTP プロキシサーバーを指定します (デフォルトのポートは 8080)
.br
.di
.nr h| \n(dn
@@ -248,7 +248,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-＜ゃ篆障
+生成されたファイルを保持します
.br
.di
.nr i| \n(dn
@@ -264,7 +264,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻 WSDL/鴻若ゃ潟ｃ潟違鴻帥ゃ冴 篁罕ц鎘宴若後≪眼冴障
+このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべての WSDL/スキーマバインディングカスタマイズや、 仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます
.br
.di
.nr j| \n(dn
@@ -280,7 +280,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-純若鴻＜ゃ主贋絎障
+生成されるソースファイルを格納する場所を指定する
.br
.di
.nr k| \n(dn
@@ -296,7 +296,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-潟潟ゃ絎茵≪＜祉若吾阪障
+コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr l| \n(dn
@@ -312,7 +312,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-若吾с恰宴阪障
+バージョン情報を出力します
.br
.di
.nr m| \n(dn
@@ -344,7 +344,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2@WebServiceClient.wsdlLocation\fP
+\f2@WebServiceClient.wsdlLocation\fP 値
.br
.di
.nr o| \n(dn
@@ -360,7 +360,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-絎 JAX\-WS 篁罕若吾с潟緇ｃ潟若障若吾с 2.0 сJAX\-WS 2.0 篁罕羣潟若障
+指定された JAX\-WS 仕様バージョンに従ってコードを生成します。バージョン 2.0 では、JAX\-WS 2.0 仕様に準拠したコードを生成します。
.br
.di
.nr p| \n(dn
@@ -376,7 +376,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-wsimport 阪吟障
+wsimport 出力を抑制します
.br
.di
.nr q| \n(dn
@@ -387,7 +387,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3激с\fP
+.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-d <directory> \fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -422,7 +422,7 @@
.nr 38 \n(n-
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
-.nr 38 \w\f3茯\fP
+.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
@@ -483,7 +483,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
@@ -766,13 +766,294 @@
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-72
.LP
-\f2\-b\fP 激с潟篏帥ｃ茲違 JAX\-WS JAXB ゃ潟ｃ潟違＜ゃ絎с障 ＜ゃ篏帥ｃ宴若後 Bean 障障鴻帥ゃ冴純с JAX\-WS JAXB ゃ潟ｃ潟違＜ゃ荅括完
+\-b オプションを使って、複数の JAX\-WS および JAXB バインディングファイル \f2を指定できます。\fP これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。JAX\-WS および JAXB バインディングファイルの詳細は、
.na
-\f2鴻帥ゃ冴ャ≪\fP @
+\f2カスタマイズマニュアル\fP @
.fi
-https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlс
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlを参照してください。
+.LP
+次の表に、 \f2wsimport\fP の非標準オプションを示します。
.LP
-.SH "箴"
+.TS
+.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
+.de 35
+.ps \n(.s
+.vs \n(.vu
+.in \n(.iu
+.if \n(.u .fi
+.if \n(.j .ad
+.if \n(.j=0 .na
+..
+.nf
+.nr #~ 0
+.if n .nr #~ 0.6n
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.fc
+.nr 33 \n(.s
+.rm 80 81
+.nr 34 \n(.lu
+.eo
+.am 81
+.br
+.di a+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+要求または応答メッセージにバインドされないヘッダーを Java メソッドのパラメータにマップします
+.br
+.di
+.nr a| \n(dn
+.nr a- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di b+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://username:password@example.org/stock?wsdl
+.br
+.di
+.nr b| \n(dn
+.nr b- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di c+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+デバッグ情報を出力します
+.br
+.di
+.nr c| \n(dn
+.nr c- \n(dl
+..
+.ec \
+.eo
+.am 80
+.br
+.di d+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(80 .ll \n(80u
+.in 0
+\f3\-Xno\-addressing\-databinding\fP
+.br
+.di
+.nr d| \n(dn
+.nr d- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di e+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+W3C \f2EndpointReferenceType\fP と Java のバインディングを有効にします
+.br
+.di
+.nr e| \n(dn
+.nr e- \n(dl
+..
+.ec \
+.eo
+.am 81
+.br
+.di f+
+.35
+.ft \n(.f
+.ll \n(34u*1u/3u
+.if \n(.l<\n(81 .ll \n(81u
+.in 0
+生成された Java ファイルをコンパイルしません
+.br
+.di
+.nr f| \n(dn
+.nr f- \n(dl
+..
+.ec \
+.35
+.nf
+.ll \n(34u
+.nr 80 0
+.nr 38 \w\f3オプション\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-XadditionalHeaders\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xauthfile <file>\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xdebug\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \w\f3\-Xnocompile\fP
+.if \n(80<\n(38 .nr 80 \n(38
+.80
+.rm 80
+.nr 38 \n(d-
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 81 0
+.nr 38 \w\f3説明\fP
+.if \n(81<\n(38 .nr 81 \n(38
+.81
+.rm 81
+.nr 38 \n(a-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(b-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(c-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(e-
+.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(f-
+.if \n(81<\n(38 .nr 81 \n(38
+.35
+.nf
+.ll \n(34u
+.nr 38 1n
+.nr 79 0
+.nr 40 \n(79+(0*\n(38)
+.nr 80 +\n(40
+.nr 41 \n(80+(3*\n(38)
+.nr 81 +\n(41
+.nr TW \n(81
+.if t .if \n(TW>\n(.li .tm Table at line 199 file Input is too wide - \n(TW units
+.fc
+.nr #T 0-1
+.nr #a 0-1
+.eo
+.de T#
+.ds #d .d
+.if \(ts\n(.z\(ts\(ts .ds #d nl
+.mk ##
+.nr ## -1v
+.ls 1
+.ls
+..
+.ec
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
+.ne \n(a|u+\n(.Vu
+.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-XadditionalHeaders\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.a+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(b|u+\n(.Vu
+.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xauthfile <file>\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.b+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(c|u+\n(.Vu
+.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xdebug\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.c+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(d|u+\n(.Vu
+.ne \n(e|u+\n(.Vu
+.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
+.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(40u
+.in +\n(37u
+.d+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.e+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(f|u+\n(.Vu
+.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f3\-Xnocompile\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
+.sp |\n(##u-1v
+.nr 37 \n(41u
+.in +\n(37u
+.f+
+.in -\n(37u
+.mk 32
+.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.fc
+.nr T. 1
+.T# 1
+.35
+.rm a+
+.rm b+
+.rm c+
+.rm d+
+.rm e+
+.rm f+
+.TE
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
+
+.LP
+.SH "例"
.nf
\f3
.fl
@@ -780,6 +1061,6 @@
.fl
.fi
.LP
-Java ≪若ｃ＜\f2http://stockquote.xyz/quote?wsdl\fP ゃ潟若с≪若ｃ＜潟潟ゃ障
+Java アーティファクトを生成し、 \f2http://stockquote.xyz/quote?wsdl\fP をインポートすることで、それらのアーティファクトをコンパイルします。
.br
--- a/jdk/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon May 02 09:36:45 2011 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/ja/xjc.1 Wed Jul 05 17:42:56 2017 +0200
@@ -19,266 +19,277 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH xjc 1 "02 Jun 2010"
+.TH xjc 1 "14 Apr 2011"
.LP
.ad c
-.SH ""
-xjc \- XML ゃ潟 Java(TM) ≪若ｃ
+.SH "名前"
+xjc \- XML バインドのための Java(TM) アーキテクチャー
.br
-ゃ潟ｃ潟違潟潟ゃ
+バインディングコンパイラ
.LP
-\f3篁罕若吾с:\fP 2.1
+\f3仕様バージョン:\fP 2.1
.br
-\f3＜潟劫茖 (RI) 若吾с:\fP 2.1.3 .ad l
+\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l
.LP
-.SH "xjc 莎桁"
+.SH "xjc の起動"
.LP
.LP
-ゃ潟ｃ潟違潟潟ゃ莎桁篏睡若綽 \f2bin\fP ｃ \f2xjc\fP 激с鴻篏睡障障ゃ潟ｃ潟違潟潟ゃ絎茵 Ant 帥鴻障
+バインディングコンパイラを起動するには、使用するプラットフォームに応じた bin ディレクトリ内の \f2xjc\fP シェルスクリプト \f2を\fP 使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。
.na
-\f2xjc Ant 篏睡\fP @
+\f2xjc を Ant とともに使用する\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlс
-.LP
-.RS 3
-
+https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。
.LP
.LP
\f2% xjc \-help\fP
.LP
-.RE
-\f3阪\fP
-.LP
-.RS 3
-
+.SS
+出力
.LP
.nf
\f3
.fl
-Usage: xjc [\-options ...] <schema_file/URL/dir> ... [\-b <bindinfo>] ...
+Usage: xjc [\-options ...] <schema file/URL/dir/jar> ... [\-b <bindinfo>] ...
+.fl
+If dir is specified, all schema files in it will be compiled.
+.fl
+If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled.
.fl
Options:
.fl
- \-nv : do not perform strict validation of the input schema(s)
+ \-nv : do not perform strict validation of the input schema(s)
.fl
- \-extension : allow vendor extensions \- do not strictly follow the
+ \-extension : allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
.fl
- Compatibility Rules and App E.2 from the JAXB Spec
+ \-b <file/dir> : specify external bindings files (each <file> must have its own \-b); if a directory is given, **/*.xjb is searched
.fl
- \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
+ \-d <dir> : generated files will go into this directory
+.fl
+ \-p <pkg> : specifies the target package
.fl
- If a directory is given, **/*.xjb is searched
+ \-httpproxy <proxy> : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
.fl
- \-d <dir> : generated files will go into this directory
+ \-httpproxyfile <f> : works like \-httpproxy but takes the argument in a file to protect password
.fl
- \-p <pkg> : specifies the target package
+ \-classpath <arg> : specify where to find user class files
.fl
- \-httpproxy <proxy> : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort
+ \-catalog <file> : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
.fl
- \-httpproxyfile <file>: set the proxy string (same format as above).
+ \-readOnly : generated files will be in read\-only mode
.fl
- \-classpath <arg> : specify where to find user class files
+ \-npa : suppress generation of package level annotations (**/package\-info.java)
+.fl
+ \-no\-header : suppress generation of a file header with timestamp
.fl
- \-catalog <file> : specify catalog files to resolve external entity references
+ \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features
.fl
- support TR9401, XCatalog, and OASIS XML Catalog format.
+ \-xmlschema : treat input as W3C XML Schema (default)
.fl
- \-readOnly : generated files will be in read\-only mode
+ \-relaxng : treat input as RELAX NG (experimental,unsupported)
.fl
- \-npa : suppress generation of package level annotations (**/package\-info.java)
+ \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
.fl
- \-no\-header : suppress generation of a file header with timestamp
+ \-dtd : treat input as XML DTD (experimental,unsupported)
.fl
- \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
+ \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+.fl
+ \-verbose : be extra verbose
.fl
- \-xmlschema : treat input as W3C XML Schema (default)
+ \-quiet : suppress compiler output
.fl
- \-relaxng : treat input as RELAX NG (experimental,unsupported)
+ \-help : display this help message
.fl
- \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
+ \-version : display version information
+.fl
+
.fl
- \-dtd : treat input as XML DTD (experimental,unsupported)
+
.fl
- \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+Extensions:
.fl
- \-verbose : be extra verbose
+ \-Xlocator : enable source location support for generated code
.fl
- \-quiet : suppress compiler output
+ \-Xsync\-methods : generate accessor methods with the 'synchronized' keyword
.fl
- \-help : display this help message
+ \-mark\-generated : mark the generated code as @javax.annotation.Generated
.fl
- \-version : display version information
+ \-episode <FILE> : generate the episode file for separate compilation
.fl
\fP
.fi
-.RE
.LP
-.SH "激с"
-.LP
-
+.SH "オプション"
.LP
.RS 3
.TP 3
\-nv
-сXJC ゃ潟ｃ潟違潟潟ゃ純若鴻鴻若ｳ絲罎荐若絎茵障激с潟篏睡ｳ絲鴻若罎荐若≦鴻障ゃ潟ｃ潟違潟潟ゃ罎荐若筝絎茵с障 ｳ絲с罎荐若絎茵с
+デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
.TP 3
\-extension
-сXJC ゃ潟ｃ潟違潟潟ゃJAXB 篁罕Compatibility腴ц荀ｳ絲綣桁吟障篁 E.2 JAXB v1.0 у泣若筝ｃ W3C XML 鴻若罘純絎臂障 翫ｃ鴻ゃф鴻\-extension≪若с罘純篏睡с障障ｳ絲≪若с篁罕絎臂ゃ潟ｃ潟違鴻帥ゃ冴帥篏睡с障\-extension鴻ゃ絎違JAXB Vendor Extension 篏睡с障
+デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
.TP 3
\-b <file>
-紊ゃ潟ｃ潟違＜ゃ 1 ゃ障茲井絎障(ゃ潟ｃ潟違＜ゃ\f2\-b\fP鴻ゃ絎綽荀障)紊ゃ潟ｃ潟違＜ゃ罕絽吾荵с茲違鴻若鴻帥ゃ冴障 1 ゃゃ潟ｃ潟違＜ゃ篏睡鴻帥ゃ冴茲違ゃ潟ｃ潟違＜ゃ蚊с障 罨＜箴腓冴障
-.RS 3
-
-.LP
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
+処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに \f2「\-b」\fP スイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる 1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。 \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
.br
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
-.RE
-障潟潟茵鴻若＜ゃゃ潟ｃ潟違＜ゃ絎篁紙с
+\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
.TP 3
\-d <dir>
-сXJC ゃ潟ｃ潟違潟潟ゃJava 潟潟潟鴻憜ｃ障激с潟篏睡篁ｆ水阪ｃ絎с障阪ｃ絖綽荀障 XJC ゃ潟ｃ潟違潟潟ゃｃ篏障
+デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
.TP 3
\-p <pkg>
-潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻ゃ潟ｃ潟違鴻帥ゃ冴篁罕ц鎘宴若後≪眼冴障
+このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
.TP 3
\-httpproxy <proxy>
-HTTP/HTTPS 激絎障綵√ [user[:password]@]proxyHost[:proxyPort] с緇ャ \f2\-host\fP \f2\-port\fP 筝篏篋с＜潟劫茖с泣若障ｨ絅障激с潟ф絎鴻若\f2top\fP 潟潟篏睡若吟若祉若吟若茵腓冴с綣違с羈祉ャｃ若蕭罨＜ \f2\-httpproxyfile\fP 篏睡
+HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、 \f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティーを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
.TP 3
\-httpproxyfile <file>
-HTTP/HTTPS 激＜ゃ腟宴ф絎障綵√筝荐с＜ゃ絎鴻若祉若吟若茵腓冴с障
+HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
.TP 3
\-classpath <arg>
-\f2<jxb:javaType>\fP \f2<xjc:superClass>\fP 鴻帥ゃ冴篏睡ゃ≪潟≪宴若激с潟鴻＜ゃ罎膣√贋絎障
+<jxb:javaType> および <xjc:superClass> \f2カスタマイズが使用する\fP クライアントアプリケーションの \f2クラスファイルの検索場所を\fP 指定します。
.TP 3
\-catalog <file>
-紊潟ｃｃ弱с茹ｆ浦帥違＜ゃ絎障TR9401XCatalog OASIS XML Catalog 綵√泣若障荅括完XML Entity and URI Resolversャ＜潟с\f2帥違障\fP泣潟≪宴若激с潟茯帥鴻
+外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、 \f2カタログリゾルバの\fP サンプルアプリケーションを調べてください。
.TP 3
\-readOnly
-сXJC ゃ潟ｃ潟違潟潟ゃ Java 純若鴻＜ゃ吾莨若帥篆茘激障激с潟篏睡XJC ゃ潟ｃ潟違潟潟ゃ Java 純若鴻綣桁句茯水絨障
+デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
.TP 3
\-npa
-宴若吾羈 **/package\-info.java 吟障鴻ゃ篏睡潟若с羈祉羝帥鴻障
+パッケージレベルの注釈を **/package\-info.java に生成することを抑制します。このスイッチを使用して生成するコードでは、これらの注釈がほかの生成済みクラスに内部化されます。
.TP 3
\-no\-header
-紊絨＜≪帥ゃ鴻帥潟＜ゃ若潟＜潟吟障激с潟篏睡潟若障
+多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。
.TP 3
\-target 2.0
- JAXB 2.1 罘純箴絖潟若障潟若 JAXB 2.0 潟帥ゃ (JavaSE 6 ) у茵с障
+なんらかの JAXB 2.1 機能に依存するコードを生成しないようにします。これにより、生成されたコードを JAXB 2.0 ランタイム (JavaSE 6 など) で実行できます。
.TP 3
\-xmlschema
-ュ鴻若 W3C XML 鴻若 () 荀障鴻ゃ絎ュ鴻若 W3C XML 鴻若荀障
+入力スキーマを W3C XML スキーマ (デフォルト) と見なします。このスイッチを指定しなくても、入力スキーマは W3C XML スキーマと見なされます。
.TP 3
\-relaxng
-ュ鴻若 RELAX NG 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-relaxng\-compact
-ュ鴻若 RELAX NG х軒罕障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-dtd
-ュ鴻若 XML DTD 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
+入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-wsdl
-ュ WSDL 宴鴻若潟潟ゃ障 (荅薑泣若)
+入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
.TP 3
\-quiet
-我宴茘潟潟ゃ阪吟障
+進捗情報や警告など、コンパイラの出力を抑制します。
.TP 3
\-verbose
-宴＜祉若吾阪劫主榊鴻帥若鴻茵腓冴罐泣激障
+情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
.TP 3
\-help
-潟潟ゃ鴻ゃ网荀茵腓冴障
+コンパイラスイッチの概要を表示します。
.TP 3
\-version
-潟潟ゃ若吾с恰宴茵腓冴障
+コンパイラのバージョン情報を表示します。
.TP 3
<schema file/URL/dir>
-潟潟ゃ絲乗院 1 ゃ障茲違鴻若＜ゃ絎障若吟若ｃ絎翫xjc ｃ莎井祉цゃｃ鴻鴻若＜ゃ潟潟ゃ障
+コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
.RE
+
+.LP
.SS
-ｨ絅潟潟茵激с潟喝ゃ潟潟茵激с潟网荀
+非標準のコマンド行オプション
.LP
.RS 3
+.TP 3
+\-Xlocator
+生成されたコードでは、非整列化のあとに Java Bean インスタンスに含まれるソース XML に関する SAX Locator 情報が公開されます。
+.TP 3
+\-Xsync\-methods
+生成されたすべてのメソッドシグニチャーに \f2同期された\fP キーワードが含められます。
+.TP 3
+\-mark\-generated
+生成されたコードに注釈 \f2@javax.annotation.Generated\fP を付けます。
+.TP 3
+\-episode <file>
+コンパイルごとに指定されたエピソードファイルを生成します。
+.RE
.LP
+.SS
+非推奨コマンド行オプションおよび削除されたコマンド行オプション
+.LP
.RS 3
.TP 3
\-host & \-port
-激с潟ｨ絅\f3\-httpproxy\fP 激с潟х舟障激с潟筝篏篋с腆坂у膓泣若障ャ＜潟荐莠絨ャ若鴻уゃ醇с障
+これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
.TP 3
\-use\-runtime
-JAXB 2.0 篁罕хЩ罎с潟帥ゃ荀鎘JAXB RI **/impl/runtime 宴若吾綽荀障鴻ゃ筝荀ゃ障
+JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
.TP 3
\-source
-\-source 篋с鴻ゃJAXB 2.0 Early Access уャ障鴻ゃJAXB 2.0 篁緇若鴻ゃ障1.0.x 潟若綽荀翫1.0.x 潟若若鴻ゃ潟鴻若篏睡
-.TP 3
-\-Xlocator & \-Xsync\-methods
-鴻ゃ憝鴻с≦劫障罘純絨ャャ潟若箴篋絎с
+\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。このスイッチは、JAXB 2.0 の今後のリリースから削除されることになりました。1.0.x コードを生成する必要がある場合は、1.0.x コードベースのインストールを使用してください。
.RE
.LP
-.RE
.SS
-潟潟ゃ狗
+コンパイラの制限
.LP
.LP
-絽吾∫ｃ鴻鴻若ゃ潟ｃ潟違潟潟ゃ鴻ゃ絎 1 ゃ篏潟潟ゃｃ絎с
+通常は、関連するすべてのスキーマを、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
.LP
.LP
-xjc 絎茵罨＜腓冴狗羈狗祉xjc 篏綺若喝冴茲違鴻若潟潟ゃ翫翠障
+xjc を実行するときは、次に示す制限に注意してください。これらの制限のほとんどは、xjc を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
.LP
.RS 3
.TP 2
o
-茲違鴻若潟潟ゃ翫帥若蚊 Java 宴若後罨＜篏荀羈
+複数のスキーマを同時にコンパイルする場合は、ターゲットの Java パッケージ名に次の優先順位の規則が適用されることに注意してください。
.RS 3
.TP 3
1.
-\f2\-p\fP潟潟茵激с潟ｃ障
+「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
.TP 3
2.
-<\f2jaxb:package\fP> 鴻帥ゃ
+<\f2jaxb:package\fP> のカスタマイズ
.TP 3
3.
-\f2targetNamespace\fP 絎ｈ翫篁罕絎臂 \f2targetNamespace\fP \-> Java 宴若後≪眼冴障
+\f2targetNamespace\fP が宣言されている場合は、 \f2仕様に定義されている targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
.TP 3
4.
-\f2targetNamespace\fP 絎ｈ翫"generated" 若潟若宴若吾篏睡障
+\f2targetNamespace\fP が宣言されていない場合は、「generated」という名前のハードコードされたパッケージを使用します。
.RE
.TP 2
o
-腥咲茲違 <\f2jaxb:schemaBindings\fP> ゃ筝罩ｃс 1 ゃ帥若蚊腥咲 2 ゃ鴻若違 Java 宴若吾潟潟ゃс障
+名前空間ごとに複数の <\f2jaxb:schemaBindings\fP> を持つことは不正です。このため、1 つのターゲット名前空間内の 2 つのスキーマを異なる Java パッケージにコンパイルすることはできません。
.TP 2
o
-1 ゃ Java 宴若吾潟潟ゃ鴻鴻若XJC ゃ潟ｃ潟違潟潟ゃ篆＜綽荀障 ャ潟潟ゃс篋篏障
+1 つの Java パッケージにコンパイルされるすべてのスキーマは、XJC バインディングコンパイラに同時に送信する必要があります。個別にコンパイルすることはできず、予期したとおりに動作しません。
.TP 2
o
-茲違鴻若＜ゃ障荀膣臀違若潟潟ゃ綽荀障
+複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
.RE
.LP
-.SH "∫ｉ"
+.SH "関連項目"
.LP
.RS 3
.TP 2
o
-潟潟茵с潟潟若帥絎茵 (XJC):[
+コマンド行でのコンバータの実行 (XJC): [
.na
-\f2潟潟茵巡擦\fP @
+\f2コマンド行の命令\fP @
.fi
-https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html
+https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html、
.na
-\f2xjc Ant 篏睡\fP @
+\f2xjc を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
.TP 2
o
.na
-\f2XML ゃ潟 JavaTM ≪若ｃ (JAXB)\fP @
+\f2XML バインドのための Java アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
--- a/jdk/test/java/util/jar/JarInputStream/ScanSignedJar.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/test/java/util/jar/JarInputStream/ScanSignedJar.java Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2011, 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
@@ -27,11 +27,9 @@
* @summary Confirm that JarEntry.getCertificates identifies signed entries.
*/
-import java.io.*;
import java.net.URL;
import java.security.CodeSigner;
import java.security.cert.Certificate;
-import java.util.Enumeration;
import java.util.jar.*;
/*
@@ -72,6 +70,9 @@
if (signers == null && certificates == null) {
System.out.println("[unsigned]\t" + name + "\t(" + size +
" bytes)");
+ if (name.equals("Count.class")) {
+ throw new Exception("Count.class should be signed");
+ }
} else if (signers != null && certificates != null) {
System.out.println("[" + signers.length +
(signers.length == 1 ? " signer" : " signers") + "]\t" +
--- a/jdk/test/java/util/jar/JarInputStream/TestIndexedJarWithBadSignature.java Mon May 02 09:36:45 2011 -0700
+++ b/jdk/test/java/util/jar/JarInputStream/TestIndexedJarWithBadSignature.java Wed Jul 05 17:42:56 2017 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2011, 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
@@ -37,7 +37,7 @@
public static void main(String...args) throws Throwable {
try (JarInputStream jis = new JarInputStream(
- new FileInputStream(System.getProperty("tst.src", ".") +
+ new FileInputStream(System.getProperty("test.src", ".") +
System.getProperty("file.separator") +
"BadSignedJar.jar")))
{