diff --git a/pages/common/jj-gerrit.md b/pages/common/jj-gerrit.md new file mode 100644 index 0000000000..4794c6d883 --- /dev/null +++ b/pages/common/jj-gerrit.md @@ -0,0 +1,37 @@ +# jj gerrit + +> Interact with Gerrit to upload changes for code review, or update existing changes. +> See also: `jj git push`. +> More information: . + +- Upload the current change (or its parent if the working copy has no description): + +`jj gerrit upload` + +- Upload a specific revision: + +`jj gerrit upload {{[-r|--revision]}} {{revset}}` + +- Upload multiple specific revsets: + +`jj gerrit upload {{[-r|--revision]}} {{revset1}} {{[-r|--revision]}} {{revset2}}` + +- Upload a revision targeting a specific remote branch for merging: + +`jj gerrit upload {{[-r|--revision]}} {{revset}} {{[-b|--remote-branch]}} {{branch}}` + +- Upload to a specific Gerrit remote: + +`jj gerrit upload --remote {{remote}}` + +- Upload and add reviewers and CC recipients by email (flags can be repeated): + +`jj gerrit upload --reviewer {{reviewer@example.com}} --cc {{cc@example.com}}` + +- Upload while suppressing non-essential output: + +`jj gerrit upload --quiet` + +- Preview what would be uploaded without pushing to Gerrit: + +`jj gerrit upload {{[-n|--dry-run]}}`