From 90affdd775badf64760c9fe35167979161ff49cf Mon Sep 17 00:00:00 2001
From: Johannes Pfeifer <jpfeifer@gmx.de>
Date: Wed, 29 Jun 2016 09:36:10 +0200
Subject: [PATCH] Clarify the timing convention in dynare++ Closes #1244

---
 dynare++/doc/dynare++-tutorial.tex | 8 ++++++--
 examples/dynare++/example1.mod     | 7 +++++++
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/dynare++/doc/dynare++-tutorial.tex b/dynare++/doc/dynare++-tutorial.tex
index 3f5682c5c..0661f38be 100644
--- a/dynare++/doc/dynare++-tutorial.tex
+++ b/dynare++/doc/dynare++-tutorial.tex
@@ -10,7 +10,7 @@
 
 \author{Ondra Kamen\'\i k}
 
-\date{February 2011}
+\date{February 2011, updated August 2016}
 \maketitle
 
 \tableofcontents
@@ -32,7 +32,7 @@ operating system path. This ensures that your OS will find the {\tt dynare++} ex
 
 \section{Sample Session}
 
-As an example, let us take a simple DSGE model whose dynamic
+As an example, let us take a simple DSGE model with time to build, whose dynamic
 equilibrium is described by the following first order conditions:
 
 \begin{align*}
@@ -46,6 +46,10 @@ equilibrium is described by the following first order conditions:
 \end{align*}
 
 \label{timing}
+The convention is that the timing of a variable reflects when this variable
+is decided. Dynare++ therefore uses a ``stock at the end of the
+period'' notation for predetermined state variables (see the Dynare manual for details).
+
 The timing of this model is that the exogenous shocks $\epsilon_t$,
 and $\nu_t$ are observed by agents in the beginning of period $t$ and
 before the end of period $t$ all endogenous variables with index $t$
diff --git a/examples/dynare++/example1.mod b/examples/dynare++/example1.mod
index 27ab3fd3f..b60885026 100644
--- a/examples/dynare++/example1.mod
+++ b/examples/dynare++/example1.mod
@@ -1,3 +1,10 @@
+/*
+ * This Dynare++ mod-file implements the RBC model with time-to-build
+ * described in Kamenik (2011): "DSGE Models with Dynare++. A Tutorial."
+ * Note that Dynare++ uses the same stock-at-the-end-of-period timing convention
+ * as the regular Dynare
+*/
+
 var Y, C, K, A, H, B;
 
 varexo EPS, NU;