Regularize doxygen comments, fix typos

Author: pmai

osi_detectedlandmark.proto

@@ -15,19 +15,22 @@ message DetectedTrafficSign
 {
     // Specific ID of the traffic sign as assigned by the sensor internally.
     // Need not match with ground_truth_id.
+    //
     optional Identifier tracking_id = 2;
 
     // The ID of the original traffic sign in the ground truth.
     // In case of a ghost sign (no corresponding ground truth), this field
     // should be unset.
+    //
     optional Identifier ground_truth_id = 3;
 
     // A list of candidates for this traffic sign as estimated by the sensor.
     //    
     repeated CandidateSign candidate_sign = 4;
 
     // A list of candidates for (a) possible supplementary sign(s) as estimated
-    //     by the sensor.
+    // by the sensor.
+    //
     repeated CandidateSupplementarySign candidate_supplementary_sign = 5;
 
     // The detected geometry of the traffic sign.
@@ -39,6 +42,7 @@ message DetectedTrafficSign
     //
     // \note Use as confidence measure where a low value means less confidence
     // and a high value indicates strong confidence.
+    //
     optional double existence_probability = 7;
 
     // The measurement state.
@@ -47,6 +51,7 @@ message DetectedTrafficSign
 
     // The root mean squared error of the base parameters of the detected
     // traffic sign.
+    //
     optional BaseStationary rmse = 9;
 
     // Links to the corresponding lanes.
@@ -61,6 +66,7 @@ message DetectedTrafficSign
     // \note This information can be determined via the detected entities'
     // detections ( \c ...Detection::object_id = 'this detected entity' ) and
     // the sensors (their IDs) to which these detections belong.
+    //
     repeated Identifier sensor_id = 11;    
 
     // Definition of traffic sign geometries.
@@ -69,6 +75,7 @@ message DetectedTrafficSign
     {
         // Geometry of the traffic sign is unknown (must not be used in ground
         // truth).
+        //
         GEOMETRY_UNKNOWN = 0;
 
         // Geometry of the traffic sign is unspecified (but known).
@@ -109,14 +116,17 @@ message DetectedTrafficSign
 
         // Traffic sign has a rectangle geometry. (width is bigger than height)
         // E.g. one-way
+        //
         GEOMETRY_RECTANGLE = 10;
 
         // Traffic sign that has a pole geometry. (height is bigger than width)
         // E.g. pole indicating highways exit in xx m.
+        //
         GEOMETRY_POLE = 11;
 
         // Traffic sign that has an oversize rectangle geometry.
         // E.g. direction plates on highway or city signs.
+        //
         GEOMETRY_PLATE = 12;
     }
 }
@@ -129,10 +139,12 @@ message CandidateSign
     // The definition of the candidate's properties.
     // The sign.id values of all \c CandidateSign within one
     // \c DetectedTrafficSign correspond to the tracking ID and must be identical.
+    //
     optional TrafficSign sign = 1;
 
     // The estimated probability that this candidate is the true value.
     // Range [0,1]. The sum of all candidate_probabilities must be one.
+    //
     optional double candidate_probability = 2;
 
     // The amount of time that this detected object has been currently 
