From b471be590b4f31291704ed5a9bc0f063eb7ad4cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andreas=20Kl=C3=B6ckner?= <inform@tiker.net>
Date: Sun, 26 Apr 2020 20:10:15 +0200
Subject: [PATCH] Apply suggestion to grudge/symbolic/primitives.py

---
 grudge/symbolic/primitives.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/grudge/symbolic/primitives.py b/grudge/symbolic/primitives.py
index 875a7bff..c2397c47 100644
--- a/grudge/symbolic/primitives.py
+++ b/grudge/symbolic/primitives.py
@@ -427,9 +427,17 @@ class Ones(HasDOFDesc, ExpressionBase):
 
 
 class _SignedFaceOnes(HasDOFDesc, ExpressionBase):
-    """Sets the face to :math:`-1` if its odd and :math:`+1` if its even.
+    """Produces DoFs on a face that are :math:`-1` if their corresponding
+    face number is odd and :math:`+1` if it is even.
+    *dd* must refer to a 0D (point-shaped) trace domain.
     This is based on the face order of
     :meth:`meshmode.mesh.MeshElementGroup.face_vertex_indices`.
+
+   .. note::
+
+       This is used as a hack to generate normals with the correct orientation
+       in 1D problems, and so far only intended for this particular use cases.
+       (If you can think of a better way, please speak up!)
     """
 
     def __init__(self, dd):
-- 
GitLab