Notice -> Note in the docs, and a handful of other typo fixed

This commit is contained in:
Daniele Varrazzo 2011-10-14 23:59:49 +01:00
parent 37a9eb3615
commit 3e39b23835
4 changed files with 9 additions and 9 deletions

View File

@ -351,7 +351,7 @@ returned, the connection can be safely used:
>>> wait(aconn) >>> wait(aconn)
>>> acurs = aconn.cursor() >>> acurs = aconn.cursor()
Notice that there are a few other requirements to be met in order to have a Note that there are a few other requirements to be met in order to have a
completely non-blocking connection attempt: see the libpq documentation for completely non-blocking connection attempt: see the libpq documentation for
|PQconnectStart|_. |PQconnectStart|_.

View File

@ -579,7 +579,7 @@ from the database. See :ref:`unicode-handling` for details.
TIME TIME
UNICODE UNICODE
Typecasters for basic types. Notice that a few other ones (`~psycopg2.BINARY`, Typecasters for basic types. Note that a few other ones (`~psycopg2.BINARY`,
`~psycopg2.DATETIME`, `~psycopg2.NUMBER`, `~psycopg2.ROWID`, `~psycopg2.DATETIME`, `~psycopg2.NUMBER`, `~psycopg2.ROWID`,
`~psycopg2.STRING`) are exposed by the `psycopg2` module for |DBAPI|_ `~psycopg2.STRING`) are exposed by the `psycopg2` module for |DBAPI|_
compliance. compliance.

View File

@ -36,7 +36,7 @@ directly into the client application.
Close all the connections handled by the pool. Close all the connections handled by the pool.
Notice that all the connections are closed, including ones Note that all the connections are closed, including ones
eventually in use by the application. eventually in use by the application.

View File

@ -180,9 +180,9 @@ reliable. It is really the case to stress this point:
The correct way to pass variables in a SQL command is using the second The correct way to pass variables in a SQL command is using the second
argument of the `~cursor.execute()` method:: argument of the `~cursor.execute()` method::
>>> SQL = "INSERT INTO authors (name) VALUES (%s);" # Notice: no quotes >>> SQL = "INSERT INTO authors (name) VALUES (%s);" # Note: no quotes
>>> data = ("O'Reilly", ) >>> data = ("O'Reilly", )
>>> cur.execute(SQL, data) # Notice: no % operator >>> cur.execute(SQL, data) # Note: no % operator
@ -473,7 +473,7 @@ to a `~psycopg2.tz.FixedOffsetTimezone` instance.
>>> cur.fetchone()[0].tzinfo >>> cur.fetchone()[0].tzinfo
psycopg2.tz.FixedOffsetTimezone(offset=60, name=None) psycopg2.tz.FixedOffsetTimezone(offset=60, name=None)
Notice that only time zones with an integer number of minutes are supported: Note that only time zones with an integer number of minutes are supported:
this is a limitation of the Python `datetime` module. A few historical time this is a limitation of the Python `datetime` module. A few historical time
zones had seconds in the UTC offset: these time zones will have the offset zones had seconds in the UTC offset: these time zones will have the offset
rounded to the nearest minute, with an error of up to 30 seconds. rounded to the nearest minute, with an error of up to 30 seconds.
@ -568,9 +568,9 @@ method and to read the data using `~cursor.fetchone()` and
`~cursor.fetchmany()` methods. `~cursor.fetchmany()` methods.
Named cursors are also :ref:`iterable <cursor-iterable>` like regular cursors. Named cursors are also :ref:`iterable <cursor-iterable>` like regular cursors.
Notice however that before Psycopg 2.4 iteration was performed fetching one Note however that before Psycopg 2.4 iteration was performed fetching one
record at time from the backend, resulting in a large overhead. The attribute record at time from the backend, resulting in a large overhead. The attribute
`~cursor.itersize` now controls how many records are now fetched at time `~cursor.itersize` now controls how many records are fetched at time
during the iteration: the default value of 2000 allows to fetch about 100KB during the iteration: the default value of 2000 allows to fetch about 100KB
per roundtrip assuming records of 10-20 columns of mixed number and strings; per roundtrip assuming records of 10-20 columns of mixed number and strings;
you may decrease this value if you are dealing with huge records. you may decrease this value if you are dealing with huge records.
@ -584,7 +584,7 @@ value for the `withhold` parameter to `~connection.cursor()` or by setting the
`~cursor.withhold` attribute to `!True` before calling `~cursor.execute()` on `~cursor.withhold` attribute to `!True` before calling `~cursor.execute()` on
the cursor. It is extremely important to always `~cursor.close()` such cursors, the cursor. It is extremely important to always `~cursor.close()` such cursors,
otherwise they will continue to hold server-side resources until the connection otherwise they will continue to hold server-side resources until the connection
will be eventually be closed. Also note that while :sql:`WITH HOLD` cursors will be eventually closed. Also note that while :sql:`WITH HOLD` cursors
lifetime extends well after `~connection.commit()`, calling lifetime extends well after `~connection.commit()`, calling
`~connection.rollback()` will automatically close the cursor. `~connection.rollback()` will automatically close the cursor.