@@ -149,10 +161,12 @@ message CandidateSupplementarySign
 {
     // The definition of one of more supplementary signs that together define
     // this candidate.
+    //
     repeated SupplementarySign sign = 1;
 
     // The estimated probability that this candidate is the true value.
     // Range [0,1]. The sum of all candidate_probabilities must be one.
+    //
     optional double candidate_probability = 2;
 
     // The amount of time that this detected object has been currently 
@@ -169,11 +183,13 @@ message DetectedTrafficLight
 {
     // Specific ID of the traffic light as assigned by the sensor internally.
     // Need not match with ground_truth_id.
+    //
     optional Identifier tracking_id = 2;
 
     // The ID of the original traffic light in the ground truth.
     // In case of a ghost detection (no corresponding ground truth), this field
     // should be unset.
+    //
     optional Identifier ground_truth_id = 3;
 
     // Description of the detected traffic light.
@@ -193,6 +209,7 @@ message DetectedTrafficLight
     //
     // \note Use as confidence measure where a low value means less confidence
     // and a high value indicates strong confidence.
+    //
     optional double existence_probability = 7;
 
     // The measurement state.
@@ -201,6 +218,7 @@ message DetectedTrafficLight
 
     // The root mean squared error of the base parameters of the detected
     // traffic light.
+    //
     optional BaseStationary rmse = 9;
 
     // A list of sensors which detected this detected entity.
@@ -211,6 +229,7 @@ message DetectedTrafficLight
     // \note This information can be determined via the detected entities'
     // detections ( \c ...Detection::object_id = 'this detected entity' ) and
     // the sensors (their IDs) to which these detections belong.
+    //
     repeated Identifier sensor_id = 10;    
 
     //
@@ -233,15 +252,19 @@ message DetectedTrafficLight
             // Direction is unknown (must not be used in ground truth).
             //
             DIRECTION_UNKNOWN = 0;
+
             // Other (unspecified but known) direction.
             //
             DIRECTION_OTHER = 1;
+
             // Direction is straight.
             //
             DIRECTION_STRAIGHT = 2;
+
             // Direction is left.
             //
             DIRECTION_LEFT = 3;
+
             // Direction is right.
             //
             DIRECTION_RIGHT = 4;
@@ -270,11 +293,13 @@ message DetectedRoadMarking
 {
     // Specific ID of the road marking as assigned by the sensor internally.
     // Need not match with ground_truth_id.
+    //
     optional Identifier tracking_id = 2;
 
     // The ID of the original road marking in the ground truth.
     // In case of a ghost detection (no corresponding ground truth), this field
     // should be unset.
+    //
     optional Identifier ground_truth_id = 3;
 
     // A list of candidates for this road marking as estimated by the sensor.
@@ -286,6 +311,7 @@ message DetectedRoadMarking
     //
     // \note Use as confidence measure where a low value means less confidence
     // and a high value indicates strong confidence.
+    //
     optional double existence_probability = 5;
 
     // Links to the corresponding lanes.
@@ -298,6 +324,7 @@ message DetectedRoadMarking
 
     // The root mean squared error of the base parameters of the detected road
     // marking.
+    //
     optional BaseStationary rmse = 8;
 
     // A list of sensors which detected this detected entity.
@@ -308,6 +335,7 @@ message DetectedRoadMarking
     // \note This information can be determined via the detected entities'
     // detections ( \c ...Detection::object_id = 'this detected entity' ) and
     // the sensors (their IDs) to which these detections belong.
+    //
     repeated Identifier sensor_id = 11;    
 }
 
@@ -322,6 +350,7 @@ message CandidateRoadMarking
 
     // The estimated probability that this candidate is the true value.
     // Range [0,1]. The sum of all candidate_probabilities must be one.
+    //
     optional double candidate_probability = 2;
 
     // The amount of time that this detected object has been currently 

osi_sensordata.proto

@@ -28,8 +28,9 @@ message SensorData
 {  
     // The ID of the sensor at host vehicle's mounting_position.
     //
-    // This ID can equal \c DetectionHeader::sensor_id, if SensorData hold only
+    // This ID can equal \c DetectionHeader::sensor_id, if SensorData holds only
     // data from one sensor/sensor model.
+    //
     optional Identifier sensor_id = 1;
 
     // The timestamp of the sensor data. Zero time is arbitrary but must be
@@ -56,6 +57,7 @@ message SensorData
     // For a sensor model that does not know its own internal latencies (e.g.
     // a dumb sensor with no internal time concept), the two timestamps might
     // also be identical, but delayed from the GroundTruth timestamp.
+    //
     optional Timestamp timestamp = 2;
 
     // Ground truth w.r.t. global coordinate system
@@ -185,6 +187,7 @@ message SensorData
     // Host vehicle data is data that the host vehicle knows about itself,
     // e.g. from location sensors, internal sensors and ECU bus data, etc.,
     // that is made available to sensors as input.
+    //
     optional HostVehicleData host_vehicle_data_id = 18;
 }
 
@@ -199,6 +202,7 @@ message DetectedEntityHeader
     //
     // \note See SensorData::timestamp and SensorData::last_measurement_time
     // for detailed discussions on the semantics of time-related fields.
+    //
     optional Timestamp measurement_time = 1;
 
     // Continuous up counter to identify the cycle.
@@ -207,6 +211,7 @@ message DetectedEntityHeader
 
     // Data Qualifier expresses to what extent the content of this event can be
     // relied on.
+    //
     optional DataQualifier data_qualifier = 3;
 
     //