bug#58928: 29.0.50; overlays in org-mode are disrupted after call `org-capture`

[Eli Zaretskii]

> From: Matt Armstrong <matt@rfc20.org>
> Cc: Eason Huang <aqua0210@foxmail.com>, Gerd Möllmann
>  <gerd.moellmann@gmail.com>, Ihor Radchenko <yantar92@posteo.net>,
>  58928@debbugs.gnu.org, Eli Zaretskii <eliz@gnu.org>, Eli Qian
>  <eli.q.qian@gmail.com>
> Date: Fri, 04 Nov 2022 15:47:55 -0700
> 
> +   When BEFORE_MARKERS, all overlays beginning/ending at POS are
> +   treated as if their front_advance/rear_advance was true. */

Please avoid this confusing style (in comments, doc strings, and the
manual).  Our preferred style is to say this instead:

  BEFORE_MARKERS non-zero means ...

or

  If BEFORE_MARKERS is non-zero, ...