Merge pull request #3889 from jmdavis/deprecations

Move deprecations along.
dlang · Dec 31, 2015 · 35857ac · 35857ac
2 parents 13e74e9 + 0899d94
commit 35857ac
Show file tree

Hide file tree

Showing 27 changed files with 147 additions and 135 deletions.
diff --git a/std/algorithm/iteration.d b/std/algorithm/iteration.d
@@ -3285,45 +3285,6 @@ if (is(typeof(binaryFun!pred(r.front, s.front)) : bool)
                 return ret;
             }
         }
-
-        // Bidirectional functionality as suggested by Brad Roberts.
-        static if (isBidirectionalRange!Range && isBidirectionalRange!Separator)
-        {
-            //Deprecated. It will be removed in December 2015
-            deprecated("splitter!(Range, Range) cannot be iterated backwards (due to separator overlap).")
-            @property Range back()
-            {
-                ensureBackLength();
-                return _input[_input.length - _backLength .. _input.length];
-            }
-
-            //Deprecated. It will be removed in December 2015
-            deprecated("splitter!(Range, Range) cannot be iterated backwards (due to separator overlap).")
-            void popBack()
-            {
-                ensureBackLength();
-                if (_backLength == _input.length)
-                {
-                    // done
-                    _input = _input[0 .. 0];
-                    _frontLength = _frontLength.max;
-                    _backLength = _backLength.max;
-                    return;
-                }
-                if (_backLength + separatorLength == _input.length)
-                {
-                    // Special case: popping the first-to-first item; there is
-                    // an empty item right before this. Leave the separator in.
-                    _input = _input[0 .. 0];
-                    _frontLength = 0;
-                    _backLength = 0;
-                    return;
-                }
-                // Normal case
-                _input = _input[0 .. _input.length - _backLength - separatorLength];
-                _backLength = _backLength.max;
-            }
-        }
     }
 
     return Result(r, s);

diff --git a/std/bitmanip.d b/std/bitmanip.d
@@ -1239,19 +1239,15 @@ public:
         return hash;
     }
 
-    // @@@DEPRECATED_2016-01@@@
-    /++
-        $(RED Deprecated. Please use the constructor instead. This will be
-              removed in January 2016.)
-      +/
-    deprecated("Please use the constructor instead.")
+    // Explictly undocumented. It will be removed in January 2017. @@@DEPRECATED_2017-01@@@
+    deprecated("Use the constructor instead.")
     void init(bool[] ba) pure nothrow
     {
         this = BitArray(ba);
     }
 
-    /// ditto
-    deprecated("Please use the constructor instead.")
+    // Explictly undocumented. It will be removed in January 2017. @@@DEPRECATED_2017-01@@@
+    deprecated("Use the constructor instead.")
     void init(void[] v, size_t numbits) pure nothrow
     {
         this = BitArray(v, numbits);

diff --git a/std/c/fenv.d b/std/c/fenv.d
@@ -1,15 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.fenv) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.fenv) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;fenv.h&gt;
  * Authors: Walter Bright, Digital Mars, http://www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCFenv
  */
-
-/// Please import core.stdc.fenv instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.fenv instead")
 module std.c.fenv;
 
 public import core.stdc.fenv;
diff --git a/std/c/freebsd/socket.d b/std/c/freebsd/socket.d
@@ -1,10 +1,12 @@
 // Written in the D programming language.
 
-/*
- * This module is just for making std.socket work under FreeBSD, and these
- * definitions should actually be in druntime. (core.sys.posix.netdb or sth)
- */
-/// Please import the core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+// @@@DEPRECATED_2017-06@@@
+
+/++
+    $(RED Deprecated. Use the appropriate $(D core.sys.posix.*) modules instead.
+          This module will be removed in June 2017.)
+  +/
+deprecated("Import the appropriate core.sys.posix.* modules instead")
 module std.c.freebsd.socket;
 
 version (FreeBSD):

