libv8 8.4.255.0

data/vendor/depot_tools/man/src/filter_demo_output.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python
+# Copyright 2014 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+from __future__ import print_function
+
+import collections
+import os
+import re
+import sys
+
+from xml.sax.saxutils import escape
+
+from cStringIO import StringIO
+
+if not os.path.exists('ansi2html'):
+  print('You must run ./make_docs.sh once before running this script.')
+  sys.exit(1)
+
+# This dependency is pulled in by make_docs.sh
+# if it doesn't exist, run ./make_docs.sh first
+sys.path.insert(0, 'ansi2html')
+
+import ansi2html            # pylint: disable=import-error, W0611
+import ansi2html.converter  # pylint: disable=import-error, W0611
+
+def simpleXML(string):
+  BRIGHT = 1
+  DIM    = 2
+  NORMAL = 22
+  RESET  = 0
+  ESC_RE = re.compile('(\x1B\\[[^m]*?)m')
+
+  ret = StringIO()
+  boldstate = False
+
+  for tok in ESC_RE.split(string):
+    if not tok:
+      continue
+    if tok[0] == '\x1b':
+      codes = map(int, filter(bool, tok[2:].split(';')))
+      if not codes:
+        codes = [RESET]
+      for code in codes:
+        # only care about Bright
+        if code == BRIGHT and boldstate is False:
+          boldstate = True
+          ret.write('<emphasis role="strong">')
+        elif code in (DIM, NORMAL, RESET) and boldstate:
+          boldstate = False
+          ret.write('</emphasis>')
+    else:
+      ret.write(escape(tok))
+
+  if boldstate:
+    ret.write('</emphasis>')
+
+  return ret.getvalue()
+
+
+def main():
+  ansi2html.converter.SCHEME['custom'] = (
+      "#000000", "#e42e16", "#19c518", "#e7e71c", "#492ee1",
+      "#d338d3", "#33d6e5", "#ffffff",
+  )
+
+  backend = sys.argv[1]
+  output = sys.stdin.read().rstrip()
+
+  callout_re = re.compile(r'\x1b\[(\d+)c\n')
+  callouts = collections.defaultdict(int)
+  for i, line in enumerate(output.splitlines(True)):
+    m = callout_re.match(line)
+    if m:
+      callouts[i + int(m.group(1)) - len(callouts)] += 1
+
+  output = callout_re.sub('', output)
+
+  w = sys.stdout.write
+
+  comment_marker = '###COMMENT###'
+
+  callout_counter = 1
+  if backend == 'xhtml11':
+    preamble = (
+        '</p></div><div class="listingblock"><div class="content"><pre><code>'
+    )
+    postamble = '</code></pre></div></div><p><div class="paragraph">'
+    c = ansi2html.Ansi2HTMLConverter(inline=True, scheme='custom')
+
+    in_code = False
+    body = c.convert(output, full=False)
+    for i, line in enumerate(body.splitlines()):
+      if line.startswith(comment_marker):
+        if in_code:
+          w(postamble)
+          in_code = False
+        w(line[len(comment_marker):])
+      else:
+        if not in_code:
+          w(preamble)
+          in_code = True
+        ext = ''
+        for _ in xrange(callouts[i]):
+          if not ext:
+            ext += '</span>'
+          ext += ' <b>&lt;%d&gt;</b>' % callout_counter
+          callout_counter += 1
+        if ext:
+          ext += '<span>'
+        w(line + ext + '\n')
+    if in_code:
+      w(postamble)
+  else:
+    preamble = '</simpara><literallayout class="monospaced">'
+    postamble = '</literallayout><simpara>'
+
+    in_code = False
+    body = simpleXML(output)
+    for i, line in enumerate(body.splitlines()):
+      if line.startswith(comment_marker):
+        if in_code:
+          w(postamble)
+          in_code = False
+        w(line[len(comment_marker):])
+      else:
+        if not in_code:
+          w(preamble)
+          in_code = True
+        ext = ''
+        for _ in xrange(callouts[i]):
+          ext += '  <emphasis role="strong">(%d)</emphasis>' % callout_counter
+          callout_counter += 1
+        w(line + ext + '\n')
+    if in_code:
+      w(postamble)
+
+
+if __name__ == '__main__':
+  main()

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

