[doc] added documentation for Feature example
Change-Id: I4a597a88b3ec33cd626b630c17809ea841839a09
diff --git a/plugins/org.eclipse.etrice.doc/doc/039-examples.tex b/plugins/org.eclipse.etrice.doc/doc/039-examples.tex
index b65480f..e304517 100644
--- a/plugins/org.eclipse.etrice.doc/doc/039-examples.tex
+++ b/plugins/org.eclipse.etrice.doc/doc/039-examples.tex
@@ -187,6 +187,67 @@
\item use hierarchy to group levels functionality to reusable blocks.
\end{itemize}
+\subsection{Features}
+
+This project illustrates the various ways how replication can be exploited in
+ROOM. Replication can be chosen for ports and for actor references.
+The example enumerates a number of typical combinations of the two
+possibilities.
+
+\subsubsection{Purpose}
+
+Five different ways to combine replicated ports and replicated actor references
+are shown in this example.
+
+Each of these combination consists of one ore more receivers and one or more
+senders.
+
+All five combinations are contained in the actor class \texttt{ExampleMultiplicity}.
+
+\begin{itemize}
+\item \texttt{sender1} and \texttt{receiver1} - a single sender and a single
+receiver, both with plain ports, are connected.
+\item \texttt{multiSender2} with a replication factor of 10 is connected to
+\texttt{multiReceiver2} also with a replication factor of 10 - this is
+equivalent to 10 single senders each of which is connected to one single out
+of 10 receivers
+\item \texttt{multiSender3} with a replication factor of 2 is connected to
+\texttt{receiverMultiPort3} which has a port with replication factor 2
+\item \texttt{multiSender4} with a replication factor of 10 is connected to
+\texttt{multiReceiverMultiPort4} with a replicated port with cardinality 2
+and replicated 5 times - this is equivalent to 5 receivers where each is connected
+to two senders
+\item \texttt{multiSender5} is connected to
+\begin{itemize}
+\item \texttt{receiver5} which is a simple receiver not using any replication
+\item \texttt{multiReceiver5} which is a replicated receiver
+\item \texttt{} which is not replicated but uses a replicated portreceiverMultiPort5
+\item \texttt{multiReceiverMultiPort5} which is replicated and has replicated ports
+\end{itemize}
+So \texttt{multiSender5} is connected
+\begin{itemize}
+\item once to \texttt{receiver5}
+\item three times to \texttt{multiReceiver5}
+\item two times to \texttt{receiverMultiPort5} and
+\item four times to \texttt{multiReceiverMultiPort5}
+\end{itemize}
+which totals to 10 (implicit) connections and matches the replication factor of
+10 of \texttt{multiSender5}
+\end{itemize}
+
+\subsubsection{Details}
+
+The head quarters actor of this example controls two blocks of traffic
+lights. It already has a replicated port which is now connected
+to a doubled \texttt{TrafficLightControllerWithInfrastructure}.
+The latter one
+
+\subsubsection{Noteworthy}
+
+\begin{itemize}
+\item use hierarchy to group levels functionality to reusable blocks.
+\end{itemize}
+
\section{The Java examples project}
The example project \texttt{org.eclipse.etrice.examples.java} currently contains