diff --git a/std/c/linux/linux.d b/std/c/linux/linux.d
@@ -1,3 +1,4 @@
+// @@@DEPRECATED_2017-06@@@
 
 /* Written by Walter Bright, Christopher E. Miller, and many others.
  * http://www.digitalmars.com/d/
@@ -6,7 +7,11 @@
  * countries.
  */
 
-/// Please import the core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Use the appropriate $(D core.sys.posix.*) modules instead.
+          This module will be removed in June 2017.)
+  +/
+deprecated("Import the appropriate core.sys.posix.* modules instead")
 module std.c.linux.linux;
 
 version (linux):

diff --git a/std/c/linux/linuxextern.d b/std/c/linux/linuxextern.d
@@ -1,3 +1,4 @@
+// @@@DEPRECATED_2017-06@@@
 
 /* Written by Walter Bright.
  * www.digitalmars.com
@@ -6,11 +7,11 @@
  * countries.
  */
 
-/* These are all the globals defined by the linux C runtime library.
- * Put them separate so they'll be externed - do not link in linuxextern.o
- */
-
-/// Please remove this import. This module is empty and will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Remove this import. This module no longer contains
+          anything.)
+  +/
+deprecated("This module no longer contains anything. Just remove the import.")
 module std.c.linux.linuxextern;
 
 // No longer needed since "extern" storage class
diff --git a/std/c/linux/pthread.d b/std/c/linux/pthread.d
@@ -1,9 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
+
 /* Written by Walter Bright, Christopher E. Miller, and many others.
  * www.digitalmars.com
  * Placed into public domain.
  */
 
-/// Please import core.sys.posix.pthread or the other core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Use $(core.sys.posix.pthread) or the appropriate
+          $(D core.sys.posix.*) modules instead. This module will be removed in
+          June 2017.)
+  +/
+deprecated("Import core.sys.posix.pthread or the appropriate core.sys.posix.* modules instead")
 module std.c.linux.pthread;
 
 version (linux):

diff --git a/std/c/linux/socket.d b/std/c/linux/socket.d
@@ -3,8 +3,13 @@
     Placed into public domain.
 */
 
+// @@@DEPRECATED_2017-06@@@
 
-/// Please import the core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Use the appropriate $(D core.sys.posix.*) modules instead.
+          This module will be removed in June 2017.)
+  +/
+deprecated("Import the appropriate core.sys.posix.* modules instead")
 module std.c.linux.socket;
 
 version (linux):

diff --git a/std/c/linux/termios.d b/std/c/linux/termios.d
@@ -1,6 +1,11 @@
+// @@@DEPRECATED_2017-06@@@
 
 
-/// Please import core.sys.posix.termios instead. This module will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Use $(D core.sys.posix.termios) instead. This module will
+          be removed in June 2017.)
+  +/
+deprecated("Import core.sys.posix.termios instead")
 module std.c.linux.termios;
 
 version (linux):

diff --git a/std/c/linux/tipc.d b/std/c/linux/tipc.d
@@ -1,14 +1,17 @@
+// @@@DEPRECATED_2017-06@@@
+
 /**
- * $(RED Deprecated. Please use $(D core.sys.linux.tipc) instead.  This module
- *       will be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.sys.linux.tipc) instead.  This module will be
+ *       removed in June 2017.)
+ *
  * Interface for Linux TIPC sockets, /usr/include/linux/tipc.h
  *
  * Copyright: Public Domain
  * License:   Public Domain
  * Authors:   Leandro Lucarella
  */
 
-/// Please import core.sys.linux.tipc instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.sys.linux.tipc instead")
 module std.c.linux.tipc;
 
 public import core.sys.linux.tipc;
diff --git a/std/c/locale.d b/std/c/locale.d
@@ -1,14 +1,17 @@
+// @@@DEPRECATED_2017-06@@@
+
 /**
- * $(RED Deprecated. Please use $(D core.stdc.locale) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.locale) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;locale.h&gt;
  * License: Public Domain
  * Standards:
  *      ISO/IEC 9899:1999 7.11
  * Macros:
  *      WIKI=Phobos/StdCLocale
  */
-/// Please import core.stdc.locale instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.locale instead")
 module std.c.locale;
 
 public import core.stdc.locale;
