Merge "Document Table/Column accessors"

1 files changed, 9 insertions, 1 deletions

diff --git a/lib/sqlalchemy/sql/selectable.py b/lib/sqlalchemy/sql/selectable.py
index a1dfa8b56..b4f6c8bc9 100644
--- a/lib/sqlalchemy/sql/selectable.py
+++ b/lib/sqlalchemy/sql/selectable.py
@@ -749,9 +749,17 @@ class FromClause(roles.AnonymizedFromClauseRole, Selectable):
 
     @util.memoized_property
     def foreign_keys(self):
-        """Return the collection of :class:`_schema.ForeignKey` objects
+        """Return the collection of :class:`_schema.ForeignKey` marker objects
         which this FromClause references.
 
+        Each :class:`_schema.ForeignKey` is a member of a
+        :class:`_schema.Table`-wide
+        :class:`_schema.ForeignKeyConstraint`.
+
+        .. seealso::
+
+            :attr:`_schema.Table.foreign_key_constraints`
+
         """
         self._init_collections()
         self._populate_column_collection()