aboutsummaryrefslogtreecommitdiffstats
path: root/doc/distributed_bugtracking.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/distributed_bugtracking.txt')
-rw-r--r--doc/distributed_bugtracking.txt29
1 files changed, 18 insertions, 11 deletions
diff --git a/doc/distributed_bugtracking.txt b/doc/distributed_bugtracking.txt
index f3d574c..5ca42a6 100644
--- a/doc/distributed_bugtracking.txt
+++ b/doc/distributed_bugtracking.txt
@@ -8,26 +8,33 @@ Usage Cases
Case 1: Tracking the status of bugs in remote repo branches
-----------------------------------------------------------
-See discussion in
- #bea86499-824e-4e77-b085-2d581fa9ccab/12c986be-d19a-4b8b-b1b5-68248ff4d331#
+See the discussion in
+#bea86499-824e-4e77-b085-2d581fa9ccab/12c986be-d19a-4b8b-b1b5-68248ff4d331#.
Here, it doesn't matter whether the remote repository is a branch of
the local repository, or a completely separate project
(e.g. upstream, ...). So long as the remote project provides access
-via some REPO format, you can use
- be --repo REPO ...
-to run your query, or
- be diff REPO
+via some REPO format, you can use::
+
+ $ be --repo REPO ...
+
+to run your query, or::
+
+ $ be diff REPO
+
to see the changes between the local and remote repositories.
Case 2: Importing bugs from other repositories
----------------------------------------------
-Case 2.1: If the remote repository is a branch of the local repository
- VCS merge REPO
+Case 2.1: If the remote repository is a branch of the local repository::
+
+ $ <VCS> merge <REPO>
+
Case 2.2: If the remote repository is not a branch of the local repository
- Hypothetical command:
- be import REPO ID
+(Hypothetical command)::
+
+ $ be import <REPO> <ID>
Notes
@@ -46,5 +53,5 @@ Managing permissions
Many bugtrackers implement some sort of permissions system, and they
are certainly required for a central system with diverse user roles.
-However DVCSs also support the 'pull my changes' workflow, where
+However DVCSs also support the "pull my changes" workflow, where
permissions are irrelevant.