From 429ebfc764470c3789766eb5c047f527f0ff8b0c Mon Sep 17 00:00:00 2001 From: Daniele Varrazzo Date: Wed, 16 Oct 2013 19:08:45 +0100 Subject: [PATCH] Document that named cursors don't raise an exception going out-of-bound See issue #174 for the details. --- doc/src/cursor.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/src/cursor.rst b/doc/src/cursor.rst index 62be5e3c..3e3d8a0a 100644 --- a/doc/src/cursor.rst +++ b/doc/src/cursor.rst @@ -332,10 +332,6 @@ The ``cursor`` class `~psycopg2.ProgrammingError` is raised and the cursor position is not changed. - The method can be used both for client-side cursors and - :ref:`server-side cursors `. Server-side cursors - can usually scroll backwards only if declared `~cursor.scrollable`. - .. note:: According to the |DBAPI|_, the exception raised for a cursor out @@ -347,6 +343,13 @@ The ``cursor`` class except (ProgrammingError, IndexError), exc: deal_with_it(exc) + The method can be used both for client-side cursors and + :ref:`server-side cursors `. Server-side cursors + can usually scroll backwards only if declared `~cursor.scrollable`. + Moving out-of-bound in a server-side cursor doesn't result in an + exception, if the backend doesn't raise any (Postgres doesn't tell us + in a reliable way if we went out of bound). + .. attribute:: arraysize