Next in Review Queue: The New std.path

[Jonathan M Davis]

On 2011-07-14 17:33, dsimcha wrote:
> 3. All the stuff from the old std.path should be "scheduled for
> deprecation". Deprecating stuff breaks people's build processes and
> should only be done after adequate warning. I don't know a good way to
> implement this for enums and aliases, though, which I guess begs the
> question of whether DMD should support soft deprecation.

A documentation note for it can and should be added to each function saying 
that it's scheduled for deprecation (std.ctype, std.string, and std.file all 
have some good examples of this). Unfortunately, the only way at this point to 
print a message about a function being scheduled for deprecation is to use a 
pragma inside of the function - which only works with templated functions. 
However, there's been a number of complaints on the Announce list about the 
messages which are currently printed for functions which are scheduled for 
deprecation, so I don't know how we want to handle such messages. At minimum, 
the old functions should be in the documentation and labeled as scheduled for 
deprecation rather than deprecated.

- Jonathan M Davis