summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2009-05-17 08:36:04 (GMT)
committerGeorg Brandl <georg@python.org>2009-05-17 08:36:04 (GMT)
commitee8e08b8b686ee23c1f6995d608bb2a0f59277c2 (patch)
tree195f49abbb6f3d49cfc33c922e1c7397dcaf9062 /Doc
parent4c8b1c7a590f42511324a8860d5f5eb79c5ac716 (diff)
downloadcpython-ee8e08b8b686ee23c1f6995d608bb2a0f59277c2.zip
cpython-ee8e08b8b686ee23c1f6995d608bb2a0f59277c2.tar.gz
cpython-ee8e08b8b686ee23c1f6995d608bb2a0f59277c2.tar.bz2
#5942: Copy over flag table from dbm.rst which is clearer.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/anydbm.rst36
1 files changed, 25 insertions, 11 deletions
diff --git a/Doc/library/anydbm.rst b/Doc/library/anydbm.rst
index 36f0a7e..aad1776 100644
--- a/Doc/library/anydbm.rst
+++ b/Doc/library/anydbm.rst
@@ -27,19 +27,33 @@ these modules is installed, the slow-but-simple implementation in module
Open the database file *filename* and return a corresponding object.
- If the database file already exists, the :mod:`whichdb` module is used to
- determine its type and the appropriate module is used; if it does not exist, the
- first module listed above that can be imported is used.
-
- The optional *flag* argument can be ``'r'`` to open an existing database for
- reading only, ``'w'`` to open an existing database for reading and writing,
- ``'c'`` to create the database if it doesn't exist, or ``'n'``, which will
- always create a new empty database. If not specified, the default value is
- ``'r'``.
+ If the database file already exists, the :mod:`whichdb` module is used to
+ determine its type and the appropriate module is used; if it does not exist,
+ the first module listed above that can be imported is used.
+
+ The optional *flag* argument must be one of these values:
+
+ +---------+-------------------------------------------+
+ | Value | Meaning |
+ +=========+===========================================+
+ | ``'r'`` | Open existing database for reading only |
+ | | (default) |
+ +---------+-------------------------------------------+
+ | ``'w'`` | Open existing database for reading and |
+ | | writing |
+ +---------+-------------------------------------------+
+ | ``'c'`` | Open database for reading and writing, |
+ | | creating it if it doesn't exist |
+ +---------+-------------------------------------------+
+ | ``'n'`` | Always create a new, empty database, open |
+ | | for reading and writing |
+ +---------+-------------------------------------------+
+
+ If not specified, the default value is ``'r'``.
The optional *mode* argument is the Unix mode of the file, used only when the
- database has to be created. It defaults to octal ``0666`` (and will be modified
- by the prevailing umask).
+ database has to be created. It defaults to octal ``0666`` (and will be
+ modified by the prevailing umask).
.. exception:: error