summaryrefslogtreecommitdiff
path: root/doc/tools
AgeCommit message (Collapse)Author
2017-11-19Fix the class docs for the rst-syntax errors.Martin Capitanio
- Generate a correkt rst-syntax for the [/code] inline markup. (http://www.sphinx-doc.org/en/1.6.5/rest.html#inline-markup) - Fix xml souce bugs for the sphinx's rst syntax werrors: class_area.rst:319: WARNING: Inline literal start-string without end-string. class_area2d.rst:287: WARNING: Inline literal start-string without end-string. class_audioserver.rst:287: WARNING: Inline literal start-string without end-string. class_control.rst:509: WARNING: Inline literal start-string without end-string. class_image.rst:422: WARNING: Inline literal start-string without end-string. class_image.rst:434: WARNING: Inline literal start-string without end-string. class_inputevent.rst:74: WARNING: Inline literal start-string without end-string. class_inputeventaction.rst:45: WARNING: Inline literal start-string without end-string. class_inputmap.rst:47: WARNING: Inline literal start-string without end-string. class_kinematicbody.rst:80: WARNING: Inline interpreted text or phrase reference start-string without end-string. class_kinematicbody2d.rst:80: WARNING: Inline interpreted text or phrase reference start-string without end-string. class_line2d.rst:182: WARNING: Inline literal start-string without end-string. class_thread.rst:51: WARNING: Inline literal start-string without end-string. class_treeitem.rst:160: WARNING: Inline literal start-string without end-string.
2017-11-18Fix class docs, improve error handling of the rst generator.Martin Capitanio
The rst-generator gives you now a hint what's going on: Bad reference: 'method.RegEx.search_all' in file: ../modules/regex/doc_classes/RegExMatch.xml grep 'method.RegEx.search_all' ../modules/regex/doc_classes/RegExMatch.xml Contains the results of a single regex match returned by [method RegEx.search] and [method.RegEx.search_all]. It can be used to find the position and range of the match and its capturing groups, and it can extract its sub-string for you.
2017-10-21makerst: Remove stray spaces in method signaturesRémi Verschelde
2017-10-21makerst: Add support for [member] and [signal]Rémi Verschelde
Part of #11137. [enum] is still missing, and none are implemented in the engine itself yet.
2017-10-21makerst: Fix rst-ization of members and escaping of [Class]sRémi Verschelde
Fixes #11517.
2017-10-19Merge pull request #12053 from Grosskopf/audiodocs-fixRémi Verschelde
filtering getters&setters over strings works for AudioStreamPlayer*
2017-10-15filtering getters&setters over strings works for AudioStreamPlayer*Grosskopf
2017-10-14makerst: Fix support for module classesRémi Verschelde
Previous code expected only one XML per module, which is not the case for e.g. mono or gdnative. Also add newline after signal description to fix rst warning, and make the script Python 3-compatible. [ci skip]
2017-10-07doc_status.py: Error message for unknown CLI flag, switch shebang to pythonmhilbrunner
2017-10-03doc_status.py: Add -e (--empty) option to hide items with nothing left to domhilbrunner
2017-10-02Merge pull request #11757 from mhilbrunner/doc_status_py27Andreas Haas
doc_status.py Python 2.7 backwards compatibility & Windows support
2017-10-02Merge pull request #11654 from bojidar-bg/docstatus-fnmatchPoommetee Ketson
Allow using wildcards to filter docstatus class names
2017-10-01doc_status.py Python 2.7 backwards compatibilitymhilbrunner
2017-09-28Allow using wildcards to filter docstatus class namesBojidar Marinov
[ci skip]
2017-09-23makerst.py: Support split classes XML and use folders and/or single files as ↵Alexander Meerhoff
input The new syntax is (from `doc/`): `tools/makerst.py classes/ ../modules/`. Also adapted `make rst` target accordingly. [ci skip]
2017-09-16Make doc_status output a bit more markdown-friendly, hide some printsBojidar Marinov
2017-09-15Update doc status generator.Daniel J. Ramirez
[ciskip]
2017-07-22Docs: ignore tags inside code,codeblock tagPoommetee Ketson
2017-06-14Add Signals descriptions when they exist.Julian Murgia
2017-05-06Doc: Drop unmainted converters for html, textile, dokuwikiRémi Verschelde
2017-05-06Doc: Remove unused tool translationRémi Verschelde
2017-04-08Add "Godot Engine contributors" copyright lineRémi Verschelde
2017-04-05Fix URLs to moved docs pagesRémi Verschelde
Closes #8266.
2017-03-29Update classes.xml to master version, add a small feature to doc_statusBojidar Marinov
2017-01-01Welcome in 2017, dear changelog reader!Rémi Verschelde
That year should bring the long-awaited OpenGL ES 3.0 compatible renderer with state-of-the-art rendering techniques tuned to work as low as middle end handheld devices - without compromising with the possibilities given for higher end desktop games of course. Great times ahead for the Godot community and the gamers that will play our games!
2016-11-01style: Various other PEP8 fixes in Python filesRémi Verschelde
Done with `autopep8 --select=E7`, fixes: - E701 - Put colon-separated compound statement on separate lines. - E702 - Put semicolon-separated compound statement on separate lines. - E703 - Put semicolon-separated compound statement on separate lines. - E711 - Fix comparison with None. - E712 - Fix (trivial case of) comparison with boolean. - E713 - Fix (trivial case of) non-membership check. - E721 - Fix various deprecated code (via lib2to3).
2016-11-01style: Fix PEP8 blank lines issues in Python filesRémi Verschelde
Done with `autopep8 --select=E3,W3`, fixes: - E301 - Add missing blank line. - E302 - Add missing 2 blank lines. - E303 - Remove extra blank lines. - E304 - Remove blank line following function decorator. - E309 - Add missing blank line. - W391 - Remove trailing blank lines.
2016-11-01style: Fix PEP8 whitespace issues in Python filesRémi Verschelde
Done with `autopep8 --select=E2,W2`, fixes: - E201 - Remove extraneous whitespace. - E202 - Remove extraneous whitespace. - E203 - Remove extraneous whitespace. - E211 - Remove extraneous whitespace. - E221 - Fix extraneous whitespace around keywords. - E222 - Fix extraneous whitespace around keywords. - E223 - Fix extraneous whitespace around keywords. - E224 - Remove extraneous whitespace around operator. - E225 - Fix missing whitespace around operator. - E226 - Fix missing whitespace around operator. - E227 - Fix missing whitespace around operator. - E228 - Fix missing whitespace around operator. - E231 - Add missing whitespace. - E231 - Fix various deprecated code (via lib2to3). - E241 - Fix extraneous whitespace around keywords. - E242 - Remove extraneous whitespace around operator. - E251 - Remove whitespace around parameter '=' sign. - E261 - Fix spacing after comment hash. - E262 - Fix spacing after comment hash. - E265 - Format block comments. - E271 - Fix extraneous whitespace around keywords. - E272 - Fix extraneous whitespace around keywords. - E273 - Fix extraneous whitespace around keywords. - E274 - Fix extraneous whitespace around keywords. - W291 - Remove trailing whitespace. - W293 - Remove trailing whitespace.
2016-11-01style: Start applying PEP8 to Python files, indentation issuesRémi Verschelde
Done with `autopep8 --select=E1`, fixes: - E101 - Reindent all lines. - E112 - Fix under-indented comments. - E113 - Fix over-indented comments. - E115 - Fix under-indented comments. - E116 - Fix over-indented comments. - E121 - Fix a badly indented line. - E122 - Fix a badly indented line. - E123 - Fix a badly indented line. - E124 - Fix a badly indented line. - E125 - Fix indentation undistinguish from the next logical line. - E126 - Fix a badly indented line. - E127 - Fix a badly indented line. - E128 - Fix a badly indented line. - E129 - Fix a badly indented line.
2016-10-17SCsub: Add python shebang as a hint for syntax highlightingRémi Verschelde
Also switch existing shebangs to "better" /usr/bin/env python.
2016-06-22classref: Fix UTF-8 parsing in makerstRémi Verschelde
2016-04-26Various improvements to doc_status.pyRémi Verschelde
- Make comments opt-in (smaller table in width) - Reduce length of Brief Description and Description (also smaller table as output) - Make names cyan (blue is too dark on black terminal) - Drop some redundant synonyms for the flags
2016-04-22Add a python script to check the current doc statusBojidar Marinov
2016-04-02Remove trailing spacesRémi Verschelde
2016-02-17Add a warning header to each rst fileRémi Verschelde
To tell potential contributors that they should direct their work to the XML template and not the auto-generated reST
2016-02-17Implement support for [codeblock] tag in helpRémi Verschelde
It allows to define a multiline space-indented code block that will be properly parsed by the reST converter for the online docs. The in-editor help understand the [codeblock] tag as it supposedly understand [code] already (i.e. it just seems to discard it, though the code was supposed to switch it to a monospace font, but that's likely another issue.
2016-02-07Improve parsing of [method ...] tagsRémi Verschelde
Also improve some code display.
2016-02-07Fix badly formatted tags in XMLRémi Verschelde
Also add parsing of [code] tags in RST converter
2016-02-07Display better inheritance info in docJuan Linietsky
2016-02-07Small makerst improvementsRémi Verschelde
2016-02-07Enhance xml to rst converterRémi Verschelde
Fixes a number of issues: - Headings underliners now have the correct length - Newline+Tabs in descriptions are replaced by two newlines to make a proper paragraph - [br] are replaced by two newlines, making a proper paragraph - Properly parse internal hyperlinks in constants description - Fix broken internal links due to missing newlines - Show method header even when it has no description, to have something to reference in hyperlinks
2016-02-06-Added RST generator for class referenceJuan Linietsky
2016-01-01Update copyright to 2016 in headersGeorge Marques
2015-12-13Add a Makefile to generate classes doc in various formatsRémi Verschelde
All the generated documentation is put in doc/_build.
2015-12-12Move documentation python tools to doc/tools folderRémi Verschelde