Javadoc/Typo のバックアップ(No.7)

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

TITLE:Typo、変換ミス - Javadoc

Typo、変換ミス

句点が二度出現

• http://docs.oracle.com/javase/jp/6/api/javax/swing/text/JTextComponent.html#setMargin(java.awt.Insets)
  • Border オブジェクトが適切なマージン空白を作成します。 (それ以外の場合、このプロパティーは事実上無視される)。
• 変更案
  • Border オブジェクトが適切なマージン空白を作成します(それ以外の場合、このプロパティーは事実上無視される)。

翻訳されていない

• http://docs.oracle.com/javase/jp/6/api/java/awt/Component.html#setBounds(int,%20int,%20int,%20int)
  • width - このコンポーネントの新しい width
  • height - このコンポーネントの新しい height
• 変更案
  • width - このコンポーネントの新しい幅
  • height - このコンポーネントの新しい高さ

英語版の<code>タグの付け方が、このメソッドだけ他と異なるようだ。

余計な括弧

• http://docs.oracle.com/javase/jp/6/api/javax/swing/UIManager.html
  • このため、一般に、ある Look & Feel が提供する ComponentUI) は、別の Look & Feel では動作しません。
• http://docs.oracle.com/javase/7/docs/api/javax/swing/UIManager.html
  • so that in general a ComponentUI provided by one look and feel will not work with another look and feel.
• 変更案
  • このため、一般に、ある Look & Feel が提供する ComponentUI は、別の Look & Feel では動作しません。

同一文章が二回出現

• http://docs.oracle.com/javase/jp/6/api/javax/swing/text/JTextComponent.html#setCaretPosition(int)
  • TextComponent のテキスト挿入キャレットの位置を設定します。TextComponent のテキスト挿入キャレットの位置を設定します。
• http://docs.oracle.com/javase/6/docs/api/javax/swing/text/JTextComponent.html#setCaretPosition(int)
  • Sets the position of the text insertion caret for the TextComponent.

デフォルトでは…が二回

• http://docs.oracle.com/javase/jp/6/api/java/awt/Frame.html#isUndecorated()
  • デフォルトではすべてのフレームが装飾を持ちます。デフォルトでは、すべてのフレームが初期状態で装飾を持ちます。
• http://docs.oracle.com/javase/6/docs/api/java/awt/Frame.html#isUndecorated()
  • Indicates whether this frame is undecorated. By default, all frames are initially decorated.
• 変更案
  • このフレームが装飾されていないかどうか示します。デフォルトでは、すべてのフレームが初期状態で装飾を持ちます。

特に、余分のスペースの差 (1 - ウエイト) * を取得

• http://docs.oracle.com/javase/jp/6/api/javax/swing/JSplitPane.html#setResizeWeight(double)
  • 特に、左または上のコンポーネントは余分なスペース (ウエイト * 差) を取得し、右または下のコンポーネントは余分のスペースの差 (1 - ウエイト) * を取得します。
• http://docs.oracle.com/javase/6/docs/api/javax/swing/JSplitPane.html#setResizeWeight(double)
  • Specifically, the left/top component gets (weight * diff) extra space and the right/bottom component gets (1 - weight) * diff extra space.
• 変更案
  • 具体的には、左/上のコンポーネントは、(ウエイト * 差)の余分なスペースを取得し、右/下のコンポーネントは、((1 - ウエイト) * 差) の余分なスペースを取得します。

カッコの後に* ではなく、* 差が良さそう。

SimpleDateFormat getNativeImageMetadataFormat から 午前/午後

• http://docs.oracle.com/javase/jp/6/api/java/text/SimpleDateFormat.html
  • getNativeImageMetadataFormat から
• http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
  • a

何かの変換ミスか？

JFileCHooser.ERROR_OPTION

• http://docs.oracle.com/javase/6/docs/api/javax/swing/JFileChooser.html#showDialog(java.awt.Component,%20java.lang.String)
• http://docs.oracle.com/javase/jp/6/api/javax/swing/JFileChooser.html#showDialog(java.awt.Component,%20java.lang.String)
  • JFileCHooser.ERROR_OPTION

JFileChooserのHが大文字になっている。日本語版は、三箇所。7 の英語版は修正されている。

HyperLinkListener

• http://docs.oracle.com/javase/jp/6/api/javax/swing/JEditorPane.html#getHyperlinkListeners()
• http://docs.oracle.com/javase/6/docs/api/javax/swing/JEditorPane.html#getHyperlinkListeners()
  • HyperLinkListener

HyperlinkのLが大文字になっている。

<code>, <i>

• http://docs.oracle.com/javase/jp/6/api/java/lang/Math.html#E
  • 自然対数の底 <code>e</code> にもっとも近い <i>double</i> 値です。
• http://docs.oracle.com/javase/6/docs/api/java/lang/Math.html#E
  • The <code>double</code> value that is closer than any other to <i>e</i>, the base of the natural logarithms.
