move docs generation

Move Doxyfile files to docs and associated makefile. This is a prelude to allowing a docs directory for all the RST files as well as expanding the makefile to build the docs for those too, not just the doxygen output.

The doxygen html has been moved to build/docs/html so it's not in a source directory.

Gitignore has been fixed to allow files in docs now without complaining.

BUG=
R=stichnot@chromium.org

Committed: https://gerrit.chromium.org/gerrit/gitweb?p=native_client/pnacl-subzero.git;a=commit;h=4cba1cbba5cb2b0a487734a822ff39607a32926d

[rkotlerimgtec, 2016-01-06 04:22:38]

Description was changed from

==========
move docs generation

BUG=
==========

to

==========
Move Doxyfile files to docs and associated makefile. This is a prelude to
allowing a docs directory for all the RST files as well as expanding the
makefile to build the docs for those too, not just the doxygen output.

The doxygen html has been moved to build/docs/html so it's not in a source
directory.

Gitignore has been fixed to allow files in docs now without complaining.

BUG=
==========

[rkotlerimgtec, 2016-01-06 04:22:38]

rkotlerimgtec@gmail.com changed reviewers:
+ jpp@chromium.org, kschimpf@chromium.org, stichnot@chromium.org

[Jim Stichnoth, 2016-01-06 19:59:32]

https://codereview.chromium.org/1562703002/diff/1/.gitignore
File .gitignore (left):

https://codereview.chromium.org/1562703002/diff/1/.gitignore#oldcode13
.gitignore:13: /docs/
Should this be preserved as /docs/html/ ?

Also, my docs/ directory happens to contain a few doxygen_objdb_*.tmp files
which were being conveniently ignored, fwiw.

[rkotlerimgtec, 2016-01-07 00:02:53]

https://codereview.chromium.org/1562703002/diff/1/.gitignore
File .gitignore (left):

https://codereview.chromium.org/1562703002/diff/1/.gitignore#oldcode13
.gitignore:13: /docs/
On 2016/01/06 19:59:32, stichnot wrote:
> Should this be preserved as /docs/html/ ?
> 
> Also, my docs/ directory happens to contain a few doxygen_objdb_*.tmp files
> which were being conveniently ignored, fwiw.

The docs/html have been moved to the build directory.

[Jim Stichnoth, 2016-01-07 01:27:29]

Can you rebase and upload a new version?  There are (expected) conflicts after
landing the previous CL.

[rkotlerimgtec, 2016-01-07 01:48:00]

Patchset #2 (id:20001) has been deleted

[rkotlerimgtec, 2016-01-07 01:56:39]

On 2016/01/07 01:52:16, rkotlerimgtec wrote:

 408           -i x8632,nonsfi,sse2,O2 -e x8632,nonsfi,test_select \	 408       
   -i x8632,nonsfi,sse2,O2 \

Not sure if this rebase did the right thing for this line 408

[Jim Stichnoth, 2016-01-07 02:00:39]

https://codereview.chromium.org/1562703002/diff/40001/.gitignore
File .gitignore (left):

https://codereview.chromium.org/1562703002/diff/40001/.gitignore#oldcode13
.gitignore:13: /docs/html/
I don't think this should be deleted.

https://codereview.chromium.org/1562703002/diff/40001/Makefile.standalone
File Makefile.standalone (left):

https://codereview.chromium.org/1562703002/diff/40001/Makefile.standalone#old...
Makefile.standalone:520: rm -rf build/ docs/html
I think docs/html still needs to be removed under clean-all.  Also,
crosstest/Output/ while you're at it.

[rkotlerimgtec, 2016-01-07 04:47:53]

https://codereview.chromium.org/1562703002/diff/40001/.gitignore
File .gitignore (left):

https://codereview.chromium.org/1562703002/diff/40001/.gitignore#oldcode13
.gitignore:13: /docs/html/
On 2016/01/07 02:00:39, stichnot wrote:
> I don't think this should be deleted.

I will put it back in. It's harmless but not needed because there are no files
being put in docs/html any longer.

https://codereview.chromium.org/1562703002/diff/40001/Makefile.standalone
File Makefile.standalone (left):

https://codereview.chromium.org/1562703002/diff/40001/Makefile.standalone#old...
Makefile.standalone:520: rm -rf build/ docs/html
On 2016/01/07 02:00:39, stichnot wrote:
> I think docs/html still needs to be removed under clean-all.  Also,
> crosstest/Output/ while you're at it.

I've made the changes. There is no docs/html any longer - it's in build not so
there should be no files to clean up (except the first time). Of course for old
build areas, there could be an issue with this.

[Jim Stichnoth, 2016-01-07 16:22:10]

Sorry, somehow I completely missed that doxygen output was moved into the build/
directory.  This is great, and I think it's fine to expect current developers to
manually clean the old docs/html/ directory.

Can you go back to the previous patchset?  Thanks!

[Jim Stichnoth, 2016-01-07 16:44:58]

LGTM.

BTW, if you "make clean-all" and then "make docs", you get an error because the
build/ subdir doesn't exist.  This may be something to fold into a future CL.

[Jim Stichnoth, 2016-01-07 16:45:18]

Description was changed from

==========
Move Doxyfile files to docs and associated makefile. This is a prelude to
allowing a docs directory for all the RST files as well as expanding the
makefile to build the docs for those too, not just the doxygen output.

The doxygen html has been moved to build/docs/html so it's not in a source
directory.

Gitignore has been fixed to allow files in docs now without complaining.

BUG=
==========

to

==========
Move Doxyfile files to docs and associated makefile. This is a prelude to
allowing a docs directory for all the RST files as well as expanding the
makefile to build the docs for those too, not just the doxygen output.

The doxygen html has been moved to build/docs/html so it's not in a source
directory.

Gitignore has been fixed to allow files in docs now without complaining.

BUG=
R=stichnot@chromium.org

Committed:
https://gerrit.chromium.org/gerrit/gitweb?p=native_client/pnacl-subzero.git;a...
==========

[Jim Stichnoth, 2016-01-07 16:45:20]

Committed patchset #4 (id:80001) manually as
4cba1cbba5cb2b0a487734a822ff39607a32926d (presubmit successful).