17.3.3.18 noBreakHyphen

This element specifies that a non breaking hyphen character shall be placed at the current location in the run content.

The behavior of a non-breaking hyphen in run content shall be to display using the same glyph as the hyphen- minus character (U+002D), however, without that hyphen being a line breaking position (unlike the hyphen- minus character, which does allow line breaking).

[Example: Consider the following sentence in a WordprocessingML document: ‘Each citizen has a unique Social Security Number of the form “999-99-9999”, where each 9 represents a decimal digit.’ The fragment of this sentence involving the string literal might be represented in WordprocessingML, as follows:

<w:r>
  <w:t>Number of the form “999-99-9999”, where</w:t>
</w:r>

However, consider the case in which, on rendering, the right margin was such that the quoted string is broken across multiple lines with the hyphens being used as possible line breaking points; for example:.

Each citizen has a unique Social Security Number of the form “999-99-
9999”, where …

If such line breaks are undesirable, those hyphens can be marked as non-breaking, as follows:

<w:r>
  <w:t>Number of the form “999</w:t>
</w:r>
<w:r>
  <w:noBreakHyphen />
  <w:t>99</w:t>
</w:r>
<w:r>
  <w:noBreakHyphen />
  <w:t>9999”, where</w:t>
</w:r>

in which case, for the same margin settings, the rendered result might be like the following:

Each citizen has a unique Social Security Number of the form
“999-99-9999”, where …

end example]

[Note: The W3C XML Schema definition of this element’s content model (CT_Empty) is located in A.1. end note]