summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2009-05-25 21:15:01 (GMT)
committerGeorg Brandl <georg@python.org>2009-05-25 21:15:01 (GMT)
commit1a04058a642ce9b88925b2b5a2dc1e2f969b3562 (patch)
tree112af9710c9654c69f045229fddf0b423bc8ab30
parent7b53cb7dbac2230a8461a7f8902af6f13c0a9177 (diff)
downloadcpython-1a04058a642ce9b88925b2b5a2dc1e2f969b3562.zip
cpython-1a04058a642ce9b88925b2b5a2dc1e2f969b3562.tar.gz
cpython-1a04058a642ce9b88925b2b5a2dc1e2f969b3562.tar.bz2
Manual merge of r72710: use table of flags for dbm.open description.
-rw-r--r--Doc/library/dbm.rst22
1 files changed, 17 insertions, 5 deletions
diff --git a/Doc/library/dbm.rst b/Doc/library/dbm.rst
index 0fa0eb2..7c2d660 100644
--- a/Doc/library/dbm.rst
+++ b/Doc/library/dbm.rst
@@ -38,11 +38,23 @@
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'``.
+ The optional *flag* argument can be:
+
+ +---------+-------------------------------------------+
+ | 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 |
+ +---------+-------------------------------------------+
The optional *mode* argument is the Unix mode of the file, used only when the
database has to be created. It defaults to octal ``0o666`` (and will be