From 6a7bc8500514eb63e6016c274c15c87853603fcc Mon Sep 17 00:00:00 2001
From: Andre Anjos <andre.dos.anjos@gmail.com>
Date: Mon, 1 Mar 2021 14:45:04 +0100
Subject: [PATCH] [doc/macos] Add more comments

---
 doc/macos.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/macos.rst b/doc/macos.rst
index 680f5182..a6883ab8 100644
--- a/doc/macos.rst
+++ b/doc/macos.rst
@@ -151,6 +151,9 @@ Building the reference setup
    Configure the runner for `shell executor`_, with local caching.  As
    ``gitlab`` user, execute on the command-line::
 
+     # notice that running `brew services gitlab-runner start or restart` will
+     # break the configuration of the service once more.  Execute the following
+     # to correct for it:
      $ /bin/bash <(curl -s https://gitlab.idiap.ch/bob/bob.devtools/raw/master/doc/macos-ci-install/reconfig-gitlab-runner.sh)
 
    Once that is set, your runner configuration (``~/.gitlab-runner/config.toml``) should look like this (remove comments if gitlab does not like them)::
-- 
GitLab