From 7a171ded10d1b9821c612de31d9e7fbb4e6b25bd Mon Sep 17 00:00:00 2001
From: Axel Kohlmeyer <akohlmey@gmail.com>
Date: Sun, 30 Oct 2022 22:07:43 -0400
Subject: [PATCH] document preference to not use "alternative tokens"

---
 doc/src/Modify_style.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/src/Modify_style.rst b/doc/src/Modify_style.rst
index 9b394f23a9..ad2cb656d0 100644
--- a/doc/src/Modify_style.rst
+++ b/doc/src/Modify_style.rst
@@ -359,6 +359,12 @@ you are uncertain, please ask.
 
 - I/O is done via the C-style stdio library and **not** iostreams.
 
+- Do not use so-called "alternative tokens" like ``and``, ``or``,
+  ``not`` and similar, but rather use the corresponding operators
+  ``&&``, ``||``, and ``!``.  The alternative tokens are not available
+  by default on all compilers, and also we want to maintain a consistent
+  programming style.
+
 - Output to the screen and the logfile should be using the corresponding
   FILE pointers and only be done on MPI rank 0.  Use the :cpp:func:`utils::logmesg`
   convenience function where possible.