Skip to content

Commit ab18ecf

Browse files
committed
Clarified case where intent has no arguments (especially token case); removed stub section on inference
1 parent f3f9fec commit ab18ecf

File tree

1 file changed

+7
-29
lines changed

1 file changed

+7
-29
lines changed

src/intent.html

+7-29
Original file line numberDiff line numberDiff line change
@@ -294,16 +294,15 @@ <h3 id="mixing_intent_properties">Intent Properties</h3>
294294
<section>
295295
<h3 id="intent_using">Using Intent Concepts and Properties</h3>
296296
<p>When the <code class="attribute">intent</code> attribute corresponding to a specific node
297-
contains a concept component, possibly with properties and arguments,
298-
the AT's [=Intent Concept Dictionary=] should be consulted.
297+
contains a concept component, the AT's [=Intent Concept Dictionary=] should be consulted.
299298
The concept name should be normalized
300299
(<q>`_`</q> (U+00F5) and <q>`.`</q> (U+002E) to <q>`-`</q> (U+002D)),
301300
and compared using <a data-cite="INFRA#ascii-case-insensitive">ASCII case-insensitive</a>
302-
match.</p>
301+
match. If arguments were given explicitly in the <code class="attribute">intent</code>
302+
then their number gives the arity, and the fixity is determined from an explicit property
303+
or may default from the concept dictionary. Otherwise, arity is assumed to be 0.</p>
303304
<p>An concept is considered a <dfn id="intent_known_concept">known concept</dfn> (to the AT)
304-
when the normalized name,
305-
the fixity property (which may be defaulted in the concept dictionary),
306-
and the arity (number of arguments, if any)
305+
when the normalized name, the fixity property, and the arity
307306
all match an entry in the AT's concept dictionary.
308307
The speech hint in the matching entry
309308
can be used be used as a guide for the generation of
@@ -323,14 +322,14 @@ <h3 id="intent_using">Using Intent Concepts and Properties</h3>
323322
<dfn id="intent_unknown_concept">unknown concept</dfn> (to the AT)
324323
and will be treated the same as a [=literal=];
325324
that is, the name is spoken as-is after normalizing each of `-`, `_` and `.` to an inter-word space.
326-
Even for an unknown concept, if a fixity property and arguments were given (or inferred),
325+
Even for an unknown concept, if a fixity property and arguments were given,
327326
the speech for the arguments should be composed
328327
in a manner consistent with the given fixity property, if possible.</p>
329328
<p>Note that future updates of the AT and [=Intent Concept Dictionary=] may
330329
include additional concepts, at which time those concepts may also receive special treatment.</p>
331330

332331
<p>In cases where the intent contains neither an explicit nor inferrable concept
333-
the AT should generally read out the MathML in a literal or structural fashion (examples?).
332+
the AT should generally read out the MathML in a literal or structural fashion.
334333
However, any given [=properties=] should be respected if possible,
335334
and may be useful to indicate the kind of mathematical object,
336335
rather than giving an explicit [=concept=] name to be spoken.
@@ -352,27 +351,6 @@ <h3 id="intent_using">Using Intent Concepts and Properties</h3>
352351
these extra words might be a distraction. AT should always
353352
produce speech that is appropriate to the community they serve.</p>
354353
</section>
355-
356-
<section>
357-
<h3 id="mixing_intent_errors">Intent Inference</h3>
358-
<p><em>Not yet spec language: NEEDS CLARIFICATION: </em></p>
359-
<p>Some clarification is probably needed concerning cases where the intent
360-
is not fully specified, or where it is missing completely.</p>
361-
<ul>
362-
<li>For example, the shorthand form:
363-
<pre>
364-
&lt;mrow&gt;&lt;mi&gt;x&lt;/mi&gt;&lt;mo intent="plus"&gt;foo&lt;/mo&gt;&lt;mi&gt;y&lt;/mi&gt;&lt;/mrow&gt;
365-
</pre>
366-
could be rewritten to be
367-
<pre>
368-
&lt;mrow intent="plus:infix($x,$y)"&gt;&lt;mi arg="x"&gt;x&lt;/mi&gt;&lt;mo&gt;foo&lt;/mo&gt;&lt;mi arg="y"&gt;y&lt;/mi&gt;&lt;/mrow&gt;
369-
</pre>
370-
</li>
371-
<li>A system may be capable, in certain contexts, of infering that
372-
<pre>&lt;msup&gt;&lt;mi&gt;x&lt;/mi&gt;&lt;mn&gt;2&lt;/mn&gt;&lt;/msup&gt;</pre>
373-
actually should be a power. (It could be overridden with an explicit <code>:literal</code>)
374-
</li>
375-
</section>
376354

377355
<section>
378356
<h3 id="mixing_intent_errors">Intent Error Handling</h3>

0 commit comments

Comments
 (0)