@@ -0,0 +1,119 @@
+git-cl(1)
+=========
+
+NAME
+----
+git-cl -
+include::_git-cl_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git cl <subcommand> [options]'
+
+DESCRIPTION
+-----------
+
+`git cl` is the home of all of the tools for interacting with changelists.
+
+Run `git cl help <subcommand>` for a more detailed listing of that command
+and its options.
+
+SUBCOMMANDS
+-----------
+
+archive::
+  archives and deletes branches associated with closed changelists
+
+baseurl::
+  gets or sets base-url for this branch
+
+checkout::
+  checks out a branch associated with a given Rietveld or Gerrit issue
+
+comments::
+  shows or posts review comments for any changelist
+
+config::
+  edits configuration for this tree
+
+dcommit::
+  DEPRECATED: Used to commit the current changelist via git-svn
+
+description::
+  brings up the editor for the current CL's description
+
+diff::
+  shows differences between local tree and last upload
+
+format::
+  runs auto-formatting tools (clang-format etc.) on the diff
+
+help::
+  prints list of commands or help for a specific command
+
+issue::
+  sets or displays the current code review issue number
+
+land::
+  commits the current changelist via git
+
+lint::
+  runs cpplint on the current changelist
+
+owners::
+  interactively find the owners for reviewing
+
+patch::
+  patches in a code review
+
+presubmit::
+  runs presubmit tests on the current changelist
+
+set-close::
+  closes the issue
+
+set-commit::
+  sets the commit bit to trigger the Commit Queue
+
+split::
+  splits a branch into smaller branches and uploads CLs
+
+status::
+  show status of changelists
+
+tree::
+  shows the status of the tree
+
+try::
+  triggers try jobs using either BuildBucket or CQ dry run
+
+try-results::
+  prints info about try jobs associated with current CL
+
+upload::
+  uploads the current changelist to codereview
+
+upstream::
+  prints or sets the name of the upstream branch, if any
+
+web::
+  opens the current CL in the web browser
+
+
+OPTIONS
+-------
+
+--version::
+  show program's version number and exit
+
+-h, --help::
+  show this help message and exit
+
+-v, --verbose::
+  Use 2 times for more debugging info
+
+
+include::_footer.txt[]
+
+// vim: ft:asciidoc:

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

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+. git-drover.demo.common.sh
+
+drover_c "This change needs to go to branch 9999"
+
+echo "# Here's a commit (from some.committer) that we want to 'drover'."
+run git log -n 1 --pretty=fuller
+echo
+echo "# Now do the 'drover'."
+pcommand git drover --branch 9999 \
+  --cherry-pick $(git show-ref -s pick_commit)
+
+echo "Going to cherry-pick"
+echo '"""'
+output git log -n 1
+echo '"""'
+echo "to 9999. Continue (y/n)? y"
+echo
+echo "# A cl is uploaded to rietveld, where it can be reviewed before landing."
+echo
+echo "About to land on 9999. Continue (y/n)? y"
+echo "# The cherry-pick cl is landed on the branch 9999."

data/vendor/depot_tools/man/src/git-drover.demo.2.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+. git-drover.demo.common.sh
+
+echo "# Make sure we have the most up-to-date branch sources."
+run git fetch
+echo
+echo "# Checkout the branch with the change we want to revert."
+run git checkout -b drover_9999 branch-heads/9999
+echo
+drover_c "This change is horribly broken."
+echo "# Here's the commit we want to revert."
+run git log -n 1
+echo
+echo "# Now do the revert."
+silent git revert --no-edit $(git show-ref -s pick_commit)
+pcommand git revert $(git show-ref -s pick_commit)
+echo
+echo "# That reverted the change and committed the revert."
+run git log -n 1
+echo
+echo "# As with old drover, reverts are generally OK to commit without LGTM."
+pcommand git cl upload -r some.committer@chromium.org --send-mail
+run git cl land --bypass-hooks

data/vendor/depot_tools/man/src/git-drover.demo.3.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+. git-drover.demo.common.sh
+
+drover_c "This change needs to go to branch 9999"
+
+echo "# Make sure we have the most up-to-date branch sources."
+run git fetch
+echo
+echo "# Here's a commit (from some.committer) that we want to 'drover'."
+run git log -n 1 --pretty=fuller
+echo
+echo "# Checkout the branch we want to 'drover' to."
+run git checkout -b drover_9999 branch-heads/9999
+echo
+echo "# Now do the 'drover'."
+echo "# IMPORTANT!!! Do Not leave off the '-x' flag"
+run git cherry-pick -x $(git show-ref -s pick_commit)
+echo
+echo "# That took the code authored by some.committer and committed it to"
+echo "# the branch by the person who drovered it (i.e. you)."
+run git log -n 1 --pretty=fuller
+echo
+echo "# Looks good. Ship it!"
+pcommand git cl upload
+echo "# Wait for LGTM or TBR it."
+run git cl land
+echo "# Or skip the LGTM/TBR and just 'git cl land --bypass-hooks'"

