From f596bf15661df0fe6051fbc3331d7f4e04c7e669 Mon Sep 17 00:00:00 2001
From: Simone Bordet <simone.bordet@gmail.com>
Date: Wed, 25 Nov 2015 12:51:03 +0100
Subject: [PATCH] Improved javadocs for onPreface().

---
 .../java/org/eclipse/jetty/http2/api/Session.java     | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/jetty-http2/http2-common/src/main/java/org/eclipse/jetty/http2/api/Session.java b/jetty-http2/http2-common/src/main/java/org/eclipse/jetty/http2/api/Session.java
index 883ed322f6b..16bdc08f3b3 100644
--- a/jetty-http2/http2-common/src/main/java/org/eclipse/jetty/http2/api/Session.java
+++ b/jetty-http2/http2-common/src/main/java/org/eclipse/jetty/http2/api/Session.java
@@ -134,11 +134,18 @@ public interface Session
     public interface Listener
     {
         /**
-         * <p>Callback method invoked when the preface has been received.</p>
+         * <p>Callback method invoked:</p>
+         * <ul>
+         *     <li>for clients, just before the preface is sent, to gather the
+         *     SETTINGS configuration options the client wants to send to the server;</li>
+         *     <li>for servers, just after having received the preface, to gather
+         *     the SETTINGS configuration options the server wants to send to the
+         *     client.</li>
+         * </ul>
          *
          * @param session the session
          * @return a (possibly empty or null) map containing SETTINGS configuration
-         * options that are sent after the preface.
+         * options to send.
          */
         public Map<Integer, Integer> onPreface(Session session);