godot/doc/Makefile

BASEDIR = $(CURDIR)
CLASSES = $(BASEDIR)/classes/ $(BASEDIR)/../modules/
OUTPUTDIR = $(BASEDIR)/_build
TOOLSDIR = $(BASEDIR)/tools

.ONESHELL:

clean:
	rm -rf $(OUTPUTDIR)

doxygen:
	rm -rf $(OUTPUTDIR)/doxygen
	mkdir -p $(OUTPUTDIR)/doxygen
	doxygen Doxyfile

rst:
	rm -rf $(OUTPUTDIR)/rst
	mkdir -p $(OUTPUTDIR)/rst
	pushd $(OUTPUTDIR)/rst
	python3 $(TOOLSDIR)/makerst.py $(CLASSES)
	popd
Add a Makefile to generate classes doc in various formats All the generated documentation is put in doc/_build. 2015-12-13 00:01:04 +01:00			`BASEDIR = $(CURDIR)`
makerst.py: Support split classes XML and use folders and/or single files as input The new syntax is (from `doc/`): `tools/makerst.py classes/ ../modules/`. Also adapted `make rst` target accordingly. [ci skip] 2017-09-22 16:55:48 +02:00			`CLASSES = $(BASEDIR)/classes/ $(BASEDIR)/../modules/`
Add a Makefile to generate classes doc in various formats All the generated documentation is put in doc/_build. 2015-12-13 00:01:04 +01:00			`OUTPUTDIR = $(BASEDIR)/_build`
			`TOOLSDIR = $(BASEDIR)/tools`

			`.ONESHELL:`

			`clean:`
			`rm -rf $(OUTPUTDIR)`

			`doxygen:`
			`rm -rf $(OUTPUTDIR)/doxygen`
			`mkdir -p $(OUTPUTDIR)/doxygen`
			`doxygen Doxyfile`

			`rst:`
			`rm -rf $(OUTPUTDIR)/rst`
			`mkdir -p $(OUTPUTDIR)/rst`
			`pushd $(OUTPUTDIR)/rst`
Clean up & improve makerst.py Man this file even had some semicolons in it. I cleaned up the entire file, while it's still pretty ugly it's much better now. I also added type checks so it passes mypy --strict. make_type now throws a warning on unresolved type references, which there are a bunch of. I'm not responsible for fixing those though. Also some more hardening against crashes. For example XML tags without content won't cause crashes now. Functionality has not been modified as far as I can tell. Update Makefile for Python 3 Fix ordering issues related to enums & constants 2018-12-26 15:57:51 +01:00			`python3 $(TOOLSDIR)/makerst.py $(CLASSES)`
Add a Makefile to generate classes doc in various formats All the generated documentation is put in doc/_build. 2015-12-13 00:01:04 +01:00			`popd`