From 7d378d374c490996343449bc8d13e6cfabc8ed21 Mon Sep 17 00:00:00 2001
From: Ross Churchley <ross@rosschurchley.com>
Date: Sun, 21 Feb 2016 22:41:46 -0800
Subject: [PATCH] Update documentation

Add details on conflicts with other color themes.
---
 doc/metropolistheme.dtx               | 33 +++++++++++++++++++++++++++
 source/beamercolorthememetropolis.dtx |  4 +++-
 source/beamerinnerthememetropolis.dtx |  4 +++-
 3 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/doc/metropolistheme.dtx b/doc/metropolistheme.dtx
index fb804a4..82a8c84 100644
--- a/doc/metropolistheme.dtx
+++ b/doc/metropolistheme.dtx
@@ -523,7 +523,40 @@ only alphabetic characters and do not require the expansion of any macros.
 
 
 
+\subsection{Interactions with other color themes}
 
+\themename can be used along with any other Beamer color theme, such as
+|crane| or |seahorse|. If you wish to do this, it is usually best to include
+the \themename subpackages individually so the \themename color theme is
+never loaded. Although this will disable some features, including
+|\plain| slides, it will prevent conflicts between the \themename color theme
+and your preferred theme.
+
+For example, overriding the color theme as follows may not work as expected because |\usetheme{metropolis}| loads the \themename color theme, which
+defines a relationship between the frametitle background and the primary
+palette of the theme. Since |seahorse| assumes a different relationship
+between its palettes, the result is a grey, rather than periwinkle,
+frametitle background.
+
+\begin{lstlisting}
+\usetheme{metropolis}
+\usecolortheme{seahorse}
+\end{lstlisting}
+
+The correct colors are chosen if the \themename outer, inner, and font themes
+are loaded seperately:
+
+\begin{lstlisting}
+\useoutertheme{metropolis}
+\useinnertheme{metropolis}
+\usefonttheme{metropolis}
+\usecolortheme{seahorse}   % or your preferred color theme
+\end{lstlisting}
+
+Please note that \themename may not use all the colors defined in your
+favourite Beamer color theme. In particular, \themename does not set a
+background color for the title; this will cause issues when using color themes
+like |whale| which set a white foreground for the title.
 
 
 
diff --git a/source/beamercolorthememetropolis.dtx b/source/beamercolorthememetropolis.dtx
index d1f3232..7127722 100644
--- a/source/beamercolorthememetropolis.dtx
+++ b/source/beamercolorthememetropolis.dtx
@@ -226,7 +226,9 @@
 \setbeamercolor{footnote mark}{fg=.}
 %    \end{macrocode}
 %
-% Process package options
+%
+%
+% \subsubsection{Process package options}
 %
 %    \begin{macrocode}
 \metropolis@color@setdefaults
diff --git a/source/beamerinnerthememetropolis.dtx b/source/beamerinnerthememetropolis.dtx
index 4615043..f546028 100644
--- a/source/beamerinnerthememetropolis.dtx
+++ b/source/beamerinnerthememetropolis.dtx
@@ -429,7 +429,9 @@
 }
 %    \end{macrocode}
 %
-% Process package options
+%
+%
+% \subsubsection{Process package options}
 %
 %    \begin{macrocode}
 \metropolis@inner@setdefaults