merge -c1610 branches/stable-1.4: Added missing doxygen docs.
authorFlorian Pose <fp@igh-essen.com>
Mon, 26 Jan 2009 11:58:35 +0000
changeset 1332 d62633fea8ed
parent 1331 7cd33a77f926
child 1333 7b9898062c8f
merge -c1610 branches/stable-1.4: Added missing doxygen docs.
master/master.c
master/module.c
master/pdo.c
master/sdo_request.c
master/slave_config.c
--- a/master/master.c	Mon Jan 26 11:51:53 2009 +0000
+++ b/master/master.c	Mon Jan 26 11:58:35 2009 +0000
@@ -1307,6 +1307,8 @@
  *  Realtime interface
  *****************************************************************************/
 
+/** Same as ecrt_master_create_domain(), but with ERR_PTR() return value.
+ */
 ec_domain_t *ecrt_master_create_domain_err(
         ec_master_t *master /**< master */
         )
@@ -1484,6 +1486,8 @@
 
 /*****************************************************************************/
 
+/** Same as ecrt_master_slave_config(), but with ERR_PTR() return value.
+ */
 ec_slave_config_t *ecrt_master_slave_config_err(ec_master_t *master,
         uint16_t alias, uint16_t position, uint32_t vendor_id,
         uint32_t product_code)
--- a/master/module.c	Mon Jan 26 11:51:53 2009 +0000
+++ b/master/module.c	Mon Jan 26 11:58:35 2009 +0000
@@ -462,7 +462,9 @@
  *
  * Same as ecrt_request_master(), but with ERR_PTR() return value.
  */
-ec_master_t *ecrt_request_master_err(unsigned int master_index)
+ec_master_t *ecrt_request_master_err(
+        unsigned int master_index /**< Master index. */
+        )
 {
     ec_master_t *master, *errptr = NULL;
 
--- a/master/pdo.c	Mon Jan 26 11:51:53 2009 +0000
+++ b/master/pdo.c	Mon Jan 26 11:58:35 2009 +0000
@@ -56,7 +56,10 @@
  * \retval  0 Success.
  * \retval <0 Error code.
  */
-int ec_pdo_init_copy(ec_pdo_t *pdo, const ec_pdo_t *other_pdo)
+int ec_pdo_init_copy(
+        ec_pdo_t *pdo, /**< PDO to create. */
+        const ec_pdo_t *other_pdo /**< PDO to copy from. */
+        )
 {
     int ret = 0;
 
@@ -149,10 +152,10 @@
  * \retval Pointer to the added entry, otherwise a ERR_PTR() code.
  */
 ec_pdo_entry_t *ec_pdo_add_entry(
-        ec_pdo_t *pdo,
-        uint16_t index,
-        uint8_t subindex,
-        uint8_t bit_length
+        ec_pdo_t *pdo, /**< PDO. */
+        uint16_t index, /**< New entry's index. */
+        uint8_t subindex, /**< New entry's subindex. */
+        uint8_t bit_length /**< New entry's bit length. */
         )
 {
     ec_pdo_entry_t *entry;
@@ -177,7 +180,10 @@
  * \retval  0 Success.
  * \retval <0 Error code.
  */
-int ec_pdo_copy_entries(ec_pdo_t *pdo, const ec_pdo_t *other)
+int ec_pdo_copy_entries(
+        ec_pdo_t *pdo, /**< PDO whos entries shall be replaced. */
+        const ec_pdo_t *other /**< Pdo with entries to copy. */
+        )
 {
     ec_pdo_entry_t *entry, *other_entry;
     int ret;
--- a/master/sdo_request.c	Mon Jan 26 11:51:53 2009 +0000
+++ b/master/sdo_request.c	Mon Jan 26 11:58:35 2009 +0000
@@ -81,8 +81,8 @@
  * \attention Only the index subindex and data are copied.
  */
 int ec_sdo_request_copy(
-        ec_sdo_request_t *req,
-        const ec_sdo_request_t *other
+        ec_sdo_request_t *req, /**< SDO request. */
+        const ec_sdo_request_t *other /**< Other SDO request to copy from. */
         )
 {
     req->index = other->index;
--- a/master/slave_config.c	Mon Jan 26 11:51:53 2009 +0000
+++ b/master/slave_config.c	Mon Jan 26 11:58:35 2009 +0000
@@ -734,6 +734,9 @@
 
 /*****************************************************************************/
 
+/** Same as ecrt_slave_config_create_sdo_request(), but with ERR_PTR() return
+ * value.
+ */
 ec_sdo_request_t *ecrt_slave_config_create_sdo_request_err(
         ec_slave_config_t *sc, uint16_t index, uint8_t subindex, size_t size)
 {
@@ -784,6 +787,9 @@
 
 /*****************************************************************************/
 
+/** Same as ecrt_slave_config_create_voe_handler(), but with ERR_PTR() return
+ * value.
+ */
 ec_voe_handler_t *ecrt_slave_config_create_voe_handler_err(
         ec_slave_config_t *sc, size_t size)
 {