tweak

diff --git a/doc/build/content/session.txt b/doc/build/content/session.txt
index e8ec743c313d3a8465b317fc9e68790b7517c1b6..be028d769b504c499e43960dee4bc86e099835be 100644 (file)
--- a/doc/build/content/session.txt
+++ b/doc/build/content/session.txt
@@ -236,7 +236,7 @@ The solution is to use proper cascading:
 
 ### Flushing
 
-When the `Session` is used with its default configuration, the flush step is nearly always done transparently.  Specifically, the flush occurs before any individual `Query` is issued, as well as within the `commit()` call before the transaction is committed.  This behavior can be disabled by constructing `sessionmaker()` with the flag `autoflush=False`.
+When the `Session` is used with its default configuration, the flush step is nearly always done transparently.  Specifically, the flush occurs before any individual `Query` is issued, as well as within the `commit()` call before the transaction is committed.  It also occurs before a SAVEPOINT is issued when `begin_nested()` is used.  The "flush-on-Query" aspect of the behavior can be disabled by constructing `sessionmaker()` with the flag `autoflush=False`.
 
 Regardless of the autoflush setting, a flush can always be forced by issing `flush()`: