diff --git a/src/dc_contact.c b/src/dc_contact.c
index fc0703d9..bb02bfb4 100644
--- a/src/dc_contact.c
+++ b/src/dc_contact.c
@@ -837,17 +837,15 @@ cleanup:
  * To add a single contact entered by the user, you should prefer dc_create_contact(),
  * however, for adding a bunch of addresses, this function is _much_ faster.
  *
- * The function takes are of not overwriting names manually added or edited by dc_create_contact().
- *
  * @memberof dc_context_t
  * @param context the context object as created by dc_context_new().
- * @param adr_book A multi-line string in the format in the format
- *     `Name one\nAddress one\nName two\Address two`.  If an email address
- *      already exists, the name is updated and the origin is increased to
- *      "manually created".
+ * @param adr_book A multi-line string in the format
+ *     `Name one\nAddress one\nName two\nAddress two`.
+ *      If an email address already exists, the name is updated
+ *      unless it was edited manually by dc_create_contact() before.
  * @return The number of modified or added contacts.
  */
-int dc_add_address_book(dc_context_t* context, const char* adr_book) /* format: Name one\nAddress one\nName two\Address two */
+int dc_add_address_book(dc_context_t* context, const char* adr_book)
 {
 	carray* lines = NULL;
 	size_t  i = 0;
diff --git a/src/dc_context.c b/src/dc_context.c
index c3cebbc6..0d8039da 100644
--- a/src/dc_context.c
+++ b/src/dc_context.c
@@ -50,7 +50,7 @@ static uintptr_t cb_dummy(dc_context_t* context, int event, uintptr_t data1, uin
 
 
 /**
- * The following three callback are used by dc_imap_new() to read/write configuration
+ * The following three callback are given to dc_imap_new() to read/write configuration
  * and to handle received messages. As the imap-functions are typically used in
  * a separate user-thread, also these functions may be called from a different thread.
  *