I committed this patch to fix some API doc links in java.awt.Font:
2005-06-29 David Gilbert <[EMAIL PROTECTED]>
* java/awt/Font.java: fixed API doc links.
Regards,
Dave Gilbert
Index: java/awt/Font.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/awt/Font.java,v
retrieving revision 1.25
diff -u -r1.25 Font.java
--- java/awt/Font.java 8 Mar 2005 08:15:34 -0000 1.25
+++ java/awt/Font.java 29 Jun 2005 07:24:02 -0000
@@ -44,6 +44,7 @@
import java.awt.font.FontRenderContext;
import java.awt.font.GlyphVector;
import java.awt.font.LineMetrics;
+import java.awt.font.TextLayout;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.peer.FontPeer;
@@ -377,8 +378,8 @@
*
* @return The logical name of the font.
*
- * @see getFamily()
- * @see getFontName()
+ * @see #getFamily()
+ * @see #getFontName()
*/
public String getName ()
{
@@ -453,9 +454,9 @@
*
* @since 1.2
*
- * @see getName()
- * @see getFontName()
- * @see GraphicsEnvironment.getAvailableFontFamilyNames()
+ * @see #getName()
+ * @see #getFontName()
+ * @see GraphicsEnvironment#getAvailableFontFamilyNames()
*/
public String getFamily ()
{
@@ -464,13 +465,13 @@
/**
* Returns integer code representing the sum of style flags of this font, a
- * combination of either [EMAIL PROTECTED] PLAIN}, [EMAIL PROTECTED] BOLD},
or [EMAIL PROTECTED] ITALIC}.
+ * combination of either [EMAIL PROTECTED] #PLAIN}, [EMAIL PROTECTED] #BOLD},
or [EMAIL PROTECTED] #ITALIC}.
*
* @return code representing the style of this font.
*
- * @see isPlain()
- * @see isBold()
- * @see isItalic()
+ * @see #isPlain()
+ * @see #isBold()
+ * @see #isItalic()
*/
public int getStyle ()
{
@@ -555,13 +556,13 @@
}
/**
- * Creates a new font with point size 1 and [EMAIL PROTECTED] PLAIN} style,
+ * Creates a new font with point size 1 and [EMAIL PROTECTED] #PLAIN} style,
* reading font data from the provided input stream. The resulting font
* can have further fonts derived from it using its
* <code>deriveFont</code> method.
*
* @param fontFormat Integer code indicating the format the font data is
- * in.Currently this can only be [EMAIL PROTECTED] TRUETYPE_FONT}.
+ * in.Currently this can only be [EMAIL PROTECTED] #TRUETYPE_FONT}.
* @param is [EMAIL PROTECTED] InputStream} from which font data will be
read. This
* stream is not closed after font data is extracted.
*
@@ -594,7 +595,7 @@
* @return A new [EMAIL PROTECTED] GlyphVector} containing glyphs mapped from
str,
* through the font's cmap table.
*
- * @see layoutGlyphVector()
+ * @see #layoutGlyphVector(FontRenderContext, char[], int, int, int)
*/
public GlyphVector createGlyphVector (FontRenderContext ctx, String str)
{
@@ -614,7 +615,7 @@
* @return A new [EMAIL PROTECTED] GlyphVector} containing glyphs mapped from
str,
* through the font's cmap table.
*
- * @see layoutGlyphVector()
+ * @see #layoutGlyphVector(FontRenderContext, char[], int, int, int)
*/
public GlyphVector createGlyphVector (FontRenderContext ctx,
CharacterIterator i)
{
@@ -634,7 +635,7 @@
* @return A new [EMAIL PROTECTED] GlyphVector} containing glyphs mapped from
str,
* through the font's cmap table.
*
- * @see layoutGlyphVector()
+ * @see #layoutGlyphVector(FontRenderContext, char[], int, int, int)
*/
public GlyphVector createGlyphVector (FontRenderContext ctx, char[] chars)
{
@@ -652,7 +653,7 @@
* @return A new [EMAIL PROTECTED] GlyphVector} containing glyphs mapped from
str,
* through the font's cmap table.
*
- * @see layoutGlyphVector()
+ * @see #layoutGlyphVector(FontRenderContext, char[], int, int, int)
*
* @specnote This method is documented to perform character-to-glyph
* conversions, in the Sun documentation, but its second parameter name is
@@ -776,7 +777,7 @@
*
* @return A map of chracter attributes which this font currently has set.
*
- * @see getAvailableAttributes()
+ * @see #getAvailableAttributes()
* @see java.text.AttributedCharacterIterator.Attribute
* @see java.awt.font.TextAttribute
*/
@@ -790,7 +791,7 @@
*
* @return An array of chracter attribute keys which this font understands.
*
- * @see getAttributes()
+ * @see #getAttributes()
* @see java.text.AttributedCharacterIterator.Attribute
* @see java.awt.font.TextAttribute
*/
@@ -800,8 +801,8 @@
}
/**
- * Returns a baseline code (one of [EMAIL PROTECTED] ROMAN_BASELINE}, [EMAIL
PROTECTED]
- * CENTER_BASELINE} or [EMAIL PROTECTED] HANGING_BASELINE}) indicating which
baseline
+ * Returns a baseline code (one of [EMAIL PROTECTED] #ROMAN_BASELINE}, [EMAIL
PROTECTED]
+ * #CENTER_BASELINE} or [EMAIL PROTECTED] #HANGING_BASELINE}) indicating
which baseline
* this font will measure baseline offsets for, when presenting glyph
* metrics for a given character.
*
@@ -818,7 +819,7 @@
*
* @since 1.2
*
- * @see LineMetrics.getBaselineOffsets()
+ * @see LineMetrics#getBaselineOffsets()
*/
public byte getBaselineFor (char c)
{
@@ -838,9 +839,9 @@
*
* @since 1.2
*
- * @see getName()
- * @see getFontName()
- * @see GraphicsEnvironment.getAvailableFontFamilyNames()
+ * @see #getName()
+ * @see #getFontName()
+ * @see GraphicsEnvironment#getAvailableFontFamilyNames()
* @see Locale
*/
public String getFamily (Locale lc)
@@ -857,7 +858,7 @@
*
* @since 1.2
*
- * @see TextAttribure
+ * @see java.awt.font.TextAttribute
*/
public static Font getFont (Map attributes)
{
@@ -874,8 +875,8 @@
*
* @since 1.2
*
- * @see getName()
- * @see getFamily()
+ * @see #getName()
+ * @see #getFamily()
*/
public String getFontName ()
{
@@ -894,8 +895,8 @@
*
* @since 1.2
*
- * @see getName()
- * @see getFamily()
+ * @see #getName()
+ * @see #getFamily()
*/
public String getFontName (Locale lc)
{
@@ -904,12 +905,12 @@
/**
* Returns the italic angle of this font, a measurement of its slant when
- * style is [EMAIL PROTECTED] ITALIC}. The precise meaning is the inverse
slope of a
+ * style is [EMAIL PROTECTED] #ITALIC}. The precise meaning is the inverse
slope of a
* caret line which "best measures" the font's italic posture.
*
* @return The italic angle.
*
- * @see TextAttribute.POSTURE
+ * @see java.awt.font.TextAttribute#POSTURE
*/
public float getItalicAngle ()
{
@@ -1028,9 +1029,9 @@
*
* @since 1.2
*
- * @see getName()
- * @see getFamily()
- * @see getFontName()
+ * @see #getName()
+ * @see #getFamily()
+ * @see #getFontName()
*/
public String getPSName ()
{
@@ -1042,7 +1043,7 @@
* font in the specified [EMAIL PROTECTED] FontRenderContext}. This box will
include the
* glyph origin, ascent, advance, height, and leading, but may not include all
* diacritics or accents. To get the complete visual bounding box of all the
- * glyphs in a run of text, use the [EMAIL PROTECTED] TextLayout#getBounds}
method of
+ * glyphs in a run of text, use the [EMAIL PROTECTED] TextLayout#getBounds}
method of
* [EMAIL PROTECTED] TextLayout}.
*
* @param str The string to measure.
@@ -1050,7 +1051,7 @@
*
* @return A bounding box covering the logical bounds of the specified text.
*
- * @see createGlyphVector()
+ * @see #createGlyphVector(FontRenderContext, String)
*/
public Rectangle2D getStringBounds (String str, FontRenderContext frc)
{
@@ -1077,7 +1078,7 @@
*
* @since 1.2
*
- * @see createGlyphVector()
+ * @see #createGlyphVector(FontRenderContext, String)
*/
public Rectangle2D getStringBounds (String str, int begin,
int limit, FontRenderContext frc)
@@ -1105,7 +1106,7 @@
*
* @since 1.2
*
- * @see createGlyphVector()
+ * @see #createGlyphVector(FontRenderContext, CharacterIterator)
*/
public Rectangle2D getStringBounds (CharacterIterator ci, int begin,
int limit, FontRenderContext frc)
@@ -1133,7 +1134,7 @@
*
* @since 1.2
*
- * @see createGlyphVector()
+ * @see #createGlyphVector(FontRenderContext, char[])
*/
public Rectangle2D getStringBounds (char[] chars, int begin,
int limit, FontRenderContext frc)
@@ -1163,7 +1164,7 @@
* @return Whether this font has uniform line metrics.
*
* @see LineMetrics
- * @see getLineMetrics()
+ * @see #getLineMetrics(String, FontRenderContext)
*/
public boolean hasUniformLineMetrics ()
{
@@ -1189,12 +1190,12 @@
*
* Bidirectional (bidi) layout is not performed in this method; text
* should have its bidi direction specified with one of the flags [EMAIL
PROTECTED]
- * LAYOUT_LEFT_TO_RIGHT} or [EMAIL PROTECTED] LAYOUT_RIGHT_TO_LEFT}.
+ * #LAYOUT_LEFT_TO_RIGHT} or [EMAIL PROTECTED] #LAYOUT_RIGHT_TO_LEFT}.
*
* Some types of layout (notably Arabic glyph shaping) may examine context
* characters beyond the bounds of the indicated range, in order to select
- * an appropriate shape. The flags [EMAIL PROTECTED] LAYOUT_NO_START_CONTEXT}
and
- * [EMAIL PROTECTED] LAYOUT_NO_LIMIT_CONTEXT} can be provided to prevent
these extra
+ * an appropriate shape. The flags [EMAIL PROTECTED]
#LAYOUT_NO_START_CONTEXT} and
+ * [EMAIL PROTECTED] #LAYOUT_NO_LIMIT_CONTEXT} can be provided to prevent
these extra
* context areas from being examined, for instance if they contain invalid
* characters.
*
_______________________________________________
Classpath-patches mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/classpath-patches