data/vendor/depot_tools/man/src/git-drover.demo.4.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+. git-drover.demo.common.sh
+
+drover_c "This change needs to go to branch 9999"
+
+echo "# Here's a commit (from some.committer) that we want to 'drover'."
+run git log -n 1 --pretty=fuller
+echo
+echo "# Now do the 'drover'."
+pcommand git drover --branch 9999 \
+  --cherry-pick $(git show-ref -s pick_commit)
+
+echo "Going to cherry-pick"
+echo '"""'
+output git log -n 1
+echo '"""'
+echo "to 9999. Continue (y/n)? y"
+echo
+echo "Error: Patch failed to apply."
+echo
+echo "A workdir for this cherry-pick has been created in"
+echo "  /tmp/drover_9999"
+echo
+echo "To continue, resolve the conflicts there and run"
+echo "  git drover --continue /tmp/drover_9999"
+echo
+echo "To abort this cherry-pick run"
+echo "  git drover --abort /tmp/drover_9999"
+echo
+pcommand pushd /tmp/drover_9999
+echo "# Manually resolve conflicts."
+pcommand git add path/to/file_with_conflicts
+pcommand popd
+pcommand git drover --continue /tmp/drover_9999
+echo
+echo "# A cl is uploaded to rietveld, where it can be reviewed before landing."
+echo
+echo "About to land on 9999. Continue (y/n)? y"
+echo "# The cherry-pick cl is landed on the branch 9999."

data/vendor/depot_tools/man/src/git-drover.demo.common.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+. demo_repo.sh
+
+# Add and tag a dummy commit to refer to later.
+drover_c() {
+  add modified_file
+  set_user some.committer
+  c "$1"
+  silent git tag -f pick_commit
+  set_user you
+  tick 1000
+}
+
+silent git push origin refs/remotes/origin/master:refs/branch-heads/9999
+silent git config --add remote.origin.fetch \
+  +refs/branch-heads/*:refs/remotes/branch-heads/*
+silent git fetch origin
+
+silent git checkout -B master origin/master

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

@@ -0,0 +1,102 @@
+git-drover(1)
+=============
+
+NAME
+----
+git-drover -
+include::_git-drover_desc.helper.txt[]
+
+SYNOPSIS
+--------
+[verse]
+'git drover' --branch <branch>
+           (--cherry-pick <change> | --continue [path_to_workdir] |
+            --abort [path_to_workdir])
+           [--parent_checkout <path-to-existing-checkout>]
+           [--verbose] [--dry-run]
+
+DESCRIPTION
+-----------
+
+`git drover` applies a commit to a release branch. It creates a new workdir from
+an existing checkout to avoid downloading a new checkout without affecting the
+existing checkout.
+
+`git drover` does not support reverts. See the EXAMPLE section for the
+equivalent sequence of commands to run.
+
+OPTIONS
+-------
+--branch <branch>::
+  The branch to cherry-pick the commit to.
+
+--cherry-pick <commit>::
+  The commit to cherry-pick.
+
+--continue [path_to_workdir]::
+  Continue a cherry-pick that required manual resolution. The path to the drover
+  workdir is optional. If unspecified, the current directory is used.
+
+--abort [path_to_workdir]::
+  Abort a cherry-pick that required manual resolution and clean up its workdir.
+  The path to the drover workdir is optional. If unspecified, the current
+  directory is used.
+
+--parent_checkout::
+  The path to the chromium checkout to use as the source for a creating
+  git-new-workdir workdir to use for cherry-picking. If unspecified, the current
+  directory is used.
+
+-v::
+--verbose::
+  Enable verbose logging.
+
+--dry-run::
+  Skip landing the cherry-pick. Just ensure that the commit can be cherry-picked
+  into the branch.
+
+EXAMPLE
+-------
+
+PREREQUISITES
+~~~~~~~~~~~~~
+Before working with branches, you must
+ifdef::backend-xhtml11[]
+`gclient sync --with_branch_heads`
+endif::backend-xhtml11[]
+ifdef::backend-docbook[]
+'gclient sync --with_branch_heads'
+endif::backend-docbook[]
+at least once to fetch the branches.
+
+Merge Example
+^^^^^^^^^^^^^
+demo:1[]
+
+Merge with Conflicts Example
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+demo:4[]
+
+Revert Example
+^^^^^^^^^^^^^^
+demo:2[]
+
+If your cherrypick onto a release branch gets reverted, do not create a new
+cherrypick from master onto that release branch. Instead, use the "Reland"
+button on the original cherrypick CL.
+
+Manual Merge Example
+^^^^^^^^^^^^^^^^^^^^
+demo:3[]
+
+If `git cl upload` errors out, the branch you're uploading to probably has a CL
+with the same Change-Id. Instead of cherry-picking manually, use the Reland
+button in the Gerrit UI to create a new CL, and patch that CL into your client.
+
+SEE ALSO
+--------
+linkgit:git-cherry-pick[1], linkgit:git-revert[1]
+
+include::_footer.txt[]
+
+// vim: ft=asciidoc: