|
|
|
@ -23,6 +23,8 @@ import ast
|
|
|
|
|
import yaml
|
|
|
|
|
import traceback
|
|
|
|
|
|
|
|
|
|
from collections import MutableMapping, MutableSet, MutableSequence
|
|
|
|
|
|
|
|
|
|
from ansible import utils
|
|
|
|
|
|
|
|
|
|
# modules that are ok that they do not have documentation strings
|
|
|
|
@ -86,7 +88,14 @@ def get_docstring(filename, verbose=False):
|
|
|
|
|
if not doc.has_key(key):
|
|
|
|
|
doc[key] = value
|
|
|
|
|
else:
|
|
|
|
|
if isinstance(doc[key], MutableMapping):
|
|
|
|
|
doc[key].update(value)
|
|
|
|
|
elif isinstance(doc[key], MutableSet):
|
|
|
|
|
doc[key].add(value)
|
|
|
|
|
elif isinstance(doc[key], MutableSequence):
|
|
|
|
|
doc[key] = sorted(frozenset(doc[key] + value))
|
|
|
|
|
else:
|
|
|
|
|
raise Exception("Attempt to extend a documentation fragement of unknown type")
|
|
|
|
|
|
|
|
|
|
if 'EXAMPLES' in (t.id for t in child.targets):
|
|
|
|
|
plainexamples = child.value.s[1:] # Skip first empty line
|
|
|
|
|