zone: update a comment

diff --git a/src/knot/zone/zone.h b/src/knot/zone/zone.h
index 0019c9eaf159bd49c35db54d9b8b9833312388b5..99d478877b46e8de30b7e7abc8c47ad1e6c8dc89 100644 (file)
--- a/src/knot/zone/zone.h
+++ b/src/knot/zone/zone.h
@@ -268,13 +268,14 @@ typedef int (*zone_master_cb)(conf_t *conf, zone_t *zone, const conf_remote_t *r
                               void *data, zone_master_fallback_t *fallback);
 
 /*!
- * \brief Perform an action with a first working master server.
+ * \brief Perform an action with all configured master servers.
  *
  * The function iterates over available masters. For each master, the callback
- * function is called. If the callback function succeeds (\ref KNOT_EOK is
- * returned), the iteration is terminated.
+ * function is called once for its every adresses until the callback function
+ * succeeds (\ref KNOT_EOK is returned) and then the iteration continues with
+ * the next master.
  *
- * \return Error code from the last callback.
+ * \return Error code from the last callback or KNOT_ENOMASTER.
  */
 int zone_master_try(conf_t *conf, zone_t *zone, zone_master_cb callback,
                     void *callback_data, const char *err_str);