libv8 8.4.255.0

data/vendor/depot_tools/man/src/git-retry.txt

@@ -0,0 +1,67 @@
+git-retry(1)
+=============
+
+NAME
+----
+git-retry -
+include::_git-retry_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git retry' [-v] [-c COUNT] [-d DELAY] [-D DELAY_FACTOR] -- _<git_subcommand>_
+
+DESCRIPTION
+-----------
+
+`git retry` is a bootstrap that wraps a standard `git` command execution in
+a fault-tolerant retry wrapper.
+
+If a retry succeeds, the return code of the successful attempt is returned.
+Otherwise, the return code of the last failed attempt is returned.
+
+The wrapper is aware of `git`-specific failure conditions and will only consider
+retrying if a given failure can be linked to such a condition.
+
+
+OPTIONS
+-------
+
+<git_subcommand>::
+  The `git` command to retry. This should omit the actual `git` command (e.g.,
+  to retry `git clone`, use `git retry clone`).
+
+-v, --verbose::
+  Increases logging verbosity. By default, no additional logging is generated
+  by the `git retry` command. This can be specified multiple times.
+
+-c, --retry-count _count_::
+  Specify the number of retries that should be performed before giving up. The
+  default retry count is *5*.
+
+-d, --delay _seconds_::
+  Floating-point value that specifies the amount of time (in seconds) to wait
+  after a failure. This can be zero to specify no delay. The default delay is
+  *3 seconds*.
+
+-D, --delay-factor::
+  The exponential factor to apply to the delay. By default this is *2*.
+  For a given retry round *n*, the delay for that round will be
+  *(<delay-factor>^(n-1) * delay)*. If no delay is specified, this will have
+  no effect.
+  If the delay factor is *0*, the delay will increase linearly (for a given
+  retry round *n*, the delay will be *(n * delay)*).
+
+    (Note that a delay factor of *1* will result in a constant delay.)
+
+
+EXIT STATUS
+-----------
+
+Upon success, `git retry` will exit with the successful exit code of *0*. On
+failure, it will exit with the exit code of the last failed attempt.
+
+
+include::_footer.txt[]
+
+// vim: ft=asciidoc:

data/vendor/depot_tools/man/src/git-squash-branch.demo.1.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+. demo_repo.sh
+
+run git map
+echo
+
+# since these are all empty commits, pretend there's something there
+pcommand git squash-branch -m "cool squash demo"
+git squash-branch -m "cool squash demo" > /dev/null 2> /dev/null
+c "cool squash demo"
+
+run git map

data/vendor/depot_tools/man/src/git-squash-branch.txt

@@ -0,0 +1,59 @@
+git-squash-branch(1)
+====================
+
+NAME
+----
+git-squash-branch -
+include::_git-squash-branch_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git squash-branch' [-m <message>]
+
+DESCRIPTION
+-----------
+
+`git squash-branch` is a simple helper command. It takes all the commits on the
+current branch from the 'merge_base' to HEAD, and reduces them to a single
+commit. The new commit will contain a summary of all the commits which were
+squashed, preceded by a header message indicating that it's the result of a
+squash (or the message you pass on the command line.).
+
+Squashing branches is useful when trying to rebase-update over branches which
+were pushed to their upsteram (or committed by the 'Commit Queue'), and then
+conflicting changes landed in upstream on top of the push/commit. If you know
+that your branch was committed but linkgit:git-rebase-update[1] isn't able to
+automatically clean it, you can squash the troublesome branch before `git
+rebase-update`, and then when `git rebase-update` presents the conflict, you can
+verify that the conflict diff is what you expected (and then skip it with
+`git rebase --skip`).
+
+OPTIONS
+-------
+
+-m <message>::
+--message=<message>::
+  Optional message to use for the first line of the squashed commit. If omitted,
+  it defaults to "git squash commit for <branch>.".
+
+EXAMPLE
+-------
+demo:1[]
+
+
+include::_aliases.txt[]
+
+----
+[alias]
+  git squash = squash-branch
+----
+
+
+SEE ALSO
+--------
+linkgit:git-rebase-update[1]
+
+include::_footer.txt[]
+
+// vim: ft=asciidoc:

data/vendor/depot_tools/man/src/git-thaw.txt

