doc: General improvements.

recipe_engine/recipe_api.py

Index: recipe_engine/recipe_api.py
diff --git a/recipe_engine/recipe_api.py b/recipe_engine/recipe_api.py
index 28fd9dc20c959dcb84ef81318a79ed32afb1e954..e102518c9c639560677dc7f80a00df1c0e9b2ce5 100644
--- a/recipe_engine/recipe_api.py
+++ b/recipe_engine/recipe_api.py
@@ -1,4 +1,4 @@
-# Copyright 2013-2015 The Chromium Authors. All rights reserved.
+# Copyright 2016 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.
 
@@ -234,6 +234,7 @@ def infer_composite_step(func):
       except StepFailure as ex:
         agg.add_failure(ex)
         return DeferredResult(None, ex)
+  _inner.__original = func

[martiniss, 2016/04/25 23:44:19]

Umm. Is this legit? It works, but.....

[iannucci, 2016/05/28 00:38:17]

it's as legit as anything else :/. Python's gone back and forth about how to do
this. To unwrap, you may need to recurse on __original's though.

   return _inner
 
 
@@ -271,6 +272,7 @@ def composite_step(func):
       except StepFailure as ex:
         agg.add_failure(ex)
         return DeferredResult(None, ex)
+  _inner.__original = func
   return _inner