summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2007-04-29 16:21:43 +0000
committerMike Bayer <mike_mp@zzzcomputing.com>2007-04-29 16:21:43 +0000
commitec66cd4c44eda62ab72c11d302b12231c60cf41e (patch)
treedf6d82722e0c094a5fdb29634e084c0f610fd2cd
parentc0f391af951ab75a1c486d4179216d31997a0f83 (diff)
downloadsqlalchemy-ec66cd4c44eda62ab72c11d302b12231c60cf41e.tar.gz
- CSS change to regular font for docstrings now that we use docutils for formatting
- dynamicmetadata clarification
-rw-r--r--doc/build/content/metadata.txt12
-rw-r--r--doc/docs.css2
2 files changed, 8 insertions, 6 deletions
diff --git a/doc/build/content/metadata.txt b/doc/build/content/metadata.txt
index 054dbdde8..01d5646cc 100644
--- a/doc/build/content/metadata.txt
+++ b/doc/build/content/metadata.txt
@@ -131,15 +131,17 @@ To bind `MetaData` to a single `Engine`, use `BoundMetaData`:
# create the Engine and MetaData in one step
meta = BoundMetaData('postgres://db/', **kwargs)
-
-Another form of `MetaData` exists which can connect to an engine within the context of the current thread only, allowing different engines to be connected within other concurrent threads. This is `DynamicMetaData`:
+
+Another form of `MetaData` exits which can connect to an engine within the current thread (or "on a per-thread basis"), allowing other threads to be connected to different engines simultaneously:
{python}
meta = DynamicMetaData()
+
+ # In thread 1, connect to an existing Engine
+ meta.connect(engine)
- meta.connect(engine) # connect to an existing Engine
-
- meta.connect('mysql://user@host/dsn') # create a new Engine and connect
+ # Meanwhile in thread 2, create a new Engine and connect
+ meta.connect('mysq://user@host/dsn')
`DynamicMetaData` is intended for applications that need to use the same set of `Tables` for many different database connections in the same process, such as a CherryPy web application which handles multiple application instances in one process.
diff --git a/doc/docs.css b/doc/docs.css
index c5c3cb437..d65f5aff5 100644
--- a/doc/docs.css
+++ b/doc/docs.css
@@ -129,7 +129,7 @@ h3 {
}
.darkcell {
- font-family: courier, "courier new", serif;
+ /*font-family: courier, "courier new", serif;*/
margin:0px 0px 10px 0px;
padding:4px 4px 4px 4px;
background-color: #f0f0f0;