Move various deprecations along.

This commit is contained in:
jmdavis 2013-12-11 23:44:12 -08:00
parent 9749958019
commit efd6ea0cbf
13 changed files with 28 additions and 260 deletions

View file

@ -2897,9 +2897,9 @@ unittest
assert(equal(splitter!"a=='本'"("日本語"), ["日", "語"]));
}
//Explicitly undocumented. It will be removed in December 2014.
//@@@6730@@@ This exists already in std.array, so this declaration, at best, will only create ambiguity.
//unfortunatly, an alias will conflict with the existing splitter in std.algorithm.
//It needs to be removed.
//unfortunately, an alias will conflict with the existing splitter in std.algorithm.
deprecated("Please use std.array.splitter for string specific splitting")
auto splitter(Range)(Range input)
if (isSomeString!Range)
@ -5242,14 +5242,6 @@ unittest
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.algorithm.countUntil instead.")
ptrdiff_t indexOf(alias pred = "a == b", R1, R2)(R1 haystack, R2 needle)
if (is(typeof(startsWith!pred(haystack, needle))))
{
return countUntil!pred(haystack, needle);
}
/**
Interval option specifier for $(D until) (below) and others.
*/
@ -10747,9 +10739,8 @@ unittest
assert(canFind([0, 1, 2, 3], [1, 3], [2, 4]) == 0);
}
//Explictly Undocumented. Do not use. It may be deprecated in the future.
//Use any instead.
bool canFind(alias pred, Range)(Range range)
//Explictly Undocumented. It will be removed in December 2014.
deprecated("Please use any instead.") bool canFind(alias pred, Range)(Range range)
{
return any!pred(range);
}

View file

