Adding postgres create table options documentation

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index 057a5e07271af65548e52304e4a41a4360af0646..34932520f47bd8c6e90ecc530e4d4add9fdbfe78 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -417,6 +417,22 @@ of :class:`.PGInspector`, which offers additional methods::
 .. autoclass:: PGInspector
     :members:
 
+PostgreSQL specific table options
+---------------------------------
+
+PostgreSQL provides several CREATE TABLE specific options allowing to 
+specify how table data are stored. The following options are currently 
+supported: ``TABLESPACE``, ``ON COMMIT``, ``WITH OIDS``.
+
+``postgresql_tablespace`` is probably the more common and allows to specify 
+where in the filesystem the data files for the table will be created (see
+http://www.postgresql.org/docs/9.3/static/manage-ag-tablespaces.html)
+
+.. seealso::
+
+    `Postgresql CREATE TABLE options
+    <http://www.postgresql.org/docs/9.3/static/sql-createtable.html>`_ -
+    on the PostgreSQL website
 
 """
 from collections import defaultdict