• 追加された行はこの色です。
  • 削除された行はこの色です。
TITLE:Javadoc 日本語翻訳
RIGHT:Posted by &author(aterai); at 2010-10-05
---
title: Javadoc 日本語翻訳
keywords: [Java, Javadoc, Translation, Japanese]
description: Java™ Platform Standard EditionのAPI仕様の日本語翻訳に関するメモ
author: aterai
pubdate: 2010-10-05
---
#contents

* Javadoc 日本語翻訳 [#tbecfb97]
#contents(big)
* 概要 [#summary]
「`Java™ Platform Standard Edition`の`API`仕様」の日本語翻訳に関するメモです。

* 概要 [#v1a01202]
「Java  Platform Standard Edition の API 仕様」の日本語翻訳に関するメモです。
- 編集の制限はしていないはずなので、追記、ツッコミがあれば、適当にどうぞ
- 主に自分用メモなのでSwing関係が中心
- 既出、修正済みなどのチェックはいい加減
-- 検索するのが面倒なのと、bugs.sun.com は遅いし、ログイン出来ないし、最近はメンテナンス?で繋がらないことが多いので。
- [http://java.net/projects/jdk-api-ja Jdk-api-ja — Java.net] の Users Mailing List に報告したら順次消していく予定…ですが Jdk-api-ja はもう活動していないのかも?
** メモ [#memo]
- 主に自分用メモなので`Swing`関係が中心
- %%[http://java.net/projects/jdk-api-ja Jdk-api-ja — Java.net]%%に報告したら消去する予定だったが、現在は活動していないようなので、既出、修正済みか?などのチェックは適当で当面このまま放置になりそう
- [https://qiita.com/amay077/items/8823376f307235a7f651 プロダクトのドキュメントにプルリクエストを送れる仕組みがすごい - Qiita]のような仕組みが欲しいところ
-- ページ下にある「バグを報告する、または機能強化を提案する 」を使用するのは、すこし大げさすぎる
- [https://github.com/dotnet/docs.ja-jp/issues/118 doの意味が全体的に逆になっています。 · Issue #118 · dotnet/docs.ja-jp]
-- `Java`の`API doc`でも時々見かけるが、機械翻訳で意味が逆になるのは辛い

- メモ: [http://yoshio3.com/2012/04/11/new-link-of-javase-api-reference/ 続:旧 Java SE API リファレンスへの新しいリンク先変更について « 寺田 佳央 – Yoshio Terada]から引用(重箱の隅)
 また、Java SE 7 API のドキュメント翻訳プロジェクトにつきましては、諸事情がございまして、5月中旬位まで御待ち頂けませんでしょうか。5月中旬%%移行%%以降に本件についてのアップデートをさせて頂きたいと考えております。
** Java 9 [#java9]
- [https://docs.oracle.com/javase/jp/9/docs/api/overview-summary.html 概要 (Java SE 9 & JDK 9)]には、「機械翻訳について」の項目がページ先頭に追加され、「免責事項: ここに記載されているドキュメントは、お客様の利便性のために翻訳ソフトウエアにより機械的に翻訳(機械翻訳)したものです。オリジナルの英語版もあわせてご確認ください。」との記述が表示されている

* 翻訳メモの一覧 [#f8fd3e5d]

** 日本語訳 [#s103255f]
* 翻訳メモの一覧 [#translation]
** 日本語訳 [#Japanese]
- [[Javadoc/Japanese]]
-- 日本語訳で修正した方が良さそうなもの。
-- 日本語訳で修正した方が良さそうなもの

** 翻訳元から [#xdf8ce86]
** 翻訳元から [#Nitpick]
- [[Javadoc/Nitpick]]
-- 翻訳元から修正した方が良さそうなもの。
-- 翻訳元から修正した方が良さそうなもの

** Typo [#s349bb74]
** Typo [#Typo]
- [[Javadoc/Typo]]
-- Typo、変換ミスなど。
-- `Typo`、変換ミスなど

* リンク [#k7f2489a]
** bugs.sun.com [#z3771fc9]
- [http://bugs.sun.com/view_bug.do?bug_id=6496912 Bug ID: 6496912 Swing Text API JavaDoc has incorrect links]
-- http://java.sun.com/javase/6/docs/api/javax/swing/text/JTextComponent.html#addInputMethodListener(java.awt.event.InputMethodListener)
-- http://docs.oracle.com/javase/jp/6/api/javax/swing/text/JTextComponent.html#addInputMethodListener(java.awt.event.InputMethodListener)
- [http://bugs.sun.com/view_bug.do?bug_id=6603635 Bug ID: 6603635 links to tutorials broken in JTable API doc]
- Choosing the Look and Feel
-- http://docs.oracle.com/javase/jp/6/api/javax/swing/plaf/multi/doc-files/multi_tsc.html
-- ついでに、サンプルコードが文字化け?
** JDK 7 [#jdk7]
- [[Javadoc/JDK7]]
-- `Java SE 7`で追加された`Swing`関係のクラスドキュメントを翻訳

** 修正済み [#o47e719a]
- [http://bugs.sun.com/view_bug.do?bug_id=6255121 Bug ID: 6255121 Doc: Comments in some files include duplicate "the"s. (i.e. "the the ")]
- [http://bugs.sun.com/view_bug.do?bug_id=5087703 Bug ID: 5087703 Typo in the comments for JSpinner.AccessibleJSpinner]
- [http://mail.openjdk.java.net/pipermail/core-libs-dev/2009-April/001390.html core lib typo fixes]
** The Java™ Tutorials [#Tutorials]
- [https://docs.oracle.com/javase/tutorial/uiswing/concurrency/bound.html Bound Properties and Status Methods (The Java™ Tutorials > Creating a GUI With JFC/Swing > Concurrency in Swing)]
-- `SwingWorker.setProgress`へのリンクが https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingWorker.html#setProgress-- でリンク切れ
-- `SwingWorker.getProgress`へのリンクが https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingWorker.html#getProgress-int- でリンク切れ
-- 正しくは[https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingWorker.html#setProgress-int- SwingWorker.setProgress]、[https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingWorker.html#getProgress-- SwingWorker.getProgress]なので、おそらくコピペミス
- [https://docs.oracle.com/javase/tutorial/uiswing/misc/modality.html How to Use Modality in Dialogs (The Java™ Tutorials > Creating a GUI With JFC/Swing > Using Other Swing Features)]
-- `f7.setModalityExclusionType(Dialog.ModalExclusionType.APPLICATION_EXCLUDED);`の`setModalityExclusionType`は存在しない
-- 正しくは[https://docs.oracle.com/javase/8/docs/api/java/awt/Window.html#setModalExclusionType-java.awt.Dialog.ModalExclusionType- Window#setModalExclusionType(...)]

* コメント [#rc2fa0b7]
- 「コロンのあとに例(数値)が重複して現れる」を追加。 -- [[aterai]] &new{2010-10-26 (火) 18:52:22};
- renderer の訳が、「レンダリング」。レンダラでいいような気がするけど、これは一箇所しかない? -- [[aterai]] &new{2010-10-28 (木) 15:07:41};
- WindowsComboBoxUI#paintCurrentValue(Graphics g, Rectangle bounds, boolean hasFocus) メソッド中のコメントに、 Typo。 // On vista for READNLY ComboBox -- [[aterai]] &new{2011-02-10 (木) 14:18:59};
- [http://docs.oracle.com/javase/jp/6/api/javax/swing/JTable.html#doLayout() デルタの分散]、Distributing the delta、分散、分配・・・。 -- [[aterai]] &new{2011-03-07 (月) 16:17:00};
- [http://docs.oracle.com/javase/6/docs/api/java/awt/geom/Rectangle2D.html The Rectangle2D class describes a rectangle defined by a location (x, y) and dimension (w x h).]と、[http://docs.oracle.com/javase/6/docs/api/java/awt/geom/Rectangle2D.Double.html Constructs a new Rectangle2D, initialized to location (0, 0) and size (0, 0).]。個人的には、(w x h)より、(w, h)の方が…。   -- [[aterai]] &new{2011-12-07 (水) 18:33:19};
- メモ: [http://togetter.com/li/278455 rip-sun.com - Togetter] -- [[aterai]] &new{2012-03-26 (月) 01:48:27};
-- メモ: [http://d.hatena.ne.jp/chiheisen/20120326/1332715371 Java SE API(JavaDoc)日本語訳は、オンラインで読めます。 - 地平線に行く] -- [[aterai]] &new{2012-03-26 (月) 17:59:32};
-- URLの変更はそのうちヤル予定。 -- [[aterai]] &new{2012-04-03 (火) 18:33:03};
- java.sun.com の日本語版が参照できるようになっている?けど、dlc.sun.com.edgesuite.net と比べると微妙に異なるみたい。どちらが新しいのだろう? -- [[aterai]] &new{2012-04-09 (月) 21:17:16};
-- そもそも両方共結構古いバージョンなのかもしれない。http://java.net/projects/jdk-api-ja に報告、修正された箇所が多数?巻戻っているみたいなので。 -- [[aterai]] &new{2012-04-10 (火) 19:36:34};
- download.java.net が落ちてるので、dlc.sun.com.edgesuite.netのドキュメント にも繋がらない。 -- [[aterai]] &new{2012-04-11 (水) 14:23:29};
-- bugs.sun.com にも繋がらない(ログインしてたら激遅になるバグのせいでもなさそうだし)のは、困る…。 -- [[aterai]] &new{2012-04-11 (水) 14:29:45};
-- bugs.sun.com をoracleのどこかに移転するとかの予告か何かありましたっけ?(あれ使いにくかったので作りなおすのは歓迎ですが、いきなり繋がらなくなるのは…) -- [[aterai]] &new{2012-04-11 (水) 16:01:26};
-- XXから戻ったら復帰してた。 -- [[aterai]] &new{2012-04-11 (水) 18:57:20};
- サイト全体で、java.sun.com/javase/6/docs/ を docs.oracle.com/javase/jp/6/ に置換。ついでに download.oracle.com/javase/jp/6/ を docs.oracle.com/javase/jp/6/ に置換。 -- [[aterai]] &new{2012-04-11 (水) 19:30:06};
* リンク [#reference]
** bugs.java.com [#z3771fc9]
- [https://bugs.openjdk.org/browse/JDK-6496912 Bug ID: 6496912 Swing Text API JavaDoc has incorrect links]
// http://java.sun.com/javase/6/docs/api/javax/swing/text/JTextComponent.html#addInputMethodListener(java.awt.event.InputMethodListener)
// https://docs.oracle.com/javase/jp/6/api/javax/swing/text/JTextComponent.html#addInputMethodListener(java.awt.event.InputMethodListener)
- [https://bugs.openjdk.org/browse/JDK-6603635 Bug ID: 6603635 links to tutorials broken in JTable API doc]
- [https://docs.oracle.com/javase/jp/6/api/javax/swing/plaf/multi/doc-files/multi_tsc.html Using the Multiplexing Look and Feel]
-- サンプルコードが文字化け?

** 修正済み [#fixed]
- [https://bugs.openjdk.org/browse/JDK-6255121 Bug ID: 6255121 Doc: Comments in some files include duplicate "the"s. (i.e. "the the ")]
- [https://bugs.openjdk.org/browse/JDK-5087703 Bug ID: 5087703 Typo in the comments for JSpinner.AccessibleJSpinner]
- [https://mail.openjdk.org/pipermail/core-libs-dev/2009-April/001390.html core lib typo fixes]

* コメント [#comment]
#comment
- 「コロンのあとに例(数値)が重複して現れる」を追加。 -- &user(aterai); &new{2010-10-26 (火) 18:52:22};
- `renderer`の訳が、「レンダリング」。レンダラでいいような気がするけど、これは一箇所しかない? -- &user(aterai); &new{2010-10-28 (木) 15:07:41};
- `WindowsComboBoxUI#paintCurrentValue(Graphics g, Rectangle bounds, boolean hasFocus)`メソッド中のコメントに `Typo`。 `// On vista for READNLY ComboBox` -- &user(aterai); &new{2011-02-10 (木) 14:18:59};
- [https://docs.oracle.com/javase/jp/6/api/javax/swing/JTable.html#doLayout() デルタの分散]、`Distributing the delta`、分散、分配。 -- &user(aterai); &new{2011-03-07 (月) 16:17:00};
- [https://docs.oracle.com/javase/6/docs/api/java/awt/geom/Rectangle2D.html The Rectangle2D class describes a rectangle defined by a location (x, y) and dimension (w x h).]と、[https://docs.oracle.com/javase/6/docs/api/java/awt/geom/Rectangle2D.Double.html Constructs a new Rectangle2D, initialized to location (0, 0) and size (0, 0).]。個人的には`(w x h)`より`(w, h)`の方が良い気がする。   -- &user(aterai); &new{2011-12-07 (水) 18:33:19};
- メモ: [http://togetter.com/li/278455 rip-sun.com - Togetter] -- &user(aterai); &new{2012-03-26 (月) 01:48:27};
-- メモ: [http://d.hatena.ne.jp/chiheisen/20120326/1332715371 Java SE API(JavaDoc)日本語訳は、オンラインで読めます。 - 地平線に行く] -- &user(aterai); &new{2012-03-26 (月) 17:59:32};
- サイト全体で、`java.sun.com/javase/6/docs/`を`docs.oracle.com/javase/jp/6/`に置換。ついでに `download.oracle.com/javase/jp/6/`を`docs.oracle.com/javase/jp/6/`に置換。 -- &user(aterai); &new{2012-04-11 (水) 19:30:06};

#comment