From 4d27ced7b37e3a38ba4cb025dd65a150c2517b09 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Sat, 26 Apr 2014 14:38:46 +0200
Subject: [PATCH] [#3199] Add some Javadoc to Result.attach() and
 Result.detach() to explain the semantics

---
 jOOQ/src/main/java/org/jooq/Result.java | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/Result.java b/jOOQ/src/main/java/org/jooq/Result.java
index 6a55a5861d..b6fb74ac83 100644
--- a/jOOQ/src/main/java/org/jooq/Result.java
+++ b/jOOQ/src/main/java/org/jooq/Result.java
@@ -1188,4 +1188,29 @@ public interface Result<R extends Record> extends List<R>, Attachable {
      * @see String#intern()
      */
     Result<R> intern(String... fieldNames);
+
+    // ------------------------------------------------------------------------
+    // Specialisations of Attachable methods
+    // ------------------------------------------------------------------------
+
+    /**
+     * Attach this result and all of its contained records to a new
+     * {@link Configuration}.
+     *
+     * @param configuration A configuration or <code>null</code>, if you wish to
+     *            detach this <code>Attachable</code> from its previous
+     *            configuration.
+     */
+    @Override
+    void attach(Configuration configuration);
+
+    /**
+     * Detach this result and all of its contained records from their current
+     * {@link Configuration}.
+     * <p>
+     * This is the same as calling <code>attach(null)</code>.
+     */
+    @Override
+    void detach();
+
 }