Obsolete function previously used in Theme Editor

[SergeyBiryukov]

get_real_file_to_edit() is unused since [12063] and should probably be deprecated:
​http://core.trac.wordpress.org/browser/tags/3.5.1/wp-admin/includes/file.php#L96

[iamfriendly]

Added a patch to place the _deprecated_function() call as well as updated the docblock to indicate the function has been deprecated, too.

[nacin]

We should move this function to wp-admin/includes/deprecated.php. We should also remove the first part of the function that supports .htaccess and the root index.php file, and instead just return WP_CONTENT_DIR . $arg;

[iamfriendly]

Moving it makes absolute sense, I should have done that in the first place. Also just returning WP_CONTENT_DIR . $arg makes sense too, I just didn't want to amend the function too much. New Patch Added :)

[SergeyBiryukov]

In 25201:

Move get_real_file_to_edit() to wp-admin/includes/deprecated.php. props iamfriendly. fixes #23680.

[SergeyBiryukov]

In 25208:

Move get_real_file_to_edit() upper in the file for consistency with the existing order of functions. Some phpdoc fixes and additions. see #23680.