From 682ea77c2bb63da79b61e0dd972367eaeecc6f15 Mon Sep 17 00:00:00 2001
From: Tsuda Kageyu <tsuda.kageyu@gmail.com>
Date: Wed, 31 May 2017 09:41:41 +0900
Subject: [PATCH] Mention that FileRef::create no longer works.

---
 NEWS             | 1 +
 taglib/fileref.h | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/NEWS b/NEWS
index ac22cd93..f8136f9a 100644
--- 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 c36f54cb..ff14924e 100644
--- 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,