[NaCl Docs] Add devcyle/building.rst

native_client_sdk/src/doc/Makefile

Index: native_client_sdk/src/doc/Makefile
diff --git a/native_client_sdk/src/doc/Makefile b/native_client_sdk/src/doc/Makefile
index 024730dd2946625a2ba33618d7155bc460afeec6..2fc4e0fe2798c3a6af278caa846d8f88b63d05ec 100644
--- a/native_client_sdk/src/doc/Makefile
+++ b/native_client_sdk/src/doc/Makefile
@@ -25,30 +25,31 @@ all: devsite
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-	@echo "  devsite    build docs for developer.google.com"
-	@echo "  serve      start python web server on port server 8009"
+	@echo "  html         to make standalone HTML files"
+	@echo "  dirhtml      to make HTML files named index.html in directories"
+	@echo "  singlehtml   to make a single large HTML file"
+	@echo "  pickle       to make pickle files"
+	@echo "  json         to make JSON files"
+	@echo "  htmlhelp     to make HTML files and a HTML help project"
+	@echo "  qthelp       to make HTML files and a qthelp project"
+	@echo "  devhelp      to make HTML files and a Devhelp project"
+	@echo "  epub         to make an epub"
+	@echo "  latex        to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf     to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja   to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text         to make text files"
+	@echo "  man          to make manual pages"
+	@echo "  texinfo      to make Texinfo files"
+	@echo "  info         to make Texinfo files and run them through makeinfo"
+	@echo "  gettext      to make PO message catalogs"
+	@echo "  changes      to make an overview of all changed/added/deprecated items"
+	@echo "  xml          to make Docutils-native XML files"
+	@echo "  pseudoxml    to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck    to check all external links for integrity"
+	@echo "  doctest      to run all doctests embedded in the documentation (if enabled)"
+	@echo "  devsite      build locally viewable version of docs for developer.google.com"
+	@echo "  devsite-prod build production docs for developer.google.com"
+	@echo "  serve        start python web server on port server 8009"
 
 clean:
 	rm -rf $(BUILDDIR)/*
@@ -180,8 +181,15 @@ pseudoxml:
 	@echo
 	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
 
+devsite-prod:
+	$(SPHINXBUILD) -b devsite -D devsite_production_mode=1 $(ALLSPHINXOPTS) $(BUILDDIR)/devsite-prod
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/devsite-prod."
+
 devsite:
-	$(SPHINXBUILD) -b devsite $(ALLSPHINXOPTS) $(BUILDDIR)/devsite
+	$(SPHINXBUILD) -b devsite -D devsite_production_mode=0 $(ALLSPHINXOPTS) $(BUILDDIR)/devsite
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/devsite."
 
 serve:
 	cd _build/devsite && python -m SimpleHTTPServer 8009