Improved decumentation for '@' symbols in labels (STR #2940).

2 files changed, 9 insertions, 0 deletions

diff --git a/documentation/src/common.dox b/documentation/src/common.dox
index 9b6360fc5..fd39335f5 100644
--- a/documentation/src/common.dox
+++ b/documentation/src/common.dox
@@ -375,6 +375,15 @@ The @ sign may also be followed by the following optional
 Thus, to show a very large arrow pointing downward you would use the
 label string "@+92->".
 
+Symbols and text can can be combined in a label, however the symbol must be at
+the beginning and/or at the end of the text. If the text spans multiple lines,
+the symbol or symbols will scale up to match the height of all the lines.
+
+\image html symbol-examples.png "Figure 3-5: FLTK symbols and text"
+\image latex symbol-examples.png "FLTK symbols and text" width=10cm
+
+<!-- NEED 2in -->
+
 \par align()
 
 The \p align() method positions the label. The following
diff --git a/documentation/src/symbol-examples.png b/documentation/src/symbol-examples.png
new file mode 100644
index 000000000..429c1ccdc
--- /dev/null
+++ b/documentation/src/symbol-examples.png