From 1026bd5c822bd7aac9502b2779af2587fef471e3 Mon Sep 17 00:00:00 2001
From: Juergen Borleis <jbe@pengutronix.de>
Date: Sat, 31 Jan 2015 06:30:29 +0100
Subject: Docu/Platform: add info about Linux version and OSELAS.Toolchain
 relationship

Signed-off-by: Juergen Borleis <jbe@pengutronix.de>
---
 Changelog                                     |  4 +++-
 documentation/plain_sources/special_notes.tex | 23 +++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/Changelog b/Changelog
index 13e4d29..e49a60e 100644
--- a/Changelog
+++ b/Changelog
@@ -1,6 +1,8 @@
 2015-01-31	Juergen Borleis <jbe@pengutronix.de
 
-	* Board Support Package: fix line break
+	* Board Support Package:
+		- fix line break
+		- add info about Linux version and OSELAS.Toolchain relationship
 
 2015-01-26	Juergen Borleis <jbe@pengutronix.de
 
diff --git a/documentation/plain_sources/special_notes.tex b/documentation/plain_sources/special_notes.tex
index 3e8b284..f9e6737 100644
--- a/documentation/plain_sources/special_notes.tex
+++ b/documentation/plain_sources/special_notes.tex
@@ -97,6 +97,29 @@ for reference for the \textit{bz2} format.
 	\item 2.6.38: \texttt{7d471477bfa67546f902da62227fa976}
 \end{itemize}
 
+\begin{important}
+Be aware of a specific kernel and toolchain relationship. Our OSELAS toolchains
+are configured to create code which has minimal run-time requirements to the
+Linux kernel version. The currently configured OSELAS.Toolchain release creates
+code which needs at least a Linux-\ptxdistMinimalToolchainKernel{} at runtime.
+\end{important}
+
+If you want to keep an older Linux version, you must change back to an older
+OSELAS.Toolchain release. Here is a list of OSELAS.Toolchain releases and their
+minimal Linux kernel run-time requirements:
+
+\begin{itemize}
+	\item OSELAS.Toolchain-2014.12.x: Linux-3.16
+	\item OSELAS.Toolchain-2013.12.x: Linux-3.12
+	\item OSELAS.Toolchain-2012.12.x: Linux-3.6
+	\item OSELAS.Toolchain-2011.11.x: Linux-2.6.39
+	\item OSELAS.Toolchain-2011.03.x: Linux-2.6.36
+\end{itemize}
+
+Please note: we only do build tests with the most recent OSELAS.Toolchain
+release. If you change back to an older OSELAS.Toolchain version building the
+BSP may fail.
+
 % ----------------------------------------------------------------------------
 
 \section{Available Userland Configuration}	\label{sec:userland}
-- 
cgit v1.2.3