From 876d7f90b60e3fed88b6ae8eb2720f1f9a02306c Mon Sep 17 00:00:00 2001
From: Kelebek1 <eeeedddccc@hotmail.co.uk>
Date: Mon, 25 Mar 2024 19:16:08 +0100
Subject: [PATCH 01/13] Add option to log synchronously, add tooltip to log
 filter.

---
 src/common/logging/backend.cpp             | 21 +++++++++++++++-----
 src/common/logging/filter.cpp              |  1 +
 src/common/settings.h                      |  1 +
 src/suyu/configuration/configure_debug.cpp |  2 ++
 src/suyu/configuration/configure_debug.ui  | 23 +++++++++++++++++++++-
 5 files changed, 42 insertions(+), 6 deletions(-)

diff --git a/src/common/logging/backend.cpp b/src/common/logging/backend.cpp
index fd16197749..2cdd6cf06a 100644
--- a/src/common/logging/backend.cpp
+++ b/src/common/logging/backend.cpp
@@ -4,6 +4,7 @@
 #include <atomic>
 #include <chrono>
 #include <climits>
+#include <mutex>
 #include <thread>
 
 #include <fmt/format.h>
@@ -231,8 +232,15 @@ public:
         if (!filter.CheckMessage(log_class, log_level)) {
             return;
         }
-        message_queue.EmplaceWait(
-            CreateEntry(log_class, log_level, filename, line_num, function, std::move(message)));
+
+        auto entry =
+            CreateEntry(log_class, log_level, filename, line_num, function, std::move(message));
+        if (Settings::values.log_async) {
+            message_queue.EmplaceWait(entry);
+        } else {
+            std::scoped_lock l{sync_mutex};
+            ForEachBackend([&entry](Backend& backend) { backend.Write(entry); });
+        }
     }
 
 private:
@@ -313,6 +321,7 @@ private:
 #endif
 
     MPSCQueue<Entry> message_queue{};
+    std::mutex sync_mutex;
     std::chrono::steady_clock::time_point time_origin{std::chrono::steady_clock::now()};
     std::jthread backend_thread;
 };
