Mention that FileRef::create no longer works.

diff --git a/NEWS b/NEWS
index ac22cd93f7b93c490ba2aae0a6cd414d11a760e4..f8136f9a287b29f12131f0d9e166471547157de6 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -8,6 +8,7 @@
  * Fixed possible file corruptions when saving Ogg files.
  * Fixed reading FLAC files with zero-sized seektables.
  * Better handling of invalid UTF-8 sequences.
+ * Marked FileRef::create() deprecated. It returns null.
  * Several smaller bug fixes and performance improvements.
 
 TagLib 1.11.1 (Oct 24, 2016)

diff --git a/taglib/fileref.h b/taglib/fileref.h
index c36f54cbd33af8b5ebe4ea317959512111bd2732..ff14924e83ee0a5eba8326278d9d84c0e4e60f7e 100644 (file)
--- a/taglib/fileref.h
+++ b/taglib/fileref.h
@@ -268,7 +268,7 @@ namespace TagLib {
      * \note You generally shouldn't use this method, but instead the constructor
      * directly.
      *
-     * \deprecated
+     * \deprecated Always returns null.
      */
     static File *create(FileName fileName,
                         bool readAudioProperties = true,