Add git_docs folder to depot_tools.

Add git_docs folder to depot_tools.

Includes trial documentation for git-freeze and git-thaw, as well as a
make_docs.sh script which generates man and html documentation from the input
asciidoc files, using git 1.9's documentation toolchain.

R=szager@chromium.org, agable@chromium.org
BUG=261738
Committed: http://src.chromium.org/viewvc/chrome?view=rev&revision=257214

[agable, 2014-03-13 17:23:31]

LGTM % nits. Please send man pages for all other gitscripts soon :)

https://codereview.chromium.org/196133007/diff/10001/git_docs/git-freeze.txt
File git_docs/git-freeze.txt (right):

https://codereview.chromium.org/196133007/diff/10001/git_docs/git-freeze.txt#...
git_docs/git-freeze.txt:10: [verse]
[verse]?

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh
File git_docs/make_docs.sh (right):

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:7: # them to html + manpage format using git 1.9's doc
toolchain, then installs
"... then puts them in depot_tools to be committed."

"Installs" makes it sound like it should be run on every developer's machine.

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:43: ed git/Documentation/asciidoc.conf <<EOF
aww yisss ed

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:48: s/Git Manual/chromium depot_tools Manual
Chromium

[szager1, 2014-03-13 18:16:30]

https://codereview.chromium.org/196133007/diff/10001/git_docs/_footer.txt
File git_docs/_footer.txt (right):

https://codereview.chromium.org/196133007/diff/10001/git_docs/_footer.txt#new...
git_docs/_footer.txt:3: Part of the chromium depot_tools suite. These tools are
meant to assist with the
Probably should add a copyright notice, here or in a _header.txt.

[iannucci, 2014-03-13 18:17:42]

https://codereview.chromium.org/196133007/diff/10001/git_docs/git-freeze.txt
File git_docs/git-freeze.txt (right):

https://codereview.chromium.org/196133007/diff/10001/git_docs/git-freeze.txt#...
git_docs/git-freeze.txt:10: [verse]
On 2014/03/13 17:23:31, agable wrote:
> [verse]?

It makes this a separate stanza, see synopsis:
https://www.kernel.org/pub/software/scm/git/docs/git-status.html

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh
File git_docs/make_docs.sh (right):

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:7: # them to html + manpage format using git 1.9's doc
toolchain, then installs
On 2014/03/13 17:23:31, agable wrote:
> "... then puts them in depot_tools to be committed."
> 
> "Installs" makes it sound like it should be run on every developer's machine.

Done.

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:43: ed git/Documentation/asciidoc.conf <<EOF
On 2014/03/13 17:23:31, agable wrote:
> aww yisss ed

:D

https://codereview.chromium.org/196133007/diff/10001/git_docs/make_docs.sh#ne...
git_docs/make_docs.sh:48: s/Git Manual/chromium depot_tools Manual
On 2014/03/13 17:23:31, agable wrote:
> Chromium

Done.

[iannucci, 2014-03-13 23:10:40]

On 2014/03/13 18:16:30, szager1 wrote:
> https://codereview.chromium.org/196133007/diff/10001/git_docs/_footer.txt
> File git_docs/_footer.txt (right):
> 
>
https://codereview.chromium.org/196133007/diff/10001/git_docs/_footer.txt#new...
> git_docs/_footer.txt:3: Part of the chromium depot_tools suite. These tools
are
> meant to assist with the
> Probably should add a copyright notice, here or in a _header.txt.

Hm... I can't find any examples of a manpage w/ copyright notice in it? Do you
have a reference for what it should look like?

[iannucci, 2014-03-14 21:38:37]

The CQ bit was checked by iannucci@chromium.org

[commit-bot: I haz the power, 2014-03-14 21:38:46]

CQ is trying da patch. Follow status at
https://chromium-status.appspot.com/cq/iannucci@chromium.org/196133007/70001

[commit-bot: I haz the power, 2014-03-14 21:40:51]

Change committed as 257214