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

From: Eli Zaretskii <[email-masked]>
Date: Sat, 05 Nov 2022 08:28:24 +0200

> From: Matt Armstrong <[email-masked]>
> Cc: Eason Huang <[email-masked]>, Gerd Möllmann
>  <[email-masked]>, Ihor Radchenko <[email-masked]>,
>  [email-masked], Eli Zaretskii <[email-masked]>, Eli Qian
>  <[email-masked]>
> 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, ...