From f298c4addc5885f720c1ac843264f55b2c4ddb69 Mon Sep 17 00:00:00 2001
From: lukaseder <lukas.eder@gmail.com>
Date: Sun, 18 Aug 2013 20:58:31 +0200
Subject: [PATCH] [#2701] Document the fact that jOOQ sets changed flags to
 true, even if Record.setValue() sets the value already present in the record

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

diff --git a/jOOQ/src/main/java/org/jooq/Record.java b/jOOQ/src/main/java/org/jooq/Record.java
index 356b1d9840..e2a4e7bedc 100644
--- a/jOOQ/src/main/java/org/jooq/Record.java
+++ b/jOOQ/src/main/java/org/jooq/Record.java
@@ -434,6 +434,15 @@ public interface Record extends Attachable, Comparable<Record> {
 
     /**
      * Set a value into this record.
+     * <p>
+     * This will always set the {@link #changed(Field)} flag for the given
+     * <code>field</code>, no matter if setting the value actually changes the
+     * value.
+     * <p>
+     * Changing {@link Table#getPrimaryKey()} values will set all
+     * {@link #changed()} flags to true, in order to produce complete
+     * <code>INSERT</code> statements on subsequent
+     * {@link UpdatableRecord#store()} operations.
      *
      * @param <T> The generic field parameter
      * @param field The field
@@ -443,6 +452,15 @@ public interface Record extends Attachable, Comparable<Record> {
 
     /**
      * Set a value into this record.
+     * <p>
+     * This will always set the {@link #changed(Field)} flag for the given
+     * <code>field</code>, no matter if setting the value actually changes the
+     * value.
+     * <p>
+     * Changing {@link Table#getPrimaryKey()} values will set all
+     * {@link #changed()} flags to true, in order to produce complete
+     * <code>INSERT</code> statements on subsequent
+     * {@link UpdatableRecord#store()} operations.
      *
      * @param <T> The generic field parameter
      * @param <U> The conversion type parameter