0 votes

I've made changes to the _bind_methods function for a class and I want to update the documentation for the class as part of the PR I intend to submit. How do I go about updating the XML files with new generated content that includes my changes so that I can add the new descriptions accordingly?

asked Dec 11, 2017 in Engine by Will Nations (173 points)

1 Answer

0 votes
Best answer

You can run godot --doctool <path> to dump the generated XML files. Running just godot --doctool . will put them where they are supposed to be in the main /godot/ folder and will merge them in with the existing XML docs. In this scenario, godot is the name of the path and name to your godot executable, for example ./bin/godot.x11.tools.64 would be a path from the godot directory root.

Note that this will regenerate the entire XML documentation. There is currently no way to individually update an XML file. This is because the scripting API used to all be in one XML file and was only separated into individual files during the 3.0 release. The command line interface has not been updated to reflect that change, so there is no way (as of yet) to update only a single file.

answered Dec 11, 2017 by Will Nations (173 points)
edited Dec 11, 2017 by Will Nations
Welcome to Godot Engine Q&A, where you can ask questions and receive answers from other members of the community.

Please make sure to read How to use this Q&A? before posting your first questions.