Generalize patch_project to patch root conversion.

recipe_modules/rietveld/api.py

 # Copyright 2013 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import urlparse
 
 from recipe_engine import recipe_api
 
 
 class RietveldApi(recipe_api.RecipeApi):
   def calculate_issue_root(self, extra_patch_project_roots=None):
     """Returns path where a patch should be applied to based on "patch_project".
 
+    YOU SHOULD NOT USE THIS METHOD. Put this into gclient's config as
+    patch_projects instead, and with luck you won't need to use
+    calculate_patch_root from gclient api.
+    TODO(tandrii): remove this method completely. See http://crbug.com/605563.
+
     Maps Rietveld's "patch_project" to a path of directories relative to
     api.gclient.c.solutions[0].name which describe where to place the patch.
 
     Args:
       extra_patch_project_roots: Dict mapping project names to relative roots.
 
     Returns:
       Relative path or empty string if patch_project is not set or path for a
       given is unknown.
     """
@@ skipping 56 matching lines @@
         self.m.path['depot_tools'].join('apply_issue.py'), [
           '-r', self.m.path['checkout'].join(*root_pieces),
           '-i', issue_number,
           '-p', self.m.properties['patchset'],
           '-s', rietveld_url,
           '--no-auth'],
         )
     step_result.presentation.links['Applied issue %s' % issue_number] = (
       urlparse.urljoin(rietveld_url, str(issue_number)))