• 変更案
  • 自然対数の底 <i>e</i> にもっとも近い <code>double</code> 値です。

パージョン

• http://docs.oracle.com/javase/jp/6/technotes/guides/deployment/deployment-guide/tracing_logging.html
• http://docs.oracle.com/javase/jp/6/technotes/guides/plugin/developer_guide/version.html
  • メジャー、マイナー、およびパッチパージョン番号が含まれます

Hashtable 指定された TreeNode

• http://docs.oracle.com/javase/jp/6/api/javax/swing/JTree.html#JTree(javax.swing.tree.TreeNode)
  • Hashtable 指定された TreeNode をルートに持つ、ルートノードを表示する JTree を返します。

• http://docs.oracle.com/javase/6/docs/api/javax/swing/JTree.html#JTree(javax.swing.tree.TreeNode)
  • Returns a JTree with the specified TreeNode as its root, which displays the root node.

• 変更案
  • 指定された TreeNode をルートに持ち、ルートノードを表示する JTree を返します。

多分直前の、public JTree(Hashtable<?,?> value) から、コピペミス。

括弧の対応

• http://docs.oracle.com/javase/jp/6/api/javax/swing/DefaultRowSorter.html
  • デフォルトの Comparator を検出するには、具象実装 (たとえば、TableRowSorter を参照します。
• http://docs.oracle.com/javase/6/docs/api/javax/swing/DefaultRowSorter.html
  • To find the default Comparators, see the concrete implementation (for example, TableRowSorter).
• 変更案
  • デフォルトの Comparator を検出するには、具象実装 (たとえば、TableRowSorter) を参照します。

code タグの対応

• http://docs.oracle.com/javase/jp/6/api/java/awt/CardLayout.html
  • CardLayout</code> オブジェクトに最初に追加されるコンポーネントは、コンテナが最初に表示されるときの可視コンポーネントになります。
  • <code><code>CardLayout</code> は、アプリケーションがこれらのカードを順番にめくったり、指定したカードを表示したりできるようにするメソッドのセットを定義します。

AbstractList#modCount

• http://docs.oracle.com/javase/jp/6/api/java/util/AbstractList.html#modCount
  • @code add(int, E)} または remove(int) に対する 1 回の呼び出しでは、フィールドに 1 だけ加える必要があります。

• http://docs.oracle.com/javase/6/docs/api/java/util/AbstractList.html#modCount
  • A single call to add(int, E) or remove(int) must add no more than one to this field,
  • A single call to {@code add(int, E)} or {@code remove(int)} must add no more than one to this field,
  • A single call to <code>add(int, E)</code> or <code>remove(int)</code> must add no more than one to this field,

• 修正案
  • <code>add(int, E)</code> または <code>remove(int)</code> に対する 1 回の呼び出しでは、フィールドに 1 だけ加える必要があります。

Fild

• http://docs.oracle.com/javase/jp/6/technotes/guides/swing/SwingChanges.html#Miscellaneous
  • UIManager.put("MenuItem.commandSound", "pathToNewSoundFild");
• 変更案
  • UIManager.put("MenuItem.commandSound", "pathToNewSoundFile");

句点がない

• http://docs.oracle.com/javase/jp/6/api/javax/swing/JTable.html#changeSelection(int,%20int,%20boolean,%20boolean)
  • toggle:false、extend:false既存の選択をクリアし、新しいセルが確実に選択されるようにする
  • toggle:false、extend:true既存の選択をアンカーから指定のセルまで拡張して、ほかのすべての選択をクリアする
  • toggle:true、extend:false指定されたセルが選択されている場合、そのセルを選択解除する。選択されていない場合、そのセルを選択する
  • toggle:true、extend:trueアンカーの選択状態を、そのアンカーと指定されたセル間のすべてのセルに適用する。
• http://docs.oracle.com/javase/6/docs/api/javax/swing/JTable.html#changeSelection(int,%20int,%20boolean,%20boolean)
  • toggle: false, extend: false. Clear the previous selection and ensure the new cell is selected.
  • toggle: false, extend: true. Extend the previous selection from the anchor to the specified cell, clearing all other selections.
  • toggle: true, extend: false. If the specified cell is selected, deselect it. If it is not selected, select it.
  • toggle: true, extend: true. Apply the selection state of the anchor to all cells between it and the specified cell.
• 変更案
  • toggle:false、extend:false。既存の選択をクリアし、新しいセルが確実に選択されるようにする。
  • toggle:false、extend:true。既存の選択をアンカーから指定のセルまで拡張して、ほかのすべての選択をクリアする。
  • toggle:true、extend:false。指定されたセルが選択されている場合、そのセルを選択解除する。選択されていない場合、そのセルを選択する。
  • toggle:true、extend:true。アンカーの選択状態を、そのアンカーと指定されたセル間のすべてのセルに適用する。

g2とg2d

• http://docs.oracle.com/javase/jp/6/api/java/awt/Graphics2D.html#setTransform(java.awt.geom.AffineTransform)
  • 一サンプルコード内で、g2とg2dが使われているので、どちらかにした方がいいかも。

