The docs for java.awt.font.TextAttribute.TRANSFORM describe the behavior of text with this attribute in a way inconsistent with past and current implementations. They claim that the advance of the character is the projection of the character along the baseline, and that this does not affect subsequent characters. Formerly, the text was drawn with a rotated baseline, and then the end point was projected back onto the baseline when the run ended. This produced inconsistent behavior when the run was broken for other reasons-- a change in bidi directionality, a font change, or a color change, for example. This has been fixed for Java 6-- now the baseline is rotated uniformly regardless of other changes, and the text continues from the end point rather than dropping back to the original unrotated baseline. The docs were not changed to reflect this fix, however. They should be changed to describe the current, consistent behavior.