Move docs folder to man.

docs/src/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 puts
-# them in depot_tools to be committed.
-
-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
-
-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 asciidoc to get the right version
-BRANCH=8.6.9
-ASCIIDOC_HASH=7fed0aff1b30
-if [[ ! -d asciidoc || $(cd asciidoc && hg id -i) != $ASCIIDOC_HASH ]]
-then
-  echo Cloning asciidoc
-  rm -rf asciidoc
-  hg clone -r $BRANCH https://asciidoc.googlecode.com/hg/ asciidoc
-  (cd asciidoc && ln -s asciidoc.py asciidoc)
-fi
-echo Asciidoc up to date at $ASCIIDOC_HASH \($BRANCH\)
-
-export PATH=`pwd`/asciidoc:$PATH
-
-# We pull ansi2hash to convert demo script output
-BRANCH=1.0.6
-ANSI2HTML_HASH=6282ab7a24a5a7eab2e0b23bb0055234c533a6e9
-if [[ ! -d ansi2html || $(git -C ansi2html rev-parse HEAD) != $ANSI2HTML_HASH ]]
-then
-  echo Cloning ansi2html
-  rm -rf ansi2html
-  git clone  --single-branch --branch $BRANCH --depth 1 \
-    https://github.com/ralphbean/ansi2html.git 2> /dev/null
-  curl https://bitbucket.org/gutworth/six/raw/a875ac34c777fe801569c6c5299bf1a35aa578cd/six.py > \
-    ansi2html/ansi2html/six.py
-  ed ansi2html/ansi2html/converter.py <<EOF
-/version_str
-s/pkg.*$/'cool version bro'
-wq
-EOF
-fi
-
-echo ansi2html up to date at $ANSI2HTML_HASH \($BRANCH\)
-
-# 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
-
-  # Replace the 'source' and 'package' strings.
-  ed git/Documentation/asciidoc.conf <<EOF
-H
-81
-s/Git/depot_tools
-+2
-s/Git Manual/Chromium depot_tools Manual
-wq
-EOF
-
-  # fix Makefile to include non-_-prefixed files as MAN7 entries
-  {
-    shopt -s extglob
-    echo H
-    echo 35
-    for x in "$(echo !(git-*|_*).txt)"
-    do
-      echo i
-      echo MAN7_TXT += $x
-      echo .
-    done
-    echo wq
-  } | ed git/Documentation/Makefile
-
-  # fix build-docdep.perl to ignore attributes on include::[] macros
-  ed git/Documentation/build-docdep.perl <<EOF
-H
-12
-c
-            s/\[[^]]*\]//;
-.
-wq
-EOF
-
-  # Add additional CSS override file
-  ed git/Documentation/Makefile <<EOF
-H
-/ASCIIDOC_EXTRA
-a
- -a stylesheet=$(pwd)/git/Documentation/asciidoc-override.css
-.
--1
-j
-/^\$(MAN_HTML):
-a
- asciidoc-override.css
-.
--1
-j
-wq
-EOF
-
-  cat >> git/Documentation/asciidoc.conf <<EOF
-
-[macros]
-(?su)[\\\\]?(?P<name>demo):(?P<target>\S*?)\[\]=
-
-[demo-inlinemacro]
-{sys3:cd $(pwd); ./{docname}.demo.{target}.sh | python filter_demo_output.py {backend} }
-EOF
-
-fi
-echo Git up to date at $GITHASH \($BRANCH\)
-
-if [[ ! -d demo_repo ]]
-then
-  ./prep_demo_repo.sh
-fi
-
-# build directory files for 'essential' and 'helper' sections of the depot_tools
-# manpage.
-for category in helper essential
-do
-  {
-    PRINTED_BANNER=0
-    for x in *.${category}.txt
-    do
-      # If we actually have tools in the category, print the banner first.
-      if [[ $PRINTED_BANNER != 1 ]]
-      then
-        PRINTED_BANNER=1
-        # ex.
-        # CATEGORY TOOLS
-        # --------------
-        BANNER=$(echo $category tools | awk '{print toupper($0)}')
-        echo $BANNER
-        for i in $(seq 1 ${#BANNER})
-        do
-          echo -n -
-        done
-        echo
-        cat _${category}_prefix.txt 2> /dev/null || true
-        echo
-      fi
-
-      # ex.
-      # linkgit:git-tool[1]::
-      # \tinclude::_git-tool_desc.category.txt[]
-      PLAIN_PATH=${x%%_desc.*.txt}
-      PLAIN_PATH=${PLAIN_PATH:1}
-      echo "linkgit:$PLAIN_PATH[1]::"
-      echo -e "include::${x}[]"
-      echo
-    done
-  } > __${category}.txt
-done
-
-JOBS=1
-HTML_TARGETS=()
-MAN1_TARGETS=()
-MAN7_TARGETS=()
-for x in *.txt *.css
-do
-  TO="git/Documentation/$x"
-  if [[ ! -f "$TO" ]] || ! cmp --silent "$x" "$TO"
-  then
-    echo \'$x\' differs
-    cp $x "$TO"
-    # Exclude files beginning with _ from the target list. This is useful to
-    # have includable snippet files.
-    if [[ ${x:0:1} != _ && ${x:(-4)} == .txt ]]
-    then
-      HTML_TARGETS+=("${x%%.txt}.html")
-      if [[ ! "$NOMAN" ]]
-      then
-        if [[ ${x:0:3} == git ]]
-        then
-          MAN1_TARGETS+=("${x%%.txt}.1")
-        else
-          MAN7_TARGETS+=("${x%%.txt}.7")
-        fi
-      fi
-      JOBS=$[$JOBS + 2]
-    fi
-  fi
-done
-
-if [[ ${#HTML_TARGETS} == 0 && ${#MAN1_TARGETS} == 0 && ${#MAN7_TARGETS} == 0 ]]
-then
-  exit
-fi
-
-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"$JOBS" "${MAN1_TARGETS[@]}" "${MAN7_TARGETS[@]}" "${HTML_TARGETS[@]}"
-)
-
-for x in "${HTML_TARGETS[@]}"
-do
-  echo Copying ../html/$x
-  tr -d '\015' <"git/Documentation/$x"  >"../html/$x"
-done
-
-for x in "${MAN1_TARGETS[@]}"
-do
-  echo Copying ../man1/$x
-  cp "git/Documentation/$x" ../man1
-done
-
-for x in "${MAN7_TARGETS[@]}"
-do
-  echo Copying ../man7/$x
-  cp "git/Documentation/$x" ../man7
-done