From f160353ae4e0e5682b0e593eab135c7a0589342f Mon Sep 17 00:00:00 2001 From: Sam Whited Date: Mon, 5 Apr 2021 07:48:46 -0400 Subject: [PATCH] XEP-0393: further changes for clarity when reading --- xep-0393.xml | 48 ++++++++++++++++++++++++++++-------------------- 1 file changed, 28 insertions(+), 20 deletions(-) diff --git a/xep-0393.xml b/xep-0393.xml index fdc06fa5..5883009b 100644 --- a/xep-0393.xml +++ b/xep-0393.xml @@ -26,6 +26,19 @@ styling &sam; + + 1.1.1 + 2021-04-04 + ssw + +

+ General readability changes: + Copy part of span definition from glossary to business rules and remove + parenthesis for marking spans and blocks which was used inconsistently. + Also merge two lists of examples. +

+ + 1.1.0 2021-01-12 @@ -257,17 +270,7 @@ A group of text that may be rendered inline alongside other spans. Spans may be either plain text with no formatting applied, or may be formatted text that is enclosed by two styling directives. - Spans are always children of blocks and may not escape from their - containing block. Some spans may contain child spans. - The following all contain spans marked by parenthesis: -
    -
  • (plain span)
    • -
  • (*strong span*)
    • -
  • (_emphasized span_)
    • -
  • (_emphasized span containing (*strong span*)_)
    • -
  • (span one )(*span two*)
    • -
@@ -321,9 +324,9 @@

- (There are three blocks in this body marked by parens,) - (but there is no *formatting) - (as spans* may not escape blocks.) + There are three blocks in this body, one per line, + but there is no *formatting + as spans* may not escape blocks. ]]> @@ -386,11 +389,13 @@

+ Spans are always the children of blocks and may not escape from their + containing block. Matches of spans between two styling directives MUST contain some text - between the two styling directives, otherwise neither directive is valid. + between the two directives, otherwise neither directive is valid. The opening styling directive MUST be located at the beginning of the - line, after a whitespace character, or after a different opening styling - directive. + parent block, after a whitespace character, or after a different opening + styling directive. The opening styling directive MUST NOT be followed by a whitespace character and the closing styling directive MUST NOT be preceeded by a whitespace character. @@ -404,9 +409,10 @@ For example, each of the following would be styled as indicated:

    -
  • *strong*
    • -
  • plain *strong* plain
    • -
  • *strong* plain *strong*
    • +
  • plain span
    • +
  • *strong span*
    • +
  • plain _emphasis_ plain
    • +
  • `pre` plain *strong*
  • *strong*plain*
  • * plain *strong*
@@ -427,10 +433,12 @@

Any text inside of a block that is not part of another span is implicitly considered to be inside of a "plain text" span. + In the following example the plain span is everything before the first + "*".

- (Two spans, both )(*alike in dignity*) + Two spans, both *alike in dignity* ]]>