diff --git a/taglib/flac/flacfile.h b/taglib/flac/flacfile.h
index e2d15842..dc0a9601 100644
--- a/taglib/flac/flacfile.h
+++ b/taglib/flac/flacfile.h
@@ -79,7 +79,7 @@ namespace TagLib {
            Properties::ReadStyle propertiesStyle = Properties::Average);
 
       /*!
-       * Constructs an APE file from \a file.  If \a readProperties is true the
+       * Constructs an FLAC file from \a file.  If \a readProperties is true the
        * file's audio properties will also be read.
        *
        * If this file contains and ID3v2 tag the frames will be created using
diff --git a/taglib/toolkit/tbytevector.h b/taglib/toolkit/tbytevector.h
index 2ac3545b..793b414c 100644
--- a/taglib/toolkit/tbytevector.h
+++ b/taglib/toolkit/tbytevector.h
@@ -85,9 +85,10 @@ namespace TagLib {
 
     /*!
      * Constructs a byte vector that copies \a data up to the first null
-     * byte.  The behavior is undefined if \a data is not null terminated.
-     * This is particularly useful for constructing byte arrays from string
-     * constants.
+     * byte.  This is particularly useful for constructing byte arrays from
+     * string constants.
+     *
+     * \warning The behavior is undefined if \a data is not null terminated.
      */
     ByteVector(const char *data);
 
@@ -550,12 +551,14 @@ namespace TagLib {
     ByteVector &operator=(const ByteVector &v);
 
     /*!
-     * Copies ByteVector \a v.
+     * Copies a byte \a c.
      */
     ByteVector &operator=(char c);
 
     /*!
-     * Copies ByteVector \a v.
+     * Copies \a data up to the first null byte.
+     *
+     * \warning The behavior is undefined if \a data is not null terminated.
      */
     ByteVector &operator=(const char *data);