// Get the current transform
AffineTransform saveAT = g2.getTransform();
// Perform transformation
g2d.transform(...);
// Render
g2d.draw(...);
// Restore original transform
g2d.setTransform(saveAT);

文字実体参照

• http://docs.oracle.com/javase/jp/6/api/java/awt/Frame.html#setIconImage(java.awt.Image)
  • ArrayList<Image> imageList = new ArrayList<Image>();
• http://docs.oracle.com/javase/7/docs/api/java/awt/Frame.html#setIconImage(java.awt.Image)
  • ArrayList&lt;Image&gt; imageList = new ArrayList&lt;Image&gt;();

preタグ内の不等号が、文字実体参照になっていないので、Imageタグになっている？

Java? 2

• http://docs.oracle.com/javase/jp/6/technotes/guides/lang/hook-design.html
  • Java^{<font size=-2>TM</font>}?2 プラットフォームのバージョン 1.2 では
• http://docs.oracle.com/javase/6/docs/technotes/guides/lang/hook-design.html
  • in version 1.2 of the Java^{<font size="-2">TM</font>} 2 Platform.

  が?に化けている？
&nbsp;などを使用するなら、トレードマークも <sup><font size="-2">TM</font></sup> ではなく、&trade; か、UTF-8なので普通に™でもよさそう。

Returns the Component's "visible rect rectangle"

• http://docs.oracle.com/javase/6/docs/api/javax/swing/JComponent.html#computeVisibleRect(java.awt.Rectangle)
  • getVisibleRect() は、"visible rect rectangle" ではなく、"visible rectangle" なので、typoかも。

注:注: 1 つの「*」で構成されるパス名は、

• http://docs.oracle.com/javase/jp/6/api/java/io/FilePermission.html
  • 一箇所、「注:注:」になっている

注:注: イベントをサブコンポーネントに転送する必要はありません。

• http://docs.oracle.com/javase/jp/6/api/javax/swing/JMenuItem.html#processMouseEvent(java.awt.event.MouseEvent,%20javax.swing.MenuElement%5B%5D,%20javax.swing.MenuSelectionManager)
• http://docs.oracle.com/javase/jp/6/api/javax/swing/JMenuItem.html#processKeyEvent(java.awt.event.KeyEvent,%20javax.swing.MenuElement%5B%5D,%20javax.swing.MenuSelectionManager)
  • 二箇所、「注:注:」になっている

パラメータ値値

• http://docs.oracle.com/javase/jp/6/api/java/sql/CallableStatement.html
  • 複数箇所で、「パラメータ値値」になっている

NOT_SUPPORTED_ERR:要求されたモードまたはスキーマ型がサポート サポートされていない場合

• http://docs.oracle.com/javase/jp/6/jre/api/plugin/dom/org/w3c/dom/ls/DOMImplementationLS.html#createLSParser(short,%20java.lang.String)
  • 一箇所、「サポート サポート」になっている

アプリケーションで値 値

• http://docs.oracle.com/javase/jp/6/jre/api/plugin/dom/org/w3c/dom/ls/DOMImplementationLS.html#createLSParser(short,%20java.lang.String)
  • 一箇所、「値 値」になっている

さまさまなビューの配置場所を探せます。

• http://docs.oracle.com/javase/jp/6/api/javax/swing/text/BoxView.html#getChildAllocation(int,%20java.awt.Shape)
  • 一箇所、「さまさま」になっている

または または

• http://docs.oracle.com/javase/jp/6/api/org/omg/CORBA/Any.html#extract_fixed()
• http://docs.oracle.com/javase/jp/6/api/org/omg/CORBA/Any.html#extract_Principal()
  • 二箇所、「または または」になっている

アサーションの有効/無効ににかかわらず、

• http://docs.oracle.com/javase/jp/6/technotes/guides/language/assert.html
  • 一箇所、「無効にに」になっている

メソッドの引数 (NVList オブジェクトのの形式)

• http://docs.oracle.com/javase/jp/6/api/org/omg/CORBA/ServerRequest.html#params(org.omg.CORBA.NVList)
  • 一箇所、「のの形式」になっている

またはトランスミッタを を提供する

• http://docs.oracle.com/javase/jp/6/api/javax/sound/midi/MidiSystem.html#getTransmitter()
  • 一箇所、「を を提供する」になっている

IllegalArgumentException を をラップする。

• http://docs.oracle.com/javase/jp/6/api/javax/management/modelmbean/RequiredModelMBean.html#invoke(java.lang.String,%20java.lang.Object%5B%5D,%20java.lang.String%5B%5D)
  • 一箇所、「を をラップする」になっている

が が配置

• が がディレクトリであるか
• が が負の値
• が が配置
• が が配置

修正済み

• そのその例外
• このこのパーサー
• シーケンスとと
• 有効なな
• たとえば、たとえば
• 場合、場合
• 印刷ししたり
• 持つかかどうか
• さまざなな場面で

コメント