Javadoc/Nitpick のバックアップの現在との差分(No.39)

• バックアップ一覧
• 差分 を表示
• 現在との差分 - Visual を表示
• ソース を表示
• バックアップ を表示
• Javadoc/Nitpick へ行く。
  • 1 (2011-11-11 (金) 16:34:33)
  • 2 (2012-04-11 (水) 14:04:09)
  • 3 (2012-04-11 (水) 19:00:19)
  • 4 (2012-05-09 (水) 11:53:28)
  • 5 (2012-05-11 (金) 16:46:56)
  • 6 (2012-05-21 (月) 15:00:13)
  • 7 (2012-07-01 (日) 06:40:05)
  • 8 (2012-07-02 (月) 20:55:44)
  • 9 (2013-05-30 (木) 19:29:33)
  • 10 (2013-09-11 (水) 15:50:29)
  • 11 (2014-03-28 (金) 15:57:33)
  • 12 (2014-09-02 (火) 16:30:10)
  • 13 (2014-09-24 (水) 14:42:18)
  • 14 (2014-10-23 (木) 14:19:25)
  • 15 (2014-10-31 (金) 19:00:11)
  • 16 (2014-11-01 (土) 00:46:09)
  • 17 (2015-03-09 (月) 14:46:02)
  • 18 (2015-03-16 (月) 17:28:33)
  • 19 (2015-06-03 (水) 19:05:23)
  • 20 (2015-06-26 (金) 18:04:10)
  • 21 (2015-07-14 (火) 18:16:16)
  • 22 (2016-02-08 (月) 14:15:43)
  • 23 (2017-01-10 (火) 14:18:45)
  • 24 (2017-01-10 (火) 15:26:48)
  • 25 (2017-04-04 (火) 14:13:45)
  • 26 (2017-04-07 (金) 13:51:51)
  • 27 (2017-06-07 (水) 15:35:06)
  • 28 (2017-10-23 (月) 18:41:48)
  • 29 (2017-10-24 (火) 12:56:49)
  • 30 (2017-11-02 (木) 15:34:40)
  • 31 (2017-11-14 (火) 18:13:52)
  • 32 (2018-01-15 (月) 18:56:51)
  • 33 (2018-02-27 (火) 14:35:27)
  • 34 (2018-03-08 (木) 16:34:51)
  • 35 (2018-03-09 (金) 22:20:34)
  • 36 (2018-04-10 (火) 17:38:15)
  • 37 (2018-07-25 (水) 18:02:33)
  • 38 (2019-02-19 (火) 15:43:25)
  • 39 (2019-10-18 (金) 19:05:47)
  • 40 (2022-02-11 (金) 15:05:27)
  • 41 (2022-02-16 (水) 16:17:39)
  • 42 (2022-02-21 (月) 14:04:33)
  • 43 (2022-08-20 (土) 22:15:25)

• 追加された行はこの色です。
• 削除された行はこの色です。

