Add git_docs folder to depot_tools.

git_docs/make_docs.sh

+#!/bin/bash -e
+shopt -s nullglob
+
+cd $(dirname "$0")
+
+# Script which takes all the asciidoc git-*.txt files in this directory, renders
+# them to html + manpage format using git 1.9's doc toolchain, then installs

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

"... then puts them in depot_tools to be committed."

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

[iannucci, 2014/03/13 18:17:43]

Done.

+# them in depot_tools.
+
+ensure_in_path() {
+  local CMD=$1
+  local PTH=$(which "$CMD")
+  if [[ ! $PTH ]]
+  then
+    echo Must have "$CMD" on your PATH!
+    exit 1
+  else
+    echo Using \'$PTH\' for ${CMD}.
+  fi
+}
+
+ensure_in_path xmlto
+ensure_in_path asciidoc
+
+DFLT_CATALOG_PATH="/usr/local/etc/xml/catalog"
+if [[ ! $XML_CATALOG_FILES && -f "$DFLT_CATALOG_PATH" ]]
+then
+  # Default if you install doctools with homebrew on mac
+  export XML_CATALOG_FILES="$DFLT_CATALOG_PATH"
+  echo Using \'$DFLT_CATALOG_PATH\' for \$XML_CATALOG_FILES.
+fi
+
+# We pull git to get its documentation toolchain
+BRANCH=v1.9.0
+GITHASH=5f95c9f850b19b368c43ae399cc831b17a26a5ac
+if [[ ! -d git || $(git -C git rev-parse HEAD) != $GITHASH ]]
+then
+  echo Cloning git
+  rm -rf git
+  git clone --single-branch --branch $BRANCH --depth 1 \
+    https://kernel.googlesource.com/pub/scm/git/git.git  2> /dev/null
+
+  ed git/Documentation/asciidoc.conf <<EOF

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

aww yisss ed

[iannucci, 2014/03/13 18:17:43]

:D

+  H
+  81
+  s/Git/depot_tools
+  +2
+  s/Git Manual/chromium depot_tools Manual

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

Chromium

[iannucci, 2014/03/13 18:17:43]

Done.

+  wq
+EOF
+fi
+echo Git up to date at $GITHASH \($BRANCH\)
+
+HTML_TARGETS=()
+MAN_TARGETS=()
+for x in *.txt
+do
+  TO="git/Documentation/$x"
+  if [[ ! -f "$TO" ]] || ! cmp --silent "$x" "$TO"
+  then
+    echo \'$x\' differs
+    cp $x "$TO"
+  fi
+  # Exclude files beginning with _ from the target list. This is useful to have
+  # includable snippet files.
+  if [[ ${x:0:1} != _ ]]
+  then
+    HTML_TARGETS+=("${x%%.txt}.html")
+    MAN_TARGETS+=("${x%%.txt}.1")
+  fi
+done
+
+VER="v$(git rev-parse --short HEAD)"
+if [[ ! -f git/version ]] || ! cmp --silent git/version <(echo "$VER")
+then
+  echo Version changed, cleaning.
+  echo "$VER" > git/version
+  (cd git/Documentation && make clean)
+fi
+
+# This export is so that asciidoc sys snippets which invoke git run relative to
+# depot_tools instead of the git clone.
+(
+  export GIT_DIR="$(git rev-parse --git-dir)" &&
+  cd git/Documentation &&
+  make -j"$[${#MAN_TARGETS} + ${#HTML_TARGETS}]" "${MAN_TARGETS[@]}" "${HTML_TARGETS[@]}"
+)
+
+mkdir htmlout 2> /dev/null || true
+for x in "${HTML_TARGETS[@]}"
+do
+  echo Copying htmlout/$x
+  cp "git/Documentation/$x" htmlout
+done
+
+for x in "${MAN_TARGETS[@]}"
+do
+  echo Copying ../man1/$x
+  cp "git/Documentation/$x" ../man1
+done