Merge pull request #100 from evgeni/skip-sections

allow skipping sections

Author: dpryan79

docs/extend.rst

@@ -62,6 +62,9 @@ You can also add classifiers, which will change how these definitions are incorp
             --upgrade : @after
                 The after directive is the default, so you needn't specify it.
 
+       advanced arguments : @skip
+            skip advanced arguments
+
 
 @before
     Insert content before the parsed help/description message of the argument/option/subcommand/argument-group.
@@ -71,3 +74,6 @@ You can also add classifiers, which will change how these definitions are incorp
 
 @replace
     Replace content of help/description message of argument/option/subcommand/argument-group.
+
+@skip
+    Skip the content of help/description message of subcommand/argument-group.

sphinxarg/ext.py

@@ -32,7 +32,7 @@ def map_nested_definitions(nested_content):
                 if len(ci.children) > 0:
                     classifier = ci.children[0].astext()
             if classifier is not None and classifier not in (
-                    '@replace', '@before', '@after'):
+                    '@replace', '@before', '@after', '@skip'):
                 raise Exception('Unknown classifier: %s' % classifier)
             idx = subitem.first_child_matching_class(nodes.term)
             if idx is not None:
@@ -93,6 +93,8 @@ def print_action_groups(data, nested_content, markDownHelp=False, settings=None)
                     desc.append(s)
                 elif classifier == '@before':
                     desc.insert(0, s)
+                elif classifier == '@skip':
+                    continue
                 if len(subContent) > 0:
                     for k, v in map_nested_definitions(subContent).items():
                         definitions[k] = v