lucifer: Clean up

Final clean up now that design is stable.

Mostly documentation changes with some refactoring.

BUG=chromium:748234
TEST=bin/test_lucifer

Change-Id: I55c3ad1792e5aeeb98f0d205474b166021049c43
Reviewed-on: https://chromium-review.googlesource.com/714645
Commit-Ready: Allen Li <ayatane@chromium.org>
Tested-by: Allen Li <ayatane@chromium.org>
Reviewed-by: Prathmesh Prabhu <pprabhu@chromium.org>
diff --git a/venv/lucifer/loglib.py b/venv/lucifer/loglib.py
index 1f06878..181a9f0 100644
--- a/venv/lucifer/loglib.py
+++ b/venv/lucifer/loglib.py
@@ -2,7 +2,7 @@
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
-"""lucifer scripts shared logging related functions."""
+"""Shared logging functions"""
 
 from __future__ import absolute_import
 from __future__ import division