From d53dee06965b6437c6d6b410c5a0ae1e1a677897 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Wed, 19 Jun 2019 11:09:48 +0200
Subject: [PATCH] [jOOQ/jOOQ#8815] Add missing Javadoc to
 Configuration.visitListenerProviders()

---
 .../src/main/java/org/jooq/Configuration.java | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/jOOQ/src/main/java/org/jooq/Configuration.java b/jOOQ/src/main/java/org/jooq/Configuration.java
index fccdf32773..729a6f6867 100644
--- a/jOOQ/src/main/java/org/jooq/Configuration.java
+++ b/jOOQ/src/main/java/org/jooq/Configuration.java
@@ -376,7 +376,27 @@ public interface Configuration extends Serializable {
     ExecuteListenerProvider[] executeListenerProviders();
 
     /**
-     * TODO [#2667]
+     * Get the configured <code>VisitListenerProvider</code> instances from this
+     * configuration.
+     * <p>
+     * This method allows for retrieving the configured
+     * <code>VisitListenerProvider</code> instances from this configuration. The
+     * providers will provide jOOQ with {@link VisitListener} instances. These
+     * instances receive query rendering lifecycle notification events every
+     * time jOOQ renders queries. jOOQ makes no assumptions about the internal
+     * state of these listeners, i.e. listener instances may
+     * <ul>
+     * <li>share this <code>Configuration</code>'s lifecycle (i.e. that of a
+     * JDBC <code>Connection</code>, or that of a transaction)</li>
+     * <li>share the lifecycle of an <code>ExecuteContext</code> (i.e. that of a
+     * single query execution)</li>
+     * <li>follow an entirely different lifecycle.</li>
+     * </ul>
+     *
+     * @return The configured set of visit listeners.
+     * @see VisitListenerProvider
+     * @see VisitListener
+     * @see VisitContext
      */
     VisitListenerProvider[] visitListenerProviders();