Mercurial > hg > release > icedtea7-forest-2.5 > jdk
changeset 5214:c1dadea1a083
Merge
author | asaha |
---|---|
date | Mon, 16 Apr 2012 11:16:28 -0700 |
parents | 26243ee3de2e (current diff) 81a0f71a895e (diff) |
children | aa47efbd5b6d |
files | .hgtags src/macosx/classes/sun/lwawt/macosx/LWCToolkit.java test/tools/launcher/TestHelper.java |
diffstat | 164 files changed, 8660 insertions(+), 7162 deletions(-) [+] |
line wrap: on
line diff
--- a/.hgtags Mon Apr 02 15:01:04 2012 -0700 +++ b/.hgtags Mon Apr 16 11:16:28 2012 -0700 @@ -163,6 +163,8 @@ df20c60949f8cef09be1e89d754cff366eaf7aa4 jdk7u4-b16 b4401b362fd8076d705aa57acb9967b5962a795d jdk7u4-b17 084825fc677ef6adecab9400a2625eb0e5579509 jdk7u4-b18 +0f9aacb27534e7bba7ba30a2700a9c828416929d jdk7u4-b19 +1a495432b42a496bde0ddfa16c6462742d7a8cf1 jdk7u4-b20 09f612bac047b132bb9bf7d4aa8afe6ea4d5b938 jdk7u6-b01 420027ae37b33e350877f3616ec857c00bd4c958 jdk7u6-b02 8e8cedfb1ee265f4aff8441bae2ebf0f5b1ee853 jdk7u6-b03
--- a/make/common/Defs-linux.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/Defs-linux.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -53,6 +53,11 @@ PLATFORM_SRC = $(BUILDDIR)/../src/solaris endif # PLATFORM_SRC +# Location of the various .properties files specific to Linux platform +ifndef PLATFORM_PROPERTIES + PLATFORM_PROPERTIES = $(BUILDDIR)/../src/solaris/lib +endif # PLATFORM_SRC + # Platform specific closed sources ifndef OPENJDK ifndef CLOSED_PLATFORM_SRC
--- a/make/common/Defs-macosx.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/Defs-macosx.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ # -# Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. +# Copyright (c) 1999, 2012, 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 @@ -53,6 +53,11 @@ PLATFORM_SRC = $(BUILDDIR)/../src/solaris endif # PLATFORM_SRC +# Location of the various .properties files specific to MacOS X platform +ifndef PLATFORM_PROPERTIES + PLATFORM_PROPERTIES = $(BUILDDIR)/../src/macosx/lib +endif # PLATFORM_SRC + PLATFORM_SRC_MACOS = $(BUILDDIR)/../src/macosx # BSD build pulls its platform sources from the solaris tree. @@ -106,10 +111,10 @@ # For all platforms, do not omit the frame pointer register usage. # We need this frame pointer to make it easy to walk the stacks. -# This should be the default on X86, but ia64 and amd64 may not have this -# as the default. -CFLAGS_REQUIRED_amd64 += -m64 -fno-omit-frame-pointer -D_LITTLE_ENDIAN -LDFLAGS_COMMON_amd64 += -m64 +# This should be the default on X86, but ia64, and x86_64 +# may not have this as the default. +CFLAGS_REQUIRED_x86_64 += -m64 -fno-omit-frame-pointer -D_LITTLE_ENDIAN +LDFLAGS_COMMON_x86_64 += -m64 CFLAGS_REQUIRED_i586 += -m32 -fno-omit-frame-pointer -D_LITTLE_ENDIAN LDFLAGS_COMMON_i586 += -m32 CFLAGS_REQUIRED_ia64 += -m64 -fno-omit-frame-pointer -D_LITTLE_ENDIAN @@ -163,7 +168,7 @@ PIC_CODE_SMALL = -fpic GLOBAL_KPIC = $(PIC_CODE_LARGE) CFLAGS_COMMON += $(GLOBAL_KPIC) $(GCC_WARNINGS) -ifeq ($(ARCH), amd64) +ifeq ($(ARCH), x86_64) CFLAGS_COMMON += -pipe endif
--- a/make/common/Defs-solaris.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/Defs-solaris.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -51,6 +51,11 @@ PLATFORM_SRC = $(BUILDDIR)/../src/solaris endif # PLATFORM_SRC +# Location of the various .properties files specific to Solaris platform +ifndef PLATFORM_PROPERTIES + PLATFORM_PROPERTIES = $(BUILDDIR)/../src/solaris/lib +endif # PLATFORM_SRC + # Platform specific closed sources ifndef OPENJDK ifndef CLOSED_PLATFORM_SRC
--- a/make/common/Defs-windows.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/Defs-windows.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -53,6 +53,11 @@ PLATFORM_SRC = $(BUILDDIR)/../src/windows endif # PLATFORM_SRC +# Location of the various .properties files specific to Windows platform +ifndef PLATFORM_PROPERTIES + PLATFORM_PROPERTIES = $(BUILDDIR)/../src/windows/lib +endif # PLATFORM_SRC + # Platform specific closed sources ifndef OPENJDK ifndef CLOSED_PLATFORM_SRC
--- a/make/common/Release.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/Release.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -146,6 +146,7 @@ javadoc.1 \ javah.1 \ javap.1 \ + jcmd.1 \ jconsole.1 \ jdb.1 \ jhat.1 \ @@ -615,10 +616,6 @@ $(ECHO) "oracle/jrockit/jfr/parser/" >> $@ $(ECHO) "oracle/jrockit/jfr/settings/" >> $@ $(ECHO) "oracle/jrockit/jfr/tools/" >> $@ - $(ECHO) "oracle/jrockit/jfr/util/" >> $@ - $(ECHO) "oracle/jrockit/jfr/util/log/" >> $@ - $(ECHO) "oracle/jrockit/jfr/util/os/" >> $@ - $(ECHO) "oracle/jrockit/jfr/util/text/" >> $@ endif endif @@ -645,7 +642,7 @@ $(MV) $@.temp $@ @($(CD) $(CLASSBINDIR) && $(java-vm-cleanup)) -# Create the jfr.jar containing Java Flight Recorder implementation +# Create jfr.jar JFR_JAR= ifndef OPENJDK ifndef JAVASE_EMBEDDED
--- a/make/common/shared/Platform.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/common/shared/Platform.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ # -# Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. +# Copyright (c) 1997, 2012, 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 @@ -262,7 +262,7 @@ echo sparc \ ;; \ x86_64) \ - echo amd64 \ + echo x86_64 \ ;; \ "Power Macintosh") \ echo ppc \
--- a/make/java/awt/Makefile Mon Apr 02 15:01:04 2012 -0700 +++ b/make/java/awt/Makefile Mon Apr 16 11:16:28 2012 -0700 @@ -57,7 +57,7 @@ properties: $(LIBDIR) $(LIBPROPS) -$(LIBDIR)/%.properties: $(PLATFORM_SRC)/lib/%.properties +$(LIBDIR)/%.properties: $(PLATFORM_PROPERTIES)/%.properties $(install-file) properties.clean :
--- a/make/java/java/FILES_java.gmk Mon Apr 02 15:01:04 2012 -0700 +++ b/make/java/java/FILES_java.gmk Mon Apr 16 11:16:28 2012 -0700 @@ -51,6 +51,7 @@ java/lang/SuppressWarnings.java \ java/lang/AbstractStringBuilder.java \ java/lang/ClassLoader.java \ + java/lang/ClassLoaderHelper.java \ java/lang/AssertionStatusDirectives.java \ java/lang/Enum.java \ java/lang/StrictMath.java \
--- a/make/sun/javazic/tzdata/VERSION Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/VERSION Mon Apr 16 11:16:28 2012 -0700 @@ -21,4 +21,4 @@ # or visit www.oracle.com if you need additional information or have any # questions. # -tzdata2011l +tzdata2012c
--- a/make/sun/javazic/tzdata/africa Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/africa Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)africa 8.33 +# @(#)africa 8.35 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -791,6 +791,37 @@ # wall clock time (i.e. 11pm UTC), but that's what I would assume. It has # also been like that in the past. +# From Alexander Krivenyshev (2012-03-09): +# According to Infomédiaire web site from Morocco (infomediaire.ma), +# on March 9, 2012, (in French) Heure légale: +# Le Maroc adopte officiellement l'heure d'été +# <a href="http://www.infomediaire.ma/news/maroc/heure-l%C3%A9gale-le-maroc-adopte-officiellement-lheure-d%C3%A9t%C3%A9"> +# http://www.infomediaire.ma/news/maroc/heure-l%C3%A9gale-le-maroc-adopte-officiellement-lheure-d%C3%A9t%C3%A9 +# </a> +# Governing Council adopted draft decree, that Morocco DST starts on +# the last Sunday of March (March 25, 2012) and ends on +# last Sunday of September (September 30, 2012) +# except the month of Ramadan. +# or (brief) +# <a href="http://www.worldtimezone.com/dst_news/dst_news_morocco06.html"> +# http://www.worldtimezone.com/dst_news/dst_news_morocco06.html +# </a> + +# From Arthur David Olson (2012-03-10): +# The infomediaire.ma source indicates that the system is to be in +# effect every year. It gives 03H00 as the "fall back" time of day; +# it lacks a "spring forward" time of day; assume 2:00 XXX. +# Wait on specifying the Ramadan exception for details about +# start date, start time of day, end date, and end time of day XXX. + +# From Christophe Tropamer (2012-03-16): +# Seen Morocco change again: +# <a href="http://www.le2uminutes.com/actualite.php"> +# http://www.le2uminutes.com/actualite.php +# </a> +# "...à partir du dernier dimance d'avril et non fins mars, +# comme annoncé précédemment." + # RULE NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Morocco 1939 only - Sep 12 0:00 1:00 S @@ -816,6 +847,9 @@ Rule Morocco 2010 only - Aug 8 0:00 0 - Rule Morocco 2011 only - Apr 3 0:00 1:00 S Rule Morocco 2011 only - Jul 31 0 0 - +Rule Morocco 2012 max - Apr lastSun 2:00 1:00 S +Rule Morocco 2012 max - Sep lastSun 3:00 0 - + # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Africa/Casablanca -0:30:20 - LMT 1913 Oct 26 0:00 Morocco WE%sT 1984 Mar 16
--- a/make/sun/javazic/tzdata/antarctica Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/antarctica Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)antarctica 8.9 +# @(#)antarctica 8.10 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -65,8 +65,19 @@ Rule ChileAQ 1998 only - Mar Sun>=9 3:00u 0 - Rule ChileAQ 1998 only - Sep 27 4:00u 1:00 S Rule ChileAQ 1999 only - Apr 4 3:00u 0 - -Rule ChileAQ 1999 max - Oct Sun>=9 4:00u 1:00 S -Rule ChileAQ 2000 max - Mar Sun>=9 3:00u 0 - +Rule ChileAQ 1999 2010 - Oct Sun>=9 4:00u 1:00 S +Rule ChileAQ 2000 2007 - Mar Sun>=9 3:00u 0 - +# N.B.: the end of March 29 in Chile is March 30 in Universal time, +# which is used below in specifying the transition. +Rule ChileAQ 2008 only - Mar 30 3:00u 0 - +Rule ChileAQ 2009 only - Mar Sun>=9 3:00u 0 - +Rule ChileAQ 2010 only - Apr Sun>=1 3:00u 0 - +Rule ChileAQ 2011 only - May Sun>=2 3:00u 0 - +Rule ChileAQ 2011 only - Aug Sun>=16 4:00u 1:00 S +Rule ChileAQ 2012 only - Apr Sun>=23 3:00u 0 - +Rule ChileAQ 2012 only - Sep Sun>=2 4:00u 1:00 S +Rule ChileAQ 2013 max - Mar Sun>=9 3:00u 0 - +Rule ChileAQ 2013 max - Oct Sun>=9 4:00u 1:00 S # These rules are stolen from the `australasia' file. Rule AusAQ 1917 only - Jan 1 0:01 1:00 - @@ -165,12 +176,16 @@ # Western (Aus) Standard Time 11:00 - CAST 2010 Mar 5 2:00 # Casey Time + 8:00 - WST 2011 Oct 28 2:00 + 11:00 - CAST 2012 Feb 21 17:00u 8:00 - WST Zone Antarctica/Davis 0 - zzz 1957 Jan 13 7:00 - DAVT 1964 Nov # Davis Time 0 - zzz 1969 Feb 7:00 - DAVT 2009 Oct 18 2:00 5:00 - DAVT 2010 Mar 10 20:00u + 7:00 - DAVT 2011 Oct 28 2:00 + 5:00 - DAVT 2012 Feb 21 20:00u 7:00 - DAVT Zone Antarctica/Mawson 0 - zzz 1954 Feb 13 6:00 - MAWT 2009 Oct 18 2:00
--- a/make/sun/javazic/tzdata/asia Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/asia Mon Apr 16 11:16:28 2012 -0700 @@ -21,7 +21,8 @@ # or visit www.oracle.com if you need additional information or have any # questions. # -# @(#)asia 8.68 +# <pre> +# @(#)asia 8.73 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -100,10 +101,6 @@ Rule RussiaAsia 1993 1995 - Sep lastSun 2:00s 0 - Rule RussiaAsia 1996 max - Oct lastSun 2:00s 0 - -# From Arthur David Olson (2011-06-15): -# While Russia abandoned DST in 2011, Armenia may choose to -# follow Russia's "old" rules. - # Afghanistan # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Asia/Kabul 4:36:48 - LMT 1890 @@ -120,6 +117,21 @@ # in 1996, though it did use DST in 1995. IATA SSIM (1991/1998) reports that # Armenia switched from 3:00 to 4:00 in 1998 and observed DST after 1991, # but started switching at 3:00s in 1998. + +# From Arthur David Olson (2011-06-15): +# While Russia abandoned DST in 2011, Armenia may choose to +# follow Russia's "old" rules. + +# From Alexander Krivenyshev (2012-02-10): +# According to News Armenia, on Feb 9, 2012, +# http://newsarmenia.ru/society/20120209/42609695.html +# +# The Armenia National Assembly adopted final reading of Amendments to the +# Law "On procedure of calculation time on the territory of the Republic of +# Armenia" according to which Armenia [is] abolishing Daylight Saving Time. +# or +# (brief) +# http://www.worldtimezone.com/dst_news/dst_news_armenia03.html # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Asia/Yerevan 2:58:00 - LMT 1924 May 2 3:00 - YERT 1957 Mar # Yerevan Time @@ -127,7 +139,8 @@ 3:00 1:00 YERST 1991 Sep 23 # independence 3:00 RussiaAsia AM%sT 1995 Sep 24 2:00s 4:00 - AMT 1997 - 4:00 RussiaAsia AM%sT + 4:00 RussiaAsia AM%sT 2012 Mar 25 2:00s + 4:00 - AMT # Azerbaijan # From Rustam Aliyev of the Azerbaijan Internet Forum (2005-10-23): @@ -2258,6 +2271,29 @@ # http://www.maannews.net/eng/ViewDetails.aspx?ID=424808 # </a> +# From Steffen Thorsen (2012-03-26): +# Palestinian news sources tell that both Gaza and West Bank will start DST +# on Friday (Thursday midnight, 2012-03-29 24:00). +# Some of many sources in Arabic: +# <a href="http://www.samanews.com/index.php?act=Show&id=122638"> +# http://www.samanews.com/index.php?act=Show&id=122638 +# </a> +# +# <a href="http://safa.ps/details/news/74352/%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%AA%D9%88%D9%82%D9%8A%D8%AA-%D8%A7%D9%84%D8%B5%D9%8A%D9%81%D9%8A-%D8%A8%D8%A7%D9%84%D8%B6%D9%81%D8%A9-%D9%88%D8%BA%D8%B2%D8%A9-%D9%84%D9%8A%D9%84%D8%A9-%D8%A7%D9%84%D8%AC%D9%85%D8%B9%D8%A9.html"> +# http://safa.ps/details/news/74352/%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%AA%D9%88%D9%82%D9%8A%D8%AA-%D8%A7%D9%84%D8%B5%D9%8A%D9%81%D9%8A-%D8%A8%D8%A7%D9%84%D8%B6%D9%81%D8%A9-%D9%88%D8%BA%D8%B2%D8%A9-%D9%84%D9%8A%D9%84%D8%A9-%D8%A7%D9%84%D8%AC%D9%85%D8%B9%D8%A9.html +# </a> +# +# Our brief summary: +# <a href="http://www.timeanddate.com/news/time/gaza-west-bank-dst-2012.html"> +# http://www.timeanddate.com/news/time/gaza-west-bank-dst-2012.html +# </a> + +# From Arthur David Olson (2012-03-27): +# The timeanddate article for 2012 says that "the end date has not yet been +# announced" and that "Last year, both...paused daylight saving time during... +# Ramadan. It is not yet known [for] 2012." +# For now, assume both switch back on the last Friday in September. XXX + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule EgyptAsia 1957 only - May 10 0:00 1:00 S Rule EgyptAsia 1957 1958 - Oct 1 0:00 0 - @@ -2290,6 +2326,8 @@ 2:00 Jordan EE%sT 1999 2:00 Palestine EE%sT 2011 Apr 2 12:01 2:00 1:00 EEST 2011 Aug 1 + 2:00 - EET 2012 Mar 30 + 2:00 1:00 EEST 2012 Sep 28 2:00 - EET Zone Asia/Hebron 2:20:23 - LMT 1900 Oct @@ -2303,6 +2341,8 @@ 2:00 1:00 EEST 2011 Aug 1 2:00 - EET 2011 Aug 30 2:00 1:00 EEST 2011 Sep 30 3:00 + 2:00 - EET 2012 Mar 30 + 2:00 1:00 EEST 2012 Sep 28 3:00 2:00 - EET # Paracel Is @@ -2594,10 +2634,28 @@ # http://sns.sy/sns/?path=news/read/11421 (Arabic) # </a> +# From Steffen Thorsen (2012-03-26): +# Today, Syria's government announced that they will start DST early on Friday +# (00:00). This is a bit earlier than the past two years. +# +# From Syrian Arab News Agency, in Arabic: +# <a href="http://www.sana.sy/ara/2/2012/03/26/408215.htm"> +# http://www.sana.sy/ara/2/2012/03/26/408215.htm +# </a> +# +# Our brief summary: +# <a href="http://www.timeanddate.com/news/time/syria-dst-2012.html"> +# http://www.timeanddate.com/news/time/syria-dst-2012.html +# </a> + +# From Arthur David Olson (2012-03-27): +# Assume last Friday in March going forward XXX. + Rule Syria 2008 only - Apr Fri>=1 0:00 1:00 S Rule Syria 2008 only - Nov 1 0:00 0 - Rule Syria 2009 only - Mar lastFri 0:00 1:00 S -Rule Syria 2010 max - Apr Fri>=1 0:00 1:00 S +Rule Syria 2010 2011 - Apr Fri>=1 0:00 1:00 S +Rule Syria 2012 max - Mar lastFri 0:00 1:00 S Rule Syria 2009 max - Oct lastFri 0:00 0 - # Zone NAME GMTOFF RULES FORMAT [UNTIL]
--- a/make/sun/javazic/tzdata/australasia Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/australasia Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)australasia 8.27 +# @(#)australasia 8.30 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -331,6 +331,20 @@ # advance at 2am to 3am on October 23, 2011 and one hour back at 3am to # 2am on February 26 next year. +# From Ken Rylander (2011-10-24) +# Another change to the Fiji DST end date. In the TZ database the end date for +# Fiji DST 2012, is currently Feb 26. This has been changed to Jan 22. +# +# <a href="http://www.fiji.gov.fj/index.php?option=com_content&view=article&id=5017:amendments-to-daylight-savings&catid=71:press-releases&Itemid=155"> +# http://www.fiji.gov.fj/index.php?option=com_content&view=article&id=5017:amendments-to-daylight-savings&catid=71:press-releases&Itemid=155 +# </a> +# states: +# +# The end of daylight saving scheduled initially for the 26th of February 2012 +# has been brought forward to the 22nd of January 2012. +# The commencement of daylight saving will remain unchanged and start +# on the 23rd of October, 2011. + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Fiji 1998 1999 - Nov Sun>=1 2:00 1:00 S Rule Fiji 1999 2000 - Feb lastSun 3:00 0 - @@ -339,7 +353,7 @@ Rule Fiji 2010 only - Oct 24 2:00 1:00 S Rule Fiji 2011 only - Mar Sun>=1 3:00 0 - Rule Fiji 2011 only - Oct 23 2:00 1:00 S -Rule Fiji 2012 only - Feb 26 3:00 0 - +Rule Fiji 2012 only - Jan 22 3:00 0 - # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Pacific/Fiji 11:53:40 - LMT 1915 Oct 26 # Suva 12:00 Fiji FJ%sT # Fiji Time @@ -625,6 +639,11 @@ # Dateline Change skip Friday 30th Dec 2011 # Thursday 29th December 2011 23:59:59 Hours # Saturday 31st December 2011 00:00:00 Hours +# +# Clarification by Tim Parenti (2012-01-03): +# Although Samoa has used Daylight Saving Time in the 2010-2011 and 2011-2012 +# seasons, there is not yet any indication that this trend will continue on +# a regular basis. For now, we have explicitly listed the transitions below. Zone Pacific/Apia 12:33:04 - LMT 1879 Jul 5 -11:26:56 - LMT 1911 -11:30 - SAMT 1950 # Samoa Time @@ -642,9 +661,28 @@ 11:00 - SBT # Solomon Is Time # Tokelau Is +# +# From Gwillim Law (2011-12-29) +# A correspondent informed me that Tokelau, like Samoa, will be skipping +# December 31 this year, thereby changing its time zone from UTC-10 to +# UTC+14. When I tried to verify this statement, I found a confirming +# article in Time magazine online +# <a href="http://www.time.com/time/world/article/0,8599,2103243,00.html"> +# (http://www.time.com/time/world/article/0,8599,2103243,00.html). +# </a> +# +# From Jonathan Leffler (2011-12-29) +# Information from the BBC to the same effect: +# <a href="http://www.bbc.co.uk/news/world-asia-16351377"> +# http://www.bbc.co.uk/news/world-asia-16351377 +# </a> +# +# Patch supplied by Tim Parenti (2011-12-29) + # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Pacific/Fakaofo -11:24:56 - LMT 1901 - -10:00 - TKT # Tokelau Time + -10:00 - TKT 2011 Dec 30 # Tokelau Time + 14:00 - TKT # Tonga # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S
--- a/make/sun/javazic/tzdata/backward Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/backward Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)backward 8.9 +# @(#)backward 8.11 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson.
--- a/make/sun/javazic/tzdata/europe Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/europe Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)europe 8.38 +# @(#)europe 8.41 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -234,9 +234,15 @@ # the history of summer time legislation in the United Kingdom. # Since 1998 Joseph S. Myers has been updating # and extending this list, which can be found in -# <a href="http://student.cusu.cam.ac.uk/~jsm28/british-time/"> +# http://student.cusu.cam.ac.uk/~jsm28/british-time/ +# <a href="http://www.polyomino.org.uk/british-time/"> # History of legal time in Britain # </a> +# Rob Crowther (2012-01-04) reports that that URL no longer +# exists, and the article can now be found at: +# <a href="http://www.polyomino.org.uk/british-time/"> +# http://www.polyomino.org.uk/british-time/ +# </a> # From Joseph S. Myers (1998-01-06): # @@ -1174,10 +1180,10 @@ # write that they were used in Monaco and in many French locations. # Le Corre writes that the upper limit of the free zone was Arneguy, Orthez, # Mont-de-Marsan, Bazas, Langon, Lamotte-Montravel, Marouil, La -# Rochefoucault, Champagne-Mouton, La Roche-Posay, La Haye-Decartes, +# Rochefoucault, Champagne-Mouton, La Roche-Posay, La Haye-Descartes, # Loches, Montrichard, Vierzon, Bourges, Moulins, Digoin, # Paray-le-Monial, Montceau-les-Mines, Chalons-sur-Saone, Arbois, -# Dole, Morez, St-Claude, and Collognes (Haute-Savioe). +# Dole, Morez, St-Claude, and Collonges (Haute-Savoie). Rule France 1941 only - May 5 0:00 2:00 M # Midsummer # Shanks & Pottenger say this transition occurred at Oct 6 1:00, # but go with Denis Excoffier (1997-12-12), @@ -1678,6 +1684,41 @@ # But [two people] separately reported via # Jesper Norgaard that as of 2001-01-24 Tiraspol was like Chisinau. # The Tiraspol entry has therefore been removed for now. +# +# From Alexander Krivenyshev (2011-10-17): +# Pridnestrovian Moldavian Republic (PMR, also known as +# "Pridnestrovie") has abolished seasonal clock change (no transition +# to the Winter Time). +# +# News (in Russian): +# <a href="http://www.kyivpost.ua/russia/news/pridnestrove-otkazalos-ot-perehoda-na-zimnee-vremya-30954.html"> +# http://www.kyivpost.ua/russia/news/pridnestrove-otkazalos-ot-perehoda-na-zimnee-vremya-30954.html +# </a> +# +# <a href="http://www.allmoldova.com/moldova-news/1249064116.html"> +# http://www.allmoldova.com/moldova-news/1249064116.html +# </a> +# +# The substance of this change (reinstatement of the Tiraspol entry) +# is from a patch from Petr Machata (2011-10-17) +# +# From Tim Parenti (2011-10-19) +# In addition, being situated at +4651+2938 would give Tiraspol +# a pre-1880 LMT offset of 1:58:32. +# +# (which agrees with the earlier entry that had been removed) +# +# From Alexander Krivenyshev (2011-10-26) +# NO need to divide Moldova into two timezones at this point. +# As of today, Transnistria (Pridnestrovie)- Tiraspol reversed its own +# decision to abolish DST this winter. +# Following Moldova and neighboring Ukraine- Transnistria (Pridnestrovie)- +# Tiraspol will go back to winter time on October 30, 2011. +# News from Moldova (in russian): +# <a href="http://ru.publika.md/link_317061.html"> +# http://ru.publika.md/link_317061.html +# </a> + # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Europe/Chisinau 1:55:20 - LMT 1880 @@ -2674,6 +2715,28 @@ # <a href="http://www.pravda.com.ua/rus/news/2011/09/20/6600616/"> # http://www.pravda.com.ua/rus/news/2011/09/20/6600616/ # </a> +# +# From Philip Pizzey (2011-10-18): +# Today my Ukrainian colleagues have informed me that the +# Ukrainian parliament have decided that they will go to winter +# time this year after all. +# +# From Udo Schwedt (2011-10-18): +# As far as I understand, the recent change to the Ukranian time zone +# (Europe/Kiev) to introduce permanent daylight saving time (similar +# to Russia) was reverted today: +# +# <a href="http://portal.rada.gov.ua/rada/control/en/publish/article/info_left?art_id=287324&cat_id=105995"> +# http://portal.rada.gov.ua/rada/control/en/publish/article/info_left?art_id=287324&cat_id=105995 +# </a> +# +# Also reported by Alexander Bokovoy (2011-10-18) who also noted: +# The law documents themselves are at +# +# <a href="http://w1.c1.rada.gov.ua/pls/zweb_n/webproc4_1?id=&pf3511=41484"> +# http://w1.c1.rada.gov.ua/pls/zweb_n/webproc4_1?id=&pf3511=41484 +# </a> + # Zone NAME GMTOFF RULES FORMAT [UNTIL] # Most of Ukraine since 1970 has been like Kiev. @@ -2688,8 +2751,7 @@ 3:00 - MSK 1990 Jul 1 2:00 2:00 - EET 1992 2:00 E-Eur EE%sT 1995 - 2:00 EU EE%sT 2011 Mar lastSun 1:00u - 3:00 - FET # Further-eastern European Time + 2:00 EU EE%sT # Ruthenia used CET 1990/1991. # "Uzhhorod" is the transliteration of the Ukrainian name, but # "Uzhgorod" is more common in English. @@ -2703,8 +2765,7 @@ 1:00 - CET 1991 Mar 31 3:00 2:00 - EET 1992 2:00 E-Eur EE%sT 1995 - 2:00 EU EE%sT 2011 Mar lastSun 1:00u - 3:00 - FET # Further-eastern European Time + 2:00 EU EE%sT # Zaporozh'ye and eastern Lugansk oblasts observed DST 1990/1991. # "Zaporizhia" is the transliteration of the Ukrainian name, but # "Zaporozh'ye" is more common in English. Use the common English @@ -2717,8 +2778,7 @@ 1:00 C-Eur CE%sT 1943 Oct 25 3:00 Russia MSK/MSD 1991 Mar 31 2:00 2:00 E-Eur EE%sT 1995 - 2:00 EU EE%sT 2011 Mar lastSun 1:00u - 3:00 - FET # Further-eastern European Time + 2:00 EU EE%sT # Central Crimea used Moscow time 1994/1997. Zone Europe/Simferopol 2:16:24 - LMT 1880 2:16 - SMT 1924 May 2 # Simferopol Mean T @@ -2743,8 +2803,7 @@ # Assume it happened in March by not changing the clocks. 3:00 Russia MSK/MSD 1997 3:00 - MSK 1997 Mar lastSun 1:00u - 2:00 EU EE%sT 2011 Mar lastSun 1:00u - 3:00 - FET # Further-eastern European Time + 2:00 EU EE%sT ###############################################################################
--- a/make/sun/javazic/tzdata/leapseconds Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/leapseconds Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)leapseconds 8.11 +# @(#)leapseconds 8.13 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -71,40 +71,54 @@ Leap 1998 Dec 31 23:59:60 + S Leap 2005 Dec 31 23:59:60 + S Leap 2008 Dec 31 23:59:60 + S +Leap 2012 Jun 30 23:59:60 + S # INTERNATIONAL EARTH ROTATION AND REFERENCE SYSTEMS SERVICE (IERS) # # SERVICE INTERNATIONAL DE LA ROTATION TERRESTRE ET DES SYSTEMES DE REFERENCE # +# # SERVICE DE LA ROTATION TERRESTRE # OBSERVATOIRE DE PARIS # 61, Av. de l'Observatoire 75014 PARIS (France) -# Tel. : 33 (0) 1 40 51 22 29 +# Tel. : 33 (0) 1 40 51 22 26 # FAX : 33 (0) 1 40 51 22 91 -# Internet : services.iers@obspm.fr +# e-mail : (E-Mail Removed) +# http://hpiers.obspm.fr/eop-pc # -# Paris, 2 February 2011 +# Paris, 5 January 2012 # -# Bulletin C 41 +# +# Bulletin C 43 # # To authorities responsible # for the measurement and # distribution of time # -# INFORMATION ON UTC - TAI +# +# UTC TIME STEP +# on the 1st of July 2012 +# # -# NO positive leap second will be introduced at the end of June 2011. -# The difference between Coordinated Universal Time UTC and the -# International Atomic Time TAI is : +# A positive leap second will be introduced at the end of June 2012. +# The sequence of dates of the UTC second markers will be: +# +# 2012 June 30, 23h 59m 59s +# 2012 June 30, 23h 59m 60s +# 2012 July 1, 0h 0m 0s # -# from 2009 January 1, 0h UTC, until further notice : UTC-TAI = -34 s +# The difference between UTC and the International Atomic Time TAI is: +# +# from 2009 January 1, 0h UTC, to 2012 July 1 0h UTC : UTC-TAI = - 34s +# from 2012 July 1, 0h UTC, until further notice : UTC-TAI = - 35s # # Leap seconds can be introduced in UTC at the end of the months of December -# or June, depending on the evolution of UT1-TAI. Bulletin C is mailed every -# six months, either to announce a time step in UTC, or to confirm that there +# or June, depending on the evolution of UT1-TAI. Bulletin C is mailed every +# six months, either to announce a time step in UTC or to confirm that there # will be no time step at the next possible date. # +# # Daniel GAMBIS -# Head -# Earth Orientation Center of the IERS +# Head +# Earth Orientation Center of IERS # Observatoire de Paris, France
--- a/make/sun/javazic/tzdata/northamerica Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/northamerica Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)northamerica 8.49 +# @(#)northamerica 8.54 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -1143,9 +1143,26 @@ # For now, assume all of DST-observing Canada will fall into line with the # new US DST rules, +# From Chris Walton (2011-12-01) +# In the first of Tammy Hardwick's articles +# <a href="http://www.ilovecreston.com/?p=articles&t=spec&ar=260"> +# http://www.ilovecreston.com/?p=articles&t=spec&ar=260 +# </a> +# she quotes the Friday November 1/1918 edition of the Creston Review. +# The quote includes these two statements: +# 'Sunday the CPR went back to the old system of time...' +# '... The daylight saving scheme was dropped all over Canada at the same time,' +# These statements refer to a transition from daylight time to standard time +# that occurred nationally on Sunday October 27/1918. This transition was +# also documented in the Saturday October 26/1918 edition of the Toronto Star. + +# In light of that evidence, we alter the date from the earlier believed +# Oct 31, to Oct 27, 1918 (and Sunday is a more likely transition day +# than Thursday) in all Canadian rulesets. + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Canada 1918 only - Apr 14 2:00 1:00 D -Rule Canada 1918 only - Oct 31 2:00 0 S +Rule Canada 1918 only - Oct 27 2:00 0 S Rule Canada 1942 only - Feb 9 2:00 1:00 W # War Rule Canada 1945 only - Aug 14 23:00u 1:00 P # Peace Rule Canada 1945 only - Sep 30 2:00 0 S @@ -1668,7 +1685,7 @@ Rule Winn 1916 only - Apr 23 0:00 1:00 D Rule Winn 1916 only - Sep 17 0:00 0 S Rule Winn 1918 only - Apr 14 2:00 1:00 D -Rule Winn 1918 only - Oct 31 2:00 0 S +Rule Winn 1918 only - Oct 27 2:00 0 S Rule Winn 1937 only - May 16 2:00 1:00 D Rule Winn 1937 only - Sep 26 2:00 0 S Rule Winn 1942 only - Feb 9 2:00 1:00 W # War @@ -1751,7 +1768,7 @@ # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Regina 1918 only - Apr 14 2:00 1:00 D -Rule Regina 1918 only - Oct 31 2:00 0 S +Rule Regina 1918 only - Oct 27 2:00 0 S Rule Regina 1930 1934 - May Sun>=1 0:00 1:00 D Rule Regina 1930 1934 - Oct Sun>=1 0:00 0 S Rule Regina 1937 1941 - Apr Sun>=8 0:00 1:00 D @@ -1788,7 +1805,7 @@ # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Edm 1918 1919 - Apr Sun>=8 2:00 1:00 D -Rule Edm 1918 only - Oct 31 2:00 0 S +Rule Edm 1918 only - Oct 27 2:00 0 S Rule Edm 1919 only - May 27 2:00 0 S Rule Edm 1920 1923 - Apr lastSun 2:00 1:00 D Rule Edm 1920 only - Oct lastSun 2:00 0 S @@ -1818,9 +1835,68 @@ # Dawson Creek uses MST. Much of east BC is like Edmonton. # Matthews and Vincent (1998) write that Creston is like Dawson Creek. +# It seems though that (re: Creston) is not entirely correct: + +# From Chris Walton (2011-12-01): +# There are two areas within the Canadian province of British Columbia +# that do not currently observe daylight saving: +# a) The Creston Valley (includes the town of Creston and surrounding area) +# b) The eastern half of the Peace River Regional District +# (includes the cities of Dawson Creek and Fort St. John) + +# Earlier this year I stumbled across a detailed article about the time +# keeping history of Creston; it was written by Tammy Hardwick who is the +# manager of the Creston & District Museum. The article was written in May 2009. +# <a href="http://www.ilovecreston.com/?p=articles&t=spec&ar=260"> +# http://www.ilovecreston.com/?p=articles&t=spec&ar=260 +# </a> +# According to the article, Creston has not changed its clocks since June 1918. +# i.e. Creston has been stuck on UTC-7 for 93 years. +# Dawson Creek, on the other hand, changed its clocks as recently as April 1972. + +# Unfortunately the exact date for the time change in June 1918 remains +# unknown and will be difficult to ascertain. I e-mailed Tammy a few months +# ago to ask if Sunday June 2 was a reasonable guess. She said it was just +# as plausible as any other date (in June). She also said that after writing the +# article she had discovered another time change in 1916; this is the subject +# of another article which she wrote in October 2010. +# <a href="http://www.creston.museum.bc.ca/index.php?module=comments&uop=view_comment&cm+id=56"> +# http://www.creston.museum.bc.ca/index.php?module=comments&uop=view_comment&cm+id=56 +# </a> + +# Here is a summary of the three clock change events in Creston's history: +# 1. 1884 or 1885: adoption of Mountain Standard Time (GMT-7) +# Exact date unknown +# 2. Oct 1916: switch to Pacific Standard Time (GMT-8) +# Exact date in October unknown; Sunday October 1 is a reasonable guess. +# 3. June 1918: switch to Pacific Daylight Time (GMT-7) +# Exact date in June unknown; Sunday June 2 is a reasonable guess. +# note#1: +# On Oct 27/1918 when daylight saving ended in the rest of Canada, +# Creston did not change its clocks. +# note#2: +# During WWII when the Federal Government legislated a mandatory clock change, +# Creston did not oblige. +# note#3: +# There is no guarantee that Creston will remain on Mountain Standard Time +# (UTC-7) forever. +# The subject was debated at least once this year by the town Council. +# <a href="http://www.bclocalnews.com/kootenay_rockies/crestonvalleyadvance/news/116760809.html"> +# http://www.bclocalnews.com/kootenay_rockies/crestonvalleyadvance/news/116760809.html +# </a> + +# During a period WWII, summer time (Daylight saying) was mandatory in Canada. +# In Creston, that was handled by shifting the area to PST (-8:00) then applying +# summer time to cause the offset to be -7:00, the same as it had been before +# the change. It can be argued that the timezone abbreviation during this +# period should be PDT rather than MST, but that doesn't seem important enough +# (to anyone) to further complicate the rules. + +# The transition dates (and times) are guesses. + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Vanc 1918 only - Apr 14 2:00 1:00 D -Rule Vanc 1918 only - Oct 31 2:00 0 S +Rule Vanc 1918 only - Oct 27 2:00 0 S Rule Vanc 1942 only - Feb 9 2:00 1:00 W # War Rule Vanc 1945 only - Aug 14 23:00u 1:00 P # Peace Rule Vanc 1945 only - Sep 30 2:00 0 S @@ -1836,7 +1912,10 @@ -8:00 Canada P%sT 1947 -8:00 Vanc P%sT 1972 Aug 30 2:00 -7:00 - MST - +Zone America/Creston -7:46:04 - LMT 1884 + -7:00 - MST 1916 Oct 1 + -8:00 - PST 1918 Jun 2 + -7:00 - MST # Northwest Territories, Nunavut, Yukon @@ -2713,6 +2792,34 @@ # <a href="http://www.timeanddate.com/news/time/cuba-starts-dst-2011.html"> # http://www.timeanddate.com/news/time/cuba-starts-dst-2011.html # </a> +# +# From Steffen Thorsen (2011-10-30) +# Cuba will end DST two weeks later this year. Instead of going back +# tonight, it has been delayed to 2011-11-13 at 01:00. +# +# One source (Spanish) +# <a href="http://www.radioangulo.cu/noticias/cuba/17105-cuba-restablecera-el-horario-del-meridiano-de-greenwich.html"> +# http://www.radioangulo.cu/noticias/cuba/17105-cuba-restablecera-el-horario-del-meridiano-de-greenwich.html +# </a> +# +# Our page: +# <a href="http://www.timeanddate.com/news/time/cuba-time-changes-2011.html"> +# http://www.timeanddate.com/news/time/cuba-time-changes-2011.html +# </a> +# +# From Steffen Thorsen (2012-03-01) +# According to Radio Reloj, Cuba will start DST on Midnight between March +# 31 and April 1. +# +# Radio Reloj has the following info (Spanish): +# <a href="http://www.radioreloj.cu/index.php/noticias-radio-reloj/71-miscelaneas/7529-cuba-aplicara-el-horario-de-verano-desde-el-1-de-abril"> +# http://www.radioreloj.cu/index.php/noticias-radio-reloj/71-miscelaneas/7529-cuba-aplicara-el-horario-de-verano-desde-el-1-de-abril +# </a> +# +# Our info on it: +# <a href="http://www.timeanddate.com/news/time/cuba-starts-dst-2012.html"> +# http://www.timeanddate.com/news/time/cuba-starts-dst-2012.html +# </a> # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Cuba 1928 only - Jun 10 0:00 1:00 D @@ -2744,12 +2851,15 @@ Rule Cuba 1998 1999 - Mar lastSun 0:00s 1:00 D Rule Cuba 1998 2003 - Oct lastSun 0:00s 0 S Rule Cuba 2000 2004 - Apr Sun>=1 0:00s 1:00 D -Rule Cuba 2006 max - Oct lastSun 0:00s 0 S +Rule Cuba 2006 2010 - Oct lastSun 0:00s 0 S Rule Cuba 2007 only - Mar Sun>=8 0:00s 1:00 D Rule Cuba 2008 only - Mar Sun>=15 0:00s 1:00 D Rule Cuba 2009 2010 - Mar Sun>=8 0:00s 1:00 D Rule Cuba 2011 only - Mar Sun>=15 0:00s 1:00 D -Rule Cuba 2012 max - Mar Sun>=8 0:00s 1:00 D +Rule Cuba 2011 only - Nov 13 0:00s 0 S +Rule Cuba 2012 only - Apr 1 0:00s 1:00 D +Rule Cuba 2012 max - Oct lastSun 0:00s 0 S +Rule Cuba 2013 max - Mar Sun>=8 0:00s 1:00 D # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone America/Havana -5:29:28 - LMT 1890 @@ -2883,6 +2993,29 @@ # From Stephen Colebourne (2007-02-22): # Some IATA info: Haiti won't be having DST in 2007. +# From Steffen Thorsen (2012-03-11): +# According to several news sources, Haiti will observe DST this year, +# apparently using the same start and end date as USA/Canada. +# So this means they have already changed their time. +# +# (Sources in French): +# <a href="http://www.alterpresse.org/spip.php?article12510"> +# http://www.alterpresse.org/spip.php?article12510 +# </a> +# <a href="http://radiovision2000haiti.net/home/?p=13253"> +# http://radiovision2000haiti.net/home/?p=13253 +# </a> +# +# Our coverage: +# <a href="http://www.timeanddate.com/news/time/haiti-dst-2012.html"> +# http://www.timeanddate.com/news/time/haiti-dst-2012.html +# </a> + +# From Arthur David Olson (2012-03-11): +# The alterpresse.org source seems to show a US-style leap from 2:00 a.m. to +# 3:00 a.m. rather than the traditional Haitian jump at midnight. +# Assume a US-style fall back as well XXX. +# Do not yet assume that the change carries forward past 2012 XXX. # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Haiti 1983 only - May 8 0:00 1:00 D @@ -2894,6 +3027,8 @@ Rule Haiti 1988 1997 - Oct lastSun 1:00s 0 S Rule Haiti 2005 2006 - Apr Sun>=1 0:00 1:00 D Rule Haiti 2005 2006 - Oct lastSun 0:00 0 S +Rule Haiti 2012 only - Mar Sun>=8 2:00 1:00 D +Rule Haiti 2012 only - Nov Sun>=1 2:00 0 S # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone America/Port-au-Prince -4:49:20 - LMT 1890 -4:49 - PPMT 1917 Jan 24 12:00 # P-a-P MT
--- a/make/sun/javazic/tzdata/southamerica Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/southamerica Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)southamerica 8.50 +# @(#)southamerica 8.53 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. @@ -841,6 +841,19 @@ # oficial agency about time in Brazil, and she confirmed that the old rule is # still in force. +# From Guilherme Bernardes Rodrigues (2011-10-14) +# It's official, the President signed a decree that includes Bahia in summer +# time. +# [ and in a second message (same day): ] +# I found the decree. +# +# DECRETO No- 7.584, DE 13 DE OUTUBRO DE 2011 +# Link : +# <a href="http://www.in.gov.br/visualiza/index.jsp?data=13/10/2011&jornal=1000&pagina=6&totalArquivos=6"> +# http://www.in.gov.br/visualiza/index.jsp?data=13/10/2011&jornal=1000&pagina=6&totalArquivos=6 +# </a> + + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S # Decree <a href="http://pcdsh01.on.br/HV20466.htm">20,466</a> (1931-10-01) # Decree <a href="http://pcdsh01.on.br/HV21896.htm">21,896</a> (1932-01-10) @@ -1077,10 +1090,8 @@ # of America/Salvador. Zone America/Bahia -2:34:04 - LMT 1914 -3:00 Brazil BR%sT 2003 Sep 24 - -3:00 - BRT -# as noted above, not yet in operation. -# -3:00 - BRT 2011 Oct 16 -# -3:00 Brazil BR%sT + -3:00 - BRT 2011 Oct 16 + -3:00 Brazil BR%sT # # Goias (GO), Distrito Federal (DF), Minas Gerais (MG), # Espirito Santo (ES), Rio de Janeiro (RJ), Sao Paulo (SP), Parana (PR), @@ -1230,6 +1241,28 @@ # August, not in October as they have since 1968. This is a pilot plan # which will be reevaluated in 2012. +# From Mauricio Parada (2012-02-22), translated by Glenn Eychaner (2012-02-23): +# As stated in the website of the Chilean Energy Ministry +# http://www.minenergia.cl/ministerio/noticias/generales/gobierno-anuncia-fechas-de-cambio-de.html +# The Chilean Government has decided to postpone the entrance into winter time +# (to leave DST) from March 11 2012 to April 28th 2012. The decision has not +# been yet formalized but it will within the next days. +# Quote from the website communication: +# +# 6. For the year 2012, the dates of entry into winter time will be as follows: +# a. Saturday April 28, 2012, clocks should go back 60 minutes; that is, at +# 23:59:59, instead of passing to 0:00, the time should be adjusted to be 23:00 +# of the same day. +# b. Saturday, September 1, 2012, clocks should go forward 60 minutes; that is, +# at 23:59:59, instead of passing to 0:00, the time should be adjusted to be +# 01:00 on September 2. +# +# Note that...this is yet another "temporary" change that will be reevaluated +# AGAIN in 2013. + +# NOTE: ChileAQ rules for Antarctic bases are stored separately in the +# 'antarctica' file. + # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Chile 1927 1932 - Sep 1 0:00 1:00 S Rule Chile 1928 1932 - Apr 1 0:00 0 - @@ -1260,8 +1293,6 @@ Rule Chile 1998 only - Sep 27 4:00u 1:00 S Rule Chile 1999 only - Apr 4 3:00u 0 - Rule Chile 1999 2010 - Oct Sun>=9 4:00u 1:00 S -Rule Chile 2011 only - Aug Sun>=16 4:00u 1:00 S -Rule Chile 2012 max - Oct Sun>=9 4:00u 1:00 S Rule Chile 2000 2007 - Mar Sun>=9 3:00u 0 - # N.B.: the end of March 29 in Chile is March 30 in Universal time, # which is used below in specifying the transition. @@ -1269,7 +1300,11 @@ Rule Chile 2009 only - Mar Sun>=9 3:00u 0 - Rule Chile 2010 only - Apr Sun>=1 3:00u 0 - Rule Chile 2011 only - May Sun>=2 3:00u 0 - -Rule Chile 2012 max - Mar Sun>=9 3:00u 0 - +Rule Chile 2011 only - Aug Sun>=16 4:00u 1:00 S +Rule Chile 2012 only - Apr Sun>=23 3:00u 0 - +Rule Chile 2012 only - Sep Sun>=2 4:00u 1:00 S +Rule Chile 2013 max - Mar Sun>=9 3:00u 0 - +Rule Chile 2013 max - Oct Sun>=9 4:00u 1:00 S # IATA SSIM anomalies: (1992-02) says 1992-03-14; # (1996-09) says 1998-03-08. Ignore these. # Zone NAME GMTOFF RULES FORMAT [UNTIL] @@ -1415,6 +1450,21 @@ # will not revert to local mean time, but clocks will remain on Summer # time (UTC/GMT - 3 hours) throughout the whole of 2011. Any long term # change to local time following the trial period will be notified. +# +# From Andrew Newman (2012-02-24) +# A letter from Justin McPhee, Chief Executive, +# Cable & Wireless Falkland Islands (dated 2012-02-22) +# states... +# The current Atlantic/Stanley entry under South America expects the +# clocks to go back to standard Falklands Time (FKT) on the 15th April. +# The database entry states that in 2011 Stanley was staying on fixed +# summer time on a trial basis only. FIG need to contact IANA and/or +# the maintainers of the database to inform them we're adopting +# the same policy this year and suggest recommendations for future years. +# +# For now we will assume permanent summer time for the Falklands +# until advised differently (to apply for 2012 and beyond, after the 2011 +# experiment was apparently successful.) # Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S Rule Falk 1937 1938 - Sep lastSun 0:00 1:00 S Rule Falk 1938 1942 - Mar Sun>=19 0:00 0 - @@ -1427,14 +1477,14 @@ Rule Falk 1985 2000 - Sep Sun>=9 0:00 1:00 S Rule Falk 1986 2000 - Apr Sun>=16 0:00 0 - Rule Falk 2001 2010 - Apr Sun>=15 2:00 0 - -Rule Falk 2012 max - Apr Sun>=15 2:00 0 - -Rule Falk 2001 max - Sep Sun>=1 2:00 1:00 S +Rule Falk 2001 2010 - Sep Sun>=1 2:00 1:00 S # Zone NAME GMTOFF RULES FORMAT [UNTIL] Zone Atlantic/Stanley -3:51:24 - LMT 1890 -3:51:24 - SMT 1912 Mar 12 # Stanley Mean Time -4:00 Falk FK%sT 1983 May # Falkland Is Time -3:00 Falk FK%sT 1985 Sep 15 - -4:00 Falk FK%sT + -4:00 Falk FK%sT 2010 Sep 5 02:00 + -3:00 - FKST # French Guiana # Zone NAME GMTOFF RULES FORMAT [UNTIL]
--- a/make/sun/javazic/tzdata/zone.tab Mon Apr 02 15:01:04 2012 -0700 +++ b/make/sun/javazic/tzdata/zone.tab Mon Apr 16 11:16:28 2012 -0700 @@ -22,7 +22,7 @@ # questions. # # <pre> -# @(#)zone.tab 8.49 +# @(#)zone.tab 8.55 # This file is in the public domain, so clarified as of # 2009-05-17 by Arthur David Olson. # @@ -154,6 +154,7 @@ CA +690650-1050310 America/Cambridge_Bay Mountain Time - west Nunavut CA +6227-11421 America/Yellowknife Mountain Time - central Northwest Territories CA +682059-1334300 America/Inuvik Mountain Time - west Northwest Territories +CA +4906-11631 America/Creston Mountain Standard Time - Creston, British Columbia CA +5946-12014 America/Dawson_Creek Mountain Standard Time - Dawson Creek & Fort Saint John, British Columbia CA +4916-12307 America/Vancouver Pacific Time - west British Columbia CA +6043-13503 America/Whitehorse Pacific Time - south Yukon @@ -356,7 +357,7 @@ RU +5443+02030 Europe/Kaliningrad Moscow-01 - Kaliningrad RU +5545+03735 Europe/Moscow Moscow+00 - west Russia RU +4844+04425 Europe/Volgograd Moscow+00 - Caspian Sea -RU +5312+05009 Europe/Samara Moscow - Samara, Udmurtia +RU +5312+05009 Europe/Samara Moscow+00 - Samara, Udmurtia RU +5651+06036 Asia/Yekaterinburg Moscow+02 - Urals RU +5500+07324 Asia/Omsk Moscow+03 - west Siberia RU +5502+08255 Asia/Novosibirsk Moscow+03 - Novosibirsk
--- a/src/linux/doc/man/ja/appletviewer.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/appletviewer.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH appletviewer 1 "07 May 2011" +.TH appletviewer 1 "21 Mar 2012" .LP .SH "名前" -appletviewer \- Java アプレットビューア +appletviewer \- Javaアプレット・ビューア .LP .LP -\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。 +\f3appletviewer\fPコマンドでは、Webブラウザの外でアプレットを実行できます。 .LP .SH "形式" .LP @@ -36,27 +36,30 @@ .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://download.oracle.com/javase/7/docs/technotes/tools/appletviewertags.htmlを参照してください。 .LP .LP -\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。 +\f3注意:\fP \f3appletviewer\fPは開発専用です。詳細は、サンプル/テスト・アプリケーションのコードについてを参照してください。 +.LP +.LP +\f3注意:\fP \f3appletviewer\fPは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 .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/src/linux/doc/man/ja/apt.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/apt.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,10 +19,10 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH apt 1 "07 May 2011" +.TH apt 1 "21 Mar 2012" .LP -.SH "NAME" +.SH "名前" .LP .LP \f2apt\fP \- 注釈処理ツール @@ -35,57 +35,57 @@ .SH "パラメータ" .LP .LP -オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。 +オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記のオプションを参照してください。 .LP .RS 3 .TP 3 sourcefiles -ゼロ、1 つ、または複数の処理対象のソースファイル +ゼロ、1つ、または複数の処理対象のソース・ファイル .TP 3 @files -ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル +ソース・ファイルまたは他のオプションを一覧表示する1つまたは複数のファイル .RE .LP .SH "説明" .LP .LP -\f3注\fP: \f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください。 +\f3注意\fP: \f2apt\fPツールと、パッケージ\f2com.sun.mirror\fPに含まれているそれに関連したAPIは、JDK 7以降非推奨になっており、JDKの次のメジャー・リリースで削除される予定です。\f2javac(1)\fPツールで利用可能なオプションと、パッケージ\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPに含まれているAPIを使用して、注釈を処理してください。 .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「apt 入門」\fP @ +\f4apt\fP\f3スタート・ガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。 .LP .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 -注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。 +注釈プロセッサ・ファクトリを検索する場所を指定します。このオプションを使用する場合、クラス・パスのファクトリは検索\f2されません\fP。 .TP 3 \-factory classname -使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。 +使用する注釈プロセッサ・ファクトリの名前です。デフォルトの検出プロセスを省略します。 .TP 3 \-version バージョン情報を出力します。 @@ -96,20 +96,20 @@ .LP .SS -javac と共用するオプション +javacと共用するオプション .LP .RS 3 .TP 3 \-d dir -プロセッサと javac 生成のクラスファイルを置く場所を指定します。 +プロセッサとjavac生成のクラス・ファイルを置く場所を指定します。 .TP 3 -\-cp path または \-classpath path -ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。 +\-cppathまたは\-classpathpath +ユーザー・クラス・ファイルと注釈プロセッサ・ファクトリを検索する場所を指定します。\f2\-factorypath\fPが指定されている場合、クラス・パスのファクトリは検索されません。 .RE .LP .LP -\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。 +\f2javac\fPオプションの詳細は、javac(1)のマニュアル・ページを参照してください。 .LP .SS 非標準オプション @@ -117,36 +117,36 @@ .RS 3 .TP 3 \-XListAnnotationTypes -注釈の型に検出されるリスト. +検出された注釈の型をリストします。 .TP 3 \-XListDeclarations -指定および宣言がインクルードされるリスト. +指定およびインクルードされる宣言をリストします。 .TP 3 \-XPrintAptRounds -初期および再帰的な \f2apt\fP ラウンドに関する情報を出力する. +初期および再帰的な\f2apt\fPラウンドに関する情報を出力します。 .TP 3 \-XPrintFactoryInfo -処理を要求するファクトリの注釈に関する情報を出力する. +ファクトリに処理をリクエストする注釈に関する情報を出力します。 .TP 3 \-XclassesAsDecls -クラスファイルとソースファイルの両方を、処理対象の宣言として処理します。 +クラス・ファイルとソース・ファイルの両方を、処理対象の宣言として処理します。 .RE .LP .LP -\f3注\fP: これらは非標準オプションなので、予告なく変更される可能性があります。 +\f3注意\fP: これらは非標準オプションなので、予告なく変更される可能性があります。 .LP -.SH "注" +.SH "注意" .LP .LP -\f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください。 +\f2apt\fPツールと、パッケージ\f2com.sun.mirror\fPに含まれているそれに関連したAPIは、JDK 7以降非推奨になっており、JDKの次のメジャー・リリースで削除される予定です。\f2javac(1)\fPツールで利用可能なオプションと、パッケージ\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPに含まれているAPIを使用して、注釈を処理してください。 .LP .SH "関連項目" .LP .RS 3 .TP 2 o -javac(1), java(1) +javac(1)、java(1) .RE .LP
--- a/src/linux/doc/man/ja/extcheck.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/extcheck.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH extcheck 1 "07 May 2011" +.TH extcheck 1 "21 Mar 2012" .LP .SH "名前" -extcheck \- jar の競合検出ユーティリティー +extcheck \- jarの競合検出ユーティリティ .LP .LP -\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。 +\f3extcheck\fPは、ターゲットのjarファイルと現在インストールされている拡張機能のjarファイル間のバージョンの競合を検出します。 .LP .SH "形式" .LP @@ -42,26 +42,26 @@ .SH "説明" .LP .LP -\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。 +\f3extcheck\fPユーティリティは、指定されたJarファイルのタイトルおよびバージョンがJava(tm) SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 .LP .LP -\f3extcheck\fP ユーティリティーは、targetfile.jar ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされている \f2すべての Jar ファイル内の\fP 対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。 +\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 です。 +競合が検出されない場合のリターン・コードは\f20\fPです。 .LP .LP -拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP 、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。 \f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。 +拡張機能ディレクトリ内のいずれかの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
--- a/src/linux/doc/man/ja/idlj.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/idlj.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH idlj 1 "07 May 2011" +.TH idlj 1 "21 Mar 2012" .LP .SH "名前" -idlj \- IDL\-to\-Java コンパイラ +idlj \- IDL\-to\-Javaコンパイラ .LP -\f3idlj\fP は、指定された IDL ファイルから Java バインディングを生成します。 +\f3idlj\fPは、指定されたIDLファイルからJavaバインディングを生成します。 .SH "形式" .LP .nf @@ -38,22 +38,22 @@ .LP .LP -\f2idl\-file\fP は、インタフェース定義言語 (IDL) による定義が入ったファイルの名前です。\f2options\fP の順番は任意ですが、\f2idl\-file\fP よりも前に指定しなければなりません。 +\f2idl\-file\fPは、インタフェース定義言語(IDL)による定義が入ったファイルの名前です。\f2options\fPの順番は任意ですが、\f2idl\-file\fPよりも前に指定する必要があります。 .LP .SH "説明" .LP .LP -IDL\-to\-Java コンパイラは、指定された IDL ファイルについて Java バインディングを生成します。バインディングの詳細は、 +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://download.oracle.com/javase/7/docs/technotes/guides/idl/mapping/jidlMapping.htmlを参照してください。IDL\-to\-Javaコンパイラの以前のリリースの中には、\f2idltojava\fPという名前だったものがあります。 .LP .SS -クライアントバインディングおよびサーバーバインディングの発行 +クライアント・バインディングおよびサーバー・バインディングの発行 .LP .LP -My.idl という名前の IDL ファイルに対して Java バインディングを生成するには、次のコマンドを実行します。 +My.idlという名前のIDLファイルに対してJavaバインディングを生成するには、次のコマンドを実行します。 .LP .nf \f3 @@ -87,7 +87,7 @@ .LP .LP -サーバー側のバインディングには、クライアント側のバインディングのほかに、スケルトンも含まれています。これらはすべて、 \f2POA\fP (つまり継承モデル) クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド (どれも等価) のうちの 1 つを使用します。 +サーバー側のバインディングには、クライアント側のバインディングの他に、スケルトンも含まれています。これらはすべて、\f2POA\fP(つまり継承モデル)クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド(どれも等価)のうちの1つを使用します。 .LP .nf \f3 @@ -100,26 +100,26 @@ .LP .LP -サーバー側で可能なモデルは 2 つあります。継承モデルと Tie 委譲モデルです。 +サーバー側で可能なモデルは2つあります。継承モデルとTie委譲モデルです。 .LP .LP -デフォルトのサーバー側のモデルは、「移殖可能サーバント継承モデル」です。\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2MyPOA.java\fP というファイルが生成されます。この実装は \f2My\fP に提供し、\f2MyPOA\fP を継承する必要があります。 +デフォルトのサーバー側のモデルは、\f2移殖可能サーバント継承モデル\fPです。\f2My.idl\fP内で\f2My\fPインタフェースが定義されている場合は、\f2MyPOA.java\fPというファイルが生成されます。この実装は\f2My\fPに提供し、\f2MyPOA\fPを継承する必要があります。 .LP .LP -\f2MyPOA.java\fP は +\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://download.oracle.com/javase/7/docs/api/org/omg/PortableServer/Servant.htmlを拡張するストリームベースのスケルトンで、スケルトンが実装するIDLインタフェースに関連付けられている\f2InvokeHandler\fPインタフェースと操作インタフェースを実装します。 .LP .LP .na -\f2Portable Object Adapter (POA)\fP @ +\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://download.oracle.com/javase/7/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 ベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次のコマンドを使用します。 +継承モデルのもう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 @@ -132,10 +132,10 @@ .LP .LP -\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2_MyImplBase.java\fP というファイルが生成されます。\f2My\fP に対してその実装を提供し、この実装は \f2_MyImplBase\fP から継承しなければなりません。 +\f2My.idl\fP内で\f2My\fPインタフェースが定義されている場合は、\f2_MyImplBase.java\fPというファイルが生成されます。\f2My\fPに対してその実装を提供し、この実装は\f2_MyImplBase\fPから継承する必要があります。 .LP .LP -もう 1 つのサーバー側モデルは、Tie モデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tie とスケルトンを同時に生成することはできないため、それらは別々に生成しなければなりません。次のコマンドによって、Tie モデル用のバインディングが生成されます。 +もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 .LP .nf \f3 @@ -148,7 +148,7 @@ .LP .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 @@ -188,10 +188,10 @@ .LP .LP -他の実装から継承しなければならない場合、標準の継承モデルではなく Tie モデルを使用することがあります。Java の場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは 1 つだけです。継承モデルを使用した場合は、そのスロットが占有されます。Tie モデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが 1 つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼び出しが 1 回発生します。 +他の実装から継承する必要がある場合、標準の継承モデルではなくTieモデルを使用することもできます。Javaの場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは1つのみです。継承モデルを使用した場合は、そのスロットが占有されます。Tieモデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが1つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼出しが1回発生します。 .LP .LP -IDL のバージョンから J2SE 1.4 より前のバージョンの Java 言語へのマッピングと互換性のある、サーバー側の Tie モデルのバインディングを生成するには、次のコマンドを使用します。 +J2SE 1.4より前のバージョンのJava言語にマッピングするIDLのバージョンと互換性のある、サーバー側のTieモデルのバインディングを生成する方法は、次のとおりです。 .LP .nf \f3 @@ -204,7 +204,7 @@ .LP .LP -\f2My\fP というインタフェースの場合、これにより \f2My_Tie.java\fP が生成されます。\f2My_Tie\fP のコンストラクタは、\f2impl\fP を取ります。\f2impl\fP に対して実装を提供しなければなりませんが、その実装は \f2HelloOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2My_Tie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。 +\f2My\fPというインタフェースの場合、これにより\f2My_Tie.java\fPが生成されます。\f2My_Tie\fPのコンストラクタは、\f2impl\fPを取ります。\f2impl\fPに対して実装を提供する必要がありますが、その実装は\f2HelloOperations\fPインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、この実装をORBと一緒に使用するには、\f2My_Tie\fP内で実装をラップする必要があります。たとえば、次のようにします。 .LP .nf \f3 @@ -239,7 +239,7 @@ 発行されたファイルの代替位置の指定 .LP .LP -発行されたファイルをカレントディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。 +発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -250,13 +250,13 @@ .LP .LP -\f2My\fP インタフェースの場合、バインディングは、\f2./My.java\fP ではなく、\f2/altdir/My.java\fP などに発行されます。 +\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 にある場合は、次のようなコマンドでコンパイラを呼び出します。 +\f2My.idl\fPにもう1つのIDLファイル\f2MyOther.idl\fPがインクルードされている場合、コンパイラは、ローカル・ディレクトリに\f2MyOther.idl\fPがあるものと想定します。たとえば、そのファイルが\f2/includes\fPにある場合は、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -267,7 +267,7 @@ .LP .LP -また、もし \f2My.idl\fP に、たとえば \f2/moreIncludes\fP にある \f2Another.idl\fP もインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 +たとえば、\f2/moreIncludes\fPにある\f2Another.idl\fPも\f2My.idl\fPにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -278,7 +278,7 @@ .LP .LP -このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルードファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATH にリストされているディレクトリ内に \f2idl.config\fP という名前のファイルを作成します。その \f2idl.config\fP の中に、次のような形式の行を入れます。 +このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATHにリストされているディレクトリ内に\f2idl.config\fPという名前のファイルを作成します。その\f2idl.config\fPの中に、次のような形式の行を入れます。 .LP .nf \f3 @@ -290,17 +290,17 @@ .LP .LP -コンパイラは、このファイルを検索し、インクルードリストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン (;) になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windows プラットフォームではセミコロンですが、Unix プラットフォームではコロンです。 \f2インクルード\fPの詳細については、 +コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windowsプラットフォームではセミコロンですが、Unixプラットフォームではコロンです。\f2includes\fPの詳細は、 .na -\f2CLASSPATH の設定\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#general を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#generalを参照してください。 .LP .SS -インクルードファイルに対するバインディングの発行 +インクルード・ファイルに対するバインディングの発行 .LP .LP -デフォルトでは、コマンド行に指定した IDL ファイルで定義されているインタフェースや構造体などについてのみ、Java バインディングが生成されます。インクルードされたファイルで定義されている型については、Java バインディングは生成されません。たとえば、次の 2 つの IDL ファイルについて考えてみましょう。 +デフォルトでは、コマンドラインに指定したIDLファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つのIDLファイルについて考えてみましょう。 .LP .LP @@ -343,7 +343,7 @@ .LP .LP -次のコマンドでは、\f2My\fP に対する Java バインディングだけが生成されます。 +次のコマンドでは、\f2My\fPに対するJavaバインディングのみが生成されます。 .LP .nf \f3 @@ -355,7 +355,7 @@ .LP .LP -\f2My.idl\fP で定義されている型と、\f2My.idl\fP にインクルードされたファイル (この例では \f2MyOther.idl\fP) で定義されている型すべてについて Java バインディングを生成するには、次のコマンドを使用します。 +\f2My.idl\fPで定義されている型と、\f2My.idl\fPにインクルードされたファイル(この例では\f2MyOther.idl\fP)で定義されている型すべてについて生成するには、次のコマンドを使用します。 .LP .nf \f3 @@ -366,7 +366,7 @@ .LP .LP -このデフォルトの規則に関して注意しなければならないことがあります。グローバルスコープに指定した \f2#include\fP 文は、前述のとおりに処理されます。これらの \f2#include\fP 文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した \f2#include\fP 文は、本当の意味での \f2#include\fP 文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対して Java バインディングが発行されます。次はその例です。 +このデフォルトのルールに関して注意が必要な点があります。グローバル・スコープに指定した\f2#include\fP文は、前述のとおりに処理されます。これらの\f2#include\fP文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した\f2#include\fP文は、本当の意味での\f2#include\fP文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 .LP .LP @@ -437,7 +437,7 @@ .LP .LP -次のような一連の Java ファイルが生成されます。 +次のような一連のJavaファイルが生成されます。 .LP .nf \f3 @@ -463,16 +463,16 @@ .LP .LP -インポート文と見なされる \f2#include\fP に定義されているため、\f2MyOther.java\fP は生成されません。ただし、本当の意味での \f2#include\fP で定義されているため、\f2E.java\fP は生成されます。さらに、\f2Embedded.idl\fP が \f2My\fP インタフェースのスコープ内にインクルードされていたため、\f2My\fP のスコープ内 (つまり、\f2MyPackage\fP 内) に生成されています。 +インポート文と見なされる\f2#include\fPに定義されていたため、\f2MyOther.java\fPは生成されませんでした。ただし、本当の意味での\f2#include\fPで定義されていたため、\f2E.java\fPは生成\f2されました\fP。さらに、\f2Embedded.idl\fPが\f2My\fPインタフェースのスコープ内にインクルードされていたため、\f2My\fPのスコープ内(つまり、\f2MyPackage\fP内)に生成されています。 .LP .LP -上記の例で \f2\-emitAll\fP フラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。 +上記の例で\f2\-emitAll\fPフラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。 .LP .SS パッケージの接頭辞の挿入 .LP .LP -ABC という名前の会社のために作業していて、次のような IDL ファイルを構築したとしましょう。 +ABCという名前の会社のために作業していて、次のようなIDLファイルを構築したとしましょう。 .LP .LP @@ -499,7 +499,7 @@ .LP .LP -このファイルに対して IDL\-to\-Java コンパイラを実行すると、\f2W1\fP および \f2W2\fP に対する Java バインディングが \f2Widgets\fP パッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<会社名>\fP という名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fP パッケージでは不十分です。慣例に従うには、パッケージを \f2com.abc.Widgets\fP にする必要があります。このパッケージ接頭辞を \f2Widgets\fP モジュールに付加するには、次のコマンドを実行します。 +このファイルに対してIDL\-to\-Javaコンパイラを実行すると、\f2W1\fPおよび\f2W2\fPに対するJavaバインディングが\f2Widgets\fPパッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<company name>\fPという名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fPパッケージでは不十分です。慣例に従うには、パッケージを\f2com.abc.Widgets\fPにする必要があります。このパッケージ接頭辞を\f2Widgets\fPモジュールに付加するには、次のコマンドを実行します。 .LP .nf \f3 @@ -510,10 +510,10 @@ .LP .LP -\f2Widgets.idl\fP をインクルードしている IDL ファイルがある場合は、そのコマンドにも \f2\-pkgPrefix\fP フラグが必要です。このフラグを指定しないと、その IDL ファイルは、\f2com.abc.Widgets\fP パッケージではなく、\f2Widgets\fP パッケージを検索することになります。 +\f2Widgets.idl\fPをインクルードしているIDLファイルがある場合は、そのコマンドにも\f2\-pkgPrefix\fPフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\f2com.abc.Widgets\fPパッケージではなく、\f2Widgets\fPパッケージを検索することになります。 .LP .LP -接頭辞が必要なパッケージがいくつもある場合は、前述の \f2idl.config\fP ファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。 +接頭辞が必要なパッケージがいくつもある場合は、前述の\f2idl.config\fPファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。 .LP .nf \f3 @@ -535,13 +535,13 @@ .LP .LP -このオプションを使用しても、リポジトリ ID は影響を受けません。 +このオプションを使用しても、リポジトリIDは影響を受けません。 .LP .SS コンパイル前のシンボルの定義 .LP .LP -コンパイル用のシンボルが IDL ファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグコードを組み入れるときに使用します。次のコマンドは、 +コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。次のコマンドは、 .LP .nf \f3 @@ -552,13 +552,13 @@ .LP .LP -\f2My.idl\fP 内に \f2#define MYDEF\fP という行を指定した場合と等価です。 +\f2My.idl\fP内に\f2#define MYDEF\fPという行を指定した場合と等価です。 .LP .SS 既存のバインディングの保持 .LP .LP -Java バインディングファイルがすでに存在する場合は、\f2\-keep\fP フラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合 (ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\-keep オプションは有用です。次のコマンドは、 +Javaバインディング・ファイルがすでに存在する場合は、\f2\-keep\fPフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\f2\-keep\fPオプションは有用です。次のコマンドは、 .LP .nf \f3 @@ -575,7 +575,7 @@ コンパイルの進捗状況の表示 .LP .LP -IDL\-to\-Java コンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モード (メッセージが多いモード) にするには、\f2\-v\fP オプションを使用します。 +IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モードをアクティブ化するには、\f2\-v\fPオプションを使用します。 .LP .nf \f3 @@ -592,7 +592,7 @@ バージョン情報の表示 .LP .LP -IDL\-to\-Java コンパイラのビルドバージョンを表示するには、コマンド行で \f2\-version\fP オプションを指定します。 +IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンドラインで\f2\-version\fPオプションを指定します。 .LP .nf \f3 @@ -604,14 +604,14 @@ .LP .LP -バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。 +バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンドラインに指定すると、それ以外のオプションを指定しても、すべて無視されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-d symbol -このオプションは、IDL ファイルに次のような行を追加した場合と等価です。 +このオプションは、IDLファイルに次のような行を追加した場合と等価です。 .nf \f3 .fl @@ -621,13 +621,13 @@ .fi .TP 3 \-emitAll -#include ファイル 内で定義されているものも含めて、 \f2すべての型を\fP 発行します。 +\f2#include\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 生成されるファイルがすでに存在している場合は、そのファイルが上書きされません。デフォルトでは、上書きされます。 @@ -636,15 +636,16 @@ 警告メッセージを表示しないようにします。 .TP 3 \-oldImplBase -v1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。デフォルトでは、POA 継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\f2ImplBase\fP 継承モデルのクラスであるサーバー側バインディングが生成されるので、古いバージョンの Java プログラミング言語との下位互換性が得られます。 +1.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 -識別子の中にモジュール名 type が検出されると、生成される Java パッケージ内のすべてのファイルについて、識別子の中のその名前が package で置き換えられます。最初に \f2pkgPrefix\fP を変更します。\f2type\fP は、トップレベルのモジュール、またはすべてのモジュールの外部で定義された IDL 型の単純名です。そして、完全なパッケージ名に正確に一致しなければなりません。 -.LP -1 つの識別子の中で複数の変換がマッチする場合は、もっとも長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、 +識別子の中にモジュール名\f2type\fPが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前が\f2package\fPで置き換えられます。最初に\f2pkgPrefix\fPの変更が行われます。\f2type\fPは、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 +.br +.br +1つの識別子の中で複数の変換がマッチする場合は、最も長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、 .nf \f3 .fl @@ -652,22 +653,20 @@ .fl \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 @@ -675,37 +674,36 @@ \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 -\-nowarn, \-verbose +\-nowarn、\-verbose 冗長モードになります。 .TP 3 \-version @@ -713,16 +711,18 @@ .RE .LP -各オプションの詳細については、「説明」のセクションを参照してください。 +.LP +各オプションの詳細は、説明のセクションを参照してください。 +.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 @@ -731,7 +731,7 @@ .RS 3 .TP 2 o -グローバル識別子についてインポートが生成されません。予期されないローカル impl を呼び出すと、例外を受け取ります。 しかし、その原因は、\f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP にあるようです。 +グローバル識別子についてインポートが生成されません。予期されないローカルimplを呼び出すと、例外を受け取ります。しかし、その原因は、\f2ServerDelegate\fP DSIコード内の\f2NullPointerException\fPにあるようです。 .RE .LP
--- a/src/linux/doc/man/ja/jar.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jar.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jar 1 "07 May 2011" +.TH jar 1 "21 Mar 2012" .LP .SH "名前" -jar \- Java ARchive ツール +jar \- Java ARchiveツール .LP -\f3jar\fP は複数のファイルを 1 つの JAR アーカイブファイルに結合します。 +\f3jar\fPは複数のファイルを1つのJARアーカイブ・ファイルに結合します。 .RS 3 .TP 2 o @@ -38,7 +38,7 @@ オプション .TP 2 o -コマンド行引数ファイル +コマンドライン引数ファイル .TP 2 o 例 @@ -52,19 +52,19 @@ .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 @@ -75,37 +75,37 @@ .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 の場合) される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション \f20\fP (ゼロ) を使用しないかぎり圧縮されます。 +\f2jarfile\fPに結合されるか(cおよびuの場合)、\f2jarfile\fPから抽出(xの場合)または一覧表示(tの場合)される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション\f20\fP(ゼロ)を使用しないかぎり圧縮されます。 .TP 3 manifest -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 の出現順序と一致する必要があります。 +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ファイル内にバンドルされたスタンドアロン・アプリケーションのアプリケーション・エントリ・ポイントとして設定するクラスの名前。\f2e\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\f2\-\ dir\fP \f2inputfiles\fP のセットは複数使用できます。 +これに続く\f2inputfiles\fP引数を処理する間、ディレクトリを\f2dir\fPへ一時的に変更します。\f2\-C\ \fP\f2dir\fP \f2inputfiles\fPのセットは複数使用できます。 .TP 3 \-Joption -Java 実行環境へ渡されるオプション。\f2\-J\fP と \f2option\fP の間には空白を入れないでください。 +Java実行環境へ渡されるオプション。(\f2\-J\fPと\f2option\fPの間には空白を入れないでください。) .RE .LP .SH "説明" .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 ファイルへ結合する一般的な使用法は次のとおりです。 +複数のファイルをJARファイルへ結合する一般的な使用方法は次のとおりです。 .LP .nf \f3 @@ -116,13 +116,13 @@ .fi .LP -この例では、現在のディレクトリにあるクラス (.class) ファイルがすべて、\f2myFile.jar\fP という名前のファイルに格納されます。jar ツールは自動的に、 \f2META\-INF/MANIFEST.MF\fP という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを \f2name\ :\ value\fP ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、「 +この例では、現在のディレクトリにあるすべてのクラス・ファイルが\f2myFile.jar\fPという名前のファイルに格納されます。jarツールは自動的に、\f2META\-INF/MANIFEST.MF\fPという名前のマニフェスト・ファイル・エントリを生成します。これは常に、JARファイルの最初のエントリになります。マニフェスト・ファイルは、アーカイブに関するメタ情報を宣言し、そのデータを\f2name\ :\ value\fPのペアとして格納します。jarツールがマニフェスト・ファイル内にメタ情報を格納する方法の詳細は、 .na -\f2JAR file specification\fP @ +\f2JARファイルの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest」を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR%20Manifestを参照してください。 .LP -既存のマニフェストファイル内に格納された \f2name\ :\ value\fP ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。 +既存のマニフェスト・ファイル内に格納された\f2name\ :\ value\fPのペアをJARファイルに含める必要がある場合には、次のように\f2\-m\fPオプションを使用してそのファイルを指定します。 .LP .nf \f3 @@ -133,14 +133,14 @@ .fi .LP -既存のマニフェストファイルは改行文字で終わっている必要があります。マニフェストファイルが改行文字で終わっていないと、\f3jar\fP はその最終行を解析しません。 +既存のマニフェスト・ファイルは改行文字で終わっている必要があります。マニフェスト・ファイルが改行文字で終わっていないと、\f3jar\fPはその最終行を解析しません。 .br .LP .br .LP -\f3注:\ \fPコマンド行に \f2cmf\fP ではなく \f2cfm\fP が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず JAR アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。 次に例を示します。 +\f3注意:\ \fPコマンドラインに\f2cmf\fPではなく\f2cfm\fPが指定された(mと\-fオプションの順番を逆にした)jarコマンドの場合、\f3jar\fPコマンドラインにまずJARアーカイブの名前を指定し、続いてマニフェスト・ファイルの名前を指定する必要があります。次に例を示します。 .nf \f3 .fl @@ -150,9 +150,9 @@ .fi .LP -マニフェストは、RFC822 ASCII 形式で規定されたテキスト形式であるため、マニフェストファイルの内容を簡単に表示および編集できます。 +マニフェストは、RFC822 ASCII形式で規定されたテキスト形式であるため、マニフェスト・ファイルの内容を簡単に表示および処理できます。 .LP -JAR ファイルからファイルを抽出する場合は、 \f2x\fP を使用します。 +JARファイルからファイルを抽出する場合は、\f2x\fPを使用します。 .LP .nf \f3 @@ -164,7 +164,7 @@ .LP .LP -jar ファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。 +jarファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。 .LP .nf \f3 @@ -176,11 +176,11 @@ .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#JAR_Index がサポートされています。 JarIndex を使用すると、アプリケーションのクラスローダーで JAR ファイルからクラスがロードされるときの効率が向上します。アプリケーションまたはアプレットが複数の JAR ファイルにバンドルされている場合は、クラスがロードされるときに、必要な JAR ファイル以外のダウンロードおよびオープンは行われません。このパフォーマンスの最適化は、新しい \f2\-i\fP オプションを指定して \f2jar\fP を実行すると有効になります。このオプションを使うと、指定した JAR メインファイルと、そのメインファイルが依存しているすべての JAR ファイルについて、パッケージ位置情報が生成されます。メインファイルが依存している JAR ファイルは、JAR メインファイルのマニフェストの \f2Class\-Path\fP 属性に指定しておく必要があります。 +http://download.oracle.com/javase/7/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 @@ -192,39 +192,39 @@ .LP .LP -この例では、 \f2INDEX.LIST\fP ファイルが \f2main.jar\fP の \f2META\-INF\fP ディレクトリ内に挿入されます。 +この例では、\f2INDEX.LIST\fPファイルが\f2main.jar\fPの\f2META\-INF\fPディレクトリ内に挿入されます。 .br .br -このファイルに格納されている情報を使用して、アプリケーションのクラスローダーは、効率的にクラスをロードします。インデックスファイルに位置情報を格納する方法の詳細は、「JarIndex 仕様」を参照してください。 +アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。インデックス・ファイルに位置情報を格納する方法の詳細は、\f2JarIndex\fP仕様を参照してください。 .br .br -ディレクトリをコピーするには、まず \f2dir1\fP 内のファイルを圧縮して \f2stdout\fP に出力し、続いて \f2stdin\fP から抽出して \f2dir2\fP に出力します (\f2\-f\fP オプションはどちらの \f2jar\fP コマンドでも省略)。 +ディレクトリをコピーするには、まず\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 .LP .LP -\f2jar\fP を使用して JAR ファイルや JAR マニフェストファイルを操作するサンプルコマンドを確認したい場合は、後述の「例」を参照してください。また、「 +\f2jar\fPを使用してJARファイルやJARマニフェスト・ファイルを操作するサンプル・コマンドを確認するには、次の例を参照してください。また、 .na -\f2Java Tutorial\fP @ +\f2Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar」の JAR コースも参照してください。 +http://docs.oracle.com/javase/tutorial/deployment/jarのJARトライアルも参照してください。 .LP .SH "オプション" .LP .RS 3 .TP 3 c -f が指定された場合は \f2jarfile\fP という名前の \f2新しい\fP アーカイブファイルを \f2作成し、\fP f と \f2jarfile\fP が省略された場合は標準出力に情報を出力します。\f2inputfiles\fP で指定されたファイルとディレクトリを、このアーカイブに追加します。 +\f2jarfile\fPという名前の新しいアーカイブ・ファイルを作成する(\f2f\fPが指定された場合)か、標準出力に出力します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPで指定されたファイルとディレクトリを、このアーカイブに追加します。 .TP 3 u -f が指定されている場合に、既存ファイル \f2jarfile\fP を \f2更新する目的で、\fP \f2inputfiles\fP に指定されたファイルやディレクトリを追加します。次に例を示します。 +\f2inputfiles\fPに指定されたファイルやディレクトリを追加して、既存ファイル\f2jarfile\fPを更新します(\f2f\fPが指定されている場合)。次に例を示します。 .nf \f3 .fl @@ -232,7 +232,7 @@ .fl \fP .fi -上のコマンドは、ファイル \f2foo.class\fP を既存の JAR ファイル \f2foo.jar\fP に追加します。次の例に示すように、\f2\-u\fP オプションは、マニフェストエントリも更新できます。 +上のコマンドは、ファイル\f2foo.class\fPを既存のJARファイル\f2foo.jar\fPに追加します。次の例に示すように、\f2\-u\fPオプションは、マニフェスト・エントリも更新できます。 .nf \f3 .fl @@ -240,16 +240,16 @@ .fl \fP .fi -\f2foo.jar\fP マニフェストをマニフェスト内の \f2name:value\fP ペアで更新します。 +上のコマンドは、\f2foo.jar\fPマニフェストを\f2manifest\fP内の\f2name : value\fPのペアで更新します。 .TP 3 x -f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、ファイルやディレクトリを抽出します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが抽出されます。指定されていなければ、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。 +\f2jarfile\fPからファイルとディレクトリを抽出します(\f2f\fPが指定された場合)、または標準入力からファイルやディレクトリを抽出します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPが指定されている場合は、指定されたファイルとディレクトリのみが抽出されます。それ以外の場合は、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。 .TP 3 t -f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、目次を表示します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが一覧表示されます。指定されていなければ、すべてのファイルとディレクトリが一覧表示されます。 +\f2jarfile\fPから目次を表示します(\f2f\fPが指定された場合)、または標準入力から目次を表示します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPが指定されている場合は、指定されたファイルとディレクトリのみが一覧表示されます。それ以外の場合は、すべてのファイルとディレクトリが一覧表示されます。 .TP 3 i -指定された \f2jarfile\fP と、それに依存する JAR ファイルについて、インデックス情報を生成します。たとえば、 +指定された\f2jarfile\fPと、それに依存するJARファイルについて、インデックス情報を生成します。次に例を示します。 .nf \f3 .fl @@ -258,24 +258,25 @@ \fP .fi .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 -次の各処理の対象となるファイル \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 ファイルが送信されます。 +作成(\f2c\fP)、更新(\f2u\fP)、抽出(\f2x\fP)、インデックス追加(\f2i\fP)または表示(\f2t\fP)の各処理の対象となるファイル\f2jarfile\fPを指定します。\f2f\fPオプションとファイル名\f2jarfile\fPとがペアになります。つまり、片方を記述すれば、もう一方も記述する必要があります。\f2f\fPと\f2jarfile\fPを省略すると、\f2stdin\fPからJARファイル名が取得される(xおよびtの場合)か、\f2stdout\fPにJARファイルが出力されます(cおよびuの場合)。 .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 はその値を更新します。 -.LP -コマンド行で、\f3m\fP と \f3f\fP の文字は、\f2manifest\fP と \f2jarfile\fP の入力順序と同じ順序で記述する必要があります。たとえば、次のようにして使います。 +\f2META\-INF/MANIFEST.MF\fPのファイルで指定したマニフェスト・ファイル\f2manifest\fPの\f2name : value\fPの属性ペアを組み込みます。\f2jar\fPは、すでに同じ名前で存在しない場合は、その\f2name\ :\ value\fPペアを追加します。同じ名前で存在する場合、\f2jar\fPはその値を更新します。 +.br +.br +コマンドラインで、\f3m\fPと\f3f\fPの文字は、\f2manifest\fPと\f2jarfile\fPの入力順序と同じ順序で記述する必要があります。たとえば、次のように使用します。 .nf \f3 .fl @@ -283,17 +284,18 @@ .fl \fP .fi -デフォルトのマニフェストには含まれないマニフェストに、特別な目的の \f2name\ :\ value\fP の属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージシーリング、または JAR にバンドルされたアプリケーションを実行するための属性を追加できます。「Java Tutorial」の「 +デフォルトのマニフェストには含まれないマニフェストに、特別な目的の\f2name\ :\ value\fPの属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージ・シーリング、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。Javaチュートリアルの .na -\f2JAR Files\fP @ +\f2JARファイル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar/」コースを参照し、 \f4\-m\fP オプションの使用例を確認してください。 +http://docs.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 に設定されます。 +.br +たとえば、次のコマンドでは\f2Main.jar\fPが作成されますが、その際、マニフェスト内の\f2Main\-Class\fP属性値は\f2Main\fPに設定されます。 .nf \f3 .fl @@ -301,8 +303,7 @@ .fl \fP .fi -.LP -次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。 +次のコマンドを実行するとjavaランタイムから直接このアプリケーションを起動できます。 .nf \f3 .fl @@ -310,7 +311,7 @@ .fl \fP .fi -あるパッケージ内にエントリポイントのクラス名が含まれている場合、ドット (「.」) 、スラッシュ (「/」) のいずれかの文字をその区切り文字として使用できます。たとえば、 \f2Main.class\fP が \f2foo\fP という名前のパッケージに含まれている場合、エントリポイントは次のようにして指定できます。 +あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(「.」)、スラッシュ(「/」)のいずれかの文字をその区切り文字として使用できます。たとえば、\f2Main.class\fPが\f2foo\fPという名前のパッケージに含まれている場合、エントリ・ポイントは次のようにして指定できます。 .nf \f3 .fl @@ -326,14 +327,13 @@ .fl \fP .fi -\f3注:\ \fP \f2\-m\fP オプションと \f2\-e\fP オプションの両方を同時に指定した場合、指定したマニフェストにも \f2Main\-Class\fP 属性が含まれていれば、 \f2Main.class\fP の指定があいまいになってエラーや発生し、JAR の作成処理や更新処理が異常終了します。 -.LP +\f3注意:\fP \f2\-m\fPオプションと\f2\-e\fPオプションの両方を同時に指定した場合、指定したマニフェストにも\f2Main\-Class\fP属性が含まれていれば、\f2Main.class\fPの指定があいまいになってエラーや発生し、JARの作成処理や更新処理が異常終了します。 .TP 3 -\-C \ dir -\f2jar\fP コマンドの実行中に後続の \f2inputfiles\fP 引数を処理するときに、一時的にディレクトリを変更します (cd \f2dir\fP)。この処理は、UNIX の \f2tar\fP ユーティリティーの \f2\-C\fP オプションの機能に類似しています。 +\-C\ dir +\f2jar\fPコマンドの実行中に後続の\f2inputfiles\fP引数を処理するときに、一時的にディレクトリを変更します(\f2cd\fP\ \f2dir\fP)。この処理は、UNIXの\f2tar\fPユーティリティの\f2\-C\fPオプションの機能に類似しています。 .br .br -たとえば、次のコマンドは、\f2classes\fP ディレクトリに移動し、そのディレクトリから \f2bar.class\fP を \f2foo.jar\fP に追加します。 +たとえば、次のコマンドは、\f2classes\fPディレクトリに移動し、そのディレクトリから\f2bar.class\fPを\f2foo.jar\fPに追加します。 .nf \f3 .fl @@ -341,15 +341,15 @@ .fl \fP .fi -次のコマンドでは、\f2classes\fP ディレクトリに移動し、\f2classes\fP ディレクトリ内のすべてのファイルを \f2foo.jar\fP に追加します (jar ファイルには classes ディレクトリを作成しません)。次に元のディレクトリに戻ってから、\f2bin\fP ディレクトリに移動し、\f2xyz.class\fP を \f2foo.jar\fP に追加します。 +次のコマンドでは、\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 -\f2classes\fP にファイル \f2bar1\fP と \f2bar2\fP が格納されている場合に、 \f2jar tf foo.jar\fP 使用したときの JAR ファイルの中身を、次に示します。 +\f2classes\fPにファイル\f2bar1\fPと\f2bar2\fPが格納されている場合に、\f2jar tf foo.jar\fP使用したときのJARファイルの中身を、次に示します。 .nf \f3 .fl @@ -368,21 +368,21 @@ .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 "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP -jar のコマンド行を短くしたり簡潔にしたりするために、jar コマンドに対する引数 (\-J オプションを除く) を含む 1 つ以上の \f2ファイルを\fP 指定することが \f2できます\fP 。これにより、任意の長さの jar コマンドを作成でき、オペレーティングシステムによるコマンド行の制限から解放されます。 +jarのコマンドラインを短くしたり簡潔にしたりするために、\f2jar\fPコマンドに対する引数(\f2\-J\fPオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、任意の長さの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 -次の例で、 \f2classes.list\fP には、 \f2find\fP コマンドによって出力されたファイルの名前が格納されます。 +次の例で、\f2classes.list\fPには、\f2find\fPコマンドによって出力されたファイルの名前が格納されます。 .LP .nf \f3 @@ -393,7 +393,7 @@ .LP .LP -次に、引数ファイル構文を使用して \f2classes.list\fP を jar に渡すことで、 \f2そのリスト\fP に対して \f2jar\fP コマンドを実行できます。 +次に、引数ファイル構文を使用して\f2Classes.list\fPを\f2jar\fPに渡すことで、そのリストに対して\f2jar\fPコマンドを実行できます。 .LP .nf \f3 @@ -419,7 +419,7 @@ .LP .SH "例" .LP -特定のディレクトリ内のすべてのファイルをアーカイブに追加する (そのアーカイブがすでに存在する場合は、その内容を上書きする) には、次のようにします。\f2\-v\fP オプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。 +特定のディレクトリ内のすべてのファイルをアーカイブに追加する(そのアーカイブがすでに存在する場合は、その内容を上書きする)には、次のようにします。\f2\-v\fPオプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。 .nf \f3 .fl @@ -457,7 +457,7 @@ .fi .LP -すでに画像、オーディオファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一の JAR ファイルに結合できます。 +すでに画像、オーディオ・ファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一のJARファイルに結合できます。 .nf \f3 .fl @@ -503,7 +503,7 @@ .fi .LP -JAR ファイルのエントリ名を表示するには、「\f2t\fP」オプションを使用します。 +JARファイルのエントリ名を表示するには、\f2t\fPオプションを使用します。 .nf \f3 .fl @@ -534,21 +534,21 @@ .LP .LP -クラスロードを高速にするためにインデックスファイルを JAR ファイルに追加するには、「\f2i\fP」オプションを使用します。 +クラス・ロードを高速にするためにインデックス・ファイルをJARファイルに追加するには、\f2i\fPオプションを使用します。 .br .br 例: .br .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 @@ -558,7 +558,7 @@ .fi .LP -\f2\-i\fP オプションを使用すれば、アプリケーションのクラスの 読み込みを高速化できます。 +\f2\-i\fPオプションを使用すれば、アプリケーションのクラスの読込みを高速化できます。 .nf \f3 .fl @@ -568,32 +568,32 @@ .fi .LP -\f2INDEX.LIST\fP ファイルが \f2META\-INF\fP ディレクトリに挿入されます。この結果、アプリケーションのクラスローダーによってクラスまたはリソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。 +\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 +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jarGuide.html .LP .LP .na -\f2JAR ファイルの仕様\fP @ +\f2JARファイルの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html .LP .LP .na -\f2JarIndex の仕様\fP @ +\f2JarIndexの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR_Index .LP .LP .na -\f2JAR チュートリアル\fP @ +\f2JARチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar/index.html +http://docs.oracle.com/javase/tutorial/deployment/jar/index.html .LP .LP pack200(1)
--- a/src/linux/doc/man/ja/jarsigner.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jarsigner.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jarsigner 1 "07 May 2011" +.TH jarsigner 1 "21 Mar 2012" .LP .SH "名前" -jarsigner \- JAR 署名および検証ツール +jarsigner \- JAR署名および検証ツール .LP .LP -Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。 +Java ARchive(JAR)ファイルの署名を生成し、署名付きJARファイルの署名を検証します。 .LP .SH "形式" .LP @@ -41,131 +41,131 @@ .LP .LP -jarsigner の \-verify コマンドでは、JAR ファイル名のあとに 0 個以上のキーストア別名を指定できます。キーストア別名が指定された場合、jarsigner は、JAR ファイル内の各署名付きエンティティーの検証に使用される証明書がキーストア別名のいずれかに一致することをチェックします。別名は、\-keystore で指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +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 ファイルが含まれています。 +JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。開発者は、jar(1)という名前のツールを使用してJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\f3jar\fPによって作成されたJARファイル、または\f3jarsigner\fPによって処理されたJARファイルには、META\-INF/MANIFEST.MFファイルが含まれています。) .LP .LP -「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティー (人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。 +\f2デジタル署名\fPは、なんらかのデータ(「署名」の対象となるデータ)と、エンティティ(人、会社など)の秘密鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。 .LP .RS 3 .TP 2 o -署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、デジタル署名が本物かどうかを検証できる +署名の生成に使用された秘密鍵と対になる公開鍵を使用して計算を行うことで、デジタル署名が本物かどうかを検証できます。 .TP 2 o -非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である +秘密鍵が他人に知られない限り、デジタル署名の偽造は不可能です。 .TP 2 o -デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの署名として機能することはない +デジタル署名は、その署名が付いたデータのみを対象とするものであり、他のデータの署名として機能することはありません。 .TP 2 o -署名付きのデータは変更できない。 データが変更された場合は、その署名によってデータが本物ではないことが検証される +署名付きのデータは変更できません。データが変更された場合は、その署名によってデータが本物ではないことが検証されます。 .RE .LP .LP -ファイルに対してエンティティーの署名を生成するには、まず、エンティティーは、そのエンティティーに関連する公開鍵と非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つまたは複数の証明書も必要です。「証明書」とは、あるエンティティーが発行したデジタル署名付きの文書で、別なエンティティーの公開鍵が特定の値であることを証明しています。 +ファイルに対してエンティティの署名を生成するには、まず、エンティティは、そのエンティティに関連する公開鍵と秘密鍵のペアを持つ必要があります。また、公開鍵を認証する1つまたは複数の証明書も必要です。\f2証明書\fPとは、あるエンティティが発行したデジタル署名付きの文書で、別なエンティティの公開鍵が特定の値であることを証明しています。 .LP .LP -\f3jarsigner\fP は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1) ユーティリティーを使います。 +\f3jarsigner\fPは、\f2キーストア\fPに含まれる鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証するためのX.509証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1)ユーティリティを使用します。 .LP .LP -\f3jarsigner\fP は、エンティティーの非公開鍵を使って署名を生成します。署名付き JAR ファイルには特に、ファイルの署名に使用された非公開鍵に対応する公開鍵に対する、キーストア内の証明書のコピーが含まれています。\f3jarsigner\fP は、署名付き JAR ファイル内 (署名ブロックファイル内) にある証明書を使用してそのファイルのデジタル署名を検証できます。 +\f3jarsigner\fPは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、ファイルの署名に使用された秘密鍵に対応する公開鍵に対する、キーストア内の証明書のコピーなどが含まれています。\f3jarsigner\fPは、署名付きJARファイル内(署名ブロック・ファイル内)にある証明書を使用してそのファイルのデジタル署名を検証できます。 .LP .LP -\f3jarsigner\fP はタイムスタンプを含む署名を生成するので、システムやデプロイヤ (Java Plug\-in を含む) はJAR ファイルが署名証明書の有効期間中に署名されたかどうかをチェックできます。さらに、API を使用すると、アプリケーションからタイムスタンプ情報を取得できます。 +\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 ファイルに署名を付けるときに自動的に作成されます。 +現時点では、\f3jarsigner\fPで署名できるのは、SDKのjar(1)ツールで作成されたJARファイル、またはZIPファイルのみです。(JARファイルはZIPファイルと同じですが、JARファイルにはMETA\-INF/MANIFEST.MFファイルが含まれている点が異なります。このファイルは、\f3jarsigner\fPがZIPファイルに署名を付けるときに自動的に作成されます。) .LP .LP -デフォルトでは、\f3jarsigner\fP は JAR (または ZIP) ファイルに「署名」を付けます。署名付き JAR ファイルを「検証」する場合は、 \f2\-verify\fP オプションを指定します。 +デフォルトでは、\f3jarsigner\fPはJAR(またはZIP)ファイルに\f2署名します\fP。署名付きJARファイルを\f2検証\fPする場合は、\f2\-verify\fPオプションを指定します。 .LP .SS キーストアの別名 .LP .LP -キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。 +キーストアのすべてのエントリは、一意の\f2別名\fPを介してアクセスされます。 .LP .LP -\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、working ディレクトリの mystore という名前のキーストアに含まれる別名 duke に関連付けられた非公開鍵を使って、MyJARFile.jar という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jar は署名付きの JAR ファイルによって上書きされます。 +\f3jarsigner\fPを使用してJARファイルに署名を付けるときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次の例は、workingディレクトリのmystoreという名前のキーストアに含まれる別名dukeに関連付けられた秘密鍵を使用して、MyJARFile.jarという名前のJARファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jarは署名付きのJARファイルによって上書きされます。 .LP .nf \f3 .fl - jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3 + jarsigner \-keystore /working/mystore \-storepass \fP\f4<keystore password>\fP\f3 .fl - \-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 MyJARFile.jar duke + \-keypass \fP\f4<private key password>\fP\f3 MyJARFile.jar duke .fl \fP .fi .LP .LP -キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワードを指定する必要があります。コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。 +キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンドラインでストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンドラインで秘密鍵のパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと違っている場合には、秘密鍵のパスワードの入力を求められます。 .LP .SS キーストアの場所 .LP .LP -\f3jarsigner\fP には、 \f2使用するキーストアの URL を指定する \-keystore\fP があります。キーストア \f2は\fP デフォルトで、 \f2user.home\fP システムプロパティーで決まるユーザーのホームディレクトリの .keystore という名前のファイル内に格納されます。Solaris システムの場合、 \f2user.home\fP のデフォルトはユーザーの home ディレクトリになります。 +\f3jarsigner\fPには、使用するキーストアのURLを指定する\f2\-keystore\fPオプションがあります。キーストアはデフォルトで、\f2user.home\fPシステム・プロパティで決まるユーザーのホーム・ディレクトリの\f2.keystore\fPという名前のファイル内に格納されます。Solarisシステムの場合、\f2user.home\fPのデフォルトはユーザーのhomeディレクトリになります。 .LP .LP -\-keystore オプション \f2に指定した\fP 入力ストリームが \f2KeyStore.load\fP メソッドに渡される点に注意してください。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではない場合、たとえばそれがハードウェアトークンデバイス上に存在している場合などに指定すべきです。 +\f2\-keystore\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 キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。 +\f2java.security\fPパッケージで提供されている\f2KeyStore\fPクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の\f2タイプ\fPのキーストアを対象とする複数の異なる実装が存在可能です。 .LP .LP -現在、キーストアの実装を使用するものとして、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールがあります。KeyStore \f2は\fP public として使用可能なので、Java 2 SDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。 +現在、キーストアの実装を使用するものとして、\f3keytool\fPと\f3jarsigner\fPの2つのコマンドライン・ツールと、\f3Policy Tool\fPという名前の1つのGUIベースのツールがあります。\f2KeyStore\fPは公開されているので、Java 2 SDKユーザーはKeyStoreを使用する他のセキュリティ・アプリケーションも作成できます。 .LP .LP -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。 +キーストアには、Sun Microsystemsが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .LP .LP -キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP によって提供されるアプリケーションインタフェースが「サービスプロバイダインタフェース」 (SPI) に基づいて実装されます。つまり、対応する抽象クラス \f2KeystoreSpi\fP が同じ \f2java.security\fP パッケージ内に存在しており、このクラスによって、「プロバイダ」が実装する必要のあるサービスプロバイダインタフェースメソッドが定義されています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、 +キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fPによって提供されるアプリケーション・インタフェースが「サービス・プロバイダ・インタフェース」(SPI)に基づいて実装されます。つまり、対応する\f2KeystoreSpi\fP抽象クラス(これも\f2java.security\fPパッケージに含まれています)があり、このクラスが、「プロバイダ」が実装する必要のあるService Provider Interfaceのメソッドを定義しています。(ここで、「プロバイダ」とは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。)したがって、キーストアの実装を提供するには、 .na -\f2「Java 暗号化アーキテクチャー用プロバイダの実装方法」\fP @ +\f2Java暗号化アーキテクチャ用プロバイダの実装方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpiサブクラスの実装を提供する必要があります。 .LP .LP -アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの \f2実装を\fP 選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\f2KeyStore\fPクラスが提供するgetInstanceファクトリ・メソッドを使用することで、様々なプロバイダから異なる\f2タイプ\fPのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .LP .LP -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。 +\f3keytool\fPは、任意のファイルベースのキーストア実装で動作します。(これは、コマンドラインから渡されたキーストアの場所をファイル名として扱い、これをFileInputStreamに変換して、FileInputStreamからキーストアの情報をロードします。)一方、\f3jarsigner\fPツールと\f3policytool\fPツールは、URLで指定可能な任意の場所からキーストアを読み込むことができます。 .LP .LP -\f3jarsigner\fP と \f3keytool\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアのタイプを指定できます。 +\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 のトップレベルディレクトリ) です。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合は、単純にセキュリティ・プロパティ・ファイルで指定された\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 の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。 +各ツールは、\f2keystore.type\fPの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .LP .LP -\f2KeyStore\fP クラスに定義されている static メソッド \f2getDefaultType\fP を使用すると、アプリケーションやアプレットから \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ \f2(keystore.type プロパティーで指定されたタイプ)\fP のインスタンスを生成します。 +\f2KeyStore\fPクラスに定義されているstaticメソッド\f2getDefaultType\fPを使用すると、アプリケーションやアプレットから\f2keystore.type\fPプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\f2keystore.type\fPプロパティで指定されたタイプ)のインスタンスを生成します。 .LP .nf \f3 @@ -177,7 +177,7 @@ .LP .LP -デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプはjks(Sunが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .LP .nf \f3 @@ -189,10 +189,10 @@ .LP .LP -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。 +注意: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKSとjksは同じものとして扱われます。 .LP .LP -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。 +各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12と呼ばれるタイプのキーストアの実装を提供しているプロバイダ・パッケージを使用するには、上の行を次のように変更します。 .LP .nf \f3 @@ -204,55 +204,55 @@ .LP .LP -PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」にある +PKCS#11プロバイダ・パッケージを使用する場合の詳細は、Java PKCS#11リファレンス・ガイドにある .na -\f2「KeyTool and JarSigner」\fP @ +\f2KeyToolとJarSigner\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner節を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/p11guide.html#KeyToolJarSignerの項を参照してください。 .LP .SS サポートされるアルゴリズム .LP .LP -\f3jarsigner\fP はデフォルトで、次のいずれかを使用して JAR ファイルに署名します。 +\f3jarsigner\fPはデフォルトで、次のいずれかを使用してJARファイルに署名します。 .LP .RS 3 .TP 2 o -SHA1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム) +SHA1ダイジェスト・アルゴリズムを使用したDSA(デジタル署名アルゴリズム) .TP 2 o -SHA256 ダイジェストアルゴリズムを使用した RSA アルゴリズム +SHA256ダイジェスト・アルゴリズムを使用したRSAアルゴリズム .TP 2 o -SHA256 と ECDSA (楕円曲線デジタル署名アルゴリズム) を使用した EC (楕円曲線) 暗号方式アルゴリズム +SHA256とECDSA(楕円曲線デジタル署名アルゴリズム)を使用したEC(楕円曲線)暗号方式アルゴリズム .RE .LP .LP -具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、\f3jarsigner\fP は SHA1withDSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が RSA 鍵である場合、\f3jarsigner\fP は SHA256withRSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が EC 鍵である場合、\f3jarsigner\fP は SHA256withECDSA アルゴリズムを使って JAR ファイルに署名を付けます。 +具体的には、署名者の公開鍵と秘密鍵がDSA鍵である場合、\f3jarsigner\fPはSHA1withDSAアルゴリズムを使用してJARファイルに署名を付けます。署名者の鍵がRSA鍵である場合、\f3jarsigner\fPはSHA256withRSAアルゴリズムを使用してJARファイルに署名を付けます。署名者の鍵がEC鍵である場合、\f3jarsigner\fPはSHA256withECDSAアルゴリズムを使用してJARファイルに署名を付けます。 .LP .LP -これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。 +これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fPオプションを使用してオーバーライドできます。 .LP .SS -署名付き JAR ファイル +署名付きJARファイル .LP .LP -\f3jarsigner\fP を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが META\-INF ディレクトリに置かれる点が異なります。 +\f3jarsigner\fPを使用してJARファイルに署名を付けた場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 .LP .RS 3 .TP 2 o -.SF 拡張子の付いた署名ファイル +.SF拡張子の付いた署名ファイル .TP 2 o -.DSA、.RSA、または .EC を拡張子に持つ署名ブロックファイル +.DSA、.RSAまたは.ECを拡張子の付いた署名ブロック・ファイル .RE .LP .LP -これら 2 つのファイルのベースファイル名は、 \f2\-sigFile\fP オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。 +これら2つのファイルのベース・ファイル名は、\f2\-sigFile\fPオプションの値から作成されます。たとえば、次のようにオプションを指定したとします。 .LP .nf \f3 @@ -264,15 +264,15 @@ .LP .LP -この場合、ファイル名はそれぞれ MKSIGN.SF と MKSIGN.DSA になります。 +この場合、ファイル名はそれぞれMKSIGN.SFとMKSIGN.DSAになります。 .LP .LP -コマンド行で \f2\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。 +コマンドラインで\f2\-sigfile\fPオプションを指定しなかった場合、.SFファイルと.DSAファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線(_)に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線(_)、ハイフンです。 .LP -\f3署名 (.SF) ファイル\fP +\f3署名(.SF)ファイル\fP .LP .LP -署名ファイル (.SF ファイル) は、\f3jarsigner\fP で署名を付けた JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、.SF ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。 +署名ファイル(.SFファイル)は、\f3jarsigner\fPで署名を付けたJARファイルに常に含まれるマニフェスト・ファイルと似ています。つまり、マニフェスト・ファイル同様、.SFファイルには、JARファイルに含まれているソース・ファイルごとに、次の3つの行があります。 .LP .RS 3 .TP 2 @@ -280,27 +280,27 @@ ファイル名 .TP 2 o -使われているダイジェストアルゴリズム (SHA) の名前 +使用されているダイジェスト・アルゴリズム(SHA)の名前 .TP 2 o -SHA ダイジェストの値 +SHAダイジェストの値 .RE .LP .LP -マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータのダイジェスト (ハッシュ) です。一方、.SF ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当するソースファイルに対応する 3 行のハッシュです。 +マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。一方、.SFファイルでは、ソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のこれら3行のハッシュになります。 .LP .LP -署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。後述の「JAR ファイルの検証」で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。 +署名ファイルには、デフォルトでマニフェスト・ファイル全体のハッシュが格納されたヘッダーも含まれています。JARファイルの検証で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。 .LP -\f3署名ブロックファイル\fP +\f3署名ブロック・ファイル\fP .LP -.SF ファイルには署名が付けられ、署名は署名ブロックファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。 証明書または証明書チェーンは、署名に使われた非公開鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェストアルゴリズムに応じて .DSA、.RSA、.EC のいずれかになります。 +.SFファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。証明書または証明書チェーンは、署名に使用された秘密鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて.DSA、.RSA、.ECのいずれかになります。 .SS 署名タイムスタンプ .LP .LP -\f2jarsigner\fP ツールは、JAR ファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、 \f2jarsigner\fP は代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。 +\f2jarsigner\fPツールでは、JARファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、\f2jarsigner\fPは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。 .LP .RS 3 .TP 2 @@ -319,43 +319,47 @@ .LP .LP -これらの各オプションの詳細については、後述の「オプション」節を参照してください。 +これらの各オプションの詳細は、オプションの項を参照してください。 .LP .SS -JAR ファイルの検証 +JARファイルの検証 .LP .LP -JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。 +JARファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後にJARファイル内のどのファイルも変更されていない場合です。JARファイルの検証は、次の手順で行われます。 .LP .RS 3 .TP 3 1. -.SF ファイルそれ自体の署名を検証します。 -.LP -この手順では、各署名ブロック (.DSA) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って生成されたものであることを確認します。 .DSA ファイルには、公開鍵の証明書 (または証明書チェーン) も含まれています。また、この手順では、目的の署名が、対応する署名 (.SF) ファイル内の有効な署名であるかどうかを調べ、.SF ファイルが改変されていないことも確認します。 +.SFファイル自体の署名を検証します。 +.br +.br +この手順では、各署名ブロック(.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 ファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。 +.SFファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突きあわせて検証します。 +.br +.br +.SFファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。このヘッダーが存在する場合は、ヘッダー内のハッシュが実際にマニフェスト・ファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致する場合は、次の手順に検証が進みます。 +.br +.br +ハッシュが一致しない場合は、効率的には劣る方法を使用した検証が必要になります。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかが確認されます(署名(.SF)ファイルを参照)。 +.br +.br +.SFファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュと、実際のマニフェスト・ファイルのハッシュとが一致しない場合は、署名(つまり.SFファイル)の生成後に、JARファイルに1つ以上のファイルが(\f2jar\fPツールを使用して)追加された可能性があります。\f2jar\fPツールを使用してファイルを追加した場合、マニフェスト・ファイルは変更されます(新しいファイル用のセクションが追加されます)が、.SFファイルは変更されません。この場合、.SFファイルのヘッダー以外のセクションに格納されたハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するときは、署名の生成時にJARファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。 .TP 3 3. -JAR ファイル内のファイルのうち、.SF ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルのダイジェストを計算し、結果をマニフェストセクション内の該当するファイルのダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない場合は検証が失敗します。 +JARファイル内のファイルのうち、.SFファイル内にエントリを持つ各ファイルを読み込みます。読込み中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内の該当するファイルのダイジェストと比較します。2つのダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 .RE .LP .LP -検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティー例外がスローされます。スローされたセキュリティー例外は、\f3jarsigner\fP がキャッチして表示します。 +検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティ例外がスローされます。例外は、\f3jarsigner\fPがキャッチして表示します。 .LP .SS -1 つの JAR ファイルを対象とする複数の署名 +1つのJARファイルを対象とする複数の署名 .LP .LP -1 つの JAR ファイルに対して \f3jarsigner\fP ツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JAR ファイルに複数のユーザーの署名を付けることができます。 +1つのJARファイルに対して\f3jarsigner\fPツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JARファイルに複数のユーザーの署名を付けることができます。 .LP .nf \f3 @@ -369,7 +373,7 @@ .LP .LP -JAR ファイルが複数回署名されている場合、その JAR ファイルには .SF ファイルと .DSA ファイルの対が複数含まれることになります。 .SF ファイルと .DSA ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力される JAR ファイルには、次の名前を持つファイルが含まれます。 +JARファイルが複数回署名されている場合、そのJARファイルには.SFファイルと.DSAファイルのペアが複数含まれることになります。.SFファイルと.DSAファイルのペアは、1回の署名に対して1つ作成されます。したがって、上の例で出力されるJARファイルには、次の名前を持つファイルが含まれます。 .LP .nf \f3 @@ -387,39 +391,42 @@ .LP .LP -注: JAR ファイルでは、JDK 1.1 の \f3javakey\fP ツールで生成された署名と \f3jarsigner\fP で生成された署名が混在できます。つまり、すでに \f3javakey\fP を使って署名が付けられている JAR ファイルに、\f3jarsigner\fP を使って署名を付けることができます。 +注意: JARファイルでは、JDK 1.1の\f3javakey\fPツールで生成された署名と\f3jarsigner\fPで生成された署名が混在できます。つまり、すでに\f3javakey\fPを使用して署名が付けられているJARファイルに、\f3jarsigner\fPを使用して署名を付けることができます。 .LP .SH "オプション" .LP .LP -以下では、\f3jarsigner\fP のオプションについて説明します。注: +次に、\f3jarsigner\fPのオプションについて説明します。注意: .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 ファイルに署名を付ける場合だけである +\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 として扱われます。たとえば、次のように指定できます。 +キーストアの場所を示すURLを指定します。デフォルトは、ユーザーのホーム・ディレクトリ内のファイル\f2.keystore\fPです。ユーザーのホーム・ディレクトリは、user.homeシステム・プロパティによって決まります。 +.br +.br +署名するときはキーストアが必要です。このため、デフォルトのキーストアが存在しない場合(またはデフォルト以外のキーストアを使用する場合)は、キーストアを明示的に指定する必要があります。 +.br +.br +検証するときはキーストアは\f2必要ありません\fP。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\f2\-verbose\fPオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 +.br +.br +注意: \f2\-keystore\fPの引数には、URLのかわりにファイル名(とパス)を指定できます。ファイル名(とパス)を指定した場合は、「file:」URLとして扱われます。次に例を示します。 .nf \f3 .fl @@ -427,7 +434,6 @@ .fl \fP .fi -.LP これは、次の指定と同じものとして扱われます。 .nf \f3 @@ -436,8 +442,7 @@ .fl \fP .fi -.LP -JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。 +JREの\f2$JAVA_HOME/lib/security\fPディレクトリに格納された\f2java.security\fPセキュリティ・プロパティ・ファイル内でSun PKCS#11プロバイダが構成されている場合、keytoolとjarsignerはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 .RS 3 .TP 2 o @@ -446,135 +451,141 @@ o \f2\-storetype PKCS11\fP .RE -.LP -たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。 +たとえば、次のコマンドは、構成された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 オプションを指定する必要がありますが、パスワードオプションを指定する必要はありません。 +インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内のkeystore.typeプロパティの値で指定されたタイプです。この値は、\f2java.security.KeyStore\fPのstatic \f2getDefaultType\fPメソッドによって返されます。 +.br +.br +\f2\-storepass\fPオプションを使用してPCKS#11トークンのPINを指定することもできます。何も指定しなかった場合、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 になります。それ以外の場合、パスワードは次のようにして取得されます。 +キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\f2\-storepass\fPオプションをコマンドラインで指定しないと、パスワードの入力を求められます。 +.br +.br +修飾子\f2env\fPまたは\f2file\fPが指定されていない場合、パスワードの値は\f2argument\fPになります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する +\f2file\fP: \f2argument\fPという名前のファイルからパスワードを取得します。 .RE -.LP -注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 +注意: テストを目的とする場合、またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 .TP 3 \-keypass[:env | :file] argument -.LP -コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するのに使うパスワードを指定します。\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 -.LP -修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。 +コマンドラインで指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\f3jarsigner\fPを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンドラインでパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 +.br +.br +修飾子\f2env\fPまたは\f2file\fPが指定されていない場合、パスワードの値は\f2argument\fPになります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する +\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\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。 +.SFファイルと .DSAファイルの生成に使用するベース・ファイル名を指定します。たとえば、\f2file\fPにDUKESIGNを指定すると、生成される.SFファイルと.DSAファイルの名前は、それぞれDUKESIGN.SFとDUKESIGN.DSAになります。これらのファイルは、署名付きJARファイルのMETA\-INFディレクトリに置かれます。 +.br +.br +\f2file\fPに使用できる文字は「a\-zA\-Z0\-9_\-」です。つまり、文字、数字、下線およびハイフンのみを使用できます。注意: .SFおよび.DSAのファイル名では、小文字はすべて大文字に変換されます。 +.br +.br +コマンドラインで\f2\-sigfile\fPオプションを指定しなかった場合、.SFファイルと.DSAファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線(_)に置き換えてファイル名が作成されます。 .TP 3 \-sigalg algorithm -JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。 -.LP -標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」にある +JARファイルの署名に使用する署名アルゴリズムの名前を指定します。 +.br +.br +標準署名アルゴリズム名の一覧は、Java暗号化アーキテクチャの .na -\f2「Appendix A 」\fP @ +\f2付録A\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、SHA256withRSA、SHA256withECDSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しなかった場合、秘密鍵のタイプに応じてSHA1withDSA、SHA256withRSA、SHA256withECDSAのいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\f2\-providerClass\fPオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドの実行が失敗します。 .TP 3 \-digestalg algorithm -JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。 -.LP -標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」にある +JARファイルのエントリをダイジェストする際に使用するメッセージ・ダイジェスト・アルゴリズムの名前を指定します。 +.br +.br +メッセージ・ダイジェスト・アルゴリズム名の一覧は、Java暗号化アーキテクチャの .na -\f2「Appendix A 」\fP @ +\f2付録A\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\f2\-providerClass\fPオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドの実行が失敗します。 .TP 3 \-signedjar file -署名付き JAR ファイルの名前を指定します。 -.LP -コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる JAR ファイル) の名前と同じ名前が使われます。 この場合、入力 JAR ファイルは署名付き JAR ファイルによって上書きされます。 +署名付きJARファイルの名前を指定します。 +.br +.br +コマンドラインで名前を指定しなかった場合は、入力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 ファイルの検証」を参照してください。 +コマンドラインでこのオプションが指定されている場合は、指定されたJARファイルの署名ではなく検証が行われます。検証が成功すると、「jarが検証されました。」というメッセージが表示されます。署名されていないJARファイル、またはサポートされていないアルゴリズム(RSAプロバイダのインストールを終了していない場合のRSAなど)を使用して署名されたJARファイルを検証しようとすると、「jarは署名されていません。(署名が見つからないか、構文解析できません)」というメッセージが表示されます。 +.br +.br +署名付きJARファイルは、\f3jarsigner\fPまたはJDK 1.1の\f3javakey\fPツールのどちらかまたは両方を使用して検証できます。 +.br +.br +検証の詳細は、JARファイルの検証を参照してください。 .TP 3 \-certs -コマンド行で、 \f2\-verify\fP および \f2\-verbose\fP オプションとともにこのオプションを指定した場合、JAR ファイルの各署名者の証明書情報が出力に含まれます。証明書情報には次のものが含まれます。 +コマンドラインで、\f2\-verify\fPおよび\f2\-verbose\fPオプションとともにこのオプションを指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には次のものが含まれます。 .RS 3 .TP 2 o -署名者の公開鍵を証明する (.DSA ファイルに格納された) 証明書の種類の名前 +署名者の公開鍵を証明する(.DSAファイルに格納された)証明書タイプの名前 .TP 2 o -証明書が X. 証明書 (つまり、 \f2java.security.cert.X509Certificate\fP のインスタンス) である場合は、署名者の識別名 +証明書がX.509証明書(つまり、\f2java.security.cert.X509Certificate\fPのインスタンス)である場合は、署名者の識別名 .RE -.LP -キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストアファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。 +キーストアの確認も行われます。コマンドラインでキーストアの値が指定されていない場合、デフォルトのキーストア・ファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。 .RS 3 .TP 2 o -署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。 ただし、キーストアではなく JDK 1.1 のアイデンティティーデータベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。 +署名者に該当するキーストア・エントリの別名。この別名は括弧で囲まれます。ただし、キーストアではなくJDK 1.1のアイデンティティ・データベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。 .RE .TP 3 \-certchain file -コマンド行で指定した別名で決まるキーストアエントリの非公開鍵に関連付けられた証明書チェーンが完全でない場合に、使用すべき証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェアトークン上に格納されているが、そこには証明書チェーンの全体を保持できるだけの領域が存在していないような場合です。このファイルは一連の X.509 証明書が順に連結されたもの、PKCS#7 形式の単一データブロックのいずれかとなり、そのエンコーディング形式はバイナリエンコーディング形式、Internet RFC 1421 標準で規定される印刷可能エンコーディング形式 (BASE64 エンコーディングとも呼ばれる) のいずれかになります。 +コマンドラインで指定した別名で決まるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全でない場合に、使用する証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェア・トークン上に格納されているが、そこには証明書チェーンの全体を保持できる領域が存在していないような場合です。このファイルは一連のX.509証明書が順に連結されたもの、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(BASE64エンコーディングとも呼ばれる)のいずれかになります。 .TP 3 \-verbose -コマンド行でこのオプションが指定されている場合、\f3jarsigner\fP は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出力します。 +コマンドラインでこのオプションが指定されている場合、\f3jarsigner\fPは「冗長」モードで動作し、JARの署名または検証の進行状況に関する追加情報を出力します。 .TP 3 \-internalsf -以前は、JAR ファイルの署名時に生成された .DSA (署名ブロック) ファイルの中に、生成された .SF ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この動作は変更されました。この動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、デフォルトでは .SF ファイルが .DSA ファイルに含まれないようになっています。ただし、 \f2\-internalsf\fP オプションをコマンド行で指定すると、以前と同じように動作します。\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP +以前は、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 +コマンドラインでこのオプションが指定されている場合、JARファイルの署名時に生成される.SFファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは\f2含まれません\fP。この場合、.SFファイルに含まれるのは、JARファイル内の各ソース・ファイルに関する情報およびハッシュのみです。詳細は、署名(.SF)ファイルを参照してください。 +.br +.br +デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合は、JARファイルの検証時に、まずヘッダー内のハッシュが、マニフェスト・ファイル全体のハッシュと実際に一致するかどうかが確認されます。一致する場合、検証は次の手順に進みます。ハッシュが一致しない場合は、効率的には劣る方法を使用して検証する必要があります。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかが確認されます。 +.br +.br +詳細は、JARファイルの検証を参照してください。 +.br +.br +\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。このオプションを使用すると、有益な最適化が行われなくなります。\fP .TP 3 \-protected -\f2true\fP または \f2false\fP。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値を \f2true\fP に指定してください。 +\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 キーストアを一覧表示するコマンドの例を次に示します。 +サービス・プロバイダがセキュリティ・プロパティ・ファイル(\f2java.security\fP)のリストに入っていないときに、暗号化サービス・プロバイダのマスター・クラス・ファイルの名前を指定するために使用します。 +.br +.br +\f2\-providerArg\fP \f2ConfigFilePath\fPオプションと組み合せて使用します。keytoolとjarsignerはプロバイダを動的にインストールします(ここで、\f2ConfigFilePath\fPはトークン構成ファイルへのパスです)。セキュリティ・プロパティ・ファイル内でSun PKCS#11プロバイダが構成されていない場合にPKCS#11キーストアを一覧表示するコマンドの例を次に示します。 .nf \f3 .fl @@ -590,13 +601,14 @@ .fi .TP 3 \-providerName providerName -\f2java.security\fP セキュリティープロパティーファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前です。 -.LP -Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP という形式になります。 ここで「\f2TokenName\fP」は、プロバイダインスタンスが構成された名前の接尾辞です。 詳細は +\f2java.security\fPセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成されている場合、\f2\-providerName\fPオプションを使用して特定のプロバイダ・インスタンスを選択できます。このオプションの引数は、プロバイダの名前です。 +.br +.br +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 キーストアプロバイダインスタンスの内容をリストします。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/p11guide.html#ATTRSを参照してください。たとえば、次のコマンドは、名前接尾辞\f2SmartCard\fPのPKCS#11キーストア・プロバイダ・インスタンスの内容をリストします。 .nf \f3 .fl @@ -609,38 +621,39 @@ \fP .fi .TP 3 -できますjavaoption -指定された \f2javaoption\fP 文字列を Java インタプリタに直接渡します。\f3jarsigner\fP は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。使用可能なインタプリタオプションの一覧を表示するには、 \f2java \-h\fP または \f2java \-X\fP とコマンド行から入力します。 -.LP +\-Jjavaoption +指定された\f2javaoption\fP文字列をJavaインタプリタに直接渡します。(\f3jarsigner\fPは、実際にはJavaインタプリタに対する「ラッパー」です。)このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\f2java \-h\fPまたは\f2java \-X\fPと入力してください。 .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 は、 +\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の公開鍵証明書をキーストアに配置する必要はありません。 +.br +.br +タイムスタンプを生成するために、\f2jarsigner\fPは、 .na \f2RFC 3161\fP @ .fi -http://www.ietf.org/rfc/rfc3161.txt で定義されている タイムスタンププロトコル (TSP) を使用して TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンは署名ブロックファイルの署名とともに保存されます。 -.LP +http://www.ietf.org/rfc/rfc3161.txtで定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAから返されたタイムスタンプ・トークンは署名ブロック・ファイルの署名とともに保存されます。 .TP 3 \-tsacert alias -\f2「\-tsacert alias」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。 \f2alias\fP は、キーストア内の現在有効な TSA の公開鍵証明書を特定します。エントリの証明書で、TSA の場所を特定する URL を含む Subject Information Access 拡張機能が確認されます。 -.LP -TSA の公開鍵証明書は、 \f2\-tsacert を使った場合、キーストアに配置されている必要があります。\fP. -.LP +\f2「\-tsacert alias」\fPがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。\f2alias\fPは、キーストア内の現在有効なTSAの公開鍵証明書を示しています。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 +.br +.br +\f2\-tsacert\fPを使用した場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 .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 +代替署名機構を使用することを指定します。完全修飾クラス名で、\f2com.sun.jarsigner.ContentSigner\fP抽象クラスを拡張するクラス・ファイルを指定します。このクラス・ファイルへのパスは、\f2\-altsignerpath\fPオプションによって定義されます。\f2\-altsigner\fPオプションが使用されると、\f2jarsigner\fPは、指定されたクラスが提供する署名機構を使用します。それ以外の場合、\f2jarsigner\fPはデフォルトの署名機構を使用します。 +.br +.br +たとえば、\f2com.sun.sun.jarsigner.AuthSigner\fPという名前のクラスが提供する署名機構を使用するには、\f2jarsigner\fPで\f2「\-altsigner com.sun.jarsigner.AuthSigner」\fPというオプションを使用します。 .TP 3 \-altsignerpath classpathlist -クラスファイル (そのクラスファイル名は前述の \f2\-altsigner\fP オプションで指定される) およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。クラスファイルが JAR ファイル内にある場合、以下の例のように JAR ファイルへのパスが指定されます。 -.LP -絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP に複数のパスや JAR ファイルが含まれる場合には、それらを Solaris の場合はコロン (\f2:\fP) で、Windows の場合はセミコロン (\f2;\fP) でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 -.LP -クラスファイルを含む、JAR ファイルへのパスを指定する例を示します。 +クラス・ファイル(クラス・ファイル名は前述の\f2\-altsigner\fPオプションで指定します)およびそのクラスが依存するすべてのJARファイルへのパスを指定します。クラス・ファイルがJARファイル内にある場合、以下の例のようにJARファイルへのパスが指定されます。 +.br +.br +絶対パスまたは現在のディレクトリからの相対パスを指定できます。\f2classpathlist\fPに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(\f2:\fP)で、Windowsの場合はセミコロン(\f2;\fP)でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 +.br +.br +クラス・ファイルを含む、JARファイルへのパスを指定する例を示します。 .nf \f3 .fl @@ -648,10 +661,10 @@ .fl \fP .fi -.LP -JAR ファイル名が含まれていることに注意してください。 -.LP -クラスファイルを含む JAR ファイルへのパスを指定する例を示します。 +JARファイル名が含まれていることに注意してください。 +.br +.br +クラス・ファイルを含むJARファイルへのパスを指定する例を示します。 .nf \f3 .fl @@ -659,41 +672,40 @@ .fl \fP .fi -.LP -JAR ファイル名は含まれていないことに留意してください。 +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 つのエントリ (およびそれ以上)」として要約されて表示されます。詳細は例の項を参照してください。 +検証処理の場合、表示する情報の量を決定するサブオプションを\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 ファイルの署名 +JARファイルの署名 .LP .LP -bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。 +bundle.jarという名前のJARファイルがあるとします。このファイルに、workingというディレクトリのmystoreというキーストアにあるキーストアの別名がjaneであるユーザーの秘密鍵を使用して、署名を付けるとします。次のコマンドを実行すると、JARファイルに署名を付けてsbundle.jarという署名付きJARファイルを作成できます。 .LP .nf \f3 .fl - jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3 + jarsigner \-keystore /working/mystore \-storepass \fP\f4<keystore password>\fP\f3 .fl - \-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 \-signedjar sbundle.jar bundle.jar jane + \-keypass \fP\f4<private key password>\fP\f3 \-signedjar sbundle.jar bundle.jar jane .fl \fP .fi .LP .LP -上のコマンドでは \f2\-sigfile\fP が指定されていないため、署名付き JAR ファイルに格納される .SF ファイルと .DSA ファイルの名前は、別名からデフォルト名がつけられます。つまり、それらの名前は \f2JANE.SF\fP および \f2JANE.DSA\fP になります。 +上のコマンドでは\f2\-sigfile\fPが指定されていないため、署名付きJARファイルに格納される.SFファイルと.DSAファイルの名前は、別名からデフォルト名が付けられます。つまり、それらの名前は\f2JANE.SF\fPおよび\f2JANE.DSA\fPになります。 .LP .LP -ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、上のコマンドを短縮して次のように入力できます。 +ストアのパスワードと秘密鍵のパスワードの入力を求めるプロンプトを表示する場合は、上のコマンドを短縮して次のように入力できます。 .LP .nf \f3 @@ -707,7 +719,7 @@ .LP .LP -デフォルトのキーストア (ホームディレクトリ内の .keystore という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を省略できます。 +デフォルトのキーストア(ホーム・ディレクトリ内の.keystoreという名前のキーストア)を使用する場合は、次に示すように、キーストアの指定を省略できます。 .LP .nf \f3 @@ -719,7 +731,7 @@ .LP .LP -最後に、入力 JAR ファイル (\f2bundle.jar\fP) を署名付き JAR ファイルで単純に上書きする場合は、次のように \f2\-signedjar\fP オプションを指定する必要はありません。 +最後に、入力JARファイル(\f2bundle.jar\fP)を署名付きJARファイルで単純に上書きする場合は、次のように\f2\-signedjar\fPオプションを指定する必要はありません。 .LP .nf \f3 @@ -731,10 +743,10 @@ .LP .SS -署名付き JAR ファイルの検証 +署名付きJARファイルの検証 .LP .LP -次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが改変されていないことを確認するためのコマンド例です。 +署名付きJARファイルを検証する、つまり署名が有効でJARファイルが改変されていないことを確認するには、次のようなコマンドを入力します。 .LP .nf \f3 @@ -746,7 +758,7 @@ .LP .LP -検証が成功すると、次のようなメッセージが表示されます。 +検証が成功すると、 .LP .nf \f3 @@ -758,10 +770,10 @@ .LP .LP -というプロンプトが表示されます。検証が成功しなかった場合は、エラーメッセージが表示されます。 +と表示されます。それ以外の場合は、エラー・メッセージが表示されます。 .LP .LP -\-verbose オプションを使うと、 \f2より多くの情報が\fP 表示されます。\-verbose オプション付きで \f3jarsigner\fP \f2を使用する例とその出力例を、\fP 次に示します。 +\f2\-verbose\fPオプションを使用すると、より多くの情報が表示されます。\f2\-verbose\fPオプション付きで\f3jarsigner\fPを使用する例とその出力例を、次に示します。 .LP .nf \f3 @@ -782,25 +794,25 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .SS -証明書情報を使った検証 +証明書情報を使用した検証 .LP .LP -検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 および JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。たとえば、 +検証時に\f2\-verify\fPと\f2\-verbose\fPオプションに加えて\f2\-certs\fPオプションを指定した場合は、JARファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報(X.509証明書の場合のみ)、およびJARファイルの公開鍵の証明書がキーストア・エントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。次に示します。 .LP .nf \f3 @@ -829,22 +841,22 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .LP -署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の場合は、次のように表示されます。 +署名者の証明書がX.509証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名がbobの場合は、次のように表示されます。 .LP .nf \f3 @@ -856,13 +868,13 @@ .LP .SS -アイデンティティーデータベースの署名者を含む JAR ファイルの検証 +アイデンティティ・データベースの署名者を含むJARファイルの検証 .LP .LP -JAR ファイルが、JDK 1.1 の \f3javakey\fP ツールを使って署名されている場合、署名者はアイデンティティーデータベース内の別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、アイデンティティーデータベース内の別名とキーストア内の別名の両方によって署名されている場合は、k と i の両方が表示されます。 +JARファイルが、JDK 1.1の\f3javakey\fPツールを使用して署名されている場合、署名者はアイデンティティ・データベース内の別名です。この場合、検証の出力には「i」という記号が含まれます。JARファイルが、アイデンティティ・データベース内の別名とキーストア内の別名の両方によって署名されている場合は、「k」と「i」の両方が表示されます。 .LP .LP -\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。次に例を示します。 +\f2\-certs\fPオプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティ・データベース内の別名は角括弧で囲まれて表示されます。次に例を示します。 .LP .nf \f3 @@ -891,92 +903,92 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl - i = アイデンティティースコープで 1 つ以上の証明書が見つかりました + i = at least one certificate was found in identity scope .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .LP -別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティーデータベースの別名です。 +別名dukeは角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティ・データベースの別名です。 .LP .SH "警告" .LP -署名/検証処理中には、jarsigner からさまざまな警告が表示される可能性があります。これらの警告コードは次のように定義されています。 +署名/検証処理中には、jarsignerから様々な警告が表示される可能性があります。これらの警告コードは次のように定義されています。 .nf \f3 .fl hasExpiringCert 2 .fl - この JAR に含まれるエントリの署名者の証明書が 6 か月以内に期限切れになります + This jar contains entries whose signer certificate will expire within six months .fl .fl hasExpiredCert 4 .fl - この JAR に含まれるエントリの署名者の証明書が期限切れになっています。 + This jar contains entries whose signer certificate has expired. .fl .fl notYetValidCert 4 .fl - この JAR に含まれるエントリの署名者の証明書がまだ有効になっていません。 + This jar contains entries whose signer certificate is not yet valid. .fl .fl chainNotValidated 4 .fl - この JAR に含まれるエントリの証明書チェーンの検証を正しく行えません。 + This jar contains entries whose certificate chain cannot be correctly validated. .fl .fl - badKeyUsa ge 8 + badKeyUsage 8 .fl - この JAR に含まれるエントリの署名者の証明書の KeyUsage 拡張がコードの署名を許可していません。 + This jar contains entries whose signer certificate's KeyUsage extension doesn't allow code signing. .fl .fl badExtendedKeyUsage 8 .fl - この JAR に含まれるエントリの署名者の証明書の ExtendedKeyUsage 拡張が + This jar contains entries whose signer certificate's ExtendedKeyUsage extension .fl - コードの署名を許可していません。 + doesn't allow code signing. .fl .fl badNetscapeCertType 8 .fl - この JAR に含まれるエントリの署名者の証明書の NetscapeCertType 拡張が + This jar contains entries whose signer certificate's NetscapeCertType extension .fl - コードの署名を許可していません。 + doesn't allow code signing. .fl .fl hasUnsignedEntry 16 .fl - この JAR には、完全性チェックが行われていない署名なしエントリが含まれています。 + This jar contains unsigned entries which have not been integrity\-checked. .fl .fl notSignedByAlias 32 .fl - この JAR には、指定された別名によって署名されていない署名付きエントリが含まれています + This jar contains signed entries which are not signed by the specified alias(es) .fl .fl aliasNotInStore 32 .fl - この JAR には、このキーストアの別名によって署名されていない署名付きエントリが含まれています + This jar contains signed entries that are not signed by alias in this keystore .fl .fl @@ -985,10 +997,10 @@ .LP .LP -\f2\-strict\fP オプションを指定した場合、検出された警告の OR を取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書の keyUsage 拡張でファイルの署名が許可されていない場合、終了コード 12 (=4+8) が返されます。 +\f2\-strict\fPオプションを指定した場合、検出された警告のORを取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書のkeyUsage拡張でファイルの署名が許可されていない場合、終了コード12(=4+8)が返されます。 .LP .LP -\f3注\fP: UNIX で使用可能な値は 0 から 255 だけであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。 +\f3注意\fP: UNIXで使用可能な値は0から255のみであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。 .LP .nf \f3 @@ -1000,29 +1012,29 @@ .LP .SS -JDK 1.1 との互換性 +JDK 1.1との互換性 .LP .LP -\f3keytool\fP ツールと \f3jarsigner\fP ツールは、JDK 1.1 で提供されていた \f3javakey\fP ツールを完全に置き換えるものです。これらの新しいツールは、キーストアと非公開鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fP より多くのを機能を備えています。 +\f3keytool\fPツールと\f3jarsigner\fPツールは、JDK 1.1で提供されていた\f3javakey\fPツールを完全に置き換えるものです。これらの新しいツールは、キーストアと秘密鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fPより多くのを機能を備えています。 .LP .LP -新しいキーストアアーキテクチャーは、\f3javakey\fP が作成して管理していたアイデンティティーデータベースに代わるものです。キーストア形式と、JDK 1.1 の \f3javakey\fP が使っていたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。 +新しいキーストア・アーキテクチャは、\f3javakey\fPが作成して管理していたアイデンティティ・データベースに代わるものです。キーストア形式と、1.1の\f3javakey\fPが使用していたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。 .LP .RS 3 .TP 2 o -\f3keytool\fP の \f2\-identitydb\fP コマンドを使うと、アイデンティティーデータベースの情報をキーストアにインポートできます。 +\f3keytool\fPの\f2\-identitydb\fPコマンドを使用すると、アイデンティティ・データベースの情報をキーストアにインポートできます。 .TP 2 o -\f3jarsigner\fP は、以前に \f3javakey\fP を使って署名された JAR ファイルに署名を付けることができます。 +\f3jarsigner\fPは、以前に\f3javakey\fPを使用して署名されたJARファイルに署名を付けることができます。 .TP 2 o -\f3jarsigner\fP は、\f3javakey\fPを使って署名された JAR ファイルを検証できます。したがって、jarsigner は、Java 2 SDK のキーストアではなく JDK 1.1 のアイデンティティーデータベースからの署名者別名を認識し、これらを対象に処理を行うことができます。 +\f3jarsigner\fPは、\f3javakey\fPを使用して署名されたJARファイルを検証できます。したがって、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 @@ -1053,7 +1065,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 @@ -1069,7 +1081,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 @@ -1085,7 +1097,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 @@ -1101,7 +1113,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 @@ -1117,7 +1129,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr e| \n(dn @@ -1133,7 +1145,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr f| \n(dn @@ -1149,7 +1161,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr g| \n(dn @@ -1165,7 +1177,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(81 .ll \n(81u .in 0 -あり/信頼できない +はい/信頼できない .br .di .nr h| \n(dn @@ -1181,7 +1193,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権(3) +すべてのコードに付与されるデフォルトの特権(3) .br .di .nr i| \n(dn @@ -1197,7 +1209,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(81 .ll \n(81u .in 0 -あり/信頼できない +はい/信頼できない .br .di .nr j| \n(dn @@ -1213,7 +1225,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 @@ -1229,7 +1241,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権 +すべてのコードに付与されるデフォルトの特権とポリシー・ファイル内で付与される特権 .br .di .nr l| \n(dn @@ -1245,7 +1257,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権(2) +すべてのコードに付与されるデフォルトの特権とポリシー・ファイル内で付与される特権(2) .br .di .nr m| \n(dn @@ -1256,46 +1268,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 @@ -1306,63 +1318,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すべての特権 .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 @@ -1396,7 +1408,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 1078 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1090 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1421,7 +1433,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 @@ -1458,7 +1470,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 @@ -1474,7 +1486,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 @@ -1490,7 +1502,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 @@ -1508,7 +1520,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 @@ -1533,7 +1545,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 @@ -1556,7 +1568,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 @@ -1572,7 +1584,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 @@ -1586,15 +1598,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 @@ -1617,21 +1629,21 @@ .LP .LP -注 \- +注意: .LP .RS 3 .TP 3 1. -ポリシーファイル内にアイデンティティー/別名についての言及がある場合、それをキーストアにインポートして、ポリシーファイルの設定が与えられた特権に反映されるようにする必要があります。 +ポリシー・ファイル内にアイデンティティ/別名についての言及がある場合、それをキーストアにインポートして、付与された特権にポリシー・ファイルの設定が反映されるようにする必要があります。 .TP 3 2. -ポリシーファイル/キーストアの組み合わせは、アイデンティティーデータベース内の信頼できるアイデンティティーよりも優先されます。 +ポリシー・ファイル/キーストアの組合せは、アイデンティティ・データベース内の信頼できるアイデンティティよりも優先されます。 .TP 3 3. -Java 2 プラットフォームでは、信頼できないアイデンティティーは無視されます。 +Java 2プラットフォームでは、信頼できないアイデンティティは無視されます。 .TP 3 4. -Java 2 SDK キーストアにインポートできるのは、信頼できるアイデンティティーだけです。 +Java 2 SDKキーストアにインポートできるのは、信頼できるアイデンティティのみです。 .RE .LP @@ -1640,20 +1652,21 @@ .RS 3 .TP 2 o -jar(1) ツールのドキュメント +jar(1)ツールのドキュメント .TP 2 o -keytool(1) ツールのドキュメント +keytool(1)ツールのドキュメント .TP 2 o +\f3jarsigner\fPツールの使用例は、 .na -\f4jarsigner\fP\f2 ツールの使用例については、\fP @ +\f4Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/security/index.html +http://docs.oracle.com/javase/tutorial/index.htmlの .na -\f2「Java チュートリアル」\fP\f4の\fP @ +\f4セキュリティ\fP @ .fi -http://download.oracle.com/javase/tutorial/index.html「Security」\f3を参照\fP +http://docs.oracle.com/javase/tutorial/security/index.htmlを参照 .RE .LP
--- a/src/linux/doc/man/ja/java.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/java.1 Mon Apr 16 11:16:28 2012 -0700 @@ -1,4 +1,4 @@ -." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved. +." Copyright (c) 1994, 2012, 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,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH java 1 "07 May 2011" +.TH java 1 "01 Apr 2012" .LP .SH "名前" -java \- Java アプリケーション起動ツール +java \- Javaアプリケーション起動ツール .LP .RS 3 .TP 2 @@ -56,26 +56,26 @@ .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 .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 @@ -87,13 +87,13 @@ .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 @@ -105,85 +105,115 @@ .RS 3 .TP 3 \-client -.LP -Java HotSpot Client VM を選択します。64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。 -.LP -デフォルトの VM の選択については、 +Java HotSpot Client VMを選択します。64ビット対応JDKは現時点では、このオプションを無視し、かわりにJava Hotspot Server VMを使用します。 +.br +.br +デフォルトのVMの選択については、 .na -\f2「サーバー \- クラスマシンの検出」\fP @ +\f2サーバー \- クラス・マシンの検出\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/server\-class.htmlを参照してください。 .TP 3 \-server -.LP -Java HotSpot Server VM を選択します。64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。 -.LP -デフォルトの VM の選択については、 +Java HotSpot Server VMを選択します。64ビット対応JDK上では、サポートされるのはJava Hotspot Server VMのみであるため、\-serverオプションが暗黙的に選択されます。 +.br +.br +デフォルトのVMの選択については、 .na -\f2「サーバー \- クラスマシンの検出」\fP @ +\f2サーバー \- クラス・マシンの検出\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/server\-class.htmlを参照してください。 .TP 3 \-agentlib:libname[=options] -ネイティブエージェントライブラリ \f2libname\fP をロードします。たとえば次のように指定します。 -.LP -\-agentlib:hprof -.LP -\-agentlib:jdwp=help -.LP -\-agentlib:hprof=help -.LP -詳細については、 +ネイティブ・エージェント・ライブラリ\f2libname\fPをロードします。たとえば次のように指定します。 +.br +.br +\-agentlib:hprof +.br +.br +\-agentlib:jdwp=help +.br +.br +\-agentlib:hprof=help +.br +.br +詳細は、 .na -\f2「JVMTI エージェントのコマンド行オプション」\fP @ +\f2JVMTIエージェントのコマンドライン・オプション\fP @ .fi -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。 +http://download.oracle.com/javase/7/docs/platform/jvmti/jvmti.html#startingを参照してください。 .TP 3 \-agentpath:pathname[=options] -フルパス名を使用して、ネーティブエージェントライブラリをロードします。詳細については、 +フルパス名を使用して、ネーティブ・エージェント・ライブラリをロードします。詳細は、 .na -\f2「JVMTI エージェントのコマンド行オプション」\fP @ +\f2JVMTIエージェントのコマンドライン・オプション\fP @ .fi -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。 +http://download.oracle.com/javase/7/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 環境変数の設定がオーバーライドされます。 -.LP -\f3\-classpath\fP も \f3\-cp\fP も使用されず、\f3CLASSPATH\fP も設定されていない場合、ユーザークラスパスは現在のディレクトリ (\f4.\fP) になります。 -.LP -便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。 +クラス・ファイルを検索するディレクトリ、JARアーカイブおよびZIPアーカイブのリストを指定します。クラス・パスの各エントリはコロン(\f3:\fP)で区切ります。\f3\-classpath\fPまたは\f3\-cp\fPを指定すると、このオプションの値によって\f3CLASSPATH\fP環境変数の設定がオーバーライドされます。 +.br +.br +\f3\-classpath\fPも\f3\-cp\fPも使用されず、\f3CLASSPATH\fPも設定されていない場合、ユーザー・クラス・パスは現在のディレクトリ(\f4.\fP)になります。 +.br +.br +便宜上、\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 プログラムが展開されていないワイルドカードを認識することはありません。 -.LP -クラスパスの詳細は、 +たとえば、ディレクトリ\f2foo\fPに\f2a.jar\fPと\f2b.JAR\fPが含まれている場合、クラス・パス要素\f2foo/*\fPは\f2A.jar:b.JAR\fPに展開されます。ただし、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。\f2*\fPのみからなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\f2CLASSPATH\fP環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカード展開は必ず、Java仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 +.br +.br +クラス・パスの詳細は、 .na -\f2「クラスパスの設定」\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpathを参照してください。 .TP 3 \-Dproperty=value -システムプロパティーの値を設定します。 +システム・プロパティの値を設定します。 .TP 3 \-d32 .TP 3 \-d64 -それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。 -.LP -現在のところ、Java HotSpot Server VM だけが 64 ビットの操作をサポートしており、\-server オプションを使用する場合は、\-d64 も一緒に使用する必要があります。したがって、\-d64 使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 -.LP -\f3\-d32\fP と \f3\-d64\fP がどちらも指定されていない場合は、デフォルトとして、32 ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。 +それぞれ32ビット環境、64ビット環境でプログラムを実行することをリクエストします。リクエストされた環境がインストールされていないかサポートされていない場合は、エラーが報告されます。 +.br +.br +現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\-d64使用時には\-serverオプションが暗黙的に使用されます。したがって、\-d64使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 +.br +.br +\f3\-d32\fPと\f3\-d64\fPがどちらも指定されていない場合は、デフォルトとして、32ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。 .TP 3 \-enableassertions[:<package name>"..." | :<class name> ] .TP 3 \-ea[:<package name>"..." | :<class name> ] -アサーションを有効にします。アサーションは、デフォルトでは無効になっています。 -.LP -引数なしの \f3enableassertions\fP または \f3\-ea\fP を指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが有効になります。 -.LP -単一コマンド行にこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ \f2com.wombat.fruitbat\fP (サブパッケージを含む) 内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。 +.TP 3 +\-disableassertions[:<package name>"..." | :<class name> ] +.TP 3 +\-da[:<package name>"..." | :<class name> ] +アサーションを無効にします。これがデフォルトです。 +.br +.br +引数なしの\f3disableassertions\fPまたは\f3\-da\fPを指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」のみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが無効になります。 +.br +.br +パッケージ\f2com.wombat.fruitbat\fP内ではアサーションを有効にし、クラス\f2com.wombat.fruitbat.Brickbat\fP内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。 +.nf +\f3 +.fl +java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat \fP\f4<Main Class>\fP\f3 +.fl +\fP +.fi +\f3\-disableassertions\fPおよび\f3\-da\fPスイッチは、\f2すべての\fPクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用\f2されない\fP、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステム・クラスでアサーションを無効にするために、別のスイッチが用意されています。この後の\f3\-disablesystemassertions\fPを参照してください。 +アサーションを有効にします。アサーションは、デフォルトでは無効になっています。 +.br +.br +引数なしの\f3enableassertions\fPまたは\f3\-ea\fPを指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」のみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが有効になります。 +.br +.br +単一コマンドラインにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ\f2com.wombat.fruitbat\fP(サブパッケージを含む)内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。 .nf \f3 .fl @@ -191,64 +221,56 @@ .fl \fP .fi -.LP -\f3\-enableassertions\fP および \f3\-ea\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを有効にするために、別のスイッチが用意されています。このあとの \f3\-enablesystemassertions\fP を参照してください。 -.TP 3 -\-disableassertions[:<package name>"..." | :<class name> ] -.TP 3 -\-da[:<package name>"..." | :<class name> ] -アサーションを無効にします。これがデフォルトです。 -.LP -引数なしの \f3disableassertions\fP または \f3\-da\fP を指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが無効になります。 -.LP -パッケージ \f2com.wombat.fruitbat\fP 内ではアサーションを有効にし、クラス \f2com.wombat.fruitbat.Brickbat\fP 内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。 -.nf -\f3 -.fl -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\-enableassertions\fPおよび\f3\-ea\fPスイッチは、\f2すべての\fPクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用\f2されない\fP、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステム・クラスでアサーションを無効にするために、別のスイッチが用意されています。この後の\f3\-enablesystemassertions\fPを参照してください。 .TP 3 \-enablesystemassertions .TP 3 \-esa -すべてのシステムクラス内でアサーションを有効にします。つまり、システムクラスについてアサーションのデフォルトステータスを \f2true\fP に設定します。 +すべてのシステム・クラス内でアサーションを有効にします。つまり、システム・クラスについて\f2アサーションのデフォルト・ステータス\fPを\f2true\fPに設定します。 .TP 3 \-disablesystemassertions .TP 3 \-dsa -すべてのシステムクラス内でアサーションを無効にします。 +すべてのシステム・クラス内でアサーションを無効にします。 +.TP 3 +\-helpまたは\-? +使用方法を表示して終了します。 .TP 3 \-jar -JAR ファイルにカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR ファイルの名前にします。このオプションが機能するには、JAR ファイルのマニフェストに\f3「Main\-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://download.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。 -.LP -このオプションを使用すると、指定した JAR ファイルがすべてのユーザークラスのソースになり、ユーザークラスパスのほかの設定は無視されます。 -.LP -Solaris 8 では、「java \-jar」オプションで実行できる JAR ファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。Java Archive (JAR) ファイル +http://docs.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。\ +.br +.br +このオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、ユーザー・クラス・パスの他の設定は無視されます。 +.br +.br +「java \-jar」オプションで実行できるJARファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。 .na - @ +\f2Java Archive(JAR)ファイル\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/jar/index.htmlを参照してください。 .TP 3 \-javaagent:jarpath[=options] -Java プログラミング言語エージェントをロードします。 java.lang.instrument を参照してください。 +Javaプログラミング言語エージェントをロードします。 .na - @ +\f2java.lang.instrument\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html +http://download.oracle.com/javase/7/docs/api/java/lang/instrument/package\-summary.htmlを参照してください。 .TP 3 \-jre\-restrict\-search -ユーザープライベートな JRE をバージョン検索に含めます。 +ユーザー・プライベートなJREをバージョン検索に含めます。 .TP 3 \-no\-jre\-restrict\-search -ユーザープライベートな JRE をバージョン検索から除外します。 +ユーザー・プライベートなJREをバージョン検索から除外します。 +.TP 3 +\-showversion +バージョン情報を表示して続行します。(関連項目: \f3\-version\fP。) +.TP 3 +\-splash:imagepath +\f2imagepath\fPに指定された画像を含むスプラッシュ画面を表示します。 .TP 3 \-verbose .TP 3 @@ -256,18 +278,19 @@ クラスがロードされるたびにクラスに関する情報を表示します。 .TP 3 \-verbose:gc -ガベージコレクションイベントが発生するたびに報告します。 +ガベージ・コレクション・イベントが発生するたびに報告します。 .TP 3 \-verbose:jni -ネイティブメソッドの使用およびその他の Java Native Interface (JNI) アクティビティーに関する情報を報告します。 +ネイティブ・メソッドの使用およびその他のJava Native Interface(JNI)アクティビティに関する情報を報告します。 .TP 3 \-version -バージョン情報を表示して終了します。 +バージョン情報を表示して終了します。(関連項目: \f3\-showversion\fP。) .TP 3 \-version:release -コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 -.LP -\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。 +コマンドラインに指定されたクラスまたはJARファイルが、\f2release\fPで指定されたバージョンを必要としていることを示します。起動されたjavaコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 +.br +.br +\f2release\fPでは、特定のバージョンを指定できるのみでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョンID、バージョンIDの後にアスタリスク(*)を付加したもの、バージョンIDの後にプラス記号(+)を付加したもの、2つのバージョン範囲をアンパサンド(&)で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは2つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。 .nf \f3 .fl @@ -275,25 +298,13 @@ .fl \fP .fi -上記の意味は、バージョン 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 ファイルのマニフェスト内に指定することが推奨されています。 -.LP -このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。 -.TP 3 -\-showversion -バージョン情報を表示して続行します。 -.TP 3 -\-? -.TP 3 -\-help -使用法を表示して終了します。 -.TP 3 -\-splash:imagepath -\f2imagepath\fP に指定された画像を含むスプラッシュ画面を表示します。 -.TP 3 -\-X -非標準オプションに関する情報を表示して終了します。 +上記の意味は、バージョン1.6.0_13、1.6をバージョンIDプレフィックスに持つ1.6.0_10以上のバージョン、のいずれかをクラスまたはJARファイルが必要としている、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol&API Specification(JSR\-56)」の「Appendix A」を参照してください。 +.br +.br +JARファイルの場合は通常、バージョン要件をコマンドラインに指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 +.br +.br +このオプションの使用に関する重要なポリシー情報については、後述の注意を参照してください。 .RE .LP @@ -302,45 +313,53 @@ .LP .RS 3 .TP 3 +\-X +非標準オプションに関する情報を表示して終了します。 +.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 アーカイブをコロンで区切ったリストで指定します。指定したパスに存在するブートクラスファイルが、Java プラットフォーム 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 を指定したときに報告される情報のほかに、報告される各イベントの先頭に、最初のガベージコレクションイベントからの経過時間 (秒単位) が付け加えられます。 -.LP -ネットワークの応答時間によって JVM の実行速度が低下するのを避けるため、このファイルの格納先は、常にローカルファイルシステムにしてください。ファイルシステムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引き続き記録されます。このオプションと \f2\-verbose:gc\fP の両方がコマンド行に指定されている場合は、このオプションが優先されます。 +\-verbose:gcと同様にガベージ・コレクション・イベントが発生するたびに報告しますが、そのデータを\f2file\fPに記録します。\f2\-verbose:gc\fPを指定したときに報告される情報の他に、報告される各イベントの先頭に、最初のガベージ・コレクション・イベントからの経過時間(秒単位)が付け加えられます。 +.br +.br +ネットワークのレスポンス時間によってJVMの実行速度が低下するのを避けるため、このファイルの格納先は、常にローカル・ファイル・システムにしてください。ファイル・システムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引続き記録されます。このオプションと\f2\-verbose:gc\fPの両方がコマンドラインに指定されている場合は、このオプションが優先されます。 +.TP 3 +\-Xmnsizeまたは\-XX:NewSize +若い世代(ナーサリ)のサイズを設定します。 .TP 3 \-Xmsn -メモリー割り当てプールの初期サイズをバイト数で指定します。指定する値は、1M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「 +メモリー割当プールの初期サイズをバイト数で指定します。指定する値は、1MBより大きい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 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/gc\-ergonomics.htmlを参照してください。 +.br +.br 例: .nf \f3 @@ -357,11 +376,12 @@ .fi .TP 3 \-Xmxn -メモリー割り当てプールの最大サイズをバイト数で指定します。指定する値は、2M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「 +メモリー割当プールの最大サイズをバイト数で指定します。指定する値は、2MBより大きい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」を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/gc\-ergonomics.htmlを参照してください。 +.br .br 例: .nf @@ -377,52 +397,139 @@ .fl \fP .fi -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 -実行中のプログラムのプロファイルを生成し、プロファイルデータを標準出力に出力します。このオプションは、プログラム開発用のユーティリティーとして提供されています。 本番稼動システムでの使用を目的としたものではありません。 +実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に出力します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 .TP 3 \-Xrs -Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの使用を減らします。 -.LP -以前のリリースでは、Java アプリケーションを秩序正しくシャットダウンするためのシャットダウンフック機能が追加されました。この機能により、JVM が突然終了した場合でも、シャットダウン時にユーザークリーンアップコード (データベース接続のクローズなど) を実行できるようになりました。 -.LP -Sun の JVM は、シグナルをキャッチすることによって、JVM の異常終了のためのシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、および SIGTERM を使用して、シャットダウンフックの実行を開始します。 -.LP -JVM は、デバッグの目的でスレッドスタックをダンプするという、1.2 より前からある機能を実現するためにも、同様の機構を使用します。Sun の JVM は、スレッドダンプを実行するために SIGQUIT を使用します。 -.LP -JVM を埋め込んでいるアプリケーションが SIGINT や SIGTERM などのシグナルを頻繁にトラップする必要があると、JVM そのもののシグナルハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fP コマンド行オプションを使用すると、この問題に対処できます。Sun の JVM に対して \f3\-Xrs\fP を使用すると、SIGINT、SIGTERM、SIGHUP、および SIGQUIT に対するシグナルマスクは JVM によって変更されず、これらのシグナルに対するシグナルハンドラはインストールされません。 -.LP -\f3\-Xrs\fP を指定した場合、次の 2 つの影響があります。 +Java仮想マシン(JVM)によるオペレーティング・システム・シグナルの使用を減らします。 +.br +.br +以前のリリースでは、Javaアプリケーションを秩序正しくシャットダウンするためのシャットダウン・フック機能が追加されました。この機能により、JVMが突然終了した場合でも、シャットダウン時にユーザー・クリーン・アップコード(データベース接続のクローズなど)を実行できるようになりました。 +.br +.br +Sun社のJVMは、シグナルをキャッチすることによって、JVMの異常終了のためのシャットダウン・フックを実装します。JVMは、SIGHUP、SIGINTおよびSIGTERMを使用して、シャットダウン・フックの実行を開始します。 +.br +.br +JVMは、デバッグの目的でスレッド・スタックをダンプするという、1.2より前からある機能を実現するためにも、同様の機構を使用します。Sun社のJVMは、スレッド・ダンプを実行するためにSIGQUITを使用します。 +.br +.br +JVMを埋め込んでいるアプリケーションがSIGINTやSIGTERMなどのシグナルを頻繁にトラップする必要があると、JVMそのもののシグナル・ハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fPコマンドライン・オプションを使用すると、この問題に対処できます。Sun社のJVMに対して\f3\-Xrs\fPを使用すると、SIGINT、SIGTERM、SIGHUPおよびSIGQUITに対するシグナル・マスクはJVMによって変更されず、これらのシグナルに対するシグナル・ハンドラはインストールされません。 +.br +.br +\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:AllocationPrefetchStyle=n +割当中に使用されるプリフェッチのスタイルを設定します。デフォルトは2です。 +.br +.TP 3 +\-XX:+AggressiveOpts +積極的な最適化を有効にします。 +.br +.TP 3 +\-XX:+|\-DisableAttachMechanism +このオプションは、ツール(\f2jmap\fPおよび\f2jconsole\fPなど)がJVMに接続できるかどうかを指定します。デフォルトでは、この機能は無効になっています。つまり、接続は有効です。使用例: +.nf +\f3 +.fl + java \-XX:+DisableAttachMechanism +.fl +\fP +.fi +.TP 3 +\-XXLargePageSizeInBytes=n +このオプションは、ラージ・ページの最大サイズを指定します。 +.TP 3 +\-XX:MaxGCPauseMillis=n +最大GC休止時間のターゲットを設定します。 +.br +これはソフト・ゴールのため、JVMは実現のために最善の努力をします。 +.TP 3 +\-XX:NewSize +若い世代(ナーサリ)のサイズを設定します。\f3\-Xmn\fP\f4size\fPと同じです。 +.TP 3 +\-XX:ParallelGCThreads=n +パラレル・コレクタ内のGCスレッドの数を設定します。 +.br +.TP 3 +\-XX:PredictedClassLoadCount=n +このオプションでは、最初に\f3UnlockExperimentalVMOptions\fPフラグを設定する必要があります。アプリケーションが多数のクラスをロードする場合で、特に\f3class.forName()\fPが頻繁に使用される場合は\f3PredictedClassLoadCount\fPフラグを使用します。推奨値は、\f3\-verbose:class\fPからの出力に示されているロード済クラスの数です。 +.br +使用例: +.nf +\f3 +.fl + java \-XX:+UnlockExperimentalVMOptions \-XX:PredictedClassLoadCount=60013 +.fl +\fP +.fi +.TP 3 +\-XX:+PrintCompilation +HotSpotダイナミック・ランタイム・コンパイラからの詳細出力を印刷します。 +.br +.TP 3 +\-XX:+PrintGCDetails \-XX:+PrintGCTimeStamps +ガベージ・コレクション出力をタイムスタンプとともに印刷します。 +.br +.TP 3 +\-XX:SoftRefLRUPolicyMSPerMB=0 +このフラグは、ソフトウェア参照の積極的処理を有効にします。このフラグは、HotSpot GCがソフトウェア参照カウントの影響を受ける場合に使用します。 +.TP 3 +\-XX:TLABSize=n +スレッド・ローカル割当バッファ(TLAB)がHotSpotでデフォルトで有効になっています。HotSpotでは、TLABのサイズを割当パターンに基づいて自動的に決定します。\f3\-XX:TLABSize\fPオプションでTLABのサイズを微調整できます。 +.br +.TP 3 +\-XX:+UnlockCommercialFeatures +このフラグは、商用機能の使用を能動的にロック解除する場合に使用します。商用機能とは、 +.na +\f2Oracle Java SE Products Webページ\fP @ +.fi +http://www.oracle.com/technetwork/java/javase/terms/products/index.htmlで規定される製品"Oracle Java SE Advanced"または"Oracle Java SE Suite"です。 +.br +このフラグが指定されていない場合、デフォルトはJava仮想マシンを使用可能な商用機能なしで実行することです。いったん商用機能を有効にすると、実行時にその使用を無効にすることはできません。 .TP 3 \-XX:+UseAltSigs -VM ではデフォルトで \f2SIGUSR1\fP および \f2SIGUSR2\fP を使用しますが、\f2SIGUSR1\fP および \f2SIGUSR2\fP をシグナル連鎖するアプリケーションと 競合する場合があります。\f2\-XX:+UseAltSigs\fP オプションは、VM にデフォルトとして \f2SIGUSR1\fP と \f2SIGUSR2\fP 以外のシグナルを使用させます。 -.RE - +VMではデフォルトで\f2SIGUSR1\fPおよび\f2SIGUSR2\fPを使用しますが、\f2SIGUSR1\fPおよび\f2SIGUSR2\fPをシグナル連鎖するアプリケーションと競合する場合があります。\f2\-XX:+UseAltSigs\fPオプションは、VMにデフォルトとして\f2SIGUSR1\fPと\f2SIGUSR2\fP以外のシグナルを使用させます。 +.TP 3 +\-XX:+|\-UseCompressedOops +64ビットJVMで圧縮参照を有効にします。 +.br +このオプションはデフォルトでtrueです。 +.br +.TP 3 +\-XX:+UseConcMarkSweepGCまたは\-XX:+UseG1GC +これらのフラグはConcurrent Mark Sweep (CMS)またはG1ガベージ・コレクションを有効にします。 +.br +.TP 3 +\-XX:+|\-UseLargePages +このフラグは、ラージ・ページ・サポートを有効にする場合に使用します。ラージ・ページは、Solarisではデフォルトで有効になっています。 +.br +.TP 3 +\-XX:+UseParallelOldGC +パラレル・ガベージ・コレクタを有効にします。これはスループットおよび平均レスポンス時間に対して最適化されます。 +.br +.SH "注意" .LP -.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 @@ -430,10 +537,10 @@ .fl \fP .fi -この場合、 \f21.6.0_10\fP よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。 +この場合、\f21.6.0_10\fPよりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された(あるいはそのバグが修正された)場合に便利です。 .TP 3 3. -ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。 +ある特定のバージョンIDよりも大きいバージョンで、そのリリース・ファミリの上限によって制限されるもの。次に例を示します。 .nf \f3 .fl @@ -443,7 +550,7 @@ .fi .TP 3 4. -上の項目 2 と項目 3 の「OR」式。次に例を示します。 +上の項目2と項目3の「OR」式。次に例を示します。 .nf \f3 .fl @@ -451,27 +558,20 @@ .fl \fP .fi -これは項目 2 に似ていますが、ある変更が特定のリリース (1.7) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。 +これは項目2に似ていますが、ある変更が特定のリリース(1.7)で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。 .RE - +.SH "終了ステータス" .LP -.SH "終了ステータス" -.LP -.LP -一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいは Java 仮想マシンから例外がスローされた場合です。ただし Java アプリケーションは、API 呼び出し \f2System.exit(exitValue)\fP を使用して任意の値を返すことを選択することもできます。 -.LP +一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJava仮想マシンから例外がスローされた場合です。ただしJavaアプリケーションは、API呼出し\f2System.exit(exitValue)\fPを使用して任意の値を返すことを選択することもできます。 .RS 3 .TP 2 o \f20\fP: 正常終了 .TP 2 o -\f2>0\fP: エラーが発生した +\f2>0\fP: エラー発生 .RE - -.LP -.SH "関連項目" -.LP +.SH "関連項目" .RS 3 .TP 2 o @@ -488,22 +588,23 @@ .TP 2 o .na -\f2「Java 拡張機能フレームワーク」\fP @ +\f2Java拡張機能フレームワーク\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html +http://download.oracle.com/javase/7/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 +http://download.oracle.com/javase/7/docs/technotes/guides/security/index.html .TP 2 o .na -\f2「HotSpot VM Specific Options」\fP @ +\f2HotSpot VM Specific Options\fP @ .fi http://java.sun.com/docs/hotspot/VMOptions.html .RE +.RE .LP
--- a/src/linux/doc/man/ja/javac.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/javac.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javac 1 "07 May 2011" +.TH javac 1 "21 Mar 2012" .LP .SH "名前" -javac \- Java プログラミング言語コンパイラ +javac \- Javaプログラミング言語コンパイラ .LP .RS 3 .TP 2 @@ -37,7 +37,7 @@ オプション .TP 2 o -コマンド行引数ファイル +コマンドライン引数ファイル .TP 2 o 注釈処理 @@ -46,7 +46,7 @@ 型の検索 .TP 2 o -プログラマティックインタフェース +プログラマティック・インタフェース .TP 2 o 例 @@ -74,53 +74,53 @@ .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 .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 .LP -コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。 +コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fPで始まります。 .LP .SS 標準オプション @@ -128,124 +128,131 @@ .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 のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、「クラスパスの設定」を参照してください。 -.LP -\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。 -.LP -\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。 +\-cppathまたは\-classpathpath +ユーザーのクラス・ファイルおよび(場合によっては)注釈プロセッサやソース・ファイルの検索場所を指定します。このクラス・パスは\f3CLASSPATH\fP環境変数のユーザー・クラス・パスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fPのいずれも指定されていない場合、ユーザー・クラス・パスは、現在のディレクトリになります。詳細は、クラス・パスの設定を参照してください。 +.br +.br +\f3\-sourcepath\fPオプションが指定されていない場合は、ソース・ファイルもユーザー・クラス・パスから検索されます。 +.br +.br +\f3\-processorpath\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 になります。 -.LP -\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。 -.LP -\f3注:\fP \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。 +クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。\f3javac\fPでは作成されません。クラスがパッケージの一部である場合、\f3javac\fPは、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラス・ファイルを格納します。たとえば、\f3\-d/home/myclasses\fPと指定し、クラスの名前が\f2com.mypackage.MyClass\fPである場合、クラス・ファイルは\f2/home/myclasses/com/mypackage/MyClass.class\fPになります。 +.br +.br +\f3\-d\fPが指定されなかった場合、\f3javac\fPは各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 +.br +.br +\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 や UTF\-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 プラットフォームに実装されたブートストラップクラスや拡張機能クラスに対してコンパイルを行う) を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細は、「クロスコンパイルオプション」を参照してください。 +\f2ext\fPディレクトリの位置をオーバーライドします。\f2directories\fP変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARアーカイブから、クラス・ファイルが検索されます。見つかったすべてのJARアーカイブは自動的にクラス・パスの一部になります。 +.br +.br +クロスコンパイル(異なる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 起動ツールに渡してください。 +\f3javac\fPが呼び出す\f3java\fP起動ツールに、\f2option\fPを渡します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。\f3\-J\fPを使用して、Javaで記述されたアプリケーションを実行する背後のVMにオプションを渡すことは、よく行われています。 +.br +.br +\f3注意:\fP \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fPおよび\f3\-extdirs\fPは、\f3javac\fPを実行するために使用するクラスを指定するものでは\f2ありません\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 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +このコンパイラでは、Java SE 1.3以降に導入されたアサーション、総称または他の言語機能をサポート\f2しません\fP。 .TP 3 1.4 -JDK 1.4 で導入された、アサーションを含むコードを受け付けます。 +Java SE 1.4で導入された、アサーションを含むコードを受け付けます。 .TP 3 1.5 -JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。 +Java SE 5で導入された総称および他の言語機能を含んだコードを受け付けます。 .TP 3 5 -1.5 と同義です。 +1.5と同義です。 .TP 3 1.6 -これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。 +Java SE 6では言語に対する変更は導入されませんでした。しかし、ソース・ファイル内のエンコーディング・エラーが、Java SE以前のような「警告」ではなく、「エラー」として報告されるようになりました。 .TP 3 6 -1.6 と同義です。 +1.6と同義です。 .TP 3 1.7 -JDK 7 で導入された機能を含むコードを受け付けます。 +これがデフォルト値です。Java SE 7で導入された機能を含むコードを受け付けます。 .TP 3 7 -1.7 と同義です。 +1.7と同義です。 .RE .TP 3 \-sourcepath sourcepath -クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。 -.LP -\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。 +クラスまたはインタフェースの定義を検索するソース・コード・パスを指定します。ユーザー・クラス・パスと同様に、ソース・パスの複数のエントリはコロン(\f3:\fP)で区切ります。ソース・パスのエントリには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。パッケージを使用している場合は、ディレクトリまたはアーカイブ内のローカル・パス名がパッケージ名を反映している必要があります。 +.br +.br +\f3注意:\fP クラス・パスからクラスのみでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。型の検索を参照してください。 .TP 3 \-verbose -詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。 +詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソース・ファイルごとの情報が出力されます。 .TP 3 \-version バージョン情報を出力します。 @@ -259,34 +266,40 @@ .LP .SS -クロスコンパイルオプション +クロスコンパイル・オプション .LP .LP -デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。 +デフォルトでは、クラスのコンパイルは、\f3javac\fPが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fPは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行う「\f2クロスコンパイル\fP」もサポートしています。クロスコンパイルを行う場合は、\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 も可)、および \f31.7\fP (\f37\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.7\fP になります。 +\-sourceが\f3指定されなかった\fP場合、\-targetの値は\f31.7\fPになります。 +.TP 2 +o +\-sourceが\f31.2\fPの場合、\-targetの値は\f31.4\fPになります。 .TP 2 o -\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。 +\-sourceが\f31.3\fPの場合、\-targetの値は\f31.4\fPになります。 .TP 2 o -\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。 +\-sourceが\f31.5\fPの場合、\-targetの値は\f31.7\fPになります。 .TP 2 o -\-source が\f3それ以外の値の場合はすべて\fP、\f3\\\-target\fP の値は \f3\-source\fP の値になります。 +\-sourceが\f31.6\fPの場合、\-targetの値は\f31.7\fPになります。 +.TP 2 +o +\-sourceが\f3それ以外の値の場合はすべて\fP、\f3\-target\fPの値は\f3\-source\fPの値になります。 .RE .TP 3 \-bootclasspath bootclasspath -指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。 +指定された一連のブート・クラスに対してクロスコンパイルを行います。ユーザー・クラス・パスと同様に、ブート・クラス・パスの複数のエントリはコロン(\f3:\fP)で区切ります。ブート・クラス・パスのエントリには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。 .RE .LP @@ -296,28 +309,28 @@ .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 すべての警告を無効にします。 .TP 3 \-Xlint:name -警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 +警告\f2name\fPを有効にします。このオプションで有効にできる警告のリストについては、\-Xlintオプションを使用して有効または無効にできる警告を参照してください。 .TP 3 \-Xlint:\-name -警告 \f2name\fP を無効にします。このオプションで無効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 +警告\f2name\fPを無効にします。このオプションで無効にできる警告のリストについては、\-Xlintオプションを使用して有効または無効にできる警告を参照してください。 .TP 3 \-Xmaxerrs number 印刷するエラーの最大数を設定します。 @@ -326,10 +339,10 @@ 印刷する警告の最大数を設定します。 .TP 3 \-Xstdout filename -コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。 +コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは\f2System.err\fPに送られます。 .TP 3 \-Xprefer:{newer,source} -ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。SOURCE の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fP \f2を使用してください\fP。 +ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します(型の検索を参照)。\f2\-Xprefer:newer\fPを使用した場合、ある型に対するソース・ファイルとクラス・ファイルの新しい方が読み取られます(デフォルト)。\f2\-Xprefer:source\fPオプションを使用した場合、ソース・ファイルが読み取られます。\f2SOURCE\fPの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fPを使用してください。 .TP 3 \-Xpkginfo:{always,legacy,nonempty} パッケージ情報ファイルの処理を指定します。 @@ -346,10 +359,10 @@ .LP .SS -\-Xlint オプションを使って有効または無効にできる警告 +\-Xlintオプションを使用して有効または無効にできる警告 .LP .LP -\f3\-Xlint:\fP\f2name\fP オプションを使って警告 \f2name\fP を有効にします。ただし、\f2name\fP は次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fP オプションを使って警告 \f2name\fP を無効にできます。 +\f3\-Xlint:\fP\f2name\fPオプションを使用して警告\f2name\fPを有効にします。ただし、\f2name\fPは次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fPオプションを使用して警告\f2name\fPを無効にできます。 .LP .RS 3 .TP 3 @@ -364,7 +377,7 @@ .fi .TP 3 classfile -クラスファイルの内容に関連した問題について警告します。 +クラス・ファイルの内容に関連した問題について警告します。 .TP 3 deprecation 非推奨項目の使用について警告します。次に例を示します。 @@ -377,11 +390,10 @@ .fl \fP .fi -.LP -メソッド \f2java.util.Date.getDay\fP は JDK 1.1 以降は推奨されていません。 +メソッド\f2java.util.Date.getDay\fPはJDK 1.1以降は推奨されていません。 .TP 3 dep\-ann -\f2@deprecated\fP Javadoc コメントでドキュメント化されているが、 \f2@Deprecated\fP 注釈が付いていない項目について警告します。次に例を示します。 +\f2@deprecated\fP Javadocコメントでドキュメント化されているが、\f2@Deprecated\fP注釈が付いていない項目について警告します。次に例を示します。 .nf \f3 .fl @@ -403,7 +415,7 @@ .fi .TP 3 divzero -一定の整数 0 で除算されることについて警告します。次に例を示します。 +定整数0で除算されることについて警告します。次に例を示します。 .nf \f3 .fl @@ -413,7 +425,7 @@ .fi .TP 3 empty -\f2if\fP 文以降が空の文であることについて警告します。次に例を示します。 +\f2if\fP文以降が空の文であることについて警告します。次に例を示します。 .nf \f3 .fl @@ -431,7 +443,7 @@ .fi .TP 3 fallthrough -fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。 +fall\-throughケースの\f2switch\fPブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-throughケースは、\f2switch\fPブロック内の最後のケースを除くケースです。このコードには\f2break\fP文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この\f2switch\fPブロック内の\f2case 1\fPラベルに続くコードは、\f2break\fP文で終わっていません。 .nf \f3 .fl @@ -451,11 +463,10 @@ .fl \fP .fi -.LP -このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。 +このコードのコンパイル時に\f2\-Xlint:fallthrough\fPフラグが使用されていた場合、コンパイラは当該ケースの行番号とともに、fall\-throughケースの可能性があることを示す警告を発行します。 .TP 3 finally -正常に完了できない \f2finally\fP 節について警告します。次に例を示します。 +正常に完了できない\f2finally\fP節について警告します。次に例を示します。 .nf \f3 .fl @@ -481,14 +492,13 @@ .fl \fP .fi -.LP -この例では、コンパイラは \f2finally\fP ブロックに関する警告を生成します。このメソッドが呼び出されると、値 1 ではなく \f20\fP が \f2返されます\fP。 \f2finally\fP ブロックは、 \f2try\fP ブロックが終了すると必ず実行されます。この例では、制御が \f2catch\fP に移された場合、メソッドは終了します。ただし、 \f2finally\fP ブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。 +この例では、コンパイラは\f2finally\fPブロックに関する警告を生成します。このメソッドが呼び出されると、値\f21\fPではなく\f20\fPが返されます。\f2finally\fPブロックは、\f2try\fPブロックが終了すると必ず実行されます。この例では、制御が\f2catch\fPに移された場合、メソッドは終了します。ただし、\f2finally\fPブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。 .TP 3 options -コマンド行オプションの使用に関する問題について警告します。この種の警告の例については、「クロスコンパイルの例」を参照してください。 +コマンドライン・オプションの使用に関する問題について警告します。この種の警告の例については、クロスコンパイルの例を参照してください。 .TP 3 overrides -メソッドのオーバーライドに関する問題について警告します。たとえば、次の 2 つのクラスがあるとします。 +メソッドのオーバーライドに関する問題について警告します。たとえば、次の2つのクラスがあるとします。 .nf \f3 .fl @@ -513,20 +523,16 @@ .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 の仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 +コンパイラは次のような警告を生成します。 +.br +.br +\f2warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod overrides varargsMethod(String...) in ClassWithVarargsMethod; overriding method is missing '...'\fP +.br +.br +コンパイラは、varargsメソッドを検出すると、varargsの仮パラメータを配列に変換します。メソッド\f2ClassWithVarargsMethod.varargsMethod\fPでは、コンパイラはvarargsの仮パラメータ\f2String... s\fPを仮パラメータ\f2String[] s\fPに変換します。String[] sは、メソッド\f2ClassWithOverridingMethod.varargsMethod\fPの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 .TP 3 path -コマンド行での無効なパス要素と存在しないパスディレクトリについて警告します (クラスパス、ソースパスなどのパス関連)。このような警告を \f2@SuppressWarnings\fP 注釈で抑制することはできません。次に例を示します。 +コマンドラインでの無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\f2@SuppressWarnings\fP注釈で抑制することはできません。次に例を示します。 .nf \f3 .fl @@ -536,9 +542,10 @@ .fi .TP 3 processing -注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでその型の例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。 -.LP -\f3ソースファイル \fP\f4AnnoProc.java\fP: +注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでそのタイプの例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。 +.br +.br +\f3ソース・ファイル\fP\f4AnnoProc.java\fP: .nf \f3 .fl @@ -574,8 +581,7 @@ .fl \fP .fi -.LP -\f3ソースファイル \fP\f4AnnosWithoutProcessors.java\fP\f3:\fP +\f3ソース・ファイル\fP\f4AnnosWithoutProcessors.java\fP\f3:\fP .nf \f3 .fl @@ -589,31 +595,25 @@ .fl \fP .fi -.LP -次のコマンドは、注釈プロセッサ \f2AnnoProc\fP をコンパイルし、この注釈プロセッサをソースファイル \f2AnnosWithoutProcessors.java\fP に対して実行します。 +次のコマンドは、注釈プロセッサ\f2AnnoProc\fPをコンパイルし、この注釈プロセッサをソース・ファイル\f2AnnosWithoutProcessors.java\fPに対して実行します。 .nf \f3 .fl -% javac AnnoProc.java +% \fP\f3javac AnnoProc.java\fP .fl -% javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java +% \f3javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java\fP .fl -\fP .fi -.LP -コンパイラがソースファイル \f2AnnosWithoutProcessors.java\fP に対して注釈プロセッサを実行すると、次の警告が生成されます。 -.nf -\f3 -.fl -warning: [processing] No processor claimed any of these annotations: Anno -.fl -\fP -.fi -.LP -この問題を解決するには、クラス \f2AnnosWithoutProcessors\fP で定義および使用される注釈の名前を \f2Anno\fP から \f2NotAnno\fP に変更します。 +コンパイラがソース・ファイル\f2AnnosWithoutProcessors.java\fPに対して注釈プロセッサを実行すると、次の警告が生成されます。 +.br +.br +\f2warning: [processing] No processor claimed any of these annotations: Anno\fP +.br +.br +この問題を解決するには、クラス\f2AnnosWithoutProcessors\fPで定義および使用される注釈の名前を\f2Anno\fPから\f2NotAnno\fPに変更します。 .TP 3 rawtypes -raw 型に対する未検査操作について警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。 +raw型に対する未検査操作について警告します。次の文では、\f2rawtypes\fP警告が生成されます。 .nf \f3 .fl @@ -621,8 +621,7 @@ .fl \fP .fi -.LP -次の文では、 \f2rawtypes\fP 警告は生成されません。 +次の文では、\f2rawtypes\fP警告は生成されません。 .nf \f3 .fl @@ -630,11 +629,10 @@ .fl \fP .fi -.LP -\f2List\fP は raw 型です。ただし、 \f2List<?>\fP はアンバウンド形式のワイルドカードのパラメータ化された型です。 \f2List\fP はパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、 \f2List\fP の仮引数はアンバウンド形式のワイルドカード (\f2?\fP) を使ってその仮型パラメータとして指定されます。つまり、 \f2countElements\fP メソッドは \f2List\fP インタフェースのどのインスタンス化も受け付けることができます。 +\f2List\fPはraw型です。ただし、\f2List<?>\fPはアンバウンド形式のワイルドカードのパラメータ化された型です。\f2List\fPはパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、\f2List\fPの仮引数はアンバウンド形式のワイルドカード(\f2?\fP)を使用してその仮型パラメータとして指定されます。つまり、\f2countElements\fPメソッドは\f2List\fPインタフェースのどのインスタンス化も受け付けることができます。 .TP 3 serial -直列化可能クラスに \f2serialVersionUID\fP 定義がないことを警告します。次に例を示します。 +直列化可能クラスに\f2serialVersionUID\fP定義がないことを警告します。次に例を示します。 .nf \f3 .fl @@ -664,20 +662,16 @@ .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 値を明示的に宣言する必要があります。 +コンパイラは次の警告を生成します。 +.br +.br +\f2warning: [serial] serializable class PersistentTime has no definition of serialVersionUID\fP +.br +.br +直列化可能クラスが\f2serialVersionUID\fPという名前のフィールドを明示的に宣言しない場合、直列化ランタイムは「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\f2serialVersionUID\fPのデフォルト値を計算します。ただし、すべての直列化可能クラスが\f2serialVersionUID\fP値を明示的に宣言することを強くお薦めします。 これは、\f2serialVersionUID\fP値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、直列化復元中に予期しない\f2InvalidClassExceptions\fPが発生する可能性があるためです。したがって、Javaコンパイラの実装が異なっても\f2serialVersionUID\fP値の一貫性を確保にするには、直列化可能クラスが\f2serialVersionUID\fP値を明示的に宣言する必要があります。 .TP 3 static -static の使用に関する問題について警告します。次に例を示します。 +staticの使用に関する問題について警告します。次に例を示します。 .nf \f3 .fl @@ -691,7 +685,6 @@ .fl \fP .fi -.LP コンパイラは次の警告を生成します。 .nf \f3 @@ -700,8 +693,7 @@ .fl \fP .fi -.LP -この問題を解決するために、次のように static メソッド \f2m1\fP を呼び出すことができます。 +この問題を解決するために、次のようにstaticメソッド\f2m1\fPを呼び出すことができます。 .nf \f3 .fl @@ -709,11 +701,10 @@ .fl \fP .fi -.LP -あるいは、 \f2static\fP キーワードをメソッド \f2m1\fP の宣言から削除することもできます。 +あるいは、\f2static\fPキーワードをメソッド\f2m1\fPの宣言から削除することもできます。 .TP 3 try -try\-with\-resources 文を含む、 \f2try\fP ブロックの使用に関する問題について警告します。たとえば、try 文で宣言されたリソース \f2ac\fP が使用されないために、 \f2次の文に対して警告が\fP 生成されます。 +try\-with\-resources文を含む、\f2try\fPブロックの使用に関する問題について警告します。たとえば、\f2try\fP文で宣言されたリソース\f2ac\fPが使用されないために、次の文に対して警告が生成されます。 .nf \f3 .fl @@ -727,7 +718,7 @@ .fi .TP 3 unchecked -Java 言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。 +Java言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。 .nf \f3 .fl @@ -737,15 +728,16 @@ .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に代入することを許可します。 +型の消去中に、型\f2ArrayList<Number>\fPおよび\f2List<String>\fPはそれぞれ\f2ArrayList\fPおよび\f2List\fPになります。 +.br +.br +変数\f2ls\fPにはパラメータ化された型\f2List<String>\fPが指定されています。\f2l\fPによって参照される\f2List\fPが\f2ls\fPに代入されると、コンパイラは未検査警告を生成します。コンパイラは\f2l\fPが\f2List<String>\fP型を参照するかどうかをコンパイル時に判断できません。また、JVMが実行時にそれを判断できないことも認識しています。lはList<String>型を参照しません。その結果、ヒープ汚染が発生します。 +.br +.br +詳しく説明すると、ヒープ汚染状態が発生するのは、\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 varargs -可変引数 (varargs) メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。 +可変引数(varargs)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。 .nf \f3 .fl @@ -765,8 +757,7 @@ .fl \fP .fi -.LP -コンパイラは、メソッド \f2ArrayBuilder.addToList\fP の定義に関する次の警告を生成します。 +コンパイラは、メソッド\f2ArrayBuilder.addToList\fPの定義に関する次の警告を生成します。 .nf \f3 .fl @@ -774,30 +765,29 @@ .fl \fP .fi -.LP -コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。しかし、Java プログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド \f2ArrayBuilder.addToList\fP では、コンパイラは varargs の仮パラメータ \f2T... elements\fP を仮パラメータ \f2T[] elements\fP(配列) に変換します。しかし、型消去のために、コンパイラは varargs の仮パラメータを \f2Object[] elements\fP に変換します。その結果、ヒープ汚染が発生する可能性があります。 +コンパイラは、varargsメソッドを検出すると、varargsの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\f2ArrayBuilder.addToList\fPでは、コンパイラはvarargsの仮パラメータ\f2T... elements\fPを仮パラメータ\f2T[] elements\fP(配列)に変換します。しかし、型消去のために、コンパイラはvarargsの仮パラメータを\f2Object[] elements\fPに変換します。その結果、ヒープ汚染が発生する可能性があります。 .RE .LP -.SH "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP .LP -javac のコマンド行を短くしたり簡潔にしたりするために、 \f2javac\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。 +javacのコマンドラインを短くしたり簡潔にしたりするために、\f2javac\fPコマンドに対する引数(\f2\-J\fPオプションを除く)を含む1つ以上のファイルを指定することができます。この方法を使用すると、どのオペレーティング・システム上でも、任意の長さのjavacコマンドを作成できます。 .LP .LP -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 +引数ファイルには、javacのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 .LP .LP -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード(*)は使用できません。たとえば、\f2*.java\fPとは指定できません。引数ファイル内の引数で\f2@\fP文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fPオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .LP .LP -javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +javacを実行するときに、各引数ファイルのパスとファイル名の先頭に\f2@\fP文字を付けて渡します。javacは、\f2@\fP文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .LP .SS -引数ファイルを 1 つ指定する例 +引数ファイルを1つ指定する例 .LP .LP -\f2「argfile」という名前の引数ファイルに\fPすべての javac 引数を格納する場合は、次のように指定します。 +「\f2argfile\fP」という名前の引数ファイルにすべてのjavac引数を格納する場合は、次のように指定します。 .LP .nf \f3 @@ -808,16 +798,16 @@ .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 @@ -835,7 +825,7 @@ .LP .LP -以下の内容を含む \f2classes\fP というファイルを作成します。 +次の内容を含む\f2classes\fPというファイルを作成します。 .LP .nf \f3 @@ -853,7 +843,7 @@ .LP .LP -次のコマンドを使用して \f3javac\fP を実行します。 +次のコマンドを使用して\f3javac\fPを実行します。 .LP .nf \f3 @@ -869,7 +859,7 @@ パス付きの引数ファイルの例 .LP .LP -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。 +引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fPや\f2path2\fPから見た相対パスではありません。 .LP .nf \f3 @@ -882,68 +872,68 @@ .SH "注釈処理" .LP .LP -\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。 +\f3javac\fPが注釈処理を直接サポートしているため、独立した注釈処理ツールである\f3apt\fPを使用する必要がなくなりました。 .LP .LP -注釈処理の API は、 \f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。 +注釈処理のAPIは、\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPパッケージとそのサブパッケージ内に定義されています。 .LP .SS 注釈処理の概要 .LP .LP -\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META\-INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。 +\f3\-proc:none\fPオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは\f3\-processorpath\fPオプションを使用して指定できます。検索パスを指定しなかった場合は、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\f2META\-INF/services/javax.annotation.processing.Processor\fPという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\f3\-processor\fPオプションを使用してプロセッサを明示的に指定することもできます。 .LP .LP -コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。 +コンパイラは、コマンドラインのソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。 .LP .LP -いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。 +いずれかのプロセッサによって新しいソース・ファイルが生成されると、注釈処理の2回目のラウンドが開始されます。新しく生成されたすべてのソース・ファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソース・ファイルが生成されなくなるまで続きます。 .LP .LP -あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。 +あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fPオプションが使用されない限り、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 .LP .SS -暗黙的にロードされたソースファイル +暗黙的にロードされたソース・ファイル .LP .LP -コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードすることが必要な場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。 +コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。(型の検索を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソース・ファイルが1つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicitオプションを参照してください。 .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 コマンド行オプションを使って設定します。詳細は、「クラスパスの設定」を参照してください。 +コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを探します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\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 "プログラマティックインタフェース" +.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 @@ -957,19 +947,19 @@ .LP .LP -この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。 +この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンドラインから呼び出された\f3javac\fPが返すのと同じ終了コードが返されます。 .LP .LP -\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。 +\f2javax.tools.JavaCompiler\fPインタフェース上の他のメソッドを使用すると、診断メッセージの処理やファイルの読取り元/書込み先の制御などを行えます。 .LP .SS 旧式のインタフェース .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 @@ -983,16 +973,16 @@ .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 のサブパッケージとして知られる) に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。 +名前が\f2com.sun.tools.javac\fPで始まるパッケージ(非公式には\f2com.sun.tools.javac\fPのサブパッケージとして知られる)に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。 .LP .SH "例" .LP @@ -1000,7 +990,7 @@ 簡単なプログラムのコンパイル .LP .LP -\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。 \f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。 +\f2Hello.java\fPというソース・ファイルで、\f3greetings.Hello\fPという名前のクラスを定義しているとします。\f2greetings\fPディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザー・クラス・パスを使用できます。また、\f3\-d\fPを使用して別の出力先ディレクトリを指定する必要もありません。 .LP .nf \f3 @@ -1051,10 +1041,10 @@ .LP .SS -複数のソースファイルのコンパイル +複数のソース・ファイルのコンパイル .LP .LP -次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。 +次の例では、パッケージ\f2greetings\fP内のすべてのソース・ファイルをコンパイルします。 .LP .nf \f3 @@ -1079,10 +1069,10 @@ .LP .SS -ユーザークラスパスの指定 +ユーザー・クラス・パスの指定 .LP .LP -上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。 +上の例のソース・ファイルのうち1つを変更し、変更後のファイルを再コンパイルするとします。 .LP .nf \f3 @@ -1097,7 +1087,7 @@ .LP .LP -\f2greetings.Hi\fP は、 \f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。 +\f2greetings.Hi\fPは、\f2greetings\fPパッケージ内の他のクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザー・クラス・パスが、パッケージ・ディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。しかし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合を考えてみましょう。そのような場合は、ユーザー・クラス・パスに\f2/examples\fPを追加する必要があります。ユーザー・クラス・パスにエントリを追加するには、\f3CLASSPATH\fPを設定する方法もありますが、ここでは\f3\-classpath\fPオプションを使用します。 .LP .nf \f3 @@ -1108,7 +1098,7 @@ .LP .LP -再度 \f2greetings.Hi\fP を変更してバナーユーティリティーを使うようにした場合は、このバナーユーティリティーもユーザークラスパスを通じてアクセスできるようになっている必要があります。 +再度\f2greetings.Hi\fPを変更してバナー・ユーティリティを使用するようにした場合は、このバナー・ユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 .LP .nf \f3 @@ -1121,7 +1111,7 @@ .LP .LP -\f2greetings\fP 内のクラスを実行するには、 \f2greetings\fP と、それが使うクラスの両方にアクセスできる必要があります。 +\f2greetings\fP内のクラスを実行するには、\f2greetings\fPと、それが使用するクラスの両方にアクセスできる必要があります。 .LP .nf \f3 @@ -1132,10 +1122,10 @@ .LP .SS -ソースファイルとクラスファイルの分離 +ソース・ファイルとクラス・ファイルの分離 .LP .LP -特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。 +特に大規模プロジェクトの場合は、ソース・ファイルとクラス・ファイルを別々のディレクトリに置くと便利なことがあります。クラス・ファイルの出力先を別に指定するには、\f3\-d\fPを使用します。ソース・ファイルはユーザー・クラス・パスにはないので、\f3\-sourcepath\fPを使用して、コンパイラがソース・ファイルを見つけることができるようにします。 .LP .nf \f3 @@ -1174,13 +1164,13 @@ .LP .LP -\f3注:\fP コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。 +\f3注意:\fP コマンドラインでは\f2src/farewells/Base.java\fPを指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fPオプションを使用します。 .LP .SS クロスコンパイルの例 .LP .LP -ここでは、\f3javac\fP を使って、1.6 VM 上で実行するコードをコンパイルします。 +次の例は、1.6 VM上で動作するコードをコンパイルするために\f3javac\fPを使用します。 .LP .nf \f3 @@ -1193,10 +1183,10 @@ .LP .LP -\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 オプションを省略できます。 +\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 -\f3\-bootclasspath\fP オプションを使用して、適切なバージョンのブートストラップクラス ( \f2rt.jar\fP ライブラリ) を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\f3\-bootclasspath\fPオプションを使用して、適切なバージョンのブートストラップ・クラス(\f2rt.jar\fPライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .LP .nf \f3 @@ -1209,7 +1199,7 @@ .LP .LP -適切なバージョンのブートストラップクラスを指定しない場合、コンパイラは古い言語仕様 (この例では、バージョン 1.6 の Java プログラミング言語) を新しいブートストラップクラスと組み合わせて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラスファイルが古いプラットフォーム (この場合は Java SE 6) で動作しない可能性があります。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1.6のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。 .LP .SH "関連項目" .LP @@ -1217,33 +1207,33 @@ .TP 2 o .na -\f2「The javac Guide」\fP @ +\f2javacガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html +http://download.oracle.com/javase/7/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) \- APIドキュメント・ジェネレータ .TP 2 o -「jar(1) \- JAR アーカイブツール」 +jar(1) \- JARアーカイブ・ツール .TP 2 o .na -\f2「Java 拡張機能フレームワーク」\fP @ +\f2Java拡張機能フレームワーク\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/extensions/index.html .RE .LP
--- a/src/linux/doc/man/ja/javadoc.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/javadoc.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,74 +19,74 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javadoc 1 "07 May 2011" +.TH javadoc 1 "21 Mar 2012" .SH "名前" -javadoc \- Java API ドキュメントジェネレータ +javadoc \- Java APIドキュメント・ジェネレータ .LP -Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、 Solaris を使用した場合のものです。 +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 -引数を指定する順序は任意です。Javadoc ツールでの、処理対象の .java ファイルを決定する方法の詳細については、「ソースファイルの処理」\f2を参照\fPしてください。 +引数を指定する順序は任意です。Javadocツールでの、処理対象の\f2.java\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」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです (Java 言語仕様を参照)。したがって、ハイフンを含む名前 ( \f2X\-Buffer\fP など) や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。ソースファイル名の前に指定したパスによって、javadoc がそのファイルを検索する場所が決まります。Javadoc ツールは、これらのソースファイル名を検索するときには \f2\-sourcepath\fP を使用しません。相対パスは現在のディレクトリを起点とするため、 \f2Button.java\fP を渡すことは、 \f2./Button.java\fP を渡すことと同じです。ソースファイル名をフルパスで指定すると、 \f2/home/src/java/awt/Graphics*.java のようになります\fP。 「1 つ以上のクラスのドキュメント化」の例を参照してください。また、「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。 +空白文字で区切られた一連のソース・ファイル名です。各ファイルは、パスで始まります。アスタリスク(*)などのワイルドカードを含めることができます。Javadocツールが処理するのは、ファイル名が「.java」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです(Java言語仕様を参照)。したがって、ハイフンを含む名前(\f2X\-Buffer\fPなど)や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト・ファイルやテンプレート・ファイルの場合に便利です。ソース・ファイル名の前に指定したパスによって、javadocがそのファイルを検索する場所が決まります。(Javadocツールは、これらのソース・ファイル名を検索するときに\f2\-sourcepath\fPを使用\f2しません\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 オプションは、このファイルの中では指定できません。 +Javadocオプション、パッケージ名、およびソース・ファイル名を任意の順序で並べたリストが含まれる1つ以上のファイルです。このファイルの中では、ワイルドカード(*)および\f2\-J\fPオプションは指定できません。 .RE -.SH " 説明" +.SH "説明" .LP -\f3Javadoc\fP ツールは、一連の Java ソースファイルにある宣言およびドキュメンテーションコメントを解析し、デフォルトでは public クラス、protected クラス、入れ子にされたクラス (匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。 +\f3Javadoc\fPツールは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトではpublicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。また、API(アプリケーション・プログラミング・インタフェース)ドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 .LP -Javadoc ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fP を使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々ソースファイルに対して javadoc を実行する場合は、一連のソース (.\f2.java\fP) ファイル名を渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadoc によるソースファイルの処理について説明します。 +Javadocツールは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fPを使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルのドキュメント化を行うには、ソース(.\f2.java\fP)ファイル名のリストを渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadocによるソース・ファイルの処理について説明します。 .SS -ソースファイルの処理 +ソース・ファイルの処理 .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」ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合だけです。 +Javadocツールは、末尾が「\f2.java\fP」のファイル以外に、ソース・ファイルで記述されている他のファイルも処理します。個々のソース・ファイル名を明示的に渡してJavadocツールを実行する場合、どの\f2.java\fPファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、Javadocツールは3つの方法で実行できます。それは、(1)パッケージ名を渡す、(2)\f2\-subpackages\fPを使用する、(3)ソース・ファイル名でワイルドカードを使用する(\f2*.java\fP)、という方法です。これらの場合、Javadocツールが\f2.java\fPファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 .RS 3 .TP 2 o -名前から接尾辞「\f2.java\fP」を取り除くと、実際に有効なクラス名になっている (Java 言語仕様の有効な文字を参照) +接尾辞「\f2.java\fP」を除いた名前が実際に有効なクラス名である場合(有効な文字については、Java言語仕様を参照) .TP 2 o -ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている +ソース・ツリーのルートから相対的なディレクトリ・パスが、区切り文字をドットに変換すると、実際に有効なパッケージ名である場合 .TP 2 o -パッケージ文には有効なパッケージ名が含まれる (前項目で指定) +package文に有効なパッケージ名(前箇条書きで指定)が含まれる場合 .RE .LP -\f3リンクの処理\fP \- Javadoc ツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。 +\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 パッケージおよびクラスの継承ツリー @@ -95,150 +95,150 @@ 索引 .RE .LP -コマンド行で指定しなかったクラスについての既存のテキスト (別に生成したテキスト) に対してハイパーリンクを追加するには、\f2\-link\fP および \f2\-linkoffline\fP オプションを利用できます。 +コマンドラインで指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してハイパーリンクを追加するには、\f2\-link\fPおよび\f2\-linkoffline\fPオプションを利用できます。 .LP -\f3その他の処理についての詳細\fP \- Javadoc ツールは、実行するたびに 1 つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadoc ツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。ただし、前述のように、以前の実行結果に対してリンクを追加することはできます。 +\f3その他の処理についての詳細\fP \- Javadocツールは、実行するたびに1つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadocツールの以前の実行結果を修正したり、その内容を\f2直接\fP組み入れたりすることはできません。ただし、前述のように、他の実行結果にリンクすることはできます。 .LP -実装上の理由から、Javadoc ツールは、処理を実行するために java コンパイラを必要とし、java コンパイラに依存しています。Javadoc ツールは、 \f2javac\fP の一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。Javadoc ツールは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報から HTML を生成します。さらに、Javadoc ツールは、ソースコードのドキュメンテーションコメントから、ユーザーの提供したドキュメントも取得します。 +実装上の理由から、Javadocツールは、ジョブを実行するためにjavaコンパイラを必要とし、javaコンパイラに依存しています。Javadocツールは、\f2javac\fPの一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。これは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報からHTMLを生成します。さらに、Javadocツールは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。 .LP -実際には、Javadoc ツールは、メソッド本体を持たない純粋なスタブファイルであるような \f2.java\fP ソースファイルでも動作します。したがって、API の作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーションコメントを記述して javadoc ツールを実行できます。 +実際には、Javadocツールは、メソッド本体を持たない純粋なスタブ・ファイルである\f2.java\fPソース・ファイルに対しても実行できます。したがって、APIの作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーション・コメントを記述してjavadocツールを実行できます。 .LP -コンパイラに依存することによって、HTML 出力は、実際の実装に正確に対応します。実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。たとえば、Javadoc ツールは、.class ファイルには存在するがソースコードには存在しないデフォルトコンストラクタ (Java 言語仕様を参照) \f2をドキュメント化\fP します。 +コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、Javadocツールは、\f2.class\fPファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタ(Java言語仕様を参照)をドキュメント化します。 .LP -通常、Javadoc ツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、Java 言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。このエラーを検出すると、javac コンパイラは停止しますが、Javadoc ツールは警告を出さずに処理を続行します。Javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、DocCheck ドックレットを使用してください。 +通常、Javadocツールでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、\f2Java言語仕様\fPによると、抽象メソッドを含むクラスは、それ自体を抽象として宣言する必要があります。javacコンパイラはこのエラーを検出すると停止しますが、Javadocツールはこのチェックを行わず、警告を出さずに処理を続行します。Javadocツールはドキュメンテーション・コメントの基本的なチェックを行います。ドキュメンテーション・コメントをより詳しくチェックする必要がある場合は、DocCheckドックレットを使用してください。 .LP -Javadoc ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadoc ツールは、ブートストラップクラス、拡張機能、またはユーザークラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、 +Javadocツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadocツールは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。詳細は、 .na -\f2「クラスの検索方法」\fP @ +\f2クラスの検索方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadoc ツールのクラスパス内に置く必要があります。 +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadocツールのクラス・パス内に置く必要があります。 .SS -Javadoc のドックレット +Javadocのドックレット .LP -Javadoc ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadoc ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。標準ドックレットは、HTML 形式の API ドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTF などの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。 +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 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/index.html .TP 2 o -\f2\-doclet\fP コマンド行オプション +\f2\-doclet\fPコマンドライン・オプション .RE .LP -\f2\-doclet\fP コマンド行オプションでカスタムドックレットが指定されていない場合、Javadoc ツールは、デフォルトの標準ドックレットを使用します。javadoc ツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。 +\f2\-doclet\fPコマンドライン・オプションでカスタム・ドックレットが指定されていない場合、Javadocツールは、デフォルトの標準ドックレットを使用します。javadocツールには、使用されているドックレットに関係なく使用できるコマンドライン・オプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンドライン・オプションが追加されます。どちらのオプションについても、後述のオプションで説明します。 .SS 関連ドキュメントおよびドックレット .RS 3 .TP 2 o .na -\f2Javadoc に施された拡張機能\fP @ +\f2Javadocに施された拡張機能\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc 1.4 で追加された改良点の詳細 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/index.html \- Javadocで追加された改良点の詳細。 .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://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html \- ドキュメンテーションコメントの記述方法に関する Sun の規約 +http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html \- ドキュメンテーション・コメントの記述方法に関するSunの規約。 .TP 2 o .na -\f2Requirements for Writing API Specifications\fP @ +\f2API仕様を記述するための要件\fP @ .fi -http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java SE プラットフォーム仕様を記述する際に使用された標準要件この情報は、ソースファイルのドキュメンテーションコメント形式で 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 Gosling、Bill Joy、Guy Steele 共著) の初版の第 18 章「Documentation Comments」を参照してください。この章は、第 2 版では削除されました。 +http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ドキュメンテーション・コメントのオリジナル仕様については、\f2Java Language Specification\fP (James Gosling、Bill Joy、Guy Steele共著)の初版の第18章、Documentation Commentsを参照してください。(この章は、第2版では削除されました。) .TP 2 o .na -\f2DocCheck ドックレット\fP @ +\f2DocCheckドックレット\fP @ .fi -http://www.oracle.com/technetwork/java/javase/documentation/index\-141437.html \- ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Check ユーティリティーの一部です。 +http://www.oracle.com/technetwork/java/javase/documentation/index\-141437.html \- ソース・ファイル内のドキュメンテーション・コメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Checkユーティリティの一部です。 .TP 2 o .na -\f2MIF ドックレット\fP @ +\f2MIFドックレット\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/ \- MIF、FrameMaker、PDF の書式で API ドキュメントを自動生成します。MIF は Adobe FrameMaker の交換書式です。 +http://java.sun.com/j2se/javadoc/mifdoclet/ \- MIF、FrameMaker、PDFの形式でAPIドキュメントを自動生成します。MIFはAdobe FrameMakerの交換形式です。 .RE .SS 用語 .LP -\f2「ドキュメンテーションコメント」\fP、\f2「doc コメント」\fP、\f2「主説明」\fP、\f2「タグ」\fP、\f2「ブロックタグ」\fP、および\f2「インラインタグ」\fPの用語については、「ドキュメンテーションコメント」で説明します以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。 +\f2ドキュメンテーション・コメント\fP、\f2docコメント\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 コマンドに渡され、アクセス修飾子 (public、protected、package\-private または private) によってフィルタ処理されないようにしなければなりません。ドキュメント化されるクラスは、javadoc ツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。 +ドキュメント化されるクラス(documented classes) +Javadocの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。ドキュメント化するには、ソース・ファイルが使用可能であり、ソース・ファイル名またはパッケージ名をjavadocコマンドに渡す必要があり、アクセス修飾子(public、protected、package\-privateまたはprivate)によってフィルタ処理されないようにする必要があります。ドキュメント化されるクラスは、javadocツールの出力に組み込まれるクラス、つまり\f2包含クラス\fPとも呼ばれます。 .LP .TP 3 -包含クラス (included classes) -ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」と同じ。 +包含クラス(included classes) +Javadocツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。\f2ドキュメント化されるクラス\fPと同じです。 .LP .TP 3 -除外クラス (excluded classes) -ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。 +除外クラス(excluded classes) +Javadocツールの実行によって詳細なドキュメントが生成\f2されない\fPクラスおよびインタフェースのことです。 .LP .TP 3 -参照クラス (referenced classes) -ドキュメント化されるクラスおよびインタフェースの定義 (実装) またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc} タグなどがあります。この定義は +参照クラス(referenced classes) +ドキュメント化されるクラスおよびインタフェースの定義(実装)またはドキュメンテーション・コメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc}タグなどがあります。(この定義は .na \f21.3\fP @ .fi -http://download.oracle.com/javase/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses から変更されています。javadoc ツールを実行するときは、Javadoc のブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。Javadoc ツールは、クラスの存在とそのメンバーの完全指定の名前を判別するのに必要なすべての情報を、.class ファイルから引き出すことができます。 +http://docs.oracle.com/javase/1.3/docs/tooldocs/solaris/javadoc.html#referencedclassesから変更されていることに注意してください。)Javadocツールを実行するときは、Javadocのブート・クラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。(参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。)Javadocツールは、クラスの存在とそのメンバーの完全修飾名を判別するのに必要十分な情報を、.classファイルから引き出すことができます。 .LP .TP 3 -外部参照クラス (external referenced classes) -参照クラスのうち、javadoc ツールの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンド行で Javadoc ツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。たとえば、Javadoc ツールの実行対象が \f2java.awt\fP パッケージのみである場合、 \f2java.lang\fP 内のすべてのクラス ( \f2Object\fPなど) が外部参照クラスになります。外部参照クラスにリンクするには、 \f2\-link\fP および \f2\-linkoffline\fP オプションを使用します。外部参照クラスには、通常そのソースコメントを javadoc ツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。 +外部参照クラス(external referenced classes) +参照クラスのうち、Javadocの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンドラインでJavadocツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、\f2外部参照\fPまたは\f2外部リンク\fPと呼ばれます。たとえば、\f2java.awt\fPパッケージに対してのみJavadocツールを実行した場合、\f2Object\fPなどの\f2java.lang\fP内のすべてのクラスが外部参照クラスになります。外部参照クラスにリンクするには、\f2\-link\fPおよび\f2\-linkoffline\fPオプションを使用します。外部参照クラスには、通常そのソース・コメントをJavadocツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。 .RE -.SH "ソースファイル" +.SH "ソース・ファイル" .LP -Javadoc ツールは 4 種類の異なる「ソース」ファイルから出力を生成します。その 4 種類とは、クラスの Java 言語ソースファイル (\f2.java\fP)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートファイルについても説明します。 +Javadocツールは、4つのタイプの異なる「ソース」ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\f2.java\fP)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 .SS -クラスソースコードファイル +クラス・ソース・コード・ファイル .LP -それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーションコメントを持つことができ、それを \f2.java\fP ファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。 +それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーション・コメントを持つことができ、それを\f2.java\fPファイル内に保持します。ドキュメンテーション・コメントの詳細は、ドキュメンテーション・コメントを参照してください。 .SS -パッケージコメントファイル +パッケージ・コメント・ファイル .LP -それぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 +それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadocツールによって生成されるパッケージの概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 .LP -パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。 +パッケージ・コメント・ファイルを作成する場合、コメントの格納先として、次の2つのファイルのいずれかを選択できます。 .RS 3 .TP 2 o -\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは一般に、package.html よりも推奨されます。 +\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルは一般に、package.htmlよりも推奨されます。 .TP 2 o -\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。 +\f2package.html\fP \- 格納できるのはパッケージ・コメントとJavadocタグのみです。パッケージ注釈は格納できません。 .RE .LP -各パッケージでは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを選択できますが、その両方を選択することはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。 +各パッケージは、\f2package.html\fPファイルまたは\f2package\-info.java\fPファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルを\f2.java\fPファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 .LP -\f4package\-info.java\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントはパッケージ宣言の前に配置します。 +\f4package\-info.java\fP \- このファイルには、次の構造のパッケージ・コメントを格納できます。コメントはパッケージ宣言の前に配置します。 .LP -File: \f2java/applet/package\-info.java\fP +ファイル: \f2java/applet/package\-info.java\fP .nf \f3 .fl @@ -277,90 +277,114 @@ \fP .fi .LP -コメント区切り文字の \f2/**\fP と \f2/*\fP は存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。 +コメント区切り文字の\f2/**\fPと\f2*/\fPは存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。 .LP -\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。 +\f4package.html\fP \- このファイルには、次の構造のパッケージ・コメントを格納できます。コメントは\f2<body>\fP要素内に配置します。 .LP -File: \f2java/applet/package.html\fP +ファイル: \f2java/applet/package.html\fP .nf \f3 .fl -<HTML> <BODY> Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.<p> +<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> .fl The applet framework involves two entities: the applet .fl -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> +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> .fl \fP .fi .LP -これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述しますが、1 つだけ例外があります。それは、このドキュメンテーションコメントには、コメント区切り文字 である \f2/**\fP と \f2*/\fP 、および行頭のアスタリスクを含めてはならない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、 \f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、すべてのブロックタグは、主説明のあとに置かなければなりません。 \f2@see\fP タグをパッケージコメントファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、 +これは単なる通常のHTMLファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージ・コメント・ファイルの内容は、他のすべてのコメントと同様にHTMLで記述しますが、例外が1つあります。それは、このドキュメンテーション・コメントには、コメント区切り文字である\f2/**\fPと\f2*/\fP、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、\f2<body>\fPと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることはできますが、他のドキュメンテーション・コメントと同様、すべてのブロック・タグは、主説明の後に配置する必要があります。\f2@see\fPタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、 .na \f2package.html\fPの例 @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#packagecommentsを参照してください。 .LP -\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。 +\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 @ .fi -http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html) +http://download.oracle.com/javase/7/docs/api/java/applet/package\-summary.htmlを参照)。 .TP 2 o -パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例: +パッケージの概要ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します( .na \f2概要の要約\fP @ .fi -http://java.sun.com/javase/6/docs/api/overview\-summary.html)。文の末尾は、クラスやメンバーの主説明の最初の文の末尾と同じ規則によって判断される +http://download.oracle.com/javase/7/docs/api/overview\-summary.htmlを参照)。文の終わりは、クラスやメンバーの主説明の最初の文の終わりと同じルールによって判断されます。 .RE .SS -概要コメントファイル +概要コメント・ファイル .LP -ドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。 +ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadocツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 .LP -概要コメントファイルを作成するには、ファイルに任意の名前 (通常は \f4overview.html\fP) を付け、それを任意の場所 (通常はソースツリーの最上位) に配置できます。たとえば、 \f2java.applet\fP パッケージのソースファイルが \f2/home/user/src/java/applet\fP ディレクトリに格納されていれば、概要コメントファイルは \f2/home/user/src/overview.html に作成できます\fP。 +概要コメント・ファイルを作成するには、ファイルに任意の名前(通常は\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 文目で、そのドキュメンテーションを公開用または内部用として記述できます。 +異なるパッケージのセットに対してJavadocを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\-privateを指定してJavadocを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 .LP -概要コメントファイルの内容は、前述のパッケージコメントファイルと同様、HTML で記述された 1 つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、 \f2<body>\fP と最初の文の間にタイトルその他のテキストを含めないようにします。概要タグを含めることができます。ほかのドキュメンテーションコメントと同じく、 \f2{@link}\fP などのインラインタグを除くすべてのタグは、主説明のあとに配置する必要があります。 \f2@see\fP タグを追加する場合には、完全修飾名を使用する必要があります。 +概要コメント・ファイルの内容は、前述のパッケージ・コメント・ファイルと同様、HTMLで記述された1つの大きなドキュメンテーション・コメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、コメントを書く場合は、最初の文をアプリケーションまたはパッケージ・セットの概要とし、\f2<body>\fPと最初の文の間にタイトルやその他のテキストを含めないようにします。概要タグを含めることができます。他のドキュメンテーション・コメントと同じく、\f2{@link}\fPなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\f2@see\fPタグを追加する場合には、完全修飾名を使用する必要があります。 .LP -Javadoc ツールの実行時に、\-overview オプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。 +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 @ .fi -http://java.sun.com/javase/6/docs/api/overview\-summary.html) +http://download.oracle.com/javase/7/docs/api/overview\-summary.htmlを参照)。 .TP 2 o -概要ページの先頭に、概要コメントの最初の文をコピーする +概要ページの先頭に、概要コメントの最初の文をコピーします。 .RE .SS その他の未処理のファイル .LP -ソースには、Javadoc ツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。一般に、このようなファイルには、グラフィックファイル、サンプルの Java ソース (.java) およびクラス (.class) ファイル、内容が通常の Java ソースファイルのドキュメンテーションコメントの影響を受けない独立した HTML ファイルなどがあります。 +ソースには、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 つも存在していません。 +未処理のファイルを含めるには、それらのファイルを\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 のドキュメンテーションコメント内のリンクは、次のようになります。 +これらの未処理のファイルへのリンクは、すべてハードコードする必要があります。これは、Javadocツールがそれらのファイルを見ずに、ディレクトリとその内容を宛先にそのままコピーするからです。たとえば、\f2Button.java\fPのドキュメンテーション・コメント内のリンクは、次のようになります。 .nf \f3 .fl @@ -375,15 +399,15 @@ \fP .fi .SS -テストファイルおよびテンプレートファイル +テスト・ファイルおよびテンプレート・ファイル .LP -一部の開発者から、テストファイルおよびテンプレートファイルを対応するソースファイルの近くのソースツリーに保存したいという要望がありました。つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに保存したいということです。 +一部の開発者から、テスト・ファイルおよびテンプレート・ファイルを対応するソース・ファイルの近くのソース・ツリーに保存したいという要望がありました。つまり、これらのソース・ファイルと同じディレクトリまたはサブディレクトリに保存したいということです。 .LP -個別のソースファイル名で明示的に渡して Javadoc ツールを実行する場合は、テストファイルおよびテンプレートファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイルおよびテンプレートファイルが処理されないようにする必要があります。 +個々のソース・ファイル名で明示的に渡してJavadocツールを実行する場合、テスト・ファイルおよびテンプレート・ファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、特定のルールに従って、これらのテスト・ファイルおよびテンプレート・ファイルが処理されないようにする必要があります。 .LP -テストファイルとテンプレートファイルの違いは、テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、テンプレートファイルは、そうではないという点です。ただし、テンプレートファイルも「.java」で終わることができます。 +テスト・ファイルとテンプレート・ファイルの違いは、テスト・ファイルは、有効でコンパイル可能なソース・ファイルであるのに対して、テンプレート・ファイルは、そうではないという点です。ただし、テンプレート・ファイルも「.java」で終わることができます。 .LP -\f3テストファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテストファイルをそのパッケージのソースファイルと同じディレクトリに配置したいと考えています。しかしテストファイルは、名前なしパッケージなど、ソースファイルパッケージとは別のパッケージに属させたいとも考えています (そのため、テストファイルには package ステートメントがないか、またはソースとは別の package ステートメントがある)。このような状況では、コマンド行で指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テストファイルは警告またはエラーを引き起こします。そのようなテストファイルはサブディレクトリに配置する必要があります。たとえば、 \f2com.package1\fP 内のソースファイルに対するテストファイルを追加する場合は次のように、ハイフンを含んでいるためにパッケージ名としては無効であるようなサブディレクトリ内に、それらのファイルを配置します。 +\f3テスト・ファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテスト・ファイルをそのパッケージのソース・ファイルと\f2同じ\fPディレクトリに配置したいと考えています。しかしテスト・ファイルは、名前なしパッケージなど、ソース・ファイル・パッケージとは別のパッケージに属させたいとも考えています(そのため、テスト・ファイルにはpackage文がないか、またはソースとは別のpackage文があります)。このような状況では、コマンドラインで指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テスト・ファイルは警告またはエラーを引き起こします。そのようなテスト・ファイルはサブディレクトリに配置する必要があります。たとえば、\f2com.package1\fP内のソース・ファイルに対するテスト・ファイルを追加する場合は、次のようにハイフンを含んでいるためにパッケージ名としては無効な名前のサブディレクトリ内に配置します。 .nf \f3 .fl @@ -392,184 +416,184 @@ \fP .fi .LP -こうすると、Javadoc ツールでは警告なしで test ディレクトリをスキップします。 +これで、Javadocツールは警告なしでtestディレクトリをスキップします。 .LP -テストファイルに doc コメントが含まれる場合、次のようにワイルドカードを含んだテストソースファイル名で渡してテストファイルのドキュメントを生成するように、Javadoc ツールを別個に実行できるように設定できます。たとえば、 \f2com/package1/test\-files/*.java などです\fP。 +テスト・ファイルにドキュメンテーション・コメントが含まれる場合、Javadocツールの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\f2com/package1/test\-files/*.java\fPなど)で渡してテスト・ファイルのドキュメントを生成するように設定できます。 .LP -\f3ソースファイルのテンプレート\fP \- テンプレートファイルの名前は「.java」で終わることもありますが、テンプレートファイルはコンパイルできません。ソースディレクトリ内に保持したいソースファイルのテンプレートがある場合は、 \f2Buffer\-Template.java\fP のようにハイフンやその他の無効な Java 文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadoc ツールが処理するのは、「.java」接尾辞を除いた名前が 正規のクラス名であるソースファイルだけであるためです (Java 言語仕様の「Identifiers」に関する情報を参照)。 +\f3ソース・ファイルのテンプレート\fP \- テンプレート・ファイルの名前は「.java」で終わることもありますが、テンプレート・ファイルはコンパイルできません。ソース・ディレクトリ内に保持したいソース・ファイルのテンプレートがある場合は、\f2Buffer\-Template.java\fPのようにハイフンやその他の無効なJava文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadocツールが処理するのは、「.java」接尾辞を除いた名前が有効なクラス名であるソース・ファイルのみであるためです(Java言語仕様の識別子に関する情報を参照)。 .SH "生成されるファイル" .LP -デフォルトでは、javadoc ツールは、HTML 形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。それぞれの HTML ページは、個々のファイルに相当します。javadoc が生成するファイルの名前には、クラスやインタフェースの名前にちなんだものと、そうでないもの ( \f2package\-summary.html など\fP) の 2 種類があります。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。 +デフォルトでは、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) +ドキュメント化するクラスまたはインタフェースごとに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 テキストをすべて組み入れます。 +ドキュメント化するパッケージごとに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 フレーム」を参照してください。 +パッケージのセット全体に対して1つの\f3概要ページ\fP(\f2overview\-summary.html\fP)。これは、生成ドキュメントの先頭ページになります。Javadocツールは、\f2\-overview\fPオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。このファイルは、Javadocに複数のパッケージ名を渡した場合にのみ作成されます。詳細は、HTMLフレームを参照してください。 .RE .LP \f3相互参照ページ\fP .RS 3 .TP 2 o -\f3パッケージのセット全体に対して 1 つのクラス階層ページ\fP (\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーションバーの [概要] をクリックしてから、[階層ツリー] をクリックします。 +\f3パッケージのセット全体に対して1つのクラス階層ページ\fP(\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーション・バーの「概要」をクリックしてから、「階層ツリー」をクリックします。 .TP 2 o -\f3パッケージごとに 1 つのクラス階層ページ\fP (\f2package\-tree.html\fP)。これを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、[階層ツリー] をクリックしてそのパッケージの階層を表示させます。 +\f3パッケージごとに1つのクラス階層ページ\fP(\f2package\-tree.html\fP)。このページを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、「階層ツリー」をクリックしてそのパッケージの階層を表示します。 .TP 2 o -\f3パッケージごとに 1 つの [使用] ページ\fP (\f2package\-use.html\fP) と、クラスおよびインタフェースごとに 1 つずつの [使用] ページ (\f2class\-use/\fP\f2クラス名\fP\f2.html\fP)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。クラスまたはインタフェース A を例にして考えると、その [使用] ページには、A のサブクラス、A として宣言されたフィールド、A を返すメソッド、A 型のパラメータを持つメソッドおよびコンストラクタが表示されます。 このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの [使用] リンクをクリックします。 +\f3パッケージごとに1つの「使用」ページ\fP(\f2package\-use.html\fP)と、クラスおよびインタフェースごとに1つずつの「使用」ページ(\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 は、将来の実装では削除される可能性があります。 +\f3非推奨APIページ\fP(\f2deprecated\-list.html\fP)。推奨されない名前がすべてリストされます。(非推奨名は、一般に改良されたために使用が推奨されていないAPIの名前であり、通常、それに置き換わる名前が提示されています。非推奨APIは、将来の実装では削除される可能性があります。) .TP 2 o -\f3定数フィールド値ページ\fP (\f2constant\-values.html\fP)。static フィールドの値用です。 +\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 クラスの完全に直列化されたクラスを生成できます。 +\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オプションの指定\f2なし\fPでJavadocツールを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。 .TP 2 o -\f3索引\fP (\f2index\-*.html\fP)。すべてのクラス、インタフェース、コンストラクタ、フィールド、およびメソッドの名前がアルファベット順に並んでいます。索引は、Unicode を扱えるように国際化されています。1 つのファイルとして生成することも、先頭文字 (英語の場合 A ~ Z) ごとに別々のファイルとして生成することもできます。 +\f3索引\fP(\f2index\-*.html\fP)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引は、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\-Z)ごとに別々のファイルとして生成することもできます。 .RE .LP -\f3サポートファイル\fP +\f3サポート・ファイル\fP .RS 3 .TP 2 o -\f3ヘルプページ\fP (\f2help\-doc.html\fP)。ナビゲーションバーや前述の各ページに関する説明が記載されています。デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供するには、\f2\-helpfile\fP を使用します。 +\f3ヘルプ・ページ\fP(\f2help\-doc.html\fP)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。\f2\-helpfile\fPを使用すると、デフォルトのヘルプ・ファイルに代わる独自のカスタム・ヘルプ・ファイルを提供できます。 .TP 2 o -表示用の HTML フレームを作成する 1 つの \f3index.html ファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。 +表示用のHTMLフレームを作成する1つの\f3index.htmlファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト・コンテンツは含まれていません。 .TP 2 o -複数の\f3フレームファイル\fP (\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTML フレームを表示するときに使用されます。 +複数の\f3フレーム・ファイル\fP(\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTMLフレームを表示するときに使用されます。 .TP 2 o -\f3パッケージリスト\fPファイル (\f2package\-list\fP)。 \f2\-link\fP および \f2\-linkoffline\fP オプションで使用されます。これは、HTML ファイルではなくテキストファイルであり、どのリンクからもアクセスできません。 +\f3パッケージ・リスト\fPファイル(\f2package\-list\fP)。\f2\-link\fPおよび\f2\-linkoffline\fPオプションで使用されます。これは、HTMLファイルではなくテキスト・ファイルであり、どのリンクからもアクセスできません。 .TP 2 o -\f3スタイルシート\fPファイル (\f2stylesheet.css\fP)。生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。 +\f3スタイルシート\fP・ファイル(\f2stylesheet.css\fP)。生成されるページの一部の要素について色、フォント・ファミリ、フォント・サイズ、フォント・スタイル、および配置を制御します。 .TP 2 o -\f3doc\-files\fP ディレクトリ。生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。これらのファイルは、Javadoc ツールによって処理されないため、ファイル内に javadoc タグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。 +\f3doc\-files\fPディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルがすべて格納されます。これらのファイルは、いかなる方法でもJavadocツールによって処理されません。つまり、ファイル内にjavadocタグがあっても無視されます。このディレクトリは、ソース・ツリーの中に存在する場合にのみ生成されます。 .RE .LP -\f3HTML フレーム\fP +\f3HTMLフレーム\fP .LP -Javadoc ツールは、下の図に示すように、2 ~ 3 つの HTML フレームを生成します。1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。単一のパッケージに属するソースファイル (*.java) または単一のパッケージ名を引数として javadoc コマンドに渡す場合は、左側の列にクラスの一覧を表示するフレーム (C) 1 つだけが作成されます。Javadoc に複数のパッケージ名を渡した場合は、概要ページ (Detail) に加えて、すべてのパッケージを一覧表示する第 3 のフレーム (P) が作成されます。この概要ページのファイル名は、 \f2overview\-summary.html です\fP。したがって、このファイルは、2 つ以上のパッケージ名を渡した場合にだけ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.html を最初に表示すると、フレームを省略できます。 +Javadocツールは、下の図に示すように、2、3個のHTMLフレームを生成します。1つのパッケージしかない場合(またはパッケージがない場合)は、パッケージのリストを省略することによって最低限必要な数のフレームを作成します。つまり、単一のパッケージに属するソース・ファイル(*.java)または単一のパッケージ名を引数としてjavadocコマンドに渡す場合は、左側の列にクラスのリストを表示するフレーム(C)が1つのみ作成されます。Javadocに複数のパッケージ名を渡した場合は、概要ページ(Detail)に加えて、すべてのパッケージをリストする第3のフレーム(P)が作成されます。この概要ページのファイル名は、\f2overview\-summary.html\fPです。したがって、このファイルは、複数のパッケージ名を渡した場合にのみ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.htmlを最初に表示すると、フレームを省略できます。 .LP -HTML フレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、「印刷」メニューコマンドを使ってそのフレームを印刷したりできます。 +HTMLフレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに\f2フォーカス\fPが必要であることに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。これで、多くのブラウザでは、矢印キーやページ・キーを使用してそのフレームをスクロールしたり、「印刷」メニュー・コマンドを使用してそのフレームを印刷したりできます。 .LP -HTML フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。 +HTMLフレームが必要かどうかによって、次のいずれかのファイルを開始ページとしてロードします。 .RS 3 .TP 2 o -\f2index.html\fP (フレームあり) +\f2index.html\fP(フレームあり) .TP 2 o -\f2overview\-summary.html\fP (フレームなし) +\f2overview\-summary.html\fP(フレームなし) .RE .LP \f3生成されるファイルの構造\fP .LP -生成されるクラスファイルおよびインタフェースファイルは、Java ソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1 つのサブパッケージにつき 1 つのディレクトリ、という構造になります。 +生成されるクラス・ファイルおよびインタフェース・ファイルは、Javaソース・ファイルおよびクラス・ファイルと同じディレクトリ階層に編成されます。1つのサブパッケージにつき1つのディレクトリ、という構造になります。 .LP -たとえば、 \f2java.applet.Applet\fP クラス用に生成されたドキュメントは、 \f2java/applet/Applet.html\fP に格納されます。生成先のディレクトリの名前が \f2apidocs\fP だとすると、java.applet パッケージのファイル構造は、その下に構築されます。前述のように、「frame」という語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外の HTML ファイルは、すべて右側のフレームに表示されます。 +たとえば、\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 ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。 +注意 \- ディレクトリは\f3太字\fPで示しています。アスタリスク(\f2*\fP)は、Javadocへの引数がパッケージ名ではなくソース・ファイル名(*.java)である場合に\f2省略される\fPファイルおよびディレクトリを示しています。また、引数がソース・ファイル名の場合、\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 Top directory +.fl + index.html Initial page that sets up HTML frames +.fl + * overview\-summary.html Lists all packages with first sentence summaries +.fl + overview\-tree.html Lists class hierarchy for all packages +.fl + deprecated\-list.html Lists deprecated API for all packages +.fl + constant\-values.html Lists values of static fields for all packages +.fl + serialized\-form.html Lists serialized form for all packages +.fl + * overview\-frame.html Lists all packages, used in upper\-left frame +.fl + allclasses\-frame.html Lists all classes for all packages, used in lower\-left frame +.fl + help\-doc.html Lists user help for how these pages are organized +.fl + index\-all.html Default index created without \-splitindex option +.fl + \f3index\-files\fP Directory created with \-splitindex option +.fl + index\-<number>.html Index files created with \-splitindex option +.fl + package\-list Lists package names, used only for resolving external refs +.fl + stylesheet.css HTML style sheet for defining fonts, colors and positions +.fl + \f3java\fP Package directory +.fl + \f3applet\fP Subpackage directory +.fl + Applet.html Page for Applet class +.fl + AppletContext.html Page for AppletContext interface +.fl + AppletStub.html Page for AppletStub interface +.fl + AudioClip.html Page for AudioClip interface +.fl + * package\-summary.html Lists classes with first sentence summaries for this package +.fl + * package\-frame.html Lists classes in this package, used in lower left\-hand frame +.fl + * package\-tree.html Lists class hierarchy for this package +.fl + package\-use Lists where this package is used +.fl + \f3doc\-files\fP Directory holding image and example files +.fl + \f3class\-use\fP Directory holding pages API is used +.fl + Applet.html Page for uses of Applet class +.fl + AppletContext.html Page for uses of AppletContext interface +.fl + AppletStub.html Page for uses of AppletStub interface +.fl + AudioClip.html Page for uses of AudioClip interface +.fl + \f3src\-html\fP Source code directory +.fl + \f3java\fP Package directory +.fl + \f3applet\fP Subpackage directory +.fl + Applet.html Page for Applet source code +.fl + AppletContext.html Page for AppletContext source code +.fl + AppletStub.html Page for AppletStub source code +.fl + AudioClip.html Page for AudioClip source code .fl .fi .SS -生成される API 宣言 +生成されるAPI宣言 .LP -Javadoc ツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、その API 用の宣言を生成します。たとえば、 \f2Boolean\fP クラスの宣言は、次のようになります。 +Javadocツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\f2Boolean\fPクラスの宣言は、次のようになります。 .LP \f2public final class Boolean\fP .br @@ -577,20 +601,20 @@ .br \f2implements Serializable\fP .LP -また、 \f2Boolean.valueOf\fP メソッドの宣言は、次のようになります。 +また、\f2Boolean.valueOf\fPメソッドの宣言は、次のようになります。 .LP \f2public static Boolean valueOf(String s)\fP .LP -Javadoc ツールでは、修飾子 \f2public\fP、 \f2protected\fP、 \f2private\fP、 \f2abstract\fP、 \f2final\fP、 \f2static\fP、 \f2transient\fP、および \f2volatile\fP は組み込めますが、 \f2synchronized\fP と \f2native\fP は組み込めません。これら後者の 2 つの修飾子は、実装の詳細と見なされているため、API 仕様には含まれません。 +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 "ドキュメンテーションコメント" +APIでは、並行性セマンティクスについて、キーワード\f2synchronized\fPに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つの\f2Enumeration\fPを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\f2Hashtable\fPはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。バケット・レベルで内部的に同期化する権限を保有しておく必要があります。そうすれば、より高度な並行性が提供されます。 +.SH "ドキュメンテーション・コメント" .LP -オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。 +オリジナルの「ドキュメンテーション・コメントの仕様」は、関連項目を参照してください。 .SS -ソースコードへのコメントの挿入 +ソース・コードへのコメントの挿入 .LP -ソースコードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーションコメント ("doc comments") を記述することができます。各パッケージにドキュメンテーションコメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadoc コメント」と呼ばれています (この用語は商標関連の使用法に違反)。ドキュメンテーションコメントは、コメントを始まりを示す文字列 \f2/**\fP と、コメントを終わりを示す文字列 \f2*/\fP の間にある文字から構成されます。行の先頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。 +ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、\f2ドキュメンテーション・コメント\fP("doc comments")を記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、非公式に「Javadocコメント」と呼ばれています(この用語は商標関連の使用方法に違反)。ドキュメンテーション・コメントは、コメントを始まりを示す文字列\f2/**\fPと、コメントを終わりを示す文字列\f2*/\fPの間にある文字から構成されます。行頭のアスタリスクは、各行に記述できます。詳細は、後述します。コメントのテキストは、複数行にわたって記述できます。 .nf \f3 .fl @@ -605,18 +629,18 @@ \fP .fi .LP -次のようにして 1 行に記述すると、スペースを節約できます。 +スペースを節約するには、コメントを1行に入れます。 .nf \f3 .fl -/** This comment takes up only one line.*/ +/** This comment takes up only one line. */ .fl \fP .fi .LP -\f3コメントの配置\fP \- ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。javadoc ツールでは、1 つの宣言文につき 1 つのドキュメンテーションコメントだけが認識されます。 +\f3コメントの配置\fP \- ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにのみ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。Javadocツールでは、1つの宣言文につき1つのドキュメンテーション・コメントのみが認識されます。 .LP -よくある間違いは、クラスコメントとクラス宣言の間に \f2import\fP 文を置いてしまうことです。このような記述はしないでください。このようなクラスコメントは無視されます。 +よくある間違いは、クラス・コメントとクラス宣言の間に\f2import\fP文を置いてしまうことです。このような記述はしないでください。このようなクラス・コメントは無視されます。 .nf \f3 .fl @@ -639,7 +663,7 @@ \fP .fi .LP -\f3ドキュメンテーションコメントは主説明のあとにタグセクションが続く \- コメントの開始区切り文字である\fP \f2/**\fP のあとからタグセクションまでが主説明になります。タグセクションは、行の先頭にある最初の \f2@\fP で定義される最初のブロックタグから始まります (先頭のアスタリスク、空白、先頭の区切り文字 \f2/**\fP は除く)。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1 回しか記述できないタグがあります。たとえば、次の \f2@see\fP は、タグセクションを開始しています。 +\f3ドキュメンテーション・コメントは\fP\f4主説明\fP\f3の後に\fP\f4タグ・セクション\fP\f3が続く\fP \- 開始区切り文字である\f2/**\fPの後からタグ・セクションまでが\f2主説明\fPになります。\f2タグ・セクション\fPは、先頭文字が\f2@\fPの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\f2/**\fPは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\f2@see\fPからタグ・セクションは始まります。 .nf \f3 .fl @@ -654,7 +678,7 @@ \fP .fi .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 が含まれています。 +\f3ブロック・タグとインライン・タグ\fP \- \f2タグ\fPは、Javadocツールが処理できる、ドキュメンテーション・コメント内の特別なキーワードです。タグには2つのタイプがあります。1つは\f2@tag\fPのように表記されるブロック・タグ(「スタンドアロン・タグ」とも呼ばれる)、もう1つは\f2{@tag}\fPのように中括弧で囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\f2/**\fP)を除いて、行の先頭に置く必要があります。これは、\f2@\fP文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\f2@\fP文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\f2@\fPを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\f2@deprecated\fPとインライン・タグ\f2{@link}\fPが含まれています。 .nf \f3 .fl @@ -667,11 +691,11 @@ \fP .fi .LP -\f3コメントは HTML で記述する\fP \- テキストは HTML 形式で記述しなければなりません。これは、HTML のエンティティーを使う必要があること、および HTML タグを使用できることを意味します。記述する HTML のバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディングスタイルシート (CSS) とフレームを含め、すべての部分 (ドキュメンテーションコメント以外の部分) で HTML 3.2 に準拠したコードを生成するように作成されています。ただし、フレームセット対応のため、生成される各ファイルには「HTML 4.0」と記述されます。 +\f3コメントはHTMLで記述する\fP \- テキストはHTMLで記述する必要があります。これは、HTMLのエンティティを使用する必要があること、およびHTMLタグを使用できることを意味します。HTMLのバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディング・スタイル・シートおよびフレームを含め、ドキュメンテーション・コメント以外の部分でHTML 3.2に準拠したコードを生成するように作成されています。(ただし、フレーム・セット対応のため、生成される各ファイルには「HTML 4.0」と先頭に記述されます。) .LP -たとえば、より小さい (\f2<\fP) 記号およびより大きい (\f2>\fP) 記号のエンティティーは、 \f2<\fP および \f2>\fP と記述すべきです。同様に、アンパサンド (\f2&\fP) は \f2&\fP と記述すべきです。次の例ではボールドの HTML タグ \f2<b>\fP が示されています。 +たとえば、より小さい(\f2<\fP)記号およびより大きい(\f2>\fP)記号のエンティティは、\f2<\fPおよび\f2>\fPと記述する必要があります。同様に、アンパサンド(\f2&\fP)は\f2&\fPと記述する必要があります。次の例では、太字のHTMLタグ\f2<b>\fPを使用しています。 .LP -次に、ドキュメンテーションコメントを示します。 +次に、ドキュメンテーション・コメントを示します。 .nf \f3 .fl @@ -686,11 +710,11 @@ \fP .fi .LP -\f3行頭のアスタリスク\fP \- javadoc によるドキュメンテーションコメントの解析時に、各行の先頭にあるアスタリスク (\f2*\fP) 文字は破棄されます。最初のアスタリスク (\f2*\fP) 文字より前にある空白やタブも破棄されます。バージョン 1.4 からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーションコメントの \f2<PRE>\fP タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は左マージンになります (区切り文字 \f2/**\fP または \f2<PRE>\fP タグではなく)。 +\f3行頭のアスタリスク\fP \- Javadocによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(\f2*\fP)文字は破棄されます。最初のアスタリスク(\f2*\fP)文字より前にある空白やタブも破棄されます。バージョン1.4からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーション・コメントの\f2<PRE>\fPタグ内に張り付けても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\f2/**\fPまたは\f2<PRE>\fPタグではなく)左マージンになります。 .LP -\f3最初の文\fP \- 各ドキュメンテーションコメントの最初の文は、宣言されているエンティティーに関する簡潔かつ完全な要約文である必要があります。この「最初の文」は、直後にスペース、タブ、または改行が続く最初のピリオド (ロケールが英語に設定されている場合)、または最初のタグがある位置で終わります。最初の文は、Javadoc ツールによって HTML ページの最初にあるメンバーの概要の部分にコピーされます。 +\f3最初の文\fP \- 各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全な要約文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、JavadocツールによってHTMLページの先頭にあるメンバーの概要の部分にコピーされます。 .LP -\f3複数フィールドの宣言\fP \- Java では、1 つの文で複数のフィールドを宣言できます。ただし、この文には、1 つのドキュメンテーションコメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。たとえば、次のドキュメンテーションコメントは、1 つの宣言として記述すると不適切です。この場合は、宣言を 2 つに分けることをお勧めします。 +\f3複数フィールドの宣言\fP \- Javaでは、1つの文で複数のフィールドを宣言できます。ただし、この文には、1つのドキュメンテーション・コメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーション・コメントを記述する必要がある場合は、各フィールドを別々の文で宣言する必要があります。たとえば、次のドキュメンテーション・コメントは、1つの宣言として記述すると不適切です。この場合は、宣言を2つに分けることをお薦めします。 .nf \f3 .fl @@ -705,7 +729,7 @@ \fP .fi .LP -上記のコードからは、次のようなドキュメントが生成されます。 +上のコードからは、次のようなドキュメントが生成されます。 .nf \f3 .fl @@ -725,80 +749,80 @@ The horizontal and vertical distances of point (x,y) .RE .LP -\f3見出しタグはなるべく使用しない\fP \- メンバーに対してドキュメンテーションコメントを記述するときには、<H1> や <H2> などの HTML 見出しタグは、なるべく使わないでください。 Javadoc ツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。 +\f3見出しタグの使用には要注意\fP \- メンバーに対してドキュメンテーション・コメントを記述するときには、<H1>や<H2>などのHTML見出しタグを使用しないことをお薦めします。Javadocツールは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 .SS -メソッドコメントの自動コピー +メソッド・コメントの自動コピー .LP -Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。 +Javadocツールには、次の2つの場合に、クラスおよびインタフェースのメソッド・コメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 .RS 3 .TP 2 o -\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、 \f2@return\fP タグ、 \f2@param\fP タグ、または \f2@throws\fP タグがメソッドコメントに見つからない場合、Javadoc ツールは、オーバーライドまたは実装している場合はその対象となるメソッドから、対応する主説明またはタグコメントを、次のアルゴリズムに従ってコピーします。 +\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、\f2@return\fPタグ、\f2@param\fPタグ、または\f2@throws\fP タグがメソッド・コメントに見つからない場合、Javadocツールは、メソッドをオーバーライドまたは実装している場合はそのメソッドから、対応する主説明またはタグ・コメントを、次のアルゴリズムに従ってコピーします。 .LP -厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、その例外が宣言されている場合にかぎり、 \f2@throws\fP タグがコピーされます。 +厳密には、特定のパラメータの\f2@param\fPタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\f2@throws\fPタグが見つからない場合、その例外が宣言されている場合に\f2かぎり\fP、\f2@throws\fPタグがコピーされます。 .LP -この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。 +この動作はバージョン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 -ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。 +ドキュメンテーション・コメントを実際にコピーに利用するには、継承したメソッドのソース・ファイルが\-sourcepathで指定したパスのみに置かれている必要があります。コマンドラインで、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスであることが必要だった1.3.x以前のリリースと異なります。 .LP -\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。 +\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の3つの場合に、コメントの継承が行われます。 .RS 3 .TP 2 o -クラスのメソッドがスーパークラスのメソッドをオーバーライドしている +クラスのメソッドがスーパークラスのメソッドをオーバーライドしている場合 .TP 2 o -インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている +インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている場合 .TP 2 o -クラスのメソッドがインタフェースのメソッドを実装している +クラスのメソッドがインタフェースのメソッドを実装している場合 .RE .LP -最初の 2 つのケース (メソッドがオーバーライドしている場合) では、Javadoc ツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。 +最初の2つのケース(メソッドがオーバーライドしている場合)では、Javadocツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。 .LP -3 つ目のケース (特定のクラスのメソッドがインタフェースのメソッドを実装している場合) では、javadoc ツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。 +3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、Javadocツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。 .LP -\f3メソッドの説明が継承されるアルゴリズム\fP \- あるメソッドにドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、Javadoc ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。 このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。 +\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 -.SH "javadoc タグ" +.SH "javadocタグ" .LP -Javadoc ツールは、Java のドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーションタグを使うと、書式の整った完全な API ドキュメントをソースコードから自動的に生成できます。タグは「アットマーク」記号 (\f2@\fP) で始まり、大文字と小文字の区別があります。タグは、大文字と小文字を使用して、表示されているとおりに入力する必要があります。タグは、行の先頭 (先行する空白と省略可能なアスタリスクは除く) に置かなければなりません。慣例として、同じ名前のタグは 1 か所にまとめて記述するようにします。たとえば、 \f2@see\fP タグはすべて同じ場所に配置します。 +Javadocツールは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーション・タグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグは「アットマーク」記号(\f2@\fP)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、通常のテキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\f2@see\fPタグが複数ある場合は、すべて同じ場所にまとめて配置します。 .LP -タグには 2 つのタイプがあります。 +タグには次の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 今後のリリースで導入されるタグについては、 .na -\f2「Proposed Javadoc Tags」\fP @ +\f2提案されているタグ\fP @ .fi http://java.sun.com/j2se/javadoc/proposed\-tags.htmlを参照してください。 .LP @@ -822,26 +846,6 @@ .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 -\f3導入された JDK/SDK のバージョン\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 @@ -886,6 +890,8 @@ .80 .rm 80 .nr 81 0 +.nr 38 \w\f3導入されたJDK/SDK\fP +.if \n(81<\n(38 .nr 81 \n(38 .nr 38 \w1.0 .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \w1.5 @@ -926,11 +932,6 @@ .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 -.35 -.nf -.ll \n(34u .nr 38 1n .nr 79 0 .nr 40 \n(79+(0*\n(38) @@ -938,7 +939,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 851 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 873 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -952,22 +953,10 @@ .ls .. .ec -.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タグ\fP\h'|\n(41u' -.mk ## -.nr 31 \n(## -.sp |\n(##u-1v -.nr 37 (\n(41u+\n(81u-\n(a-u)/2u -.in +\n(37u -.a+ -.in -\n(37u -.mk 32 -.if \n(32>\n(31 .nr 31 \n(32 -.sp |\n(31u +\&\h'|\n(40u'\f3タグ\fP\h'|\n(41u'\f3導入されたJDK/SDK\fP .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -1048,41 +1037,40 @@ .nr T. 1 .T# 1 .35 -.rm a+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-44 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-42 .LP -カスタムタグについては、\-tag オプションを参照してください。 +カスタム・タグについては、\-tagオプションを参照してください。 .RS 3 .TP 3 @author\ name\-text -\-author オプションが使用されている場合、指定された \f2name\-text\fP を含む [作成者] エントリを生成ドキュメントに追加します。1 つのドキュメンテーションコメントに複数の \f2@author\fP タグを含めることができます。1 つの \f2@author\fP タグに 1 つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。 +\-authorオプションが使用されている場合、生成ドキュメントに「作成者」エントリを追加して、指定された\f2name\-text\fPを書き込みます。1つのドキュメンテーション・コメントに複数の\f2@author\fPタグを含めることができます。1つの\f2@author\fPタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadocツールによって名前と名前の間にカンマ(\f2,\fP)と空白文字が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときは、1つのタグに複数の名前を指定してください。 .RE .LP -詳細については、「タグを使用できる場所」および +詳細は、タグを使用できる場所および .na -\f2@author タグのドキュメント\fP @ +\f2@authorタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@authorを参照してください。 .LP .RS 3 .TP 3 -@deprecated\ deprecated\-text 注: @Deprecated 注釈を使って特定のプログラム要素を非推奨にできます。 +@deprecated\ deprecated\-text 注意: @Deprecated注釈を使用して、プログラム要素を非推奨にできます。 .RE .LP -この API は動作し続けますが、この API を使用するべきではないことを示すコメントを追加します。Javadoc ツールは、 \f2deprecated\-text\fP を主説明の前に移動してイタリックにし、その前にボールドの警告「推奨されません。」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。Javadocツールは、\f2deprecated\-text\fPを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .LP -\f2deprecated\-text\fP の最初の文では、少なくとも、その API が推奨されなくなった時期と、代替使用するべき API を読者に提示する必要があります。Javadoc ツールは、この最初の文だけを、概要セクションと索引にコピーします。そのあとの文では、その API が推奨されない理由を説明することもできます。代わりのAPI を指し示す \f2{@link}\fP タグ ( Javadoc 1.2 以降の場合) を含めるべきです。 +\f2deprecated\-text\fPの最初の文では、少なくとも、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。Javadocツールは、この最初の文のみを、概要セクションと索引にコピーします。その後の文では、推奨されない理由を説明することもできます。かわりのAPIを指し示す\f2{@link}\fPタグ(Javadoc 1.2以降の場合)を含める必要があります。 .LP -詳細については、 +詳細は、 .na -\f2@deprecated タグのドキュメント\fP @ +\f2@deprecatedタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@deprecatedを参照してください。 .RS 3 .TP 2 o -Javadoc 1.2 以降では \f2{@link}\fP タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。次に例を示します。 +Javadoc 1.2以降では、\f2{@link}\fPタグを使用します。これにより、必要な場所にインラインでリンクを作成できます。次に例を示します。 .nf \f3 .fl @@ -1098,21 +1086,21 @@ .fi .TP 2 o -Javadoc 1.1 の場合の標準形式は、 \f2@see\fP タグ (インラインは不可) を \f2@deprecated\fP タグごとに作成することです。 +Javadoc 1.1では、\f2@see\fPタグ(インラインは不可)を\f2@deprecated\fPタグごとに作成するのが標準の形式です。 .RE .LP -推奨されないタグについての詳細は、 +推奨されないタグの詳細は、 .na -\f2@deprecated タグ\fP @ +\f2@deprecatedタグ\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。 .LP .RS 3 .TP 3 {@code\ text} -\f2<code>{@literal}</code>\fP と同等です。 +\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) などです。たとえば、次のドキュメンテーションコメント +テキストをHTMLマークアップまたはネストされたjavadocタグとして解釈せずに、\f2text\fPを\f2コード\fP・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\f2<Object>\fP)、不等号(\f23 < 4\fP)、矢印(\f2<\-\fP)などで、通常の山括弧(\f2<\fPおよび\f2>\fP)をHTMLエンティティ(\f2<\fPおよび\f2>\fP)のかわりに使用できます。たとえば、次のドキュメンテーション・コメント .nf \f3 .fl @@ -1123,7 +1111,7 @@ \fP .fi .LP -は、生成された HTML ページで、次のようにそのまま表示されます。 +は、生成されたHTMLページで、次のようにそのまま表示されます。 .nf \f3 .fl @@ -1134,19 +1122,19 @@ \fP .fi .LP -ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。 +ここで注目に値するのは、\f2<B>\fPが太字として解釈されず、そのフォントはコード・フォントになる、という点です。 .LP -コードフォントなしで同じ機能を実現するには、\f2{@literal}\fP を使用します。 +コード・フォントなしで同じ機能を実現するには、\f2{@literal}\fPを使用します。 .LP .TP 3 {@docRoot} -生成されるページから見た、生成ドキュメントの (生成先の) ルートディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの下部から著作権のページにリンクします。 +生成されるページからの、生成ドキュメントの(生成先)ルート・ディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの最下部から著作権のページにリンクします。 .LP -この \f2{@docRoot}\fP タグは、コマンド行でもドキュメンテーションコメント内でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +この\f2{@docRoot}\fPタグは、コマンドラインでもドキュメンテーション・コメント内でも使用できます。このタグは、@return、@param、@deprecatedなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .RS 3 .TP 3 1. -コマンド行では、ヘッダー、フッター、またはボトムノートは次のように定義します。 +コマンドラインでは、ヘッダー、フッター、またはボトムは次のように定義します。 .nf \f3 .fl @@ -1157,10 +1145,10 @@ \fP .fi .LP -注 \- \f2{@docRoot}\fP を Makefile 内でこのように利用する場合、一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする必要があります。たとえば、Inprise MAKE バージョン 5.2 を Windows 上で実行する場合は、 \f2{{@docRoot}} のように、中括弧を二重にする必要があります\fP。さらに、 \f2\-bottom\fP などのオプションに対する引数を、単一引用符ではなく二重引用符で囲む必要もあります ( \f2href\fP の引数を囲む引用符は省略)。 +注意 \- \f2{@docRoot}\fPをMakefile内でこのように利用する場合、一部のMakefileプログラムでは、中括弧{ }文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5.2をWindows上で実行する場合は、\f2{{@docRoot}}\fPのように、中括弧を二重にする必要があります。さらに、\f2\-bottom\fPなどのオプションに対する引数を、一重引用符ではなく二重引用符で囲む必要もあります(\f2href\fP引数を囲む引用符は省略)。 .TP 3 2. -ドキュメンテーションコメントの中では、次のように使用します。 +ドキュメンテーション・コメントの中では、次のように使用します。 .nf \f3 .fl @@ -1176,7 +1164,7 @@ .fi .RE .LP -このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。次に例を示します。 +このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式 .nf \f3 .fl @@ -1187,22 +1175,22 @@ \fP .fi .LP -次のように解決されます。 +は、次のように解決されます。 .nf \f3 .fl - <a href="../../copyright.html"> java/lang/Object.java の場合 + <a href="../../copyright.html"> for java/lang/Object.java .fl .fl \fP .fi .LP -かつ +および .nf \f3 .fl - <a href="../../../copyright.html"> java/lang/ref/Reference.java の場合 + <a href="../../../copyright.html"> for java/lang/ref/Reference.java .fl .fl @@ -1211,93 +1199,93 @@ .LP .TP 3 @exception\ class\-name\ description -\f2@exception\fP タグは \f2@throws\fP と同義です。 +\f2@exception\fPタグは、\f2@throws\fPと同義です。 .LP .TP 3 {@inheritDoc}\ -もっとも近い継承可能なクラスまたは実装可能なインタフェースから、このタグの現在のドキュメンテーションコメントに、ドキュメントを継承 (コピー) します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使って記述することができます。 +最も近い継承可能なクラスまたは実装可能なインタフェースから、このタグの位置にある現在のドキュメンテーション・コメントに、ドキュメントを継承(コピー)します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使用して記述することができます。 .LP -このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。 +このタグは、ドキュメンテーション・コメントの次の位置でのみ有効です。 .RS 3 .TP 2 o -メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる +メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされます。 .TP 2 o -メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる +メソッドの@return、@param、@throwsタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 .RE .LP -継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。 +継承階層でコメントを見つける方法に関する正確な説明は、メソッド・コメントの自動コピーを参照してください。このタグが見つからない場合、コメントは、この項で説明するルールに応じて、自動的に継承されるかどうかが決まります。 .LP .TP 3 {@link\ package.class#member\ label} -表示テキスト \f2label\fP とのインラインリンクを挿入します。label は、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +表示テキスト\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 エンティティーの「}」を使います。 +このタグは\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 などの任意のタグのテキスト部分で使うことができます。 +1つ文の中で使用できる\f2{@link}\fPタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または@deprecated、@return、@paramなどの任意のタグのテキスト部分で使用できます。 .LP -たとえば、次のコメントでは \f2getComponentAt(int, int)\fP メソッドを参照しています。 +たとえば、次のコメントでは\f2getComponentAt(int,int)\fPメソッドを参照しています。 .nf \f3 .fl -{@link #getComponentAt(int, int) getComponentAt} メソッドを使用します。 +Use the {@link #getComponentAt(int, int) getComponentAt} method. .fl .fl \fP .fi .LP -標準ドックレットでは、上記のコメントから次の HTML が生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。 +標準ドックレットでは、上のコメントから次のHTMLが生成されます(このコメントが同じパッケージの別のクラスを参照している場合)。 .nf \f3 .fl -<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> メソッドを使用します。 +Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method. .fl .fl \fP .fi .LP -この HTML は、Web ページ上では次のように表示されます。 +これは、Webページ上では次のように表示されます。 .nf \f3 .fl -getComponentAt メソッドを使用します。 +Use the getComponentAt method. .fl .fl \fP .fi .LP -\f2{@link}\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。 +\f2{@link}\fPを拡張してドキュメント化されないクラスにリンクするには、\f2\-link\fPオプションを使用します。 .LP -詳細については、 +詳細は、 .na -\f2{@link} タグのドキュメント\fP @ +\f2{@link}タグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#{@link}を参照してください。 .LP .TP 3 {@linkplain\ package.class#member\ label} -リンクのラベルがコードフォントではなくプレーンテキストで表示される点以外は \f2{@link}\fP と同じです。ラベルがプレーンテキストで記述されていると便利です。次の例を参照してください。例: +リンクのラベルがコード・フォントではなくプレーン・テキストで表示される点以外は\f2{@link}\fPと同じです。ラベルがプレーン・テキストで記述されていると便利です。例: .nf \f3 .fl - {@linkplain add() the overridden method} を参照してください。 + Refer to {@linkplain add() the overridden method}. .fl .fl \fP .fi .LP -これは以下のように表示されます。 +これは次のように表示されます。 .LP -the overridden method を参照してください。 +Refer to the overridden method. .LP .TP 3 {@literal\ text} -テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、 \f2text\fP を表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント +テキストをHTMLマークアップまたはネストされたjavadocタグとして解釈せずに、\f2text\fPを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\f2<Object>\fP)、不等号(\f23 < 4\fP)、矢印(\f2<\-\fP)などで、通常の山括弧(\f2<\fPおよび\f2>\fP)をHTMLエンティティ(\f2<\fPおよび\f2>\fP)のかわりに使用できます。たとえば、次のドキュメンテーション・コメント .nf \f3 .fl @@ -1308,19 +1296,19 @@ \fP .fi .LP -は、生成された HTML ページはブラウザで次のようにそのまま表示されます。 +は、ブラウザで生成されたHTMLページに次のようにそのまま表示されます。 .LP \f2\ \ \ \ \ \fPA<B>C .LP -ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。 +ここで注目に値するのは、\f2<B>\fPが太字として解釈されず、そのフォントはコード・フォントにならない、という点です。 .LP -コードフォントで同じ機能を実現するには、\f2{@code}\fP を使用します。 +コード・フォントで同じ機能を実現するには、\f2{@code}\fPを使用します。 .LP .TP 3 @param\ parameter\-name description -指定された \f2parameter\-name\fP のあとに指定された \f2description\fP が続くパラメータを、[パラメータ] セクションに追加します。ドキュメンテーションコメントを記述するときには、 \f2description\fP を複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスの doc コメント内でのみ有効です。 +「パラメータ」セクションに、指定された\f2parameter\-name\fPの後に指定された\f2description\fPを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、\f2description\fPを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。 .LP -\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。山括弧でパラメータ名を囲むと、型パラメータを使用することを 指定します。 +\f2parameter\-name\fPは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山括弧でこのパラメータ名を囲み、型パラメータを使用することを指定します。 .LP クラスの型パラメータの例: .nf @@ -1366,29 +1354,29 @@ \fP .fi .LP -詳細については、 +詳細は、 .na -\f2@param タグのドキュメント\fP @ +\f2@paramタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@paramを参照してください。 .LP .TP 3 @return\ description -[戻り値] セクションを追加して、 \f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。 +「戻り値」セクションを追加して、\f2description\fPのテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーション・コメントでのみ有効です。 .LP -詳細については、 +詳細は、 .na -\f2@return タグのドキュメント\fP @ +\f2@returnタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@returnを参照してください。 .LP .TP 3 @see\ reference -「関連項目」見出しを追加し、 \f2reference を指すリンクか、またはテキストエントリを書き込みます\fP。ドキュメンテーションコメントには任意の数の \f2@see\fP タグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。 \f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバーに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。 +「関連項目」見出しを追加して、\f2reference\fPを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\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)かどうかを調べて、この形式を前述の形式と区別します。次に例を示します。 .nf \f3 .fl @@ -1408,12 +1396,12 @@ .RS 3 .TP 3 関連項目: -The Java Programming Language +"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 つの形式と区別します。たとえば、 +\f2URL\fP#\f2value\fPで定義されたとおりにリンクを追加します。\f2URL\fP#\f2value\fPは、相対URLまたは絶対URLです。Javadocツールは、最初の文字が「より小さい」記号(\f2<\fP)かどうかを調べて、この形式を他の形式と区別します。次に例を示します。 .nf \f3 .fl @@ -1429,23 +1417,23 @@ .RE .TP 3 @see\ package.class#member\ label -可視のテキスト \f2label\fP を持つリンクを追加します。このリンクは、参照先となる、指定された Java 言語の名前のドキュメンテーションを指します。 \f2label\fP は省略可能です。label を省略すると、リンク先のメンバーの名前が適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。\-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。 +表示テキスト\f2label\fPとともにリンクを追加します。このリンクは、指定された名前を持つ、参照されているJava言語のメンバーのドキュメントを指します。\f2label\fPは省略可能です。labelを省略すると、名前がかわりに表示テキストとして適切に短縮されて表示されます。名前が表示される方法を参照してください。\-noqualifierを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。 .LP -バージョン 1.2 だけは、ラベルではなく、名前が <code> HTML タグ内に自動的に表示されます。 1.2.2 からは、ラベルを使用するか、しないかにかかわらず、<code> は常に表示テキストを囲むかたちで、含まれます。 +バージョン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 形式のうちのどちらかを使用します。この引数については、このあとの「名前の指定」で詳しく説明します。 +\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 が、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 +\f4label\fPは、省略可能なテキストで、リンクのラベルとして表示されます。\f2label\fPには空白を含めることができます。\f2label\fPを省略すると、\f2package.class.member\fPが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。名前が表示される方法を参照してください。 .TP 2 o -空白が、 \f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 +空白文字が、\f2package.class\fP\f2#\fP\f2member\fPと\f2label\fPの間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 .RE .LP -\f3例\fP \- この例では、 \f2@see\fP タグ ( \f2Character\fP クラス内) が String クラスの \f2equals\fP メソッド \f2を参照\fP しています。このタグには名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。 +\f3例\fP \- この例では、\f2@see\fPタグ(\f2Character\fPクラス内)が、\f2String\fPクラスの\f2equals\fPメソッドを参照しています。タグには、名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。 .nf \f3 .fl @@ -1457,7 +1445,7 @@ .fl \fP .fi -標準ドックレットは、次のような HTML を生成します。 +標準ドックレットは、次のようなHTMLを生成します。 .nf \f3 .fl @@ -1471,16 +1459,16 @@ .fl \fP .fi -これは、ブラウザでは次のように表示され、ラベルがリンクテキストになります。 +これは、ブラウザでは次のように表示され、ラベルが表示リンク・テキストになります。 .RS 3 .TP 3 関連項目: equals .RE .LP -\f3名前の指定\fP \- この \f2package.class\fP\f2#\fP\f2member\fP という名前は、 \f2java.lang.String#toUpperCase()\fP のような完全修飾名にすることも、 \f2String#toUpperCase()\fP や \f2#toUpperCase()\fP のような非完全修飾名にすることもできます。名前が完全指定されていない場合、Javadoc ツールは、Java コンパイラの通常の検索順序でその名前を検索します。詳細は、このあとの「@see の検索順序」を参照してください。名前には、メソッドの複数の引数の間など、括弧の内側であれば空白を含めることができます。 +\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 にはメソッドまたはコンストラクタを、それぞれ指定できます。 +「部分的に修飾」した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次の表に、様々な形式の名前を示します。ここで、\f2Class\fPにはクラスまたはインタフェースを、\f2Type\fPにはクラス、インタフェース、配列、またはプリミティブを、\f2method\fPにはメソッドまたはコンストラクタを、それぞれ指定できます。 .LP .LP .TS @@ -1511,7 +1499,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 @@ -1527,9 +1515,9 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3現在のクラスのメンバーを参照する\fP -.br -\f2@see\fP\ \f2#\fP\f2フィールド\fP +\f3現在のクラスのメンバーを参照する\ \ \ \ \ \ \fP +.br +\f2@see\fP\ \f2#\fP\f2field\fP .br \f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP .br @@ -1553,21 +1541,21 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3現在の、またはインポートされたパッケージの別のクラスを参照する\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2フィールド\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type,\ Type,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP +\f3現在の、またはインポートされたパッケージの別のクラスを参照する\ \ \ \ \ \ \ \ \fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP .br \f2@see\fP\ \f2Class.NestedClass\fP .br -\f2@see\fP\ \f2クラス\fP +\f2@see\fP\ \f2Class\fP .br .di .nr c| \n(dn @@ -1583,9 +1571,8 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3別のパッケージの要素を参照する\fP\ (完全修飾) -.br -\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2フィールド\fP +\f3別のパッケージの要素を参照する\fP\ (完全修飾)\ \ \ \ .br +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP .br \f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP .br @@ -1599,7 +1586,7 @@ .br \f2@see\fP\ \f2package.Class\fP .br -\f2@see\fP\ \f2パッケージ\fP +\f2@see\fP\ \f2package\fP .br .di .nr d| \n(dn @@ -1628,7 +1615,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 1342 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1364 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1721,46 +1708,46 @@ .RS 3 .TP 2 o -最初の種類の形式 (パッケージとクラスを省略) の場合、Javadoc ツールは、現在のクラスの階層だけを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、または現在のクラスかインタフェースを囲んでいるクラスかインタフェースからメンバーを検索します (このあとの検索手順 1 ~ 3)。現在のパッケージのほかの部分や、ほかのパッケージは検索しません (検索手順 4 ~ 5)。 +最初のタイプの形式(パッケージとクラスを省略)の場合、Javadocツールは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索手順1\-3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索手順4\-5)。 .TP 2 o -メソッドまたはコンストラクタの指定時に、 \f2getValue\fP のように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadoc ツールによってその名前へのリンクが正しく作成されますが、括弧や引数の追加をユーザーに促すための警告メッセージが表示されます。このメソッドがオーバーロードされている場合、Javadoc ツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 +メソッドまたはコンストラクタの入力時に、\f2getValue\fPのように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadocツールはその名前へのリンクを正しく作成しますが、括弧と引数の追加を促す警告メッセージを出力します。このメソッドがオーバーロードされている場合、Javadocツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 .TP 2 o -入れ子になったクラスは、すべての形式について、 \f2outer\fP\f2.\fP\f2inner\fP として指定する必要があります。単純に \f2inner\fP とはしないでください。 +ネストされたクラスは、すべての形式について、\f2outer\fP\f2.\fP\f2inner\fPとして指定する必要があります。単純に\f2inner\fPとはしないでください。 .TP 2 o -すでに述べたように、\f2クラスとメンバーとの間の区切り文字としては、\fPドット (\f2.\fP) ではなくシャープ文字 (#) を使用します。このように指定すると、Javadoc ツールは、あいまいさを解決できます。ドットは、クラス、入れ子にされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されます。ただし、Javadoc ツールでは一般に許容範囲が広く、あいまいさがなければ、ドットでも正しく解析されます。その場合でも警告は表示されます。 +すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\f2.\fP)ではなくシャープ文字(\f2#\fP)を使用します。このように指定すると、Javadocツールは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、Javadocツールでは一般に許容範囲が広く、あいまいさがなければドットは正しく解析されます。その場合でも、警告は表示されます。 .RE .LP -\f3@see の検索順序\fP \- Javadoc ツールは、ソースファイル (.java)、パッケージファイル (package.html または package\-info.java) または概要ファイル (overview.html) に含まれる \f2@see\fP タグを処理します。後者の 2 つのファイルでは、完全指定の名前を \f2@see\fP タグに指定しなければなりません。ソースファイルでは、完全指定の名前、または部分指定の名前を指定できます。 +\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 ツールは、特定の名前空間のあいまいさを検出しません。 これは、ソースコードにこれらのエラーが存在していないことを前提としているためです。この検索順序は、\f2Java 言語仕様\fPで正式に定義されています。Javadoc ツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてから名前を検索します。具体的には、次の順序で検索します。 +Javadocツールは、完全修飾\f2でない\fP名前が記述された\f2@see\fPタグを\f2.java\fPファイル内で見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、Javadocツールは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、\f2Java言語仕様\fPで正式に定義されています。Javadocツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 .RS 3 .TP 3 1. 現在のクラスまたはインタフェース .TP 3 2. -外側を囲んでいるクラスとインタフェース (もっとも近いものから検索) +外側を囲んでいるクラスとインタフェース(最も近いものから検索) .TP 3 3. -スーパークラスとスーパーインタフェース (もっとも近いものから検索) +スーパークラスとスーパーインタフェース(最も近いものから検索) .TP 3 4. 現在のパッケージ .TP 3 5. -インポートされているパッケージ、クラス、およびインタフェース (import 文の順序に従って検索) +インポートされているパッケージ、クラス、およびインタフェース(import文の順序に従って検索) .RE .LP -Javadoc ツールは、各クラスについて手順 1 ~ 3 を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にそのクラスを囲んでいるクラス E を検索し、その次に E のスーパークラスを検索し、さらにその次に E を囲んでいるクラスを検索します。 手順 4 と 5 では、1 つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません。その順序は、個々のコンパイラによって異なります。手順 5 では、Javadoc ツールは、java.lang を検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 +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 はそのパッケージ内での検索を行いません。 +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 メソッドに、同じクラスのメンバーへの参照とほかのクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースだけです (次の表を参照)。 +\f3名前が表示される方法\fP \- \f2label\fPを省略すると、\f2package.class.member\fPが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。「短縮される」とは、必要最小限の名前のみが表示されるということです。たとえば、\f2String.toUpperCase()\fPメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次の表を参照)。 .LP -パッケージ名を広域的に削除するには、\-noqualifier を使用します。 +パッケージ名を全体的に削除するには、\-noqualifierを使用します。 .br .LP .TS @@ -1791,7 +1778,7 @@ .ll \n(34u*1u/4u .if \n(.l<\n(81 .ll \n(81u .in 0 -\f4String.toUpperCase() での例\fP +\f4String.toUpperCase()\fP\f3での例\fP .br .di .nr a| \n(dn @@ -1807,7 +1794,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 @@ -1823,7 +1810,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 @@ -1839,7 +1826,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 @@ -1871,7 +1858,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 @@ -1887,7 +1874,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 @@ -1919,7 +1906,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 @@ -1930,7 +1917,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 @@ -1974,7 +1961,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 1418 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1440 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1993,7 +1980,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 @@ -2113,13 +2100,13 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-28 .LP -\f3@see の例\fP -.br -右側のコメントは、 \f2@see\fP タグが \f2java.applet.Applet\fP などの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。 +\f3@seeの例\fP +.br +右側のコメントは、\f2@see\fPタグが\f2java.applet.Applet\fPなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。 .nf \f3 .fl - 関連項目: + See also: .fl @see java.lang.String // String \fP\f3 .fl @@ -2141,11 +2128,11 @@ .fl \fP .fi -\f2@see\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。 +\f2@see\fPを拡張してドキュメント化されないクラスにリンクするには、\f2\-link\fPオプションを使用します。 .LP -詳細については、 +詳細は、 .na -\f2@see タグのドキュメント\fP @ +\f2@seeタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@seeを参照してください。 .RE @@ -2154,53 +2141,53 @@ .RS 3 .TP 3 @serial\ field\-description | include | exclude -デフォルトの直列化可能フィールドのドキュメンテーションコメントで使用します。 +デフォルトの直列化可能フィールドのドキュメンテーション・コメントで使用します。 .LP -\f2field\-description\fP (省略可能) では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式のページに追加します。 +\f2field\-description\fP(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。 .LP -クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 +クラスを直列化した後しばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 .LP -\f2include\fP および \f2exclude\fP 引数は、直列化された形式のページにクラスまたはパッケージを含めるか除外するかを示します。これらの引数には、次のような効果があります。 +\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とマークされていないかぎり、\f2含められます\fP。 .TP 2 o -\f2Serializable\fP を実装している private または package\-private クラスは、そのクラス (またはそのパッケージ) が \f2@serial include\fP として マークされていないかぎり、除外されます。 +\f2Serializable\fPを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\f2@serial include\fPとマークされていないかぎり、\f2除外されます\fP。 .RE .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 としてマークされています。 +例: \f2javax.swing\fPパッケージは(\f2package.html\fPまたは\f2package\-info.java\fP内で)\f2@serial exclude\fPとマークされています。publicクラス\f2java.security.BasicPermission\fPは\f2@serial exclude\fPとマークされています。package\-privateクラス\f2java.util.PropertyPermissionCollection\fPは\f2@serial include\fPとマークされています。 .LP -クラスレベルで指定された @serial タグは、パッケージレベルで指定された @serial タグをオーバーライドします。 +クラス・レベルで指定された@serialタグは、パッケージ・レベルで指定された@serialタグをオーバーライドします。 .LP -これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節 +これらのタグの使用方法の詳細と使用例は、\f2Javaオブジェクト直列化仕様\fPの第1.6項 .na -\f2「クラスの直列化可能なフィールドおよびデータの文書化」\fP @ +\f2クラスの直列化可能なフィールドおよびデータの文書化\fP @ .fi -http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、 +http://download.oracle.com/javase/7/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、 .na -\f2「直列化の FAQ」\fP @ +\f2直列化のFAQ\fP @ .fi -http://java.sun.com/javase/technologies/core/basic/serializationFAQ.jsp#javadoc_warn_missingも参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、 +http://java.sun.com/javase/technologies/core/basic/serializationFAQ.jsp#javadoc_warn_missingも参照してください。このFAQには、「\-privateスイッチを指定しないでjavadocを実行しているのにprivateフィールドの@serialタグが見つからないというjavadocの警告が表示される」などの一般的な質問への回答が記載されています。直列化された形式の仕様にクラスを含める場合には、 .na -\f2「Sun の仕様」\fP @ +\f2Sunの基準\fP @ .fi http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlも参照してください。 .LP .TP 3 @serialField\ field\-name\ field\-type\ field\-description -Serializable \f2クラスの\fP serialPersistentFields \f2メンバーの\fP ObjectStreamField コンポーネント \f2をドキュメント化\fP します。1 つの \f2@serialField\fP タグを各 \f2ObjectStreamField\fP コンポーネントで使用すべきです。 +\f2Serializable\fPクラスの\f2serialPersistentFields\fPメンバーの\f2ObjectStreamField\fPコンポーネントをドキュメント化します。各\f2ObjectStreamField\fPコンポーネントに対して1つの\f2@serialField\fPタグを使用する必要があります。 .LP .TP 3 @serialData\ data\-description -\f2data\-description\fP は、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、 \f2writeObject\fP メソッドによって書き込まれる省略可能なデータ、および \f2Externalizable.writeExternal\fP メソッドによって書き込まれるすべてのデータ (基底クラスも含む) が含まれます。 +\f2data\-description\fPは、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、\f2writeObject\fPメソッドによって書き込まれる省略可能なデータ、および\f2Externalizable.writeExternal\fPメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 .LP -\f2@serialData\fP タグは、 \f2writeObject\fP、 \f2readObject\fP、 \f2writeExternal\fP、 \f2readExternal\fP、 \f2writeReplace\fP、および \f2readResolve\fP メソッドのドキュメンテーションコメント内で使用できます。 +\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。たとえば、 +生成ドキュメントに「導入されたバージョン」見出しを追加して、指定された\f2since\-text\fPを書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\f2since\-text\fPによって指定されたソフトウェア・リリース以降、存在していることを意味します。次に例を示します。 .nf \f3 .fl @@ -2211,25 +2198,25 @@ \fP .fi .LP -Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。 +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 タグを使用できます。 +\f2@throws\fPタグと\f2@exception\fPタグは同義です。生成ドキュメントに「スロー」小見出しを追加して、\f2class\-name\fPおよび\f2description\fPのテキストを書き込みます。\f2class\-name\fPは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、Javadocツールは、検索順序に従ってクラスを探します。同じまたは異なる例外の特定のドキュメンテーション・コメントで、複数の\f2@throws\fPタグを使用できます。 .LP -すべてのチェック済み例外がドキュメント化されるようにするために、 \f2@throws\fP タグが throws 節内の例外用に存在しない場合は、@throws タグのあるドキュメントであるかのように、Javadoc ツールによって例外が HTML 出力に説明なしで自動的に追加されます。 +すべてのチェック済み例外がドキュメント化されるようにするために、\f2@throws\fPタグがthrows節内の例外用に存在しない場合は、@throwsタグでドキュメント化されたかのように、Javadocツールによって例外がHTML出力に説明なしで自動的に追加されます。 .LP -オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、 \f2@throws\fP ドキュメンテーションがそのメソッドからサブクラスにコピーされます。インタフェースメソッドから実装メソッドにコピーされる場合も同様です。@throws にドキュメンテーションを継承させるには、{@inheritDoc} を使用できます。 +オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\f2@throws\fPのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。@throwsにドキュメントを継承させるには、{@inheritDoc}を使用できます。 .LP -詳細については、 +詳細は、 .na -\f2@throws タグのドキュメント\fP @ +\f2@throwsタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@exceptionを参照してください。 .LP .TP 3 {@value\ package.class#field} -\f2{@value}\fP が静的フィールドの doc コメントで 引数なしで使用されている場合、その定数の値が表示されます。 +\f2{@value}\fPが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値が表示されます。 .nf \f3 .fl @@ -2246,7 +2233,7 @@ \fP .fi .LP -任意のドキュメンテーションコメント内で引数 \f2package.class#field\fP ありで使用された場合は、その指定された定数の値が表示されます。 +任意のドキュメンテーション・コメント内で引数\f2package.class#field\fPありで使用された場合は、その指定された定数の値が表示されます。 .nf \f3 .fl @@ -2265,36 +2252,36 @@ \fP .fi .LP -引数 \f2package.class#field\fP は、@see 引数と同一の形式になります。ただし、メンバーが静的フィールドになければならない点が異なります。 +引数\f2package.class#field\fPは、@see引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 .LP これらの定数での値は、 .na \f2定数フィールド値\fP @ .fi -http://java.sun.com/javase/6/docs/api/constant\-values.htmlページにも表示されます。 +http://download.oracle.com/javase/7/docs/api/constant\-values.htmlページにも表示されます。 .LP .TP 3 @version\ version\-text -\-version オプションが使用されると、生成ドキュメントに [バージョン] 小見出しを追加し、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。 \f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。 +\-versionオプションが使用されている場合、生成ドキュメントに「バージョン」小見出しを追加して、指定された\f2version\-text\fPを書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています(これに対し、@sinceは、このコードが導入されたバージョン番号を保持します)。\f2version\-text\fPには、特別な内部構造はありません。バージョン・タグを使用できる場所を調べるには、タグを使用できる場所を参照してください。 .LP -1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。意味が失われない範囲内で、1 つの \f2@version\fP タグに 1 つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。 +1つのドキュメンテーション・コメントに複数の\f2@version\fPタグを含めることができます。必要に応じて、1つの\f2@version\fPタグに1つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadocツールによって名前と名前の間にカンマ(\f2,\fP)と空白文字が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときは、1つのタグに複数の名前を指定してください。 .LP -詳細については、 +詳細は、 .na -\f2@version タグのドキュメント\fP @ +\f2@versionタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@versionを参照してください。 .RE .SS タグを使用できる場所 .LP -ここでは、タグを使用できる場所について説明します。すべてのドキュメンテーションコメントで使用可能なタグは次のとおりです。 \f2@see\fP、 \f2@since\fP、 \f2@deprecated\fP、 \f2{@link}\fP、 \f2{@linkplain}\fP、および \f2{@docroot}\fP。 +ここでは、タグを使用できる場所について説明します。\f2@see\fP、\f2@since\fP、\f2@deprecated\fP、\f2{@link}\fP、\f2{@linkplain}\fP、および\f2{@docroot}\fPは、すべてのドキュメンテーション・コメントで使用できます。 .SS -概要のドキュメンテーションタグ +概要のドキュメンテーション・タグ .LP -概要タグは、概要ページのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは、通常 \f2overview.html\fP という名前のソースファイル内にあります。 ほかのドキュメンテーションコメントの場合と同様に、これらのタグは、主説明のあとで使う必要があります。 +概要タグは、概要ページのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは、通常\f2overview.html\fPという名前のソース・ファイル内にあります)。他のドキュメンテーション・コメントの場合と同様に、これらのタグは、主説明の後で使用する必要があります。 .LP -\f3注\fP \- バージョン 1.2 では、概要ドキュメント内の \f2{@link}\fP タグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、 \f2{@docRoot}\fP タグは、概要ドキュメント内では動作しません。 +\f3注意\fP \- バージョン1.2では、概要ドキュメント内の\f2{@link}\fPタグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\f2{@docRoot}\fPタグは、概要ドキュメント内では機能しません。 .LP \f3概要タグ\fP .RS 3 @@ -2321,11 +2308,11 @@ \f2{@docRoot}\fP .RE .SS -パッケージドキュメンテーションタグ +パッケージ・ドキュメンテーション・タグ .LP -パッケージタグは、パッケージのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは \f2package.html\fP または \f2package\-info.java\fP という名前のソースファイル内にあります。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。 +パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは\f2package.html\fPまたは\f2package\-info.java\fPという名前のソース・ファイル内にあります)。ここで使用できる\f2@serial\fPタグは、\f2include\fPまたは\f2exclude\fP引数を指定したもののみです。 .LP -\f3パッケージタグ\fP +\f3パッケージ・タグ\fP .RS 3 .TP 2 o @@ -2353,11 +2340,11 @@ \f2{@docRoot}\fP .RE .SS -クラスおよびインタフェースドキュメンテーションタグ +クラスおよびインタフェース・ドキュメンテーション・タグ .LP -次に、クラスまたはインタフェースのドキュメンテーションコメントで使用できるタグを示します。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。 +次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。ここで使用できる\f2@serial\fPタグは、\f2include\fPまたは\f2exclude\fP引数を指定したもののみです。 .LP -\f3クラスおよびインタフェースタグ\fP +\f3クラスおよびインタフェース・タグ\fP .RS 3 .TP 2 o @@ -2387,7 +2374,7 @@ o \f2{@docRoot}\fP .RE -\f3次にクラスコメントの例を示します。\fP +\f3クラス・コメントの例:\fP .nf \f3 .fl @@ -2426,11 +2413,11 @@ \fP .fi .SS -フィールドドキュメンテーションタグ +フィールド・ドキュメンテーション・タグ .LP -次に、フィールドのドキュメンテーションコメントで使用できるタグを示します。 +次に、フィールドのドキュメンテーション・コメントで使用できるタグを示します。 .LP -\f3フィールドタグ\fP +\f3フィールド・タグ\fP .RS 3 .TP 2 o @@ -2460,7 +2447,7 @@ o \f2{@value}\fP .RE -\f3次にフィールドコメントの例を示します。\fP +\f3フィールド・コメントの例:\fP .nf \f3 .fl @@ -2479,11 +2466,11 @@ \fP .fi .SS -コンストラクタおよびメソッドドキュメンテーションタグ +コンストラクタおよびメソッド・ドキュメンテーション・タグ .LP -次に、コンストラクタまたはメソッドのドキュメンテーションコメントで使用できるタグを示します。ただし、 \f2@return\fP はコンストラクタでは使用できず、 \f2{@inheritDoc}\fP には特定の制限があります。 \f2@serialData\fP タグは特定の直列化メソッドの doc コメントでのみ使用できます。 +次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\f2@return\fPはコンストラクタでは使用できず、\f2{@inheritDoc}\fPには特定の制限があります。\f2@serialData\fPタグは特定の直列化メソッドのドキュメンテーション・コメントでのみ使用できます。 .LP -\f3メソッドおよびコンストラクタタグ\fP +\f3メソッドおよびコンストラクタ・タグ\fP .RS 3 .TP 2 o @@ -2502,7 +2489,7 @@ \f2@return\fP .TP 2 o -\f2@throws\fP と \f2@exception\fP +\f2@throws\fPと\f2@exception\fP .TP 2 o \f2@serialData\fP @@ -2519,7 +2506,7 @@ o \f2{@docRoot}\fP .RE -\f3次にメソッドのドキュメンテーションコメントの例を示します。\fP +\f3メソッドのドキュメンテーション・コメントの例:\fP .nf \f3 .fl @@ -2555,7 +2542,7 @@ .fi .SH "オプション" .LP -javadoc ツールは、ドックレットを使って出力を決定します。Javadoc ツールは、\-doclet オプションでカスタムドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使います。Javadoc ツールには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、このあとの「Javadoc オプション」で説明します。標準ドックレットでは、このほかに、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、そのあとの「標準ドックレットが提供するオプション」で説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 +Javadocツールは、ドックレットを使用して出力を決定します。Javadocツールは、\-docletオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。Javadocツールには、任意のドックレットとともに使用できるコマンドライン・オプションがあります。これらのオプションについては、後述のJavadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンドライン・オプションが提供されます。これらのオプションについては、後述の標準ドックレットが提供するオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 .LP オプションは次のとおりです。 .LP @@ -2773,7 +2760,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 1993 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 2015 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2831,47 +2818,46 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-127 .LP -\f2イタリック\fP で示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。 +\f2イタリック\fPで示されたオプションは、Javadocの基本オプションであり、Javadocツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。 .SS -Javadoc オプション +Javadocオプション .RS 3 .TP 3 \-overview \ path/filename -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 +Javadocに対して、\f2path/filename\fPで指定された「ソース」ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(\f2overview\-summary.html\fP)に配置するように指定します。\f2path/filename\fPは、現在のディレクトリからの相対パスです。 +.br +.br +\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に配置できます。使用例を参照してください。 +.br +.br +\f2path/filename\fPで指定するファイルについては、概要コメント・ファイルを参照してください。 +.br +.br +概要ページが作成されるのは、Javadocに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。 +.br +.br +概要ページのタイトルは、\f2\-doctitle\fPによって設定されます。 .TP 3 \-public -public クラスおよびメンバーだけを表示します。 -.LP +publicクラスおよびメンバーのみを表示します。 .TP 3 \-protected -protected および public のクラスとメンバーだけを表示します。これがデフォルトです。 -.LP +protectedおよびpublicのクラスとメンバーのみを表示します。これがデフォルトです。 .TP 3 \-package -package、protected、および public のクラスとメンバーだけを表示します。 -.LP +package、protected、およびpublicのクラスとメンバーのみを表示します。 .TP 3 \-private -すべてのクラスとメンバーを表示します。 -.LP +すべてのクラスとメンバーを表示します。 .TP 3 \-help -オンラインヘルプを表示します。Javadoc とドックレットのコマンド行オプションが一覧表示されます。 -.LP +オンライン・ヘルプを表示します。Javadocとドックレットのコマンドライン・オプションがリストされます。 .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オプションによって定義されます。 +.br +.br +たとえば、MIFドックレットを呼び出すには、次のように指定します。 .nf \f3 .fl @@ -2879,18 +2865,17 @@ .fl \fP .fi -.LP 特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 -.LP +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .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ファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。 +.br +.br +jarファイルへのパスの例には、ドックレット開始クラス・ファイルが含まれています。jarファイル名が含まれている点に注目してください。 .nf \f3 .fl @@ -2898,7 +2883,7 @@ .fl \fP .fi -ドックレット開始クラスファイルのパスの例。クラスファイル名が省略されている点に注目してください。 +ドックレット開始クラス・ファイルのパスの例。クラス・ファイル名が省略されている点に注目してください。 .nf \f3 .fl @@ -2908,38 +2893,36 @@ .fi 特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 -.LP +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .TP 3 \-1.1 -\f2この機能は Javadoc 1.4 から削除されました。代替機能はありません。このオプションは、Javadoc 1.1 によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした。入れ子のクラスはサポートされていません。このオプションが必要な場合は、Javadoc 1.2 または 1.3 を使用してください。\fP -.LP +\f2この機能はJavadoc 1.4から削除されました。代替機能はありません。このオプションは、Javadoc 1.1によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした(ネストされたクラスはサポートされていません)。このオプションが必要な場合は、Javadoc 1.2または1.3をかわりに使用してください。\fP .TP 3 \-source release -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。 +受け付けるソース・コードのバージョンを指定します。\f2release\fPには次の値を指定できます。 .RS 3 .TP 2 o -\f31.5\fP \- javadoc は、JDK 1.5 で導入された総称などの言語機能を含むコードを受け付けます。\f3\-source\fP フラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5 のものになります。 +\f31.5\fP \- Javadocは、JDK 1.5で導入された総称および他の言語機能を含むコードを受け付けます。\f3\-source\fPフラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5のものになります。 .TP 2 o -\f31.4\fP Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。 +\f31.4\fP \- Javadocは、JDK 1.4で導入されたアサーションを含むコードを受け付けます。 .TP 2 o -\f31.3\fP Javadoc は、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +\f31.3\fP \- Javadocは、JDK 1.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 .RE -.LP -javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。 -.LP +javacでコードをコンパイルするときに使用した値に対応する\f2release\fPの値を使用します。 .TP 3 \-sourcepath\ sourcepathlist -パッケージ名または \-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 という名前のパッケージをドキュメント化する場合に、そのソースファイルが次の場所にあるとします。 +パッケージ名または\f2\-subpackages\fPを\f2javadoc\fPコマンドに渡すときに、ソース・ファイル(.\f2.java\fP)を見つけるための検索パスを指定します。\f2sourcepathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 +.br +.br +\f2\-sourcepath\fPオプションを使用できるのは、javadocコマンドにパッケージ名を渡す場合のみです。このパスからは、\f2javadoc\fPコマンドに渡される\f2.java\fPファイルは検索されません。(\f2.java\fPファイルを検索するには、そのディレクトリにcdによって移動するか、または各ファイルの先頭にパスを含めます(1つ以上のクラスのドキュメント化を参照)。)\f2\-sourcepath\fPが省略された場合、Javadocは、クラス・パスを使用してソース・ファイルを検索します(\-classpathを参照)。したがって、デフォルトの\-sourcepathは、クラス・パスの値です。\-classpathを省略してパッケージ名をJavadocに渡すと、Javadocは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 +.br +.br +\f2sourcepathlist\fPには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。たとえば、\f2com.mypackage\fPという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが次の場所にあるとします。 .nf \f3 .fl @@ -2947,143 +2930,142 @@ .fl \fP .fi -このとき次のように、 \f2sourcepath\fP を、com/mypackage を含むディレクトリである \f2/home/user/src\fP に指定したあと、 パッケージ名 \f2com.mypackage\fP を指定します。 +この場合、次のようにして\f2sourcepath\fPを、\f2com/mypackage\fPを含むディレクトリである\f2/home/user/src\fPに指定してから、パッケージ名\f2com.mypackage\fPを指定します。 .nf \f3 .fl % \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP .fl .fi -この方法は、ソースパスの値とパッケージ名を連結して、ドットを (円記号) 「\\」に変えると、パッケージのフルパス \f2/home/user/src/com/mypackage になることを理解すると簡単です\fP。 -.LP -2 つのソースパスを設定するには、次のようにします。 +この方法は、ソース・パスの値とパッケージ名を連結して、ドットをスラッシュ「/」に変更すると、パッケージのフルパス\f2/home/user/src/com/mypackage\fPになることに気付くと覚えやすいです。 +.br +.br +2つのソース・パスを設定するには、次のようにします。 .nf \f3 .fl % \fP\f3javadoc \-sourcepath /home/user1/src:/home/user2/src com.mypackage\fP .fl .fi -.LP .TP 3 \-classpath\ classpathlist -javadoc が参照クラス (\f2.class\fP ファイル) の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスから参照されるすべてのクラスを指します。\f2classpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。classpathlist を指定するときは、 +Javadocが参照クラス(\f2.class\fPファイル)の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。\f2classpathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。\f2classpathlist\fPを指定するときは、 .na -\f2クラスパス\fP @ +\f2クラス・パス\fP @ .fi -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 内のライブラリに依存しているとします。このとき次のように指定します。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#generalのドキュメントにある指示に従ってください。 +.br +.br +\f2\-sourcepath\fPが省略された場合、Javadocツールはクラス・ファイルを検索するときのみでなく、ソース・ファイルを検索するときにも\f2\-classpath\fPを使用します(下位互換性のため)。したがって、ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\f2\-sourcepath\fPと\f2\-classpath\fPの両方を使用します。 +.br +.br +たとえば、\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 が指定されなかった場合、Javadoc ツールはほかのツールと同じく、CLASSPATH 環境変数が設定されていればその値を使用します。どちらも設定されていない場合、Javadoc ツールは現在のディレクトリからクラスを検索します。 -.LP -Javadoc ツールが \f2\-classpath\fP を使用してユーザークラスを検索する方法について、拡張クラスやブートストラップクラスと関連付けて説明している情報を入手するには、 +他のツールと同様に、\f2\-classpath\fPが指定されていない場合、CLASSPATH環境変数が設定されていれば、Javadocツールはその環境変数を使用します。どちらも設定されていない場合、Javadocツールは現在のディレクトリからクラスを検索します。 +.br +.br +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 つの呼び出しを区別できない)。 -.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 プログラムが展開されていないワイルドカードを認識することはありません。 -.LP +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.htmlを参照してください。 +.br +.br +便宜上、\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仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 .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を使用します。このオプションは、ソース・ファイルの処理で説明したとおり、ソース・ツリーにあるがパッケージには属していないソース・ファイルを処理しないので役立ちます。 +.br +.br +例を示します。 .nf \f3 .fl % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP .fl .fi -このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 -.LP -\f2\-subpackages\fP と \f2\-exclude\fP を組み合わせて使用すると、特定のパッケージを除外できます。 -.LP +このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 +.br +.br +\f2\-subpackages\fPを\f2\-exclude\fPと組み合せて使用すると、特定のパッケージを除外できます。 .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 も除外される点に注意してください。 -.LP +この場合、\f2java.io\fP、\f2java.util\fP、\f2java.math\fPなどは組み込まれますが、\f2java.net\fPと\f2java.lang\fPをルートに持つパッケージは除外されます。\f2java.lang\fPのサブパッケージである\f2java.lang.ref\fPが除外される点に注意してください。 .TP 3 \-bootclasspath\ classpathlist -ブートクラスが存在するパスを指定します。ブートクラスとは、通常、Java プラットフォームのコアクラスのことです。ブートクラスパスは、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、 +ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。ブート・クラスパスは、Javadocツールがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、 .na -\f2「クラスの検索方法」\fP @ +\f2クラスの検索方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。コロン (:) を、 \f2classpathlist\fP 内のディレクトリ間の区切り文字として使用します。 -.LP +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。\f2classpathlist\fP内の複数のディレクトリは、コロン(:)で区切ります。 .TP 3 \-extdirs\ dirlist -拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java 拡張機能機構を使うすべてのクラスです。extdirs は、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、前述の \f2\-classpath\fP を参照してください。コロン (:) を、 \f2dirlist\fP 内のディレクトリ間の区切り文字として使用します。 -.LP +拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。extdirsは、Javadocツールがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、前述の\f2\-classpath\fPを参照してください。\f2dirlist\fP内の複数のディレクトリは、コロン(:)で区切ります。 .TP 3 \-verbose -javadoc の実行中に詳細なメッセージを表示します。verbose オプションを指定しないと、ソースファイルのロード時、ドキュメントの生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時にメッセージが表示されます。verbose オプションを指定すると、各 Java ソースファイルの解析に要した時間 (ミリ秒単位) など、追加のメッセージが表示されます。 -.LP +Javadocの実行中に詳細なメッセージを表示します。verboseオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 .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 クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、 \f2\-breakiterator\fP オプションは、1.2 以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 +http://download.oracle.com/javase/7/docs/api/java/text/BreakIterator.htmlの国際化された文境界を使用します(他のすべてのロケールはすでに\f2BreakIterator\fPを使用)。\f2最初の文\fPとは、パッケージ、クラス、またはメンバーの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバーの要約にコピーされ、アルファベット順の索引にコピーされます。 +.br +.br +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 valid」など、ほとんどの省略表記が処理されますが、「Mr. Smith」などは処理されません。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する +breakiterator文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no. is valid」など、ほとんどの省略表記が処理されますが、「Mr.Smith」は処理されません。HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止します。 .RE -.LP -注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\\\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。この件で皆様に余分の手間をおかけし、混乱を招いたことをお詫びいたします。 +注意: 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 -.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 +\f3重要\fP \- \f2\-locale\fPオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより\f2前\fP(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンドライン・オプションのみ、指定する順序に依存します。 +.br +.br +Javadocがドキュメントを生成するときに使用するロケールを指定します。この引数は、java.util.Localeのドキュメントで説明されているロケールの名前です。たとえば、\f2en_US\fP (英語、米国)または\f2en_US_WIN\fP (Windowsで使用される英語)などです。 +.br +.br +ロケールを指定すると、指定したロケールのリソース・ファイルがJavadocによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。ただし、このオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 .TP 3 \-encoding\ name -ソースファイルのエンコーディングの名前 ( \f2EUCJIS/SJIS\fP など) を指定します。 このオプションが指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。 -.LP -\-docencoding および \-charset も参照してください。 -.LP +ソース・ファイルのエンコーディングの名前(\f2EUCJIS/SJIS\fPなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 +.br +.br +\-docencodingおよび\-charsetも参照してください。 .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の間に空白文字を入れないように注意してください。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、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 @@ -3094,47 +3076,47 @@ Classic VM (build JDK\-1.2\-V, green threads, sunwjit) .fl .fi -出力ストリームには標準ドックレットのバージョン番号が含まれます。 +(出力ストリームには標準ドックレットのバージョン番号が含まれます。) .RE .SS 標準ドックレットが提供するオプション .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を実行すると生成先ディレクトリが自動的に作成されます。 +.br +.br +たとえば、次の例では、\f2com.mypackage\fPパッケージのドキュメントが生成され、その結果が\f2/home/user/doc/\fPディレクトリに保存されます。 .nf \f3 .fl % \fP\f3javadoc \-d /home/user/doc com.mypackage\fP .fl .fi -.LP .TP 3 \-use -ドキュメント化されるクラスおよびパッケージごとに 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 -生成された [使用] ページにアクセスするには、目的のクラスまたはパッケージに移動し、ナビゲーションバーの [使用] リンクをクリックします。 +ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。 +.br +.br +たとえば、Stringの使用ページに何が表示されるかを見てみましょう。\f2java.awt.Font\fPクラスの\f2getName()\fPメソッドは、\f2String\fP型の値を返します。したがって、\f2getName()\fPは\f2String\fPを使用しているので、\f2String\fPの使用ページにこのメソッドが表示されます。 +.br +.br +ただし、ドキュメント化されるのはAPIの使用のみで、実装はドキュメント化されません。あるメソッドが、その実装の中で\f2String\fPを使用していても、引数として文字列をとったり、文字列を返したりしない場合は、\f2String\fPの「使用」とはみなされません。 +.br +.br +生成された使用ページにアクセスするには、まず目的のクラスまたはパッケージに移動し、ナビゲーション・バーの「使用」リンクをクリックします。 .TP 3 \-version -生成ドキュメントに、@version のテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している Javadoc ツールのバージョンを確認するには \f2\-J\-version\fP オプションを使用します。 -.LP +生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用しているJavadocツールのバージョンを確認するには\f2\-J\-version\fPオプションを使用します。 .TP 3 \-author -生成ドキュメントに、@author のテキストを組み込みます。 -.LP +生成ドキュメントに、@authorのテキストを組み込みます。 .TP 3 \-splitindex -索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる索引エントリ用に 1 つのファイルを作成します。 -.LP +索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに1つのファイルと、アルファベット以外の文字で始まる索引エントリ用に1つのファイルを作成します。 .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 @@ -3143,7 +3125,7 @@ .fi .TP 3 \-doctitle\ title -概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル 1 の見出しとして、上部ナビゲーションバーのすぐ下に置かれます。\f2title\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 +概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\f2title\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2title\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .nf \f3 .fl @@ -3152,48 +3134,45 @@ .fi .TP 3 \-title\ title -\f3このオプションはもう存在していません。\fPこのオプションは Javadoc 1.2 のベータ版にしか存在していませんでした。このオプションの名前は \f2\-doctitle\fP に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 -.LP +\f3このオプションは、現在は存在していません。\fPJavadoc 1.2のベータ版にしか存在していませんでした。このオプションは、\f2\-doctitle\fPという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 .TP 3 \-header\ header -各出力ファイルの上端に配置するヘッダーテキストを指定します。ヘッダーは、上部ナビゲーションバーの右側に配置されます。\f2header\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2header\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 +各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、上部ナビゲーション・バーの右側に配置されます。\f2header\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2header\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .nf \f3 .fl % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP .fl .fi -.LP .TP 3 \-footer\ footer -各出力ファイルの下端に配置するフッターテキストを指定します。フッターは、下部ナビゲーションバーの右側に配置されます。\f2footer\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2footer\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 -.LP +各出力ファイルの最下部に配置するフッター・テキストを指定します。フッターは、下部ナビゲーション・バーの右側に配置されます。\f2footer\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2footer\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .TP 3 \-top -各出力ファイルの上端に配置するテキストを指定します。 -.LP +各出力ファイルの最上部に配置するテキストを指定します。 .TP 3 \-bottom\ text -各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーションバーより下の、ページの最下部に配置されます。 \f2text\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。引用符を \f2text\fP 内で使用する場合、引用符をエスケープしなければならない可能性があります。 -.LP +各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーション・バーより下の、ページの最下部に配置されます。\f2text\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2text\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .TP 3 \-link\ extdocURL -javadoc により生成された既存の外部参照クラスのドキュメンテーションへのリンクを作成します。引数を 1 つとります。 -.LP +既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。引数を1つとります。 .RS 3 .TP 2 o -\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:」ベースにかかわらず、スラッシュを区切り文字として使用します ( +\f4extdocURL\fPは、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。後で例を示します。このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\f2\-linkoffline\fPを使用します)。Javadocツールは、\f2package\-list\fPファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。Javadocツールの実行時に、\f2extdocURL\fPの値がそのまま、作成された\f2<A HREF>\fPリンク内にコピーされます。したがって、\f2extdocURL\fPはファイルへのURLではなく、\f2ディレクトリ\fPへのURLである必要があります。 +.br +.br +\f2extdocURL\fPに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクの場合、ユーザーが渡す値は、生成先ディレクトリ(\f2\-d\fPで指定)からリンク先となるパッケージを含むディレクトリへの相対パスにする必要があります。 +.br +.br +通常、絶対リンクを指定する場合は、\f2http:\fPリンクを使用します。Webサーバーを持たないファイル・システムにリンクする場合は、\f2file:\fPリンクを使用できます。ただし、この方法は、同じファイル・システムを共有する生成ドキュメントにすべてのユーザーがアクセスする必要がある場合以外は使用しないでください。 +.br +.br +すべての場合、すべてのオペレーティング・システムで、絶対URLと相対URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します( .na -\f2URL Memo\fP @ +\f2URLのドキュメント\fP @ .fi -http://www.ietf.org/rfc/rfc1738.txt で指定)。 +http://www.ietf.org/rfc/rfc1738.txtで指定)。 .RS 3 .TP 3 http: ベースの絶対リンク: @@ -3206,81 +3185,90 @@ \f2\-link <directory>/<directory>/.../<name>\fP .RE .RE -.LP -javadoc の 1 回の実行で複数の \f2\-link\fP オプションを指定すれば、複数のドキュメントへのリンクを作成できます。 \f3\-linkoffline または \-link の選択\fP +1回のJavadocの実行で、複数の\f2\-link\fPオプションを指定して複数のドキュメントへのリンクを作成できます。 +.br +.br +\f3\-linkofflineまたは\-linkの選択\fP: +.br .br \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 -外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されていない場合)このような状況は、リンク先のドキュメントがファイアウォールの向こう側にある場合に発生します。 +外部APIドキュメントへの絶対URLを使用する場合(プログラムがそのURLに接続し、読取りを行うことがシェルによって\f2許可されていない\fP場合)このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 .RE -.LP -\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2java.lang\fP、 \f2java.io\fP 、その他の Java プラットフォームパッケージ ( +.br +.br +\f3外部ドキュメントへの絶対リンクの使用例\fP \- .na -\f2http://download.oracle.com/javase/7/docs/api/\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/\fP @ .fi -http://download.oracle.com/javase/7/docs/api/ 内) にリンクしたい場合があります。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP や \f2\-d\fP など、その他のオプションは示していません。 +http://docs.oracle.com/javase/7/docs/api/内の\f2java.lang\fP、\f2java.io\fP、その他のJavaプラットフォーム・パッケージにリンクしたいとします。次のコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\f2com.mypackage\fPパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス・ツリー内の\f2Object\fPクラスへのリンクが含まれています。(\f2\-sourcepath\fPや\f2\-d\fPなどの他のオプションは表示されません。) .nf \f3 .fl - % \fP\f3javadoc \-link http://download.oracle.com/javase/7/docs/api/ com.mypackage\fP + % \fP\f3javadoc \-link http://docs.oracle.com/javase/7/docs/api/ com.mypackage\fP .fl .fi -\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 パッケージをドキュメント化するには、次のコマンドを実行します。 +\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 % \fP\f3javadoc \-d ./spi \-link ../api com.spipackage\fP .fl .fi -.LP -\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: +\f2\-link\fPの引数は、宛先ディレクトリ(\f2docs/spi\fP)からの相対パスです。 +.br +.br +\f3詳細\fP \- \f2\-link\fPオプションを使用すると、コードからは参照されていても、今回のJavadocの実行ではドキュメント化\f2されない\fPというクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\f2extdocURL\fPに指定する必要があります。これにより、たとえば、サード・パーティのドキュメントから\f2http://java.sun.com\fP上の\f2java.*\fPのドキュメントにリンクすることができます。 +.br +.br +今回の実行でJavadocによって生成されるドキュメント内のAPIのみを対象にリンクを作成する場合は、\f2\-link\fPオプションを省略します。(\f2\-link\fPオプションが指定されていないと、Javadocツールは、外部参照のドキュメントへのリンクを作成しません。これは、そのドキュメントが存在するかどうか、および存在する場合はその場所がわからないからです。) +.br +.br +このオプションでは、生成ドキュメント内の複数の場所にリンクを作成できます。 +.br +.br +もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対してJavadocを実行した後、他方のパッケージ・セットに対してJavadocを再度実行すると、両セット間に双方向のリンクを作成できます。 +.br +.br +\f3クラスの参照方法\fP \- 外部参照クラスへのリンクを、テキスト・ラベルのみではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\f2import\fP文、宣言のいずれかで参照する必要があります。次に、クラス\f2java.io.File\fPを参照する方法の例を示します。 .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 文に置きます。 +\f2void foo(File f){}\fP +.br +この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースの戻り値の型またはパラメータの型に置くか、\f2implements\fP、\f2extends\fP、または\f2throws\fP文に置きます。 .RE -.LP -重要な結果として、 \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 のパッケージリストは +重要な結果として、\f2\-link\fPオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。(テキストはハイパーテキスト・リンクが付けられずに表示されます。)リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も安全な方法は前述したとおり、そのクラスをインポートすることです。 +.br +.br +\f3パッケージ・リスト\fP \- \f2\-link\fPオプションには、Javadocツールによって生成される\f2package\-list\fPという名前のファイルが、\f2\-link\fPに指定したURLに存在していることが必要です。\f2package\-list\fPファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前の例では、Javadocツールは、指定されたURLで\f2package\-list\fPという名前のファイルを探し、パッケージ名を読み込んだ後、そのURLにあるそれらのパッケージへのリンクを作成しました。 +.br +.br +たとえば、Java SE 6 APIのパッケージ・リストは .na -\f2http://download.oracle.com/javase/7/docs/api/package\-list\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/package\-list\fP @ .fi -http://download.oracle.com/javase/7/docs/api/package\-list にあり、次のような内容で始まっています。 +http://docs.oracle.com/javase/7/docs/api/package\-listにあり、次のような内容で始まっています。 .nf \f3 .fl @@ -3298,89 +3286,102 @@ .fl java.awt.font .fl - その他 + etc. .fl \fP .fi -.LP -\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 +\f2\-link\fPオプションを指定せずにJavadocを実行した場合、Javadocは外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\f2\-link\fPオプションを指定した場合、Javadocツールは、指定された\f2extdocURL\fPの場所にある\f2package\-list\fPファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\f2extdocURL\fPが名前の前に付加されます。 +.br +.br +すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。Javadocツールは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 +.br +.br +\f3複数のリンク\fP \- 複数の\f2\-link\fPオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。\ Javadoc 1.2には、複数の\f2\-link\fPコマンドを指定できないという既知のバグがあります。これは1.2.2で修正されました。 +.br +.br +リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。 +.br +.br +\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2... \fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP +.br +.br +\f2extdocURL1\fP、\ \f2extdocURL2\fP、\ ... \f2extdocURLn\fPは、それぞれ外部ドキュメントのルートを指し、各ルートには、\f2package\-list\fPという名前のファイルが入っています。 +.br +.br +\f3クロスリンク\fP \- まだ生成されていない2つ以上のドキュメントをクロスリンクする場合は、「ブートストラップ」が必要になります。つまり、どのドキュメントについても\f2package\-list\fPが存在していない場合は、最初のドキュメントに対してJavadocツールを実行する時点で、2番目のドキュメントの\f2package\-list\fPはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成し直す必要があります。 +.br +.br +この場合、最初のドキュメント生成の目的は、\f2package\-list\fPを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部の\f2package\-list\fPファイルが存在しない場合は、Javadocツールから警告が出力されます。 .TP 3 \-linkoffline\ extdocURL\ packagelistLoc -このオプションは \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 の検索場所を示す引数です。 +このオプションは\f2\-link\fPのバリエーションの1つです。どちらも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。Javadocツール自体が「オフライン」になっているとき(Web接続を使用してドキュメントにアクセスできないとき)、Web上のドキュメントにリンクするには、\f2\-linkoffline\fPオプションを使用します。 +.br +.br +厳密には、外部ドキュメントの\f2package\-list\fPファイルにアクセスできないとき、またはこのファイルが\f2extdocURL\fPで指定された場所には存在せず、\f2packageListLoc\fPで指定できる別の場所(通常ローカル)に存在するとき、\f2\-linkoffline\fPを使用します。したがって、\f2extdocURL\fPにWWW上でしかアクセスできない場合は、\f2\-linkoffline\fPを指定することにより、ドキュメントの生成時にJavadocツールがWebに接続できる必要があるという制約がなくなります。 +.br +.br +もう1つの用途は、ドキュメントを更新するための「ハッキング」として使用することです。パッケージのセット全体に対してJavadocを実行した後、変更した一部のパッケージに対してのみJavadocを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。後で例を示します。 +.br +.br +\f2\-linkoffline\fPオプションは引数を2つ取ります。第1引数は\f2<a href>\fPリンクに組み込まれる文字列を指定する引数、第2引数は\f2package\-list\fPの検索場所を指定する引数です。 .RS 3 .TP 2 o -\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。相対リンクの場合、その値は、( \f2\-d\fP で指定された) 生成先ディレクトリからリンク先パッケージのルートへの相対パスにすべきです。詳細は、\-link オプションの \f2extdocURL\fP \f2を参照\fP してください。 +\f4extdocURL\fPは、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\f2\-d\fPで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\f2\-link\fPオプションの\f2extdocURL\fPを参照してください。 .TP 2 o -\f4packagelistLoc\fP は、外部ドキュメントの \f2package\-list\fP ファイルを含むディレクトリへのパスまたは URL です。これは、URL (http: または file:) でもファイルパスでもかまいませんし、絶対パスでも相対パスでもかまいません。相対パスの場合は、javadoc が実行されるカレントディレクトリからの相対パスとして指定します。ファイル名 \f2package\-list\fP は含めないでください。 +\f4packagelistLoc\fPは、外部ドキュメントの\f2package\-list\fPファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、javadocが実行される\f2現在の\fPディレクトリからの相対パスとして指定します。ファイル名の\f2package\-list\fPは含めないでください。 .RE -.LP -1 回の javadoc 実行で複数の \f2\-linkoffline\fP オプションを指定できます。1.2.2 より前は、複数のオプションを指定することはできませんでした。 -.LP -\f3外部ドキュメントへの絶対リンクの使用例\fP \- http://download.oracle.com/javase/7/docs/api/ 内の \f2java.lang\fP、 \f2java.io\fP 、およびその他の Java SE プラットフォームパッケージ \f2にリンクしたくても、\fPWeb にアクセスできない場合を考えます。ブラウザで \f2、\fP +1回のJavadocの実行で、複数の\f2\-linkoffline\fPオプションを指定できます。(1.2.2より前は、1つのオプションしか指定できませんでした。) +.br +.br +\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2http://docs.oracle.com/javase/7/docs/api/\fP内の\f2java.lang\fP、\f2java.io\fP、その他のJava SEプラットフォーム・パッケージにリンクしたいが、Webにアクセスできないとします。ブラウザで、 .na -\f2http://download.oracle.com/javase/7/docs/api/package\-list\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/package\-list\fP @ .fi -http://download.oracle.com/javase/7/docs/api/package\-list にある package\-list ファイルを開き、それをローカルディレクトリに保存し、第 2 引数 \f2packagelistLoc\fP でこのローカルコピーへのパスを指定します。この例では、パッケージリストファイルはカレントディレクトリ "\f2.\fP" に保存されています。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP など、その他のオプションは示していません。 +http://docs.oracle.com/javase/7/docs/api/package\-listにある\f2package\-list\fPファイルを開き、それをローカル・ディレクトリに保存し、第2引数\f2packagelistLoc\fPでこのローカル・コピーの場所を指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ「\f2.\fP」に保存されています。次のコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\f2com.mypackage\fPパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス・ツリー内の\f2Object\fPクラスへのリンクが含まれています。(\f2\-sourcepath\fPなど、他の必要なオプションは表示されません。) .nf \f3 .fl -% \fP\f3javadoc \-linkoffline http://download.oracle.com/javase/7/docs/api/ . com.mypackage\fP +% \fP\f3javadoc \-linkoffline http://docs.oracle.com/javase/7/docs/api/ . com.mypackage\fP .fl .fi -.LP -\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 +\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の相対リンクの例を参照してください。 +.br +.br +\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ファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 +.br +.br +\f3複数のドキュメントへのリンク\fP \- 参照先となる生成ドキュメントごとに\f2\-linkoffline\fPを1つずつ含めることができます(わかりやすくするために、オプションごとに改行して示しています)。 +.br +.br \f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP .br \f2\ \ \ \ \ \ \ \ \ \ \fP\f4\-linkoffline\fP \f2extdocURL2\fP \f2packagelistLoc2\fP \f2\\\fP .br -\f2\ \ \ \ \ \ \ \ \ \ ...\fP -.LP -\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渡します。 +\f2\ \ \ \ \ \ \ \ \ \ ...\fP +.br +.br +\f3ドキュメントの更新\fP \- \f2\-linkoffline\fPオプションのもう1つの用途は、プロジェクトに大量のパッケージが含まれていて、すでにツリー全体に対してJavadocの実行が完了している場合に、次の実行では、少量の変更を手早く加えた後、ソース・ツリーのごく一部に対してのみJavadocを再実行する場合に便利です。これは、ドキュメンテーション・コメントに対してのみ変更を加え、宣言は変更しない場合にのみ正しく処理されるので、ハッキングのようなものです。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 +.br +.br +まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(\f2update\fP)を作成します。元の生成先ディレクトリの名前が\f2html\fPだったとします。最も単純な例では、\f2html\fPディレクトリの親にcdによって移動します。\f2\-linkoffline\fPの第1引数にカレント・ディレクトリ「.」を設定し、第2引数に\f2package\-list\fPが検索される\f2html\fPへの相対パスを設定します。更新するパッケージのパッケージ名のみを渡します。 .nf \f3 .fl % \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP .fl .fi -Javadoc ツリーの終了後、 \f2update/com/package\fP 内の生成されたクラスのページをコピーし (概要や索引は除く)、 \f2html/com/package 内の元のファイルに上書きします\fP。 -.LP +Javadocツールの終了後、\f2update/com/package\fP内の生成されたクラスのページをコピーし(概要や索引は除く)、\f2html/com/package\fP内の元のファイルに上書きします。 .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ドキュメントからソース・ファイルへのリンクを追加します。リンクは、ソース・ファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルト・コンストラクタ、生成されたクラスなどに対しては作成されません。 +.br +.br +\f3このオプションは、\fP\f4\-public\fP\f3、\fP\f4\-package\fP\f3、\fP\f4\-protected\fP\f3、\fP\f4\-private\fP\f3の各オプションとは関係なく\fP\f3、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内の\fP\f4すべての\fP\f3非公開実装の詳細を公開します。\fP\f2\-private\fPオプションも併せて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 +.br +.br +各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\f2Button\fPクラスのソース・コードへのリンクは、「Button」という語の上に作成されます。 .nf \f3 .fl @@ -3392,7 +3393,7 @@ .fl \fP .fi -また、Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。 +また、Buttonクラスの\f2getLabel()\fPメソッドのソース・コードへのリンクは、「getLabel」という語の上に作成されます。 .nf \f3 .fl @@ -3400,24 +3401,24 @@ .fl \fP .fi -.LP .TP 3 \-group\ groupheading\ packagepattern:packagepattern:... -概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の \f2\-group\fP オプションで指定します。これらのグループは、コマンド行で指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。ある特定の \f2\-group\fP オプションでは、 \f2packagepattern\fP 式のリストに一致するパッケージが、 \f2groupheading\fP という見出しの表に表示されます。 +概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\f2\-group\fPオプションで指定します。これらのグループは、コマンドラインで指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。1つの\f2\-group\fPオプションでは、\f2packagepattern\fP式のリストに一致するパッケージが、見出しとして\f2groupheading\fPを持つ1つの表に表示されます。 .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 -.LP -\f3注: パターンやパターンリスト内でアスタリスクを使う場合は、 \fP\f4"java.lang*:java.util" のように、パターンリストを引用符で囲む必要があります。\fP -.LP -ユーザーが \f2\-group\fP オプションを 1 つも指定しなかった場合、「パッケージ」という見出しの 1 つのグループ内に、すべてのパッケージが配置されます。ドキュメント化されるパッケージの中に、指定したグループのどのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。 -.LP -たとえば、次のようにオプションを指定すると、ドキュメント化される 5 つのパッケージは、コアパッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.lang パッケージは除外されることになります。 +\f3注意: パターンやパターン・リスト内でアスタリスクを使用する場合は、\fP\f4"java.lang*:java.util"\fP\f3のように、パターン・リストを引用符で囲む必要があります。\fP +.br +.br +\f2\-group\fPオプションが指定されていない場合、すべてのパッケージが、「パッケージ」という見出しの1つのグループに入れられます。ドキュメント化されるパッケージの中に、どのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。 +.br +.br +たとえば、次のようにオプションを指定すると、ドキュメント化される5つのパッケージは、コア・パッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.langパッケージは除外されることになります。 .nf \f3 .fl @@ -3431,7 +3432,7 @@ この結果、次のようなグループ化が行われます。 .RS 3 .TP 3 -コアパッケージ +コア・パッケージ \f2java.lang\fP \f2java.lang.reflect\fP \f2java.util\fP @@ -3442,38 +3443,30 @@ その他のパッケージ \f2java.new\fP .RE -.LP .TP 3 \-nodeprecated -推奨されない API をドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlist オプションを指定した場合と同じ効果があることに加えて、ドキュメントのほかの部分全体でも、推奨されない API が生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。 -.LP +推奨されないAPIをドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlistオプションを指定した場合と同じ効果があることに加えて、ドキュメントの他の部分全体でも、推奨されないAPIが生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。 .TP 3 \-nodeprecatedlist -推奨されない API のリストを含むファイル (deprecated\-list.html)、およびナビゲーションバーのそのページへのリンクが生成されないようにします。ただし、ドキュメントのほかの部分では、推奨されない API が生成されます。このオプションは、推奨されない API がソースコードに含まれておらず、ナビゲーションバーをすっきりと見せたい場合に便利です。 -.LP +推奨されないAPIのリストを含むファイル(deprecated\-list.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。(ただし、ドキュメントの他の部分では、推奨されないAPIが生成されます。)このオプションは、推奨されないAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 .TP 3 \-nosince -生成ドキュメントから、@since タグに対応する「導入されたバージョン」 セクションを省略します。 -.LP +生成ドキュメントから、@sinceタグに関連付けられた「導入されたバージョン」セクションを省略します。 .TP 3 \-notree -生成されるドキュメントからクラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。 -.LP +生成ドキュメントから、クラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーション・バーの「階層ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。 .TP 3 \-noindex -生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。 -.LP +生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。 .TP 3 \-nohelp -出力の各ページの最上部と最下部にあるナビゲーションバーから「ヘルプ」リンクを省略します。 -.LP +出力の各ページの最上部と最下部にあるナビゲーション・バーから「ヘルプ」リンクを省略します。 .TP 3 \-nonavbar -生成されるページの最上部と最下部に表示されるナビゲーションバー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottom オプションには影響を与えません。 \f2\-nonavbar\fP オプションは、印刷するためだけにファイルを PostScript または PDF に変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。 -.LP +生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottomオプションには影響を与えません。\f2\-nonavbar\fPオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 .TP 3 \-helpfile\ path/filename -上部と下部のナビゲーションバーの「ヘルプ」リンクのリンク先となる代替ヘルプファイル \f2path/filename\fP のパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているヘルプファイル \f2help\-doc.html\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2help\-doc.html には限定されません。\fP Javadoc ツールは、ナビゲーションバー内のリンクを必要に応じて調整します。次に例を示します。 +最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイル\f2path/filename\fPのパスを指定します。このオプションが指定されていないと、Javadocツールは、ツール内でハードコードされているヘルプ・ファイル\f2help\-doc.html\fPを自動作成します。このオプションを使用すると、そのデフォルトの動作をオーバーライドできます。\f2filename\fPにはどんなファイル名でも指定でき、\f2help\-doc.html\fPに限定されません。Javadocツールは、ナビゲーション・バー内のリンクを必要に応じて調整します。次に例を示します。 .nf \f3 .fl @@ -3482,7 +3475,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 @@ -3491,15 +3484,14 @@ .fi .TP 3 \-serialwarn -@serial タグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 以降のバージョンでは、直列化の警告は生成されません1.2.2 より前の初期バージョンでは、警告が生成されます。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと \f2writeExternal\fP メソッドを適切にドキュメント化するのに役立ちます。 -.LP +@serialタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 (以降)では、直列化の警告は生成されません。(以前のバージョンとは逆の動作です。)このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\f2writeExternal\fPメソッドを適切にドキュメント化するのに役立ちます。 .TP 3 \-charset\ name -このドキュメント用の HTML 文字セットを指定します。この名前は、 +このドキュメント用のHTML文字セットを指定します。この名前は、 .na -\f2IANA Registry\fP @ +\f2IANAレジストリ\fP @ .fi -http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。たとえば、 +http://www.iana.org/assignments/character\-setsで指定された、推奨されるMIME名である必要があります。次に例を示します。 .nf \f3 .fl @@ -3514,34 +3506,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 も参照してください。 -.LP +http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2(4197265および4137321)を参照してください。 +.br +.br +\-encodingおよび\-docencodingも参照してください。 .TP 3 \-docencoding\ name -生成される HTML ファイルのエンコーディングを指定します。この名前は、 +生成されるHTMLファイルのエンコーディングを指定します。この名前は、 .na -\f2IANA Registry\fP @ +\f2IANAレジストリ\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 も参照してください。 -.LP +\-encodingおよび\-charsetも参照してください。 .TP 3 \-keywords -HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。 -.LP -メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。 +HTMLメタ・キーワード・タグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチ・エンジンがページを見つける場合に役立ちます。(インターネット全体を検索する多くのサーチ・エンジンは、ページがメタタグを誤用している可能性があるため、メタタグを調べません。一方、検索を自身のWebサイトに限定している企業が提供するサーチ・エンジンは、メタタグを調べることによってメリットを得られます。) +.br +.br +メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラスStringは次のキーワードで開始します。 .nf \f3 .fl @@ -3555,16 +3547,21 @@ .fl \fP .fi -.LP .TP 3 \-tag\ \ tagname:Xaoptcmf:"taghead" -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 (タグの無効化) +Javadocツールがドキュメンテーション・コメント内の引数を1つ取る単純なカスタムブロック・タグ\f2@\fP\f2tagname\fPを解釈できるようにします。これにより、Javadocツールはタグ名の「スペルチェック」を行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\f2\-tag\fPオプションを組み込むことが重要です。今回の実行では出力されないタグは、\f2X\fPを付けて無効にします。 +.br +.br +コロン(\f4:\fP)が常に区切り文字になります。\f2tagname\fPでコロンを使用する方法については、タグ名でのコロンの使用を参照してください。 +.br +.br +\f2\-tag\fPオプションは、タグの見出し\f2taghead\fPを太字で出力します。その次の行には、このオプションの引数で指定したテキストが続きます(下の例を参照)。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\f2@return\fPや\f2@author\fPなど)の出力とよく似ています。\f2taghead\fPを省略すると、\f2tagname\fPが見出しとして表示されます。 +.br +.br +\f3タグの配置\fP \- 引数の\f4Xaoptcmf\fP部分は、ソース・コード内のタグを配置できる位置と、タグを(\f2X\fPを使用して)無効にできるかどうかを決定します。タグの配置位置を制限しない場合は\f4a\fPを指定します。それ以外の文字の組合せも可能です。 +.br +.br +\f4X\fP (タグの無効化) .br \f4a\fP (すべて) .br @@ -3579,8 +3576,9 @@ \f4m\fP (メソッド) .br \f4f\fP (フィールド) -.LP -\f3シングルタグの例\fP \- ソースコード内の任意の位置で使用できるタグのタグオプションの例を示します。 +.br +.br +\f3シングル・タグの例\fP \- ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。 .nf \f3 .fl @@ -3588,7 +3586,7 @@ .fl \fP .fi -@todo をコンストラクタ、メソッド、フィールドのみで使用する場合は、以下のオプションを使用します。 +@todoをコンストラクタ、メソッド、フィールドのみで使用する場合は、次のオプションを使用します。 .nf \f3 .fl @@ -3596,7 +3594,7 @@ .fl \fP .fi -上の例の最後のコロン (\f2:\fP) は、パラメータ区切り子ですが、見出しテキストの一部になっています (以下の例を参照)。次の例のように、 \f2@todo\fP タグを含むソースコードでは、いずれかのタグオプションを使用します。 +上の例の最後のコロン(\f2:\fP)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています(下の例を参照)。次の例のように、\f2@todo\fPタグを含むソース・コードでは、いずれかのタグ・オプションを使用します。 .nf \f3 .fl @@ -3604,7 +3602,7 @@ .fl \fP .fi -\f3タグ名にコロンを使用する\fP \- コロン (:) をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーションコメントの中では、次のように使用します。 +\f3タグ名でのコロンの使用\fP \- コロン(:)をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーション・コメントの中では、次のように使用します。 .nf \f3 .fl @@ -3616,7 +3614,7 @@ .fl \fP .fi -でこのタグオプションを使用すると、 +このタグ・オプションを使用すると、次のようになります。 .nf \f3 .fl @@ -3624,9 +3622,10 @@ .fl \fP .fi -\f3タグ名のスペルチェック (タグの無効化)\fP \- ソースコード内に配置した一部のカスタムタグの出力を抑制したい場合があります。この場合も、ソースコード内にすべてのタグを配置し、出力を抑制しないタグを有効にし、出力を抑制するタグを無効にします。 \f2X\fP が存在する場合はタグが無効になり、存在しない場合はタグが有効になります。これにより、Javadoc ツールは、検出したタグが入力ミスなどによる未知のタグであるかどうかを特定できます。未知のタグを検出した場合、Javadoc ツールは警告を出力します。 -.LP -すでに配置されている値に \f2X\fP を追加できます。こうしておけば、 \f2X を削除するだけでタグを有効にすることができます\fP。たとえば、@todo タグの出力を抑制したい場合、次のように指定します。 +\f3タグ名のスペルチェック(タグの無効化)\fP \- 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内に存在するすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\f2X\fPを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、Javadocツールは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。この場合は警告が出力されます。 +.br +.br +すでに配置されている値に\f2X\fPを追加できます。こうしておけば、\f2X\fPを削除するのみでタグを有効にすることができます。たとえば、@todoタグの出力を抑制する場合、次のように指定します。 .nf \f3 .fl @@ -3642,14 +3641,16 @@ .fl \fP .fi -.LP -構文 \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 を使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます。行の継続を示す文字は不要です。 +構文\f2\-tag todo:X\fPは、\f2@todo\fPがタグレットで定義されていても機能します。 +.br +.br +\f3タグの順序\fP \- \f2\-tag\fP (および\f2\-taglet\fP)オプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためのみのプレースホルダです。これらは標準タグ名のみを使用します。(標準タグの小見出しは変更できません。)これについては、下の例で説明します。 +.br +.br +\f2\-tag\fPがない場合は、\f2\-taglet\fPの位置によってその順序が決まります。タグが両方とも存在する場合、コマンドラインの最後にある方がその順序を決定します。これは、タグやタグレットがコマンドラインに指定された順番に処理されるためです。たとえば、\f2\-taglet\fPと\f2\-tag\fPの両方が「todo」という名前を持っている場合、コマンドラインの最後にある方が順序を決定します。 +.br +.br +\f3タグの完全セットの例\fP \- この例では、出力の「Parameters」と「Throws」の間に「To Do」を挿入します。「X」を使用して、@exampleが、ソース・コード内の今回の実行では出力されないタグであることを指定します。@argfileを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 .nf \f3 .fl @@ -3667,38 +3668,41 @@ .fl \fP .fi -.LP -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 タグにすべきです。それ以外の場合は注釈にすべきです。 +Javadocがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\f2\-tag\fPや\f2\-taglet\fPで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 +.br +.br +標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\f2\-tag\fPオプションを使用すると、このリストに追加されるタグ、すなわち標準タグがデフォルトの位置から移動します。つまり、標準タグの\f2\-tag\fPオプションを省略すると、これらはデフォルトの位置に配置されたままになります。 +.br +.br +\f3競合の回避\fP \- 固有の名前空間を細かく分けるには、パッケージに使用されている\f2com.mycompany.todo\fPという名前のように、ドット(.)で区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。つまり、\f2@todo\fPという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 +.br +.br +\f3注釈vs. Javadocタグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメントに影響を与えたりドキュメントを生成したりするためのものである場合、そのマークアップはJavadocタグにします。それ以外の場合は注釈にします。 .na -\f2「Comparing Annotations and Javadoc Tags」\fP @ +\f2注釈とJavadocタグの比較\fP @ .fi -http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#annotationsを参照してください。 -.LP -\-taglet オプションを使用して、より複雑なブロックタグやカスタムインラインタグを 作成することができます。 -.LP +http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#annotationsを参照してください。 +.br +.br +\-tagletオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグを作成することもできます。 .TP 3 \-taglet\ \ class -そのタグのドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。クラスの完全指定名を指定してください。このタグレットは、カスタムタグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプルタグレットについては、以下を参照してください。 +そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\f2クラス\fPの完全修飾名を指定してください。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプル・タグレットについては、次を参照してください。 .RS 3 .TP 2 o .na -\f2「タグレットの概要」\fP @ +\f2タグレットの概要\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/taglet/overview.html .RE -.LP -タグレットは、ブロックタグまたはインラインタグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。 -.LP -タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。 -.LP -タグレットのパスを指定するには、\f2\-tagletpath\fP オプションを使用します。以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。 +タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。 +.br +.br +タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。したがって、タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。 +.br +.br +タグレットへのパスを指定するには、\f2\-tagletpath\fPオプションを使用します。次に、生成されるページの「Parameters」と「Throws」の間に「To Do」タグレットを挿入する例を示します。 .nf \f3 .fl @@ -3718,25 +3722,21 @@ .fl \fP .fi -.LP -また、 \f2\-taglet\fP オプションを \f2\-tag\fP オプションの代わりに使用することもできますが、そうすると可読性が低下する可能性があります。 -.LP +また、\f2\-taglet\fPオプションを\f2\-tag\fPオプションのかわりに使用することもできますが、読みにくくなる可能性があります。 .TP 3 \-tagletpath\ \ tagletpathlist -taglet クラスファイル (.class) の検索パスを指定します。\f2tagletpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。 -.LP +tagletクラス・ファイル(.class)を検索するための検索パスを指定します。\f2tagletpathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。 .TP 3 \-docfilessubdirs\ -「\f2doc\-files\fP」ディレクトリの深いコピーを有効にします。つまり、コピー先には、サブディレクトリとすべてのコンテンツがコピーされます。たとえば、ディレクトリ \f2doc\-files/example/images\fP とそのすべての内容がコピーされます。ここでも、サブディレクトリを除外する指定が可能です。 -.LP +「\f2doc\-files\fP」ディレクトリのディープ・コピーを有効にします。つまり、宛先には、サブディレクトリとそのすべて内容が再帰的にコピーされます。たとえば、ディレクトリ\f2doc\-files/example/images\fPとその内容がすべてコピーされます。ここでも、サブディレクトリを除外する指定が可能です。 .TP 3 \-excludedocfilessubdir\ \ name1:name2... -「\f2doc\-files\fP」の、指定された名前のサブディレクトリをすべて除外します。これにより、SCCS とその他のソースコード制御サブディレクトリのコピーを防ぎます。 -.LP +指定された名前の「\f2doc\-files\fP」サブディレクトリをすべて除外します。これにより、SCCSとその他のソース・コード制御サブディレクトリのコピーを防ぎます。 .TP 3 \-noqualifier\ \ all\ | \ packagename1:packagename2:... -出力されるクラス名の先頭のパッケージ名 (パッケージ修飾子) を省略します。 \f2\-noqualifier\fP の引数は、「\f2all\fP」(すべてのパッケージ修飾子が省略される)、修飾子として削除すべきパッケージのコロン区切りリスト (ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。 -.LP +出力されるクラス名の先頭からパッケージ名(パッケージ修飾子)を省略します。\f2\-noqualifier\fPの引数は、「\f2all\fP」(すべてのパッケージ修飾子を省略)、修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。 +.br +.br 次の例では、すべてのパッケージ修飾子を省略します。 .nf \f3 @@ -3745,7 +3745,7 @@ .fl \fP .fi -次の例では、パッケージ修飾子 java.lang および java.io を省略します。 +次の例では、パッケージ修飾子「java.lang」および「java.io」を省略します。 .nf \f3 .fl @@ -3753,7 +3753,7 @@ .fl \fP .fi -次の例では、java で始まるパッケージ修飾子と com.sun というサブパッケージ (javax ではない) を省略します。 +次の例では、「java」で始まるパッケージ修飾子と「com.sun」というサブパッケージ(「javax」ではない)を省略します。 .nf \f3 .fl @@ -3761,11 +3761,10 @@ .fl \fP .fi -パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、 \f2\-noqualifier\fP を使用するかどうかにかかわらず有効です。 -.LP +パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。詳細は、名前が表示される方法を参照してください。このルールは、\f2\-noqualifier\fPを使用するかどうかにかかわらず有効です。 .TP 3 \-notimestamp\ -タイムスタンプが抑制されます。各ページ先頭近くにある、生成された HTML 内の HTML コメントでタイムスタンプが隠されます。Javadoc を 2 つのソースベースで実行し、それらに対して diff を実行するときにこのオプションを使用すると、タイムスタンプによって diff が発生しなくなるので便利です (このオプションを使用しないと、各ページで diff になります)。タイムスタンプには Javadoc のバージョン番号が含まれており、次のようになります。 +タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。Javadocを2つのソース・ベースで実行し、それらに対してdiffを実行するときにこのオプションを使用すると、タイムスタンプによってdiffが発生しなくなるので便利です(このオプションを使用しないと、各ページでdiffになります)。タイムスタンプにはJavadocのバージョン番号が含まれており、次のようになります。 .nf \f3 .fl @@ -3773,28 +3772,26 @@ .fl \fP .fi -.LP .TP 3 \-nocomment\ -主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。このオプションにより、元は異なる目的のためだったソースファイルを再利用し、新しいプロジェクトの早い段階でスケルトン HTML ドキュメントを作成できるようになりました。 -.LP +主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言のみを生成します。このオプションにより、元は異なる目的のためだったソース・ファイルを再利用し、新しいプロジェクトの早い段階でスケルトンHTMLドキュメントを作成できるようになります。 .TP 3 \-sourcetab tabLength -ソース内で各タブが獲得する空白の数を指定します。 +ソース内の各タブが取る空白文字の数を指定します。 .RE -.SH "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP -javadoc のコマンド行を短くしたり簡潔にしたりするために、 \f2javadoc\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) が入った 1 つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティングシステム上でも、任意の長さの javadoc コマンドを作成できます。 +Javadocのコマンドラインを短くしたり簡潔にしたりするために、\f2javadoc\fPコマンドに対する引数(\f2\-J\fPオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さのjavadocコマンドを作成できます。 .LP -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 +引数ファイルには、javacのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 .LP -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード(*)は使用できません。たとえば、\f2*.java\fPとは指定できません。引数ファイル内の引数で\f2@\fP文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fPオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .LP -javadoc を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javadoc は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +Javadocを実行するときに、各引数ファイルのパスとファイル名の先頭に\f2@\fP文字を付けて渡します。Javadocは、\f2@\fP文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .SS -引数ファイルを 1 つ指定する例 +引数ファイルを1つ指定する例 .LP -次のように、「\f2argfile\fP」という名前の単一の引数ファイル内に、Javadoc のすべての引数を格納します。 +次のようにして、「\f2argfile\fP」という名前の単一の引数ファイルに、すべてのJavadoc引数を格納できます。 .nf \f3 .fl @@ -3802,11 +3799,11 @@ .fl .fi .LP -この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。 +この引数ファイルには、次の例で示されている2つのファイルの内容を両方とも入れることができます。 .SS -引数ファイルを 2 つ指定する例 +引数ファイルを2つ指定する例 .LP -2 つの引数ファイルを作成できます。1 つは Javadoc オプション用、もう 1 つはパッケージ名またはソースファイル名用です。なお、次のリストでは行継続文字を使用していません。 +次のようにして、Javadocオプション用に1つ、パッケージ名またはソース・ファイル名用に1つというように、2つの引数ファイルを作成できます(なお、次のリストでは行継続文字を使用していません)。 .LP 次の内容を含む、「\f2options\fP」という名前のファイルを作成します。 .nf @@ -3848,7 +3845,7 @@ \fP .fi .LP -そのあと、次のコマンドを使用して javadoc を実行します。 +その後、次のコマンドを使用してJavadocを実行します。 .nf \f3 .fl @@ -3858,7 +3855,7 @@ .SS パス付きの引数ファイルの例 .LP -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。 +引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fPや\f2path2\fPから見た相対パスではありません。 .nf \f3 .fl @@ -3868,7 +3865,7 @@ .SS オプションの引数の例 .LP -次に、Javadoc オプションに対する引数だけを引数ファイルに格納する例を示します。ここでは \f2\-bottom\fP オプションを使用します。というのも、引数が長くなる可能性があるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。 +次に、Javadocオプションに対する引数のみを引数ファイルに格納する例を示します。ここでは\f2\-bottom\fPオプションを使用します。そのオプションには、長い引数を指定できるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。 .nf \f3 .fl @@ -3880,12 +3877,12 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font> + Other names may be trademarks of their respective owners.</font> .fl \fP .fi .LP -そのあと、次のようにして Javadoc ツールを実行します。 +その後、次のようにしてJavadocツールを実行します。 .nf \f3 .fl @@ -3893,7 +3890,7 @@ .fl .fi .LP -あるいは、引数ファイルの先頭に \f2\-bottom\fP オプションも組み込んだあと、次のように実行してもかまいません。 +あるいは、引数ファイルの先頭に\f2\-bottom\fPオプションを組み込んだ後、次のようにして実行します。 .nf \f3 .fl @@ -3902,34 +3899,34 @@ .fi .SH "名前" 実行 -.SH "Javadoc の実行" +.SH "Javadocの実行" .LP -\f3バージョン番号\fP \- javadoc のバージョン番号を判別するには、\f3javadoc \-J\-version\fP を使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。その出力を無効にするには、 \f2\-quiet\fP を使用します。 +\f3バージョン番号\fP \- Javadocのバージョン番号を判別するには、\f3javadoc \-J\-version\fPを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。\f2\-quiet\fPで無効にできます。 .LP -\f3公開プログラムインタフェース\fP \- Java 言語で記述されたプログラムから Javadoc ツールを起動するとき使用します。このインタフェースは \f2com.sun.tools.javadoc.Main にあります\fP (javadoc は再入可能)。詳細は、 +\f3公開プログラム・インタフェース\fP \- Java言語で記述されたプログラムからJavadocツールを起動するとき使用します。このインタフェースは\f2com.sun.tools.javadoc.Main\fPにあります(Javadocは再入可能)。詳細は、 .na -\f2「標準ドックレット」\fP @ +\f2標準ドックレット\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。 .LP -\f3ドックレットの実行\fP \- 下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、 +\f3ドックレットの実行\fP \- 下の説明は、標準HTMLドックレットを呼び出すためのものです。カスタム・ドックレットを呼び出すには、\-docletおよび\-docletpathオプションを使用します。特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .SH "簡単な例" .LP -javadoc は、パッケージ全体に対して実行することも、個々のソースファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソースファイルは \f2/home/src/java/awt/*.java にあります\fP。生成先ディレクトリは \f2/home/html です\fP。 +Javadocは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソース・ファイルは\f2/home/src/java/awt/*.java\fPにあります。生成先ディレクトリは\f2/home/html\fPです。 .SS -1 つ以上のパッケージのドキュメント化 +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。 +パッケージをドキュメント化するには、そのパッケージのソース・ファイル(\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 -javadoc を実行するには、 \f2cd\fP を使用してディレクトリを変更するか、 \f2\-sourcepath\fP オプションを使用します。以下の例では、両方の方法について説明します。 +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のサブパッケージである\f2java.lang.ref\fPが除外される点に注意してください。 .nf \f3 .fl @@ -3937,10 +3934,10 @@ .fl .fi .LP -ほかのパッケージツリーも下方にたどるには、 \f2java:javax:org.xml.sax のように、\fP それらのパッケージの名前を \-subpackages \f2の引数の末尾に追加します\fP。 +また、他のパッケージ・ツリーを下方にたどるには、\f2java:javax:org.xml.sax\fPのように、それらのパッケージの名前を\f2\-subpackages\fPの引数に追加します。 .TP 2 o -\f3ケース 2 \- ルートソースディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全指定のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。 +\f3ケース2 \- ルート・ソース・ディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全修飾のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する1つ以上のパッケージの名前を指定してJavadocを実行します。 .nf \f3 .fl @@ -3951,7 +3948,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 @@ -3960,7 +3957,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 @@ -3969,15 +3966,15 @@ .fi .RE .LP -結果: すべてのケースでパッケージ \f2java.awt\fP および \f2java.awt.event\fP 内の public および protected クラスとインタフェースについて、HTML 形式のドキュメントが生成され、指定された生成先ディレクトリ (\f2/home/html\fP) に HTML ファイルが保存されます。2 つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラスページという 3 つのフレームを持つことになります。 +結果: すべてのケースで\f2java.awt\fPおよび\f2java.awt.event\fPパッケージ内のpublicおよびprotectedクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリ(\f2/home/html\fP)にHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 .SS -1 つ以上のクラスのドキュメント化 +1つ以上のクラスのドキュメント化 .LP -また、1 つ以上のソースファイル (\f2.java\fP) を渡して、Javadoc ツールを実行することもできます。javadoc は、次の 2 つの方法のいずれかで実行できます。1 つは \f2cd\fP を使用してディレクトリを変更する方法、もう 1 つは \f2.java\fP ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソースファイル名を渡すときは、 \f2\-sourcepath\fP オプションは無視されます。アスタリスク (*) のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。 +また、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 @@ -3986,10 +3983,10 @@ % \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP .fl .fi -この例では、クラス \f2Button\fP と \f2Canvas\fP 、および名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。パッケージ名ではなくソースファイルが javadoc に引数として渡されているので、ドキュメントは、クラスのリストとメインページという 2 つのフレームを持つことになります。 +この例では、\f2Button\fPクラスと\f2Canvas\fPクラス、および名前が\f2Graphics\fPで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルがJavadocに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 .TP 2 o -\f3ケース 2 \- パッケージのルートディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソースファイルをドキュメント化する場合に便利です。パッケージのルートディレクトリに移り、各ソースファイルを、ルートからのパスとともに指定します。 +\f3ケース2 \- パッケージのルート・ディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソース・ファイルをドキュメント化する場合に便利です。パッケージのルート・ディレクトリに移り、各ソース・ファイルを、ルートからのパスとともに指定します。 .nf \f3 .fl @@ -3998,22 +3995,22 @@ % \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP .fl .fi -この例では、クラス \f2Button\fP および \f2Applet について、HTML 形式のドキュメントが生成されます\fP。 +この例では、\f2Button\fPクラスおよび\f2Applet\fPクラスについて、HTML形式のドキュメントが生成されます。 .TP 2 o -\f3ケース 3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する .java ファイルへの絶対パス (またはカレントディレクトリからの相対パス) を指定して \f2javadoc\fP を実行します。 +\f3ケース3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する\f2.java\fPファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定してJavadocを実行します。 .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 で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。 +この例では、\f2Button\fPクラス、および名前が\f2Graphics\fPで始まるクラスについて、HTML形式のドキュメントが生成されます。 .RE .SS パッケージとクラスのドキュメント化 .LP -パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に前述の 2 つの例を組み合わせた例を示します。 \f2\-sourcepath\fP は、パッケージへのパスに対しては使用できますが、個々のクラスのパスに対しては使用できません。 +パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\f2\-sourcepath\fPは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 .nf \f3 .fl @@ -4021,16 +4018,16 @@ .fl .fi .LP -この例では、パッケージ \f2java.awt\fP とクラス \f2Applet について、HTML 形式のドキュメントが生成されます\fP。Javadoc ツールは、 \f2Applet.java ソースファイル内にパッケージ宣言があれば、\fP その宣言に基づいて \f2Applet のパッケージ名を\fP 判定します。 +この例では、\f2java.awt\fPパッケージおよび\f2Applet\fPクラスについて、HTML形式のドキュメントが生成されます。(Javadocツールは、\f2Applet.java\fPソース・ファイル内にパッケージ宣言があれば、その宣言に基づいて\f2Applet\fPのパッケージ名を判別します。) .SH "使用例" .LP -Javadoc ツールには多くの便利なオプションがあり、その中にはほかのオプションよりも頻繁に使われるものがあります。ここで紹介するのは、Java プラットフォーム API に対して Javadoc ツールを実行するときに使用する実際のコマンドです。ここでは、Java SE Platform, Standard Edition, v1.2 の (約) 1500 個の public および protected クラスのドキュメントを生成するために、180M バイトのメモリーを使用します。 +Javadocツールには多くの便利なオプションがあり、その中には他のオプションよりも頻繁に使用されるものがあります。ここで紹介するのは、JavaプラットフォームAPIに対してJavadocツールを実行するときに使用する実際のコマンドです。Java SE Platform, Standard Edition, v1.2に存在する、約1500個のpublicおよびprotectedクラスのドキュメントを生成するために、180MBのメモリーを使用します。 .LP -同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。オプションの引数で絶対パスが使用されているため、同じ \f2javadoc\fP コマンドをどのディレクトリからでも実行できます。 +同じ例を2回掲載します。最初の例はコマンドラインから実行するもので、2番目の例はMakefileから実行するものです。オプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\f2javadoc\fPコマンドを実行できます。 .SS -コマンド行の例 +コマンドラインの例 .LP -次の例は、DOS などの一部のシェルでは長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェルスクリプトを記述します。 +次の例は、DOSなどの一部のシェルには長すぎます。この制限を回避するには、コマンドライン引数ファイルを使用します。または、シェル・スクリプトを記述します。 .nf \f3 .fl @@ -4058,7 +4055,7 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font>' \\ + Other names may be trademarks of their respective owners.</font>' \\ .fl \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\ .fl @@ -4071,13 +4068,13 @@ \fP .fi .LP -ここで、 \f2packages\fP は、処理対象のパッケージ名 ( \f2java.applet java.lang\fP など) が入っているファイルの名前です。各オプションの、単一引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー&ペーストする場合は、 \f2\-bottom\fP オプションから改行文字を削除してください。さらに、このあとの「注」も参照してください。 +ここで、\f2packages\fPは、処理対象のパッケージ名(\f2java.applet java.lang\fPなど)が入っているファイルの名前です。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。(たとえば、この例をコピー&ペーストする場合は、\f2\-bottom\fPオプションから改行文字を削除してください。)さらに、下の「注意」も参照してください。 .SS -Makefile の例 +Makefileの例 .LP -ここでは、GNU Makefile の例を示します。Windows の Makefile の例については、 +ここでは、GNU Makefileの例を示します。WindowsのMakefileの例については、 .na -\f2Windows の Makefile の作成方法\fP @ +\f2WindowsのMakefileの作成方法\fP @ .fi http://java.sun.com/j2se/javadoc/faq/index.html#makefilesを参照してください。 .nf @@ -4129,7 +4126,7 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font>' + Other names may be trademarks of their respective owners.</font>' .fl GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"' .fl @@ -4140,19 +4137,19 @@ \fP .fi .LP -Makefile の引数は、単一引用符で囲みます。 +Makefileの引数は、一重引用符で囲みます。 .LP -\f3注\fP +\f3注意\fP .RS 3 .TP 2 o -\-windowtitle \f2オプションを省略すると、\fP Javadoc ツールによってドキュメントタイトルがウィンドウタイトルにコピーされます。 \f2\-windowtitle\fP のテキストは基本的に \f2\-doctitle\fP のものと同じですが、HTML タグを含まない点が異なります。これは、HTML タグが raw テキストとしてウィンドウタイトル内に表示されるのを防ぐためです。 +\f2\-windowtitle\fPオプションを省略すると、Javadocツールによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\f2\-windowtitle\fPのテキストは、基本的に\f2\-doctitle\fPと同じです。ただし、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。. .TP 2 o -ここで行っているように \f2\-footer\fP オプションを省略すると、Javadoc ツールによってヘッダーのテキストがフッターにコピーされます。 +この例のように\f2\-footer\fPオプションを省略すると、Javadocツールによってヘッダー・テキストがフッターにコピーされます。 .TP 2 o -この例では必要ありませんが、\-\f2classpath\fP と \-\f2link\fP も重要なオプションです。 +この例では必要ありませんが、\f2\-classpath\fPと\f2\-link\fPも重要なオプションです。 .RE .SH "トラブルシューティング" .SS @@ -4160,35 +4157,35 @@ .RS 3 .TP 2 o -\f3Javadoc FAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、 +\f3JavadocのFAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、 .na -\f2「Javadoc FAQ」\fP @ +\f2Javadocの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 \- バグの一部は、バグ修正および変更のインポートでも参照できます。 .TP 2 o -\f3バージョン番号\fP \- 「バージョン番号」を参照してください。 +\f3バージョン番号\fP \- バージョン番号を参照してください。 .TP 2 o -\f3有効なクラスだけをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadoc は、有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、javadoc によるファイルの解析を防ぐことができます。 +\f3有効なクラスのみをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadocは、名前が有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、Javadocによるファイルの解析を防ぐことができます。 .RE .SS エラーと警告 .LP -エラーおよび警告メッセージには、ファイル名と宣言行 (ドキュメンテーションコメント内の特定の行ではない) の行番号が含まれます。 +エラーおよび警告メッセージには、ファイル名と宣言行(ドキュメンテーション・コメント内の特定の行ではない)の行番号が含まれます。 .RS 3 .TP 2 o -\f2"error: cannot read: Class1.java"\fP Javadoc ツールはカレントディレクトリに Class1.java クラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合 \f2./Class1.java と同じです\fP。 +「\f2エラー: Class1.javaを読み込めません\fP」: Javadocツールは現在のディレクトリにClass1.javaクラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合\f2./Class1.java\fPと同じです。 .RE .SH "環境" .RS 3 .TP 3 CLASSPATH -Javadoc がユーザークラスのファイルを探すときに使うパスを指定する環境変数です。この環境変数は、 \f2\-classpath\fP オプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。 +Javadocがユーザー・クラスのファイルを探すときに使用するパスを指定する環境変数です。この環境変数は、\f2\-classpath\fPオプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。 .:/home/classes:/usr/local/java/classes .RE .SH "関連項目" @@ -4211,7 +4208,7 @@ .TP 2 o .na -\f2Javadoc のホームページ\fP @ +\f2Javadocのホーム・ページ\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-jsp\-135444.html .TP 2 @@ -4223,14 +4220,14 @@ .TP 2 o .na -\f2クラスパスの設定\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#general +http://download.oracle.com/javase/7/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) +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.html#srcfiles(tools.jar) .RE
--- a/src/linux/doc/man/ja/javah.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/javah.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javah 1 "07 May 2011" +.TH javah 1 "21 Mar 2012" .LP .SH "名前" -javah \- C ヘッダーとスタブファイルジェネレータ +javah \- Cヘッダーとスタブ・ファイル・ジェネレータ .LP .LP -\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。 +\f3javah\fPは、JavaクラスからCヘッダー・ファイルとCソース・ファイルを作成します。これらのファイルは、Javaプログラミング言語で書かれたコードと、Cなどのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。 .LP .SH "形式" .LP @@ -42,44 +42,44 @@ .SH "説明" .LP .LP -\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。 +\f3javah\fPは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。.hファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。 .LP .LP -ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。 +ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fPに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方に付加されます。下線(_)が名前の区切り文字として使用されます。 .LP .LP -デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。 +デフォルトでは\f3javah\fPは、コマンドラインにリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\f2\-stubs\fPオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fPオプションを使用してください。 .LP .LP -新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。 +新しいネイティブ・メソッド・インタフェースである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 のどちらか一方だけが使われます。 +\-ddirectory +\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 @@ -95,23 +95,22 @@ .fl \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仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 .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
--- a/src/linux/doc/man/ja/javap.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/javap.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javap 1 "07 May 2011" +.TH javap 1 "21 Mar 2012" .LP .SH "名前" -javap \- Java クラスファイル逆アセンブラ +javap \- Javaクラス・ファイル逆アセンブラ .LP .LP -クラスファイルを逆アセンブルします。 +クラス・ファイルを逆アセンブルします。 .LP .SH "形式" .LP @@ -42,15 +42,15 @@ .SH "説明" .LP .LP -\f3javap\fP コマンドは、1 つまたは複数のクラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。 +\f3javap\fPコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fPは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\f3javap\fPはその出力を標準出力に表示します。 .LP .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 classes -注釈の処理対象となる 1 つ以上のクラス \f2DocFooter.class\fP など) のリスト (空白区切り)。クラスパスで見つかるクラスは、ファイル名 ( \f2/home/user/myproject/src/DocFooter.class\fP など) または URL ( \f2file:///home/user/myproject/src/DocFooter.class\fP など) で指定できます。 +注釈の処理対象となる1つ以上のクラス\f2DocFooter.class\fPなどのリスト(空白区切り)。クラス・パスで見つかるクラスは、ファイル名(\f2/home/user/myproject/src/DocFooter.class\fPなど)またはURL(\f2file:///home/user/myproject/src/DocFooter.class\fPなど)で指定できます。 .RE .LP @@ -101,7 +101,7 @@ .LP .LP -\f3javap DocFooter.class\fP がもたらす出力は次のようになります。 +\f3javap DocFooter.class\fPがもたらす出力は次のようになります。 .LP .nf \f3 @@ -127,7 +127,7 @@ .LP .LP -\f3javap \-c DocFooter.class\fP がもたらす出力は次のようになります。 +\f3javap \-c DocFooter.class\fPがもたらす出力は次のようになります。 .LP .nf \f3 @@ -247,28 +247,28 @@ .RS 3 .TP 3 \-help \-\-help \-? -\f3javap\fP のヘルプメッセージを出力します。 +\f3javap\fPのヘルプ・メッセージを出力します。 .TP 3 \-version -バージョン情報を表示します。 +バージョン情報を出力します。 .TP 3 \-l -行番号と局所変数テーブルを表示します。 +行番号とローカル変数表を出力します。 .TP 3 \-public -public クラスおよびメンバーだけを表示します。 +publicクラスおよびメンバーのみ表示します。 .TP 3 \-protected -protected および public のクラスとメンバーだけを表示します。 +protectedおよびpublicのクラスとメンバーのみを表示します。 .TP 3 \-package -package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。 +package、protected、およびpublicのクラスとメンバーのみ表示します。これがデフォルトです。 .TP 3 \-private \-p すべてのクラスとメンバーを表示します。 .TP 3 \-Jflag -ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。 +ランタイム・システムに直接\f2flag\fPを渡します。使用例を次に示します。 .nf \f3 .fl @@ -280,32 +280,32 @@ .fi .TP 3 \-s -内部の型シグニチャーを出力します。 +内部の型シグニチャを出力します。 .TP 3 \-sysinfo -処理中のクラスのシステム情報 (パス、サイズ、日付、MD5 ハッシュ) を表示します。 +処理中のクラスのシステム情報(パス、サイズ、日付、MD5ハッシュ)を表示します。 .TP 3 \-constants -static final 定数を表示します。 +static final定数を表示します。 .TP 3 \-c -クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは +クラスの各メソッドのために逆アセンブルされるコード、すなわちJavaバイトコードからなる命令を表示します。これらは .na -\f2「Java Virtual Machine Specification」\fP @ +\f2Java Virtual Machine Specification\fP @ .fi 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 環境変数設定を上書きします。 +\f3javap\fPがクラスを探すために使用するパスを指定します。デフォルトまたはCLASSPATH環境変数設定を上書きします。 .TP 3 \-bootclasspath path -ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\f2jre/lib/rt.jar\fPおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .TP 3 \-extdirs dirs -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。 +インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\f2java.ext.dirs\fPです。 .RE .LP
--- a/src/linux/doc/man/ja/javaws.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/javaws.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,16 +19,16 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javaws 1 "07 May 2011" +.TH javaws 1 "21 Mar 2012" .LP .SH "名前" -\f2javaws\fP コマンド行 +\f2javaws\fPコマンドライン .LP .SH "名前" .LP .LP -\f2javaws\fP \- Java Web Start 起動コマンド +\f2javaws\fP \- Java Web Start起動コマンド .LP .SH "形式" .LP @@ -44,30 +44,30 @@ \f2[run\-options]\fP .LP .LP -コマンド行実行オプション。実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。 +コマンドライン実行オプション。実行オプションは任意の順序で指定できます。各種実行オプションの詳細は、次の実行オプションを参照してください。 .LP .LP \f2<jnlp>\fP .LP .LP -JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。 +JNLP(Java Network Launching Protocol)ファイルのパスまたはURL(Uniform Resource Locator)のどちらかを指定できます。 .LP .LP \f2[control\-options]\fP .LP .LP -コマンド行制御オプション。制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。 +コマンドライン制御オプション。制御オプションは任意の順序で指定できます。各種制御オプションの詳細は、次の制御オプションを参照してください。 .LP .SH "説明" .LP .LP -\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。 +\f2javaws\fPコマンドは、JNLP(Java Network Launching Protocol)のリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションまたはアプレットを起動します。 .LP .LP -JNLP ファイルが指定された場合、 \f2javaws\fP は、その JNLP ファイルで指定された Java アプリケーション/アプレットを起動します。 +JNLPファイルが指定された場合、\f2javaws\fPは、そのJNLPファイルで指定されたJavaアプリケーション/アプレットを起動します。 .LP .LP -\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 +\f2javaws\fP起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 .LP .SH "実行オプション" .LP @@ -75,7 +75,7 @@ \f2\-offline\fP .LP .LP -Java Web Start をオフラインモードで実行します。 +Java Web Startをオフライン・モードで実行します。 .LP .LP \f2\-Xnosplash\fP @@ -87,25 +87,25 @@ \f2\-open <arguments>\fP .LP .LP -このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\f2\-open<arguments>\fPに置き換わります。 .LP .LP \f2\-print <arguments>\fP .LP .LP -このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\f2\-print<arguments>\fPに置き換わります。 .LP .LP \f2\-online\fP .LP .LP -オンラインモードを使用します (デフォルトの動作)。 +オンライン・モードを使用します(デフォルトの動作)。 .LP .LP \f2\-wait\fP .LP .LP -このオプションを指定した場合、 \f2javaws\fP プロセスは、アプリケーションが終了するまで終了しません。Windows プラットフォーム上では、このオプションは説明したとおりに機能しません。 +このオプションを指定した場合、\f2javaws\fPプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。 .LP .LP \f2\-verbose\fP @@ -117,13 +117,13 @@ \f2\-J<option>\fP .LP .LP -vm にオプションを補います。 +VMに対するオプションを指定します。 .LP .LP \f2\-system\fP .LP .LP -アプリケーションをシステムキャッシュからのみ実行します。 +アプリケーションをシステム・キャッシュのみから実行します。 .LP .SH "制御オプション" .LP @@ -131,7 +131,7 @@ \f2\-viewer\fP .LP .LP -Java コントロールパネルでキャッシュビューアを表示します。 +Javaコントロール・パネルでキャッシュ・ビューアを表示します。 .LP .LP \f2\-clearcache\fP @@ -143,13 +143,13 @@ \f2\-userConfig <property name>\fP .LP .LP -指定された配備プロパティーをクリアします。 +指定されたデプロイメント・プロパティをクリアします。 .LP .LP \f2\-userConfig <property name> <property value>\fP .LP .LP -指定された配備プロパティーを指定された値に設定します。 +指定されたデプロイメント・プロパティを指定された値に設定します。 .LP .LP \f2\-uninstall\fP @@ -169,54 +169,54 @@ .LP キャッシュにアプリケーションをインポートします。 .LP -.SH "インポートオプション" +.SH "インポート・オプション" .LP .LP \f2\-silent\fP .LP .LP -サイレントモードでインポートします (UI は表示されません)。 +サイレント・モードでインポートします(ユーザー・インタフェースは表示されません)。 .LP .LP \f2\-system\fP .LP .LP -システムキャッシュにアプリケーションをインポートします。 +システム・キャッシュにアプリケーションをインポートします。 .LP .LP \f2\-codebase <url>\fP .LP .LP -任意の codebase からリソースを取得します。 +指定したcodebaseからリソースを取得します。 .LP .LP \f2\-shortcut\fP .LP .LP -ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。 +ユーザーがプロンプトで許可した場合のようにショートカットをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。 .LP .LP \f2\-association\fP .LP .LP -ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。 +ユーザーがプロンプトで許可した場合のようにアソシエーションをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。 .LP .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://download.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。 .LP .SH "詳細情報" .LP .LP -Java Web Start の詳細は、 +Java Web Startの詳細は、 .na -\f2「Java Web Start」\fP @ +\f2Java Web Start\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javaws/index.htmlを参照してください。 .LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/linux/doc/man/ja/jcmd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,124 @@ +." Copyright (c) 1994, 2012, 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 jcmd 1 "22 Mar 2012" + +.LP +.SH "Name" +jcmd \- 診断コマンド +.LP +.LP +\f3jcmd\fPは、実行中のJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。 +.LP +.SH "形式" +.LP +.nf +\f3 +.fl + \fP\f3jcmd\fP [ option ] +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> PerfCounter.print +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> \f2command\fP [\f2arguments\fP] +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> \-f \f2file\fP +.fl +.fi + +.LP +.SH "説明" +.LP +.LP +\f3jcmd\fPは、この機能をサポートするJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。 +.LP +.LP +引数なしまたは\-lオプションを指定してjcmdを使用すると、実行中のJavaプロセスがプロセスID、メイン・クラスおよびコマンドライン引数とともに表示されます。 +.LP +.LP +プロセスIDをコマンドラインに指定すると、jcmdでは、このIDのプロセスに診断コマンド・リクエストが送信されます。 +.LP +.LP +メイン・クラスをコマンドラインに指定すると、jcmdでは、このメイン・クラスのすべてのJavaプロセスに診断コマンド・リクエストが送信されます。 +.LP +.LP +PerfCounter.print引数を指定すると、jcmdでは、ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。 +.LP +.LP +\-f オプションを指定すると、jcmdでは、\f2file\fPに保存されている診断コマンドがターゲットのJavaプロセスに送信されます。 +.LP +.SH "オプション" +.LP +.LP +各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述してください。 +.LP +.RS 3 +.TP 3 +\-l +実行中のJavaプロセスの一覧がプロセスID、メイン・クラスおよびコマンドライン引数とともに出力されます。 +.br +.TP 3 +\-h +ヘルプ・メッセージが出力されます。 +.br +.TP 3 +\-help +ヘルプ・メッセージが出力されます。 +.RE + +.LP +.SH "パラメータ" +.LP +.RS 3 +.TP 3 +pid +診断コマンド・リクエストを受信するプロセスを指定します。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。 +.br +.TP 3 +main class +診断コマンド・リクエストを受信するプロセスのメイン・クラスです。いくつかの実行中のJavaプロセスがこのメイン・クラスを共有している場合は、それらすべてのプロセスに診断コマンド・リクエストが送信されます。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。 +.br +.TP 3 +command [arguments] +\f2command\fPという名前の診断コマンドをターゲットのJavaプロセスに対して起動します。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\f3help\fPコマンドを呼び出せば表示されます。各診断コマンドには独自の\f2arguments\fPのセットがあり、\f3help\fPコマンドの後にコマンド名を指定して呼び出せば表示されます。 +.br +.TP 3 +Counter.print +ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。パフォーマンス・カウンタのリストはJavaプロセスによって異なる場合があります。 +.br +.TP 3 +\-f file +\f2file\fPからコマンドを読み取って、ターゲットのJavaプロセスで呼び出します。\f2file\fPでは、各コマンドを1行に記述する必要があります。#で始まる行は無視されます。すべての行が呼び出されるか、\f3stop\fPキーワードを含む行が読み取られると、\f2file\fPの処理が終了します。 +.RE + +.LP +.SH "関連項目" +.LP +.RS 3 +.TP 2 +o +jps(1) +.RE + +.LP +.LP +jps(1) +.LP +
--- a/src/linux/doc/man/ja/jconsole.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jconsole.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jconsole 1 "07 May 2011" +.TH jconsole 1 "21 Mar 2012" .LP .SH "名前" -jconsole \- Java 監視および管理コンソール +jconsole \- Java監視および管理コンソール .LP .RS 3 .TP 2 @@ -67,49 +67,49 @@ .RS 3 .TP 2 o -\f2pid\fPローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、 +\f2pid\fPローカルのJava VMのプロセスID。Java VMは、jconsoleを実行しているユーザーIDと同じユーザーIDを使用して実行する必要があります。詳細は、 .na -\f2「JMX 監視および管理」\fP @ +\f2JMXの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.htmlを参照してください。 .TP 2 o -\f2host\fP:\f2port\fP Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、 +\f2host\fP:\f2port\fP: Java VMを実行しているホスト・システムの名前と、Java VMを起動したときにシステム・プロパティ\f2com.sun.management.jmxremote.port\fPで指定したポート番号。詳細は、 .na -\f2「JMX 監視および管理」\fP @ +\f2JMXの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.htmlを参照してください。 .TP 2 o -\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。これについては、 +\f2jmxUrl\fP: .na \f2JMXServiceURL\fP @ .fi -http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。 +http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.htmlに記述されている接続先のJMXエージェントのアドレス。 .RE .RE .LP -.SH " 説明" +.SH "説明" .LP .LP -\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。 +\f3jconsole\fPコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンの監視と管理を行うグラフィカル・コンソール・ツールを起動します。 .LP .LP -Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。 +Windows上では、\f3jconsole\fPはコンソール・ウィンドウと関連付けられていません。ただし、なんらかの理由で\f3jconsole\fPコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-interval=n -更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。 +更新間隔を\f2n\fP秒に設定します(デフォルトは4秒)。 .TP 3 \-notile -最初にウィンドウをタイリングしません (複数の接続のため)。 +最初にウィンドウをタイリングしません(複数接続の場合)。 .TP 3 \-pluginpath plugins -JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。 +JConsoleプラグインの検索先となるディレクトリまたはJARファイルのリストを指定します。\f2plugins\fPパスには、次の名前のプロバイダ構成ファイルを含めてください。 .br .nf \f3 @@ -118,21 +118,20 @@ .fl \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://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.htmlクラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに1行ずつ含まれています。 .TP 3 \-version バージョン情報を出力して終了します。 .TP 3 \-help -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-J<flag> -jconsole が実行されている Java 仮想マシンに <flag> を渡します。 +jconsoleが実行されているJava仮想マシンに<flag>を渡します。 .RE .LP @@ -142,15 +141,15 @@ .TP 2 o .na -\f2JConsole の使用\fP @ +\f2JConsoleの使用\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html +http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html .TP 2 o .na -\f2「Java プラットフォームの監視および管理」\fP @ +\f2Javaプラットフォームの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html .RE .LP
--- a/src/linux/doc/man/ja/jdb.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jdb.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jdb 1 "07 May 2011" +.TH jdb 1 "21 Mar 2012" .LP .SH "名前" -jdb \- Java デバッガ +jdb \- Javaデバッガ .LP .LP -\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。 +\f3jdb\fPは、Java言語プログラムのバグを見つけて修正するために使用するツールです。 .LP .SH "形式" .LP @@ -41,30 +41,30 @@ .RS 3 .TP 3 options -次に示すコマンド行オプション +次に示すコマンドライン・オプション .TP 3 class デバッグを開始するクラスの名前 .TP 3 arguments -class の \f2main()\fP メソッドに渡す \f2引数\fP +\f2class\fPの\f2main()\fPメソッドに渡す引数 .RE .LP -.SH " 説明" +.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://download.oracle.com/javase/7/docs/technotes/guides/jpda/index.htmlを視覚的に実行し、ローカルまたはリモートのJava Virtual Machineの検査とデバッグを行うことができます。 .LP .SS -jdb セッションの開始 +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 @@ -76,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 @@ -91,7 +91,7 @@ .LP .LP -たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。 +たとえば、次のコマンドは、MyClassアプリケーションを実行して、\f3jdb\fPがあとでそのアプリケーションに接続できるようにします。 .LP .nf \f3 @@ -103,7 +103,7 @@ .LP .LP -次のコマンドを使用して、\f3jdb\fP を VM に接続できます。 +次のコマンドを使用して、\f3jdb\fPをVMに接続できます。 .LP .nf \f3 @@ -115,42 +115,44 @@ .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 @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、 +http://download.oracle.com/javase/7/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を参照してください。 .LP .SS -基本 jdb コマンド +基本jdbコマンド .LP .LP -基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。 +基本的な\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 コマンドの説明を参照してください。 -.LP -\f2注: 局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされている必要があります。 -.LP -\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。次に例を示します。 +Javaオブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の\f2dump\fPコマンドの説明を参照してください。 +.br +.br +\f2注意: ローカル変数を表示するには、その変数を含むクラスが\fP\f2javac(1)\fP\f2 \fP\f2\-g\fPオプションでコンパイルされている必要があります。 +.br +.br +\f2print\fPでは、メソッドの呼出しを含む多数の簡単なJava式がサポートされています。次に例を示します。 .RS 3 .TP 2 o @@ -160,22 +162,23 @@ \f2print myObj.myInstanceField\fP .TP 2 o -\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか) +\f2print i+j+k\fP \f2(i、j、およびkはプリミティブであり、フィールドまたはローカル変数のいずれか)\fP .TP 2 o -\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合) +\f2print myObj.myMethod()\fP \f2(myMethodがnull以外を返す場合)\fP .TP 2 o \f2print new java.lang.String("Hello").length()\fP .RE .TP 3 dump -プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。 -.LP -\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。 +プリミティブ値の場合には、このコマンドは\f2print\fPと同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。 +.br +.br +\f2dump\fPコマンドでは、\f2print\fPコマンドと同じ式がサポートされます。 .TP 3 threads -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。次に例を示します。 +現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。次に例を示します。 .nf \f3 .fl @@ -183,15 +186,16 @@ .fl \fP .fi -この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。スレッドの名前は「main」であり、現在実行中です。 +この例では、スレッド・インデックスは4であり、スレッドはjava.lang.Threadのインスタンスです。スレッドの名前は「main」であり、現在実行中です。 .TP 3 thread -現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。 +現在のスレッドにするスレッドを選択します。多くの\f3jdb\fPコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fPコマンドで説明したスレッド・インデックスとともに指定します。 .TP 3 where -\f2引数を指定しないで\fP where を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックをすべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。 -.LP -現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。 +引数を指定しないで\f2where\fPを実行すると、現在のスレッドのスタックがダンプされます。\f2where all\fPコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\f2where\fP \f2threadindex\fPは、指定されたスレッドのスタックをダンプします。 +.br +.br +現在のスレッドが(ブレークポイントか\f2suspend\fPコマンドによって)中断している場合は、ローカル変数とフィールドは\f2print\fPコマンドと\f2dump\fPコマンドで表示できます。\f2up\fPコマンドと\f2down\fPコマンドで、どのスタック・フレームをカレントにするかを選ぶことができます。 .RE .LP @@ -199,105 +203,105 @@ ブレークポイント .LP .LP -ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。次に例を示します。 +ブレークポイントは、行番号またはメソッドの最初の命令で\f3jdb\fPに設定できます。次に例を示します。 .LP .RS 3 .TP 2 o -\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定) +\f2stop at MyClass:22\fP \f2(MyClassが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定)\fP .TP 2 o -\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定) +\f2stop in java.lang.String.length\fP \f2(\fP\f2java.lang.String.length\fPメソッドの最初にブレークポイントを設定) .TP 2 o -\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別) +\f2stop in MyClass.<init>\fP \f2(<init>はMyClassコンストラクタを識別)\fP .TP 2 o -\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別) +\f2stop in MyClass.<clinit>\fP \f2(<clinit>はMyClassの静的初期化コードを識別)\fP .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 .SS ステップ実行 .LP .LP -\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。 +\f2step\fPコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fPコマンドは、現在のスタック・フレームの次の行を実行します。 .LP .SS 例外 .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 -.SH "コマンド行オプション" +.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 @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/jpda/conninv.htmlを参照してください。 .LP .SS デバッグ対象のプロセスに転送されるオプション @@ -308,13 +312,13 @@ 冗長モードにします。 .TP 3 \-D<name>=<value> -システムプロパティーを設定します。 +システム・プロパティを設定します。 .TP 3 \-classpath <directories separated by ":"> クラスを検索するディレクトリを一覧表示します。 .TP 3 \-X<option> -非標準ターゲット VM オプションです。 +非標準ターゲットVMオプションです。 .RE .LP
--- a/src/linux/doc/man/ja/jhat.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jhat.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jhat 1 "07 May 2011" +.TH jhat 1 "21 Mar 2012" .LP .SH "名前" -jhat \- Java ヒープ解析ツール +jhat \- Javaヒープ解析ツール .LP .RS 3 .TP 2 @@ -64,77 +64,77 @@ オプションを使用する場合、コマンド名の直後に記述してください。 .TP 3 heap\-dump\-file -ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。 +ブラウズ対象となる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」のすべてのインスタンスを表示する」といった、事前に設計されたクエリーの他、ヒープ・ダンプをクエリーするSQLに似たクエリー言語である\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://download.oracle.com/javase/7/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 "オプション" .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 バージョン番号を報告したあと、終了します。 .TP 3 \-h -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-help -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-J<flag> -jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。 +jhatが実行されているJava仮想マシンに<flag>を渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\-J\-Xmx512mとします。 .RE .LP @@ -150,7 +150,7 @@ .TP 2 o .na -\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @ +\f2hprof \- ヒープおよびCPUプロファイリング・ツール\fP @ .fi http://java.sun.com/developer/technicalArticles/Programming/HPROF.html .RE
--- a/src/linux/doc/man/ja/jinfo.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jinfo.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,7 +19,7 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jinfo 1 "07 May 2011" +.TH jinfo 1 "21 Mar 2012" .LP .SH "名前" @@ -70,84 +70,84 @@ .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 アドレスです。 +リモート・デバッグ・サーバー(jsadebugd(1)を参照)のホスト名またはIPアドレス。 .RE .LP .RS 3 .TP 3 server\-id -複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 +複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。 .RE .LP .SH "説明" .LP .LP -\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 +\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 +\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 +\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
--- a/src/linux/doc/man/ja/jmap.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jmap.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jmap 1 "07 May 2011" +.TH jmap 1 "21 Mar 2012" .LP .SH "名前" -jmap \- メモリーマップ +jmap \- メモリー・マップ .LP .RS 3 .TP 2 @@ -66,23 +66,23 @@ 各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。 .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 @@ -90,7 +90,7 @@ .SH "説明" .LP .LP -\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 +\f3jmap\fPは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットVM上で実行されている場合、\f2\-J\-d64\fPオプションを指定する必要がある場合があります。次に例を示します。 .LP .nf \f3 @@ -102,10 +102,10 @@ .LP .LP -\f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP +\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 +\f3次に例を示します。\fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .LP .br @@ -115,11 +115,11 @@ .RS 3 .TP 3 <オプションなし> -オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット 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 @@ -127,33 +127,33 @@ .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 @@ -163,7 +163,7 @@ .RS 3 .TP 2 o -pmap (1) +pmap(1) .TP 2 o jhat(1)
--- a/src/linux/doc/man/ja/jps.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jps.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jps 1 "07 May 2011" +.TH jps 1 "21 Mar 2012" .LP .SH "名前" -jps \- Java 仮想マシンプロセスステータスツール +jps \- Java仮想マシン・プロセス・ステータス・ツール .LP .RS 3 .TP 2 @@ -70,57 +70,57 @@ .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 hostid -プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。 +プロセス・レポートを生成するホストのホスト識別子。\f2hostid\fPには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。 .RE .LP -.SH " 説明" +.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 .LP -\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 +\f3jps\fPコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 .LP .RS 3 .TP 3 \-q -クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。 +クラス名、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 @@ -128,7 +128,7 @@ ホスト識別子 .LP .LP -ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。 +ホスト識別子、つまり\f2hostid\fPは、ターゲット・システムを示す文字列です。\f2hostid\fP文字列の構文の大部分は、URIの構文に対応しています。 .LP .nf \f3 @@ -144,23 +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 .SH "出力形式" .LP .LP -\f3jps\fP コマンドの出力は、次のパターンに従います。 +\f3jps\fPコマンドの出力は、次のパターンに従います。 .LP .nf \f3 @@ -174,20 +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 .LP -この節では、\f3jps\fP コマンドの例を示します。 +この項では、\f3jps\fPコマンドの例を示します。 .LP .LP -ローカルホスト上で計測された JVM を一覧表示する場合: +ローカル・ホスト上で計測されたJVMを一覧表示する場合: .LP .nf \f3 @@ -212,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 @@ -236,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 @@ -262,16 +262,16 @@ .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/src/linux/doc/man/ja/jrunscript.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jrunscript.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jrunscript 1 "07 May 2011" +.TH jrunscript 1 "21 Mar 2012" .LP .SH "名前" -jrunscript \- コマンド行スクリプトシェル +jrunscript \- コマンドライン・スクリプト・シェル .LP .RS 3 .TP 2 @@ -72,65 +72,65 @@ .RE .LP -.SH " 説明" +.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 .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が使用されます。他のスクリプト言語を使用するには、\-cpまたは\-classpathオプションを使用して、対応するスクリプト・エンジンのJARファイルも指定する必要があります。 .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 "引数" .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 配列型のエンジン変数を使用します。 +[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 "例" .LP .SS -インラインスクリプトの実行 +インライン・スクリプトの実行 .LP .nf \f3 @@ -144,7 +144,7 @@ .LP .SS -指定された言語を使用し、指定されたスクリプトファイルを評価する +指定された言語の使用および指定されたスクリプト・ファイルの評価 .LP .nf \f3 @@ -188,7 +188,7 @@ .LP .SS -スクリプト引数を指定してスクリプトファイルを実行する +スクリプト引数を指定したスクリプト・ファイルの実行 .LP .nf \f3 @@ -199,10 +199,14 @@ .fi .LP -test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。 +test.jsが実行対象となるスクリプト・ファイルであり、arg1、arg2およびarg3はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使用してこれらにアクセスできます。 .SH "関連項目" .LP .LP -JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。 +JavaScriptが使用される場合、jrunscriptは、最初のユーザー定義スクリプトを評価する前に、いくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScript組込み機能については、 +.na +\f2jsdocs\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/tools/share/jsdocs/allclasses\-noframe.htmlを参照してください。 .LP
--- a/src/linux/doc/man/ja/jsadebugd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jsadebugd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jsadebugd 1 "07 May 2011" +.TH jsadebugd 1 "21 Mar 2012" .LP .SH "名前" -jsadebugd \- サービスアビリティーエージェントデバッグデーモン +jsadebugd \- サービスアビリティ・エージェント・デバッグ・デーモン .LP .RS 3 .TP 2 @@ -58,44 +58,27 @@ .RS 3 .TP 3 pid -デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。 -.RE - -.LP -.RS 3 +デバッグ・サーバーが接続するプロセスのプロセスIDです。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)を使用します。単一のプロセスに接続できるデバッグ・サーバーのインスタンスは、1つに制限されます。 .TP 3 executable -.RE - -.LP -.RS 3 -.TP 3 -コアダンプの作成元になる Java 実行可能ファイルです。 -.RE - -.LP -.RS 3 +コア・ダンプの作成元のJava実行可能ファイル。 .TP 3 core -デバッグサーバーを接続するコアファイルです。 -.RE - -.LP -.RS 3 +デバッグ・サーバーを接続するコア・ファイルです。 .TP 3 server\-id -複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。 +複数のデバッグ・サーバーが同一のマシン上で実行されている場合に必要になる、オプションの一意のIDです。このIDは、リモート・クライアントが、接続先のデバッグ・サーバーを特定するために使用する必要があります。このIDは、単一のマシン内で一意にする必要があります。 .RE .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 を起動する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmiを起動する必要があります。 .LP .nf \f3 @@ -107,13 +90,13 @@ .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注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。 +\f3注意\fP \- このユーティリティはサポート対象外であり、将来のJDKのバージョンでは利用できなくなる可能性があります。dbgeng.dllが存在していないWindowsシステムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、\f2PATH\fP環境変数には、ターゲット・プロセスによって使用される\f2jvm.dll\fPの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。 .LP .LP -次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP +次に例を示します。\f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .LP .SH "関連項目" .LP @@ -135,7 +118,7 @@ .na \f2rmiregistry\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi .RE .LP
--- a/src/linux/doc/man/ja/jstack.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jstack.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstack 1 "07 May 2011" +.TH jstack 1 "21 Mar 2012" .LP .SH "名前" -jstack \- スタックトレース +jstack \- スタック・トレース .br .LP @@ -73,33 +73,33 @@ .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 .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 @@ -113,35 +113,35 @@ .LP .LP -\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。 +\f3注意\fP \- このユーティリティはサポート対象外であり、将来のJDKのバージョンでは利用できなくなる可能性があります。dbgeng.dllが存在していないWindowsシステムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、\f2PATH\fP環境変数には、ターゲット・プロセスによって使用される\f2jvm.dll\fPの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。 .LP .LP -次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP +次に例を示します。\f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .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 @ .fi -http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。 +http://download.oracle.com/javase/7/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 @@ -167,6 +167,6 @@ .SH "既知のバグ" .LP .LP -混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。 +混合モードのスタック・トレース(\-mオプション使用)は、リモート・デバッグ・サーバーでは機能しません。 .LP
--- a/src/linux/doc/man/ja/jstat.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jstat.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstat 1 "07 May 2011" +.TH jstat 1 "21 Mar 2012" .LP .SH "名前" -jstat \- Java 仮想マシン統計データ監視ツール +jstat \- Java仮想マシン統計データ監視ツール .LP .RS 3 .TP 2 @@ -73,36 +73,36 @@ .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 " 説明" +.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 @@ -110,7 +110,7 @@ 仮想マシン識別子 .LP .LP -\f2vmid\fP 文字列の構文の大部分は、URI の構文に対応しています。 +\f2vmid\fP文字列の構文の大部分は、URIの構文に対応しています。 .LP .nf \f3 @@ -123,31 +123,31 @@ .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 .SH "オプション" .LP .LP -\f3jstat\fP コマンドは、一般的なオプションと出力オプションの 2 つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fP は簡単な使用率およびバージョン情報を表示します。出力オプションでは、統計データ出力の内容と形式を指定します。 +\f3jstat\fPコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fPは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 .br .LP .LP -\f3注\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 +\f3注意\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 .LP .SS 一般的なオプション @@ -158,13 +158,13 @@ .RS 3 .TP 3 \-help -ヘルプメッセージを表示します。 +ヘルプ・メッセージを表示します。 .TP 3 \-version バージョン情報を表示します。 .TP 3 \-options -統計データオプションを一覧表示します。下記の「出力オプション」の節を参照してください。 +統計データ・オプションを一覧表示します。下記の出力オプションの項を参照してください。 .RE .LP @@ -172,24 +172,24 @@ 出力オプション .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 @@ -221,7 +221,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -クラスローダーの動作に関する統計データ +クラス・ローダーの動作に関する統計データ .br .di .nr a| \n(dn @@ -237,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 @@ -253,7 +253,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクトされたヒープの動作に関する統計データ +ガベージ・コレクトされたヒープの動作に関する統計データ .br .di .nr c| \n(dn @@ -285,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 @@ -301,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 @@ -317,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 @@ -333,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 @@ -349,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 @@ -365,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 @@ -381,7 +381,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション統計データの概要 +ガベージ・コレクション統計データの概要 .br .di .nr k| \n(dn @@ -397,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 @@ -705,26 +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 \-JjavaOption -\f2javaOption\fP を \f3java\fP アプリケーション起動ツールへ渡す。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。オプションの完全なリストについては、「java(1)」のドキュメントを参照してください。 +\f2javaOption\fPを\f3java\fPアプリケーション起動ツールに渡します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。オプションの完全なリストについては、java(1)を参照してください。 .RE .LP .SS -statOption と出力 +statOptionと出力 .LP .LP -以降の表では、\f3jstat\fP が \f2statOption\fP ごとに出力する列について概要を示します。 +以降の表では、\f3jstat\fPが\f2statOption\fPごとに出力する列について概要を示します。 .br .LP .SS -\-class オプション +\-classオプション .LP .LP .TS @@ -771,7 +771,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ロードされた K バイト数 +アンロードされたクラスの数 .br .di .nr b| \n(dn @@ -787,7 +787,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -アンロードされたクラスの数 +アンロードされたKB数 .br .di .nr c| \n(dn @@ -803,34 +803,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -アンロードされた K バイト数 +クラスのロードやアンロード処理に要した時間 .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 -クラスのロードやアンロード処理に要した時間 -.br -.di -.nr e| \n(dn -.nr e- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -849,6 +833,8 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wロードされたKB数 +.if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 .nr 38 \n(a- @@ -859,8 +845,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(d- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(e- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -871,7 +855,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 298 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 296 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -888,7 +872,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -909,12 +893,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'Bytes\h'|\n(41u'ロードされたKB数 .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'Bytes\h'|\n(41u' +\&\h'|\n(40u'Unloaded\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -930,7 +918,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'Unloaded\h'|\n(41u' +\&\h'|\n(40u'Bytes\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -946,7 +934,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'Bytes\h'|\n(41u' +\&\h'|\n(40u'Time\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -957,22 +945,6 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ne \n(e|u+\n(.Vu -.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'Time\h'|\n(41u' -.mk ## -.nr 31 \n(## -.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 .fc .nr T. 1 .T# 1 @@ -981,13 +953,12 @@ .rm b+ .rm c+ .rm d+ -.rm e+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-25 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-23 .LP .SS -\-compiler オプション +\-compilerオプション .LP .LP .TS @@ -1018,7 +989,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -実行されたコンパイルタスクの数 +実行されたコンパイル・タスクの数 .br .di .nr a| \n(dn @@ -1034,7 +1005,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -失敗したコンパイルタスクの数 +失敗したコンパイル・タスクの数 .br .di .nr b| \n(dn @@ -1050,7 +1021,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -無効にされたコンパイルタスクの数 +無効にされたコンパイル・タスクの数 .br .di .nr c| \n(dn @@ -1066,7 +1037,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -コンパイルタスクの実行に要した時間 +コンパイル・タスクの実行に要した時間 .br .di .nr d| \n(dn @@ -1082,7 +1053,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -最後に失敗したコンパイルのコンパイルタイプ +最後に失敗したコンパイルのコンパイル・タイプ .br .di .nr e| \n(dn @@ -1109,7 +1080,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -1154,7 +1125,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 334 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 332 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1171,7 +1142,7 @@ .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 @@ -1287,7 +1258,7 @@ .LP .SS -\-gc オプション +\-gcオプション .LP .LP .TS @@ -1318,7 +1289,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 @@ -1334,7 +1305,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 @@ -1350,7 +1321,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 @@ -1366,7 +1337,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 @@ -1382,7 +1353,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 @@ -1398,7 +1369,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 @@ -1414,7 +1385,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 @@ -1430,7 +1401,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (KB) +Permanent領域の現在の容量(KB) .br .di .nr h| \n(dn @@ -1446,7 +1417,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 @@ -1462,7 +1433,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Permanent 領域の使用率 (KB) +若い世代のGCイベント数 .br .di .nr j| \n(dn @@ -1478,7 +1449,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のガベージ・コレクション時間 .br .di .nr k| \n(dn @@ -1494,7 +1465,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr l| \n(dn @@ -1510,34 +1481,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +ガベージ・コレクション総時間 .br .di .nr m| \n(dn .nr m- \n(dl .. .ec \ -.eo -.am 81 -.br -.di n+ -.35 -.ft \n(.f -.ll \n(34u*1u/3u -.if \n(.l<\n(81 .ll \n(81u -.in 0 -ガベージコレクション総時間 -.br -.di -.nr n| \n(dn -.nr n- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -1576,7 +1531,9 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wフル GC イベント数 +.nr 38 \wOld領域の使用率(KB) +.if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wフルGCイベント数 .if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 @@ -1606,8 +1563,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(m- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(n- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -1618,7 +1573,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 404 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 400 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1635,7 +1590,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -1752,12 +1707,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'OU\h'|\n(41u'Old領域の使用率(KB) .ne \n(h|u+\n(.Vu .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'OU\h'|\n(41u' +\&\h'|\n(40u'PC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1773,7 +1732,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'PC\h'|\n(41u' +\&\h'|\n(40u'PU\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1789,7 +1748,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'PU\h'|\n(41u' +\&\h'|\n(40u'YGC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1805,7 +1764,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'YGC\h'|\n(41u' +\&\h'|\n(40u'YGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1816,12 +1775,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'FGC\h'|\n(41u'フルGCイベント数 .ne \n(l|u+\n(.Vu .if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'YGCT\h'|\n(41u' +\&\h'|\n(40u'FGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1832,38 +1795,18 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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 .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'FGCT\h'|\n(41u' -.mk ## -.nr 31 \n(## -.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 -.ne \n(n|u+\n(.Vu -.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v) -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m \&\h'|\n(40u'GCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v .nr 37 \n(41u .in +\n(37u -.n+ +.m+ .in -\n(37u .mk 32 .if \n(32>\n(31 .nr 31 \n(32 @@ -1885,13 +1828,12 @@ .rm k+ .rm l+ .rm m+ -.rm n+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-61 .LP .SS -\-gccapacity オプション +\-gccapacityオプション .LP .LP .TS @@ -1922,7 +1864,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 @@ -1938,7 +1880,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 @@ -1954,7 +1896,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 @@ -1970,7 +1912,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 @@ -1986,7 +1928,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 @@ -2002,7 +1944,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 @@ -2018,7 +1960,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 @@ -2034,7 +1976,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 @@ -2050,7 +1992,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 @@ -2066,7 +2008,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 @@ -2082,7 +2024,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 @@ -2098,7 +2040,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 @@ -2114,7 +2056,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 @@ -2130,7 +2072,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 @@ -2146,7 +2088,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr o| \n(dn @@ -2157,7 +2099,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2198,7 +2140,7 @@ .nr 81 0 .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 @@ -2242,7 +2184,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 478 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 474 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2259,7 +2201,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -2507,7 +2449,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 @@ -2532,10 +2474,10 @@ .LP .SS -\-gccause オプション +\-gccauseオプション .LP .LP -このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。 +このオプションは、\f3\-gcutil\fPオプションと同じガベージ・コレクション統計データの概要を表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\f3\-gcutil\fPで一覧表示される列のほか、このオプションでは次の列が追加されます。 .LP .LP .TS @@ -2566,7 +2508,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -最後のガベージコレクションの原因 +最後のガベージ・コレクションの原因 .br .di .nr a| \n(dn @@ -2582,7 +2524,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -現在のガベージコレクションの原因 +現在のガベージ・コレクションの原因 .br .di .nr b| \n(dn @@ -2593,7 +2535,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2622,7 +2564,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 501 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 497 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2639,7 +2581,7 @@ .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 @@ -2687,7 +2629,7 @@ .LP .SS -\-gcnew オプション +\-gcnewオプション .LP .LP .TS @@ -2718,7 +2660,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 @@ -2734,7 +2676,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 @@ -2750,7 +2692,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 @@ -2766,7 +2708,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 @@ -2798,7 +2740,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 @@ -2814,7 +2756,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 @@ -2830,7 +2772,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 @@ -2846,7 +2788,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr i| \n(dn @@ -2862,7 +2804,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +若い世代のガベージ・コレクション時間 .br .di .nr j| \n(dn @@ -2873,7 +2815,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2938,7 +2880,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 555 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 551 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2955,7 +2897,7 @@ .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 @@ -3143,7 +3085,7 @@ .LP .SS -\-gcnewcapacity オプション +\-gcnewcapacityオプション .LP .LP .TS @@ -3174,7 +3116,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 @@ -3190,7 +3132,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 @@ -3206,7 +3148,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 @@ -3222,7 +3164,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 @@ -3238,7 +3180,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 @@ -3254,7 +3196,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 @@ -3270,7 +3212,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 @@ -3286,7 +3228,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 @@ -3302,7 +3244,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 @@ -3318,7 +3260,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr j| \n(dn @@ -3329,7 +3271,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -3360,7 +3302,7 @@ .nr 81 0 .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 @@ -3394,7 +3336,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 609 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 605 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -3411,7 +3353,7 @@ .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 @@ -3579,7 +3521,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 @@ -3599,7 +3541,7 @@ .LP .SS -\-gcold オプション +\-gcoldオプション .LP .LP .TS @@ -3630,7 +3572,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 @@ -3646,7 +3588,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 @@ -3662,7 +3604,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 @@ -3678,7 +3620,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (KB) +若い世代のGCイベント数 .br .di .nr d| \n(dn @@ -3694,7 +3636,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +フルガベージ・コレクション時間 .br .di .nr e| \n(dn @@ -3710,34 +3652,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +ガベージ・コレクション総時間 .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 -ガベージコレクション総時間 -.br -.di -.nr g| \n(dn -.nr g- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -3762,7 +3688,9 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wフル GC イベント数 +.nr 38 \wOld領域の使用率(KB) +.if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wフルGCイベント数 .if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 @@ -3778,8 +3706,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(f- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(g- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -3790,7 +3716,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 651 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 645 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -3807,7 +3733,7 @@ .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 @@ -3860,12 +3786,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'OU\h'|\n(41u'Old領域の使用率(KB) .ne \n(d|u+\n(.Vu .if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'OU\h'|\n(41u' +\&\h'|\n(40u'YGC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -3876,12 +3806,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'FGC\h'|\n(41u'フルGCイベント数 .ne \n(e|u+\n(.Vu .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'YGC\h'|\n(41u' +\&\h'|\n(40u'FGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -3892,38 +3826,18 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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 .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'FGCT\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 -.ne \n(g|u+\n(.Vu -.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'GCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v .nr 37 \n(41u .in +\n(37u -.g+ +.f+ .in -\n(37u .mk 32 .if \n(32>\n(31 .nr 31 \n(32 @@ -3938,13 +3852,12 @@ .rm d+ .rm e+ .rm f+ -.rm g+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-33 .LP .SS -\-gcoldcapacity オプション +\-gcoldcapacityオプション .LP .LP .TS @@ -3975,7 +3888,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 @@ -3991,7 +3904,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 @@ -4007,7 +3920,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 @@ -4023,7 +3936,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 @@ -4039,7 +3952,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr e| \n(dn @@ -4055,7 +3968,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr f| \n(dn @@ -4071,7 +3984,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr g| \n(dn @@ -4082,7 +3995,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4107,7 +4020,7 @@ .nr 81 0 .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 @@ -4135,7 +4048,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 693 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 687 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4152,7 +4065,7 @@ .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 @@ -4240,7 +4153,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 @@ -4289,7 +4202,7 @@ .LP .SS -\-gcpermcapacity オプション +\-gcpermcapacityオプション .LP .LP .TS @@ -4320,7 +4233,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 @@ -4336,7 +4249,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 @@ -4352,7 +4265,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 @@ -4368,7 +4281,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 @@ -4384,7 +4297,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr e| \n(dn @@ -4400,7 +4313,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr f| \n(dn @@ -4416,7 +4329,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr g| \n(dn @@ -4427,7 +4340,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4452,7 +4365,7 @@ .nr 81 0 .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 @@ -4480,7 +4393,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 735 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 729 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4497,7 +4410,7 @@ .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 @@ -4585,7 +4498,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 @@ -4634,7 +4547,7 @@ .LP .SS -\-gcutil オプション +\-gcutilオプション .LP .LP .TS @@ -4665,7 +4578,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 @@ -4681,7 +4594,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 @@ -4697,7 +4610,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Eden 領域の使用率 (現在の容量に対するパーセンテージ) +Eden領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr c| \n(dn @@ -4713,7 +4626,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (現在の容量に対するパーセンテージ) +Old領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr d| \n(dn @@ -4729,7 +4642,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Permanent 領域の使用率 (現在の容量に対するパーセンテージ) +Permanent領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr e| \n(dn @@ -4745,7 +4658,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr f| \n(dn @@ -4761,7 +4674,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +若い世代のガベージ・コレクション時間 .br .di .nr g| \n(dn @@ -4777,7 +4690,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr h| \n(dn @@ -4793,7 +4706,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr i| \n(dn @@ -4804,7 +4717,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4833,7 +4746,7 @@ .nr 81 0 .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 @@ -4865,7 +4778,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 785 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 779 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4882,7 +4795,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -5002,7 +4915,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 @@ -5053,7 +4966,7 @@ .LP .SS -\-printcompilation オプション +\-printcompilationオプション .LP .LP .TS @@ -5084,7 +4997,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -実行されたコンパイルタスクの数 +実行されたコンパイル・タスクの数 .br .di .nr a| \n(dn @@ -5116,36 +5029,50 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」の代わりに「/」が使用される。メソッド名は、指定されたクラス内のメソッドである。これらの 2 つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fP オプションと対応している +コンパイル・タイプ .br .di .nr c| \n(dn .nr c- \n(dl .. .ec \ +.eo +.am 81 +.br +.di d+ +.35 +.ft \n(.f +.ll \n(34u*1u/3u +.if \n(.l<\n(81 .ll \n(81u +.in 0 +コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」のかわりに「/」が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fPオプションと対応しています。 +.br +.di +.nr d| \n(dn +.nr d- \n(dl +.. +.ec \ .35 .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 .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 \wSize .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \w型 +.nr 38 \wType .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \wメソッド +.nr 38 \wMethod .if \n(80<\n(38 .nr 80 \n(38 .80 .rm 80 .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wコンパイルタイプ -.if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 .nr 38 \n(a- @@ -5154,6 +5081,8 @@ .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(d- +.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -5164,7 +5093,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 811 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 807 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -5181,7 +5110,7 @@ .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 @@ -5207,7 +5136,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'サイズ\h'|\n(41u' +\&\h'|\n(40u'Size\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -5218,16 +5147,12 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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'Type\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -5238,6 +5163,22 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ne \n(d|u+\n(.Vu +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v) +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'Method\h'|\n(41u' +.mk ## +.nr 31 \n(## +.sp |\n(##u-1v +.nr 37 \n(41u +.in +\n(37u +.d+ +.in -\n(37u +.mk 32 +.if \n(32>\n(31 .nr 31 \n(32 +.sp |\n(31u .fc .nr T. 1 .T# 1 @@ -5245,20 +5186,21 @@ .rm a+ .rm b+ .rm c+ +.rm d+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-19 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-21 .LP .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 @@ -5303,13 +5245,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 @@ -5362,16 +5304,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 @@ -5400,13 +5342,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へ増加しています。この世代(および領域)の最大容量は、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 @@ -5423,23 +5365,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 .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) \- jvmstatデーモン .TP 2 o -「rmiregistry(1) \- Java リモートオブジェクトレジストリ」 +rmiregistry(1) \- Javaリモート・オブジェクト・レジストリ .RE .LP
--- a/src/linux/doc/man/ja/jstatd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jstatd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstatd 1 "07 May 2011" +.TH jstatd 1 "21 Mar 2012" .LP .SH "名前" -jstatd \- 仮想マシン jstat デーモン +jstatd \- 仮想マシンjstatデーモン .LP .RS 3 .TP 2 @@ -40,10 +40,10 @@ オプション .TP 2 o -セキュリティー +セキュリティ .TP 2 o -リモートインタフェース +リモート・インタフェース .TP 2 o 例 @@ -71,59 +71,59 @@ .RS 3 .TP 3 options -コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。 +コマンドライン・オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。 .RE .LP -.SH " 説明" +.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 .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 "セキュリティー" +.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 プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。 +\f3jstatd\fPサーバーには、リモート・クライアントの認証機能がありません。そのため、\f3jstatd\fPサーバー・プロセスを実行すると、\f3jstatd\fPプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に実稼働環境または安全でないネットワークでは、\f3jstatd\fPプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 .LP .LP -\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の +\f3jstatd\fPサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、RMISecurityPolicyのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、デフォルト・ポリシー実装の .na -\f2ポリシーファイルの構文\fP @ +\f2ポリシー・ファイルの構文\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。 .LP .LP -次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。 +次のポリシー・ファイルでは、セキュリティ例外を発生せずに\f3jstatd\fPサーバーを実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\f3jstatd\fPサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 .LP .nf \f3 @@ -145,7 +145,7 @@ .LP .LP -このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。 +このポリシーを使用するには、このテキストを\f2jstatd.all.policy\fPというファイルにコピーし、次のように\f3jstatd\fPサーバーを実行します。 .LP .nf \f3 @@ -159,23 +159,23 @@ .LP .LP -より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。 +より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\f3jstatd\fPサーバーを実行せずに、\f3jstat\fPと\f3jps\fPツールをローカルで使用することが最も安全な方法になります。 .LP -.SH "リモートインタフェース" +.SH "リモート・インタフェース" .LP .LP -\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。 +\f3jstatd\fPプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 .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 @@ -187,10 +187,10 @@ .LP .SS -外部 RMI レジストリの使用 +外部RMIレジストリの使用 .LP .LP -この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -204,7 +204,7 @@ .LP .LP -この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、ポート2020の外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -218,7 +218,7 @@ .LP .LP -この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、AlternateJstatdServerNameの名前にバインドされた、ポート2020の外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -232,10 +232,10 @@ .LP .SS -インプロセス RMI レジストリの作成の禁止 +インプロセスRMIレジストリの作成の禁止 .LP .LP -この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。 +この例は、RMIレジストリが見つからない場合にRMIレジストリを作成しない\f3jstatd\fPの起動を表しています。この例では、RMIレジストリがすでに実行されていると想定しています。実行されていない場合は、適切なエラー・メッセージが表示されます。 .LP .nf \f3 @@ -247,10 +247,10 @@ .LP .SS -RMI ログ機能の有効化 +RMIログ機能の有効化 .LP .LP -この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。 +この例は、RMIログ機能を有効にした\f3jstatd\fPの起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。 .LP .nf \f3 @@ -266,20 +266,19 @@ .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://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi \- Javaリモート・オブジェクト・レジストリ .RE .LP
--- a/src/linux/doc/man/ja/jvisualvm.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/jvisualvm.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jvisualvm 1 "07 May 2011" +.TH jvisualvm 1 "21 Mar 2012" .LP .SH "名前" -\f2jvisualvm\fP \- Java 仮想マシンの監視、トラブルシューティング、およびプロファイリングツール +\f2jvisualvm\fP \- Java仮想マシンの監視、トラブルシューティングおよびプロファイリング・ツール .LP .RS 3 .TP 2 @@ -60,35 +60,35 @@ .SH "パラメータ" .LP .LP -オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、このあとの「オプション」を参照してください。 +オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、次のオプションを参照してください。 .LP -.SH " 説明" +.SH "説明" .LP .LP -Java VisualVM は、指定された Java 仮想マシン (JVM(*)) で Java テクノロジベースのアプリケーション (Java アプリケーション) が実行されているときに、その Java アプリケーションに関する詳細な情報を提供する直感的なグラフィカルユーザーインタフェースです。Java VisualVM という名前は、Java VisualVM が JVM ソフトウェアに関する情報を「視覚的に」提供するという事実に由来しています。 +Java VisualVMは、指定されたJava仮想マシン(JVM(*))でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を\f2視覚的に\fP提供するという事実に由来しています。 .LP .LP -Java VisualVM は、いくつかの監視、トラブルシューティング、およびプロファイリングユーティリティーを 1 つのツールに統合します。たとえば、スタンドアロンツール \f2jmap\fP、 \f2jinfo\fP、 \f2jstat\fP 、および \f2jstack\fP で提供されている機能のほとんどが、Java VisualVM に組み込まれています。JConsole ツールによって提供される一部の機能など、ほかの機能はオプションのプラグインとして追加できます。 +Java VisualVMは、いくつかの監視、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\f2jmap\fP、\f2jinfo\fP、\f2jstat\fPおよび\f2jstack\fPで提供されている機能のほとんどが、Java VisualVMに組み込まれています。JConsoleツールによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 .LP .SH "オプション" .LP .LP -次のオプションは、Java VisualVM を起動したときに実行可能になります。 +次のオプションは、Java VisualVMを起動したときに実行可能になります。 .LP .RS 3 .TP 3 \-J<jvm_option>\ -この \f2<jvm_option>\fP を JVM ソフトウェアに渡します。 +この\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 メニューの「ツール」>「プラグイン」を選択します。 +Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行および監視、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。Java VisualVMの機能を拡張するプラグインもいくつかあります。たとえば、JConsoleツールのほとんどの機能は、「MBeans」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの「ツール」→「プラグイン」を選択します。 .LP .LP -Java VisualVM を起動するには、次のコマンドを実行します。 +Java VisualVMを起動するには、次のコマンドを実行します。 .LP .nf \f3 @@ -102,25 +102,25 @@ .SH "関連項目" .LP .LP -Java VisualVM の詳細は、次のページを参照してください。 +Java VisualVMの詳細は、次のページを参照してください。 .LP .RS 3 .TP 2 o .na -\f2Java VisualVM 開発者のサイト\fP @ +\f2Java VisualVM開発者のサイト\fP @ .fi http://visualvm.java.net .TP 2 o .na -\f2Java SE プラットフォームでの Java VisualVM のドキュメント\fP @ +\f2Java SEプラットフォームでのJava VisualVMのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/visualvm/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/visualvm/index.html .RE .LP .LP -\f2(* 「Java 仮想マシン」と「JVM」という用語は、Java プラットフォームの仮想マシンを意味しています。)\fP +\f2(*「Java仮想マシン」と「JVM」という用語は、Javaプラットフォームの仮想マシンを意味しています。)\fP .LP
--- a/src/linux/doc/man/ja/keytool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/keytool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -1,4 +1,4 @@ -." Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved. +." Copyright (c) 1998-2011 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,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH keytool 1 "07 May 2011" +.TH keytool 1 "21 Mar 2012" .LP .SH "名前" keytool \- 鍵と証明書の管理ツール .LP .LP -暗号化鍵、X.509 証明書チェーン、および信頼できる証明書を含むキーストア (データベース) を管理します。 +暗号化鍵、X.509証明書チェーンおよび信頼できる証明書を含むキーストア(データベース)を管理します。 .LP .SH "形式" .LP @@ -39,44 +39,44 @@ .LP .LP -Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。 +Java SE 6でkeytoolのコマンド・インタフェースが変更されました。詳細は、変更点の項を参照してください。以前に定義されたコマンドも引続きサポートされています。 .LP .SH "説明" .LP -\f3keytool\fP は、鍵と証明書を管理するためのユーティリティーです。keytool を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザーまたはサービスに対して自分自身を認証すること) や、データの整合性と証明書に関するサービスを利用することができます。keytool では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。 +\f3keytool\fPは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。また、通信相手の公開鍵を(証明書の形で)キャッシュすることもできます。 .LP -「証明書」とは、あるエンティティー (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティーの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「整合性」とは、データが変更されたり、改変されたりしていないことを意味します。 また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。 +「\f2証明書\fP」とは、あるエンティティ(人物、会社など)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティの公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。(証明書を参照。)データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「\f2整合性\fP」とは、データが変更されたり、改変されたりしていないことを意味します。また、データが「\f2本物である\fP」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。 .LP .LP -また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。 +また、\f3keytool\fPを使用すれば、DESなどの対称暗号化/復号化で使用される秘密鍵を管理することもできます。 .LP .LP -\f3keytool\fP は、鍵と証明書を\f2「キーストア」\fPに格納します。 +\f3keytool\fPは、鍵と証明書を\f2キーストア\fPに格納します。 .LP -.SH "コマンドとオプションに関する注" +.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 @@ -85,7 +85,7 @@ \fP .fi .LP -\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。次に例を示す +\f2\-printcert\fPコマンドを指定するときは、\f2cert_file\fPのかわりに実際のファイル名を指定します。次に例を示します。 .nf \f3 .fl @@ -95,10 +95,10 @@ .fi .TP 2 o -オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある +オプションの値に空白(スペース)が含まれている場合は、値を引用符で囲む必要があります。 .TP 2 o -\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする +\f2\-help\fPコマンドはデフォルトのコマンドです。そのため、コマンドライン .nf \f3 .fl @@ -107,7 +107,7 @@ \fP .fi .LP -これは、次のように指定することと同じです。 +は、次と同じです。 .nf \f3 .fl @@ -133,23 +133,23 @@ .fl \-keyalg .fl - "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合) + "DSA" (when using \fP\f3\-genkeypair\fP\f3) .fl - "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合) + "DES" (when using \fP\f3\-genseckey\fP\f3) .fl .fl \-keysize .fl - 2048 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "RSA" の場合) + 2048 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "RSA") .fl - 1024 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "DSA" の場合) + 1024 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "DSA") .fl - 256 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "EC" の場合) + 256 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "EC") .fl - 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合) + 56 (when using \fP\f3\-genseckey\fP\f3 and \-keyalg is "DES") .fl - 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合) + 168 (when using \fP\f3\-genseckey\fP\f3 and \-keyalg is "DESede") .fl .fl @@ -159,19 +159,19 @@ .fl .fl -\-keystore ユーザーのホームディレクトリの \fP\f4.keystore\fP\f3 というファイル +\-keystore the file named \fP\f4.keystore\fP\f3 in the user's home directory .fl .fl -\-storetype セキュリティープロパティーファイルの「keystore.type」プロパティーの値で、 +\-storetype the value of the "keystore.type" property in the security properties file, .fl - java.security.KeyStore の静的な getDefaultType メソッドから返される \fP\f4 \fP\f3 + which is returned by the static \fP\f4getDefaultType\fP\f3 method in .fl - \fP\f4 \fP\f3 + \fP\f4java.security.KeyStore\fP\f3 .fl .fl -\-file 読み込みの場合は標準入力、書き込みの場合は標準出力 +\-file stdin if reading, stdout if writing .fl .fl @@ -182,36 +182,36 @@ .LP .LP -公開/非公開鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。 +公開/秘密鍵ペアの生成において、署名アルゴリズム(\f2\-sigalg\fPオプション)は、基になる秘密鍵のアルゴリズムから派生します。 .LP .RS 3 .TP 2 o -基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションのデフォルト値は SHA1withDSA になり、 +基になる秘密鍵がDSAタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA1withDSAになります。 .TP 2 o -基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withRSA になり、 +基になる秘密鍵がRSAタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA256withRSAになります。 .TP 2 o -基になる非公開鍵が EC タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withECDSA になります。 +基になる秘密鍵がECタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA256withECDSAになります。 .RE .LP .LP -選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、 +選択可能な\f2\-keyalg\fPおよび\f2\-sigalg\fPの完全な一覧については、 .na -\f2「Java Cryptography Architecture API Specification & Reference」\fP @ +\f2Java Cryptography Architecture API Specification & Reference\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。 .LP .SS 一般オプション .LP .LP -\f2\-v\fP オプションは、 \f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。 +\f2\-v\fPオプションは、\f2\-help\fPコマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。 .LP .LP -また、 \f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。 +また、\f2\-J\fP\f2javaoption\fPオプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された\f2javaoption\fP文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\f2java \-h\fPまたは\f2java \-X\fPと入力してください。 .LP .LP 次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。 @@ -226,56 +226,56 @@ .LP キーストアの場所を指定します。 .LP -特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、 \f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、 \f2.keystore\fP という名前のデフォルトキーストアファイルがユーザーのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、 \f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。 +特定の\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 がファイルベースではなく、たとえば、ハードウェアトークンデバイスに置かれている場合に指定します。 +\f2\-keystore\fPオプションからの入力ストリームは、\f2KeyStore.load\fPメソッドに渡されます。URLとして\f2NONE\fPが指定されている場合は、nullのストリームが\f2KeyStore.load\fPメソッドに渡されます。\f2NONE\fPは、\f2KeyStore\fPがファイルベースではなく、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 .TP 3 \-storepass[:env|:file] argument .LP -キーストアの整合性を保護するために使うパスワードを指定します。 +キーストアの整合性を保護するために使用するパスワードを指定します。 .LP -修飾子 \f2env\fP または \f2file\fP を指定しない場合、パスワードの値は \f2argument\fP になります。この値は、6 文字以上にする必要があります。それ以外の場合、パスワードは次のように取得されます。 +修飾子\f2env\fPまたは\f2file\fPを指定しない場合、パスワードの値は\f2argument\fPになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\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) で区切ってください。 +\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 オプションを指定しなかった場合は、パスワードの入力を求められます。 +パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンドラインで\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 のコンストラクタに対する省略可能な文字列入力引数を表します。 +\f2\-providerClass\fPと組み合せて使用します。\f2provider_class_name\fPのコンストラクタに対する省略可能な文字列入力引数を表します。 .TP 3 \-protected .LP -\f2true\fP または \f2false\fP のいずれか。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。 +\f2true\fPまたは\f2false\fPのいずれか。専用PINリーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に\f2true\fPを指定してください。 .LP -注: \f2\-importkeystore\fP コマンドには 2 つのキーストアが関係しているため、2 つのオプション、つまり \f2\-srcprotected\fP と \f2\-destprotected\fP がソースキーストアとターゲットキーストアにそれぞれ指定されます。 +注意: \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 を使用できます。 . +X.509証明書エクステンションを示します。このオプションを\-genkeypairおよび\-gencertで使用して、生成される証明書または\f2\-certreq\fPにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは、複数回使用できます。nameには、サポートされているエクステンション名(下記を参照)または任意のOID番号を指定できます。valueを指定した場合は、エクステンションのパラメータを示します。省略した場合は、エクステンションのデフォルト値(定義されている場合)を示すか、またはエクステンションにパラメータは必要ありません。\f2:critical\fP修飾子を指定した場合は、エクステンションのisCritical属性がtrueであることを示します。それ以外の場合はfalseであることを示します。\f2:critical\fPのかわりに\f2:c\fPを使用できます。 .RE .LP .LP -現在、keytool は次の名前のエクステンションをサポートしています (大文字と小文字は区別されない)。 +現在、keytoolは次の名前のエクステンションをサポートしています(大文字と小文字は区別されません)。 .LP .LP .TS @@ -306,7 +306,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -BC または BasicConstraints +BCまたはBasicConstraints .br .di .nr a| \n(dn @@ -322,7 +322,7 @@ .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」の意味になります +完全な形は「ca:{true|false}[,pathlen:<len>]」で、<len>は「ca:true,pathlen:<len>」の省略表記です。 .br .di .nr b| \n(dn @@ -338,7 +338,7 @@ .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 の大文字と小文字は区別されません。 +usage(,usage)*。usageには、digitalSignature、 nonRepudiation (contentCommitment)、keyEncipherment、dataEncipherment、keyAgreement、keyCertSign、cRLSign、encipherOnly、decipherOnlyのいずれかを指定できます。Usageは、あいまいさがなければ、最初の数文字(たとえば、digitalSignatureをdigに)またはキャメルケース・スタイルに(たとえば、 短縮できます。Usageの大文字と小文字は区別されません。 .br .di .nr c| \n(dn @@ -354,7 +354,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -EKU または ExtendedkeyUsage +EKUまたはExtendedkeyUsage .br .di .nr d| \n(dn @@ -370,7 +370,7 @@ .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 の大文字と小文字は区別されません。 +usage(,usage)*。usageには、anyExtendedKeyUsage、 serverAuth、clientAuth、codeSigning、emailProtection、 timeStamping、OCSPSigning、または任意のOID文字列のいずれかを指定できます。 名前付きのusageは、あいまいさがなければ、 最初の数文字またはキャメルケース・スタイルに 短縮できます。Usageの大文字と小文字は区別されません。 .br .di .nr e| \n(dn @@ -386,7 +386,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -SAN または SubjectAlternativeName +SANまたはSubjectAlternativeName .br .di .nr f| \n(dn @@ -402,7 +402,7 @@ .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 の文字列形式の値です。 +type:value(,type:value)*。typeには、EMAIL、URI、DNS、IPまたはOIDを指定できます。valueは、typeの文字列形式の値です。 .br .di .nr g| \n(dn @@ -418,7 +418,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -IAN または IssuerAlternativeName +IANまたはIssuerAlternativeName .br .di .nr h| \n(dn @@ -434,7 +434,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -SubjectAlternativeName と同じです +SubjectAlternativeNameと同じです .br .di .nr i| \n(dn @@ -450,7 +450,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -SIA または SubjectInfoAccess +SIAまたはSubjectInfoAccess .br .di .nr j| \n(dn @@ -466,7 +466,7 @@ .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 を指定できます。 +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 @@ -482,7 +482,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -AIA または AuthorityInfoAccess +AIAまたはAuthorityInfoAccess .br .di .nr l| \n(dn @@ -498,7 +498,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -SubjectInfoAccess と同じです。method には、「ocsp」、「caIssuers」、または任意の OID を指定できます。 +SubjectInfoAccessと同じです。methodには、「ocsp」、「caIssuers」、または任意のOIDを指定できます。 .br .di .nr m| \n(dn @@ -511,7 +511,7 @@ .nr 80 0 .nr 38 \w\f3名前\fP .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \wKU または KeyUsage +.nr 38 \wKUまたはKeyUsage .if \n(80<\n(38 .nr 80 \n(38 .80 .rm 80 @@ -604,7 +604,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'KU または KeyUsage\h'|\n(41u' +\&\h'|\n(40u'KUまたはKeyUsage\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -762,19 +762,19 @@ .LP .LP -OID 名の場合、OCTET STRING タイプと長さのバイトを除外したエクステンションについては、値は extnValue の HEX ダンプの DER エンコーディングです。HEX 文字列では、標準の HEX 数 (0\-9、a\-f、A\-F) 以外の文字は無視されます。したがって、 \f2「01:02:03:04」\fP と \f2「01020304」の両方とも\fP 同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 +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」とともに使用し、例外を示す) のコンマ区切りリストです。デフォルトでは、要求されるエクステンションは優先されません。 +\f2\-gencert\fPでのみ使用する\f2「honored」\fPという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\f2「all」\fP(リクエストされるすべてのエクステンションが優先される)、\f2「name{:[critical|non\-critical]}」\fP(名前付きのエクステンションが優先されるが、別のisCritical属性を使用する)、および\f2「\-name」\fP(「all」とともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 .LP .LP -\-ext 優先のオプションに加え、別の名前の、または OID \-ext のオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前 (または OID) を優先される値でも使用した場合は、その値と重要性が要求に含まれるものをオーバーライドします。 +\-ext優先のオプションに加え、別の名前の、またはOID \-extのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 .LP .LP -subjectKeyIdentifier エクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifier が常に作成されます。 +subjectKeyIdentifierエクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifierが常に作成されます。 .LP .LP -\f3注:\fP ユーザーは、エクステンション (および証明書のほかのフィールド) の組み合わせによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細については、「証明書の準拠に関する注意事項」を参照してください。 +\f3注意:\fP ユーザーは、エクステンション(および証明書の他のフィールド)の組合せによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細は、証明書の準拠に関する注意事項を参照してください。 .LP .SH "コマンド" .LP @@ -785,17 +785,17 @@ .TP 3 \-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 が作成されます。 +証明書リクエスト・ファイル(\f2keytool \-certreq\fPコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\f2infile\fPから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X.509証明書を\f2outfile\fPに(省略した場合は、標準出力に)出力します。\f2\-rfc\fPを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 .LP -\f2sigalg\fP には、証明書に署名を付けるときに使うアルゴリズムを指定します。\f2startdate\fP は、証明書が有効になる開始時刻/日付です。\f2valDays\fP には、証明書の有効日数を指定します。 +\f2sigalg\fPには、証明書に署名を付けるときに使用するアルゴリズムを指定します。\f2startdate\fPは、証明書が有効になる開始時刻/日付です。\f2valDays\fPには、証明書の有効日数を指定します。 .LP -\f2dname\fP を指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書要求からの名前が使用されます。 +\f2dname\fPを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 .LP -\f2ext\fP は、証明書に埋め込まれる X.509 エクステンションを示します。\-ext の文法については、「一般オプション」を参照してください。 +\f2ext\fPは、証明書に埋め込まれるX.509エクステンションを示します。\f2\-ext\fPの構文については、一般オプションを参照してください。 .LP -\f2\-gencert\fP コマンドを使用すると、証明書チェーンを作成できます。次の例では、 \f2e1\fP という証明書を作成します。この証明書の証明書チェーンには、3 つの証明書が含まれています。 +\f2\-gencert\fPコマンドを使用すると、証明書チェーンを作成できます。次の例では、\f2e1\fPという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 .LP -次のコマンドは、ca、ca1、ca2、および e1 の 4 つの鍵ペアを作成します。 +次のコマンドは、\f2ca\fP、\f2ca1\fP、\f2ca2\fPおよび\f2e1\fPの4つの鍵ペアを作成します。 .nf \f3 .fl @@ -810,7 +810,7 @@ \fP .fi .LP -次の 2 つのコマンドは、署名付き証明書のチェーンを作成します。 \f2ca\fP は ca1 に署名し、 \f2ca1 signs ca2\fP に署名します。すべて自己発行です。 +次の2つのコマンドは、署名付き証明書のチェーンを作成します。\f2ca\fPはca1に署名し、\f2ca1\fPはca2に署名します。すべて自己発行です。 .nf \f3 .fl @@ -821,7 +821,7 @@ \fP .fi .LP -次のコマンドは、証明書 e1 を作成してファイル e1.cert に格納します。この証明書は ca2 によって署名されます。その結果、e1 の証明書チェーンには ca、ca1、および ca2 が含まれることになります。 +次のコマンドは、証明書\f2e1\fPを作成してファイル\f2e1.cert\fPに格納します。この証明書は\f2ca2\fPによって署名されます。その結果、\f2e1\fPの証明書チェーンには\f2ca\fP、\f2ca1\fPおよび\f2ca2\fPが含まれることになります。 .nf \f3 .fl @@ -832,17 +832,17 @@ .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 で特定される新しいキーストアエントリに格納されます。 +鍵のペア(公開鍵および関連する秘密鍵)を生成します。公開鍵はX.509 v3自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと秘密鍵は、\f2alias\fPで特定される新しいキーストア・エントリに格納されます。 .LP -\f2keyalg\fP は鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fP は生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。 +\f2keyalg\fPは鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fPは生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fPには、自己署名証明書に署名を付けるときに使用するアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fPと互換している必要があります。 .LP -\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の issuer フィールドと subject フィールドとして使う X.500 識別名を指定します。 コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。 +\f2dname\fPには、\f2alias\fPに関連付け、自己署名証明書の\f2issuer\fPフィールドと\f2subject\fPフィールドとして使用するX.500 識別名を指定します。コマンドラインで識別名を指定しなかった場合は、識別名の入力を求められます。 .LP -\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。 +\f2keypass\fPには、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fPは、6文字以上にする必要があります。 .LP -\f2startdate\fP には、証明書の発行時刻を指定します。これは、X.509 証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 +\f2startdate\fPには、証明書の発行時刻を指定します。これは、X.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 .LP -オプションの値は、次の 2 つの形式のいずれかで設定できます。 +オプションの値は、次の2つの形式のいずれかで設定できます。 .RS 3 .TP 3 1. @@ -852,7 +852,7 @@ [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と指定すると、開始時刻は次のようになります。 +最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\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 @@ -869,86 +869,85 @@ \fP .fi .LP -2 番目の形式では、ユーザーは、年/月/日と時間:分:秒の 2 つの部分で厳密な開始時刻を設定します (地元の時間帯を使用)。ユーザーは、1 つの部分だけを指定できます。これは、もう 1 つの部分は現在の日付 (または時刻) と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります (短い場合は 0 で埋める)。日付と時刻の両方が指定された状態で、2 つの部分の間に空白文字が 1 つ (1 つだけ) あります。時間は常に 24 時間形式で指定してください。 +2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分で厳密な開始時刻を設定します(地元の時間帯を使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 .LP -オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で 1 回指定できます。 +オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で1回指定できます。 .LP -\f2valDays\fP には、証明書の有効日数を指定します ( \f2\-startdate\fP で指定された日付、または \f2\-startdate\fP が指定されていない場合は現在の日付から始まる)。 +\f2valDays\fPには、証明書の有効日数を指定します(\f2\-startdate\fPで指定された日付、または\f2\-startdate\fPが指定されていない場合は現在の日付から始まります)。 .LP -このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\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} +\-genseckey {\-aliasalias} {\-keyalgkeyalg} {\-keysizekeysize} [\-keypasskeypass] {\-storetypestoretype} {\-keystorekeystore} [\-storepassstorepass] {\-providerClassprovider_class_name {\-providerArgprovider_arg}} {\-v} {\-protected} {\-Jjavaoption} .LP -秘密鍵を生成し、それを新しい \f2KeyStore.SecretKeyEntry\fP (\f2alias\fP で特定される) 内に格納します。 +秘密鍵を生成し、それを新しい\f2KeyStore.SecretKeyEntry\fP(\f2alias\fPで特定される)内に格納します。 .LP -\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。 +\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 によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または証明書チェーンを読み込みます。 +ファイル\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」で始まる文字列で終了しなければなりません。 +\f3keytool\fPでは、X.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了する必要があります。 .LP -証明書のインポートには、次の 2 つの目的があります。 +証明書のインポートには、次の2つの目的があります。 .RS 3 .TP 3 1. -信頼できる証明書のリストに証明書を追加する +信頼できる証明書のリストに証明書を追加します。 .TP 3 2. -CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする +CAに証明書署名リクエスト(\-certreqコマンドを参照)を送信した結果として、CAから受け取った証明応答をインポートします。 .RE .LP -どちらの種類のインポートを行うかは、 \f2\-alias\fP オプションの値によって指定します。 +どちらのタイプのインポートを行うかは、\f2\-alias\fPオプションの値によって指定します。 .RS 3 .TP 3 1. -\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内にすでに存在していてはいけません。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。 +\f3別名がキー・エントリをポイントしない場合\fP、\f3keytool\fPはユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fPはエラーを出力し、証明書のインポートを行いません。 .TP 3 2. -.LP -\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。 +\f3別名がキー・エントリをポイントする場合\fP、\f3keytool\fPはユーザーが証明書応答をインポートしようとしているものと見なします。 .RE \f3新しい信頼できる証明書のインポート\fP .LP -\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 +\f3keytool\fPは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 .LP -\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できるすなわち cacerts という名前のファイルに含まれる証明書のチェーンと見なされます。 +\f2\-trustcacerts\fPオプションを指定した場合、追加の証明書は信頼できるすなわちcacertsという名前のファイルに含まれる証明書のチェーンと見なされます。 .LP -\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかのなんらかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。 -\f3証明応答のインポート\fP +\f3keytool\fPが、インポートする証明書から自己署名証明書(キーストアまたはcacertsファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者本人など)から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、信頼できる証明書のインポートに関する注意事項を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fPオプションが指定されている場合、ユーザーとの対話は行われません。 +\f3証明書応答のインポート\fP .LP -「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\-trustcacerts オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。 +「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および(\f2\-trustcacerts\fPオプションが指定されている場合は)cacertsキーストア・ファイルで構成された証明書を使用して証明応答が検査されます。 .LP -証明応答が信頼できるかどうかを決定する方法は次のとおりです。 +証明書応答が信頼できるかどうかを決定する方法は次のとおりです。 .RS 3 .TP 2 o -\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。 +\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 オプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 +\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、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。 +証明書応答内の公開鍵が\f2alias\fPの下にすでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを新しい証明書チェーンで置き換えることができるのは、有効な\f2keypass\fP、つまり該当するエントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 .LP -このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。 +このコマンドは、以前のリリースでは\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 が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。 +\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 が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。 +\f2srcalias\fPオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\f2srcstorepass\fPを使用してそのエントリが回復されます。\f2srcstorepass\fPが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 .LP -ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 +ターゲット別名がターゲット・キーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 .LP -\f2\-noprompt\fP を指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。 +\f2\-noprompt\fPを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。 .TP 3 \-printcertreq {\-file file} .LP -PKCS #10 形式の証明書要求の内容を出力します。この要求は、keytool \-certreq コマンドで生成できます。このコマンドは、file から要求を読み込みます。file が省略されている場合は、標準入力から読み込みます。 +PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、keytool \-certreqコマンドで生成できます。このコマンドは、fileからリクエストを読み込みます。fileが省略されている場合は、標準入力から読み込みます。 .RE .LP @@ -959,29 +958,29 @@ .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) を生成します。 +PKCS#10形式を使用して証明書署名リクエスト(CSR)を生成します。 .LP -CSR は、証明書発行局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明書チェーンを送り返します。 この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。 +CSRは、証明書発行局(CA)に送信することを目的としたものです。CAは、証明書要求者を(通常はオフラインで)認証し、証明書または証明書チェーンを送り返します。この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン(最初は1つの自己署名証明書から構成される)に置き換えて使用します。 .LP -\f2alias\fP に関連付けられた非公開鍵は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。dname が指定されている場合は、それが CSR で主体として使用されます。それ以外の場合は、別名に関連付けられた X.500 識別名が使用されます。 +\f2alias\fPに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵はキーストア内ではパスワードによって保護されているので、秘密鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンドラインで\f2keypass\fPを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。dnameが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX.500識別名が使用されます。 .LP -\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。 +\f2sigalg\fPには、CSRに署名を付けるときに使用するアルゴリズムを指定します。 .LP -CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。 +CSRは、ファイル\f2certreq_file\fPに格納されます。ファイルが指定されていない場合は、標準出力にCSRが出力されます。 .LP -CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。 +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 -デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\-rfc オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。 +デフォルトでは、バイナリ符号化方式の証明書が出力されます。ただし、\f2\-rfc\fPオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。出力可能符号化方式は、インターネット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 @@ -992,35 +991,35 @@ .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 -このコマンドは、デフォルトでは証明書の SHA1 フィンガープリントを表示します。 \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 | \-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 オプションを同時に指定することはできません。同時に指定すると、エラーが報告されます。オプションが指定されていない場合は、標準入力から証明書を読み込みます。 +ファイル\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 モードで証明書を出力します。 +\f2\-rfc\fPが指定されている場合、keytoolは、インターネットRFC 1421標準で定義されているように、PEMモードで証明書を出力します。 .LP -ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネット RFC 1421 標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 +ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネットRFC 1421標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 .LP -SSL サーバーがファイアウォールの背後にある場合は、 \f2\-J\-Dhttps.proxyHost=proxyhost\fP と \f2\-J\-Dhttps.proxyPort=proxyport\fP をコマンド行で指定して、プロキシトンネリングを使用できます。詳細は、 +SSLサーバーがファイアウォールの背後にある場合は、\f2\-J\-Dhttps.proxyHost=proxyhost\fPと\f2\-J\-Dhttps.proxyPort=proxyport\fPをコマンドラインで指定して、プロキシ・トンネリングを使用できます。詳細は、 .na -\f2「JSSE リファレンスガイド」\fP @ +\f2JSSEリファレンス・ガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。 .LP -\f3注\fP: このオプションはキーストアとは関係なく使用できます。 +\f3注意\fP: このオプションはキーストアとは関係なく使用できます。 .TP 3 \-printcrl \-file crl_ {\-v} .LP -ファイル \f2crl_file\fP から証明書の取り消しリスト (CRL) を読み込みます。 +ファイル\f2crl_file\fPから証明書の取消しリスト(CRL)を読み込みます。 .LP -証明書の取り消しリスト (CRL) は、デジタル証明書を発行した証明書発行局 (CA) によって取り消されたデジタル証明書のリストです。CA は、\f2crl_file\fP を生成します。 +証明書の取消しリスト(CRL)は、デジタル証明書を発行した証明書発行局(CA)によって取り消されたデジタル証明書のリストです。CAは、\f2crl_file\fPを生成します。 .LP -\f3注\fP: このオプションはキーストアとは関係なく使用できます。 +\f3注意\fP: このオプションはキーストアとは関係なく使用できます。 .RE .LP @@ -1031,23 +1030,23 @@ .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 には、新しいパスワードを指定します。new_storepass は、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 に変更します。new_keypass は、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 @@ -1060,7 +1059,7 @@ .LP 基本的なコマンドとそのオプションの一覧を表示します。 .LP -特定のコマンドの詳細については、次のように入力してください。 \f2command_name\fP はコマンドの名前です。 +特定のコマンドの詳細を参照するには、次のように入力してください。\f2command_name\fPはコマンドの名前です。 .nf \f3 .fl @@ -1074,7 +1073,7 @@ .SH "例" .LP .LP -ここでは、自分の鍵のペアおよび信頼できるエンティティーからの証明書を管理するためのキーストアを作成する場合を例として示します。 +ここでは、自分の鍵のペアおよび信頼できるエンティティからの証明書を管理するためのキーストアを作成する場合を例として示します。 .LP .SS 鍵のペアの生成 @@ -1087,25 +1086,25 @@ .fl keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US" .fl - \-alias business \-keypass \fP\f4<非公開鍵の新しいパスワード>\fP\f3 \-keystore /working/mykeystore + \-alias business \-keypass \fP\f4<new password for private key>\fP\f3 \-keystore /working/mykeystore .fl - \-storepass \fP\f4<キーストアの新しいパスワード>\fP\f3 \-validity 180 + \-storepass \fP\f4<new password for keystore>\fP\f3 \-validity 180 .fl \fP .fi .LP .LP -注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。 +注意: このコマンドは1行に入力する必要があります。例で複数行に入力しているのは読みやすくするためです。 .LP .LP -この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアに、\f2<キーストアの新しいパスワード>\fP で指定したパスワード を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。 +この例では、workingディレクトリにmykeystoreという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\f2<new password for keystore>\fPで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2文字の国番号が「US」です。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 .LP .LP -このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵には、\f2<非公開鍵の新しいパスワード>\fP で指定したパスワードが割り当てられます。 +このコマンドは、公開鍵と識別名情報を含む自己署名証明書(デフォルトのSHA1withDSA署名アルゴリズムを使用)を作成します。証明書の有効期間は180日です。証明書は、別名「business」で特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\f2<new password for private key>\fPで指定したパスワードが割り当てられます。 .LP .LP -オプションのデフォルト値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。 デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。 +オプションのデフォルト値を使用する場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを1つも指定せずにコマンドを実行することも可能です。デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使用され、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。 .LP .nf \f3 @@ -1117,16 +1116,16 @@ .LP .LP -この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。 +この場合は、mykeyという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の .keystoreという名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードについては、入力を求められます。 .LP .LP -以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、識別名には cn=Mark Jones, ou=Java, o=Oracle, c=US と指定)。 +以降では、オプションを指定しないで\f2\-genkeypair\fPコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\f2\-genkeypair\fPコマンドの値を入力したものとします(たとえば、識別名にはcn=Mark Jones,ou=Java,o=Oracle,c=USと指定)。 .LP .SS -証明書発行局に対する署名付き証明書の要求 +証明書発行局に対する署名付き証明書のリクエスト .LP .LP -現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に証明書発行局 (CA) の署名が付いていれば、ほかのユーザーから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。 +現時点で手元にあるのは、1通の自己署名証明書のみです。証明書に証明書発行局(CA)の署名が付いていれば、他のユーザーから証明書が信頼される可能性も高くなります。このような署名を取得するには、まず、証明書署名リクエスト(CSR)を生成します。たとえば、次のようにします。 .LP .nf \f3 @@ -1138,38 +1137,38 @@ .LP .LP -CSR (デフォルト別名「mykey」によって特定されるエンティティーの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 +CSR(デフォルト別名「mykey」によって特定されるエンティティのCSR)が作成され、MarkJ.csrという名前のファイルに置かれます。このファイルは、VeriSignなどのCAに提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 .LP .SS -CA からの証明書のインポート +CAからの証明書のインポート .LP .LP -作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CA を起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 +作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CAを起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 .LP .LP -CA からの証明応答をインポートするには、キーストアか、 \f2cacerts\fP キーストアファイル (importcert コマンドで説明) 内に 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 キーストアファイルは、いくつかの 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 コマンドを使用するか、または \-noprompt オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 +「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。まず、証明書の内容を表示し(\f3keytool\fP \f2\-printcert\fPコマンドを使用するか、または\f2\-noprompt\fPオプションを指定しないで\f3keytool\fP \f2\-importcert\fPコマンドを使用し、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(または安全な公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 .LP .LP -ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。 +この証明書を有効なものとして信頼する場合は、証明書をキーストアに追加できます。たとえば、次のようにします。 .LP .nf \f3 @@ -1181,16 +1180,16 @@ .LP .LP -ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。 +ABCCA.cerファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリにabcという別名が割り当てられます。 .LP .SS -CA からの証明応答のインポート +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 @@ -1205,10 +1204,10 @@ 公開鍵を認証する証明書のエクスポート .LP .LP -たとえば、jarsigner(1) ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。 +たとえば、jarsigner(1)ツールを使用してJava ARchive(JAR)ファイルに署名を付けたとします。このファイルはクライアントによって使用されますが、クライアント側では署名を認証したいと考えています。 .LP .LP -クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。このエントリには「mykey」という別名が使われているとします。 +クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を\f2MJ.cer\fPという名前のファイルにコピーします。このエントリには「mykey」という別名が使用されているとします。 .LP .nf \f3 @@ -1220,16 +1219,16 @@ .LP .LP -証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。 +証明書と署名付きJARファイルを入手したクライアントは、\f3jarsigner\fPツールを使用して署名を認証できます。 .LP .SS キーストアのインポート .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 @@ -1240,14 +1239,14 @@ .fl \-srcstoretype JKS \-deststoretype PKCS11 .fl - \-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3 + \-srcstorepass \fP\f4<source keystore password>\fP\f3 \-deststorepass \fP\f4<destination keystore password>\fP\f3 .fl \fP .fi .LP .LP -また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 +また、importkeystoreコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcaliasオプションを指定する場合には、ターゲット別名もコマンドラインから指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 .LP .nf \f3 @@ -1258,11 +1257,11 @@ .fl \-srcstoretype JKS \-deststoretype PKCS11 .fl - \-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3 + \-srcstorepass \fP\f4<source keystore password>\fP\f3 \-deststorepass \fP\f4<destination keystore password>\fP\f3 .fl \-srcalias myprivatekey \-destalias myoldprivatekey .fl - \-srckeypass \fP\f4<ソースエントリのパスワード>\fP\f3 \-destkeypass \fP\f4<ターゲットエントリのパスワード>\fP\f3 + \-srckeypass \fP\f4<source entry password>\fP\f3 \-destkeypass \fP\f4<destination entry password>\fP\f3 .fl \-noprompt .fl @@ -1271,10 +1270,10 @@ .LP .SS -一般的な SSL サーバー用の証明書の生成 +一般的なSSLサーバー用の証明書の生成 .LP .LP -次に、3 つのエンティティー、つまりルート CA (root)、中間 CA (ca)、および SSL サーバー (server) 用の鍵ペアと証明書を生成する keytool コマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとして RSA を指定することをお勧めします。 +次に、3つのエンティティ、つまりルートCA(root)、中間CA(ca)およびSSLサーバー(server)用の鍵ペアと証明書を生成するkeytoolコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとしてRSAを指定することをお薦めします。 .LP .nf \f3 @@ -1308,7 +1307,7 @@ .SH "用語と警告" .LP .SS -KeyStore +キーストア .LP .LP キーストアは、暗号化の鍵と証明書を格納するための機能です。 @@ -1318,24 +1317,24 @@ o \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」(所有者) によって特定されるアイデンティティーに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 +\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を1つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。それは、証明書内の公開鍵が、証明書の「Subject」(所有者)によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 .RE .TP 2 o \f3キーストアの別名\fP .LP -キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。 +キーストアのすべてのエントリ(鍵および信頼できる証明書)は、一意の\f2別名\fPを介してアクセスされます。 .LP -別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明書チェーンを信頼できる証明書のリストに追加したりするなど、特定のエンティティーをキーストアに追加する場合です。これ以後、\f3keytool\fP コマンドでエンティティーを参照する場合は、このときに指定した別名を使用する必要があります。 +別名を指定するのは、\-genseckeyコマンドを使用して秘密鍵を生成したり、\-genkeypairコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\-importcertコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\f3keytool\fPコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 .LP -たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明書チェーン」を参照) でラップするとします。 この場合は、次のコマンドを実行します。 +たとえば、\f2duke\fPという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書(証明書チェーンを参照)でラップするとします。この場合は、次のコマンドを実行します。 .nf \f3 .fl @@ -1344,7 +1343,7 @@ \fP .fi .LP -ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 duke 連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。 duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。 +ここでは、初期パスワードとしてdukekeypasswdを指定しています。以後、別名\f2duke\fPに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 .nf \f3 .fl @@ -1353,36 +1352,36 @@ \fP .fi .LP -パスワードが、dukekeypasswd から newpass に変更されます。 +パスワードが、dukekeypasswdからnewpassに変更されます。 .LP -注: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 +注意: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 .TP 2 o \f3キーストアの実装\fP .LP -\f2KeyStore\fP クラス ( \f2java.security\fP パッケージで提供される) には、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。 +\f2java.security\fPパッケージで提供されている\f2KeyStore\fPクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の\f2タイプ\fPのキーストアを対象とする複数の異なる実装が存在可能です。 .LP -現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。 \f2KeyStore\fP は public として使用可能なので、JDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。 +現在、\f3keytool\fPと\f3jarsigner\fPの2つのコマンドライン・ツールと、\f3Policy Tool\fPという名前のGUIベースのツールが、キーストアの実装を使用しています。\f2KeyStore\fPはpublicとして使用可能なので、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 .LP -キーストアには、Oracle が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。 +キーストアには、Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .LP -キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが、「プロバイダ」が実装する必要のある Service Provider Interface のメソッドを定義しています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、 +キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fPによって提供されるアプリケーション・インタフェースが「サービス・プロバイダ・インタフェース」(SPI)に基づいて実装されます。つまり、対応する\f2KeystoreSpi\fP抽象クラス(これも\f2java.security\fPパッケージに含まれています)があり、このクラスが、「プロバイダ」が実装する必要のあるService Provider Interfaceのメソッドを定義しています。(ここで、「プロバイダ」とは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。)したがって、キーストアの実装を提供するには、 .na -\f2「Java(TM) 暗号化アーキテクチャー用プロバイダの実装方法」\fP @ +\f2Java暗号化アーキテクチャ用プロバイダの実装方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpiサブクラスの実装を提供する必要があります。 .LP -アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。 キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\f2KeyStore\fPクラスが提供するgetInstanceファクトリ・メソッドを使用することで、様々なプロバイダから異なる\f2タイプ\fPのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .LP -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。 +\f3keytool\fPは、任意のファイルベースのキーストア実装で動作します。(これは、コマンドラインから渡されたキーストアの場所をファイル名として扱い、これをFileInputStreamに変換して、FileInputStreamからキーストアの情報をロードします。)一方、\f3jarsigner\fPツールと\f3policytool\fPツールは、URLで指定可能な任意の場所からキーストアを読み込むことができます。 .LP -\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fPの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 +\f3keytool\fPと\f3jarsigner\fPの場合、\f2\-storetype\fPオプションを使用してコマンドラインでキーストアのタイプを指定できます。\f3Policy Tool\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 の最上位ディレクトリ) です。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合は、単純にセキュリティ・プロパティ・ファイルで指定された\f2keystore.type\fPプロパティの値に基づいて、キーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\f2java.security\fPと呼ばれ、セキュリティ・プロパティ・ディレクトリ\f2java.home\fP/lib/security内に存在しています。ここで、\f2java.home\fPは実行時環境のディレクトリ(SDKの\f2jre\fPディレクトリまたはJava 2 Runtime Environmentのトップレベル・ディレクトリ)です。 .LP -各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。 +各ツールは、\f2keystore.type\fPの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .LP -\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ ( \f2keystore.type\fP プロパティーで指定されたタイプ) のインスタンスを生成します。 +\f2KeyStore\fPクラスに定義されているstaticメソッド\f2getDefaultType\fPを使用すると、アプリケーションやアプレットから\f2keystore.type\fPプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\f2keystore.type\fPプロパティで指定されたタイプ)のインスタンスを生成します。 .nf \f3 .fl @@ -1391,7 +1390,7 @@ \fP .fi .LP -デフォルトのキーストアタイプは JKS (Oracle が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプはJKS(Oracleが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .nf \f3 .fl @@ -1402,7 +1401,7 @@ .LP 各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。 .LP -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。 +たとえば、pkcs12と呼ばれるタイプのキーストアの実装を提供しているプロバイダ・パッケージを使用するには、上の行を次のように変更します。 .nf \f3 .fl @@ -1411,14 +1410,14 @@ \fP .fi .LP -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。 +注意: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKSとjksは同じものとして扱われます。 .RE .LP .SS 証明書 .LP -\f3証明書\fP (\f3公開鍵証明書\fPとも呼ぶ) とは、あるエンティティー (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティー (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。 +\f3証明書\fP(\f3公開鍵証明書\fPとも呼ばれます)とは、あるエンティティ(\f2発行者\fP)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティ(\f2署名者\fP)の公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。 .RS 3 .TP 2 o @@ -1427,30 +1426,30 @@ .TP 3 公開鍵 .LP -公開鍵は、特定のエンティティーに関連付けられた数です。公開鍵は、該当するエンティティーとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。 +公開鍵は、特定のエンティティに関連付けられた数です。公開鍵は、該当するエンティティとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使用されます。 .TP 3 デジタル署名 .LP -データが「デジタル署名」されると、そのデータは、エンティティーの「アイデンティティー」と、そのエンティティーがデータの内容について知っていることを証明する署名とともに格納されます。エンティティーの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。 +データが「\f2デジタル署名\fP」されると、そのデータは、エンティティの「アイデンティティ」と、そのエンティティがデータの内容について知っていることを証明書する署名とともに格納されます。エンティティの秘密鍵を使用してデータに署名を付けると、データの偽造は不可能になります。 .TP 3 -アイデンティティー +アイデンティティ .LP -エンティティーを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティーにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティーとすることができます。 +エンティティを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティにするものがあります。公開鍵の他にも、Unix UIDや電子メール・アドレス、X.509識別名など、様々なものをアイデンティティとすることができます。 .TP 3 署名 .LP -署名は、なんらかのデータを基にエンティティー (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。 +署名は、なんらかのデータを基にエンティティ(\f2署名者\fP。証明書に関しては\f2発行者\fPとも呼ばれます)の秘密鍵を使用して計算されます。 .TP 3 -非公開鍵 +秘密鍵 .LP -非公開鍵は特定のエンティティーだけが知っている数のことで、この数のことを、そのエンティティーの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。 +秘密鍵は特定のエンティティのみが知っている数のことで、この数のことを、そのエンティティの秘密鍵といいます。秘密鍵は、他に知られないように秘密にしておくことが前提になっています。秘密鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSAなどの典型的な公開鍵暗号化システムの場合、1つの秘密鍵は正確に1つの公開鍵に対応します。秘密鍵は、署名を計算するのに使用されます。 .TP 3 -エンティティー +エンティティ .LP -エンテンティーは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。 +エンティティは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となる様々なものを指します。 .RE .LP -公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティー間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「証明書発行局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティーの証明書に署名する (発行する) 行為を、信頼して任されているエンティティー (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。 +公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引続き確立されていると仮定したり、使用されているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、\f2証明書発行局\fP(CA)が信頼できる第三者として機能します。CAは、他のエンティティの証明書に署名する(発行する)行為を、信頼して任されているエンティティ(企業など)です。CAは法律上の契約に拘束されるので、有効かつ信頼できる証明書のみを作成するものとして扱われます。 .na \f2VeriSign\fP @ .fi @@ -1462,49 +1461,49 @@ .na \f2Entrust\fP @ .fi -http://www.entrust.com/ をはじめ、多くの CA が存在します。Microsoft の認証サーバー、Entrust の CA 製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。 +http://www.entrust.com/をはじめ、多くの公的な証明書発行局が存在します。Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。 .LP -\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 +\f3keytool\fPを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 .LP -現在、\f3keytool\fP は X.509 証明書を対象にしています。 +現在、\f3keytool\fPはX.509証明書を対象にしています。 .TP 2 o -\f3X.509 証明書\fP +\f3X.509証明書\fP .LP -X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。 +X.509規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法(データ形式)についても記述されています。証明書のすべてのデータは、ASN.1/DERと呼ばれる2つの関連規格を使用して符号化されます。\f2Abstract Syntax Notation 1\fPはデータについて記述しています。\f2Definite Encoding Rules\fPは、データの保存および転送の方法について記述しています。 .LP -すべての X.509 証明書は、署名のほかに次のデータを含んでいます。 +すべてのX.509証明書は、署名の他に次のデータを含んでいます。 .RS 3 .TP 3 バージョン .LP -証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。keytool が生成するのは、v3 の証明書です。 +証明書に適用されるX.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3つのバージョンが定義されています。\f3keytool\fPでは、v1、v2およびv3の証明書のインポートとエクスポートが可能です。v3の証明書を生成します。 .LP -「X.509 Version 1」は、1988 年から利用されて広く普及しており、もっとも一般的です。 +\f2X.509 Version 1\fPは、1988年から利用されて広く普及しており、最も一般的です。 .LP -「X.509 Version 2」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。 +\f2X.509 Version 2\fPでは、Subjectや発行者の名前をあとで再利用できるようにするために、Subjectと発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意の識別子を使用しないことが、強く推奨されています。Version 2の証明書は、広くは使用されていません。 .LP -「X.509 Version 3」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、KeyUsage (「署名専用」など、鍵の使用を特定の目的に制限する)、AlternativeNames (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティーを公開鍵に関連付けることができる) などがあります。エクステンションには、critical というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。 +\f2X.509 Version 3\fPは最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使用されている一般的なエクステンションとしては、\f2KeyUsage\fP(「署名専用」など、鍵の使用を特定の目的に制限する)、\f2AlternativeNames\fP(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、\f2critical\fPというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、KeyCertSignが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 .TP 3 シリアル番号 .LP -証明書を作成したエンティティーは、そのエンティティーが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。 +証明書を作成したエンティティは、そのエンティティが発行する他の証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、様々な方法で使用されます。たとえば、証明書が取り消されると、シリアル番号が証明書の取消しリスト(CRL)に格納されます。 .TP 3 署名アルゴリズム識別子 .LP -証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。 +証明書に署名を付けるときにCAが使用したアルゴリズムを特定します。 .TP 3 発行者名 .LP -証明書に署名を付けたエンティティーの X.500 識別名です。エンティティーは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティーを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。 +証明書に署名を付けたエンティティのX.500識別名です。エンティティは、通常はCAです。この証明書を使用することは、証明書に署名を付けたエンティティを信頼することを意味します。\f2ルートつまりトップレベル\fPのCAの証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。 .TP 3 有効期間 .LP -各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティーが公開鍵を信頼できると期待される期間です。 +各証明書は、限られた期間のみ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から100年という長期にわたることもあります。選択される有効期間は、証明書への署名に使用される秘密鍵の強度や証明書に支払う金額など、様々な要因で異なります。有効期間は、関連する秘密鍵が損なわれない場合に、エンティティが公開鍵を信頼できると期待される期間です。 .TP 3 -Subject 名 +Subject名 .LP -証明書で公開鍵が識別されているエンティティーの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティーの X.500 識別名 (DN) です。次に例を示します。 +証明書で公開鍵が識別されているエンティティの名前です。この名前はX.500標準を使用するので、インターネット全体で一意なものと想定されます。これは、エンティティのX.500識別名(DN)です。次に例を示します。 .nf \f3 .fl @@ -1515,34 +1514,34 @@ .LP これらはそれぞれ主体の通称、組織単位、組織、国を表します。 .TP 3 -Subject の公開鍵情報 +Subjectの公開鍵情報 .LP -名前を付けられたエンティティーの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。 +名前を付けられたエンティティの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使用されている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。 .RE .TP 2 o \f3証明書チェーン\fP .LP -\f3keytool\fP では、非公開鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 +\f3keytool\fPでは、秘密鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 .LP -鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含むチェーンが開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。 \f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 +鍵を初めて作成すると(\-genkeypairコマンドを参照)、「\f2自己署名証明書\fP」という1つの要素のみを含むチェーンが開始されます。自己署名証明書は、発行者(署名者)が主体(証明書で認証されている公開鍵の持ち主)と同じである証明書のことです。\f2\-genkeypair\fPコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 .LP -このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が証明書発行局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。チェーン内のその前の証明書は、「CA」の公開鍵を認証する証明書です。 +この後、証明書署名リクエスト(CSR)が生成されて(\-certreqコマンドを参照)、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスがインポートされ(\-importcertコマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、\f2CA\fPの公開鍵を認証する証明書です。 .LP -CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これはチェーンの最初の証明書になります。場合によっては、CA が証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、チェーン内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次の CA の鍵を認証する証明書になります。 以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の (最初の証明書以後の) 各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 +CAの公開鍵を認証する証明書は、多くの場合、自己署名証明書(つまりCAが自身の公開鍵を認証した証明書)であり、これはチェーンの最初の証明書になります。場合によっては、CAが証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書(CAによって署名され、鍵エントリの公開鍵を認証する証明書)に変わりはありませんが、チェーン内のその前の証明書は、CSRの送信先のCAとは\f2別の\fPCAによって署名され、CSRの送信先のCAの公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次のCAの鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の(最初の証明書以後の)各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 .LP -多くの CA は、チェーンをサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 +多くのCAは、チェーンをサポートせずに発行済みの証明書のみを返します。特に、中間のCAが存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 .LP -別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。 +別の応答形式(PKCS#7で定義されている形式)でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fPでは、どちらの応答形式も扱うことができます。 .LP -トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し ( \f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。 +トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく(たとえば、VeriSignルートCAのような有名な識別名を使用した自己署名証明書を作成すること自体は誰でも可能)、新聞などの他の情報源に由来するものです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、その前に証明書の内容を表示し(\f2\-printcert\fPオプションを使用)、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 .TP 2 o -\f3cacerts 証明書ファイル\fP +\f3cacerts証明書ファイル\fP .LP -\f3cacerts\fP という名前の証明書ファイルは、セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。 +\f3cacerts\fPという名前の証明書ファイルは、セキュリティ・プロパティ・ディレクトリ\f2java.home\fP/lib/securityに置かれています。\f2java.home\fPは、実行環境のディレクトリ(SDKの\f2jre\fPディレクトリまたはJava 2 Runtime Environmentの最上位ディレクトリ)です。 .LP -cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、ルート CA 証明書のデフォルトセットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。 +cacertsファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプにjksを指定することで、\f3keytool\fPを使用してこのファイルの構成と管理を行うことができます。cacertsキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。 .nf \f3 .fl @@ -1551,20 +1550,20 @@ \fP .fi .LP -cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。 +cacertsキーストア・ファイルの初期パスワードは、changeitです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 .LP -\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 のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。 +\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 +\f3インターネットRFC 1421証明書符号化規格\fP .LP -多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。 +多くの場合、証明書は、バイナリ符号化ではなく、インターネットRFC 1421規格で定義されている出力可能符号化方式を使用して格納されます。「Base 64符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、他のアプリケーションに証明書を容易にエクスポートできます。 .LP -\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。 +\f2\-importcert\fPと\f2\-printcert\fPコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。 .LP -\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。 ただし、 \f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 +\f2\-exportcert\fPコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\f2\-rfc\fPオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 .LP -\f2\-list\fP コマンドでは、デフォルトで証明書の SHA1 フィンガープリントが出力されます。 \f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、 \f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。 +\f2\-list\fPコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\f2\-v\fPオプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、\f2\-rfc\fPオプションを指定すると、出力可能符号化方式で証明書が出力されます。 .LP 出力可能符号化方式で符号化された証明書は、次の行で始まります。 .nf @@ -1587,35 +1586,35 @@ .LP .SS -X.500 識別名 +X.500識別名 .LP .LP -X.500 識別名は、エンティティーを特定するために使われます。たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。 +X.500識別名は、エンティティを特定するために使用されます。たとえば、X.509証明書の\f2subject\fPフィールドと\f2issuer\fP(署名者)フィールドで指定される名前は、X.500識別名です。\f3keytool\fPは、次のサブパートをサポートしています。 .LP .RS 3 .TP 2 o -\f2commonName\fP \- 人の通称。 「Susan Jones」など +\f2commonName\fP \- 人の通称。「Susan Jones」など .TP 2 o -\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。 「仕入部」など +\f2organizationUnit\fP \- 小さな組織(部、課など)の名称。「Purchasing」など .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 -\-genkeypair コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、 次の形式で指定する必要があります。 +識別名文字列を\f2\-dname\fPオプションの値として指定する場合は(\f2\-genkeypair\fP コマンド)、次の形式で指定する必要があります。 .LP .nf \f3 @@ -1627,7 +1626,7 @@ .LP .LP -イタリック体の項目は、実際に指定する値を表します。 短縮形のキーワードの意味は、次のとおりです。 +イタリック体の項目は、実際に指定する値を表します。短縮形のキーワードの意味は、次のとおりです。 .LP .nf \f3 @@ -1661,7 +1660,7 @@ .LP .LP -次は、この文字列を使ったコマンドの例です。 +次は、この文字列を使用したコマンドの例です。 .LP .nf \f3 @@ -1675,10 +1674,10 @@ .LP .LP -キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。 +キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cnおよびCnは、どれも同じものとして扱われます。 .LP .LP -一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。 +一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントのみを指定できます。 .LP .nf \f3 @@ -1690,7 +1689,7 @@ .LP .LP -識別名文字列の値にコンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。 +識別名文字列の値にカンマが含まれる場合に、コマンドラインで文字列を指定するときには、次のようにカンマを文字「\\」でエスケープする必要があります。 .LP .nf \f3 @@ -1702,7 +1701,7 @@ .LP .LP -識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。 +識別名文字列をコマンドラインで指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンドラインで識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマを「\\」でエスケープする必要はありません。 .LP .SS 信頼できる証明書のインポートに関する注意事項 @@ -1711,7 +1710,7 @@ 重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。 .LP .LP -まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +まず、証明書の内容を表示し(\f2\-printcert\fPコマンドを使用するか、または\f2\-noprompt\fPオプションを指定しないで\f2\-importcert\fPコマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\f2/tmp/cert\fPという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\f2\-printcert\fPコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .LP .nf \f3 @@ -1741,10 +1740,10 @@ .LP .LP -次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。 +次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの(攻撃的意図を持つクラス・ファイルを含んだJARファイルなど)を信頼することになります。 .LP .LP -注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 コマンドを使用し、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。 +注意: 証明書をインポートする前に\f2\-printcert\fPコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に\f2\-importcert\fPコマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\f2\-importcert\fPコマンドを\f2\-noprompt\fPオプションを指定せずに実行した場合のみです。コマンドを使用し、\f2\-noprompt\fPオプションが指定されている場合、ユーザーとの対話は行われません。 .LP .SS パスワードに関する注意事項 @@ -1753,53 +1752,54 @@ キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。 .LP .LP -パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 +パスワードはコマンドラインで指定できます(ストアのパスワードには\f2\-storepass\fPオプション、秘密鍵のパスワードには\f2\-keypass\fPオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 .LP .LP -必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 +必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 .LP .SS 証明書の準拠に関する注意事項 .LP .LP -インターネット標準の +インターネット標準の .na \f2RFC 5280\fP @ .fi -http://tools.ietf.org/rfc/rfc5280.txt では、X.509 証明書が準拠するプロファイルを定義しています。このプロファイルには、証明書のフィールドやエクステンションで有効な値や値の組み合わせが含まれています。\f3keytool\fP では、これらのすべての規則が適用されているわけではないので、標準に準拠しない証明書が生成される可能性があり、そのような証明書は JRE やほかのアプリケーションで拒否されることがあります。ユーザーは、 \f2\-dname\fP や \f2\-ext\fP などで適正なオプションを指定するようにしてください。 +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 -jar(1) ツールのドキュメント +jar(1)ツールのドキュメント .TP 2 o -jarsigner(1) ツールのドキュメント +jarsigner(1)ツールのドキュメント .TP 2 o +\f3keytool\fPの使用例については、 .na -\f4keytool\fP\f2 の使用例については、\fP @ +\f4Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/security/index.html +http://docs.oracle.com/javase/tutorial/の .na -\f2「Java Tutorial」\fP\f4の\fP @ +\f4セキュリティ\fP @ .fi -http://download.oracle.com/javase/tutorial/「Security」\f3を参照\fP +http://docs.oracle.com/javase/tutorial/security/index.htmlを参照 .RE .LP .SH "変更点" .LP .LP -Java SE 6 で keytool のコマンドインタフェースが変更されました。 +Java SE 6でkeytoolのコマンド・インタフェースが変更されました。 .LP .LP -\f3keytool\fP は、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。 +\f3keytool\fPは、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストア・パスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。 .LP .LP -変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。 +変更されたコマンドの中には、名前のみが変更されたものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド(名前が変更されたものと廃止されたものの両方)は、このリリースでも引続きサポートされており、今後のリリースでもサポートされる予定です。keytoolのコマンド・インタフェースに加えられたすべての変更点の概要を、次に示します。 .LP .LP 名前が変更されたコマンド: @@ -1807,13 +1807,13 @@ .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
--- a/src/linux/doc/man/ja/native2ascii.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/native2ascii.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH native2ascii 1 "07 May 2011" +.TH native2ascii 1 "21 Mar 2012" .LP .SH "名前" -native2ascii \- ネイティブ \- ASCII コンバータ +native2ascii \- ネイティブ \- ASCIIコンバータ .LP .LP -サポートされる文字エンコーディングの文字のファイルを ASCII または Unicode エスケープあるいはその両方のファイルに変換します。その逆の変換も行います。 +サポートされる文字エンコーディングの文字のファイルをASCIIまたはUnicodeエスケープあるいはその両方のファイルに変換します。その逆の変換も行います。 .LP .SH "形式" .LP @@ -41,31 +41,31 @@ .SH "説明" .LP .LP -\f2native2ascii\fP Java 実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCII でエンコードされたファイルに変換します。ASCII 文字セットの一部でないすべての文字で Unicode エスケープ (「\\uxxxx」の表記) を使用します。このプロセスは、ISO\-8859\-1 文字セットに含まれない文字が含まれているプロパティーファイルで必要です。このツールは、その逆の変換を実行することもできます。 +\f2native2ascii\fP Java実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。ASCII文字セットの一部でないすべての文字でUnicodeエスケープ(「\\uxxxx」の表記)を使用します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 .LP .LP -\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、 \f2inputfile\fP を省略した場合、標準入力から入力されます。 +\f2outputfile\fPを省略した場合、標準出力に出力されます。さらに、\f2inputfile\fPを省略した場合、標準入力から入力されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-reverse -逆の処理を行います。つまり、ISO\-8859\-1 で Unicode エスケープを使ってエンコードされたファイルを、Java 実行環境でサポートされる文字エンコーディングのファイルに変換します。 +逆の処理を行います。つまり、ISO\-8859\-1でUnicodeエスケープを使用してエンコードされたファイルを、Java実行環境でサポートされる文字エンコーディングのファイルに変換します。 .br .br .TP 3 \-encoding encoding_name -変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング ( \f2java.nio.charset.Charset.defaultCharset\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ドキュメントに示されている、Java 実行環境でサポートされる文字エンコーディングの名前にする必要があります。 +http://download.oracle.com/javase/7/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/src/linux/doc/man/ja/orbd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/orbd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,21 +19,21 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH orbd 1 "07 May 2011" +.TH orbd 1 "21 Mar 2012" .LP .SH "名前" orbd \- The Object Request Broker Daemon .LP .LP -\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。 +\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 +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html .LP .SH "形式" .LP @@ -49,27 +49,27 @@ .SH "説明" .LP .LP -\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。 +\f3orbd\fPツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーム・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 .LP .RS 3 .TP 2 o -ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。 +ネーム・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーム・サービスのサーバーによってネーム・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDがいつでも正しいオブジェクト参照を返します。 .TP 2 o -クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる +クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。 .RE .LP .LP -ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。 +ORBDのサーバー・マネージャにアクセスするには、servertool(1)を使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動およびシャットダウンを行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、このドキュメントの\f2サーバー・マネージャ\fPという項を参照してください。 .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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .LP .SH "オプション" .LP @@ -79,7 +79,7 @@ .RS 3 .TP 3 \-ORBInitialPort nameserverport -ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須) +ネーム・サーバーを起動するポートの番号を指定します。\f2orbd\fPは、起動されると、このポート上で着信リクエストを待機します。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。(必須) .RE .LP @@ -92,70 +92,70 @@ .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 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) +\f2servertool\fPを使用して登録された永続サーバーが正常に動作していることをORBDが確認する回数を指定します。デフォルト値は1,000ミリ秒です。\f2milliseconds\fPに指定する値は、有効な正の整数にする必要があります。(省略可) .RE .LP .RS 3 .TP 3 \-serverStartupDelay milliseconds -\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) +\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://download.oracle.com/javase/7/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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingをネーム・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。 .LP .LP -ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。 +ORBDは、クライアントまたはサーバーを実行する前に起動します。ORBDには、永続ネーム・サービスおよび一時ネーム・サービスが組み込まれています。これらはどちらもCOSネーム・サービスの実装です。 .LP .LP -\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。 +\f4永続\fP\f3ネーム・サービス\fPは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーム・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。 .LP .LP \ .LP .LP -下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。 +下位互換性のため、旧バージョンのJDKに同梱されていた\f4一時\fP\f3ネーム・サービス\fP\f2tnameserv\fPが、今回のリリースのJ2SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 .LP .LP -\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。 +\f2\-ORBInitialPort\fP引数は、\f2orbd\fPの必須のコマンドライン引数で、ネーム・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java\ IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 .LP .LP -UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。 +UNIXコマンド・シェルで\f2orbd\fPを起動するには、次のように入力します。 .LP .nf \f3 @@ -167,7 +167,7 @@ .LP .LP -Windows の MS\-DOS システムプロンプトでは、次のように入力します。 +WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。 .LP .nf \f3 @@ -179,7 +179,7 @@ .LP .LP -これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。 +これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーム・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。 .LP .nf \f3 @@ -197,7 +197,7 @@ .LP .LP -この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。 +この例では、ネーム・サービスは、ホストMyHostのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、「HelloApplication」を起動できます。 .LP .nf \f3 @@ -209,35 +209,35 @@ .LP .LP -ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。 +ネーム・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Solaris上で\f2pkill orbd\fPを実行したり、\f2orbd\fPが動作中のDOSウィンドウで\f2[Ctrl]+[C]\fPキーを押します。一時ネーム・サービスの場合は、サービスが終了されると、ネーム・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 .LP .LP -ORDB に含まれるネームサービスの詳細については、 +ORBDに含まれるネーム・サービスの詳細は、 .na -\f2「ネームサービス」\fP @ +\f2ネーム・サービス\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .LP -.SH "サーバーマネージャー" +.SH "サーバー・マネージャ" .LP .LP -ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\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://download.oracle.com/javase/7/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 \ @@ -252,7 +252,7 @@ .LP .LP -Windows の MS\-DOS システムプロンプトでは、次のように入力します。 +WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。 .LP .nf \f3 @@ -264,13 +264,13 @@ .LP .LP -\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。 +\f21050\fPはネーム・サーバーを実行するポートです。\f2\-ORBInitialPort\fPは必要なコマンドラインの引数です。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .LP .LP -\f2servertool\fP を起動します。 +\f2servertool\fPを起動します。 .LP .LP -Hello サーバーを起動するには、次のように入力します。 +Helloサーバーを起動するには、次のように入力します。 .LP .nf \f3 @@ -282,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 @@ -305,13 +305,13 @@ .LP .LP -\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。 +\f2servertool\fPによってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。 .LP .LP .LP .LP -別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。 +別の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 .LP .LP \ @@ -326,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 \ @@ -338,13 +338,13 @@ \ .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をシャットダウンするには、サーバーを実行しているウィンドウを選択して\f2[Ctrl]+[C]\fPキーを押します。UNIXシェルで\f2orbd\fPをシャットダウンするには、プロセスを検出して終了(kill)します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。 .LP .LP -\f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。 +\f2servertool\fPをシャットダウンするには、\f2quit\fPと入力してキーボードの\f2[Enter]\fPキーを押します。 .LP .SH "関連項目" .LP @@ -352,9 +352,9 @@ .TP 2 o .na -\f2ネームサービス\fP @ +\f2ネーム・サービス\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html .br .TP 2 o
--- a/src/linux/doc/man/ja/pack200.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/pack200.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH pack200 1 "07 May 2011" +.TH pack200 1 "21 Mar 2012" .LP .SH "名前" -pack200 \- JAR パックツール +pack200 \- JARパック・ツール .LP .RS 3 .TP 2 @@ -43,7 +43,7 @@ 関連項目 .TP 2 o -注意事項 +注意 .RE .LP @@ -53,12 +53,12 @@ \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP .LP .LP -オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションの指定順序に決まりはありません。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .LP .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 output\-file 出力ファイルの名前。 @@ -68,13 +68,13 @@ .RE .LP -.SH " 説明" +.SH "説明" .LP .LP -\f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。 +\f2pack200\fPツールは、Java \f2gzip\fP圧縮プログラムを使用してJARファイルを\f2pack200\fP圧縮ファイルに変換するJavaアプリケーションです。\f2pack200\fPファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接デプロイすることができます。 .LP .LP -\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 +\f2pack200\fPツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 .LP .SS 一般的な使用方法: @@ -83,7 +83,7 @@ \f2% pack200 myarchive.pack.gz myarchive.jar\fP .LP .LP -この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。 +この例では、デフォルトの\f2pack200\fP設定を使用して\f2myarchive.pack.gz\fPが生成されます。 .LP .SH "オプション" .LP @@ -91,7 +91,7 @@ \f4\-r \-\-repack\fP .LP .LP -ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。 +ファイル\f2myarchive.jar\fPをパックした後アンパックすることで、JARファイルを生成します。生成されたファイルは\f2jarsigner(1)\fPツールの入力ファイルとして使用できます。 .LP .LP \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP @@ -103,7 +103,7 @@ \f4\-g \-\-no\-gzip\fP .LP .LP -\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。 +\f2pack200\fPファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 .LP .LP \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP @@ -112,7 +112,7 @@ \f4\-G \-\-strip\-debug\fP .LP .LP -出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 +出力からデバッグ用の属性を削除します。これには、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、\f2LocalVariableTypeTable\fPが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 .LP .LP \f4\-\-keep\-file\-order\fP @@ -124,53 +124,53 @@ \f4\-O \-\-no\-keep\-file\-order\fP .LP .LP -パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。 +パック・ツールは、すべての要素を並べ替えて転送します。さらに、JARディレクトリ名が削除される場合があります。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとするJARファイルの最適化機能は正常に動作しなくなることがあります。 .LP .LP \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP .LP .LP -この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが +この値は、各アーカイブ・セグメントの予想ターゲット・サイズN(バイト単位)です。単一の入力ファイルの必要サイズが .br -N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 +Nバイトを超えると、そのファイルには独立したアーカイブ・セグメントが割り当てられます。特殊なケースとして、値が\f2\-1\fPの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が\f20\fPの場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 .LP .LP -各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。 +各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。 .LP .LP -デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。 +デフォルトは \-1です。つまり、パック・ツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化(分割)してより小さなJARにすることを強くお薦めします。 .LP .LP -この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。 +この制限が課されていない10MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。 .LP .LP \f4\-Evalue \-\-effort=\fP\f2value\fP .LP .LP -単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 +単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル\f21\fPの場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル\f29\fPの場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値\f20\fPを指定した場合は、元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 .LP .LP -デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。 +デフォルトは\f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。 .LP .LP \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP .LP .LP -デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。 +入力情報を保存するというデフォルト値を上書きします。転送されるアーカイブのサイズは大きくなる場合があります。次の値を指定できます。 .LP .RS 3 .TP 3 true .TP 3 false -どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。 +どちらの場合でも、指定に従ってパック・ツールがデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 .RE .LP .RS 3 .TP 3 keep -入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。) +入力JAR.内で見つかったデフレーション・ヒントを維持します。(これがデフォルトです。) .RE .LP @@ -178,15 +178,15 @@ \f4\-mvalue \-\-modification\-time=\fP\f2value\fP .LP .LP -返される値は次のどれかになります。 +次の値を指定できます。 .LP .RS 3 .TP 3 latest -パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 +パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 .TP 3 keep -入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。) +入力JAR内で見つかった変更時刻を維持します。(これがデフォルトです。) .RE .LP @@ -194,24 +194,24 @@ \f4\-Pfile \-\-pass\-file=\fP\f2file\fP .LP .LP -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 +ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。fileにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 .LP .LP \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP .LP .LP -デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値: +デフォルトの動作を無効にします。たとえば、不明な属性を含むクラス・ファイルを指定したアクションで転送します。アクションとして指定可能な値は次のとおりです。 .LP .RS 3 .TP 3 error -\f2pack200\fP の操作に失敗し、適切な解説が表示されます。 +\f2pack200\fPの操作全体に失敗し、適切な解説が表示されます。 .TP 3 strip -属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。 +属性がドロップされます。注意: VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。 .TP 3 pass -この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。 +この属性が検出された場合、クラス全体が1つのリソースとして転送されます。 .RE .LP @@ -225,31 +225,31 @@ \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP .LP .LP -これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値: +これら4つのオプションでは、クラス・エンティティにClass属性、Field属性、Method属性、Code属性などの属性のレイアウトを指定できます。attribute\-nameには、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値は次のとおりです。 .LP .RS 3 .TP 3 some\-layout\-string -レイアウト言語は、JSR 200 仕様に定義されています。 +レイアウト言語は、JSR 200仕様に定義されています。 .LP 例: \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 .LP \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP .LP .LP -コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。 +コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 .LP .LP \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP @@ -284,13 +284,13 @@ \f4\-q \-\-quiet\fP .LP .LP -メッセージを表示せずに動作します。 +メッセージを表示せずに動作するように指定します。 .LP .LP \f4\-lfilename \-\-log\-file=\fP\f2filename\fP .LP .LP -出力メッセージのログファイルを指定します。 +出力メッセージのログ・ファイルを指定します。 .LP .LP \f4\-? \-h \-\-help\fP @@ -308,7 +308,7 @@ \f4\-J\fP\f2option\fP .LP .LP -\f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。 +\f2option\fPを、\f2pack200\fPから呼び出されたJava起動ツールに渡します。たとえば、\f2\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーが48Mバイトに設定されます。このオプションは\f2\-X\fPで始まっていませんが、\f2pack200\fPの標準オプションではありません。\f2\-J\fPを使用して、Javaで記述されたアプリケーションを実行する背後のVMにオプション渡すことは、よく行われています。 .LP .SH "終了ステータス" .LP @@ -316,10 +316,10 @@ 次の終了値が返されます。 .LP .LP -\f2\ 0\fP 正常終了した場合 +\f2\ 0\fP正常終了した場合 .LP .LP -\f2>0\fP エラーが発生した場合 +\f2>0\fPエラーが発生した場合 .LP .SH "関連項目" .LP @@ -330,33 +330,33 @@ .TP 2 o .na -\f2Java SE のドキュメント\fP @ +\f2Java SEのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/index.html +http://download.oracle.com/javase/7/docs/index.html .TP 2 o .na -\f2「Java 配備ガイド \- Pack200」\fP @ +\f2Javaデプロイメント・ガイド \- Pack200\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html +http://download.oracle.com/javase/7/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 "注意事項" +.SH "注意" .LP .LP -このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。 +このコマンドと\f2pack(1)\fPを混同しないでください。これらは別製品です。 .LP .LP -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 +JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .LP
--- a/src/linux/doc/man/ja/policytool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/policytool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH policytool 1 "07 May 2011" +.TH policytool 1 "21 Mar 2012" .LP .SH "名前" -policytool \- PolicyTool 管理 GUI ユーティリティー +policytool \- PolicyTool管理GUIユーティリティ .LP -\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。 +\f3policytool\fPは、ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。 .RS 3 .TP 2 o @@ -44,62 +44,77 @@ .LP .SH "形式" .LP -.RS 3 -.TP 3 -\ -.TP 3 -policytool 管理者ユーティリティーを実行します -\f4policytool\fP -.TP 3 -policytool を実行し、指定されたポリシーファイルを読み込みます -\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP -.TP 3 -\ -.TP 3 -以下にそれぞれの意味を示します。 +.LP +policytool管理者ユーティリティを実行します +.LP +.LP +\f4policytool\fP +.LP +.LP +policytoolを実行し、指定されたポリシー・ファイルを読み込みます +.LP +.LP +\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP +.LP +.LP +説明 +.LP .RS 3 .TP 3 file -ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します +ローカル・ポリシー・ファイルを読み込むように\f2policytool\fPに指示します .TP 3 filename ファイル名 .RE -.SH "説明" + .LP -\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、 +.SH "説明" +.LP +.LP +\f3policytool\fPは、ユーザーがローカル・ポリシー・ファイルの内容を管理することを可能にするGUIです。詳細は、 .na -\f2「ポリシーファイル作成および管理ツール」\fP @ +\f2ポリシー・ファイル作成および管理ツール\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。 -.SH "オプション" +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。 +.LP +.SH "オプション" +.LP .RS 3 .TP 3 file -\f2filename\fP を読み込みます。 -.SH "関連項目" -.na -\f2「Default Policy Implementation and Syntax」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html -.br -.na -\f2「Policy Tool Users' Guide」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html -.br -.na -\f2「Security Permissions」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html -.br -.na -\f2「Security Overview」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html -.br -.RE +\f2filename\fPを読み込みます。 .RE .LP +.SH "関連項目" +.LP +.na +\f2デフォルトのポリシー実装および構文\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyFiles.html +.br + +.LP +.na +\f2ポリシー・ツール・ユーザーズ・ガイド\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.html +.br + +.LP +.na +\f2セキュリティ権限\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/permissions.html +.br + +.LP +.na +\f2セキュリティの概要\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/overview/jsoverview.html +.br + +.LP
--- a/src/linux/doc/man/ja/rmic.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/rmic.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmic 1 "07 May 2011" +.TH rmic 1 "21 Mar 2012" .LP .SH "名前" -rmic \- Java RMI コンパイラ +rmic \- Java RMIコンパイラ .LP .LP -\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。 +\f3rmic\fPによって、JRMPまたはIIOPプロトコルを使用するリモート・オブジェクトのスタブ、スケルトン、およびTieクラスが生成されます。また、OMG IDLも生成されます。 .LP .SH "形式" .LP @@ -42,7 +42,7 @@ .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 @@ -54,32 +54,32 @@ .LP .LP -\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。 +\f2HelloImpl_Stub.class\fPファイルが、クラスのパッケージ名が付いた\f2hello\fPサブディレクトリに作成されます。 .LP .LP -リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。 +リモート・オブジェクトの\f2スケルトン\fPはJRMPプロトコル・サーバー側のエンティティで、実際のリモート・オブジェクト実装を呼び出すメソッドを含みます。 .LP .LP -リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。 +リモート・オブジェクトの\f2Tie\fPは、スケルトンと同様にサーバー側のエンティティですが、IIOPプロトコルを使用してクライアントと通信します。 .LP .LP -「スタブ」とは、リモートオブジェクトのクライアント側での代理です。スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。 +\f2スタブ\fPとは、リモート・オブジェクトのクライアント側での代理です。スタブは、リモート・オブジェクトのメソッド呼出しを、実物のリモート・オブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモート・オブジェクトへの参照は、実際はローカル・スタブへの参照となります。 .LP .LP -デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。 +デフォルトで\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 メソッドを使わなければなりません。 +スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクト自体が実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\f2PortableRemoteObject.narrow\fPメソッドを使用する必要があります。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-bootclasspath path -ブートストラップクラスファイルの位置をオーバーライドします。 +ブートストラップ・クラス・ファイルの位置をオーバーライドします。 .TP 3 \-classpath path -\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。 +\f3rmic\fPがクラスを探すためのパスを指定します。このオプションは、デフォルトやCLASSPATH環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fPの一般形式は次のようになります。 .nf \f3 .fl @@ -87,7 +87,7 @@ .fl \fP .fi -例を示します。 +次に例を示します。 .nf \f3 .fl @@ -97,7 +97,7 @@ .fi .TP 3 \-d directory -生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。 +生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使用すると、スタブ、スケルトン、およびTieファイルを格納するディレクトリを指定できます。たとえば、次のように使用します。 .nf \f3 .fl @@ -105,7 +105,7 @@ .fl \fP .fi -MyClass から取得した \f2スタブとスケルトンクラスを\fP \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。) +\f2MyClass\fPから取得したスタブとスケルトン・クラスを\f2/java/classes/foo\fPディレクトリに置きます。\f2\-d\fPオプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトン・ファイルがそのディレクトリに格納されます。(以前のバージョンの\f3rmic\fPでは、\f2\-d\fPが指定されていない場合は、パッケージ階層は作成\f2されず\fP、出力ファイルはすべて現在のディレクトリに直接格納されていた。) .br \ .TP 3 @@ -113,93 +113,89 @@ インストール型拡張機能の位置をオーバーライドします。 .TP 3 \-g -局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。 +ローカル変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報のみ生成されます。 .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 @ +\f2Java 言語とIDLのマッピング\fP @ .fi -http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。 -.LP -\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。 +http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm(OMG)を参照してください。 +.br +.br +\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 .TP 3 \-iiop -\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。 -.LP -\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。 +\f2rmic\fPによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、実際にはスタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 +.br +.br +\f2\-iiop\fPを使用して\f2rmic\fPを呼び出すと、次の命名規約に準拠したスタブとTieが生成されます。 .nf \f3 .fl _<implementationName>_stub.class .fl -\fP -.br -\f3 -.fl _<interfaceName>_tie.class .fl \fP .fi -.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 に変わります。 -.LP +継承が\f2org.omg.CORBA_2_3.portable.ObjectImpl\fPから\f2org.omg.PortableServer.Servant\fPに変わります。 .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 Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。 +http://download.oracle.com/javase/7/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 オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 +\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 警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。 .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 -コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。 +コンパイラやリンカーが、コンパイルされているクラスやロードされているクラス・ファイルについてのメッセージを表示するようにします。 .TP 3 \-v1.1 -1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。 +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 @@ -208,7 +204,7 @@ .RS 3 .TP 3 CLASSPATH -ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 +ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に示します。 .nf \f3 .fl @@ -226,6 +222,6 @@ .na \f2CLASSPATH\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpath .LP
--- a/src/linux/doc/man/ja/rmid.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/rmid.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmid 1 "07 May 2011" +.TH rmid 1 "21 Mar 2012" .LP .SH "名前" -rmid \- Java RMI 起動システムデーモン +rmid \- Java RMI起動システム・デーモン .LP .LP -\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。 +\f3rmid\fPでアクティブ化するシステム・デーモンを開始すると、オブジェクトを仮想マシン(VM)に登録してアクティブ化できるようになります。 .LP .SH "形式" .LP @@ -42,18 +42,18 @@ .SH "説明" .LP .LP -\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、 +\f3rmid\fPツールは、起動システム・デーモンを開始します。アクティブ化システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、VM内でアクティブ化したりすることができません。起動可能なリモート・オブジェクトを使用したプログラムの作成方法の詳細は、 .na -\f2「Java RMI 仕様」\fP @ +\f2Java RMI仕様\fP @ .fi -http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび +http://download.oracle.com/javase/7/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://download.oracle.com/javase/7/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。 .LP .LP -デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。 +デーモンを起動するには、次のように、セキュリティ・ポリシー・ファイルを指定して\f2rmid\fPコマンドを実行します。 .LP .nf \f3 @@ -65,23 +65,23 @@ .LP .LP -\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 が使用するポリシーを決定します。 +\f3注意:\fP \f2rmid\fPのSunの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\f2rmid\fPが起動グループ用にVMを起動するために各\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを検証できるようにするためです。特に、\f2ActivationGroupDesc\fPのコンストラクタに渡される\f2CommandEnvironment\fPや任意の\f2Properties\fPによって指定されるコマンドおよびオプションは、\f2rmid\fPのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fPプロパティの値は、起動グループ用にVMを起動するために\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを判断するときに\f2rmid\fPが使用するポリシーを決定します。 .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 -レジストリにほかのポートを指定するには、rmid の起動時に \f2\-port\fP オプションを \f2指定しなければなりません\fP。次に例を示します。 +レジストリに他のポートを指定するには、\f2rmid\fPの起動時に\f2\-port\fPオプションを指定する必要があります。次に示します。 .LP .nf \f3 @@ -93,42 +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 を開始すると、System.inheritedChannel メソッドを呼び出して、継承されたチャンネル ( \f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。 継承されたチャンネルが \f2null\fP であるか、 \f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、 \f2rmid\fP rmid はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。 +\f2rmid\fPを開始すると、\f2System.inheritedChannel\fPメソッドを呼び出して、継承されたチャンネル(\f2inetd\fP/\f2xinetd\fPから継承)を取得しようとします。継承されたチャンネルが\f2null\fPであるか、\f2java.nio.channels.ServerSocketChannel\fPのインスタンスでなかった場合、\f2rmid\fPはそのチャンネルは\f2inetd\fP/\f2xinetd\fPによって起動されたものではないと判断し、前述のように起動します。 .LP .LP -継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、 \f2rmid\fP はエクスポートするリモートオブジェクト、つまり java.rmi.activation.ActivationSystem がバインドされているレジストリと java.rmi.activation.Activator リモートオブジェクトに対する要求を受信するサーバーソケットとして、ServerSocketChannel から取得した java.net.ServerSocket を使用します。 このモードでは、 \f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。 +継承されたチャンネルが\f2ServerSocketChannel\fPインスタンスである場合は、\f2rmid\fPはエクスポートするリモート・オブジェクト、つまり\f2java.rmi.activation.ActivationSystem\fPがバインドされているレジストリと\f2java.rmi.activation.Activator\fPリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\f2ServerSocketChannel\fPから取得した\f2java.net.ServerSocket\fPを使用します。このモードでは、\f2rmid\fPの動作は、\f2次のことを除いて\fP、コマンドラインから起動した場合と同じです。 .LP .RS 3 .TP 2 o -\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。ファイル名の接頭辞は \f2"rmid\-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 .RS 3 .TP 3 \-C<someCommandLineOption> -\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各仮想マシンにプロパティーを渡すことができます。 +\f2rmid\fPの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 .nf \f3 .fl @@ -136,7 +136,7 @@ .fl \fP .fi -コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。 +コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。 .nf \f3 .fl @@ -144,11 +144,11 @@ .fl \fP .fi -このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。 +このコマンドにより、すべての子VMでサーバー呼出しのログが作成されるようになります。 .LP .TP 3 \-J<someCommandLineOption> -rmid を実行している \f2java\fP インタプリタに渡すオプションを指定します。 たとえば、 \f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、rmid のコマンド行で \f2\-J\fP オプションを使って、 \f2java.security.policy\fP プロパティーを定義します。 次に例を示します。 +\f2rmid\fPを実行している\f2java\fPインタプリタに渡すオプションを指定します。たとえば、\f2rmid\fPが\f2rmid.policy\fPという名前のポリシー・ファイルを使用するように指定するには、\f2rmid\fPのコマンドラインで\f2\-J\fPオプションを使用して、\f2java.security.policy\fPプロパティを定義します。次に例を示します。 .nf \f3 .fl @@ -158,15 +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 です。 +起動グループが実行されることになる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\f4指定されていない\fP\f3場合)\fP .LP -デフォルトの \f2execPolicy\fP の場合、 \f2rmid\fP が実行できるのは、 \f2rmid\fP が使用するセキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。 +デフォルトの\f2execPolicy\fPの場合、\f2rmid\fPが実行できるのは、\f2rmid\fPが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\f2rmid\fPに与えられているコマンドおよびコマンドライン・オプションのみです。\f2デフォルト\fPの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 .LP -\f2rmid は、\fP 起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、 \f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、 \f2rmid は\fP java.home にある \f2java\fP コマンドを使用します。 グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。このプロパティーは、次のように定義します。 +\f2rmid\fPは、起動グループ用のVMを起動するときに、そのグループについて登録された起動グループ記述子である\f2ActivationGroupDesc\fP内の情報を使用します。グループ記述子は、\f2ActivationGroupDesc.CommandEnvironment\fPを指定します(省略可能)。これには、起動グループを開始する\f2コマンド\fPと、そのコマンドラインに追加できるコマンドライン・\f2オプション\fPが含まれています。デフォルトでは、\f2rmid\fPは\f2java.home\fPにある\f2java\fPコマンドを使用します。グループ記述子には、オプションとしてコマンドラインに追加される\f2プロパティ\fP・オーバーライドも含まれています。このプロパティは、次のように定義します。 .nf \f3 .fl @@ -175,33 +175,33 @@ \fP .fi .LP -アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、 \f2rmid\fP に対して、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに rmid が使用できるようになります。 +アクセス権\f2com.sun.rmi.rmid.ExecPermission\fPを使用すると、\f2rmid\fPに対して、グループ記述子の\f2CommandEnvironment\fPで指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権\f2com.sun.rmi.rmid.ExecOptionPermission\fPを使用すると、グループ記述子でプロパティ・オーバーライドとして指定されたコマンドライン・オプション、または\f2CommandEnvironment\fPでオプションとして指定されたコマンドライン・オプションを、起動グループを開始するときに\f2rmid\fPが使用できるようになります。 .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特定の\f2コマンド\fPを実行する権限を表します。 .LP \f3構文\fP .br -\f2ExecPermission\fP の「名前」は、 \f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 File.separatorChar) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。 「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。 +\f2ExecPermission\fPの\f2名前\fPは、\f2rmid\fPに実行を許可するコマンドのパス名です。「/*」(「/」はファイル区切り文字\f2File.separatorChar\fP)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン「<<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で特定のコマンドライン・\f2オプション\fPを使用できる権限を表します。\f2ExecOptionPermission\fPの\f2名前\fPは、コマンドライン・オプションの値です。 .LP \f3構文\fP .br -オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。 +オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスクは、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。 .LP 例を示します。「*」、「\-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 -rmid に各種の実行権限を許可するポリシーファイルの例を、次に示します。 +\f2rmid\fPに各種の実行権限を許可するポリシー・ファイルの例を、次に示します。 .nf \f3 .fl @@ -239,11 +239,11 @@ .fl \fP .fi -最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンドを使用します。 \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。 +最初に付与されているアクセス権は、\f2rmid\fPに対し、パス名により明示的に指定される\f2java\fPコマンドの1.7.0バージョンの実行を許可します。デフォルトでは、\f2java.home\fPにあるバージョンの\f2java\fPコマンドを使用します。\f2rmid\fPが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目のアクセス権は、\f2rmid\fPに対して、ディレクトリ\f2/files/apps/rmidcmds\fP内の任意のコマンドの実行権限を許可します。 .LP -3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。 +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 プロパティーを指定する必要があります。 次に例を示します。 +ポリシー・ファイルを指定して\f2rmid\fPを起動するには、\f2rmid\fPのコマンドラインで\f2java.security.policy\fPプロパティを指定する必要があります。次に例を示します。 .LP \f2rmid \-J\-Djava.security.policy=rmid.policy\fP .RE @@ -251,9 +251,9 @@ 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 @@ -265,21 +265,21 @@ .fl \fP .fi -起動グループを開始する前に、 \f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。 \f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、 \f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。 +アクティブ化グループを開始する前に、\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 -起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに、 \f2log\fP というログディレクトリが作成されます。 +起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\f2rmid\fPコマンドを実行したディレクトリに、\f2log\fPというログ・ディレクトリが作成されます。 .LP .TP 3 \-port port -\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、 \f2java.rmi.activation.ActivationSystem\fP という名前でActivationSystem をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。 +\f2rmid\fPのレジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\f2java.rmi.activation.ActivationSystem\fPという名前で\f2ActivationSystem\fPをバインドします。したがって、ローカル・マシン上の\f2ActivationSystem\fPは、次のように\f2Naming.lookup\fPメソッドを呼び出すことによって取得できます。 .nf \f3 .fl @@ -296,7 +296,7 @@ .fi .TP 3 \-stop -\-port オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。 ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。 +\f2\-port\fPオプションによって指定されたポートの、現在の\f2rmid\fP呼出しを停止します。ポートが指定されていない場合は、ポート1098で実行されている\f2rmid\fPを停止します。 .RE .LP @@ -305,7 +305,7 @@ .RS 3 .TP 3 CLASSPATH -ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。 +ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 .nf \f3 .fl @@ -323,6 +323,6 @@ .na \f2CLASSPATH\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1) +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpath、java(1) .LP
--- a/src/linux/doc/man/ja/rmiregistry.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/rmiregistry.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmiregistry 1 "07 May 2011" +.TH rmiregistry 1 "21 Mar 2012" .LP .SH "名前" -rmiregistry \- Java リモートオブジェクトレジストリ +rmiregistry \- Javaリモート・オブジェクト・レジストリ .LP .RS 3 -\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。 +\f3rmiregistry\fPコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。 .RE .LP @@ -44,29 +44,29 @@ .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 +\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 .RS 3 .TP 3 \-J -\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 +\f2\-J\fPの後ろに続くオプションを\f2java\fPインタプリタに引き渡します。\f2java\fPオプションと組み合せて使用します(\-Jとjavaオプションの間にスペースは入れない)。 .RE .LP @@ -76,8 +76,8 @@ .na \f2java.rmi.registry.LocateRegistry\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および +http://download.oracle.com/javase/7/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 +http://download.oracle.com/javase/7/docs/api/java/rmi/Naming.html
--- a/src/linux/doc/man/ja/schemagen.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/schemagen.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,29 +19,29 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH schemagen 1 "07 May 2011" +.TH schemagen 1 "21 Mar 2012" .LP .SH "名前" -schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ +schemagen \- XMLバインドのためのJava(tm)アーキテクチャ・スキーマ・ジェネレータ .LP .LP \f3仕様バージョン:\fP 2.1 .br \f3実装バージョン:\fP 2.1.3 .LP -.SH "schemagen の起動" +.SH "schemagenの起動" .LP .LP -スキーマジェネレータを起動するには、ユーザーのプラットフォームの bin ディレクトリ内にある \f2適切な schemagen シェルスクリプト\fP を使用 \f2します\fP 。 +スキーマ・ジェネレータを起動するには、ユーザーのプラットフォームの\f2bin\fPディレクトリ内にある適切な\f2schemagen\fPシェル・スクリプトを使用します。 .LP .LP -現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。 +現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 .LP .LP -また、スキーマジェネレータを実行するための Ant タスクも用意されています。 +また、スキーマ・ジェネレータを実行するためのAntタスクも用意されています。 .na -\f2schemagen を Ant とともに使用する\fP @ +\f2schemagenをAntとともに使用する\fP @ .fi https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。 .LP @@ -57,46 +57,46 @@ .LP .LP -ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP を使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。 +ユーザーのJavaソース/クラスが他のクラスを参照している場合、システムのCLASSPATH環境変数でそれらのクラスにアクセスできるようになっているか、\f2\-classpath\fP/\f2\-cp\fPを使用してそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。 .LP .SS -コマンド行オプション +コマンドライン・オプション .LP .nf \f3 .fl -使用方法: schemagen [\-options ...] <java files> +Usage: schemagen [\-options ...] <java files> .fl .fl -オプション: +Options: .fl - \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します。 + \-d <path> : specify where to place processor and javac generated class files .fl - \-cp <path> : ユーザー指定ファイルの検索場所を指定します。 + \-cp <path> : specify where to find user specified files .fl - \-classpath <path> : ユーザー指定ファイルの検索場所を指定します。 + \-classpath <path> : specify where to find user specified files .fl - \-encoding <encoding> : apt/javac 呼び出しに使用されるエンコーディングを指定します。 + \-encoding <encoding> : specify encoding to be used for apt/javac invocation .fl .fl - \-episode <file> : 個別コンパイル用のエピソードファイルを生成します。 + \-episode <file> : generate episode file for separate compilation .fl - \-version : バージョン情報を表示します。 + \-version : display version information .fl - \-help : この使用方法に関するメッセージを表示します。 + \-help : display this usage message .fl \fP .fi .LP -.SH "生成されるリソースファイル" +.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を使用してください。 .LP @@ -106,21 +106,21 @@ .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、 .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バインドのためのJavaアーキテクチャ(JAXB)\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html .RE .LP
--- a/src/linux/doc/man/ja/serialver.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/serialver.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH serialver 1 "07 May 2011" +.TH serialver 1 "21 Mar 2012" .LP .SH "名前" -serialver \- シリアルバージョンコマンド +serialver \- シリアル・バージョン・コマンド .LP .LP -\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。 +\f3serialver\fPコマンドは\f2serialVersionUID\fPを返します。 .LP .SH "形式" .LP @@ -41,23 +41,23 @@ .RS 3 .TP 3 options -このドキュメントで説明されているコマンド行オプションです。 +このドキュメントで説明されているコマンドライン・オプションです。 .TP 3 classnames -1 つ以上のクラス名です。 +1つ以上のクラス名です。 .RE .LP .SH "説明" .LP .LP -\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。 +\f3serialver\fPは、1つ以上のクラスの\f2serialVersionUID\fPを、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 -\-classpath <: で区切られたディレクトリと zip や jar ファイル> +\-classpath<: で区切られたディレクトリとzipやjarファイル> アプリケーションのクラスおよびリソースの検索パスを設定します。 .RE @@ -65,23 +65,23 @@ .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 "注" +.SH "注意" .LP .LP -\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。 +\f3serialver\fPコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\f3serialver\fPを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 .LP .LP \f2\-J\-Djava.security.manager\fP .LP .LP -また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。 +また、必要であれば、次のオプションを使用してセキュリティ・ポリシーを指定できます。 .LP .LP \f2\-J\-Djava.security.policy=<policy file>\fP @@ -92,6 +92,6 @@ .na \f2java.io.ObjectStreamClass\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html +http://download.oracle.com/javase/7/docs/api/java/io/ObjectStreamClass.html .LP
--- a/src/linux/doc/man/ja/servertool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/servertool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH servertool 1 "07 May 2011" +.TH servertool 1 "21 Mar 2012" .LP .SH "名前" -servertool \- Java(TM) IDL サーバーツール +servertool \- Java(tm)IDLサーバー・ツール .LP -\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。 +\f3servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。 .SH "形式" .LP .nf @@ -38,28 +38,28 @@ .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 以上のポート番号を使用することをお勧めします。 +\f2\-ORBInitialPort\fP \f2nameserverport\fPオプションは\f3必須\fPです。\f2nameserverport\fPの値には、\f2orbd\fPが実行され、着信リクエストを待機しているポートを指定する必要があります。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、\f2nameserverport\fPとして1024以上のポート番号を使用することをお薦めします。 .LP .SH "説明" .LP .LP -\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。 +\f2servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。その他に、サーバーに関する様々な統計情報を取得するためのコマンドも提供します。 .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 @@ -68,43 +68,43 @@ .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 によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。 +ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。 .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
--- a/src/linux/doc/man/ja/tnameserv.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/tnameserv.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,18 +19,18 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH tnameserv 1 "07 May 2011" +.TH tnameserv 1 "21 Mar 2012" .LP .SH "名前" -Java IDL: 一時ネームサービス \- \f2tnameserv\fP +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 ツールの詳細については、orbd の 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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。 .LP .LP ここでは、以下の項目について説明します。 @@ -38,40 +38,40 @@ .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 のネーミングサービスプロセスが停止し、再起動されると失われます。 +オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・\f2バインディング\fPと呼ばれます。ネーム・バインディングは\f2ネーミング・コンテキスト\fPに組み込むことができます。ネーミング・コンテキストはそれ自体がネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは\f2初期ネーミング・コンテキスト\fPに格納されます。名前空間において、初期ネーミング・コンテキストは唯一の永続的バインディングです。それ以外のネーミング・コンテキストは、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以上のポート番号を使用することをお薦めします。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 -\f2「RMI\-IIOP を使った Hello World の例」に示されています。\fP @ +\f2RMI\-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://download.oracle.com/javase/7/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlに示されています。コマンドライン・オプション\f2\-ORBInitialPort\fP \f2nameserverport#\fPと\f2\-ORBInitialHost\fP \f2nameserverhostname\fPを使用して、クライアントとサーバーに対してネーム・サービスを探す場所を指定することもできます。 .na -\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @ +\f2Java IDL: 2台のマシン上で実行するHello Worldプログラム\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。 +http://download.oracle.com/javase/7/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,52 +166,51 @@ .LP .SS -\-J オプション +\-Jオプション .LP -このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。 +このコマンドライン・オプションは、\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 -.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の場合は、\f2[Ctrl]+[C]\fPキーを使用します。ネーム・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 .LP -.SH "サンプルクライアント: 名前空間へのオブジェクトの追加" +.SH "サンプル・クライアント: 名前空間へのオブジェクトの追加" .LP .LP -次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。 +次に示すサンプル・プログラムは、名前を名前空間に追加する方法を示すものです。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。 .LP -.nf -\f3 -.fl -\fP\f3 -.fl - \fP\f4初期\fP\f3 -.fl - \fP\f4ネーミングコンテキスト\fP\f3 -.fl - / \\ -.fl - / \\ -.fl - plans \fP\f4Personal\fP\f3 -.fl - / \\ -.fl - / \\ -.fl - calendar schedule\fP -.fl -.fi +.RS 3 +.TP 2 +o +\f4初期ネーミング・コンテキスト\fP +.RS 3 +.TP 2 +* +\f3plans\fP +.TP 2 +* +\f4Personal\fP +.RS 3 +.TP 2 +- +\f3calendar\fP +.TP 2 +- +\f3schedule\fP +.RE +.RE +.RE .LP .LP -この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。 +この例で、\f3plans\fPはオブジェクト参照、\f3Personal\fPは\f3calendar\fPと\f3schedule\fPの2つのオブジェクト参照を含むネーミング・コンテキストです。 .LP .nf \f3 @@ -238,7 +237,7 @@ .fi .LP -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。 +前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。 .nf \f3 .fl @@ -254,7 +253,7 @@ .fi .LP -次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この objref には、あとでさまざまな名前を割り当てて名前空間に追加します。 +次のコードでは、初期ネーミング・コンテキストを取得し、それを\f3ctx\fPに代入します。2行目では、\f3ctx\fPをダミーのオブジェクト参照\f3objref\fPにコピーします。このobjrefには、あとで様々な名前を割り当てて名前空間に追加します。 .nf \f3 .fl @@ -270,7 +269,7 @@ .fi .LP -次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、rebind を使用して初期ネーミングコンテキストの下に \f2plans を追加しています\fP。 \f2rebind\fP メソッドを使用すれば、bind を使用した場合に発生する例外を発生させずに、 \f2このプログラムを何度も繰り返し実行できます\fP。 +次のコードでは、textタイプの名前plansを作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fPを使用して初期ネーミング・コンテキストの下にplansを追加しています。\f2rebind\fPメソッドを使用すれば、\f2bind\fPを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 .nf \f3 .fl @@ -280,7 +279,7 @@ .fl ctx.rebind(name1, objref); .fl - System.out.println("plans rebind sucessful!"); + System.out.println("plans rebind successful!"); .fl .fl @@ -288,7 +287,7 @@ .fi .LP -次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。 +次のコードでは、directoryタイプのPersonalというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\f3ctx2\fPをこの名前にバインドし、初期ネーミング・コンテキストに追加します。 .nf \f3 .fl @@ -306,7 +305,7 @@ .fi .LP -残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。 +残りのコードでは、ダミーのオブジェクト参照をscheduleとcalendarという名前でネーミング・コンテキスト「Personal」(\f3ctx2\fP)にバインドします。 .nf \f3 .fl @@ -316,7 +315,7 @@ .fl ctx2.rebind(name3, objref); .fl - System.out.println("schedule rebind sucessful!"); + System.out.println("schedule rebind successful!"); .fl .fl @@ -326,7 +325,7 @@ .fl ctx2.rebind(name4, objref); .fl - System.out.println("calender rebind sucessful!"); + System.out.println("calender rebind successful!"); .fl .fl @@ -346,10 +345,10 @@ .fi .LP -.SH "サンプルクライアント: 名前空間のブラウズ" +.SH "サンプル・クライアント: 名前空間のブラウズ" .LP .LP -次のサンプルプログラムでは、名前空間をブラウズする方法を示します。 +次のサンプル・プログラムでは、名前空間をブラウズする方法を示します。 .LP .nf \f3 @@ -376,7 +375,7 @@ .fi .LP -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。 +前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。 .nf \f3 .fl @@ -396,7 +395,7 @@ .fi .LP -次のコードでは、初期ネーミングコンテキストを取得しています。 +次のコードでは、初期ネーミング・コンテキストを取得しています。 .nf \f3 .fl @@ -410,7 +409,7 @@ .fi .LP -\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。 +\f2list\fPメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストからBindingListHolderに返されます。残りのバインディングは、BindingIteratorHolderに返されます。 .nf \f3 .fl @@ -426,7 +425,7 @@ .fi .LP -次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。 +次のコードでは、返されたBindingListHolderからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 .nf \f3 .fl
--- a/src/linux/doc/man/ja/unpack200.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/unpack200.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH unpack200 1 "07 May 2011" +.TH unpack200 1 "21 Mar 2012" .LP .SH "名前" -unpack200 \- JAR アンパックツール +unpack200 \- JARアンパック・ツール .LP .RS 3 .TP 2 @@ -43,7 +43,7 @@ 関連項目 .TP 2 o -注意事項 +注意 .RE .LP @@ -53,28 +53,28 @@ \f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP .LP .LP -オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションの指定順序に決まりはありません。コマンドラインに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .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 -.SH " 説明" +.SH "説明" .LP .LP -\f2unpack200\fP は、pack200(1) で作成されたパックファイルを JAR ファイルに変換する \f2ネイティブ実装\fPです。一般的な使用方法: +\f2unpack200\fPは、\f2pack200\fP(1)で作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法: .LP .LP \f2% unpack200 myarchive.pack.gz myarchive.jar\fP .LP .LP -この例では、 \f2デフォルトの unpack200 設定で、myarchive.pack.gz\fP から \f2myarchive.jar\fP が \f2作成されます\fP 。 +この例では、デフォルトの\f2unpack200\fPの設定で、\f2myarchive.pack.gz\fPから\f2myarchive.jar\fPが作成されます。 .LP .SH "オプション" .LP @@ -82,13 +82,13 @@ \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP .LP .LP -JAR ファイル内のすべてのエントリに \f2true\fP 、 \f2false\fP、 \f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。 \f2true\fP または \f2false 場合、\fPデフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。 +JARファイル内のすべてのエントリに\f2true\fP、\f2false\fPまたは\f2keep\fPのデフレーションを設定します。デフォルト・モードは\f2keep\fPです。\f2true\fPまたは\f2false\fP場合、デフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 .LP .LP \f4\-r \-\-remove\-pack\-file\fP .LP .LP -入力パックファイルを削除します。 +入力パック・ファイルを削除します。 .LP .LP \f4\-v \-\-verbose\fP @@ -100,13 +100,13 @@ \f4\-q \-\-quiet\fP .LP .LP -メッセージを表示せずに動作します。 +メッセージを表示せずに動作するように指定します。 .LP .LP \f4\-lfilename \-\-log\-file=\fP\f2filename\fP .LP .LP -出力メッセージのログファイルを指定します。 +出力メッセージのログ・ファイルを指定します。 .LP .LP \f4\-? \-h \-\-help\fP @@ -124,7 +124,7 @@ \f4\-J\fP\f2option\fP .LP .LP -unpack200 によって呼び出される Java 起動ツールに \f2オプション\fP を \f2渡します\fP。 +\f2unpack200\fPによって呼び出されるJava起動ツールに\f2option\fPを渡します。 .LP .SH "終了ステータス" .LP @@ -132,10 +132,10 @@ 次の終了値が返されます。 .LP .LP -\f2\ 0\fP " 成功" +\f2\ 0\fP: 正常終了した場合 .LP .LP -\f2>0\fP " エラー" +\f2>0\fP: エラーが発生した場合 .LP .SH "関連項目" .LP @@ -146,33 +146,33 @@ .TP 2 o .na -\f2Java SE のドキュメント\fP @ +\f2Java SEのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/index.html +http://download.oracle.com/javase/7/docs/index.html .TP 2 o .na -\f2「Java 配備ガイド \- Pack200」\fP @ +\f2Javaデプロイメント・ガイド \- Pack200\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html +http://download.oracle.com/javase/7/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 "注意事項" +.SH "注意" .LP .LP -このコマンドと \f2unpack(1) を\fP混同しないでください。これらは別製品です。 +このコマンドと\f2unpack(1)\fPを混同しないでください。これらは別製品です。 .LP .LP -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 +JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .LP
--- a/src/linux/doc/man/ja/wsgen.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/wsgen.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,24 +19,24 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH wsgen 1 "07 May 2011" +.TH wsgen 1 "21 Mar 2012" .SH "名前" -wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API +wsgen \- XML Web Services(JAX\-WS)2.0のためのJava(tm)API .LP \f3仕様バージョン:\fP 2.1 .br \f3実装バージョン:\fP 2.1.1 .LP -\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。 +\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を参照してください。 .LP -.SH "wsgen の起動" +.SH "wsgenの起動" .RS 3 .TP 2 o @@ -74,7 +74,7 @@ \fP .fi .LP -次の表に、 \f2wsgen\fP のオプションを示します。 +次の表に、\f2wsgen\fPのオプションを示します。 .br .LP .TS @@ -105,7 +105,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -入力クラスファイルの検索場所を指定します +入力クラス・ファイルの検索場所を指定します .br .di .nr a| \n(dn @@ -121,7 +121,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -\-classpath <path> \f2と同じです\fP +\f2\-classpath<path>\fPと同じです .br .di .nr b| \n(dn @@ -153,7 +153,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります +ベンダー拡張(仕様で規定されていない機能)を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、他の実装との相互運用が行えなくなる可能性があります .br .di .nr d| \n(dn @@ -201,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 @@ -217,7 +217,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -生成されるソースファイルを格納する場所を指定する +生成されるソース・ファイルを格納する場所を指定します .br .di .nr h| \n(dn @@ -249,7 +249,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。 +バージョン情報を出力します。このオプションを使用すると、バージョン情報のみが出力されます。通常の処理は実行されません。 .br .di .nr j| \n(dn @@ -265,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 は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\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は省略可能であり、\f2wsdl:binding\fPで使用するプロトコルを指定するために使用されます。有効なプロトコルは\f2soap1.1\fPおよび\f2Xsoap1.2\fPなどです。デフォルトは\f2soap1.1\fPです。\f2Xsoap1.2\fPは標準ではないため、\f2\-extension\fPオプションと組み合せないと使用できません。 .br .di .nr k| \n(dn @@ -281,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 @@ -297,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 @@ -635,7 +635,7 @@ .fl .fi .LP -\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。 +\f3stock\fPディレクトリ内に@WebService注釈が付けられた、StockServiceに必要なラッパー・クラスが生成されます。 .nf \f3 .fl @@ -643,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 @@ -651,6 +651,6 @@ .fl .fi .LP -SOAP 1.2 WSDL が生成されます。 +SOAP 1.2 WSDLが生成されます。 .LP -サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。 +サービスをデプロイするときにJAXWSランタイムによって自動的にWSDLが生成されるため、開発時にWSDLを生成する必要はありません。
--- a/src/linux/doc/man/ja/wsimport.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/wsimport.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,9 +19,9 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH wsimport 1 "07 May 2011" +.TH wsimport 1 "21 Mar 2012" .SH "名前" -wsimport \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API +wsimport \- XML Web Services(JAX\-WS)2.0のためのJava(tm)API .LP \f3仕様バージョン:\fP 2.1 .br @@ -29,34 +29,34 @@ .br .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 クラス) +JAXBが生成する値タイプ(スキーマのタイプからマップされた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を参照してください。 .br .LP -.SH "wsimport の起動" +.SH "wsimportの起動" .RS 3 .TP 2 o @@ -86,7 +86,7 @@ \fP .fi .LP -次の表に、 \f2wsimport\fP のオプションを示します。 +次の表に、\f2wsimport\fPのオプションを示します。 .LP .TS .if \n+(b.=1 .nr d. \n(.c-\n(c.-1 @@ -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 -外部エンティティー参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。 +外部エンティティ参照を解決するためのカタログ・ファイルを指定します。TR9401、XCatalog、OASIS XML Catalogの各形式がサポートされています。 .na \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 @@ -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 @@ -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 @@ -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 @@ -766,13 +766,13 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-72 .LP -\-b オプションを使って、複数の JAX\-WS および JAXB バインディングファイル \f2を指定できます。\fP これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。JAX\-WS および JAXB バインディングファイルの詳細は、 +\f2\-b\fPオプションを使用して、複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 .na -\f2カスタマイズマニュアル\fP @ +\f2カスタマイズ・マニュアル\fP @ .fi https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlを参照してください。 .LP -次の表に、 \f2wsimport\fP の非標準オプションを示します。 +次の表に、\f2wsimport\fPの非標準オプションを示します。 .LP .TS .if \n+(b.=1 .nr d. \n(.c-\n(c.-1 @@ -802,7 +802,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -要求または応答メッセージにバインドされないヘッダーを Java メソッドのパラメータにマップします +リクエストまたはレスポンス・メッセージにバインドされないヘッダーをJavaメソッドのパラメータにマップします .br .di .nr a| \n(dn @@ -818,7 +818,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://\f2<ユーザー名>\fP:\f2<パスワード>\fP@\f2<ホスト名>\fP/\f2<Web サービス名>\fP?wsdl +認証情報を含むファイルを指定するWSDL URIです。このURIの形式は次のとおりです http://\f2<user name>\fP:\f2<password>\fP@\f2<host name>\fP/\f2<Web service name>\fP?wsdl .br .di .nr b| \n(dn @@ -866,7 +866,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -W3C \f2EndpointReferenceType\fP と Java のバインディングを有効にします +W3C \f2EndpointReferenceType\fPとJavaのバインディングを有効にします .br .di .nr e| \n(dn @@ -882,7 +882,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -生成された Java ファイルをコンパイルしません +生成されたJavaファイルをコンパイルしません .br .di .nr f| \n(dn @@ -1061,6 +1061,6 @@ .fl .fi .LP -Java アーティファクトを生成し、 \f2http://stockquote.example.com/quote?wsdl\fP をインポートしてその Java アーティファクトをコンパイルします +Javaアーティファクトを生成し、\f2http://stockquote.example.com/quote?wsdl\fPをインポートしてそのJavaアーティファクトをコンパイルします .br
--- a/src/linux/doc/man/ja/xjc.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/linux/doc/man/ja/xjc.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,28 +19,27 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH xjc 1 "07 May 2011" +.TH xjc 1 "21 Mar 2012" .LP -.ad c .SH "名前" -xjc \- XML バインドのための Java(TM) アーキテクチャー +xjc \- XMLバインドのためのJava(tm)アーキテクチャ .br -バインディングコンパイラ +バインディング・コンパイラ +.LP .LP \f3仕様バージョン:\fP 2.1 .br -\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l - +\f3リファレンス実装(RI)バージョン:\fP 2.1.3 .LP -.SH "xjc の起動" +.SH "xjcの起動" .LP .LP -バインディングコンパイラを起動するには、使用するプラットフォームに応じた bin ディレクトリ内の \f2xjc\fP シェルスクリプト \f2を\fP 使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。 +バインディング・コンパイラを起動するには、使用するプラットフォームに応じた\f2bin\fPディレクトリ内の\f2xjc\fPシェル・スクリプトを使用します。また、バインディング・コンパイラを実行するためのAntタスクも用意されています。 .na -\f2xjc を Ant とともに使用する\fP @ +\f2XJC Antタスクの使用\fP @ .fi -https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlの手順を参照してください。 .LP .LP \f2% xjc \-help\fP @@ -126,110 +125,110 @@ .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 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。 \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 また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。 +\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は、下位互換性のためにリファレンス実装(RI)ではサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fPコマンドを使用するユーザーなど、他のユーザーが表示できる引数であることに注意してください。セキュリティを高めるには、次の\f2\-httpproxyfile\fPを使用してください。 .TP 3 \-httpproxyfile <file> -HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。 +HTTP/HTTPSプロキシをファイル経由で指定します。形式は前述のものと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 .TP 3 \-classpath <arg> -<jxb:javaType> および <xjc:superClass> \f2カスタマイズが使用する\fP クライアントアプリケーションの \f2クラスファイルの検索場所を\fP 指定します。 +\f2<jxb:javaType>\fPおよび\f2<xjc:superClass>\fPカスタマイズが使用するクライアント・アプリケーションのクラス・ファイルの検索場所を指定します。 .TP 3 \-catalog <file> -外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、 \f2カタログリゾルバの\fP サンプルアプリケーションを調べてください。 +外部エンティティ参照を解決するカタログ・ファイルを指定します。TR9401、XCatalogおよびOASIS XML Catalog形式がサポートされます。詳細は、XML Entity and URI Resolversのドキュメントを参照するか、\f2catalog\-resolver\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 -多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。 +多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードでdiffを使用しやすくなります。 .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 情報が公開されます。 +生成されたコードでは、非整列化の後にJava Beanインスタンスに含まれるソースXMLに関するSAX Locator情報が公開されます。 .TP 3 \-Xsync\-methods -生成されたすべてのメソッドシグニチャーに \f2同期された\fP キーワードが含められます。 +生成されたすべてのメソッド・シグニチャに\f2synchronized\fPキーワードが含められます。 .TP 3 \-mark\-generated -生成されたコードに注釈 \f2@javax.annotation.Generated\fP を付けます。 +生成されたコードに注釈\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 コードベースのインストールを使用してください。 +\-source互換性スイッチは、JAXB 2.0の最初のEarly Access版で導入されました。このスイッチは、JAXB 2.0の今後のリリースから削除されることになりました。1.0.xコードを生成する必要がある場合は、1.0.xコードベースのインストールを使用してください。 .RE .LP @@ -237,38 +236,38 @@ コンパイラの制限 .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 が宣言されている場合は、 \f2仕様に定義されている targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。 +\f2targetNamespace\fPが宣言されている場合は、仕様に定義されている\f2targetNamespace\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 @@ -277,21 +276,21 @@ .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、 .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 バインドのための Java アーキテクチャー (JAXB)\fP @ +\f2XMLバインドのためのJavaアーキテクチャ(JAXB)\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html .RE .LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/macosx/bin/x86_64/jvm.cfg Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,39 @@ +# +# Copyright (c) 2012, 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. +# +# List of JVMs that can be used as an option to java, javac, etc. +# Order is important -- first in this list is the default JVM. +# NOTE that this both this file and its format are UNSUPPORTED and +# WILL GO AWAY in a future release. +# +# You may also select a JVM in an arbitrary location with the +# "-XXaltjvm=<jvm_dir>" option, but that too is unsupported +# and may not be available in a future release. +# +-server KNOWN +-client IGNORE +-hotspot ERROR +-classic WARN +-native ERROR +-green ERROR
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/macosx/classes/java/lang/ClassLoaderHelper.java Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,47 @@ +/* + * Copyright (c) 2012, 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 java.lang; + +import java.io.File; + +class ClassLoaderHelper { + + private ClassLoaderHelper() {} + + /** + * Returns an alternate path name for the given file + * such that if the original pathname did not exist, then the + * file may be located at the alternate location. + * For mac, this replaces the final .dylib suffix with .jnilib + */ + static File mapAlternativeName(File lib) { + String name = lib.toString(); + int index = name.toLowerCase().lastIndexOf(".dylib"); + if (index < 0) { + return null; + } + return new File(name.substring(0, index) + ".jnilib"); + } +}
--- a/src/macosx/classes/sun/lwawt/macosx/CCustomCursor.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/macosx/classes/sun/lwawt/macosx/CCustomCursor.java Mon Apr 16 11:16:28 2012 -0700 @@ -26,6 +26,7 @@ package sun.lwawt.macosx; import java.awt.*; +import java.awt.image.BufferedImage; public class CCustomCursor extends Cursor { static Dimension sMaxCursorSize; @@ -36,7 +37,6 @@ } Image fImage; - private boolean isImageOk = false; Point fHotspot; public CCustomCursor(final Image cursor, final Point hotSpot, final String name) throws IndexOutOfBoundsException, HeadlessException { @@ -61,21 +61,19 @@ // Fix for bug 4212593 The Toolkit.createCustomCursor does not // check absence of the image of cursor // If the image is invalid, the cursor will be hidden (made completely - // transparent). In this case, getBestCursorSize() will adjust negative w and h, - // but we need to set the hotspot inside the image here. + // transparent). if (tracker.isErrorAny() || width < 0 || height < 0) { fHotspot.x = fHotspot.y = 0; - isImageOk = false; + width = height = 1; + fImage = createTransparentImage(width, height); } else { - isImageOk = true; - } - - // Scale image to nearest supported size - final Dimension nativeSize = toolkit.getBestCursorSize(width, height); - if (nativeSize.width != width || nativeSize.height != height) { - fImage = fImage.getScaledInstance(nativeSize.width, nativeSize.height, Image.SCALE_DEFAULT); - width = nativeSize.width; - height = nativeSize.height; + // Scale image to nearest supported size + final Dimension nativeSize = toolkit.getBestCursorSize(width, height); + if (nativeSize.width != width || nativeSize.height != height) { + fImage = fImage.getScaledInstance(nativeSize.width, nativeSize.height, Image.SCALE_DEFAULT); + width = nativeSize.width; + height = nativeSize.height; + } } // NOTE: this was removed for 3169146, but in 1.5 the JCK tests for an exception and fails if one isn't thrown. @@ -98,6 +96,21 @@ } } + private static BufferedImage createTransparentImage(int w, int h) { + GraphicsEnvironment ge = + GraphicsEnvironment.getLocalGraphicsEnvironment(); + GraphicsDevice gs = ge.getDefaultScreenDevice(); + GraphicsConfiguration gc = gs.getDefaultConfiguration(); + + BufferedImage img = gc.createCompatibleImage(w, h, Transparency.BITMASK); + Graphics2D g = (Graphics2D)img.getGraphics(); + g.setBackground(new Color(0, 0, 0, 0)); + g.clearRect(0, 0, w, h); + g.dispose(); + + return img; + } + public static Dimension getBestCursorSize(final int preferredWidth, final int preferredHeight) { // With Panther, cursors have no limit on their size. So give the client their // preferred size, but no larger than half the dimensions of the main screen @@ -111,31 +124,26 @@ } // Called from native when the cursor is set - // Returns long array of [NSImage ptr, x hotspot, y hotspot] CImage fCImage; long getImageData() { if (fCImage != null) { return fCImage.ptr; } - if (isImageOk) { - try { - fCImage = CImage.getCreator().createFromImage(fImage); - - if (fCImage == null) { - isImageOk = false; - return 0L; - } else { - return fCImage.ptr; - } - } catch (IllegalArgumentException iae) { - // Silently return null - we want to hide cursor by providing an empty - // ByteArray or just null + try { + fCImage = CImage.getCreator().createFromImage(fImage); + if (fCImage == null) { + // Something unexpected happened: CCustomCursor constructor + // takes care of invalid cursor images, yet createFromImage() + // failed to do its job. Return null to keep the cursor unchanged. return 0L; + } else { + return fCImage.ptr; } + } catch (IllegalArgumentException iae) { + // see comment above + return 0L; } - - return 0L; } Point getHotSpot() {
--- a/src/macosx/classes/sun/lwawt/macosx/CPrinterJob.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/macosx/classes/sun/lwawt/macosx/CPrinterJob.java Mon Apr 16 11:16:28 2012 -0700 @@ -33,6 +33,7 @@ import javax.print.*; import javax.print.attribute.PrintRequestAttributeSet; +import javax.print.attribute.standard.PageRanges; import sun.java2d.*; import sun.print.*; @@ -145,6 +146,17 @@ } protected void setAttributes(PrintRequestAttributeSet attributes) throws PrinterException { + if (attributes != null) { + PageRanges pageRangesAttr = + (PageRanges)attributes.get(PageRanges.class); + if (pageRangesAttr != null) { + SunPageSelection psel = (SunPageSelection)attributes.get(SunPageSelection.class); + if (psel == null) { + attributes.add(SunPageSelection.RANGE); + } + } + } + super.setAttributes(attributes); if (attributes == null) {
--- a/src/macosx/classes/sun/lwawt/macosx/LWCToolkit.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/macosx/classes/sun/lwawt/macosx/LWCToolkit.java Mon Apr 16 11:16:28 2012 -0700 @@ -656,6 +656,14 @@ return ((mods & (InputEvent.META_MASK | InputEvent.CTRL_MASK)) == 0); } + /** + * Returns whether popup is allowed to be shown above the task bar. + */ + @Override + public boolean canPopupOverlapTaskBar() { + return false; + } + // Extends PeerEvent because we want to pass long an ObjC mediator object and because we want these events to be posted early // Typically, rather than relying on the notifier to call notifyAll(), we use the mediator to stop the runloop public static class CPeerEvent extends PeerEvent {
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/macosx/lib/content-types.properties Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,276 @@ +#sun.net.www MIME content-types table +# +# Property fields: +# +# <description> ::= 'description' '=' <descriptive string> +# <extensions> ::= 'file_extensions' '=' <comma-delimited list, include '.'> +# <image> ::= 'icon' '=' <filename of icon image> +# <action> ::= 'browser' | 'application' | 'save' | 'unknown' +# <application> ::= 'application' '=' <command line template> +# + +# +# The "we don't know anything about this data" type(s). +# Used internally to mark unrecognized types. +# +content/unknown: description=Unknown Content +unknown/unknown: description=Unknown Data Type + +# +# The template we should use for temporary files when launching an application +# to view a document of given type. +# +temp.file.template: /tmp/%s + +# +# The "real" types. +# +application/octet-stream: \ + description=Generic Binary Stream;\ + file_extensions=.saveme,.dump,.hqx,.arc,.o,.a,.bin,.exe,.z,.gz + +application/oda: \ + description=ODA Document;\ + file_extensions=.oda + +application/pdf: \ + description=Adobe PDF Format;\ + file_extensions=.pdf + +application/postscript: \ + description=Postscript File;\ + file_extensions=.eps,.ai,.ps;\ + icon=ps;\ + action=application;\ + application=imagetool %s + +application/x-dvi: \ + description=TeX DVI File;\ + file_extensions=.dvi;\ + action=application;\ + application=xdvi %s + +application/x-hdf: \ + description=Hierarchical Data Format;\ + file_extensions=.hdf;\ + action=save + +application/x-latex: \ + description=LaTeX Source;\ + file_extensions=.latex + +application/x-netcdf: \ + description=Unidata netCDF Data Format;\ + file_extensions=.nc,.cdf;\ + action=save + +application/x-tex: \ + description=TeX Source;\ + file_extensions=.tex + +application/x-texinfo: \ + description=Gnu Texinfo;\ + file_extensions=.texinfo,.texi + +application/x-troff: \ + description=Troff Source;\ + file_extensions=.t,.tr,.roff;\ + action=application;\ + application=xterm -title troff -e sh -c \"nroff %s | col | more -w\" + +application/x-troff-man: \ + description=Troff Manpage Source;\ + file_extensions=.man;\ + action=application;\ + application=xterm -title troff -e sh -c \"nroff -man %s | col | more -w\" + +application/x-troff-me: \ + description=Troff ME Macros;\ + file_extensions=.me;\ + action=application;\ + application=xterm -title troff -e sh -c \"nroff -me %s | col | more -w\" + +application/x-troff-ms: \ + description=Troff MS Macros;\ + file_extensions=.ms;\ + action=application;\ + application=xterm -title troff -e sh -c \"nroff -ms %s | col | more -w\" + +application/x-wais-source: \ + description=Wais Source;\ + file_extensions=.src,.wsrc + +application/zip: \ + description=Zip File;\ + file_extensions=.zip;\ + icon=zip;\ + action=save + +application/x-bcpio: \ + description=Old Binary CPIO Archive;\ + file_extensions=.bcpio; action=save + +application/x-cpio: \ + description=Unix CPIO Archive;\ + file_extensions=.cpio; action=save + +application/x-gtar: \ + description=Gnu Tar Archive;\ + file_extensions=.gtar;\ + icon=tar;\ + action=save + +application/x-shar: \ + description=Shell Archive;\ + file_extensions=.sh,.shar;\ + action=save + +application/x-sv4cpio: \ + description=SVR4 CPIO Archive;\ + file_extensions=.sv4cpio; action=save + +application/x-sv4crc: \ + description=SVR4 CPIO with CRC;\ + file_extensions=.sv4crc; action=save + +application/x-tar: \ + description=Tar Archive;\ + file_extensions=.tar;\ + icon=tar;\ + action=save + +application/x-ustar: \ + description=US Tar Archive;\ + file_extensions=.ustar;\ + action=save + +audio/basic: \ + description=Basic Audio;\ + file_extensions=.snd,.au;\ + icon=audio;\ + action=application;\ + application=audiotool %s + +audio/x-aiff: \ + description=Audio Interchange Format File;\ + file_extensions=.aifc,.aif,.aiff;\ + icon=aiff + +audio/x-wav: \ + description=Wav Audio;\ + file_extensions=.wav;\ + icon=wav + +image/gif: \ + description=GIF Image;\ + file_extensions=.gif;\ + icon=gif;\ + action=browser + +image/ief: \ + description=Image Exchange Format;\ + file_extensions=.ief + +image/jpeg: \ + description=JPEG Image;\ + file_extensions=.jfif,.jfif-tbnl,.jpe,.jpg,.jpeg;\ + icon=jpeg;\ + action=browser;\ + application=imagetool %s + +image/tiff: \ + description=TIFF Image;\ + file_extensions=.tif,.tiff;\ + icon=tiff + +image/vnd.fpx: \ + description=FlashPix Image;\ + file_extensions=.fpx,.fpix + +image/x-cmu-rast: \ + description=CMU Raster Image;\ + file_extensions=.ras + +image/x-portable-anymap: \ + description=PBM Anymap Format;\ + file_extensions=.pnm + +image/x-portable-bitmap: \ + description=PBM Bitmap Format;\ + file_extensions=.pbm + +image/x-portable-graymap: \ + description=PBM Graymap Format;\ + file_extensions=.pgm + +image/x-portable-pixmap: \ + description=PBM Pixmap Format;\ + file_extensions=.ppm + +image/x-rgb: \ + description=RGB Image;\ + file_extensions=.rgb + +image/x-xbitmap: \ + description=X Bitmap Image;\ + file_extensions=.xbm,.xpm + +image/x-xwindowdump: \ + description=X Window Dump Image;\ + file_extensions=.xwd + +image/png: \ + description=PNG Image;\ + file_extensions=.png;\ + icon=png;\ + action=browser + +text/html: \ + description=HTML Document;\ + file_extensions=.htm,.html;\ + icon=html + +text/plain: \ + description=Plain Text;\ + file_extensions=.text,.c,.cc,.c++,.h,.pl,.txt,.java,.el;\ + icon=text;\ + action=browser + +text/tab-separated-values: \ + description=Tab Separated Values Text;\ + file_extensions=.tsv + +text/x-setext: \ + description=Structure Enhanced Text;\ + file_extensions=.etx + +video/mpeg: \ + description=MPEG Video Clip;\ + file_extensions=.mpg,.mpe,.mpeg;\ + icon=mpeg;\ + action=application;\ + application=mpeg_play %s + +video/quicktime: \ + description=QuickTime Video Clip;\ + file_extensions=.mov,.qt + +application/x-troff-msvideo: \ + description=AVI Video;\ + file_extensions=.avi;\ + icon=avi + +video/x-sgi-movie: \ + description=SGI Movie;\ + file_extensions=.movie,.mv + +message/rfc822: \ + description=Internet Email Message;\ + file_extensions=.mime + +application/xml: \ + description=XML document;\ + file_extensions=.xml + + +
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/macosx/lib/flavormap.properties Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,78 @@ +# +# This properties file is used to initialize the default +# java.awt.datatransfer.SystemFlavorMap. It contains the X11 platform-specific, +# default mappings between common X11 selection atoms and platform-independent +# MIME type strings, which will be converted into +# java.awt.datatransfer.DataFlavors. +# +# These default mappings may be augmented by specifying the +# +# AWT.DnD.flavorMapFileURL +# +# property in the appropriate awt.properties file. The specified properties URL +# will be loaded into the SystemFlavorMap. +# +# The standard format is: +# +# <native>=<MIME type> +# +# <native> should be a string identifier that the native platform will +# recognize as a valid data format. <MIME type> should specify both a MIME +# primary type and a MIME subtype separated by a '/'. The MIME type may include +# parameters, where each parameter is a key/value pair separated by '=', and +# where each parameter to the MIME type is separated by a ';'. +# +# Because SystemFlavorMap implements FlavorTable, developers are free to +# duplicate both native keys and DataFlavor values. If a mapping contains a +# duplicate key or value, earlier mappings which included this key or value +# will be preferred. +# +# Mappings whose values specify DataFlavors with primary MIME types of +# "text", and which support the charset parameter, should specify the exact +# format in which the native platform expects the data. The "charset" +# parameter specifies the char to byte encoding, the "eoln" parameter +# specifies the end-of-line marker, and the "terminators" parameter specifies +# the number of terminating NUL bytes. Note that "eoln" and "terminators" +# are not standardized MIME type parameters. They are specific to this file +# format ONLY. They will not appear in any of the DataFlavors returned by the +# SystemFlavorMap at the Java level. +# +# If the "charset" parameter is omitted, or has zero length, the platform +# default encoding is assumed. If the "eoln" parameter is omitted, or has +# zero length, "\n" is assumed. If the "terminators" parameter is omitted, +# or has a value less than zero, zero is assumed. +# +# Upon initialization, the data transfer subsystem will record the specified +# details of the native text format, but the default SystemFlavorMap will +# present a large set of synthesized DataFlavors which map, in both +# directions, to the native. After receiving data from the application in one +# of the synthetic DataFlavors, the data transfer subsystem will transform +# the data stream into the format specified in this file before passing the +# transformed stream to the native system. +# +# Mappings whose values specify DataFlavors with primary MIME types of +# "text", but which do not support the charset parameter, will be treated as +# opaque, 8-bit data. They will not undergo any transformation process, and +# any "charset", "eoln", or "terminators" parameters specified in this file +# will be ignored. +# +# See java.awt.datatransfer.DataFlavor.selectBestTextFlavor for a list of +# text flavors which support the charset parameter. + +UTF8_STRING=text/plain;charset=UTF-8;eoln="\n";terminators=0 + +# The COMPOUND_TEXT support for inter-client text transfer is disabled by +# default. The reason is that many native applications prefer this format over +# other native text formats, but are unable to decode the textual data in this +# format properly. This results in java-to-native text transfer failures. +# To enable the COMPOUND_TEXT support for this JRE installation uncomment +# the line below. + +# COMPOUND_TEXT=text/plain;charset=x-compound-text;eoln="\n";terminators=0 + +TEXT=text/plain;eoln="\n";terminators=0 +STRING=text/plain;charset=UTF-8;eoln="\n";terminators=0 +FILE_NAME=application/x-java-file-list;class=java.util.List +text/uri-list=application/x-java-file-list;class=java.util.List +PNG=image/x-java-image;class=java.awt.Image +JFIF=image/x-java-image;class=java.awt.Image
--- a/src/macosx/native/sun/awt/awt.m Mon Apr 02 15:01:04 2012 -0700 +++ b/src/macosx/native/sun/awt/awt.m Mon Apr 16 11:16:28 2012 -0700 @@ -307,16 +307,18 @@ if (verbose) AWT_DEBUG_LOG(@"got out of the AppKit startup mutex"); } - // Don't set the delegate until the NSApplication has been created and - // its finishLaunching has initialized it. - // ApplicationDelegate is the support code for com.apple.eawt. - void (^setDelegateBlock)() = ^(){ - OSXAPP_SetApplicationDelegate([ApplicationDelegate sharedDelegate]); - }; - if (onMainThread) { - setDelegateBlock(); - } else { - [JNFRunLoop performOnMainThreadWaiting:YES withBlock:setDelegateBlock]; + if (!headless) { + // Don't set the delegate until the NSApplication has been created and + // its finishLaunching has initialized it. + // ApplicationDelegate is the support code for com.apple.eawt. + void (^setDelegateBlock)() = ^(){ + OSXAPP_SetApplicationDelegate([ApplicationDelegate sharedDelegate]); + }; + if (onMainThread) { + setDelegateBlock(); + } else { + [JNFRunLoop performOnMainThreadWaiting:YES withBlock:setDelegateBlock]; + } } }
--- a/src/macosx/native/sun/java2d/opengl/CGLGraphicsConfig.m Mon Apr 02 15:01:04 2012 -0700 +++ b/src/macosx/native/sun/java2d/opengl/CGLGraphicsConfig.m Mon Apr 16 11:16:28 2012 -0700 @@ -312,7 +312,10 @@ GLint contextVirtualScreen = [context currentVirtualScreen]; #if USE_NSVIEW_FOR_SCRATCH - [context setView: scratchSurface]; + /* the scratch surface will be set to the view + * later on the flusher thread by OGLSD_SetScratchSurface. + */ + //[context setView: scratchSurface]; #else [context setPixelBuffer: scratchSurface
--- a/src/share/classes/java/lang/ClassLoader.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/java/lang/ClassLoader.java Mon Apr 16 11:16:28 2012 -0700 @@ -1861,6 +1861,17 @@ } private static boolean loadLibrary0(Class fromClass, final File file) { + if (loadLibrary1(fromClass, file)) { + return true; + } + final File libfile = ClassLoaderHelper.mapAlternativeName(file); + if (libfile != null && loadLibrary1(fromClass, libfile)) { + return true; + } + return false; + } + + private static boolean loadLibrary1(Class fromClass, final File file) { boolean exists = AccessController.doPrivileged( new PrivilegedAction<Object>() { public Object run() {
--- a/src/share/classes/java/net/AbstractPlainDatagramSocketImpl.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/java/net/AbstractPlainDatagramSocketImpl.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2012, 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 @@ -62,7 +62,7 @@ /** * flag set if the native connect() call not to be used */ - private final static boolean connectDisabled = os.startsWith("Mac OS"); + private final static boolean connectDisabled = os.contains("OS X"); /** * Load net library into runtime.
--- a/src/share/classes/java/nio/Bits.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/java/nio/Bits.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -609,7 +609,7 @@ String arch = AccessController.doPrivileged( new sun.security.action.GetPropertyAction("os.arch")); unaligned = arch.equals("i386") || arch.equals("x86") - || arch.equals("amd64"); + || arch.equals("amd64") || arch.equals("x86_64"); unalignedKnown = true; return unaligned; }
--- a/src/share/classes/java/util/prefs/Preferences.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/java/util/prefs/Preferences.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -295,7 +295,7 @@ String platformFactory; if (osName.startsWith("Windows")) { platformFactory = "java.util.prefs.WindowsPreferencesFactory"; - } else if (osName.startsWith("Mac OS X")) { + } else if (osName.contains("OS X")) { platformFactory = "java.util.prefs.MacOSXPreferencesFactory"; } else { platformFactory = "java.util.prefs.FileSystemPreferencesFactory";
--- a/src/share/classes/javax/swing/JPopupMenu.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/javax/swing/JPopupMenu.java Mon Apr 16 11:16:28 2012 -0700 @@ -41,6 +41,8 @@ import javax.swing.plaf.ComponentUI; import javax.swing.plaf.basic.BasicComboPopup; import javax.swing.event.*; + +import sun.awt.SunToolkit; import sun.security.util.SecurityConstants; import java.applet.Applet; @@ -346,6 +348,7 @@ long popupBottomY = (long)popupLocation.y + (long)popupSize.height; int scrWidth = scrBounds.width; int scrHeight = scrBounds.height; + if (!canPopupOverlapTaskBar()) { // Insets include the task bar. Take them into account. Insets scrInsets = toolkit.getScreenInsets(gc); @@ -403,25 +406,19 @@ } /** - * Checks that there are enough security permissions - * to make popup "always on top", which allows to show it above the task bar. + * Returns whether popup is allowed to be shown above the task bar. */ static boolean canPopupOverlapTaskBar() { boolean result = true; - try { - SecurityManager sm = System.getSecurityManager(); - if (sm != null) { - sm.checkPermission( - SecurityConstants.AWT.SET_WINDOW_ALWAYS_ON_TOP_PERMISSION); - } - } catch (SecurityException se) { - // There is no permission to show popups over the task bar - result = false; + + Toolkit tk = Toolkit.getDefaultToolkit(); + if (tk instanceof SunToolkit) { + result = ((SunToolkit)tk).canPopupOverlapTaskBar(); } + return result; } - /** * Factory method which creates the <code>JMenuItem</code> for * <code>Actions</code> added to the <code>JPopupMenu</code>.
--- a/src/share/classes/sun/awt/OSInfo.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/awt/OSInfo.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2012, 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 @@ -101,7 +101,7 @@ return SOLARIS; } - if (osName.startsWith("Mac OS X")) { + if (osName.contains("OS X")) { return MACOSX; }
--- a/src/share/classes/sun/awt/SunToolkit.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/awt/SunToolkit.java Mon Apr 16 11:16:28 2012 -0700 @@ -42,6 +42,8 @@ import java.util.concurrent.locks.Condition; import java.util.concurrent.locks.Lock; import java.util.concurrent.locks.ReentrantLock; + +import sun.security.util.SecurityConstants; import sun.util.logging.PlatformLogger; import sun.misc.SoftCache; import sun.font.FontDesignMetrics; @@ -1094,6 +1096,26 @@ } /** + * Returns whether popup is allowed to be shown above the task bar. + * This is a default implementation of this method, which checks + * corresponding security permission. + */ + public boolean canPopupOverlapTaskBar() { + boolean result = true; + try { + SecurityManager sm = System.getSecurityManager(); + if (sm != null) { + sm.checkPermission( + SecurityConstants.AWT.SET_WINDOW_ALWAYS_ON_TOP_PERMISSION); + } + } catch (SecurityException se) { + // There is no permission to show popups over the task bar + result = false; + } + return result; + } + + /** * Returns a new input method window, with behavior as specified in * {@link java.awt.im.spi.InputMethodContext#createInputMethodWindow}. * If the inputContext is not null, the window should return it from its
--- a/src/share/classes/sun/font/FontUtilities.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/font/FontUtilities.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2008, 2012, 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 @@ -78,7 +78,7 @@ isLinux = osName.startsWith("Linux"); - isMacOSX = osName.startsWith("Mac OS X"); // TODO: MacOSX + isMacOSX = osName.contains("OS X"); // TODO: MacOSX String t2kStr = System.getProperty("sun.java2d.font.scaler"); if (t2kStr != null) {
--- a/src/share/classes/sun/launcher/LauncherHelper.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/launcher/LauncherHelper.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2007, 2012, 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 @@ -381,7 +381,7 @@ PrintStream ostream = (printToStderr) ? System.err : System.out; ostream.println(getLocalizedMessage("java.launcher.X.usage", File.pathSeparator)); - if (System.getProperty("os.name").startsWith("Mac OS")) { + if (System.getProperty("os.name").contains("OS X")) { ostream.println(getLocalizedMessage("java.launcher.X.macosx.usage", File.pathSeparator)); }
--- a/src/share/classes/sun/nio/cs/ext/ExtendedCharsets.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/nio/cs/ext/ExtendedCharsets.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2002, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2002, 2012, 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 @@ -1280,7 +1280,7 @@ String osName = AccessController.doPrivileged( new GetPropertyAction("os.name")); if ("SunOS".equals(osName) || "Linux".equals(osName) - || osName.startsWith("Mac OS")) { + || osName.contains("OS X")) { charset("x-COMPOUND_TEXT", "COMPOUND_TEXT", new String[] { "COMPOUND_TEXT", // JDK historical
--- a/src/share/classes/sun/print/PSPrinterJob.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/print/PSPrinterJob.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2012, 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 @@ -1536,7 +1536,7 @@ } String osname = System.getProperty("os.name"); - if (osname.equals("Linux") || osname.startsWith("Mac OS X")) { + if (osname.equals("Linux") || osname.contains("OS X")) { execCmd = new String[ncomps]; execCmd[n++] = "/usr/bin/lpr"; if ((pFlags & PRINTER) != 0) {
--- a/src/share/classes/sun/security/jgss/wrapper/SunNativeProvider.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/security/jgss/wrapper/SunNativeProvider.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2012, 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 @@ -89,7 +89,7 @@ "libgssapi_krb5.so", "libgssapi_krb5.so.2", }; - } else if (osname.startsWith("Mac OS X")) { + } else if (osname.contains("OS X")) { gssLibs = new String[]{ "/usr/lib/sasl2/libgssapiv2.2.so", };
--- a/src/share/classes/sun/security/krb5/Config.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/security/krb5/Config.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -729,7 +729,7 @@ } } else if (osname.startsWith("SunOS")) { name = "/etc/krb5/krb5.conf"; - } else if (osname.startsWith("Mac")) { + } else if (osname.contains("OS X")) { if (isMacosLionOrBetter()) return ""; name = findMacosConfigFile(); } else {
--- a/src/share/classes/sun/security/krb5/Credentials.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/security/krb5/Credentials.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -289,7 +289,7 @@ String os = java.security.AccessController.doPrivileged( new sun.security.action.GetPropertyAction("os.name")); if (os.toUpperCase(Locale.ENGLISH).startsWith("WINDOWS") || - os.toUpperCase(Locale.ENGLISH).startsWith("MAC")) { + os.toUpperCase(Locale.ENGLISH).contains("OS X")) { Credentials creds = acquireDefaultCreds(); if (creds == null) { if (DEBUG) { @@ -471,7 +471,7 @@ java.security.AccessController.doPrivileged( new java.security.PrivilegedAction<Void> () { public Void run() { - if (System.getProperty("os.name").startsWith("Mac")) { + if (System.getProperty("os.name").contains("OS X")) { System.loadLibrary("osxkrb5"); } else { System.loadLibrary("w2k_lsa_auth");
--- a/src/share/classes/sun/security/provider/ByteArrayAccess.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/security/provider/ByteArrayAccess.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2006, 2012, 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 @@ -95,7 +95,8 @@ private static boolean unaligned() { String arch = java.security.AccessController.doPrivileged (new sun.security.action.GetPropertyAction("os.arch", "")); - return arch.equals("i386") || arch.equals("x86") || arch.equals("amd64"); + return arch.equals("i386") || arch.equals("x86") || arch.equals("amd64") + || arch.equals("x86_64"); } /**
--- a/src/share/classes/sun/security/ssl/SSLContextImpl.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/security/ssl/SSLContextImpl.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2012, 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 @@ -770,12 +770,8 @@ // the delegated trust manager private final X509TrustManager tm; - // Cache the trusted certificate to optimize the performance. - private final Collection<X509Certificate> trustedCerts = new HashSet<>(); - AbstractTrustManagerWrapper(X509TrustManager tm) { this.tm = tm; - Collections.addAll(trustedCerts, tm.getAcceptedIssuers()); } @Override @@ -916,6 +912,13 @@ try { // Does the certificate chain end with a trusted certificate? int checkedLength = chain.length - 1; + + Collection<X509Certificate> trustedCerts = new HashSet<>(); + X509Certificate[] certs = tm.getAcceptedIssuers(); + if ((certs != null) && (certs.length > 0)){ + Collections.addAll(trustedCerts, certs); + } + if (trustedCerts.contains(chain[checkedLength])) { checkedLength--; }
--- a/src/share/classes/sun/util/resources/LocaleNames_de.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_de.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=Bahrain BI=Burundi BJ=Benin +BL=Saint Barth\u00E9lemy BM=Bermuda BN=Brunei BO=Bolivien +BQ=Bonaire, Sint Eustatius und Saba BR=Brasilien BS=Bahamas BT=Bhutan @@ -919,6 +921,7 @@ CS=Serbien und Montenegro CU=Kuba CV=Kap Verde +CW=Cura\u00E7ao CX=Weihnachtsinsel CY=Zypern CZ=Tschechische Republik @@ -946,6 +949,7 @@ GD=Grenada GE=Georgien GF=Franz\u00f6sisch-Guayana +GG=Guernsey GH=Ghana GI=Gibraltar GL=Gr\u00f6nland @@ -968,12 +972,14 @@ ID=Indonesien IE=Irland IL=Israel +IM=Isle of Man IN=Indien IO=Britische Territorien im Indischen Ozean IQ=Irak IR=Iran IS=Island IT=Italien +JE=Jersey JM=Jamaika JO=Jordanien JP=Japan @@ -1003,6 +1009,7 @@ MC=Monaco MD=Moldau ME=Montenegro +MF=St. Martin MG=Madagaskar MH=Marshall-Inseln MK=Mazedonien @@ -1071,6 +1078,7 @@ SR=Suriname ST=Sao Tome und Principe SV=El Salvador +SX=Sint Maarten (Niederl\u00E4ndischer Teil) SY=Syrien SZ=Swasiland TC=Turks- und Caicos-Inseln
--- a/src/share/classes/sun/util/resources/LocaleNames_es.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_es.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=Bahr\u00e1in BI=Burundi BJ=Ben\u00edn +BL=San Bartolom\u00E9 BM=Bermudas BN=Brun\u00e9i BO=Bolivia +BQ=Bonaire, San Eustaquio y Saba BR=Brasil BS=Bahamas BT=But\u00e1n @@ -919,6 +921,7 @@ CS=Serbia y Montenegro CU=Cuba CV=Cabo Verde +CW=Cura\u00E7ao CX=Isla Christmas CY=Chipre CZ=Chequia @@ -946,6 +949,7 @@ GD=Granada GE=Georgia GF=Guayana Francesa +GG=Guernsey GH=Ghana GI=Gibraltar GL=Groenlandia @@ -968,12 +972,14 @@ ID=Indonesia IE=Irlanda IL=Israel +IM=Isla de Man IN=India IO=Territorio Brit\u00e1nico del Oc\u00e9ano \u00cdndico IQ=Iraq IR=Ir\u00e1n IS=Islandia IT=Italia +JE=Jersey JM=Jamaica JO=Jordania JP=Jap\u00f3n @@ -1003,6 +1009,7 @@ MC=M\u00f3naco MD=Moldavia ME=Montenegro +MF=San Mart\u00EDn MG=Madagascar MH=Islas Marshall MK=Macedonia @@ -1071,6 +1078,7 @@ SR=Surinam ST=Santo Tom\u00e9 y Pr\u00edncipe SV=El Salvador +SX=San Mart\u00EDn (regi\u00F3n holandesa) SY=Siria SZ=Suazilandia TC=Islas Turcas y Caicos
--- a/src/share/classes/sun/util/resources/LocaleNames_fr.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_fr.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=Bahre\u00efn BI=Burundi BJ=Benin +BL=Saint-Barth\u00E9lemy BM=Bermudes BN=Brunei BO=Bolivie +BQ=Bonaire, Saint-Eustache et Saba BR=Br\u00e9sil BS=Bahamas BT=Bhoutan @@ -919,6 +921,7 @@ CS=Serbie et Mont\u00e9n\u00e9gro CU=Cuba CV=Cap Vert +CW=Cura\u00E7ao CX=\u00cele Christmas CY=Chypre CZ=R\u00e9publique Tch\u00e8que @@ -946,6 +949,7 @@ GD=Grenade GE=G\u00e9orgie GF=Guyane fran\u00e7aise +GG=Guernesey GH=Ghana GI=Gibraltar GL=Groenland @@ -968,12 +972,14 @@ ID=Indon\u00e9sie IE=Irlande IL=Isra\u00ebl +IM=Ile de Man IN=Inde IO=Territoires britanniques de l'Oc\u00e9an Indien IQ=Irak IR=Iran IS=Islande IT=Italie +JE=Jersey JM=Jama\u00efque JO=Jordanie JP=Japon @@ -1003,6 +1009,7 @@ MC=Monaco MD=Moldavie ME=Mont\u00e9n\u00e9gro +MF=Saint-Martin MG=Madagascar MH=\u00celes Marshall MK=Mac\u00e9doine @@ -1071,6 +1078,7 @@ SR=Suriname ST=Sao Tom\u00e9 et Principe SV=El Salvador +SX=Saint-Martin (partie n\u00E9erlandaise) SY=Syrie SZ=Swaziland TC=\u00celes Turks et Caicos
--- a/src/share/classes/sun/util/resources/LocaleNames_it.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_it.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=Bahrain BI=Burundi BJ=Benin +BL=Saint Barth\u00E9lemy BM=Bermuda BN=Brunei BO=Bolivia +BQ=Bonaire, Sint Eustatius e Saba BR=Brasile BS=Bahamas BT=Bhutan @@ -919,6 +921,7 @@ CS=Serbia e Montenegro CU=Cuba CV=Capo Verde +CW=Cura\u00E7ao CX=Isola di Natale CY=Cipro CZ=Repubblica Ceca @@ -946,6 +949,7 @@ GD=Grenada GE=Georgia GF=Guayana Francese +GG=Guernsey GH=Ghana GI=Gibilterra GL=Groenlandia @@ -968,12 +972,14 @@ ID=Indonesia IE=Irlanda IL=Israele +IM=Isola di Man IN=India IO=Territorio britannico dell'Oceano Indiano IQ=Iraq IR=Iran IS=Islanda IT=Italia +JE=Jersey JM=Giamaica JO=Giordania JP=Giappone @@ -1003,6 +1009,7 @@ MC=Monaco MD=Moldavia ME=Montenegro +MF=Saint Martin MG=Madagascar MH=Isole Marshall MK=Macedonia @@ -1071,6 +1078,7 @@ SR=Suriname ST=S\u00e3o Tom\u00e9 e Principe SV=El Salvador +SX=Sint Maarten (parte olandese) SY=Siria SZ=Swaziland TC=Isole Turks e Caicos
--- a/src/share/classes/sun/util/resources/LocaleNames_ja.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_ja.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=\u30d0\u30fc\u30ec\u30fc\u30f3 BI=\u30d6\u30eb\u30f3\u30b8 BJ=\u30d9\u30cb\u30f3 +BL=\u30B5\u30F3\u30FB\u30D0\u30EB\u30C6\u30EB\u30DF\u30FC BM=\u30d0\u30fc\u30df\u30e5\u30fc\u30c0\u8af8\u5cf6 BN=\u30d6\u30eb\u30cd\u30a4 BO=\u30dc\u30ea\u30d3\u30a2 +BQ=\u30DC\u30CD\u30FC\u30EB\u3001\u30BB\u30F3\u30C8\u30FB\u30A8\u30A6\u30B9\u30BF\u30C6\u30A3\u30A6\u30B9\u304A\u3088\u3073\u30B5\u30D0 BR=\u30d6\u30e9\u30b8\u30eb BS=\u30d0\u30cf\u30de BT=\u30d6\u30fc\u30bf\u30f3 @@ -919,6 +921,7 @@ CS=\u30bb\u30eb\u30d3\u30a2\u30fb\u30e2\u30f3\u30c6\u30cd\u30b0\u30ed CU=\u30ad\u30e5\u30fc\u30d0 CV=\u30ab\u30fc\u30dc\u30d9\u30eb\u30c7 +CW=\u30AD\u30E5\u30E9\u30BD\u30FC CX=\u30af\u30ea\u30b9\u30de\u30b9\u5cf6 CY=\u30ad\u30d7\u30ed\u30b9 CZ=\u30c1\u30a7\u30b3 @@ -946,6 +949,7 @@ GD=\u30b0\u30ec\u30ca\u30c0 GE=\u30b0\u30eb\u30b8\u30a2 GF=\u4ecf\u9818\u30ae\u30a2\u30ca +GG=\u30AC\u30FC\u30F3\u30B8\u30FC GH=\u30ac\u30fc\u30ca GI=\u30b8\u30d6\u30e9\u30eb\u30bf\u30eb GL=\u30b0\u30ea\u30fc\u30f3\u30e9\u30f3\u30c9 @@ -968,12 +972,14 @@ ID=\u30a4\u30f3\u30c9\u30cd\u30b7\u30a2 IE=\u30a2\u30a4\u30eb\u30e9\u30f3\u30c9 IL=\u30a4\u30b9\u30e9\u30a8\u30eb +IM=\u30DE\u30F3\u5CF6 IN=\u30a4\u30f3\u30c9 IO=\u82f1\u9818\u30a4\u30f3\u30c9\u6d0b\u5730\u57df IQ=\u30a4\u30e9\u30af IR=\u30a4\u30e9\u30f3 IS=\u30a2\u30a4\u30b9\u30e9\u30f3\u30c9 IT=\u30a4\u30bf\u30ea\u30a2 +JE=\u30B8\u30E3\u30FC\u30B8\u30FC JM=\u30b8\u30e3\u30de\u30a4\u30ab JO=\u30e8\u30eb\u30c0\u30f3 JP=\u65e5\u672c @@ -1003,6 +1009,7 @@ MC=\u30e2\u30ca\u30b3 MD=\u30e2\u30eb\u30c9\u30d0 ME=\u30e2\u30f3\u30c6\u30cd\u30b0\u30ed +MF=\u30BB\u30F3\u30C8\u30FB\u30DE\u30FC\u30C1\u30F3 MG=\u30de\u30c0\u30ac\u30b9\u30ab\u30eb MH=\u30de\u30fc\u30b7\u30e3\u30eb\u8af8\u5cf6 MK=\u30de\u30b1\u30c9\u30cb\u30a2 @@ -1071,6 +1078,7 @@ SR=\u30b9\u30ea\u30ca\u30e0 ST=\u30b5\u30f3\u30c8\u30e1\u30fb\u30d7\u30ea\u30f3\u30b7\u30da SV=\u30a8\u30eb\u30b5\u30eb\u30d0\u30c9\u30eb +SX=\u30B5\u30F3\u30FB\u30DE\u30EB\u30BF\u30F3(\u30AA\u30E9\u30F3\u30C0\u9818) SY=\u30b7\u30ea\u30a2 SZ=\u30b9\u30ef\u30b8\u30e9\u30f3\u30c9 TC=\u30bf\u30fc\u30af\u30b9\u8af8\u5cf6\u30fb\u30ab\u30a4\u30b3\u30b9\u8af8\u5cf6
--- a/src/share/classes/sun/util/resources/LocaleNames_ko.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_ko.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=\ubc14\ub808\uc778 BI=\ubd80\ub8ec\ub514 BJ=\ubca0\ub139 +BL=\uC0DD \uBC14\uB974\uD154\uB808\uBBF8 BM=\ubc84\ubba4\ub2e4 BN=\ube0c\ub8e8\ub098\uc774 BO=\ubcfc\ub9ac\ube44\uc544 +BQ=\uBCF4\uB124\uB974, \uC2E0\uD2B8\uC720\uC2A4\uD0C0\uD2F0\uC6B0\uC2A4, \uC0AC\uBC14 \uC81C\uB3C4 BR=\ube0c\ub77c\uc9c8 BS=\ubc14\ud558\ub9c8 BT=\ubd80\ud0c4 @@ -919,6 +921,7 @@ CS=\uc138\ub974\ube44\uc544 \ubaac\ud14c\ub124\uadf8\ub85c(\uc720\uace0\uc2ac\ub77c\ube44\uc544) CU=\ucfe0\ubc14 CV=\uae4c\ubf40\ubca0\ub974\ub370 +CW=\uD034\uB77C\uC18C CX=\ud06c\ub9ac\uc2a4\ub9c8\uc2a4 \uc12c CY=\uc0ac\uc774\ud504\ub7ec\uc2a4 CZ=\uccb4\ucf54 @@ -946,6 +949,7 @@ GD=\uadf8\ub808\ub098\ub2e4 GE=\uadf8\ub8e8\uc9c0\uc57c GF=\ud504\ub791\uc2a4\ub839 \uae30\uc544\ub098 +GG=\uAC74\uC9C0 GH=\uac00\ub098 GI=\uc9c0\ube0c\ub864\ud130 GL=\uadf8\ub9b0\ub79c\ub4dc @@ -968,12 +972,14 @@ ID=\uc778\ub3c4\ub124\uc2dc\uc544 IE=\uc544\uc77c\ub79c\ub4dc IL=\uc774\uc2a4\ub77c\uc5d8 +IM=\uB9E8 \uC12C IN=\uc778\ub3c4 IO=\uc601\uc778\ub3c4 \uc81c\ub3c4 IQ=\uc774\ub77c\ud06c IR=\uc774\ub780 IS=\uc544\uc774\uc2ac\ub780\ub4dc IT=\uc774\ud0c8\ub9ac\uc544 +JE=\uC800\uC9C0 JM=\uc790\uba54\uc774\uce74 JO=\uc694\ub974\ub2e8 JP=\uc77c\ubcf8 @@ -1003,6 +1009,7 @@ MC=\ubaa8\ub098\ucf54 MD=\ubab0\ub3c4\ubc14 ME=\ubaac\ud14c\ub124\uadf8\ub85c +MF=\uC0DD \uB9C8\uB974\uD0F1 MG=\ub9c8\ub2e4\uac00\uc2a4\uce74\ub974 MH=\ub9c8\uc15c \uc81c\ub3c4 MK=\ub9c8\ucf00\ub3c4\ub2c8\uc544\uc5b4 @@ -1071,6 +1078,7 @@ SR=\uc218\ub9ac\ub0a8 ST=\uc0c1\ud22c\uba54 \ud504\ub9b0\uc2dc\ud398 SV=\uc5d8\uc0b4\ubc14\ub3c4\ub974 +SX=\uC2E0\uD2B8\uB9C8\uB974\uD150(\uB124\uB35C\uB780\uB4DC\uB839) SY=\uc2dc\ub9ac\uc544 SZ=\uc2a4\uc640\uc9c8\ub79c\ub4dc TC=\ud130\ud06c\uc2a4 \ucf00\uc774\ucee4\uc2a4 \uc81c\ub3c4
--- a/src/share/classes/sun/util/resources/LocaleNames_sv.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_sv.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=Bahrain BI=Burundi BJ=Benin +BL=Saint Barth\u00E9lemy BM=Bermuda BN=Brunei BO=Bolivia +BQ=Bonaire, Saint Eustatius och Saba BR=Brasilien BS=Bahamas BT=Bhutan @@ -919,6 +921,7 @@ CS=Serbien och Montenegro CU=Kuba CV=Kap Verde +CW=Cura\u00E7ao CX=Jul\u00f6n CY=Cypern CZ=Tjeckiska republiken @@ -946,6 +949,7 @@ GD=Grenada GE=Georgien GF=Franska Guyana +GG=Guernsey GH=Ghana GI=Gibraltar GL=Gr\u00f6nland @@ -968,12 +972,14 @@ ID=Indonesien IE=Irland IL=Israel +IM=Isle of Man IN=Indien IO=Brittiska territoriet i Indiska Oceanen IQ=Irak IR=Iran IS=Island IT=Italien +JE=Jersey JM=Jamaica JO=Jordanien JP=Japan @@ -1003,6 +1009,7 @@ MC=Monaco MD=Moldavien ME=Montenegro +MF=Saint-Martin MG=Madagaskar MH=Marshall\u00f6arna MK=Makedonien @@ -1071,6 +1078,7 @@ SR=Surinam ST=S\u00e3o Tom\u00e9 och Pr\u00edncipe SV=El Salvador +SX=Sint Maarten (nederl\u00E4ndska delen) SY=Syrien SZ=Swaziland TC=Turks- och Caicos\u00f6arna
--- a/src/share/classes/sun/util/resources/LocaleNames_zh.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_zh.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=\u5df4\u6797 BI=\u5e03\u9686\u8fea BJ=\u8d1d\u5b81 +BL=\u5723\u5DF4\u6CF0\u52D2\u7C73\u5C9B BM=\u767e\u6155\u5927 BN=\u6587\u83b1 BO=\u73bb\u5229\u7ef4\u4e9a +BQ=\u535A\u5948\u5C14\u5C9B, \u5723\u5C24\u65AF\u7279\u6B47\u65AF\u5C9B\u548C\u8428\u5DF4\u5C9B BR=\u5df4\u897f BS=\u5df4\u54c8\u9a6c BT=\u4e0d\u4e39 @@ -919,6 +921,7 @@ CS=\u585e\u5c14\u7ef4\u4e9a\u53ca\u9ed1\u5c71 CU=\u53e4\u5df4 CV=\u4f5b\u5f97\u89d2 +CW=\u5E93\u62C9\u7D22\u5C9B CX=\u5723\u8bde\u5c9b CY=\u585e\u6d66\u8def\u65af CZ=\u6377\u514b\u5171\u548c\u56fd @@ -946,6 +949,7 @@ GD=\u683c\u6797\u7eb3\u8fbe GE=\u683c\u9c81\u5409\u4e9a GF=\u6cd5\u5c5e\u572d\u4e9a\u90a3 +GG=\u683C\u6069\u897F\u5C9B GH=\u52a0\u7eb3 GI=\u76f4\u5e03\u7f57\u9640 GL=\u683c\u9675\u5170 @@ -968,12 +972,14 @@ ID=\u5370\u5ea6\u5c3c\u897f\u4e9a IE=\u7231\u5c14\u5170 IL=\u4ee5\u8272\u5217 +IM=\u66FC\u5C9B IN=\u5370\u5ea6 IO=\u82f1\u5c5e\u5370\u5ea6\u6d0b\u9886\u5730 IQ=\u4f0a\u62c9\u514b IR=\u4f0a\u6717 IS=\u51b0\u5c9b IT=\u610f\u5927\u5229 +JE=\u6CFD\u897F\u5C9B JM=\u7259\u4e70\u52a0 JO=\u7ea6\u65e6 JP=\u65e5\u672c @@ -1003,6 +1009,7 @@ MC=\u6469\u7eb3\u54e5 MD=\u6469\u5c14\u591a\u74e6 ME=\u9ed1\u5c71 +MF=\u5723\u9A6C\u4E01 MG=\u9a6c\u8fbe\u52a0\u65af\u52a0 MH=\u9a6c\u7ecd\u5c14\u7fa4\u5c9b MK=\u9a6c\u5176\u987f\u738b\u56fd @@ -1071,6 +1078,7 @@ SR=\u82cf\u91cc\u5357 ST=\u5723\u591a\u7f8e\u548c\u666e\u6797\u897f\u6bd4 SV=\u8428\u5c14\u74e6\u591a +SX=\u8377\u5C5E\u5723\u9A6C\u4E01\u5C9B SY=\u53d9\u5229\u4e9a SZ=\u65af\u5a01\u58eb\u5170 TC=\u7279\u514b\u65af\u7fa4\u5c9b\u548c\u51ef\u79d1\u65af\u7fa4\u5c9b
--- a/src/share/classes/sun/util/resources/LocaleNames_zh_TW.properties Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/LocaleNames_zh_TW.properties Mon Apr 16 11:16:28 2012 -0700 @@ -893,9 +893,11 @@ BH=\u5df4\u6797 BI=\u6d66\u9686\u5730 BJ=\u8c9d\u5357 +BL=\u8056\u5DF4\u745F\u7C73 BM=\u767e\u6155\u9054 BN=\u6c76\u840a BO=\u73bb\u5229\u7dad\u4e9e +BQ=\u6CE2\u7D0D\u723E\u5CF6\u3001\u8056\u827E\u65AF\u5854\u5F97\u65AF\u5CF6\u53CA\u85A9\u5DF4\u5CF6 BR=\u5df4\u897f BS=\u5df4\u54c8\u99ac BT=\u4e0d\u4e39 @@ -919,6 +921,7 @@ CS=\u585e\u723e\u7dad\u4e9e\u53ca\u8499\u7279\u5c3c\u54e5\u7f85 CU=\u53e4\u5df4 CV=\u7dad\u5fb7\u89d2 +CW=\u53E4\u62C9\u679C CX=\u8056\u8a95\u5cf6 CY=\u8cfd\u666e\u52d2\u65af CZ=\u6377\u514b\u5171\u548c\u570b @@ -946,6 +949,7 @@ GD=\u683c\u745e\u90a3\u9054 GE=\u55ac\u6cbb\u4e9e GF=\u6cd5\u5c6c\u84cb\u4e9e\u7d0d +GG=\u6839\u897F\u5CF6 GH=\u8fe6\u7d0d GI=\u76f4\u5e03\u7f85\u9640 GL=\u683c\u9675\u862d @@ -968,12 +972,14 @@ ID=\u5370\u5c3c IE=\u611b\u723e\u862d IL=\u4ee5\u8272\u5217 +IM=\u66FC\u5CF6 IN=\u5370\u5ea6 IO=\u82f1\u5c6c\u5370\u5ea6\u6d0b\u5730\u5340 IQ=\u4f0a\u62c9\u514b IR=\u4f0a\u6717 IS=\u51b0\u5cf6 IT=\u7fa9\u5927\u5229 +JE=\u6FA4\u897F\u5CF6 JM=\u7259\u8cb7 JO=\u7d04\u65e6 JP=\u65e5\u672c @@ -1003,6 +1009,7 @@ MC=\u6469\u7d0d\u54e5 MD=\u6469\u723e\u591a\u74e6 ME=\u8499\u7279\u5c3c\u683c\u7f85 +MF=\u8056\u99AC\u4E01 MG=\u99ac\u9054\u52a0\u65af\u52a0 MH=\u99ac\u7d39\u723e\u7fa4\u5cf6 MK=\u99ac\u5176\u9813 @@ -1071,6 +1078,7 @@ SR=\u8607\u5229\u5357 ST=\u8056\u591a\u7f8e SV=\u85a9\u723e\u74e6\u591a +SX=\u8056\u99AC\u4E01 (\u8377\u862D\u90E8\u4EFD) SY=\u6558\u5229\u4e9e SZ=\u53f2\u74e6\u6fdf\u862d TC=\u571f\u514b\u65af\u548c\u958b\u5361\u65af\u7fa4\u5cf6
--- a/src/share/classes/sun/util/resources/TimeZoneNames.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "French Guiana Summer Time", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Samara Summer Time", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Volgograd Summer Time", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_de.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_de.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Franz\u00f6sisch-Guiana Sommerzeit", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Samarische Sommerzeit", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Wolgograder Sommerzeit", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_es.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_es.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Hora de verano de la Guayana Francesa", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Hora de verano de Samara", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Hora de verano de Volgogrado", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_fr.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_fr.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Heure d'\u00e9t\u00e9 de Guyane fran\u00e7aise", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Heure d'\u00e9t\u00e9 de Samara", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Heure d'\u00e9t\u00e9 de Volgograd", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_it.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_it.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Ora estiva della Guyana Francese", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Ora estiva di Samara", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Ora estiva di Volgograd", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_ja.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_ja.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "\u4ecf\u9818\u30ae\u30a2\u30ca\u590f\u6642\u9593", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "\u30b5\u30de\u30e9\u590f\u6642\u9593", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "\u30dc\u30eb\u30b4\u30b0\u30e9\u30fc\u30c9\u590f\u6642\u9593", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_ko.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_ko.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "\ud504\ub791\uc2a4\ub839 \uae30\uc544\ub098 \uc77c\uad11\uc808\uc57d\uc2dc\uac04", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "\uc0ac\ub9c8\ub77c \uc77c\uad11\uc808\uc57d\uc2dc\uac04", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "\ubcfc\uace0\uadf8\ub77c\ub4dc \uc77c\uad11\uc808\uc57d\uc2dc\uac04", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_pt_BR.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_pt_BR.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Fuso hor\u00e1rio de ver\u00e3o da Guiana Francesa", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Fuso hor\u00e1rio de ver\u00e3o de Samara", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Fuso hor\u00e1rio de ver\u00e3o de Volgogrado", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_sv.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_sv.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "Franska Guyana, sommartid", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "Samara, sommartid", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "Volgograd, sommartid", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_zh_CN.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_zh_CN.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "\u6cd5\u5c5e\u572d\u4e9a\u90a3\u590f\u4ee4\u65f6", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -678,7 +679,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -699,14 +700,14 @@ "\u6c99\u9a6c\u62c9\u590f\u4ee4\u65f6", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -715,7 +716,7 @@ "\u4f0f\u5c14\u52a0\u683c\u52d2\u590f\u4ee4\u65f6", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- a/src/share/classes/sun/util/resources/TimeZoneNames_zh_TW.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/share/classes/sun/util/resources/TimeZoneNames_zh_TW.java Mon Apr 16 11:16:28 2012 -0700 @@ -333,6 +333,7 @@ "\u6cd5\u5c6c\u572d\u4e9e\u90a3\u590f\u4ee4\u6642\u9593", "GFST"}}, {"America/Cayman", EST}, {"America/Chihuahua", MST}, + {"America/Creston", MST}, {"America/Coral_Harbour", EST}, {"America/Cordoba", AGT}, {"America/Costa_Rica", CST}, @@ -679,7 +680,7 @@ {"Europe/Istanbul", EET}, {"Europe/Jersey", GMTBST}, {"Europe/Kaliningrad", FET}, - {"Europe/Kiev", FET}, + {"Europe/Kiev", EET}, {"Europe/Lisbon", WET}, {"Europe/Ljubljana", CET}, {"Europe/London", GMTBST}, @@ -700,14 +701,14 @@ "\u6c99\u99ac\u62c9\u590f\u4ee4\u6642\u9593", "SAMST"}}, {"Europe/San_Marino", CET}, {"Europe/Sarajevo", CET}, - {"Europe/Simferopol", FET}, + {"Europe/Simferopol", EET}, {"Europe/Skopje", CET}, {"Europe/Sofia", EET}, {"Europe/Stockholm", CET}, {"Europe/Tallinn", EET}, {"Europe/Tirane", CET}, {"Europe/Tiraspol", EET}, - {"Europe/Uzhgorod", FET}, + {"Europe/Uzhgorod", EET}, {"Europe/Vaduz", CET}, {"Europe/Vatican", CET}, {"Europe/Vienna", CET}, @@ -716,7 +717,7 @@ "\u4f0f\u723e\u52a0\u683c\u52d2\u590f\u4ee4\u6642\u9593", "VOLST"}}, {"Europe/Warsaw", CET}, {"Europe/Zagreb", CET}, - {"Europe/Zaporozhye", FET}, + {"Europe/Zaporozhye", EET}, {"Europe/Zurich", CET}, {"GB", GMTBST}, {"GB-Eire", GMTBST},
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/solaris/classes/java/lang/ClassLoaderHelper.java Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2012, 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 java.lang; + +import java.io.File; + +class ClassLoaderHelper { + + private ClassLoaderHelper() {} + + /** + * Returns an alternate path name for the given file + * such that if the original pathname did not exist, then the + * file may be located at the alternate location. + * For most platforms, this behavior is not supported and returns null. + */ + static File mapAlternativeName(File lib) { + return null; + } +}
--- a/src/solaris/classes/sun/nio/ch/DefaultAsynchronousChannelProvider.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/classes/sun/nio/ch/DefaultAsynchronousChannelProvider.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2009, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2008, 2012, 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 @@ -50,7 +50,7 @@ return new SolarisAsynchronousChannelProvider(); if (osname.equals("Linux")) return new LinuxAsynchronousChannelProvider(); - if (osname.startsWith("Mac OS")) + if (osname.contains("OS X")) return new BsdAsynchronousChannelProvider(); throw new InternalError("platform not recognized"); }
--- a/src/solaris/classes/sun/nio/fs/DefaultFileSystemProvider.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/classes/sun/nio/fs/DefaultFileSystemProvider.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2009, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2008, 2012, 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 @@ -68,7 +68,7 @@ return createProvider("sun.nio.fs.SolarisFileSystemProvider"); if (osname.equals("Linux")) return createProvider("sun.nio.fs.LinuxFileSystemProvider"); - if (osname.equals("Darwin") || osname.startsWith("Mac OS X")) + if (osname.equals("Darwin") || osname.contains("OS X")) return createProvider("sun.nio.fs.BsdFileSystemProvider"); throw new AssertionError("Platform not recognized"); }
--- a/src/solaris/classes/sun/print/UnixPrintServiceLookup.java Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/classes/sun/print/UnixPrintServiceLookup.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -120,7 +120,7 @@ static boolean isBSD() { return (osname.equals("Linux") || - osname.startsWith("Mac OS X")); + osname.contains("OS X")); } static final int UNINITIALIZED = -1;
--- a/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH appletviewer 1 "07 May 2011" +.TH appletviewer 1 "21 Mar 2012" .LP .SH "名前" -appletviewer \- Java アプレットビューア +appletviewer \- Javaアプレット・ビューア .LP .LP -\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。 +\f3appletviewer\fPコマンドでは、Webブラウザの外でアプレットを実行できます。 .LP .SH "形式" .LP @@ -36,27 +36,30 @@ .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://download.oracle.com/javase/7/docs/technotes/tools/appletviewertags.htmlを参照してください。 .LP .LP -\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。 +\f3注意:\fP \f3appletviewer\fPは開発専用です。詳細は、サンプル/テスト・アプリケーションのコードについてを参照してください。 +.LP +.LP +\f3注意:\fP \f3appletviewer\fPは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 .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/src/solaris/doc/sun/man/man1/ja/apt.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/apt.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,10 +19,10 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH apt 1 "07 May 2011" +.TH apt 1 "21 Mar 2012" .LP -.SH "NAME" +.SH "名前" .LP .LP \f2apt\fP \- 注釈処理ツール @@ -35,57 +35,57 @@ .SH "パラメータ" .LP .LP -オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。 +オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記のオプションを参照してください。 .LP .RS 3 .TP 3 sourcefiles -ゼロ、1 つ、または複数の処理対象のソースファイル +ゼロ、1つ、または複数の処理対象のソース・ファイル .TP 3 @files -ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル +ソース・ファイルまたは他のオプションを一覧表示する1つまたは複数のファイル .RE .LP .SH "説明" .LP .LP -\f3注\fP: \f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください。 +\f3注意\fP: \f2apt\fPツールと、パッケージ\f2com.sun.mirror\fPに含まれているそれに関連したAPIは、JDK 7以降非推奨になっており、JDKの次のメジャー・リリースで削除される予定です。\f2javac(1)\fPツールで利用可能なオプションと、パッケージ\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPに含まれているAPIを使用して、注釈を処理してください。 .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「apt 入門」\fP @ +\f4apt\fP\f3スタート・ガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。 .LP .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 -注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。 +注釈プロセッサ・ファクトリを検索する場所を指定します。このオプションを使用する場合、クラス・パスのファクトリは検索\f2されません\fP。 .TP 3 \-factory classname -使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。 +使用する注釈プロセッサ・ファクトリの名前です。デフォルトの検出プロセスを省略します。 .TP 3 \-version バージョン情報を出力します。 @@ -96,20 +96,20 @@ .LP .SS -javac と共用するオプション +javacと共用するオプション .LP .RS 3 .TP 3 \-d dir -プロセッサと javac 生成のクラスファイルを置く場所を指定します。 +プロセッサとjavac生成のクラス・ファイルを置く場所を指定します。 .TP 3 -\-cp path または \-classpath path -ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。 +\-cppathまたは\-classpathpath +ユーザー・クラス・ファイルと注釈プロセッサ・ファクトリを検索する場所を指定します。\f2\-factorypath\fPが指定されている場合、クラス・パスのファクトリは検索されません。 .RE .LP .LP -\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。 +\f2javac\fPオプションの詳細は、javac(1)のマニュアル・ページを参照してください。 .LP .SS 非標準オプション @@ -117,36 +117,36 @@ .RS 3 .TP 3 \-XListAnnotationTypes -注釈の型に検出されるリスト. +検出された注釈の型をリストします。 .TP 3 \-XListDeclarations -指定および宣言がインクルードされるリスト. +指定およびインクルードされる宣言をリストします。 .TP 3 \-XPrintAptRounds -初期および再帰的な \f2apt\fP ラウンドに関する情報を出力する. +初期および再帰的な\f2apt\fPラウンドに関する情報を出力します。 .TP 3 \-XPrintFactoryInfo -処理を要求するファクトリの注釈に関する情報を出力する. +ファクトリに処理をリクエストする注釈に関する情報を出力します。 .TP 3 \-XclassesAsDecls -クラスファイルとソースファイルの両方を、処理対象の宣言として処理します。 +クラス・ファイルとソース・ファイルの両方を、処理対象の宣言として処理します。 .RE .LP .LP -\f3注\fP: これらは非標準オプションなので、予告なく変更される可能性があります。 +\f3注意\fP: これらは非標準オプションなので、予告なく変更される可能性があります。 .LP -.SH "注" +.SH "注意" .LP .LP -\f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください。 +\f2apt\fPツールと、パッケージ\f2com.sun.mirror\fPに含まれているそれに関連したAPIは、JDK 7以降非推奨になっており、JDKの次のメジャー・リリースで削除される予定です。\f2javac(1)\fPツールで利用可能なオプションと、パッケージ\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPに含まれているAPIを使用して、注釈を処理してください。 .LP .SH "関連項目" .LP .RS 3 .TP 2 o -javac(1), java(1) +javac(1)、java(1) .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/extcheck.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/extcheck.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH extcheck 1 "07 May 2011" +.TH extcheck 1 "21 Mar 2012" .LP .SH "名前" -extcheck \- jar の競合検出ユーティリティー +extcheck \- jarの競合検出ユーティリティ .LP .LP -\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。 +\f3extcheck\fPは、ターゲットのjarファイルと現在インストールされている拡張機能のjarファイル間のバージョンの競合を検出します。 .LP .SH "形式" .LP @@ -42,26 +42,26 @@ .SH "説明" .LP .LP -\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。 +\f3extcheck\fPユーティリティは、指定されたJarファイルのタイトルおよびバージョンがJava(tm) SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 .LP .LP -\f3extcheck\fP ユーティリティーは、targetfile.jar ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされている \f2すべての Jar ファイル内の\fP 対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。 +\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 です。 +競合が検出されない場合のリターン・コードは\f20\fPです。 .LP .LP -拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP 、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。 \f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。 +拡張機能ディレクトリ内のいずれかの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
--- a/src/solaris/doc/sun/man/man1/ja/idlj.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/idlj.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH idlj 1 "07 May 2011" +.TH idlj 1 "21 Mar 2012" .LP .SH "名前" -idlj \- IDL\-to\-Java コンパイラ +idlj \- IDL\-to\-Javaコンパイラ .LP -\f3idlj\fP は、指定された IDL ファイルから Java バインディングを生成します。 +\f3idlj\fPは、指定されたIDLファイルからJavaバインディングを生成します。 .SH "形式" .LP .nf @@ -38,22 +38,22 @@ .LP .LP -\f2idl\-file\fP は、インタフェース定義言語 (IDL) による定義が入ったファイルの名前です。\f2options\fP の順番は任意ですが、\f2idl\-file\fP よりも前に指定しなければなりません。 +\f2idl\-file\fPは、インタフェース定義言語(IDL)による定義が入ったファイルの名前です。\f2options\fPの順番は任意ですが、\f2idl\-file\fPよりも前に指定する必要があります。 .LP .SH "説明" .LP .LP -IDL\-to\-Java コンパイラは、指定された IDL ファイルについて Java バインディングを生成します。バインディングの詳細は、 +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://download.oracle.com/javase/7/docs/technotes/guides/idl/mapping/jidlMapping.htmlを参照してください。IDL\-to\-Javaコンパイラの以前のリリースの中には、\f2idltojava\fPという名前だったものがあります。 .LP .SS -クライアントバインディングおよびサーバーバインディングの発行 +クライアント・バインディングおよびサーバー・バインディングの発行 .LP .LP -My.idl という名前の IDL ファイルに対して Java バインディングを生成するには、次のコマンドを実行します。 +My.idlという名前のIDLファイルに対してJavaバインディングを生成するには、次のコマンドを実行します。 .LP .nf \f3 @@ -87,7 +87,7 @@ .LP .LP -サーバー側のバインディングには、クライアント側のバインディングのほかに、スケルトンも含まれています。これらはすべて、 \f2POA\fP (つまり継承モデル) クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド (どれも等価) のうちの 1 つを使用します。 +サーバー側のバインディングには、クライアント側のバインディングの他に、スケルトンも含まれています。これらはすべて、\f2POA\fP(つまり継承モデル)クラスです。クライアント側とサーバー側の両方のバインディングを生成する場合は、次のコマンド(どれも等価)のうちの1つを使用します。 .LP .nf \f3 @@ -100,26 +100,26 @@ .LP .LP -サーバー側で可能なモデルは 2 つあります。継承モデルと Tie 委譲モデルです。 +サーバー側で可能なモデルは2つあります。継承モデルとTie委譲モデルです。 .LP .LP -デフォルトのサーバー側のモデルは、「移殖可能サーバント継承モデル」です。\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2MyPOA.java\fP というファイルが生成されます。この実装は \f2My\fP に提供し、\f2MyPOA\fP を継承する必要があります。 +デフォルトのサーバー側のモデルは、\f2移殖可能サーバント継承モデル\fPです。\f2My.idl\fP内で\f2My\fPインタフェースが定義されている場合は、\f2MyPOA.java\fPというファイルが生成されます。この実装は\f2My\fPに提供し、\f2MyPOA\fPを継承する必要があります。 .LP .LP -\f2MyPOA.java\fP は +\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://download.oracle.com/javase/7/docs/api/org/omg/PortableServer/Servant.htmlを拡張するストリームベースのスケルトンで、スケルトンが実装するIDLインタフェースに関連付けられている\f2InvokeHandler\fPインタフェースと操作インタフェースを実装します。 .LP .LP .na -\f2Portable Object Adapter (POA)\fP @ +\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://download.oracle.com/javase/7/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 ベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次のコマンドを使用します。 +継承モデルのもう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 @@ -132,10 +132,10 @@ .LP .LP -\f2My.idl\fP 内で \f2My\fP インタフェースが定義されている場合は、\f2_MyImplBase.java\fP というファイルが生成されます。\f2My\fP に対してその実装を提供し、この実装は \f2_MyImplBase\fP から継承しなければなりません。 +\f2My.idl\fP内で\f2My\fPインタフェースが定義されている場合は、\f2_MyImplBase.java\fPというファイルが生成されます。\f2My\fPに対してその実装を提供し、この実装は\f2_MyImplBase\fPから継承する必要があります。 .LP .LP -もう 1 つのサーバー側モデルは、Tie モデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tie とスケルトンを同時に生成することはできないため、それらは別々に生成しなければなりません。次のコマンドによって、Tie モデル用のバインディングが生成されます。 +もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 .LP .nf \f3 @@ -148,7 +148,7 @@ .LP .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 @@ -188,10 +188,10 @@ .LP .LP -他の実装から継承しなければならない場合、標準の継承モデルではなく Tie モデルを使用することがあります。Java の場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは 1 つだけです。継承モデルを使用した場合は、そのスロットが占有されます。Tie モデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが 1 つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼び出しが 1 回発生します。 +他の実装から継承する必要がある場合、標準の継承モデルではなくTieモデルを使用することもできます。Javaの場合は、インタフェースの継承の個数に制限はありませんが、クラスの継承に使用できるスロットは1つのみです。継承モデルを使用した場合は、そのスロットが占有されます。Tieモデルを使用した場合は、そのスロットが使用されず、ユーザーが独自の目的で使用することができます。ただし、この方法には、間接性のレベルが1つ導入されるという欠点があります。メソッドを呼び出すときに、余分なメソッド呼出しが1回発生します。 .LP .LP -IDL のバージョンから J2SE 1.4 より前のバージョンの Java 言語へのマッピングと互換性のある、サーバー側の Tie モデルのバインディングを生成するには、次のコマンドを使用します。 +J2SE 1.4より前のバージョンのJava言語にマッピングするIDLのバージョンと互換性のある、サーバー側のTieモデルのバインディングを生成する方法は、次のとおりです。 .LP .nf \f3 @@ -204,7 +204,7 @@ .LP .LP -\f2My\fP というインタフェースの場合、これにより \f2My_Tie.java\fP が生成されます。\f2My_Tie\fP のコンストラクタは、\f2impl\fP を取ります。\f2impl\fP に対して実装を提供しなければなりませんが、その実装は \f2HelloOperations\fP インタフェースから継承する必要があるだけで、その他のクラスから継承する必要はありません。しかし、この実装を ORB と一緒に使用するには、\f2My_Tie\fP 内で実装をラップしなければなりません。たとえば、次のようにします。 +\f2My\fPというインタフェースの場合、これにより\f2My_Tie.java\fPが生成されます。\f2My_Tie\fPのコンストラクタは、\f2impl\fPを取ります。\f2impl\fPに対して実装を提供する必要がありますが、その実装は\f2HelloOperations\fPインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、この実装をORBと一緒に使用するには、\f2My_Tie\fP内で実装をラップする必要があります。たとえば、次のようにします。 .LP .nf \f3 @@ -239,7 +239,7 @@ 発行されたファイルの代替位置の指定 .LP .LP -発行されたファイルをカレントディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。 +発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -250,13 +250,13 @@ .LP .LP -\f2My\fP インタフェースの場合、バインディングは、\f2./My.java\fP ではなく、\f2/altdir/My.java\fP などに発行されます。 +\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 にある場合は、次のようなコマンドでコンパイラを呼び出します。 +\f2My.idl\fPにもう1つのIDLファイル\f2MyOther.idl\fPがインクルードされている場合、コンパイラは、ローカル・ディレクトリに\f2MyOther.idl\fPがあるものと想定します。たとえば、そのファイルが\f2/includes\fPにある場合は、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -267,7 +267,7 @@ .LP .LP -また、もし \f2My.idl\fP に、たとえば \f2/moreIncludes\fP にある \f2Another.idl\fP もインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 +たとえば、\f2/moreIncludes\fPにある\f2Another.idl\fPも\f2My.idl\fPにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 .LP .nf \f3 @@ -278,7 +278,7 @@ .LP .LP -このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルードファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATH にリストされているディレクトリ内に \f2idl.config\fP という名前のファイルを作成します。その \f2idl.config\fP の中に、次のような形式の行を入れます。 +このような形式でインクルードを指定すると、コマンドが長くて複雑になります。そこで、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。CLASSPATHにリストされているディレクトリ内に\f2idl.config\fPという名前のファイルを作成します。その\f2idl.config\fPの中に、次のような形式の行を入れます。 .LP .nf \f3 @@ -290,17 +290,17 @@ .LP .LP -コンパイラは、このファイルを検索し、インクルードリストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン (;) になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windows プラットフォームではセミコロンですが、Unix プラットフォームではコロンです。 \f2インクルード\fPの詳細については、 +コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。たとえば、Windowsプラットフォームではセミコロンですが、Unixプラットフォームではコロンです。\f2includes\fPの詳細は、 .na -\f2CLASSPATH の設定\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#general を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#generalを参照してください。 .LP .SS -インクルードファイルに対するバインディングの発行 +インクルード・ファイルに対するバインディングの発行 .LP .LP -デフォルトでは、コマンド行に指定した IDL ファイルで定義されているインタフェースや構造体などについてのみ、Java バインディングが生成されます。インクルードされたファイルで定義されている型については、Java バインディングは生成されません。たとえば、次の 2 つの IDL ファイルについて考えてみましょう。 +デフォルトでは、コマンドラインに指定したIDLファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つのIDLファイルについて考えてみましょう。 .LP .LP @@ -343,7 +343,7 @@ .LP .LP -次のコマンドでは、\f2My\fP に対する Java バインディングだけが生成されます。 +次のコマンドでは、\f2My\fPに対するJavaバインディングのみが生成されます。 .LP .nf \f3 @@ -355,7 +355,7 @@ .LP .LP -\f2My.idl\fP で定義されている型と、\f2My.idl\fP にインクルードされたファイル (この例では \f2MyOther.idl\fP) で定義されている型すべてについて Java バインディングを生成するには、次のコマンドを使用します。 +\f2My.idl\fPで定義されている型と、\f2My.idl\fPにインクルードされたファイル(この例では\f2MyOther.idl\fP)で定義されている型すべてについて生成するには、次のコマンドを使用します。 .LP .nf \f3 @@ -366,7 +366,7 @@ .LP .LP -このデフォルトの規則に関して注意しなければならないことがあります。グローバルスコープに指定した \f2#include\fP 文は、前述のとおりに処理されます。これらの \f2#include\fP 文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した \f2#include\fP 文は、本当の意味での \f2#include\fP 文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対して Java バインディングが発行されます。次はその例です。 +このデフォルトのルールに関して注意が必要な点があります。グローバル・スコープに指定した\f2#include\fP文は、前述のとおりに処理されます。これらの\f2#include\fP文は、インポート文と見なすことができます。それに対して、他の定義に囲まれたスコープ内に指定した\f2#include\fP文は、本当の意味での\f2#include\fP文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま指定されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 .LP .LP @@ -437,7 +437,7 @@ .LP .LP -次のような一連の Java ファイルが生成されます。 +次のような一連のJavaファイルが生成されます。 .LP .nf \f3 @@ -463,16 +463,16 @@ .LP .LP -インポート文と見なされる \f2#include\fP に定義されているため、\f2MyOther.java\fP は生成されません。ただし、本当の意味での \f2#include\fP で定義されているため、\f2E.java\fP は生成されます。さらに、\f2Embedded.idl\fP が \f2My\fP インタフェースのスコープ内にインクルードされていたため、\f2My\fP のスコープ内 (つまり、\f2MyPackage\fP 内) に生成されています。 +インポート文と見なされる\f2#include\fPに定義されていたため、\f2MyOther.java\fPは生成されませんでした。ただし、本当の意味での\f2#include\fPで定義されていたため、\f2E.java\fPは生成\f2されました\fP。さらに、\f2Embedded.idl\fPが\f2My\fPインタフェースのスコープ内にインクルードされていたため、\f2My\fPのスコープ内(つまり、\f2MyPackage\fP内)に生成されています。 .LP .LP -上記の例で \f2\-emitAll\fP フラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。 +上記の例で\f2\-emitAll\fPフラグを使用すれば、インクルードされたすべてのファイルにあるすべての型が発行されます。 .LP .SS パッケージの接頭辞の挿入 .LP .LP -ABC という名前の会社のために作業していて、次のような IDL ファイルを構築したとしましょう。 +ABCという名前の会社のために作業していて、次のようなIDLファイルを構築したとしましょう。 .LP .LP @@ -499,7 +499,7 @@ .LP .LP -このファイルに対して IDL\-to\-Java コンパイラを実行すると、\f2W1\fP および \f2W2\fP に対する Java バインディングが \f2Widgets\fP パッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<会社名>\fP という名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fP パッケージでは不十分です。慣例に従うには、パッケージを \f2com.abc.Widgets\fP にする必要があります。このパッケージ接頭辞を \f2Widgets\fP モジュールに付加するには、次のコマンドを実行します。 +このファイルに対してIDL\-to\-Javaコンパイラを実行すると、\f2W1\fPおよび\f2W2\fPに対するJavaバインディングが\f2Widgets\fPパッケージ内に生成されます。しかし、業界の慣例によると、会社のパッケージは、\f2com.<company name>\fPという名前のパッケージ内に置くことになっています。そのため、\f2Widgets\fPパッケージでは不十分です。慣例に従うには、パッケージを\f2com.abc.Widgets\fPにする必要があります。このパッケージ接頭辞を\f2Widgets\fPモジュールに付加するには、次のコマンドを実行します。 .LP .nf \f3 @@ -510,10 +510,10 @@ .LP .LP -\f2Widgets.idl\fP をインクルードしている IDL ファイルがある場合は、そのコマンドにも \f2\-pkgPrefix\fP フラグが必要です。このフラグを指定しないと、その IDL ファイルは、\f2com.abc.Widgets\fP パッケージではなく、\f2Widgets\fP パッケージを検索することになります。 +\f2Widgets.idl\fPをインクルードしているIDLファイルがある場合は、そのコマンドにも\f2\-pkgPrefix\fPフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\f2com.abc.Widgets\fPパッケージではなく、\f2Widgets\fPパッケージを検索することになります。 .LP .LP -接頭辞が必要なパッケージがいくつもある場合は、前述の \f2idl.config\fP ファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。 +接頭辞が必要なパッケージがいくつもある場合は、前述の\f2idl.config\fPファイルで接頭辞を指定するのが簡単です。パッケージの接頭辞を指定する行は、それぞれ次の形式で記述します。 .LP .nf \f3 @@ -535,13 +535,13 @@ .LP .LP -このオプションを使用しても、リポジトリ ID は影響を受けません。 +このオプションを使用しても、リポジトリIDは影響を受けません。 .LP .SS コンパイル前のシンボルの定義 .LP .LP -コンパイル用のシンボルが IDL ファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグコードを組み入れるときに使用します。次のコマンドは、 +コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。次のコマンドは、 .LP .nf \f3 @@ -552,13 +552,13 @@ .LP .LP -\f2My.idl\fP 内に \f2#define MYDEF\fP という行を指定した場合と等価です。 +\f2My.idl\fP内に\f2#define MYDEF\fPという行を指定した場合と等価です。 .LP .SS 既存のバインディングの保持 .LP .LP -Java バインディングファイルがすでに存在する場合は、\f2\-keep\fP フラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合 (ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\-keep オプションは有用です。次のコマンドは、 +Javaバインディング・ファイルがすでに存在する場合は、\f2\-keep\fPフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\f2\-keep\fPオプションは有用です。次のコマンドは、 .LP .nf \f3 @@ -575,7 +575,7 @@ コンパイルの進捗状況の表示 .LP .LP -IDL\-to\-Java コンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モード (メッセージが多いモード) にするには、\f2\-v\fP オプションを使用します。 +IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。「冗長」モードをアクティブ化するには、\f2\-v\fPオプションを使用します。 .LP .nf \f3 @@ -592,7 +592,7 @@ バージョン情報の表示 .LP .LP -IDL\-to\-Java コンパイラのビルドバージョンを表示するには、コマンド行で \f2\-version\fP オプションを指定します。 +IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンドラインで\f2\-version\fPオプションを指定します。 .LP .nf \f3 @@ -604,14 +604,14 @@ .LP .LP -バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。 +バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンドラインに指定すると、それ以外のオプションを指定しても、すべて無視されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-d symbol -このオプションは、IDL ファイルに次のような行を追加した場合と等価です。 +このオプションは、IDLファイルに次のような行を追加した場合と等価です。 .nf \f3 .fl @@ -621,13 +621,13 @@ .fi .TP 3 \-emitAll -#include ファイル 内で定義されているものも含めて、 \f2すべての型を\fP 発行します。 +\f2#include\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 生成されるファイルがすでに存在している場合は、そのファイルが上書きされません。デフォルトでは、上書きされます。 @@ -636,15 +636,16 @@ 警告メッセージを表示しないようにします。 .TP 3 \-oldImplBase -v1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。デフォルトでは、POA 継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\f2ImplBase\fP 継承モデルのクラスであるサーバー側バインディングが生成されるので、古いバージョンの Java プログラミング言語との下位互換性が得られます。 +1.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 -識別子の中にモジュール名 type が検出されると、生成される Java パッケージ内のすべてのファイルについて、識別子の中のその名前が package で置き換えられます。最初に \f2pkgPrefix\fP を変更します。\f2type\fP は、トップレベルのモジュール、またはすべてのモジュールの外部で定義された IDL 型の単純名です。そして、完全なパッケージ名に正確に一致しなければなりません。 -.LP -1 つの識別子の中で複数の変換がマッチする場合は、もっとも長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、 +識別子の中にモジュール名\f2type\fPが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前が\f2package\fPで置き換えられます。最初に\f2pkgPrefix\fPの変更が行われます。\f2type\fPは、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 +.br +.br +1つの識別子の中で複数の変換がマッチする場合は、最も長いマッチが選ばれます。たとえば、次のような引数が指定されている場合は、 .nf \f3 .fl @@ -652,22 +653,20 @@ .fl \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 @@ -675,37 +674,36 @@ \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 -\-nowarn, \-verbose +\-nowarn、\-verbose 冗長モードになります。 .TP 3 \-version @@ -713,16 +711,18 @@ .RE .LP -各オプションの詳細については、「説明」のセクションを参照してください。 +.LP +各オプションの詳細は、説明のセクションを参照してください。 +.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 @@ -731,7 +731,7 @@ .RS 3 .TP 2 o -グローバル識別子についてインポートが生成されません。予期されないローカル impl を呼び出すと、例外を受け取ります。 しかし、その原因は、\f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP にあるようです。 +グローバル識別子についてインポートが生成されません。予期されないローカルimplを呼び出すと、例外を受け取ります。しかし、その原因は、\f2ServerDelegate\fP DSIコード内の\f2NullPointerException\fPにあるようです。 .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jar.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jar.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jar 1 "07 May 2011" +.TH jar 1 "21 Mar 2012" .LP .SH "名前" -jar \- Java ARchive ツール +jar \- Java ARchiveツール .LP -\f3jar\fP は複数のファイルを 1 つの JAR アーカイブファイルに結合します。 +\f3jar\fPは複数のファイルを1つのJARアーカイブ・ファイルに結合します。 .RS 3 .TP 2 o @@ -38,7 +38,7 @@ オプション .TP 2 o -コマンド行引数ファイル +コマンドライン引数ファイル .TP 2 o 例 @@ -52,19 +52,19 @@ .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 @@ -75,37 +75,37 @@ .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 の場合) される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション \f20\fP (ゼロ) を使用しないかぎり圧縮されます。 +\f2jarfile\fPに結合されるか(cおよびuの場合)、\f2jarfile\fPから抽出(xの場合)または一覧表示(tの場合)される、空白で区切られたファイルまたはディレクトリ。すべてのディレクトリは再帰的に処理されます。このファイルは、オプション\f20\fP(ゼロ)を使用しないかぎり圧縮されます。 .TP 3 manifest -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 の出現順序と一致する必要があります。 +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ファイル内にバンドルされたスタンドアロン・アプリケーションのアプリケーション・エントリ・ポイントとして設定するクラスの名前。\f2e\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\f2\-\ dir\fP \f2inputfiles\fP のセットは複数使用できます。 +これに続く\f2inputfiles\fP引数を処理する間、ディレクトリを\f2dir\fPへ一時的に変更します。\f2\-C\ \fP\f2dir\fP \f2inputfiles\fPのセットは複数使用できます。 .TP 3 \-Joption -Java 実行環境へ渡されるオプション。\f2\-J\fP と \f2option\fP の間には空白を入れないでください。 +Java実行環境へ渡されるオプション。(\f2\-J\fPと\f2option\fPの間には空白を入れないでください。) .RE .LP .SH "説明" .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 ファイルへ結合する一般的な使用法は次のとおりです。 +複数のファイルをJARファイルへ結合する一般的な使用方法は次のとおりです。 .LP .nf \f3 @@ -116,13 +116,13 @@ .fi .LP -この例では、現在のディレクトリにあるクラス (.class) ファイルがすべて、\f2myFile.jar\fP という名前のファイルに格納されます。jar ツールは自動的に、 \f2META\-INF/MANIFEST.MF\fP という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを \f2name\ :\ value\fP ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、「 +この例では、現在のディレクトリにあるすべてのクラス・ファイルが\f2myFile.jar\fPという名前のファイルに格納されます。jarツールは自動的に、\f2META\-INF/MANIFEST.MF\fPという名前のマニフェスト・ファイル・エントリを生成します。これは常に、JARファイルの最初のエントリになります。マニフェスト・ファイルは、アーカイブに関するメタ情報を宣言し、そのデータを\f2name\ :\ value\fPのペアとして格納します。jarツールがマニフェスト・ファイル内にメタ情報を格納する方法の詳細は、 .na -\f2JAR file specification\fP @ +\f2JARファイルの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest」を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR%20Manifestを参照してください。 .LP -既存のマニフェストファイル内に格納された \f2name\ :\ value\fP ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。 +既存のマニフェスト・ファイル内に格納された\f2name\ :\ value\fPのペアをJARファイルに含める必要がある場合には、次のように\f2\-m\fPオプションを使用してそのファイルを指定します。 .LP .nf \f3 @@ -133,14 +133,14 @@ .fi .LP -既存のマニフェストファイルは改行文字で終わっている必要があります。マニフェストファイルが改行文字で終わっていないと、\f3jar\fP はその最終行を解析しません。 +既存のマニフェスト・ファイルは改行文字で終わっている必要があります。マニフェスト・ファイルが改行文字で終わっていないと、\f3jar\fPはその最終行を解析しません。 .br .LP .br .LP -\f3注:\ \fPコマンド行に \f2cmf\fP ではなく \f2cfm\fP が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず JAR アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。 次に例を示します。 +\f3注意:\ \fPコマンドラインに\f2cmf\fPではなく\f2cfm\fPが指定された(mと\-fオプションの順番を逆にした)jarコマンドの場合、\f3jar\fPコマンドラインにまずJARアーカイブの名前を指定し、続いてマニフェスト・ファイルの名前を指定する必要があります。次に例を示します。 .nf \f3 .fl @@ -150,9 +150,9 @@ .fi .LP -マニフェストは、RFC822 ASCII 形式で規定されたテキスト形式であるため、マニフェストファイルの内容を簡単に表示および編集できます。 +マニフェストは、RFC822 ASCII形式で規定されたテキスト形式であるため、マニフェスト・ファイルの内容を簡単に表示および処理できます。 .LP -JAR ファイルからファイルを抽出する場合は、 \f2x\fP を使用します。 +JARファイルからファイルを抽出する場合は、\f2x\fPを使用します。 .LP .nf \f3 @@ -164,7 +164,7 @@ .LP .LP -jar ファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。 +jarファイルから個別のファイルを抽出する場合は、そのファイル名を指定します。 .LP .nf \f3 @@ -176,11 +176,11 @@ .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#JAR_Index がサポートされています。 JarIndex を使用すると、アプリケーションのクラスローダーで JAR ファイルからクラスがロードされるときの効率が向上します。アプリケーションまたはアプレットが複数の JAR ファイルにバンドルされている場合は、クラスがロードされるときに、必要な JAR ファイル以外のダウンロードおよびオープンは行われません。このパフォーマンスの最適化は、新しい \f2\-i\fP オプションを指定して \f2jar\fP を実行すると有効になります。このオプションを使うと、指定した JAR メインファイルと、そのメインファイルが依存しているすべての JAR ファイルについて、パッケージ位置情報が生成されます。メインファイルが依存している JAR ファイルは、JAR メインファイルのマニフェストの \f2Class\-Path\fP 属性に指定しておく必要があります。 +http://download.oracle.com/javase/7/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 @@ -192,39 +192,39 @@ .LP .LP -この例では、 \f2INDEX.LIST\fP ファイルが \f2main.jar\fP の \f2META\-INF\fP ディレクトリ内に挿入されます。 +この例では、\f2INDEX.LIST\fPファイルが\f2main.jar\fPの\f2META\-INF\fPディレクトリ内に挿入されます。 .br .br -このファイルに格納されている情報を使用して、アプリケーションのクラスローダーは、効率的にクラスをロードします。インデックスファイルに位置情報を格納する方法の詳細は、「JarIndex 仕様」を参照してください。 +アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。インデックス・ファイルに位置情報を格納する方法の詳細は、\f2JarIndex\fP仕様を参照してください。 .br .br -ディレクトリをコピーするには、まず \f2dir1\fP 内のファイルを圧縮して \f2stdout\fP に出力し、続いて \f2stdin\fP から抽出して \f2dir2\fP に出力します (\f2\-f\fP オプションはどちらの \f2jar\fP コマンドでも省略)。 +ディレクトリをコピーするには、まず\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 .LP .LP -\f2jar\fP を使用して JAR ファイルや JAR マニフェストファイルを操作するサンプルコマンドを確認したい場合は、後述の「例」を参照してください。また、「 +\f2jar\fPを使用してJARファイルやJARマニフェスト・ファイルを操作するサンプル・コマンドを確認するには、次の例を参照してください。また、 .na -\f2Java Tutorial\fP @ +\f2Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar」の JAR コースも参照してください。 +http://docs.oracle.com/javase/tutorial/deployment/jarのJARトライアルも参照してください。 .LP .SH "オプション" .LP .RS 3 .TP 3 c -f が指定された場合は \f2jarfile\fP という名前の \f2新しい\fP アーカイブファイルを \f2作成し、\fP f と \f2jarfile\fP が省略された場合は標準出力に情報を出力します。\f2inputfiles\fP で指定されたファイルとディレクトリを、このアーカイブに追加します。 +\f2jarfile\fPという名前の新しいアーカイブ・ファイルを作成する(\f2f\fPが指定された場合)か、標準出力に出力します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPで指定されたファイルとディレクトリを、このアーカイブに追加します。 .TP 3 u -f が指定されている場合に、既存ファイル \f2jarfile\fP を \f2更新する目的で、\fP \f2inputfiles\fP に指定されたファイルやディレクトリを追加します。次に例を示します。 +\f2inputfiles\fPに指定されたファイルやディレクトリを追加して、既存ファイル\f2jarfile\fPを更新します(\f2f\fPが指定されている場合)。次に例を示します。 .nf \f3 .fl @@ -232,7 +232,7 @@ .fl \fP .fi -上のコマンドは、ファイル \f2foo.class\fP を既存の JAR ファイル \f2foo.jar\fP に追加します。次の例に示すように、\f2\-u\fP オプションは、マニフェストエントリも更新できます。 +上のコマンドは、ファイル\f2foo.class\fPを既存のJARファイル\f2foo.jar\fPに追加します。次の例に示すように、\f2\-u\fPオプションは、マニフェスト・エントリも更新できます。 .nf \f3 .fl @@ -240,16 +240,16 @@ .fl \fP .fi -\f2foo.jar\fP マニフェストをマニフェスト内の \f2name:value\fP ペアで更新します。 +上のコマンドは、\f2foo.jar\fPマニフェストを\f2manifest\fP内の\f2name : value\fPのペアで更新します。 .TP 3 x -f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、ファイルやディレクトリを抽出します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが抽出されます。指定されていなければ、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。 +\f2jarfile\fPからファイルとディレクトリを抽出します(\f2f\fPが指定された場合)、または標準入力からファイルやディレクトリを抽出します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPが指定されている場合は、指定されたファイルとディレクトリのみが抽出されます。それ以外の場合は、すべてのファイルとディレクトリが抽出されます。抽出されたファイルの日時は、アーカイブ内で設定されたものです。 .TP 3 t -f が指定された場合は \f2jarfile\fP \f2から\fP 、 \f2f\fP と \f2jarfile\fP が省略された場合は標準入力から、目次を表示します。\f2inputfiles\fP が指定されている場合は、その指定したファイルとディレクトリだけが一覧表示されます。指定されていなければ、すべてのファイルとディレクトリが一覧表示されます。 +\f2jarfile\fPから目次を表示します(\f2f\fPが指定された場合)、または標準入力から目次を表示します(\f2f\fPと\f2jarfile\fPが省略された場合)。\f2inputfiles\fPが指定されている場合は、指定されたファイルとディレクトリのみが一覧表示されます。それ以外の場合は、すべてのファイルとディレクトリが一覧表示されます。 .TP 3 i -指定された \f2jarfile\fP と、それに依存する JAR ファイルについて、インデックス情報を生成します。たとえば、 +指定された\f2jarfile\fPと、それに依存するJARファイルについて、インデックス情報を生成します。次に例を示します。 .nf \f3 .fl @@ -258,24 +258,25 @@ \fP .fi .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 -次の各処理の対象となるファイル \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 ファイルが送信されます。 +作成(\f2c\fP)、更新(\f2u\fP)、抽出(\f2x\fP)、インデックス追加(\f2i\fP)または表示(\f2t\fP)の各処理の対象となるファイル\f2jarfile\fPを指定します。\f2f\fPオプションとファイル名\f2jarfile\fPとがペアになります。つまり、片方を記述すれば、もう一方も記述する必要があります。\f2f\fPと\f2jarfile\fPを省略すると、\f2stdin\fPからJARファイル名が取得される(xおよびtの場合)か、\f2stdout\fPにJARファイルが出力されます(cおよびuの場合)。 .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 はその値を更新します。 -.LP -コマンド行で、\f3m\fP と \f3f\fP の文字は、\f2manifest\fP と \f2jarfile\fP の入力順序と同じ順序で記述する必要があります。たとえば、次のようにして使います。 +\f2META\-INF/MANIFEST.MF\fPのファイルで指定したマニフェスト・ファイル\f2manifest\fPの\f2name : value\fPの属性ペアを組み込みます。\f2jar\fPは、すでに同じ名前で存在しない場合は、その\f2name\ :\ value\fPペアを追加します。同じ名前で存在する場合、\f2jar\fPはその値を更新します。 +.br +.br +コマンドラインで、\f3m\fPと\f3f\fPの文字は、\f2manifest\fPと\f2jarfile\fPの入力順序と同じ順序で記述する必要があります。たとえば、次のように使用します。 .nf \f3 .fl @@ -283,17 +284,18 @@ .fl \fP .fi -デフォルトのマニフェストには含まれないマニフェストに、特別な目的の \f2name\ :\ value\fP の属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージシーリング、または JAR にバンドルされたアプリケーションを実行するための属性を追加できます。「Java Tutorial」の「 +デフォルトのマニフェストには含まれないマニフェストに、特別な目的の\f2name\ :\ value\fPの属性ペアを追加できます。たとえば、ベンダー情報、バージョン情報、パッケージ・シーリング、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。Javaチュートリアルの .na -\f2JAR Files\fP @ +\f2JARファイル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar/」コースを参照し、 \f4\-m\fP オプションの使用例を確認してください。 +http://docs.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 に設定されます。 +.br +たとえば、次のコマンドでは\f2Main.jar\fPが作成されますが、その際、マニフェスト内の\f2Main\-Class\fP属性値は\f2Main\fPに設定されます。 .nf \f3 .fl @@ -301,8 +303,7 @@ .fl \fP .fi -.LP -次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。 +次のコマンドを実行するとjavaランタイムから直接このアプリケーションを起動できます。 .nf \f3 .fl @@ -310,7 +311,7 @@ .fl \fP .fi -あるパッケージ内にエントリポイントのクラス名が含まれている場合、ドット (「.」) 、スラッシュ (「/」) のいずれかの文字をその区切り文字として使用できます。たとえば、 \f2Main.class\fP が \f2foo\fP という名前のパッケージに含まれている場合、エントリポイントは次のようにして指定できます。 +あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(「.」)、スラッシュ(「/」)のいずれかの文字をその区切り文字として使用できます。たとえば、\f2Main.class\fPが\f2foo\fPという名前のパッケージに含まれている場合、エントリ・ポイントは次のようにして指定できます。 .nf \f3 .fl @@ -326,14 +327,13 @@ .fl \fP .fi -\f3注:\ \fP \f2\-m\fP オプションと \f2\-e\fP オプションの両方を同時に指定した場合、指定したマニフェストにも \f2Main\-Class\fP 属性が含まれていれば、 \f2Main.class\fP の指定があいまいになってエラーや発生し、JAR の作成処理や更新処理が異常終了します。 -.LP +\f3注意:\fP \f2\-m\fPオプションと\f2\-e\fPオプションの両方を同時に指定した場合、指定したマニフェストにも\f2Main\-Class\fP属性が含まれていれば、\f2Main.class\fPの指定があいまいになってエラーや発生し、JARの作成処理や更新処理が異常終了します。 .TP 3 -\-C \ dir -\f2jar\fP コマンドの実行中に後続の \f2inputfiles\fP 引数を処理するときに、一時的にディレクトリを変更します (cd \f2dir\fP)。この処理は、UNIX の \f2tar\fP ユーティリティーの \f2\-C\fP オプションの機能に類似しています。 +\-C\ dir +\f2jar\fPコマンドの実行中に後続の\f2inputfiles\fP引数を処理するときに、一時的にディレクトリを変更します(\f2cd\fP\ \f2dir\fP)。この処理は、UNIXの\f2tar\fPユーティリティの\f2\-C\fPオプションの機能に類似しています。 .br .br -たとえば、次のコマンドは、\f2classes\fP ディレクトリに移動し、そのディレクトリから \f2bar.class\fP を \f2foo.jar\fP に追加します。 +たとえば、次のコマンドは、\f2classes\fPディレクトリに移動し、そのディレクトリから\f2bar.class\fPを\f2foo.jar\fPに追加します。 .nf \f3 .fl @@ -341,15 +341,15 @@ .fl \fP .fi -次のコマンドでは、\f2classes\fP ディレクトリに移動し、\f2classes\fP ディレクトリ内のすべてのファイルを \f2foo.jar\fP に追加します (jar ファイルには classes ディレクトリを作成しません)。次に元のディレクトリに戻ってから、\f2bin\fP ディレクトリに移動し、\f2xyz.class\fP を \f2foo.jar\fP に追加します。 +次のコマンドでは、\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 -\f2classes\fP にファイル \f2bar1\fP と \f2bar2\fP が格納されている場合に、 \f2jar tf foo.jar\fP 使用したときの JAR ファイルの中身を、次に示します。 +\f2classes\fPにファイル\f2bar1\fPと\f2bar2\fPが格納されている場合に、\f2jar tf foo.jar\fP使用したときのJARファイルの中身を、次に示します。 .nf \f3 .fl @@ -368,21 +368,21 @@ .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 "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP -jar のコマンド行を短くしたり簡潔にしたりするために、jar コマンドに対する引数 (\-J オプションを除く) を含む 1 つ以上の \f2ファイルを\fP 指定することが \f2できます\fP 。これにより、任意の長さの jar コマンドを作成でき、オペレーティングシステムによるコマンド行の制限から解放されます。 +jarのコマンドラインを短くしたり簡潔にしたりするために、\f2jar\fPコマンドに対する引数(\f2\-J\fPオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、任意の長さの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 -次の例で、 \f2classes.list\fP には、 \f2find\fP コマンドによって出力されたファイルの名前が格納されます。 +次の例で、\f2classes.list\fPには、\f2find\fPコマンドによって出力されたファイルの名前が格納されます。 .LP .nf \f3 @@ -393,7 +393,7 @@ .LP .LP -次に、引数ファイル構文を使用して \f2classes.list\fP を jar に渡すことで、 \f2そのリスト\fP に対して \f2jar\fP コマンドを実行できます。 +次に、引数ファイル構文を使用して\f2Classes.list\fPを\f2jar\fPに渡すことで、そのリストに対して\f2jar\fPコマンドを実行できます。 .LP .nf \f3 @@ -419,7 +419,7 @@ .LP .SH "例" .LP -特定のディレクトリ内のすべてのファイルをアーカイブに追加する (そのアーカイブがすでに存在する場合は、その内容を上書きする) には、次のようにします。\f2\-v\fP オプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。 +特定のディレクトリ内のすべてのファイルをアーカイブに追加する(そのアーカイブがすでに存在する場合は、その内容を上書きする)には、次のようにします。\f2\-v\fPオプションを使用して情報を詳細に列挙するように指定すると、サイズや最新の更新日など、アーカイブ内のファイルについての詳細情報が表示されます。 .nf \f3 .fl @@ -457,7 +457,7 @@ .fi .LP -すでに画像、オーディオファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一の JAR ファイルに結合できます。 +すでに画像、オーディオ・ファイル、およびクラス用のサブディレクトリに分けている場合は、これらを単一のJARファイルに結合できます。 .nf \f3 .fl @@ -503,7 +503,7 @@ .fi .LP -JAR ファイルのエントリ名を表示するには、「\f2t\fP」オプションを使用します。 +JARファイルのエントリ名を表示するには、\f2t\fPオプションを使用します。 .nf \f3 .fl @@ -534,21 +534,21 @@ .LP .LP -クラスロードを高速にするためにインデックスファイルを JAR ファイルに追加するには、「\f2i\fP」オプションを使用します。 +クラス・ロードを高速にするためにインデックス・ファイルをJARファイルに追加するには、\f2i\fPオプションを使用します。 .br .br 例: .br .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 @@ -558,7 +558,7 @@ .fi .LP -\f2\-i\fP オプションを使用すれば、アプリケーションのクラスの 読み込みを高速化できます。 +\f2\-i\fPオプションを使用すれば、アプリケーションのクラスの読込みを高速化できます。 .nf \f3 .fl @@ -568,32 +568,32 @@ .fi .LP -\f2INDEX.LIST\fP ファイルが \f2META\-INF\fP ディレクトリに挿入されます。この結果、アプリケーションのクラスローダーによってクラスまたはリソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。 +\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 +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jarGuide.html .LP .LP .na -\f2JAR ファイルの仕様\fP @ +\f2JARファイルの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html .LP .LP .na -\f2JarIndex の仕様\fP @ +\f2JarIndexの仕様\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR_Index +http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR_Index .LP .LP .na -\f2JAR チュートリアル\fP @ +\f2JARチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/deployment/jar/index.html +http://docs.oracle.com/javase/tutorial/deployment/jar/index.html .LP .LP pack200(1)
--- a/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jarsigner 1 "07 May 2011" +.TH jarsigner 1 "21 Mar 2012" .LP .SH "名前" -jarsigner \- JAR 署名および検証ツール +jarsigner \- JAR署名および検証ツール .LP .LP -Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。 +Java ARchive(JAR)ファイルの署名を生成し、署名付きJARファイルの署名を検証します。 .LP .SH "形式" .LP @@ -41,131 +41,131 @@ .LP .LP -jarsigner の \-verify コマンドでは、JAR ファイル名のあとに 0 個以上のキーストア別名を指定できます。キーストア別名が指定された場合、jarsigner は、JAR ファイル内の各署名付きエンティティーの検証に使用される証明書がキーストア別名のいずれかに一致することをチェックします。別名は、\-keystore で指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +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 ファイルが含まれています。 +JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。開発者は、jar(1)という名前のツールを使用してJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\f3jar\fPによって作成されたJARファイル、または\f3jarsigner\fPによって処理されたJARファイルには、META\-INF/MANIFEST.MFファイルが含まれています。) .LP .LP -「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティー (人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。 +\f2デジタル署名\fPは、なんらかのデータ(「署名」の対象となるデータ)と、エンティティ(人、会社など)の秘密鍵とに基づいて計算されるビット列です。手書きの署名同様、デジタル署名には多くの利点があります。 .LP .RS 3 .TP 2 o -署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、デジタル署名が本物かどうかを検証できる +署名の生成に使用された秘密鍵と対になる公開鍵を使用して計算を行うことで、デジタル署名が本物かどうかを検証できます。 .TP 2 o -非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である +秘密鍵が他人に知られない限り、デジタル署名の偽造は不可能です。 .TP 2 o -デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの署名として機能することはない +デジタル署名は、その署名が付いたデータのみを対象とするものであり、他のデータの署名として機能することはありません。 .TP 2 o -署名付きのデータは変更できない。 データが変更された場合は、その署名によってデータが本物ではないことが検証される +署名付きのデータは変更できません。データが変更された場合は、その署名によってデータが本物ではないことが検証されます。 .RE .LP .LP -ファイルに対してエンティティーの署名を生成するには、まず、エンティティーは、そのエンティティーに関連する公開鍵と非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つまたは複数の証明書も必要です。「証明書」とは、あるエンティティーが発行したデジタル署名付きの文書で、別なエンティティーの公開鍵が特定の値であることを証明しています。 +ファイルに対してエンティティの署名を生成するには、まず、エンティティは、そのエンティティに関連する公開鍵と秘密鍵のペアを持つ必要があります。また、公開鍵を認証する1つまたは複数の証明書も必要です。\f2証明書\fPとは、あるエンティティが発行したデジタル署名付きの文書で、別なエンティティの公開鍵が特定の値であることを証明しています。 .LP .LP -\f3jarsigner\fP は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1) ユーティリティーを使います。 +\f3jarsigner\fPは、\f2キーストア\fPに含まれる鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証するためのX.509証明書チェーンが収められたデータベースです。キーストアの作成と管理には、keytool(1)ユーティリティを使用します。 .LP .LP -\f3jarsigner\fP は、エンティティーの非公開鍵を使って署名を生成します。署名付き JAR ファイルには特に、ファイルの署名に使用された非公開鍵に対応する公開鍵に対する、キーストア内の証明書のコピーが含まれています。\f3jarsigner\fP は、署名付き JAR ファイル内 (署名ブロックファイル内) にある証明書を使用してそのファイルのデジタル署名を検証できます。 +\f3jarsigner\fPは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、ファイルの署名に使用された秘密鍵に対応する公開鍵に対する、キーストア内の証明書のコピーなどが含まれています。\f3jarsigner\fPは、署名付きJARファイル内(署名ブロック・ファイル内)にある証明書を使用してそのファイルのデジタル署名を検証できます。 .LP .LP -\f3jarsigner\fP はタイムスタンプを含む署名を生成するので、システムやデプロイヤ (Java Plug\-in を含む) はJAR ファイルが署名証明書の有効期間中に署名されたかどうかをチェックできます。さらに、API を使用すると、アプリケーションからタイムスタンプ情報を取得できます。 +\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 ファイルに署名を付けるときに自動的に作成されます。 +現時点では、\f3jarsigner\fPで署名できるのは、SDKのjar(1)ツールで作成されたJARファイル、またはZIPファイルのみです。(JARファイルはZIPファイルと同じですが、JARファイルにはMETA\-INF/MANIFEST.MFファイルが含まれている点が異なります。このファイルは、\f3jarsigner\fPがZIPファイルに署名を付けるときに自動的に作成されます。) .LP .LP -デフォルトでは、\f3jarsigner\fP は JAR (または ZIP) ファイルに「署名」を付けます。署名付き JAR ファイルを「検証」する場合は、 \f2\-verify\fP オプションを指定します。 +デフォルトでは、\f3jarsigner\fPはJAR(またはZIP)ファイルに\f2署名します\fP。署名付きJARファイルを\f2検証\fPする場合は、\f2\-verify\fPオプションを指定します。 .LP .SS キーストアの別名 .LP .LP -キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。 +キーストアのすべてのエントリは、一意の\f2別名\fPを介してアクセスされます。 .LP .LP -\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、working ディレクトリの mystore という名前のキーストアに含まれる別名 duke に関連付けられた非公開鍵を使って、MyJARFile.jar という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jar は署名付きの JAR ファイルによって上書きされます。 +\f3jarsigner\fPを使用してJARファイルに署名を付けるときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次の例は、workingディレクトリのmystoreという名前のキーストアに含まれる別名dukeに関連付けられた秘密鍵を使用して、MyJARFile.jarという名前のJARファイルに署名を付けます。出力ファイルは指定されていないので、MyJARFile.jarは署名付きのJARファイルによって上書きされます。 .LP .nf \f3 .fl - jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3 + jarsigner \-keystore /working/mystore \-storepass \fP\f4<keystore password>\fP\f3 .fl - \-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 MyJARFile.jar duke + \-keypass \fP\f4<private key password>\fP\f3 MyJARFile.jar duke .fl \fP .fi .LP .LP -キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワードを指定する必要があります。コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。 +キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンドラインでストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンドラインで秘密鍵のパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと違っている場合には、秘密鍵のパスワードの入力を求められます。 .LP .SS キーストアの場所 .LP .LP -\f3jarsigner\fP には、 \f2使用するキーストアの URL を指定する \-keystore\fP があります。キーストア \f2は\fP デフォルトで、 \f2user.home\fP システムプロパティーで決まるユーザーのホームディレクトリの .keystore という名前のファイル内に格納されます。Solaris システムの場合、 \f2user.home\fP のデフォルトはユーザーの home ディレクトリになります。 +\f3jarsigner\fPには、使用するキーストアのURLを指定する\f2\-keystore\fPオプションがあります。キーストアはデフォルトで、\f2user.home\fPシステム・プロパティで決まるユーザーのホーム・ディレクトリの\f2.keystore\fPという名前のファイル内に格納されます。Solarisシステムの場合、\f2user.home\fPのデフォルトはユーザーのhomeディレクトリになります。 .LP .LP -\-keystore オプション \f2に指定した\fP 入力ストリームが \f2KeyStore.load\fP メソッドに渡される点に注意してください。URL として \f2NONE\fP が指定されている場合は、null のストリームが \f2KeyStore.load\fP メソッドに渡されます。 \f2NONE\fP は、 \f2KeyStore\fP がファイルベースではない場合、たとえばそれがハードウェアトークンデバイス上に存在している場合などに指定すべきです。 +\f2\-keystore\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 キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。 +\f2java.security\fPパッケージで提供されている\f2KeyStore\fPクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の\f2タイプ\fPのキーストアを対象とする複数の異なる実装が存在可能です。 .LP .LP -現在、キーストアの実装を使用するものとして、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールがあります。KeyStore \f2は\fP public として使用可能なので、Java 2 SDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。 +現在、キーストアの実装を使用するものとして、\f3keytool\fPと\f3jarsigner\fPの2つのコマンドライン・ツールと、\f3Policy Tool\fPという名前の1つのGUIベースのツールがあります。\f2KeyStore\fPは公開されているので、Java 2 SDKユーザーはKeyStoreを使用する他のセキュリティ・アプリケーションも作成できます。 .LP .LP -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。 +キーストアには、Sun Microsystemsが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .LP .LP -キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP によって提供されるアプリケーションインタフェースが「サービスプロバイダインタフェース」 (SPI) に基づいて実装されます。つまり、対応する抽象クラス \f2KeystoreSpi\fP が同じ \f2java.security\fP パッケージ内に存在しており、このクラスによって、「プロバイダ」が実装する必要のあるサービスプロバイダインタフェースメソッドが定義されています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、 +キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fPによって提供されるアプリケーション・インタフェースが「サービス・プロバイダ・インタフェース」(SPI)に基づいて実装されます。つまり、対応する\f2KeystoreSpi\fP抽象クラス(これも\f2java.security\fPパッケージに含まれています)があり、このクラスが、「プロバイダ」が実装する必要のあるService Provider Interfaceのメソッドを定義しています。(ここで、「プロバイダ」とは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。)したがって、キーストアの実装を提供するには、 .na -\f2「Java 暗号化アーキテクチャー用プロバイダの実装方法」\fP @ +\f2Java暗号化アーキテクチャ用プロバイダの実装方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpiサブクラスの実装を提供する必要があります。 .LP .LP -アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの \f2実装を\fP 選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\f2KeyStore\fPクラスが提供するgetInstanceファクトリ・メソッドを使用することで、様々なプロバイダから異なる\f2タイプ\fPのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .LP .LP -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。 +\f3keytool\fPは、任意のファイルベースのキーストア実装で動作します。(これは、コマンドラインから渡されたキーストアの場所をファイル名として扱い、これをFileInputStreamに変換して、FileInputStreamからキーストアの情報をロードします。)一方、\f3jarsigner\fPツールと\f3policytool\fPツールは、URLで指定可能な任意の場所からキーストアを読み込むことができます。 .LP .LP -\f3jarsigner\fP と \f3keytool\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアのタイプを指定できます。 +\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 のトップレベルディレクトリ) です。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合は、単純にセキュリティ・プロパティ・ファイルで指定された\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 の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。 +各ツールは、\f2keystore.type\fPの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .LP .LP -\f2KeyStore\fP クラスに定義されている static メソッド \f2getDefaultType\fP を使用すると、アプリケーションやアプレットから \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ \f2(keystore.type プロパティーで指定されたタイプ)\fP のインスタンスを生成します。 +\f2KeyStore\fPクラスに定義されているstaticメソッド\f2getDefaultType\fPを使用すると、アプリケーションやアプレットから\f2keystore.type\fPプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\f2keystore.type\fPプロパティで指定されたタイプ)のインスタンスを生成します。 .LP .nf \f3 @@ -177,7 +177,7 @@ .LP .LP -デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプはjks(Sunが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .LP .nf \f3 @@ -189,10 +189,10 @@ .LP .LP -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。 +注意: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKSとjksは同じものとして扱われます。 .LP .LP -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。 +各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、pkcs12と呼ばれるタイプのキーストアの実装を提供しているプロバイダ・パッケージを使用するには、上の行を次のように変更します。 .LP .nf \f3 @@ -204,55 +204,55 @@ .LP .LP -PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」にある +PKCS#11プロバイダ・パッケージを使用する場合の詳細は、Java PKCS#11リファレンス・ガイドにある .na -\f2「KeyTool and JarSigner」\fP @ +\f2KeyToolとJarSigner\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner節を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/p11guide.html#KeyToolJarSignerの項を参照してください。 .LP .SS サポートされるアルゴリズム .LP .LP -\f3jarsigner\fP はデフォルトで、次のいずれかを使用して JAR ファイルに署名します。 +\f3jarsigner\fPはデフォルトで、次のいずれかを使用してJARファイルに署名します。 .LP .RS 3 .TP 2 o -SHA1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム) +SHA1ダイジェスト・アルゴリズムを使用したDSA(デジタル署名アルゴリズム) .TP 2 o -SHA256 ダイジェストアルゴリズムを使用した RSA アルゴリズム +SHA256ダイジェスト・アルゴリズムを使用したRSAアルゴリズム .TP 2 o -SHA256 と ECDSA (楕円曲線デジタル署名アルゴリズム) を使用した EC (楕円曲線) 暗号方式アルゴリズム +SHA256とECDSA(楕円曲線デジタル署名アルゴリズム)を使用したEC(楕円曲線)暗号方式アルゴリズム .RE .LP .LP -具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、\f3jarsigner\fP は SHA1withDSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が RSA 鍵である場合、\f3jarsigner\fP は SHA256withRSA アルゴリズムを使って JAR ファイルに署名を付けます。署名者の鍵が EC 鍵である場合、\f3jarsigner\fP は SHA256withECDSA アルゴリズムを使って JAR ファイルに署名を付けます。 +具体的には、署名者の公開鍵と秘密鍵がDSA鍵である場合、\f3jarsigner\fPはSHA1withDSAアルゴリズムを使用してJARファイルに署名を付けます。署名者の鍵がRSA鍵である場合、\f3jarsigner\fPはSHA256withRSAアルゴリズムを使用してJARファイルに署名を付けます。署名者の鍵がEC鍵である場合、\f3jarsigner\fPはSHA256withECDSAアルゴリズムを使用してJARファイルに署名を付けます。 .LP .LP -これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。 +これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fPオプションを使用してオーバーライドできます。 .LP .SS -署名付き JAR ファイル +署名付きJARファイル .LP .LP -\f3jarsigner\fP を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが META\-INF ディレクトリに置かれる点が異なります。 +\f3jarsigner\fPを使用してJARファイルに署名を付けた場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 .LP .RS 3 .TP 2 o -.SF 拡張子の付いた署名ファイル +.SF拡張子の付いた署名ファイル .TP 2 o -.DSA、.RSA、または .EC を拡張子に持つ署名ブロックファイル +.DSA、.RSAまたは.ECを拡張子の付いた署名ブロック・ファイル .RE .LP .LP -これら 2 つのファイルのベースファイル名は、 \f2\-sigFile\fP オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。 +これら2つのファイルのベース・ファイル名は、\f2\-sigFile\fPオプションの値から作成されます。たとえば、次のようにオプションを指定したとします。 .LP .nf \f3 @@ -264,15 +264,15 @@ .LP .LP -この場合、ファイル名はそれぞれ MKSIGN.SF と MKSIGN.DSA になります。 +この場合、ファイル名はそれぞれMKSIGN.SFとMKSIGN.DSAになります。 .LP .LP -コマンド行で \f2\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。 +コマンドラインで\f2\-sigfile\fPオプションを指定しなかった場合、.SFファイルと.DSAファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線(_)に置き換えてファイル名が作成されます。使用できる文字は、アルファベット、数字、下線(_)、ハイフンです。 .LP -\f3署名 (.SF) ファイル\fP +\f3署名(.SF)ファイル\fP .LP .LP -署名ファイル (.SF ファイル) は、\f3jarsigner\fP で署名を付けた JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、.SF ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。 +署名ファイル(.SFファイル)は、\f3jarsigner\fPで署名を付けたJARファイルに常に含まれるマニフェスト・ファイルと似ています。つまり、マニフェスト・ファイル同様、.SFファイルには、JARファイルに含まれているソース・ファイルごとに、次の3つの行があります。 .LP .RS 3 .TP 2 @@ -280,27 +280,27 @@ ファイル名 .TP 2 o -使われているダイジェストアルゴリズム (SHA) の名前 +使用されているダイジェスト・アルゴリズム(SHA)の名前 .TP 2 o -SHA ダイジェストの値 +SHAダイジェストの値 .RE .LP .LP -マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータのダイジェスト (ハッシュ) です。一方、.SF ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当するソースファイルに対応する 3 行のハッシュです。 +マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。一方、.SFファイルでは、ソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のこれら3行のハッシュになります。 .LP .LP -署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。後述の「JAR ファイルの検証」で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。 +署名ファイルには、デフォルトでマニフェスト・ファイル全体のハッシュが格納されたヘッダーも含まれています。JARファイルの検証で説明するように、このヘッダーの存在によって検証の最適化が可能になっています。 .LP -\f3署名ブロックファイル\fP +\f3署名ブロック・ファイル\fP .LP -.SF ファイルには署名が付けられ、署名は署名ブロックファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。 証明書または証明書チェーンは、署名に使われた非公開鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェストアルゴリズムに応じて .DSA、.RSA、.EC のいずれかになります。 +.SFファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。証明書または証明書チェーンは、署名に使用された秘密鍵に対応する公開鍵を認証します。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて.DSA、.RSA、.ECのいずれかになります。 .SS 署名タイムスタンプ .LP .LP -\f2jarsigner\fP ツールは、JAR ファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、 \f2jarsigner\fP は代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。 +\f2jarsigner\fPツールでは、JARファイルの署名時に署名タイムスタンプを生成して保存できます。さらに、\f2jarsigner\fPは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。 .LP .RS 3 .TP 2 @@ -319,43 +319,47 @@ .LP .LP -これらの各オプションの詳細については、後述の「オプション」節を参照してください。 +これらの各オプションの詳細は、オプションの項を参照してください。 .LP .SS -JAR ファイルの検証 +JARファイルの検証 .LP .LP -JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。 +JARファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後にJARファイル内のどのファイルも変更されていない場合です。JARファイルの検証は、次の手順で行われます。 .LP .RS 3 .TP 3 1. -.SF ファイルそれ自体の署名を検証します。 -.LP -この手順では、各署名ブロック (.DSA) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って生成されたものであることを確認します。 .DSA ファイルには、公開鍵の証明書 (または証明書チェーン) も含まれています。また、この手順では、目的の署名が、対応する署名 (.SF) ファイル内の有効な署名であるかどうかを調べ、.SF ファイルが改変されていないことも確認します。 +.SFファイル自体の署名を検証します。 +.br +.br +この手順では、各署名ブロック(.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 ファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。 +.SFファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突きあわせて検証します。 +.br +.br +.SFファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。このヘッダーが存在する場合は、ヘッダー内のハッシュが実際にマニフェスト・ファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致する場合は、次の手順に検証が進みます。 +.br +.br +ハッシュが一致しない場合は、効率的には劣る方法を使用した検証が必要になります。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかが確認されます(署名(.SF)ファイルを参照)。 +.br +.br +.SFファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュと、実際のマニフェスト・ファイルのハッシュとが一致しない場合は、署名(つまり.SFファイル)の生成後に、JARファイルに1つ以上のファイルが(\f2jar\fPツールを使用して)追加された可能性があります。\f2jar\fPツールを使用してファイルを追加した場合、マニフェスト・ファイルは変更されます(新しいファイル用のセクションが追加されます)が、.SFファイルは変更されません。この場合、.SFファイルのヘッダー以外のセクションに格納されたハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するときは、署名の生成時にJARファイル内に存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功したものとして扱われます。 .TP 3 3. -JAR ファイル内のファイルのうち、.SF ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルのダイジェストを計算し、結果をマニフェストセクション内の該当するファイルのダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない場合は検証が失敗します。 +JARファイル内のファイルのうち、.SFファイル内にエントリを持つ各ファイルを読み込みます。読込み中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内の該当するファイルのダイジェストと比較します。2つのダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 .RE .LP .LP -検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティー例外がスローされます。スローされたセキュリティー例外は、\f3jarsigner\fP がキャッチして表示します。 +検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティ例外がスローされます。例外は、\f3jarsigner\fPがキャッチして表示します。 .LP .SS -1 つの JAR ファイルを対象とする複数の署名 +1つのJARファイルを対象とする複数の署名 .LP .LP -1 つの JAR ファイルに対して \f3jarsigner\fP ツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JAR ファイルに複数のユーザーの署名を付けることができます。 +1つのJARファイルに対して\f3jarsigner\fPツールを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JARファイルに複数のユーザーの署名を付けることができます。 .LP .nf \f3 @@ -369,7 +373,7 @@ .LP .LP -JAR ファイルが複数回署名されている場合、その JAR ファイルには .SF ファイルと .DSA ファイルの対が複数含まれることになります。 .SF ファイルと .DSA ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力される JAR ファイルには、次の名前を持つファイルが含まれます。 +JARファイルが複数回署名されている場合、そのJARファイルには.SFファイルと.DSAファイルのペアが複数含まれることになります。.SFファイルと.DSAファイルのペアは、1回の署名に対して1つ作成されます。したがって、上の例で出力されるJARファイルには、次の名前を持つファイルが含まれます。 .LP .nf \f3 @@ -387,39 +391,42 @@ .LP .LP -注: JAR ファイルでは、JDK 1.1 の \f3javakey\fP ツールで生成された署名と \f3jarsigner\fP で生成された署名が混在できます。つまり、すでに \f3javakey\fP を使って署名が付けられている JAR ファイルに、\f3jarsigner\fP を使って署名を付けることができます。 +注意: JARファイルでは、JDK 1.1の\f3javakey\fPツールで生成された署名と\f3jarsigner\fPで生成された署名が混在できます。つまり、すでに\f3javakey\fPを使用して署名が付けられているJARファイルに、\f3jarsigner\fPを使用して署名を付けることができます。 .LP .SH "オプション" .LP .LP -以下では、\f3jarsigner\fP のオプションについて説明します。注: +次に、\f3jarsigner\fPのオプションについて説明します。注意: .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 ファイルに署名を付ける場合だけである +\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 として扱われます。たとえば、次のように指定できます。 +キーストアの場所を示すURLを指定します。デフォルトは、ユーザーのホーム・ディレクトリ内のファイル\f2.keystore\fPです。ユーザーのホーム・ディレクトリは、user.homeシステム・プロパティによって決まります。 +.br +.br +署名するときはキーストアが必要です。このため、デフォルトのキーストアが存在しない場合(またはデフォルト以外のキーストアを使用する場合)は、キーストアを明示的に指定する必要があります。 +.br +.br +検証するときはキーストアは\f2必要ありません\fP。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\f2\-verbose\fPオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 +.br +.br +注意: \f2\-keystore\fPの引数には、URLのかわりにファイル名(とパス)を指定できます。ファイル名(とパス)を指定した場合は、「file:」URLとして扱われます。次に例を示します。 .nf \f3 .fl @@ -427,7 +434,6 @@ .fl \fP .fi -.LP これは、次の指定と同じものとして扱われます。 .nf \f3 @@ -436,8 +442,7 @@ .fl \fP .fi -.LP -JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティープロパティーファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。 +JREの\f2$JAVA_HOME/lib/security\fPディレクトリに格納された\f2java.security\fPセキュリティ・プロパティ・ファイル内でSun PKCS#11プロバイダが構成されている場合、keytoolとjarsignerはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 .RS 3 .TP 2 o @@ -446,135 +451,141 @@ o \f2\-storetype PKCS11\fP .RE -.LP -たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。 +たとえば、次のコマンドは、構成された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 オプションを指定する必要がありますが、パスワードオプションを指定する必要はありません。 +インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内のkeystore.typeプロパティの値で指定されたタイプです。この値は、\f2java.security.KeyStore\fPのstatic \f2getDefaultType\fPメソッドによって返されます。 +.br +.br +\f2\-storepass\fPオプションを使用してPCKS#11トークンのPINを指定することもできます。何も指定しなかった場合、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 になります。それ以外の場合、パスワードは次のようにして取得されます。 +キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\f2\-storepass\fPオプションをコマンドラインで指定しないと、パスワードの入力を求められます。 +.br +.br +修飾子\f2env\fPまたは\f2file\fPが指定されていない場合、パスワードの値は\f2argument\fPになります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する +\f2file\fP: \f2argument\fPという名前のファイルからパスワードを取得します。 .RE -.LP -注: テストを目的とする場合、またはセキュリティー保護されたシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 +注意: テストを目的とする場合、またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 .TP 3 \-keypass[:env | :file] argument -.LP -コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するのに使うパスワードを指定します。\f3jarsigner\fP を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 -.LP -修飾子 \f2env\fP または \f2file\fP が指定されていない場合、パスワードの値は \f2argument\fP になります。それ以外の場合、パスワードは次のようにして取得されます。 +コマンドラインで指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\f3jarsigner\fPを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンドラインでパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 +.br +.br +修飾子\f2env\fPまたは\f2file\fPが指定されていない場合、パスワードの値は\f2argument\fPになります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\fP という名前のファイルからパスワードを取得する +\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\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。 +.SFファイルと .DSAファイルの生成に使用するベース・ファイル名を指定します。たとえば、\f2file\fPにDUKESIGNを指定すると、生成される.SFファイルと.DSAファイルの名前は、それぞれDUKESIGN.SFとDUKESIGN.DSAになります。これらのファイルは、署名付きJARファイルのMETA\-INFディレクトリに置かれます。 +.br +.br +\f2file\fPに使用できる文字は「a\-zA\-Z0\-9_\-」です。つまり、文字、数字、下線およびハイフンのみを使用できます。注意: .SFおよび.DSAのファイル名では、小文字はすべて大文字に変換されます。 +.br +.br +コマンドラインで\f2\-sigfile\fPオプションを指定しなかった場合、.SFファイルと.DSAファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線(_)に置き換えてファイル名が作成されます。 .TP 3 \-sigalg algorithm -JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。 -.LP -標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」にある +JARファイルの署名に使用する署名アルゴリズムの名前を指定します。 +.br +.br +標準署名アルゴリズム名の一覧は、Java暗号化アーキテクチャの .na -\f2「Appendix A 」\fP @ +\f2付録A\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、SHA256withRSA、SHA256withECDSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しなかった場合、秘密鍵のタイプに応じてSHA1withDSA、SHA256withRSA、SHA256withECDSAのいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\f2\-providerClass\fPオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドの実行が失敗します。 .TP 3 \-digestalg algorithm -JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。 -.LP -標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」にある +JARファイルのエントリをダイジェストする際に使用するメッセージ・ダイジェスト・アルゴリズムの名前を指定します。 +.br +.br +メッセージ・ダイジェスト・アルゴリズム名の一覧は、Java暗号化アーキテクチャの .na -\f2「Appendix A 」\fP @ +\f2付録A\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザーがそのようなプロバイダを \f2\-providerClass\fP オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。このオプションを指定しなかった場合、SHA256が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\f2\-providerClass\fPオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドの実行が失敗します。 .TP 3 \-signedjar file -署名付き JAR ファイルの名前を指定します。 -.LP -コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる JAR ファイル) の名前と同じ名前が使われます。 この場合、入力 JAR ファイルは署名付き JAR ファイルによって上書きされます。 +署名付きJARファイルの名前を指定します。 +.br +.br +コマンドラインで名前を指定しなかった場合は、入力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 ファイルの検証」を参照してください。 +コマンドラインでこのオプションが指定されている場合は、指定されたJARファイルの署名ではなく検証が行われます。検証が成功すると、「jarが検証されました。」というメッセージが表示されます。署名されていないJARファイル、またはサポートされていないアルゴリズム(RSAプロバイダのインストールを終了していない場合のRSAなど)を使用して署名されたJARファイルを検証しようとすると、「jarは署名されていません。(署名が見つからないか、構文解析できません)」というメッセージが表示されます。 +.br +.br +署名付きJARファイルは、\f3jarsigner\fPまたはJDK 1.1の\f3javakey\fPツールのどちらかまたは両方を使用して検証できます。 +.br +.br +検証の詳細は、JARファイルの検証を参照してください。 .TP 3 \-certs -コマンド行で、 \f2\-verify\fP および \f2\-verbose\fP オプションとともにこのオプションを指定した場合、JAR ファイルの各署名者の証明書情報が出力に含まれます。証明書情報には次のものが含まれます。 +コマンドラインで、\f2\-verify\fPおよび\f2\-verbose\fPオプションとともにこのオプションを指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には次のものが含まれます。 .RS 3 .TP 2 o -署名者の公開鍵を証明する (.DSA ファイルに格納された) 証明書の種類の名前 +署名者の公開鍵を証明する(.DSAファイルに格納された)証明書タイプの名前 .TP 2 o -証明書が X. 証明書 (つまり、 \f2java.security.cert.X509Certificate\fP のインスタンス) である場合は、署名者の識別名 +証明書がX.509証明書(つまり、\f2java.security.cert.X509Certificate\fPのインスタンス)である場合は、署名者の識別名 .RE -.LP -キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストアファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。 +キーストアの確認も行われます。コマンドラインでキーストアの値が指定されていない場合、デフォルトのキーストア・ファイルがあれば、検査されます。署名者の公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示されます。 .RS 3 .TP 2 o -署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。 ただし、キーストアではなく JDK 1.1 のアイデンティティーデータベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。 +署名者に該当するキーストア・エントリの別名。この別名は括弧で囲まれます。ただし、キーストアではなくJDK 1.1のアイデンティティ・データベースに由来する署名者の場合は、括弧ではなく大括弧で囲まれます。 .RE .TP 3 \-certchain file -コマンド行で指定した別名で決まるキーストアエントリの非公開鍵に関連付けられた証明書チェーンが完全でない場合に、使用すべき証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェアトークン上に格納されているが、そこには証明書チェーンの全体を保持できるだけの領域が存在していないような場合です。このファイルは一連の X.509 証明書が順に連結されたもの、PKCS#7 形式の単一データブロックのいずれかとなり、そのエンコーディング形式はバイナリエンコーディング形式、Internet RFC 1421 標準で規定される印刷可能エンコーディング形式 (BASE64 エンコーディングとも呼ばれる) のいずれかになります。 +コマンドラインで指定した別名で決まるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全でない場合に、使用する証明書チェーンを指定します。そのような状態になる可能性があるのは、キーストアがハードウェア・トークン上に格納されているが、そこには証明書チェーンの全体を保持できる領域が存在していないような場合です。このファイルは一連のX.509証明書が順に連結されたもの、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(BASE64エンコーディングとも呼ばれる)のいずれかになります。 .TP 3 \-verbose -コマンド行でこのオプションが指定されている場合、\f3jarsigner\fP は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出力します。 +コマンドラインでこのオプションが指定されている場合、\f3jarsigner\fPは「冗長」モードで動作し、JARの署名または検証の進行状況に関する追加情報を出力します。 .TP 3 \-internalsf -以前は、JAR ファイルの署名時に生成された .DSA (署名ブロック) ファイルの中に、生成された .SF ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この動作は変更されました。この動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、デフォルトでは .SF ファイルが .DSA ファイルに含まれないようになっています。ただし、 \f2\-internalsf\fP オプションをコマンド行で指定すると、以前と同じように動作します。\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。 このオプションを使用すると、有益な最適化が行われなくなります。\fP +以前は、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 +コマンドラインでこのオプションが指定されている場合、JARファイルの署名時に生成される.SFファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは\f2含まれません\fP。この場合、.SFファイルに含まれるのは、JARファイル内の各ソース・ファイルに関する情報およびハッシュのみです。詳細は、署名(.SF)ファイルを参照してください。 +.br +.br +デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合は、JARファイルの検証時に、まずヘッダー内のハッシュが、マニフェスト・ファイル全体のハッシュと実際に一致するかどうかが確認されます。一致する場合、検証は次の手順に進みます。ハッシュが一致しない場合は、効率的には劣る方法を使用して検証する必要があります。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかが確認されます。 +.br +.br +詳細は、JARファイルの検証を参照してください。 +.br +.br +\f3このオプションは、テストを行う場合には便利ですが、それ以外には使用しないでください。このオプションを使用すると、有益な最適化が行われなくなります。\fP .TP 3 \-protected -\f2true\fP または \f2false\fP。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値を \f2true\fP に指定してください。 +\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 キーストアを一覧表示するコマンドの例を次に示します。 +サービス・プロバイダがセキュリティ・プロパティ・ファイル(\f2java.security\fP)のリストに入っていないときに、暗号化サービス・プロバイダのマスター・クラス・ファイルの名前を指定するために使用します。 +.br +.br +\f2\-providerArg\fP \f2ConfigFilePath\fPオプションと組み合せて使用します。keytoolとjarsignerはプロバイダを動的にインストールします(ここで、\f2ConfigFilePath\fPはトークン構成ファイルへのパスです)。セキュリティ・プロパティ・ファイル内でSun PKCS#11プロバイダが構成されていない場合にPKCS#11キーストアを一覧表示するコマンドの例を次に示します。 .nf \f3 .fl @@ -590,13 +601,14 @@ .fi .TP 3 \-providerName providerName -\f2java.security\fP セキュリティープロパティーファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前です。 -.LP -Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP という形式になります。 ここで「\f2TokenName\fP」は、プロバイダインスタンスが構成された名前の接尾辞です。 詳細は +\f2java.security\fPセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成されている場合、\f2\-providerName\fPオプションを使用して特定のプロバイダ・インスタンスを選択できます。このオプションの引数は、プロバイダの名前です。 +.br +.br +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 キーストアプロバイダインスタンスの内容をリストします。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/p11guide.html#ATTRSを参照してください。たとえば、次のコマンドは、名前接尾辞\f2SmartCard\fPのPKCS#11キーストア・プロバイダ・インスタンスの内容をリストします。 .nf \f3 .fl @@ -609,38 +621,39 @@ \fP .fi .TP 3 -できますjavaoption -指定された \f2javaoption\fP 文字列を Java インタプリタに直接渡します。\f3jarsigner\fP は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。使用可能なインタプリタオプションの一覧を表示するには、 \f2java \-h\fP または \f2java \-X\fP とコマンド行から入力します。 -.LP +\-Jjavaoption +指定された\f2javaoption\fP文字列をJavaインタプリタに直接渡します。(\f3jarsigner\fPは、実際にはJavaインタプリタに対する「ラッパー」です。)このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\f2java \-h\fPまたは\f2java \-X\fPと入力してください。 .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 は、 +\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の公開鍵証明書をキーストアに配置する必要はありません。 +.br +.br +タイムスタンプを生成するために、\f2jarsigner\fPは、 .na \f2RFC 3161\fP @ .fi -http://www.ietf.org/rfc/rfc3161.txt で定義されている タイムスタンププロトコル (TSP) を使用して TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンは署名ブロックファイルの署名とともに保存されます。 -.LP +http://www.ietf.org/rfc/rfc3161.txtで定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAから返されたタイムスタンプ・トークンは署名ブロック・ファイルの署名とともに保存されます。 .TP 3 \-tsacert alias -\f2「\-tsacert alias」\fP が JAR ファイルの署名時にコマンド行に表示される場合、署名のタイムスタンプが生成されます。 \f2alias\fP は、キーストア内の現在有効な TSA の公開鍵証明書を特定します。エントリの証明書で、TSA の場所を特定する URL を含む Subject Information Access 拡張機能が確認されます。 -.LP -TSA の公開鍵証明書は、 \f2\-tsacert を使った場合、キーストアに配置されている必要があります。\fP. -.LP +\f2「\-tsacert alias」\fPがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。\f2alias\fPは、キーストア内の現在有効なTSAの公開鍵証明書を示しています。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 +.br +.br +\f2\-tsacert\fPを使用した場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 .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 +代替署名機構を使用することを指定します。完全修飾クラス名で、\f2com.sun.jarsigner.ContentSigner\fP抽象クラスを拡張するクラス・ファイルを指定します。このクラス・ファイルへのパスは、\f2\-altsignerpath\fPオプションによって定義されます。\f2\-altsigner\fPオプションが使用されると、\f2jarsigner\fPは、指定されたクラスが提供する署名機構を使用します。それ以外の場合、\f2jarsigner\fPはデフォルトの署名機構を使用します。 +.br +.br +たとえば、\f2com.sun.sun.jarsigner.AuthSigner\fPという名前のクラスが提供する署名機構を使用するには、\f2jarsigner\fPで\f2「\-altsigner com.sun.jarsigner.AuthSigner」\fPというオプションを使用します。 .TP 3 \-altsignerpath classpathlist -クラスファイル (そのクラスファイル名は前述の \f2\-altsigner\fP オプションで指定される) およびそのクラスが依存するすべての JAR ファイルへのパスを指定します。クラスファイルが JAR ファイル内にある場合、以下の例のように JAR ファイルへのパスが指定されます。 -.LP -絶対パスまたは現在のディレクトリからの相対パスを指定できます。 \f2classpathlist\fP に複数のパスや JAR ファイルが含まれる場合には、それらを Solaris の場合はコロン (\f2:\fP) で、Windows の場合はセミコロン (\f2;\fP) でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 -.LP -クラスファイルを含む、JAR ファイルへのパスを指定する例を示します。 +クラス・ファイル(クラス・ファイル名は前述の\f2\-altsigner\fPオプションで指定します)およびそのクラスが依存するすべてのJARファイルへのパスを指定します。クラス・ファイルがJARファイル内にある場合、以下の例のようにJARファイルへのパスが指定されます。 +.br +.br +絶対パスまたは現在のディレクトリからの相対パスを指定できます。\f2classpathlist\fPに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(\f2:\fP)で、Windowsの場合はセミコロン(\f2;\fP)でそれぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 +.br +.br +クラス・ファイルを含む、JARファイルへのパスを指定する例を示します。 .nf \f3 .fl @@ -648,10 +661,10 @@ .fl \fP .fi -.LP -JAR ファイル名が含まれていることに注意してください。 -.LP -クラスファイルを含む JAR ファイルへのパスを指定する例を示します。 +JARファイル名が含まれていることに注意してください。 +.br +.br +クラス・ファイルを含むJARファイルへのパスを指定する例を示します。 .nf \f3 .fl @@ -659,41 +672,40 @@ .fl \fP .fi -.LP -JAR ファイル名は含まれていないことに留意してください。 +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 つのエントリ (およびそれ以上)」として要約されて表示されます。詳細は例の項を参照してください。 +検証処理の場合、表示する情報の量を決定するサブオプションを\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 ファイルの署名 +JARファイルの署名 .LP .LP -bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。 +bundle.jarという名前のJARファイルがあるとします。このファイルに、workingというディレクトリのmystoreというキーストアにあるキーストアの別名がjaneであるユーザーの秘密鍵を使用して、署名を付けるとします。次のコマンドを実行すると、JARファイルに署名を付けてsbundle.jarという署名付きJARファイルを作成できます。 .LP .nf \f3 .fl - jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3 + jarsigner \-keystore /working/mystore \-storepass \fP\f4<keystore password>\fP\f3 .fl - \-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 \-signedjar sbundle.jar bundle.jar jane + \-keypass \fP\f4<private key password>\fP\f3 \-signedjar sbundle.jar bundle.jar jane .fl \fP .fi .LP .LP -上のコマンドでは \f2\-sigfile\fP が指定されていないため、署名付き JAR ファイルに格納される .SF ファイルと .DSA ファイルの名前は、別名からデフォルト名がつけられます。つまり、それらの名前は \f2JANE.SF\fP および \f2JANE.DSA\fP になります。 +上のコマンドでは\f2\-sigfile\fPが指定されていないため、署名付きJARファイルに格納される.SFファイルと.DSAファイルの名前は、別名からデフォルト名が付けられます。つまり、それらの名前は\f2JANE.SF\fPおよび\f2JANE.DSA\fPになります。 .LP .LP -ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、上のコマンドを短縮して次のように入力できます。 +ストアのパスワードと秘密鍵のパスワードの入力を求めるプロンプトを表示する場合は、上のコマンドを短縮して次のように入力できます。 .LP .nf \f3 @@ -707,7 +719,7 @@ .LP .LP -デフォルトのキーストア (ホームディレクトリ内の .keystore という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を省略できます。 +デフォルトのキーストア(ホーム・ディレクトリ内の.keystoreという名前のキーストア)を使用する場合は、次に示すように、キーストアの指定を省略できます。 .LP .nf \f3 @@ -719,7 +731,7 @@ .LP .LP -最後に、入力 JAR ファイル (\f2bundle.jar\fP) を署名付き JAR ファイルで単純に上書きする場合は、次のように \f2\-signedjar\fP オプションを指定する必要はありません。 +最後に、入力JARファイル(\f2bundle.jar\fP)を署名付きJARファイルで単純に上書きする場合は、次のように\f2\-signedjar\fPオプションを指定する必要はありません。 .LP .nf \f3 @@ -731,10 +743,10 @@ .LP .SS -署名付き JAR ファイルの検証 +署名付きJARファイルの検証 .LP .LP -次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが改変されていないことを確認するためのコマンド例です。 +署名付きJARファイルを検証する、つまり署名が有効でJARファイルが改変されていないことを確認するには、次のようなコマンドを入力します。 .LP .nf \f3 @@ -746,7 +758,7 @@ .LP .LP -検証が成功すると、次のようなメッセージが表示されます。 +検証が成功すると、 .LP .nf \f3 @@ -758,10 +770,10 @@ .LP .LP -というプロンプトが表示されます。検証が成功しなかった場合は、エラーメッセージが表示されます。 +と表示されます。それ以外の場合は、エラー・メッセージが表示されます。 .LP .LP -\-verbose オプションを使うと、 \f2より多くの情報が\fP 表示されます。\-verbose オプション付きで \f3jarsigner\fP \f2を使用する例とその出力例を、\fP 次に示します。 +\f2\-verbose\fPオプションを使用すると、より多くの情報が表示されます。\f2\-verbose\fPオプション付きで\f3jarsigner\fPを使用する例とその出力例を、次に示します。 .LP .nf \f3 @@ -782,25 +794,25 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .SS -証明書情報を使った検証 +証明書情報を使用した検証 .LP .LP -検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 および JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。たとえば、 +検証時に\f2\-verify\fPと\f2\-verbose\fPオプションに加えて\f2\-certs\fPオプションを指定した場合は、JARファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報(X.509証明書の場合のみ)、およびJARファイルの公開鍵の証明書がキーストア・エントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。次に示します。 .LP .nf \f3 @@ -829,22 +841,22 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .LP -署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の場合は、次のように表示されます。 +署名者の証明書がX.509証明書でない場合は、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名がbobの場合は、次のように表示されます。 .LP .nf \f3 @@ -856,13 +868,13 @@ .LP .SS -アイデンティティーデータベースの署名者を含む JAR ファイルの検証 +アイデンティティ・データベースの署名者を含むJARファイルの検証 .LP .LP -JAR ファイルが、JDK 1.1 の \f3javakey\fP ツールを使って署名されている場合、署名者はアイデンティティーデータベース内の別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、アイデンティティーデータベース内の別名とキーストア内の別名の両方によって署名されている場合は、k と i の両方が表示されます。 +JARファイルが、JDK 1.1の\f3javakey\fPツールを使用して署名されている場合、署名者はアイデンティティ・データベース内の別名です。この場合、検証の出力には「i」という記号が含まれます。JARファイルが、アイデンティティ・データベース内の別名とキーストア内の別名の両方によって署名されている場合は、「k」と「i」の両方が表示されます。 .LP .LP -\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。次に例を示します。 +\f2\-certs\fPオプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティ・データベース内の別名は角括弧で囲まれて表示されます。次に例を示します。 .LP .nf \f3 @@ -891,92 +903,92 @@ .fl .fl - s = 署名が検証されました + s = signature was verified .fl - m = マニフェストにエントリが記載されています + m = entry is listed in manifest .fl - k = キーストアで 1 つ以上の証明書が見つかりました + k = at least one certificate was found in keystore .fl - i = アイデンティティースコープで 1 つ以上の証明書が見つかりました + i = at least one certificate was found in identity scope .fl .fl - JAR が検証されました。 + jar verified. .fl \fP .fi .LP .LP -別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティーデータベースの別名です。 +別名dukeは角括弧で囲まれているので、この別名はキーストアの別名ではなく、アイデンティティ・データベースの別名です。 .LP .SH "警告" .LP -署名/検証処理中には、jarsigner からさまざまな警告が表示される可能性があります。これらの警告コードは次のように定義されています。 +署名/検証処理中には、jarsignerから様々な警告が表示される可能性があります。これらの警告コードは次のように定義されています。 .nf \f3 .fl hasExpiringCert 2 .fl - この JAR に含まれるエントリの署名者の証明書が 6 か月以内に期限切れになります + This jar contains entries whose signer certificate will expire within six months .fl .fl hasExpiredCert 4 .fl - この JAR に含まれるエントリの署名者の証明書が期限切れになっています。 + This jar contains entries whose signer certificate has expired. .fl .fl notYetValidCert 4 .fl - この JAR に含まれるエントリの署名者の証明書がまだ有効になっていません。 + This jar contains entries whose signer certificate is not yet valid. .fl .fl chainNotValidated 4 .fl - この JAR に含まれるエントリの証明書チェーンの検証を正しく行えません。 + This jar contains entries whose certificate chain cannot be correctly validated. .fl .fl - badKeyUsa ge 8 + badKeyUsage 8 .fl - この JAR に含まれるエントリの署名者の証明書の KeyUsage 拡張がコードの署名を許可していません。 + This jar contains entries whose signer certificate's KeyUsage extension doesn't allow code signing. .fl .fl badExtendedKeyUsage 8 .fl - この JAR に含まれるエントリの署名者の証明書の ExtendedKeyUsage 拡張が + This jar contains entries whose signer certificate's ExtendedKeyUsage extension .fl - コードの署名を許可していません。 + doesn't allow code signing. .fl .fl badNetscapeCertType 8 .fl - この JAR に含まれるエントリの署名者の証明書の NetscapeCertType 拡張が + This jar contains entries whose signer certificate's NetscapeCertType extension .fl - コードの署名を許可していません。 + doesn't allow code signing. .fl .fl hasUnsignedEntry 16 .fl - この JAR には、完全性チェックが行われていない署名なしエントリが含まれています。 + This jar contains unsigned entries which have not been integrity\-checked. .fl .fl notSignedByAlias 32 .fl - この JAR には、指定された別名によって署名されていない署名付きエントリが含まれています + This jar contains signed entries which are not signed by the specified alias(es) .fl .fl aliasNotInStore 32 .fl - この JAR には、このキーストアの別名によって署名されていない署名付きエントリが含まれています + This jar contains signed entries that are not signed by alias in this keystore .fl .fl @@ -985,10 +997,10 @@ .LP .LP -\f2\-strict\fP オプションを指定した場合、検出された警告の OR を取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書の keyUsage 拡張でファイルの署名が許可されていない場合、終了コード 12 (=4+8) が返されます。 +\f2\-strict\fPオプションを指定した場合、検出された警告のORを取った値がツールの終了コードとして返されます。たとえば、エントリの署名に使用される証明書が期限切れになっていて、かつその証明書のkeyUsage拡張でファイルの署名が許可されていない場合、終了コード12(=4+8)が返されます。 .LP .LP -\f3注\fP: UNIX で使用可能な値は 0 から 255 だけであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。 +\f3注意\fP: UNIXで使用可能な値は0から255のみであるため、終了コードは再利用されます。いずれにしても、署名/検証処理が失敗すると、次の終了コードが返されます。 .LP .nf \f3 @@ -1000,29 +1012,29 @@ .LP .SS -JDK 1.1 との互換性 +JDK 1.1との互換性 .LP .LP -\f3keytool\fP ツールと \f3jarsigner\fP ツールは、JDK 1.1 で提供されていた \f3javakey\fP ツールを完全に置き換えるものです。これらの新しいツールは、キーストアと非公開鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fP より多くのを機能を備えています。 +\f3keytool\fPツールと\f3jarsigner\fPツールは、JDK 1.1で提供されていた\f3javakey\fPツールを完全に置き換えるものです。これらの新しいツールは、キーストアと秘密鍵をパスワードで保護する機能や、署名の生成に加えて署名を検証する機能など、\f3javakey\fPより多くのを機能を備えています。 .LP .LP -新しいキーストアアーキテクチャーは、\f3javakey\fP が作成して管理していたアイデンティティーデータベースに代わるものです。キーストア形式と、JDK 1.1 の \f3javakey\fP が使っていたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。 +新しいキーストア・アーキテクチャは、\f3javakey\fPが作成して管理していたアイデンティティ・データベースに代わるものです。キーストア形式と、1.1の\f3javakey\fPが使用していたデータベース形式との間には下位互換性はありません。ただし、次のことは可能です。 .LP .RS 3 .TP 2 o -\f3keytool\fP の \f2\-identitydb\fP コマンドを使うと、アイデンティティーデータベースの情報をキーストアにインポートできます。 +\f3keytool\fPの\f2\-identitydb\fPコマンドを使用すると、アイデンティティ・データベースの情報をキーストアにインポートできます。 .TP 2 o -\f3jarsigner\fP は、以前に \f3javakey\fP を使って署名された JAR ファイルに署名を付けることができます。 +\f3jarsigner\fPは、以前に\f3javakey\fPを使用して署名されたJARファイルに署名を付けることができます。 .TP 2 o -\f3jarsigner\fP は、\f3javakey\fPを使って署名された JAR ファイルを検証できます。したがって、jarsigner は、Java 2 SDK のキーストアではなく JDK 1.1 のアイデンティティーデータベースからの署名者別名を認識し、これらを対象に処理を行うことができます。 +\f3jarsigner\fPは、\f3javakey\fPを使用して署名されたJARファイルを検証できます。したがって、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 @@ -1053,7 +1065,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 @@ -1069,7 +1081,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 @@ -1085,7 +1097,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 @@ -1101,7 +1113,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 @@ -1117,7 +1129,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr e| \n(dn @@ -1133,7 +1145,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr f| \n(dn @@ -1149,7 +1161,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権 +すべてのコードに付与されるデフォルトの特権 .br .di .nr g| \n(dn @@ -1165,7 +1177,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(81 .ll \n(81u .in 0 -あり/信頼できない +はい/信頼できない .br .di .nr h| \n(dn @@ -1181,7 +1193,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権(3) +すべてのコードに付与されるデフォルトの特権(3) .br .di .nr i| \n(dn @@ -1197,7 +1209,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(81 .ll \n(81u .in 0 -あり/信頼できない +はい/信頼できない .br .di .nr j| \n(dn @@ -1213,7 +1225,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 @@ -1229,7 +1241,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権 +すべてのコードに付与されるデフォルトの特権とポリシー・ファイル内で付与される特権 .br .di .nr l| \n(dn @@ -1245,7 +1257,7 @@ .ll \n(34u*1u/6u .if \n(.l<\n(84 .ll \n(84u .in 0 -すべてのコードに与えられるデフォルトの特権とポリシーファイル内で与えられる特権(2) +すべてのコードに付与されるデフォルトの特権とポリシー・ファイル内で付与される特権(2) .br .di .nr m| \n(dn @@ -1256,46 +1268,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 @@ -1306,63 +1318,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すべての特権 .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 @@ -1396,7 +1408,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 1078 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1090 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1421,7 +1433,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 @@ -1458,7 +1470,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 @@ -1474,7 +1486,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 @@ -1490,7 +1502,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 @@ -1508,7 +1520,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 @@ -1533,7 +1545,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 @@ -1556,7 +1568,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 @@ -1572,7 +1584,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 @@ -1586,15 +1598,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 @@ -1617,21 +1629,21 @@ .LP .LP -注 \- +注意: .LP .RS 3 .TP 3 1. -ポリシーファイル内にアイデンティティー/別名についての言及がある場合、それをキーストアにインポートして、ポリシーファイルの設定が与えられた特権に反映されるようにする必要があります。 +ポリシー・ファイル内にアイデンティティ/別名についての言及がある場合、それをキーストアにインポートして、付与された特権にポリシー・ファイルの設定が反映されるようにする必要があります。 .TP 3 2. -ポリシーファイル/キーストアの組み合わせは、アイデンティティーデータベース内の信頼できるアイデンティティーよりも優先されます。 +ポリシー・ファイル/キーストアの組合せは、アイデンティティ・データベース内の信頼できるアイデンティティよりも優先されます。 .TP 3 3. -Java 2 プラットフォームでは、信頼できないアイデンティティーは無視されます。 +Java 2プラットフォームでは、信頼できないアイデンティティは無視されます。 .TP 3 4. -Java 2 SDK キーストアにインポートできるのは、信頼できるアイデンティティーだけです。 +Java 2 SDKキーストアにインポートできるのは、信頼できるアイデンティティのみです。 .RE .LP @@ -1640,20 +1652,21 @@ .RS 3 .TP 2 o -jar(1) ツールのドキュメント +jar(1)ツールのドキュメント .TP 2 o -keytool(1) ツールのドキュメント +keytool(1)ツールのドキュメント .TP 2 o +\f3jarsigner\fPツールの使用例は、 .na -\f4jarsigner\fP\f2 ツールの使用例については、\fP @ +\f4Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/security/index.html +http://docs.oracle.com/javase/tutorial/index.htmlの .na -\f2「Java チュートリアル」\fP\f4の\fP @ +\f4セキュリティ\fP @ .fi -http://download.oracle.com/javase/tutorial/index.html「Security」\f3を参照\fP +http://docs.oracle.com/javase/tutorial/security/index.htmlを参照 .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/java.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/java.1 Mon Apr 16 11:16:28 2012 -0700 @@ -1,4 +1,4 @@ -." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved. +." Copyright (c) 1994, 2012, 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,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH java 1 "07 May 2011" +.TH java 1 "01 Apr 2012" .LP .SH "名前" -java \- Java アプリケーション起動ツール +java \- Javaアプリケーション起動ツール .LP .RS 3 .TP 2 @@ -56,26 +56,26 @@ .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 .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 @@ -87,13 +87,13 @@ .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 @@ -105,85 +105,115 @@ .RS 3 .TP 3 \-client -.LP -Java HotSpot Client VM を選択します。64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。 -.LP -デフォルトの VM の選択については、 +Java HotSpot Client VMを選択します。64ビット対応JDKは現時点では、このオプションを無視し、かわりにJava Hotspot Server VMを使用します。 +.br +.br +デフォルトのVMの選択については、 .na -\f2「サーバー \- クラスマシンの検出」\fP @ +\f2サーバー \- クラス・マシンの検出\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/server\-class.htmlを参照してください。 .TP 3 \-server -.LP -Java HotSpot Server VM を選択します。64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。 -.LP -デフォルトの VM の選択については、 +Java HotSpot Server VMを選択します。64ビット対応JDK上では、サポートされるのはJava Hotspot Server VMのみであるため、\-serverオプションが暗黙的に選択されます。 +.br +.br +デフォルトのVMの選択については、 .na -\f2「サーバー \- クラスマシンの検出」\fP @ +\f2サーバー \- クラス・マシンの検出\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/server\-class.htmlを参照してください。 .TP 3 \-agentlib:libname[=options] -ネイティブエージェントライブラリ \f2libname\fP をロードします。たとえば次のように指定します。 -.LP -\-agentlib:hprof -.LP -\-agentlib:jdwp=help -.LP -\-agentlib:hprof=help -.LP -詳細については、 +ネイティブ・エージェント・ライブラリ\f2libname\fPをロードします。たとえば次のように指定します。 +.br +.br +\-agentlib:hprof +.br +.br +\-agentlib:jdwp=help +.br +.br +\-agentlib:hprof=help +.br +.br +詳細は、 .na -\f2「JVMTI エージェントのコマンド行オプション」\fP @ +\f2JVMTIエージェントのコマンドライン・オプション\fP @ .fi -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。 +http://download.oracle.com/javase/7/docs/platform/jvmti/jvmti.html#startingを参照してください。 .TP 3 \-agentpath:pathname[=options] -フルパス名を使用して、ネーティブエージェントライブラリをロードします。詳細については、 +フルパス名を使用して、ネーティブ・エージェント・ライブラリをロードします。詳細は、 .na -\f2「JVMTI エージェントのコマンド行オプション」\fP @ +\f2JVMTIエージェントのコマンドライン・オプション\fP @ .fi -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingを参照してください。 +http://download.oracle.com/javase/7/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 環境変数の設定がオーバーライドされます。 -.LP -\f3\-classpath\fP も \f3\-cp\fP も使用されず、\f3CLASSPATH\fP も設定されていない場合、ユーザークラスパスは現在のディレクトリ (\f4.\fP) になります。 -.LP -便宜上、 \f2*\fP のベース名を含むクラスパス要素は、 \f2.jar\fP または \f2.JAR\fP を拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます (java プログラムはこの 2 つの呼び出しを区別できない)。 +クラス・ファイルを検索するディレクトリ、JARアーカイブおよびZIPアーカイブのリストを指定します。クラス・パスの各エントリはコロン(\f3:\fP)で区切ります。\f3\-classpath\fPまたは\f3\-cp\fPを指定すると、このオプションの値によって\f3CLASSPATH\fP環境変数の設定がオーバーライドされます。 +.br +.br +\f3\-classpath\fPも\f3\-cp\fPも使用されず、\f3CLASSPATH\fPも設定されていない場合、ユーザー・クラス・パスは現在のディレクトリ(\f4.\fP)になります。 +.br +.br +便宜上、\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 プログラムが展開されていないワイルドカードを認識することはありません。 -.LP -クラスパスの詳細は、 +たとえば、ディレクトリ\f2foo\fPに\f2a.jar\fPと\f2b.JAR\fPが含まれている場合、クラス・パス要素\f2foo/*\fPは\f2A.jar:b.JAR\fPに展開されます。ただし、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。\f2*\fPのみからなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\f2CLASSPATH\fP環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカード展開は必ず、Java仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 +.br +.br +クラス・パスの詳細は、 .na -\f2「クラスパスの設定」\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpathを参照してください。 .TP 3 \-Dproperty=value -システムプロパティーの値を設定します。 +システム・プロパティの値を設定します。 .TP 3 \-d32 .TP 3 \-d64 -それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。 -.LP -現在のところ、Java HotSpot Server VM だけが 64 ビットの操作をサポートしており、\-server オプションを使用する場合は、\-d64 も一緒に使用する必要があります。したがって、\-d64 使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 -.LP -\f3\-d32\fP と \f3\-d64\fP がどちらも指定されていない場合は、デフォルトとして、32 ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。 +それぞれ32ビット環境、64ビット環境でプログラムを実行することをリクエストします。リクエストされた環境がインストールされていないかサポートされていない場合は、エラーが報告されます。 +.br +.br +現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\-d64使用時には\-serverオプションが暗黙的に使用されます。したがって、\-d64使用時には「\-client」オプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 +.br +.br +\f3\-d32\fPと\f3\-d64\fPがどちらも指定されていない場合は、デフォルトとして、32ビット環境で実行されます。この仕様は、将来のリリースでは変更になる可能性があります。 .TP 3 \-enableassertions[:<package name>"..." | :<class name> ] .TP 3 \-ea[:<package name>"..." | :<class name> ] -アサーションを有効にします。アサーションは、デフォルトでは無効になっています。 -.LP -引数なしの \f3enableassertions\fP または \f3\-ea\fP を指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが有効になります。 -.LP -単一コマンド行にこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ \f2com.wombat.fruitbat\fP (サブパッケージを含む) 内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。 +.TP 3 +\-disableassertions[:<package name>"..." | :<class name> ] +.TP 3 +\-da[:<package name>"..." | :<class name> ] +アサーションを無効にします。これがデフォルトです。 +.br +.br +引数なしの\f3disableassertions\fPまたは\f3\-da\fPを指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」のみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが無効になります。 +.br +.br +パッケージ\f2com.wombat.fruitbat\fP内ではアサーションを有効にし、クラス\f2com.wombat.fruitbat.Brickbat\fP内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。 +.nf +\f3 +.fl +java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat \fP\f4<Main Class>\fP\f3 +.fl +\fP +.fi +\f3\-disableassertions\fPおよび\f3\-da\fPスイッチは、\f2すべての\fPクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用\f2されない\fP、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステム・クラスでアサーションを無効にするために、別のスイッチが用意されています。この後の\f3\-disablesystemassertions\fPを参照してください。 +アサーションを有効にします。アサーションは、デフォルトでは無効になっています。 +.br +.br +引数なしの\f3enableassertions\fPまたは\f3\-ea\fPを指定すると、アサーションが有効になります。「\f2...\fP」で終わる引数を1つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として「\f2...\fP」のみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。「\f2...\fP」で終わらない引数を1つ指定すると、指定したクラス内でアサーションが有効になります。 +.br +.br +単一コマンドラインにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。したがって、たとえば、パッケージ\f2com.wombat.fruitbat\fP(サブパッケージを含む)内でのみアサーションを有効にしてプログラムを実行するには、次のようなコマンドを使用します。 .nf \f3 .fl @@ -191,64 +221,56 @@ .fl \fP .fi -.LP -\f3\-enableassertions\fP および \f3\-ea\fP スイッチは、すべてのクラスローダおよびシステムクラスに適用されます。システムクラスにはクラスローダはありません。ただし、この規則には 1 つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用されない、ということです。この例外を利用すれば、システムクラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステムクラスでアサーションを有効にするために、別のスイッチが用意されています。このあとの \f3\-enablesystemassertions\fP を参照してください。 -.TP 3 -\-disableassertions[:<package name>"..." | :<class name> ] -.TP 3 -\-da[:<package name>"..." | :<class name> ] -アサーションを無効にします。これがデフォルトです。 -.LP -引数なしの \f3disableassertions\fP または \f3\-da\fP を指定すると、アサーションが無効になります。「\f2...\fP」で終わる引数を 1 つ指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として「\f2...\fP」だけを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。「\f2...\fP」で終わらない引数を 1 つ指定すると、指定したクラス内でアサーションが無効になります。 -.LP -パッケージ \f2com.wombat.fruitbat\fP 内ではアサーションを有効にし、クラス \f2com.wombat.fruitbat.Brickbat\fP 内ではアサーションを無効にしたうえで、プログラムを実行するには、次のようなコマンドを使用します。 -.nf -\f3 -.fl -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\-enableassertions\fPおよび\f3\-ea\fPスイッチは、\f2すべての\fPクラス・ローダーおよびシステム・クラスに適用されます。システム・クラスにはクラス・ローダーはありません。ただし、このルールには1つ例外があります。それは、引数なしの形式でこのスイッチを指定すると、その指定がシステムに適用\f2されない\fP、ということです。この例外を利用すれば、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。すべてのシステム・クラスでアサーションを無効にするために、別のスイッチが用意されています。この後の\f3\-enablesystemassertions\fPを参照してください。 .TP 3 \-enablesystemassertions .TP 3 \-esa -すべてのシステムクラス内でアサーションを有効にします。つまり、システムクラスについてアサーションのデフォルトステータスを \f2true\fP に設定します。 +すべてのシステム・クラス内でアサーションを有効にします。つまり、システム・クラスについて\f2アサーションのデフォルト・ステータス\fPを\f2true\fPに設定します。 .TP 3 \-disablesystemassertions .TP 3 \-dsa -すべてのシステムクラス内でアサーションを無効にします。 +すべてのシステム・クラス内でアサーションを無効にします。 +.TP 3 +\-helpまたは\-? +使用方法を表示して終了します。 .TP 3 \-jar -JAR ファイルにカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR ファイルの名前にします。このオプションが機能するには、JAR ファイルのマニフェストに\f3「Main\-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://download.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。 -.LP -このオプションを使用すると、指定した JAR ファイルがすべてのユーザークラスのソースになり、ユーザークラスパスのほかの設定は無視されます。 -.LP -Solaris 8 では、「java \-jar」オプションで実行できる JAR ファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。Java Archive (JAR) ファイル +http://docs.oracle.com/javase/tutorial/deployment/jarの「Trail: Jar Files」を参照してください。\ +.br +.br +このオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、ユーザー・クラス・パスの他の設定は無視されます。 +.br +.br +「java \-jar」オプションで実行できるJARファイルは、実行権限のセットを保持しています。このため、「java \-jar」を使用しないで実行することも可能です。 .na - @ +\f2Java Archive(JAR)ファイル\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/jar/index.htmlを参照してください。 .TP 3 \-javaagent:jarpath[=options] -Java プログラミング言語エージェントをロードします。 java.lang.instrument を参照してください。 +Javaプログラミング言語エージェントをロードします。 .na - @ +\f2java.lang.instrument\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html +http://download.oracle.com/javase/7/docs/api/java/lang/instrument/package\-summary.htmlを参照してください。 .TP 3 \-jre\-restrict\-search -ユーザープライベートな JRE をバージョン検索に含めます。 +ユーザー・プライベートなJREをバージョン検索に含めます。 .TP 3 \-no\-jre\-restrict\-search -ユーザープライベートな JRE をバージョン検索から除外します。 +ユーザー・プライベートなJREをバージョン検索から除外します。 +.TP 3 +\-showversion +バージョン情報を表示して続行します。(関連項目: \f3\-version\fP。) +.TP 3 +\-splash:imagepath +\f2imagepath\fPに指定された画像を含むスプラッシュ画面を表示します。 .TP 3 \-verbose .TP 3 @@ -256,18 +278,19 @@ クラスがロードされるたびにクラスに関する情報を表示します。 .TP 3 \-verbose:gc -ガベージコレクションイベントが発生するたびに報告します。 +ガベージ・コレクション・イベントが発生するたびに報告します。 .TP 3 \-verbose:jni -ネイティブメソッドの使用およびその他の Java Native Interface (JNI) アクティビティーに関する情報を報告します。 +ネイティブ・メソッドの使用およびその他のJava Native Interface(JNI)アクティビティに関する情報を報告します。 .TP 3 \-version -バージョン情報を表示して終了します。 +バージョン情報を表示して終了します。(関連項目: \f3\-showversion\fP。) .TP 3 \-version:release -コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 -.LP -\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。 +コマンドラインに指定されたクラスまたはJARファイルが、\f2release\fPで指定されたバージョンを必要としていることを示します。起動されたjavaコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 +.br +.br +\f2release\fPでは、特定のバージョンを指定できるのみでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョンID、バージョンIDの後にアスタリスク(*)を付加したもの、バージョンIDの後にプラス記号(+)を付加したもの、2つのバージョン範囲をアンパサンド(&)で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは2つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。 .nf \f3 .fl @@ -275,25 +298,13 @@ .fl \fP .fi -上記の意味は、バージョン 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 ファイルのマニフェスト内に指定することが推奨されています。 -.LP -このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。 -.TP 3 -\-showversion -バージョン情報を表示して続行します。 -.TP 3 -\-? -.TP 3 -\-help -使用法を表示して終了します。 -.TP 3 -\-splash:imagepath -\f2imagepath\fP に指定された画像を含むスプラッシュ画面を表示します。 -.TP 3 -\-X -非標準オプションに関する情報を表示して終了します。 +上記の意味は、バージョン1.6.0_13、1.6をバージョンIDプレフィックスに持つ1.6.0_10以上のバージョン、のいずれかをクラスまたはJARファイルが必要としている、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol&API Specification(JSR\-56)」の「Appendix A」を参照してください。 +.br +.br +JARファイルの場合は通常、バージョン要件をコマンドラインに指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 +.br +.br +このオプションの使用に関する重要なポリシー情報については、後述の注意を参照してください。 .RE .LP @@ -302,45 +313,53 @@ .LP .RS 3 .TP 3 +\-X +非標準オプションに関する情報を表示して終了します。 +.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 アーカイブをコロンで区切ったリストで指定します。指定したパスに存在するブートクラスファイルが、Java プラットフォーム 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 を指定したときに報告される情報のほかに、報告される各イベントの先頭に、最初のガベージコレクションイベントからの経過時間 (秒単位) が付け加えられます。 -.LP -ネットワークの応答時間によって JVM の実行速度が低下するのを避けるため、このファイルの格納先は、常にローカルファイルシステムにしてください。ファイルシステムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引き続き記録されます。このオプションと \f2\-verbose:gc\fP の両方がコマンド行に指定されている場合は、このオプションが優先されます。 +\-verbose:gcと同様にガベージ・コレクション・イベントが発生するたびに報告しますが、そのデータを\f2file\fPに記録します。\f2\-verbose:gc\fPを指定したときに報告される情報の他に、報告される各イベントの先頭に、最初のガベージ・コレクション・イベントからの経過時間(秒単位)が付け加えられます。 +.br +.br +ネットワークのレスポンス時間によってJVMの実行速度が低下するのを避けるため、このファイルの格納先は、常にローカル・ファイル・システムにしてください。ファイル・システムが満杯になると、ファイルは切り詰められ、そのファイルにデータが引続き記録されます。このオプションと\f2\-verbose:gc\fPの両方がコマンドラインに指定されている場合は、このオプションが優先されます。 +.TP 3 +\-Xmnsizeまたは\-XX:NewSize +若い世代(ナーサリ)のサイズを設定します。 .TP 3 \-Xmsn -メモリー割り当てプールの初期サイズをバイト数で指定します。指定する値は、1M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「 +メモリー割当プールの初期サイズをバイト数で指定します。指定する値は、1MBより大きい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 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/gc\-ergonomics.htmlを参照してください。 +.br +.br 例: .nf \f3 @@ -357,11 +376,12 @@ .fi .TP 3 \-Xmxn -メモリー割り当てプールの最大サイズをバイト数で指定します。指定する値は、2M バイトより大きい 1024 の倍数にしなければなりません。キロバイトを指定するには、文字 \f2k\fP または \f2K\fP を付けます。メガバイトを指定するには、文字 \f2m\fP または \f2M\fP を付けます。デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「 +メモリー割当プールの最大サイズをバイト数で指定します。指定する値は、2MBより大きい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」を参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/vm/gc\-ergonomics.htmlを参照してください。 +.br .br 例: .nf @@ -377,52 +397,139 @@ .fl \fP .fi -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 -実行中のプログラムのプロファイルを生成し、プロファイルデータを標準出力に出力します。このオプションは、プログラム開発用のユーティリティーとして提供されています。 本番稼動システムでの使用を目的としたものではありません。 +実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に出力します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 .TP 3 \-Xrs -Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの使用を減らします。 -.LP -以前のリリースでは、Java アプリケーションを秩序正しくシャットダウンするためのシャットダウンフック機能が追加されました。この機能により、JVM が突然終了した場合でも、シャットダウン時にユーザークリーンアップコード (データベース接続のクローズなど) を実行できるようになりました。 -.LP -Sun の JVM は、シグナルをキャッチすることによって、JVM の異常終了のためのシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、および SIGTERM を使用して、シャットダウンフックの実行を開始します。 -.LP -JVM は、デバッグの目的でスレッドスタックをダンプするという、1.2 より前からある機能を実現するためにも、同様の機構を使用します。Sun の JVM は、スレッドダンプを実行するために SIGQUIT を使用します。 -.LP -JVM を埋め込んでいるアプリケーションが SIGINT や SIGTERM などのシグナルを頻繁にトラップする必要があると、JVM そのもののシグナルハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fP コマンド行オプションを使用すると、この問題に対処できます。Sun の JVM に対して \f3\-Xrs\fP を使用すると、SIGINT、SIGTERM、SIGHUP、および SIGQUIT に対するシグナルマスクは JVM によって変更されず、これらのシグナルに対するシグナルハンドラはインストールされません。 -.LP -\f3\-Xrs\fP を指定した場合、次の 2 つの影響があります。 +Java仮想マシン(JVM)によるオペレーティング・システム・シグナルの使用を減らします。 +.br +.br +以前のリリースでは、Javaアプリケーションを秩序正しくシャットダウンするためのシャットダウン・フック機能が追加されました。この機能により、JVMが突然終了した場合でも、シャットダウン時にユーザー・クリーン・アップコード(データベース接続のクローズなど)を実行できるようになりました。 +.br +.br +Sun社のJVMは、シグナルをキャッチすることによって、JVMの異常終了のためのシャットダウン・フックを実装します。JVMは、SIGHUP、SIGINTおよびSIGTERMを使用して、シャットダウン・フックの実行を開始します。 +.br +.br +JVMは、デバッグの目的でスレッド・スタックをダンプするという、1.2より前からある機能を実現するためにも、同様の機構を使用します。Sun社のJVMは、スレッド・ダンプを実行するためにSIGQUITを使用します。 +.br +.br +JVMを埋め込んでいるアプリケーションがSIGINTやSIGTERMなどのシグナルを頻繁にトラップする必要があると、JVMそのもののシグナル・ハンドラの処理に支障が出る可能性があります。\f3\-Xrs\fPコマンドライン・オプションを使用すると、この問題に対処できます。Sun社のJVMに対して\f3\-Xrs\fPを使用すると、SIGINT、SIGTERM、SIGHUPおよびSIGQUITに対するシグナル・マスクはJVMによって変更されず、これらのシグナルに対するシグナル・ハンドラはインストールされません。 +.br +.br +\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:AllocationPrefetchStyle=n +割当中に使用されるプリフェッチのスタイルを設定します。デフォルトは2です。 +.br +.TP 3 +\-XX:+AggressiveOpts +積極的な最適化を有効にします。 +.br +.TP 3 +\-XX:+|\-DisableAttachMechanism +このオプションは、ツール(\f2jmap\fPおよび\f2jconsole\fPなど)がJVMに接続できるかどうかを指定します。デフォルトでは、この機能は無効になっています。つまり、接続は有効です。使用例: +.nf +\f3 +.fl + java \-XX:+DisableAttachMechanism +.fl +\fP +.fi +.TP 3 +\-XXLargePageSizeInBytes=n +このオプションは、ラージ・ページの最大サイズを指定します。 +.TP 3 +\-XX:MaxGCPauseMillis=n +最大GC休止時間のターゲットを設定します。 +.br +これはソフト・ゴールのため、JVMは実現のために最善の努力をします。 +.TP 3 +\-XX:NewSize +若い世代(ナーサリ)のサイズを設定します。\f3\-Xmn\fP\f4size\fPと同じです。 +.TP 3 +\-XX:ParallelGCThreads=n +パラレル・コレクタ内のGCスレッドの数を設定します。 +.br +.TP 3 +\-XX:PredictedClassLoadCount=n +このオプションでは、最初に\f3UnlockExperimentalVMOptions\fPフラグを設定する必要があります。アプリケーションが多数のクラスをロードする場合で、特に\f3class.forName()\fPが頻繁に使用される場合は\f3PredictedClassLoadCount\fPフラグを使用します。推奨値は、\f3\-verbose:class\fPからの出力に示されているロード済クラスの数です。 +.br +使用例: +.nf +\f3 +.fl + java \-XX:+UnlockExperimentalVMOptions \-XX:PredictedClassLoadCount=60013 +.fl +\fP +.fi +.TP 3 +\-XX:+PrintCompilation +HotSpotダイナミック・ランタイム・コンパイラからの詳細出力を印刷します。 +.br +.TP 3 +\-XX:+PrintGCDetails \-XX:+PrintGCTimeStamps +ガベージ・コレクション出力をタイムスタンプとともに印刷します。 +.br +.TP 3 +\-XX:SoftRefLRUPolicyMSPerMB=0 +このフラグは、ソフトウェア参照の積極的処理を有効にします。このフラグは、HotSpot GCがソフトウェア参照カウントの影響を受ける場合に使用します。 +.TP 3 +\-XX:TLABSize=n +スレッド・ローカル割当バッファ(TLAB)がHotSpotでデフォルトで有効になっています。HotSpotでは、TLABのサイズを割当パターンに基づいて自動的に決定します。\f3\-XX:TLABSize\fPオプションでTLABのサイズを微調整できます。 +.br +.TP 3 +\-XX:+UnlockCommercialFeatures +このフラグは、商用機能の使用を能動的にロック解除する場合に使用します。商用機能とは、 +.na +\f2Oracle Java SE Products Webページ\fP @ +.fi +http://www.oracle.com/technetwork/java/javase/terms/products/index.htmlで規定される製品"Oracle Java SE Advanced"または"Oracle Java SE Suite"です。 +.br +このフラグが指定されていない場合、デフォルトはJava仮想マシンを使用可能な商用機能なしで実行することです。いったん商用機能を有効にすると、実行時にその使用を無効にすることはできません。 .TP 3 \-XX:+UseAltSigs -VM ではデフォルトで \f2SIGUSR1\fP および \f2SIGUSR2\fP を使用しますが、\f2SIGUSR1\fP および \f2SIGUSR2\fP をシグナル連鎖するアプリケーションと 競合する場合があります。\f2\-XX:+UseAltSigs\fP オプションは、VM にデフォルトとして \f2SIGUSR1\fP と \f2SIGUSR2\fP 以外のシグナルを使用させます。 -.RE - +VMではデフォルトで\f2SIGUSR1\fPおよび\f2SIGUSR2\fPを使用しますが、\f2SIGUSR1\fPおよび\f2SIGUSR2\fPをシグナル連鎖するアプリケーションと競合する場合があります。\f2\-XX:+UseAltSigs\fPオプションは、VMにデフォルトとして\f2SIGUSR1\fPと\f2SIGUSR2\fP以外のシグナルを使用させます。 +.TP 3 +\-XX:+|\-UseCompressedOops +64ビットJVMで圧縮参照を有効にします。 +.br +このオプションはデフォルトでtrueです。 +.br +.TP 3 +\-XX:+UseConcMarkSweepGCまたは\-XX:+UseG1GC +これらのフラグはConcurrent Mark Sweep (CMS)またはG1ガベージ・コレクションを有効にします。 +.br +.TP 3 +\-XX:+|\-UseLargePages +このフラグは、ラージ・ページ・サポートを有効にする場合に使用します。ラージ・ページは、Solarisではデフォルトで有効になっています。 +.br +.TP 3 +\-XX:+UseParallelOldGC +パラレル・ガベージ・コレクタを有効にします。これはスループットおよび平均レスポンス時間に対して最適化されます。 +.br +.SH "注意" .LP -.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 @@ -430,10 +537,10 @@ .fl \fP .fi -この場合、 \f21.6.0_10\fP よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。 +この場合、\f21.6.0_10\fPよりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された(あるいはそのバグが修正された)場合に便利です。 .TP 3 3. -ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。 +ある特定のバージョンIDよりも大きいバージョンで、そのリリース・ファミリの上限によって制限されるもの。次に例を示します。 .nf \f3 .fl @@ -443,7 +550,7 @@ .fi .TP 3 4. -上の項目 2 と項目 3 の「OR」式。次に例を示します。 +上の項目2と項目3の「OR」式。次に例を示します。 .nf \f3 .fl @@ -451,27 +558,20 @@ .fl \fP .fi -これは項目 2 に似ていますが、ある変更が特定のリリース (1.7) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。 +これは項目2に似ていますが、ある変更が特定のリリース(1.7)で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。 .RE - +.SH "終了ステータス" .LP -.SH "終了ステータス" -.LP -.LP -一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいは Java 仮想マシンから例外がスローされた場合です。ただし Java アプリケーションは、API 呼び出し \f2System.exit(exitValue)\fP を使用して任意の値を返すことを選択することもできます。 -.LP +一般に、次の終了値が起動ツールから返されるのは通常、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJava仮想マシンから例外がスローされた場合です。ただしJavaアプリケーションは、API呼出し\f2System.exit(exitValue)\fPを使用して任意の値を返すことを選択することもできます。 .RS 3 .TP 2 o \f20\fP: 正常終了 .TP 2 o -\f2>0\fP: エラーが発生した +\f2>0\fP: エラー発生 .RE - -.LP -.SH "関連項目" -.LP +.SH "関連項目" .RS 3 .TP 2 o @@ -488,22 +588,23 @@ .TP 2 o .na -\f2「Java 拡張機能フレームワーク」\fP @ +\f2Java拡張機能フレームワーク\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html +http://download.oracle.com/javase/7/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 +http://download.oracle.com/javase/7/docs/technotes/guides/security/index.html .TP 2 o .na -\f2「HotSpot VM Specific Options」\fP @ +\f2HotSpot VM Specific Options\fP @ .fi http://java.sun.com/docs/hotspot/VMOptions.html .RE +.RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/javac.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/javac.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javac 1 "07 May 2011" +.TH javac 1 "21 Mar 2012" .LP .SH "名前" -javac \- Java プログラミング言語コンパイラ +javac \- Javaプログラミング言語コンパイラ .LP .RS 3 .TP 2 @@ -37,7 +37,7 @@ オプション .TP 2 o -コマンド行引数ファイル +コマンドライン引数ファイル .TP 2 o 注釈処理 @@ -46,7 +46,7 @@ 型の検索 .TP 2 o -プログラマティックインタフェース +プログラマティック・インタフェース .TP 2 o 例 @@ -74,53 +74,53 @@ .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 .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 .LP -コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。 +コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fPで始まります。 .LP .SS 標準オプション @@ -128,124 +128,131 @@ .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 のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、「クラスパスの設定」を参照してください。 -.LP -\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。 -.LP -\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。 +\-cppathまたは\-classpathpath +ユーザーのクラス・ファイルおよび(場合によっては)注釈プロセッサやソース・ファイルの検索場所を指定します。このクラス・パスは\f3CLASSPATH\fP環境変数のユーザー・クラス・パスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fPのいずれも指定されていない場合、ユーザー・クラス・パスは、現在のディレクトリになります。詳細は、クラス・パスの設定を参照してください。 +.br +.br +\f3\-sourcepath\fPオプションが指定されていない場合は、ソース・ファイルもユーザー・クラス・パスから検索されます。 +.br +.br +\f3\-processorpath\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 になります。 -.LP -\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。 -.LP -\f3注:\fP \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。 +クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。\f3javac\fPでは作成されません。クラスがパッケージの一部である場合、\f3javac\fPは、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラス・ファイルを格納します。たとえば、\f3\-d/home/myclasses\fPと指定し、クラスの名前が\f2com.mypackage.MyClass\fPである場合、クラス・ファイルは\f2/home/myclasses/com/mypackage/MyClass.class\fPになります。 +.br +.br +\f3\-d\fPが指定されなかった場合、\f3javac\fPは各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 +.br +.br +\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 や UTF\-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 プラットフォームに実装されたブートストラップクラスや拡張機能クラスに対してコンパイルを行う) を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細は、「クロスコンパイルオプション」を参照してください。 +\f2ext\fPディレクトリの位置をオーバーライドします。\f2directories\fP変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARアーカイブから、クラス・ファイルが検索されます。見つかったすべてのJARアーカイブは自動的にクラス・パスの一部になります。 +.br +.br +クロスコンパイル(異なる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 起動ツールに渡してください。 +\f3javac\fPが呼び出す\f3java\fP起動ツールに、\f2option\fPを渡します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。\f3\-J\fPを使用して、Javaで記述されたアプリケーションを実行する背後のVMにオプションを渡すことは、よく行われています。 +.br +.br +\f3注意:\fP \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fPおよび\f3\-extdirs\fPは、\f3javac\fPを実行するために使用するクラスを指定するものでは\f2ありません\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 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +このコンパイラでは、Java SE 1.3以降に導入されたアサーション、総称または他の言語機能をサポート\f2しません\fP。 .TP 3 1.4 -JDK 1.4 で導入された、アサーションを含むコードを受け付けます。 +Java SE 1.4で導入された、アサーションを含むコードを受け付けます。 .TP 3 1.5 -JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。 +Java SE 5で導入された総称および他の言語機能を含んだコードを受け付けます。 .TP 3 5 -1.5 と同義です。 +1.5と同義です。 .TP 3 1.6 -これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。 +Java SE 6では言語に対する変更は導入されませんでした。しかし、ソース・ファイル内のエンコーディング・エラーが、Java SE以前のような「警告」ではなく、「エラー」として報告されるようになりました。 .TP 3 6 -1.6 と同義です。 +1.6と同義です。 .TP 3 1.7 -JDK 7 で導入された機能を含むコードを受け付けます。 +これがデフォルト値です。Java SE 7で導入された機能を含むコードを受け付けます。 .TP 3 7 -1.7 と同義です。 +1.7と同義です。 .RE .TP 3 \-sourcepath sourcepath -クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。 -.LP -\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。 +クラスまたはインタフェースの定義を検索するソース・コード・パスを指定します。ユーザー・クラス・パスと同様に、ソース・パスの複数のエントリはコロン(\f3:\fP)で区切ります。ソース・パスのエントリには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。パッケージを使用している場合は、ディレクトリまたはアーカイブ内のローカル・パス名がパッケージ名を反映している必要があります。 +.br +.br +\f3注意:\fP クラス・パスからクラスのみでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。型の検索を参照してください。 .TP 3 \-verbose -詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。 +詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソース・ファイルごとの情報が出力されます。 .TP 3 \-version バージョン情報を出力します。 @@ -259,34 +266,40 @@ .LP .SS -クロスコンパイルオプション +クロスコンパイル・オプション .LP .LP -デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。 +デフォルトでは、クラスのコンパイルは、\f3javac\fPが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fPは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行う「\f2クロスコンパイル\fP」もサポートしています。クロスコンパイルを行う場合は、\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 も可)、および \f31.7\fP (\f37\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.7\fP になります。 +\-sourceが\f3指定されなかった\fP場合、\-targetの値は\f31.7\fPになります。 +.TP 2 +o +\-sourceが\f31.2\fPの場合、\-targetの値は\f31.4\fPになります。 .TP 2 o -\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。 +\-sourceが\f31.3\fPの場合、\-targetの値は\f31.4\fPになります。 .TP 2 o -\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。 +\-sourceが\f31.5\fPの場合、\-targetの値は\f31.7\fPになります。 .TP 2 o -\-source が\f3それ以外の値の場合はすべて\fP、\f3\\\-target\fP の値は \f3\-source\fP の値になります。 +\-sourceが\f31.6\fPの場合、\-targetの値は\f31.7\fPになります。 +.TP 2 +o +\-sourceが\f3それ以外の値の場合はすべて\fP、\f3\-target\fPの値は\f3\-source\fPの値になります。 .RE .TP 3 \-bootclasspath bootclasspath -指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。 +指定された一連のブート・クラスに対してクロスコンパイルを行います。ユーザー・クラス・パスと同様に、ブート・クラス・パスの複数のエントリはコロン(\f3:\fP)で区切ります。ブート・クラス・パスのエントリには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。 .RE .LP @@ -296,28 +309,28 @@ .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 すべての警告を無効にします。 .TP 3 \-Xlint:name -警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 +警告\f2name\fPを有効にします。このオプションで有効にできる警告のリストについては、\-Xlintオプションを使用して有効または無効にできる警告を参照してください。 .TP 3 \-Xlint:\-name -警告 \f2name\fP を無効にします。このオプションで無効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 +警告\f2name\fPを無効にします。このオプションで無効にできる警告のリストについては、\-Xlintオプションを使用して有効または無効にできる警告を参照してください。 .TP 3 \-Xmaxerrs number 印刷するエラーの最大数を設定します。 @@ -326,10 +339,10 @@ 印刷する警告の最大数を設定します。 .TP 3 \-Xstdout filename -コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。 +コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは\f2System.err\fPに送られます。 .TP 3 \-Xprefer:{newer,source} -ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。SOURCE の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fP \f2を使用してください\fP。 +ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します(型の検索を参照)。\f2\-Xprefer:newer\fPを使用した場合、ある型に対するソース・ファイルとクラス・ファイルの新しい方が読み取られます(デフォルト)。\f2\-Xprefer:source\fPオプションを使用した場合、ソース・ファイルが読み取られます。\f2SOURCE\fPの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fPを使用してください。 .TP 3 \-Xpkginfo:{always,legacy,nonempty} パッケージ情報ファイルの処理を指定します。 @@ -346,10 +359,10 @@ .LP .SS -\-Xlint オプションを使って有効または無効にできる警告 +\-Xlintオプションを使用して有効または無効にできる警告 .LP .LP -\f3\-Xlint:\fP\f2name\fP オプションを使って警告 \f2name\fP を有効にします。ただし、\f2name\fP は次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fP オプションを使って警告 \f2name\fP を無効にできます。 +\f3\-Xlint:\fP\f2name\fPオプションを使用して警告\f2name\fPを有効にします。ただし、\f2name\fPは次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fPオプションを使用して警告\f2name\fPを無効にできます。 .LP .RS 3 .TP 3 @@ -364,7 +377,7 @@ .fi .TP 3 classfile -クラスファイルの内容に関連した問題について警告します。 +クラス・ファイルの内容に関連した問題について警告します。 .TP 3 deprecation 非推奨項目の使用について警告します。次に例を示します。 @@ -377,11 +390,10 @@ .fl \fP .fi -.LP -メソッド \f2java.util.Date.getDay\fP は JDK 1.1 以降は推奨されていません。 +メソッド\f2java.util.Date.getDay\fPはJDK 1.1以降は推奨されていません。 .TP 3 dep\-ann -\f2@deprecated\fP Javadoc コメントでドキュメント化されているが、 \f2@Deprecated\fP 注釈が付いていない項目について警告します。次に例を示します。 +\f2@deprecated\fP Javadocコメントでドキュメント化されているが、\f2@Deprecated\fP注釈が付いていない項目について警告します。次に例を示します。 .nf \f3 .fl @@ -403,7 +415,7 @@ .fi .TP 3 divzero -一定の整数 0 で除算されることについて警告します。次に例を示します。 +定整数0で除算されることについて警告します。次に例を示します。 .nf \f3 .fl @@ -413,7 +425,7 @@ .fi .TP 3 empty -\f2if\fP 文以降が空の文であることについて警告します。次に例を示します。 +\f2if\fP文以降が空の文であることについて警告します。次に例を示します。 .nf \f3 .fl @@ -431,7 +443,7 @@ .fi .TP 3 fallthrough -fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。 +fall\-throughケースの\f2switch\fPブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-throughケースは、\f2switch\fPブロック内の最後のケースを除くケースです。このコードには\f2break\fP文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この\f2switch\fPブロック内の\f2case 1\fPラベルに続くコードは、\f2break\fP文で終わっていません。 .nf \f3 .fl @@ -451,11 +463,10 @@ .fl \fP .fi -.LP -このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。 +このコードのコンパイル時に\f2\-Xlint:fallthrough\fPフラグが使用されていた場合、コンパイラは当該ケースの行番号とともに、fall\-throughケースの可能性があることを示す警告を発行します。 .TP 3 finally -正常に完了できない \f2finally\fP 節について警告します。次に例を示します。 +正常に完了できない\f2finally\fP節について警告します。次に例を示します。 .nf \f3 .fl @@ -481,14 +492,13 @@ .fl \fP .fi -.LP -この例では、コンパイラは \f2finally\fP ブロックに関する警告を生成します。このメソッドが呼び出されると、値 1 ではなく \f20\fP が \f2返されます\fP。 \f2finally\fP ブロックは、 \f2try\fP ブロックが終了すると必ず実行されます。この例では、制御が \f2catch\fP に移された場合、メソッドは終了します。ただし、 \f2finally\fP ブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。 +この例では、コンパイラは\f2finally\fPブロックに関する警告を生成します。このメソッドが呼び出されると、値\f21\fPではなく\f20\fPが返されます。\f2finally\fPブロックは、\f2try\fPブロックが終了すると必ず実行されます。この例では、制御が\f2catch\fPに移された場合、メソッドは終了します。ただし、\f2finally\fPブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。 .TP 3 options -コマンド行オプションの使用に関する問題について警告します。この種の警告の例については、「クロスコンパイルの例」を参照してください。 +コマンドライン・オプションの使用に関する問題について警告します。この種の警告の例については、クロスコンパイルの例を参照してください。 .TP 3 overrides -メソッドのオーバーライドに関する問題について警告します。たとえば、次の 2 つのクラスがあるとします。 +メソッドのオーバーライドに関する問題について警告します。たとえば、次の2つのクラスがあるとします。 .nf \f3 .fl @@ -513,20 +523,16 @@ .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 の仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 +コンパイラは次のような警告を生成します。 +.br +.br +\f2warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod overrides varargsMethod(String...) in ClassWithVarargsMethod; overriding method is missing '...'\fP +.br +.br +コンパイラは、varargsメソッドを検出すると、varargsの仮パラメータを配列に変換します。メソッド\f2ClassWithVarargsMethod.varargsMethod\fPでは、コンパイラはvarargsの仮パラメータ\f2String... s\fPを仮パラメータ\f2String[] s\fPに変換します。String[] sは、メソッド\f2ClassWithOverridingMethod.varargsMethod\fPの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 .TP 3 path -コマンド行での無効なパス要素と存在しないパスディレクトリについて警告します (クラスパス、ソースパスなどのパス関連)。このような警告を \f2@SuppressWarnings\fP 注釈で抑制することはできません。次に例を示します。 +コマンドラインでの無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\f2@SuppressWarnings\fP注釈で抑制することはできません。次に例を示します。 .nf \f3 .fl @@ -536,9 +542,10 @@ .fi .TP 3 processing -注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでその型の例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。 -.LP -\f3ソースファイル \fP\f4AnnoProc.java\fP: +注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでそのタイプの例外を処理できない場合です。単純な注釈プロセッサの例を次に示します。 +.br +.br +\f3ソース・ファイル\fP\f4AnnoProc.java\fP: .nf \f3 .fl @@ -574,8 +581,7 @@ .fl \fP .fi -.LP -\f3ソースファイル \fP\f4AnnosWithoutProcessors.java\fP\f3:\fP +\f3ソース・ファイル\fP\f4AnnosWithoutProcessors.java\fP\f3:\fP .nf \f3 .fl @@ -589,31 +595,25 @@ .fl \fP .fi -.LP -次のコマンドは、注釈プロセッサ \f2AnnoProc\fP をコンパイルし、この注釈プロセッサをソースファイル \f2AnnosWithoutProcessors.java\fP に対して実行します。 +次のコマンドは、注釈プロセッサ\f2AnnoProc\fPをコンパイルし、この注釈プロセッサをソース・ファイル\f2AnnosWithoutProcessors.java\fPに対して実行します。 .nf \f3 .fl -% javac AnnoProc.java +% \fP\f3javac AnnoProc.java\fP .fl -% javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java +% \f3javac \-cp . \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors.java\fP .fl -\fP .fi -.LP -コンパイラがソースファイル \f2AnnosWithoutProcessors.java\fP に対して注釈プロセッサを実行すると、次の警告が生成されます。 -.nf -\f3 -.fl -warning: [processing] No processor claimed any of these annotations: Anno -.fl -\fP -.fi -.LP -この問題を解決するには、クラス \f2AnnosWithoutProcessors\fP で定義および使用される注釈の名前を \f2Anno\fP から \f2NotAnno\fP に変更します。 +コンパイラがソース・ファイル\f2AnnosWithoutProcessors.java\fPに対して注釈プロセッサを実行すると、次の警告が生成されます。 +.br +.br +\f2warning: [processing] No processor claimed any of these annotations: Anno\fP +.br +.br +この問題を解決するには、クラス\f2AnnosWithoutProcessors\fPで定義および使用される注釈の名前を\f2Anno\fPから\f2NotAnno\fPに変更します。 .TP 3 rawtypes -raw 型に対する未検査操作について警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。 +raw型に対する未検査操作について警告します。次の文では、\f2rawtypes\fP警告が生成されます。 .nf \f3 .fl @@ -621,8 +621,7 @@ .fl \fP .fi -.LP -次の文では、 \f2rawtypes\fP 警告は生成されません。 +次の文では、\f2rawtypes\fP警告は生成されません。 .nf \f3 .fl @@ -630,11 +629,10 @@ .fl \fP .fi -.LP -\f2List\fP は raw 型です。ただし、 \f2List<?>\fP はアンバウンド形式のワイルドカードのパラメータ化された型です。 \f2List\fP はパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、 \f2List\fP の仮引数はアンバウンド形式のワイルドカード (\f2?\fP) を使ってその仮型パラメータとして指定されます。つまり、 \f2countElements\fP メソッドは \f2List\fP インタフェースのどのインスタンス化も受け付けることができます。 +\f2List\fPはraw型です。ただし、\f2List<?>\fPはアンバウンド形式のワイルドカードのパラメータ化された型です。\f2List\fPはパラメータ化されたインタフェースなので、必ずその型引数を指定する必要があります。この例では、\f2List\fPの仮引数はアンバウンド形式のワイルドカード(\f2?\fP)を使用してその仮型パラメータとして指定されます。つまり、\f2countElements\fPメソッドは\f2List\fPインタフェースのどのインスタンス化も受け付けることができます。 .TP 3 serial -直列化可能クラスに \f2serialVersionUID\fP 定義がないことを警告します。次に例を示します。 +直列化可能クラスに\f2serialVersionUID\fP定義がないことを警告します。次に例を示します。 .nf \f3 .fl @@ -664,20 +662,16 @@ .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 値を明示的に宣言する必要があります。 +コンパイラは次の警告を生成します。 +.br +.br +\f2warning: [serial] serializable class PersistentTime has no definition of serialVersionUID\fP +.br +.br +直列化可能クラスが\f2serialVersionUID\fPという名前のフィールドを明示的に宣言しない場合、直列化ランタイムは「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\f2serialVersionUID\fPのデフォルト値を計算します。ただし、すべての直列化可能クラスが\f2serialVersionUID\fP値を明示的に宣言することを強くお薦めします。 これは、\f2serialVersionUID\fP値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、直列化復元中に予期しない\f2InvalidClassExceptions\fPが発生する可能性があるためです。したがって、Javaコンパイラの実装が異なっても\f2serialVersionUID\fP値の一貫性を確保にするには、直列化可能クラスが\f2serialVersionUID\fP値を明示的に宣言する必要があります。 .TP 3 static -static の使用に関する問題について警告します。次に例を示します。 +staticの使用に関する問題について警告します。次に例を示します。 .nf \f3 .fl @@ -691,7 +685,6 @@ .fl \fP .fi -.LP コンパイラは次の警告を生成します。 .nf \f3 @@ -700,8 +693,7 @@ .fl \fP .fi -.LP -この問題を解決するために、次のように static メソッド \f2m1\fP を呼び出すことができます。 +この問題を解決するために、次のようにstaticメソッド\f2m1\fPを呼び出すことができます。 .nf \f3 .fl @@ -709,11 +701,10 @@ .fl \fP .fi -.LP -あるいは、 \f2static\fP キーワードをメソッド \f2m1\fP の宣言から削除することもできます。 +あるいは、\f2static\fPキーワードをメソッド\f2m1\fPの宣言から削除することもできます。 .TP 3 try -try\-with\-resources 文を含む、 \f2try\fP ブロックの使用に関する問題について警告します。たとえば、try 文で宣言されたリソース \f2ac\fP が使用されないために、 \f2次の文に対して警告が\fP 生成されます。 +try\-with\-resources文を含む、\f2try\fPブロックの使用に関する問題について警告します。たとえば、\f2try\fP文で宣言されたリソース\f2ac\fPが使用されないために、次の文に対して警告が生成されます。 .nf \f3 .fl @@ -727,7 +718,7 @@ .fi .TP 3 unchecked -Java 言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。 +Java言語仕様で指定されている未検査変換警告の詳細を示します。次に例を示します。 .nf \f3 .fl @@ -737,15 +728,16 @@ .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に代入することを許可します。 +型の消去中に、型\f2ArrayList<Number>\fPおよび\f2List<String>\fPはそれぞれ\f2ArrayList\fPおよび\f2List\fPになります。 +.br +.br +変数\f2ls\fPにはパラメータ化された型\f2List<String>\fPが指定されています。\f2l\fPによって参照される\f2List\fPが\f2ls\fPに代入されると、コンパイラは未検査警告を生成します。コンパイラは\f2l\fPが\f2List<String>\fP型を参照するかどうかをコンパイル時に判断できません。また、JVMが実行時にそれを判断できないことも認識しています。lはList<String>型を参照しません。その結果、ヒープ汚染が発生します。 +.br +.br +詳しく説明すると、ヒープ汚染状態が発生するのは、\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 varargs -可変引数 (varargs) メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。 +可変引数(varargs)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。次に例を示します。 .nf \f3 .fl @@ -765,8 +757,7 @@ .fl \fP .fi -.LP -コンパイラは、メソッド \f2ArrayBuilder.addToList\fP の定義に関する次の警告を生成します。 +コンパイラは、メソッド\f2ArrayBuilder.addToList\fPの定義に関する次の警告を生成します。 .nf \f3 .fl @@ -774,30 +765,29 @@ .fl \fP .fi -.LP -コンパイラは、varargs メソッドを検出すると、varargs の仮パラメータを配列に変換します。しかし、Java プログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド \f2ArrayBuilder.addToList\fP では、コンパイラは varargs の仮パラメータ \f2T... elements\fP を仮パラメータ \f2T[] elements\fP(配列) に変換します。しかし、型消去のために、コンパイラは varargs の仮パラメータを \f2Object[] elements\fP に変換します。その結果、ヒープ汚染が発生する可能性があります。 +コンパイラは、varargsメソッドを検出すると、varargsの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\f2ArrayBuilder.addToList\fPでは、コンパイラはvarargsの仮パラメータ\f2T... elements\fPを仮パラメータ\f2T[] elements\fP(配列)に変換します。しかし、型消去のために、コンパイラはvarargsの仮パラメータを\f2Object[] elements\fPに変換します。その結果、ヒープ汚染が発生する可能性があります。 .RE .LP -.SH "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP .LP -javac のコマンド行を短くしたり簡潔にしたりするために、 \f2javac\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。 +javacのコマンドラインを短くしたり簡潔にしたりするために、\f2javac\fPコマンドに対する引数(\f2\-J\fPオプションを除く)を含む1つ以上のファイルを指定することができます。この方法を使用すると、どのオペレーティング・システム上でも、任意の長さのjavacコマンドを作成できます。 .LP .LP -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 +引数ファイルには、javacのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 .LP .LP -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード(*)は使用できません。たとえば、\f2*.java\fPとは指定できません。引数ファイル内の引数で\f2@\fP文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fPオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .LP .LP -javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +javacを実行するときに、各引数ファイルのパスとファイル名の先頭に\f2@\fP文字を付けて渡します。javacは、\f2@\fP文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .LP .SS -引数ファイルを 1 つ指定する例 +引数ファイルを1つ指定する例 .LP .LP -\f2「argfile」という名前の引数ファイルに\fPすべての javac 引数を格納する場合は、次のように指定します。 +「\f2argfile\fP」という名前の引数ファイルにすべてのjavac引数を格納する場合は、次のように指定します。 .LP .nf \f3 @@ -808,16 +798,16 @@ .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 @@ -835,7 +825,7 @@ .LP .LP -以下の内容を含む \f2classes\fP というファイルを作成します。 +次の内容を含む\f2classes\fPというファイルを作成します。 .LP .nf \f3 @@ -853,7 +843,7 @@ .LP .LP -次のコマンドを使用して \f3javac\fP を実行します。 +次のコマンドを使用して\f3javac\fPを実行します。 .LP .nf \f3 @@ -869,7 +859,7 @@ パス付きの引数ファイルの例 .LP .LP -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。 +引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fPや\f2path2\fPから見た相対パスではありません。 .LP .nf \f3 @@ -882,68 +872,68 @@ .SH "注釈処理" .LP .LP -\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。 +\f3javac\fPが注釈処理を直接サポートしているため、独立した注釈処理ツールである\f3apt\fPを使用する必要がなくなりました。 .LP .LP -注釈処理の API は、 \f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。 +注釈処理のAPIは、\f2javax.annotation.processing\fPおよび\f2javax.lang.model\fPパッケージとそのサブパッケージ内に定義されています。 .LP .SS 注釈処理の概要 .LP .LP -\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META\-INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。 +\f3\-proc:none\fPオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは\f3\-processorpath\fPオプションを使用して指定できます。検索パスを指定しなかった場合は、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\f2META\-INF/services/javax.annotation.processing.Processor\fPという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\f3\-processor\fPオプションを使用してプロセッサを明示的に指定することもできます。 .LP .LP -コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。 +コンパイラは、コマンドラインのソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。 .LP .LP -いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。 +いずれかのプロセッサによって新しいソース・ファイルが生成されると、注釈処理の2回目のラウンドが開始されます。新しく生成されたすべてのソース・ファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソース・ファイルが生成されなくなるまで続きます。 .LP .LP -あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。 +あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fPオプションが使用されない限り、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 .LP .SS -暗黙的にロードされたソースファイル +暗黙的にロードされたソース・ファイル .LP .LP -コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードすることが必要な場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。 +コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。(型の検索を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソース・ファイルが1つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicitオプションを参照してください。 .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 コマンド行オプションを使って設定します。詳細は、「クラスパスの設定」を参照してください。 +コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを探します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\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 "プログラマティックインタフェース" +.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 @@ -957,19 +947,19 @@ .LP .LP -この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。 +この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンドラインから呼び出された\f3javac\fPが返すのと同じ終了コードが返されます。 .LP .LP -\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。 +\f2javax.tools.JavaCompiler\fPインタフェース上の他のメソッドを使用すると、診断メッセージの処理やファイルの読取り元/書込み先の制御などを行えます。 .LP .SS 旧式のインタフェース .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 @@ -983,16 +973,16 @@ .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 のサブパッケージとして知られる) に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。 +名前が\f2com.sun.tools.javac\fPで始まるパッケージ(非公式には\f2com.sun.tools.javac\fPのサブパッケージとして知られる)に含まれるその他のクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。 .LP .SH "例" .LP @@ -1000,7 +990,7 @@ 簡単なプログラムのコンパイル .LP .LP -\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。 \f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。 +\f2Hello.java\fPというソース・ファイルで、\f3greetings.Hello\fPという名前のクラスを定義しているとします。\f2greetings\fPディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザー・クラス・パスを使用できます。また、\f3\-d\fPを使用して別の出力先ディレクトリを指定する必要もありません。 .LP .nf \f3 @@ -1051,10 +1041,10 @@ .LP .SS -複数のソースファイルのコンパイル +複数のソース・ファイルのコンパイル .LP .LP -次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。 +次の例では、パッケージ\f2greetings\fP内のすべてのソース・ファイルをコンパイルします。 .LP .nf \f3 @@ -1079,10 +1069,10 @@ .LP .SS -ユーザークラスパスの指定 +ユーザー・クラス・パスの指定 .LP .LP -上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。 +上の例のソース・ファイルのうち1つを変更し、変更後のファイルを再コンパイルするとします。 .LP .nf \f3 @@ -1097,7 +1087,7 @@ .LP .LP -\f2greetings.Hi\fP は、 \f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。 +\f2greetings.Hi\fPは、\f2greetings\fPパッケージ内の他のクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザー・クラス・パスが、パッケージ・ディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。しかし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合を考えてみましょう。そのような場合は、ユーザー・クラス・パスに\f2/examples\fPを追加する必要があります。ユーザー・クラス・パスにエントリを追加するには、\f3CLASSPATH\fPを設定する方法もありますが、ここでは\f3\-classpath\fPオプションを使用します。 .LP .nf \f3 @@ -1108,7 +1098,7 @@ .LP .LP -再度 \f2greetings.Hi\fP を変更してバナーユーティリティーを使うようにした場合は、このバナーユーティリティーもユーザークラスパスを通じてアクセスできるようになっている必要があります。 +再度\f2greetings.Hi\fPを変更してバナー・ユーティリティを使用するようにした場合は、このバナー・ユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 .LP .nf \f3 @@ -1121,7 +1111,7 @@ .LP .LP -\f2greetings\fP 内のクラスを実行するには、 \f2greetings\fP と、それが使うクラスの両方にアクセスできる必要があります。 +\f2greetings\fP内のクラスを実行するには、\f2greetings\fPと、それが使用するクラスの両方にアクセスできる必要があります。 .LP .nf \f3 @@ -1132,10 +1122,10 @@ .LP .SS -ソースファイルとクラスファイルの分離 +ソース・ファイルとクラス・ファイルの分離 .LP .LP -特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。 +特に大規模プロジェクトの場合は、ソース・ファイルとクラス・ファイルを別々のディレクトリに置くと便利なことがあります。クラス・ファイルの出力先を別に指定するには、\f3\-d\fPを使用します。ソース・ファイルはユーザー・クラス・パスにはないので、\f3\-sourcepath\fPを使用して、コンパイラがソース・ファイルを見つけることができるようにします。 .LP .nf \f3 @@ -1174,13 +1164,13 @@ .LP .LP -\f3注:\fP コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。 +\f3注意:\fP コマンドラインでは\f2src/farewells/Base.java\fPを指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fPオプションを使用します。 .LP .SS クロスコンパイルの例 .LP .LP -ここでは、\f3javac\fP を使って、1.6 VM 上で実行するコードをコンパイルします。 +次の例は、1.6 VM上で動作するコードをコンパイルするために\f3javac\fPを使用します。 .LP .nf \f3 @@ -1193,10 +1183,10 @@ .LP .LP -\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 オプションを省略できます。 +\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 -\f3\-bootclasspath\fP オプションを使用して、適切なバージョンのブートストラップクラス ( \f2rt.jar\fP ライブラリ) を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\f3\-bootclasspath\fPオプションを使用して、適切なバージョンのブートストラップ・クラス(\f2rt.jar\fPライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .LP .nf \f3 @@ -1209,7 +1199,7 @@ .LP .LP -適切なバージョンのブートストラップクラスを指定しない場合、コンパイラは古い言語仕様 (この例では、バージョン 1.6 の Java プログラミング言語) を新しいブートストラップクラスと組み合わせて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラスファイルが古いプラットフォーム (この場合は Java SE 6) で動作しない可能性があります。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1.6のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。 .LP .SH "関連項目" .LP @@ -1217,33 +1207,33 @@ .TP 2 o .na -\f2「The javac Guide」\fP @ +\f2javacガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html +http://download.oracle.com/javase/7/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) \- APIドキュメント・ジェネレータ .TP 2 o -「jar(1) \- JAR アーカイブツール」 +jar(1) \- JARアーカイブ・ツール .TP 2 o .na -\f2「Java 拡張機能フレームワーク」\fP @ +\f2Java拡張機能フレームワーク\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/extensions/index.html .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/javadoc.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/javadoc.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,74 +19,74 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javadoc 1 "07 May 2011" +.TH javadoc 1 "21 Mar 2012" .SH "名前" -javadoc \- Java API ドキュメントジェネレータ +javadoc \- Java APIドキュメント・ジェネレータ .LP -Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、 Solaris を使用した場合のものです。 +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 -引数を指定する順序は任意です。Javadoc ツールでの、処理対象の .java ファイルを決定する方法の詳細については、「ソースファイルの処理」\f2を参照\fPしてください。 +引数を指定する順序は任意です。Javadocツールでの、処理対象の\f2.java\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」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです (Java 言語仕様を参照)。したがって、ハイフンを含む名前 ( \f2X\-Buffer\fP など) や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。ソースファイル名の前に指定したパスによって、javadoc がそのファイルを検索する場所が決まります。Javadoc ツールは、これらのソースファイル名を検索するときには \f2\-sourcepath\fP を使用しません。相対パスは現在のディレクトリを起点とするため、 \f2Button.java\fP を渡すことは、 \f2./Button.java\fP を渡すことと同じです。ソースファイル名をフルパスで指定すると、 \f2/home/src/java/awt/Graphics*.java のようになります\fP。 「1 つ以上のクラスのドキュメント化」の例を参照してください。また、「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。 +空白文字で区切られた一連のソース・ファイル名です。各ファイルは、パスで始まります。アスタリスク(*)などのワイルドカードを含めることができます。Javadocツールが処理するのは、ファイル名が「.java」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです(Java言語仕様を参照)。したがって、ハイフンを含む名前(\f2X\-Buffer\fPなど)や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト・ファイルやテンプレート・ファイルの場合に便利です。ソース・ファイル名の前に指定したパスによって、javadocがそのファイルを検索する場所が決まります。(Javadocツールは、これらのソース・ファイル名を検索するときに\f2\-sourcepath\fPを使用\f2しません\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 オプションは、このファイルの中では指定できません。 +Javadocオプション、パッケージ名、およびソース・ファイル名を任意の順序で並べたリストが含まれる1つ以上のファイルです。このファイルの中では、ワイルドカード(*)および\f2\-J\fPオプションは指定できません。 .RE -.SH " 説明" +.SH "説明" .LP -\f3Javadoc\fP ツールは、一連の Java ソースファイルにある宣言およびドキュメンテーションコメントを解析し、デフォルトでは public クラス、protected クラス、入れ子にされたクラス (匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。 +\f3Javadoc\fPツールは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトではpublicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。また、API(アプリケーション・プログラミング・インタフェース)ドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 .LP -Javadoc ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fP を使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々ソースファイルに対して javadoc を実行する場合は、一連のソース (.\f2.java\fP) ファイル名を渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadoc によるソースファイルの処理について説明します。 +Javadocツールは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\f2\-subpackages\fPを使用して最上位ディレクトリから下方に再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルのドキュメント化を行うには、ソース(.\f2.java\fP)ファイル名のリストを渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadocによるソース・ファイルの処理について説明します。 .SS -ソースファイルの処理 +ソース・ファイルの処理 .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」ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合だけです。 +Javadocツールは、末尾が「\f2.java\fP」のファイル以外に、ソース・ファイルで記述されている他のファイルも処理します。個々のソース・ファイル名を明示的に渡してJavadocツールを実行する場合、どの\f2.java\fPファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、Javadocツールは3つの方法で実行できます。それは、(1)パッケージ名を渡す、(2)\f2\-subpackages\fPを使用する、(3)ソース・ファイル名でワイルドカードを使用する(\f2*.java\fP)、という方法です。これらの場合、Javadocツールが\f2.java\fPファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 .RS 3 .TP 2 o -名前から接尾辞「\f2.java\fP」を取り除くと、実際に有効なクラス名になっている (Java 言語仕様の有効な文字を参照) +接尾辞「\f2.java\fP」を除いた名前が実際に有効なクラス名である場合(有効な文字については、Java言語仕様を参照) .TP 2 o -ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている +ソース・ツリーのルートから相対的なディレクトリ・パスが、区切り文字をドットに変換すると、実際に有効なパッケージ名である場合 .TP 2 o -パッケージ文には有効なパッケージ名が含まれる (前項目で指定) +package文に有効なパッケージ名(前箇条書きで指定)が含まれる場合 .RE .LP -\f3リンクの処理\fP \- Javadoc ツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。 +\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 パッケージおよびクラスの継承ツリー @@ -95,150 +95,150 @@ 索引 .RE .LP -コマンド行で指定しなかったクラスについての既存のテキスト (別に生成したテキスト) に対してハイパーリンクを追加するには、\f2\-link\fP および \f2\-linkoffline\fP オプションを利用できます。 +コマンドラインで指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してハイパーリンクを追加するには、\f2\-link\fPおよび\f2\-linkoffline\fPオプションを利用できます。 .LP -\f3その他の処理についての詳細\fP \- Javadoc ツールは、実行するたびに 1 つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadoc ツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。ただし、前述のように、以前の実行結果に対してリンクを追加することはできます。 +\f3その他の処理についての詳細\fP \- Javadocツールは、実行するたびに1つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。つまり、Javadocツールの以前の実行結果を修正したり、その内容を\f2直接\fP組み入れたりすることはできません。ただし、前述のように、他の実行結果にリンクすることはできます。 .LP -実装上の理由から、Javadoc ツールは、処理を実行するために java コンパイラを必要とし、java コンパイラに依存しています。Javadoc ツールは、 \f2javac\fP の一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。Javadoc ツールは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報から HTML を生成します。さらに、Javadoc ツールは、ソースコードのドキュメンテーションコメントから、ユーザーの提供したドキュメントも取得します。 +実装上の理由から、Javadocツールは、ジョブを実行するためにjavaコンパイラを必要とし、javaコンパイラに依存しています。Javadocツールは、\f2javac\fPの一部を呼び出して宣言をコンパイルしますが、メンバーの実装は無視します。これは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報からHTMLを生成します。さらに、Javadocツールは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。 .LP -実際には、Javadoc ツールは、メソッド本体を持たない純粋なスタブファイルであるような \f2.java\fP ソースファイルでも動作します。したがって、API の作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーションコメントを記述して javadoc ツールを実行できます。 +実際には、Javadocツールは、メソッド本体を持たない純粋なスタブ・ファイルである\f2.java\fPソース・ファイルに対しても実行できます。したがって、APIの作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーション・コメントを記述してjavadocツールを実行できます。 .LP -コンパイラに依存することによって、HTML 出力は、実際の実装に正確に対応します。実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。たとえば、Javadoc ツールは、.class ファイルには存在するがソースコードには存在しないデフォルトコンストラクタ (Java 言語仕様を参照) \f2をドキュメント化\fP します。 +コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、Javadocツールは、\f2.class\fPファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタ(Java言語仕様を参照)をドキュメント化します。 .LP -通常、Javadoc ツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、Java 言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。このエラーを検出すると、javac コンパイラは停止しますが、Javadoc ツールは警告を出さずに処理を続行します。Javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、DocCheck ドックレットを使用してください。 +通常、Javadocツールでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、\f2Java言語仕様\fPによると、抽象メソッドを含むクラスは、それ自体を抽象として宣言する必要があります。javacコンパイラはこのエラーを検出すると停止しますが、Javadocツールはこのチェックを行わず、警告を出さずに処理を続行します。Javadocツールはドキュメンテーション・コメントの基本的なチェックを行います。ドキュメンテーション・コメントをより詳しくチェックする必要がある場合は、DocCheckドックレットを使用してください。 .LP -Javadoc ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadoc ツールは、ブートストラップクラス、拡張機能、またはユーザークラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、 +Javadocツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadocツールは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。詳細は、 .na -\f2「クラスの検索方法」\fP @ +\f2クラスの検索方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadoc ツールのクラスパス内に置く必要があります。 +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadocツールのクラス・パス内に置く必要があります。 .SS -Javadoc のドックレット +Javadocのドックレット .LP -Javadoc ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadoc ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。標準ドックレットは、HTML 形式の API ドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTF などの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。 +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 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/index.html .TP 2 o -\f2\-doclet\fP コマンド行オプション +\f2\-doclet\fPコマンドライン・オプション .RE .LP -\f2\-doclet\fP コマンド行オプションでカスタムドックレットが指定されていない場合、Javadoc ツールは、デフォルトの標準ドックレットを使用します。javadoc ツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。 +\f2\-doclet\fPコマンドライン・オプションでカスタム・ドックレットが指定されていない場合、Javadocツールは、デフォルトの標準ドックレットを使用します。javadocツールには、使用されているドックレットに関係なく使用できるコマンドライン・オプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンドライン・オプションが追加されます。どちらのオプションについても、後述のオプションで説明します。 .SS 関連ドキュメントおよびドックレット .RS 3 .TP 2 o .na -\f2Javadoc に施された拡張機能\fP @ +\f2Javadocに施された拡張機能\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc 1.4 で追加された改良点の詳細 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/index.html \- Javadocで追加された改良点の詳細。 .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://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html \- ドキュメンテーションコメントの記述方法に関する Sun の規約 +http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html \- ドキュメンテーション・コメントの記述方法に関するSunの規約。 .TP 2 o .na -\f2Requirements for Writing API Specifications\fP @ +\f2API仕様を記述するための要件\fP @ .fi -http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java SE プラットフォーム仕様を記述する際に使用された標準要件この情報は、ソースファイルのドキュメンテーションコメント形式で 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 Gosling、Bill Joy、Guy Steele 共著) の初版の第 18 章「Documentation Comments」を参照してください。この章は、第 2 版では削除されました。 +http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ドキュメンテーション・コメントのオリジナル仕様については、\f2Java Language Specification\fP (James Gosling、Bill Joy、Guy Steele共著)の初版の第18章、Documentation Commentsを参照してください。(この章は、第2版では削除されました。) .TP 2 o .na -\f2DocCheck ドックレット\fP @ +\f2DocCheckドックレット\fP @ .fi -http://www.oracle.com/technetwork/java/javase/documentation/index\-141437.html \- ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Check ユーティリティーの一部です。 +http://www.oracle.com/technetwork/java/javase/documentation/index\-141437.html \- ソース・ファイル内のドキュメンテーション・コメントをチェックし、検出されたエラーや不正のレポートを生成します。Doc Checkユーティリティの一部です。 .TP 2 o .na -\f2MIF ドックレット\fP @ +\f2MIFドックレット\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/ \- MIF、FrameMaker、PDF の書式で API ドキュメントを自動生成します。MIF は Adobe FrameMaker の交換書式です。 +http://java.sun.com/j2se/javadoc/mifdoclet/ \- MIF、FrameMaker、PDFの形式でAPIドキュメントを自動生成します。MIFはAdobe FrameMakerの交換形式です。 .RE .SS 用語 .LP -\f2「ドキュメンテーションコメント」\fP、\f2「doc コメント」\fP、\f2「主説明」\fP、\f2「タグ」\fP、\f2「ブロックタグ」\fP、および\f2「インラインタグ」\fPの用語については、「ドキュメンテーションコメント」で説明します以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。 +\f2ドキュメンテーション・コメント\fP、\f2docコメント\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 コマンドに渡され、アクセス修飾子 (public、protected、package\-private または private) によってフィルタ処理されないようにしなければなりません。ドキュメント化されるクラスは、javadoc ツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。 +ドキュメント化されるクラス(documented classes) +Javadocの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。ドキュメント化するには、ソース・ファイルが使用可能であり、ソース・ファイル名またはパッケージ名をjavadocコマンドに渡す必要があり、アクセス修飾子(public、protected、package\-privateまたはprivate)によってフィルタ処理されないようにする必要があります。ドキュメント化されるクラスは、javadocツールの出力に組み込まれるクラス、つまり\f2包含クラス\fPとも呼ばれます。 .LP .TP 3 -包含クラス (included classes) -ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」と同じ。 +包含クラス(included classes) +Javadocツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。\f2ドキュメント化されるクラス\fPと同じです。 .LP .TP 3 -除外クラス (excluded classes) -ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。 +除外クラス(excluded classes) +Javadocツールの実行によって詳細なドキュメントが生成\f2されない\fPクラスおよびインタフェースのことです。 .LP .TP 3 -参照クラス (referenced classes) -ドキュメント化されるクラスおよびインタフェースの定義 (実装) またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc} タグなどがあります。この定義は +参照クラス(referenced classes) +ドキュメント化されるクラスおよびインタフェースの定義(実装)またはドキュメンテーション・コメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc}タグなどがあります。(この定義は .na \f21.3\fP @ .fi -http://download.oracle.com/javase/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses から変更されています。javadoc ツールを実行するときは、Javadoc のブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。Javadoc ツールは、クラスの存在とそのメンバーの完全指定の名前を判別するのに必要なすべての情報を、.class ファイルから引き出すことができます。 +http://docs.oracle.com/javase/1.3/docs/tooldocs/solaris/javadoc.html#referencedclassesから変更されていることに注意してください。)Javadocツールを実行するときは、Javadocのブート・クラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。(参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。)Javadocツールは、クラスの存在とそのメンバーの完全修飾名を判別するのに必要十分な情報を、.classファイルから引き出すことができます。 .LP .TP 3 -外部参照クラス (external referenced classes) -参照クラスのうち、javadoc ツールの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンド行で Javadoc ツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。たとえば、Javadoc ツールの実行対象が \f2java.awt\fP パッケージのみである場合、 \f2java.lang\fP 内のすべてのクラス ( \f2Object\fPなど) が外部参照クラスになります。外部参照クラスにリンクするには、 \f2\-link\fP および \f2\-linkoffline\fP オプションを使用します。外部参照クラスには、通常そのソースコメントを javadoc ツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。 +外部参照クラス(external referenced classes) +参照クラスのうち、Javadocの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンドラインでJavadocツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、\f2外部参照\fPまたは\f2外部リンク\fPと呼ばれます。たとえば、\f2java.awt\fPパッケージに対してのみJavadocツールを実行した場合、\f2Object\fPなどの\f2java.lang\fP内のすべてのクラスが外部参照クラスになります。外部参照クラスにリンクするには、\f2\-link\fPおよび\f2\-linkoffline\fPオプションを使用します。外部参照クラスには、通常そのソース・コメントをJavadocツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。 .RE -.SH "ソースファイル" +.SH "ソース・ファイル" .LP -Javadoc ツールは 4 種類の異なる「ソース」ファイルから出力を生成します。その 4 種類とは、クラスの Java 言語ソースファイル (\f2.java\fP)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートファイルについても説明します。 +Javadocツールは、4つのタイプの異なる「ソース」ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\f2.java\fP)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 .SS -クラスソースコードファイル +クラス・ソース・コード・ファイル .LP -それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーションコメントを持つことができ、それを \f2.java\fP ファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。 +それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーション・コメントを持つことができ、それを\f2.java\fPファイル内に保持します。ドキュメンテーション・コメントの詳細は、ドキュメンテーション・コメントを参照してください。 .SS -パッケージコメントファイル +パッケージ・コメント・ファイル .LP -それぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 +それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadocツールによって生成されるパッケージの概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 .LP -パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。 +パッケージ・コメント・ファイルを作成する場合、コメントの格納先として、次の2つのファイルのいずれかを選択できます。 .RS 3 .TP 2 o -\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは一般に、package.html よりも推奨されます。 +\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルは一般に、package.htmlよりも推奨されます。 .TP 2 o -\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。 +\f2package.html\fP \- 格納できるのはパッケージ・コメントとJavadocタグのみです。パッケージ注釈は格納できません。 .RE .LP -各パッケージでは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを選択できますが、その両方を選択することはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。 +各パッケージは、\f2package.html\fPファイルまたは\f2package\-info.java\fPファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルを\f2.java\fPファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 .LP -\f4package\-info.java\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントはパッケージ宣言の前に配置します。 +\f4package\-info.java\fP \- このファイルには、次の構造のパッケージ・コメントを格納できます。コメントはパッケージ宣言の前に配置します。 .LP -File: \f2java/applet/package\-info.java\fP +ファイル: \f2java/applet/package\-info.java\fP .nf \f3 .fl @@ -277,90 +277,114 @@ \fP .fi .LP -コメント区切り文字の \f2/**\fP と \f2/*\fP は存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。 +コメント区切り文字の\f2/**\fPと\f2*/\fPは存在している必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。 .LP -\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。 +\f4package.html\fP \- このファイルには、次の構造のパッケージ・コメントを格納できます。コメントは\f2<body>\fP要素内に配置します。 .LP -File: \f2java/applet/package.html\fP +ファイル: \f2java/applet/package.html\fP .nf \f3 .fl -<HTML> <BODY> Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.<p> +<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> .fl The applet framework involves two entities: the applet .fl -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> +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> .fl \fP .fi .LP -これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述しますが、1 つだけ例外があります。それは、このドキュメンテーションコメントには、コメント区切り文字 である \f2/**\fP と \f2*/\fP 、および行頭のアスタリスクを含めてはならない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、 \f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、すべてのブロックタグは、主説明のあとに置かなければなりません。 \f2@see\fP タグをパッケージコメントファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、 +これは単なる通常のHTMLファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージ・コメント・ファイルの内容は、他のすべてのコメントと同様にHTMLで記述しますが、例外が1つあります。それは、このドキュメンテーション・コメントには、コメント区切り文字である\f2/**\fPと\f2*/\fP、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージの概要とし、\f2<body>\fPと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることはできますが、他のドキュメンテーション・コメントと同様、すべてのブロック・タグは、主説明の後に配置する必要があります。\f2@see\fPタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。詳細は、 .na \f2package.html\fPの例 @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#packagecommentsを参照してください。 .LP -\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。 +\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 @ .fi -http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html) +http://download.oracle.com/javase/7/docs/api/java/applet/package\-summary.htmlを参照)。 .TP 2 o -パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例: +パッケージの概要ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します( .na \f2概要の要約\fP @ .fi -http://java.sun.com/javase/6/docs/api/overview\-summary.html)。文の末尾は、クラスやメンバーの主説明の最初の文の末尾と同じ規則によって判断される +http://download.oracle.com/javase/7/docs/api/overview\-summary.htmlを参照)。文の終わりは、クラスやメンバーの主説明の最初の文の終わりと同じルールによって判断されます。 .RE .SS -概要コメントファイル +概要コメント・ファイル .LP -ドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。 +ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadocツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 .LP -概要コメントファイルを作成するには、ファイルに任意の名前 (通常は \f4overview.html\fP) を付け、それを任意の場所 (通常はソースツリーの最上位) に配置できます。たとえば、 \f2java.applet\fP パッケージのソースファイルが \f2/home/user/src/java/applet\fP ディレクトリに格納されていれば、概要コメントファイルは \f2/home/user/src/overview.html に作成できます\fP。 +概要コメント・ファイルを作成するには、ファイルに任意の名前(通常は\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 文目で、そのドキュメンテーションを公開用または内部用として記述できます。 +異なるパッケージのセットに対してJavadocを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\-privateを指定してJavadocを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 .LP -概要コメントファイルの内容は、前述のパッケージコメントファイルと同様、HTML で記述された 1 つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、 \f2<body>\fP と最初の文の間にタイトルその他のテキストを含めないようにします。概要タグを含めることができます。ほかのドキュメンテーションコメントと同じく、 \f2{@link}\fP などのインラインタグを除くすべてのタグは、主説明のあとに配置する必要があります。 \f2@see\fP タグを追加する場合には、完全修飾名を使用する必要があります。 +概要コメント・ファイルの内容は、前述のパッケージ・コメント・ファイルと同様、HTMLで記述された1つの大きなドキュメンテーション・コメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、コメントを書く場合は、最初の文をアプリケーションまたはパッケージ・セットの概要とし、\f2<body>\fPと最初の文の間にタイトルやその他のテキストを含めないようにします。概要タグを含めることができます。他のドキュメンテーション・コメントと同じく、\f2{@link}\fPなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\f2@see\fPタグを追加する場合には、完全修飾名を使用する必要があります。 .LP -Javadoc ツールの実行時に、\-overview オプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。 +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 @ .fi -http://java.sun.com/javase/6/docs/api/overview\-summary.html) +http://download.oracle.com/javase/7/docs/api/overview\-summary.htmlを参照)。 .TP 2 o -概要ページの先頭に、概要コメントの最初の文をコピーする +概要ページの先頭に、概要コメントの最初の文をコピーします。 .RE .SS その他の未処理のファイル .LP -ソースには、Javadoc ツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。一般に、このようなファイルには、グラフィックファイル、サンプルの Java ソース (.java) およびクラス (.class) ファイル、内容が通常の Java ソースファイルのドキュメンテーションコメントの影響を受けない独立した HTML ファイルなどがあります。 +ソースには、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 つも存在していません。 +未処理のファイルを含めるには、それらのファイルを\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 のドキュメンテーションコメント内のリンクは、次のようになります。 +これらの未処理のファイルへのリンクは、すべてハードコードする必要があります。これは、Javadocツールがそれらのファイルを見ずに、ディレクトリとその内容を宛先にそのままコピーするからです。たとえば、\f2Button.java\fPのドキュメンテーション・コメント内のリンクは、次のようになります。 .nf \f3 .fl @@ -375,15 +399,15 @@ \fP .fi .SS -テストファイルおよびテンプレートファイル +テスト・ファイルおよびテンプレート・ファイル .LP -一部の開発者から、テストファイルおよびテンプレートファイルを対応するソースファイルの近くのソースツリーに保存したいという要望がありました。つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに保存したいということです。 +一部の開発者から、テスト・ファイルおよびテンプレート・ファイルを対応するソース・ファイルの近くのソース・ツリーに保存したいという要望がありました。つまり、これらのソース・ファイルと同じディレクトリまたはサブディレクトリに保存したいということです。 .LP -個別のソースファイル名で明示的に渡して Javadoc ツールを実行する場合は、テストファイルおよびテンプレートファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイルおよびテンプレートファイルが処理されないようにする必要があります。 +個々のソース・ファイル名で明示的に渡してJavadocツールを実行する場合、テスト・ファイルおよびテンプレート・ファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、特定のルールに従って、これらのテスト・ファイルおよびテンプレート・ファイルが処理されないようにする必要があります。 .LP -テストファイルとテンプレートファイルの違いは、テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、テンプレートファイルは、そうではないという点です。ただし、テンプレートファイルも「.java」で終わることができます。 +テスト・ファイルとテンプレート・ファイルの違いは、テスト・ファイルは、有効でコンパイル可能なソース・ファイルであるのに対して、テンプレート・ファイルは、そうではないという点です。ただし、テンプレート・ファイルも「.java」で終わることができます。 .LP -\f3テストファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテストファイルをそのパッケージのソースファイルと同じディレクトリに配置したいと考えています。しかしテストファイルは、名前なしパッケージなど、ソースファイルパッケージとは別のパッケージに属させたいとも考えています (そのため、テストファイルには package ステートメントがないか、またはソースとは別の package ステートメントがある)。このような状況では、コマンド行で指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テストファイルは警告またはエラーを引き起こします。そのようなテストファイルはサブディレクトリに配置する必要があります。たとえば、 \f2com.package1\fP 内のソースファイルに対するテストファイルを追加する場合は次のように、ハイフンを含んでいるためにパッケージ名としては無効であるようなサブディレクトリ内に、それらのファイルを配置します。 +\f3テスト・ファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテスト・ファイルをそのパッケージのソース・ファイルと\f2同じ\fPディレクトリに配置したいと考えています。しかしテスト・ファイルは、名前なしパッケージなど、ソース・ファイル・パッケージとは別のパッケージに属させたいとも考えています(そのため、テスト・ファイルにはpackage文がないか、またはソースとは別のpackage文があります)。このような状況では、コマンドラインで指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テスト・ファイルは警告またはエラーを引き起こします。そのようなテスト・ファイルはサブディレクトリに配置する必要があります。たとえば、\f2com.package1\fP内のソース・ファイルに対するテスト・ファイルを追加する場合は、次のようにハイフンを含んでいるためにパッケージ名としては無効な名前のサブディレクトリ内に配置します。 .nf \f3 .fl @@ -392,184 +416,184 @@ \fP .fi .LP -こうすると、Javadoc ツールでは警告なしで test ディレクトリをスキップします。 +これで、Javadocツールは警告なしでtestディレクトリをスキップします。 .LP -テストファイルに doc コメントが含まれる場合、次のようにワイルドカードを含んだテストソースファイル名で渡してテストファイルのドキュメントを生成するように、Javadoc ツールを別個に実行できるように設定できます。たとえば、 \f2com/package1/test\-files/*.java などです\fP。 +テスト・ファイルにドキュメンテーション・コメントが含まれる場合、Javadocツールの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\f2com/package1/test\-files/*.java\fPなど)で渡してテスト・ファイルのドキュメントを生成するように設定できます。 .LP -\f3ソースファイルのテンプレート\fP \- テンプレートファイルの名前は「.java」で終わることもありますが、テンプレートファイルはコンパイルできません。ソースディレクトリ内に保持したいソースファイルのテンプレートがある場合は、 \f2Buffer\-Template.java\fP のようにハイフンやその他の無効な Java 文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadoc ツールが処理するのは、「.java」接尾辞を除いた名前が 正規のクラス名であるソースファイルだけであるためです (Java 言語仕様の「Identifiers」に関する情報を参照)。 +\f3ソース・ファイルのテンプレート\fP \- テンプレート・ファイルの名前は「.java」で終わることもありますが、テンプレート・ファイルはコンパイルできません。ソース・ディレクトリ内に保持したいソース・ファイルのテンプレートがある場合は、\f2Buffer\-Template.java\fPのようにハイフンやその他の無効なJava文字を名前に含めることで、テンプレートが処理されないようにします。これは、Javadocツールが処理するのは、「.java」接尾辞を除いた名前が有効なクラス名であるソース・ファイルのみであるためです(Java言語仕様の識別子に関する情報を参照)。 .SH "生成されるファイル" .LP -デフォルトでは、javadoc ツールは、HTML 形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。それぞれの HTML ページは、個々のファイルに相当します。javadoc が生成するファイルの名前には、クラスやインタフェースの名前にちなんだものと、そうでないもの ( \f2package\-summary.html など\fP) の 2 種類があります。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。 +デフォルトでは、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) +ドキュメント化するクラスまたはインタフェースごとに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 テキストをすべて組み入れます。 +ドキュメント化するパッケージごとに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 フレーム」を参照してください。 +パッケージのセット全体に対して1つの\f3概要ページ\fP(\f2overview\-summary.html\fP)。これは、生成ドキュメントの先頭ページになります。Javadocツールは、\f2\-overview\fPオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。このファイルは、Javadocに複数のパッケージ名を渡した場合にのみ作成されます。詳細は、HTMLフレームを参照してください。 .RE .LP \f3相互参照ページ\fP .RS 3 .TP 2 o -\f3パッケージのセット全体に対して 1 つのクラス階層ページ\fP (\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーションバーの [概要] をクリックしてから、[階層ツリー] をクリックします。 +\f3パッケージのセット全体に対して1つのクラス階層ページ\fP(\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーション・バーの「概要」をクリックしてから、「階層ツリー」をクリックします。 .TP 2 o -\f3パッケージごとに 1 つのクラス階層ページ\fP (\f2package\-tree.html\fP)。これを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、[階層ツリー] をクリックしてそのパッケージの階層を表示させます。 +\f3パッケージごとに1つのクラス階層ページ\fP(\f2package\-tree.html\fP)。このページを表示するには、特定のパッケージ、クラス、またはインタフェースのページに移動し、「階層ツリー」をクリックしてそのパッケージの階層を表示します。 .TP 2 o -\f3パッケージごとに 1 つの [使用] ページ\fP (\f2package\-use.html\fP) と、クラスおよびインタフェースごとに 1 つずつの [使用] ページ (\f2class\-use/\fP\f2クラス名\fP\f2.html\fP)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。クラスまたはインタフェース A を例にして考えると、その [使用] ページには、A のサブクラス、A として宣言されたフィールド、A を返すメソッド、A 型のパラメータを持つメソッドおよびコンストラクタが表示されます。 このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの [使用] リンクをクリックします。 +\f3パッケージごとに1つの「使用」ページ\fP(\f2package\-use.html\fP)と、クラスおよびインタフェースごとに1つずつの「使用」ページ(\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 は、将来の実装では削除される可能性があります。 +\f3非推奨APIページ\fP(\f2deprecated\-list.html\fP)。推奨されない名前がすべてリストされます。(非推奨名は、一般に改良されたために使用が推奨されていないAPIの名前であり、通常、それに置き換わる名前が提示されています。非推奨APIは、将来の実装では削除される可能性があります。) .TP 2 o -\f3定数フィールド値ページ\fP (\f2constant\-values.html\fP)。static フィールドの値用です。 +\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 クラスの完全に直列化されたクラスを生成できます。 +\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オプションの指定\f2なし\fPでJavadocツールを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。 .TP 2 o -\f3索引\fP (\f2index\-*.html\fP)。すべてのクラス、インタフェース、コンストラクタ、フィールド、およびメソッドの名前がアルファベット順に並んでいます。索引は、Unicode を扱えるように国際化されています。1 つのファイルとして生成することも、先頭文字 (英語の場合 A ~ Z) ごとに別々のファイルとして生成することもできます。 +\f3索引\fP(\f2index\-*.html\fP)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引は、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\-Z)ごとに別々のファイルとして生成することもできます。 .RE .LP -\f3サポートファイル\fP +\f3サポート・ファイル\fP .RS 3 .TP 2 o -\f3ヘルプページ\fP (\f2help\-doc.html\fP)。ナビゲーションバーや前述の各ページに関する説明が記載されています。デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供するには、\f2\-helpfile\fP を使用します。 +\f3ヘルプ・ページ\fP(\f2help\-doc.html\fP)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。\f2\-helpfile\fPを使用すると、デフォルトのヘルプ・ファイルに代わる独自のカスタム・ヘルプ・ファイルを提供できます。 .TP 2 o -表示用の HTML フレームを作成する 1 つの \f3index.html ファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。 +表示用のHTMLフレームを作成する1つの\f3index.htmlファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト・コンテンツは含まれていません。 .TP 2 o -複数の\f3フレームファイル\fP (\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTML フレームを表示するときに使用されます。 +複数の\f3フレーム・ファイル\fP(\f2*\-frame.html\fP)。パッケージ、クラス、およびインタフェースのリストが含まれています。HTMLフレームを表示するときに使用されます。 .TP 2 o -\f3パッケージリスト\fPファイル (\f2package\-list\fP)。 \f2\-link\fP および \f2\-linkoffline\fP オプションで使用されます。これは、HTML ファイルではなくテキストファイルであり、どのリンクからもアクセスできません。 +\f3パッケージ・リスト\fPファイル(\f2package\-list\fP)。\f2\-link\fPおよび\f2\-linkoffline\fPオプションで使用されます。これは、HTMLファイルではなくテキスト・ファイルであり、どのリンクからもアクセスできません。 .TP 2 o -\f3スタイルシート\fPファイル (\f2stylesheet.css\fP)。生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。 +\f3スタイルシート\fP・ファイル(\f2stylesheet.css\fP)。生成されるページの一部の要素について色、フォント・ファミリ、フォント・サイズ、フォント・スタイル、および配置を制御します。 .TP 2 o -\f3doc\-files\fP ディレクトリ。生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。これらのファイルは、Javadoc ツールによって処理されないため、ファイル内に javadoc タグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。 +\f3doc\-files\fPディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルがすべて格納されます。これらのファイルは、いかなる方法でもJavadocツールによって処理されません。つまり、ファイル内にjavadocタグがあっても無視されます。このディレクトリは、ソース・ツリーの中に存在する場合にのみ生成されます。 .RE .LP -\f3HTML フレーム\fP +\f3HTMLフレーム\fP .LP -Javadoc ツールは、下の図に示すように、2 ~ 3 つの HTML フレームを生成します。1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。単一のパッケージに属するソースファイル (*.java) または単一のパッケージ名を引数として javadoc コマンドに渡す場合は、左側の列にクラスの一覧を表示するフレーム (C) 1 つだけが作成されます。Javadoc に複数のパッケージ名を渡した場合は、概要ページ (Detail) に加えて、すべてのパッケージを一覧表示する第 3 のフレーム (P) が作成されます。この概要ページのファイル名は、 \f2overview\-summary.html です\fP。したがって、このファイルは、2 つ以上のパッケージ名を渡した場合にだけ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.html を最初に表示すると、フレームを省略できます。 +Javadocツールは、下の図に示すように、2、3個のHTMLフレームを生成します。1つのパッケージしかない場合(またはパッケージがない場合)は、パッケージのリストを省略することによって最低限必要な数のフレームを作成します。つまり、単一のパッケージに属するソース・ファイル(*.java)または単一のパッケージ名を引数としてjavadocコマンドに渡す場合は、左側の列にクラスのリストを表示するフレーム(C)が1つのみ作成されます。Javadocに複数のパッケージ名を渡した場合は、概要ページ(Detail)に加えて、すべてのパッケージをリストする第3のフレーム(P)が作成されます。この概要ページのファイル名は、\f2overview\-summary.html\fPです。したがって、このファイルは、複数のパッケージ名を渡した場合にのみ作成されます。「フレームなし」リンクをクリックするか、overview\-summary.htmlを最初に表示すると、フレームを省略できます。 .LP -HTML フレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、「印刷」メニューコマンドを使ってそのフレームを印刷したりできます。 +HTMLフレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに\f2フォーカス\fPが必要であることに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。これで、多くのブラウザでは、矢印キーやページ・キーを使用してそのフレームをスクロールしたり、「印刷」メニュー・コマンドを使用してそのフレームを印刷したりできます。 .LP -HTML フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。 +HTMLフレームが必要かどうかによって、次のいずれかのファイルを開始ページとしてロードします。 .RS 3 .TP 2 o -\f2index.html\fP (フレームあり) +\f2index.html\fP(フレームあり) .TP 2 o -\f2overview\-summary.html\fP (フレームなし) +\f2overview\-summary.html\fP(フレームなし) .RE .LP \f3生成されるファイルの構造\fP .LP -生成されるクラスファイルおよびインタフェースファイルは、Java ソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1 つのサブパッケージにつき 1 つのディレクトリ、という構造になります。 +生成されるクラス・ファイルおよびインタフェース・ファイルは、Javaソース・ファイルおよびクラス・ファイルと同じディレクトリ階層に編成されます。1つのサブパッケージにつき1つのディレクトリ、という構造になります。 .LP -たとえば、 \f2java.applet.Applet\fP クラス用に生成されたドキュメントは、 \f2java/applet/Applet.html\fP に格納されます。生成先のディレクトリの名前が \f2apidocs\fP だとすると、java.applet パッケージのファイル構造は、その下に構築されます。前述のように、「frame」という語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外の HTML ファイルは、すべて右側のフレームに表示されます。 +たとえば、\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 ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。 +注意 \- ディレクトリは\f3太字\fPで示しています。アスタリスク(\f2*\fP)は、Javadocへの引数がパッケージ名ではなくソース・ファイル名(*.java)である場合に\f2省略される\fPファイルおよびディレクトリを示しています。また、引数がソース・ファイル名の場合、\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 Top directory +.fl + index.html Initial page that sets up HTML frames +.fl + * overview\-summary.html Lists all packages with first sentence summaries +.fl + overview\-tree.html Lists class hierarchy for all packages +.fl + deprecated\-list.html Lists deprecated API for all packages +.fl + constant\-values.html Lists values of static fields for all packages +.fl + serialized\-form.html Lists serialized form for all packages +.fl + * overview\-frame.html Lists all packages, used in upper\-left frame +.fl + allclasses\-frame.html Lists all classes for all packages, used in lower\-left frame +.fl + help\-doc.html Lists user help for how these pages are organized +.fl + index\-all.html Default index created without \-splitindex option +.fl + \f3index\-files\fP Directory created with \-splitindex option +.fl + index\-<number>.html Index files created with \-splitindex option +.fl + package\-list Lists package names, used only for resolving external refs +.fl + stylesheet.css HTML style sheet for defining fonts, colors and positions +.fl + \f3java\fP Package directory +.fl + \f3applet\fP Subpackage directory +.fl + Applet.html Page for Applet class +.fl + AppletContext.html Page for AppletContext interface +.fl + AppletStub.html Page for AppletStub interface +.fl + AudioClip.html Page for AudioClip interface +.fl + * package\-summary.html Lists classes with first sentence summaries for this package +.fl + * package\-frame.html Lists classes in this package, used in lower left\-hand frame +.fl + * package\-tree.html Lists class hierarchy for this package +.fl + package\-use Lists where this package is used +.fl + \f3doc\-files\fP Directory holding image and example files +.fl + \f3class\-use\fP Directory holding pages API is used +.fl + Applet.html Page for uses of Applet class +.fl + AppletContext.html Page for uses of AppletContext interface +.fl + AppletStub.html Page for uses of AppletStub interface +.fl + AudioClip.html Page for uses of AudioClip interface +.fl + \f3src\-html\fP Source code directory +.fl + \f3java\fP Package directory +.fl + \f3applet\fP Subpackage directory +.fl + Applet.html Page for Applet source code +.fl + AppletContext.html Page for AppletContext source code +.fl + AppletStub.html Page for AppletStub source code +.fl + AudioClip.html Page for AudioClip source code .fl .fi .SS -生成される API 宣言 +生成されるAPI宣言 .LP -Javadoc ツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、その API 用の宣言を生成します。たとえば、 \f2Boolean\fP クラスの宣言は、次のようになります。 +Javadocツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\f2Boolean\fPクラスの宣言は、次のようになります。 .LP \f2public final class Boolean\fP .br @@ -577,20 +601,20 @@ .br \f2implements Serializable\fP .LP -また、 \f2Boolean.valueOf\fP メソッドの宣言は、次のようになります。 +また、\f2Boolean.valueOf\fPメソッドの宣言は、次のようになります。 .LP \f2public static Boolean valueOf(String s)\fP .LP -Javadoc ツールでは、修飾子 \f2public\fP、 \f2protected\fP、 \f2private\fP、 \f2abstract\fP、 \f2final\fP、 \f2static\fP、 \f2transient\fP、および \f2volatile\fP は組み込めますが、 \f2synchronized\fP と \f2native\fP は組み込めません。これら後者の 2 つの修飾子は、実装の詳細と見なされているため、API 仕様には含まれません。 +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 "ドキュメンテーションコメント" +APIでは、並行性セマンティクスについて、キーワード\f2synchronized\fPに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つの\f2Enumeration\fPを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\f2Hashtable\fPはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。バケット・レベルで内部的に同期化する権限を保有しておく必要があります。そうすれば、より高度な並行性が提供されます。 +.SH "ドキュメンテーション・コメント" .LP -オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。 +オリジナルの「ドキュメンテーション・コメントの仕様」は、関連項目を参照してください。 .SS -ソースコードへのコメントの挿入 +ソース・コードへのコメントの挿入 .LP -ソースコードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーションコメント ("doc comments") を記述することができます。各パッケージにドキュメンテーションコメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadoc コメント」と呼ばれています (この用語は商標関連の使用法に違反)。ドキュメンテーションコメントは、コメントを始まりを示す文字列 \f2/**\fP と、コメントを終わりを示す文字列 \f2*/\fP の間にある文字から構成されます。行の先頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。 +ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、\f2ドキュメンテーション・コメント\fP("doc comments")を記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、非公式に「Javadocコメント」と呼ばれています(この用語は商標関連の使用方法に違反)。ドキュメンテーション・コメントは、コメントを始まりを示す文字列\f2/**\fPと、コメントを終わりを示す文字列\f2*/\fPの間にある文字から構成されます。行頭のアスタリスクは、各行に記述できます。詳細は、後述します。コメントのテキストは、複数行にわたって記述できます。 .nf \f3 .fl @@ -605,18 +629,18 @@ \fP .fi .LP -次のようにして 1 行に記述すると、スペースを節約できます。 +スペースを節約するには、コメントを1行に入れます。 .nf \f3 .fl -/** This comment takes up only one line.*/ +/** This comment takes up only one line. */ .fl \fP .fi .LP -\f3コメントの配置\fP \- ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。javadoc ツールでは、1 つの宣言文につき 1 つのドキュメンテーションコメントだけが認識されます。 +\f3コメントの配置\fP \- ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにのみ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。Javadocツールでは、1つの宣言文につき1つのドキュメンテーション・コメントのみが認識されます。 .LP -よくある間違いは、クラスコメントとクラス宣言の間に \f2import\fP 文を置いてしまうことです。このような記述はしないでください。このようなクラスコメントは無視されます。 +よくある間違いは、クラス・コメントとクラス宣言の間に\f2import\fP文を置いてしまうことです。このような記述はしないでください。このようなクラス・コメントは無視されます。 .nf \f3 .fl @@ -639,7 +663,7 @@ \fP .fi .LP -\f3ドキュメンテーションコメントは主説明のあとにタグセクションが続く \- コメントの開始区切り文字である\fP \f2/**\fP のあとからタグセクションまでが主説明になります。タグセクションは、行の先頭にある最初の \f2@\fP で定義される最初のブロックタグから始まります (先頭のアスタリスク、空白、先頭の区切り文字 \f2/**\fP は除く)。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1 回しか記述できないタグがあります。たとえば、次の \f2@see\fP は、タグセクションを開始しています。 +\f3ドキュメンテーション・コメントは\fP\f4主説明\fP\f3の後に\fP\f4タグ・セクション\fP\f3が続く\fP \- 開始区切り文字である\f2/**\fPの後からタグ・セクションまでが\f2主説明\fPになります。\f2タグ・セクション\fPは、先頭文字が\f2@\fPの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\f2/**\fPは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\f2@see\fPからタグ・セクションは始まります。 .nf \f3 .fl @@ -654,7 +678,7 @@ \fP .fi .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 が含まれています。 +\f3ブロック・タグとインライン・タグ\fP \- \f2タグ\fPは、Javadocツールが処理できる、ドキュメンテーション・コメント内の特別なキーワードです。タグには2つのタイプがあります。1つは\f2@tag\fPのように表記されるブロック・タグ(「スタンドアロン・タグ」とも呼ばれる)、もう1つは\f2{@tag}\fPのように中括弧で囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\f2/**\fP)を除いて、行の先頭に置く必要があります。これは、\f2@\fP文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\f2@\fP文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\f2@\fPを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\f2@deprecated\fPとインライン・タグ\f2{@link}\fPが含まれています。 .nf \f3 .fl @@ -667,11 +691,11 @@ \fP .fi .LP -\f3コメントは HTML で記述する\fP \- テキストは HTML 形式で記述しなければなりません。これは、HTML のエンティティーを使う必要があること、および HTML タグを使用できることを意味します。記述する HTML のバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディングスタイルシート (CSS) とフレームを含め、すべての部分 (ドキュメンテーションコメント以外の部分) で HTML 3.2 に準拠したコードを生成するように作成されています。ただし、フレームセット対応のため、生成される各ファイルには「HTML 4.0」と記述されます。 +\f3コメントはHTMLで記述する\fP \- テキストはHTMLで記述する必要があります。これは、HTMLのエンティティを使用する必要があること、およびHTMLタグを使用できることを意味します。HTMLのバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。標準ドックレットは、カスケーディング・スタイル・シートおよびフレームを含め、ドキュメンテーション・コメント以外の部分でHTML 3.2に準拠したコードを生成するように作成されています。(ただし、フレーム・セット対応のため、生成される各ファイルには「HTML 4.0」と先頭に記述されます。) .LP -たとえば、より小さい (\f2<\fP) 記号およびより大きい (\f2>\fP) 記号のエンティティーは、 \f2<\fP および \f2>\fP と記述すべきです。同様に、アンパサンド (\f2&\fP) は \f2&\fP と記述すべきです。次の例ではボールドの HTML タグ \f2<b>\fP が示されています。 +たとえば、より小さい(\f2<\fP)記号およびより大きい(\f2>\fP)記号のエンティティは、\f2<\fPおよび\f2>\fPと記述する必要があります。同様に、アンパサンド(\f2&\fP)は\f2&\fPと記述する必要があります。次の例では、太字のHTMLタグ\f2<b>\fPを使用しています。 .LP -次に、ドキュメンテーションコメントを示します。 +次に、ドキュメンテーション・コメントを示します。 .nf \f3 .fl @@ -686,11 +710,11 @@ \fP .fi .LP -\f3行頭のアスタリスク\fP \- javadoc によるドキュメンテーションコメントの解析時に、各行の先頭にあるアスタリスク (\f2*\fP) 文字は破棄されます。最初のアスタリスク (\f2*\fP) 文字より前にある空白やタブも破棄されます。バージョン 1.4 からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーションコメントの \f2<PRE>\fP タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は左マージンになります (区切り文字 \f2/**\fP または \f2<PRE>\fP タグではなく)。 +\f3行頭のアスタリスク\fP \- Javadocによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(\f2*\fP)文字は破棄されます。最初のアスタリスク(\f2*\fP)文字より前にある空白やタブも破棄されます。バージョン1.4からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーション・コメントの\f2<PRE>\fPタグ内に張り付けても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\f2/**\fPまたは\f2<PRE>\fPタグではなく)左マージンになります。 .LP -\f3最初の文\fP \- 各ドキュメンテーションコメントの最初の文は、宣言されているエンティティーに関する簡潔かつ完全な要約文である必要があります。この「最初の文」は、直後にスペース、タブ、または改行が続く最初のピリオド (ロケールが英語に設定されている場合)、または最初のタグがある位置で終わります。最初の文は、Javadoc ツールによって HTML ページの最初にあるメンバーの概要の部分にコピーされます。 +\f3最初の文\fP \- 各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全な要約文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、JavadocツールによってHTMLページの先頭にあるメンバーの概要の部分にコピーされます。 .LP -\f3複数フィールドの宣言\fP \- Java では、1 つの文で複数のフィールドを宣言できます。ただし、この文には、1 つのドキュメンテーションコメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。たとえば、次のドキュメンテーションコメントは、1 つの宣言として記述すると不適切です。この場合は、宣言を 2 つに分けることをお勧めします。 +\f3複数フィールドの宣言\fP \- Javaでは、1つの文で複数のフィールドを宣言できます。ただし、この文には、1つのドキュメンテーション・コメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーション・コメントを記述する必要がある場合は、各フィールドを別々の文で宣言する必要があります。たとえば、次のドキュメンテーション・コメントは、1つの宣言として記述すると不適切です。この場合は、宣言を2つに分けることをお薦めします。 .nf \f3 .fl @@ -705,7 +729,7 @@ \fP .fi .LP -上記のコードからは、次のようなドキュメントが生成されます。 +上のコードからは、次のようなドキュメントが生成されます。 .nf \f3 .fl @@ -725,80 +749,80 @@ The horizontal and vertical distances of point (x,y) .RE .LP -\f3見出しタグはなるべく使用しない\fP \- メンバーに対してドキュメンテーションコメントを記述するときには、<H1> や <H2> などの HTML 見出しタグは、なるべく使わないでください。 Javadoc ツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。 +\f3見出しタグの使用には要注意\fP \- メンバーに対してドキュメンテーション・コメントを記述するときには、<H1>や<H2>などのHTML見出しタグを使用しないことをお薦めします。Javadocツールは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 .SS -メソッドコメントの自動コピー +メソッド・コメントの自動コピー .LP -Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。 +Javadocツールには、次の2つの場合に、クラスおよびインタフェースのメソッド・コメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 .RS 3 .TP 2 o -\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、 \f2@return\fP タグ、 \f2@param\fP タグ、または \f2@throws\fP タグがメソッドコメントに見つからない場合、Javadoc ツールは、オーバーライドまたは実装している場合はその対象となるメソッドから、対応する主説明またはタグコメントを、次のアルゴリズムに従ってコピーします。 +\f3自動的にコメントを継承して見つからないテキストを埋める\fP \- 主説明、\f2@return\fPタグ、\f2@param\fPタグ、または\f2@throws\fP タグがメソッド・コメントに見つからない場合、Javadocツールは、メソッドをオーバーライドまたは実装している場合はそのメソッドから、対応する主説明またはタグ・コメントを、次のアルゴリズムに従ってコピーします。 .LP -厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、その例外が宣言されている場合にかぎり、 \f2@throws\fP タグがコピーされます。 +厳密には、特定のパラメータの\f2@param\fPタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\f2@throws\fPタグが見つからない場合、その例外が宣言されている場合に\f2かぎり\fP、\f2@throws\fPタグがコピーされます。 .LP -この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。 +この動作はバージョン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 -ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。 +ドキュメンテーション・コメントを実際にコピーに利用するには、継承したメソッドのソース・ファイルが\-sourcepathで指定したパスのみに置かれている必要があります。コマンドラインで、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスであることが必要だった1.3.x以前のリリースと異なります。 .LP -\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。 +\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の3つの場合に、コメントの継承が行われます。 .RS 3 .TP 2 o -クラスのメソッドがスーパークラスのメソッドをオーバーライドしている +クラスのメソッドがスーパークラスのメソッドをオーバーライドしている場合 .TP 2 o -インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている +インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている場合 .TP 2 o -クラスのメソッドがインタフェースのメソッドを実装している +クラスのメソッドがインタフェースのメソッドを実装している場合 .RE .LP -最初の 2 つのケース (メソッドがオーバーライドしている場合) では、Javadoc ツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。 +最初の2つのケース(メソッドがオーバーライドしている場合)では、Javadocツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。 .LP -3 つ目のケース (特定のクラスのメソッドがインタフェースのメソッドを実装している場合) では、javadoc ツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。 +3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、Javadocツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。 .LP -\f3メソッドの説明が継承されるアルゴリズム\fP \- あるメソッドにドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、Javadoc ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。 このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。 +\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 -.SH "javadoc タグ" +.SH "javadocタグ" .LP -Javadoc ツールは、Java のドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーションタグを使うと、書式の整った完全な API ドキュメントをソースコードから自動的に生成できます。タグは「アットマーク」記号 (\f2@\fP) で始まり、大文字と小文字の区別があります。タグは、大文字と小文字を使用して、表示されているとおりに入力する必要があります。タグは、行の先頭 (先行する空白と省略可能なアスタリスクは除く) に置かなければなりません。慣例として、同じ名前のタグは 1 か所にまとめて記述するようにします。たとえば、 \f2@see\fP タグはすべて同じ場所に配置します。 +Javadocツールは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーション・タグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグは「アットマーク」記号(\f2@\fP)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、通常のテキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\f2@see\fPタグが複数ある場合は、すべて同じ場所にまとめて配置します。 .LP -タグには 2 つのタイプがあります。 +タグには次の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 今後のリリースで導入されるタグについては、 .na -\f2「Proposed Javadoc Tags」\fP @ +\f2提案されているタグ\fP @ .fi http://java.sun.com/j2se/javadoc/proposed\-tags.htmlを参照してください。 .LP @@ -822,26 +846,6 @@ .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 -\f3導入された JDK/SDK のバージョン\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 @@ -886,6 +890,8 @@ .80 .rm 80 .nr 81 0 +.nr 38 \w\f3導入されたJDK/SDK\fP +.if \n(81<\n(38 .nr 81 \n(38 .nr 38 \w1.0 .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \w1.5 @@ -926,11 +932,6 @@ .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 -.35 -.nf -.ll \n(34u .nr 38 1n .nr 79 0 .nr 40 \n(79+(0*\n(38) @@ -938,7 +939,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 851 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 873 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -952,22 +953,10 @@ .ls .. .ec -.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タグ\fP\h'|\n(41u' -.mk ## -.nr 31 \n(## -.sp |\n(##u-1v -.nr 37 (\n(41u+\n(81u-\n(a-u)/2u -.in +\n(37u -.a+ -.in -\n(37u -.mk 32 -.if \n(32>\n(31 .nr 31 \n(32 -.sp |\n(31u +\&\h'|\n(40u'\f3タグ\fP\h'|\n(41u'\f3導入されたJDK/SDK\fP .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -1048,41 +1037,40 @@ .nr T. 1 .T# 1 .35 -.rm a+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-44 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-42 .LP -カスタムタグについては、\-tag オプションを参照してください。 +カスタム・タグについては、\-tagオプションを参照してください。 .RS 3 .TP 3 @author\ name\-text -\-author オプションが使用されている場合、指定された \f2name\-text\fP を含む [作成者] エントリを生成ドキュメントに追加します。1 つのドキュメンテーションコメントに複数の \f2@author\fP タグを含めることができます。1 つの \f2@author\fP タグに 1 つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。 +\-authorオプションが使用されている場合、生成ドキュメントに「作成者」エントリを追加して、指定された\f2name\-text\fPを書き込みます。1つのドキュメンテーション・コメントに複数の\f2@author\fPタグを含めることができます。1つの\f2@author\fPタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、Javadocツールによって名前と名前の間にカンマ(\f2,\fP)と空白文字が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときは、1つのタグに複数の名前を指定してください。 .RE .LP -詳細については、「タグを使用できる場所」および +詳細は、タグを使用できる場所および .na -\f2@author タグのドキュメント\fP @ +\f2@authorタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@authorを参照してください。 .LP .RS 3 .TP 3 -@deprecated\ deprecated\-text 注: @Deprecated 注釈を使って特定のプログラム要素を非推奨にできます。 +@deprecated\ deprecated\-text 注意: @Deprecated注釈を使用して、プログラム要素を非推奨にできます。 .RE .LP -この API は動作し続けますが、この API を使用するべきではないことを示すコメントを追加します。Javadoc ツールは、 \f2deprecated\-text\fP を主説明の前に移動してイタリックにし、その前にボールドの警告「推奨されません。」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。Javadocツールは、\f2deprecated\-text\fPを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .LP -\f2deprecated\-text\fP の最初の文では、少なくとも、その API が推奨されなくなった時期と、代替使用するべき API を読者に提示する必要があります。Javadoc ツールは、この最初の文だけを、概要セクションと索引にコピーします。そのあとの文では、その API が推奨されない理由を説明することもできます。代わりのAPI を指し示す \f2{@link}\fP タグ ( Javadoc 1.2 以降の場合) を含めるべきです。 +\f2deprecated\-text\fPの最初の文では、少なくとも、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。Javadocツールは、この最初の文のみを、概要セクションと索引にコピーします。その後の文では、推奨されない理由を説明することもできます。かわりのAPIを指し示す\f2{@link}\fPタグ(Javadoc 1.2以降の場合)を含める必要があります。 .LP -詳細については、 +詳細は、 .na -\f2@deprecated タグのドキュメント\fP @ +\f2@deprecatedタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@deprecatedを参照してください。 .RS 3 .TP 2 o -Javadoc 1.2 以降では \f2{@link}\fP タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。次に例を示します。 +Javadoc 1.2以降では、\f2{@link}\fPタグを使用します。これにより、必要な場所にインラインでリンクを作成できます。次に例を示します。 .nf \f3 .fl @@ -1098,21 +1086,21 @@ .fi .TP 2 o -Javadoc 1.1 の場合の標準形式は、 \f2@see\fP タグ (インラインは不可) を \f2@deprecated\fP タグごとに作成することです。 +Javadoc 1.1では、\f2@see\fPタグ(インラインは不可)を\f2@deprecated\fPタグごとに作成するのが標準の形式です。 .RE .LP -推奨されないタグについての詳細は、 +推奨されないタグの詳細は、 .na -\f2@deprecated タグ\fP @ +\f2@deprecatedタグ\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。 .LP .RS 3 .TP 3 {@code\ text} -\f2<code>{@literal}</code>\fP と同等です。 +\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) などです。たとえば、次のドキュメンテーションコメント +テキストをHTMLマークアップまたはネストされたjavadocタグとして解釈せずに、\f2text\fPを\f2コード\fP・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\f2<Object>\fP)、不等号(\f23 < 4\fP)、矢印(\f2<\-\fP)などで、通常の山括弧(\f2<\fPおよび\f2>\fP)をHTMLエンティティ(\f2<\fPおよび\f2>\fP)のかわりに使用できます。たとえば、次のドキュメンテーション・コメント .nf \f3 .fl @@ -1123,7 +1111,7 @@ \fP .fi .LP -は、生成された HTML ページで、次のようにそのまま表示されます。 +は、生成されたHTMLページで、次のようにそのまま表示されます。 .nf \f3 .fl @@ -1134,19 +1122,19 @@ \fP .fi .LP -ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。 +ここで注目に値するのは、\f2<B>\fPが太字として解釈されず、そのフォントはコード・フォントになる、という点です。 .LP -コードフォントなしで同じ機能を実現するには、\f2{@literal}\fP を使用します。 +コード・フォントなしで同じ機能を実現するには、\f2{@literal}\fPを使用します。 .LP .TP 3 {@docRoot} -生成されるページから見た、生成ドキュメントの (生成先の) ルートディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの下部から著作権のページにリンクします。 +生成されるページからの、生成ドキュメントの(生成先)ルート・ディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの最下部から著作権のページにリンクします。 .LP -この \f2{@docRoot}\fP タグは、コマンド行でもドキュメンテーションコメント内でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +この\f2{@docRoot}\fPタグは、コマンドラインでもドキュメンテーション・コメント内でも使用できます。このタグは、@return、@param、@deprecatedなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .RS 3 .TP 3 1. -コマンド行では、ヘッダー、フッター、またはボトムノートは次のように定義します。 +コマンドラインでは、ヘッダー、フッター、またはボトムは次のように定義します。 .nf \f3 .fl @@ -1157,10 +1145,10 @@ \fP .fi .LP -注 \- \f2{@docRoot}\fP を Makefile 内でこのように利用する場合、一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする必要があります。たとえば、Inprise MAKE バージョン 5.2 を Windows 上で実行する場合は、 \f2{{@docRoot}} のように、中括弧を二重にする必要があります\fP。さらに、 \f2\-bottom\fP などのオプションに対する引数を、単一引用符ではなく二重引用符で囲む必要もあります ( \f2href\fP の引数を囲む引用符は省略)。 +注意 \- \f2{@docRoot}\fPをMakefile内でこのように利用する場合、一部のMakefileプログラムでは、中括弧{ }文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5.2をWindows上で実行する場合は、\f2{{@docRoot}}\fPのように、中括弧を二重にする必要があります。さらに、\f2\-bottom\fPなどのオプションに対する引数を、一重引用符ではなく二重引用符で囲む必要もあります(\f2href\fP引数を囲む引用符は省略)。 .TP 3 2. -ドキュメンテーションコメントの中では、次のように使用します。 +ドキュメンテーション・コメントの中では、次のように使用します。 .nf \f3 .fl @@ -1176,7 +1164,7 @@ .fi .RE .LP -このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。次に例を示します。 +このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式 .nf \f3 .fl @@ -1187,22 +1175,22 @@ \fP .fi .LP -次のように解決されます。 +は、次のように解決されます。 .nf \f3 .fl - <a href="../../copyright.html"> java/lang/Object.java の場合 + <a href="../../copyright.html"> for java/lang/Object.java .fl .fl \fP .fi .LP -かつ +および .nf \f3 .fl - <a href="../../../copyright.html"> java/lang/ref/Reference.java の場合 + <a href="../../../copyright.html"> for java/lang/ref/Reference.java .fl .fl @@ -1211,93 +1199,93 @@ .LP .TP 3 @exception\ class\-name\ description -\f2@exception\fP タグは \f2@throws\fP と同義です。 +\f2@exception\fPタグは、\f2@throws\fPと同義です。 .LP .TP 3 {@inheritDoc}\ -もっとも近い継承可能なクラスまたは実装可能なインタフェースから、このタグの現在のドキュメンテーションコメントに、ドキュメントを継承 (コピー) します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使って記述することができます。 +最も近い継承可能なクラスまたは実装可能なインタフェースから、このタグの位置にある現在のドキュメンテーション・コメントに、ドキュメントを継承(コピー)します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使用して記述することができます。 .LP -このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。 +このタグは、ドキュメンテーション・コメントの次の位置でのみ有効です。 .RS 3 .TP 2 o -メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる +メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされます。 .TP 2 o -メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる +メソッドの@return、@param、@throwsタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 .RE .LP -継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。 +継承階層でコメントを見つける方法に関する正確な説明は、メソッド・コメントの自動コピーを参照してください。このタグが見つからない場合、コメントは、この項で説明するルールに応じて、自動的に継承されるかどうかが決まります。 .LP .TP 3 {@link\ package.class#member\ label} -表示テキスト \f2label\fP とのインラインリンクを挿入します。label は、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +表示テキスト\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 エンティティーの「}」を使います。 +このタグは\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 などの任意のタグのテキスト部分で使うことができます。 +1つ文の中で使用できる\f2{@link}\fPタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または@deprecated、@return、@paramなどの任意のタグのテキスト部分で使用できます。 .LP -たとえば、次のコメントでは \f2getComponentAt(int, int)\fP メソッドを参照しています。 +たとえば、次のコメントでは\f2getComponentAt(int,int)\fPメソッドを参照しています。 .nf \f3 .fl -{@link #getComponentAt(int, int) getComponentAt} メソッドを使用します。 +Use the {@link #getComponentAt(int, int) getComponentAt} method. .fl .fl \fP .fi .LP -標準ドックレットでは、上記のコメントから次の HTML が生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。 +標準ドックレットでは、上のコメントから次のHTMLが生成されます(このコメントが同じパッケージの別のクラスを参照している場合)。 .nf \f3 .fl -<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> メソッドを使用します。 +Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method. .fl .fl \fP .fi .LP -この HTML は、Web ページ上では次のように表示されます。 +これは、Webページ上では次のように表示されます。 .nf \f3 .fl -getComponentAt メソッドを使用します。 +Use the getComponentAt method. .fl .fl \fP .fi .LP -\f2{@link}\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。 +\f2{@link}\fPを拡張してドキュメント化されないクラスにリンクするには、\f2\-link\fPオプションを使用します。 .LP -詳細については、 +詳細は、 .na -\f2{@link} タグのドキュメント\fP @ +\f2{@link}タグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#{@link}を参照してください。 .LP .TP 3 {@linkplain\ package.class#member\ label} -リンクのラベルがコードフォントではなくプレーンテキストで表示される点以外は \f2{@link}\fP と同じです。ラベルがプレーンテキストで記述されていると便利です。次の例を参照してください。例: +リンクのラベルがコード・フォントではなくプレーン・テキストで表示される点以外は\f2{@link}\fPと同じです。ラベルがプレーン・テキストで記述されていると便利です。例: .nf \f3 .fl - {@linkplain add() the overridden method} を参照してください。 + Refer to {@linkplain add() the overridden method}. .fl .fl \fP .fi .LP -これは以下のように表示されます。 +これは次のように表示されます。 .LP -the overridden method を参照してください。 +Refer to the overridden method. .LP .TP 3 {@literal\ text} -テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、 \f2text\fP を表示します。このため、ドキュメンテーションコメント内で通常の山括弧 (\f2<\fP および \f2>\fP) を HTML エンティティー (\f2<\fP および \f2>\fP) の代わりに使用できます。たとえば、パラメータの型 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、矢印 (\f2<\-\fP) などです。たとえば、次のドキュメンテーションコメント +テキストをHTMLマークアップまたはネストされたjavadocタグとして解釈せずに、\f2text\fPを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\f2<Object>\fP)、不等号(\f23 < 4\fP)、矢印(\f2<\-\fP)などで、通常の山括弧(\f2<\fPおよび\f2>\fP)をHTMLエンティティ(\f2<\fPおよび\f2>\fP)のかわりに使用できます。たとえば、次のドキュメンテーション・コメント .nf \f3 .fl @@ -1308,19 +1296,19 @@ \fP .fi .LP -は、生成された HTML ページはブラウザで次のようにそのまま表示されます。 +は、ブラウザで生成されたHTMLページに次のようにそのまま表示されます。 .LP \f2\ \ \ \ \ \fPA<B>C .LP -ここで注目すべき点は、 \f2<B>\fP が太字として解釈されず、そのフォントはコードフォントになる、という点です。 +ここで注目に値するのは、\f2<B>\fPが太字として解釈されず、そのフォントはコード・フォントにならない、という点です。 .LP -コードフォントで同じ機能を実現するには、\f2{@code}\fP を使用します。 +コード・フォントで同じ機能を実現するには、\f2{@code}\fPを使用します。 .LP .TP 3 @param\ parameter\-name description -指定された \f2parameter\-name\fP のあとに指定された \f2description\fP が続くパラメータを、[パラメータ] セクションに追加します。ドキュメンテーションコメントを記述するときには、 \f2description\fP を複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスの doc コメント内でのみ有効です。 +「パラメータ」セクションに、指定された\f2parameter\-name\fPの後に指定された\f2description\fPを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、\f2description\fPを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。 .LP -\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。山括弧でパラメータ名を囲むと、型パラメータを使用することを 指定します。 +\f2parameter\-name\fPは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山括弧でこのパラメータ名を囲み、型パラメータを使用することを指定します。 .LP クラスの型パラメータの例: .nf @@ -1366,29 +1354,29 @@ \fP .fi .LP -詳細については、 +詳細は、 .na -\f2@param タグのドキュメント\fP @ +\f2@paramタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@paramを参照してください。 .LP .TP 3 @return\ description -[戻り値] セクションを追加して、 \f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。 +「戻り値」セクションを追加して、\f2description\fPのテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーション・コメントでのみ有効です。 .LP -詳細については、 +詳細は、 .na -\f2@return タグのドキュメント\fP @ +\f2@returnタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@returnを参照してください。 .LP .TP 3 @see\ reference -「関連項目」見出しを追加し、 \f2reference を指すリンクか、またはテキストエントリを書き込みます\fP。ドキュメンテーションコメントには任意の数の \f2@see\fP タグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。 \f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバーに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。 +「関連項目」見出しを追加して、\f2reference\fPを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\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)かどうかを調べて、この形式を前述の形式と区別します。次に例を示します。 .nf \f3 .fl @@ -1408,12 +1396,12 @@ .RS 3 .TP 3 関連項目: -The Java Programming Language +"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 つの形式と区別します。たとえば、 +\f2URL\fP#\f2value\fPで定義されたとおりにリンクを追加します。\f2URL\fP#\f2value\fPは、相対URLまたは絶対URLです。Javadocツールは、最初の文字が「より小さい」記号(\f2<\fP)かどうかを調べて、この形式を他の形式と区別します。次に例を示します。 .nf \f3 .fl @@ -1429,23 +1417,23 @@ .RE .TP 3 @see\ package.class#member\ label -可視のテキスト \f2label\fP を持つリンクを追加します。このリンクは、参照先となる、指定された Java 言語の名前のドキュメンテーションを指します。 \f2label\fP は省略可能です。label を省略すると、リンク先のメンバーの名前が適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。\-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。 +表示テキスト\f2label\fPとともにリンクを追加します。このリンクは、指定された名前を持つ、参照されているJava言語のメンバーのドキュメントを指します。\f2label\fPは省略可能です。labelを省略すると、名前がかわりに表示テキストとして適切に短縮されて表示されます。名前が表示される方法を参照してください。\-noqualifierを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。 .LP -バージョン 1.2 だけは、ラベルではなく、名前が <code> HTML タグ内に自動的に表示されます。 1.2.2 からは、ラベルを使用するか、しないかにかかわらず、<code> は常に表示テキストを囲むかたちで、含まれます。 +バージョン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 形式のうちのどちらかを使用します。この引数については、このあとの「名前の指定」で詳しく説明します。 +\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 が、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 +\f4label\fPは、省略可能なテキストで、リンクのラベルとして表示されます。\f2label\fPには空白を含めることができます。\f2label\fPを省略すると、\f2package.class.member\fPが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。名前が表示される方法を参照してください。 .TP 2 o -空白が、 \f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 +空白文字が、\f2package.class\fP\f2#\fP\f2member\fPと\f2label\fPの間の区切り文字になります。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 .RE .LP -\f3例\fP \- この例では、 \f2@see\fP タグ ( \f2Character\fP クラス内) が String クラスの \f2equals\fP メソッド \f2を参照\fP しています。このタグには名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。 +\f3例\fP \- この例では、\f2@see\fPタグ(\f2Character\fPクラス内)が、\f2String\fPクラスの\f2equals\fPメソッドを参照しています。タグには、名前「\f2String#equals(Object)\fP」とラベル「\f2equals\fP」の両方の引数が含まれています。 .nf \f3 .fl @@ -1457,7 +1445,7 @@ .fl \fP .fi -標準ドックレットは、次のような HTML を生成します。 +標準ドックレットは、次のようなHTMLを生成します。 .nf \f3 .fl @@ -1471,16 +1459,16 @@ .fl \fP .fi -これは、ブラウザでは次のように表示され、ラベルがリンクテキストになります。 +これは、ブラウザでは次のように表示され、ラベルが表示リンク・テキストになります。 .RS 3 .TP 3 関連項目: equals .RE .LP -\f3名前の指定\fP \- この \f2package.class\fP\f2#\fP\f2member\fP という名前は、 \f2java.lang.String#toUpperCase()\fP のような完全修飾名にすることも、 \f2String#toUpperCase()\fP や \f2#toUpperCase()\fP のような非完全修飾名にすることもできます。名前が完全指定されていない場合、Javadoc ツールは、Java コンパイラの通常の検索順序でその名前を検索します。詳細は、このあとの「@see の検索順序」を参照してください。名前には、メソッドの複数の引数の間など、括弧の内側であれば空白を含めることができます。 +\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 にはメソッドまたはコンストラクタを、それぞれ指定できます。 +「部分的に修飾」した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次の表に、様々な形式の名前を示します。ここで、\f2Class\fPにはクラスまたはインタフェースを、\f2Type\fPにはクラス、インタフェース、配列、またはプリミティブを、\f2method\fPにはメソッドまたはコンストラクタを、それぞれ指定できます。 .LP .LP .TS @@ -1511,7 +1499,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 @@ -1527,9 +1515,9 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3現在のクラスのメンバーを参照する\fP -.br -\f2@see\fP\ \f2#\fP\f2フィールド\fP +\f3現在のクラスのメンバーを参照する\ \ \ \ \ \ \fP +.br +\f2@see\fP\ \f2#\fP\f2field\fP .br \f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP .br @@ -1553,21 +1541,21 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3現在の、またはインポートされたパッケージの別のクラスを参照する\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2フィールド\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type,\ Type,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP -.br -\f2@see\fP\ \f2クラス\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP +\f3現在の、またはインポートされたパッケージの別のクラスを参照する\ \ \ \ \ \ \ \ \fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP +.br +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP .br \f2@see\fP\ \f2Class.NestedClass\fP .br -\f2@see\fP\ \f2クラス\fP +\f2@see\fP\ \f2Class\fP .br .di .nr c| \n(dn @@ -1583,9 +1571,8 @@ .ll \n(34u*1u/2u .if \n(.l<\n(80 .ll \n(80u .in 0 -\f3別のパッケージの要素を参照する\fP\ (完全修飾) -.br -\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2フィールド\fP +\f3別のパッケージの要素を参照する\fP\ (完全修飾)\ \ \ \ .br +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP .br \f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP .br @@ -1599,7 +1586,7 @@ .br \f2@see\fP\ \f2package.Class\fP .br -\f2@see\fP\ \f2パッケージ\fP +\f2@see\fP\ \f2package\fP .br .di .nr d| \n(dn @@ -1628,7 +1615,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 1342 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1364 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1721,46 +1708,46 @@ .RS 3 .TP 2 o -最初の種類の形式 (パッケージとクラスを省略) の場合、Javadoc ツールは、現在のクラスの階層だけを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、または現在のクラスかインタフェースを囲んでいるクラスかインタフェースからメンバーを検索します (このあとの検索手順 1 ~ 3)。現在のパッケージのほかの部分や、ほかのパッケージは検索しません (検索手順 4 ~ 5)。 +最初のタイプの形式(パッケージとクラスを省略)の場合、Javadocツールは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索手順1\-3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索手順4\-5)。 .TP 2 o -メソッドまたはコンストラクタの指定時に、 \f2getValue\fP のように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadoc ツールによってその名前へのリンクが正しく作成されますが、括弧や引数の追加をユーザーに促すための警告メッセージが表示されます。このメソッドがオーバーロードされている場合、Javadoc ツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 +メソッドまたはコンストラクタの入力時に、\f2getValue\fPのように括弧なしの名前を使用した場合、同じ名前のフィールドが存在していなければ、Javadocツールはその名前へのリンクを正しく作成しますが、括弧と引数の追加を促す警告メッセージを出力します。このメソッドがオーバーロードされている場合、Javadocツールは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 .TP 2 o -入れ子になったクラスは、すべての形式について、 \f2outer\fP\f2.\fP\f2inner\fP として指定する必要があります。単純に \f2inner\fP とはしないでください。 +ネストされたクラスは、すべての形式について、\f2outer\fP\f2.\fP\f2inner\fPとして指定する必要があります。単純に\f2inner\fPとはしないでください。 .TP 2 o -すでに述べたように、\f2クラスとメンバーとの間の区切り文字としては、\fPドット (\f2.\fP) ではなくシャープ文字 (#) を使用します。このように指定すると、Javadoc ツールは、あいまいさを解決できます。ドットは、クラス、入れ子にされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されます。ただし、Javadoc ツールでは一般に許容範囲が広く、あいまいさがなければ、ドットでも正しく解析されます。その場合でも警告は表示されます。 +すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\f2.\fP)ではなくシャープ文字(\f2#\fP)を使用します。このように指定すると、Javadocツールは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、Javadocツールでは一般に許容範囲が広く、あいまいさがなければドットは正しく解析されます。その場合でも、警告は表示されます。 .RE .LP -\f3@see の検索順序\fP \- Javadoc ツールは、ソースファイル (.java)、パッケージファイル (package.html または package\-info.java) または概要ファイル (overview.html) に含まれる \f2@see\fP タグを処理します。後者の 2 つのファイルでは、完全指定の名前を \f2@see\fP タグに指定しなければなりません。ソースファイルでは、完全指定の名前、または部分指定の名前を指定できます。 +\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 ツールは、特定の名前空間のあいまいさを検出しません。 これは、ソースコードにこれらのエラーが存在していないことを前提としているためです。この検索順序は、\f2Java 言語仕様\fPで正式に定義されています。Javadoc ツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてから名前を検索します。具体的には、次の順序で検索します。 +Javadocツールは、完全修飾\f2でない\fP名前が記述された\f2@see\fPタグを\f2.java\fPファイル内で見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、Javadocツールは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、\f2Java言語仕様\fPで正式に定義されています。Javadocツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 .RS 3 .TP 3 1. 現在のクラスまたはインタフェース .TP 3 2. -外側を囲んでいるクラスとインタフェース (もっとも近いものから検索) +外側を囲んでいるクラスとインタフェース(最も近いものから検索) .TP 3 3. -スーパークラスとスーパーインタフェース (もっとも近いものから検索) +スーパークラスとスーパーインタフェース(最も近いものから検索) .TP 3 4. 現在のパッケージ .TP 3 5. -インポートされているパッケージ、クラス、およびインタフェース (import 文の順序に従って検索) +インポートされているパッケージ、クラス、およびインタフェース(import文の順序に従って検索) .RE .LP -Javadoc ツールは、各クラスについて手順 1 ~ 3 を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にそのクラスを囲んでいるクラス E を検索し、その次に E のスーパークラスを検索し、さらにその次に E を囲んでいるクラスを検索します。 手順 4 と 5 では、1 つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません。その順序は、個々のコンパイラによって異なります。手順 5 では、Javadoc ツールは、java.lang を検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 +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 はそのパッケージ内での検索を行いません。 +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 メソッドに、同じクラスのメンバーへの参照とほかのクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースだけです (次の表を参照)。 +\f3名前が表示される方法\fP \- \f2label\fPを省略すると、\f2package.class.member\fPが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。「短縮される」とは、必要最小限の名前のみが表示されるということです。たとえば、\f2String.toUpperCase()\fPメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次の表を参照)。 .LP -パッケージ名を広域的に削除するには、\-noqualifier を使用します。 +パッケージ名を全体的に削除するには、\-noqualifierを使用します。 .br .LP .TS @@ -1791,7 +1778,7 @@ .ll \n(34u*1u/4u .if \n(.l<\n(81 .ll \n(81u .in 0 -\f4String.toUpperCase() での例\fP +\f4String.toUpperCase()\fP\f3での例\fP .br .di .nr a| \n(dn @@ -1807,7 +1794,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 @@ -1823,7 +1810,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 @@ -1839,7 +1826,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 @@ -1871,7 +1858,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 @@ -1887,7 +1874,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 @@ -1919,7 +1906,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 @@ -1930,7 +1917,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 @@ -1974,7 +1961,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 1418 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 1440 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1993,7 +1980,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 @@ -2113,13 +2100,13 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-28 .LP -\f3@see の例\fP -.br -右側のコメントは、 \f2@see\fP タグが \f2java.applet.Applet\fP などの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。 +\f3@seeの例\fP +.br +右側のコメントは、\f2@see\fPタグが\f2java.applet.Applet\fPなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。 .nf \f3 .fl - 関連項目: + See also: .fl @see java.lang.String // String \fP\f3 .fl @@ -2141,11 +2128,11 @@ .fl \fP .fi -\f2@see\fP を拡張してドキュメント化されないクラスへのリンクも可能にするには、\f2\-link\fP オプションを使用します。 +\f2@see\fPを拡張してドキュメント化されないクラスにリンクするには、\f2\-link\fPオプションを使用します。 .LP -詳細については、 +詳細は、 .na -\f2@see タグのドキュメント\fP @ +\f2@seeタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@seeを参照してください。 .RE @@ -2154,53 +2141,53 @@ .RS 3 .TP 3 @serial\ field\-description | include | exclude -デフォルトの直列化可能フィールドのドキュメンテーションコメントで使用します。 +デフォルトの直列化可能フィールドのドキュメンテーション・コメントで使用します。 .LP -\f2field\-description\fP (省略可能) では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式のページに追加します。 +\f2field\-description\fP(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。 .LP -クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 +クラスを直列化した後しばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 .LP -\f2include\fP および \f2exclude\fP 引数は、直列化された形式のページにクラスまたはパッケージを含めるか除外するかを示します。これらの引数には、次のような効果があります。 +\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とマークされていないかぎり、\f2含められます\fP。 .TP 2 o -\f2Serializable\fP を実装している private または package\-private クラスは、そのクラス (またはそのパッケージ) が \f2@serial include\fP として マークされていないかぎり、除外されます。 +\f2Serializable\fPを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\f2@serial include\fPとマークされていないかぎり、\f2除外されます\fP。 .RE .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 としてマークされています。 +例: \f2javax.swing\fPパッケージは(\f2package.html\fPまたは\f2package\-info.java\fP内で)\f2@serial exclude\fPとマークされています。publicクラス\f2java.security.BasicPermission\fPは\f2@serial exclude\fPとマークされています。package\-privateクラス\f2java.util.PropertyPermissionCollection\fPは\f2@serial include\fPとマークされています。 .LP -クラスレベルで指定された @serial タグは、パッケージレベルで指定された @serial タグをオーバーライドします。 +クラス・レベルで指定された@serialタグは、パッケージ・レベルで指定された@serialタグをオーバーライドします。 .LP -これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節 +これらのタグの使用方法の詳細と使用例は、\f2Javaオブジェクト直列化仕様\fPの第1.6項 .na -\f2「クラスの直列化可能なフィールドおよびデータの文書化」\fP @ +\f2クラスの直列化可能なフィールドおよびデータの文書化\fP @ .fi -http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、 +http://download.oracle.com/javase/7/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、 .na -\f2「直列化の FAQ」\fP @ +\f2直列化のFAQ\fP @ .fi -http://java.sun.com/javase/technologies/core/basic/serializationFAQ.jsp#javadoc_warn_missingも参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、 +http://java.sun.com/javase/technologies/core/basic/serializationFAQ.jsp#javadoc_warn_missingも参照してください。このFAQには、「\-privateスイッチを指定しないでjavadocを実行しているのにprivateフィールドの@serialタグが見つからないというjavadocの警告が表示される」などの一般的な質問への回答が記載されています。直列化された形式の仕様にクラスを含める場合には、 .na -\f2「Sun の仕様」\fP @ +\f2Sunの基準\fP @ .fi http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlも参照してください。 .LP .TP 3 @serialField\ field\-name\ field\-type\ field\-description -Serializable \f2クラスの\fP serialPersistentFields \f2メンバーの\fP ObjectStreamField コンポーネント \f2をドキュメント化\fP します。1 つの \f2@serialField\fP タグを各 \f2ObjectStreamField\fP コンポーネントで使用すべきです。 +\f2Serializable\fPクラスの\f2serialPersistentFields\fPメンバーの\f2ObjectStreamField\fPコンポーネントをドキュメント化します。各\f2ObjectStreamField\fPコンポーネントに対して1つの\f2@serialField\fPタグを使用する必要があります。 .LP .TP 3 @serialData\ data\-description -\f2data\-description\fP は、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、 \f2writeObject\fP メソッドによって書き込まれる省略可能なデータ、および \f2Externalizable.writeExternal\fP メソッドによって書き込まれるすべてのデータ (基底クラスも含む) が含まれます。 +\f2data\-description\fPは、直列化された形式でのデータの型と順序を説明するテキストです。具体的に言うと、このデータには、\f2writeObject\fPメソッドによって書き込まれる省略可能なデータ、および\f2Externalizable.writeExternal\fPメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 .LP -\f2@serialData\fP タグは、 \f2writeObject\fP、 \f2readObject\fP、 \f2writeExternal\fP、 \f2readExternal\fP、 \f2writeReplace\fP、および \f2readResolve\fP メソッドのドキュメンテーションコメント内で使用できます。 +\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。たとえば、 +生成ドキュメントに「導入されたバージョン」見出しを追加して、指定された\f2since\-text\fPを書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\f2since\-text\fPによって指定されたソフトウェア・リリース以降、存在していることを意味します。次に例を示します。 .nf \f3 .fl @@ -2211,25 +2198,25 @@ \fP .fi .LP -Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。 +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 タグを使用できます。 +\f2@throws\fPタグと\f2@exception\fPタグは同義です。生成ドキュメントに「スロー」小見出しを追加して、\f2class\-name\fPおよび\f2description\fPのテキストを書き込みます。\f2class\-name\fPは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、Javadocツールは、検索順序に従ってクラスを探します。同じまたは異なる例外の特定のドキュメンテーション・コメントで、複数の\f2@throws\fPタグを使用できます。 .LP -すべてのチェック済み例外がドキュメント化されるようにするために、 \f2@throws\fP タグが throws 節内の例外用に存在しない場合は、@throws タグのあるドキュメントであるかのように、Javadoc ツールによって例外が HTML 出力に説明なしで自動的に追加されます。 +すべてのチェック済み例外がドキュメント化されるようにするために、\f2@throws\fPタグがthrows節内の例外用に存在しない場合は、@throwsタグでドキュメント化されたかのように、Javadocツールによって例外がHTML出力に説明なしで自動的に追加されます。 .LP -オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、 \f2@throws\fP ドキュメンテーションがそのメソッドからサブクラスにコピーされます。インタフェースメソッドから実装メソッドにコピーされる場合も同様です。@throws にドキュメンテーションを継承させるには、{@inheritDoc} を使用できます。 +オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\f2@throws\fPのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。@throwsにドキュメントを継承させるには、{@inheritDoc}を使用できます。 .LP -詳細については、 +詳細は、 .na -\f2@throws タグのドキュメント\fP @ +\f2@throwsタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@exceptionを参照してください。 .LP .TP 3 {@value\ package.class#field} -\f2{@value}\fP が静的フィールドの doc コメントで 引数なしで使用されている場合、その定数の値が表示されます。 +\f2{@value}\fPが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値が表示されます。 .nf \f3 .fl @@ -2246,7 +2233,7 @@ \fP .fi .LP -任意のドキュメンテーションコメント内で引数 \f2package.class#field\fP ありで使用された場合は、その指定された定数の値が表示されます。 +任意のドキュメンテーション・コメント内で引数\f2package.class#field\fPありで使用された場合は、その指定された定数の値が表示されます。 .nf \f3 .fl @@ -2265,36 +2252,36 @@ \fP .fi .LP -引数 \f2package.class#field\fP は、@see 引数と同一の形式になります。ただし、メンバーが静的フィールドになければならない点が異なります。 +引数\f2package.class#field\fPは、@see引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 .LP これらの定数での値は、 .na \f2定数フィールド値\fP @ .fi -http://java.sun.com/javase/6/docs/api/constant\-values.htmlページにも表示されます。 +http://download.oracle.com/javase/7/docs/api/constant\-values.htmlページにも表示されます。 .LP .TP 3 @version\ version\-text -\-version オプションが使用されると、生成ドキュメントに [バージョン] 小見出しを追加し、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。 \f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。 +\-versionオプションが使用されている場合、生成ドキュメントに「バージョン」小見出しを追加して、指定された\f2version\-text\fPを書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています(これに対し、@sinceは、このコードが導入されたバージョン番号を保持します)。\f2version\-text\fPには、特別な内部構造はありません。バージョン・タグを使用できる場所を調べるには、タグを使用できる場所を参照してください。 .LP -1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。意味が失われない範囲内で、1 つの \f2@version\fP タグに 1 つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって名前と名前の間にコンマ (\f2,\fP) と空白が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。 +1つのドキュメンテーション・コメントに複数の\f2@version\fPタグを含めることができます。必要に応じて、1つの\f2@version\fPタグに1つのバージョン番号を指定することも、複数のバージョン番号を指定することもできます。前者の場合は、Javadocツールによって名前と名前の間にカンマ(\f2,\fP)と空白文字が挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときは、1つのタグに複数の名前を指定してください。 .LP -詳細については、 +詳細は、 .na -\f2@version タグのドキュメント\fP @ +\f2@versionタグのドキュメント\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#@versionを参照してください。 .RE .SS タグを使用できる場所 .LP -ここでは、タグを使用できる場所について説明します。すべてのドキュメンテーションコメントで使用可能なタグは次のとおりです。 \f2@see\fP、 \f2@since\fP、 \f2@deprecated\fP、 \f2{@link}\fP、 \f2{@linkplain}\fP、および \f2{@docroot}\fP。 +ここでは、タグを使用できる場所について説明します。\f2@see\fP、\f2@since\fP、\f2@deprecated\fP、\f2{@link}\fP、\f2{@linkplain}\fP、および\f2{@docroot}\fPは、すべてのドキュメンテーション・コメントで使用できます。 .SS -概要のドキュメンテーションタグ +概要のドキュメンテーション・タグ .LP -概要タグは、概要ページのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは、通常 \f2overview.html\fP という名前のソースファイル内にあります。 ほかのドキュメンテーションコメントの場合と同様に、これらのタグは、主説明のあとで使う必要があります。 +概要タグは、概要ページのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは、通常\f2overview.html\fPという名前のソース・ファイル内にあります)。他のドキュメンテーション・コメントの場合と同様に、これらのタグは、主説明の後で使用する必要があります。 .LP -\f3注\fP \- バージョン 1.2 では、概要ドキュメント内の \f2{@link}\fP タグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、 \f2{@docRoot}\fP タグは、概要ドキュメント内では動作しません。 +\f3注意\fP \- バージョン1.2では、概要ドキュメント内の\f2{@link}\fPタグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\f2{@docRoot}\fPタグは、概要ドキュメント内では機能しません。 .LP \f3概要タグ\fP .RS 3 @@ -2321,11 +2308,11 @@ \f2{@docRoot}\fP .RE .SS -パッケージドキュメンテーションタグ +パッケージ・ドキュメンテーション・タグ .LP -パッケージタグは、パッケージのドキュメンテーションコメントで使用できるタグです。このドキュメンテーションコメントは \f2package.html\fP または \f2package\-info.java\fP という名前のソースファイル内にあります。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。 +パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは\f2package.html\fPまたは\f2package\-info.java\fPという名前のソース・ファイル内にあります)。ここで使用できる\f2@serial\fPタグは、\f2include\fPまたは\f2exclude\fP引数を指定したもののみです。 .LP -\f3パッケージタグ\fP +\f3パッケージ・タグ\fP .RS 3 .TP 2 o @@ -2353,11 +2340,11 @@ \f2{@docRoot}\fP .RE .SS -クラスおよびインタフェースドキュメンテーションタグ +クラスおよびインタフェース・ドキュメンテーション・タグ .LP -次に、クラスまたはインタフェースのドキュメンテーションコメントで使用できるタグを示します。ここで使用できる \f2@serial\fP タグは、 \f2include\fP または \f2exclude\fP 引数が指定されたものだけです。 +次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。ここで使用できる\f2@serial\fPタグは、\f2include\fPまたは\f2exclude\fP引数を指定したもののみです。 .LP -\f3クラスおよびインタフェースタグ\fP +\f3クラスおよびインタフェース・タグ\fP .RS 3 .TP 2 o @@ -2387,7 +2374,7 @@ o \f2{@docRoot}\fP .RE -\f3次にクラスコメントの例を示します。\fP +\f3クラス・コメントの例:\fP .nf \f3 .fl @@ -2426,11 +2413,11 @@ \fP .fi .SS -フィールドドキュメンテーションタグ +フィールド・ドキュメンテーション・タグ .LP -次に、フィールドのドキュメンテーションコメントで使用できるタグを示します。 +次に、フィールドのドキュメンテーション・コメントで使用できるタグを示します。 .LP -\f3フィールドタグ\fP +\f3フィールド・タグ\fP .RS 3 .TP 2 o @@ -2460,7 +2447,7 @@ o \f2{@value}\fP .RE -\f3次にフィールドコメントの例を示します。\fP +\f3フィールド・コメントの例:\fP .nf \f3 .fl @@ -2479,11 +2466,11 @@ \fP .fi .SS -コンストラクタおよびメソッドドキュメンテーションタグ +コンストラクタおよびメソッド・ドキュメンテーション・タグ .LP -次に、コンストラクタまたはメソッドのドキュメンテーションコメントで使用できるタグを示します。ただし、 \f2@return\fP はコンストラクタでは使用できず、 \f2{@inheritDoc}\fP には特定の制限があります。 \f2@serialData\fP タグは特定の直列化メソッドの doc コメントでのみ使用できます。 +次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\f2@return\fPはコンストラクタでは使用できず、\f2{@inheritDoc}\fPには特定の制限があります。\f2@serialData\fPタグは特定の直列化メソッドのドキュメンテーション・コメントでのみ使用できます。 .LP -\f3メソッドおよびコンストラクタタグ\fP +\f3メソッドおよびコンストラクタ・タグ\fP .RS 3 .TP 2 o @@ -2502,7 +2489,7 @@ \f2@return\fP .TP 2 o -\f2@throws\fP と \f2@exception\fP +\f2@throws\fPと\f2@exception\fP .TP 2 o \f2@serialData\fP @@ -2519,7 +2506,7 @@ o \f2{@docRoot}\fP .RE -\f3次にメソッドのドキュメンテーションコメントの例を示します。\fP +\f3メソッドのドキュメンテーション・コメントの例:\fP .nf \f3 .fl @@ -2555,7 +2542,7 @@ .fi .SH "オプション" .LP -javadoc ツールは、ドックレットを使って出力を決定します。Javadoc ツールは、\-doclet オプションでカスタムドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使います。Javadoc ツールには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、このあとの「Javadoc オプション」で説明します。標準ドックレットでは、このほかに、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、そのあとの「標準ドックレットが提供するオプション」で説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 +Javadocツールは、ドックレットを使用して出力を決定します。Javadocツールは、\-docletオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。Javadocツールには、任意のドックレットとともに使用できるコマンドライン・オプションがあります。これらのオプションについては、後述のJavadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンドライン・オプションが提供されます。これらのオプションについては、後述の標準ドックレットが提供するオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 .LP オプションは次のとおりです。 .LP @@ -2773,7 +2760,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 1993 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 2015 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2831,47 +2818,46 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-127 .LP -\f2イタリック\fP で示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。 +\f2イタリック\fPで示されたオプションは、Javadocの基本オプションであり、Javadocツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。 .SS -Javadoc オプション +Javadocオプション .RS 3 .TP 3 \-overview \ path/filename -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 +Javadocに対して、\f2path/filename\fPで指定された「ソース」ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(\f2overview\-summary.html\fP)に配置するように指定します。\f2path/filename\fPは、現在のディレクトリからの相対パスです。 +.br +.br +\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に配置できます。使用例を参照してください。 +.br +.br +\f2path/filename\fPで指定するファイルについては、概要コメント・ファイルを参照してください。 +.br +.br +概要ページが作成されるのは、Javadocに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。 +.br +.br +概要ページのタイトルは、\f2\-doctitle\fPによって設定されます。 .TP 3 \-public -public クラスおよびメンバーだけを表示します。 -.LP +publicクラスおよびメンバーのみを表示します。 .TP 3 \-protected -protected および public のクラスとメンバーだけを表示します。これがデフォルトです。 -.LP +protectedおよびpublicのクラスとメンバーのみを表示します。これがデフォルトです。 .TP 3 \-package -package、protected、および public のクラスとメンバーだけを表示します。 -.LP +package、protected、およびpublicのクラスとメンバーのみを表示します。 .TP 3 \-private -すべてのクラスとメンバーを表示します。 -.LP +すべてのクラスとメンバーを表示します。 .TP 3 \-help -オンラインヘルプを表示します。Javadoc とドックレットのコマンド行オプションが一覧表示されます。 -.LP +オンライン・ヘルプを表示します。Javadocとドックレットのコマンドライン・オプションがリストされます。 .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オプションによって定義されます。 +.br +.br +たとえば、MIFドックレットを呼び出すには、次のように指定します。 .nf \f3 .fl @@ -2879,18 +2865,17 @@ .fl \fP .fi -.LP 特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 -.LP +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .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ファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。 +.br +.br +jarファイルへのパスの例には、ドックレット開始クラス・ファイルが含まれています。jarファイル名が含まれている点に注目してください。 .nf \f3 .fl @@ -2898,7 +2883,7 @@ .fl \fP .fi -ドックレット開始クラスファイルのパスの例。クラスファイル名が省略されている点に注目してください。 +ドックレット開始クラス・ファイルのパスの例。クラス・ファイル名が省略されている点に注目してください。 .nf \f3 .fl @@ -2908,38 +2893,36 @@ .fi 特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 -.LP +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .TP 3 \-1.1 -\f2この機能は Javadoc 1.4 から削除されました。代替機能はありません。このオプションは、Javadoc 1.1 によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした。入れ子のクラスはサポートされていません。このオプションが必要な場合は、Javadoc 1.2 または 1.3 を使用してください。\fP -.LP +\f2この機能はJavadoc 1.4から削除されました。代替機能はありません。このオプションは、Javadoc 1.1によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした(ネストされたクラスはサポートされていません)。このオプションが必要な場合は、Javadoc 1.2または1.3をかわりに使用してください。\fP .TP 3 \-source release -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。 +受け付けるソース・コードのバージョンを指定します。\f2release\fPには次の値を指定できます。 .RS 3 .TP 2 o -\f31.5\fP \- javadoc は、JDK 1.5 で導入された総称などの言語機能を含むコードを受け付けます。\f3\-source\fP フラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5 のものになります。 +\f31.5\fP \- Javadocは、JDK 1.5で導入された総称および他の言語機能を含むコードを受け付けます。\f3\-source\fPフラグが使用されなかった場合のコンパイラのデフォルト動作は、1.5のものになります。 .TP 2 o -\f31.4\fP Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。 +\f31.4\fP \- Javadocは、JDK 1.4で導入されたアサーションを含むコードを受け付けます。 .TP 2 o -\f31.3\fP Javadoc は、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +\f31.3\fP \- Javadocは、JDK 1.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 .RE -.LP -javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。 -.LP +javacでコードをコンパイルするときに使用した値に対応する\f2release\fPの値を使用します。 .TP 3 \-sourcepath\ sourcepathlist -パッケージ名または \-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 という名前のパッケージをドキュメント化する場合に、そのソースファイルが次の場所にあるとします。 +パッケージ名または\f2\-subpackages\fPを\f2javadoc\fPコマンドに渡すときに、ソース・ファイル(.\f2.java\fP)を見つけるための検索パスを指定します。\f2sourcepathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 +.br +.br +\f2\-sourcepath\fPオプションを使用できるのは、javadocコマンドにパッケージ名を渡す場合のみです。このパスからは、\f2javadoc\fPコマンドに渡される\f2.java\fPファイルは検索されません。(\f2.java\fPファイルを検索するには、そのディレクトリにcdによって移動するか、または各ファイルの先頭にパスを含めます(1つ以上のクラスのドキュメント化を参照)。)\f2\-sourcepath\fPが省略された場合、Javadocは、クラス・パスを使用してソース・ファイルを検索します(\-classpathを参照)。したがって、デフォルトの\-sourcepathは、クラス・パスの値です。\-classpathを省略してパッケージ名をJavadocに渡すと、Javadocは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 +.br +.br +\f2sourcepathlist\fPには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。たとえば、\f2com.mypackage\fPという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが次の場所にあるとします。 .nf \f3 .fl @@ -2947,143 +2930,142 @@ .fl \fP .fi -このとき次のように、 \f2sourcepath\fP を、com/mypackage を含むディレクトリである \f2/home/user/src\fP に指定したあと、 パッケージ名 \f2com.mypackage\fP を指定します。 +この場合、次のようにして\f2sourcepath\fPを、\f2com/mypackage\fPを含むディレクトリである\f2/home/user/src\fPに指定してから、パッケージ名\f2com.mypackage\fPを指定します。 .nf \f3 .fl % \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP .fl .fi -この方法は、ソースパスの値とパッケージ名を連結して、ドットを (円記号) 「\\」に変えると、パッケージのフルパス \f2/home/user/src/com/mypackage になることを理解すると簡単です\fP。 -.LP -2 つのソースパスを設定するには、次のようにします。 +この方法は、ソース・パスの値とパッケージ名を連結して、ドットをスラッシュ「/」に変更すると、パッケージのフルパス\f2/home/user/src/com/mypackage\fPになることに気付くと覚えやすいです。 +.br +.br +2つのソース・パスを設定するには、次のようにします。 .nf \f3 .fl % \fP\f3javadoc \-sourcepath /home/user1/src:/home/user2/src com.mypackage\fP .fl .fi -.LP .TP 3 \-classpath\ classpathlist -javadoc が参照クラス (\f2.class\fP ファイル) の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスから参照されるすべてのクラスを指します。\f2classpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。classpathlist を指定するときは、 +Javadocが参照クラス(\f2.class\fPファイル)の検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。\f2classpathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。\f2classpathlist\fPを指定するときは、 .na -\f2クラスパス\fP @ +\f2クラス・パス\fP @ .fi -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 内のライブラリに依存しているとします。このとき次のように指定します。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#generalのドキュメントにある指示に従ってください。 +.br +.br +\f2\-sourcepath\fPが省略された場合、Javadocツールはクラス・ファイルを検索するときのみでなく、ソース・ファイルを検索するときにも\f2\-classpath\fPを使用します(下位互換性のため)。したがって、ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\f2\-sourcepath\fPと\f2\-classpath\fPの両方を使用します。 +.br +.br +たとえば、\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 が指定されなかった場合、Javadoc ツールはほかのツールと同じく、CLASSPATH 環境変数が設定されていればその値を使用します。どちらも設定されていない場合、Javadoc ツールは現在のディレクトリからクラスを検索します。 -.LP -Javadoc ツールが \f2\-classpath\fP を使用してユーザークラスを検索する方法について、拡張クラスやブートストラップクラスと関連付けて説明している情報を入手するには、 +他のツールと同様に、\f2\-classpath\fPが指定されていない場合、CLASSPATH環境変数が設定されていれば、Javadocツールはその環境変数を使用します。どちらも設定されていない場合、Javadocツールは現在のディレクトリからクラスを検索します。 +.br +.br +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 つの呼び出しを区別できない)。 -.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 プログラムが展開されていないワイルドカードを認識することはありません。 -.LP +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.htmlを参照してください。 +.br +.br +便宜上、\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仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 .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を使用します。このオプションは、ソース・ファイルの処理で説明したとおり、ソース・ツリーにあるがパッケージには属していないソース・ファイルを処理しないので役立ちます。 +.br +.br +例を示します。 .nf \f3 .fl % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP .fl .fi -このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 -.LP -\f2\-subpackages\fP と \f2\-exclude\fP を組み合わせて使用すると、特定のパッケージを除外できます。 -.LP +このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 +.br +.br +\f2\-subpackages\fPを\f2\-exclude\fPと組み合せて使用すると、特定のパッケージを除外できます。 .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 も除外される点に注意してください。 -.LP +この場合、\f2java.io\fP、\f2java.util\fP、\f2java.math\fPなどは組み込まれますが、\f2java.net\fPと\f2java.lang\fPをルートに持つパッケージは除外されます。\f2java.lang\fPのサブパッケージである\f2java.lang.ref\fPが除外される点に注意してください。 .TP 3 \-bootclasspath\ classpathlist -ブートクラスが存在するパスを指定します。ブートクラスとは、通常、Java プラットフォームのコアクラスのことです。ブートクラスパスは、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、 +ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。ブート・クラスパスは、Javadocツールがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、 .na -\f2「クラスの検索方法」\fP @ +\f2クラスの検索方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。コロン (:) を、 \f2classpathlist\fP 内のディレクトリ間の区切り文字として使用します。 -.LP +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。\f2classpathlist\fP内の複数のディレクトリは、コロン(:)で区切ります。 .TP 3 \-extdirs\ dirlist -拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java 拡張機能機構を使うすべてのクラスです。extdirs は、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、前述の \f2\-classpath\fP を参照してください。コロン (:) を、 \f2dirlist\fP 内のディレクトリ間の区切り文字として使用します。 -.LP +拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。extdirsは、Javadocツールがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、前述の\f2\-classpath\fPを参照してください。\f2dirlist\fP内の複数のディレクトリは、コロン(:)で区切ります。 .TP 3 \-verbose -javadoc の実行中に詳細なメッセージを表示します。verbose オプションを指定しないと、ソースファイルのロード時、ドキュメントの生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時にメッセージが表示されます。verbose オプションを指定すると、各 Java ソースファイルの解析に要した時間 (ミリ秒単位) など、追加のメッセージが表示されます。 -.LP +Javadocの実行中に詳細なメッセージを表示します。verboseオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 .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 クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、 \f2\-breakiterator\fP オプションは、1.2 以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 +http://download.oracle.com/javase/7/docs/api/java/text/BreakIterator.htmlの国際化された文境界を使用します(他のすべてのロケールはすでに\f2BreakIterator\fPを使用)。\f2最初の文\fPとは、パッケージ、クラス、またはメンバーの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバーの要約にコピーされ、アルファベット順の索引にコピーされます。 +.br +.br +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 valid」など、ほとんどの省略表記が処理されますが、「Mr. Smith」などは処理されません。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する +breakiterator文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no. is valid」など、ほとんどの省略表記が処理されますが、「Mr.Smith」は処理されません。HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止します。 .RE -.LP -注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\\\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。この件で皆様に余分の手間をおかけし、混乱を招いたことをお詫びいたします。 +注意: 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 -.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 +\f3重要\fP \- \f2\-locale\fPオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより\f2前\fP(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンドライン・オプションのみ、指定する順序に依存します。 +.br +.br +Javadocがドキュメントを生成するときに使用するロケールを指定します。この引数は、java.util.Localeのドキュメントで説明されているロケールの名前です。たとえば、\f2en_US\fP (英語、米国)または\f2en_US_WIN\fP (Windowsで使用される英語)などです。 +.br +.br +ロケールを指定すると、指定したロケールのリソース・ファイルがJavadocによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。ただし、このオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 .TP 3 \-encoding\ name -ソースファイルのエンコーディングの名前 ( \f2EUCJIS/SJIS\fP など) を指定します。 このオプションが指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。 -.LP -\-docencoding および \-charset も参照してください。 -.LP +ソース・ファイルのエンコーディングの名前(\f2EUCJIS/SJIS\fPなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 +.br +.br +\-docencodingおよび\-charsetも参照してください。 .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の間に空白文字を入れないように注意してください。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、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 @@ -3094,47 +3076,47 @@ Classic VM (build JDK\-1.2\-V, green threads, sunwjit) .fl .fi -出力ストリームには標準ドックレットのバージョン番号が含まれます。 +(出力ストリームには標準ドックレットのバージョン番号が含まれます。) .RE .SS 標準ドックレットが提供するオプション .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を実行すると生成先ディレクトリが自動的に作成されます。 +.br +.br +たとえば、次の例では、\f2com.mypackage\fPパッケージのドキュメントが生成され、その結果が\f2/home/user/doc/\fPディレクトリに保存されます。 .nf \f3 .fl % \fP\f3javadoc \-d /home/user/doc com.mypackage\fP .fl .fi -.LP .TP 3 \-use -ドキュメント化されるクラスおよびパッケージごとに 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 -生成された [使用] ページにアクセスするには、目的のクラスまたはパッケージに移動し、ナビゲーションバーの [使用] リンクをクリックします。 +ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。 +.br +.br +たとえば、Stringの使用ページに何が表示されるかを見てみましょう。\f2java.awt.Font\fPクラスの\f2getName()\fPメソッドは、\f2String\fP型の値を返します。したがって、\f2getName()\fPは\f2String\fPを使用しているので、\f2String\fPの使用ページにこのメソッドが表示されます。 +.br +.br +ただし、ドキュメント化されるのはAPIの使用のみで、実装はドキュメント化されません。あるメソッドが、その実装の中で\f2String\fPを使用していても、引数として文字列をとったり、文字列を返したりしない場合は、\f2String\fPの「使用」とはみなされません。 +.br +.br +生成された使用ページにアクセスするには、まず目的のクラスまたはパッケージに移動し、ナビゲーション・バーの「使用」リンクをクリックします。 .TP 3 \-version -生成ドキュメントに、@version のテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している Javadoc ツールのバージョンを確認するには \f2\-J\-version\fP オプションを使用します。 -.LP +生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用しているJavadocツールのバージョンを確認するには\f2\-J\-version\fPオプションを使用します。 .TP 3 \-author -生成ドキュメントに、@author のテキストを組み込みます。 -.LP +生成ドキュメントに、@authorのテキストを組み込みます。 .TP 3 \-splitindex -索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる索引エントリ用に 1 つのファイルを作成します。 -.LP +索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに1つのファイルと、アルファベット以外の文字で始まる索引エントリ用に1つのファイルを作成します。 .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 @@ -3143,7 +3125,7 @@ .fi .TP 3 \-doctitle\ title -概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル 1 の見出しとして、上部ナビゲーションバーのすぐ下に置かれます。\f2title\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 +概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\f2title\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2title\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .nf \f3 .fl @@ -3152,48 +3134,45 @@ .fi .TP 3 \-title\ title -\f3このオプションはもう存在していません。\fPこのオプションは Javadoc 1.2 のベータ版にしか存在していませんでした。このオプションの名前は \f2\-doctitle\fP に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 -.LP +\f3このオプションは、現在は存在していません。\fPJavadoc 1.2のベータ版にしか存在していませんでした。このオプションは、\f2\-doctitle\fPという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 .TP 3 \-header\ header -各出力ファイルの上端に配置するヘッダーテキストを指定します。ヘッダーは、上部ナビゲーションバーの右側に配置されます。\f2header\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2header\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 +各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、上部ナビゲーション・バーの右側に配置されます。\f2header\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2header\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .nf \f3 .fl % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP .fl .fi -.LP .TP 3 \-footer\ footer -各出力ファイルの下端に配置するフッターテキストを指定します。フッターは、下部ナビゲーションバーの右側に配置されます。\f2footer\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2footer\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。 -.LP +各出力ファイルの最下部に配置するフッター・テキストを指定します。フッターは、下部ナビゲーション・バーの右側に配置されます。\f2footer\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2footer\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .TP 3 \-top -各出力ファイルの上端に配置するテキストを指定します。 -.LP +各出力ファイルの最上部に配置するテキストを指定します。 .TP 3 \-bottom\ text -各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーションバーより下の、ページの最下部に配置されます。 \f2text\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。引用符を \f2text\fP 内で使用する場合、引用符をエスケープしなければならない可能性があります。 -.LP +各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーション・バーより下の、ページの最下部に配置されます。\f2text\fPには、HTMLタグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲む必要があります。\f2text\fPの中で引用符を使用する場合は、引用符をエスケープする必要があります。 .TP 3 \-link\ extdocURL -javadoc により生成された既存の外部参照クラスのドキュメンテーションへのリンクを作成します。引数を 1 つとります。 -.LP +既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。引数を1つとります。 .RS 3 .TP 2 o -\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:」ベースにかかわらず、スラッシュを区切り文字として使用します ( +\f4extdocURL\fPは、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。後で例を示します。このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\f2\-linkoffline\fPを使用します)。Javadocツールは、\f2package\-list\fPファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。Javadocツールの実行時に、\f2extdocURL\fPの値がそのまま、作成された\f2<A HREF>\fPリンク内にコピーされます。したがって、\f2extdocURL\fPはファイルへのURLではなく、\f2ディレクトリ\fPへのURLである必要があります。 +.br +.br +\f2extdocURL\fPに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクの場合、ユーザーが渡す値は、生成先ディレクトリ(\f2\-d\fPで指定)からリンク先となるパッケージを含むディレクトリへの相対パスにする必要があります。 +.br +.br +通常、絶対リンクを指定する場合は、\f2http:\fPリンクを使用します。Webサーバーを持たないファイル・システムにリンクする場合は、\f2file:\fPリンクを使用できます。ただし、この方法は、同じファイル・システムを共有する生成ドキュメントにすべてのユーザーがアクセスする必要がある場合以外は使用しないでください。 +.br +.br +すべての場合、すべてのオペレーティング・システムで、絶対URLと相対URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します( .na -\f2URL Memo\fP @ +\f2URLのドキュメント\fP @ .fi -http://www.ietf.org/rfc/rfc1738.txt で指定)。 +http://www.ietf.org/rfc/rfc1738.txtで指定)。 .RS 3 .TP 3 http: ベースの絶対リンク: @@ -3206,81 +3185,90 @@ \f2\-link <directory>/<directory>/.../<name>\fP .RE .RE -.LP -javadoc の 1 回の実行で複数の \f2\-link\fP オプションを指定すれば、複数のドキュメントへのリンクを作成できます。 \f3\-linkoffline または \-link の選択\fP +1回のJavadocの実行で、複数の\f2\-link\fPオプションを指定して複数のドキュメントへのリンクを作成できます。 +.br +.br +\f3\-linkofflineまたは\-linkの選択\fP: +.br .br \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 -外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されていない場合)このような状況は、リンク先のドキュメントがファイアウォールの向こう側にある場合に発生します。 +外部APIドキュメントへの絶対URLを使用する場合(プログラムがそのURLに接続し、読取りを行うことがシェルによって\f2許可されていない\fP場合)このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 .RE -.LP -\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2java.lang\fP、 \f2java.io\fP 、その他の Java プラットフォームパッケージ ( +.br +.br +\f3外部ドキュメントへの絶対リンクの使用例\fP \- .na -\f2http://download.oracle.com/javase/7/docs/api/\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/\fP @ .fi -http://download.oracle.com/javase/7/docs/api/ 内) にリンクしたい場合があります。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP や \f2\-d\fP など、その他のオプションは示していません。 +http://docs.oracle.com/javase/7/docs/api/内の\f2java.lang\fP、\f2java.io\fP、その他のJavaプラットフォーム・パッケージにリンクしたいとします。次のコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\f2com.mypackage\fPパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス・ツリー内の\f2Object\fPクラスへのリンクが含まれています。(\f2\-sourcepath\fPや\f2\-d\fPなどの他のオプションは表示されません。) .nf \f3 .fl - % \fP\f3javadoc \-link http://download.oracle.com/javase/7/docs/api/ com.mypackage\fP + % \fP\f3javadoc \-link http://docs.oracle.com/javase/7/docs/api/ com.mypackage\fP .fl .fi -\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 パッケージをドキュメント化するには、次のコマンドを実行します。 +\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 % \fP\f3javadoc \-d ./spi \-link ../api com.spipackage\fP .fl .fi -.LP -\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: +\f2\-link\fPの引数は、宛先ディレクトリ(\f2docs/spi\fP)からの相対パスです。 +.br +.br +\f3詳細\fP \- \f2\-link\fPオプションを使用すると、コードからは参照されていても、今回のJavadocの実行ではドキュメント化\f2されない\fPというクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\f2extdocURL\fPに指定する必要があります。これにより、たとえば、サード・パーティのドキュメントから\f2http://java.sun.com\fP上の\f2java.*\fPのドキュメントにリンクすることができます。 +.br +.br +今回の実行でJavadocによって生成されるドキュメント内のAPIのみを対象にリンクを作成する場合は、\f2\-link\fPオプションを省略します。(\f2\-link\fPオプションが指定されていないと、Javadocツールは、外部参照のドキュメントへのリンクを作成しません。これは、そのドキュメントが存在するかどうか、および存在する場合はその場所がわからないからです。) +.br +.br +このオプションでは、生成ドキュメント内の複数の場所にリンクを作成できます。 +.br +.br +もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対してJavadocを実行した後、他方のパッケージ・セットに対してJavadocを再度実行すると、両セット間に双方向のリンクを作成できます。 +.br +.br +\f3クラスの参照方法\fP \- 外部参照クラスへのリンクを、テキスト・ラベルのみではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\f2import\fP文、宣言のいずれかで参照する必要があります。次に、クラス\f2java.io.File\fPを参照する方法の例を示します。 .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 文に置きます。 +\f2void foo(File f){}\fP +.br +この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースの戻り値の型またはパラメータの型に置くか、\f2implements\fP、\f2extends\fP、または\f2throws\fP文に置きます。 .RE -.LP -重要な結果として、 \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 のパッケージリストは +重要な結果として、\f2\-link\fPオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。(テキストはハイパーテキスト・リンクが付けられずに表示されます。)リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も安全な方法は前述したとおり、そのクラスをインポートすることです。 +.br +.br +\f3パッケージ・リスト\fP \- \f2\-link\fPオプションには、Javadocツールによって生成される\f2package\-list\fPという名前のファイルが、\f2\-link\fPに指定したURLに存在していることが必要です。\f2package\-list\fPファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前の例では、Javadocツールは、指定されたURLで\f2package\-list\fPという名前のファイルを探し、パッケージ名を読み込んだ後、そのURLにあるそれらのパッケージへのリンクを作成しました。 +.br +.br +たとえば、Java SE 6 APIのパッケージ・リストは .na -\f2http://download.oracle.com/javase/7/docs/api/package\-list\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/package\-list\fP @ .fi -http://download.oracle.com/javase/7/docs/api/package\-list にあり、次のような内容で始まっています。 +http://docs.oracle.com/javase/7/docs/api/package\-listにあり、次のような内容で始まっています。 .nf \f3 .fl @@ -3298,89 +3286,102 @@ .fl java.awt.font .fl - その他 + etc. .fl \fP .fi -.LP -\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 +\f2\-link\fPオプションを指定せずにJavadocを実行した場合、Javadocは外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\f2\-link\fPオプションを指定した場合、Javadocツールは、指定された\f2extdocURL\fPの場所にある\f2package\-list\fPファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\f2extdocURL\fPが名前の前に付加されます。 +.br +.br +すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。Javadocツールは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 +.br +.br +\f3複数のリンク\fP \- 複数の\f2\-link\fPオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。\ Javadoc 1.2には、複数の\f2\-link\fPコマンドを指定できないという既知のバグがあります。これは1.2.2で修正されました。 +.br +.br +リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。 +.br +.br +\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2... \fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP +.br +.br +\f2extdocURL1\fP、\ \f2extdocURL2\fP、\ ... \f2extdocURLn\fPは、それぞれ外部ドキュメントのルートを指し、各ルートには、\f2package\-list\fPという名前のファイルが入っています。 +.br +.br +\f3クロスリンク\fP \- まだ生成されていない2つ以上のドキュメントをクロスリンクする場合は、「ブートストラップ」が必要になります。つまり、どのドキュメントについても\f2package\-list\fPが存在していない場合は、最初のドキュメントに対してJavadocツールを実行する時点で、2番目のドキュメントの\f2package\-list\fPはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成し直す必要があります。 +.br +.br +この場合、最初のドキュメント生成の目的は、\f2package\-list\fPを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部の\f2package\-list\fPファイルが存在しない場合は、Javadocツールから警告が出力されます。 .TP 3 \-linkoffline\ extdocURL\ packagelistLoc -このオプションは \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 の検索場所を示す引数です。 +このオプションは\f2\-link\fPのバリエーションの1つです。どちらも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。Javadocツール自体が「オフライン」になっているとき(Web接続を使用してドキュメントにアクセスできないとき)、Web上のドキュメントにリンクするには、\f2\-linkoffline\fPオプションを使用します。 +.br +.br +厳密には、外部ドキュメントの\f2package\-list\fPファイルにアクセスできないとき、またはこのファイルが\f2extdocURL\fPで指定された場所には存在せず、\f2packageListLoc\fPで指定できる別の場所(通常ローカル)に存在するとき、\f2\-linkoffline\fPを使用します。したがって、\f2extdocURL\fPにWWW上でしかアクセスできない場合は、\f2\-linkoffline\fPを指定することにより、ドキュメントの生成時にJavadocツールがWebに接続できる必要があるという制約がなくなります。 +.br +.br +もう1つの用途は、ドキュメントを更新するための「ハッキング」として使用することです。パッケージのセット全体に対してJavadocを実行した後、変更した一部のパッケージに対してのみJavadocを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。後で例を示します。 +.br +.br +\f2\-linkoffline\fPオプションは引数を2つ取ります。第1引数は\f2<a href>\fPリンクに組み込まれる文字列を指定する引数、第2引数は\f2package\-list\fPの検索場所を指定する引数です。 .RS 3 .TP 2 o -\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。相対リンクの場合、その値は、( \f2\-d\fP で指定された) 生成先ディレクトリからリンク先パッケージのルートへの相対パスにすべきです。詳細は、\-link オプションの \f2extdocURL\fP \f2を参照\fP してください。 +\f4extdocURL\fPは、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\f2\-d\fPで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\f2\-link\fPオプションの\f2extdocURL\fPを参照してください。 .TP 2 o -\f4packagelistLoc\fP は、外部ドキュメントの \f2package\-list\fP ファイルを含むディレクトリへのパスまたは URL です。これは、URL (http: または file:) でもファイルパスでもかまいませんし、絶対パスでも相対パスでもかまいません。相対パスの場合は、javadoc が実行されるカレントディレクトリからの相対パスとして指定します。ファイル名 \f2package\-list\fP は含めないでください。 +\f4packagelistLoc\fPは、外部ドキュメントの\f2package\-list\fPファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、javadocが実行される\f2現在の\fPディレクトリからの相対パスとして指定します。ファイル名の\f2package\-list\fPは含めないでください。 .RE -.LP -1 回の javadoc 実行で複数の \f2\-linkoffline\fP オプションを指定できます。1.2.2 より前は、複数のオプションを指定することはできませんでした。 -.LP -\f3外部ドキュメントへの絶対リンクの使用例\fP \- http://download.oracle.com/javase/7/docs/api/ 内の \f2java.lang\fP、 \f2java.io\fP 、およびその他の Java SE プラットフォームパッケージ \f2にリンクしたくても、\fPWeb にアクセスできない場合を考えます。ブラウザで \f2、\fP +1回のJavadocの実行で、複数の\f2\-linkoffline\fPオプションを指定できます。(1.2.2より前は、1つのオプションしか指定できませんでした。) +.br +.br +\f3外部ドキュメントへの絶対リンクの使用例\fP \- \f2http://docs.oracle.com/javase/7/docs/api/\fP内の\f2java.lang\fP、\f2java.io\fP、その他のJava SEプラットフォーム・パッケージにリンクしたいが、Webにアクセスできないとします。ブラウザで、 .na -\f2http://download.oracle.com/javase/7/docs/api/package\-list\fP @ +\f2http://docs.oracle.com/javase/7/docs/api/package\-list\fP @ .fi -http://download.oracle.com/javase/7/docs/api/package\-list にある package\-list ファイルを開き、それをローカルディレクトリに保存し、第 2 引数 \f2packagelistLoc\fP でこのローカルコピーへのパスを指定します。この例では、パッケージリストファイルはカレントディレクトリ "\f2.\fP" に保存されています。次のコマンドは、Java SE プラットフォームパッケージへのリンクを含んだ、パッケージ \f2com.mypackage\fP のドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。なお、 \f2\-sourcepath\fP など、その他のオプションは示していません。 +http://docs.oracle.com/javase/7/docs/api/package\-listにある\f2package\-list\fPファイルを開き、それをローカル・ディレクトリに保存し、第2引数\f2packagelistLoc\fPでこのローカル・コピーの場所を指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ「\f2.\fP」に保存されています。次のコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\f2com.mypackage\fPパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス・ツリー内の\f2Object\fPクラスへのリンクが含まれています。(\f2\-sourcepath\fPなど、他の必要なオプションは表示されません。) .nf \f3 .fl -% \fP\f3javadoc \-linkoffline http://download.oracle.com/javase/7/docs/api/ . com.mypackage\fP +% \fP\f3javadoc \-linkoffline http://docs.oracle.com/javase/7/docs/api/ . com.mypackage\fP .fl .fi -.LP -\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 +\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の相対リンクの例を参照してください。 +.br +.br +\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ファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 +.br +.br +\f3複数のドキュメントへのリンク\fP \- 参照先となる生成ドキュメントごとに\f2\-linkoffline\fPを1つずつ含めることができます(わかりやすくするために、オプションごとに改行して示しています)。 +.br +.br \f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP .br \f2\ \ \ \ \ \ \ \ \ \ \fP\f4\-linkoffline\fP \f2extdocURL2\fP \f2packagelistLoc2\fP \f2\\\fP .br -\f2\ \ \ \ \ \ \ \ \ \ ...\fP -.LP -\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渡します。 +\f2\ \ \ \ \ \ \ \ \ \ ...\fP +.br +.br +\f3ドキュメントの更新\fP \- \f2\-linkoffline\fPオプションのもう1つの用途は、プロジェクトに大量のパッケージが含まれていて、すでにツリー全体に対してJavadocの実行が完了している場合に、次の実行では、少量の変更を手早く加えた後、ソース・ツリーのごく一部に対してのみJavadocを再実行する場合に便利です。これは、ドキュメンテーション・コメントに対してのみ変更を加え、宣言は変更しない場合にのみ正しく処理されるので、ハッキングのようなものです。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 +.br +.br +まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(\f2update\fP)を作成します。元の生成先ディレクトリの名前が\f2html\fPだったとします。最も単純な例では、\f2html\fPディレクトリの親にcdによって移動します。\f2\-linkoffline\fPの第1引数にカレント・ディレクトリ「.」を設定し、第2引数に\f2package\-list\fPが検索される\f2html\fPへの相対パスを設定します。更新するパッケージのパッケージ名のみを渡します。 .nf \f3 .fl % \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP .fl .fi -Javadoc ツリーの終了後、 \f2update/com/package\fP 内の生成されたクラスのページをコピーし (概要や索引は除く)、 \f2html/com/package 内の元のファイルに上書きします\fP。 -.LP +Javadocツールの終了後、\f2update/com/package\fP内の生成されたクラスのページをコピーし(概要や索引は除く)、\f2html/com/package\fP内の元のファイルに上書きします。 .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ドキュメントからソース・ファイルへのリンクを追加します。リンクは、ソース・ファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルト・コンストラクタ、生成されたクラスなどに対しては作成されません。 +.br +.br +\f3このオプションは、\fP\f4\-public\fP\f3、\fP\f4\-package\fP\f3、\fP\f4\-protected\fP\f3、\fP\f4\-private\fP\f3の各オプションとは関係なく\fP\f3、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内の\fP\f4すべての\fP\f3非公開実装の詳細を公開します。\fP\f2\-private\fPオプションも併せて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 +.br +.br +各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\f2Button\fPクラスのソース・コードへのリンクは、「Button」という語の上に作成されます。 .nf \f3 .fl @@ -3392,7 +3393,7 @@ .fl \fP .fi -また、Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。 +また、Buttonクラスの\f2getLabel()\fPメソッドのソース・コードへのリンクは、「getLabel」という語の上に作成されます。 .nf \f3 .fl @@ -3400,24 +3401,24 @@ .fl \fP .fi -.LP .TP 3 \-group\ groupheading\ packagepattern:packagepattern:... -概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の \f2\-group\fP オプションで指定します。これらのグループは、コマンド行で指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。ある特定の \f2\-group\fP オプションでは、 \f2packagepattern\fP 式のリストに一致するパッケージが、 \f2groupheading\fP という見出しの表に表示されます。 +概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\f2\-group\fPオプションで指定します。これらのグループは、コマンドラインで指定した順序でページに表示されます。各グループ内では、パッケージがアルファベット順に並べられます。1つの\f2\-group\fPオプションでは、\f2packagepattern\fP式のリストに一致するパッケージが、見出しとして\f2groupheading\fPを持つ1つの表に表示されます。 .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 -.LP -\f3注: パターンやパターンリスト内でアスタリスクを使う場合は、 \fP\f4"java.lang*:java.util" のように、パターンリストを引用符で囲む必要があります。\fP -.LP -ユーザーが \f2\-group\fP オプションを 1 つも指定しなかった場合、「パッケージ」という見出しの 1 つのグループ内に、すべてのパッケージが配置されます。ドキュメント化されるパッケージの中に、指定したグループのどのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。 -.LP -たとえば、次のようにオプションを指定すると、ドキュメント化される 5 つのパッケージは、コアパッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.lang パッケージは除外されることになります。 +\f3注意: パターンやパターン・リスト内でアスタリスクを使用する場合は、\fP\f4"java.lang*:java.util"\fP\f3のように、パターン・リストを引用符で囲む必要があります。\fP +.br +.br +\f2\-group\fPオプションが指定されていない場合、すべてのパッケージが、「パッケージ」という見出しの1つのグループに入れられます。ドキュメント化されるパッケージの中に、どのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。 +.br +.br +たとえば、次のようにオプションを指定すると、ドキュメント化される5つのパッケージは、コア・パッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。「java.lang.*」のようにドットを入れると、java.langパッケージは除外されることになります。 .nf \f3 .fl @@ -3431,7 +3432,7 @@ この結果、次のようなグループ化が行われます。 .RS 3 .TP 3 -コアパッケージ +コア・パッケージ \f2java.lang\fP \f2java.lang.reflect\fP \f2java.util\fP @@ -3442,38 +3443,30 @@ その他のパッケージ \f2java.new\fP .RE -.LP .TP 3 \-nodeprecated -推奨されない API をドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlist オプションを指定した場合と同じ効果があることに加えて、ドキュメントのほかの部分全体でも、推奨されない API が生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。 -.LP +推奨されないAPIをドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlistオプションを指定した場合と同じ効果があることに加えて、ドキュメントの他の部分全体でも、推奨されないAPIが生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。 .TP 3 \-nodeprecatedlist -推奨されない API のリストを含むファイル (deprecated\-list.html)、およびナビゲーションバーのそのページへのリンクが生成されないようにします。ただし、ドキュメントのほかの部分では、推奨されない API が生成されます。このオプションは、推奨されない API がソースコードに含まれておらず、ナビゲーションバーをすっきりと見せたい場合に便利です。 -.LP +推奨されないAPIのリストを含むファイル(deprecated\-list.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。(ただし、ドキュメントの他の部分では、推奨されないAPIが生成されます。)このオプションは、推奨されないAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 .TP 3 \-nosince -生成ドキュメントから、@since タグに対応する「導入されたバージョン」 セクションを省略します。 -.LP +生成ドキュメントから、@sinceタグに関連付けられた「導入されたバージョン」セクションを省略します。 .TP 3 \-notree -生成されるドキュメントからクラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。 -.LP +生成ドキュメントから、クラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーション・バーの「階層ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。 .TP 3 \-noindex -生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。 -.LP +生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。 .TP 3 \-nohelp -出力の各ページの最上部と最下部にあるナビゲーションバーから「ヘルプ」リンクを省略します。 -.LP +出力の各ページの最上部と最下部にあるナビゲーション・バーから「ヘルプ」リンクを省略します。 .TP 3 \-nonavbar -生成されるページの最上部と最下部に表示されるナビゲーションバー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottom オプションには影響を与えません。 \f2\-nonavbar\fP オプションは、印刷するためだけにファイルを PostScript または PDF に変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。 -.LP +生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottomオプションには影響を与えません。\f2\-nonavbar\fPオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 .TP 3 \-helpfile\ path/filename -上部と下部のナビゲーションバーの「ヘルプ」リンクのリンク先となる代替ヘルプファイル \f2path/filename\fP のパスを指定します。このオプションが指定されないと、Javadoc ツールは、ツール内でハードコードされているヘルプファイル \f2help\-doc.html\fP を自動作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、 \f2help\-doc.html には限定されません。\fP Javadoc ツールは、ナビゲーションバー内のリンクを必要に応じて調整します。次に例を示します。 +最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイル\f2path/filename\fPのパスを指定します。このオプションが指定されていないと、Javadocツールは、ツール内でハードコードされているヘルプ・ファイル\f2help\-doc.html\fPを自動作成します。このオプションを使用すると、そのデフォルトの動作をオーバーライドできます。\f2filename\fPにはどんなファイル名でも指定でき、\f2help\-doc.html\fPに限定されません。Javadocツールは、ナビゲーション・バー内のリンクを必要に応じて調整します。次に例を示します。 .nf \f3 .fl @@ -3482,7 +3475,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 @@ -3491,15 +3484,14 @@ .fi .TP 3 \-serialwarn -@serial タグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 以降のバージョンでは、直列化の警告は生成されません1.2.2 より前の初期バージョンでは、警告が生成されます。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと \f2writeExternal\fP メソッドを適切にドキュメント化するのに役立ちます。 -.LP +@serialタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 (以降)では、直列化の警告は生成されません。(以前のバージョンとは逆の動作です。)このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\f2writeExternal\fPメソッドを適切にドキュメント化するのに役立ちます。 .TP 3 \-charset\ name -このドキュメント用の HTML 文字セットを指定します。この名前は、 +このドキュメント用のHTML文字セットを指定します。この名前は、 .na -\f2IANA Registry\fP @ +\f2IANAレジストリ\fP @ .fi -http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。たとえば、 +http://www.iana.org/assignments/character\-setsで指定された、推奨されるMIME名である必要があります。次に例を示します。 .nf \f3 .fl @@ -3514,34 +3506,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 も参照してください。 -.LP +http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2(4197265および4137321)を参照してください。 +.br +.br +\-encodingおよび\-docencodingも参照してください。 .TP 3 \-docencoding\ name -生成される HTML ファイルのエンコーディングを指定します。この名前は、 +生成されるHTMLファイルのエンコーディングを指定します。この名前は、 .na -\f2IANA Registry\fP @ +\f2IANAレジストリ\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 も参照してください。 -.LP +\-encodingおよび\-charsetも参照してください。 .TP 3 \-keywords -HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。 -.LP -メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。 +HTMLメタ・キーワード・タグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチ・エンジンがページを見つける場合に役立ちます。(インターネット全体を検索する多くのサーチ・エンジンは、ページがメタタグを誤用している可能性があるため、メタタグを調べません。一方、検索を自身のWebサイトに限定している企業が提供するサーチ・エンジンは、メタタグを調べることによってメリットを得られます。) +.br +.br +メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラスStringは次のキーワードで開始します。 .nf \f3 .fl @@ -3555,16 +3547,21 @@ .fl \fP .fi -.LP .TP 3 \-tag\ \ tagname:Xaoptcmf:"taghead" -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 (タグの無効化) +Javadocツールがドキュメンテーション・コメント内の引数を1つ取る単純なカスタムブロック・タグ\f2@\fP\f2tagname\fPを解釈できるようにします。これにより、Javadocツールはタグ名の「スペルチェック」を行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\f2\-tag\fPオプションを組み込むことが重要です。今回の実行では出力されないタグは、\f2X\fPを付けて無効にします。 +.br +.br +コロン(\f4:\fP)が常に区切り文字になります。\f2tagname\fPでコロンを使用する方法については、タグ名でのコロンの使用を参照してください。 +.br +.br +\f2\-tag\fPオプションは、タグの見出し\f2taghead\fPを太字で出力します。その次の行には、このオプションの引数で指定したテキストが続きます(下の例を参照)。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\f2@return\fPや\f2@author\fPなど)の出力とよく似ています。\f2taghead\fPを省略すると、\f2tagname\fPが見出しとして表示されます。 +.br +.br +\f3タグの配置\fP \- 引数の\f4Xaoptcmf\fP部分は、ソース・コード内のタグを配置できる位置と、タグを(\f2X\fPを使用して)無効にできるかどうかを決定します。タグの配置位置を制限しない場合は\f4a\fPを指定します。それ以外の文字の組合せも可能です。 +.br +.br +\f4X\fP (タグの無効化) .br \f4a\fP (すべて) .br @@ -3579,8 +3576,9 @@ \f4m\fP (メソッド) .br \f4f\fP (フィールド) -.LP -\f3シングルタグの例\fP \- ソースコード内の任意の位置で使用できるタグのタグオプションの例を示します。 +.br +.br +\f3シングル・タグの例\fP \- ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。 .nf \f3 .fl @@ -3588,7 +3586,7 @@ .fl \fP .fi -@todo をコンストラクタ、メソッド、フィールドのみで使用する場合は、以下のオプションを使用します。 +@todoをコンストラクタ、メソッド、フィールドのみで使用する場合は、次のオプションを使用します。 .nf \f3 .fl @@ -3596,7 +3594,7 @@ .fl \fP .fi -上の例の最後のコロン (\f2:\fP) は、パラメータ区切り子ですが、見出しテキストの一部になっています (以下の例を参照)。次の例のように、 \f2@todo\fP タグを含むソースコードでは、いずれかのタグオプションを使用します。 +上の例の最後のコロン(\f2:\fP)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています(下の例を参照)。次の例のように、\f2@todo\fPタグを含むソース・コードでは、いずれかのタグ・オプションを使用します。 .nf \f3 .fl @@ -3604,7 +3602,7 @@ .fl \fP .fi -\f3タグ名にコロンを使用する\fP \- コロン (:) をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーションコメントの中では、次のように使用します。 +\f3タグ名でのコロンの使用\fP \- コロン(:)をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーション・コメントの中では、次のように使用します。 .nf \f3 .fl @@ -3616,7 +3614,7 @@ .fl \fP .fi -でこのタグオプションを使用すると、 +このタグ・オプションを使用すると、次のようになります。 .nf \f3 .fl @@ -3624,9 +3622,10 @@ .fl \fP .fi -\f3タグ名のスペルチェック (タグの無効化)\fP \- ソースコード内に配置した一部のカスタムタグの出力を抑制したい場合があります。この場合も、ソースコード内にすべてのタグを配置し、出力を抑制しないタグを有効にし、出力を抑制するタグを無効にします。 \f2X\fP が存在する場合はタグが無効になり、存在しない場合はタグが有効になります。これにより、Javadoc ツールは、検出したタグが入力ミスなどによる未知のタグであるかどうかを特定できます。未知のタグを検出した場合、Javadoc ツールは警告を出力します。 -.LP -すでに配置されている値に \f2X\fP を追加できます。こうしておけば、 \f2X を削除するだけでタグを有効にすることができます\fP。たとえば、@todo タグの出力を抑制したい場合、次のように指定します。 +\f3タグ名のスペルチェック(タグの無効化)\fP \- 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内に存在するすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\f2X\fPを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、Javadocツールは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。この場合は警告が出力されます。 +.br +.br +すでに配置されている値に\f2X\fPを追加できます。こうしておけば、\f2X\fPを削除するのみでタグを有効にすることができます。たとえば、@todoタグの出力を抑制する場合、次のように指定します。 .nf \f3 .fl @@ -3642,14 +3641,16 @@ .fl \fP .fi -.LP -構文 \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 を使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます。行の継続を示す文字は不要です。 +構文\f2\-tag todo:X\fPは、\f2@todo\fPがタグレットで定義されていても機能します。 +.br +.br +\f3タグの順序\fP \- \f2\-tag\fP (および\f2\-taglet\fP)オプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためのみのプレースホルダです。これらは標準タグ名のみを使用します。(標準タグの小見出しは変更できません。)これについては、下の例で説明します。 +.br +.br +\f2\-tag\fPがない場合は、\f2\-taglet\fPの位置によってその順序が決まります。タグが両方とも存在する場合、コマンドラインの最後にある方がその順序を決定します。これは、タグやタグレットがコマンドラインに指定された順番に処理されるためです。たとえば、\f2\-taglet\fPと\f2\-tag\fPの両方が「todo」という名前を持っている場合、コマンドラインの最後にある方が順序を決定します。 +.br +.br +\f3タグの完全セットの例\fP \- この例では、出力の「Parameters」と「Throws」の間に「To Do」を挿入します。「X」を使用して、@exampleが、ソース・コード内の今回の実行では出力されないタグであることを指定します。@argfileを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 .nf \f3 .fl @@ -3667,38 +3668,41 @@ .fl \fP .fi -.LP -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 タグにすべきです。それ以外の場合は注釈にすべきです。 +Javadocがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\f2\-tag\fPや\f2\-taglet\fPで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 +.br +.br +標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\f2\-tag\fPオプションを使用すると、このリストに追加されるタグ、すなわち標準タグがデフォルトの位置から移動します。つまり、標準タグの\f2\-tag\fPオプションを省略すると、これらはデフォルトの位置に配置されたままになります。 +.br +.br +\f3競合の回避\fP \- 固有の名前空間を細かく分けるには、パッケージに使用されている\f2com.mycompany.todo\fPという名前のように、ドット(.)で区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。つまり、\f2@todo\fPという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 +.br +.br +\f3注釈vs. Javadocタグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメントに影響を与えたりドキュメントを生成したりするためのものである場合、そのマークアップはJavadocタグにします。それ以外の場合は注釈にします。 .na -\f2「Comparing Annotations and Javadoc Tags」\fP @ +\f2注釈とJavadocタグの比較\fP @ .fi -http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#annotationsを参照してください。 -.LP -\-taglet オプションを使用して、より複雑なブロックタグやカスタムインラインタグを 作成することができます。 -.LP +http://www.oracle.com/technetwork/java/javase/documentation/index\-137868.html#annotationsを参照してください。 +.br +.br +\-tagletオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグを作成することもできます。 .TP 3 \-taglet\ \ class -そのタグのドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。クラスの完全指定名を指定してください。このタグレットは、カスタムタグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプルタグレットについては、以下を参照してください。 +そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\f2クラス\fPの完全修飾名を指定してください。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプル・タグレットについては、次を参照してください。 .RS 3 .TP 2 o .na -\f2「タグレットの概要」\fP @ +\f2タグレットの概要\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/taglet/overview.html .RE -.LP -タグレットは、ブロックタグまたはインラインタグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。 -.LP -タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。 -.LP -タグレットのパスを指定するには、\f2\-tagletpath\fP オプションを使用します。以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。 +タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。 +.br +.br +タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。したがって、タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。 +.br +.br +タグレットへのパスを指定するには、\f2\-tagletpath\fPオプションを使用します。次に、生成されるページの「Parameters」と「Throws」の間に「To Do」タグレットを挿入する例を示します。 .nf \f3 .fl @@ -3718,25 +3722,21 @@ .fl \fP .fi -.LP -また、 \f2\-taglet\fP オプションを \f2\-tag\fP オプションの代わりに使用することもできますが、そうすると可読性が低下する可能性があります。 -.LP +また、\f2\-taglet\fPオプションを\f2\-tag\fPオプションのかわりに使用することもできますが、読みにくくなる可能性があります。 .TP 3 \-tagletpath\ \ tagletpathlist -taglet クラスファイル (.class) の検索パスを指定します。\f2tagletpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。 -.LP +tagletクラス・ファイル(.class)を検索するための検索パスを指定します。\f2tagletpathlist\fPには、コロン(\f2:\fP)で区切って複数のパスを含めることができます。Javadocツールは、指定されたパス以下のすべてのサブディレクトリを検索します。 .TP 3 \-docfilessubdirs\ -「\f2doc\-files\fP」ディレクトリの深いコピーを有効にします。つまり、コピー先には、サブディレクトリとすべてのコンテンツがコピーされます。たとえば、ディレクトリ \f2doc\-files/example/images\fP とそのすべての内容がコピーされます。ここでも、サブディレクトリを除外する指定が可能です。 -.LP +「\f2doc\-files\fP」ディレクトリのディープ・コピーを有効にします。つまり、宛先には、サブディレクトリとそのすべて内容が再帰的にコピーされます。たとえば、ディレクトリ\f2doc\-files/example/images\fPとその内容がすべてコピーされます。ここでも、サブディレクトリを除外する指定が可能です。 .TP 3 \-excludedocfilessubdir\ \ name1:name2... -「\f2doc\-files\fP」の、指定された名前のサブディレクトリをすべて除外します。これにより、SCCS とその他のソースコード制御サブディレクトリのコピーを防ぎます。 -.LP +指定された名前の「\f2doc\-files\fP」サブディレクトリをすべて除外します。これにより、SCCSとその他のソース・コード制御サブディレクトリのコピーを防ぎます。 .TP 3 \-noqualifier\ \ all\ | \ packagename1:packagename2:... -出力されるクラス名の先頭のパッケージ名 (パッケージ修飾子) を省略します。 \f2\-noqualifier\fP の引数は、「\f2all\fP」(すべてのパッケージ修飾子が省略される)、修飾子として削除すべきパッケージのコロン区切りリスト (ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。 -.LP +出力されるクラス名の先頭からパッケージ名(パッケージ修飾子)を省略します。\f2\-noqualifier\fPの引数は、「\f2all\fP」(すべてのパッケージ修飾子を省略)、修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。 +.br +.br 次の例では、すべてのパッケージ修飾子を省略します。 .nf \f3 @@ -3745,7 +3745,7 @@ .fl \fP .fi -次の例では、パッケージ修飾子 java.lang および java.io を省略します。 +次の例では、パッケージ修飾子「java.lang」および「java.io」を省略します。 .nf \f3 .fl @@ -3753,7 +3753,7 @@ .fl \fP .fi -次の例では、java で始まるパッケージ修飾子と com.sun というサブパッケージ (javax ではない) を省略します。 +次の例では、「java」で始まるパッケージ修飾子と「com.sun」というサブパッケージ(「javax」ではない)を省略します。 .nf \f3 .fl @@ -3761,11 +3761,10 @@ .fl \fP .fi -パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、 \f2\-noqualifier\fP を使用するかどうかにかかわらず有効です。 -.LP +パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。詳細は、名前が表示される方法を参照してください。このルールは、\f2\-noqualifier\fPを使用するかどうかにかかわらず有効です。 .TP 3 \-notimestamp\ -タイムスタンプが抑制されます。各ページ先頭近くにある、生成された HTML 内の HTML コメントでタイムスタンプが隠されます。Javadoc を 2 つのソースベースで実行し、それらに対して diff を実行するときにこのオプションを使用すると、タイムスタンプによって diff が発生しなくなるので便利です (このオプションを使用しないと、各ページで diff になります)。タイムスタンプには Javadoc のバージョン番号が含まれており、次のようになります。 +タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。Javadocを2つのソース・ベースで実行し、それらに対してdiffを実行するときにこのオプションを使用すると、タイムスタンプによってdiffが発生しなくなるので便利です(このオプションを使用しないと、各ページでdiffになります)。タイムスタンプにはJavadocのバージョン番号が含まれており、次のようになります。 .nf \f3 .fl @@ -3773,28 +3772,26 @@ .fl \fP .fi -.LP .TP 3 \-nocomment\ -主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。このオプションにより、元は異なる目的のためだったソースファイルを再利用し、新しいプロジェクトの早い段階でスケルトン HTML ドキュメントを作成できるようになりました。 -.LP +主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言のみを生成します。このオプションにより、元は異なる目的のためだったソース・ファイルを再利用し、新しいプロジェクトの早い段階でスケルトンHTMLドキュメントを作成できるようになります。 .TP 3 \-sourcetab tabLength -ソース内で各タブが獲得する空白の数を指定します。 +ソース内の各タブが取る空白文字の数を指定します。 .RE -.SH "コマンド行引数ファイル" +.SH "コマンドライン引数ファイル" .LP -javadoc のコマンド行を短くしたり簡潔にしたりするために、 \f2javadoc\fP コマンドに対する引数 ( \f2\-J\fP オプションを除く) が入った 1 つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティングシステム上でも、任意の長さの javadoc コマンドを作成できます。 +Javadocのコマンドラインを短くしたり簡潔にしたりするために、\f2javadoc\fPコマンドに対する引数(\f2\-J\fPオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さのjavadocコマンドを作成できます。 .LP -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 +引数ファイルには、javacのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。 .LP -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、 \f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、 \f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード(*)は使用できません。たとえば、\f2*.java\fPとは指定できません。引数ファイル内の引数で\f2@\fP文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fPオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .LP -javadoc を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javadoc は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +Javadocを実行するときに、各引数ファイルのパスとファイル名の先頭に\f2@\fP文字を付けて渡します。Javadocは、\f2@\fP文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .SS -引数ファイルを 1 つ指定する例 +引数ファイルを1つ指定する例 .LP -次のように、「\f2argfile\fP」という名前の単一の引数ファイル内に、Javadoc のすべての引数を格納します。 +次のようにして、「\f2argfile\fP」という名前の単一の引数ファイルに、すべてのJavadoc引数を格納できます。 .nf \f3 .fl @@ -3802,11 +3799,11 @@ .fl .fi .LP -この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。 +この引数ファイルには、次の例で示されている2つのファイルの内容を両方とも入れることができます。 .SS -引数ファイルを 2 つ指定する例 +引数ファイルを2つ指定する例 .LP -2 つの引数ファイルを作成できます。1 つは Javadoc オプション用、もう 1 つはパッケージ名またはソースファイル名用です。なお、次のリストでは行継続文字を使用していません。 +次のようにして、Javadocオプション用に1つ、パッケージ名またはソース・ファイル名用に1つというように、2つの引数ファイルを作成できます(なお、次のリストでは行継続文字を使用していません)。 .LP 次の内容を含む、「\f2options\fP」という名前のファイルを作成します。 .nf @@ -3848,7 +3845,7 @@ \fP .fi .LP -そのあと、次のコマンドを使用して javadoc を実行します。 +その後、次のコマンドを使用してJavadocを実行します。 .nf \f3 .fl @@ -3858,7 +3855,7 @@ .SS パス付きの引数ファイルの例 .LP -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、 \f2path1\fP や \f2path2\fP から見た相対パスではありません。 +引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fPや\f2path2\fPから見た相対パスではありません。 .nf \f3 .fl @@ -3868,7 +3865,7 @@ .SS オプションの引数の例 .LP -次に、Javadoc オプションに対する引数だけを引数ファイルに格納する例を示します。ここでは \f2\-bottom\fP オプションを使用します。というのも、引数が長くなる可能性があるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。 +次に、Javadocオプションに対する引数のみを引数ファイルに格納する例を示します。ここでは\f2\-bottom\fPオプションを使用します。そのオプションには、長い引数を指定できるからです。次のようなテキスト引数を含む、「\f2bottom\fP」という名前のファイルを作成できます。 .nf \f3 .fl @@ -3880,12 +3877,12 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font> + Other names may be trademarks of their respective owners.</font> .fl \fP .fi .LP -そのあと、次のようにして Javadoc ツールを実行します。 +その後、次のようにしてJavadocツールを実行します。 .nf \f3 .fl @@ -3893,7 +3890,7 @@ .fl .fi .LP -あるいは、引数ファイルの先頭に \f2\-bottom\fP オプションも組み込んだあと、次のように実行してもかまいません。 +あるいは、引数ファイルの先頭に\f2\-bottom\fPオプションを組み込んだ後、次のようにして実行します。 .nf \f3 .fl @@ -3902,34 +3899,34 @@ .fi .SH "名前" 実行 -.SH "Javadoc の実行" +.SH "Javadocの実行" .LP -\f3バージョン番号\fP \- javadoc のバージョン番号を判別するには、\f3javadoc \-J\-version\fP を使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。その出力を無効にするには、 \f2\-quiet\fP を使用します。 +\f3バージョン番号\fP \- Javadocのバージョン番号を判別するには、\f3javadoc \-J\-version\fPを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。\f2\-quiet\fPで無効にできます。 .LP -\f3公開プログラムインタフェース\fP \- Java 言語で記述されたプログラムから Javadoc ツールを起動するとき使用します。このインタフェースは \f2com.sun.tools.javadoc.Main にあります\fP (javadoc は再入可能)。詳細は、 +\f3公開プログラム・インタフェース\fP \- Java言語で記述されたプログラムからJavadocツールを起動するとき使用します。このインタフェースは\f2com.sun.tools.javadoc.Main\fPにあります(Javadocは再入可能)。詳細は、 .na -\f2「標準ドックレット」\fP @ +\f2標準ドックレット\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。 .LP -\f3ドックレットの実行\fP \- 下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、 +\f3ドックレットの実行\fP \- 下の説明は、標準HTMLドックレットを呼び出すためのものです。カスタム・ドックレットを呼び出すには、\-docletおよび\-docletpathオプションを使用します。特定のドックレットを実行した完全な例については、 .na -\f2MIF Doclet のドキュメント\fP @ +\f2MIFドックレットのドキュメント\fP @ .fi http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。 .SH "簡単な例" .LP -javadoc は、パッケージ全体に対して実行することも、個々のソースファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソースファイルは \f2/home/src/java/awt/*.java にあります\fP。生成先ディレクトリは \f2/home/html です\fP。 +Javadocは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソース・ファイルは\f2/home/src/java/awt/*.java\fPにあります。生成先ディレクトリは\f2/home/html\fPです。 .SS -1 つ以上のパッケージのドキュメント化 +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。 +パッケージをドキュメント化するには、そのパッケージのソース・ファイル(\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 -javadoc を実行するには、 \f2cd\fP を使用してディレクトリを変更するか、 \f2\-sourcepath\fP オプションを使用します。以下の例では、両方の方法について説明します。 +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のサブパッケージである\f2java.lang.ref\fPが除外される点に注意してください。 .nf \f3 .fl @@ -3937,10 +3934,10 @@ .fl .fi .LP -ほかのパッケージツリーも下方にたどるには、 \f2java:javax:org.xml.sax のように、\fP それらのパッケージの名前を \-subpackages \f2の引数の末尾に追加します\fP。 +また、他のパッケージ・ツリーを下方にたどるには、\f2java:javax:org.xml.sax\fPのように、それらのパッケージの名前を\f2\-subpackages\fPの引数に追加します。 .TP 2 o -\f3ケース 2 \- ルートソースディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全指定のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。 +\f3ケース2 \- ルート・ソース・ディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全修飾のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する1つ以上のパッケージの名前を指定してJavadocを実行します。 .nf \f3 .fl @@ -3951,7 +3948,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 @@ -3960,7 +3957,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 @@ -3969,15 +3966,15 @@ .fi .RE .LP -結果: すべてのケースでパッケージ \f2java.awt\fP および \f2java.awt.event\fP 内の public および protected クラスとインタフェースについて、HTML 形式のドキュメントが生成され、指定された生成先ディレクトリ (\f2/home/html\fP) に HTML ファイルが保存されます。2 つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラスページという 3 つのフレームを持つことになります。 +結果: すべてのケースで\f2java.awt\fPおよび\f2java.awt.event\fPパッケージ内のpublicおよびprotectedクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリ(\f2/home/html\fP)にHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 .SS -1 つ以上のクラスのドキュメント化 +1つ以上のクラスのドキュメント化 .LP -また、1 つ以上のソースファイル (\f2.java\fP) を渡して、Javadoc ツールを実行することもできます。javadoc は、次の 2 つの方法のいずれかで実行できます。1 つは \f2cd\fP を使用してディレクトリを変更する方法、もう 1 つは \f2.java\fP ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソースファイル名を渡すときは、 \f2\-sourcepath\fP オプションは無視されます。アスタリスク (*) のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。 +また、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 @@ -3986,10 +3983,10 @@ % \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP .fl .fi -この例では、クラス \f2Button\fP と \f2Canvas\fP 、および名前が \f2Graphics で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。パッケージ名ではなくソースファイルが javadoc に引数として渡されているので、ドキュメントは、クラスのリストとメインページという 2 つのフレームを持つことになります。 +この例では、\f2Button\fPクラスと\f2Canvas\fPクラス、および名前が\f2Graphics\fPで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルがJavadocに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 .TP 2 o -\f3ケース 2 \- パッケージのルートディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソースファイルをドキュメント化する場合に便利です。パッケージのルートディレクトリに移り、各ソースファイルを、ルートからのパスとともに指定します。 +\f3ケース2 \- パッケージのルート・ディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソース・ファイルをドキュメント化する場合に便利です。パッケージのルート・ディレクトリに移り、各ソース・ファイルを、ルートからのパスとともに指定します。 .nf \f3 .fl @@ -3998,22 +3995,22 @@ % \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP .fl .fi -この例では、クラス \f2Button\fP および \f2Applet について、HTML 形式のドキュメントが生成されます\fP。 +この例では、\f2Button\fPクラスおよび\f2Applet\fPクラスについて、HTML形式のドキュメントが生成されます。 .TP 2 o -\f3ケース 3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する .java ファイルへの絶対パス (またはカレントディレクトリからの相対パス) を指定して \f2javadoc\fP を実行します。 +\f3ケース3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する\f2.java\fPファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定してJavadocを実行します。 .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 で始まるクラスについて、HTML 形式のドキュメントが生成されます\fP。 +この例では、\f2Button\fPクラス、および名前が\f2Graphics\fPで始まるクラスについて、HTML形式のドキュメントが生成されます。 .RE .SS パッケージとクラスのドキュメント化 .LP -パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に前述の 2 つの例を組み合わせた例を示します。 \f2\-sourcepath\fP は、パッケージへのパスに対しては使用できますが、個々のクラスのパスに対しては使用できません。 +パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\f2\-sourcepath\fPは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 .nf \f3 .fl @@ -4021,16 +4018,16 @@ .fl .fi .LP -この例では、パッケージ \f2java.awt\fP とクラス \f2Applet について、HTML 形式のドキュメントが生成されます\fP。Javadoc ツールは、 \f2Applet.java ソースファイル内にパッケージ宣言があれば、\fP その宣言に基づいて \f2Applet のパッケージ名を\fP 判定します。 +この例では、\f2java.awt\fPパッケージおよび\f2Applet\fPクラスについて、HTML形式のドキュメントが生成されます。(Javadocツールは、\f2Applet.java\fPソース・ファイル内にパッケージ宣言があれば、その宣言に基づいて\f2Applet\fPのパッケージ名を判別します。) .SH "使用例" .LP -Javadoc ツールには多くの便利なオプションがあり、その中にはほかのオプションよりも頻繁に使われるものがあります。ここで紹介するのは、Java プラットフォーム API に対して Javadoc ツールを実行するときに使用する実際のコマンドです。ここでは、Java SE Platform, Standard Edition, v1.2 の (約) 1500 個の public および protected クラスのドキュメントを生成するために、180M バイトのメモリーを使用します。 +Javadocツールには多くの便利なオプションがあり、その中には他のオプションよりも頻繁に使用されるものがあります。ここで紹介するのは、JavaプラットフォームAPIに対してJavadocツールを実行するときに使用する実際のコマンドです。Java SE Platform, Standard Edition, v1.2に存在する、約1500個のpublicおよびprotectedクラスのドキュメントを生成するために、180MBのメモリーを使用します。 .LP -同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。オプションの引数で絶対パスが使用されているため、同じ \f2javadoc\fP コマンドをどのディレクトリからでも実行できます。 +同じ例を2回掲載します。最初の例はコマンドラインから実行するもので、2番目の例はMakefileから実行するものです。オプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\f2javadoc\fPコマンドを実行できます。 .SS -コマンド行の例 +コマンドラインの例 .LP -次の例は、DOS などの一部のシェルでは長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェルスクリプトを記述します。 +次の例は、DOSなどの一部のシェルには長すぎます。この制限を回避するには、コマンドライン引数ファイルを使用します。または、シェル・スクリプトを記述します。 .nf \f3 .fl @@ -4058,7 +4055,7 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font>' \\ + Other names may be trademarks of their respective owners.</font>' \\ .fl \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\ .fl @@ -4071,13 +4068,13 @@ \fP .fi .LP -ここで、 \f2packages\fP は、処理対象のパッケージ名 ( \f2java.applet java.lang\fP など) が入っているファイルの名前です。各オプションの、単一引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー&ペーストする場合は、 \f2\-bottom\fP オプションから改行文字を削除してください。さらに、このあとの「注」も参照してください。 +ここで、\f2packages\fPは、処理対象のパッケージ名(\f2java.applet java.lang\fPなど)が入っているファイルの名前です。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。(たとえば、この例をコピー&ペーストする場合は、\f2\-bottom\fPオプションから改行文字を削除してください。)さらに、下の「注意」も参照してください。 .SS -Makefile の例 +Makefileの例 .LP -ここでは、GNU Makefile の例を示します。Windows の Makefile の例については、 +ここでは、GNU Makefileの例を示します。WindowsのMakefileの例については、 .na -\f2Windows の Makefile の作成方法\fP @ +\f2WindowsのMakefileの作成方法\fP @ .fi http://java.sun.com/j2se/javadoc/faq/index.html#makefilesを参照してください。 .nf @@ -4129,7 +4126,7 @@ .fl Oracle is a registered trademark of Oracle Corporation and/or its affiliates. .fl - その他の名称は、それぞれの所有者の商標または登録商標です。</font>' + Other names may be trademarks of their respective owners.</font>' .fl GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"' .fl @@ -4140,19 +4137,19 @@ \fP .fi .LP -Makefile の引数は、単一引用符で囲みます。 +Makefileの引数は、一重引用符で囲みます。 .LP -\f3注\fP +\f3注意\fP .RS 3 .TP 2 o -\-windowtitle \f2オプションを省略すると、\fP Javadoc ツールによってドキュメントタイトルがウィンドウタイトルにコピーされます。 \f2\-windowtitle\fP のテキストは基本的に \f2\-doctitle\fP のものと同じですが、HTML タグを含まない点が異なります。これは、HTML タグが raw テキストとしてウィンドウタイトル内に表示されるのを防ぐためです。 +\f2\-windowtitle\fPオプションを省略すると、Javadocツールによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\f2\-windowtitle\fPのテキストは、基本的に\f2\-doctitle\fPと同じです。ただし、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。. .TP 2 o -ここで行っているように \f2\-footer\fP オプションを省略すると、Javadoc ツールによってヘッダーのテキストがフッターにコピーされます。 +この例のように\f2\-footer\fPオプションを省略すると、Javadocツールによってヘッダー・テキストがフッターにコピーされます。 .TP 2 o -この例では必要ありませんが、\-\f2classpath\fP と \-\f2link\fP も重要なオプションです。 +この例では必要ありませんが、\f2\-classpath\fPと\f2\-link\fPも重要なオプションです。 .RE .SH "トラブルシューティング" .SS @@ -4160,35 +4157,35 @@ .RS 3 .TP 2 o -\f3Javadoc FAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、 +\f3JavadocのFAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、 .na -\f2「Javadoc FAQ」\fP @ +\f2Javadocの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 \- バグの一部は、バグ修正および変更のインポートでも参照できます。 .TP 2 o -\f3バージョン番号\fP \- 「バージョン番号」を参照してください。 +\f3バージョン番号\fP \- バージョン番号を参照してください。 .TP 2 o -\f3有効なクラスだけをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadoc は、有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、javadoc によるファイルの解析を防ぐことができます。 +\f3有効なクラスのみをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadocは、名前が有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、Javadocによるファイルの解析を防ぐことができます。 .RE .SS エラーと警告 .LP -エラーおよび警告メッセージには、ファイル名と宣言行 (ドキュメンテーションコメント内の特定の行ではない) の行番号が含まれます。 +エラーおよび警告メッセージには、ファイル名と宣言行(ドキュメンテーション・コメント内の特定の行ではない)の行番号が含まれます。 .RS 3 .TP 2 o -\f2"error: cannot read: Class1.java"\fP Javadoc ツールはカレントディレクトリに Class1.java クラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合 \f2./Class1.java と同じです\fP。 +「\f2エラー: Class1.javaを読み込めません\fP」: Javadocツールは現在のディレクトリにClass1.javaクラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合\f2./Class1.java\fPと同じです。 .RE .SH "環境" .RS 3 .TP 3 CLASSPATH -Javadoc がユーザークラスのファイルを探すときに使うパスを指定する環境変数です。この環境変数は、 \f2\-classpath\fP オプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。 +Javadocがユーザー・クラスのファイルを探すときに使用するパスを指定する環境変数です。この環境変数は、\f2\-classpath\fPオプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。 .:/home/classes:/usr/local/java/classes .RE .SH "関連項目" @@ -4211,7 +4208,7 @@ .TP 2 o .na -\f2Javadoc のホームページ\fP @ +\f2Javadocのホーム・ページ\fP @ .fi http://www.oracle.com/technetwork/java/javase/documentation/index\-jsp\-135444.html .TP 2 @@ -4223,14 +4220,14 @@ .TP 2 o .na -\f2クラスパスの設定\fP @ +\f2クラス・パスの設定\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#general +http://download.oracle.com/javase/7/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) +http://download.oracle.com/javase/7/docs/technotes/tools/findingclasses.html#srcfiles(tools.jar) .RE
--- a/src/solaris/doc/sun/man/man1/ja/javah.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/javah.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javah 1 "07 May 2011" +.TH javah 1 "21 Mar 2012" .LP .SH "名前" -javah \- C ヘッダーとスタブファイルジェネレータ +javah \- Cヘッダーとスタブ・ファイル・ジェネレータ .LP .LP -\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。 +\f3javah\fPは、JavaクラスからCヘッダー・ファイルとCソース・ファイルを作成します。これらのファイルは、Javaプログラミング言語で書かれたコードと、Cなどのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。 .LP .SH "形式" .LP @@ -42,44 +42,44 @@ .SH "説明" .LP .LP -\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。 +\f3javah\fPは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。.hファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。 .LP .LP -ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。 +ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fPに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方に付加されます。下線(_)が名前の区切り文字として使用されます。 .LP .LP -デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。 +デフォルトでは\f3javah\fPは、コマンドラインにリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\f2\-stubs\fPオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fPオプションを使用してください。 .LP .LP -新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。 +新しいネイティブ・メソッド・インタフェースである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 のどちらか一方だけが使われます。 +\-ddirectory +\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 @@ -95,23 +95,22 @@ .fl \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仮想マシンの起動前に実行されます。したがって、環境に問合せを行わない限り、Javaプログラムが展開されていないワイルドカードを認識することはありません。たとえば、\f2System.getenv(\\"CLASSPATH\\")\fP呼出しがその例です。 .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
--- a/src/solaris/doc/sun/man/man1/ja/javap.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/javap.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javap 1 "07 May 2011" +.TH javap 1 "21 Mar 2012" .LP .SH "名前" -javap \- Java クラスファイル逆アセンブラ +javap \- Javaクラス・ファイル逆アセンブラ .LP .LP -クラスファイルを逆アセンブルします。 +クラス・ファイルを逆アセンブルします。 .LP .SH "形式" .LP @@ -42,15 +42,15 @@ .SH "説明" .LP .LP -\f3javap\fP コマンドは、1 つまたは複数のクラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。 +\f3javap\fPコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fPは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\f3javap\fPはその出力を標準出力に表示します。 .LP .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 classes -注釈の処理対象となる 1 つ以上のクラス \f2DocFooter.class\fP など) のリスト (空白区切り)。クラスパスで見つかるクラスは、ファイル名 ( \f2/home/user/myproject/src/DocFooter.class\fP など) または URL ( \f2file:///home/user/myproject/src/DocFooter.class\fP など) で指定できます。 +注釈の処理対象となる1つ以上のクラス\f2DocFooter.class\fPなどのリスト(空白区切り)。クラス・パスで見つかるクラスは、ファイル名(\f2/home/user/myproject/src/DocFooter.class\fPなど)またはURL(\f2file:///home/user/myproject/src/DocFooter.class\fPなど)で指定できます。 .RE .LP @@ -101,7 +101,7 @@ .LP .LP -\f3javap DocFooter.class\fP がもたらす出力は次のようになります。 +\f3javap DocFooter.class\fPがもたらす出力は次のようになります。 .LP .nf \f3 @@ -127,7 +127,7 @@ .LP .LP -\f3javap \-c DocFooter.class\fP がもたらす出力は次のようになります。 +\f3javap \-c DocFooter.class\fPがもたらす出力は次のようになります。 .LP .nf \f3 @@ -247,28 +247,28 @@ .RS 3 .TP 3 \-help \-\-help \-? -\f3javap\fP のヘルプメッセージを出力します。 +\f3javap\fPのヘルプ・メッセージを出力します。 .TP 3 \-version -バージョン情報を表示します。 +バージョン情報を出力します。 .TP 3 \-l -行番号と局所変数テーブルを表示します。 +行番号とローカル変数表を出力します。 .TP 3 \-public -public クラスおよびメンバーだけを表示します。 +publicクラスおよびメンバーのみ表示します。 .TP 3 \-protected -protected および public のクラスとメンバーだけを表示します。 +protectedおよびpublicのクラスとメンバーのみを表示します。 .TP 3 \-package -package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。 +package、protected、およびpublicのクラスとメンバーのみ表示します。これがデフォルトです。 .TP 3 \-private \-p すべてのクラスとメンバーを表示します。 .TP 3 \-Jflag -ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。 +ランタイム・システムに直接\f2flag\fPを渡します。使用例を次に示します。 .nf \f3 .fl @@ -280,32 +280,32 @@ .fi .TP 3 \-s -内部の型シグニチャーを出力します。 +内部の型シグニチャを出力します。 .TP 3 \-sysinfo -処理中のクラスのシステム情報 (パス、サイズ、日付、MD5 ハッシュ) を表示します。 +処理中のクラスのシステム情報(パス、サイズ、日付、MD5ハッシュ)を表示します。 .TP 3 \-constants -static final 定数を表示します。 +static final定数を表示します。 .TP 3 \-c -クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは +クラスの各メソッドのために逆アセンブルされるコード、すなわちJavaバイトコードからなる命令を表示します。これらは .na -\f2「Java Virtual Machine Specification」\fP @ +\f2Java Virtual Machine Specification\fP @ .fi 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 環境変数設定を上書きします。 +\f3javap\fPがクラスを探すために使用するパスを指定します。デフォルトまたはCLASSPATH環境変数設定を上書きします。 .TP 3 \-bootclasspath path -ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\f2jre/lib/rt.jar\fPおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .TP 3 \-extdirs dirs -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。 +インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\f2java.ext.dirs\fPです。 .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/javaws.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/javaws.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,16 +19,16 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH javaws 1 "07 May 2011" +.TH javaws 1 "21 Mar 2012" .LP .SH "名前" -\f2javaws\fP コマンド行 +\f2javaws\fPコマンドライン .LP .SH "名前" .LP .LP -\f2javaws\fP \- Java Web Start 起動コマンド +\f2javaws\fP \- Java Web Start起動コマンド .LP .SH "形式" .LP @@ -44,30 +44,30 @@ \f2[run\-options]\fP .LP .LP -コマンド行実行オプション。実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。 +コマンドライン実行オプション。実行オプションは任意の順序で指定できます。各種実行オプションの詳細は、次の実行オプションを参照してください。 .LP .LP \f2<jnlp>\fP .LP .LP -JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。 +JNLP(Java Network Launching Protocol)ファイルのパスまたはURL(Uniform Resource Locator)のどちらかを指定できます。 .LP .LP \f2[control\-options]\fP .LP .LP -コマンド行制御オプション。制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。 +コマンドライン制御オプション。制御オプションは任意の順序で指定できます。各種制御オプションの詳細は、次の制御オプションを参照してください。 .LP .SH "説明" .LP .LP -\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。 +\f2javaws\fPコマンドは、JNLP(Java Network Launching Protocol)のリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションまたはアプレットを起動します。 .LP .LP -JNLP ファイルが指定された場合、 \f2javaws\fP は、その JNLP ファイルで指定された Java アプリケーション/アプレットを起動します。 +JNLPファイルが指定された場合、\f2javaws\fPは、そのJNLPファイルで指定されたJavaアプリケーション/アプレットを起動します。 .LP .LP -\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 +\f2javaws\fP起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 .LP .SH "実行オプション" .LP @@ -75,7 +75,7 @@ \f2\-offline\fP .LP .LP -Java Web Start をオフラインモードで実行します。 +Java Web Startをオフライン・モードで実行します。 .LP .LP \f2\-Xnosplash\fP @@ -87,25 +87,25 @@ \f2\-open <arguments>\fP .LP .LP -このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\f2\-open<arguments>\fPに置き換わります。 .LP .LP \f2\-print <arguments>\fP .LP .LP -このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\f2\-print<arguments>\fPに置き換わります。 .LP .LP \f2\-online\fP .LP .LP -オンラインモードを使用します (デフォルトの動作)。 +オンライン・モードを使用します(デフォルトの動作)。 .LP .LP \f2\-wait\fP .LP .LP -このオプションを指定した場合、 \f2javaws\fP プロセスは、アプリケーションが終了するまで終了しません。Windows プラットフォーム上では、このオプションは説明したとおりに機能しません。 +このオプションを指定した場合、\f2javaws\fPプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。 .LP .LP \f2\-verbose\fP @@ -117,13 +117,13 @@ \f2\-J<option>\fP .LP .LP -vm にオプションを補います。 +VMに対するオプションを指定します。 .LP .LP \f2\-system\fP .LP .LP -アプリケーションをシステムキャッシュからのみ実行します。 +アプリケーションをシステム・キャッシュのみから実行します。 .LP .SH "制御オプション" .LP @@ -131,7 +131,7 @@ \f2\-viewer\fP .LP .LP -Java コントロールパネルでキャッシュビューアを表示します。 +Javaコントロール・パネルでキャッシュ・ビューアを表示します。 .LP .LP \f2\-clearcache\fP @@ -143,13 +143,13 @@ \f2\-userConfig <property name>\fP .LP .LP -指定された配備プロパティーをクリアします。 +指定されたデプロイメント・プロパティをクリアします。 .LP .LP \f2\-userConfig <property name> <property value>\fP .LP .LP -指定された配備プロパティーを指定された値に設定します。 +指定されたデプロイメント・プロパティを指定された値に設定します。 .LP .LP \f2\-uninstall\fP @@ -169,54 +169,54 @@ .LP キャッシュにアプリケーションをインポートします。 .LP -.SH "インポートオプション" +.SH "インポート・オプション" .LP .LP \f2\-silent\fP .LP .LP -サイレントモードでインポートします (UI は表示されません)。 +サイレント・モードでインポートします(ユーザー・インタフェースは表示されません)。 .LP .LP \f2\-system\fP .LP .LP -システムキャッシュにアプリケーションをインポートします。 +システム・キャッシュにアプリケーションをインポートします。 .LP .LP \f2\-codebase <url>\fP .LP .LP -任意の codebase からリソースを取得します。 +指定したcodebaseからリソースを取得します。 .LP .LP \f2\-shortcut\fP .LP .LP -ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。 +ユーザーがプロンプトで許可した場合のようにショートカットをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。 .LP .LP \f2\-association\fP .LP .LP -ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。 +ユーザーがプロンプトで許可した場合のようにアソシエーションをインストールします。このオプションは、\f2\-silent\fPオプションも使用しないと効果がありません。 .LP .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://download.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。 .LP .SH "詳細情報" .LP .LP -Java Web Start の詳細は、 +Java Web Startの詳細は、 .na -\f2「Java Web Start」\fP @ +\f2Java Web Start\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/javaws/index.htmlを参照してください。 .LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/solaris/doc/sun/man/man1/ja/jcmd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,124 @@ +." Copyright (c) 1994, 2012, 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 jcmd 1 "22 Mar 2012" + +.LP +.SH "Name" +jcmd \- 診断コマンド +.LP +.LP +\f3jcmd\fPは、実行中のJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。 +.LP +.SH "形式" +.LP +.nf +\f3 +.fl + \fP\f3jcmd\fP [ option ] +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> PerfCounter.print +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> \f2command\fP [\f2arguments\fP] +.fl + \f3jcmd\fP <\f2pid\fP | \f2main class\fP> \-f \f2file\fP +.fl +.fi + +.LP +.SH "説明" +.LP +.LP +\f3jcmd\fPは、この機能をサポートするJava仮想マシンに診断コマンド・リクエストを送信するユーティリティです。 +.LP +.LP +引数なしまたは\-lオプションを指定してjcmdを使用すると、実行中のJavaプロセスがプロセスID、メイン・クラスおよびコマンドライン引数とともに表示されます。 +.LP +.LP +プロセスIDをコマンドラインに指定すると、jcmdでは、このIDのプロセスに診断コマンド・リクエストが送信されます。 +.LP +.LP +メイン・クラスをコマンドラインに指定すると、jcmdでは、このメイン・クラスのすべてのJavaプロセスに診断コマンド・リクエストが送信されます。 +.LP +.LP +PerfCounter.print引数を指定すると、jcmdでは、ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。 +.LP +.LP +\-f オプションを指定すると、jcmdでは、\f2file\fPに保存されている診断コマンドがターゲットのJavaプロセスに送信されます。 +.LP +.SH "オプション" +.LP +.LP +各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述してください。 +.LP +.RS 3 +.TP 3 +\-l +実行中のJavaプロセスの一覧がプロセスID、メイン・クラスおよびコマンドライン引数とともに出力されます。 +.br +.TP 3 +\-h +ヘルプ・メッセージが出力されます。 +.br +.TP 3 +\-help +ヘルプ・メッセージが出力されます。 +.RE + +.LP +.SH "パラメータ" +.LP +.RS 3 +.TP 3 +pid +診断コマンド・リクエストを受信するプロセスを指定します。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。 +.br +.TP 3 +main class +診断コマンド・リクエストを受信するプロセスのメイン・クラスです。いくつかの実行中のJavaプロセスがこのメイン・クラスを共有している場合は、それらすべてのプロセスに診断コマンド・リクエストが送信されます。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)またはjcmd(1)を使用します。 +.br +.TP 3 +command [arguments] +\f2command\fPという名前の診断コマンドをターゲットのJavaプロセスに対して起動します。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\f3help\fPコマンドを呼び出せば表示されます。各診断コマンドには独自の\f2arguments\fPのセットがあり、\f3help\fPコマンドの後にコマンド名を指定して呼び出せば表示されます。 +.br +.TP 3 +Counter.print +ターゲットのJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。パフォーマンス・カウンタのリストはJavaプロセスによって異なる場合があります。 +.br +.TP 3 +\-f file +\f2file\fPからコマンドを読み取って、ターゲットのJavaプロセスで呼び出します。\f2file\fPでは、各コマンドを1行に記述する必要があります。#で始まる行は無視されます。すべての行が呼び出されるか、\f3stop\fPキーワードを含む行が読み取られると、\f2file\fPの処理が終了します。 +.RE + +.LP +.SH "関連項目" +.LP +.RS 3 +.TP 2 +o +jps(1) +.RE + +.LP +.LP +jps(1) +.LP +
--- a/src/solaris/doc/sun/man/man1/ja/jconsole.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jconsole.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jconsole 1 "07 May 2011" +.TH jconsole 1 "21 Mar 2012" .LP .SH "名前" -jconsole \- Java 監視および管理コンソール +jconsole \- Java監視および管理コンソール .LP .RS 3 .TP 2 @@ -67,49 +67,49 @@ .RS 3 .TP 2 o -\f2pid\fPローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、 +\f2pid\fPローカルのJava VMのプロセスID。Java VMは、jconsoleを実行しているユーザーIDと同じユーザーIDを使用して実行する必要があります。詳細は、 .na -\f2「JMX 監視および管理」\fP @ +\f2JMXの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.htmlを参照してください。 .TP 2 o -\f2host\fP:\f2port\fP Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、 +\f2host\fP:\f2port\fP: Java VMを実行しているホスト・システムの名前と、Java VMを起動したときにシステム・プロパティ\f2com.sun.management.jmxremote.port\fPで指定したポート番号。詳細は、 .na -\f2「JMX 監視および管理」\fP @ +\f2JMXの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.htmlを参照してください。 .TP 2 o -\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。これについては、 +\f2jmxUrl\fP: .na \f2JMXServiceURL\fP @ .fi -http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。 +http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.htmlに記述されている接続先のJMXエージェントのアドレス。 .RE .RE .LP -.SH " 説明" +.SH "説明" .LP .LP -\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。 +\f3jconsole\fPコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンの監視と管理を行うグラフィカル・コンソール・ツールを起動します。 .LP .LP -Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。 +Windows上では、\f3jconsole\fPはコンソール・ウィンドウと関連付けられていません。ただし、なんらかの理由で\f3jconsole\fPコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-interval=n -更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。 +更新間隔を\f2n\fP秒に設定します(デフォルトは4秒)。 .TP 3 \-notile -最初にウィンドウをタイリングしません (複数の接続のため)。 +最初にウィンドウをタイリングしません(複数接続の場合)。 .TP 3 \-pluginpath plugins -JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。 +JConsoleプラグインの検索先となるディレクトリまたはJARファイルのリストを指定します。\f2plugins\fPパスには、次の名前のプロバイダ構成ファイルを含めてください。 .br .nf \f3 @@ -118,21 +118,20 @@ .fl \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://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.htmlクラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに1行ずつ含まれています。 .TP 3 \-version バージョン情報を出力して終了します。 .TP 3 \-help -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-J<flag> -jconsole が実行されている Java 仮想マシンに <flag> を渡します。 +jconsoleが実行されているJava仮想マシンに<flag>を渡します。 .RE .LP @@ -142,15 +141,15 @@ .TP 2 o .na -\f2JConsole の使用\fP @ +\f2JConsoleの使用\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html +http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html .TP 2 o .na -\f2「Java プラットフォームの監視および管理」\fP @ +\f2Javaプラットフォームの監視および管理\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/management/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jdb.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jdb.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jdb 1 "07 May 2011" +.TH jdb 1 "21 Mar 2012" .LP .SH "名前" -jdb \- Java デバッガ +jdb \- Javaデバッガ .LP .LP -\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。 +\f3jdb\fPは、Java言語プログラムのバグを見つけて修正するために使用するツールです。 .LP .SH "形式" .LP @@ -41,30 +41,30 @@ .RS 3 .TP 3 options -次に示すコマンド行オプション +次に示すコマンドライン・オプション .TP 3 class デバッグを開始するクラスの名前 .TP 3 arguments -class の \f2main()\fP メソッドに渡す \f2引数\fP +\f2class\fPの\f2main()\fPメソッドに渡す引数 .RE .LP -.SH " 説明" +.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://download.oracle.com/javase/7/docs/technotes/guides/jpda/index.htmlを視覚的に実行し、ローカルまたはリモートのJava Virtual Machineの検査とデバッグを行うことができます。 .LP .SS -jdb セッションの開始 +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 @@ -76,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 @@ -91,7 +91,7 @@ .LP .LP -たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。 +たとえば、次のコマンドは、MyClassアプリケーションを実行して、\f3jdb\fPがあとでそのアプリケーションに接続できるようにします。 .LP .nf \f3 @@ -103,7 +103,7 @@ .LP .LP -次のコマンドを使用して、\f3jdb\fP を VM に接続できます。 +次のコマンドを使用して、\f3jdb\fPをVMに接続できます。 .LP .nf \f3 @@ -115,42 +115,44 @@ .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 @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、 +http://download.oracle.com/javase/7/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を参照してください。 .LP .SS -基本 jdb コマンド +基本jdbコマンド .LP .LP -基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。 +基本的な\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 コマンドの説明を参照してください。 -.LP -\f2注: 局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされている必要があります。 -.LP -\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。次に例を示します。 +Javaオブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の\f2dump\fPコマンドの説明を参照してください。 +.br +.br +\f2注意: ローカル変数を表示するには、その変数を含むクラスが\fP\f2javac(1)\fP\f2 \fP\f2\-g\fPオプションでコンパイルされている必要があります。 +.br +.br +\f2print\fPでは、メソッドの呼出しを含む多数の簡単なJava式がサポートされています。次に例を示します。 .RS 3 .TP 2 o @@ -160,22 +162,23 @@ \f2print myObj.myInstanceField\fP .TP 2 o -\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか) +\f2print i+j+k\fP \f2(i、j、およびkはプリミティブであり、フィールドまたはローカル変数のいずれか)\fP .TP 2 o -\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合) +\f2print myObj.myMethod()\fP \f2(myMethodがnull以外を返す場合)\fP .TP 2 o \f2print new java.lang.String("Hello").length()\fP .RE .TP 3 dump -プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。 -.LP -\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。 +プリミティブ値の場合には、このコマンドは\f2print\fPと同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。 +.br +.br +\f2dump\fPコマンドでは、\f2print\fPコマンドと同じ式がサポートされます。 .TP 3 threads -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。次に例を示します。 +現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。次に例を示します。 .nf \f3 .fl @@ -183,15 +186,16 @@ .fl \fP .fi -この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。スレッドの名前は「main」であり、現在実行中です。 +この例では、スレッド・インデックスは4であり、スレッドはjava.lang.Threadのインスタンスです。スレッドの名前は「main」であり、現在実行中です。 .TP 3 thread -現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。 +現在のスレッドにするスレッドを選択します。多くの\f3jdb\fPコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fPコマンドで説明したスレッド・インデックスとともに指定します。 .TP 3 where -\f2引数を指定しないで\fP where を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックをすべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。 -.LP -現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。 +引数を指定しないで\f2where\fPを実行すると、現在のスレッドのスタックがダンプされます。\f2where all\fPコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\f2where\fP \f2threadindex\fPは、指定されたスレッドのスタックをダンプします。 +.br +.br +現在のスレッドが(ブレークポイントか\f2suspend\fPコマンドによって)中断している場合は、ローカル変数とフィールドは\f2print\fPコマンドと\f2dump\fPコマンドで表示できます。\f2up\fPコマンドと\f2down\fPコマンドで、どのスタック・フレームをカレントにするかを選ぶことができます。 .RE .LP @@ -199,105 +203,105 @@ ブレークポイント .LP .LP -ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。次に例を示します。 +ブレークポイントは、行番号またはメソッドの最初の命令で\f3jdb\fPに設定できます。次に例を示します。 .LP .RS 3 .TP 2 o -\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定) +\f2stop at MyClass:22\fP \f2(MyClassが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定)\fP .TP 2 o -\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定) +\f2stop in java.lang.String.length\fP \f2(\fP\f2java.lang.String.length\fPメソッドの最初にブレークポイントを設定) .TP 2 o -\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別) +\f2stop in MyClass.<init>\fP \f2(<init>はMyClassコンストラクタを識別)\fP .TP 2 o -\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別) +\f2stop in MyClass.<clinit>\fP \f2(<clinit>はMyClassの静的初期化コードを識別)\fP .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 .SS ステップ実行 .LP .LP -\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。 +\f2step\fPコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fPコマンドは、現在のスタック・フレームの次の行を実行します。 .LP .SS 例外 .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 -.SH "コマンド行オプション" +.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 @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/jpda/conninv.htmlを参照してください。 .LP .SS デバッグ対象のプロセスに転送されるオプション @@ -308,13 +312,13 @@ 冗長モードにします。 .TP 3 \-D<name>=<value> -システムプロパティーを設定します。 +システム・プロパティを設定します。 .TP 3 \-classpath <directories separated by ":"> クラスを検索するディレクトリを一覧表示します。 .TP 3 \-X<option> -非標準ターゲット VM オプションです。 +非標準ターゲットVMオプションです。 .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jhat.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jhat.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jhat 1 "07 May 2011" +.TH jhat 1 "21 Mar 2012" .LP .SH "名前" -jhat \- Java ヒープ解析ツール +jhat \- Javaヒープ解析ツール .LP .RS 3 .TP 2 @@ -64,77 +64,77 @@ オプションを使用する場合、コマンド名の直後に記述してください。 .TP 3 heap\-dump\-file -ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。 +ブラウズ対象となる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」のすべてのインスタンスを表示する」といった、事前に設計されたクエリーの他、ヒープ・ダンプをクエリーするSQLに似たクエリー言語である\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://download.oracle.com/javase/7/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 "オプション" .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 バージョン番号を報告したあと、終了します。 .TP 3 \-h -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-help -ヘルプメッセージを出力して終了します。 +ヘルプ・メッセージを出力して終了します。 .TP 3 \-J<flag> -jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。 +jhatが実行されているJava仮想マシンに<flag>を渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\-J\-Xmx512mとします。 .RE .LP @@ -150,7 +150,7 @@ .TP 2 o .na -\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @ +\f2hprof \- ヒープおよびCPUプロファイリング・ツール\fP @ .fi http://java.sun.com/developer/technicalArticles/Programming/HPROF.html .RE
--- a/src/solaris/doc/sun/man/man1/ja/jinfo.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jinfo.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,7 +19,7 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jinfo 1 "07 May 2011" +.TH jinfo 1 "21 Mar 2012" .LP .SH "名前" @@ -70,84 +70,84 @@ .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 アドレスです。 +リモート・デバッグ・サーバー(jsadebugd(1)を参照)のホスト名またはIPアドレス。 .RE .LP .RS 3 .TP 3 server\-id -複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 +複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。 .RE .LP .SH "説明" .LP .LP -\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 +\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 +\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 +\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
--- a/src/solaris/doc/sun/man/man1/ja/jmap.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jmap.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jmap 1 "07 May 2011" +.TH jmap 1 "21 Mar 2012" .LP .SH "名前" -jmap \- メモリーマップ +jmap \- メモリー・マップ .LP .RS 3 .TP 2 @@ -66,23 +66,23 @@ 各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。 .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 @@ -90,7 +90,7 @@ .SH "説明" .LP .LP -\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 +\f3jmap\fPは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットVM上で実行されている場合、\f2\-J\-d64\fPオプションを指定する必要がある場合があります。次に例を示します。 .LP .nf \f3 @@ -102,10 +102,10 @@ .LP .LP -\f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP +\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 +\f3次に例を示します。\fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .LP .br @@ -115,11 +115,11 @@ .RS 3 .TP 3 <オプションなし> -オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット 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 @@ -127,33 +127,33 @@ .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 @@ -163,7 +163,7 @@ .RS 3 .TP 2 o -pmap (1) +pmap(1) .TP 2 o jhat(1)
--- a/src/solaris/doc/sun/man/man1/ja/jps.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jps.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jps 1 "07 May 2011" +.TH jps 1 "21 Mar 2012" .LP .SH "名前" -jps \- Java 仮想マシンプロセスステータスツール +jps \- Java仮想マシン・プロセス・ステータス・ツール .LP .RS 3 .TP 2 @@ -70,57 +70,57 @@ .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 hostid -プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。 +プロセス・レポートを生成するホストのホスト識別子。\f2hostid\fPには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。 .RE .LP -.SH " 説明" +.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 .LP -\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 +\f3jps\fPコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 .LP .RS 3 .TP 3 \-q -クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。 +クラス名、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 @@ -128,7 +128,7 @@ ホスト識別子 .LP .LP -ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。 +ホスト識別子、つまり\f2hostid\fPは、ターゲット・システムを示す文字列です。\f2hostid\fP文字列の構文の大部分は、URIの構文に対応しています。 .LP .nf \f3 @@ -144,23 +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 .SH "出力形式" .LP .LP -\f3jps\fP コマンドの出力は、次のパターンに従います。 +\f3jps\fPコマンドの出力は、次のパターンに従います。 .LP .nf \f3 @@ -174,20 +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 .LP -この節では、\f3jps\fP コマンドの例を示します。 +この項では、\f3jps\fPコマンドの例を示します。 .LP .LP -ローカルホスト上で計測された JVM を一覧表示する場合: +ローカル・ホスト上で計測されたJVMを一覧表示する場合: .LP .nf \f3 @@ -212,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 @@ -236,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 @@ -262,16 +262,16 @@ .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/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jrunscript 1 "07 May 2011" +.TH jrunscript 1 "21 Mar 2012" .LP .SH "名前" -jrunscript \- コマンド行スクリプトシェル +jrunscript \- コマンドライン・スクリプト・シェル .LP .RS 3 .TP 2 @@ -72,65 +72,65 @@ .RE .LP -.SH " 説明" +.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 .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が使用されます。他のスクリプト言語を使用するには、\-cpまたは\-classpathオプションを使用して、対応するスクリプト・エンジンのJARファイルも指定する必要があります。 .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 "引数" .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 配列型のエンジン変数を使用します。 +[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 "例" .LP .SS -インラインスクリプトの実行 +インライン・スクリプトの実行 .LP .nf \f3 @@ -144,7 +144,7 @@ .LP .SS -指定された言語を使用し、指定されたスクリプトファイルを評価する +指定された言語の使用および指定されたスクリプト・ファイルの評価 .LP .nf \f3 @@ -188,7 +188,7 @@ .LP .SS -スクリプト引数を指定してスクリプトファイルを実行する +スクリプト引数を指定したスクリプト・ファイルの実行 .LP .nf \f3 @@ -199,10 +199,14 @@ .fi .LP -test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。 +test.jsが実行対象となるスクリプト・ファイルであり、arg1、arg2およびarg3はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使用してこれらにアクセスできます。 .SH "関連項目" .LP .LP -JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。 +JavaScriptが使用される場合、jrunscriptは、最初のユーザー定義スクリプトを評価する前に、いくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScript組込み機能については、 +.na +\f2jsdocs\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/tools/share/jsdocs/allclasses\-noframe.htmlを参照してください。 .LP
--- a/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jsadebugd 1 "07 May 2011" +.TH jsadebugd 1 "21 Mar 2012" .LP .SH "名前" -jsadebugd \- サービスアビリティーエージェントデバッグデーモン +jsadebugd \- サービスアビリティ・エージェント・デバッグ・デーモン .LP .RS 3 .TP 2 @@ -58,44 +58,27 @@ .RS 3 .TP 3 pid -デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。 -.RE - -.LP -.RS 3 +デバッグ・サーバーが接続するプロセスのプロセスIDです。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)を使用します。単一のプロセスに接続できるデバッグ・サーバーのインスタンスは、1つに制限されます。 .TP 3 executable -.RE - -.LP -.RS 3 -.TP 3 -コアダンプの作成元になる Java 実行可能ファイルです。 -.RE - -.LP -.RS 3 +コア・ダンプの作成元のJava実行可能ファイル。 .TP 3 core -デバッグサーバーを接続するコアファイルです。 -.RE - -.LP -.RS 3 +デバッグ・サーバーを接続するコア・ファイルです。 .TP 3 server\-id -複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。 +複数のデバッグ・サーバーが同一のマシン上で実行されている場合に必要になる、オプションの一意のIDです。このIDは、リモート・クライアントが、接続先のデバッグ・サーバーを特定するために使用する必要があります。このIDは、単一のマシン内で一意にする必要があります。 .RE .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 を起動する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmiを起動する必要があります。 .LP .nf \f3 @@ -107,13 +90,13 @@ .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注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。 +\f3注意\fP \- このユーティリティはサポート対象外であり、将来のJDKのバージョンでは利用できなくなる可能性があります。dbgeng.dllが存在していないWindowsシステムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、\f2PATH\fP環境変数には、ターゲット・プロセスによって使用される\f2jvm.dll\fPの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。 .LP .LP -次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP +次に例を示します。\f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .LP .SH "関連項目" .LP @@ -135,7 +118,7 @@ .na \f2rmiregistry\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jstack.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jstack.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstack 1 "07 May 2011" +.TH jstack 1 "21 Mar 2012" .LP .SH "名前" -jstack \- スタックトレース +jstack \- スタック・トレース .br .LP @@ -73,33 +73,33 @@ .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 .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 @@ -113,35 +113,35 @@ .LP .LP -\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。 +\f3注意\fP \- このユーティリティはサポート対象外であり、将来のJDKのバージョンでは利用できなくなる可能性があります。dbgeng.dllが存在していないWindowsシステムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、\f2PATH\fP環境変数には、ターゲット・プロセスによって使用される\f2jvm.dll\fPの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。 .LP .LP -次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP +次に例を示します。\f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP .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 @ .fi -http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。 +http://download.oracle.com/javase/7/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 @@ -167,6 +167,6 @@ .SH "既知のバグ" .LP .LP -混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。 +混合モードのスタック・トレース(\-mオプション使用)は、リモート・デバッグ・サーバーでは機能しません。 .LP
--- a/src/solaris/doc/sun/man/man1/ja/jstat.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jstat.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstat 1 "07 May 2011" +.TH jstat 1 "21 Mar 2012" .LP .SH "名前" -jstat \- Java 仮想マシン統計データ監視ツール +jstat \- Java仮想マシン統計データ監視ツール .LP .RS 3 .TP 2 @@ -73,36 +73,36 @@ .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 " 説明" +.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 @@ -110,7 +110,7 @@ 仮想マシン識別子 .LP .LP -\f2vmid\fP 文字列の構文の大部分は、URI の構文に対応しています。 +\f2vmid\fP文字列の構文の大部分は、URIの構文に対応しています。 .LP .nf \f3 @@ -123,31 +123,31 @@ .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 .SH "オプション" .LP .LP -\f3jstat\fP コマンドは、一般的なオプションと出力オプションの 2 つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fP は簡単な使用率およびバージョン情報を表示します。出力オプションでは、統計データ出力の内容と形式を指定します。 +\f3jstat\fPコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\f3jstat\fPは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 .br .LP .LP -\f3注\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 +\f3注意\fP: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 .LP .SS 一般的なオプション @@ -158,13 +158,13 @@ .RS 3 .TP 3 \-help -ヘルプメッセージを表示します。 +ヘルプ・メッセージを表示します。 .TP 3 \-version バージョン情報を表示します。 .TP 3 \-options -統計データオプションを一覧表示します。下記の「出力オプション」の節を参照してください。 +統計データ・オプションを一覧表示します。下記の出力オプションの項を参照してください。 .RE .LP @@ -172,24 +172,24 @@ 出力オプション .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 @@ -221,7 +221,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -クラスローダーの動作に関する統計データ +クラス・ローダーの動作に関する統計データ .br .di .nr a| \n(dn @@ -237,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 @@ -253,7 +253,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクトされたヒープの動作に関する統計データ +ガベージ・コレクトされたヒープの動作に関する統計データ .br .di .nr c| \n(dn @@ -285,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 @@ -301,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 @@ -317,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 @@ -333,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 @@ -349,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 @@ -365,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 @@ -381,7 +381,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション統計データの概要 +ガベージ・コレクション統計データの概要 .br .di .nr k| \n(dn @@ -397,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 @@ -705,26 +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 \-JjavaOption -\f2javaOption\fP を \f3java\fP アプリケーション起動ツールへ渡す。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。オプションの完全なリストについては、「java(1)」のドキュメントを参照してください。 +\f2javaOption\fPを\f3java\fPアプリケーション起動ツールに渡します。たとえば、\f3\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーは48Mバイトに設定されます。オプションの完全なリストについては、java(1)を参照してください。 .RE .LP .SS -statOption と出力 +statOptionと出力 .LP .LP -以降の表では、\f3jstat\fP が \f2statOption\fP ごとに出力する列について概要を示します。 +以降の表では、\f3jstat\fPが\f2statOption\fPごとに出力する列について概要を示します。 .br .LP .SS -\-class オプション +\-classオプション .LP .LP .TS @@ -771,7 +771,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ロードされた K バイト数 +アンロードされたクラスの数 .br .di .nr b| \n(dn @@ -787,7 +787,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -アンロードされたクラスの数 +アンロードされたKB数 .br .di .nr c| \n(dn @@ -803,34 +803,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -アンロードされた K バイト数 +クラスのロードやアンロード処理に要した時間 .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 -クラスのロードやアンロード処理に要した時間 -.br -.di -.nr e| \n(dn -.nr e- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -849,6 +833,8 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wロードされたKB数 +.if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 .nr 38 \n(a- @@ -859,8 +845,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(d- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(e- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -871,7 +855,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 298 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 296 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -888,7 +872,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -909,12 +893,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'Bytes\h'|\n(41u'ロードされたKB数 .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'Bytes\h'|\n(41u' +\&\h'|\n(40u'Unloaded\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -930,7 +918,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'Unloaded\h'|\n(41u' +\&\h'|\n(40u'Bytes\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -946,7 +934,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'Bytes\h'|\n(41u' +\&\h'|\n(40u'Time\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -957,22 +945,6 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ne \n(e|u+\n(.Vu -.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'Time\h'|\n(41u' -.mk ## -.nr 31 \n(## -.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 .fc .nr T. 1 .T# 1 @@ -981,13 +953,12 @@ .rm b+ .rm c+ .rm d+ -.rm e+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-25 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-23 .LP .SS -\-compiler オプション +\-compilerオプション .LP .LP .TS @@ -1018,7 +989,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -実行されたコンパイルタスクの数 +実行されたコンパイル・タスクの数 .br .di .nr a| \n(dn @@ -1034,7 +1005,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -失敗したコンパイルタスクの数 +失敗したコンパイル・タスクの数 .br .di .nr b| \n(dn @@ -1050,7 +1021,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -無効にされたコンパイルタスクの数 +無効にされたコンパイル・タスクの数 .br .di .nr c| \n(dn @@ -1066,7 +1037,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -コンパイルタスクの実行に要した時間 +コンパイル・タスクの実行に要した時間 .br .di .nr d| \n(dn @@ -1082,7 +1053,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -最後に失敗したコンパイルのコンパイルタイプ +最後に失敗したコンパイルのコンパイル・タイプ .br .di .nr e| \n(dn @@ -1109,7 +1080,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -1154,7 +1125,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 334 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 332 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1171,7 +1142,7 @@ .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 @@ -1287,7 +1258,7 @@ .LP .SS -\-gc オプション +\-gcオプション .LP .LP .TS @@ -1318,7 +1289,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 @@ -1334,7 +1305,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 @@ -1350,7 +1321,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 @@ -1366,7 +1337,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 @@ -1382,7 +1353,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 @@ -1398,7 +1369,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 @@ -1414,7 +1385,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 @@ -1430,7 +1401,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (KB) +Permanent領域の現在の容量(KB) .br .di .nr h| \n(dn @@ -1446,7 +1417,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 @@ -1462,7 +1433,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Permanent 領域の使用率 (KB) +若い世代のGCイベント数 .br .di .nr j| \n(dn @@ -1478,7 +1449,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のガベージ・コレクション時間 .br .di .nr k| \n(dn @@ -1494,7 +1465,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr l| \n(dn @@ -1510,34 +1481,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +ガベージ・コレクション総時間 .br .di .nr m| \n(dn .nr m- \n(dl .. .ec \ -.eo -.am 81 -.br -.di n+ -.35 -.ft \n(.f -.ll \n(34u*1u/3u -.if \n(.l<\n(81 .ll \n(81u -.in 0 -ガベージコレクション総時間 -.br -.di -.nr n| \n(dn -.nr n- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -1576,7 +1531,9 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wフル GC イベント数 +.nr 38 \wOld領域の使用率(KB) +.if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wフルGCイベント数 .if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 @@ -1606,8 +1563,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(m- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(n- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -1618,7 +1573,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 404 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 400 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -1635,7 +1590,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -1752,12 +1707,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'OU\h'|\n(41u'Old領域の使用率(KB) .ne \n(h|u+\n(.Vu .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'OU\h'|\n(41u' +\&\h'|\n(40u'PC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1773,7 +1732,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'PC\h'|\n(41u' +\&\h'|\n(40u'PU\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1789,7 +1748,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'PU\h'|\n(41u' +\&\h'|\n(40u'YGC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1805,7 +1764,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'YGC\h'|\n(41u' +\&\h'|\n(40u'YGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1816,12 +1775,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'FGC\h'|\n(41u'フルGCイベント数 .ne \n(l|u+\n(.Vu .if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'YGCT\h'|\n(41u' +\&\h'|\n(40u'FGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -1832,38 +1795,18 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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 .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'FGCT\h'|\n(41u' -.mk ## -.nr 31 \n(## -.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 -.ne \n(n|u+\n(.Vu -.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v) -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m \&\h'|\n(40u'GCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v .nr 37 \n(41u .in +\n(37u -.n+ +.m+ .in -\n(37u .mk 32 .if \n(32>\n(31 .nr 31 \n(32 @@ -1885,13 +1828,12 @@ .rm k+ .rm l+ .rm m+ -.rm n+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-61 .LP .SS -\-gccapacity オプション +\-gccapacityオプション .LP .LP .TS @@ -1922,7 +1864,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 @@ -1938,7 +1880,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 @@ -1954,7 +1896,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 @@ -1970,7 +1912,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 @@ -1986,7 +1928,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 @@ -2002,7 +1944,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 @@ -2018,7 +1960,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 @@ -2034,7 +1976,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 @@ -2050,7 +1992,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 @@ -2066,7 +2008,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 @@ -2082,7 +2024,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 @@ -2098,7 +2040,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 @@ -2114,7 +2056,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 @@ -2130,7 +2072,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 @@ -2146,7 +2088,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr o| \n(dn @@ -2157,7 +2099,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2198,7 +2140,7 @@ .nr 81 0 .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 @@ -2242,7 +2184,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 478 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 474 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2259,7 +2201,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -2507,7 +2449,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 @@ -2532,10 +2474,10 @@ .LP .SS -\-gccause オプション +\-gccauseオプション .LP .LP -このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。 +このオプションは、\f3\-gcutil\fPオプションと同じガベージ・コレクション統計データの概要を表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\f3\-gcutil\fPで一覧表示される列のほか、このオプションでは次の列が追加されます。 .LP .LP .TS @@ -2566,7 +2508,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -最後のガベージコレクションの原因 +最後のガベージ・コレクションの原因 .br .di .nr a| \n(dn @@ -2582,7 +2524,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -現在のガベージコレクションの原因 +現在のガベージ・コレクションの原因 .br .di .nr b| \n(dn @@ -2593,7 +2535,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2622,7 +2564,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 501 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 497 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2639,7 +2581,7 @@ .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 @@ -2687,7 +2629,7 @@ .LP .SS -\-gcnew オプション +\-gcnewオプション .LP .LP .TS @@ -2718,7 +2660,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 @@ -2734,7 +2676,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 @@ -2750,7 +2692,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 @@ -2766,7 +2708,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 @@ -2798,7 +2740,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 @@ -2814,7 +2756,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 @@ -2830,7 +2772,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 @@ -2846,7 +2788,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr i| \n(dn @@ -2862,7 +2804,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +若い世代のガベージ・コレクション時間 .br .di .nr j| \n(dn @@ -2873,7 +2815,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -2938,7 +2880,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 555 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 551 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -2955,7 +2897,7 @@ .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 @@ -3143,7 +3085,7 @@ .LP .SS -\-gcnewcapacity オプション +\-gcnewcapacityオプション .LP .LP .TS @@ -3174,7 +3116,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 @@ -3190,7 +3132,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 @@ -3206,7 +3148,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 @@ -3222,7 +3164,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 @@ -3238,7 +3180,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 @@ -3254,7 +3196,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 @@ -3270,7 +3212,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 @@ -3286,7 +3228,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 @@ -3302,7 +3244,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 @@ -3318,7 +3260,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr j| \n(dn @@ -3329,7 +3271,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -3360,7 +3302,7 @@ .nr 81 0 .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 @@ -3394,7 +3336,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 609 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 605 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -3411,7 +3353,7 @@ .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 @@ -3579,7 +3521,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 @@ -3599,7 +3541,7 @@ .LP .SS -\-gcold オプション +\-gcoldオプション .LP .LP .TS @@ -3630,7 +3572,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 @@ -3646,7 +3588,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 @@ -3662,7 +3604,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 @@ -3678,7 +3620,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (KB) +若い世代のGCイベント数 .br .di .nr d| \n(dn @@ -3694,7 +3636,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +フルガベージ・コレクション時間 .br .di .nr e| \n(dn @@ -3710,34 +3652,18 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +ガベージ・コレクション総時間 .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 -ガベージコレクション総時間 -.br -.di -.nr g| \n(dn -.nr g- \n(dl -.. -.ec \ .35 .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -3762,7 +3688,9 @@ .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wフル GC イベント数 +.nr 38 \wOld領域の使用率(KB) +.if \n(81<\n(38 .nr 81 \n(38 +.nr 38 \wフルGCイベント数 .if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 @@ -3778,8 +3706,6 @@ .if \n(81<\n(38 .nr 81 \n(38 .nr 38 \n(f- .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \n(g- -.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -3790,7 +3716,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 651 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 645 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -3807,7 +3733,7 @@ .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 @@ -3860,12 +3786,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'OU\h'|\n(41u'Old領域の使用率(KB) .ne \n(d|u+\n(.Vu .if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v) .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'OU\h'|\n(41u' +\&\h'|\n(40u'YGC\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -3876,12 +3806,16 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'FGC\h'|\n(41u'フルGCイベント数 .ne \n(e|u+\n(.Vu .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'YGC\h'|\n(41u' +\&\h'|\n(40u'FGCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -3892,38 +3826,18 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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 .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'FGCT\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 -.ne \n(g|u+\n(.Vu -.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'GCT\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v .nr 37 \n(41u .in +\n(37u -.g+ +.f+ .in -\n(37u .mk 32 .if \n(32>\n(31 .nr 31 \n(32 @@ -3938,13 +3852,12 @@ .rm d+ .rm e+ .rm f+ -.rm g+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-33 .LP .SS -\-gcoldcapacity オプション +\-gcoldcapacityオプション .LP .LP .TS @@ -3975,7 +3888,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 @@ -3991,7 +3904,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 @@ -4007,7 +3920,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 @@ -4023,7 +3936,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 @@ -4039,7 +3952,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr e| \n(dn @@ -4055,7 +3968,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr f| \n(dn @@ -4071,7 +3984,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr g| \n(dn @@ -4082,7 +3995,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4107,7 +4020,7 @@ .nr 81 0 .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 @@ -4135,7 +4048,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 693 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 687 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4152,7 +4065,7 @@ .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 @@ -4240,7 +4153,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 @@ -4289,7 +4202,7 @@ .LP .SS -\-gcpermcapacity オプション +\-gcpermcapacityオプション .LP .LP .TS @@ -4320,7 +4233,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 @@ -4336,7 +4249,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 @@ -4352,7 +4265,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 @@ -4368,7 +4281,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 @@ -4384,7 +4297,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr e| \n(dn @@ -4400,7 +4313,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr f| \n(dn @@ -4416,7 +4329,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr g| \n(dn @@ -4427,7 +4340,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4452,7 +4365,7 @@ .nr 81 0 .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 @@ -4480,7 +4393,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 735 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 729 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4497,7 +4410,7 @@ .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 @@ -4585,7 +4498,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 @@ -4634,7 +4547,7 @@ .LP .SS -\-gcutil オプション +\-gcutilオプション .LP .LP .TS @@ -4665,7 +4578,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 @@ -4681,7 +4594,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 @@ -4697,7 +4610,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Eden 領域の使用率 (現在の容量に対するパーセンテージ) +Eden領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr c| \n(dn @@ -4713,7 +4626,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Old 領域の使用率 (現在の容量に対するパーセンテージ) +Old領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr d| \n(dn @@ -4729,7 +4642,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -Permanent 領域の使用率 (現在の容量に対するパーセンテージ) +Permanent領域の使用率(現在の容量に対するパーセンテージ) .br .di .nr e| \n(dn @@ -4745,7 +4658,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代の GC イベント数 +若い世代のGCイベント数 .br .di .nr f| \n(dn @@ -4761,7 +4674,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -若い世代のガベージコレクション時間 +若い世代のガベージ・コレクション時間 .br .di .nr g| \n(dn @@ -4777,7 +4690,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -フルガベージコレクション時間 +フルガベージ・コレクション時間 .br .di .nr h| \n(dn @@ -4793,7 +4706,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ガベージコレクション総時間 +ガベージ・コレクション総時間 .br .di .nr i| \n(dn @@ -4804,7 +4717,7 @@ .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 .if \n(80<\n(38 .nr 80 \n(38 @@ -4833,7 +4746,7 @@ .nr 81 0 .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 @@ -4865,7 +4778,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 785 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 779 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -4882,7 +4795,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' .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m @@ -5002,7 +4915,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 @@ -5053,7 +4966,7 @@ .LP .SS -\-printcompilation オプション +\-printcompilationオプション .LP .LP .TS @@ -5084,7 +4997,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -実行されたコンパイルタスクの数 +実行されたコンパイル・タスクの数 .br .di .nr a| \n(dn @@ -5116,36 +5029,50 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」の代わりに「/」が使用される。メソッド名は、指定されたクラス内のメソッドである。これらの 2 つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fP オプションと対応している +コンパイル・タイプ .br .di .nr c| \n(dn .nr c- \n(dl .. .ec \ +.eo +.am 81 +.br +.di d+ +.35 +.ft \n(.f +.ll \n(34u*1u/3u +.if \n(.l<\n(81 .ll \n(81u +.in 0 +コンパイル方法を特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、「.」のかわりに「/」が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot \- \f3XX:+PrintComplation\fPオプションと対応しています。 +.br +.di +.nr d| \n(dn +.nr d- \n(dl +.. +.ec \ .35 .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 .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 \wSize .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \w型 +.nr 38 \wType .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \wメソッド +.nr 38 \wMethod .if \n(80<\n(38 .nr 80 \n(38 .80 .rm 80 .nr 81 0 .nr 38 \w\f3説明\fP .if \n(81<\n(38 .nr 81 \n(38 -.nr 38 \wコンパイルタイプ -.if \n(81<\n(38 .nr 81 \n(38 .81 .rm 81 .nr 38 \n(a- @@ -5154,6 +5081,8 @@ .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(d- +.if \n(81<\n(38 .nr 81 \n(38 .35 .nf .ll \n(34u @@ -5164,7 +5093,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 811 file Input is too wide - \n(TW units +.if t .if \n(TW>\n(.li .tm Table at line 807 file Input is too wide - \n(TW units .fc .nr #T 0-1 .nr #a 0-1 @@ -5181,7 +5110,7 @@ .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 @@ -5207,7 +5136,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'サイズ\h'|\n(41u' +\&\h'|\n(40u'Size\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -5218,16 +5147,12 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u -.ta \n(80u \n(81u -.nr 31 \n(.f -.nr 35 1m -\&\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'Type\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -5238,6 +5163,22 @@ .mk 32 .if \n(32>\n(31 .nr 31 \n(32 .sp |\n(31u +.ne \n(d|u+\n(.Vu +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v) +.ta \n(80u \n(81u +.nr 31 \n(.f +.nr 35 1m +\&\h'|\n(40u'Method\h'|\n(41u' +.mk ## +.nr 31 \n(## +.sp |\n(##u-1v +.nr 37 \n(41u +.in +\n(37u +.d+ +.in -\n(37u +.mk 32 +.if \n(32>\n(31 .nr 31 \n(32 +.sp |\n(31u .fc .nr T. 1 .T# 1 @@ -5245,20 +5186,21 @@ .rm a+ .rm b+ .rm c+ +.rm d+ .TE -.if \n-(b.=0 .nr c. \n(.c-\n(d.-19 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-21 .LP .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 @@ -5303,13 +5245,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 @@ -5362,16 +5304,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 @@ -5400,13 +5342,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へ増加しています。この世代(および領域)の最大容量は、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 @@ -5423,23 +5365,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 .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) \- jvmstatデーモン .TP 2 o -「rmiregistry(1) \- Java リモートオブジェクトレジストリ」 +rmiregistry(1) \- Javaリモート・オブジェクト・レジストリ .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jstatd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jstatd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jstatd 1 "07 May 2011" +.TH jstatd 1 "21 Mar 2012" .LP .SH "名前" -jstatd \- 仮想マシン jstat デーモン +jstatd \- 仮想マシンjstatデーモン .LP .RS 3 .TP 2 @@ -40,10 +40,10 @@ オプション .TP 2 o -セキュリティー +セキュリティ .TP 2 o -リモートインタフェース +リモート・インタフェース .TP 2 o 例 @@ -71,59 +71,59 @@ .RS 3 .TP 3 options -コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。 +コマンドライン・オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。 .RE .LP -.SH " 説明" +.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 .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 "セキュリティー" +.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 プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。 +\f3jstatd\fPサーバーには、リモート・クライアントの認証機能がありません。そのため、\f3jstatd\fPサーバー・プロセスを実行すると、\f3jstatd\fPプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に実稼働環境または安全でないネットワークでは、\f3jstatd\fPプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 .LP .LP -\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の +\f3jstatd\fPサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、RMISecurityPolicyのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、デフォルト・ポリシー実装の .na -\f2ポリシーファイルの構文\fP @ +\f2ポリシー・ファイルの構文\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。 .LP .LP -次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。 +次のポリシー・ファイルでは、セキュリティ例外を発生せずに\f3jstatd\fPサーバーを実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\f3jstatd\fPサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 .LP .nf \f3 @@ -145,7 +145,7 @@ .LP .LP -このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。 +このポリシーを使用するには、このテキストを\f2jstatd.all.policy\fPというファイルにコピーし、次のように\f3jstatd\fPサーバーを実行します。 .LP .nf \f3 @@ -159,23 +159,23 @@ .LP .LP -より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。 +より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\f3jstatd\fPサーバーを実行せずに、\f3jstat\fPと\f3jps\fPツールをローカルで使用することが最も安全な方法になります。 .LP -.SH "リモートインタフェース" +.SH "リモート・インタフェース" .LP .LP -\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。 +\f3jstatd\fPプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 .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 @@ -187,10 +187,10 @@ .LP .SS -外部 RMI レジストリの使用 +外部RMIレジストリの使用 .LP .LP -この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -204,7 +204,7 @@ .LP .LP -この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、ポート2020の外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -218,7 +218,7 @@ .LP .LP -この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。 +この例は、AlternateJstatdServerNameの名前にバインドされた、ポート2020の外部RMIレジストリを使用した\f3jstatd\fPの起動を表しています。 .LP .nf \f3 @@ -232,10 +232,10 @@ .LP .SS -インプロセス RMI レジストリの作成の禁止 +インプロセスRMIレジストリの作成の禁止 .LP .LP -この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。 +この例は、RMIレジストリが見つからない場合にRMIレジストリを作成しない\f3jstatd\fPの起動を表しています。この例では、RMIレジストリがすでに実行されていると想定しています。実行されていない場合は、適切なエラー・メッセージが表示されます。 .LP .nf \f3 @@ -247,10 +247,10 @@ .LP .SS -RMI ログ機能の有効化 +RMIログ機能の有効化 .LP .LP -この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。 +この例は、RMIログ機能を有効にした\f3jstatd\fPの起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。 .LP .nf \f3 @@ -266,20 +266,19 @@ .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://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi \- Javaリモート・オブジェクト・レジストリ .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/jvisualvm.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/jvisualvm.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH jvisualvm 1 "07 May 2011" +.TH jvisualvm 1 "21 Mar 2012" .LP .SH "名前" -\f2jvisualvm\fP \- Java 仮想マシンの監視、トラブルシューティング、およびプロファイリングツール +\f2jvisualvm\fP \- Java仮想マシンの監視、トラブルシューティングおよびプロファイリング・ツール .LP .RS 3 .TP 2 @@ -60,35 +60,35 @@ .SH "パラメータ" .LP .LP -オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、このあとの「オプション」を参照してください。 +オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、次のオプションを参照してください。 .LP -.SH " 説明" +.SH "説明" .LP .LP -Java VisualVM は、指定された Java 仮想マシン (JVM(*)) で Java テクノロジベースのアプリケーション (Java アプリケーション) が実行されているときに、その Java アプリケーションに関する詳細な情報を提供する直感的なグラフィカルユーザーインタフェースです。Java VisualVM という名前は、Java VisualVM が JVM ソフトウェアに関する情報を「視覚的に」提供するという事実に由来しています。 +Java VisualVMは、指定されたJava仮想マシン(JVM(*))でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を\f2視覚的に\fP提供するという事実に由来しています。 .LP .LP -Java VisualVM は、いくつかの監視、トラブルシューティング、およびプロファイリングユーティリティーを 1 つのツールに統合します。たとえば、スタンドアロンツール \f2jmap\fP、 \f2jinfo\fP、 \f2jstat\fP 、および \f2jstack\fP で提供されている機能のほとんどが、Java VisualVM に組み込まれています。JConsole ツールによって提供される一部の機能など、ほかの機能はオプションのプラグインとして追加できます。 +Java VisualVMは、いくつかの監視、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\f2jmap\fP、\f2jinfo\fP、\f2jstat\fPおよび\f2jstack\fPで提供されている機能のほとんどが、Java VisualVMに組み込まれています。JConsoleツールによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 .LP .SH "オプション" .LP .LP -次のオプションは、Java VisualVM を起動したときに実行可能になります。 +次のオプションは、Java VisualVMを起動したときに実行可能になります。 .LP .RS 3 .TP 3 \-J<jvm_option>\ -この \f2<jvm_option>\fP を JVM ソフトウェアに渡します。 +この\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 メニューの「ツール」>「プラグイン」を選択します。 +Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行および監視、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。Java VisualVMの機能を拡張するプラグインもいくつかあります。たとえば、JConsoleツールのほとんどの機能は、「MBeans」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの「ツール」→「プラグイン」を選択します。 .LP .LP -Java VisualVM を起動するには、次のコマンドを実行します。 +Java VisualVMを起動するには、次のコマンドを実行します。 .LP .nf \f3 @@ -102,25 +102,25 @@ .SH "関連項目" .LP .LP -Java VisualVM の詳細は、次のページを参照してください。 +Java VisualVMの詳細は、次のページを参照してください。 .LP .RS 3 .TP 2 o .na -\f2Java VisualVM 開発者のサイト\fP @ +\f2Java VisualVM開発者のサイト\fP @ .fi http://visualvm.java.net .TP 2 o .na -\f2Java SE プラットフォームでの Java VisualVM のドキュメント\fP @ +\f2Java SEプラットフォームでのJava VisualVMのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/visualvm/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/visualvm/index.html .RE .LP .LP -\f2(* 「Java 仮想マシン」と「JVM」という用語は、Java プラットフォームの仮想マシンを意味しています。)\fP +\f2(*「Java仮想マシン」と「JVM」という用語は、Javaプラットフォームの仮想マシンを意味しています。)\fP .LP
--- a/src/solaris/doc/sun/man/man1/ja/keytool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/keytool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -1,4 +1,4 @@ -." Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved. +." Copyright (c) 1998-2011 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,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH keytool 1 "07 May 2011" +.TH keytool 1 "21 Mar 2012" .LP .SH "名前" keytool \- 鍵と証明書の管理ツール .LP .LP -暗号化鍵、X.509 証明書チェーン、および信頼できる証明書を含むキーストア (データベース) を管理します。 +暗号化鍵、X.509証明書チェーンおよび信頼できる証明書を含むキーストア(データベース)を管理します。 .LP .SH "形式" .LP @@ -39,44 +39,44 @@ .LP .LP -Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。 +Java SE 6でkeytoolのコマンド・インタフェースが変更されました。詳細は、変更点の項を参照してください。以前に定義されたコマンドも引続きサポートされています。 .LP .SH "説明" .LP -\f3keytool\fP は、鍵と証明書を管理するためのユーティリティーです。keytool を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザーまたはサービスに対して自分自身を認証すること) や、データの整合性と証明書に関するサービスを利用することができます。keytool では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。 +\f3keytool\fPは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。また、通信相手の公開鍵を(証明書の形で)キャッシュすることもできます。 .LP -「証明書」とは、あるエンティティー (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティーの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「整合性」とは、データが変更されたり、改変されたりしていないことを意味します。 また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。 +「\f2証明書\fP」とは、あるエンティティ(人物、会社など)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティの公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。(証明書を参照。)データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの「\f2整合性\fP」とは、データが変更されたり、改変されたりしていないことを意味します。また、データが「\f2本物である\fP」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。 .LP .LP -また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。 +また、\f3keytool\fPを使用すれば、DESなどの対称暗号化/復号化で使用される秘密鍵を管理することもできます。 .LP .LP -\f3keytool\fP は、鍵と証明書を\f2「キーストア」\fPに格納します。 +\f3keytool\fPは、鍵と証明書を\f2キーストア\fPに格納します。 .LP -.SH "コマンドとオプションに関する注" +.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 @@ -85,7 +85,7 @@ \fP .fi .LP -\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。次に例を示す +\f2\-printcert\fPコマンドを指定するときは、\f2cert_file\fPのかわりに実際のファイル名を指定します。次に例を示します。 .nf \f3 .fl @@ -95,10 +95,10 @@ .fi .TP 2 o -オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある +オプションの値に空白(スペース)が含まれている場合は、値を引用符で囲む必要があります。 .TP 2 o -\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする +\f2\-help\fPコマンドはデフォルトのコマンドです。そのため、コマンドライン .nf \f3 .fl @@ -107,7 +107,7 @@ \fP .fi .LP -これは、次のように指定することと同じです。 +は、次と同じです。 .nf \f3 .fl @@ -133,23 +133,23 @@ .fl \-keyalg .fl - "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合) + "DSA" (when using \fP\f3\-genkeypair\fP\f3) .fl - "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合) + "DES" (when using \fP\f3\-genseckey\fP\f3) .fl .fl \-keysize .fl - 2048 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "RSA" の場合) + 2048 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "RSA") .fl - 1024 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "DSA" の場合) + 1024 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "DSA") .fl - 256 (\fP\f3\-genkeypair\fP\f3 を使用していて \-keyalg が "EC" の場合) + 256 (when using \fP\f3\-genkeypair\fP\f3 and \-keyalg is "EC") .fl - 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合) + 56 (when using \fP\f3\-genseckey\fP\f3 and \-keyalg is "DES") .fl - 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合) + 168 (when using \fP\f3\-genseckey\fP\f3 and \-keyalg is "DESede") .fl .fl @@ -159,19 +159,19 @@ .fl .fl -\-keystore ユーザーのホームディレクトリの \fP\f4.keystore\fP\f3 というファイル +\-keystore the file named \fP\f4.keystore\fP\f3 in the user's home directory .fl .fl -\-storetype セキュリティープロパティーファイルの「keystore.type」プロパティーの値で、 +\-storetype the value of the "keystore.type" property in the security properties file, .fl - java.security.KeyStore の静的な getDefaultType メソッドから返される \fP\f4 \fP\f3 + which is returned by the static \fP\f4getDefaultType\fP\f3 method in .fl - \fP\f4 \fP\f3 + \fP\f4java.security.KeyStore\fP\f3 .fl .fl -\-file 読み込みの場合は標準入力、書き込みの場合は標準出力 +\-file stdin if reading, stdout if writing .fl .fl @@ -182,36 +182,36 @@ .LP .LP -公開/非公開鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。 +公開/秘密鍵ペアの生成において、署名アルゴリズム(\f2\-sigalg\fPオプション)は、基になる秘密鍵のアルゴリズムから派生します。 .LP .RS 3 .TP 2 o -基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションのデフォルト値は SHA1withDSA になり、 +基になる秘密鍵がDSAタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA1withDSAになります。 .TP 2 o -基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withRSA になり、 +基になる秘密鍵がRSAタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA256withRSAになります。 .TP 2 o -基になる非公開鍵が EC タイプである場合は、\f2\-sigalg\fP オプションのデフォルト値は SHA256withECDSA になります。 +基になる秘密鍵がECタイプである場合は、\f2\-sigalg\fPオプションのデフォルト値はSHA256withECDSAになります。 .RE .LP .LP -選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、 +選択可能な\f2\-keyalg\fPおよび\f2\-sigalg\fPの完全な一覧については、 .na -\f2「Java Cryptography Architecture API Specification & Reference」\fP @ +\f2Java Cryptography Architecture API Specification & Reference\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAを参照してください。 .LP .SS 一般オプション .LP .LP -\f2\-v\fP オプションは、 \f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。 +\f2\-v\fPオプションは、\f2\-help\fPコマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な証明書情報が出力されます。 .LP .LP -また、 \f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。 +また、\f2\-J\fP\f2javaoption\fPオプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された\f2javaoption\fP文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\f2java \-h\fPまたは\f2java \-X\fPと入力してください。 .LP .LP 次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。 @@ -226,56 +226,56 @@ .LP キーストアの場所を指定します。 .LP -特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、 \f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、 \f2.keystore\fP という名前のデフォルトキーストアファイルがユーザーのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、 \f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。 +特定の\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 がファイルベースではなく、たとえば、ハードウェアトークンデバイスに置かれている場合に指定します。 +\f2\-keystore\fPオプションからの入力ストリームは、\f2KeyStore.load\fPメソッドに渡されます。URLとして\f2NONE\fPが指定されている場合は、nullのストリームが\f2KeyStore.load\fPメソッドに渡されます。\f2NONE\fPは、\f2KeyStore\fPがファイルベースではなく、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 .TP 3 \-storepass[:env|:file] argument .LP -キーストアの整合性を保護するために使うパスワードを指定します。 +キーストアの整合性を保護するために使用するパスワードを指定します。 .LP -修飾子 \f2env\fP または \f2file\fP を指定しない場合、パスワードの値は \f2argument\fP になります。この値は、6 文字以上にする必要があります。それ以外の場合、パスワードは次のように取得されます。 +修飾子\f2env\fPまたは\f2file\fPを指定しない場合、パスワードの値は\f2argument\fPになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 .RS 3 .TP 2 o -\f2env\fP: \f2argument\fP という名前の環境変数からパスワードを取得する +\f2env\fP: \f2argument\fPという名前の環境変数からパスワードを取得します。 .TP 2 o -\f2file\fP: \f2argument\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) で区切ってください。 +\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 オプションを指定しなかった場合は、パスワードの入力を求められます。 +パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンドラインで\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 のコンストラクタに対する省略可能な文字列入力引数を表します。 +\f2\-providerClass\fPと組み合せて使用します。\f2provider_class_name\fPのコンストラクタに対する省略可能な文字列入力引数を表します。 .TP 3 \-protected .LP -\f2true\fP または \f2false\fP のいずれか。専用 PIN リーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。 +\f2true\fPまたは\f2false\fPのいずれか。専用PINリーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に\f2true\fPを指定してください。 .LP -注: \f2\-importkeystore\fP コマンドには 2 つのキーストアが関係しているため、2 つのオプション、つまり \f2\-srcprotected\fP と \f2\-destprotected\fP がソースキーストアとターゲットキーストアにそれぞれ指定されます。 +注意: \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 を使用できます。 . +X.509証明書エクステンションを示します。このオプションを\-genkeypairおよび\-gencertで使用して、生成される証明書または\f2\-certreq\fPにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは、複数回使用できます。nameには、サポートされているエクステンション名(下記を参照)または任意のOID番号を指定できます。valueを指定した場合は、エクステンションのパラメータを示します。省略した場合は、エクステンションのデフォルト値(定義されている場合)を示すか、またはエクステンションにパラメータは必要ありません。\f2:critical\fP修飾子を指定した場合は、エクステンションのisCritical属性がtrueであることを示します。それ以外の場合はfalseであることを示します。\f2:critical\fPのかわりに\f2:c\fPを使用できます。 .RE .LP .LP -現在、keytool は次の名前のエクステンションをサポートしています (大文字と小文字は区別されない)。 +現在、keytoolは次の名前のエクステンションをサポートしています(大文字と小文字は区別されません)。 .LP .LP .TS @@ -306,7 +306,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -BC または BasicConstraints +BCまたはBasicConstraints .br .di .nr a| \n(dn @@ -322,7 +322,7 @@ .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」の意味になります +完全な形は「ca:{true|false}[,pathlen:<len>]」で、<len>は「ca:true,pathlen:<len>」の省略表記です。 .br .di .nr b| \n(dn @@ -338,7 +338,7 @@ .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 の大文字と小文字は区別されません。 +usage(,usage)*。usageには、digitalSignature、 nonRepudiation (contentCommitment)、keyEncipherment、dataEncipherment、keyAgreement、keyCertSign、cRLSign、encipherOnly、decipherOnlyのいずれかを指定できます。Usageは、あいまいさがなければ、最初の数文字(たとえば、digitalSignatureをdigに)またはキャメルケース・スタイルに(たとえば、 短縮できます。Usageの大文字と小文字は区別されません。 .br .di .nr c| \n(dn @@ -354,7 +354,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -EKU または ExtendedkeyUsage +EKUまたはExtendedkeyUsage .br .di .nr d| \n(dn @@ -370,7 +370,7 @@ .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 の大文字と小文字は区別されません。 +usage(,usage)*。usageには、anyExtendedKeyUsage、 serverAuth、clientAuth、codeSigning、emailProtection、 timeStamping、OCSPSigning、または任意のOID文字列のいずれかを指定できます。 名前付きのusageは、あいまいさがなければ、 最初の数文字またはキャメルケース・スタイルに 短縮できます。Usageの大文字と小文字は区別されません。 .br .di .nr e| \n(dn @@ -386,7 +386,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -SAN または SubjectAlternativeName +SANまたはSubjectAlternativeName .br .di .nr f| \n(dn @@ -402,7 +402,7 @@ .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 の文字列形式の値です。 +type:value(,type:value)*。typeには、EMAIL、URI、DNS、IPまたはOIDを指定できます。valueは、typeの文字列形式の値です。 .br .di .nr g| \n(dn @@ -418,7 +418,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -IAN または IssuerAlternativeName +IANまたはIssuerAlternativeName .br .di .nr h| \n(dn @@ -434,7 +434,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -SubjectAlternativeName と同じです +SubjectAlternativeNameと同じです .br .di .nr i| \n(dn @@ -450,7 +450,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -SIA または SubjectInfoAccess +SIAまたはSubjectInfoAccess .br .di .nr j| \n(dn @@ -466,7 +466,7 @@ .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 を指定できます。 +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 @@ -482,7 +482,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(80 .ll \n(80u .in 0 -AIA または AuthorityInfoAccess +AIAまたはAuthorityInfoAccess .br .di .nr l| \n(dn @@ -498,7 +498,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -SubjectInfoAccess と同じです。method には、「ocsp」、「caIssuers」、または任意の OID を指定できます。 +SubjectInfoAccessと同じです。methodには、「ocsp」、「caIssuers」、または任意のOIDを指定できます。 .br .di .nr m| \n(dn @@ -511,7 +511,7 @@ .nr 80 0 .nr 38 \w\f3名前\fP .if \n(80<\n(38 .nr 80 \n(38 -.nr 38 \wKU または KeyUsage +.nr 38 \wKUまたはKeyUsage .if \n(80<\n(38 .nr 80 \n(38 .80 .rm 80 @@ -604,7 +604,7 @@ .ta \n(80u \n(81u .nr 31 \n(.f .nr 35 1m -\&\h'|\n(40u'KU または KeyUsage\h'|\n(41u' +\&\h'|\n(40u'KUまたはKeyUsage\h'|\n(41u' .mk ## .nr 31 \n(## .sp |\n(##u-1v @@ -762,19 +762,19 @@ .LP .LP -OID 名の場合、OCTET STRING タイプと長さのバイトを除外したエクステンションについては、値は extnValue の HEX ダンプの DER エンコーディングです。HEX 文字列では、標準の HEX 数 (0\-9、a\-f、A\-F) 以外の文字は無視されます。したがって、 \f2「01:02:03:04」\fP と \f2「01020304」の両方とも\fP 同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 +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」とともに使用し、例外を示す) のコンマ区切りリストです。デフォルトでは、要求されるエクステンションは優先されません。 +\f2\-gencert\fPでのみ使用する\f2「honored」\fPという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\f2「all」\fP(リクエストされるすべてのエクステンションが優先される)、\f2「name{:[critical|non\-critical]}」\fP(名前付きのエクステンションが優先されるが、別のisCritical属性を使用する)、および\f2「\-name」\fP(「all」とともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 .LP .LP -\-ext 優先のオプションに加え、別の名前の、または OID \-ext のオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前 (または OID) を優先される値でも使用した場合は、その値と重要性が要求に含まれるものをオーバーライドします。 +\-ext優先のオプションに加え、別の名前の、またはOID \-extのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 .LP .LP -subjectKeyIdentifier エクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifier が常に作成されます。 +subjectKeyIdentifierエクステンションは常に作成されます。自己署名でない証明書の場合は、authorityKeyIdentifierが常に作成されます。 .LP .LP -\f3注:\fP ユーザーは、エクステンション (および証明書のほかのフィールド) の組み合わせによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細については、「証明書の準拠に関する注意事項」を参照してください。 +\f3注意:\fP ユーザーは、エクステンション(および証明書の他のフィールド)の組合せによっては、インターネットの標準に準拠しない場合があることに注意してください。詳細は、証明書の準拠に関する注意事項を参照してください。 .LP .SH "コマンド" .LP @@ -785,17 +785,17 @@ .TP 3 \-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 が作成されます。 +証明書リクエスト・ファイル(\f2keytool \-certreq\fPコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\f2infile\fPから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X.509証明書を\f2outfile\fPに(省略した場合は、標準出力に)出力します。\f2\-rfc\fPを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 .LP -\f2sigalg\fP には、証明書に署名を付けるときに使うアルゴリズムを指定します。\f2startdate\fP は、証明書が有効になる開始時刻/日付です。\f2valDays\fP には、証明書の有効日数を指定します。 +\f2sigalg\fPには、証明書に署名を付けるときに使用するアルゴリズムを指定します。\f2startdate\fPは、証明書が有効になる開始時刻/日付です。\f2valDays\fPには、証明書の有効日数を指定します。 .LP -\f2dname\fP を指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書要求からの名前が使用されます。 +\f2dname\fPを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 .LP -\f2ext\fP は、証明書に埋め込まれる X.509 エクステンションを示します。\-ext の文法については、「一般オプション」を参照してください。 +\f2ext\fPは、証明書に埋め込まれるX.509エクステンションを示します。\f2\-ext\fPの構文については、一般オプションを参照してください。 .LP -\f2\-gencert\fP コマンドを使用すると、証明書チェーンを作成できます。次の例では、 \f2e1\fP という証明書を作成します。この証明書の証明書チェーンには、3 つの証明書が含まれています。 +\f2\-gencert\fPコマンドを使用すると、証明書チェーンを作成できます。次の例では、\f2e1\fPという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 .LP -次のコマンドは、ca、ca1、ca2、および e1 の 4 つの鍵ペアを作成します。 +次のコマンドは、\f2ca\fP、\f2ca1\fP、\f2ca2\fPおよび\f2e1\fPの4つの鍵ペアを作成します。 .nf \f3 .fl @@ -810,7 +810,7 @@ \fP .fi .LP -次の 2 つのコマンドは、署名付き証明書のチェーンを作成します。 \f2ca\fP は ca1 に署名し、 \f2ca1 signs ca2\fP に署名します。すべて自己発行です。 +次の2つのコマンドは、署名付き証明書のチェーンを作成します。\f2ca\fPはca1に署名し、\f2ca1\fPはca2に署名します。すべて自己発行です。 .nf \f3 .fl @@ -821,7 +821,7 @@ \fP .fi .LP -次のコマンドは、証明書 e1 を作成してファイル e1.cert に格納します。この証明書は ca2 によって署名されます。その結果、e1 の証明書チェーンには ca、ca1、および ca2 が含まれることになります。 +次のコマンドは、証明書\f2e1\fPを作成してファイル\f2e1.cert\fPに格納します。この証明書は\f2ca2\fPによって署名されます。その結果、\f2e1\fPの証明書チェーンには\f2ca\fP、\f2ca1\fPおよび\f2ca2\fPが含まれることになります。 .nf \f3 .fl @@ -832,17 +832,17 @@ .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 で特定される新しいキーストアエントリに格納されます。 +鍵のペア(公開鍵および関連する秘密鍵)を生成します。公開鍵はX.509 v3自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと秘密鍵は、\f2alias\fPで特定される新しいキーストア・エントリに格納されます。 .LP -\f2keyalg\fP は鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fP は生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。 +\f2keyalg\fPは鍵のペアの生成に使用するアルゴリズムを、\f2keysize\fPは生成する各鍵のサイズを、それぞれ指定します。\f2sigalg\fPには、自己署名証明書に署名を付けるときに使用するアルゴリズムを指定します。このアルゴリズムは、\f2keyalg\fPと互換している必要があります。 .LP -\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の issuer フィールドと subject フィールドとして使う X.500 識別名を指定します。 コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。 +\f2dname\fPには、\f2alias\fPに関連付け、自己署名証明書の\f2issuer\fPフィールドと\f2subject\fPフィールドとして使用するX.500 識別名を指定します。コマンドラインで識別名を指定しなかった場合は、識別名の入力を求められます。 .LP -\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。 +\f2keypass\fPには、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fPは、6文字以上にする必要があります。 .LP -\f2startdate\fP には、証明書の発行時刻を指定します。これは、X.509 証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 +\f2startdate\fPには、証明書の発行時刻を指定します。これは、X.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 .LP -オプションの値は、次の 2 つの形式のいずれかで設定できます。 +オプションの値は、次の2つの形式のいずれかで設定できます。 .RS 3 .TP 3 1. @@ -852,7 +852,7 @@ [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と指定すると、開始時刻は次のようになります。 +最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\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 @@ -869,86 +869,85 @@ \fP .fi .LP -2 番目の形式では、ユーザーは、年/月/日と時間:分:秒の 2 つの部分で厳密な開始時刻を設定します (地元の時間帯を使用)。ユーザーは、1 つの部分だけを指定できます。これは、もう 1 つの部分は現在の日付 (または時刻) と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります (短い場合は 0 で埋める)。日付と時刻の両方が指定された状態で、2 つの部分の間に空白文字が 1 つ (1 つだけ) あります。時間は常に 24 時間形式で指定してください。 +2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分で厳密な開始時刻を設定します(地元の時間帯を使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 .LP -オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で 1 回指定できます。 +オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で1回指定できます。 .LP -\f2valDays\fP には、証明書の有効日数を指定します ( \f2\-startdate\fP で指定された日付、または \f2\-startdate\fP が指定されていない場合は現在の日付から始まる)。 +\f2valDays\fPには、証明書の有効日数を指定します(\f2\-startdate\fPで指定された日付、または\f2\-startdate\fPが指定されていない場合は現在の日付から始まります)。 .LP -このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\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} +\-genseckey {\-aliasalias} {\-keyalgkeyalg} {\-keysizekeysize} [\-keypasskeypass] {\-storetypestoretype} {\-keystorekeystore} [\-storepassstorepass] {\-providerClassprovider_class_name {\-providerArgprovider_arg}} {\-v} {\-protected} {\-Jjavaoption} .LP -秘密鍵を生成し、それを新しい \f2KeyStore.SecretKeyEntry\fP (\f2alias\fP で特定される) 内に格納します。 +秘密鍵を生成し、それを新しい\f2KeyStore.SecretKeyEntry\fP(\f2alias\fPで特定される)内に格納します。 .LP -\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上にする必要があります。 +\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 によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または証明書チェーンを読み込みます。 +ファイル\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」で始まる文字列で終了しなければなりません。 +\f3keytool\fPでは、X.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了する必要があります。 .LP -証明書のインポートには、次の 2 つの目的があります。 +証明書のインポートには、次の2つの目的があります。 .RS 3 .TP 3 1. -信頼できる証明書のリストに証明書を追加する +信頼できる証明書のリストに証明書を追加します。 .TP 3 2. -CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする +CAに証明書署名リクエスト(\-certreqコマンドを参照)を送信した結果として、CAから受け取った証明応答をインポートします。 .RE .LP -どちらの種類のインポートを行うかは、 \f2\-alias\fP オプションの値によって指定します。 +どちらのタイプのインポートを行うかは、\f2\-alias\fPオプションの値によって指定します。 .RS 3 .TP 3 1. -\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内にすでに存在していてはいけません。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。 +\f3別名がキー・エントリをポイントしない場合\fP、\f3keytool\fPはユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fPはエラーを出力し、証明書のインポートを行いません。 .TP 3 2. -.LP -\f3別名がキーエントリをポイントしない場合\fP、\f3keytool\fP はユーザーが信頼できる証明書エントリを追加しようとしているものと見なします。 +\f3別名がキー・エントリをポイントする場合\fP、\f3keytool\fPはユーザーが証明書応答をインポートしようとしているものと見なします。 .RE \f3新しい信頼できる証明書のインポート\fP .LP -\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 +\f3keytool\fPは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 .LP -\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できるすなわち cacerts という名前のファイルに含まれる証明書のチェーンと見なされます。 +\f2\-trustcacerts\fPオプションを指定した場合、追加の証明書は信頼できるすなわちcacertsという名前のファイルに含まれる証明書のチェーンと見なされます。 .LP -\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかのなんらかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。 -\f3証明応答のインポート\fP +\f3keytool\fPが、インポートする証明書から自己署名証明書(キーストアまたはcacertsファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者本人など)から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、信頼できる証明書のインポートに関する注意事項を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fPオプションが指定されている場合、ユーザーとの対話は行われません。 +\f3証明書応答のインポート\fP .LP -「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\-trustcacerts オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。 +「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および(\f2\-trustcacerts\fPオプションが指定されている場合は)cacertsキーストア・ファイルで構成された証明書を使用して証明応答が検査されます。 .LP -証明応答が信頼できるかどうかを決定する方法は次のとおりです。 +証明書応答が信頼できるかどうかを決定する方法は次のとおりです。 .RS 3 .TP 2 o -\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。 +\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 オプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 +\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、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。 +証明書応答内の公開鍵が\f2alias\fPの下にすでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを新しい証明書チェーンで置き換えることができるのは、有効な\f2keypass\fP、つまり該当するエントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 .LP -このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。 +このコマンドは、以前のリリースでは\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 が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。 +\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 が指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。 +\f2srcalias\fPオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\f2srcstorepass\fPを使用してそのエントリが回復されます。\f2srcstorepass\fPが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 .LP -ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 +ターゲット別名がターゲット・キーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 .LP -\f2\-noprompt\fP を指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。 +\f2\-noprompt\fPを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。 .TP 3 \-printcertreq {\-file file} .LP -PKCS #10 形式の証明書要求の内容を出力します。この要求は、keytool \-certreq コマンドで生成できます。このコマンドは、file から要求を読み込みます。file が省略されている場合は、標準入力から読み込みます。 +PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、keytool \-certreqコマンドで生成できます。このコマンドは、fileからリクエストを読み込みます。fileが省略されている場合は、標準入力から読み込みます。 .RE .LP @@ -959,29 +958,29 @@ .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) を生成します。 +PKCS#10形式を使用して証明書署名リクエスト(CSR)を生成します。 .LP -CSR は、証明書発行局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明書チェーンを送り返します。 この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。 +CSRは、証明書発行局(CA)に送信することを目的としたものです。CAは、証明書要求者を(通常はオフラインで)認証し、証明書または証明書チェーンを送り返します。この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン(最初は1つの自己署名証明書から構成される)に置き換えて使用します。 .LP -\f2alias\fP に関連付けられた非公開鍵は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。dname が指定されている場合は、それが CSR で主体として使用されます。それ以外の場合は、別名に関連付けられた X.500 識別名が使用されます。 +\f2alias\fPに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵はキーストア内ではパスワードによって保護されているので、秘密鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンドラインで\f2keypass\fPを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。dnameが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX.500識別名が使用されます。 .LP -\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。 +\f2sigalg\fPには、CSRに署名を付けるときに使用するアルゴリズムを指定します。 .LP -CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。 +CSRは、ファイル\f2certreq_file\fPに格納されます。ファイルが指定されていない場合は、標準出力にCSRが出力されます。 .LP -CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。 +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 -デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\-rfc オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。 +デフォルトでは、バイナリ符号化方式の証明書が出力されます。ただし、\f2\-rfc\fPオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。出力可能符号化方式は、インターネット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 @@ -992,35 +991,35 @@ .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 -このコマンドは、デフォルトでは証明書の SHA1 フィンガープリントを表示します。 \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 | \-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 オプションを同時に指定することはできません。同時に指定すると、エラーが報告されます。オプションが指定されていない場合は、標準入力から証明書を読み込みます。 +ファイル\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 モードで証明書を出力します。 +\f2\-rfc\fPが指定されている場合、keytoolは、インターネットRFC 1421標準で定義されているように、PEMモードで証明書を出力します。 .LP -ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネット RFC 1421 標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 +ファイルまたは標準入力から証明書を読み込む場合、その証明書は、インターネットRFC 1421標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 .LP -SSL サーバーがファイアウォールの背後にある場合は、 \f2\-J\-Dhttps.proxyHost=proxyhost\fP と \f2\-J\-Dhttps.proxyPort=proxyport\fP をコマンド行で指定して、プロキシトンネリングを使用できます。詳細は、 +SSLサーバーがファイアウォールの背後にある場合は、\f2\-J\-Dhttps.proxyHost=proxyhost\fPと\f2\-J\-Dhttps.proxyPort=proxyport\fPをコマンドラインで指定して、プロキシ・トンネリングを使用できます。詳細は、 .na -\f2「JSSE リファレンスガイド」\fP @ +\f2JSSEリファレンス・ガイド\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/jsse/JSSERefGuide.htmlを参照してください。 .LP -\f3注\fP: このオプションはキーストアとは関係なく使用できます。 +\f3注意\fP: このオプションはキーストアとは関係なく使用できます。 .TP 3 \-printcrl \-file crl_ {\-v} .LP -ファイル \f2crl_file\fP から証明書の取り消しリスト (CRL) を読み込みます。 +ファイル\f2crl_file\fPから証明書の取消しリスト(CRL)を読み込みます。 .LP -証明書の取り消しリスト (CRL) は、デジタル証明書を発行した証明書発行局 (CA) によって取り消されたデジタル証明書のリストです。CA は、\f2crl_file\fP を生成します。 +証明書の取消しリスト(CRL)は、デジタル証明書を発行した証明書発行局(CA)によって取り消されたデジタル証明書のリストです。CAは、\f2crl_file\fPを生成します。 .LP -\f3注\fP: このオプションはキーストアとは関係なく使用できます。 +\f3注意\fP: このオプションはキーストアとは関係なく使用できます。 .RE .LP @@ -1031,23 +1030,23 @@ .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 には、新しいパスワードを指定します。new_storepass は、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 に変更します。new_keypass は、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 @@ -1060,7 +1059,7 @@ .LP 基本的なコマンドとそのオプションの一覧を表示します。 .LP -特定のコマンドの詳細については、次のように入力してください。 \f2command_name\fP はコマンドの名前です。 +特定のコマンドの詳細を参照するには、次のように入力してください。\f2command_name\fPはコマンドの名前です。 .nf \f3 .fl @@ -1074,7 +1073,7 @@ .SH "例" .LP .LP -ここでは、自分の鍵のペアおよび信頼できるエンティティーからの証明書を管理するためのキーストアを作成する場合を例として示します。 +ここでは、自分の鍵のペアおよび信頼できるエンティティからの証明書を管理するためのキーストアを作成する場合を例として示します。 .LP .SS 鍵のペアの生成 @@ -1087,25 +1086,25 @@ .fl keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US" .fl - \-alias business \-keypass \fP\f4<非公開鍵の新しいパスワード>\fP\f3 \-keystore /working/mykeystore + \-alias business \-keypass \fP\f4<new password for private key>\fP\f3 \-keystore /working/mykeystore .fl - \-storepass \fP\f4<キーストアの新しいパスワード>\fP\f3 \-validity 180 + \-storepass \fP\f4<new password for keystore>\fP\f3 \-validity 180 .fl \fP .fi .LP .LP -注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。 +注意: このコマンドは1行に入力する必要があります。例で複数行に入力しているのは読みやすくするためです。 .LP .LP -この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアに、\f2<キーストアの新しいパスワード>\fP で指定したパスワード を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。 +この例では、workingディレクトリにmykeystoreという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\f2<new password for keystore>\fPで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2文字の国番号が「US」です。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 .LP .LP -このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵には、\f2<非公開鍵の新しいパスワード>\fP で指定したパスワードが割り当てられます。 +このコマンドは、公開鍵と識別名情報を含む自己署名証明書(デフォルトのSHA1withDSA署名アルゴリズムを使用)を作成します。証明書の有効期間は180日です。証明書は、別名「business」で特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\f2<new password for private key>\fPで指定したパスワードが割り当てられます。 .LP .LP -オプションのデフォルト値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。 デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。 +オプションのデフォルト値を使用する場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを1つも指定せずにコマンドを実行することも可能です。デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使用され、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。 .LP .nf \f3 @@ -1117,16 +1116,16 @@ .LP .LP -この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。 +この場合は、mykeyという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の .keystoreという名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードについては、入力を求められます。 .LP .LP -以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、識別名には cn=Mark Jones, ou=Java, o=Oracle, c=US と指定)。 +以降では、オプションを指定しないで\f2\-genkeypair\fPコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\f2\-genkeypair\fPコマンドの値を入力したものとします(たとえば、識別名にはcn=Mark Jones,ou=Java,o=Oracle,c=USと指定)。 .LP .SS -証明書発行局に対する署名付き証明書の要求 +証明書発行局に対する署名付き証明書のリクエスト .LP .LP -現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に証明書発行局 (CA) の署名が付いていれば、ほかのユーザーから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。 +現時点で手元にあるのは、1通の自己署名証明書のみです。証明書に証明書発行局(CA)の署名が付いていれば、他のユーザーから証明書が信頼される可能性も高くなります。このような署名を取得するには、まず、証明書署名リクエスト(CSR)を生成します。たとえば、次のようにします。 .LP .nf \f3 @@ -1138,38 +1137,38 @@ .LP .LP -CSR (デフォルト別名「mykey」によって特定されるエンティティーの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 +CSR(デフォルト別名「mykey」によって特定されるエンティティのCSR)が作成され、MarkJ.csrという名前のファイルに置かれます。このファイルは、VeriSignなどのCAに提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 .LP .SS -CA からの証明書のインポート +CAからの証明書のインポート .LP .LP -作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CA を起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 +作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CAを起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 .LP .LP -CA からの証明応答をインポートするには、キーストアか、 \f2cacerts\fP キーストアファイル (importcert コマンドで説明) 内に 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 キーストアファイルは、いくつかの 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 コマンドを使用するか、または \-noprompt オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 +「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。まず、証明書の内容を表示し(\f3keytool\fP \f2\-printcert\fPコマンドを使用するか、または\f2\-noprompt\fPオプションを指定しないで\f3keytool\fP \f2\-importcert\fPコマンドを使用し、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(または安全な公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 .LP .LP -ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。 +この証明書を有効なものとして信頼する場合は、証明書をキーストアに追加できます。たとえば、次のようにします。 .LP .nf \f3 @@ -1181,16 +1180,16 @@ .LP .LP -ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。 +ABCCA.cerファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリにabcという別名が割り当てられます。 .LP .SS -CA からの証明応答のインポート +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 @@ -1205,10 +1204,10 @@ 公開鍵を認証する証明書のエクスポート .LP .LP -たとえば、jarsigner(1) ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。 +たとえば、jarsigner(1)ツールを使用してJava ARchive(JAR)ファイルに署名を付けたとします。このファイルはクライアントによって使用されますが、クライアント側では署名を認証したいと考えています。 .LP .LP -クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。このエントリには「mykey」という別名が使われているとします。 +クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を\f2MJ.cer\fPという名前のファイルにコピーします。このエントリには「mykey」という別名が使用されているとします。 .LP .nf \f3 @@ -1220,16 +1219,16 @@ .LP .LP -証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。 +証明書と署名付きJARファイルを入手したクライアントは、\f3jarsigner\fPツールを使用して署名を認証できます。 .LP .SS キーストアのインポート .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 @@ -1240,14 +1239,14 @@ .fl \-srcstoretype JKS \-deststoretype PKCS11 .fl - \-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3 + \-srcstorepass \fP\f4<source keystore password>\fP\f3 \-deststorepass \fP\f4<destination keystore password>\fP\f3 .fl \fP .fi .LP .LP -また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 +また、importkeystoreコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcaliasオプションを指定する場合には、ターゲット別名もコマンドラインから指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 .LP .nf \f3 @@ -1258,11 +1257,11 @@ .fl \-srcstoretype JKS \-deststoretype PKCS11 .fl - \-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3 + \-srcstorepass \fP\f4<source keystore password>\fP\f3 \-deststorepass \fP\f4<destination keystore password>\fP\f3 .fl \-srcalias myprivatekey \-destalias myoldprivatekey .fl - \-srckeypass \fP\f4<ソースエントリのパスワード>\fP\f3 \-destkeypass \fP\f4<ターゲットエントリのパスワード>\fP\f3 + \-srckeypass \fP\f4<source entry password>\fP\f3 \-destkeypass \fP\f4<destination entry password>\fP\f3 .fl \-noprompt .fl @@ -1271,10 +1270,10 @@ .LP .SS -一般的な SSL サーバー用の証明書の生成 +一般的なSSLサーバー用の証明書の生成 .LP .LP -次に、3 つのエンティティー、つまりルート CA (root)、中間 CA (ca)、および SSL サーバー (server) 用の鍵ペアと証明書を生成する keytool コマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとして RSA を指定することをお勧めします。 +次に、3つのエンティティ、つまりルートCA(root)、中間CA(ca)およびSSLサーバー(server)用の鍵ペアと証明書を生成するkeytoolコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、鍵のアルゴリズムとしてRSAを指定することをお薦めします。 .LP .nf \f3 @@ -1308,7 +1307,7 @@ .SH "用語と警告" .LP .SS -KeyStore +キーストア .LP .LP キーストアは、暗号化の鍵と証明書を格納するための機能です。 @@ -1318,24 +1317,24 @@ o \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」(所有者) によって特定されるアイデンティティーに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 +\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を1つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。それは、証明書内の公開鍵が、証明書の「Subject」(所有者)によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 .RE .TP 2 o \f3キーストアの別名\fP .LP -キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。 +キーストアのすべてのエントリ(鍵および信頼できる証明書)は、一意の\f2別名\fPを介してアクセスされます。 .LP -別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明書チェーンを信頼できる証明書のリストに追加したりするなど、特定のエンティティーをキーストアに追加する場合です。これ以後、\f3keytool\fP コマンドでエンティティーを参照する場合は、このときに指定した別名を使用する必要があります。 +別名を指定するのは、\-genseckeyコマンドを使用して秘密鍵を生成したり、\-genkeypairコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\-importcertコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\f3keytool\fPコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 .LP -たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明書チェーン」を参照) でラップするとします。 この場合は、次のコマンドを実行します。 +たとえば、\f2duke\fPという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書(証明書チェーンを参照)でラップするとします。この場合は、次のコマンドを実行します。 .nf \f3 .fl @@ -1344,7 +1343,7 @@ \fP .fi .LP -ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 duke 連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。 duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。 +ここでは、初期パスワードとしてdukekeypasswdを指定しています。以後、別名\f2duke\fPに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 .nf \f3 .fl @@ -1353,36 +1352,36 @@ \fP .fi .LP -パスワードが、dukekeypasswd から newpass に変更されます。 +パスワードが、dukekeypasswdからnewpassに変更されます。 .LP -注: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 +注意: テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 .TP 2 o \f3キーストアの実装\fP .LP -\f2KeyStore\fP クラス ( \f2java.security\fP パッケージで提供される) には、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。 +\f2java.security\fPパッケージで提供されている\f2KeyStore\fPクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定の\f2タイプ\fPのキーストアを対象とする複数の異なる実装が存在可能です。 .LP -現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。 \f2KeyStore\fP は public として使用可能なので、JDK ユーザーは KeyStore を使ったほかのセキュリティーアプリケーションも作成できます。 +現在、\f3keytool\fPと\f3jarsigner\fPの2つのコマンドライン・ツールと、\f3Policy Tool\fPという名前のGUIベースのツールが、キーストアの実装を使用しています。\f2KeyStore\fPはpublicとして使用可能なので、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 .LP -キーストアには、Oracle が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の整合性も (非公開鍵とは別の) パスワードによって保護されます。 +キーストアには、Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .LP -キーストアの実装は、プロバイダベースです。具体的には、 \f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが、「プロバイダ」が実装する必要のある Service Provider Interface のメソッドを定義しています。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、 +キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fPによって提供されるアプリケーション・インタフェースが「サービス・プロバイダ・インタフェース」(SPI)に基づいて実装されます。つまり、対応する\f2KeystoreSpi\fP抽象クラス(これも\f2java.security\fPパッケージに含まれています)があり、このクラスが、「プロバイダ」が実装する必要のあるService Provider Interfaceのメソッドを定義しています。(ここで、「プロバイダ」とは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。)したがって、キーストアの実装を提供するには、 .na -\f2「Java(TM) 暗号化アーキテクチャー用プロバイダの実装方法」\fP @ +\f2Java暗号化アーキテクチャ用プロバイダの実装方法\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。 +http://download.oracle.com/javase/7/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlで説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpiサブクラスの実装を提供する必要があります。 .LP -アプリケーションでは、KeyStore クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。 キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\f2KeyStore\fPクラスが提供するgetInstanceファクトリ・メソッドを使用することで、様々なプロバイダから異なる\f2タイプ\fPのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .LP -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。keytool は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP ツールと \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。 +\f3keytool\fPは、任意のファイルベースのキーストア実装で動作します。(これは、コマンドラインから渡されたキーストアの場所をファイル名として扱い、これをFileInputStreamに変換して、FileInputStreamからキーストアの情報をロードします。)一方、\f3jarsigner\fPツールと\f3policytool\fPツールは、URLで指定可能な任意の場所からキーストアを読み込むことができます。 .LP -\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fPの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 +\f3keytool\fPと\f3jarsigner\fPの場合、\f2\-storetype\fPオプションを使用してコマンドラインでキーストアのタイプを指定できます。\f3Policy Tool\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 の最上位ディレクトリ) です。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合は、単純にセキュリティ・プロパティ・ファイルで指定された\f2keystore.type\fPプロパティの値に基づいて、キーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\f2java.security\fPと呼ばれ、セキュリティ・プロパティ・ディレクトリ\f2java.home\fP/lib/security内に存在しています。ここで、\f2java.home\fPは実行時環境のディレクトリ(SDKの\f2jre\fPディレクトリまたはJava 2 Runtime Environmentのトップレベル・ディレクトリ)です。 .LP -各ツールは、 \f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。 +各ツールは、\f2keystore.type\fPの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .LP -\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティーの値を取得できます。次のコードは、デフォルトのキーストアタイプ ( \f2keystore.type\fP プロパティーで指定されたタイプ) のインスタンスを生成します。 +\f2KeyStore\fPクラスに定義されているstaticメソッド\f2getDefaultType\fPを使用すると、アプリケーションやアプレットから\f2keystore.type\fPプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\f2keystore.type\fPプロパティで指定されたタイプ)のインスタンスを生成します。 .nf \f3 .fl @@ -1391,7 +1390,7 @@ \fP .fi .LP -デフォルトのキーストアタイプは JKS (Oracle が提供する独自のタイプのキーストアの実装) です。これは、セキュリティープロパティーファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプはJKS(Oracleが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .nf \f3 .fl @@ -1402,7 +1401,7 @@ .LP 各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。 .LP -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。 +たとえば、pkcs12と呼ばれるタイプのキーストアの実装を提供しているプロバイダ・パッケージを使用するには、上の行を次のように変更します。 .nf \f3 .fl @@ -1411,14 +1410,14 @@ \fP .fi .LP -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。 +注意: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKSとjksは同じものとして扱われます。 .RE .LP .SS 証明書 .LP -\f3証明書\fP (\f3公開鍵証明書\fPとも呼ぶ) とは、あるエンティティー (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティー (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。 +\f3証明書\fP(\f3公開鍵証明書\fPとも呼ばれます)とは、あるエンティティ(\f2発行者\fP)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティ(\f2署名者\fP)の公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。 .RS 3 .TP 2 o @@ -1427,30 +1426,30 @@ .TP 3 公開鍵 .LP -公開鍵は、特定のエンティティーに関連付けられた数です。公開鍵は、該当するエンティティーとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。 +公開鍵は、特定のエンティティに関連付けられた数です。公開鍵は、該当するエンティティとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使用されます。 .TP 3 デジタル署名 .LP -データが「デジタル署名」されると、そのデータは、エンティティーの「アイデンティティー」と、そのエンティティーがデータの内容について知っていることを証明する署名とともに格納されます。エンティティーの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。 +データが「\f2デジタル署名\fP」されると、そのデータは、エンティティの「アイデンティティ」と、そのエンティティがデータの内容について知っていることを証明書する署名とともに格納されます。エンティティの秘密鍵を使用してデータに署名を付けると、データの偽造は不可能になります。 .TP 3 -アイデンティティー +アイデンティティ .LP -エンティティーを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティーにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティーとすることができます。 +エンティティを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティにするものがあります。公開鍵の他にも、Unix UIDや電子メール・アドレス、X.509識別名など、様々なものをアイデンティティとすることができます。 .TP 3 署名 .LP -署名は、なんらかのデータを基にエンティティー (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。 +署名は、なんらかのデータを基にエンティティ(\f2署名者\fP。証明書に関しては\f2発行者\fPとも呼ばれます)の秘密鍵を使用して計算されます。 .TP 3 -非公開鍵 +秘密鍵 .LP -非公開鍵は特定のエンティティーだけが知っている数のことで、この数のことを、そのエンティティーの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。 +秘密鍵は特定のエンティティのみが知っている数のことで、この数のことを、そのエンティティの秘密鍵といいます。秘密鍵は、他に知られないように秘密にしておくことが前提になっています。秘密鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSAなどの典型的な公開鍵暗号化システムの場合、1つの秘密鍵は正確に1つの公開鍵に対応します。秘密鍵は、署名を計算するのに使用されます。 .TP 3 -エンティティー +エンティティ .LP -エンテンティーは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。 +エンティティは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となる様々なものを指します。 .RE .LP -公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティー間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「証明書発行局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティーの証明書に署名する (発行する) 行為を、信頼して任されているエンティティー (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。 +公開鍵暗号化では、その性質上、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引続き確立されていると仮定したり、使用されているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、\f2証明書発行局\fP(CA)が信頼できる第三者として機能します。CAは、他のエンティティの証明書に署名する(発行する)行為を、信頼して任されているエンティティ(企業など)です。CAは法律上の契約に拘束されるので、有効かつ信頼できる証明書のみを作成するものとして扱われます。 .na \f2VeriSign\fP @ .fi @@ -1462,49 +1461,49 @@ .na \f2Entrust\fP @ .fi -http://www.entrust.com/ をはじめ、多くの CA が存在します。Microsoft の認証サーバー、Entrust の CA 製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。 +http://www.entrust.com/をはじめ、多くの公的な証明書発行局が存在します。Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。 .LP -\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 +\f3keytool\fPを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 .LP -現在、\f3keytool\fP は X.509 証明書を対象にしています。 +現在、\f3keytool\fPはX.509証明書を対象にしています。 .TP 2 o -\f3X.509 証明書\fP +\f3X.509証明書\fP .LP -X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。 +X.509規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法(データ形式)についても記述されています。証明書のすべてのデータは、ASN.1/DERと呼ばれる2つの関連規格を使用して符号化されます。\f2Abstract Syntax Notation 1\fPはデータについて記述しています。\f2Definite Encoding Rules\fPは、データの保存および転送の方法について記述しています。 .LP -すべての X.509 証明書は、署名のほかに次のデータを含んでいます。 +すべてのX.509証明書は、署名の他に次のデータを含んでいます。 .RS 3 .TP 3 バージョン .LP -証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。keytool が生成するのは、v3 の証明書です。 +証明書に適用されるX.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3つのバージョンが定義されています。\f3keytool\fPでは、v1、v2およびv3の証明書のインポートとエクスポートが可能です。v3の証明書を生成します。 .LP -「X.509 Version 1」は、1988 年から利用されて広く普及しており、もっとも一般的です。 +\f2X.509 Version 1\fPは、1988年から利用されて広く普及しており、最も一般的です。 .LP -「X.509 Version 2」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。 +\f2X.509 Version 2\fPでは、Subjectや発行者の名前をあとで再利用できるようにするために、Subjectと発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意の識別子を使用しないことが、強く推奨されています。Version 2の証明書は、広くは使用されていません。 .LP -「X.509 Version 3」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、KeyUsage (「署名専用」など、鍵の使用を特定の目的に制限する)、AlternativeNames (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティーを公開鍵に関連付けることができる) などがあります。エクステンションには、critical というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。 +\f2X.509 Version 3\fPは最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使用されている一般的なエクステンションとしては、\f2KeyUsage\fP(「署名専用」など、鍵の使用を特定の目的に制限する)、\f2AlternativeNames\fP(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、\f2critical\fPというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、KeyCertSignが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 .TP 3 シリアル番号 .LP -証明書を作成したエンティティーは、そのエンティティーが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。 +証明書を作成したエンティティは、そのエンティティが発行する他の証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、様々な方法で使用されます。たとえば、証明書が取り消されると、シリアル番号が証明書の取消しリスト(CRL)に格納されます。 .TP 3 署名アルゴリズム識別子 .LP -証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。 +証明書に署名を付けるときにCAが使用したアルゴリズムを特定します。 .TP 3 発行者名 .LP -証明書に署名を付けたエンティティーの X.500 識別名です。エンティティーは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティーを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。 +証明書に署名を付けたエンティティのX.500識別名です。エンティティは、通常はCAです。この証明書を使用することは、証明書に署名を付けたエンティティを信頼することを意味します。\f2ルートつまりトップレベル\fPのCAの証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。 .TP 3 有効期間 .LP -各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティーが公開鍵を信頼できると期待される期間です。 +各証明書は、限られた期間のみ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から100年という長期にわたることもあります。選択される有効期間は、証明書への署名に使用される秘密鍵の強度や証明書に支払う金額など、様々な要因で異なります。有効期間は、関連する秘密鍵が損なわれない場合に、エンティティが公開鍵を信頼できると期待される期間です。 .TP 3 -Subject 名 +Subject名 .LP -証明書で公開鍵が識別されているエンティティーの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティーの X.500 識別名 (DN) です。次に例を示します。 +証明書で公開鍵が識別されているエンティティの名前です。この名前はX.500標準を使用するので、インターネット全体で一意なものと想定されます。これは、エンティティのX.500識別名(DN)です。次に例を示します。 .nf \f3 .fl @@ -1515,34 +1514,34 @@ .LP これらはそれぞれ主体の通称、組織単位、組織、国を表します。 .TP 3 -Subject の公開鍵情報 +Subjectの公開鍵情報 .LP -名前を付けられたエンティティーの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。 +名前を付けられたエンティティの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使用されている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。 .RE .TP 2 o \f3証明書チェーン\fP .LP -\f3keytool\fP では、非公開鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 +\f3keytool\fPでは、秘密鍵および関連する証明書「チェーン」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 .LP -鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含むチェーンが開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。 \f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 +鍵を初めて作成すると(\-genkeypairコマンドを参照)、「\f2自己署名証明書\fP」という1つの要素のみを含むチェーンが開始されます。自己署名証明書は、発行者(署名者)が主体(証明書で認証されている公開鍵の持ち主)と同じである証明書のことです。\f2\-genkeypair\fPコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 .LP -このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が証明書発行局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。チェーン内のその前の証明書は、「CA」の公開鍵を認証する証明書です。 +この後、証明書署名リクエスト(CSR)が生成されて(\-certreqコマンドを参照)、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスがインポートされ(\-importcertコマンドを参照)、元の自己署名証明書は証明書チェーンによって置き換えられます。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、\f2CA\fPの公開鍵を認証する証明書です。 .LP -CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これはチェーンの最初の証明書になります。場合によっては、CA が証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、チェーン内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次の CA の鍵を認証する証明書になります。 以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の (最初の証明書以後の) 各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 +CAの公開鍵を認証する証明書は、多くの場合、自己署名証明書(つまりCAが自身の公開鍵を認証した証明書)であり、これはチェーンの最初の証明書になります。場合によっては、CAが証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書(CAによって署名され、鍵エントリの公開鍵を認証する証明書)に変わりはありませんが、チェーン内のその前の証明書は、CSRの送信先のCAとは\f2別の\fPCAによって署名され、CSRの送信先のCAの公開鍵を認証する証明書になります。さらに、チェーン内のその前の証明書は、次のCAの鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の(最初の証明書以後の)各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 .LP -多くの CA は、チェーンをサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 +多くのCAは、チェーンをサポートせずに発行済みの証明書のみを返します。特に、中間のCAが存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 .LP -別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。 +別の応答形式(PKCS#7で定義されている形式)でも、発行済み証明書に加え、証明書チェーンのサポートが含まれています。\f3keytool\fPでは、どちらの応答形式も扱うことができます。 .LP -トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し ( \f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。 +トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく(たとえば、VeriSignルートCAのような有名な識別名を使用した自己署名証明書を作成すること自体は誰でも可能)、新聞などの他の情報源に由来するものです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、その前に証明書の内容を表示し(\f2\-printcert\fPオプションを使用)、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 .TP 2 o -\f3cacerts 証明書ファイル\fP +\f3cacerts証明書ファイル\fP .LP -\f3cacerts\fP という名前の証明書ファイルは、セキュリティープロパティーディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。 +\f3cacerts\fPという名前の証明書ファイルは、セキュリティ・プロパティ・ディレクトリ\f2java.home\fP/lib/securityに置かれています。\f2java.home\fPは、実行環境のディレクトリ(SDKの\f2jre\fPディレクトリまたはJava 2 Runtime Environmentの最上位ディレクトリ)です。 .LP -cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、ルート CA 証明書のデフォルトセットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。 +cacertsファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプにjksを指定することで、\f3keytool\fPを使用してこのファイルの構成と管理を行うことができます。cacertsキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。それらの証明書を一覧表示するには、次のコマンドを使用します。 .nf \f3 .fl @@ -1551,20 +1550,20 @@ \fP .fi .LP -cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。 +cacertsキーストア・ファイルの初期パスワードは、changeitです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 .LP -\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 のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。 +\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 +\f3インターネットRFC 1421証明書符号化規格\fP .LP -多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。 +多くの場合、証明書は、バイナリ符号化ではなく、インターネットRFC 1421規格で定義されている出力可能符号化方式を使用して格納されます。「Base 64符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、他のアプリケーションに証明書を容易にエクスポートできます。 .LP -\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。 +\f2\-importcert\fPと\f2\-printcert\fPコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。 .LP -\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。 ただし、 \f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 +\f2\-exportcert\fPコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\f2\-rfc\fPオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 .LP -\f2\-list\fP コマンドでは、デフォルトで証明書の SHA1 フィンガープリントが出力されます。 \f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、 \f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。 +\f2\-list\fPコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\f2\-v\fPオプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、\f2\-rfc\fPオプションを指定すると、出力可能符号化方式で証明書が出力されます。 .LP 出力可能符号化方式で符号化された証明書は、次の行で始まります。 .nf @@ -1587,35 +1586,35 @@ .LP .SS -X.500 識別名 +X.500識別名 .LP .LP -X.500 識別名は、エンティティーを特定するために使われます。たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。 +X.500識別名は、エンティティを特定するために使用されます。たとえば、X.509証明書の\f2subject\fPフィールドと\f2issuer\fP(署名者)フィールドで指定される名前は、X.500識別名です。\f3keytool\fPは、次のサブパートをサポートしています。 .LP .RS 3 .TP 2 o -\f2commonName\fP \- 人の通称。 「Susan Jones」など +\f2commonName\fP \- 人の通称。「Susan Jones」など .TP 2 o -\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。 「仕入部」など +\f2organizationUnit\fP \- 小さな組織(部、課など)の名称。「Purchasing」など .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 -\-genkeypair コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、 次の形式で指定する必要があります。 +識別名文字列を\f2\-dname\fPオプションの値として指定する場合は(\f2\-genkeypair\fP コマンド)、次の形式で指定する必要があります。 .LP .nf \f3 @@ -1627,7 +1626,7 @@ .LP .LP -イタリック体の項目は、実際に指定する値を表します。 短縮形のキーワードの意味は、次のとおりです。 +イタリック体の項目は、実際に指定する値を表します。短縮形のキーワードの意味は、次のとおりです。 .LP .nf \f3 @@ -1661,7 +1660,7 @@ .LP .LP -次は、この文字列を使ったコマンドの例です。 +次は、この文字列を使用したコマンドの例です。 .LP .nf \f3 @@ -1675,10 +1674,10 @@ .LP .LP -キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。 +キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cnおよびCnは、どれも同じものとして扱われます。 .LP .LP -一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。 +一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントのみを指定できます。 .LP .nf \f3 @@ -1690,7 +1689,7 @@ .LP .LP -識別名文字列の値にコンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。 +識別名文字列の値にカンマが含まれる場合に、コマンドラインで文字列を指定するときには、次のようにカンマを文字「\\」でエスケープする必要があります。 .LP .nf \f3 @@ -1702,7 +1701,7 @@ .LP .LP -識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。 +識別名文字列をコマンドラインで指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンドラインで識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマを「\\」でエスケープする必要はありません。 .LP .SS 信頼できる証明書のインポートに関する注意事項 @@ -1711,7 +1710,7 @@ 重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。 .LP .LP -まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +まず、証明書の内容を表示し(\f2\-printcert\fPコマンドを使用するか、または\f2\-noprompt\fPオプションを指定しないで\f2\-importcert\fPコマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\f2/tmp/cert\fPという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\f2\-printcert\fPコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .LP .nf \f3 @@ -1741,10 +1740,10 @@ .LP .LP -次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。 +次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの(攻撃的意図を持つクラス・ファイルを含んだJARファイルなど)を信頼することになります。 .LP .LP -注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 コマンドを使用し、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。 +注意: 証明書をインポートする前に\f2\-printcert\fPコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に\f2\-importcert\fPコマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\f2\-importcert\fPコマンドを\f2\-noprompt\fPオプションを指定せずに実行した場合のみです。コマンドを使用し、\f2\-noprompt\fPオプションが指定されている場合、ユーザーとの対話は行われません。 .LP .SS パスワードに関する注意事項 @@ -1753,53 +1752,54 @@ キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。 .LP .LP -パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 +パスワードはコマンドラインで指定できます(ストアのパスワードには\f2\-storepass\fPオプション、秘密鍵のパスワードには\f2\-keypass\fPオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 .LP .LP -必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 +必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 .LP .SS 証明書の準拠に関する注意事項 .LP .LP -インターネット標準の +インターネット標準の .na \f2RFC 5280\fP @ .fi -http://tools.ietf.org/rfc/rfc5280.txt では、X.509 証明書が準拠するプロファイルを定義しています。このプロファイルには、証明書のフィールドやエクステンションで有効な値や値の組み合わせが含まれています。\f3keytool\fP では、これらのすべての規則が適用されているわけではないので、標準に準拠しない証明書が生成される可能性があり、そのような証明書は JRE やほかのアプリケーションで拒否されることがあります。ユーザーは、 \f2\-dname\fP や \f2\-ext\fP などで適正なオプションを指定するようにしてください。 +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 -jar(1) ツールのドキュメント +jar(1)ツールのドキュメント .TP 2 o -jarsigner(1) ツールのドキュメント +jarsigner(1)ツールのドキュメント .TP 2 o +\f3keytool\fPの使用例については、 .na -\f4keytool\fP\f2 の使用例については、\fP @ +\f4Javaチュートリアル\fP @ .fi -http://download.oracle.com/javase/tutorial/security/index.html +http://docs.oracle.com/javase/tutorial/の .na -\f2「Java Tutorial」\fP\f4の\fP @ +\f4セキュリティ\fP @ .fi -http://download.oracle.com/javase/tutorial/「Security」\f3を参照\fP +http://docs.oracle.com/javase/tutorial/security/index.htmlを参照 .RE .LP .SH "変更点" .LP .LP -Java SE 6 で keytool のコマンドインタフェースが変更されました。 +Java SE 6でkeytoolのコマンド・インタフェースが変更されました。 .LP .LP -\f3keytool\fP は、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。 +\f3keytool\fPは、ユーザーがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザーはパスワード入力時にその入力内容を確認できなくなったため、初期キーストア・パスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。 .LP .LP -変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。 +変更されたコマンドの中には、名前のみが変更されたものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド(名前が変更されたものと廃止されたものの両方)は、このリリースでも引続きサポートされており、今後のリリースでもサポートされる予定です。keytoolのコマンド・インタフェースに加えられたすべての変更点の概要を、次に示します。 .LP .LP 名前が変更されたコマンド: @@ -1807,13 +1807,13 @@ .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
--- a/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH native2ascii 1 "07 May 2011" +.TH native2ascii 1 "21 Mar 2012" .LP .SH "名前" -native2ascii \- ネイティブ \- ASCII コンバータ +native2ascii \- ネイティブ \- ASCIIコンバータ .LP .LP -サポートされる文字エンコーディングの文字のファイルを ASCII または Unicode エスケープあるいはその両方のファイルに変換します。その逆の変換も行います。 +サポートされる文字エンコーディングの文字のファイルをASCIIまたはUnicodeエスケープあるいはその両方のファイルに変換します。その逆の変換も行います。 .LP .SH "形式" .LP @@ -41,31 +41,31 @@ .SH "説明" .LP .LP -\f2native2ascii\fP Java 実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCII でエンコードされたファイルに変換します。ASCII 文字セットの一部でないすべての文字で Unicode エスケープ (「\\uxxxx」の表記) を使用します。このプロセスは、ISO\-8859\-1 文字セットに含まれない文字が含まれているプロパティーファイルで必要です。このツールは、その逆の変換を実行することもできます。 +\f2native2ascii\fP Java実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。ASCII文字セットの一部でないすべての文字でUnicodeエスケープ(「\\uxxxx」の表記)を使用します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 .LP .LP -\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、 \f2inputfile\fP を省略した場合、標準入力から入力されます。 +\f2outputfile\fPを省略した場合、標準出力に出力されます。さらに、\f2inputfile\fPを省略した場合、標準入力から入力されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-reverse -逆の処理を行います。つまり、ISO\-8859\-1 で Unicode エスケープを使ってエンコードされたファイルを、Java 実行環境でサポートされる文字エンコーディングのファイルに変換します。 +逆の処理を行います。つまり、ISO\-8859\-1でUnicodeエスケープを使用してエンコードされたファイルを、Java実行環境でサポートされる文字エンコーディングのファイルに変換します。 .br .br .TP 3 \-encoding encoding_name -変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング ( \f2java.nio.charset.Charset.defaultCharset\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ドキュメントに示されている、Java 実行環境でサポートされる文字エンコーディングの名前にする必要があります。 +http://download.oracle.com/javase/7/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/src/solaris/doc/sun/man/man1/ja/orbd.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/orbd.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,21 +19,21 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH orbd 1 "07 May 2011" +.TH orbd 1 "21 Mar 2012" .LP .SH "名前" orbd \- The Object Request Broker Daemon .LP .LP -\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。 +\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 +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html .LP .SH "形式" .LP @@ -49,27 +49,27 @@ .SH "説明" .LP .LP -\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。 +\f3orbd\fPツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーム・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 .LP .RS 3 .TP 2 o -ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。 +ネーム・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーム・サービスのサーバーによってネーム・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDがいつでも正しいオブジェクト参照を返します。 .TP 2 o -クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる +クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。 .RE .LP .LP -ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。 +ORBDのサーバー・マネージャにアクセスするには、servertool(1)を使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動およびシャットダウンを行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、このドキュメントの\f2サーバー・マネージャ\fPという項を参照してください。 .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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .LP .SH "オプション" .LP @@ -79,7 +79,7 @@ .RS 3 .TP 3 \-ORBInitialPort nameserverport -ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須) +ネーム・サーバーを起動するポートの番号を指定します。\f2orbd\fPは、起動されると、このポート上で着信リクエストを待機します。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。(必須) .RE .LP @@ -92,70 +92,70 @@ .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 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) +\f2servertool\fPを使用して登録された永続サーバーが正常に動作していることをORBDが確認する回数を指定します。デフォルト値は1,000ミリ秒です。\f2milliseconds\fPに指定する値は、有効な正の整数にする必要があります。(省略可) .RE .LP .RS 3 .TP 3 \-serverStartupDelay milliseconds -\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) +\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://download.oracle.com/javase/7/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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingをネーム・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。 .LP .LP -ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。 +ORBDは、クライアントまたはサーバーを実行する前に起動します。ORBDには、永続ネーム・サービスおよび一時ネーム・サービスが組み込まれています。これらはどちらもCOSネーム・サービスの実装です。 .LP .LP -\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。 +\f4永続\fP\f3ネーム・サービス\fPは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーム・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。 .LP .LP \ .LP .LP -下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。 +下位互換性のため、旧バージョンのJDKに同梱されていた\f4一時\fP\f3ネーム・サービス\fP\f2tnameserv\fPが、今回のリリースのJ2SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 .LP .LP -\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。 +\f2\-ORBInitialPort\fP引数は、\f2orbd\fPの必須のコマンドライン引数で、ネーム・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java\ IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 .LP .LP -UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。 +UNIXコマンド・シェルで\f2orbd\fPを起動するには、次のように入力します。 .LP .nf \f3 @@ -167,7 +167,7 @@ .LP .LP -Windows の MS\-DOS システムプロンプトでは、次のように入力します。 +WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。 .LP .nf \f3 @@ -179,7 +179,7 @@ .LP .LP -これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。 +これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーム・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。 .LP .nf \f3 @@ -197,7 +197,7 @@ .LP .LP -この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。 +この例では、ネーム・サービスは、ホストMyHostのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、「HelloApplication」を起動できます。 .LP .nf \f3 @@ -209,35 +209,35 @@ .LP .LP -ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。 +ネーム・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Solaris上で\f2pkill orbd\fPを実行したり、\f2orbd\fPが動作中のDOSウィンドウで\f2[Ctrl]+[C]\fPキーを押します。一時ネーム・サービスの場合は、サービスが終了されると、ネーム・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 .LP .LP -ORDB に含まれるネームサービスの詳細については、 +ORBDに含まれるネーム・サービスの詳細は、 .na -\f2「ネームサービス」\fP @ +\f2ネーム・サービス\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .LP -.SH "サーバーマネージャー" +.SH "サーバー・マネージャ" .LP .LP -ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\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://download.oracle.com/javase/7/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 \ @@ -252,7 +252,7 @@ .LP .LP -Windows の MS\-DOS システムプロンプトでは、次のように入力します。 +WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。 .LP .nf \f3 @@ -264,13 +264,13 @@ .LP .LP -\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。 +\f21050\fPはネーム・サーバーを実行するポートです。\f2\-ORBInitialPort\fPは必要なコマンドラインの引数です。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .LP .LP -\f2servertool\fP を起動します。 +\f2servertool\fPを起動します。 .LP .LP -Hello サーバーを起動するには、次のように入力します。 +Helloサーバーを起動するには、次のように入力します。 .LP .nf \f3 @@ -282,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 @@ -305,13 +305,13 @@ .LP .LP -\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。 +\f2servertool\fPによってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。 .LP .LP .LP .LP -別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。 +別の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 .LP .LP \ @@ -326,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 \ @@ -338,13 +338,13 @@ \ .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をシャットダウンするには、サーバーを実行しているウィンドウを選択して\f2[Ctrl]+[C]\fPキーを押します。UNIXシェルで\f2orbd\fPをシャットダウンするには、プロセスを検出して終了(kill)します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。 .LP .LP -\f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。 +\f2servertool\fPをシャットダウンするには、\f2quit\fPと入力してキーボードの\f2[Enter]\fPキーを押します。 .LP .SH "関連項目" .LP @@ -352,9 +352,9 @@ .TP 2 o .na -\f2ネームサービス\fP @ +\f2ネーム・サービス\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html +http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html .br .TP 2 o
--- a/src/solaris/doc/sun/man/man1/ja/pack200.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/pack200.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH pack200 1 "07 May 2011" +.TH pack200 1 "21 Mar 2012" .LP .SH "名前" -pack200 \- JAR パックツール +pack200 \- JARパック・ツール .LP .RS 3 .TP 2 @@ -43,7 +43,7 @@ 関連項目 .TP 2 o -注意事項 +注意 .RE .LP @@ -53,12 +53,12 @@ \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP .LP .LP -オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションの指定順序に決まりはありません。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .LP .RS 3 .TP 3 options -コマンド行オプション。 +コマンドライン・オプション。 .TP 3 output\-file 出力ファイルの名前。 @@ -68,13 +68,13 @@ .RE .LP -.SH " 説明" +.SH "説明" .LP .LP -\f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。 +\f2pack200\fPツールは、Java \f2gzip\fP圧縮プログラムを使用してJARファイルを\f2pack200\fP圧縮ファイルに変換するJavaアプリケーションです。\f2pack200\fPファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接デプロイすることができます。 .LP .LP -\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 +\f2pack200\fPツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 .LP .SS 一般的な使用方法: @@ -83,7 +83,7 @@ \f2% pack200 myarchive.pack.gz myarchive.jar\fP .LP .LP -この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。 +この例では、デフォルトの\f2pack200\fP設定を使用して\f2myarchive.pack.gz\fPが生成されます。 .LP .SH "オプション" .LP @@ -91,7 +91,7 @@ \f4\-r \-\-repack\fP .LP .LP -ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。 +ファイル\f2myarchive.jar\fPをパックした後アンパックすることで、JARファイルを生成します。生成されたファイルは\f2jarsigner(1)\fPツールの入力ファイルとして使用できます。 .LP .LP \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP @@ -103,7 +103,7 @@ \f4\-g \-\-no\-gzip\fP .LP .LP -\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。 +\f2pack200\fPファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 .LP .LP \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP @@ -112,7 +112,7 @@ \f4\-G \-\-strip\-debug\fP .LP .LP -出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 +出力からデバッグ用の属性を削除します。これには、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、\f2LocalVariableTypeTable\fPが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 .LP .LP \f4\-\-keep\-file\-order\fP @@ -124,53 +124,53 @@ \f4\-O \-\-no\-keep\-file\-order\fP .LP .LP -パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。 +パック・ツールは、すべての要素を並べ替えて転送します。さらに、JARディレクトリ名が削除される場合があります。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとするJARファイルの最適化機能は正常に動作しなくなることがあります。 .LP .LP \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP .LP .LP -この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが +この値は、各アーカイブ・セグメントの予想ターゲット・サイズN(バイト単位)です。単一の入力ファイルの必要サイズが .br -N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 +Nバイトを超えると、そのファイルには独立したアーカイブ・セグメントが割り当てられます。特殊なケースとして、値が\f2\-1\fPの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が\f20\fPの場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 .LP .LP -各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。 +各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。 .LP .LP -デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。 +デフォルトは \-1です。つまり、パック・ツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化(分割)してより小さなJARにすることを強くお薦めします。 .LP .LP -この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。 +この制限が課されていない10MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。 .LP .LP \f4\-Evalue \-\-effort=\fP\f2value\fP .LP .LP -単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 +単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル\f21\fPの場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル\f29\fPの場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値\f20\fPを指定した場合は、元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 .LP .LP -デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。 +デフォルトは\f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。 .LP .LP \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP .LP .LP -デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。 +入力情報を保存するというデフォルト値を上書きします。転送されるアーカイブのサイズは大きくなる場合があります。次の値を指定できます。 .LP .RS 3 .TP 3 true .TP 3 false -どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。 +どちらの場合でも、指定に従ってパック・ツールがデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 .RE .LP .RS 3 .TP 3 keep -入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。) +入力JAR.内で見つかったデフレーション・ヒントを維持します。(これがデフォルトです。) .RE .LP @@ -178,15 +178,15 @@ \f4\-mvalue \-\-modification\-time=\fP\f2value\fP .LP .LP -返される値は次のどれかになります。 +次の値を指定できます。 .LP .RS 3 .TP 3 latest -パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 +パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 .TP 3 keep -入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。) +入力JAR内で見つかった変更時刻を維持します。(これがデフォルトです。) .RE .LP @@ -194,24 +194,24 @@ \f4\-Pfile \-\-pass\-file=\fP\f2file\fP .LP .LP -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 +ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。fileにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 .LP .LP \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP .LP .LP -デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値: +デフォルトの動作を無効にします。たとえば、不明な属性を含むクラス・ファイルを指定したアクションで転送します。アクションとして指定可能な値は次のとおりです。 .LP .RS 3 .TP 3 error -\f2pack200\fP の操作に失敗し、適切な解説が表示されます。 +\f2pack200\fPの操作全体に失敗し、適切な解説が表示されます。 .TP 3 strip -属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。 +属性がドロップされます。注意: VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。 .TP 3 pass -この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。 +この属性が検出された場合、クラス全体が1つのリソースとして転送されます。 .RE .LP @@ -225,31 +225,31 @@ \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP .LP .LP -これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値: +これら4つのオプションでは、クラス・エンティティにClass属性、Field属性、Method属性、Code属性などの属性のレイアウトを指定できます。attribute\-nameには、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値は次のとおりです。 .LP .RS 3 .TP 3 some\-layout\-string -レイアウト言語は、JSR 200 仕様に定義されています。 +レイアウト言語は、JSR 200仕様に定義されています。 .LP 例: \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 .LP \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP .LP .LP -コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。 +コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 .LP .LP \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP @@ -284,13 +284,13 @@ \f4\-q \-\-quiet\fP .LP .LP -メッセージを表示せずに動作します。 +メッセージを表示せずに動作するように指定します。 .LP .LP \f4\-lfilename \-\-log\-file=\fP\f2filename\fP .LP .LP -出力メッセージのログファイルを指定します。 +出力メッセージのログ・ファイルを指定します。 .LP .LP \f4\-? \-h \-\-help\fP @@ -308,7 +308,7 @@ \f4\-J\fP\f2option\fP .LP .LP -\f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。 +\f2option\fPを、\f2pack200\fPから呼び出されたJava起動ツールに渡します。たとえば、\f2\-J\-Xms48m\fPと指定すると、スタートアップ・メモリーが48Mバイトに設定されます。このオプションは\f2\-X\fPで始まっていませんが、\f2pack200\fPの標準オプションではありません。\f2\-J\fPを使用して、Javaで記述されたアプリケーションを実行する背後のVMにオプション渡すことは、よく行われています。 .LP .SH "終了ステータス" .LP @@ -316,10 +316,10 @@ 次の終了値が返されます。 .LP .LP -\f2\ 0\fP 正常終了した場合 +\f2\ 0\fP正常終了した場合 .LP .LP -\f2>0\fP エラーが発生した場合 +\f2>0\fPエラーが発生した場合 .LP .SH "関連項目" .LP @@ -330,33 +330,33 @@ .TP 2 o .na -\f2Java SE のドキュメント\fP @ +\f2Java SEのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/index.html +http://download.oracle.com/javase/7/docs/index.html .TP 2 o .na -\f2「Java 配備ガイド \- Pack200」\fP @ +\f2Javaデプロイメント・ガイド \- Pack200\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html +http://download.oracle.com/javase/7/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 "注意事項" +.SH "注意" .LP .LP -このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。 +このコマンドと\f2pack(1)\fPを混同しないでください。これらは別製品です。 .LP .LP -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 +JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .LP
--- a/src/solaris/doc/sun/man/man1/ja/policytool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/policytool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH policytool 1 "07 May 2011" +.TH policytool 1 "21 Mar 2012" .LP .SH "名前" -policytool \- PolicyTool 管理 GUI ユーティリティー +policytool \- PolicyTool管理GUIユーティリティ .LP -\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。 +\f3policytool\fPは、ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。 .RS 3 .TP 2 o @@ -44,62 +44,77 @@ .LP .SH "形式" .LP -.RS 3 -.TP 3 -\ -.TP 3 -policytool 管理者ユーティリティーを実行します -\f4policytool\fP -.TP 3 -policytool を実行し、指定されたポリシーファイルを読み込みます -\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP -.TP 3 -\ -.TP 3 -以下にそれぞれの意味を示します。 +.LP +policytool管理者ユーティリティを実行します +.LP +.LP +\f4policytool\fP +.LP +.LP +policytoolを実行し、指定されたポリシー・ファイルを読み込みます +.LP +.LP +\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP +.LP +.LP +説明 +.LP .RS 3 .TP 3 file -ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します +ローカル・ポリシー・ファイルを読み込むように\f2policytool\fPに指示します .TP 3 filename ファイル名 .RE -.SH "説明" + .LP -\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、 +.SH "説明" +.LP +.LP +\f3policytool\fPは、ユーザーがローカル・ポリシー・ファイルの内容を管理することを可能にするGUIです。詳細は、 .na -\f2「ポリシーファイル作成および管理ツール」\fP @ +\f2ポリシー・ファイル作成および管理ツール\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。 -.SH "オプション" +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。 +.LP +.SH "オプション" +.LP .RS 3 .TP 3 file -\f2filename\fP を読み込みます。 -.SH "関連項目" -.na -\f2「Default Policy Implementation and Syntax」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html -.br -.na -\f2「Policy Tool Users' Guide」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html -.br -.na -\f2「Security Permissions」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html -.br -.na -\f2「Security Overview」\fP @ -.fi -http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html -.br -.RE +\f2filename\fPを読み込みます。 .RE .LP +.SH "関連項目" +.LP +.na +\f2デフォルトのポリシー実装および構文\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyFiles.html +.br + +.LP +.na +\f2ポリシー・ツール・ユーザーズ・ガイド\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/PolicyGuide.html +.br + +.LP +.na +\f2セキュリティ権限\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/permissions.html +.br + +.LP +.na +\f2セキュリティの概要\fP @ +.fi +http://download.oracle.com/javase/7/docs/technotes/guides/security/overview/jsoverview.html +.br + +.LP
--- a/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmic 1 "07 May 2011" +.TH rmic 1 "21 Mar 2012" .LP .SH "名前" -rmic \- Java RMI コンパイラ +rmic \- Java RMIコンパイラ .LP .LP -\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。 +\f3rmic\fPによって、JRMPまたはIIOPプロトコルを使用するリモート・オブジェクトのスタブ、スケルトン、およびTieクラスが生成されます。また、OMG IDLも生成されます。 .LP .SH "形式" .LP @@ -42,7 +42,7 @@ .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 @@ -54,32 +54,32 @@ .LP .LP -\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。 +\f2HelloImpl_Stub.class\fPファイルが、クラスのパッケージ名が付いた\f2hello\fPサブディレクトリに作成されます。 .LP .LP -リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。 +リモート・オブジェクトの\f2スケルトン\fPはJRMPプロトコル・サーバー側のエンティティで、実際のリモート・オブジェクト実装を呼び出すメソッドを含みます。 .LP .LP -リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。 +リモート・オブジェクトの\f2Tie\fPは、スケルトンと同様にサーバー側のエンティティですが、IIOPプロトコルを使用してクライアントと通信します。 .LP .LP -「スタブ」とは、リモートオブジェクトのクライアント側での代理です。スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。 +\f2スタブ\fPとは、リモート・オブジェクトのクライアント側での代理です。スタブは、リモート・オブジェクトのメソッド呼出しを、実物のリモート・オブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモート・オブジェクトへの参照は、実際はローカル・スタブへの参照となります。 .LP .LP -デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。 +デフォルトで\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 メソッドを使わなければなりません。 +スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクト自体が実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\f2PortableRemoteObject.narrow\fPメソッドを使用する必要があります。 .LP .SH "オプション" .LP .RS 3 .TP 3 \-bootclasspath path -ブートストラップクラスファイルの位置をオーバーライドします。 +ブートストラップ・クラス・ファイルの位置をオーバーライドします。 .TP 3 \-classpath path -\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。 +\f3rmic\fPがクラスを探すためのパスを指定します。このオプションは、デフォルトやCLASSPATH環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fPの一般形式は次のようになります。 .nf \f3 .fl @@ -87,7 +87,7 @@ .fl \fP .fi -例を示します。 +次に例を示します。 .nf \f3 .fl @@ -97,7 +97,7 @@ .fi .TP 3 \-d directory -生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。 +生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使用すると、スタブ、スケルトン、およびTieファイルを格納するディレクトリを指定できます。たとえば、次のように使用します。 .nf \f3 .fl @@ -105,7 +105,7 @@ .fl \fP .fi -MyClass から取得した \f2スタブとスケルトンクラスを\fP \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。) +\f2MyClass\fPから取得したスタブとスケルトン・クラスを\f2/java/classes/foo\fPディレクトリに置きます。\f2\-d\fPオプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトン・ファイルがそのディレクトリに格納されます。(以前のバージョンの\f3rmic\fPでは、\f2\-d\fPが指定されていない場合は、パッケージ階層は作成\f2されず\fP、出力ファイルはすべて現在のディレクトリに直接格納されていた。) .br \ .TP 3 @@ -113,93 +113,89 @@ インストール型拡張機能の位置をオーバーライドします。 .TP 3 \-g -局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。 +ローカル変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報のみ生成されます。 .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 @ +\f2Java 言語とIDLのマッピング\fP @ .fi -http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。 -.LP -\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。 +http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm(OMG)を参照してください。 +.br +.br +\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 .TP 3 \-iiop -\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。 -.LP -\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。 +\f2rmic\fPによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、実際にはスタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 +.br +.br +\f2\-iiop\fPを使用して\f2rmic\fPを呼び出すと、次の命名規約に準拠したスタブとTieが生成されます。 .nf \f3 .fl _<implementationName>_stub.class .fl -\fP -.br -\f3 -.fl _<interfaceName>_tie.class .fl \fP .fi -.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 に変わります。 -.LP +継承が\f2org.omg.CORBA_2_3.portable.ObjectImpl\fPから\f2org.omg.PortableServer.Servant\fPに変わります。 .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 Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。 +http://download.oracle.com/javase/7/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 オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 +\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 警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。 .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 -コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。 +コンパイラやリンカーが、コンパイルされているクラスやロードされているクラス・ファイルについてのメッセージを表示するようにします。 .TP 3 \-v1.1 -1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。 +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 @@ -208,7 +204,7 @@ .RS 3 .TP 3 CLASSPATH -ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 +ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に示します。 .nf \f3 .fl @@ -226,6 +222,6 @@ .na \f2CLASSPATH\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpath .LP
--- a/src/solaris/doc/sun/man/man1/ja/rmid.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/rmid.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmid 1 "07 May 2011" +.TH rmid 1 "21 Mar 2012" .LP .SH "名前" -rmid \- Java RMI 起動システムデーモン +rmid \- Java RMI起動システム・デーモン .LP .LP -\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。 +\f3rmid\fPでアクティブ化するシステム・デーモンを開始すると、オブジェクトを仮想マシン(VM)に登録してアクティブ化できるようになります。 .LP .SH "形式" .LP @@ -42,18 +42,18 @@ .SH "説明" .LP .LP -\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、 +\f3rmid\fPツールは、起動システム・デーモンを開始します。アクティブ化システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、VM内でアクティブ化したりすることができません。起動可能なリモート・オブジェクトを使用したプログラムの作成方法の詳細は、 .na -\f2「Java RMI 仕様」\fP @ +\f2Java RMI仕様\fP @ .fi -http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび +http://download.oracle.com/javase/7/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://download.oracle.com/javase/7/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。 .LP .LP -デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。 +デーモンを起動するには、次のように、セキュリティ・ポリシー・ファイルを指定して\f2rmid\fPコマンドを実行します。 .LP .nf \f3 @@ -65,23 +65,23 @@ .LP .LP -\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 が使用するポリシーを決定します。 +\f3注意:\fP \f2rmid\fPのSunの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\f2rmid\fPが起動グループ用にVMを起動するために各\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを検証できるようにするためです。特に、\f2ActivationGroupDesc\fPのコンストラクタに渡される\f2CommandEnvironment\fPや任意の\f2Properties\fPによって指定されるコマンドおよびオプションは、\f2rmid\fPのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fPプロパティの値は、起動グループ用にVMを起動するために\f2ActivationGroupDesc\fP内の情報を使用できるかどうかを判断するときに\f2rmid\fPが使用するポリシーを決定します。 .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 -レジストリにほかのポートを指定するには、rmid の起動時に \f2\-port\fP オプションを \f2指定しなければなりません\fP。次に例を示します。 +レジストリに他のポートを指定するには、\f2rmid\fPの起動時に\f2\-port\fPオプションを指定する必要があります。次に示します。 .LP .nf \f3 @@ -93,42 +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 を開始すると、System.inheritedChannel メソッドを呼び出して、継承されたチャンネル ( \f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。 継承されたチャンネルが \f2null\fP であるか、 \f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、 \f2rmid\fP rmid はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。 +\f2rmid\fPを開始すると、\f2System.inheritedChannel\fPメソッドを呼び出して、継承されたチャンネル(\f2inetd\fP/\f2xinetd\fPから継承)を取得しようとします。継承されたチャンネルが\f2null\fPであるか、\f2java.nio.channels.ServerSocketChannel\fPのインスタンスでなかった場合、\f2rmid\fPはそのチャンネルは\f2inetd\fP/\f2xinetd\fPによって起動されたものではないと判断し、前述のように起動します。 .LP .LP -継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、 \f2rmid\fP はエクスポートするリモートオブジェクト、つまり java.rmi.activation.ActivationSystem がバインドされているレジストリと java.rmi.activation.Activator リモートオブジェクトに対する要求を受信するサーバーソケットとして、ServerSocketChannel から取得した java.net.ServerSocket を使用します。 このモードでは、 \f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。 +継承されたチャンネルが\f2ServerSocketChannel\fPインスタンスである場合は、\f2rmid\fPはエクスポートするリモート・オブジェクト、つまり\f2java.rmi.activation.ActivationSystem\fPがバインドされているレジストリと\f2java.rmi.activation.Activator\fPリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\f2ServerSocketChannel\fPから取得した\f2java.net.ServerSocket\fPを使用します。このモードでは、\f2rmid\fPの動作は、\f2次のことを除いて\fP、コマンドラインから起動した場合と同じです。 .LP .RS 3 .TP 2 o -\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。ファイル名の接頭辞は \f2"rmid\-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 .RS 3 .TP 3 \-C<someCommandLineOption> -\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各仮想マシンにプロパティーを渡すことができます。 +\f2rmid\fPの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 .nf \f3 .fl @@ -136,7 +136,7 @@ .fl \fP .fi -コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。 +コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。 .nf \f3 .fl @@ -144,11 +144,11 @@ .fl \fP .fi -このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。 +このコマンドにより、すべての子VMでサーバー呼出しのログが作成されるようになります。 .LP .TP 3 \-J<someCommandLineOption> -rmid を実行している \f2java\fP インタプリタに渡すオプションを指定します。 たとえば、 \f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、rmid のコマンド行で \f2\-J\fP オプションを使って、 \f2java.security.policy\fP プロパティーを定義します。 次に例を示します。 +\f2rmid\fPを実行している\f2java\fPインタプリタに渡すオプションを指定します。たとえば、\f2rmid\fPが\f2rmid.policy\fPという名前のポリシー・ファイルを使用するように指定するには、\f2rmid\fPのコマンドラインで\f2\-J\fPオプションを使用して、\f2java.security.policy\fPプロパティを定義します。次に例を示します。 .nf \f3 .fl @@ -158,15 +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 です。 +起動グループが実行されることになる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\f4指定されていない\fP\f3場合)\fP .LP -デフォルトの \f2execPolicy\fP の場合、 \f2rmid\fP が実行できるのは、 \f2rmid\fP が使用するセキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。 +デフォルトの\f2execPolicy\fPの場合、\f2rmid\fPが実行できるのは、\f2rmid\fPが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\f2rmid\fPに与えられているコマンドおよびコマンドライン・オプションのみです。\f2デフォルト\fPの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 .LP -\f2rmid は、\fP 起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、 \f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、 \f2rmid は\fP java.home にある \f2java\fP コマンドを使用します。 グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。このプロパティーは、次のように定義します。 +\f2rmid\fPは、起動グループ用のVMを起動するときに、そのグループについて登録された起動グループ記述子である\f2ActivationGroupDesc\fP内の情報を使用します。グループ記述子は、\f2ActivationGroupDesc.CommandEnvironment\fPを指定します(省略可能)。これには、起動グループを開始する\f2コマンド\fPと、そのコマンドラインに追加できるコマンドライン・\f2オプション\fPが含まれています。デフォルトでは、\f2rmid\fPは\f2java.home\fPにある\f2java\fPコマンドを使用します。グループ記述子には、オプションとしてコマンドラインに追加される\f2プロパティ\fP・オーバーライドも含まれています。このプロパティは、次のように定義します。 .nf \f3 .fl @@ -175,33 +175,33 @@ \fP .fi .LP -アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、 \f2rmid\fP に対して、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに rmid が使用できるようになります。 +アクセス権\f2com.sun.rmi.rmid.ExecPermission\fPを使用すると、\f2rmid\fPに対して、グループ記述子の\f2CommandEnvironment\fPで指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権\f2com.sun.rmi.rmid.ExecOptionPermission\fPを使用すると、グループ記述子でプロパティ・オーバーライドとして指定されたコマンドライン・オプション、または\f2CommandEnvironment\fPでオプションとして指定されたコマンドライン・オプションを、起動グループを開始するときに\f2rmid\fPが使用できるようになります。 .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特定の\f2コマンド\fPを実行する権限を表します。 .LP \f3構文\fP .br -\f2ExecPermission\fP の「名前」は、 \f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 File.separatorChar) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。 「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。 +\f2ExecPermission\fPの\f2名前\fPは、\f2rmid\fPに実行を許可するコマンドのパス名です。「/*」(「/」はファイル区切り文字\f2File.separatorChar\fP)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン「<<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で特定のコマンドライン・\f2オプション\fPを使用できる権限を表します。\f2ExecOptionPermission\fPの\f2名前\fPは、コマンドライン・オプションの値です。 .LP \f3構文\fP .br -オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。 +オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスクは、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。 .LP 例を示します。「*」、「\-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 -rmid に各種の実行権限を許可するポリシーファイルの例を、次に示します。 +\f2rmid\fPに各種の実行権限を許可するポリシー・ファイルの例を、次に示します。 .nf \f3 .fl @@ -239,11 +239,11 @@ .fl \fP .fi -最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンドを使用します。 \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。 +最初に付与されているアクセス権は、\f2rmid\fPに対し、パス名により明示的に指定される\f2java\fPコマンドの1.7.0バージョンの実行を許可します。デフォルトでは、\f2java.home\fPにあるバージョンの\f2java\fPコマンドを使用します。\f2rmid\fPが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目のアクセス権は、\f2rmid\fPに対して、ディレクトリ\f2/files/apps/rmidcmds\fP内の任意のコマンドの実行権限を許可します。 .LP -3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。 +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 プロパティーを指定する必要があります。 次に例を示します。 +ポリシー・ファイルを指定して\f2rmid\fPを起動するには、\f2rmid\fPのコマンドラインで\f2java.security.policy\fPプロパティを指定する必要があります。次に例を示します。 .LP \f2rmid \-J\-Djava.security.policy=rmid.policy\fP .RE @@ -251,9 +251,9 @@ 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 @@ -265,21 +265,21 @@ .fl \fP .fi -起動グループを開始する前に、 \f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。 \f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、 \f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。 +アクティブ化グループを開始する前に、\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 -起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに、 \f2log\fP というログディレクトリが作成されます。 +起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\f2rmid\fPコマンドを実行したディレクトリに、\f2log\fPというログ・ディレクトリが作成されます。 .LP .TP 3 \-port port -\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、 \f2java.rmi.activation.ActivationSystem\fP という名前でActivationSystem をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。 +\f2rmid\fPのレジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\f2java.rmi.activation.ActivationSystem\fPという名前で\f2ActivationSystem\fPをバインドします。したがって、ローカル・マシン上の\f2ActivationSystem\fPは、次のように\f2Naming.lookup\fPメソッドを呼び出すことによって取得できます。 .nf \f3 .fl @@ -296,7 +296,7 @@ .fi .TP 3 \-stop -\-port オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。 ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。 +\f2\-port\fPオプションによって指定されたポートの、現在の\f2rmid\fP呼出しを停止します。ポートが指定されていない場合は、ポート1098で実行されている\f2rmid\fPを停止します。 .RE .LP @@ -305,7 +305,7 @@ .RS 3 .TP 3 CLASSPATH -ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。 +ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 .nf \f3 .fl @@ -323,6 +323,6 @@ .na \f2CLASSPATH\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1) +http://download.oracle.com/javase/7/docs/technotes/tools/index.html#classpath、java(1) .LP
--- a/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmiregistry 1 "07 May 2011" +.TH rmiregistry 1 "21 Mar 2012" .LP .SH "名前" -rmiregistry \- Java リモートオブジェクトレジストリ +rmiregistry \- Javaリモート・オブジェクト・レジストリ .LP .RS 3 -\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。 +\f3rmiregistry\fPコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。 .RE .LP @@ -44,29 +44,29 @@ .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 +\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 .RS 3 .TP 3 \-J -\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 +\f2\-J\fPの後ろに続くオプションを\f2java\fPインタプリタに引き渡します。\f2java\fPオプションと組み合せて使用します(\-Jとjavaオプションの間にスペースは入れない)。 .RE .LP @@ -76,8 +76,8 @@ .na \f2java.rmi.registry.LocateRegistry\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および +http://download.oracle.com/javase/7/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 +http://download.oracle.com/javase/7/docs/api/java/rmi/Naming.html
--- a/src/solaris/doc/sun/man/man1/ja/schemagen.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/schemagen.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,29 +19,29 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH schemagen 1 "07 May 2011" +.TH schemagen 1 "21 Mar 2012" .LP .SH "名前" -schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ +schemagen \- XMLバインドのためのJava(tm)アーキテクチャ・スキーマ・ジェネレータ .LP .LP \f3仕様バージョン:\fP 2.1 .br \f3実装バージョン:\fP 2.1.3 .LP -.SH "schemagen の起動" +.SH "schemagenの起動" .LP .LP -スキーマジェネレータを起動するには、ユーザーのプラットフォームの bin ディレクトリ内にある \f2適切な schemagen シェルスクリプト\fP を使用 \f2します\fP 。 +スキーマ・ジェネレータを起動するには、ユーザーのプラットフォームの\f2bin\fPディレクトリ内にある適切な\f2schemagen\fPシェル・スクリプトを使用します。 .LP .LP -現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。 +現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 .LP .LP -また、スキーマジェネレータを実行するための Ant タスクも用意されています。 +また、スキーマ・ジェネレータを実行するためのAntタスクも用意されています。 .na -\f2schemagen を Ant とともに使用する\fP @ +\f2schemagenをAntとともに使用する\fP @ .fi https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。 .LP @@ -57,46 +57,46 @@ .LP .LP -ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP を使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。 +ユーザーのJavaソース/クラスが他のクラスを参照している場合、システムのCLASSPATH環境変数でそれらのクラスにアクセスできるようになっているか、\f2\-classpath\fP/\f2\-cp\fPを使用してそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。 .LP .SS -コマンド行オプション +コマンドライン・オプション .LP .nf \f3 .fl -使用方法: schemagen [\-options ...] <java files> +Usage: schemagen [\-options ...] <java files> .fl .fl -オプション: +Options: .fl - \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します。 + \-d <path> : specify where to place processor and javac generated class files .fl - \-cp <path> : ユーザー指定ファイルの検索場所を指定します。 + \-cp <path> : specify where to find user specified files .fl - \-classpath <path> : ユーザー指定ファイルの検索場所を指定します。 + \-classpath <path> : specify where to find user specified files .fl - \-encoding <encoding> : apt/javac 呼び出しに使用されるエンコーディングを指定します。 + \-encoding <encoding> : specify encoding to be used for apt/javac invocation .fl .fl - \-episode <file> : 個別コンパイル用のエピソードファイルを生成します。 + \-episode <file> : generate episode file for separate compilation .fl - \-version : バージョン情報を表示します。 + \-version : display version information .fl - \-help : この使用方法に関するメッセージを表示します。 + \-help : display this usage message .fl \fP .fi .LP -.SH "生成されるリソースファイル" +.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を使用してください。 .LP @@ -106,21 +106,21 @@ .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、 .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バインドのためのJavaアーキテクチャ(JAXB)\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html .RE .LP
--- a/src/solaris/doc/sun/man/man1/ja/serialver.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/serialver.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,14 +19,14 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH serialver 1 "07 May 2011" +.TH serialver 1 "21 Mar 2012" .LP .SH "名前" -serialver \- シリアルバージョンコマンド +serialver \- シリアル・バージョン・コマンド .LP .LP -\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。 +\f3serialver\fPコマンドは\f2serialVersionUID\fPを返します。 .LP .SH "形式" .LP @@ -41,23 +41,23 @@ .RS 3 .TP 3 options -このドキュメントで説明されているコマンド行オプションです。 +このドキュメントで説明されているコマンドライン・オプションです。 .TP 3 classnames -1 つ以上のクラス名です。 +1つ以上のクラス名です。 .RE .LP .SH "説明" .LP .LP -\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。 +\f3serialver\fPは、1つ以上のクラスの\f2serialVersionUID\fPを、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。 .LP .SH "オプション" .LP .RS 3 .TP 3 -\-classpath <: で区切られたディレクトリと zip や jar ファイル> +\-classpath<: で区切られたディレクトリとzipやjarファイル> アプリケーションのクラスおよびリソースの検索パスを設定します。 .RE @@ -65,23 +65,23 @@ .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 "注" +.SH "注意" .LP .LP -\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。 +\f3serialver\fPコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\f3serialver\fPを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 .LP .LP \f2\-J\-Djava.security.manager\fP .LP .LP -また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。 +また、必要であれば、次のオプションを使用してセキュリティ・ポリシーを指定できます。 .LP .LP \f2\-J\-Djava.security.policy=<policy file>\fP @@ -92,6 +92,6 @@ .na \f2java.io.ObjectStreamClass\fP @ .fi -http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html +http://download.oracle.com/javase/7/docs/api/java/io/ObjectStreamClass.html .LP
--- a/src/solaris/doc/sun/man/man1/ja/servertool.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/servertool.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,13 +19,13 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH servertool 1 "07 May 2011" +.TH servertool 1 "21 Mar 2012" .LP .SH "名前" -servertool \- Java(TM) IDL サーバーツール +servertool \- Java(tm)IDLサーバー・ツール .LP -\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。 +\f3servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。 .SH "形式" .LP .nf @@ -38,28 +38,28 @@ .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 以上のポート番号を使用することをお勧めします。 +\f2\-ORBInitialPort\fP \f2nameserverport\fPオプションは\f3必須\fPです。\f2nameserverport\fPの値には、\f2orbd\fPが実行され、着信リクエストを待機しているポートを指定する必要があります。Solarisソフトウェアを使用する場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。このため、\f2nameserverport\fPとして1024以上のポート番号を使用することをお薦めします。 .LP .SH "説明" .LP .LP -\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。 +\f2servertool\fPはアプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースを提供します。その他に、サーバーに関する様々な統計情報を取得するためのコマンドも提供します。 .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 @@ -68,43 +68,43 @@ .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 によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。 +ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。 .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
--- a/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,18 +19,18 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH tnameserv 1 "07 May 2011" +.TH tnameserv 1 "21 Mar 2012" .LP .SH "名前" -Java IDL: 一時ネームサービス \- \f2tnameserv\fP +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 ツールの詳細については、orbd の 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://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。 .LP .LP ここでは、以下の項目について説明します。 @@ -38,40 +38,40 @@ .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 のネーミングサービスプロセスが停止し、再起動されると失われます。 +オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・\f2バインディング\fPと呼ばれます。ネーム・バインディングは\f2ネーミング・コンテキスト\fPに組み込むことができます。ネーミング・コンテキストはそれ自体がネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは\f2初期ネーミング・コンテキスト\fPに格納されます。名前空間において、初期ネーミング・コンテキストは唯一の永続的バインディングです。それ以外のネーミング・コンテキストは、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以上のポート番号を使用することをお薦めします。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 -\f2「RMI\-IIOP を使った Hello World の例」に示されています。\fP @ +\f2RMI\-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://download.oracle.com/javase/7/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlに示されています。コマンドライン・オプション\f2\-ORBInitialPort\fP \f2nameserverport#\fPと\f2\-ORBInitialHost\fP \f2nameserverhostname\fPを使用して、クライアントとサーバーに対してネーム・サービスを探す場所を指定することもできます。 .na -\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @ +\f2Java IDL: 2台のマシン上で実行するHello Worldプログラム\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。 +http://download.oracle.com/javase/7/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,52 +166,51 @@ .LP .SS -\-J オプション +\-Jオプション .LP -このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。 +このコマンドライン・オプションは、\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 -.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の場合は、\f2[Ctrl]+[C]\fPキーを使用します。ネーム・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 .LP -.SH "サンプルクライアント: 名前空間へのオブジェクトの追加" +.SH "サンプル・クライアント: 名前空間へのオブジェクトの追加" .LP .LP -次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。 +次に示すサンプル・プログラムは、名前を名前空間に追加する方法を示すものです。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。 .LP -.nf -\f3 -.fl -\fP\f3 -.fl - \fP\f4初期\fP\f3 -.fl - \fP\f4ネーミングコンテキスト\fP\f3 -.fl - / \\ -.fl - / \\ -.fl - plans \fP\f4Personal\fP\f3 -.fl - / \\ -.fl - / \\ -.fl - calendar schedule\fP -.fl -.fi +.RS 3 +.TP 2 +o +\f4初期ネーミング・コンテキスト\fP +.RS 3 +.TP 2 +* +\f3plans\fP +.TP 2 +* +\f4Personal\fP +.RS 3 +.TP 2 +- +\f3calendar\fP +.TP 2 +- +\f3schedule\fP +.RE +.RE +.RE .LP .LP -この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。 +この例で、\f3plans\fPはオブジェクト参照、\f3Personal\fPは\f3calendar\fPと\f3schedule\fPの2つのオブジェクト参照を含むネーミング・コンテキストです。 .LP .nf \f3 @@ -238,7 +237,7 @@ .fi .LP -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。 +前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。 .nf \f3 .fl @@ -254,7 +253,7 @@ .fi .LP -次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この objref には、あとでさまざまな名前を割り当てて名前空間に追加します。 +次のコードでは、初期ネーミング・コンテキストを取得し、それを\f3ctx\fPに代入します。2行目では、\f3ctx\fPをダミーのオブジェクト参照\f3objref\fPにコピーします。このobjrefには、あとで様々な名前を割り当てて名前空間に追加します。 .nf \f3 .fl @@ -270,7 +269,7 @@ .fi .LP -次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、rebind を使用して初期ネーミングコンテキストの下に \f2plans を追加しています\fP。 \f2rebind\fP メソッドを使用すれば、bind を使用した場合に発生する例外を発生させずに、 \f2このプログラムを何度も繰り返し実行できます\fP。 +次のコードでは、textタイプの名前plansを作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fPを使用して初期ネーミング・コンテキストの下にplansを追加しています。\f2rebind\fPメソッドを使用すれば、\f2bind\fPを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 .nf \f3 .fl @@ -280,7 +279,7 @@ .fl ctx.rebind(name1, objref); .fl - System.out.println("plans rebind sucessful!"); + System.out.println("plans rebind successful!"); .fl .fl @@ -288,7 +287,7 @@ .fi .LP -次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。 +次のコードでは、directoryタイプのPersonalというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\f3ctx2\fPをこの名前にバインドし、初期ネーミング・コンテキストに追加します。 .nf \f3 .fl @@ -306,7 +305,7 @@ .fi .LP -残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。 +残りのコードでは、ダミーのオブジェクト参照をscheduleとcalendarという名前でネーミング・コンテキスト「Personal」(\f3ctx2\fP)にバインドします。 .nf \f3 .fl @@ -316,7 +315,7 @@ .fl ctx2.rebind(name3, objref); .fl - System.out.println("schedule rebind sucessful!"); + System.out.println("schedule rebind successful!"); .fl .fl @@ -326,7 +325,7 @@ .fl ctx2.rebind(name4, objref); .fl - System.out.println("calender rebind sucessful!"); + System.out.println("calender rebind successful!"); .fl .fl @@ -346,10 +345,10 @@ .fi .LP -.SH "サンプルクライアント: 名前空間のブラウズ" +.SH "サンプル・クライアント: 名前空間のブラウズ" .LP .LP -次のサンプルプログラムでは、名前空間をブラウズする方法を示します。 +次のサンプル・プログラムでは、名前空間をブラウズする方法を示します。 .LP .nf \f3 @@ -376,7 +375,7 @@ .fi .LP -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。 +前述のJava IDL一時ネーム・サービスの起動で、ネーム・サーバーはポート1050を使用して起動しました。次のコードで、このポート番号をクライアント・システムに知らせます。 .nf \f3 .fl @@ -396,7 +395,7 @@ .fi .LP -次のコードでは、初期ネーミングコンテキストを取得しています。 +次のコードでは、初期ネーミング・コンテキストを取得しています。 .nf \f3 .fl @@ -410,7 +409,7 @@ .fi .LP -\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。 +\f2list\fPメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストからBindingListHolderに返されます。残りのバインディングは、BindingIteratorHolderに返されます。 .nf \f3 .fl @@ -426,7 +425,7 @@ .fi .LP -次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。 +次のコードでは、返されたBindingListHolderからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 .nf \f3 .fl
--- a/src/solaris/doc/sun/man/man1/ja/unpack200.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/unpack200.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,11 +19,11 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH unpack200 1 "07 May 2011" +.TH unpack200 1 "21 Mar 2012" .LP .SH "名前" -unpack200 \- JAR アンパックツール +unpack200 \- JARアンパック・ツール .LP .RS 3 .TP 2 @@ -43,7 +43,7 @@ 関連項目 .TP 2 o -注意事項 +注意 .RE .LP @@ -53,28 +53,28 @@ \f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP .LP .LP -オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションの指定順序に決まりはありません。コマンドラインに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .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 -.SH " 説明" +.SH "説明" .LP .LP -\f2unpack200\fP は、pack200(1) で作成されたパックファイルを JAR ファイルに変換する \f2ネイティブ実装\fPです。一般的な使用方法: +\f2unpack200\fPは、\f2pack200\fP(1)で作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法: .LP .LP \f2% unpack200 myarchive.pack.gz myarchive.jar\fP .LP .LP -この例では、 \f2デフォルトの unpack200 設定で、myarchive.pack.gz\fP から \f2myarchive.jar\fP が \f2作成されます\fP 。 +この例では、デフォルトの\f2unpack200\fPの設定で、\f2myarchive.pack.gz\fPから\f2myarchive.jar\fPが作成されます。 .LP .SH "オプション" .LP @@ -82,13 +82,13 @@ \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP .LP .LP -JAR ファイル内のすべてのエントリに \f2true\fP 、 \f2false\fP、 \f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。 \f2true\fP または \f2false 場合、\fPデフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。 +JARファイル内のすべてのエントリに\f2true\fP、\f2false\fPまたは\f2keep\fPのデフレーションを設定します。デフォルト・モードは\f2keep\fPです。\f2true\fPまたは\f2false\fP場合、デフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 .LP .LP \f4\-r \-\-remove\-pack\-file\fP .LP .LP -入力パックファイルを削除します。 +入力パック・ファイルを削除します。 .LP .LP \f4\-v \-\-verbose\fP @@ -100,13 +100,13 @@ \f4\-q \-\-quiet\fP .LP .LP -メッセージを表示せずに動作します。 +メッセージを表示せずに動作するように指定します。 .LP .LP \f4\-lfilename \-\-log\-file=\fP\f2filename\fP .LP .LP -出力メッセージのログファイルを指定します。 +出力メッセージのログ・ファイルを指定します。 .LP .LP \f4\-? \-h \-\-help\fP @@ -124,7 +124,7 @@ \f4\-J\fP\f2option\fP .LP .LP -unpack200 によって呼び出される Java 起動ツールに \f2オプション\fP を \f2渡します\fP。 +\f2unpack200\fPによって呼び出されるJava起動ツールに\f2option\fPを渡します。 .LP .SH "終了ステータス" .LP @@ -132,10 +132,10 @@ 次の終了値が返されます。 .LP .LP -\f2\ 0\fP " 成功" +\f2\ 0\fP: 正常終了した場合 .LP .LP -\f2>0\fP " エラー" +\f2>0\fP: エラーが発生した場合 .LP .SH "関連項目" .LP @@ -146,33 +146,33 @@ .TP 2 o .na -\f2Java SE のドキュメント\fP @ +\f2Java SEのドキュメント\fP @ .fi -http://java.sun.com/javase/6/docs/index.html +http://download.oracle.com/javase/7/docs/index.html .TP 2 o .na -\f2「Java 配備ガイド \- Pack200」\fP @ +\f2Javaデプロイメント・ガイド \- Pack200\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html +http://download.oracle.com/javase/7/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 "注意事項" +.SH "注意" .LP .LP -このコマンドと \f2unpack(1) を\fP混同しないでください。これらは別製品です。 +このコマンドと\f2unpack(1)\fPを混同しないでください。これらは別製品です。 .LP .LP -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 +JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .LP
--- a/src/solaris/doc/sun/man/man1/ja/wsgen.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/wsgen.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,24 +19,24 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH wsgen 1 "07 May 2011" +.TH wsgen 1 "21 Mar 2012" .SH "名前" -wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API +wsgen \- XML Web Services(JAX\-WS)2.0のためのJava(tm)API .LP \f3仕様バージョン:\fP 2.1 .br \f3実装バージョン:\fP 2.1.1 .LP -\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。 +\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を参照してください。 .LP -.SH "wsgen の起動" +.SH "wsgenの起動" .RS 3 .TP 2 o @@ -74,7 +74,7 @@ \fP .fi .LP -次の表に、 \f2wsgen\fP のオプションを示します。 +次の表に、\f2wsgen\fPのオプションを示します。 .br .LP .TS @@ -105,7 +105,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -入力クラスファイルの検索場所を指定します +入力クラス・ファイルの検索場所を指定します .br .di .nr a| \n(dn @@ -121,7 +121,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -\-classpath <path> \f2と同じです\fP +\f2\-classpath<path>\fPと同じです .br .di .nr b| \n(dn @@ -153,7 +153,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります +ベンダー拡張(仕様で規定されていない機能)を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、他の実装との相互運用が行えなくなる可能性があります .br .di .nr d| \n(dn @@ -201,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 @@ -217,7 +217,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -生成されるソースファイルを格納する場所を指定する +生成されるソース・ファイルを格納する場所を指定します .br .di .nr h| \n(dn @@ -249,7 +249,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。 +バージョン情報を出力します。このオプションを使用すると、バージョン情報のみが出力されます。通常の処理は実行されません。 .br .di .nr j| \n(dn @@ -265,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 は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\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は省略可能であり、\f2wsdl:binding\fPで使用するプロトコルを指定するために使用されます。有効なプロトコルは\f2soap1.1\fPおよび\f2Xsoap1.2\fPなどです。デフォルトは\f2soap1.1\fPです。\f2Xsoap1.2\fPは標準ではないため、\f2\-extension\fPオプションと組み合せないと使用できません。 .br .di .nr k| \n(dn @@ -281,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 @@ -297,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 @@ -635,7 +635,7 @@ .fl .fi .LP -\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。 +\f3stock\fPディレクトリ内に@WebService注釈が付けられた、StockServiceに必要なラッパー・クラスが生成されます。 .nf \f3 .fl @@ -643,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 @@ -651,6 +651,6 @@ .fl .fi .LP -SOAP 1.2 WSDL が生成されます。 +SOAP 1.2 WSDLが生成されます。 .LP -サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。 +サービスをデプロイするときにJAXWSランタイムによって自動的にWSDLが生成されるため、開発時にWSDLを生成する必要はありません。
--- a/src/solaris/doc/sun/man/man1/ja/wsimport.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/wsimport.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,9 +19,9 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH wsimport 1 "07 May 2011" +.TH wsimport 1 "21 Mar 2012" .SH "名前" -wsimport \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API +wsimport \- XML Web Services(JAX\-WS)2.0のためのJava(tm)API .LP \f3仕様バージョン:\fP 2.1 .br @@ -29,34 +29,34 @@ .br .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 クラス) +JAXBが生成する値タイプ(スキーマのタイプからマップされた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を参照してください。 .br .LP -.SH "wsimport の起動" +.SH "wsimportの起動" .RS 3 .TP 2 o @@ -86,7 +86,7 @@ \fP .fi .LP -次の表に、 \f2wsimport\fP のオプションを示します。 +次の表に、\f2wsimport\fPのオプションを示します。 .LP .TS .if \n+(b.=1 .nr d. \n(.c-\n(c.-1 @@ -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 -外部エンティティー参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。 +外部エンティティ参照を解決するためのカタログ・ファイルを指定します。TR9401、XCatalog、OASIS XML Catalogの各形式がサポートされています。 .na \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 @@ -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 @@ -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 @@ -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 @@ -766,13 +766,13 @@ .TE .if \n-(b.=0 .nr c. \n(.c-\n(d.-72 .LP -\-b オプションを使って、複数の JAX\-WS および JAXB バインディングファイル \f2を指定できます。\fP これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。JAX\-WS および JAXB バインディングファイルの詳細は、 +\f2\-b\fPオプションを使用して、複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 .na -\f2カスタマイズマニュアル\fP @ +\f2カスタマイズ・マニュアル\fP @ .fi https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlを参照してください。 .LP -次の表に、 \f2wsimport\fP の非標準オプションを示します。 +次の表に、\f2wsimport\fPの非標準オプションを示します。 .LP .TS .if \n+(b.=1 .nr d. \n(.c-\n(c.-1 @@ -802,7 +802,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -要求または応答メッセージにバインドされないヘッダーを Java メソッドのパラメータにマップします +リクエストまたはレスポンス・メッセージにバインドされないヘッダーをJavaメソッドのパラメータにマップします .br .di .nr a| \n(dn @@ -818,7 +818,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://\f2<ユーザー名>\fP:\f2<パスワード>\fP@\f2<ホスト名>\fP/\f2<Web サービス名>\fP?wsdl +認証情報を含むファイルを指定するWSDL URIです。このURIの形式は次のとおりです http://\f2<user name>\fP:\f2<password>\fP@\f2<host name>\fP/\f2<Web service name>\fP?wsdl .br .di .nr b| \n(dn @@ -866,7 +866,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -W3C \f2EndpointReferenceType\fP と Java のバインディングを有効にします +W3C \f2EndpointReferenceType\fPとJavaのバインディングを有効にします .br .di .nr e| \n(dn @@ -882,7 +882,7 @@ .ll \n(34u*1u/3u .if \n(.l<\n(81 .ll \n(81u .in 0 -生成された Java ファイルをコンパイルしません +生成されたJavaファイルをコンパイルしません .br .di .nr f| \n(dn @@ -1061,6 +1061,6 @@ .fl .fi .LP -Java アーティファクトを生成し、 \f2http://stockquote.example.com/quote?wsdl\fP をインポートしてその Java アーティファクトをコンパイルします +Javaアーティファクトを生成し、\f2http://stockquote.example.com/quote?wsdl\fPをインポートしてそのJavaアーティファクトをコンパイルします .br
--- a/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon Apr 02 15:01:04 2012 -0700 +++ b/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon Apr 16 11:16:28 2012 -0700 @@ -19,28 +19,27 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH xjc 1 "07 May 2011" +.TH xjc 1 "21 Mar 2012" .LP -.ad c .SH "名前" -xjc \- XML バインドのための Java(TM) アーキテクチャー +xjc \- XMLバインドのためのJava(tm)アーキテクチャ .br -バインディングコンパイラ +バインディング・コンパイラ +.LP .LP \f3仕様バージョン:\fP 2.1 .br -\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l - +\f3リファレンス実装(RI)バージョン:\fP 2.1.3 .LP -.SH "xjc の起動" +.SH "xjcの起動" .LP .LP -バインディングコンパイラを起動するには、使用するプラットフォームに応じた bin ディレクトリ内の \f2xjc\fP シェルスクリプト \f2を\fP 使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。 +バインディング・コンパイラを起動するには、使用するプラットフォームに応じた\f2bin\fPディレクトリ内の\f2xjc\fPシェル・スクリプトを使用します。また、バインディング・コンパイラを実行するためのAntタスクも用意されています。 .na -\f2xjc を Ant とともに使用する\fP @ +\f2XJC Antタスクの使用\fP @ .fi -https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlの手順を参照してください。 .LP .LP \f2% xjc \-help\fP @@ -126,110 +125,110 @@ .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 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。 \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 また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。 +\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は、下位互換性のためにリファレンス実装(RI)ではサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fPコマンドを使用するユーザーなど、他のユーザーが表示できる引数であることに注意してください。セキュリティを高めるには、次の\f2\-httpproxyfile\fPを使用してください。 .TP 3 \-httpproxyfile <file> -HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。 +HTTP/HTTPSプロキシをファイル経由で指定します。形式は前述のものと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 .TP 3 \-classpath <arg> -<jxb:javaType> および <xjc:superClass> \f2カスタマイズが使用する\fP クライアントアプリケーションの \f2クラスファイルの検索場所を\fP 指定します。 +\f2<jxb:javaType>\fPおよび\f2<xjc:superClass>\fPカスタマイズが使用するクライアント・アプリケーションのクラス・ファイルの検索場所を指定します。 .TP 3 \-catalog <file> -外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、 \f2カタログリゾルバの\fP サンプルアプリケーションを調べてください。 +外部エンティティ参照を解決するカタログ・ファイルを指定します。TR9401、XCatalogおよびOASIS XML Catalog形式がサポートされます。詳細は、XML Entity and URI Resolversのドキュメントを参照するか、\f2catalog\-resolver\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 -多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。 +多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードでdiffを使用しやすくなります。 .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 情報が公開されます。 +生成されたコードでは、非整列化の後にJava Beanインスタンスに含まれるソースXMLに関するSAX Locator情報が公開されます。 .TP 3 \-Xsync\-methods -生成されたすべてのメソッドシグニチャーに \f2同期された\fP キーワードが含められます。 +生成されたすべてのメソッド・シグニチャに\f2synchronized\fPキーワードが含められます。 .TP 3 \-mark\-generated -生成されたコードに注釈 \f2@javax.annotation.Generated\fP を付けます。 +生成されたコードに注釈\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 コードベースのインストールを使用してください。 +\-source互換性スイッチは、JAXB 2.0の最初のEarly Access版で導入されました。このスイッチは、JAXB 2.0の今後のリリースから削除されることになりました。1.0.xコードを生成する必要がある場合は、1.0.xコードベースのインストールを使用してください。 .RE .LP @@ -237,38 +236,38 @@ コンパイラの制限 .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 が宣言されている場合は、 \f2仕様に定義されている targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。 +\f2targetNamespace\fPが宣言されている場合は、仕様に定義されている\f2targetNamespace\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 @@ -277,21 +276,21 @@ .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、 .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 バインドのための Java アーキテクチャー (JAXB)\fP @ +\f2XMLバインドのためのJavaアーキテクチャ(JAXB)\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html +http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html .RE .LP
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/windows/classes/java/lang/ClassLoaderHelper.java Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2012, 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 java.lang; + +import java.io.File; + +class ClassLoaderHelper { + + private ClassLoaderHelper() {} + + /** + * Returns an alternate path name for the given file + * such that if the original pathname did not exist, then the + * file may be located at the alternate location. + * For most platforms, this behavior is not supported and returns null. + */ + static File mapAlternativeName(File lib) { + return null; + } +}
--- a/test/demo/jvmti/DemoRun.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/demo/jvmti/DemoRun.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2007, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2012, 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 @@ -124,7 +124,7 @@ String os_name = System.getProperty("os.name"); String libprefix = os_name.contains("Windows")?"":"lib"; String libsuffix = os_name.contains("Windows")?".dll": - os_name.startsWith("Mac OS")?".dylib":".so"; + os_name.contains("OS X")?".dylib":".so"; boolean d64 = ( os_name.contains("Solaris") || os_name.contains("SunOS") ) && ( os_arch.equals("sparcv9") ||
--- a/test/java/io/File/GetXSpace.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/io/File/GetXSpace.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2012, 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,7 +51,7 @@ private static final String dfFormat; static { if (name.equals("SunOS") || name.equals("Linux") - || name.startsWith("Mac OS")) { + || name.contains("OS X")) { // FileSystem Total Used Available Use% MountedOn dfFormat = "([^\\s]+)\\s+(\\d+)\\s+\\d+\\s+(\\d+)\\s+\\d+%\\s+([^\\s]+)"; } else if (name.startsWith("Windows")) {
--- a/test/java/lang/ProcessBuilder/Basic.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/lang/ProcessBuilder/Basic.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2012, 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 @@ -597,7 +597,7 @@ static class MacOSX { public static boolean is() { return is; } private static final String osName = System.getProperty("os.name"); - private static final boolean is = osName.startsWith("Mac OS"); + private static final boolean is = osName.contains("OS X"); } static class True {
--- a/test/java/lang/ProcessBuilder/Zombies.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/lang/ProcessBuilder/Zombies.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2006, 2012, 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,7 +34,7 @@ static final String os = System.getProperty("os.name"); - static final String TrueCommand = os.startsWith("Mac OS")? + static final String TrueCommand = os.contains("OS X")? "/usr/bin/true" : "/bin/true"; public static void main(String[] args) throws Throwable {
--- a/test/java/lang/invoke/InvokeGenericTest.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/lang/invoke/InvokeGenericTest.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2012, 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 @@ -75,7 +75,7 @@ String name = properties.getProperty("java.vm.name"); String arch = properties.getProperty("os.arch"); if ((arch.equals("amd64") || arch.equals("i386") || arch.equals("x86") || - arch.equals("sparc") || arch.equals("sparcv9")) && + arch.equals("x86_64") || arch.equals("sparc") || arch.equals("sparcv9")) && (name.contains("Client") || name.contains("Server")) ) { platformOK = true;
--- a/test/java/lang/management/OperatingSystemMXBean/GetSystemLoadAverage.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/lang/management/OperatingSystemMXBean/GetSystemLoadAverage.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2012, 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 @@ -80,7 +80,7 @@ } private static String LOAD_AVERAGE_TEXT - = System.getProperty("os.name").startsWith("Mac OS") + = System.getProperty("os.name").contains("OS X") ? "load averages:" : "load average:"; @@ -99,7 +99,7 @@ System.out.println("Load average returned from uptime = " + output); System.out.println("getSystemLoadAverage() returned " + loadavg); - String[] lavg = System.getProperty("os.name").startsWith("Mac OS") + String[] lavg = System.getProperty("os.name").contains("OS X") ? output.split(" ") : output.split(","); double expected = Double.parseDouble(lavg[0]);
--- a/test/java/nio/channels/FileChannel/Size.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/nio/channels/FileChannel/Size.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2012, 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 @@ -69,7 +69,7 @@ // Windows and Linux can't handle the really large file sizes for a truncate // or a positional write required by the test for 4563125 String osName = System.getProperty("os.name"); - if (osName.startsWith("SunOS") || osName.startsWith("Mac OS")) { + if (osName.startsWith("SunOS") || osName.contains("OS X")) { blah = File.createTempFile("blah", null); long testSize = ((long)Integer.MAX_VALUE) * 2; initTestFile(blah, 10);
--- a/test/java/nio/channels/FileChannel/Transfer.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/nio/channels/FileChannel/Transfer.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2012, 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 @@ -228,7 +228,7 @@ // Windows and Linux can't handle the really large file sizes for a // truncate or a positional write required by the test for 4563125 String osName = System.getProperty("os.name"); - if (!(osName.startsWith("SunOS") || osName.startsWith("Mac OS"))) + if (!(osName.startsWith("SunOS") || osName.contains("OS X"))) return; File source = File.createTempFile("blah", null); source.deleteOnExit();
--- a/test/java/nio/file/FileSystem/Basic.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/java/nio/file/FileSystem/Basic.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2009, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2008, 2012, 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 @@ -76,7 +76,7 @@ checkSupported(fs, "posix", "unix", "owner", "acl", "user"); if (os.equals("Linux")) checkSupported(fs, "posix", "unix", "owner", "dos", "user"); - if (os.startsWith("Mac OS")) + if (os.contains("OS X")) checkSupported(fs, "posix", "unix", "owner"); if (os.equals("Windows")) checkSupported(fs, "owner", "dos", "acl", "user");
--- a/test/sun/nio/ch/SelProvider.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/sun/nio/ch/SelProvider.java Mon Apr 16 11:16:28 2012 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2012, 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 @@ -50,7 +50,7 @@ } else { throw new RuntimeException("Test does not recognize this operating system"); } - } else if (osname.startsWith("Mac OS")) { + } else if (osname.contains("OS X")) { expected = "sun.nio.ch.PollSelectorProvider"; } else return;
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test/sun/security/ssl/com/sun/net/ssl/internal/ssl/SSLContextImpl/NullGetAcceptedIssuers.java Mon Apr 16 11:16:28 2012 -0700 @@ -0,0 +1,66 @@ +/* + * Copyright (c) 2012, 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. + */ + +/* + * @test + * @bug 7142172 + * @summary Custom TrustManagers that return null for getAcceptedIssuers + * will NPE. + * SunJSSE does not support dynamic system properties, no way to + * re-use system properties in samevm/agentvm mode. + * @run main/othervm NullGetAcceptedIssuers + */ + +import javax.net.ssl.*; + +public class NullGetAcceptedIssuers { + + public static void main(String[] args) throws Exception { + SSLContext sslContext; + + // Create a trust manager that does not validate certificate chains + TrustManager[] trustAllCerts = + new TrustManager[] {new X509TrustManager() { + + public void checkClientTrusted( + java.security.cert.X509Certificate[] certs, + String authType) { + } + + public void checkServerTrusted( + java.security.cert.X509Certificate[] certs, + String authType) { + } + + // API says empty array, but some custom TMs are + // returning null. + public java.security.cert.X509Certificate[] + getAcceptedIssuers() { + return null; + } + }}; + + sslContext = javax.net.ssl.SSLContext.getInstance("SSL"); + sslContext.init(null, trustAllCerts, null); + } +}
--- a/test/tools/launcher/TestHelper.java Mon Apr 02 15:01:04 2012 -0700 +++ b/test/tools/launcher/TestHelper.java Mon Apr 16 11:16:28 2012 -0700 @@ -65,7 +65,7 @@ static final boolean isWindows = System.getProperty("os.name", "unknown").startsWith("Windows"); static final boolean isMacOSX = - System.getProperty("os.name", "unknown").startsWith("Mac"); + System.getProperty("os.name", "unknown").contains("OS X"); static final boolean is64Bit = System.getProperty("sun.arch.data.model").equals("64"); static final boolean is32Bit =