---
title: 翻訳元からの誤記
author: aterai
pubdate: 2010-10-05
pubdate: 2010-10-05getAccessibleIndexInParent
description: Java クラスドキュメントで、オリジナルの英語版から修正した方が良さそうな誤字など。
---
* 概要 [#summary]
`Java`(`Swing`)のクラスドキュメントで、オリジナルの英語版から修正した方が良さそうな箇所をメモしています。

#contents

* 未修正 [#Unresolved]
** `BasicTreeUI#getPathBounds(...)` [#w4af6eac]
- https://docs.oracle.com/javase/jp/8/docs/api/javax/swing/plaf/basic/BasicTreeUI.html
-- Will return null if any component in path is currently valid.
-- 意味が逆になっている
- [https://bugs.openjdk.org/browse/JDK-8047749 [JDK-8047749] javadoc for getPathBounds() in TreeUI and BasicTreeUI is incorrect - Java Bug System]で以下のように修正される
-- Will return null if any component in path is currently invalid.

** TreePathのサンプルコードに非互換タイプエラー [#p756b32f]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/tree/TreePath.html
#code{{
DefaultMutableTreeNode selectedNode =
  ((DefaultMutableTreeNode) selectedPath.getLastPathComponent())
  .getUserObject();
}}

- [https://bugs.openjdk.org/browse/JDK-8054449 [JDK-8054449] Incompatible type in example code in TreePath - Java Bug System]で以下のように修正される
#code{{
DefaultMutableTreeNode selectedNode =
  (DefaultMutableTreeNode) selectedPath.getLastPathComponent();
Object myObject= selectedNode.getUserObject();
}}

** UIManager.getString("Table.foreground") [#be02be71]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/UIManager.html
-- `UIManager.getString("Table.foreground")`
-- この例だと、色を`getString`で取得しようとしているので常に`null`
-- `UIManager.get("Table.foreground")`か`UIManager.getColor("Table.foreground")`に変更した方がよさそう

** UIManager [#q4536622]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/UIManager.html
-- Some look and feels may aggressively look up defaults, so that changing a default may not have an effect after installing the look and feel. Other look and feels may lazily access defaults so that a change to the defaults may effect an existing look and feel.
- https://docs.oracle.com/javase/jp/8/docs/api/javax/swing/UIManager.html
-- 積極的にデフォルトを検索するLook & Feelもあれば(この場合、Look & Feelのインストール後にデフォルトに変更を加えても効果はない)、めったにデフォルトにアクセスしないLook & Feelもあります。(この場合、デフォルトの変更が既存のLook & Feelに影響を及ぼす)
- 修正案？
-- 積極的にデフォルトを検索するLookAndFeelなら、インストール後のデフォルト変更は効果があるような気がするのだが…、括弧内の説明が逆になっている？
-- ついでに、日本語訳としては句点は閉じ括弧の後に移動した方が良さそう

** avadoc [#p9af4b61]
- [https://docs.oracle.com/javase/9/javadoc/javadoc-command.htm#JSJAV-GUID-EAAAE17F-E540-42A0-B22B-4D2B2FD3E4D2 Javadoc Command]
-- 最下部の例で、`javadoc`コマンドが`avadoc`になっている

 Example 1   
 Oracle Solaris, Linux, and macOS:
 
 avadoc -d /home/html -sourcepath /home/src java.awt \

** translateMouseEvent() [#r6849aca]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingUtilities.html#convertMouseEvent-java.awt.Component-java.awt.event.MouseEvent-java.awt.Component-
-- the source field of the returned event will be set to destination if destination is non-null use the translateMouseEvent() method to translate a mouse event from one component to another without changing the source.
- 修正案
-- `translateMouseEvent()`というメソッドはどこにも存在しない？
- 参考
-- [https://bugs.openjdk.java.net/browse/JDK-8049533 JDK-8049533 SwingUtilities.convertMouseEvent misses MouseWheelEvent.preciseWheelRotation - Java Bug System]
-- [https://bugs.openjdk.org/browse/JDK-8049533 JDK-8049533 SwingUtilities.convertMouseEvent misses MouseWheelEvent.preciseWheelRotation - Java Bug System]
-- `Java 9`で`MouseWheelEvent`がコピーされない件は修正されているが、同時に指摘されている`translateMouseEvent()`などは未修正

** SwingConstants#VERTICAL [#i122ead5]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingConstants.html#VERTICAL
-- Vertical orientation. Used for scrollbars and sliders.
- 修正案
-- `JScrollBar`は`SwingConstants`を実装していない(`java.awt.Adjustable`を実装している)ので、`progressbars and sliders`のほうがよさそう
-- `SwingConstants#HORIZONTAL`も同様

** getAlignmentY() [#ec1629bc]
- https://docs.oracle.com/javase/8/docs/api/java/awt/Component.html
-- Ease-of-use constant for getAlignmentX.
-- Ease-of-use constant for getAlignmentY().
- 修正案
-- ()を付ける方に揃える

** setAsksAllowsChildren [#ed45c143]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/tree/DefaultTreeModel.html#setAsksAllowsChildren-boolean-
-- If newvalue is true,
- 修正案
-- If newValue is true,
- メモ
-- [https://bugs.openjdk.java.net/browse/JDK-8026776 JDK-8026776 Broken API names in API doc - Java Bug System]で既出
-- [https://bugs.openjdk.org/browse/JDK-8026776 JDK-8026776 Broken API names in API doc - Java Bug System]で既出
--- https://docs.oracle.com/javase/jp/8/docs/api/java/net/URLConnection.html のgetLastModifedなど

** TableModelevent [#e8b81142]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/event/TableModelEvent.html
-- the TableModelevent can be used to specify the following types of changes:
- 修正案
-- the TableModelEvent can be used to specify the following types of changes:

** HTML.Attribute.id [#j0917455]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/text/html/HTMLDocument.html#getElement-java.lang.String-
-- This is a convenience method for getElement(RootElement, HTML.Attribute.id, id). 
- 修正案
-- This is a convenience method for getElement(RootElement, HTML.Attribute.ID, id). 

** JMX Specification., [#xe79f485]
- https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html
//- https://docs.oracle.com/javase/8/docs/api/java/lang/management/ManagementFactory.html
-- JMX Specification.,
-- ピリオドとカンマが並んでいる

** TableModel#isCellEditable(...) [#m34adfd8]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/table/TableModel.html#isCellEditable-int-int-
-- Returns true if the cell at rowIndex and columnIndex is editable. Otherwise, setValueAt on the cell will not change the value of that cell.
-- [https://bugs.openjdk.java.net/browse/JDK-4292804 Bug ID: 4292804 DefaultTableModel doc confusion between isCellEditable and setValueAt]
-- [https://bugs.openjdk.org/browse/JDK-4292804 Bug ID: 4292804 DefaultTableModel doc confusion between isCellEditable and setValueAt]
--- DefaultTableModel は修正されている？、TableModel は関係ない？

** 文字化け？ [#j58229fa]
- https://docs.oracle.com/javase/8/docs/technotes/guides/swing/1.4/w2k_props.html
-- "win.frame.textColor?????"
-- 「メッセージボックスのフォントカラー」のプロパティー名が文字化け？
// -- http://java.sun.com/j2se/1.5.0/ja/docs/ja/guide/swing/1.4/w2k_props.html
は、「ウィンドウのフォントカラー」と同じ値になっている

本来は、"win.messagebox.textColor" とか、全然別の値なのか、あるいは、この
ページの先頭付近に載っているサンプルコード

#code{{
String propnames[] = (String[])Toolkit.getDefaultToolkit().getDesktopProperty("win.propNames");
String propnames[] = (String[]) Toolkit.getDefaultToolkit()
    .getDesktopProperty("win.propNames");
}}
で、プロパティー一覧を取得しても、"win.messagebox.textColor" は存在しないので、
「メッセージボックスのフォントカラー」自体が設定できないのかもしれない。

他にも同様に、?がついて重複するプロパティー名が存在する。

#code{{
「アイコンのサイズ」 "win.icon.hspacing" "win.icon.vspacing"???
「アイコンの横の間隔」 "win.icon.hspacing"
「アイコンの縦の間隔」 "win.icon.vspacing"
}}

** Dimension オブジェクト、寸法オブジェクト [#gfb4e02f]
- https://docs.oracle.com/javase/8/docs/api/java/awt/Component.html#getSize--
-- a Dimension object
- https://docs.oracle.com/javase/jp/8/docs/api/java/awt/Component.html#getSize--
-- Dimension オブジェクト

- https://docs.oracle.com/javase/8/docs/api/java/awt/Component.html#getPreferredSize--
-- a dimension object
- https://docs.oracle.com/javase/jp/8/docs/api/java/awt/Component.html#getPreferredSize--
-- 寸法オブジェクト

** Component.AccessibleAWTComponent.getAccessibleIndexInParent() [#n8ee376d]
** getAccessibleIndexInParent() [#n8ee376d]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/SwingUtilities.html
-- Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.

コピペして、修正し忘れてるようで、注:が全部getAccessibleIndexInParentのものと同じになっている。

* 1.8.0 で修正済み [#m9daeceb]
** Typo: agressively [#d899477e]
- https://docs.oracle.com/javase/7/docs/api/javax/swing/UIManager.html
-- agressively
- 変更案
-- aggressively

** class MyApp java.io.Serializable [#o8876b77]
- https://docs.oracle.com/javase/7/docs/api/java/awt/Component.html
-- class MyApp java.io.Serializable
- 変更案
-- class MyApp implements  java.io.Serializable

サンプルコードで、implements が抜けている。

* Java 9 で修正済み [#ad8c34d4]
** Typo: any of of them [#wedb8a36]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/JLayer.html
-- using any of of them will cause UnsupportedOperationException to be thrown,
- 変更案
-- using any of them will cause UnsupportedOperationException to be thrown,

** サンプルコードが一行になっている [#p188f78e]
- https://docs.oracle.com/javase/8/docs/api/java/awt/BasicStroke.html
-- // sets the Graphics2D object's Transform attirbute g2d.scale(10, 10); // sets the Graphics2D object's Storoke attribute g2d.setStroke(new BasicStroke(1.5f));

** JSpinnerサンプルコード [#nc09884d]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/JSpinner.html
-- [https://bugs.openjdk.java.net/browse/JDK-5109918 JDK-5109918 Wrong documentation for JSpinner.DateEditor constructor - Java Bug System]
-- [https://bugs.openjdk.org/browse/JDK-5109918 JDK-5109918 Wrong documentation for JSpinner.DateEditor constructor - Java Bug System]

- 余計な`{`がある。
-- `catch (ParseException pe) {{`

- `;`が抜けている。
-- `JComponent editor = spinner.getEditor()`

- `)`が足りない。
-- `((DefaultEditor)editor).getTextField().setValue(spinner.getValue();`

** dataModelとnewModel [#pb842784]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/JTable.html#setModel-javax.swing.table.TableModel-
-- 引数のdataModelとnewModelが混ざっている？

#code{{
public void setModel(TableModel dataModel)
このテーブルのデータモデルを newModel に設定し、それに新しいデータモデルからのリスナー通知を登録します。
パラメータ:
dataModel - このテーブルの新しいデータソース
例外:
IllegalArgumentException - newModel が null の場合
}}

** Htmlの表がずれている [#p5e32821]
- https://docs.oracle.com/javase/8/docs/api/java/awt/Container.html#setFocusTraversalKeys-int-java.util.Set-
-- KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS,	1 つ下のフォーカストラバーサルサイクルに移動	none
- [https://bugs.openjdk.java.net/browse/JDK-4470006 Bug ID: 4470006 Table shown for Traversal Keys in setDefaultFocusTraversalKeys() not proper]
- [https://bugs.openjdk.org/browse/JDK-4470006 Bug ID: 4470006 Table shown for Traversal Keys in setDefaultFocusTraversalKeys() not proper]
-- Submit Date 	14-JUN-2001
- [https://docs.oracle.com/javase/9/docs/api/java/awt/Container.html#setFocusTraversalKeys-int-java.util.Set- Container#setFocusTraversalKeys(...) (Java SE 9 & JDK 9)]

** setAlignmentX, setAlignmentY, getAlignmentX, getAlignmentY javadoc of JComponent [#ueae105a]
- [https://bugs.openjdk.java.net/browse/JDK-8068374 JDK-8068374 setAlignmentX, setAlignmentY, getAlignmentX, getAlignmentY javadoc of JComponent - Java Bug System]
- [https://bugs.openjdk.org/browse/JDK-8068374 JDK-8068374 setAlignmentX, setAlignmentY, getAlignmentX, getAlignmentY javadoc of JComponent - Java Bug System]

水平と垂直が実際の動作と入れ替わっている。

** DateTimeFormatter week-of-month [#yda50306]
- [https://bugs.openjdk.java.net/browse/JDK-8169482 JDK-8169482 java.time.DateTimeFormatter javadoc: F is not week-of-month - Java Bug System]
- [https://bugs.openjdk.org/browse/JDK-8169482 JDK-8169482 java.time.DateTimeFormatter javadoc: F is not week-of-month - Java Bug System]
- [https://stackoverflow.com/questions/40389916/java-8-dateformatter-week-of-month-and-year-key-symbols-difference time - Java 8 DateFormatter week of month and year key symbols difference - Stack Overflow]
- [https://docs.oracle.com/javase/jp/8/docs/api/java/time/format/DateTimeFormatter.html#patterns DateTimeFormatter (Java Platform SE 8)]
- パターン文字の`W`と`F`が両方`week-of-month`になっている
- 実際は`F`が`day-of-week-in-month`
- [https://docs.oracle.com/javase/jp/9/docs/api/java/time/format/DateTimeFormatter.html#patterns DateTimeFormatter (Java SE 9 & JDK 9)]

** JEditorPane#scrollToReference(...) [#o697eaf5]
- https://docs.oracle.com/javase/8/docs/api/javax/swing/JEditorPane.html#scrollToReference-java.lang.String-
-- that is, the value returned by the `UL.getRef` method for the `URL` being displayed
-- `UL.getRef`は[https://docs.oracle.com/javase/8/docs/api/java/net/URL.html#getRef-- URL#getRef()]のtypo
-- `Java 9`、`Java 10`で修正済み [https://bugs.openjdk.org/browse/JDK-8182350 [JDK-8182350] Spelling mistake in javadoc: javax.swing.JEditorPane.scrollToReference(String) - Java Bug System]

* コメント [#comment]
#comment
#comment