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

TITLE:Typo、変換ミス - Javadoc
Posted by at 2010-10-05
  • title: Typo、変換ミス author: aterai pubdate: 2010-10-05 description: Java クラスドキュメント日本語版の誤字、変換ミス、表記の揺れなど。

概要

Java(Swing)のクラスドキュメントで、日本語版の誤字、変換ミス、表記の揺れなどをメモしています。

Typo、変換ミス

未修正

オン\/オフ

JtextComponent

 小文字のtextになっている。

翻訳されていない

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

余計な括弧

同一文章が二回出現

デフォルトでは…が二回

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

カッコの後に* ではなく、* 差が良さそう。 カッコの後に* ではなく、* 差が良さそう。ついでに「ウエイト」はここだけで、他は「ウェイト」が多いみたい。

SimpleDateFormat getNativeImageMetadataFormat から 午前/午後

 何かの変換ミスか？

JFileCHooser.ERROR_OPTION

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

HyperLinkListener

HyperlinkのLが大文字になっている。 英語版、日本語版ともにHyperlinkのLが大文字になっている。

<code>, <i>

g2とg2d

  • Graphics2D#setTransform(AffineTransform)
    • サンプルコード内でg2とg2dが使用されている 
      #spanend
#spanadd
// Get the current transform
#spanend
#spanadd
AffineTransform saveAT = g2.getTransform();
#spanend
#spanadd
// Perform transformation
#spanend
#spanadd
g2d.transform(...);
#spanend
#spanadd
// Render
#spanend
#spanadd
g2d.draw(...);
#spanend
#spanadd
// Restore original transform
#spanend
#spanadd
g2d.setTransform(saveAT);
#spanend
#spanadd

Returns the Component's "visible rect rectangle"

限定されてます。
  • ObjectView
    • 限定されてます。
  • 変更案
    • 自然対数の底 <i>e</i> にもっとも近い <code>double</code> 値です。
    • 限定されています。

パージョン

Hashtable 指定された TreeNode

1.8.0で修正済み

デーモンスレッドになます。
  • Thread
    • デーモンスレッドになます。
  • 修正案
    • デーモンスレッドになります。

句点の位置
  • Runtime#freeMemory()
    • Java仮想マシン内の空きメモリーの量を返します。gcメソッドを呼び出すと、freeMemory.から返される値が増える可能性があります
  • Runtime#freeMemory()
    • Returns the amount of free memory in the Java Virtual Machine. Calling the gc method may result in increasing the value returned by freeMemory.

余計な括弧
  • UIManager
    • このため、一般に、ある Look & Feel が提供する ComponentUI) は、別の Look & Feel では動作しません。
  • UIManager
    • so that in general a ComponentUI provided by one look and feel will not work with another look and feel.
  • 変更案
    • 指定された TreeNode をルートに持ち、ルートノードを表示する JTree を返します。
    • このため、一般に、ある Look & Feel が提供する ComponentUI は、別の Look & Feel では動作しません。
多分直前の、public JTree(Hashtable<?,?> value) から、コピペミス。

1.7.0 で修正済み

行わないためでです。

書き込む。FileHandler を初期化してます。
  • FileHandler#FileHandler(...)
    • オプションの追加モードで、指定されたファイル名を書き込む。FileHandler を初期化してます。

奨励されてます。

 直前は、「奨励されています。」になっている。

注 -
  • Container
    • 注 -フォーカスサブシステムの詳細については
  • Container#setComponentZOrder(...)
    • 注 -removeNotify
  • 変更案
    • 注: フォーカスサブシステムの詳細については
    • 注: removeNotify

これはこのメソッドの戻り値です。
  • JComponent#getVisibleRect()
    • これはこのメソッドの戻り値です。 Component の「可視矩形」を返します。 これは、このコンポーネントの可視矩形、new Rectangle(0, 0, getWidth(), getHeight())、およびそのすべての上位オブジェクトの可視矩形の共通部分です。
  • JComponent#getVisibleRect()
    • Returns the Component's "visible rectangle" - the intersection of this component's visible rectangle, new Rectangle(0, 0, getWidth(), getHeight()), and all of its ancestors' visible rectangles.
  • 変更案
    • Component の「可視矩形」を返します。 これは、このコンポーネントの可視矩形、new Rectangle(0, 0, getWidth(), getHeight())、およびそのすべての上位オブジェクトの可視矩形の共通部分です。

リンクとカギ括弧
  • pack200 - JAR パックツール
    • <li><a href="../index.html#jar">「<code>jar</code></a> - Java Archive ツール」</li>
  • 変更案
    • <li>「<a href="../index.html#jar"><code>jar</code></a> - Java Archive ツール」</li>
カギ括弧自体削除してもいいかもしれない。英語版には存在しないし。

句点が二度出現
  • JTextComponent#setMargin(Insets)
    • Border オブジェクトが適切なマージン空白を作成します。 (それ以外の場合、このプロパティーは事実上無視される)。
  • 変更案
    • Border オブジェクトが適切なマージン空白を作成します(それ以外の場合、このプロパティーは事実上無視される)。

同一文章が二回出現

SimpleDateFormat getNativeImageMetadataFormat から 午前/午後

 何かの変換ミスか？

括弧の対応

code タグの対応

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

AbstractList#modCount

@code

  • DefaultListSelectionModel
    • どちらのインデックスも @code -1} でなく、
      • DefaultListSelectionModel.html 内に三箇所あり
  • 修正案
    • <code>add(int, E)</code> または <code>remove(int)</code> に対する 1 回の呼び出しでは、フィールドに 1 だけ加える必要があります。
  • AbstractList#modCount
    • @code add(int, E)} または remove(int) に対する 1 回の呼び出しでは、フィールドに 1 だけ加える必要があります。

Fild

句点がない

  • 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指定されたセルが選択されている場合、そのセルを選択解除する。選択されていない場合、そのセルを選択する
  • JTable#changeSelection(...)
    • 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.
  • JTable#changeSelection(...)
    • 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

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

文字実体参照

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

<code>, <i>
  • Math.E
    • 自然対数の底 <code>e</code> にもっとも近い <i>double</i> 値です。
  • Math.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> 値です。

Hashtable 指定された TreeNode
  • JTree#JTree(TreeNode)
    • Hashtable 指定された TreeNode をルートに持つ、ルートノードを表示する JTree を返します。
  • JTree#JTree(TreeNode)
    • Returns a JTree with the specified TreeNode as its root, which displays the root node.
  • 変更案
    • 指定された TreeNode をルートに持ち、ルートノードを表示する JTree を返します。
多分直前の、public JTree(Hashtable<?,?> value) から、コピペミス。

Java? 2

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

Returns the Component's "visible rect rectangle"

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

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

パラメータ値値

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

アプリケーションで値 値

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

または または

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

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

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

IllegalArgumentException を をラップする。

が が配置

  • - 修正済み

1.7.0 ではページが存在しない？

Fild

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

アプリケーションで値 値

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

コメント

コメント