diff -r 1550b2f6b63d -r 88470f768658 jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java --- a/jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java Wed Jul 05 20:18:43 2017 +0200 +++ b/jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java Thu Feb 12 17:12:57 2015 +0300 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -175,7 +175,7 @@ * encoding used during these marshal operations. Client applications are * expected to supply a valid character encoding name as defined in the * W3C XML 1.0 - * Recommendation and supported by your Java Platform. + * Recommendation and supported by your Java Platform. * * *
@@ -664,7 +664,7 @@ * *
* Every marshaller internally maintains a - * {@link java.util.Map}<{@link Class},{@link XmlAdapter}>, + * {@link java.util.Map}<{@link Class},{@link XmlAdapter}>, * which it uses for marshalling classes whose fields/methods are annotated * with {@link javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter}. * @@ -750,17 +750,17 @@ public Schema getSchema(); /** - *
+ ** Register an instance of an implementation of this class with a {@link Marshaller} to externally listen * for marshal events. - *
- * + * + ** This class enables pre and post processing of each marshalled object. * The event callbacks are called when marshalling from an instance that maps to an xml element or * complex type definition. The event callbacks are not called when marshalling from an instance of a * Java datatype that represents a simple type definition. - *
- * + * + ** External listener is one of two different mechanisms for defining marshal event callbacks. * See Marshal Event Callbacks for an overview. * @@ -770,10 +770,10 @@ */ public static abstract class Listener { /** - *
+ ** Callback method invoked before marshalling from source to XML. - *
- * + * + ** This method is invoked just before marshalling process starts to marshal source. * Note that if the class of source defines its own beforeMarshal method, * the class specific callback method is invoked just before this method is invoked. @@ -784,10 +784,10 @@ } /** - *
+ ** Callback method invoked after marshalling source to XML. - *
- * + * + ** This method is invoked after source and all its descendants have been marshalled. * Note that if the class of source defines its own afterMarshal method, * the class specific callback method is invoked just before this method is invoked.