Brian Coca
b7c874f81a
enforce required 'required' in docs
2016-05-05 16:55:18 -04:00
Toshio Kuratomi
b27c424fa1
Fixes to the documentation build ( #15356 )
...
* Could only have one alias before. Subsequent aliases overrode the
previous ones. Now multiple aliases work.
* Fix BLACKLISTED_MODULES. Previously, modules were listed in the
generated documentation despite being blacklisted
* Deprecated modules form extras were showing the (E) tag and not the
(D) tag. Reversed that now (Probably not necessary to also show the
E tag).
* Sort the deprecated modules alphabetically in the Category docs as
well as the list of all modules
* Optimization: Previously rendered the modules to rst twice once in all
group and once in individual categories. Fixed to only render them
once.
* Add fireball to blacklist and remove async_status (as people need to
use that).
2016-04-11 17:11:55 -07:00
Brian Coca
6414c967e4
now check for description and listify if needed
...
fixes #14371
2016-02-08 12:34:26 -05:00
Toshio Kuratomi
5cd3f71792
Handle utf-8 in module short desc
2016-02-02 13:00:24 -08:00
Jeremy Audet
5cac8efd73
Make "make webdocs" compatible with Python 3
...
The `webdocs` make target fails under Python 3. It fails due to a variety of
syntax errors, such as the use of `except Foo, e` and `print 'foo'`. Fix #13463
by making code compatible with both Python 2 and 3.
2015-12-08 12:00:53 -05:00
Brian Coca
5719912e7f
added a skip for the test dir in module repos
2015-10-27 19:59:43 -04:00
Brian Coca
3a0bf55ae3
better error catching for doc build
2015-10-13 11:14:28 -04:00
Marius Gedminas
823677b490
Replace .iteritems() with six.iteritems()
...
Replace .iteritems() with six.iteritems() everywhere except in
module_utils (because there's no 'six' on the remote host). And except
in lib/ansible/galaxy/data/metadata_template.j2, because I'm not sure
six is available there.
2015-09-03 09:23:27 +03:00
Kevin Houdebert
b8c9391d0c
Change to python3 syntax
2015-08-31 02:35:14 +02:00
Brian Coca
f5c8055879
removed debug stuff
2015-07-28 15:25:17 -04:00
Brian Coca
a78fdde32c
better handling for weird doc corner cases (abscense of options, bad text objects, etc)
...
also updated extras to get some docfixes on the module side
2015-07-28 14:30:46 -04:00
Brian Coca
740f15cb0d
just remove version_added when to old, not the whole option!
2015-07-20 22:31:20 -04:00
Brian Coca
6ba706f753
minor doc reformatting
...
now version_added < 1.3 does not get shown, up from 1.0
option's version_added is also now filterd against this threshold
module version_added is more prominent
exaples now uses pure rst instead of intermingled with html formatting
aliases now shown in description for options
bad version fields now throw warnings instead of exceptions
ansible-doc errors now show traceback in very very verbose mode, for easier debugging
2015-07-17 10:07:22 -04:00
Brian Coca
811b10d132
docs will not mention versions older than 1.5
2015-07-17 10:07:22 -04:00
James Cammarata
2bad888f28
Merge branch 'v2_final' into devel_switch_v2
...
Conflicts:
lib/ansible/inventory/__init__.py
lib/ansible/modules/core
lib/ansible/utils/__init__.py
lib/ansible/utils/module_docs.py
2015-05-28 15:26:03 -05:00
Florian Apolloner
3010190592
Fixing up the hacking module_formatter code for v2
2015-05-23 08:42:17 -05:00
Toshio Kuratomi
4c8d27f7bb
Make module formatting into links to the other module docs
2015-05-05 13:51:22 -07:00
Brian Coca
c3076b8478
added module returnval documentation to web docs
2015-03-20 16:55:03 -04:00
Brian Coca
94909bd4a2
Added return values documentation to modules
2015-03-20 16:55:03 -04:00
Brian Coca
68a06e542d
Merge pull request #9666 from follower/patch-8
...
Correct typo of "actively" (Attempt #2 )
2015-02-26 23:05:28 -05:00
Brian Coca
ee08448b2e
now module_formatter handles new expanded return values from the module_docs (still does not thing with new return value docs)
2015-02-19 18:07:05 -05:00
follower
8b278fee51
Correct typo of "actively" (Attempt #2 )
2014-11-29 18:29:09 +13:00
follower
a1c5294882
Fix misspelled "necessarily"
2014-11-29 14:55:25 +13:00
Brian Coca
339d1ccc8b
fixed issue with subclasses across the repos clobbering each other, they
...
now merge
2014-11-04 20:54:55 -05:00
Brian Coca
2ba5c3c66b
added blank line before section to avoid sphinx warnings
2014-11-04 18:14:30 -05:00
Michael DeHaan
c551fe8b50
Clarify module list footer.
2014-11-04 17:38:02 -05:00
Brian Coca
12393a4b47
subcategories are now Title case and _ gets changed to a space
2014-11-04 08:44:39 -05:00
Brian Coca
5f1ad79cd3
now correctly flags and sorts subcategory modules
2014-11-03 23:14:22 -05:00
Brian Coca
650048f7dd
now displays subcategories correctly
2014-11-03 22:02:13 -05:00
Brian Coca
7bd2c945a7
now doc generation does not ignore subdirs of cloud
2014-11-03 08:15:26 -05:00
Brian Coca
80b1365d53
now correctly processes modules when in subdirs of cloud
2014-11-01 23:19:25 -04:00
Brian Coca
f6d9aa7a8f
corrected text/flag
2014-10-31 16:05:22 -04:00
Brian Coca
023f5fd7e0
Added note explaning the module tagging
2014-10-31 15:06:00 -04:00
Brian Coca
44f0279d0a
Now adds flags for non core and deprecated modules in listing
2014-10-31 14:20:26 -04:00
Brian Coca
8b5b97d066
now docs handle deprecated modules but still ignore aliases
2014-10-30 13:29:54 -04:00
Brian Coca
27d741102c
Created Deprecated module category that only appears when there is
...
something to show
2014-10-30 11:26:43 -04:00
Brian Coca
5ab4467708
module formatter skips modules with leading underscore to avoid
...
documenting them. Soon will be patched to recognize them as either
deprecated or an alias
2014-10-28 08:36:31 -07:00
Michael DeHaan
ffee9a8fe0
Docsite formatting
2014-09-26 18:23:57 -04:00
Michael DeHaan
e8fe306cef
Some various comments about the new repos, more to likely come.
2014-09-26 17:52:50 -04:00
Michael DeHaan
bceb0026a5
Updating the module formatter to deal with the new repo structure.
2014-09-26 17:10:13 -04:00
Michael DeHaan
dfd4f18095
Docsite things.
2014-06-19 14:25:28 -05:00
Cristian Ciupitu
0749112286
Micro-optimization: replace s.find(x)!=-1 with x in s
...
timeit shows a speedup of ~3x on Python 2.7.5 x86_64.
It also makes the code a bit shorter.
2014-03-16 13:10:28 -04:00
Lukáš Lalinský
95d102f5e4
Remove obsolete module development docs
2014-02-22 15:51:59 +01:00
Michael DeHaan
c4a8a6d3c2
Add an "all" category so all modules show up uncategorized there.
2014-01-02 17:42:18 -05:00
Michael DeHaan
83d298accc
Add note about how to submit doc changes to generated module docs, limit TOC depth for module category list.
2013-12-25 21:29:54 -05:00
Mikhail Sobolev
7965d331f3
do not produce too deep toc for category lists
2013-12-25 21:19:00 +02:00
Mikhail Sobolev
af1f8db51d
remove trailing whitespaces
2013-12-25 21:19:00 +02:00
Michael DeHaan
a5e8e10bb0
Removed unused things.
2013-12-25 14:17:47 -05:00
Michael DeHaan
35ec9f81ae
Further modifications to the module formatter to adjust to the new theme, and some misc docs text corrections.
2013-12-25 13:24:29 -05:00
Michael DeHaan
fe2d00d9d3
WIP on refactoring the module formatter code that we use to build the doc site with.
2013-12-25 13:24:29 -05:00
