]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/dev: add git branch management commands 49736/head
authorZac Dover <zac.dover@gmail.com>
Fri, 13 Jan 2023 20:48:57 +0000 (06:48 +1000)
committerZac Dover <zac.dover@gmail.com>
Fri, 13 Jan 2023 21:26:18 +0000 (07:26 +1000)
Add git branch deleting and search commands to the "Basic Workflow" page
of the Developer Guide.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
doc/dev/developer_guide/basic-workflow.rst

index d7d8c1f26862c7a856d9a2fa70adc2b87d856991..738f8cb5c9bb58bb01c34cd92ea8339978897e47 100644 (file)
@@ -553,3 +553,35 @@ the branch in your local working copy, run this command from within the
 .. prompt:: bash $
 
    git config --global push.autoSetupRemote true
+
+Deleting a Branch Locally
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To delete the branch named ``localBranchName`` from the local working copy, run
+a command of this form:
+
+.. prompt:: bash $
+
+   git branch -d localBranchName
+
+Deleting a Branch Remotely
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To delete the branch named ``remoteBranchName`` from the remote upstream branch
+(which is also your fork of ``ceph/ceph``, as described in :ref:`forking`), run
+a command of this form:
+
+.. prompt:: bash $
+
+   git push origin --delete remoteBranchName
+
+Searching a File Longitudinally for a String
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To search for the commit that introduced a given string (in this example, that
+string is ``foo``) into a given file (in this example, that file is
+``file.rst``), run a command of this form:
+
+.. prompt:: bash $
+
+   git log -S 'foo' file.rst