Issue 1299 - Generate docs outside the devbuild build process

.sitescripts.example

 [DEFAULT]
 root=/server/root/path
 mailer=/usr/sbin/sendmail
 mailerDebug=no
 secret=somerandomstringhere
 
 [multiplexer]
 sitescripts.subscriptions.web.fallback =
 sitescripts.crashes.web.submitCrash =
 sitescripts.reports.web.submitReport =
@@ skipping 102 matching lines @@
 nightliesURL=https://adblockplus.org/devbuilds/
 downloadsRepo=%(root)s/hg/downloads
 downloadsDirectory=%(root)s/www/downloads
 downloadsURL=https://downloads.adblockplus.org/
 downloadLinksFile=%(root)s/tmp/downloadLinks.ini
 geckoUpdateManifestPath=%(root)s/www/update.rdf
 androidUpdateManifestPath=%(root)s/www/androidupdates.xml
 androidNewUpdateManifestPath=%(root)s/www/androidupdate.json
 safariUpdateManifestPath=%(root)s/www/updates.plist
 ieUpdateManifestPath=%(root)s/www/ieupdate.json
-docsDirectory=%(root)s/www/jsdoc
 padDirectory=%(root)s/www/pad
 padURL=https://adblockplus.org/pad/
 errorTemplate=extensions/template/error.html
 languageCheckTemplate=extensions/template/languageCheckResult.html
 languageFormTemplate=extensions/template/languageForm.html
 changelogTemplate=extensions/template/changelog.html
 geckoUpdateManifest=extensions/template/update.rdf
 chromeUpdateManifest=extensions/template/updates.xml
 safariUpdateManifest=extensions/template/updates.plist
 androidUpdateManifest=extensions/template/androidupdates.xml
@@ skipping 61 matching lines @@
 sitekeyPath=%(root)s/testpages.adblockplus.org/static/site.key
 
 [content_blocker_lists]
 abp2blocklist_url=https://hg.adblockplus.org/abp2blocklist
 abp2blocklist_path=%(root)s/content_blocker_lists/abp2blocklist
 easylist_url=https://easylist-downloads.adblockplus.org/easylist.txt
 exceptionrules_url=https://easylist-downloads.adblockplus.org/exceptionrules.txt
 easylist_content_blocker_path=%(root)s/content_blocker_lists/easylist_content_blocker.json
 easylist_content_blocker_expires=4 days
 combined_content_blocker_path=%(root)s/content_blocker_lists/easylist+exceptionrules_content_blocker.json
-combined_content_blocker_expires=4 days
+combined_content_blocker_expires=4 days
+
+[docs]
+temp_directory=%(root)s/docs-tmp
+adblockplus_repository=%(root)s/hg/adblockplus
+adblockplus_target_directory=%(root)s/www/jsdoc/adblockplus
+adblockplus_command=./build.py -t gecko docs {output_dir} &>/dev/null

[Felix Dahlke, 2016/02/05 20:47:59]

Unless I do this, the ensure_dependencies.py output shows up. I'm wondering if
we shouldn't just always swallow all output from these commands...

[Sebastian Noack, 2016/02/06 09:49:50]

That's probably a bad idea. If something is wrong on the server, the
corresponding errors should be logged and sent via cron mails. Otherwise we
wouldn't know when things are broken.

So if we keep calling build.py here, we really should only filter out the INFO
log messages. One way to do that, would be introducing an environment variable
or an option that is passed through from build.py, to set the log level.

[Felix Dahlke, 2016/02/06 10:46:39]

Yes you're right, that's much better.

[Sebastian Noack, 2016/02/06 13:39:39]

LGTM with this being resolved.

+adblockpluschrome_repository=%(root)s/hg/adblockpluschrome
+adblockpluschrome_target_directory=%(root)s/www/jsdoc/adblockpluschrome
+adblockpluschrome_command=./build.py -t chrome docs {output_dir} &>/dev/null
+adblockpluscore_repository=%(root)s/hg/adblockpluscore
+adblockpluscore_target_directory=%(root)s/www/jsdoc/adblockpluscore
+adblockpluscore_command=./generate_docs.py {output_dir} &>/dev/null
+libadblockplus_repository=%(root)s/hg/libadblockplus
+libadblockplus_target_directory=%(root)s/www/docs/libadblockplus
+libadblockplus_command=make docs &>/dev/null && mv docs/html {output_dir}