Fix (-W)documentation error found by Clang

packet-bacapp.c:78:13: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tvb
   ~~~~~~~~~^
packet-bacapp.c:79:15: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param pinfo
   ~~~~~~~~~~~^
packet-bacapp.c:80:14: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tree
   ~~~~~~~~~~^
packet-bacapp.c:100:13: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tvb
   ~~~~~~~~~^
packet-bacapp.c:101:15: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param pinfo
   ~~~~~~~~~~~^
packet-bacapp.c:102:14: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tree
   ~~~~~~~~~~^
packet-bacapp.c:103:16: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param offset
   ~~~~~~~~~~~~^
packet-bacapp.c:110:13: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tvb
   ~~~~~~~~~^
packet-bacapp.c:111:15: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param pinfo
   ~~~~~~~~~~~^
packet-bacapp.c:112:14: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tree
   ~~~~~~~~~~^
packet-bacapp.c:113:16: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param offset
   ~~~~~~~~~~~~^
packet-bacapp.c:130:13: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tvb
   ~~~~~~~~~^
packet-bacapp.c:131:15: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param pinfo
   ~~~~~~~~~~~^
packet-bacapp.c:132:14: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tree
   ~~~~~~~~~~^
packet-bacapp.c:133:16: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param offset
   ~~~~~~~~~~~~^
packet-bacapp.c:146:13: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tvb
   ~~~~~~~~~^
packet-bacapp.c:147:15: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param pinfo
   ~~~~~~~~~~~^
packet-bacapp.c:148:14: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param tree
   ~~~~~~~~~~^
packet-bacapp.c:149:16: error: empty paragraph passed to '@param' command [-Werror,-Wdocumentation]
 * @param offset
   ~~~~~~~~~~~~^

packet-bacapp.c:251:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:263:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:275:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:288:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:300:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:325:24: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param service_choice
   ~~~~~~~~~~~~~~~~~~~~^
packet-bacapp.c:338:24: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param service_choice
   ~~~~~~~~~~~~~~~~~~~~^
packet-bacapp.c:521:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^
packet-bacapp.c:522:13: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param src
   ~~~~~~~~~^
packet-bacapp.c:521:11: error: parameter 'label' not found in the function
      declaration [-Werror,-Wdocumentation]
 * @param label
          ^~~~~
packet-bacapp.c:522:11: error: parameter 'src' not found in the function
      declaration [-Werror,-Wdocumentation]
 * @param src
          ^~~
packet-bacapp.c:654:11: error: parameter 'tree' not found in the function
      declaration [-Werror,-Wdocumentation]
 * @param tree the tree to append this item to
          ^~~~
packet-bacapp.c:654:11: note: did you mean 'subtree'?
 * @param tree the tree to append this item to
          ^~~~
          subtree
packet-bacapp.c:723:11: error: parameter 'tree' not found in the function
      declaration [-Werror,-Wdocumentation]
 * @param tree the tree to append this item to
          ^~~~
packet-bacapp.c:723:11: note: did you mean 'subtree'?
 * @param tree the tree to append this item to
          ^~~~
          subtree
packet-bacapp.c:749:11: error: parameter 'tree' not found in the function
      declaration [-Werror,-Wdocumentation]
 * @param tree the tree to append this item to
          ^~~~
packet-bacapp.c:749:11: note: did you mean 'subtree'?
 * @param tree the tree to append this item to
          ^~~~
          subtree
packet-bacapp.c:1076:24: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param service_choice
   ~~~~~~~~~~~~~~~~~~~~^
packet-bacapp.c:1266:17: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param service
   ~~~~~~~~~~~~~^
packet-bacapp.c:1337:4: error: unknown command tag name 'pram'; did you mean
      'param'? [-Werror,-Wdocumentation]
 * @pram pinfo
   ^~~~~
    param
packet-bacapp.c:1337:14: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @pram pinfo
         ~~~~^
