Javadoc 日本語翻訳

概要

「Java™ Platform Standard EditionのAPI仕様」の日本語翻訳に関するメモです。

メモ

• 主に自分用メモなのでSwing関係が中心
• Jdk-api-ja — Java.netに報告したら消去する予定だったが、現在は活動していないようなので、既出、修正済みか？などのチェックは適当で当面このまま放置になりそう
• プロダクトのドキュメントにプルリクエストを送れる仕組みがすごい - Qiitaのような仕組みが欲しいところ
  • ページ下にある「バグを報告する、または機能強化を提案する 」を使用するのは、すこし大げさすぎる
• doの意味が全体的に逆になっています。 · Issue #118 · dotnet/docs.ja-jp
  • JavaのAPI docでも時々見かけるが、機械翻訳で意味が逆になるのは辛い

Java 9

• 概要 (Java SE 9 & JDK 9)には、「機械翻訳について」の項目がページ先頭に追加され、「免責事項: ここに記載されているドキュメントは、お客様の利便性のために翻訳ソフトウエアにより機械的に翻訳(機械翻訳)したものです。オリジナルの英語版もあわせてご確認ください。」との記述が表示されている

翻訳メモの一覧

日本語訳

• Javadoc/Japanese
  • 日本語訳で修正した方が良さそうなもの

翻訳元から

• Javadoc/Nitpick
  • 翻訳元から修正した方が良さそうなもの

Typo

• Javadoc/Typo
  • Typo、変換ミスなど

JDK 7

• Javadoc/JDK7
  • Java SE 7で追加されたSwing関係のクラスドキュメントを翻訳

The Java™ Tutorials

• 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- でリンク切れ
  • 正しくはSwingWorker.setProgress、SwingWorker.getProgressなので、おそらくコピペミス
• 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は存在しない
  • 正しくはWindow#setModalExclusionType(...)

リンク

bugs.java.com

• Bug ID: 6496912 Swing Text API JavaDoc has incorrect links
• Bug ID: 6603635 links to tutorials broken in JTable API doc
• Using the Multiplexing Look and Feel
  • サンプルコードが文字化け？

修正済み

• Bug ID: 6255121 Doc: Comments in some files include duplicate "the"s. (i.e. "the the ")
• Bug ID: 5087703 Typo in the comments for JSpinner.AccessibleJSpinner
• core lib typo fixes

コメント