CSS3 Text: writing-mode & direction - editorial

This should be interpreted as red pen marks in the margin.
Unfortunately, one can't quite get that effect with email...

CSS3 Text, Section 3.1
http://www.w3.org/TR/2003/WD-css3-text-20030226/#text-layout

# The 'direction' property >may< still be used ...

"may" -> "can"


# The glyph orientation determines the orientation of the
# rendered visual shape of characters relative to the inline-
# -progression.

They glyph orientation *is* the orientation of the rendered
visual shapes--it cannot determine it.


# Within a line, the adjustment to the current text position
# is based on...

What do you mean by "adjustment to the current text position"?
What's the "current text position"?


# Bidirectionality introduces another level of complexity in
# text layout, as in many combinations of 'writing-mode' and
# glyph orientation values, the proper directionality and
# ordering of text are determined the Unicode Standard
# ([UNICODE] bidirectional algorithm.

Run-on sentence.


# Furthermore, >using< the 'unicode-bidi' property, the >user
# agent< can influence the bidirectional algorithm...

"using" -> "by using" or "with"

Does the user agent influence the bidi algorithm or does
the stylesheet /author/ do that?


# Note: The Unicode Standard ([UNICODE], section 3.12)
# defines a bidirectional algorithm >determining< the
# >directionality< for bidirectional text.

"determining" -> "that determines" or "for determining"

determining the directionality of what?


# Note: HTML 4.01 does not cover the more general case
# described by the 'writing-mode' property.

What general case?

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

CSS3 Text, Section 3.2
http://www.w3.org/TR/2003/WD-css3-text-20030226/#Progression

# The 'writing-mode' property specifies whether the
# inline-progression >shall be< left-to-right, right-to-left,
# or top-to-bottom.

"shall be" -> "is" (present tense)

Also, 'writing-mode' sets both the inline-progression *and*
the block-progression, so this sentence is a bit misleading.


# some or all of the content within a given element might
# advance in the opposite direction because of the Unicode
# [UNICODE] bidirectional algorithm or because of >explicit
# text advance overrides due to this property or 'direction'
# and 'unicode-bidi'.<

Specify that the override properties you're talking about
are on the element's children, not the element itself.


# >In such contexts<, the values 'lr-tb', 'lr', 'rl-tb',
# 'rl' >correspond to< horizontal flow orientations, and the
# others 'tb-rl', 'tb', 'tb-lr', 'bt-rl', 'bt-lr' >correspond
# to< vertical flow orientations.

What contexts?

"correspond to" -> "result in" ?


# >For< horizontal flow orientations, the top and bottom
# margins can be collapsed. >For< vertical flow orientations,
# the left and right margin can be collapsed. See
# "Collapsing margins" in the CSS3 Box module [forthcoming]
# for the details of collapsing margins.

"For" -> "In"

Also, this paragraph needn't be so specific. Just mention
that it affects margin collapse and refer to CSS3 Box. You
can then incorporate it into the next paragraph.


# This property also >specifies< the direction of table
# column layout, the direction of the overflow when
# determined by the inline-progression (such as the
# 'start' and 'end' value of the 'text-align' property),
# the initial alignment of text and the position of an
# incomplete last line in a block in case of 'text-align:
# justify'.

"specifies" -> "affects"

Also, this list should be given as examples, not a definitive
enumeration.


# and the 'glyph orientation' is 'auto', '90deg (or
# equivalent), or >-90eg< (or equivalent)

"-90eg" -> "-90deg"


# In the following example, two blocks elements (1 and 3)
# separated by an image (2) are presented in various >text
# layout<.

I don't think "text layout" is the word you're looking for.
"In various flow orientations" might be more like it.

Also, "layout" should've been plural.


# the Latin string should be enclosed >within< a span element

"within" -> "in"


Under 'direction':
    # ... it specifies the direction of table column layout,
    # the direction of the overflow when determined by the
    # inline-progression (such as the 'start' and 'end'
    # values of the 'text-align' property), the initial
    # alignment of text and the position of an incomplete last
    # line in a block in case of 'text-align: justify'.
    #
    # For the 'writing-mode' property to have any effect on
    # inline-level elements, the 'unicode-bidi' property's
    # value must be 'embed' or 'bidi-override' and, in
    # addition, one of the following conditions must be met:
    #
    #  * the flow is vertical and the 'glyph orientation' is
    #    'auto', '90deg (or equivalent), or -90eg (or equivalent)
    #  * the flow is horizontal and the 'glyph orientation' is
    #    '0deg (or equivalent), or 180deg (or equivalent).

Why is this text repeated verbatim? You can just refer to the
'writing-mode' property.


~fantasai

Received on Sunday, 2 March 2003 14:01:29 UTC