packet-bacapp.c:1366:15: error: empty paragraph passed to '@param' command
      [-Werror,-Wdocumentation]
 * @param label
   ~~~~~~~~~~~^

svn path=/trunk/; revision=51261

1 files changed, 509 insertions, 512 deletions

diff --git a/epan/dissectors/packet-bacapp.c b/epan/dissectors/packet-bacapp.c
index d387fc1b2d..6e413ac2a9 100644
--- a/epan/dissectors/packet-bacapp.c
+++ b/epan/dissectors/packet-bacapp.c
@@ -75,9 +75,9 @@ static int bacapp_tap = -1;
  *  reject-PDU                  [6] BACnet-Reject-PDU,
  *  abort-PDU                   [7] BACnet-Abort-PDU
  * }
- * @param tvb
- * @param pinfo
- * @param tree
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
  **/
 static void
 dissect_bacapp(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
@@ -97,20 +97,20 @@ dissect_bacapp(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
  *  service-choice              [9] BACnetConfirmedServiceChoice,
  *  service-request             [10] BACnet-Confirmed-Service-Request OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
 fConfirmedRequestPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
 
 /**
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @param ack - indocates whether working on request or ack
  * @param svc - output variable to return service choice
  * @param tt  - output varable to return service choice item
@@ -127,10 +127,10 @@ fStartConfirmed(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  service-choice  [2] BACnetUnconfirmedServiceChoice,
  *  service-request [3] BACnetUnconfirmedServiceRequest -- Context-specific tags 0..3 are NOT used in header encoding
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -143,10 +143,10 @@ fUnconfirmedRequestPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guin
  *  invokeID            [2] Unsigned (0..255),
  *  service-ACK-choice  [3] BACnetUnconfirmedServiceChoice -- Context-specific tags 0..3 are NOT used in header encoding
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -164,10 +164,10 @@ fSimpleAckPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset)
  *  service-ACK-choice      [7] BACnetConfirmedServiceChoice,
  *  service-ACK             [8] BACnet-Confirmed-Service-Request  -- Context-specific tags 0..8 are NOT used in header encoding
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -183,10 +183,10 @@ fComplexAckPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset
  *  sequence-number         [5] Unsigned (0..255),
  *  actual-window-size      [6] Unsigned (0..127)
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -200,10 +200,10 @@ fSegmentAckPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset
  *  error-choice            [3] BACnetConfirmedServiceChoice,
  *  error                   [4] BACnet-Error
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -216,10 +216,10 @@ fErrorPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  original-invokeID       [2] Unsigned (0..255),
  *  reject-reason           [3] BACnetRejectReason
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -233,10 +233,10 @@ fRejectPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  original-invokeID       [3] Unsigned (0..255),
  *  abort-reason            [4] BACnetAbortReason
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -244,11 +244,11 @@ fAbortPDU(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
 
 /**
  * 20.2.4, adds the label with max 64Bit unsigned Integer Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -256,11 +256,11 @@ fUnsignedTag (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset,
 
 /**
  * 20.2.5, adds the label with max 64Bit signed Integer Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -268,11 +268,11 @@ fSignedTag (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset, c
 
 /**
  * 20.2.8, adds the label with Octet String to tree; if lvt == 0 then lvt = restOfFrame
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @param lvt length of String
  * @return modified offset
  */
@@ -281,11 +281,11 @@ fOctetString (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset,
 
 /**
  * 20.2.12, adds the label with Date Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -293,11 +293,11 @@ fDate    (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset, con
 
 /**
  * 20.2.13, adds the label with Time Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -306,10 +306,10 @@ fTime (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset, const
 /**
  * 20.2.14, adds Object Identifier to tree
  * use BIG ENDIAN: Bits 31..22 Object Type, Bits 21..0 Instance Number
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -318,11 +318,11 @@ fObjectIdentifier (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint of
 /**
  * BACnet-Confirmed-Service-Request ::= CHOICE {
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param service_choice
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param service_choice the service choice
  * @return offset
  */
 static guint
@@ -331,11 +331,11 @@ fConfirmedServiceRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
 /**
  * BACnet-Confirmed-Service-ACK ::= CHOICE {
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param service_choice
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param service_choice the service choice
  * @return offset
  */
 static guint
@@ -350,10 +350,10 @@ fConfirmedServiceAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  acknowledgementSource          [4] Character String,
  *  timeOfAcknowledgement          [5] BACnetTimeStamp
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -367,10 +367,10 @@ fAcknowledgeAlarmRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
  *  timeRemaining               [3] unsigned,
  *  listOfValues                [4] SEQUENCE OF BACnetPropertyValues
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -392,10 +392,10 @@ fConfirmedCOVNotificationRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree
  *  toState                    [11] BACnetEventState,
  *  eventValues                [12] BACnetNotificationParameters OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -407,10 +407,10 @@ fConfirmedEventNotificationRequest (tvbuff_t *tvb, packet_info *pinfo,  proto_tr
  *  alarmState               BACnetEventState,
  *  acknowledgedTransitions  BACnetEventTransitionBits
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -438,10 +438,10 @@ fGetAlarmSummaryAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *      } OPTIONAL,
  *  notificationClassFilter [5] Unsigned OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -455,10 +455,10 @@ fGetEnrollmentSummaryRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tre
  *  priority            Unsigned8,
  *  notificationClass   Unsigned OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -468,10 +468,10 @@ fGetEnrollmentSummaryAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
  * GetEventInformation-Request ::= SEQUENCE {
  *  lastReceivedObjectIdentifier    [0] BACnetObjectIdentifer
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -482,10 +482,10 @@ fGetEventInformationRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree
  *  listOfEventSummaries [0] listOfEventSummaries,
  *  moreEvents           [1] BOOLEAN
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -498,10 +498,10 @@ fGetEventInformationACK (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, gu
  *  request                     [2] BACnetLifeSafetyOperation
  *  objectIdentifier            [3] BACnetObjectIdentifier OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -514,12 +514,10 @@ fLifeSafetyOperationRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
  *  issueConfirmedNotifications [2] BOOLEAN OPTIONAL
  *  lifetime                    [3] Unsigned OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
- * @param src
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -534,10 +532,10 @@ fSubscribeCOVRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  monitoredPropertyIdentifier [4] BACnetPropertyReference OPTIONAL
  *  covIncrement                [5] Unsigned OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -557,10 +555,10 @@ fSubscribeCOVPropertyRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree
  *          }
  *      }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -581,10 +579,10 @@ fAtomicReadFileRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guin
  *          }
  *      }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -605,10 +603,10 @@ fAtomicReadFileAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
  *          }
  *      }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -619,10 +617,10 @@ fAtomicWriteFileRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, gui
  *      fileStartPosition [0] INTEGER,
  *      fileStartRecord   [1] INTEGER,
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -635,10 +633,10 @@ fAtomicWriteFileAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  propertyArrayIndex [2] Unsigned OPTIONAL, -- used only with array datatype
  *  listOfElements     [3] ABSTRACT-SYNTAX.&Type
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -649,10 +647,10 @@ fAddListElementRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guin
  *  objectSpecifier     [0] ObjectSpecifier,
  *  listOfInitialValues [1] SEQUENCE OF BACnetPropertyValue OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the sub tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -660,10 +658,10 @@ fCreateObjectRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *subtree, gui
 
 /**
  * CreateObject-Request ::= BACnetObjectIdentifier
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -673,10 +671,10 @@ fCreateObjectAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint off
  * DeleteObject-Request ::= SEQUENCE {
  *  ObjectIdentifier    BACnetObjectIdentifer
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -688,10 +686,10 @@ fDeleteObjectRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  propertyIdentifier  [1] BACnetPropertyIdentifier,
  *  propertyArrayIndex  [2] Unsigned OPTIONAL, -- used only with array datatype
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -704,10 +702,10 @@ fReadPropertyRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  propertyArrayIndex [2] Unsigned OPTIONAL, -- used only with array datatype
  *  propertyValue      [3] ABSTRACT-SYNTAX.&Type
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -718,10 +716,10 @@ fReadPropertyAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint off
  *  objectSelectionCriteria  [0] objectSelectionCriteria,
  *  listOfPropertyReferences [1] SEQUENCE OF BACnetPropertyReference OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the  sub tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -731,10 +729,10 @@ fReadPropertyConditionalRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *s
  * ReadPropertyConditional-ACK ::= SEQUENCE {
  *  listOfPReadAccessResults    SEQUENCE OF ReadAccessResult OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -744,10 +742,10 @@ fReadPropertyConditionalAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree
  * ReadPropertyMultiple-Request ::= SEQUENCE {
  *  listOfReadAccessSpecs   SEQUENCE OF ReadAccessSpecification
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the sub tree to append this item to
+ * @param offset the offset in the tvb
  * @return offset modified
  */
 static guint
