Skip to content

Commit e4e9e10

Browse files
committed
git bisect docs: formatting tweaks
1 parent 660b0d7 commit e4e9e10

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

llvm/docs/GitBisecting.rst

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -88,10 +88,13 @@ Here's how LLVM's history currently looks:
8888
8989
``A`` is the first commit in LLVM ever, ``97724f18c79c``.
9090

91-
``B`` is the first commit in MLIR, ``aed0d21a62db``. ``D`` is the merge commit
92-
that merged MLIR into the main LLVM repository, ``0f0d0ed1c78f``. ``C`` is the
93-
last commit in MLIR before it got merged, ``0f0d0ed1c78f^2``. (The ``^n``
94-
modifier selects the n'th parent of a merge commit.)
91+
``B`` is the first commit in MLIR, ``aed0d21a62db``.
92+
93+
``D`` is the merge commit that merged MLIR into the main LLVM repository,
94+
``0f0d0ed1c78f``.
95+
96+
``C`` is the last commit in MLIR before it got merged, ``0f0d0ed1c78f^2``. (The
97+
``^n`` modifier selects the n'th parent of a merge commit.)
9598

9699
``git bisect`` goes through all parent revisions. Due to the way MLIR was
97100
merged, at every revision at ``C`` or earlier, *only* the ``mlir/`` directory
@@ -103,8 +106,12 @@ follow the first parent of ``D``.
103106

104107
The best workaround is to pass a list of directories to ``git bisect``:
105108
If you know the bug is due to a change in llvm, clang, or compiler-rt, use
106-
``git bisect start -- clang llvm compiler-rt``. That way, the commits in
107-
``mlir`` are never evaluated.
109+
110+
.. code-block:: bash
111+
112+
git bisect start -- clang llvm compiler-rt
113+
114+
That way, the commits in ``mlir`` are never evaluated.
108115

109116
Alternatively, ``git bisect skip aed0d21a6 aed0d21a6..0f0d0ed1c78f`` explicitly
110117
skips all commits on that branch. It takes 1.5 minutes to run on a fast

0 commit comments

Comments
 (0)