The page with the application specific makefile variables and their defaults is generated (nearly automatically) from the existing application.mk make file. This is how it works:

• Run makefile_doc.py on application.mk and capture its XML output. makefile_doc.py resides in the same directory as the make files themselves. It tries to make sense of the make file entries, together with comments which hang around. It should be applicable to many of our make files, but is only tested against application.mk, being the reason it has been written. (Other parts of qooxdoo are using the XML too, like QxAdmin, so this intermediate step is not in vain).

python makefile_doc.py application.mk > mak.xml

• Run the previous output through an XSLT processor using makefile_doc.xsl. This will turn the XML into a qooxdoo DokuWiki compatible format.

xsltproc makefile_doc.xsl mak.xml > mak.wiki

• Post-process the output. Currently, the following changes are made by hand:
  • cut everything before “REQUIRED SETTINGS”
  • cut everything including and after “INCLUDE EXTERNAL MAKEFILES”
• In the existing wiki page:
  • retain the introduction (the part before the real data starts)
  • update the “version” entry to the current svn version of application.mk