@@ -757,10 +755,10 @@ fReadPropertyMultipleRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *subt
  * ReadPropertyMultiple-Ack ::= SEQUENCE {
  *  listOfReadAccessResults SEQUENCE OF ReadAccessResult
  * }
- * @param tvb
+ * @param tvb the tv buffer of the current data
  * @parma pinfo
- * @param tree
- * @param offset
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return offset modified
  */
 static guint
@@ -786,10 +784,10 @@ fReadPropertyMultipleAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
  *          },
  *      } OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -804,10 +802,10 @@ fReadRangeRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint of
  *  itemCount          [4] Unsigned,
  *  itemData           [5] SEQUENCE OF ABSTRACT-SYNTAX.&Type
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -820,10 +818,10 @@ fReadRangeAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset
  *  propertyArrayIndex  [2] Unsigned OPTIONAL, -- used only with array datatype
  *  listOfElements  [3] ABSTRACT-SYNTAX.&Type
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -837,10 +835,10 @@ fRemoveListElementRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
  *  propertyValue      [3] ABSTRACT-SYNTAX.&Type
  *  priority           [4] Unsigned8 (1..16) OPTIONAL --used only when property is commandable
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -850,10 +848,10 @@ fWritePropertyRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  * WritePropertyMultiple-Request ::= SEQUENCE {
  *  listOfWriteAccessSpecifications SEQUENCE OF WriteAccessSpecification
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -868,10 +866,10 @@ fWritePropertyMultipleRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tre
  *      },
  *  password        [2] CharacterString (SIZE(1..20)) OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -883,10 +881,10 @@ fDeviceCommunicationControlRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree
  *  serviceNumber     [1] Unsigned,
  *  serviceParameters [2] ABSTRACT-SYNTAX.&Type OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -898,10 +896,10 @@ fConfirmedPrivateTransferRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *
  *  serviceNumber [1] Unsigned,
  *  resultBlock   [2] ABSTRACT-SYNTAX.&Type OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -920,10 +918,10 @@ fConfirmedPrivateTransferAck(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree
  *      },
  *  message [3] CharacterString
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -942,10 +940,10 @@ fConfirmedTextMessageRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree
  *      },
  *  password                    [1] CharacterString (SIZE(1..20)) OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -956,10 +954,10 @@ fReinitializeDeviceRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
  *  vtClass BACnetVTClass,
  *  localVTSessionIdentifier    Unsigned8
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -969,10 +967,10 @@ fVtOpenRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset
  * VTOpen-ACK ::= SEQUENCE {
  *  remoteVTSessionIdentifier   Unsigned8
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -982,10 +980,10 @@ fVtOpenAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  * VTClose-Request ::= SEQUENCE {
  *  listOfRemoteVTSessionIdentifiers    SEQUENCE OF Unsigned8
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -997,10 +995,10 @@ fVtCloseRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *  vtNewData           OCTET STRING,
  *  vtDataFlag          Unsigned (0..1)
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1011,10 +1009,10 @@ fVtDataRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  allNewDataAccepted  [0] BOOLEAN,
  *  acceptedOctetCount  [1] Unsigned OPTIONAL -- present only if allNewDataAccepted = FALSE
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1028,10 +1026,10 @@ fVtDataAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  operatorPassword       [3] CharacterString (SIZE(1..20)) OPTIONAL,
  *  startEncypheredSession [4] BOOLEAN OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1041,10 +1039,10 @@ fAuthenticateRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  * Authenticate-ACK ::= SEQUENCE {
  *  modifiedRandomNumber    Unsigned32,
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1057,10 +1055,10 @@ fAuthenticateAck (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint off
  *  remoteDeviceIdentifier     BACnetObjectIdentifier,
  *  remoteDeviceAddress        BACnetAddress
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1069,11 +1067,11 @@ fRequestKeyRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
 /**
  * Unconfirmed-Service-Request ::= CHOICE {
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param service_choice
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param service_choice the service choice
  * @return modified offset
  */
 static guint
@@ -1087,10 +1085,10 @@ fUnconfirmedServiceRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
  *  timeRemaining               [3] unsigned,
  *  listOfValues                [4] SEQUENCE OF BACnetPropertyValues
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1112,10 +1110,10 @@ fUnconfirmedCOVNotificationRequest (tvbuff_t *tvb, packet_info *pinfo, proto_tre
  *  toState                    [11] BACnetEventState,
  *  eventValues                [12] BACnetNotificationParameters OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1128,10 +1126,10 @@ fUnconfirmedEventNotificationRequest (tvbuff_t *tvb, packet_info *pinfo, proto_t
  *  segmentationSupported   BACnetSegmentation,
  *  vendorID    Unsigned
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1144,10 +1142,10 @@ fIAmRequest  (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset)
  *  objectIdentifier  BACnetObjectIdentifier,
  *  objectName        CharacterString
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1159,10 +1157,10 @@ fIHaveRequest  (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  serviceNumber     [1] Unsigned,
  *  serviceParameters [2] ABSTRACT-SYNTAX.&Type OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1181,10 +1179,10 @@ fUnconfirmedPrivateTransferRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree
  *      },
  *  message                 [3] CharacterString
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1194,10 +1192,10 @@ fUnconfirmedTextMessageRequest(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tr
  * TimeSynchronization-Request ::=  SEQUENCE {
  *  BACnetDateTime
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1207,10 +1205,10 @@ fTimeSynchronizationRequest  (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tre
  * UTCTimeSynchronization-Request ::=  SEQUENCE {
  *  BACnetDateTime
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1227,10 +1225,10 @@ fUTCTimeSynchronizationRequest  (tvbuff_t *tvb, packet_info *pinfo, proto_tree *
  *      objectName                   [3] CharacterString
  *      }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1241,9 +1239,9 @@ fWhoHas (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  deviceInstanceRangeLowLimit  [0] Unsigned (0..4194303) OPTIONAL, -- must be used as a pair, see 16.9,
  *  deviceInstanceRangeHighLimit [0] Unsigned (0..4194303) OPTIONAL, -- must be used as a pair, see 16.9,
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1259,11 +1257,11 @@ fWhoIsRequest  (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  readRange               [26] ObjectAccessService-Error
  *                          [default] Error
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param service
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param service the service
  * @return modified offset
  */
 static guint
@@ -1272,10 +1270,10 @@ fBACnetError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset,
 /**
  * Dissect a BACnetError in a context tag
  *
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint fContextTaggedError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
@@ -1286,10 +1284,10 @@ static guint fContextTaggedError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *
  *    firstFailedElementNumber [1] Unsigned
  *    }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1301,10 +1299,10 @@ fChangeListError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *    firstFailedElementNumber [1] Unsigned
  *    }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1318,10 +1316,10 @@ fCreateObjectError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint of
  *    errorParameters [3] ABSTRACT-SYNTAX.&Type OPTIONAL
  *    }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1333,10 +1331,10 @@ fConfirmedPrivateTransferError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tr
  *    firstFailedWriteAttempt [1] Unsigned
  *    }
  * }
- * @param tvb
- * @pram pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1348,10 +1346,10 @@ fWritePropertyMultipleError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
  *    listOfVTSessionIdentifiers [1] SEQUENCE OF Unsigned8 OPTIONAL
  *    }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1359,11 +1357,11 @@ fVTCloseError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset)
 
 /**
  * BACnet Application Types chapter 20.2.1
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -1381,11 +1379,11 @@ fApplicationTypes   (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  quitOnFailure       [7] BOOLEAN,
  *  writeSuccessful     [8] BOOLEAN
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param matching tag number
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param tag_match the tag number
  * @return modified offset
  */
 static guint
@@ -1395,10 +1393,10 @@ fActionCommand (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  * BACnetActionList ::= SEQUENCE {
  *  action  [0] SEQUENCE of BACnetActionCommand
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1408,10 +1406,10 @@ fActionList (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  network-number  Unsigned16, -- A value 0 indicates the local network
  *  mac-address     OCTET STRING -- A string of length 0 indicates a broadcast
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1422,10 +1420,10 @@ fAddress (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  deviceObjectID  BACnetObjectIdentifier
  *  deviceAddress   BacnetAddress
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1437,10 +1435,10 @@ fAddressBinding (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *  dateRange   [1] BACnetDateRange,
  *  weekNDay    [2] BacnetWeekNday
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1451,9 +1449,9 @@ fCalendarEntry (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  real-increment  REAL,
  *  default-increment   NULL
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1464,10 +1462,10 @@ fClientCOV (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  * BACnetDailySchedule ::= SEQUENCE {
  *  day-schedule    [0] SENQUENCE OF BACnetTimeValue
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1477,10 +1475,10 @@ fDailySchedule (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  * BACnetWeeklySchedule ::= SEQUENCE {
  *  week-schedule    SENQUENCE SIZE (7) OF BACnetDailySchedule
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1491,10 +1489,10 @@ fWeeklySchedule (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *  StartDate   Date,
  *  EndDate     Date
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1505,11 +1503,11 @@ fDateRange (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  date   Date,
  *  time   Time
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -1525,10 +1523,10 @@ fDateTime (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset, co
  *  issueConfirmedNotifications BOOLEAN,
  *  transitions BACnetEventTransitionBits
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1541,10 +1539,10 @@ fDestination (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset)
  *  propertyArrayIndex  [2] Unsigend OPTIONAL,
  *  deviceIdentifier    [3] BACnetObjectIdentifier OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1556,10 +1554,10 @@ fDeviceObjectPropertyReference (tvbuff_t *tvb, packet_info *pinfo, proto_tree *t
  *  propertyIdentifier  [1] BACnetPropertyIdentifier,
  *  propertyArrayIndex  [2] Unsigend OPTIONAL,
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1570,10 +1568,10 @@ fObjectPropertyReference (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, g
  *  deviceIdentifier    [0] BACnetObjectIdentifier OPTIONAL,
  *  objectIdentifier    [1] BACnetObjectIdentifier
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1677,9 +1675,9 @@ fDeviceObjectReference (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, gui
  *      selected-flags                   [1] BACnetStatusFlags
  *   }
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1705,10 +1703,10 @@ fEventParameter (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *      }
  *  statusFlags [2] BACnetStatusFlags OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1723,10 +1721,10 @@ fLogRecord (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *      time-change  [2] REAL,
  *      }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1840,10 +1838,10 @@ fLogMultipleRecord (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
  *      referenced-flags     [1] BACnetStatusFlags
  *      },
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1855,10 +1853,10 @@ fNotificationParameters (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, gu
  *  propertyIdentifier  [1] BACnetPropertyIdentifier,
  *  propertyArrayIndex  [2] Unsigned OPTIONAL, -- used only with array datatype
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1874,9 +1872,9 @@ fBACnetObjectPropertyReference (tvbuff_t *tvb, packet_info *pinfo, proto_tree *t
  *      value              [3] ABSTRACT-SYNTAX.&Type, --any datatype appropriate for the specified property
  *      priority           [4] Unsigned (1..16) OPTIONAL
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1885,10 +1883,10 @@ fObjectPropertyValue (tvbuff_t *tvb, proto_tree *tree, guint offset);
 
 /**
  * BACnetPriorityArray ::= SEQUENCE SIZE (16) OF BACnetPriorityValue
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1902,10 +1900,10 @@ fPropertyReference (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
  *  propertyIdentifier  [0] BACnetPropertyIdentifier,
  *  propertyArrayIndex  [1] Unsigned OPTIONAL, -- used only with array datatype
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1928,10 +1926,10 @@ fRestartReason (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *      value              [2] ABSTRACT-SYNTAX.&Type, -- any datatype appropriate for the specified property
  *      priority           [3] Unsigned (1..16) OPTIONAL -- used only when property is commandable
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1946,10 +1944,10 @@ fPropertyValue (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offse
  *  device  [0] BACnetObjectIdentifier
  *  address [1] BACnetAddress
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1961,10 +1959,10 @@ fRecipient (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  recipient   [0] BACnetRecipient
  *  processID   [1] Unsigned32
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -1979,9 +1977,9 @@ fCOVSubscription (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint off
  *  sessionKey  OCTET STRING (SIZE(8)), -- 56 bits for key, 8 bits for checksum
  *  peerAddress BACnetAddress
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  * @todo check if checksum is displayed correctly
  */
@@ -1998,10 +1996,10 @@ fSessionKey (tvbuff_t *tvb, proto_tree *tree, guint offset);
  *      listOfTimeValues    [2] SEQUENCE OF BACnetTimeValue,
  *      eventPriority       [3] Unsigned (1..16)
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2013,11 +2011,11 @@ fSpecialEvent (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset
  *  sequenceNumber  [1] Unsigned (0..65535),
  *  dateTime        [2] BACnetDateTime
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param label
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
+ * @param label the label of this item
  * @return modified offset
  */
 static guint
@@ -2031,10 +2029,10 @@ fEventTimeStamps(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offs
  *  time    Time,
  *  value   ABSTRACT-SYNTAX.&Type -- any primitive datatype, complex types cannot be decoded
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2047,9 +2045,9 @@ fTimeValue (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *  remote-vtSessionID  Unsigned8,
  *  remote-vtAddress    BACnetAddress
  * }
- * @param tvb
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2069,10 +2067,10 @@ fVTSession (tvbuff_t *tvb, proto_tree *tree, guint offset);
  * -- third octet dayOfWeek (1..7) where 1 = Monday
  * -- 7 = Sunday
  * -- X'FF' = any day of week
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2090,10 +2088,10 @@ fWeekNDay (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
  *      }
  *  } OPTIONAL
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2104,10 +2102,10 @@ fReadAccessResult (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint of
  *  objectIdentifier         [0] BACnetObjectIdentifier,
  *  listOfPropertyReferences [1] SEQUENCE OF BACnetPropertyReference
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the subtree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2118,10 +2116,10 @@ fReadAccessSpecification (tvbuff_t *tvb, packet_info *pinfo, proto_tree *subtree
  *  objectIdentifier [0] BACnetObjectIdentifier,
  *  listOfProperty   [1] SEQUENCE OF BACnetPropertyValue
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the sub tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2132,8 +2130,8 @@ fWriteAccessSpecification (tvbuff_t *tvb, packet_info *pinfo, proto_tree *subtre
 
 /**
  * extracts the tag number from the tag header.
- * @param tvb "TestyVirtualBuffer"
- * @param offset in actual tvb
+ * @param tvb the tv buffer of the current data "TestyVirtualBuffer"
+ * @param offset the offset in the tvb in actual tvb
  * @return Tag Number corresponding to BACnet 20.2.1.2 Tag Number
  */
 static guint
@@ -2141,9 +2139,9 @@ fTagNo (tvbuff_t *tvb, guint offset);
 
 /**
  * splits Tag Header coresponding to 20.2.1 General Rules For BACnet Tags
- * @param tvb = "TestyVirtualBuffer"
- * @param pinfo = packet info
- * @param offset = offset in actual tvb
+ * @param tvb the tv buffer of the current data = "TestyVirtualBuffer"
+ * @param pinfo the packet info of the current data = packet info
+ * @param offset the offset in the tvb = offset in actual tvb
  * @return tag_no BACnet 20.2.1.2 Tag Number
  * @return class_tag BACnet 20.2.1.1 Class
  * @return lvt BACnet 20.2.1.3 Length/Value/Type
@@ -2156,10 +2154,10 @@ fTagHeader (tvbuff_t *tvb, packet_info *pinfo, guint offset, guint8 *tag_no, gui
 
 /**
  * adds processID with max 32Bit unsigned Integer Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2167,10 +2165,10 @@ fProcessId (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
 
 /**
  * adds timeSpan with max 32Bit unsigned Integer Value to tree
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2181,11 +2179,10 @@ fTimeSpan (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset, co
  * BACnetPropertyIdentifier::= ENUMERATED {
  *   @see bacapp_property_identifier
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
- * @param tt returnvalue of this item
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2196,10 +2193,10 @@ fPropertyIdentifier (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  * BACnetPropertyArrayIndex::= ENUMERATED {
  *   @see bacapp_property_array_index
  * }
- * @param tvb
- * @param tree
- * @param offset
- * @param tt returnvalue of this item
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2215,10 +2212,10 @@ fPropertyArrayIndex (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint
  *  eventEnable             [5] BACnetEventTransitionBits,
  *  eventPriorities         [6] SEQUENCE SIZE (3) OF Unsigned
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2231,10 +2228,10 @@ flistOfEventSummaries (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guin
  *  relationSpecifier  [2] ENUMERATED { bacapp_relationSpecifier },
  *  comparisonValue    [3] ABSTRACT-SYNTAX.&Type
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2245,10 +2242,10 @@ fSelectionCriteria (tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
  *  selectionLogic          [0] ENUMERATED { bacapp_selectionLogic },
  *  listOfSelectionCriteria [1] SelectionCriteria
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param subtree the sub tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2260,10 +2257,10 @@ fObjectSelectionCriteria (tvbuff_t *tvb, packet_info *pinfo, proto_tree *subtree
  *    error-code  ENUMERATED {}
  *    }
  * }
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  */
 static guint
@@ -2272,10 +2269,10 @@ fError(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint offset);
 /**
  * Generic handler for context tagged values.  Mostly for handling
  * vendor-defined properties and services.
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  * @todo beautify this ugly construct
  */
@@ -2284,10 +2281,10 @@ fContextTaggedValue(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, guint o
 
 /**
  * realizes some ABSTRACT-SYNTAX.&Type
- * @param tvb
- * @param pinfo
- * @param tree
- * @param offset
+ * @param tvb the tv buffer of the current data
+ * @param pinfo the packet info of the current data
+ * @param tree the tree to append this item to
+ * @param offset the offset in the tvb
  * @return modified offset
  * @todo beautify this ugly construct
  */
@@ -2315,10 +2312,10 @@ proto_reg_handoff_bacapp(void);
  * converts XXX coded strings to UTF-8
  * else 'in' is copied to 'out'
  * @param in  -- pointer to string
- * @param inbytesleft
+ * @param inbytesleft size of int bytes
  * @param out -- pointer to string
- * @param outbytesleft
- * @param fromcoding
+ * @param outbytesleft size of out bytes
+ * @param fromcoding coding type
  * @return count of modified characters of returned string, -1 for errors
  */
 static guint32