@@ -0,0 +1,29 @@
+git-thaw(1)
+=============
+
+NAME
+----
+git-thaw -
+include::_git-thaw_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git thaw'
+
+DESCRIPTION
+-----------
+
+`git thaw` takes a frozen branch (as made by linkgit:git-freeze[1]), and returns
+it to the status that it was in before it was frozen.
+
+If you freeze a branch multiple times (i.e. change files, freeze, change files,
+freeze), `git thaw` will thaw all of the freezes.
+
+SEE ALSO
+--------
+linkgit:git-freeze[1]
+
+include::_footer.txt[]
+
+// vim: ft=asciidoc:

data/vendor/depot_tools/man/src/git-upstream-diff.txt

@@ -0,0 +1,107 @@
+git-upstream-diff(1)
+====================
+
+NAME
+----
+git-upstream-diff -
+include::_git-upstream-diff_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git upstream-diff' [--wordwise] [--branch branch] [<extra args for git-diff>*]
+
+DESCRIPTION
+-----------
+
+Shows a diff between a branch and its upstream. If the --branch option is
+omitted or "HEAD", the tool shows the diff for the current branch. Any
+additional arguments are passed through to the underlying git-diff command. This
+is 'roughly' the same as:
+
+----
+git diff --patience -C -C branch@{upstream}  <1> <2>
+----
+<1> `-C -C` detects file copies/renames
+<2> `--patience` uses the patience-diff algorithm, which tends to produce nicer
+  diffs in many cases.
+
+The difference is that `branch@{upstream}` is actually the tagged merge base of
+your branch (See linkgit:git-rebase-update[1]). This means that if your upstream
+branch was rebased, but you haven't yet rebased the current branch on top of it,
+you'll still see an accurate diff compared to just diffing against
+`@{upstream}`.
+
+The `--wordwise` option also allows `git-diff` to do word-by-word comparison
+in a semi-intelligent way. However, sometimes it can produce surprising results,
+so it is disabled by default.
+
+Since any additional options are passed through to git-diff unchanged, you can
+use this as a general replacement for `git diff` for things like:
+
+----
+$ # See what changed in a file on the current branch
+$ git upstream-diff some/file.py
+...
+
+$ # Omit deleted files from the diff
+$ git upstream-diff --diff-filter d
+...
+
+$ # etc.
+----
+
+
+OPTIONS
+-------
+
+--wordwise::
+  Print a colorized word-wise diff instead of a line-wise diff.
+
+--branch branch::
+  Show a diff between the specified branch and its upstream, instead of using
+  the current branch.
+
+<extra args for git-diff>::
+  Extra arguments are included in the invocation of linkgit:git-diff[1]. These
+  can be anything that `git-diff` normally takes.
++
+--
+`--stat`;;
+  This is particularly useful to show 'which' files have been changed in
+  comparison to the upstream branch.
+`--staged`;;
+  Diff against the staged (cached) changes, instead of against the working
+  directory. This is 'substantially' faster on large repos, but doesn't take
+  into account unstaged changes (i.e. changes in your working copy which you
+  haven't staged with `git add`).
+`-- <filename patterns>*`;;
+  Restrict the diff to only show the diff for given files compared to the
+  upstream.
+--
+
+
+CONFIGURATION VARIABLES
+-----------------------
+
+depot-tools.upstream-diff.default-args
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A list-configuration variable. Each instance of this config variable will be
+prepended to all invocations of `git upstream-diff`, as if you had passed them
+on the command line.
+
+include::_aliases.txt[]
+
+----
+[alias]
+  git udiff = upstream-diff
+----
+
+SEE ALSO
+--------
+linkgit:git-rebase-update[1]
+
+include::_footer.txt[]
+
+// vim: ft=asciidoc:

data/vendor/depot_tools/man/src/make_docs.sh

@@ -0,0 +1,260 @@
+#!/usr/bin/env bash
+
+set -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
+ensure_in_path git
+
+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=2ff8681
+if [[ ! -d asciidoc || $(cd asciidoc && git rev-parse --short HEAD) != $ASCIIDOC_HASH ]]
+then
+  echo Cloning asciidoc
+  rm -rf asciidoc
+  git clone --branch $BRANCH https://github.com/asciidoc/asciidoc 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
+/XMLTO_EXTRA
+a
+ --skip-validation
+.
+-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