libv8 8.4.255.0

data/vendor/depot_tools/man/man1/git-new-branch.1

@@ -0,0 +1,176 @@
+'\" t
+.\"     Title: git-new-branch
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
+.\"      Date: 05/03/2019
+.\"    Manual: Chromium depot_tools Manual
+.\"    Source: depot_tools e58cce6c
+.\"  Language: English
+.\"
+.TH "GIT\-NEW\-BRANCH" "1" "05/03/2019" "depot_tools e58cce6c" "Chromium depot_tools Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+git-new-branch \- Create a new branch with correct tracking information\&.
+.SH "SYNOPSIS"
+.sp
+.nf
+\fIgit new\-branch\fR <branch_name>
+\fIgit new\-branch\fR \-\-upstream_current <branch_name>
+\fIgit new\-branch\fR \-\-upstream <REF> <branch_name>
+\fIgit new\-branch\fR \-\-lkgr <branch_name>
+.fi
+.sp
+.SH "DESCRIPTION"
+.sp
+Creates a new branch\&. By default the new branch will track the configured upstream for the repo (defaults to \fIorigin/master\fR)\&. If one of the other options is specified, it will track that other ref instead\&.
+.sp
+Conceptually, each branch in your repo represents one \fIChange List (CL)\fR\&. If you have many independent CLs (i\&.e\&. the changes in one do not interact with/depend on the changes in another), then you should create them as new branches tracking the default upstream (i\&.e\&. git new\-branch <branch_name>)\&. If you have features which depend on each other, you should create stacked branches using git new\-branch \-\-upstream_current <branch_name>\&.
+.SH "OPTIONS"
+.PP
+\-\-upstream_current
+.RS 4
+Set the tracking (upstream) branch to the currently\-checked\-out branch\&.
+.RE
+.PP
+\-\-upstream <REF>
+.RS 4
+Set the tracking (upstream) branch to <REF>\&. <REF> may be a local branch, remote branch, or a tag\&.
+.RE
+.PP
+\-\-lkgr
+.RS 4
+Alias for
+\-\-upstream lkgr\&.
+.RE
+.PP
+<branch_name>
+.RS 4
+The name for the new branch\&.
+.RE
+.SH "CONFIGURATION VARIABLES"
+.SS "depot\-tools\&.upstream"
+.sp
+This configures the default \fIupstream\fR for all new branches\&. If it is unset, it defaults to \fIorigin/master\fR\&. This is considered to be the \fIroot\fR branch\&.
+.SH "EXAMPLE"
+.sp
+
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+\fB$ git map\-branches \-v\fR
+origin/master
+  cool_feature         [ ahead 4            ]
+    subfeature         [ ahead 2 | behind 1 ]
+  fixit                [ ahead 2            ]
+\fB    frozen_branch *    [ ahead 3            ]
+$ git new\-branch independent_cl\fR
+\fB$ git map\-branches \-v\fR
+\fBorigin/master
+\fR  cool_feature        [ ahead 4            ]
+    subfeature        [ ahead 2 | behind 1 ]
+  fixit               [ ahead 2            ]
+    frozen_branch     [ ahead 3            ]
+\fB  independent_cl *
+$ vi foo && git add \-A && git commit \-m foo\fR
+\fB$ git map\-branches \-v\fR
+origin/master
+  cool_feature        [ ahead 4            ]
+    subfeature        [ ahead 2 | behind 1 ]
+  fixit               [ ahead 2            ]
+    frozen_branch     [ ahead 3            ]
+\fB  independent_cl *    [ ahead 1            ]
+$ git new\-branch \-\-upstream subfeature nested_cl\fR
+\fB$ git map\-branches \-v\fR
+origin/master
+  cool_feature       [ ahead 4            ]
+\fB    subfeature       [ ahead 2 | behind 1 ]  \fR\fB\fB(1)\fR\fR\fB
+      nested_cl *
+\fR  fixit              [ ahead 2            ]
+    frozen_branch    [ ahead 3            ]
+  independent_cl     [ ahead 1            ]
+\fB$ git checkout cool_feature\fR
+Switched to branch \*(Aqcool_feature\*(Aq
+Your branch is ahead of \*(Aqorigin/master\*(Aq by 4 commits\&.
+  (use "git push" to publish your local commits)
+\fB$ git new\-branch \-\-upstream_current cl_depends_on_cool_feature\fR
+\fB$ git map\-branches \-v\fR
+origin/master
+\fB  cool_feature                      [ ahead 4            ]
+    cl_depends_on_cool_feature *
+\fR    subfeature                      [ ahead 2 | behind 1 ]
+      nested_cl
+  fixit                             [ ahead 2            ]
+    frozen_branch                   [ ahead 3            ]
+  independent_cl                    [ ahead 1            ]
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 1.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  1." 4.2
+.\}
+Note that both branches are cyan because they are currently the same
+\fIcommit\fR
+object\&. See
+\fBgit-map-branches\fR(1)
+for more detail\&.
+.RE
+.SH "SUGGESTED ALIASES"
+.sp
+Some common short\-hand aliases\&. Feel free to add these to your \fI~/\&.gitconfig\fR file\&.
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+[alias]
+  git nb = new\-branch
+  git tb = new\-branch \-\-upstream_current  \fB(1)\fR
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+.sp
+\fB1. \fRmnemonic: tb \(-> "track branch"
+.br
+.SH "SEE ALSO"
+.sp
+\fBgit-rebase-update\fR(1), \fBgit-reparent-branch\fR(1), \fBgit-rename-branch\fR(1), \fBgit-upstream-diff\fR(1)
+.SH "CHROMIUM DEPOT_TOOLS"
+.sp
+Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assist with the development of chromium and related projects\&. Download the tools from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
+.SH "NOTES"
+.IP " 1." 4
+here
+.RS 4
+\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
+.RE

data/vendor/depot_tools/man/man1/git-rebase-update.1

@@ -0,0 +1,177 @@
+'\" t
+.\"     Title: git-rebase-update
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
+.\"      Date: 05/03/2019
+.\"    Manual: Chromium depot_tools Manual
+.\"    Source: depot_tools e58cce6c
+.\"  Language: English
+.\"
+.TH "GIT\-REBASE\-UPDATE" "1" "05/03/2019" "depot_tools e58cce6c" "Chromium depot_tools Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+git-rebase-update \- Updates all branches to have the latest changes from their upstreams\&.
+.SH "SYNOPSIS"
+.sp
+.nf
+\fIgit rebase\-update\fR [\-v | \-\-verbose] [\-n | \-\-no\-fetch] [\-k | \-\-keep\-going]
+.fi
+.sp
+.SH "DESCRIPTION"
+.sp
+Brings all branches up\-to\-date with their tracking branches\&. This involves several phases:
+.PP
+Preparation
+.RS 4
+If you currently have a branch checked out, any changes on that branch are
+\fIfrozen\fR
+(See
+\fBgit-freeze\fR(1)
+for more detail)\&. Additionally, the current branch is recorded for the
+\fIRestoration\fR
+phase later (see
+\fICONFIGURATION VARIABLES\fR
+for details on
+depot\-tools\&.rebase\-update\&.starting\-branch)\&.
+.RE
+.PP
+Fetching
+.RS 4
+All branches are examined to find their upstream references\&. The correct set of git remotes is determined, and fetched accordingly\&. Note that if any branches have a tag as their upstream, we are forced to pull all remotes\&.
+.sp
+Pass
+\-\-no\-fetch
+to skip this phase\&.
+.RE
+.PP
+Rebasing
+.RS 4
+All branches are rebased in topological order from roots (upstreams) to leaves\&. Each branch is rebased from its marked merge\-base (see
+\fICONFIGURATION VARIABLES\fR) to the branch tip on top of its parent branch\&. If the parent branch is
+\fIfrozen\fR
+(see
+\fBgit-freeze\fR(1)), the branch will be rebased onto the last non\-freeze commit on the parent branch\&.
+.sp
+Things get interesting when there are merge conflicts on rebase\&. The
+\fBmost common\fR
+cause for conflicts is when your branch has been committed to the upstream in squashed form, ala
+\fBgit-squash-branch\fR(1), which is what
+\fBgit-cl\fR(1)
+and the
+\fICommit Queue\fR
+will do\&. Because of that,
+git rebase\-update
+will attempt to squash your conflicted branch to see if the squashed version applies cleanly to its upstream\&.
+.sp
+If it does not apply cleanly, then your original (non\-squashed) branch will be left in mid\-rebase and
+git rebase\-update
+will exit\&. You can deal with this like any other conflicted rebase\&. When you\(cqre done, just
+git rebase\-update
+again to pick up where you left off\&.
+.RE
+.sp
+If you\(cqd like to rebase all rebaseable branches in one pass and manually process the unrebaseable ones later, use \-k or \-\-keep\-going\&. Cleanup will not happen until all branches apply cleanly\&.
+.PP
+Cleanup
+.RS 4
+Once all the branches have been rebased, any empty branches (i\&.e\&. branches with no commits on them) are removed\&. If a branch is removed in this fashion, any branches which depend on it are reparented to the parent of the removed branch (see
+\fBgit-reparent-branch\fR(1))\&.
+.RE
+.PP
+Restoration
+.RS 4
+git rebase\-update
+checks out the branch that you started on, and
+\fIthaws\fR
+it, if necessary (see
+\fBgit-thaw\fR(1))\&. If the branch you started on got cleaned up,
+git rebase\-update
+will checkout the
+\fIroot\fR
+ref (defaults to
+\fIorigin/master\fR, as configured by
+depot\-tools\&.upstream, see
+\fBgit-new-branch\fR(1))\&.
+.RE
+.SH "OPTIONS"
+.PP
+\-k, \-\-keep\-going
+.RS 4
+Keep processing past failed rebases\&.
+.RE
+.PP
+\-n, \-\-no\-fetch
+.RS 4
+Skip the
+git fetch
+phase of rebase\-update\&.
+.RE
+.PP
+\-v, \-\-verbose
+.RS 4
+More text than your terminal can handle\&.
+.RE
+.PP
+\-\-current
+.RS 4
+Only rebase the current branch\&.
+.RE
+.SH "CONFIGURATION VARIABLES"
+.SS "depot\-tools\&.rebase\-update\&.starting\-branch"
+.sp
+When git rebase\-update first runs, it will record the current branch here so that when it completes successfully, it will return back to the same branch you started on, even if git rebase\-update is interrupted due to rebase conflicts\&. When git rebase\-update completes successfully, this configuration variable is removed\&.
+.SS "branch\&.<name>\&.dormant"
+.sp
+If true, will cause rebase\-update to skip all processing on the branch\&. Useful for old/high\-conflict branches which you want to keep for posterity, but don\(cqt want to deal with when running git rebase\-update
+.SS "branch\&.<name>\&.base"
+.sp
+Holds the \fIbase\fR reference for this branch\&. By default this is equivalent to git merge\-base <name> <name>@{upstream}\&. However, it can diverge if <name>@{upstream} is manually rebased\&. In this case, it correctly preserves the value it had before, where git merge\-base would now report the wrong value\&.
+.sp
+All of the tools in the \fBdepot_tools\fR(1) suite collude to keep this value as up\-to\-date as possible, including \fBgit-reparent-branch\fR(1), and \fBgit-new-branch\fR(1)\&. \fBgit-map\fR(1) also shows the location of these marker values in \fBwhite\fR\&.
+.sp
+\fBgit-mark-merge-base\fR(1) allows easy manual interaction for this value, in the unlikely event that it gets out of sync\&.
+.SH "SUGGESTED ALIASES"
+.sp
+Some common short\-hand aliases\&. Feel free to add these to your \fI~/\&.gitconfig\fR file\&.
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+[alias]
+  git reup = rebase\-update
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+.SH "SEE ALSO"
+.sp
+\fBgit-new-branch\fR(1), \fBgit-reparent-branch\fR(1), \fBgit-rename-branch\fR(1), \fBgit-upstream-diff\fR(1), \fBgit-freeze\fR(1), \fBgit-mark-merge-base\fR(1)
+.SH "CHROMIUM DEPOT_TOOLS"
+.sp
+Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assist with the development of chromium and related projects\&. Download the tools from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
+.SH "NOTES"
+.IP " 1." 4
+here
+.RS 4
+\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
+.RE

data/vendor/depot_tools/man/man1/git-rename-branch.1

@@ -0,0 +1,53 @@
+'\" t
+.\"     Title: git-rename-branch
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
+.\"      Date: 05/03/2019
+.\"    Manual: Chromium depot_tools Manual
+.\"    Source: depot_tools e58cce6c
+.\"  Language: English
+.\"
+.TH "GIT\-RENAME\-BRANCH" "1" "05/03/2019" "depot_tools e58cce6c" "Chromium depot_tools Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+git-rename-branch \- Rename a branch and correctly preserve all downstream relationships\&.
+.SH "SYNOPSIS"
+.sp
+.nf
+\fIgit rename\-branch\fR <new_name>
+\fIgit rename\-branch\fR <old_name> <new_name>
+.fi
+.sp
+.SH "DESCRIPTION"
+.sp
+Rename the current (or specified) branch, then update all dowstream branches\*(Aq tracking information to preserve inter\-branch dependencies\&.
+.SH "SEE ALSO"
+.sp
+\fBgit-rebase-update\fR(1), \fBgit-reparent-branch\fR(1), \fBgit-new-branch\fR(1), \fBgit-upstream-diff\fR(1)
+.SH "CHROMIUM DEPOT_TOOLS"
+.sp
+Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assist with the development of chromium and related projects\&. Download the tools from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
+.SH "NOTES"
+.IP " 1." 4
+here
+.RS 4
+\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
+.RE

data/vendor/depot_tools/man/man1/git-reparent-branch.1

@@ -0,0 +1,93 @@
+'\" t
+.\"     Title: git-reparent-branch
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
+.\"      Date: 05/03/2019
+.\"    Manual: Chromium depot_tools Manual
+.\"    Source: depot_tools e58cce6c
+.\"  Language: English
+.\"
+.TH "GIT\-REPARENT\-BRANC" "1" "05/03/2019" "depot_tools e58cce6c" "Chromium depot_tools Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+git-reparent-branch \- Alter the parentage (upstream) for the current branch\&.
+.SH "SYNOPSIS"
+.sp
+.nf
+\fIgit reparent\-branch\fR <new_parent>
+\fIgit reparent\-branch\fR \-\-lkgr
+\fIgit reparent\-branch\fR \-\-root
+.fi
+.sp
+.SH "DESCRIPTION"
+.sp
+Change the \fIupstream\fR of the current branch, and then run \fBgit-rebase-update\fR(1) to move the commits in the current branch, as well as the commits in all descendant branches, onto the new parent\&.
+.sp
+<new_parent> may be either a local branch, remote branch, OR a tag (such as lkgr)\&.
+.sp
+This is particularly useful to reparent an independent CL to become dependent on another CL, or vice versa\&. This could happen if you started both on the assumption that they were independent, but later realized that this was not the case\&.
+.SH "OPTIONS"
+.PP
+<new_parent>
+.RS 4
+The new parent to set as the upstream for this branch\&. May be a branch ref or a tag\&.
+.RE
+.PP
+\-\-lkgr
+.RS 4
+Reparent to track lkgr\&.
+.RE
+.PP
+\-\-root
+.RS 4
+Reparent to track the
+\fIroot\fR
+branch\&. Defaults to
+\fIorigin/master\fR\&. See
+\fBgit-new-branch\fR(1)\*(Aqs CONFIGURATION VARIABLES section\&.\&.
+.RE
+.SH "SUGGESTED ALIASES"
+.sp
+Some common short\-hand aliases\&. Feel free to add these to your \fI~/\&.gitconfig\fR file\&.
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+[alias]
+  git rp = reparent\-branch
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+.SH "SEE ALSO"
+.sp
+\fBgit-rebase-update\fR(1), \fBgit-rename-branch\fR(1), \fBgit-new-branch\fR(1), \fBgit-upstream-diff\fR(1)
+.SH "CHROMIUM DEPOT_TOOLS"
+.sp
+Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assist with the development of chromium and related projects\&. Download the tools from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
+.SH "NOTES"
+.IP " 1." 4
+here
+.RS 4
+\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
+.RE