From: Mike Bayer Date: Wed, 28 Aug 2013 00:45:28 +0000 (-0400) Subject: - fix a crapload of seealsos X-Git-Tag: rel_0_8_3~36 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bedfeee764dc2f3f9d6193a71c688dbdc025d218;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git - fix a crapload of seealsos - fix the label on metadata.rst --- diff --git a/doc/build/core/metadata.rst b/doc/build/core/metadata.rst index e4b50f63a1..209cba3395 100644 --- a/doc/build/core/metadata.rst +++ b/doc/build/core/metadata.rst @@ -1,12 +1,13 @@ .. _metadata_toplevel: .. _metadata_describing_toplevel: .. _metadata_describing: -.. module:: sqlalchemy.schema ================================== Describing Databases with MetaData ================================== +.. module:: sqlalchemy.schema + This section discusses the fundamental :class:`.Table`, :class:`.Column` and :class:`.MetaData` objects. diff --git a/lib/sqlalchemy/schema.py b/lib/sqlalchemy/schema.py index 9d90ff2a8f..863c756bd8 100644 --- a/lib/sqlalchemy/schema.py +++ b/lib/sqlalchemy/schema.py @@ -121,9 +121,9 @@ class Table(SchemaItem, expression.TableClause): a second time will return the *same* :class:`.Table` object - in this way the :class:`.Table` constructor acts as a registry function. - See also: + .. seealso:: - :ref:`metadata_describing` - Introduction to database metadata + :ref:`metadata_describing` - Introduction to database metadata Constructor arguments are as follows: @@ -603,7 +603,9 @@ class Table(SchemaItem, expression.TableClause): :class:`.Table`, using the given :class:`.Connectable` for connectivity. - See also :meth:`.MetaData.create_all`. + .. seealso:: + + :meth:`.MetaData.create_all`. """ @@ -618,7 +620,9 @@ class Table(SchemaItem, expression.TableClause): :class:`.Table`, using the given :class:`.Connectable` for connectivity. - See also :meth:`.MetaData.drop_all`. + .. seealso:: + + :meth:`.MetaData.drop_all`. """ if bind is None: @@ -1716,7 +1720,11 @@ class Sequence(DefaultGenerator): be emitted as well. For platforms that don't support sequences, the :class:`.Sequence` construct is ignored. - See also: :class:`.CreateSequence` :class:`.DropSequence` + .. seealso:: + + :class:`.CreateSequence` + + :class:`.DropSequence` """ @@ -2488,7 +2496,9 @@ class Index(ColumnCollectionMixin, SchemaItem): :class:`.Index`, using the given :class:`.Connectable` for connectivity. - See also :meth:`.MetaData.create_all`. + .. seealso:: + + :meth:`.MetaData.create_all`. """ if bind is None: @@ -2501,7 +2511,9 @@ class Index(ColumnCollectionMixin, SchemaItem): :class:`.Index`, using the given :class:`.Connectable` for connectivity. - See also :meth:`.MetaData.drop_all`. + .. seealso:: + + :meth:`.MetaData.drop_all`. """ if bind is None: @@ -2543,12 +2555,9 @@ class MetaData(SchemaItem): MetaData is a thread-safe object after tables have been explicitly defined or loaded via reflection. - See also: - - :ref:`metadata_describing` - Introduction to database metadata + .. seealso:: - .. index:: - single: thread safety; MetaData + :ref:`metadata_describing` - Introduction to database metadata """ @@ -2950,7 +2959,7 @@ class DDLElement(expression.Executable, _DDLCompiles): AddConstraint(constraint).execute_if(dialect='postgresql') ) - See also: + .. seealso:: :class:`.DDL` @@ -3102,7 +3111,7 @@ class DDLElement(expression.Executable, _DDLCompiles): :param state: any value which will be passed to the callable_ as the ``state`` keyword argument. - See also: + .. seealso:: :class:`.DDLEvents` @@ -3266,9 +3275,10 @@ class DDL(DDLElement): default when ``execute()`` is invoked without a bind argument. - See also: + .. seealso:: :class:`.DDLEvents` + :mod:`sqlalchemy.event` """