@@ -345,9 +354,11 @@ void SetColorConsoleBackendEnabled(bool enabled) {
 void FmtLogMessageImpl(Class log_class, Level log_level, const char* filename,
                        unsigned int line_num, const char* function, fmt::string_view format,
                        const fmt::format_args& args) {
-    if (!initialization_in_progress_suppress_logging) {
-        Impl::Instance().PushEntry(log_class, log_level, filename, line_num, function,
-                                   fmt::vformat(format, args));
+    if (initialization_in_progress_suppress_logging) {
+        return;
     }
+
+    Impl::Instance().PushEntry(log_class, log_level, filename, line_num, function,
+                               fmt::vformat(format, args));
 }
 } // namespace Common::Log
diff --git a/src/common/logging/filter.cpp b/src/common/logging/filter.cpp
index 4e3a614a45..c16f4df3aa 100644
--- a/src/common/logging/filter.cpp
+++ b/src/common/logging/filter.cpp
@@ -171,6 +171,7 @@ const char* GetLogClassName(Class log_class) {
 #define SUB(x, y)                                                                                  \
     case Class::x##_##y:                                                                           \
         return #x "." #y;
+//        return #x "_" #y;
         ALL_LOG_CLASSES()
 #undef CLS
 #undef SUB
diff --git a/src/common/settings.h b/src/common/settings.h
index 48f127bde8..829759c94b 100644
--- a/src/common/settings.h
+++ b/src/common/settings.h
@@ -604,6 +604,7 @@ struct Values {
 
     // Miscellaneous
     Setting<std::string> log_filter{linkage, "*:Info", "log_filter", Category::Miscellaneous};
+    Setting<bool> log_async{linkage, true, "log_async", Category::Miscellaneous};
     Setting<bool> use_dev_keys{linkage, false, "use_dev_keys", Category::Miscellaneous};
 
     // Network
diff --git a/src/suyu/configuration/configure_debug.cpp b/src/suyu/configuration/configure_debug.cpp
index b4fa4eca09..6f9bb36340 100644
--- a/src/suyu/configuration/configure_debug.cpp
+++ b/src/suyu/configuration/configure_debug.cpp
@@ -73,6 +73,7 @@ void ConfigureDebug::SetConfiguration() {
     ui->disable_loop_safety_checks->setChecked(
         Settings::values.disable_shader_loop_safety_checks.GetValue());
     ui->extended_logging->setChecked(Settings::values.extended_logging.GetValue());
+    ui->log_async->setChecked(Settings::values.log_async.GetValue());
     ui->perform_vulkan_check->setChecked(Settings::values.perform_vulkan_check.GetValue());
 
 #ifdef SUYU_USE_QT_WEB_ENGINE
@@ -115,6 +116,7 @@ void ConfigureDebug::ApplyConfiguration() {
     Common::Log::Filter filter;
     filter.ParseFilterString(Settings::values.log_filter.GetValue());
     Common::Log::SetGlobalFilter(filter);
+    Settings::values.log_async = ui->log_async->isChecked();
 }
 
 void ConfigureDebug::changeEvent(QEvent* event) {
diff --git a/src/suyu/configuration/configure_debug.ui b/src/suyu/configuration/configure_debug.ui
index ed48b2f8f6..e5b76290e6 100644
--- a/src/suyu/configuration/configure_debug.ui
+++ b/src/suyu/configuration/configure_debug.ui
@@ -164,6 +164,20 @@
            </property>
           </widget>
          </item>
+         <item row="2" column="1">
+          <widget class="QCheckBox" name="log_async">
+           <property name="enabled">
+            <bool>true</bool>
+           </property>
+           <property name="toolTip">
+            <string>When checked, logging will run asynchronously. This may cut the log on crashes.
+When unchecked, logging will run synchronously. This will slow down the emulator, but allow all logs to be written. Useful for debugging.</string>
+           </property>
+           <property name="text">
+            <string>Log asynchronously</string>
+           </property>
+          </widget>
+         </item>
          <item row="0" column="0" colspan="2">
           <widget class="QWidget" name="logging_widget" native="true">
            <property name="sizePolicy">
@@ -199,7 +213,14 @@
              </widget>
             </item>
             <item>
-             <widget class="QLineEdit" name="log_filter_edit"/>
+             <widget class="QLineEdit" name="log_filter_edit">
+              <property name="toolTip">
+               <string>Log filter in the form ＜class＞:＜level＞.
+Separate multiple filters with a space.
+Levels: Trace, Debug, Info, Warning, Error, Critical
+Classes: See Common/logging/types.h</string>
+              </property>
+             </widget>
             </item>
            </layout>
           </widget>

From 040893da00a4d42f973756e26c7f94213d4d7685 Mon Sep 17 00:00:00 2001
From: ilonachan <nagato_ilona@proton.me>
Date: Mon, 25 Mar 2024 19:25:11 +0100
Subject: [PATCH 02/13] formatting

---
 src/common/logging/filter.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/common/logging/filter.cpp b/src/common/logging/filter.cpp
index c16f4df3aa..ae866c7a50 100644
--- a/src/common/logging/filter.cpp
+++ b/src/common/logging/filter.cpp
@@ -171,7 +171,7 @@ const char* GetLogClassName(Class log_class) {
 #define SUB(x, y)                                                                                  \
     case Class::x##_##y:                                                                           \
         return #x "." #y;
-//        return #x "_" #y;
+        // return #x "_" #y;
         ALL_LOG_CLASSES()
 #undef CLS
 #undef SUB

From b5c02fe14a0739add8e7ee0553280f2cd15a8704 Mon Sep 17 00:00:00 2001
From: zqpvr01 <zqpvr01@noreply.localhost>
Date: Fri, 29 Mar 2024 17:31:07 +0100
Subject: [PATCH 03/13] Update README.md

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 6334f02b2c..2e76388ba5 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,9 @@ It is written in C++ with portability in mind, and we're actively working on bui
   <a href="https://git.suyu.dev/suyu/suyu/actions">Pipelines</a>
 </p>
 
+## Hardware Requirements
+[Click here to see the Hardware Requirements](https://git.suyu.dev/suyu/suyu/wiki/Hardware-Requirements)
+
 ## Status
 
 Although we're able to make builds, we don't have a version ready for distribution yet. But we can always use more help! You can make a merge request if you'd like to see something changed, or you can [chat with other developers to find out what needs work](https://discord.gg/suyu).

From 9e223759e0e804514c318f282038fc0e12c8a180 Mon Sep 17 00:00:00 2001
From: zqpvr01 <zqpvr01@noreply.localhost>
Date: Fri, 29 Mar 2024 19:18:38 +0100
Subject: [PATCH 04/13] Add img

---
 img | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 img

diff --git a/img b/img
new file mode 100644
index 0000000000..e69de29bb2

From 2a672fac30cd3a7b578088c02795d641ccbc93c8 Mon Sep 17 00:00:00 2001
From: zqpvr01 <zqpvr01@noreply.localhost>
Date: Fri, 29 Mar 2024 19:19:11 +0100
Subject: [PATCH 05/13] revert 9e223759e0e804514c318f282038fc0e12c8a180

revert Add img
---
 img | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 img

diff --git a/img b/img
deleted file mode 100644
index e69de29bb2..0000000000

From 444a200eef33193403ab8d1ec3ee81742f611156 Mon Sep 17 00:00:00 2001
From: zqpvr01 <zqpvr01@noreply.localhost>
Date: Fri, 29 Mar 2024 19:19:28 +0100
Subject: [PATCH 06/13] Upload files to "img"

---
 img/maximum-clocks.png | Bin 0 -> 30758 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 img/maximum-clocks.png

diff --git a/img/maximum-clocks.png b/img/maximum-clocks.png
new file mode 100644
index 0000000000000000000000000000000000000000..0353c0bf83796ea720b4841784e90595142e6637
GIT binary patch
literal 30758
zcmb@ubwHF~+ckOv0*Zt`m6nk14jn*Hy1P>lq(f<>R7AR@yE`Q$hmh_Z1Oe%xb7+|F
z9(<nnJ<oaH@BDS(51706zW3hOTI*WZ1gR)V<Kd9u004j|D<h!>0C$K10DbZ<7Puu@
z;a)ZPhuTa=O%VV*834fVGXPwGoBZGa;KBs}n<fANNdN$1$CL(DVQ>eQsl2oVfJFUf
zH0Q?vfE%f-#7hnLnVmV`58n`}d)I<ywrwJax>7sFn4b!dhj;9Yb5lqjqMJRLg`YSL
z)iU0VqkHAwn33kKlgpO;Ftc7axb*aSmh)5AhdMbcU%jR#e^4ynrTg+t&8|*_H7SRV
z_dvRi1)ioa_U*UtfC5kA0A0*L#8!7xS_C%1AU`Z(7|~o-U$%8w-?Ff$(70+dDULju
zzeG2Qw2J-`ijNLHGmtm*+8GcVqOC-IXkC)wK>Y>$zC9aC6R~l|z5UeMZdrf(51{ty
z9op@GIiFW<PX}b~^<w7WiF)2{tq)p3AG1grMQe?d(L)`$7BBb<a|o%C#?iQ<cHN6f
zOhO?v2A|j%_gtTILySsadCC-VTn+e+@WTwULpU2o;3{kz*97yhy_-{R@3Y0g=)c#|
z;@VhgCyY1B<IPvzh=qldf|n^MsE~;_b}gL$utne`DvDHJ-wKxJ91kTO55u3VR!V<f
zD%x^XW?}TcMk)P8>3YOXA3Tz6W4NqQ31;XO7Jju!m@STGqAyP4at{#mRD{%XnRVe(
z2%Qv-I?)b>pHjgPu!YF|qhTZ0#1{}RsqP2_IYp7xbLhULq0g_}26$G8^9npfD$q<9
zdDytHv6j3>PJspJqk2-TfqM--n#cRX8L#CaZuE7+%%5Zj%dTTmsX(+=r2-5L00^N5
zyVOsYJB!&*R_@gNQ~v|MH@TekT<>E~s5YiXd!UTk8+skC#d-u3R+A#Uc=u5q+|%GJ
z=$?f}==Vm^b0FY{McLSmVJt*PzbLR{S$O^=23wOYXq5E!RmcRKW78^$zgr}m8?V;E
z*phyDKl*s!bXU-G;dXxo+IvPKx?ZQ#xw^dCFNvB(&MrO3ZTBMyw?uc9I$5&a21nSZ
z4nyXX1s6rNe&OSosYR>0Yq}!VF6E*y4rP+XP4k({(|%{gO`9segtUlV&zkK5?V!=u
ziR?rsk3Dh0Cca5B>u-5fSWZ7u-m;H0^3t~XQAI_1l%You(5NtwWLTuTl`9k&bC+Y1
zsF@^fKJ(+uUMSr^UAlRH&ItHyPOd$r#&{R*5A%9`!q=SO9s1a7_&rOKlj4{FIon9{
zNmI3-ks`RpRyz4An`L`#SO<Nr<CMWIQU)DpW%9VFE1Q5Vu{@zPUYwM+=G%(07IDsb
zar|q5hOj5MzOg}*JQ2FwxsSY4U0lz83>|JM5D!B%Sm)7&K?mASU{bZ-Tc02^I^0*f
z&{6u}&t<x!Srmk+dTPH)M*d+NbrT#K=ieN)VJ;IYgC*DO&r0pN;QS_J(XMOI$n)4u
z-Q3`ZPy<{-4`l&>gdV|798LlAV-c72Hw&`Z9Kl$O!=h!_Y>)iO!>euOn|<86ttOIf
z<2)QAI$*u{nx{#xO6KCyd{8y$Gv&3jopM1y8)QSpB(p^%UtTd5@8UX`Xh-K8RT^gj
z)L1J&-8%84j8#R<oQ1%5qJA`ckBZ<L`Zn8GXiY+yp!C$=L2!%T1Cjm7Mx!ih*zK{D
z9qkWo`IfnqM7r+Bu^Mr*oYyje2Kvs@=9Nia9Xp?XBdmYvWy@?>R`3fC=8DYY9R|pW
zE4I9&IJ6%*$epdR^XKLHeo|&oW-(c8UOGWqGTKfqp6+Z{rX}w6=GUc0Uctuo=qzq|
zw%|)P)IfU|zC87<@t^8Kk9dtnRvwO5p=RCu8Nmhi;F9Z_xb%upqT$UziCQjevSgra
zeS=t;N&Zzi<C(B;CJuooUw+lgVOdW*{nRxL&sRtREX0ndgL}&dgu_>bJ+<>025;|)
z!^Mq|>_+i#@J3&#)C`=|X#F&Ta~vb&qcsk4?lIGdrd0eWQ)iN(^rrAMqp@_|;kw4>
zMk)7+>KduG!O27S;#J*WMHzI6-HEi0+$4QMqoyJQ^FX21n2Dq5!;z+WYYzbe>qS##
zOUk!lI1rlgM$Os+BYKvpDvDFtD1=w><jAh-xK{j$#8hRK{Ho2CW;7EK*zWt;p9s15
z!A6%x`<$D|v3ek)$Oa*lWC;iU`_=x2E)Ay%bTu3EGc-F3lUdnOFYqbI`L?{4OSyZ^
z)2@Yf8oo<5MzF=9Q$QYbH9U(-dFXw*SGO^Hj#EQ2{orCRJY9P59fD`a&ZuDVgQ_F-
zH@2@zDpyyL5ZHWX`<4G_KNZzTf%@X6M^bUKC$;BwIRR5ffc3L!I!yt1eGQ%zai8Tb
zPHeHfVso^o&}7ZUi3;p){WsC+qP&yJkTXa_O<p@~&E;yTqxGJ>ue)Jo>3#G}iB6MZ
zJ({fzg3k{zz>`@muI=LwHH-LL1WHNMrb}t+9(I8t!9>%!0zHpm`1G*%xMbtkB|qyZ
zr_>WKjfIqJctY>#kbTHSvEA{4Ec;Os<&9P$B_*%+K!ZsW4Eu2pR6MOX88NdZa<Ne-
za$)sD=qHIb=lJ~EI|{wEQDtM8V_nek;l^d`3t6LUc!n_^j!U=u5d0kuYayF@%Xpz(
zOVXm%d2FZki)TZxcD$<HMkx;El9Cs4;}-4jn{OKEij0N5-g%5pW;+>7FEsf`WYDl&
zD3pT<HA?gTFx77^J&Uoz{p@^X)%|F!4n}{zg{R8?xGd4Q?1zYvePZz;I5HpAboyTV
z;ag?K{eH;5vuS=Y8vHOI8khC>wCw|-k)1QC<YSxpC;1Io4GiuAfsInfSdX3KtkQ(|
z-pZQ)k_owk*l3kk8Z<O6yNZWMJw*Ft2pJ)FxOwI&G*L)4sVS*^p9vnCC?G7N`giWg
z&LbFS%&-){S>k?Ha0jPBT!EwzKF5<ZB6rgOqw%Iu-j?|iLp0?62mkm6sfOn(oS}Lx
z;2JUL2|n8++j?oyxe9Hs<ZDmntErav%M4bd0?pNybm0Nz{ZE!$6fLPX$VMyb4Q@*9
z^q834e|Swi!xq7A{05!O6$x8xqw;dIR<5x7fhn<lWris9Fe}!pt?h+E4EmCbCo9JI
zt@U!~JKQU&?~O}vfWQf;<r;iHJ}Az3bKQ|c%*4Sm!CKyA>-@XNZ>t>o(!2X|*+<Jj
zqrg|h)%G2$LS1pT?{!<s&GJBE!)6hU2(mq-u$(P$?!)+pz6apNDjo!m{)HNOepu^V
zK~H5pq_ENGb`TcqSGA)r-}FcR&<83+%UpoShYi{^^c#%?%8%HIftbFqK)c;Qv9kU!
z8wwDBe4D@I>cs?l<==~#EKNrFpx$-~wMcJ(KGno1?cAa-!KOg=DUO)Mo941%eMNu^
zXTuO^eUp=BkWepoNuG;s5pO-Utu|P+1JkTia;2a2gv%7~CR#Z=ffo{^X}%96q)cEt
zvvFv=%rN$jf<}lG1>)UwzIxMTH)$*gxifxwy%#}F@zL%#*s^SKAd;oa<_^$WHIMw`
zeZA{TH6BRilQ3~LE-W}F?7XxPldKyZ9D;-BW97723CaYczi$3VLzjy++VX()2B}lw
zUs>(l@-BPd7iH^S6lA-d*c{Z&xE#f>7r6v5Q0YNmS{vloN8vf!j+E@x1n5a@>y>;Q
zkr3g!^byHMg+Qb0ErOyd?&DvXh+Jz9>&e}H9Biph|K1-r7vvLeO`^MR1sC{?hoSpf
zqfadehkv5F>)m9!p<8O6@5Kj-^GR0O!Sq*kUu9~F6;FrC#@jsDA)Yz<1amC1<r|CL
zLVPfF5#dw2G#m=gE7fMtEjJCJil-9+rmls%-nHNv^BLkemfCh!OqChdBGtue*ft%8
z>{Ie?^Dc_+iX4;k%=`l!lO+g>q}l0GhHGkJ<3Jp1Xh#BpOh}3x+secc3Uns)K(BV)
z8sJMIF=?WTP@;p|mBeClSL>zOv$p;15Qql1sKID?T)s(NQhMwJtlU4?WkxiG?W>tZ
z6wZp;PT4+nR2U%(6AQjC$w=83X+%-`tcn=+YzI4Gnzw48Mn*A7BU-`}sU7sz0Pub}
z)Xk!j9^0z?+c=-~*}zDq?Z4Z!MP}%w-Hd}@9rzHvn{ra{ZG6#7(NOD+2g=<&)KTAQ
z*~!4+VKMUg9snp9Zi2&2Tk^WEgTKKeO&+6LyhEsE#z!UTl!84uKWYl|b@>am?9N7X
z7N+3wkBiezcm*^?tal>qn=(Nd)r0dcUQDT{UkG_MF}1(#L`aFkhYMi5VCBhJs+2~Y
ziPce#V9k-AV+NrHbyslDfTzicO|(%A)GU>9da`t8-!J@hipUCCMnq8>rnh$*%E2*>
z?e-i5pd}U4LKIjCtUQaPQ;;6`e%QOtAtpJm`MUD^B*xz3N)<|mHogR-L5&08pO`}I
zJhy=W9bWB?p&qgD+l{SphdkeBQ0N65gP7IDwG4cbw6}XIa&hU2Ux_N7SB!dL-)`aI
z_&!Giv=XriJS6lxHggsPTIp7n#%aL`n(&|ohkAW=Nu35T>3esu5%vGz7q{m|M)NTc
zmyL=jyKcdw_HW^_tXd5v<RSkxYC@9g=IIfHT?mcx-5zbCwIRzfV32z)t*3G3UT86h
zkF<%jZ{g<=7i+W@A1B_6woaxA!fqvlTi+t<pxmeRj$yl2dL{md+=kO%1-;-)?HCSE
zy_}SG-Ha?&6CCG3BZ>~er~(pj)S>`CgEkR@>|Ah_(9M<84!j!9YXT`ETet=tAe7A$
zWcmAuOV6`G^3KI%{7MOIUbDR3|C8rU!e}Et0F1R8md8;bShykhw5HtSEf}QI<_{C4
z(EIzIAWwt!)r>=mRXUf4GiD4k(J0(t_;7y*ks|G|`S%HA@q_?Zh$;K*C<7FaWrSY7
zu7A&l{03H4{R|Py5N$oy241=MCs|`N94hMvRNy|;(TY2*yHw7p{bIHQA+d~F*V;(@
zY)Fefqp6=A*j=p!SNEm17z0tUrI?SNzzQD+D`4^v1r78KS;mD=l@P~d6eAPg*yhUY
z-ZxaYH>!(7=a{nV8)rU51R#~Z&!-mY^GpVaSkLI?4aH7c@8ThwTg2oVQY|57XnrfW
zL2u6t;`7~nqLx^U#ycY1;Fe}}lxh<h;ot~LTRQs$k>b3(M2n}i)XQD(C?&Pmuhqe%
zAU_Trr8gt{pg10Kc*n1osgNzk=pqWgz7`(dXUc#2h4lwWHf&2(ecp7nP3`l=pSTP5
zFv=bl^lF!h&*MQ_oEvM|9i=R$=41OOOFU~zVj-XS_1w+iF=d03)|L@$Ug>?0`I|*O
zlNVi%8NQl7j@TrU@zUN6m7_Z@tgqy(-gd;Do8hxB;lR`^;(6<=kcmvMYf+rF4-IlD
zov413@42)sFaL5v0878dw09_ht~&$k%cJK${Cq4*_0oMAI{i~qObg6*N0UrH9AY5r
z64%$mFE$!ttY?_`=~(ujng1~DRkGTUa8kl|d)?Y{W>3q>ZsT#{Gq|ard)?UJ!uRgz
z{`S<8gJKh$ccFM(Q@PgiG^$gzzlPM1gP|S9*UY30$QV_w4Msr(PkObdOZh`sG!Au)
z3#yuKA#G8Jh5}4(bFNS%aF(x5?yyF_h(-I?q7uK%m|6d-2V2ujk;@_HNr6Wl9f)Yt
z3gYs)g}qgq<z|HV9J;;7)~r2dXe-?(R^D4h)Iq-eaD)|`+co2}-7DZQVjKO<u}a`t
zNUvHP0w?JTn=JGPUpgF5*|=G0KGy&2vcf3`H@<T>q|u1I7`vvo(clFLVYW2rBsFKQ
zA<kznN)KwR1{bON$Kh1WpGpt<O!AWiYl}WSOMJTVN0ZjKaclCOVTv~e$KD-tc$s#`
z$AhI5;oWw?#Mr}_HOe)A#{Fe<xJZ%1kPqJwwq1kUiF@xy*ztay9KvyooMs&l5Yzg>
zs!_(lkC5Bk(SU8viW}0dsNI+pC(U$oEN#K3l5ip>cH`^X3!57|2$#7Xx-c@i0WAH=
zhq}tXVr`2%T_p=UYAtf&gu9DDb1d&zU$Y$$+WZP<*MsBQd3AOrfNidk$ELX#e4^s<
z_!)-N$<s|;`uP?R=4pgYolVJtbcx@dL_a)i@y@GB$hr5aY@jdO@a`S+3|Wn{<v6#G
z%ZU;xfXSWj6L$w62I{UD3j5X{hftAIbkjMWflK|D=suoRq12hRV$!rYW8IRqPs?l*
zEz(}Zb5F~2>dzOa(7~ZE5%KgvxywtQCH{Ul*j9K@+!h`a9G6kb^KzmoM{f{3;>sn(
zWBlQk#4w8wzxy>#O_$|3SwMr?*;3p(mdA|voP1LwhSf$AmsF<wInK{>YSk2BB@C`O
z-7+zYpboYtJJ1(aDCwuwIhfxeT-`9ac=g~5(r#DlCIu(<KOk+7zR!O^T9!6dhimC!
zDrtv6h-P*}5!?z5GnIS%OFm;TeS3MF_gH%kH#8v<o*xt)R0HxX5CC&Md&%83OYGL1
z6i39W;Q`h6!cJvzjJRnsZ)V(dh(E-}fTR`R(xh+@hMl_6?4)i6vvdS4uQ-tbTv|p>
zqn%f5bUd5t={MiXejM{Crr&JfIs^$a16)xp%h$bwB<0V2FJ)j~zYMM(I@pcBl5Ojl
z%Unae{=dLnr!0-5F0C3{yBJ>=OF7t@HGhe7SQ3#(h^P@;2e(MA0c*9l25ab_md45K
z;8EUi;^OZN*5~$ihhMsQ6Ec1-Z}&&!V(PCLb3K$cJa&K3OtCqz@Ng6VpBdF1!+HY|
zwRRr(y$H9;E?Az>$y{kech=3#+w`26<)3gW%`Z`iB0*|93dSKiLSjNCpQixV2p|2B
zsQ%yv@7v>UxA{?Ns?@==+B^{i@}@46YF8xb7`;<6U{iRJtLj7K)7AJC`Lhv^BgG@c
z)qPGSt7hY?t93*#<6FcDwAt*K10CSv--R3dR@8&@U)xy<kM7=^`<%gk&X>R6iWWBs
z2hO`6?J%>8CVHC8FWg+YWS<fX2zp=SPr6;PXLo>6^`1Md&T23$3ffT9D{qP>MO_Kx
z%u?O#EL2T>WD^mUyeB?gSP#axys1WY7x_?pn)hFPQ_;onGXn1Ne7eCSk}^dB`qq_5
z9Wjd>&U%%zb<Z-yKh0$4rwd2}Sgzfw@uaf8Z^q^QM|Og3Z+krGOu)mp1J;FX7Ts6F
zkDWu9uHK8(o%bJ>x5yKm1TtKAUiUlK<Sdwb5?ml<jmyvT6&x^$B#l7&-D>3C@|`GL
zdshZjz(N|3oDQnUxTv2W=|m7F-$yS|0xxjVC1x8Jd7su0#QIE4FVi@$qy{O1EY6C2
zW-j<Q;>ViGTS}p2R&l!vS;+O`#jI=dkTUQ6_>QA%pZ@aI`b#20xlLpsbQE^l!d+E#
zB?^0=Y$kf2v+g2raixpc1?h`qWj}vq8HJ(0JLV>|q{!O<N41|?l8%V2Z8r#$*>H|#
z{)2uLRdtj7BEhjJvVWcK`lZkp)~j^&#Xk%18SIXrkJx)t>d`bo{+IWCp9?QUJIEnx
z);O-q_J<L_*XSFN`vl!ST9pdr^M<9+>Debn$`VXLf6hC>li@iMk~MKnqggh{!+5E9
zK~#%@+L$yn3aDdl89s7v@8m`WHdPI8Eg-$2MlQnpZmRZMBV3Y*c^ATwH_Dk#WMHQb
zLa$QF`XY{WyUSg~w2OXlF@(#o2E)OQ#9YuqYHuC?Zs)Yfd;I<>9wzGgV(5j8#1{)%
zzD>bCGy%S4>$`C`4Qm{R`bUB@2NqeR(1IoBRrK4JRWE;P6J%uPEg@PeGww;NF#EW-
z+W(gD+0x<7(fAZfBNuHh(v#y0%Nc5uUp+b3F5(&s%i72CXrVq26un9j7W7diIDtm}
z)WLT;hO!}(eRIw4Lksdv^*Na)ik6_8*q$TjlClm8rkz@nF*ri~0WV(zt)c%ZMh9a$
z)>VmybDMlt&sW|`bz7JO=NLca+iNS*_ls^`z6Cbe;)WDA>HF0;zGvj#b)rK96m~NQ
zgU~UgZL_53ksyStXtkYcV$UE;TVIrsnQwpTb8oQf{KzNYUs=U^NV)PGV!ZO@M)CgR
zO%Y?9;Un^E7ex*_A``dYU1+T&+6JD9Ln$wEwT*-<oS6W>Cz={MIsKfC8V)T8>}+vT
zfx*j~a)RrFW`by=j2{Imsf=U18XcCE&<j6XR_IE~Mfhp=^){$HZ=DkxrHpxogy1|X
z1F3j1^S{|Q33ySrYlI-3=CEAu3xPz>jOFcL5n&vUfG?)D;9LcO!d{6-cc|}aSPp)|
zCj#1kJONn&vs{0|{fz^8@4B^kDQy3e#d}160^^p4G1f;6fSNXsdFvFxOiz51gS2$b
zmT)zA_i6MWkSF2<fun$@-S5kia|r6v0KojT9!N+8(SXpVrm6E2V9c-5A`%T$J&`fR
z&ZVOuhki%di<zKM8Mk8@vmi%k{SW}6Ul9XBv%Wd{mwOEsZ_s0X0FqC9jm^0(V%@Vo
zW2M;DFTc0I1UmUOwlZlEo8_gW9eN;cVsWXcl_H?xZAggZ|9|0EP)?A&>uhN<PvD~5
z7?!S&OY#KQuQ}3!%4yHHk#+Gc!F7amD87T-80_8aHI_NukxX$+M8jJPvMIN1Rqyw;
zVGbi-i*u?JJgp+|F;iK}*}^Y=W-}NkUoHA7YC7eyhg!XSV5R!tX0HlicX&C~%Ubwm
z<79F5s%1xSO{qFnMLu}sgeF~jSQOu_S<kd?u}oY38MxR7Aj1Wb2?+XnJ3x$#UOjtP
z`)C=X$WTk<Bs;OV8Yxp3jv{)r1e>)z)nGCpE&X%;AV_GGUlatU;SQdTl)~U?i%5df
zwV6h}4iMXn(w1&`%*(lPgIyTS<Zm+h^W(R!mG&CV*fD>o`Vm@T)n?K+SfGJMiO2h#
zp-<k2F3zmJN|Mi1RZ7f-c4Gvz`<L;qZ7d^r?V5~vT&4;#vh^tUu+Hfa!nGgVpAWCS
zWH;EBtw?>rFFIOUg`;dKqPfZ<bj8cBJe}2^oma}S6J%><9^VI>D$a4sKY7A2`CFzc
z>#vq7&j%e1yaQz9EYyg2K`BQX7T<`;)KJdUfQbotejC?9qCJ)o4AFax)CM7%aL&n+
zU#DB7vhN5BpqU!qr`#;<mkDxvkPD=nMhBa;{7L*m)oHq0kLY*+Anu=JnTmI&FXi-6
znGRuP$n;H;k)0^hU~%xKnNDe-lsU}oCcJNL4_eG*of@<rGPKkog;MI{@sH)K_cY?a
zD;)if+9<WQibxf-m~qE4i;u9TuV~Qdb1S49h0F>~x|r2BMK=-VZf@=~R&sKz7Hinh
z%uefNf5?}YjQ&7D+l%86pzh^%*`4aEv!^ua5ziPk4XXaDiEDE#KX|Q60um)z?rv)x
zea{p%wi7Mz4?fSFy01D;FMCS}b6R}xB#_AchOD#zGS-}rG+oYMZYYHAaY>p^<QV^2
z`v8mPW(HZftXd=fW?+NITDGT4I|m-^uPcWa<kq`&`fA8KM^<Yrpo(1NbpaQ6%}5_>
z-sc9X8Pw(#W`|bk3}TNrJq5>IZCv4dbC-gw-7@X|nFFHzt&zn`zPdizx#?2zFj@Pz
z6`HJZ+ZxK-$0s5)jc|Mq`oY0HHTm?Mr8`HBTQ1UAePlr7({4)54u387V!5M18;dt=
zMPno1hX*ug7Tz3#!pvA3J{Z&#*@<5n(##-==r;I8e8qbCCqo9;M61*T9}ec@pVR)j
zHjCIiz>miXVVu8HV)j=nrTeRux)!MO7ZnF5J)h^34fdQhR@2S9k{~C?t&9Ac#yJY1
zKX<KT@kMy|E!0W3ym8GF%*f!qX~=m&;oe(Vztta$R15U{!jL2y%1t~F_D?YIx%r|;
zsnE3&hi(H@RDKZI=)U>=xk!%Cxrt;Gi(5Bp3O5Qt(wr^!_{$3LPUr0TGdy<UqMDMa
zT=W{arQPxId4r;zdZPyoV{Eae;;7-n8I(}&I{1F?zab(#8$~I<@|IdHxY`}nScT>M
zS+vJowkrT9z@6DI`ZA#dFk)Y!9UOW}tp1!&-UpxDrX*^9z^54Yuu#ZSPuscwbJ{1v
zzJ<-Pw630utAq6g%VX8bh^OX1Zidwf{a%A4=lTOhGw&6$MsfyPtS?PYUnov6U>{>q
zmh_ti6dSv-8)`0lOl8N!q`PI@?zP_Osf^%U9)9W<)jr%dezNClS+F5}8DmrihL7^5
z!^57>D2+(yvgS-b;)_0q%ou;edM^>-3!@^h^spP`{#6*}tu_#$2`;Z&If%^RvgTsV
zMjJwe?%7*rv$gyDcx)5PQD~8oL@;CDPycHKg7Fkh^+K5*K$F2}kss<o1g7MG<;jJt
zTs5j>1(A`19;9&882;Q^;Yh1v{MWCr<12r^HP0gY=Da|vy^-Ht`+x+cq>H!Zc=ML@
z3!AaFvpJfHJTDu!V(O}JRKgQPpTCw%nKWUK=uo*9;7y`rQnNy`FG_tzqSR+<eFx)e
z1F_l>z6XA>2W)o$E{yRSgP!f(v3sPgI%{%lj;ZMHFc)0GaMkU!#h+-<TwnA6;39%C
zQ)}<rVVgV|ORf;@?iBQf!AZdDk44y`1LJ=_-no1)jO>%mHUqcGKyjOyguT~7%UD<h
zJof<Lc?rCTCiR8O44g}<_dT&;2`nrelq*|lZq9~;8kP?GoxwOvLV*KNOQ%9y^pGb*
zLQ;X;a`SkM#wy99s;yNd2&$>pL>y}G7Z>mn5RBVpclaqf2BMn~hfB{`*7+4KTimtz
zqX24UkKC95*Ql=atR|EqT$(N2j!ZMiwZWS$MQOa6rvrSq`2#SzN_j@#M}^y{+gGgn
zy#q;>lkA{qo=bNZ)p0<@$EFEwr~e^*b%)N2m{h^f!GpNE_{_J7b*4E#??16`nh1Zn
z$xdvcRX8^J6#0F5@Vne)M5uG3yX6l_@gFYjh6MP&wa7A?_Hme1nL*LqWNEf&A!XWW
zW_tA|JPO-o_QzJ3Ktp4fICD*&-?h_AP~IfzC?j-i+>NI{_<Q+(sb>2fpgznxQT6&(
ze4i`**ahFkzs(e1*m|Qx;p|y(NW66zd5Y2;HBgX1*rDx!%5rM^5;5?33$GC&R75e&
z_1kcH{vewAwy`E-V<YUZqCs^n+9>Q4l?yHqkC0|TfKuNwMaU|1oU=kS`po1LB}(DT
zEPVc{t)j%JVN*=!it8FW82J>aBX_yX_-d!OocGvt#X7SknRL3OZ6U`(B}G#vc=FTE
z{9oL=a>y1(iJg9-6|eH6CSvY)&$w`n&<vN3@ov}>MwUejofNb@zf=X)<Kl2ir;QQM
zm}(>H$_Fs;A`{*I3meCewxW}KFS78GD&c__qRBVy@DVgX><*_YKwUZjMg=<QP3;>{
z^;iZ)auVLOwgJtCbuHQMa2qkg!`~2|>!IL#U6zpy_%_j7-eA&^eV$O|<tV={)0Dxt
z7RIkR5ATmZfj~d_4^euy!zsW=t(0K{4Ir|^3HOKRsVI+3-u(HQtvGfxET@*d8+K!>
zor^y;U;dWCz$*EQViW@sel1*xn1}G_tnAL9iP-0r{Zkv=X`nZs&v&iwo2wkpIWm$+
z5H^4C`wtjt!aZZ(cqYE?)T_-_yg{TDb|#M1epfNl+*&!cgYnd<qR~(k2%-5kI~roE
z#iVf)=Pd4G$6S_xi2{51vs2y$R*G0Q5)p^!EfH6!MPerToiVc{ao(FFZ%FwWYjjTL
z_qW~Y3!vs%%HK!DU#XwmM83l7Y0S_8ZmLlmk51j>hQzTk>0WrV<KF0`&2fMpg@~Cw
zP(VHKwpxD2e@aGSjx!_JlkIX?UJCPn@;uM=O~6_Z;J4z0dZ3mS^hnHfmdkR;u!zl>
zL-#rkgOMc|C`*j|x8@2P=%uiu*eNI3BTveX<(oS<Cr<f?o7F{{qi^v=Qb~%=SIdR$
z=8)QgGV6S@nJ|15?Uca-@vgp6+VMemG+p=l+{HwSgKYGdq15qTw8(<@-M+jCmk8_0
z2lj&x?4OR@rq^lNp9otY&gEC_n}Slz<Oo&scE(9rs7DMcmg~iTWYJ7i-<<hShec#J
z`s%Iwxhsf2UG4P$;Br3DmA2GBzueWDGxJ^~>7S^tlwSq=MXK<16XK-1+R+ha1Jm0G
ze8eu8_m2Gga710WvHc@<^%|v{NhOqEfz6VAB4o6bf2-73Z^WX4t*mtco7Q`WbPag4
z(M&ew>GZX&E;&m&_d`1&wYA_EYpUJPY84oSjkAU$dR~Dq-Yf(s?Q6+!Hp9XWnNGdI
zV6!)5e=LIxCpg#1XMh+m5z!)<qyWYSoo>$8$tf_nrq0u+^4B=VFc&;@AbTIIlElXy
zbe}#S8XsY#+8P)a9hJs*wSi}=KPvCn&9-Y1I1faY#%NRW+m)(1zONCUw=SJtpGcBH
z`k>PFMXLw)k;>pxEWcnDPVd$){o)#tRNGL^cvbfng;l#YjQ5<aP0VV9lfk_H#iiN`
zk~m;($HVq~A0m>BUE^3O9c_%qs-KJL)>91X-uj@*-9IUuaOG)+r|4P#?DDF==WS4*
zU5YvAo6uzkbs&~Qy!%)+%)-NY8S;|c2XT*|5q>B%d$u^j%T@3}yC5LAE=!}$UsmI1
zcHLZZ!9aF|M;4Fl+J~Sz+w`P#xR$P@`+U*6Sc;opjx;PNtIo;m!Jn`2Bc7QIVqhiU
zvlE*@#yM_MEZ7V<yCu_O=~9ug<u>q+)72kUI%JT1US%Zo;;g2lx14K!*2%4Tm&8_6
z{cOj1xQzp|F0Q{(h#If9i2iU2Of9?%8z4?v1I5l7P>tg6c+{v#7dGEzg2KgWVr^}$
zJxJ+JE^FbhZDLFtBaP~cm$f#@4j~`G!DLuYcS<*vT=68@fMfoJ^qyDKyZ4PtoXaJn
zwWX@1<enHfMN&2&w&+0eKqjd0;R*$u8VrmuH6j;E#do+@qhz*gyP1zvyPHIf66vP*
zRM-1euFM0MPvuc4`|Hg5jo-%*gUsc$pB!jF<n!kS9Yc#vIFU*l=QVe!!@elpyv$F(
zBKJOYxQ@<Ij`dMrkH6NI9ZMv3Q|73Q1Z8EtMG6o3y~J%GDry&>m9~^hPg+yX3k!?!
zyTB2c{Lh2eT^$y;>9a@FslN}@k5c$qE*_Z5Qoy3^QNeruE`09fj(J*x1cA8^1;n7J
zUXyaLnLFi45R)^rC<!QewQ@}q0>H*nWR;WI;#5HI^V4p$)ER`g_f>gnl55*r=lNXY
zkzWgxBj9{aNW(+PrBelEEXSY&An}l(yYR;eh;wO=I`v)qzUV*vTqk<vFRfUdt2j@^
z`s2@K46^>!x{UUx(JjSV+okOziB*9io^C4rGQ|dEcKHzczcT5!H$QG=(yzauY5p%)
zhYLw2+1p^;1p&o2kGJ=gtwp8nyngef7brvv8$aCNvDduWy!-}r7%niE!%4xx!ea3H
z9BK3J%$$ZNV*Ea!CTS>0qukdO7NAd@_h<P#<XRbNI6mx6(@k79MY>SSSN6O7ODxB&
zDq8cHEMu6ne#>laOZ}*8s^GjG<0MQ^D+VbUJfAxA$aY-7IE)Uo5(r%piSRLHfuxeL
zw+`hn*y5|;i9GfcH)MHbC?GW@MCx?n;qKUVXO$uBd+3VIRpr`6ZGj{^4#zYN^5e+y
zqCM5<E#N+hGX6@EmKRlb6Ei&=Ww%f&(#G!8CrsL##u*eY9|*w)arNl(U)#k;Wv&ET
zhE`rMqsJg+C};|%G>xe)mc6Lxn#G({GmSh}&9j%Kunc^!@iv9#sZPHqJ0z8_8@oHn
zZLxE(DEye$LB1YTzj(GUl<H$T*CWyG@y_4^Gu7*@t)?Rwko(>n<|DsvaE5Zc$WiSb
z+nHIrNE8mcnb5Yt0t1@yW0F+AU_m_88vng_qT5t4kFv)voGVsc`AUqJ=voDJ?Ox9B
z>)29(VSHO2+tM?QW+7Kw<{@`Jfop=HvMoufj?T`+d@MN_kiYy1L`MT;1f%bB#VVsC
zleO+fPUNrAPg)B=LirB(wIV3fGrd0v@2DG+`%OgYfU@G;S<Nk^6KFT#_xtCskF(+*
zJw{Nc{cGNIl`O;5{g;1pn+4_>6sf?C3uazHh)P|rwTHnI&Kdg}b)Jb-lLy*6bYmAl
zD^g*otMW=nkeq@M0KRr669YZMRYGEF(dR|aYLOkX*~@pp(=}AM(bdFhh-H$6n=j=-
zbo|B8v$ylmlZD^x;y7nb)a9buXIHe~5u*|r1q1+oNp~_?iOX>i$83K9{6-H$@qw>v
z2#rk@80Ybtz5^pal33I?x9MozdO=;89CZd)<(o%XAk;Upep2_1gaVz*wCi|77W6M}
zgw@SYVe(p#PzV6U8B<_eBL4{wVS$>V(id;A6?@PCE=D6jC#?gSd>R&x*7F3U!mbm=
zZ?deIOTX*%yV}Bd+|GD!wH$DIg@FqW*q$qQG!u{TVjNB$2v(~e%ACV9_&yNns$F0J
z8g{l+$ESE)%1Yw8!6oFh8>ay$H2ju@@C+TS#$bbY;ZgucM@K2{Rn*koY(1*a`gEaV
z`52tCtFen(_X0RJa`6!|(OCQ=<cY)OU!<U~*vV%mGzb%SRbw0);|A~7`03R8<m7h1
zJ(d(vP!c$Dvh{802APQ2kFCiH6P4tq%s8y%j~s-(x4O$c<)e~q&<$5<$mEHI6-#9w
z`v>Gkjv30)#)0_p)?wu+=v7dEIdLUX*T>R6Ueu@QdiK_u^4m&@>Pu;NeN^cCFH2i8
zEjxA5<cPiVYgAW=nc`<-0J!7iDk`~p%leGvbjHhA=U@_$HHCV=rWaZxb*>a2Y#ML3
zrvVFFJuK3}JfDL+F1xxU>$vA1emHU%Mc1)^mH9?OJ5ZF*yF!ya>gP*ev6sxh2WhM!
z@9t3Gfj2QR1f4wqNq0F`xp5T7U7LwgMOKV4lVUBlUxjJ+;zXR!TnRNa3xuZ&*QO(8
z1$)N9ekwOGI$w<eo41e;F3=lY_7v9NR)`)1JdH*Z!^zdFr$P5ajJ!iTnIcyiA>}{I
z%0cDTurW5BV8vEem9J#KG}gF{6ry9I)@F_%Zu}1vpY(n-NVUnZ-T?<lR-^b2!#*lp
zxci%%xzavk@ASjdohXOj3E)UrF$D*RJvc-C_($KN39M^($i;)UD67|RZXfwxjn2pv
z`yuCDMf}}HeV1l$HFqE6Cj5N4`i&*nN7i_5K`LNw?5M71uaUC~gmDHhstmvlsAbIi
z(a+!cYhk6?rtq18ANT$E4?sb-$}|c7`YuW63cAATM4|e{(t7y>xkGd6#MKa|K_P*1
zDw%H{n1w&u4Ly39qc2f)q+I<WJt<xzVu$7*RhK}bB6(ICD8nc!BV$_INVkcM2}aZH
z?zqno@blG0R7E9zIAPUSFJ6;psFfxi>Mk>X{@$f6lvH*Qxfn>*w_evZT<FOvH;MR(
zb#Tc>)ZG!%R#1`<@=y1tWe18UtUwRFhcHuzf>O$}LT_aeJ7*HoMVk^z-x5qfHlxav
z;|T!(JZSd|7ZcdOLM@HdXhKa#jP<~qPZVWDGSR>AU9py*T7kegl4$KiNz(84bl{34
z!}@)WjE5xR*CEQBCzIVPA{}i2_}TL4@1h1}o>`~cGdf~`I=RF>A2mp|bPv40EpK<f
z1?L|4831%hKqnaLM@&wJqxE;mH0ABm_)Z}W^puTqG_RO?h{PswdwZ%Kr9-^+L{F(E
zf*vuBS0J874FV<>2DvC}c9el%p}R;dWCC%&`Fv^??2yi3W9Gf9`kB*-ajR)a#5OPx
zR{R)Tomd+rTQw{c($h3dU(Zxqv0QKBk%3_BzQq6+#1{1!JyySzIre8TnIU^kN5^5-
z<#KQ5GI*(0Tgy|y8C{iaL@(9-T4KA9O?1-y5qo^pGD?!2Sux&|9o}5()TvSOS#V{4
zpU>~Og1!p_OiZt8Yc?Dg_^9h!PXXox0lOsoqxl>f?H0O?80Dcbs8~~9TrBHWPs*F&
z5WX}~dU<GhKpR#6_u1I`qiQf}pnxs=x-dh~B|o6PwDkCu;*|3<e)cK$k9#UZm&(TV
zMv?(#i%?GJ_QP!PKK!BUfm^yGG#OKN&ak37hi(PBLf1}9y(3PFq+B!;7c?v!>#zWc
zeU&>2u{BuEE9X4xDQ;<Ipdb*N-u&u2^w3;(tp5G_@nN}dvDiM|Mpt1u^j{q1ntQs4
zP~Nqu`<BJw)P#|M5wL&qx6sf#)uT{D<G{6@>8y{8;F824OUZw34{Pn>h=s|ewvn;p
zb}!UC_e{IgATsiTEtif(@;P`X*Gdl08iVXF%Ej3x#_iLGY*P^M3$)dCB|@3i{KGHw
z5BhAH4u6weEO1xWF>-W_atBP&b}A7Jmp?P-+LWo+sLNI~AFAvR{RItE6F-A?EOkEQ
zMgCkRgO+G$mQ}TJ)EvttW%R#luL^c6!!7qsy(&&!^tg2XllzkY@niYT<eB(R6=BeX
z4kV=3MBncr_3-dWx{l@CvOWbp5Z|vMZo4VM@7H@49pN#`FGh!rpJl)<!}DwZacd?c
z!nKZZtN#$)v;`}ap`5gHK{+rqWL^F`Fn(&_dQs|g44W;AqU5#d?6tYFXImf)do*{b
z?VjW6Tky&QT-HgP3xDfogFUutg<Ed+pS}+1CEI%5p(b*A$#U_3Gp0?N*i!`Mxoh`;
zU{k5z=EK2sXAi3!gC!qInTnm%gZ>KD?31TzQ3N~sDa$;0xTeoi$#ir}zsM{xRw<|n
z-!ly|LiLW@b6I*!B~0TPUNxT~GSK@Hn#P=>6J)G~p+~f5Q2+dDVUp|xQS=1Jg06zm
zb$M?g$#>d%z)W#Gfry#d=#12Ri+r+SpEo^<&U>Q)SpY6=V{glU7>J9DdzM}MdHSZC
zn!b$wPjVr%>p7RHc55ox51q?q9aT#a97l`&sh>_)<5pzjQr~oV%PFR*3ysKZHRW^E
zrm0j^ZuvQA2{AJb6Li>iu9H9iMB9JzWLwSArXDm#+^gjuy6TP7=2=Z-I&n9LPZcCc
z_08s9{phB*STMzN-4Jt_xM6n;h?A94IR9x3wmzwPdJ1n;Ht2`>YOrtFGn;BVn-r}l
z*Jzl;^%^v}newP0&PCRXNy4h69Z&G$%uVF__fbQqdLb(ZRKd9UMjisnh;)TV`%%Yq
zM0B#Zo(+C>hjB6&oAExeD~9dSTUS2HVMRN524m1k2M6}ye<=84k@V8L%GJJ)zOCo<
zIX*cE2Q4^mB!+C2IEH=70{&5<y>XK!#RAP5dHh=<hx}4u>nd<HpNg2D;6Mdac6u0)
z_NlBR+`XpDv=b3TglBWUGOvXKjGovy$Je`58hSD4z*sjn@Aq+tXE3B_AYLO5WJ4+u
zjYf*{A%sPb7fPEyDG@S(ihPj&Ue^3qaDTu&Q@6gcdt=LgM^NSEW9q#fm30m5`7H_x
zuUkUo))o3Pa^(s{5n25<AFtK3hEwI(j7Ynll#h<9lSewXUx(<wa57Dl@yc&79jbRn
zAso?sntEf$ulia+!?DW|>@bG8{J7js+Dqd<8eCjl2y_sW0$ow3bA)wp2cIiwXgCIm
z`r^%5%zMw>01VUwd~sSoyxA$9s;*NEvU@}8Uo&|DQL-R&tfV{sVyIu&1EuDB{$tO6
z5^*BCcz#`+y&mCdHs7f3_0g{5dihgeqxj&W7lzXmv2LDt>L>HDwxEl~Q_vv2Rj?C5
zmc!ZWjmJJ)s%QjVDNFx-6`gcq2di}?{+x5dIlBIdkR_sSL&BU1N+uBBPxZnmJFi=a
z<55`p1Cj8yeJAA#--A9zdp6l8fd#8Hvy|D*>W0M*FyYfXP~oVGk}gs04`HHH1`9+r
zaQjIShQZ`zjs1IF`hXwzlJn>t6GL%RCd+JvWayvrKqX4i$XkPm=W1+xSU5SUBd9+Y
z?792?9=30>YDx25>|`#j`%%EP=xH{0L%g8Uy-4f1Tv`{H|NIHQ;kyG#&(r2dW@~Of
zi*kd^sin8k{UEH|I`t|9ec7$fPeijc2AZXw)>SF`T(=4|-PQXLoqn(GZaoLbdt?lQ
zI#mci=p{*;KMxqa#KFBh4+&gJ71bslNQj!aqVhS*{BZM0Dp2I9gJfYt+O$|FhxDz#
zWM4Tay!vj?<k56QwOcpQIgIuFy)TRDIV)G7SS+^2l|iep`ZFlzK>w*uQ*TyzCFEcl
zyCQWZ!VQIbil4`{RXdQJ7s`P{fLi>CF?0t0z>iMnSta-x09@C9xZmL1%J)DdhP&~d
z>G<qx7~@~qAck-9*tfOiNv9++s6&CQ#=ZOw5abkg$Itx<EInmr_&z$Y9egSWw2%2b
zuMqD{v7rNgE}w0PLhWzs<hZh{*U<|SF#HUkgN#N-_Dj0z_P)=pFM=m*1-*p5qsDi>
z+{9W&9t0`Wbt}2PvEo^BUkV$JqeE5^8rCREGw8c{Y<2zHSA|h2g%9FPjRO+{AA2PZ
zmyX!Iplbp|E&n?lkqW%c<v$Ox|A#A<bUdFiRtE(O<e;9PzI++l_(;kdicgN}fp_3C
zq%-8Po|^BV;iU=L!b&}dmy9k_XWp7hk)Fz)TI+vxTM6Z2Jw_-<Nb1ApwZSu~>p(!1
ztB@?9Sm)uO7R72Deca2q-epW}6u>uM-3!_TJ7EmS0^hBb)IQIyplmP)t~zU}tM}yX
z?BWhXP5NSAi^DcF&I`#?!xKb~Jgwn6GxKn59P`Dc0TtNq9xC@?d4ga<1^{AW{JDw!
z2G0Kjh?t?1{;k`H$()S;w;h%ImsDk3Y585vjO;o?P_?8$Kw7vHYfcJ1WNVUgRaSjU
zC%#pB?-$tnSG(mJt9gHsV=e(f3&%`WLs6==<?wbM>V7|^-?a&BpR-b|r>>LOr#h~_
zEg#t~|DYS~y!-ok^VQY@%YzT%4NjX|oVpE$vqaCteI;0S{#sBA?0%v!eA(JOa|x&Q
zugcktk)|5{J~z495BxYN0uX@+h!4>i$Y#Cqwzl7n`HjdHoSrW%+lw!j@t?qfMB7d?
z@t3$T7pTQP&n+8tvoRSZVt1AUWnS^v(>HzpCA{*zj1Q17XYiO<X;d~}RBoVj2-8DC
z&b5U)j!wXml26u5OmP#8U|SLf_zvXfp8KtQw3}wFjEs-Z|7Cn$Rpx4(J106@{(gO^
zm)9-)34Y*<^OZ-}R{<EF&3o?F<RC42-IgKX5f7?0jXtTtAjShLn!wVi`@`c^wMN*c
z3;RMg)q~oP_%m-cb}!p{;fMf6Z~^eGlpbs}bgCUk5f_#Sm}l#bnoo}D3;*ccx?;BJ
z+&E_<urvqd5@j-AL~iccn3&fH2Y_mcMtSs!nA)nk+8>SmToKywu5a-<Z7Nk6j7Ew4
z_?ExIFLS`+ED1eY5FfvLe+Dh)H%R+8dWbRr8_M<c;r-|SAS+sLzb~5Y;GL~U?6bxj
zox^E(N`+ViiPAP<yp5%$%y12r%HE#30-KDQgV@VS%P@!3l{spV#rA^LKN|n4UaHiW
z9E0Bx%d-C`dwx@%47Y%8-Zfea#Ne;kvH3uJO3vSqML9V`V~5q~oS_|!j)RXSbz_V}
z|00?>oqH>kx!h4c=(G8nYoS4@b@0yGACwZhD4}$Ge5+)#Br=7kydI8I0JxZ&m@)lI
zXzGFS^FN<_VdKLh<@&<0sN~@B<Q6n%{OyoTG=zXkRvCmkE83r6<tj&)0;Q^T0;RYL
z-olvwoyXTjI$}bGTuoWKM?pvgK}87AtNo>0_G?+_Tlc2Gd%5o~@Ab1C)C&GP<X=eV
z5jT9J+D<W0sP%!<feYeEa~Fo+^XEguLJM#bKkj*tQ;{97O)7+^a=OJpLYX{AiwyEY
zFTw|ryr5(+*$g^4&69{H_n@E^=Df|%6T~EXdL=5WNc$ZM=OQt1H<-OoGX2xxaNRK*
zmE%4e^mEy{&~iZT%KBG+?=^b6`(@$~#(1*9`7tgo3+Oy~chJrHeIDP1<;FE!wALWm
z*%%JvrMc9*jpFs*i<ysBOxXO(SpZ;4tRFLBsyjVp{5|KB5fqcCANJPbq})tt*SoUT
z*--1B5?~KixUKBUjJq?_AbEqC+1uvrR$Nx6j5EAvOd;a?&|&jm^-TS*_8r{{SYJ9&
z54qA=fmRj!aWdoNT@wBbGs`C*31?ndr+obD@MPY83kkD*`}@!e<nEh}TOoztblnw#
z;X4upaQMG9OSj@(ZY$8p0IHAk=nO%6#q^OFV8WX$&%@#TVuVWh!~g$L_^H%?$&VXK
zjz0_Z7?D|im4=caZB^tB|EI)(2T`d57Hf>XL(4lnA|~h+@-5>?;HE7+7rojSKfl5b
z!zXt-7CxcfnX8n%LG&4Xe0|2qEEoyuhybaWDVhusn560hDX~?63Hf3h6K{Rc2_CJe
zCRoe@>fb0y==Nty3RMkGy+xw>7%<@k897ivQk3f|CTb6W{wi>mwwe~ifdKQn6Yjyy
z-*a;O;y`uQ?0}3C+<S;p8$-=|v7F;@XN<N}zEvHypaE)c$1d-HDuAEeoAN$~u|`jh
z%J)9qLzhHh<*HIEeH$1nd@(+wM<~_Mb%UO`f2(jJbYnaw2?>^!U(_QrKq<n?84f7;
zH3U=O1<~55Gk8C%g|x5(q0y(Q^qMorF}_?7e6i@2|1Zgrnzn!i4KTqBhhBEaNOc3a
z$)H*=7KAB_LP#imL@LnEsR@EY&yi$-^CH&HxMDLZifO@C(SO};JijE1r+W8nVisU|
zc}35Bl_e)2X}^Se6Y?6U9-*p7?GDRNbKbffES3B#%#Kr{zC<9>2^W4>pLE<^z=)p1
zjBw;JJvmI`NYXcL)EiM?Rio~ut<}F=3KrXLFEE$AH!q$SiH&MyEPb=_?|{nV_M*li
z^6gOuQ5pYY{k>^S5zq_JLlPKY_r~w}@vg=km=%?UeTYeQs{(aA8x@S^dpAnm5XH9a
z2F$VfxtjrpqQAUe-420f@`29*^l+FRawIiMT&yC&j%$4YmYvwlqQ8Ylv}u*<RH=*n
zs~W>H>oyX?`^vx`urb6b(lB3?Y!nDwm|)Zqn0I|FWS2crp@ph~kSK-P9L<sGR7>7Z
zUEDba>22x6V+RU(2%m#p*kS4zm_zu8+>R*|D$D~5HEAP~KAaXRaB~y9FSM7|cTaDx
zw0Wa1(s9Yb&khzPG^N{ou+!t6E;SaC&%VLmQ?}Lp41?V!P8-1rgqJOgJ6;oyn}<ZN
zisxTkHWt`*bv=OM(p$}62-r0`ZFXB|@Z|kFzsdKK$91AXDpiQv9O-T|aRKXv&XA_n
zDPtRvX^6k9%xNj{2K6k!Ph++DjC1epTlw*y<QNGc)k5X`{=3>CViQa;cI#6V9XEjL
z4k~`KrYPlOX=xQ_YA^OJLOf=L_yy;y$oXA`KmyBcG3#Hs#rZ$NW7u-%!r!Q>(KUy#
zu2;edBXvx#uGdSGm?O+OxlQuk@1{&gF_?R-*O?Mh9>1$1ze`~%YxIvlYlC!bCI3FS
zA8O>Q`D0)P;~>JO$&5A(GW9Q-&NGP0o+gb};(m$76p3JuU$5M+{#zJQ?_^^83ss77
z8+V($Wj9GlG<+oeZ*vN*a)-e<oMV-?wn0D92T&#~>*}sLr9=D3a;Hx#WiSdByyoXr
zX_a0I0qUT;|AE!u2#9wk>xxa%<j+|qlh$XeEtsr-%@0-1MoGV4wij{*c``NzEmBnV
zDhO4)p~W92i2rKh1p-CL{cW7v&3Jw<R*|TOqgjFau{v4A)81v`=9?SGMEYRH-O5BU
z+pRBfx}Jimf1<H4SezP{;+wxq&DM6+&fo2B>dAe`%sZ!xdS|#jmt(!+o<ndZK>Td-
z4}x{#O|#-(vH2jmi;=ahs%3h|UGV3EYtccsmPXj)a<;5TOw32hWw?w^ws{&~P{W*E
zeZ6l}Mf+=zo)K=X^|-vb-uHQ0W3vf&`~Z$sY#~{2s_~e}gxcazt3UCD*%w8P`yFqB
z)fsH#O$9B7C~F=8*2Hp|_V}1-0862p&0dB&CJqxkWyQ~P@x?hdJ{@YNtaT=?rTi3l
zR4Q1N4)S8DSn)szBe#mlU%vc><(KLfOCcM%2dn7o`g|voc6V+NBvsS(@@%L6tPCR6
z&U|a4a{itr`Vup+V2Y~4DO~;JzcYx^eJ!npCMML1nAm_=wJigYWi9SXk}$ZW^RWJo
z@U=-Ml48KCweE}_nYFf?L*?RDz*wjWn`I1GKP?YW6LlR3fcu=z&8*;g&p&Yc)jGZN
zgh^$5Ccz41w&??9h%Q}+a=IO`nBGor*=C#qoX5^;I1!x>C}tDTD6&tjeuU=adC%6c
z|4yX_D~_FEp>%!T8oIU$){6<(zez>E^xQ0@DUe>ohzeAmPdV1bd+grR`+f{o=bOwr
zl7@fNOsR?>8ySV2nGGWBR6|hKhOwsSN|@;;O_;5Bo5uM+6;fh`r=2?r`x)@=tm(H1
z91jKgDtr1bWxZ-X?CY264#WK)#jZ==rt}Ro5*(W=?U5l41<U*YG#{W8-@U8$*d%p`
z{$-jc#0!(~atpJfIU4*Dgh2$a2O00x`){{-zXZ>^CqRWr^j&~UH>NP6Q%-{*)Qx{=
zG4B5FlmYlUCuOwTje#MTnUva*?-|mYDIJ+H`nqGylkzg^WEV_#dYW^zab3lHL*@Ns
z!b*KJL*5DkT%X*vm!BwcIKJn}1`}tSZ$WW=H+%eVWd-`L$=hV$&<ewhAl*%(3Xp(1
z%K#>!EY`Rnz&`GS{t1*78w{}|bi@jNeYZ7{t$lx!g5a0CL>h3>Lr@eMtcCux@{xH|
z6%1sJ%bFl;QMx^d#7`TH^+HeUO^AeFqYi6*JW4rWNk=@;{&@lO(U&`o)QO;I?^nHq
zHg4%bm3}=9Coxfz`XIvjf6><Qz7nZRt)aeZry>>{Y<{G8y#)j5F!e%lL+D8IZ9W4m
zSBX6wN-stU4Khurn*xn)AsOZak4d#1dGnN&St_~gX82-#5LkG4spF`u9}y?&sMg(H
z%p{}PvH!tp6$U_287#C6x`M&o8G^^*&jyH4)t-L$ehJkBvx)zUa4u(EL<r;VCkBhY
zK=-ylgELQ!FX|p#FQV_qNNV5zKXrY1AXMM`|D6%C7s;NXi3p8-iA*Ynq>@CGDY6Sg
zNXbY@w!zy{Swh(=ArzsZ>{L{g>{}>_7RmN|?(lwpKkv`?`@8?RbDeYVIp;p-Szpg{
z_b%l;w0@YW*Y&L*YR?${3Lc+2oYSnbGtSs!H9F|xJ+W`-BY=Z;y|aBgixfxN`vU@z
zi=`uMI=)EowP&%0?W4)c@1oBi@D(h6;YVG=2jX6)?#f9DT(V-m;!aXG30V5SCG0=O
z=8^E={|4gloj3<FG%wj;xlhpHIZBpjB)R4MZ6(>z#$TIGlqp+eg$yoz?zVmq`YZQ5
z8g=Nrd)w&PSme!|K)a`0GrQe+c8WZW$?6ob+`WgBFEJLsYHSKymfgj@to~JhV{XRW
zu%q&)TesR>H>Ps@lBN4_=uc(}ProWI;P-B!2(ZOucJ4fcdizgKRU17GEVKFaGBw`e
zt0?%B0%n_}|IBl+{_yXgd8;;r=JxGzn^j0U6z9971#!#@z>m+Ew+N)=pvi_WDx0QP
zWzL=57j_u&e*p)s<iu3j{mySb@19zxHPoj6ZF_FhbTRw3uT(n<%79EB>)7%plRoj5
z-t4UUBlMFcBP(%6*M0hJkKcmePBvckP$KVHv%m4~e5o6bqy)H$3hsIcDvPhl`Hxg)
z<M_PzciJf!gxZ9fY31K)UyWP!=XQpq&qv}X4s<OU1o%z<wfkb-sIahbhu0MA+l7Tq
zd>nCaAw;T*hDa}{H+DVQL+Sd=oq&d3T|yncn8&JA%yy$<aCFw0h=xetD#+YW6i89+
zE-OV1YP|$onX!YFcWQ`^mBBUUrTb(*f>g}v;=3>_9yuA^zA8cKLJ8K_=H|7NW{1Dp
z5^Y~Z)TBDj=PFTv@E$lj$5`4_2AqF7^lH~THzsrP5bD{bo6)SP6PLc#Jo`NHDXmLB
z&FG}({MkQ~KW#c7rwnhH8WwX$x(H_oaG1}>a}6)w>ddveWzM2sVPIVNCFA+yd$;rT
zMr&TiDlqeb_a!^2xx~K8pjtohN%2Y48J&^6G^oJFXH<HI*Im5#XT{cpQE8=j0S6n(
z&@i0cCMK;h{P$-{7eDpRl}zUazWuBda8uE?LZSS(<kDvsoj>o~FYhYn{|N{geXi>5
zdH=R6;|Bj_SNgrHj)n|`lUd}jK)cL0cQePQURZwpZQD|6IG1<U$<tBK?DLg<E%>{C
zXBF0bVvXx>cyU&%W){-$%u+54O}S)V$f<Bcx3i@|OGt`cR9}gBAjRZWl?M?h_06Z<
zbCy+pxnArpGxtv4Js@xOv4o%mO2>}Gt0&|fKX0BFxGKdu2WfkK0494Dc>c$tXWw6s
zA<j?=h<ALRZ_cWtH-2eg@N4@?q0HaHf%nU+<(=DmyZL%DLD@RYIV{JQ^vK@NG7sK*
z21ce~$y!(;{>Z`;#Sc+`hIi`bNB((RS#<ubHaLJvrQdIMuo-R@+49=c`6CJ)q`AEr
zyO<C7r}U$SI}bxCjpL^-d>DV?*3!7K;^DJpmY-tNF$*8s)Z4ng@2u3g`*X7Zzm&E6
z{f{d{B9j`I_PGP*@0&{4^9<CmpRV>j)5-`TYu<fSI-QrpC9BF*x2#oXr;A1_$QMyT
zcGFmgmdGJx8>Pm4<NN=|j6_$Ha-wggYG||DpQaTh)Uxs(dePM58baW&+I8$PKI9eV
z1)+FKur<UB-BpyusiV@SHo%7yA?<x*3Y;h_&CwURmu9ZDE0V3pb_b#NL_Uzej;QPI
zck=)Hg2$yPVJM&hWe7@+GZ8GU)sf_&;h_sHsP~pC8vjI=;8x29ah4=D#D2hUuxlFi
z;v$;%yvH!73}G{Hcx)0lX~%HY!p^9jt-dr%UDlMpH>92cH&{wt$<sdR({%SwJcj~7
zYZF3L5RNlR)qLRF7jRrWz`JwYF?4ikO843B39;}PbaNFx+o4cp>|m1KvE!kbGTI|r
zR#vWKH0fl%djFr`_6*Kji-(THp(ECGt&bGa>g#v+7Nl+?xN_2j8Wv()81=vun@8eN
znS{{R^&P;L2me>u1FB~GVx1DmWY5>S8;B>q5!ca)+OO!FHDcwV=?2!H7~F#E{1<Xd
zDwfQz{R(N6isPUP{S#Ei2wn>#!_7YfFN>F9Se?>G+tZvwv{U)#?Yc$_jz<7G<j6{A
zlZg9#9ymg=h;il#9-VTdF8xClKlg~~bO5@%q7)$Ak=z>)@^O}Dc}*?dCLJo9noxn)
zJ861jtlT$0$2aA|Mc@2$;WaZRQlV>hp<;Z%0et!AM*^&nGq##VaMBb?a%|;u4>)YV
zD6KLnl*P0TNv^M2nJT!NuJc28%Z+X$t^zNIoKb9eh$t;B*xJ-ms;a~w?21Xk@y%gU
zq5aJ}t#oHQpXC{4^>u<Hcz1^+Zk8p`%q8gjtWg})14AuH)$TEuqb*f|LZx57Y0o5j
zfrZ(ir8-3t4IViXzjN$+c%+l(2EP7|p=7@@mm9mvV9rFm>^;Q=ek+r~pI9XO3tBYn
zp3h^J%<SGVnb!r~3%0x*@BFt{@IQxqmp}%@-XBcC50Gd@7=3Yt?X^7CDK1(~<KKm*
zBF!pNRb|I>QK-<Xv2zLX*Yjy$Sgk^MUa2#ml#MeuXyvl0NAzadne?MBofq+pIy+ZT
z5aR>$-Z#=&omG3PueKOcv{VZfWkcV^UfsX_7n-hB+j5~2t!D6{%A=O9D>b-LUaGo*
z{cQ=9?ioDqZ|;+K$<43dpiaksmu-vlkINU#%VZsY$S@&g$K?-&94LKS5%zSyw)Z_o
z4XR$#DPQkfP+Q|5T1+l0EJjFdC!j0N@UfYj$dT{@WGP0mC|3V%5LIol%)Su&cp~_L
zbGTXO0#nwGdhiTF8K}YL3a|h#K~1Qv#0ky!cL$<IJ!QWue%|6<UgP1)-XNXBp3+`q
z@Ibo8$K1~#j>k3*>)G<+?xh6hgLsLeH6YQjNr`T3@%0Z6kNErMzkF)lHhg{$hRmk2
zNhOP0hw#+w5me(bpE}2{vOD)9r1fMuzdv@HHM%5smd=Bs*rTtnCQjX{to;5+`3sg1
z`@iz(`Q#^1zbfhRRn^JP>;z1fuXMmr)Vl$&T;nYbARoT?$PMILgiQ~j9Icq~JEP#H
z%tZ2!$r+5HLRJ<Q5p0Dlr|?7$LhJ>vl*#Lp<^vx@->6DL_#Vw){~MTjn7GFwYO;2i
z>n{kDu6TSR9SCatxMESoCns=(fg%tSjFjujFo}{&Dkfc0oH4d^JwQvIwQXg_ske7X
zyy+g9&V8Nw+;)dqUWe-Ke)0G_&N^?m>kuvmvp5H8G|g<*pa3i^;{(<>3w1f4E9+;d
z2rg-lTo#!xGIcN@NJ~OJzK<vU7w-Ix-Nc`FiSH6m3;f6B`5R3>KeFTdJ&8Wb*FWEq
z*<#K4!LsYkOB=Mgus$k*P@M9%RP*H%j;3qT?)|;_R+|1*sFO7+{$!pF*R7V(eh8cj
zTk=qQ^bdsn5MC}_ZwOV(I-#~u#oWd76_ZU+Zzkam)#qL3xX|DEL^d=(dq`>O{dxPc
z?!q!Y@W_>|tOz09NxgrzG{e_q@nQ$ZCISA*gyW~ww9eVlp$Ow`$mI9beL9~#@4p-(
zkW<n(lv#WAb15fy!#j-*dR{i_hyy@`O}osYtp0HlVaw%u0m9ucIviZ#`>+Tuc4pGO
z-83%-;FzQqX54C!5t7(5Pf+NUB)Rv(@APjOxtP+F*CAvvya3e>^^x&r1(Tv47Wog^
z<RCOvGZDAzcW{um!^Jc17;`a0=NGVlL_)h4Bczuo;-r>hUD!~5Hl_;1irN#^t@~5-
zh@rIdy*Fo${)HF^Ulb+pby_~-l?wk(0Zy(zplWQriGv!RJgDXQr&Z|WF*8?hK`6U&
zCm`yu_pw-$bS;2UWkH~mysn_8lYVFq_S$gFbY&Kb7C>{Z+A~1p0v0Uir~7oJEi?sJ
zD|H{x|Fz+)n3t1L>iue3oXF|LlAUC3?+EI==VKTx5vwhW9V1dOV-9~FH)Qi{Kxo5H
zj$#m{wxS=m9z{lD3N>a&5yWfQggJ}$9!m)uE@ILTgN_J2n&gTpf1cqRBa8}EI0^~%
zXb6UWr@coE*#NOk_#qWF_7$Omg-G+vd6m-sY4?I9S~P%u#u4I<q&8HyO5GhGwc}&6
zva@v9zWQCq7iUs^z3WDk@}A^E*-uDr$qt_s2TSXra?Y!9p1?(0^Rk4T7JEbKQ>}kY
z;w&1)Knk0?SI(EUpGF6PD7`51PHUH7oM(rsc@tP0Y!@E<KKj?CAoLnlZIHkb!9Ct6
zz`%YXj|v@8Z#5jr%-~&y!E16g5`>+wh+OChmMWTP#IO1IUf0`;RL+*E1Dpu`3cRbv
z(|KmGd8g26Zv;N5aq1;;2=&q;_W_W{*|1<kN&$5Vr&^hdMDAzYer(^EP&|DCD+u<G
zYe=Ljf~eI-iIqJ!<XQk3Y$ag}D7ZL-{X8G)-^hM}HgGS>CVm}+BoN0?0}$M{=$KcR
zUDx!KWWnBCDZLhkF^|;mSI-Ye{p#p}rdGp|%yRG{#)1!K1dFYb{rbnv&TjC1Gj2>i
ztKx%@v8ZDn4ipQ=I6>`y#tGvdg7n3cTie7L>-Zg@!tgs->z1w_+G1=EV@^~F#~p0%
zSsBkDW)7xdwo~Z4NeUM1<tL%KRgI~tWSV%K{*e!x!!|c+H_V;|xG+<keV()sly7Kh
zRZVc>GeIca{aEsuyuNPHk1K<B+81b^_SGv)q@C5%RH2!+R@v(!2!T0IYEabwQ<DDl
z-ul?QbrjZqUwY(kdn`isjbuy~K}?69j5;&4Ku}VP$64*A*5JNsb>ZCjkj@Smb=hC@
z!W((w?1#Rsj0I%b7Rs1-<77q#A#!1T1!KpnDtXb!dm5C%Q+D1cI*)+xEQ4N(UR(Uo
z#H8PV>e^7tskNxL3vk3lcE{If+yl`+FqO02=>Y3<PhRw`B}?Y>ImMr#1SQqOufp|P
zPPSdk!UlV?XCHJ%SBk1KtjTkumcvMSC>I%v?G{T$-wA;~9}0sBN|f$GtJ1+MD|Y<M
zL>FCsGl~1H#1V9lBFM+VgHp(d=&UipqC1X58y<mrVz9)Q8G0<icje3Jww%x#LCV9=
zZDgE$%uqD&8MUVb*@GJ>nKOopP=920C!H+6VLdPpPl_Mh2zl^3yi(GAtJ@((9Cqvr
z5gCMJey)r`3{v|dgc1E>^DFTT(xEZiKafgRRX{q8JOFzMM=|~WyLFH1ndv9~MMiW5
zzoqqdoF`dnTT%=QccMh>l~tRfon{#nIcR$I$AIyb05o8`btY0#QMMIslx+YLjNDfT
z)Pbmx`$w?uOpJZm$i5&Y;3vY^twi(p>T7Sj_zE}{LRiq?HY5wdCY0q&z~DZ448o>V
z8+h{FBnF)h?Wtoi%+i%U^ZU)J;t$OW31NLp35?m&|8hLRWPI(b8x;?{i~3^-!$f`H
zafC@~ANNZ=4T~EixfBsGEb@N+oE$QtzqAGExXR%yrKxZ~S6PcCSy*)&@}d4bt6<2(
zb(u%hv1HTe;Acy8@Oe4+)F5_NECsu)o00d-O;U)|=yu9UjgY!0`53-ID{S(58xqh$
zBxP}80pLcF$BFcPzY`I2+c?g30z9|}#<OiK$VV^jWxaHCoMfz2-n*lG*p6m=zbp6@
zFJI>c&o#~fCPRTj%Sa=CWpxX>SCA2202d;CT{SFUER;v?0fkaICCaIsg|-hkHN&oJ
zKo6SAKP=@xS%7}V+<Ih0s$c~{M1Um;hU{KKXt$m~fX?+A<J|+lMxO--fvMtPO>O-l
z1rG`n{m$!dAw(+3;UHOM3!Z#>SXw}%JSe4p8+q2xgoSE2pbyIBpvJ<CWtJ^MHZ}VT
zgWMpRV303iiYWh~9m7Aw&@Yn|k}<vzW|WG049QK&z*Ce5Ce|ZV!>#H(2=&4mW3t1z
zADe2`Zel*Aiw}9Y6&;F8W`~2rn4!X97ZY|HbUh#`K=eV$4Zsp3gj3OdoIpbzQU*3D
z@jz^mjqSH2po!^T3Wgef_z^mp`;EX96IhY(*HVG`Pl{nL(n&0Mfn05ijRsr<_3Erf
zVG}g~E3@`W(l+&7$0B&oz0l3`tVB8e=&A_u8MFA6dP}*I?P6&<9-O7b#N?kFYwvr0
z5IW0^WPfs8wgD(njp>uem_{M%Z)BB6_CMN$lTwe2A!L8<s_$rK1R_#682^yVmksHN
z-Usg9GeiS~#FwUk!5vF%bvmKsh>&!{9={mhK(^^|gS5|C(i<%Gye5R-UI4XOX-mS8
zz%=!!g!mJ~zJ;HKgob0x0z&@?=Z5sEz{YXG;_FAy#_%?GHuUTCLosj5y6vl1?g&7&
z9*)~pC|~;$C4I_53{XMH)Ipk53V4O-cl?Zl-od7&?eg1(cCdqRY%=?KU3#tGD6AXp
z5rC@Aa&OUPNmuLkWI%%vIiNHGGrkt6P=1CMEYmzVf_?ZN?MvR2Z}{Q#bG!++v_SC%
zmHALCb>jWEY=A4t)rKB>0UmBUzC(owSxc=l4|cR*$bXR_l=nobm|ikog$2yL#wuC?
zZaj46EiA_UAT*u~2W}gK#>uC>)52pY7~0AI{S)`buNrV&nT{AN9+kZDMS}->LZ7Zf
zi01~lFf?=y#`V8%X)qWMnF4H%$T|E5g-uaQY1V}reT6W2ATE7M&5+-7cDgai4=#*=
z#SM;di9zr^@EV?@12UZ~)B}Magi`l5ZIMJ_ss~BkGGGq`O55Q#%XA;q4Y=jO*Udbz
zItC|uFQIgSgk~B!3sin)Mg;5HXImE_=8Ox@RYH;lkC{S8h%pCzpm7}?#1se1!a5;T
zV`bM?W?5}GMF{)Na>+{Ehl<v;A*qn;0fJCN$Y?}V^l7<b53~(p5jy;OdN)BUw5YKb
zLt+UhaSUO3@Dc7DakW(huHR*tiGl6S&t5~83EA0ib0IG6N|4=*+aA*=0@;{;HJq4e
zSHQP8lt)qRzAeI<8#lKPtyG~GC>Z|Xw=<!<uy-D_CI_7c+Cmx?wdY~j8%L&3!zP2r
zlP`?y#Lz9!^G5dk-9)LGvCXSG6ZQV>Ntn@^GPKHka84609md0s=)ip-XNh#;&rOv#
z8X!6mYU+P#FGwMCg$S&yVAu$jyg^ov=-=K8n-zTvNbuo}=nIny?((u96C6UInH}a8
zkhSosS2u194?lvsYw%zq_do_r+J;fHrjdCBn1IkeR0h9iO87L>zJm#&?ZFFlMDJ3k
z%H8H=j;xaxM3Cn+YtpW?-xz#c{Y{<(bXz5_NBOgGTnwBSO2=`Oz1VROP7&fSpq*`f
zXej^?qSBw@I4a+O&IlA+MNufH?+QTAk&Yek5BO_ObTNV{ju0t9R_cIa9o(I={(%ez
z@rh$<Vm{Z4PIQ3)Vjsr}&1smoNzjLSI{NN`d!WK2_rntV;Ko}{5pf2ZTUL<^=-q$O
zIo6MC59`wem;(A6++TuTHDja{#-NniJiWr(C2;ZMvkb1^sM4_CYg$EXRSzPcj%He!
z4Pr<qOK)9RFq-IberrecP8OScUm-L5;g!zhO#2F=t4Vz@VjYo~^6@l6lxwhk1sT?i
zi{B*05t@r=&m!aTL|IYI57(n2*{Rmg&!Z7_p%I8%?H#exXC|5qSHSXgL?sDai@UWd
zh8my9*v~yMb^0{QoCz;~sHmA)3?zv39;7i%X15t7FO(U$)zIJ-ZhBc`8nB5U04!%5
zYu_ty+B>Xk+<M<3+;SLuA3$U9zmCvo_2gvBSG=IoSissMjc2tD;HBfZND5cm*RxZP
za8@mQ%<SbBn)8-!XJKg1S7(ed^zGJx)GvZ_PxUjo(9a~yzI+850^?!i(<LB#&|^(E
z2LTjUHgaWKg=|NW5L|Y$5C23)8VgId3CJCB{{;IVIb%5_!D6U5Zb4zkAW$0>Ar^=j
z`AfD&KW8CZTjP~v>PE1vupaL>PG^Gnd{X9MdcBF68`vit<<Y3}cZY2Xwi>YjWH}w5
zn^^P5@fCES@Ha8<%b+-%?bP)*Ye8GzlPo91rsPjU72R%b10K!bcrhRZZ<2!Xi$4#8
zPdk_u(;}WIz}rgZZepf4f3a?o^h8(6A~fr(Za>+ZlfWcPA&BgfHUY`m^Bsc-4LEAr
zd9Noh%YrjvgyrjeJuZ)lJ|^lveHJ(x4WGt}K?=8@8=~fYOEA_2wM*`5(iVdBxmWPm
z6Mh9Ix+vq^<ax17s{`sHOY}&_?nPBg+OXd*W>97>Mu@`BZ)AQeO5UD!A2!vNul>oQ
zVG5%;+cEcy{=~U=U1T!kix?mRPDiKbnWAQNMLAfkIH8$YCe6U6$1WW&X778G?{C@x
zRCz)3#4;-MEcU#V<|Rv*Ygs*5y$&C0Ko{p9m1j-fz?D^rLhMxhOA2-nBXQDBY%kc0
zt57FsK{TRhl@sHQL6%YNx#?H^3Yev0rVsj$dQ*ZN_|dC5x@0}=E^K_moKzLGrG4}>
zg#}h4P67W68qs?>WCFX$l{&W#A+s~sBzn_T{kl=|<}Ji$<oE9{4Im59@i@HJ5x^&Z
zxt7Qw^jv^Ja`lomb_RF>rO=&l8)%`<V2wm<$qN<f=!h!MOQ#Pq?n*=C72Cpx&$x@)
zteJ|i%&1(Ys$>XBuM!U#|EScjS+9zk&q{W%f0~Q#1uK$*V3Vurl-yg6Tz`-={Pq_e
z5h?m!@eb;abdZVgOoEQHbD^Mf2#KlSQYT}P5F!18eAEEX5RM{GO3+?TW0rnF0B(O<
z-uU;$8vC&K9Z&a`zGIgQxQ-#|DnMMA%<Bqn6rlrMuP*2@Q(qYS2dO)Oo=8s-J&<J1
z&}}p$*U2F`R*$ETbQ)||{5lwwSwKAKM`(QX8c)qyT_sp`C;)`62CSs0dJ<%dQn;5M
zAh;clLGYO3I?wi=T@W%T56wA=mR1HvfwK~2T^?m(NMY!<dF)C4fF9$Q)1EiLY{{Gr
z>DB$QrBO4DObAh`eIxcp-6K)*nI0^efU-DyH`|nH=-7F7%0bg~YhiiD9Vv{^^FwG*
z9mi_1OBHL(?4VN&-$tRSP@bV9+rZPrjB^^f3~>k5nd|F_*$hZ45_fuVj&n1&7<K=u
zh>NTF9EgzClybb@BOaU#IH=?z7CM4&ft5$qynC;%xx~AGlOP_)K}@V`+v<@Hug#La
zH7qC;-?zQy<tiy9DwnEYj#(i$81H9<+u6L3%fucT)1%bXI(D)EAK6uN=ZGCbRv2k=
z1w25=jLtf$bwesl-4h?+_B_`2a$39M`}O@Om03xIu_A^Uqk1Pi=ip(5{C#2=qA5Ix
zv}IlyVYz*d6`{_f%A<DLH;f>)GCOGdC4?Bq7zu87Tr)z&ug-RjO;V4w+W{j=1|5@b
z>X^=sV^4zo4Kgnf?g7O)7o$l{MBf8M3@!;4g{C%U5`Z)+6s$)giD&o->`lz?d0st&
zVQI=HiLW!fk7^iXUF+j8GMX1fvk0rami_!6pRRdv<f$Lb2ePYA)M3Cq_8@J8ju?in
zCHgci0FbcA9g#y|!Cbb!C%tdE4%wtdm7$DR9Y^IW1XOe9wmNvuG9^ngTwvE~TCC`4
zjj6cZFC)D@{0fw`(A*P9lI9J&7NfjXOjO|Iyw9J`dPNL*d+|%)rP!Y=$%2ReIyyZ5
zyO(vsO2hy|&G0kDAavebb@~gx%oJgRpwA5A;~Sm;HjWR=VHr_sI6v)+?tx^%au=AG
zXqs^GwOTc?h61K%>RK%CxiujHB)~H%IMrkK^J0w)2gA}c_p#9Q*CFo(d^O**eNv`+
zuX>9>BB3-uJ6&Q011;QzvH;Gkc6lJC-haInbQY#(hDNXf-Y{(hw<|YLLRHE{;k5zm
zt@na4T8ME-1h1*>&`7OWtS1xskaaI|Yw!RUQn*n>N}%xxrck=z+_l>#u;p6oLz_bI
z$@6Tztwk6r{|NoO3abyuEeqpwQUa}u%?*sp9%7(-G-@?8IOwWru|y0w@gtEnKLv=J
zZh~7;X4JkVL}t*01-YSo3LEr!Cw2RX2!{R_5LKZ@n$lFzI@oH|1egKY)657RaMs#v
zjK!w?aWG3bsAjJZ@Pm+K9HtBn4^AT#t%5hUNDH)@-v%P&p95z8<+<zLlNP(n$z@pZ
z6W)K~P%B6B#!#2gOY%MF?RmFV_?cqKJ2VsDNte@(Y5MrUMPuwCBgA!EgHrZ?adK2m
zNR%sYT4Pw$5KSNLfK~QIl_3@FRSwohh}{}LUOrSR>=qR%mvq~%j!-{%KD=_{PO{j5
zHw(3->2)&4ouHgh3ebSqoGd7Y@%JtqFgONk+sL^=rt-Ek{g)<>!h711wsFJO<A>N9
z_VfSLZ=gL2;Tchj2>33a$N?j?tX0Mq*Y`-@8XkCd2?Tn5kwq^<j?nJ4o(wv_iJ{fi
zEBX$x#?vzxggmUV{9}nb%N8-U|0)WQU3mAmYz;0ld==nR+V^xnLWt*F+O!S+Lo+O~
zx~dubOApmVMmC)D(TsEe)1&x`l>(}a;KDo}wVbv~L|cMBjo#}YS;v4RF|MGh6OG?|
z`itw&-))h_ZET$A(jvFEqE{bUTIgI>&T{p_YT^;8`fcp?b>(ap9H^2=71h5fvi38?
z!nzI_!S!)NPaHp9;LOZbE_~F(hydF0HmV(a!j&+5K{lY9fHRPra|JNNr0i-^DsSAA
zn~>l`UuAZygW<?R?OlXys1k@JZ&@AmflQ!s)KSVf(CtKG*~wT%oCI)TrST3&c^2tl
zjg#<ynhQ#y;=wL+D(E&M7Od{V_rh+Ih#eHZyf@4*1I_B|n6^?|x0aL7<3Y(otS>>^
zOq77h9ex~O&8)fDSCtg{29-SYab$7uz&QS7vm=!~v&Ji<qp^$5@|mf8k!~uEalK+J
z0avK4o?rZbffE${H-eL?WKx$7>$_Nol43G`3us0?929;xN?SNa?7?;SP1Kb7{TrO>
zWtc5C*jUqzMbqv@a$}C_Wo|CqR^3fd7fH`h>jRf|agFC-iaS_ORKr2G_b>fenY@NM
znF-tq8;K@f-iu#RSxS)UDF^w+2FUM5r)X?f$eMg6?I_l1RQQ{tp`&`>ICcFC<%`z0
zi&?f*W)G)gso8f3jlCcfAxl{&v_%0kGyN@T#b+pikeH7jK?r;W&0`GcIrKi2m;Lvr
z$V#FZek;<}*<Q8!@32OM>&$7WN=X#99H@xNlk{4L>ePtc>({v}$-E5P0(bUK66Q_O
zU{^=$QwB?*x3(_g0YP9t*0rbxSE%P_=v>Jn{p~*n2Ej_i01;RS@bpm2XMkbh999MO
ze`@@C6bXmdYM}igSu<DH<4%gMqT^`%k@+Z{w)^R=qbZEJmeY@MgZ4YKo0q_!=KdgR
znANzkaHRJ2U%IgI_=XJy8JFd=8e-y^evvIG5+X6$mkwe^6bh)oI+>ct?}Ig;?!Uuk
zb2J$%Ey-CE4#I-^rRY2bLts9I10@suW8P+#46zG@_`IWiECCE3<Bd_^PC%#|fF~06
zM>@kfa`j)62+j0@aU%C)pta!jm*_+a0sMwGTvLfjEK$HE5nhU%B_+OH@s0pbAks>8
ziCrRS!=e-QqQwrSt7wJ(XbuU}m6fN?kJgs1Z&dpl2qc%dcY3jTT##UCb^^?oYYXDw
z4z5dHy}8A^lH?WP7e}B_tRa#tduj;NsA@e2Wk(b@eYXkLP{_|!uh<R~=#9aQ2p3$0
zyTz~ZF&IqYrfwRz=)G2X7`j3a+kyzyoYZaKj_u#9xyHpHE5px{!$R2R^oXd5zg_Gq
zE3*^q-;OkD^hF|th{7?n;?TFFfA#1ixZ%cO*#09WsC%Az@^CP^#G2^7Y`MJ+^e?0p
zR620sbQ|F08$&><9z|DMKf~l&N#WtdX1xsf=ZOyo6~4V-$0=-?!U#%#5<f(#hK>`o
z-Vy9iR>X70jspoDoR>S_Q;$#?o_tXMUz4#Zl8wyqCJHILz4VXs^NWb7cdQi`)EfLW
z9r&$!`Afy;NNzq@0~6tU2TQ=4<mvqUdi9T-l_ZnumCGI958YB<$<CNtdG^L|=eN8=
zsSnZM;Tv6@-tmC_!f5%yz)PRRQkQ-YKS{Uos9~=73SaPOuY<%#*<v?R&qiQCRMGFt
z3)7z;ul&h33GkE6o0m>S_5If>?JuEf7hC0y7H)<L6mM|mG<)d28VvDQtVJWYLEroZ
zPbsfqCc@_9EC{JiW#$@()$k7%%84t99M(d_{k*oGXAzp#R|Tru%ug1IFt}Sc@Ean;
zKc2pz21PRnHe&cZ@J0QW0|6-c>1V30qyGMP;bwMxDim&jbmamlmgw5^O7qm1Qv1yH
z{S=7@LyL`Uy6;dL792u92zcX7&W~o7hU{wIv`=rc|Mk(pLoG9U-NxRPXWHc@9}HD$
z4(h??GrnrTHxehLY(MT780frX@IbuU8d`@<_n!_7^`cS2TM~oVVS$qzC9;cOi#P$!
z!p0-OB8)Mr+i?oB=VY?hgAI&&2q8G96kCCZsw%`W=uF*o#1qpRRc5}qCJ2ihK>Zam
zH=Dl`*w~P3H6a@l>zX1|ZomhK(xI$lRJ84Nlman+dsuPOo-^_Lj=jCyaq)}|qlDnZ
zmgUC)&(RZqVXlqhYGS-UXIMq`1&VMa&3t>7ZYClYo2Th4u;!&0!M=HyAH{Y}l!LeY
zSAqFdn(yHVht)3}-K^TfR4TufE%X|cAAVK@-$_BgGgM#iTJiAwO>6X7YDPSq;t{4g
zx92O`#_7g#?p=@8oX}(>f1VKUEPpS-=iTo7<6$|gpEh&P?<k!bG(-zf78r@$hf>WA
zk<lLt`ZHa;ziT@kpIY*la-LM~e`;f@!DjZE{SX&?8YpT@r|gt_95=U|x!eBn_`RRE
zHl;&VOS{xDS!e%#D0EwD!JO53+U<h>bb^e67XE3P5yZ6yFRw!igV0jDqGn#MwF79y
z*RgvROL4OAN)BWj%DwM|Lb??!Km4vJT}Hpe=8s=&c)&9`UhJ&XBiB@F5fTH7FjxC#
z8rD1At*h-&L3}4%@z@cMR@6Kk^Gbnh+fMX*i`mEgt82!^4jt@!D=@l;8zHmw#30E%
zDjyzCX%x3?6YEjE-3@J)t=i>9X+A-he{TEZYVUn7_;qEM5d-|hb`?tgk}~#%_}r7I
zSZGFzQ0noBPINLo=i61whW|`iwIT`$lcfkX+)k&6D7Dx0*K~W{xoLD#vgg0ICQm3w
zm~F@#XW^clH~88$#FWt8HgM%e{I~__NUv$Ft>W9S+}k!v?I_&k>>6d-c2lQ<Ba~lL
zAq6Umf+FyFXr8N4^U~Dm%XZb<&aSlFoc-1Pw(>x}+x2CcS}3~dQsjLbK5`IpTzo#r
zhyT9FuGd>T@R#I#bTph1sKCv;yvyV8tFWiW)>g+fJFZBi0Zb;h?!@M$dt0CeC7oZn
zjb&Er^4zM!kWlYNoYgpr*frmadFxno0!q~m4LXH&CQaUYWpvY$U-grV|8FZ1Grv3g
z7mnq)@1E`6R90W*uD!KEGXJw)152A$rxcerk9by4bTr!uh05$O5g(V8f^%YSoCh^a
zs#R1DJG@n4_HikyYp_l(`_taL_toP?MqP0bL?_@g3adDhNI9jz+JQfx-4FNAEI&yf
z?VC}0HWPhZZdD7}39JIaogFigqxXqE<zDRjA4MIK%s}N8VZs3`4@C7pqJBFG{w%CI
z7;)0=#q24}6A)(l^?ZjCv?ZaX9H1hs$#2b=s1L_h;T);ozK2I2xA)kLM|qU$gXW7Z
zub)b<#I$=puWwxm)_{J6S%(59FQMq%o68du`e9hZ9Fx>e@%{@24!X-4Uq6ZN^tv(b
zSJ$kpMSd?H&R}kX{{!~GhYz21L;crQnJYNBTXERPmAu132u-0x2qYNlf+p}Y!UpjA
zJud+ko1)POo_jc`d7hWN$F`2HGBjDOy^>ZMT~MB9xYa;>qEee7_&@A(AlY$z5~jL(
zRL=EXZ1y5WJ6ZcMy31rb-|!NBlilR`>x*U8Tp!!P6#!+-ByZws0?D1=;@e>T(dPa7
z1a0GEvY)sG+ESF4-dy;zf+>(lEZISiK&9w5@BJ3ucBj41YS~iG!XHG5prj&CP?lHH
zG*i^jQdHMcR@^}#Xb}i%*99K`tAm@nos<2A|9=OAu7{{@vHhPXcsseB_3}RL=J9{@
XQCfY7gzR62=+q4No9rvlBVYM{Sf;j4

literal 0
HcmV?d00001


From 66cf0c1b0c9452637266f4faf7077fd5d2daa88d Mon Sep 17 00:00:00 2001
From: Hustler One <nine-ball@tutanota.com>
Date: Mon, 25 Mar 2024 20:48:12 +0100
Subject: [PATCH 07/13] Clarify that we indeed have builds

Cherry-picked from #65
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2e76388ba5..3448576d3f 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ It is written in C++ with portability in mind, and we're actively working on bui
 
 ## Status
 
-Although we're able to make builds, we don't have a version ready for distribution yet. But we can always use more help! You can make a merge request if you'd like to see something changed, or you can [chat with other developers to find out what needs work](https://discord.gg/suyu).
+We currently have builds over at the [Releases](https://git.suyu.dev/suyu/suyu/releases) page.
 
 **Note**: We try to update this README whenever we can, but some links might be broken, and some information may be outdated or irrelevant.
 

From ba3539c5179913fd32f172d4002cb47b775ddb57 Mon Sep 17 00:00:00 2001
From: Fijxu <fijxu@nadeko.net>
Date: Fri, 29 Mar 2024 21:31:40 -0300
Subject: [PATCH 08/13] Use CC0-1.0 for images under ./img

---
 .reuse/dep5 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.reuse/dep5 b/.reuse/dep5
index b39bc42fb7..baf1354bf6 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -180,3 +180,7 @@ License: GPL-3.0-or-later
 Files: dist/icns_generator.sh
 Copyright: 2024 suyu Emulator Project
 License: GPL-3.0-or-later
+
+Files: img/*
+Copyright: 2024 suyu Emulator Project
+License: CC0-1.0

From 48e86d6e84c0027ccade556e90fef170c7e3d803 Mon Sep 17 00:00:00 2001
From: Lucas Clemente Vella <lvella@gmail.com>
Date: Sat, 30 Mar 2024 15:13:23 +0000
Subject: [PATCH 09/13] Fixes issue #94: setting Vulkan::Headers before Qt6 can
 do it

---
 CMakeLists.txt | 126 +++++++++++++++++++++++++------------------------
 1 file changed, 64 insertions(+), 62 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 42e8615e57..9406dd64a1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -396,7 +396,71 @@ function(set_suyu_qt_components)
     set(SUYU_QT_COMPONENTS ${SUYU_QT_COMPONENTS2} PARENT_SCOPE)
 endfunction(set_suyu_qt_components)
 
+# find SDL2 exports a bunch of variables that are needed, so its easier to do this outside of the suyu_find_package
+if (ENABLE_SDL2)
+    if (SUYU_USE_BUNDLED_SDL2)
+        # Detect toolchain and platform
+        if ((MSVC_VERSION GREATER_EQUAL 1920 AND MSVC_VERSION LESS 1940) AND ARCHITECTURE_x86_64)
+            set(SDL2_VER "SDL2-2.28.2")
+        else()
+            message(FATAL_ERROR "No bundled SDL2 binaries for your toolchain. Disable SUYU_USE_BUNDLED_SDL2 and provide your own.")
+        endif()
+
+        if (DEFINED SDL2_VER)
+            download_bundled_external("sdl2/" ${SDL2_VER} SDL2_PREFIX)
+        endif()
+
+        set(SDL2_FOUND YES)
+        set(SDL2_INCLUDE_DIR "${SDL2_PREFIX}/include" CACHE PATH "Path to SDL2 headers")
+        set(SDL2_LIBRARY "${SDL2_PREFIX}/lib/x64/SDL2.lib" CACHE PATH "Path to SDL2 library")
+        set(SDL2_DLL_DIR "${SDL2_PREFIX}/lib/x64/" CACHE PATH "Path to SDL2.dll")
+
+        add_library(SDL2::SDL2 INTERFACE IMPORTED)
+        target_link_libraries(SDL2::SDL2 INTERFACE "${SDL2_LIBRARY}")
+        target_include_directories(SDL2::SDL2 INTERFACE "${SDL2_INCLUDE_DIR}")
+    elseif (SUYU_USE_EXTERNAL_SDL2)
+        message(STATUS "Using SDL2 from externals.")
+    else()
+        find_package(SDL2 2.26.4 REQUIRED)
+    endif()
+endif()
+
+# List of all FFmpeg components required
+set(FFmpeg_COMPONENTS
+    avcodec
+    avfilter
+    avutil
+    swscale)
+
+if (UNIX AND NOT APPLE AND NOT ANDROID)
+    find_package(PkgConfig REQUIRED)
+    pkg_check_modules(LIBVA libva)
+endif()
+if (NOT SUYU_USE_BUNDLED_FFMPEG)
+    # Use system installed FFmpeg
+    find_package(FFmpeg 4.3 REQUIRED QUIET COMPONENTS ${FFmpeg_COMPONENTS})
+endif()
+
+if (WIN32 AND SUYU_CRASH_DUMPS)
+    set(BREAKPAD_VER "breakpad-c89f9dd")
+    download_bundled_external("breakpad/" ${BREAKPAD_VER} BREAKPAD_PREFIX)
+
+    set(BREAKPAD_CLIENT_INCLUDE_DIR "${BREAKPAD_PREFIX}/include")
+    set(BREAKPAD_CLIENT_LIBRARY "${BREAKPAD_PREFIX}/lib/libbreakpad_client.lib")
+
+    add_library(libbreakpad_client INTERFACE IMPORTED)
+    target_link_libraries(libbreakpad_client INTERFACE "${BREAKPAD_CLIENT_LIBRARY}")
+    target_include_directories(libbreakpad_client INTERFACE "${BREAKPAD_CLIENT_INCLUDE_DIR}")
+endif()
+
+# Prefer the -pthread flag on Linux.
+set(THREADS_PREFER_PTHREAD_FLAG ON)
+find_package(Threads REQUIRED)
+
+add_subdirectory(externals)
+
 # Qt5 requires that we find components, so it doesn't fit our pretty little find package function
+# Qt6 sets Vulkan::Headers, so Qt search has to come after externals, so it doesn't get to do it.
 if(ENABLE_QT)
     set(QT_VERSION 5.15)
     # These are used to specify minimum versions
@@ -535,67 +599,6 @@ if(ENABLE_QT)
 
 endif()
 
-# find SDL2 exports a bunch of variables that are needed, so its easier to do this outside of the suyu_find_package
-if (ENABLE_SDL2)
-    if (SUYU_USE_BUNDLED_SDL2)
-        # Detect toolchain and platform
-        if ((MSVC_VERSION GREATER_EQUAL 1920 AND MSVC_VERSION LESS 1940) AND ARCHITECTURE_x86_64)
-            set(SDL2_VER "SDL2-2.28.2")
-        else()
-            message(FATAL_ERROR "No bundled SDL2 binaries for your toolchain. Disable SUYU_USE_BUNDLED_SDL2 and provide your own.")
-        endif()
-
-        if (DEFINED SDL2_VER)
-            download_bundled_external("sdl2/" ${SDL2_VER} SDL2_PREFIX)
-        endif()
-
-        set(SDL2_FOUND YES)
-        set(SDL2_INCLUDE_DIR "${SDL2_PREFIX}/include" CACHE PATH "Path to SDL2 headers")
-        set(SDL2_LIBRARY "${SDL2_PREFIX}/lib/x64/SDL2.lib" CACHE PATH "Path to SDL2 library")
-        set(SDL2_DLL_DIR "${SDL2_PREFIX}/lib/x64/" CACHE PATH "Path to SDL2.dll")
-
-        add_library(SDL2::SDL2 INTERFACE IMPORTED)
-        target_link_libraries(SDL2::SDL2 INTERFACE "${SDL2_LIBRARY}")
-        target_include_directories(SDL2::SDL2 INTERFACE "${SDL2_INCLUDE_DIR}")
-    elseif (SUYU_USE_EXTERNAL_SDL2)
-        message(STATUS "Using SDL2 from externals.")
-    else()
-        find_package(SDL2 2.26.4 REQUIRED)
-    endif()
-endif()
-
-# List of all FFmpeg components required
-set(FFmpeg_COMPONENTS
-    avcodec
-    avfilter
-    avutil
-    swscale)
-
-if (UNIX AND NOT APPLE AND NOT ANDROID)
-    find_package(PkgConfig REQUIRED)
-    pkg_check_modules(LIBVA libva)
-endif()
-if (NOT SUYU_USE_BUNDLED_FFMPEG)
-    # Use system installed FFmpeg
-    find_package(FFmpeg 4.3 REQUIRED QUIET COMPONENTS ${FFmpeg_COMPONENTS})
-endif()
-
-if (WIN32 AND SUYU_CRASH_DUMPS)
-    set(BREAKPAD_VER "breakpad-c89f9dd")
-    download_bundled_external("breakpad/" ${BREAKPAD_VER} BREAKPAD_PREFIX)
-
-    set(BREAKPAD_CLIENT_INCLUDE_DIR "${BREAKPAD_PREFIX}/include")
-    set(BREAKPAD_CLIENT_LIBRARY "${BREAKPAD_PREFIX}/lib/libbreakpad_client.lib")
-
-    add_library(libbreakpad_client INTERFACE IMPORTED)
-    target_link_libraries(libbreakpad_client INTERFACE "${BREAKPAD_CLIENT_LIBRARY}")
-    target_include_directories(libbreakpad_client INTERFACE "${BREAKPAD_CLIENT_INCLUDE_DIR}")
-endif()
-
-# Prefer the -pthread flag on Linux.
-set(THREADS_PREFER_PTHREAD_FLAG ON)
-find_package(Threads REQUIRED)
-
 # Platform-specific library requirements
 # ======================================
 
@@ -710,7 +713,6 @@ if (SUYU_USE_FASTER_LD AND CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
     endif()
 endif()
 
-add_subdirectory(externals)
 add_subdirectory(src)
 
 # Set suyu project or suyu-cmd project as default StartUp Project in Visual Studio depending on whether QT is enabled or not

From 39eea71e62535c72eef0b41b35c5305f86df4971 Mon Sep 17 00:00:00 2001
From: Exverge <exverge@exverge.xyz>
Date: Sun, 24 Mar 2024 19:51:18 -0400
Subject: [PATCH 10/13] fix: resume application when library applets are closed

---
 .../am/service/library_applet_accessor.cpp      | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/core/hle/service/am/service/library_applet_accessor.cpp b/src/core/hle/service/am/service/library_applet_accessor.cpp
index cda8c3eb87..b7ea464ff2 100644
--- a/src/core/hle/service/am/service/library_applet_accessor.cpp
+++ b/src/core/hle/service/am/service/library_applet_accessor.cpp
@@ -1,4 +1,5 @@
 // SPDX-FileCopyrightText: Copyright 2024 yuzu Emulator Project
+// SPDX-FileCopyrightText: Copyright 2024 suyu Emulator Project
 // SPDX-License-Identifier: GPL-2.0-or-later
 
 #include "core/hle/service/am/applet_data_broker.h"
@@ -101,6 +102,22 @@ Result ILibraryAppletAccessor::PushInData(SharedPointer<IStorage> storage) {
 
 Result ILibraryAppletAccessor::PopOutData(Out<SharedPointer<IStorage>> out_storage) {
     LOG_DEBUG(Service_AM, "called");
+    // suyu todo: move library applet fix to another function
+    // since this function is only called for applets that give a result,
+    // applets that don't (e.g. info applets in 1st party games) simply freeze
+    if (auto caller = m_applet->caller_applet.lock(); caller != nullptr) {
+        caller->SetInteractibleLocked(true);
+
+        caller->lifecycle_manager.SetFocusState(FocusState::InFocus);
+        caller->lifecycle_manager.UpdateRequestedFocusState();
+
+        caller->lifecycle_manager.SetResumeNotificationEnabled(true);
+        caller->lifecycle_manager.RequestResumeNotification();
+        caller->UpdateSuspensionStateLocked(true);
+    } else {
+        LOG_CRITICAL(Service_AM, "Caller applet pointer is invalid.");
+        LOG_CRITICAL(Service_AM, "The emulator will freeze!");
+    }
     R_RETURN(m_broker->GetOutData().Pop(out_storage.Get()));
 }
 

From 7215ac95437dd041fc402faf7daad6f995724f0b Mon Sep 17 00:00:00 2001
From: Belal Ashraf <nullequal@noreply.localhost>
Date: Fri, 29 Mar 2024 13:41:34 +0100
Subject: [PATCH 11/13] Fix NROs crashing and loading infinitely

---
 src/core/hle/service/am/process_creation.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/core/hle/service/am/process_creation.cpp b/src/core/hle/service/am/process_creation.cpp
index 237151d061..e6e2fad2c6 100644
--- a/src/core/hle/service/am/process_creation.cpp
+++ b/src/core/hle/service/am/process_creation.cpp
@@ -106,6 +106,7 @@ std::unique_ptr<Process> CreateApplicationProcess(std::vector<u8>& out_control,
         out_control = nacp.GetRawBytes();
     } else {
         out_control.resize(sizeof(FileSys::RawNACP));
+        memset(out_control.data(), 0, sizeof(u8) * out_control.size());
     }
 
     auto& storage = system.GetContentProviderUnion();

From d3f67d1e9c7562026909a07cb53ea0f20c12a500 Mon Sep 17 00:00:00 2001
From: voidanix <voidanix@keyedlimepie.org>
Date: Sat, 23 Mar 2024 23:25:52 +0100
Subject: [PATCH 12/13] Fix GCC builds with Debug build type

When compiling with -DCMAKE_BUILD_TYPE=Debug, GCC would (correctly) fail to
compile intrinsics in stb and host1x due to lack of optimizations.

Sadly, the compilation error given is bogus and Clang completing the builds
without issues does raise some eyebrows.

Therefore, force optimizations for the offending files under GCC when
creating Debug builds.

Signed-off-by: voidanix <voidanix@keyedlimepie.org>
---
 src/common/CMakeLists.txt     | 9 +++++++++
 src/video_core/CMakeLists.txt | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/src/common/CMakeLists.txt b/src/common/CMakeLists.txt
index e97a415189..1d2e973841 100644
--- a/src/common/CMakeLists.txt
+++ b/src/common/CMakeLists.txt
@@ -240,6 +240,15 @@ if (MSVC)
   )
 else()
   set_source_files_properties(stb.cpp PROPERTIES COMPILE_OPTIONS "-Wno-implicit-fallthrough;-Wno-missing-declarations;-Wno-missing-field-initializers")
+
+  # Get around GCC failing with intrinsics in Debug
+  if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_BUILD_TYPE MATCHES "Debug")
+    set_property(
+      SOURCE stb.cpp
+      APPEND
+      PROPERTY COMPILE_OPTIONS ";-O2"
+    )
+  endif()
 endif()
 
 if (CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
diff --git a/src/video_core/CMakeLists.txt b/src/video_core/CMakeLists.txt
index e5cd0278fa..0afa3d7036 100644
--- a/src/video_core/CMakeLists.txt
+++ b/src/video_core/CMakeLists.txt
@@ -425,6 +425,11 @@ else()
 
     # VMA
     set_source_files_properties(vulkan_common/vma.cpp PROPERTIES COMPILE_OPTIONS "-Wno-conversion;-Wno-unused-variable;-Wno-unused-parameter;-Wno-missing-field-initializers")
+
+    # Get around GCC failing with intrinsics in Debug
+    if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_BUILD_TYPE MATCHES "Debug")
+        set_source_files_properties(host1x/vic.cpp PROPERTIES COMPILE_OPTIONS "-O2")
+    endif()
 endif()
 
 if (ARCHITECTURE_x86_64)

From 4015b1d397c5beb1968497e1f8ab6238e743c972 Mon Sep 17 00:00:00 2001
From: Lucas Clemente Vella <lvella@gmail.com>
Date: Sun, 31 Mar 2024 13:40:04 +0100
Subject: [PATCH 13/13] Solves warning about GuestMemory having internal
 linkage.

It is very hard to explain why this public interface class was defined
in an anonymous namespace inside a header file.
---
 src/core/guest_memory.h | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/core/guest_memory.h b/src/core/guest_memory.h
index 83292f7023..a753f51a4e 100644
--- a/src/core/guest_memory.h
+++ b/src/core/guest_memory.h
@@ -31,7 +31,6 @@ enum GuestMemoryFlags : u32 {
     UnsafeReadCachedWrite = UnsafeReadWrite | Cached,
 };
 
-namespace {
 template <typename M, typename T, GuestMemoryFlags FLAGS>
 class GuestMemory {
     using iterator = T*;
@@ -219,6 +218,5 @@ public:
         }
     }
 };
-} // namespace
 
 } // namespace Core::Memory