backport bug [ 1248199 ] shelve .sync operation not documented

diff --git a/Doc/lib/libshelve.tex b/Doc/lib/libshelve.tex
index e369c2a9707860c2586a12f473921aee930ac157..f17b82c2519fd922adb53737c686eec0647cd429 100644 (file)
--- a/Doc/lib/libshelve.tex
+++ b/Doc/lib/libshelve.tex
@@ -43,6 +43,14 @@ Shelve objects support all methods supported by dictionaries.  This eases
 the transition from dictionary based scripts to those requiring persistent
 storage.
 
+One additional method is supported:
+\begin{methoddesc}[Shelf]{sync}{}
+Write back all entries in the cache if the shelf was opened with
+\var{writeback} set to \var{True}. Also empty the cache and synchronize
+the persistent dictionary on disk, if feasible.  This is called automatically
+when the shelf is closed with \method{close()}.
+\end{methoddesc}
+
 \subsection{Restrictions}
 
 \begin{itemize}