From 8503c1247f1a508265fec3760cdbbbbe8639ad8f Mon Sep 17 00:00:00 2001 From: Darien Hager Date: Wed, 15 Jul 2015 18:58:18 -0700 Subject: [PATCH 1/2] Document return-value substitution in EntityManager::transactional() --- docs/en/reference/transactions-and-concurrency.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/en/reference/transactions-and-concurrency.rst b/docs/en/reference/transactions-and-concurrency.rst index 4dc18318e..c012d9049 100644 --- a/docs/en/reference/transactions-and-concurrency.rst +++ b/docs/en/reference/transactions-and-concurrency.rst @@ -98,6 +98,13 @@ functionally equivalent to the previously shown code looks as follows: $em->persist($user); }); +.. warning:: + + For historical reasons, ``EntityManager#transactional($func)`` will return + ``false`` whenever the return value of ``$func`` is loosely false. + Some examples of this include ``array()``, ``"0"``, ``""``, ``0``, and + ``null``. + The difference between ``Connection#transactional($func)`` and ``EntityManager#transactional($func)`` is that the latter abstraction flushes the ``EntityManager`` prior to transaction From 72d848901bf0f78247ddc479e3a2f273307acd19 Mon Sep 17 00:00:00 2001 From: Darien Hager Date: Wed, 15 Jul 2015 18:59:14 -0700 Subject: [PATCH 2/2] Add reminder to README for initializing git submodules --- docs/README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index 4315116f8..8b487b8cf 100644 --- a/docs/README.md +++ b/docs/README.md @@ -5,4 +5,13 @@ 1. Run ./bin/install-dependencies.sh 2. Run ./bin/generate-docs.sh -It will generate the documentation into the build directory of the checkout. \ No newline at end of file +It will generate the documentation into the build directory of the checkout. + + +## Theme issues + +If you get a "Theme error", check if the `en/_theme` subdirectory is empty, +in which case you will need to run: + +1. git submodule init +2. git submodule update