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

taglib/ogg/flac/oggflacfile.h

@@ -127,6 +127,9 @@ namespace TagLib {
       /*!
        * Save the file.  This will primarily save and update the XiphComment.
        * Returns true if the save is successful.
+       *
+       * \warning In the current implementation, it's dangerous to call save()
+       * repeatedly.  It leads to a segfault.
        */
       virtual bool save();
 

taglib/ogg/opus/opusfile.h

@@ -106,6 +106,14 @@ namespace TagLib {
          */
         virtual Properties *audioProperties() const;
 
+        /*!
+         * Save the file.
+         *
+         * This returns true if the save was successful.
+         *
+         * \warning In the current implementation, it's dangerous to call save()
+         * repeatedly.  It leads to a segfault.
+         */
         virtual bool save();
 
       private:

taglib/ogg/speex/speexfile.h

@@ -106,8 +106,14 @@ namespace TagLib {
          */
         virtual Properties *audioProperties() const;
 
-
-
+        /*!
+         * Save the file.
+         *
+         * This returns true if the save was successful.
+         *
+         * \warning In the current implementation, it's dangerous to call save()
+         * repeatedly.  It leads to a segfault.
+         */
         virtual bool save();
 
       private:

taglib/ogg/vorbis/vorbisfile.h

@@ -114,6 +114,14 @@ namespace TagLib {
        */
       virtual Properties *audioProperties() const;
 
+      /*!
+       * Save the file.
+       *
+       * This returns true if the save was successful.
+       *
+       * \warning In the current implementation, it's dangerous to call save()
+       * repeatedly.  It leads to a segfault.
+       */
       virtual bool save();
 
     private: