[NaCl Docs] Add devcyle/building.rst

This is direct port of the current content.  No editing yet.

R=eliben@chromium.org

Review URL: https://codereview.chromium.org/23463019

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@221807 0039d316-1c4b-4281-b951-d872f2087c98

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

native_client_sdk/src/doc/devguide/devcycle/dynamic-loading.rst

+######################################
+Dynamic Linking and Loading with glibc
+######################################

native_client_sdk/src/doc/devguide/devcycle/index.rst

+.. _devcycle:
+
+#################
+Development Cycle
+#################
+
+This section of the Developer's Guide provides information about how to
+compile, run, and debug Native Client applications.

native_client_sdk/src/doc/index.rst

@@ -15,9 +15,11 @@ Contents:
    sdk/release-notes.rst
    devguide/index.rst
    devguide/tutorial.rst
+   devguide/devcycle/index.rst
    devguide/devcycle/building.rst
    devguide/devcycle/running.rst
    devguide/devcycle/debugging.rst
+   devguide/devcycle/dynamic-loading.rst
    devguide/coding/3D-graphics.rst
    devguide/coding/audio.rst
    devguide/coding/application-structure.rst

native_client_sdk/src/doc/overview.rst

@@ -187,6 +187,8 @@ open web.
 Native Client in a web application
 ==================================
 
+.. _application_files:
+
 A Native Client application consists of a set of files:
 
 * **HTML web page**, **CSS**, and **JavaScript** files, as in any modern web