Add warnings about calling File::save() repeatedly.

1 files changed, 3 insertions, 0 deletions

diff --git a/taglib/flac/flacfile.h b/taglib/flac/flacfile.h
index dc0a9601..1c055d33 100644
--- a/taglib/flac/flacfile.h
+++ b/taglib/flac/flacfile.h
@@ -155,6 +155,9 @@ namespace TagLib {
        * has no XiphComment, one will be constructed from the ID3-tags.
        *
        * This returns true if the save was successful.
+       *
+       * \warning In the current implementation, it's dangerous to call save()
+       * repeatedly.  At worst it will corrupt the file.
        */
       virtual bool save();