@ -1285,129 +1285,6 @@ body
assert(to!string(long.max) == "9223372036854775807");
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.format.formattedWrite instead.")
T toImpl(T, S)(S s, in T leftBracket, in T separator = ", ", in T rightBracket = "]")
if (!isSomeChar!(ElementType!S) && (isInputRange!S || isInputRange!(Unqual!S)) &&
isExactSomeString!T)
{
static if (!isInputRange!S)
{
alias toImpl!(T, Unqual!S) ti;
return ti(s, leftBracket, separator, rightBracket);
}
else
{
alias Unqual!(ElementEncodingType!T) Char;
// array-to-string conversion
auto result = appender!(Char[])();
result.put(leftBracket);
bool first = true;
for (; !s.empty; s.popFront())
{
if (!first)
{
result.put(separator);
}
else
{
first = false;
}
result.put(to!T(s.front));
}
result.put(rightBracket);
return cast(T) result.data;
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.format.formattedWrite instead.")
T toImpl(T, S)(ref S s, in T leftBracket, in T separator = " ", in T rightBracket = "]")
if ((is(S == void[]) || is(S == const(void)[]) || is(S == immutable(void)[])) &&
isExactSomeString!T)
{
return toImpl(s);
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.format.formattedWrite instead.")
T toImpl(T, S)(S s, in T leftBracket, in T keyval = ":", in T separator = ", ", in T rightBracket = "]")
if (isAssociativeArray!S && !is(S == enum) &&
isExactSomeString!T)
{
alias Unqual!(ElementEncodingType!T) Char;
auto result = appender!(Char[])();
// hash-to-string conversion
result.put(leftBracket);
bool first = true;
foreach (k, v; s)
{
if (!first)
result.put(separator);
else first = false;
result.put(to!T(k));
result.put(keyval);
result.put(to!T(v));
}
result.put(rightBracket);
return cast(T) result.data;
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.format.formattedWrite instead.")
T toImpl(T, S)(S s, in T nullstr)
if (is(S : Object) &&
isExactSomeString!T)
{
if (!s)
return nullstr;
return to!T(s.toString());
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.format.formattedWrite instead.")
T toImpl(T, S)(S s, in T left, in T separator = ", ", in T right = ")")
if (is(S == struct) && !is(typeof(&S.init.toString)) && !isInputRange!S &&
isExactSomeString!T)
{
Tuple!(FieldTypeTuple!S) * t = void;
static if ((*t).sizeof == S.sizeof)
{
// ok, attempt to forge the tuple
t = cast(typeof(t)) &s;
alias Unqual!(ElementEncodingType!T) Char;
auto app = appender!(Char[])();
app.put(left);
foreach (i, e; t.field)
{
if (i > 0)
app.put(to!T(separator));
app.put(to!T(e));
}
app.put(right);
return cast(T) app.data;
}
else
{
// struct with weird alignment
return to!T(S.stringof);
}
}
/*
$(LI A $(D typedef Type Symbol) is converted to string as $(D "Type(value)").)
*/
deprecated T toImpl(T, S)(S s, in T left = to!T(S.stringof~"("), in T right = ")")
if (is(S == typedef) &&
isExactSomeString!T)
{
static if (is(S Original == typedef))
{
// typedef
return left ~ to!T(cast(Original) s) ~ right;
}
}
/**
Narrowing numeric-numeric conversions throw when the value does not

View file

@ -460,7 +460,6 @@ unittest
}
enforceEx!E1(s);
enforceEx!E2(s);
enforceEx!E3(s, ""); // deprecated
}
/++
@ -538,18 +537,6 @@ template enforceEx(E)
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use the version of enforceEx which takes an exception that constructs with new E(msg, file, line).")
template enforceEx(E)
if (is(typeof(new E(""))) && !is(typeof(new E("", __FILE__, __LINE__))) && !is(typeof(new E(__FILE__, __LINE__))))
{
T enforceEx(T)(T value, lazy string msg = "")
{
if (!value) throw new E(msg);
return value;
}
}
unittest
{
assertNotThrown(enforceEx!Exception(true));

View file

@ -73,10 +73,6 @@ version (Windows)
LPCWSTR lpNewFileName,
DWORD dwFlags);
}
else version (Posix)
{
deprecated alias stat_t struct_stat64;
}
// }}}

View file

@ -71,10 +71,6 @@ class FormatException : Exception
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use FormatException instead.")
alias FormatException FormatError;
private alias enforceFmt = enforceEx!FormatException;

View file

@ -4205,12 +4205,6 @@ Take!(Repeat!T) repeat(T)(T value, size_t n)
return take(repeat(value), n);
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.range.repeat instead.") Take!(Repeat!T) replicate(T)(T value, size_t n)
{
return repeat(value, n);
}
unittest
{
enforce(equal(repeat(5, 4), [ 5, 5, 5, 5 ][]));
@ -8322,9 +8316,6 @@ sgi.com/tech/stl/binary_search.html, binary_search).
}
return false;
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use contains instead.") alias contains canFind;
}
// Doc examples

View file

@ -145,16 +145,6 @@ version(unittest)
/// Base exception thrown by $(D std.socket).
class SocketException: Exception
{
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.socket.SocketOSException instead.") @property int errorCode() const
{
auto osException = cast(SocketOSException)this;
if (osException)
return osException.errorCode;
else
return 0;
}
///
this(string msg, string file = __FILE__, size_t line = __LINE__, Throwable next = null)
{
@ -2029,9 +2019,6 @@ struct TimeVal
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.socket.TimeVal instead.") alias TimeVal timeval;
/**
* A collection of sockets for use with $(D Socket.select).
@ -2257,9 +2244,6 @@ struct Linger
}
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.socket.Linger instead.") alias Linger linger;
/// Specifies a socket option:
enum SocketOption: int
{
@ -3140,9 +3124,8 @@ public:
return result;
}
// This overload is explicitly not documented. Please do not use it. It will
// likely be deprecated in the future. It is against Phobos policy to have
// functions which use naked numbers for time values.
// Explicitly undocumented. It will be removed in December 2014.
deprecated("Please use the overload of select which takes a Duration instead.")
static int select(SocketSet checkRead, SocketSet checkWrite, SocketSet checkError, long microseconds)
{
TimeVal tv;

View file

@ -2505,15 +2505,7 @@ unittest
}
/*****************************************************
* $(RED Deprecated. It will be removed in November 2013.
* Please use std.string.format instead.)
*
* Format arguments into a string.
*
* $(LREF format) was changed to use this implementation in November 2012,
*/
// Explicitly undocumented. It will be removed in July 2014.
deprecated("Please use std.string.format instead.") alias format xformat;
deprecated unittest
@ -2537,16 +2529,7 @@ deprecated unittest
}
/*****************************************************
* $(RED Deprecated. It will be removed in November 2013.
* Please use std.string.sformat instead.)
*
* Format arguments into string $(D buf) which must be large
* enough to hold the result. Throws RangeError if it is not.
*
* $(LREF sformat) was changed to use this implementation in November 2012,
*/
// Explicitly undocumented. It will be removed in July 2014.
deprecated("Please use std.string.sformat instead.") alias sformat xsformat;
deprecated unittest

View file

@ -2324,30 +2324,30 @@ Pointers to immutable objects are not considered raw aliasing.
Example:
---
// simple types
static assert(!hasRawLocalAliasing!int);
static assert( hasRawLocalAliasing!(char*));
static assert(!hasRawLocalAliasing!(shared char*));
static assert(!hasRawUnsharedAliasing!int);
static assert( hasRawUnsharedAliasing!(char*));
static assert(!hasRawUnsharedAliasing!(shared char*));
// references aren't raw pointers
static assert(!hasRawLocalAliasing!Object);
static assert(!hasRawUnsharedAliasing!Object);
// built-in arrays do contain raw pointers
static assert( hasRawLocalAliasing!(int[]));
static assert(!hasRawLocalAliasing!(shared int[]));
static assert( hasRawUnsharedAliasing!(int[]));
static assert(!hasRawUnsharedAliasing!(shared int[]));
// aggregate of simple types
struct S1 { int a; double b; }
static assert(!hasRawLocalAliasing!S1);
static assert(!hasRawUnsharedAliasing!S1);
// indirect aggregation
struct S2 { S1 a; double b; }
static assert(!hasRawLocalAliasing!S2);
static assert(!hasRawUnsharedAliasing!S2);
// struct with a pointer member
struct S3 { int a; double * b; }
static assert( hasRawLocalAliasing!S3);
static assert( hasRawUnsharedAliasing!S3);
struct S4 { int a; shared double * b; }
static assert( hasRawLocalAliasing!S4);
static assert( hasRawUnsharedAliasing!S4);
// struct with an indirect pointer member
struct S5 { S3 a; double b; }
static assert( hasRawLocalAliasing!S5);
static assert( hasRawUnsharedAliasing!S5);
struct S6 { S4 a; double b; }
static assert(!hasRawLocalAliasing!S6);
static assert(!hasRawUnsharedAliasing!S6);
----
*/
@ -2780,11 +2780,10 @@ unittest
static assert( hasIndirections!S26);
}
// These are for backwards compatibility, are intentionally lacking ddoc,
// and should eventually be deprecated.
alias hasUnsharedAliasing hasLocalAliasing;
alias hasRawUnsharedAliasing hasRawLocalAliasing;
alias hasUnsharedObjects hasLocalObjects;
//Explicitly undocumented. They will be removed in December 2014.
deprecated("Please use hasLocalAliasing instead.") alias hasUnsharedAliasing hasLocalAliasing;
deprecated("Please use hasRawLocalAliasing instead.") alias hasRawUnsharedAliasing hasRawLocalAliasing;
deprecated("Please use hasLocalObjects instead.") alias hasUnsharedObjects hasLocalObjects;
/**
Returns $(D true) if and only if $(D T)'s representation includes at

View file

@ -6660,12 +6660,6 @@ public bool isWhite(dchar c)
return isWhiteGen(c); // call pregenerated binary search
}
deprecated ("Please use std.uni.isLower instead")
bool isUniLower(dchar c) @safe pure nothrow
{
return isLower(c);
}
/++
Return whether $(D c) is a Unicode lowercase $(CHARACTER).
+/
@ -6697,13 +6691,6 @@ bool isLower(dchar c)
}
deprecated ("Please use std.uni.isUpper instead")
@safe pure nothrow
bool isUniUpper(dchar c)
{
return isUpper(c);
}
/++
Return whether $(D c) is a Unicode uppercase $(CHARACTER).
+/
@ -6734,14 +6721,6 @@ bool isUpper(dchar c)
}
deprecated ("Please use std.uni.toLower instead")
@safe pure nothrow
dchar toUniLower(dchar c)
{
return toLower(c);
}
/++
If $(D c) is a Unicode uppercase $(CHARACTER), then its lowercase equivalent
is returned. Otherwise $(D c) is returned.
@ -7210,13 +7189,6 @@ unittest
}
deprecated("Please use std.uni.toUpper instead")
@safe pure nothrow
dchar toUniUpper(dchar c)
{
return toUpper(c);
}
/++
If $(D c) is a Unicode lowercase $(CHARACTER), then its uppercase equivalent
is returned. Otherwise $(D c) is returned.
@ -7364,12 +7336,6 @@ unittest
}
}
deprecated("Please use std.uni.isAlpha instead.")
@safe pure nothrow
bool isUniAlpha(dchar c)
{
return isAlpha(c);
}
/++
Returns whether $(D c) is a Unicode alphabetic $(CHARACTER)

View file

@ -94,10 +94,6 @@ class UTFException : Exception
}
// Explicitly undocumented. It will be removed in November 2013.
deprecated("Please use std.utf.UTFException instead.") alias UtfException = UTFException;
/++
Returns whether $(D c) is a valid UTF-32 character.

View file

@ -1278,12 +1278,14 @@ public:
return value;
}
//Explicitly undocumented. It will be removed in July 2014.
deprecated("Please use value_DWORD instead.")
uint value_DWORD_LITTLEENDIAN()
{
return value_DWORD;
}
//Explicitly undocumented. It will be removed in July 2014.
deprecated("Please use value_DWORD instead.")
uint value_DWORD_BIGENDIAN()
{

View file

@ -84,7 +84,7 @@ class ArchiveMember
private ushort _madeVersion = 20;
private ushort _extractVersion = 20;
private ushort _diskNumber;
// should be private when deprecation done
// Explicitly undocumented. It will be undeprecated and made private in January 2015.
deprecated("Please use fileAttributes instead.") uint externalAttributes;
private DosFileTime _time;
@ -194,6 +194,7 @@ class ArchiveMember
**/
@property CompressionMethod compressionMethod() { return _compressionMethod; }
// Explicitly undocumented. It will be removed in January 2015.
deprecated("Please use the enum CompressionMethod to set this property instead.")
@property void compressionMethod(ushort cm)
{