Since properties "left", "leftChars", "right", "rightChars" are affected by paragraph direction, their names are misleading.
Rename these properties respectively to "lead", "leadChars", "trail", "trailChars".
ind (Paragraph Indentation), page 78-80
Section 2.3.1.12
te
Proposed Disposition of DIS 29500 Comment IL-0025 (Modified: 2008-01-10) Agreed; the current attribute names imply an inappropriate directionality bias. Accordingly, we will remove them from their current location in the specification (Part 4, §2.3.1.12, pages 7880), and place them into a new annex for deprecated features. Following the precedent set by other ISO standards (such as SQL’s ISO 9075:2003 Part 1 and C++’s ISO/IEC 14882:1998), we will make use of a new Annex that contains normative descriptions of all deprecated features. The intent of this Annex is to enable a transitional period during which existing binary documents being migrated to DIS 29500 can make use of those deprecated features to preserve their fidelity, while noting that new documents should not use them. Accordingly, the Conformance clause will also be changed to state that newly created documents (those not created by migrating existing binary documents) should not use deprecated features. All deprecated features will be removed from their current locations in the standard, but will be fully defined in this new Annex. New direction-neutral attributes will replace them as follows: left start leftChars startChars right end rightChars endChars The following changes will be made to Part 4, §2.3.1.12, pages 7880: Attributes Description left start ( Left Start Indentation) Specifies the indentation which shall be placed at the start of this paragraph between the left text margin for this paragraph and the left edge of that paragraph’s content in a left to right paragraph, and the right text margin and the right edge of that paragraph’s text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the inside page edge - the right page edge for odd numbered pages and the left page edge for even numbered pages. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. This value may be superseded for the first line only Attributes Description via use of the firstLine or hanging attributes. As well, if the leftChars startChars attribute is specified, then this value is ignored. [Example: Consider the following WordprocessingML fragment: <w:pPr> <w:ind w: left start ="720" w: right end ="2880" /> </w:pPr> This set of paragraph indentations specifies that this paragraph's text should be indented 720 twentieths of a point (one half inch) from the left text margin in this document, assuming this is a left to right paragraph. end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). left start Chars ( Left Start Indentation in Character Units) Specifies the indentation which shall be placed at the start of this paragraph between the left text margin for this paragraph and the left edge of that paragraph’s content in a left to right paragraph, and the right text margin and the right edge of that paragraph’s text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the inside page edge - the right page edge for odd numbered pages and the left page edge for even numbered pages. This value is specified in hundredths of a character unit. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. This value may be superseded for the first line only via use of the firstLine or hanging attributes. As well, if the left start attribute is specified, then its value is ignored, and is superseded by this value. [Example: Consider the following WordprocessingML fragment: <w:pPr> <w:ind w: left start Chars="250" /> </w:pPr> This set of paragraph indentations specifies that this paragraph's text should be indented two and a half character units from the left text margin in this document. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). right end Specifies the indentation which shall be placed at the end of this paragraph Attributes Description (Right End Indentation) between the right text margin for this paragraph and the right edge of that paragraph’s content in a left to right paragraph, and the left text margin and the left edge of that paragraph’s text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the outside page edge - the left page edge for odd numbered pages and the right page edge for even numbered pages. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. As well, if the right end Chars attribute is specified, then this value is ignored. [Example: Consider the following WordprocessingML fragment: <w:pPr> <w:ind w: left start ="720" w: right end ="-1440" /> </w:pPr> This set of paragraph indentations specifies that this paragraph's text should be indented 1440 twentieths of a point (one inch) into the right text margin in this document, assuming this is a left to right paragraph. end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). right end Chars ( Right End Indentation in Character Units) Specifies the indentation which shall be placed at the end of this paragraph between the right text margin for this paragraph and the right edge of that paragraph’s content in a left to right paragraph, and the left text margin and the left edge of that paragraph’s text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the outside page edge - the left page edge for odd numbered pages and the right page edge for even numbered pages. This value is specified in hundredths of a character unit. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the right text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. As well, if the right end attribute is specified, then its value is ignored, and is superseded by this value. [Example: Consider the following WordprocessingML fragment: <w:pPr> Attributes Description <w:ind w: right end Chars="250" /> </w:pPr> This set of paragraph indentations specifies that this paragraph's text should be indented two and a half character units from the right text margin in this document, assuming this is a left to right paragraph. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16).
