--- old/src/share/jaxws_classes/com/sun/xml/internal/ws/api/pipe/Codec.java	2013-04-04 15:29:00.364614528 +0200
+++ new/src/share/jaxws_classes/com/sun/xml/internal/ws/api/pipe/Codec.java	2013-04-04 15:29:00.308614528 +0200
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2013, 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
@@ -56,15 +56,17 @@
  * {@link Codec} does not produce transport-specific information, such as HTTP headers.
  *
  * <p>
- * {@link Codec} is a non-reentrant object, meaning no two threads
- * can concurrently invoke the decode method. This allows the implementation
- * to easily reuse parser objects (as instance variables), which are costly otherwise.
- *
+ * {@link Codec} implementations should be thread-safe; a codec instance could be used
+ * concurrently in multiple threads. If a codec have to generate or use a per-request
+ * state, the codec implementation must store the state in the Packet instead of using an
+ * instance variable of the codec implementation.
  *
  * <p>
  * {@link BindingID} determines the {@link Codec}. See {@link BindingID#createEncoder(WSBinding)}.
  *
  * @author Kohsuke Kawaguchi
+ * @author shih-chang.chen@oracle.com
+ *
  * @see EndpointAwareCodec
  */
 public interface Codec {