Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(253)

Unified Diff: docs/src/make_docs.sh

Issue 259863004: Move docs folder to man. (Closed) Base URL: https://chromium.googlesource.com/chromium/tools/depot_tools.git@master
Patch Set: Created 6 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « docs/src/git-upstream-diff.txt ('k') | docs/src/prep_demo_repo.sh » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
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
« no previous file with comments | « docs/src/git-upstream-diff.txt ('k') | docs/src/prep_demo_repo.sh » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698