Improved hscommon doc

* Completed hscommon.gui.table's doc
* Use sphinx.ext.autosummary.
* Moved attribute docstrings directly into properties.

help/conf.tmpl

@@ -31,6 +31,8 @@ def fix_nulljob_in_sig(app, what, name, obj, options, signature, return_annotati
 def setup(app):
     app.connect('autodoc-process-signature', fix_nulljob_in_sig)
 
+autodoc_member_order = 'groupwise'
+
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -38,7 +40,7 @@ def setup(app):
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.todo', 'sphinx.ext.autodoc']
+extensions = ['sphinx.ext.todo', 'sphinx.ext.autodoc', 'sphinx.ext.autosummary']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

help/en/developer/hscommon/gui/base.rst

@@ -3,6 +3,10 @@ hscommon.gui.base
 
 .. automodule:: hscommon.gui.base
 
+    .. autosummary::
+        
+        GUIObject
+    
     .. autoclass:: GUIObject
         :members:
         :private-members:

help/en/developer/hscommon/gui/selectable_list.rst

@@ -3,6 +3,13 @@ hscommon.gui.selectable_list
 
 .. automodule:: hscommon.gui.selectable_list
 
+    .. autosummary::
+        
+        Selectable
+        SelectableList
+        GUISelectableList
+        GUISelectableListView
+    
     .. autoclass:: Selectable
         :members:
         :private-members:

help/en/developer/hscommon/gui/table.rst

@@ -2,7 +2,14 @@ hscommon.gui.table
 ==================
 
 .. automodule:: hscommon.gui.table
-
+    
+    .. autosummary::
+        
+        Table
+        Row
+        GUITable
+        GUITableView
+    
     .. autoclass:: Table
         :members:
         :private-members:
@@ -11,3 +18,9 @@ hscommon.gui.table
         :members:
         :private-members:
 
+    .. autoclass:: GUITable
+        :members:
+        :private-members:
+    
+    .. autoclass:: GUITableView
+        :members:

help/en/developer/hscommon/gui/text_field.rst

@@ -3,6 +3,11 @@ hscommon.gui.text_field
 
 .. automodule:: hscommon.gui.text_field
 
+    .. autosummary::
+        
+        TextField
+        TextFieldView
+    
     .. autoclass:: TextField
         :members:
         :private-members: