Index: docs/src/make_docs.sh |
diff --git a/docs/src/make_docs.sh b/docs/src/make_docs.sh |
deleted file mode 100755 |
index d011a61229230fda628d4995a324e15982736dff..0000000000000000000000000000000000000000 |
--- a/docs/src/make_docs.sh |
+++ /dev/null |
@@ -1,250 +0,0 @@ |
-#!/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 |