Update lang-specific docs.

Author: guzman-raphael

docs-parts/manipulation/1-Update_lang1.rst

@@ -1,8 +1,14 @@
 
 .. code-block:: python
 
-  # update value in record with id=1
+  # with record as a dict specifying the primary and
+  # secondary attribute values
+  table.update1(record)
+
+  # update value in record with id as primary key
   table.update1({'id': 1, 'value': 3})
 
-  # reset value to default
+  # reset value to default with id as primary key
   table.update1({'id': 1, 'value': None})
+  ## OR
+  table.update1({'id': 1})

docs-parts/queries/12-Query-Caching_lang1.rst

@@ -0,0 +1,15 @@
+
+.. code-block:: python
+
+  # set the query cache path
+  dj.config['query_cache'] = os.path.expanduser('~/dj_query_cache')
+
+  # access the currently active connection object
+  conn = dj.conn()
+  ## OR
+  conn = schema.connection
+  ## OR
+  conn = table.connection
+
+  # activate query caching for a namespace called 'main'
+  conn.set_query_cache(query_cache='main')

docs-parts/queries/12-Query-Caching_lang2.rst

@@ -0,0 +1,7 @@
+
+.. code-block:: python
+
+  # deactivate query caching
+  conn.set_query_cache(query_cache=None)
+  ## OR
+  conn.set_query_cache()

docs-parts/queries/12-Query-Caching_lang3.rst

@@ -0,0 +1,6 @@
+
+.. code-block:: python
+
+  # deactivate query caching
+  conn.purge_query_cache(query_cache='main')
+

dev_guide/transpiler_specs.md …ts/queries/13-Transpiler-Design_lang1.mddev_guide/transpiler_specs.md renamed to docs-parts/queries/13-Transpiler-Design_lang1.md dev_guide/transpiler_specs.md renamed to docs-parts/queries/13-Transpiler-Design_lang1.md

@@ -1,6 +1,3 @@
-# Design specifications of the DataJoint-to-SQL Transpiler
-This document contains information and reasoning that went into the design of the DataJoint-to-SQL transpiler for DataJoint for Python version 0.13.
-
 MySQL appears to differ from standard SQL by the sequence of evaluating the clauses of the SELECT statement.
 
 ```