[x3d-public] getting contradictory advice on description attribute for StringSensor, X3D-Edit

[Don Brutzman]

Thanks for reporting this inconsistency.

Currently there is no description field for StringSensor in the specification.
http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/keyboard.html#StringSensor

There is a Mantis issue that is unresolved by the X3D Working Group:

0000667: 7.3.7 - Need description field for all X3DSensorNode
http://www.web3d.org/member-only/mantis/view.php?id=667
=============================================================
Comment on 19775-1: Abstract X3D Definitions - V3.3
7.3.7 X3DSensorNode
http://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/core.html#X3DSensorNode

All sensor nodes ought to have a description field of type SFString so that an author can communicate the intended condition being sensed, and players can note to users when such conditions are needed (or when they occur).

Currently only some Sensor nodes have the description field, and where it does exist it is quite helpful.

This change will add a field to the signature of about a dozen nodes. For software implementers, this change is not difficult.
=============================================================

The X3D DTD and Schema are currently correct in identifying the error you posted.

The X3D Schematron is overzealous and should not have suggested adding it - you might have an old version.  Updated, also added KeySensor checks.

Hopefully the description field will be added to all sensor nodes so that authors are able to directly communicate intent & guidance to users.  This is needed for sensing to be sensible.



On 12/2/2015 5:36 PM, John Carlson wrote:
> --------- Commence validation checks for pp3.x3d ---------
>
> Performing well-formed XML check...
> Checking file:/Users/johncarlson/Source/X3DJSONLD/pp3.x3d...
> Well-formed XML check: pass
>
> Performing DOCTYPE check...
> [X3dDoctypeChecker] success: valid XML declaration found; success: final X3D 3.3 DOCTYPE found.
>
> Performing DTD validation...
> Checking file:/Users/johncarlson/Source/X3DJSONLD/pp3.x3d...
> Attribute "description" must be declared for element type "StringSensor".
> Attribute "description" must be declared for element type "StringSensor".
> Attribute "description" must be declared for element type "StringSensor".
> XML DTD validation: fail!
>
> Performing X3D schema validation...
> Checking file:/Users/johncarlson/Source/X3DJSONLD/pp3.x3d...
> Referenced entity at "nbres:/org/web3d/x3d/externals/schemas/x3d-3.3-Web3dExtensionsPublic.xsd".
> Attribute "description" must be declared for element type "StringSensor".
> cvc-complex-type.3.2.2: Attribute 'description' is not allowed to appear in element 'StringSensor'.
> Attribute "description" must be declared for element type "StringSensor".
> cvc-complex-type.3.2.2: Attribute 'description' is not allowed to appear in element 'StringSensor'.
> Attribute "description" must be declared for element type "StringSensor".
> cvc-complex-type.3.2.2: Attribute 'description' is not allowed to appear in element 'StringSensor'.
> XML schema validation: fail!
>
> Performing X3D regular expression (regex) values check...
>
> Performing X3dToClassicVrml.xslt conversion check...
>
> Performing X3D Schematron check...
>
> --------- Validation checks complete for pp3.x3d ---------
>


all the best, Don
-- 
Don Brutzman  Naval Postgraduate School, Code USW/Br       brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
X3D graphics, virtual worlds, navy robotics http://faculty.nps.edu/brutzman