diff --git a/jOOQ/src/main/java/org/jooq/Cursor.java b/jOOQ/src/main/java/org/jooq/Cursor.java
index 712c130b92..2946a0febf 100644
--- a/jOOQ/src/main/java/org/jooq/Cursor.java
+++ b/jOOQ/src/main/java/org/jooq/Cursor.java
@@ -85,8 +85,19 @@ public interface Cursor<R extends Record> extends Iterable<R> , AutoCloseable  {
     /**
      * Get a specific field from this Cursor.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @see Row#field(Field)
      */
diff --git a/jOOQ/src/main/java/org/jooq/Record.java b/jOOQ/src/main/java/org/jooq/Record.java
index 70fef05bcd..a5684ea230 100644
--- a/jOOQ/src/main/java/org/jooq/Record.java
+++ b/jOOQ/src/main/java/org/jooq/Record.java
@@ -112,8 +112,19 @@ public interface Record extends Attachable, Comparable<Record> {
     /**
      * Get a specific field from this Record.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @see Row#field(Field)
      */
diff --git a/jOOQ/src/main/java/org/jooq/RecordType.java b/jOOQ/src/main/java/org/jooq/RecordType.java
index 2321567409..c3802ea10d 100644
--- a/jOOQ/src/main/java/org/jooq/RecordType.java
+++ b/jOOQ/src/main/java/org/jooq/RecordType.java
@@ -58,8 +58,19 @@ public interface RecordType<R extends Record> {
     /**
      * Get a specific field from this record type.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * type from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @param <T> The generic field type
      * @param field The field to fetch
diff --git a/jOOQ/src/main/java/org/jooq/Result.java b/jOOQ/src/main/java/org/jooq/Result.java
index d8e59f0128..62e5d7f3ce 100644
--- a/jOOQ/src/main/java/org/jooq/Result.java
+++ b/jOOQ/src/main/java/org/jooq/Result.java
@@ -79,8 +79,19 @@ public interface Result<R extends Record> extends List<R>, Attachable {
     /**
      * Get a specific field from this Result.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @see Row#field(Field)
      */
diff --git a/jOOQ/src/main/java/org/jooq/Row.java b/jOOQ/src/main/java/org/jooq/Row.java
index 3c60e12fac..f8b18ee3b9 100644
--- a/jOOQ/src/main/java/org/jooq/Row.java
+++ b/jOOQ/src/main/java/org/jooq/Row.java
@@ -62,8 +62,19 @@ public interface Row extends FieldOrRow {
     /**
      * Get a specific field from this row.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @param <T> The generic field type
      * @param field The field to fetch
diff --git a/jOOQ/src/main/java/org/jooq/TableLike.java b/jOOQ/src/main/java/org/jooq/TableLike.java
index fb398a6d18..c0f125026c 100644
--- a/jOOQ/src/main/java/org/jooq/TableLike.java
+++ b/jOOQ/src/main/java/org/jooq/TableLike.java
@@ -61,8 +61,19 @@ public interface TableLike<R extends Record> extends QueryPart {
     /**
      * Get a specific field from this table.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased table, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @see Row#field(Field)
      */
diff --git a/jOOQ/src/main/java/org/jooq/UDT.java b/jOOQ/src/main/java/org/jooq/UDT.java
index 4e95e3e85f..e93aecde53 100644
--- a/jOOQ/src/main/java/org/jooq/UDT.java
+++ b/jOOQ/src/main/java/org/jooq/UDT.java
@@ -59,8 +59,19 @@ public interface UDT<R extends UDTRecord<R>> extends QueryPart {
     /**
      * Get a specific field from this UDT.
      * <p>
-     * Usually, this will return the field itself. However, if this is a row
-     * from an aliased UDT, the field will be aliased accordingly.
+     * This will return:
+     * <ul>
+     * <li>A field that is the same as the argument field (by identity
+     * comparison).</li>
+     * <li>A field that is equal to the argument field (exact matching fully
+     * qualified name).</li>
+     * <li>A field that is equal to the argument field (partially matching
+     * qualified name).</li>
+     * <li>A field whose name is equal to the name of the argument field.</li>
+     * <li><code>null</code> otherwise.
+     * </ul>
+     * If several fields have the same name, the first one is returned and a
+     * warning is logged.
      *
      * @see Row#field(Field)
      */