Issue #1201024 by pillarsdotnet, jbrown, tim.plunket: drupal_realpath() should describe when it should be used.