Tidy up format issues in change screen documentation

Change-Id: Id86c6ab001ae2407df1a2e980a0896bfac1ad779
This commit is contained in:
David Ostrovsky
2013-12-06 19:45:27 +01:00
parent a3f72e4bb8
commit 890dd340b8

View File

@@ -110,6 +110,8 @@ which will open a drop-down editor box.
Key bindings: "e" to open the drop down. "ESC" to close it.
[[star-change]]
Star and unstar changes
-----------------------
Star change icon allows to star the change, so that "starredby:self" query can
retrieve the starred changes later. If the change is already starred, then
@@ -118,6 +120,8 @@ clicking the icon again unstars the change.
Key bindings: "s" to star/unstar the change.
[[permalink-change]]
Permalink a change
------------------
Hyperlink "Change <change link>" is a control that serves for two purposes:
reload the change and permalink the change. To permalink,
@@ -171,7 +175,7 @@ lines with the mouse and then click the bottom-most line number to create a
range comment for the highlighted lines.
Key bindings:
+
* n / p next diff chunk / previous diff chunk
* ] / [ next file / previous file
* u up to change
@@ -215,35 +219,35 @@ link:config-gerrit.html[change.updateDelay] setting.
A tab control on the third column shows the related changes. There are 4
different tabs:
+
* Related Changes
+
This tab page shows open changes on which the current change depends and open
changes that depend on the current change. For merge commits it shows also the
closed changes that are going to be merged into the destination branch by
accepting the merge commit. It is kind of a dependency too, but not in the
sense of "these changes have to be submitted in order to submit this change".
+
* Same Topic Changes
+
+ Changes that share the same topic are listed on this tab page. Only changes
Changes that share the same topic are listed on this tab page. Only changes
in status opened are currently shown.
+
* Cherry-Picks Changes
+
+ Changes with the same change id for the current project are listed on this
Changes with the same change id for the current project are listed on this
tab page. Note that also abandoned or merged changes can be shown. Currently
the status of the listed changes is not shown.
+
* Conflicts With Changes
+
Changes that are conflicting with the current change are listed on this
tab. Only the changes that are mergeable are currently shown. Non mergeable
changes are filtered out.
+
This tab is only active if secondary index is enabled
(link:config-gerrit.html#index.type[index.type] set to `LUCENE` or `SOLR`).
+
Key bindings: "J" & "K" to navigate between the related changes. "O" to
open the currently selected change on one of the related changes tab page.