[#4769] Improve TableLike.field(Field) Javadoc

jOOQ/src/main/java/org/jooq/Cursor.java

@@ -82,6 +82,9 @@ public interface Cursor<R extends Record> extends Iterable<R> /* [java-8] */, Au
 
     /**
      * 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.
      *
      * @see Row#field(Field)
      */

jOOQ/src/main/java/org/jooq/Record.java

@@ -113,6 +113,9 @@ 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.
      *
      * @see Row#field(Field)
      */

jOOQ/src/main/java/org/jooq/Result.java

@@ -84,6 +84,9 @@ 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.
      *
      * @see Row#field(Field)
      */

jOOQ/src/main/java/org/jooq/TableLike.java

@@ -55,6 +55,9 @@ 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.
      *
      * @see Row#field(Field)
      */

jOOQ/src/main/java/org/jooq/UDT.java

@@ -57,6 +57,9 @@ 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.
      *
      * @see Row#field(Field)
      */