Clarify documentation of semantic colors

Signed-off-by: Thomas Sedlmayer <tsedlmayer@pmsfit.de>

Author: thomassedlmayer

osi_lane.proto

@@ -905,7 +905,10 @@ message LaneBoundary
         //
         optional Type type = 1;
 
-        // The color of the lane boundary in case of lane markings.
+        // The semantic color of the lane boundary in case of lane markings.
+        //
+        // \note The color types represent the semantic classification of
+        // lane markings only. They do not represent an actual visual appearance.
         //
         optional Color color = 2;
 
@@ -987,10 +990,13 @@ message LaneBoundary
             TYPE_STRUCTURE = 13;
         }
 
-        // The color of the lane boundary in case of a lane markings.
+        // The semantic color of the lane boundary in case of a lane markings.
         // Lane markings that alternate in color must be represented by
         // individual \c LaneBoundary segments.
         //
+        // \note The color types represent the semantic color classification of
+        // lane markings only. They do not represent an actual visual appearance.
+        //
         enum Color
         {
             // Color of marking is unknown. Value must not be used in ground

osi_roadmarking.proto

@@ -113,7 +113,11 @@ message RoadMarking
         //
         optional TrafficSign.MainSign.Classification.Type traffic_main_sign_type = 2;
 
-        // The monochrome color of the road marking.
+        // The semantic monochrome color of the road marking.
+        //
+        // \note The color types represent the semantic color classification of
+        // road markings only. They do not represent an actual visual appearance.
+
         // \note Field need not be set (or set to \c #COLOR_OTHER)
         // if road marking type does not require it (e.g. for \c #type ==
         // \c #TYPE_PAINTED_TRAFFIC_SIGN).
@@ -286,7 +290,10 @@ message RoadMarking
             TYPE_GENERIC_TEXT = 7;
         }
 
-        // Definition of road marking colors
+        // Definition of semantic road marking colors
+        //
+        // \note The color types represent the semantic classification of
+        // road markings only. They do not represent an actual visual appearance.
         //
         enum Color
         {

osi_trafficlight.proto

@@ -68,7 +68,10 @@ message TrafficLight
     //
     message Classification
     {
-        // The color of the traffic light.
+        // The semantic color of the traffic light.
+        //
+        // \note The color types represent the semantic color classification of a 
+        // traffic light only. They do not represent an actual visual appearance.
         //
         // \note If the color of the traffic light is known (from history or
         // geometrical arrangement) and the state \c #mode is
@@ -116,7 +119,10 @@ message TrafficLight
         //
         optional bool is_out_of_service = 6;
 
-        // Definition of colors for traffic lights.
+        // Definition of semantic colors for traffic lights.
+        //
+        // \note The color types represent the semantic classification of a traffic light
+        // only. They do not represent an actual visual appearance.
         //
         enum Color
         {