From: Mike Bayer Date: Fri, 31 Mar 2023 18:03:54 +0000 (-0400) Subject: doc and changelog fixes X-Git-Tag: rel_2_0_8~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=91c1fc308c87caf277803aab0bb7f8407eeb58d8;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git doc and changelog fixes Change-Id: I611684872ea34d05cc5d81ade0813676df00e03f --- diff --git a/doc/build/changelog/changelog_14.rst b/doc/build/changelog/changelog_14.rst index 1922214a45..1e80c684c5 100644 --- a/doc/build/changelog/changelog_14.rst +++ b/doc/build/changelog/changelog_14.rst @@ -28,7 +28,7 @@ This document details individual issue-level changes made throughout Fixed bug / regression where using :func:`.bindparam()` with the same name as a column in the :meth:`.Update.values` method of :class:`.Update`, as - well as the :meth:`.Insert.values` method of :class:`.Insert` in 2.0 only, + well as the :meth:`_dml.Insert.values` method of :class:`_dml.Insert` in 2.0 only, would in some cases silently fail to honor the SQL expression in which the parameter were presented, replacing the expression with a new parameter of the same name and discarding any other elements of the SQL expression, such diff --git a/doc/build/changelog/unreleased_20/9543.rst b/doc/build/changelog/unreleased_20/9543.rst deleted file mode 100644 index 593507c410..0000000000 --- a/doc/build/changelog/unreleased_20/9543.rst +++ /dev/null @@ -1,8 +0,0 @@ -.. change:: - :tags: bug, mysql - :tickets: 9544 - - Fixed issue where string datatypes such as :class:`.CHAR`, - :class:`.VARCHAR`, :class:`.TEXT`, as well as binary :class:`.BLOB`, could - not be produced with an explicit length of zero, which has special meaning - for MySQL. Pull request courtesy J. Nick Koston. diff --git a/doc/build/changelog/unreleased_20/9544.rst b/doc/build/changelog/unreleased_20/9544.rst new file mode 100644 index 0000000000..7aae71a748 --- /dev/null +++ b/doc/build/changelog/unreleased_20/9544.rst @@ -0,0 +1,9 @@ +.. change:: + :tags: bug, mysql + :tickets: 9544 + + Fixed issue where string datatypes such as :class:`_sqltypes.CHAR`, + :class:`_sqltypes.VARCHAR`, :class:`_sqltypes.TEXT`, as well as binary + :class:`_sqltypes.BLOB`, could not be produced with an explicit length of + zero, which has special meaning for MySQL. Pull request courtesy J. Nick + Koston. diff --git a/doc/build/errors.rst b/doc/build/errors.rst index 4c8cb53d73..aa28ea9097 100644 --- a/doc/build/errors.rst +++ b/doc/build/errors.rst @@ -1450,25 +1450,25 @@ Python dataclasses error encountered when creating dataclass for When using the :class:`_orm.MappedAsDataclass` mixin class or :meth:`_orm.registry.mapped_as_dataclass` decorator, SQLAlchemy makes use -of the actual `Python dataclasses `_ module that's in the Python standard library +of the actual `Python dataclasses `_ module that's in the Python standard library in order to apply dataclass behaviors to the target class. This API has its own error scenarios, most of which involve the construction of an ``__init__()`` method on the user defined class; the order of attributes -declared on the class, as well as `on superclasses `_, determines +declared on the class, as well as `on superclasses `_, determines how the ``__init__()`` method will be constructed and there are specific rules in how the attributes are organized as well as how they should make use of parameters such as ``init=False``, ``kw_only=True``, etc. **SQLAlchemy does not control or implement these rules**. Therefore, for errors of this nature, -consult the `Python dataclasses `_ documentation, with special -attention to the rules applied to `inheritance <_dc_superclass>`_. +consult the `Python dataclasses `_ documentation, with special +attention to the rules applied to `inheritance `_. .. seealso:: :ref:`orm_declarative_native_dataclasses` - SQLAlchemy dataclasses documentation - `Python dataclasses `_ - on the python.org website + `Python dataclasses `_ - on the python.org website - `inheritance <_dc_superclass>`_ - on the python.org website + `inheritance `_ - on the python.org website .. _dataclasses: https://docs.python.org/3/library/dataclasses.html