[NaCl Docs] Add devcyle/building.rst

native_client_sdk/src/doc/Makefile

 # Makefile for Sphinx documentation
 #
 
 # You can set these variables from the command line.
 SPHINXOPTS    = -W
 SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build
 
 # User-friendly check for sphinx-build
 ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
 $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
 endif
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
 PAPEROPT_letter = -D latex_paper_size=letter
 ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext all
 
 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)/*
 
 html:
         $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
         @echo
         @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 
 dirhtml:
@@ skipping 111 matching lines @@
 xml:
         $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
         @echo
         @echo "Build finished. The XML files are in $(BUILDDIR)/xml."
 
 pseudoxml:
         $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/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