Update appendix G
Signed-off-by: Lukas Jungmann <lukas.jungmann@oracle.com>
diff --git a/spec/src/main/asciidoc/appG-deprecated.adoc b/spec/src/main/asciidoc/appG-deprecated.adoc
index 5247fa0..4f620b1 100644
--- a/spec/src/main/asciidoc/appG-deprecated.adoc
+++ b/spec/src/main/asciidoc/appG-deprecated.adoc
@@ -14,7 +14,7 @@
operations do still need to be supported by a JAXB 2.0 binding runtime
for JAXB 1.0 schema-derived classes.
-=== [[a5094]]On-demand Validation
+=== On-demand Validation
It is optional for a JAXB 2.0 implementation
to implement on-demand validation for JAXB 2.0 mapped classes. There is
@@ -23,9 +23,9 @@
compatibility, an implementation is required to support this
functionality for JAXB 1.0 schema-derived classes.
-=== [[a5096]]Validator for JAXB 1.0 schema-derived classes
+==== Validator for JAXB 1.0 schema-derived classes
- _The following text is from JAXB 1.0
+_The following text is from JAXB 1.0
Specification and applies to JAXB 1.0 schema-derived classes._
An application may wish to validate the
@@ -35,40 +35,37 @@
feels it should be valid. The application is notified about validation
errors and warnings detected in the Java content tree.
-The _Validator_ class is responsible for
+The `Validator` class is responsible for
controlling the validation of a content tree of in-memory objects. The
following summarizes the available operations on the class.
-public interface Validator \{ +
-ValidationEventHandler _getEventHandler_ () +
-void _setEventHandler_ (ValidationEventHandler)
+[source,java,indent="4"]
+----
+public interface Validator {
+ ValidationEventHandler getEventHandler()
+ void setEventHandler(ValidationEventHandler)
- +
-boolean _validate_ (java.lang.Object subrootObject)
+ boolean validate(java.lang.Object subrootObject)
+ boolean validateRoot(java.lang.Object rootObject)
- boolean _validateRoot_ (java.lang.Object
-rootObject) +
-
- java.lang.Object _getProperty_
-(java.lang.String name) +
-void _setProperty_ (java.lang.String name,
-java.lang.Object value)
-
+ java.lang.Object getProperty(java.lang.String name)
+ void setProperty(java.lang.String name, java.lang.Object value)
}
+----
- _The JAXBContext_ class provides a factory
-to create a _Validator_ instance. After an application has made a series
+`The JAXBContext` class provides a factory
+to create a `Validator` instance. After an application has made a series
of modifications to a Java content tree, the application validates the
content tree on-demand. As far as the application is concerned, this
validation takes place against the Java content instances and validation
constraint warnings and errors are reported to the application relative
to the Java content tree. Validation is initiated by invoking the
-_validateRoot(Object)_ method on the root of the Java content tree or by
-invoking _validate(Object)_ method to validate any arbitrary subtree of
+`validateRoot(Object)` method on the root of the Java content tree or by
+invoking `validate(Object)` method to validate any arbitrary subtree of
the Java content tree. The only difference between these two methods is
global constraint checking (i.e. verifying ID/IDREF constraints.) The
-_validateRoot(Object)_ method includes global constraint checking as
-part of its operation, whereas the _validate(Object)_ method does not.
+`validateRoot(Object)` method includes global constraint checking as
+part of its operation, whereas the `validate(Object)` method does not.
The validator governs the process of
validating the content tree, serves as a registry for identifier
@@ -78,6 +75,6 @@
If a violation of a local or global
structural constraint is detected, then the application is notified of
-the event with a callback passing an instance of a _ValidationEvent_ as
+the event with a callback passing an instance of a `ValidationEvent` as
a parameter.