diff --git a/std/c/math.d b/std/c/math.d
@@ -1,15 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.math) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.math) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;math.h&gt;
  * Authors: Walter Bright, Digital Mars, www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCMath
  */
-
-/// Please import core.stdc.math instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.math instead")
 module std.c.math;
 
 public import core.stdc.math;
diff --git a/std/c/osx/socket.d b/std/c/osx/socket.d
@@ -3,8 +3,13 @@
     Placed into public domain.
 */
 
+// @@@DEPRECATED_2017-06@@@
 
-/// Please import the core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+/++
+    $(RED Deprecated. Use the appropriate $(D core.sys.posix.*) modules instead.
+          This module will be removed in June 2017.)
+  +/
+deprecated("Import the appropriate core.sys.posix.* instead")
 module std.c.osx.socket;
 
 version (OSX):

diff --git a/std/c/process.d b/std/c/process.d
@@ -1,15 +1,17 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.stdlib) or the core.sys.posix.*
- *       modules you need instead.  This module will be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.stdlib) or the appropriate
+ *       core.sys.posix.* modules instead. This module will be removed in June
+ *       2017.)
+ *
  * C's &lt;process.h&gt;
  * Authors: Walter Bright, Digital Mars, www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCProcess
  */
-
-/// Please import core.stdc.stdlib or the core.sys.posix.* modules you need instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.stdlib or the appropriate core.sys.posix.* modules instead")
 module std.c.process;
 
 private import core.stdc.stddef;

diff --git a/std/c/stdarg.d b/std/c/stdarg.d
@@ -1,17 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.stdarg) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.stdarg) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;stdarg.h&gt;
  * Authors: Hauke Duden and Walter Bright, Digital Mars, www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCStdarg
  */
-
-/* This is for use with extern(C) variable argument lists. */
-
-/// Please import core.stdc.stdarg instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.stdarg instead")
 module std.c.stdarg;
 
 public import core.stdc.stdarg;
diff --git a/std/c/stddef.d b/std/c/stddef.d
@@ -1,15 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.stddef) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.stddef) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;stddef.h&gt;
  * Authors: Walter Bright, Digital Mars, http://www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCStddef
  */
-
-/// Please import core.stdc.stddef instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.stddef instead")
 module std.c.stddef;
 
 public import core.stdc.stddef;
diff --git a/std/c/stdio.d b/std/c/stdio.d
@@ -1,17 +1,16 @@
+// @@@DEPRECATED_2017-06@@@
 
 /**
- * $(RED Deprecated. Please use $(D core.stdc.stdio) instead.  This module will
- *       be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.stdio) instead. This module will be
+ *       removed in June 2017.)
+ *
  * C's &lt;stdio.h&gt; for the D programming language
  * Authors: Walter Bright, Digital Mars, http://www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCStdio
  */
-
-
-
-/// Please import core.stdc.stdio instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.stdio instead")
 module std.c.stdio;
 
 public import core.stdc.stdio;
diff --git a/std/c/stdlib.d b/std/c/stdlib.d
@@ -1,16 +1,17 @@
+// @@@DEPRECATED_2017-06@@@
+
 /**
- * $(RED Deprecated. Please use $(D core.stdc.stdlib) or $(D core.sys.posix.stdlib)
- *       instead.  This module will be removed in December 2015.)
+ * $(RED Deprecated. Use $(D core.stdc.stdlib) or $(D core.sys.posix.stdlib)
+ *       instead. This module will be removed in June 2017.)
+ *
  * C's &lt;stdlib.h&gt;
  * D Programming Language runtime library
  * Authors: Walter Bright, Digital Mars, http://www.digitalmars.com
  * License: Public Domain
  * Macros:
  *      WIKI=Phobos/StdCStdlib
  */
-
-
-/// Please import core.stdc.stdlib or core.sys.posix.stdlib instead. This module will be deprecated in DMD 2.068.
+deprecated("Import core.stdc.stdlib or core.sys.posix.stdlib instead")
 module std.c.stdlib;
 
 public import core.stdc.stdlib;