update sphinx requirements, add missing docs

docs/modules/index.rst

+API Documentation
+--------------------
+
+.. toctree::
+  :maxdepth: 1
+
+
+  tensorpack.models
+  tensorpack.dataflow
+  tensorpack.callbacks
+  tensorpack.train
+  tensorpack.utils
+  tensorpack.tfutils
+  tensorpack.predict
+  tensorpack.RL
+

docs/requirements.txt

@@ -3,4 +3,5 @@ numpy
 tqdm
 nltk
 decorator
+Sphinx==1.5.1
 recommonmark==0.4.0

docs/user/glance.md

+
+## A High-Level Glance
+
+TODO
+

docs/user/tutorials.rst

+
+Tutorials
+---------------------
+
+Test.
+
+.. toctree::
+  :maxdepth: 2
+
+  glance
+  dataflow
+  models

examples/ConvolutionalPoseMachines/load-cpm.py

@@ -14,6 +14,15 @@ from tensorpack.utils.argtools import memoized
 import matplotlib.pyplot as plt
 _CM = plt.get_cmap('jet')
 
+"""
+15 channels:
+0-1 head, neck
+2-4 right shoulder, right elbow, right wrist
+5-7 left shoulder, left elbow, left wrist
+8-10 right hip, right knee, right ankle
+11-13 left hip, left knee, left ankle
+14: background
+"""
 
 def colorize(img, heatmap):
     """ img: bgr, [0,255]
@@ -37,7 +46,6 @@ def get_gaussian_map():
 
 
 class Model(ModelDesc):
-
     def _get_input_vars(self):
         return [InputVar(tf.float32, (None, 368, 368, 3), 'input'),
                 InputVar(tf.float32, (None, 368, 368, 15), 'label'),

examples/DoReFa-Net/alexnet-dorefa.py

@@ -155,7 +155,7 @@ class Model(ModelDesc):
         add_moving_summary(tf.reduce_mean(wrong, name='train-error-top5'))
 
         # weight decay on all W of fc layers
-        wd_cost = regularize_cost('fc.*/W', l2_regularizer(5e-6))
+        wd_cost = regularize_cost('fc.*/W', l2_regularizer(5e-6), name='regularize_cost')
 
         add_param_summary(('.*/W', ['histogram', 'rms']))
         self.cost = tf.add_n([cost, wd_cost], name='cost')