From 3fc4c4a17697023613036c2ad3a31bfcf9eb374a Mon Sep 17 00:00:00 2001 From: deyan Date: Thu, 7 Nov 2024 17:35:59 -0500 Subject: [PATCH] minor proofreading edits; extra example --- src/intent.html | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/src/intent.html b/src/intent.html index 6d9fefe..0c40733 100644 --- a/src/intent.html +++ b/src/intent.html @@ -104,7 +104,7 @@

The Grammar for intentreference
- An argument [=reference=] such as $name refers to a descendent element + An argument [=reference=] such as $name refers to a descendant element that has an attribute arg="name". Unlike id attributes, arg do not have to be unique within a document. When searching for a matching element the @@ -305,7 +305,7 @@

Intent Properties

Using Intent Concepts and Properties

When the intent attribute corresponding to a specific node - contains a concept component, the AT's [=Intent Concept Dictionary=] should be consulted. + contains a concept component, the supported [=Intent Concept Dictionary=] should be consulted. The concept name should be normalized (`_` (U+00F5) and `.` (U+002E) to `-` (U+002D)), and compared using ASCII case-insensitive @@ -317,7 +317,7 @@

Using Intent Concepts and Properties

when the normalized name, the fixity property, and the arity all match an entry in the AT's concept dictionary. The speech hint in the matching entry - can be used be used as a guide for the generation of + can be used as a guide for the generation of specific audio, replacement text or braille renderings, as appropriate. It can also help clarify argument order. However, because common notations have many specialized ways of being spoken, the AT @@ -338,8 +338,8 @@

Using Intent Concepts and Properties

Even for an unsupported concept, if a fixity property and arguments were given, the speech for the arguments should be composed in a manner consistent with the given fixity property, if possible.

-

Note that future updates of the AT and its [=Intent Concept Dictionary=] may - add or remove concepts. Hence which concepts are supported may change with each update.

+

Note that future updates of an AT may add or remove concepts in its [=Intent Concept Dictionary=]. + Hence which concepts are supported may change with each update.

In cases where the intent contains neither an explicit nor inferrable concept the AT should generally read out the MathML in a literal or structural fashion, @@ -355,7 +355,7 @@

Using Intent Concepts and Properties

might read the table in a style more appropriate for a list of equations. In both cases the navigation of the underlying table structure can be supplied by the AT system, as it would for an - un-annotated table.

+ unannotated table.

In general, depending upon the reader, AT may add words or sounds to make the speech clearer to the listener. For example, for someone @@ -383,13 +383,13 @@

Intent Error Recovery

then the processor should act as if the attribute were not present. Typically this will result in a suitable fallback text being - generated from the MathML element and its descendents. Note that + generated from the MathML element and its descendants. Note that just the erroneous attribute is ignored, other intent attributes in the MathML expression should be used.
  • If a `reference` such as `$x` does not correspond to an arg attribute with value `x` on a - descendent element, the processor should act as if the reference + descendant element, the processor should act as if the reference were replaced by the literal `_dollar_x`.
  • @@ -526,6 +526,7 @@

    Intent Examples

    <mo arg="script">′</mo> </msup> +
    x prime
    x superscript prime end superscript

    An overbar may represent complex conjugation, or mean (average), again with possible readings with and without intent: