summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTom Dyson <tom@torchbox.com>2014-10-13 11:24:36 +0100
committerBaptiste Mispelon <bmispelon@gmail.com>2014-10-13 12:19:05 +0100
commit8701b5900774be3126321c2449b4d0e8091a9725 (patch)
treebd9bda5fc93cecef0ebf0840bccc814d91900152 /docs
parent8d789449c7861b8cf8b10d244f26d9d354989aaf (diff)
Cleaned up the Memcached cache backend doc
Consistent casing, minor typo fixes, reduced rhetoric.
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/cache.txt37
1 files changed, 19 insertions, 18 deletions
diff --git a/docs/topics/cache.txt b/docs/topics/cache.txt
index 233c333b25..b515925df2 100644
--- a/docs/topics/cache.txt
+++ b/docs/topics/cache.txt
@@ -62,21 +62,21 @@ settings file. Here's an explanation of all available values for
Memcached
---------
-By far the fastest, most efficient type of cache available to Django,
-Memcached__ is an entirely memory-based cache framework originally developed to
-handle high loads at LiveJournal.com and subsequently open-sourced by Danga
-Interactive. It is used by sites such as Facebook and Wikipedia to reduce
-database access and dramatically increase site performance.
+The fastest, most efficient type of cache supported natively by Django,
+Memcached__ is an entirely memory-based cache server, originally developed
+to handle high loads at LiveJournal.com and subsequently open-sourced by
+Danga Interactive. It is used by sites such as Facebook and Wikipedia to
+reduce database access and dramatically increase site performance.
__ http://memcached.org/
-Memcached runs as a daemon and is allotted a specified amount of RAM. All it does is
-provide a fast interface for adding, retrieving and deleting arbitrary data in
-the cache. All data is stored directly in memory, so there's no overhead of
+Memcached runs as a daemon and is allotted a specified amount of RAM. All it
+does is provide a fast interface for adding, retrieving and deleting data in
+the cache. All data is stored directly in memory, so there's no overhead of
database or filesystem usage.
-After installing Memcached itself, you'll need to install a memcached
-binding. There are several python memcached bindings available; the
+After installing Memcached itself, you'll need to install a Memcached
+binding. There are several Python Memcached bindings available; the
two most common are `python-memcached`_ and `pylibmc`_.
.. _`python-memcached`: ftp://ftp.tummy.com/pub/python-memcached/
@@ -114,12 +114,13 @@ In this example, Memcached is available through a local Unix socket file
}
}
-One excellent feature of Memcached is its ability to share cache over multiple
-servers. This means you can run Memcached daemons on multiple machines, and the
-program will treat the group of machines as a *single* cache, without the need
-to duplicate cache values on each machine. To take advantage of this feature,
-include all server addresses in :setting:`LOCATION <CACHES-LOCATION>`, either
-separated by semicolons or as a list.
+One excellent feature of Memcached is its ability to share a cache over
+multiple servers. This means you can run Memcached daemons on multiple
+machines, and the program will treat the group of machines as a *single*
+cache, without the need to duplicate cache values on each machine. To take
+advantage of this feature, include all server addresses in
+:setting:`LOCATION <CACHES-LOCATION>`, either separated by semicolons or as
+a list.
In this example, the cache is shared over Memcached instances running on IP
address 172.19.26.240 and 172.19.26.242, both on port 11211::
@@ -149,8 +150,8 @@ on the IP addresses 172.19.26.240 (port 11211), 172.19.26.242 (port 11212), and
}
}
-A final point about Memcached is that memory-based caching has one
-disadvantage: Because the cached data is stored in memory, the data will be
+A final point about Memcached is that memory-based caching has a
+disadvantage: because the cached data is stored in memory, the data will be
lost if your server crashes. Clearly, memory isn't intended for permanent data
storage, so don't rely on memory-based caching as your only data storage.
Without a doubt, *none* of the Django caching backends should be used for