From 45879d0049f49a226fcb2b7b8cfe6d02bf4c963c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 25 May 2021 12:22:48 -0700
Subject: [PATCH] Add documentation for notification text expressions

---
 data/interfaces/default/settings.html | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 9a24e816..618acc6a 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -1911,6 +1911,31 @@
                         <pre>{rating}              -->
 Rating: {rating}/10   --> Rating: /10
 {Rating: &lt;rating&gt;/10} --> </pre>
+                    </div>
+                    <div>
+                        <h4>Expressions</h4>
+                    </div>
+                    <div style="padding-bottom: 10px;">
+                        <p class="help-block">
+                            Note: <span class="inline-pre">notify_text_eval = 1</span> must be manually enabled in the configuration file to enable expressions.
+                            Enabling this setting could pose a security risk. Enable at your own risk. It is recommended to leave this feature disabled if it is not being used.
+                        </p>
+                        <p class="help-block">
+                            Notification parameters can be wrapped with backticks <span class="inline-pre">`expr`</span> to be evaluated as Python expressions.
+                            Only the following functions are supported in expressions:
+                        </p>
+                        <ul class="help-block">
+                            <li><span class="inline-pre">bool(x)</span></li>
+                            <li><span class="inline-pre">divmod(a, b)</span></li>
+                            <li><span class="inline-pre">float(x)</span></li>
+                            <li><span class="inline-pre">int(x)</span></li>
+                            <li><span class="inline-pre">round(n[, ndigits])</span></li>
+                            <li><span class="inline-pre">str(x)</span></li>
+                        </ul>
+                        <p><strong style="color: #fff;">Example:</strong></p>
+                        <pre>{`float(rating) * 10`>%}                           --> 89%
+{`"%d hr %d min" % divmod(int(duration), 60)`}     --> 1 hr 50 min
+{`round(float(stream_bandwidth) / 1000, 1)`> Mbps} --> 6.9 Mbps</pre>
                     </div>
                     <div>
                         <h4>Combined</h4>
@@ -1921,6 +1946,7 @@ Rating: {rating}/10   --> Rating: /10
                         </p>
                         <ol class="help-block">
                             <li>Prefix</li>
+                            <li>Evaluation</li>
                             <li>Parameter</li>
                             <li>Case Modifier</li>
                             <li>List Slicing</li>