[NaCl SDK Docs] Simplify PPAPI documentation generation.

[NaCl SDK Docs] Simplify PPAPI documentation generation.

* Modified chrome_sidenav.json to point to the correct locations.
* Added new template Doxygen config files for PPAPI C/C++ to the
  native_client_sdk directory.
* Copied doxy_cleanup.py from ppapi/c/documentation, and moved it to
  native_client_sdk, with some cleanup
* Modified doxygen header/footer to generate for chromesite
* Added generate_docs.py script. This automates nearly all of the
  doxygen documentation generation: gets the current stable/beta/dev branches,
  downloads ppapi via SVN, runs doxygen, runs doxy_cleanup, and generates
  ReST files for reference indexes.

No tryjobs because this is a documentation-only change.

BUG=none
R=awatson@chromium.org, sbc@chromium.org

Committed: https://src.chromium.org/viewvc/chrome?view=rev&revision=245362

[Sam Clegg, 2014-01-15 23:22:58]

lgtm

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
File native_client_sdk/src/doc/doxygen/generate_docs.py (right):

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
native_client_sdk/src/doc/doxygen/generate_docs.py:63: pass
Why ignore these errors?

[binji, 2014-01-15 23:56:16]

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
File native_client_sdk/src/doc/doxygen/generate_docs.py (right):

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
native_client_sdk/src/doc/doxygen/generate_docs.py:63: pass
On 2014/01/15 23:22:59, Sam Clegg wrote:
> Why ignore these errors?

I don't want to error when the file or directory doesn't exist. I guess in the
rest of the SDK we check via os.path.exists instead, right?

[Sam Clegg, 2014-01-16 02:25:37]

On 2014/01/15 23:56:16, binji wrote:
>
https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
> File native_client_sdk/src/doc/doxygen/generate_docs.py (right):
> 
>
https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
> native_client_sdk/src/doc/doxygen/generate_docs.py:63: pass
> On 2014/01/15 23:22:59, Sam Clegg wrote:
> > Why ignore these errors?
> 
> I don't want to error when the file or directory doesn't exist. I guess in the
> rest of the SDK we check via os.path.exists instead, right?

Yes, that sounds better.

[Andy, 2014-01-16 09:51:38]

LGTM.  A couple of comments inline.

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
File native_client_sdk/src/doc/pepper_beta/c/index.rst (right):

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
native_client_sdk/src/doc/pepper_beta/c/index.rst:8: 
Can we add a note here for all six index pages (C and C++ / dev, beta, and
stable), along these lines:

"""
This page lists the C API for Pepper 31.  Apps that use this API can run in
Chrome 31 or higher.
"""

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
native_client_sdk/src/doc/pepper_beta/c/index.rst:13: * `PPB_Audio_1_1
<struct_p_p_b___audio__1__1.html>`_
On DevSite, the scripts generate just one version of each interface (e.g., just
PPB_Audio, instead of 1_0 and 1_1 versions).  Do we want to provide multiple
versions?

[binji, 2014-01-16 22:27:07]

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
File native_client_sdk/src/doc/doxygen/generate_docs.py (right):

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/do...
native_client_sdk/src/doc/doxygen/generate_docs.py:63: pass
On 2014/01/15 23:56:16, binji wrote:
> On 2014/01/15 23:22:59, Sam Clegg wrote:
> > Why ignore these errors?
> 
> I don't want to error when the file or directory doesn't exist. I guess in the
> rest of the SDK we check via os.path.exists instead, right?

Done.

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
File native_client_sdk/src/doc/pepper_beta/c/index.rst (right):

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
native_client_sdk/src/doc/pepper_beta/c/index.rst:8: 
On 2014/01/16 09:51:39, Andy wrote:
> Can we add a note here for all six index pages (C and C++ / dev, beta, and
> stable), along these lines:
> 
> """
> This page lists the C API for Pepper 31.  Apps that use this API can run in
> Chrome 31 or higher.
> """

Done.

https://codereview.chromium.org/136033007/diff/1/native_client_sdk/src/doc/pe...
native_client_sdk/src/doc/pepper_beta/c/index.rst:13: * `PPB_Audio_1_1
<struct_p_p_b___audio__1__1.html>`_
On 2014/01/16 09:51:39, Andy wrote:
> On DevSite, the scripts generate just one version of each interface (e.g.,
just
> PPB_Audio, instead of 1_0 and 1_1 versions).  Do we want to provide multiple
> versions?

Done.

[binji, 2014-01-16 22:55:38]

Committed patchset #5 manually as r245362 (presubmit successful).