lint: clean up section names in docstrings
Make sure:
- correct ordering
- correct name usage
- new lines before each section
Maybe one or two other random fixes too like whitespace alignment.
BUG=chromium:327969
TEST=`cros lint` doesn't complain as much
TEST=`./buildbot/run_tests` passes
Change-Id: Ia57f06d5c0709103b2373568989d03d8fbaceeb5
Reviewed-on: https://chromium-review.googlesource.com/179802
Reviewed-by: Matt Tennant <mtennant@chromium.org>
Commit-Queue: Mike Frysinger <vapier@chromium.org>
Tested-by: Mike Frysinger <vapier@chromium.org>
diff --git a/scripts/parallel_emerge.py b/scripts/parallel_emerge.py
index fc77974..db54021 100644
--- a/scripts/parallel_emerge.py
+++ b/scripts/parallel_emerge.py
@@ -226,8 +226,10 @@
We need to be compatible with emerge arg format. We scrape arguments that
are specific to parallel_emerge, and pass through the rest directly to
emerge.
+
Args:
argv: arguments list
+
Returns:
Arguments that don't belong to parallel_emerge
"""
@@ -525,6 +527,7 @@
Args:
deps_tree: Dependency tree structure.
deps_info: More details on the dependencies.
+
Returns:
Deps graph in the form of a dict of packages, with each package
specifying a "needs" list and "provides" list.
@@ -547,8 +550,10 @@
Take the tree of package -> requirements and reverse it to a digraph of
buildable packages -> packages they unblock.
+
Args:
packages: Tree(s) of dependencies.
+
Returns:
Unsanitized digraph.
"""