colored-boxes.lyx: add section about references

is a user request

lib/examples/colored-boxes.lyx

@@ -127,6 +127,15 @@ Description of the module Fancy Colored Boxes
 Uwe Stöhr
 \end_layout
 
+\begin_layout Standard
+\begin_inset CommandInset toc
+LatexCommand tableofcontents
+
+\end_inset
+
+
+\end_layout
+
 \begin_layout Standard
 With the module 
 \emph on
@@ -1786,6 +1795,102 @@ beamer
 
 \end_layout
 
+\begin_layout Subsection
+References
+\end_layout
+
+\begin_layout Standard
+You cannot use \SpecialChar LyX
+'s label/reference mechanisms for fancy colored boxes.
+ Numbered boxes can be referenced by adding
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+, label={name}
+\end_layout
+
+\begin_layout Standard
+to the the 
+\family sans
+Color Box Options
+\family default
+ inset, whereby 
+\series bold
+name
+\series default
+ is the label name used to reference the box.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Custom Color Box 2
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Mass–energy equivalence, label={Einstein}
+\end_layout
+
+\end_inset
+
+
+\begin_inset Formula 
+\[
+E=mc^{2}.
+\]
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To reference the box, insert the command
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+ref{name}
+\end_layout
+
+\begin_layout Standard
+as \SpecialChar TeX
+ code to the text where the reference should appear.
+\end_layout
+
+\begin_layout Standard
+This is the reference to Example
+\begin_inset space \space{}
+\end_inset
+
+
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+ref{Einstein}
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
 \begin_layout Subsection
 Skins
 \end_layout
@@ -1821,6 +1926,13 @@ literal "true"
  Only the most important skins are listed in the following.
 \end_layout
 
+\begin_layout Standard
+\begin_inset Newpage newpage
+\end_inset
+
+
+\end_layout
+
 \begin_layout Subsubsection
 Enhanced
 \begin_inset CommandInset label

status.23x

@@ -35,6 +35,8 @@ What's new
 
 * DOCUMENTATION AND LOCALIZATION
 
+- New section about references in the example file colored-boxes.lyx.
+
 - The Dutch user interface localization has been revived, and the Dutch docs
   revised.