From 6f76e317b0cfbc88a94c3490bf8e44b457ed247a Mon Sep 17 00:00:00 2001
From: Ross Churchley <ross@rosschurchley.com>
Date: Mon, 13 Jun 2016 23:28:04 -0700
Subject: [PATCH] Add to docs tip for standout frames with org-mode

Fix #203
---
 doc/metropolistheme.dtx | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/doc/metropolistheme.dtx b/doc/metropolistheme.dtx
index 4baf260..6bc0dff 100644
--- a/doc/metropolistheme.dtx
+++ b/doc/metropolistheme.dtx
@@ -630,6 +630,39 @@ on each slide.
 \end{lstlisting}
 
 
+\subsection{Standout frames with labels}
+
+Because the |standout| frame option creates a group to restrict the colour
+change to a single slide, labels defined after calling |standout| will stay
+local to the group. In other words, the following may result in a ``label undefined'' error.
+
+\begin{lstlisting}
+\begin{frame}[standout, label=conclusion]{Conclusion}
+  Awesome slide
+\end{frame}
+\end{lstlisting}
+
+To fix this problem, change the order of the keys in the frame.
+
+\begin{lstlisting}
+\begin{frame}[label=conclusion, standout]{Conclusion}
+    Awesome slide
+\end{frame}
+\end{lstlisting}
+
+This error can be unwittingly triggered if you export your slides from Emacs
+Org mode, which automatically adds labels after frame options. Alex Branham
+\href{https://github.com/matze/mtheme/issues/203}{offers} the following
+solution for Org mode users, using |org-set-property|.
+
+\begin{lstlisting}
+* Start of a frame
+   :PROPERTIES:
+   :BEAMER_opt: label=conclusion,standout
+   :END:
+\end{lstlisting}
+
+
 \section{License}
 
 \themename is licensed under a