Bug 1962537 - quickref docs: remove hg references r=tgiles DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D246666
This commit is contained in:
@@ -54,14 +54,11 @@ To Setup Firefox On Windows
|
|||||||
$ cd c:/
|
$ cd c:/
|
||||||
$ mkdir mozilla-source
|
$ mkdir mozilla-source
|
||||||
$ cd mozilla-source
|
$ cd mozilla-source
|
||||||
$ wget https://hg.mozilla.org/mozilla-central/raw-file/default/python/mozboot/bin/bootstrap.py
|
$ wget https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/main/python/mozboot/bin/bootstrap.py
|
||||||
|
|
||||||
# To use Git as your VCS
|
# To use Git as your VCS
|
||||||
$ python3 bootstrap.py --vcs=git
|
$ python3 bootstrap.py --vcs=git
|
||||||
|
|
||||||
# To use Mercurial as your VCS
|
|
||||||
$ python3 bootstrap.py
|
|
||||||
|
|
||||||
More information on :ref:`building Firefox for Windows <Building Firefox On Windows>`.
|
More information on :ref:`building Firefox for Windows <Building Firefox On Windows>`.
|
||||||
|
|
||||||
To Setup Firefox On macOS and Linux
|
To Setup Firefox On macOS and Linux
|
||||||
@@ -69,14 +66,11 @@ To Setup Firefox On macOS and Linux
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
$ curl -L https://hg.mozilla.org/mozilla-central/raw-file/default/python/mozboot/bin/bootstrap.py -O
|
$ curl -L https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/main/python/mozboot/bin/bootstrap.py -O
|
||||||
|
|
||||||
# To use Git as your VCS
|
# To use Git as your VCS
|
||||||
$ python3 bootstrap.py --vcs=git
|
$ python3 bootstrap.py --vcs=git
|
||||||
|
|
||||||
# To use Mercurial as your VCS
|
|
||||||
$ python3 bootstrap.py
|
|
||||||
|
|
||||||
More information on :ref:`building Firefox for Linux <Building Firefox On Linux>` and :ref:`building Firefox for MacOS <Building Firefox On MacOS>`.
|
More information on :ref:`building Firefox for Linux <Building Firefox On Linux>` and :ref:`building Firefox for MacOS <Building Firefox On MacOS>`.
|
||||||
|
|
||||||
To Setup Firefox for Android
|
To Setup Firefox for Android
|
||||||
@@ -84,14 +78,11 @@ To Setup Firefox for Android
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
$ curl -L https://hg.mozilla.org/mozilla-central/raw-file/default/python/mozboot/bin/bootstrap.py -O
|
$ curl -L https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/main/python/mozboot/bin/bootstrap.py -O
|
||||||
|
|
||||||
# To use Git as your VCS
|
# To use Git as your VCS
|
||||||
$ python3 bootstrap.py --vcs=git
|
$ python3 bootstrap.py --vcs=git
|
||||||
|
|
||||||
# To use Mercurial as your VCS
|
|
||||||
$ python3 bootstrap.py
|
|
||||||
|
|
||||||
More information on :ref:`building Firefox for Android <Firefox for Android>`
|
More information on :ref:`building Firefox for Android <Firefox for Android>`
|
||||||
|
|
||||||
To set up your editor
|
To set up your editor
|
||||||
@@ -163,14 +154,6 @@ After making your changes, visualize your changes to ensure you're including all
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# For files changed/added/removed
|
|
||||||
$ hg status
|
|
||||||
|
|
||||||
# For detailed line changes
|
|
||||||
$ hg diff
|
|
||||||
|
|
||||||
# Git
|
|
||||||
# For files changed/added/removed
|
# For files changed/added/removed
|
||||||
$ git status
|
$ git status
|
||||||
|
|
||||||
@@ -181,9 +164,6 @@ Then commit your changes:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
$ hg commit
|
|
||||||
|
|
||||||
# Git
|
# Git
|
||||||
$ git commit
|
$ git commit
|
||||||
|
|
||||||
@@ -204,8 +184,7 @@ For example, here is an example of a good commit message:
|
|||||||
during its own onclick handler. r=person"
|
during its own onclick handler. r=person"
|
||||||
|
|
||||||
To :ref:`find a reviewer or a review group <Getting reviews>`, the easiest way is to run
|
To :ref:`find a reviewer or a review group <Getting reviews>`, the easiest way is to run
|
||||||
``hg log <modified-file>`` (or ``git log <modified-file>``, if
|
`git log <modified-file>`` on the relevant files, and look who usually is
|
||||||
you're using git) on the relevant files, and look who usually is
|
|
||||||
reviewing the actual changes (ie not reformat, renaming of variables, etc).
|
reviewing the actual changes (ie not reformat, renaming of variables, etc).
|
||||||
|
|
||||||
|
|
||||||
@@ -213,16 +192,11 @@ To visualize your patch in the repository, run:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
$ hg wip
|
|
||||||
|
|
||||||
# Git
|
# Git
|
||||||
$ git show
|
$ git show
|
||||||
|
|
||||||
:ref:`More information on how to work with stack of patches <Working with stack of patches Quick Reference>`
|
:ref:`More information on how to work with stack of patches <Working with stack of patches Quick Reference>`
|
||||||
|
|
||||||
:ref:`More information on Mercurial <Mercurial Overview>`
|
|
||||||
|
|
||||||
To make sure the change follows the coding style
|
To make sure the change follows the coding style
|
||||||
------------------------------------------------
|
------------------------------------------------
|
||||||
|
|
||||||
@@ -327,8 +301,7 @@ If you're finished with a patch and would like to return to the tip to make a ne
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
$ hg pull central
|
$ git pull --rebase
|
||||||
$ hg up central
|
|
||||||
|
|
||||||
To update a submitted patch
|
To update a submitted patch
|
||||||
---------------------------
|
---------------------------
|
||||||
@@ -350,9 +323,6 @@ Make your changes in the working folder and run:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Or, if you need to pass arguments, e.g., changing the commit message:
|
|
||||||
$ hg commit --amend
|
|
||||||
|
|
||||||
# Git
|
# Git
|
||||||
$ git commit --amend
|
$ git commit --amend
|
||||||
|
|
||||||
@@ -360,7 +330,7 @@ After amending the patch, you will need to submit it using moz-phab again.
|
|||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
|
|
||||||
Don't use ``hg commit --amend -m`` or ``git commit --amend -m``.
|
Don't use ``git commit --amend -m``.
|
||||||
|
|
||||||
Phabricator tracks revision by editing the commit message when a
|
Phabricator tracks revision by editing the commit message when a
|
||||||
revision is created to add a special ``Differential Revision:
|
revision is created to add a special ``Differential Revision:
|
||||||
@@ -375,9 +345,6 @@ command:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
$ hg histedit
|
|
||||||
|
|
||||||
# Git
|
# Git
|
||||||
$ git rebase -i
|
$ git rebase -i
|
||||||
|
|
||||||
@@ -392,9 +359,6 @@ To pull changes from the repository, run:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
$ hg pull --rebase
|
|
||||||
|
|
||||||
# Git
|
# Git
|
||||||
$ git pull --rebase
|
$ git pull --rebase
|
||||||
|
|
||||||
@@ -431,5 +395,3 @@ More documentation about contribution
|
|||||||
https://mozilla-version-control-tools.readthedocs.io/en/latest/devguide/contributing.html
|
https://mozilla-version-control-tools.readthedocs.io/en/latest/devguide/contributing.html
|
||||||
|
|
||||||
https://moz-conduit.readthedocs.io/en/latest/phabricator-user.html
|
https://moz-conduit.readthedocs.io/en/latest/phabricator-user.html
|
||||||
|
|
||||||
https://mikeconley.github.io/documents/How_mconley_uses_Mercurial_for_Mozilla_code
|
|
||||||
|
|||||||
@@ -25,11 +25,8 @@ Visualize the stack
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
$ hg wip
|
|
||||||
|
|
||||||
# Git
|
|
||||||
$ git log
|
$ git log
|
||||||
|
$ git log --graph --oneline --all
|
||||||
|
|
||||||
|
|
||||||
Merge two patches
|
Merge two patches
|
||||||
@@ -40,12 +37,6 @@ created on Phabricator. For this, merge the patches locally:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# Mark the patch to be merged with "roll" (key: "r")
|
|
||||||
# or "fold" (key: "f")
|
|
||||||
$ hg histedit
|
|
||||||
|
|
||||||
# Git
|
|
||||||
# Replace "pick" by "squash" or "fixup"
|
# Replace "pick" by "squash" or "fixup"
|
||||||
$ git rebase -i
|
$ git rebase -i
|
||||||
|
|
||||||
@@ -71,13 +62,6 @@ Fortunately, VCS support this easily.
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# Just change the order of the patches. The tool should highlight
|
|
||||||
# potential risks of conflicts.
|
|
||||||
# Note that ctrl+c works well if used.
|
|
||||||
$ hg histedit
|
|
||||||
|
|
||||||
# Git
|
|
||||||
# In the editor, just move the patches to the line below/above to
|
# In the editor, just move the patches to the line below/above to
|
||||||
# reorder commits.
|
# reorder commits.
|
||||||
# Remove everything if you want to cancel the operation.
|
# Remove everything if you want to cancel the operation.
|
||||||
@@ -88,21 +72,12 @@ Make a change on a patch at the beginning of the stack
|
|||||||
------------------------------------------------------
|
------------------------------------------------------
|
||||||
|
|
||||||
In some cases, the reviewer is asking for a change at the bottom of the stack (ie not at the top).
|
In some cases, the reviewer is asking for a change at the bottom of the stack (ie not at the top).
|
||||||
So, a simple `hg/git commit --amend` would not work.
|
So, a simple `git commit --amend` would not work.
|
||||||
|
|
||||||
In such case, the following approach can be used:
|
In such case, the following approach can be used:
|
||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# hg will try to guess in which an unambiguous prior commit
|
|
||||||
$ hg absorb
|
|
||||||
|
|
||||||
# if this doesn't work, create a temporary commit
|
|
||||||
# and merge it using "fold" or "roll"
|
|
||||||
$ hg histedit
|
|
||||||
|
|
||||||
# Git
|
|
||||||
$ git commit --fixup <hash of the commit>
|
$ git commit --fixup <hash of the commit>
|
||||||
|
|
||||||
|
|
||||||
@@ -113,11 +88,6 @@ To remove a patch in the stack:
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# select "drop" (letter "d")
|
|
||||||
$ hg histedit
|
|
||||||
|
|
||||||
# Git
|
|
||||||
# Replace "pick" by "drop"
|
# Replace "pick" by "drop"
|
||||||
# Or simply remove the line for this commit
|
# Or simply remove the line for this commit
|
||||||
$ git rebase -i
|
$ git rebase -i
|
||||||
@@ -131,16 +101,6 @@ mozilla-central before landing the changes.
|
|||||||
|
|
||||||
.. code-block:: shell
|
.. code-block:: shell
|
||||||
|
|
||||||
# Mercurial
|
|
||||||
# First, see where your patches are in the stack
|
|
||||||
$ hg wip
|
|
||||||
# Then, rebase it:
|
|
||||||
# If you are a beginner, don't hesitate to add "--dry-run"
|
|
||||||
$ hg pull
|
|
||||||
$ hg rebase -b . -d central
|
|
||||||
|
|
||||||
|
|
||||||
# Git
|
|
||||||
$ git remote update
|
$ git remote update
|
||||||
$ git rebase mozilla/central
|
$ git rebase mozilla/central
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user