From 72f534ca15674424e7e3974042921178d6b1c64c Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 22 Mar 2017 09:47:30 -0400 Subject: Help/dev: Document `Do: reformat` action --- Help/dev/review.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Help/dev/review.rst b/Help/dev/review.rst index 28f668d..3004a14 100644 --- a/Help/dev/review.rst +++ b/Help/dev/review.rst @@ -86,6 +86,21 @@ following command among the `comment trailing lines`_:: ``@kwrobot`` will add an award emoji to the comment to indicate that it was processed and also run its checks again. +Automatic Format +---------------- + +The automatic check will reject commits introducing source code not +formatted according to ``clang-format``. One may ask the robot to +automatically rewrite the MR topic branch with expected formatting +by adding a comment with the following command among the +`comment trailing lines`_:: + + Do: reformat + +``@kwrobot`` will add an award emoji to the comment to indicate that it +was processed and also rewrite the MR topic branch and force-push an +updated version with every commit formatted as expected by the check. + Human Review ============ @@ -158,6 +173,7 @@ Among the `comment trailing lines`_ authorized users may issue special commands to ``@kwrobot`` using the form ``Do: ...``: * ``Do: check`` explicitly re-runs the robot `Automatic Check`_. +* ``Do: reformat`` rewrites the MR topic for `Automatic Format`_. * ``Do: test`` submits the MR for `Topic Testing`_. * ``Do: stage`` submits the MR for `Integration Testing`_. * ``Do: merge`` submits the MR for `Merge`_. -- cgit v0.12