gx;)w9C&_N
zyG;xF
z>T}wC{N%{D?aY7?NGZAfk_uu3Ga%U8i--6Qgo*t}!0
zYfZ{+UKZUn!zfyC>|T+WI+h3^xbK%wkpjlJa6b$5jT(IQ3V7yFQ5%BWIXztQ_nTsU
z{c*{-UtCQRp*D*PTG5n%l578(I%K7LNd@_NmT_|CHxM15*-^dk-ufy0;2se3?a|ae
zBKM~tCK!6>C#sO{z_y@B(_VdwSATU3_%J?(`^lA6&Fpm+K4^8&;oUI%J$#z%Er0;|
z*!6##Rc#WE&z4v{?R4V;(iKF?r+-YGe;eTcL-Xbzv*%wXj`6=t922*Nokxr7%uAoB
zhX@e`Qh&s0t3oUwX4EI!W2>*E<5-=rL>(Y|w8A_Nb9a8lLNRHa2&2~LXuoLuqy+ny
z<;cN_!83HQ8$+?)e%>Y-t?*YCZSGk~VF8}A<2qm!)z6?@5bxJcQP1Chew4RRGc#Wg
zz9tnfoiG_|rxiA-rjv;?EZort?yUcKFO5;0_5(tNkjQRR>;JHDzPnF9mNzwLS$Wp>
z_~c0+(wmk(nSakW8tZ(9OxoRfcaICxWBA$HXk3&n>9THBL*~6;^Q0s=agqLl6QKZ3
zbnAcNM4GX)-s|;sPw9b#`mV^d*Kt=`a0;8p-u6GCu?`LMQ#`pt^Sz*S?1ss$ASTGp
zr~(uJ_}7pZF6NFG9jjt!M#@FUYW$sCsRimqSLU%eWT9$L9BfXg@@c3`_}ZXuZ5|){
z$jC}f`dQxImz+J%T^7Y`cRqEX6B7x{`vWoGn+}Nk08IO$Nr1vtrMeg{8{4OQ`mImm
z{&fvg3-jHdmQJxEzYk{b4gK13^*{>&G%483H&O&x6t}Wj{vx<{@0bNzr>WUl_&1m7
zGBw3y)ZMaPsAL77gTV}#-oit?{Tpn!Gr~Al0F3QBlgAMOh>eZO3sfKAeDCwl2w^{8
zbi|1nq0j}%?(7-jqnj2PIcCm!kSlWOWZ#r+9vIzgSf*UV*>~Mez4b)j{ub|ZJ%HCJ
zCdPFvdPIPv>s&9z89N&r?NFHk9bDm@=vLtGHVM_n;)RW$`$1Cie#
zrfI#6cS>*yV~|v2+R0hM34CQ;qKqsWoI-W7PEF&@!f+&uUXY~kiVShK>k-Ml+vs*3K
z-Flg_$7HS#Hn~y56D6I(i@!av|)Ziw{2|^!*Gi%ijg$?&KR;{PH@s5
zQ*i0ws4aONnT7Qo!Y1W$w%@O#5?vSR@zs0s6-^LQxk=d28Hr``N?$qN4~~QXJ~N0)
zmkArQNJZ&SK&c7|u^EIQ!SPdZMN
z(ziQUl#PL4p)5YgYnpTdHyyuof0d&NcHY-Ak)c3%%sru~oD6%xwqrB_Z
zTqbeWenE9kvW{2p3;&1Hb3ILdk+jEGFp!FWm#eD$=(TP&)$P$Tvbth8dS1F;p-94K
z7Vzm-vIt#R-W~Aj)(7rszb87kuvSX~u|)f-uyfQy`VR-Z0&W#UxWyWLuE~Lou%YkP
zMatQ~Q2&rfs5%ieIM+VN!xKe=YRjh7Ei>Lj!(=YbNc-}PbVeK}OfB$oXe%yS_&cLN
zq8Wxfdg6PA++!C-G=R!Xilkj7nyifNycac~ofIgncJ9PI{kH>jNAA)A0v5~No)w<;
z0|73w=b0*vHcmlep*i7jh!0Z5zgWs(K_g*sIOoO2K~~KECcG=fye;OMsez?CqlZs1
zZE#ym18_W#;ei;0MS+nYMOKZX09@A5+C9gL)qObl3wP2j?`IS}5Wl+n)j$`GWlpDr
zaw+I#_px#CI_9#7Mly7Ng{)DKAput^UlAES9J%nt)r({lGMJu)QC9^Rp+Uav4xFV#^*e21CeS%b;`-ZIWzS^#3O&`g5XbS8+9A~
zeInvUs7BKutKH){y%WXXEV^)X@nzO>c|$UMyb+nAjo*mM5Spq*NGn@yy!rcO7V1a*
zT0rmK=gexDHvlCbnk06#!fvJ>PFd0HGUpKgc8BHK{`)#&C3=m-nbvVqRe;mD=07`0<+)er0P69nUw-6M8_Zb_JQj!vz2iG|+&riUF2pN&<37+A)D
zx0L3BO#>fFNfEncHeciWhx;Jt#9ym(-%LF8XqRw?msrIT&HB>5o&|B?l+lww3f
zMfkeGBBVd5lpin|`?%{G9A!Vf&>O1SU$PY2*ZuqIiN;
zsNcr-cqa?xsl~g#zw$?M(qVu5%n>HC`Q}q>7-Pe9#dKb>jDn$;jKlDbl_61rls|qd
zQD%L}Uj(#1Q2LDf=%n6u%C|Q;DfESjUsEy-?3l^mxOot}!sSsCC=;Uw>zlfbsKYdt
zU51`%xwm|!M7pRJ$Tp1{z38oIP3PQ3-3}?oAnyUAYz?dWu{#KQ(tbd(vzXbq_;TXP
zgPRukT=eY~AhP-588^%Iz#zZb$4}9M2)ejw!2^b6_EQAyuoPf923X*gC`mA5cax3$
z!tvsQ&>3_H91!XZ7#5<7>yvoJ7;t#jd0H6YUvSYcTTiL;kpB4H{V@E;L6@^sJyvYz
zjG*mPv7e(6Lyn2LvBc*9Cwzru(Y>lQppJ;$zlq+cFGw?poHB|x6X~hQ7!4+OD}w4T
z=;6qCHZX1rK>I3wDd*3dIazo4sG>}kp{7)!h`~BN3~QrawqcO1-Z`0Oz~%a3zlR?M
zba%{egm!Uatt&P=z%jAq6zpNdr}0S>aiHhkiKM4K33_eMPu%
z#-{?AA4_vo#||BZ<^y8TrxB8Z`QD}04C>Cwk4A&-wT(=TH_lJ(7qc*-o&PQhmeAbj
z5J0CG$(LLhJl5JO|GTtGZ(`t|wCd6VL&xmND2y$d-v93w&Wb?g!Iex(zp!S_OJ=1jc-rk
zRb4c}BfM{u=&z0CNI*4bc^>nb;bKclFM8#g7}-tE_31LyGjEBW)HCPjlQwS@@`hBX
z!9>$1?(yM}9%7720X*sPFA8|02!F5%RN5G#R(KG@!*3I|>MFPxu?2!!$@3IDtwnu~
z-`R#CzEVcYI`8!|9c6Ta9dsqKFpUslf9&>g(<7i5%FzuA=}JB;3>0{~iZ!Kd#07ME
zQ^rT{QAG>4gpXNFp`__e^DX4ccjg$
zOls~Mpe^%pD87KMIu@UzmiuKt3ff7EJ)Z}MuO0eg^H(x`KdM86d5iyU(}yUS3Y3yd
z2wvn>!d!vk$_(`S0va3j$Iwb%mVzg$$b7^z2i}QN_Ji-V?rKxU2hxe@x0i$8xD|?K
zABL+BD+I`f&yG!E_n2+j^q87<7?TigKd;useLo97hQGtHFwm?H5m{wYM-cC_R0YJx
z?a6fBS!~-9U=Nm|+upV?d+4~9m%?Qu`cKUy-yNtHc3LE@T$B1yN8~f$F!vhSrNw1_
z?dud+;<9HC*D2bGey=s+STXrDjfZG5A-0q8lHTzDFZAZ>CA~2Vp`l16pA~lW2Mui%
zt*O31F>YQzQ|Sd&VFqdg;I;t>ZBDy|^NX%Zc5Tu{bQQz>Xsq~46Y>D<6;UB-zcbY5
z`15=!eLc0_ta{Q_my2=tue%BOV;9*sZJskS_4#@aTCuesH>++8qCm5FIa4}h0+Zd(
zGeM_uAt%qHXfkd*Kx|ZEh9lPiV#D(v#OB;k3#~AX8%;(8iq4*oz6#I`tD5>Iy}?cR
zN3?Zz`>j9c8_a-TK$AO%0ncvza$!2?*9boa;(`~`Ov#XW!he}oYXU)A@
z8yc&-KOV}cD5`;RP&WN29@E0zAV##|i^_zX@iOQyK;?en*DiAzuqLgd;pfbs8d$(W
z^GW;Z3pMp8({^OzkW}MpM9M{!rAlfvZxHKiGW=V}HO-tt#g(!DsvC5I&`0sE|@?q}Lvy^9imLGP@*@bd$cjsXye+DnIWKAFkaBMAPl4nLLH=NtL(54r_KZ5@RU
zGkTvU;BD9HSa?lnXF9?J*bx-HbWQe5f6>_j(Cf
z#;110sw<$l`-24eUC94a-B(6My|#O^O%xT85L7@w8l)5ufssa}y9DWwmadUd8bng*
zZjhE7C8R+~$st7=h8~!i_nyJMxBHyuoOPac&X@PotffmBhd=jq-M=iSqTYD-{kSP$
z9g5kuMco%Tc(Bmj>>8c~6qv-kS{r)CKWSjQp1q!U=JTSZH*&_twwcv8NC$z-`z7q+
zl(KVG+~8h_gyhP(i>*8_Zvai$W*pas4ae57X-agjt<6=mK6@BOYjt!M
zpfs4kTFmBi?+7TRgtPM6?-)(L;QqmB+kg|HO^zbvT%gS8RGz!i=bWx2FLc1(O_Wy9
z{l+{xYeJjdn5{rsjKe1>Cg~~K$8NO-INGY&Z|z?2hqdb@m`s$>7@GL(Pe{i22K(l%
zHNK^T_hcnsHxd}dSZb9*AyPB*HHShGk+92fs)+`nHM2bUil^B*Z$rYoNoMvvu$325hM(DaS1^2I|LB2hAJu;d>K?`om_3kz4+zx*&4
zqk?x0hkNtr(R$ojxlL1n))QPdHx*96d{+?;hd-!;2yRESQ!Z6RAeWhBk6Dp=i)eci
zmbU)#a`KGtv*9-*q5{CPMazU<{7IcLmJ+$-vFz=lb>9EB6=v(X{ud6Y0iY9ECSb?%
z7$vu(9b?a(W24^s_I50(+W^#~Yg$7%2BRRh0njMEt^AM55aB*K7Uyxk8GIZ3eLU
zM0<&wFAKF38}7%zZY*wyJIe|;W3~kr*RVk&J4QMd+kh5IPIfT+6ZA;-pu9bMx1g*5
zaZ`0O8bZPx_0#joq&~^?+ZLXj)Ybz^yS&)FhzM#@Wk<9tYrqWO%w~tq{6~ko?wT6(S>e1
z!&$8M#i`%oI2KxNlKD-^#B40*{xu|jPXw{hNJ_8%QSIZZMRe)`5XPu`;ix2HnDx&p
z*Nx5mt`gJ(-ENn3q=Jb~*-Jqa9*x0JbFfB*wZ1`93}W13K3d%{EKKaO(?b8n1g($%
zg9*|HOps^IuKvalCgv8LSzB2^C4y*Mf!wfEVys40oxF{9Q&&_gj4R>&h_26x7vTmp
zGMo?#k@P)}Eg+Nq*0H^F$aegx6f6+1TXfqgiPs0tf18!JeY6!I7YQc*exZyBudZuG>B`508g7asE^(ZA7=Km6^)B|7}5FRuwQKxMO}S
z@j&>|{K4Ms60Puu6KL{_t!d
zk743hQc5t5Ia$7{P=`pVT~IE{?8_=LXZAO#i+hHA?}@HO%$oTD)~~Ljo2z2rwl=qq
zy7ts|a4aKEqu_q0T961&SMr{v4d8IzHZPkQihk*1#p4Y~#v1J|dgO)kn77^OMD)B*
z-J>S!l{Z25z2jLyQ;=icsM-Hx1?aZ%yj(7Gsa#Kxj;N}nyuse%tIEaiw*J*^3w!do
z(TS(RRjO>?)*xJYN9e8FLgLiD6z5u1$@gd98QVm$Wk^&GaGig3&m(Lpb}c`C2hiBS`mbtl*Fv0YXjUv
zI_K8f+lp}bh4^pyh4}6tc(t3I35OzgtS+1n-d7^`T3x&tuxFAWf|xu0<&zL}3UgfK^cXO~E3VivnAN
z;ezpBgPw5>A{&o>a9L#Q#gV$;+D&Ngex@GQgWB4CuAR{N||+q?I6%)7MReDYD6>*-W%CRaT-@VC=XjkPN#Aw2r#
z6;EXwnvUbNwyygBZZylE5iYLwS-$YtSZwBskKePz^3(H2vu*r5GqyhZFR1nsLtzx&
zLXMAj2y-|t?L{g1uR%n%6viMK>#*bZvnTWnlU$d_l77Y*A=5AM$~KQO$W&=tGPg7o
z#6lD-{~Dq&5lnA~-LfN+pWg^$TIOI@Fe@C`%NJm9`;Zb!YlXRhm8?9l#)O^Pfqz@u
zCvy$oOK|j*^J5wLbnMASvcc6wk&RUexsWi#T9;Ua9t}H!*evIJ=y_H-?m`yIzDK3;
zq_#qsm*!yl%Yf;RocnwF|3`Uk|DW>O0O~%Ba;T>qU)EY8nV1Lk2gR4l=`>WC-f6
zd(9N8xhZhX!%eAJ2JaCde$K7Wu@7~5tX~KyG{GrUX0GtcCPbUgpHedE9$4~4^!b5+
zK^X~Fi5I2l<2>RmHn+(q)gI$<5#oD+`CB&@Y-4jZ?Pd>Y=5idvgDHpt?ozku6K(N{
zCU52<^si&yRh05G_Iqan5p7XMOJ~lf0}UCe3c7WZ1MfP$D_)jXipUA?rAb2$Zv~{m
zN+01b$;uL=-`d0Pm|K#&DX9k;%PHP78Axinf$O^~!(K@-hEeZng(CoGl%Si#Q*inV>idn9zRR{G`9<@ocH=F~
z?x&KAp5*>G@7jiy%M&*`fO_OuzV^;8Fxw
z0nAr1bQ{3;xTlqPj`8(l@Qe+k21+noOOq^Gk}3&VT|2iK*h{l7N&Jamn6@0?2kY-~
za6LXzrZ8AjTnqoY#%F;3$YoPCtlFSuzi<1Thuu$X2p)(e9Pl0p-$+Go@HHN7zQbgH
zEDdreSVc#UtD
za?BrxF;AZ^89YW(|E07=B@b&OTq3#4yinVGWMW^Wz8<_d(kLH+{jIZgwF>%&&h|V}
z#{t!6%{h;jW4aFyx9Lbf{vWC1~Bq}
zk5bV6fN}EgHcKURSzEMKP@CZXBap1$(F%I5I5p}whx_j!rn<03nO7rhRgLIZCx8X|
zu=;8F+x@xS&-krZ85wI*)PT(P;}3VWa%R^2O4Im*QU5BC^Mli&ygJdL;4@NjQWEXL
z-f`7!rMc2Cq-dc{bs9Bz8guLr#*p*HQA5^TE*H+`eK%|M&PHSPztzHjQ!x+HzP5mX
zx7g7I+p;OnOGPNxAl-t{i+Q9s?v=07$7tAW*PE%|REH1~b9)az8%=bn!n~?t5nUiJ
z7&!bBt`OIPl{4gGE)(bnLi7(!g@l3dwjcHn;q4Dw3i!Vi-8L(A9yB-7t?J#b&Uw86
ze+cdV=*@`3F0x|h%UdlKx>rrcXksEwA27Tdztd%|wC30?&)ma1v;V&7Y6vQOySC_-
zQH9aPI3LvAG6lW2+@FP`Z0@;4u%2uy&VOzzSRKme<&A;q_v5bD?8fwkH;VVfkKU!C
zMX%;#xOjd-ynu-Qj$kgv{vhlPQC_IFn}cRJr7wdac)o2tLlx`}Q}#*{Cthp-AwA=>
zF+`hT82*Z_>yf=~iIJyNOAMlhbv3)K5c6{}P6G~v&0Jr}CQMiRBd=+nU4+}B&ZbUv
zJJV17Qs2G=UY`Cr-i)~gPZAIvupcT@>^Yp;fm>h1|FOO>?(#6t%tri$WiTH>mhWGg
zK$A|Q9TcMH_A5AeEKsj#WHCkzYY?T~KBXBE)P^Mo2ZNSM0^eUMlK=|pfvY62YG}v5
zQsHty8Z-P)-PC>Q!lt!IRyaG@)CwW
zbytu@Ln_M#}Zzx;FM2dtz7_S~xsG0)k#yBCCg7>mfW=uAWooIr3eV<}?2
z`pzA}f-U_v{kAghOg{EVXCMjC7!1m@0u;_t;Y<(06H29yoFkOc*Ag8>_1daS&PP^@
zee}$VAw*uZ{p`9S7f)UKomyZVBMENJ1W-tWMP#nAyXhoWeiV2~Ka2M7>-c5-
z`jd-)5k9#1zq*#%9FN_a)NSu4mk?@4i{cf9yq~QaI`b=9rUpt@`>V#GlW4$%kq@JQH
zsh+C?!kqA?i@3CXv*P@}TH{oVx_qzNovR+b-4^v6-?7Vqc1;KcvflV_ot77Z{%fbD
zfgu#%Vi&9BI(H2l&@pwDj-JKVOFGRx@67hhms=Nt1Yf6Q%0Uu~{^&FF0vT+CU!IjW
zx5%b=S071NpC4DX$jbeYFswmZ+Uqj*OF5wUuv^rLR_e)K7gMIT>Zr0h_WChh#H||q
zVEktFd7-p!1*X9@682K781+B=kfB#r2lFtuZU~}t
zh%9n#;6^35o^P#P$ol*txHy9m<4pfegj=`a9^bmNDn0S5
zJU4<{Vin<
z3UKqoOTWzv+e|xxV~%y8Nw;>(^7)6Jb>jS?^u$k~-uBT(=*6P5hh_Q0mvL`)I*Ge9
zOH`X7n5?I#b$-8XoLY6NnfMa;N}oLF%YGRfY@exvKL7!qe;OA4r?1DmSX7t?iwe^a
za)$)3cWUqtah+WA@(cY6;i>HcHK!m9kT?qXa$jaLYr3#|%mbe5}Ho`8x&BbSDP*
z=Q)^JP-mN?Z>)lb5H6WBSpzzIx_v%!3u|Clp$kSPkxszXWu&|UiYViR52@84e{c)|
zG<(|i3=gww49;@EU|muyvtVUiBzxc9OXMv0pj=;pIV`C4m0X{4X*58BpVG^%c+EU%Ao0SUFby&V1>l$HpE1okQLMe#oMzLM(~I6U
z*Lp%?axb2^1~F1C9*?RgrI2YLtr^X}!<-wgm9V`xR|*o^HlIK)rFB70=>_S$F2BYB
zXx7NIW^#4%d@?2Wjlr9dYC>+cYFz2wDEy}|9KzbFgGE>u3SzdoWnUArLO-EI$e%0)
zRX+slTrLzm3*^-L7aBfhsDC)F0VVji2JB``JtZ}eb{^TYot?`%x(>h(DbK9FH6Oi&AO%dYjnAy08GMC8$3cp)>W#gh
zvLB-}Hjvr)((i%H4`&X!o+6E+q2$24u4nDOsop*5_c1+k1|>rY1-!p;%lZ0?l7qJM
z6&oIh#MleQ9e*!{r3oUI7{b&0=fC|Xg&!$UyJ}53)xXt`0%3+zbVTeHULQ6BiW5iA
z^oi2x=P9WKDwZo|Ek9l#WkAQtL&(P`V>i9AAO
zghyIR@9kifY)z;Ad2E{UK0ZxzlT(C7d@OQOGa|Y;mrq;ZN_IF@bR)8BdIyEC)No0?f^jde
z6G{zu*tYh>RVTg)y-W8}9X(X(Ay+Ml_6Sc&N3YbPYtSGgQ)w^+dW77?8p5K867&zg
zqBfxDA{dTTla>5v@&I>`;^C}hAXM^y`&y!xH{G0G)&|KVITX=G^P7paZ{HS84EiSL
znU00mc5nIazAcRQu3Zd0?x|PBfbYH;od*2t{cN%g#7^MYE1@*=V1x*t_oV$fx(EgP
zO+8Yfa0^>FVS&x|ck|k`NY2v8Y5NZ*TC=J7hWyW5DBGHYdKHyQ+b
z33*BUi3b6b`^NNwuSpj=WX7T}
zoWGyBD3-3(7KpjhvlT*Hr90~NFao`vhfZ#8HDV#9560fKL0<@;tG4)Yg!pdehOmH0
z{&fy($q-fAxJ!kVOQe-zCWUTz+j)Rk$<`9D<{j+Mt}i44*i~(`nGKC397gZdIm;6Y
zw4|x`uBiPKSV+KDhA8Kj;yqv=2`Wq{xyFX)fECOTT4y_VkAXvbr#YjW|3jY`;HExT
z>0MZCl{wHm|N8bj*4q6SH%JxG&7WB9yX@3wv4j+2%t6y2H<)$=@jTzVg?kd@6i?=J
z{#EfYEsBkw+!h$=Inf3eW3|D>Ut>>l_e;#fRnuUe8Do9))9BlmzPT|>uH#$6Q?Y||
z`fw{|Q-hCPhJC?&pls=fjQ*hG4a1?)!weWvrNZ;UYlcq3d5z`MD(({D{h}{*RC5p(
zI%g#xfh>JHY@|mtS7e-IMjSOnvtwrMR-O0V&P@*H)M8_F%r#Q~x@#qQF&|aaE&tVN
zt)=nC&p-v}Ri1uxxdEGmR6Yf(PSLi>m}`Rv{OyGMV;e
zXOwQgO8hMz#Nbj|UkPl>KA6&eI#c-5sPw^&=&XUJ*sEmPxQr41gjXzT3JxXG
zo8Q-~{P)WnK{(a()g$ScB2IrG>oWMSj&VFr>C}5hFY1k&TnyUenzOSNd3AkqH5T>y
z>(0uIo~TC*0wJHHKYX1%PAdJHj~{8?A}0Klvzvvh+nwuFjU^wFH0zaX2}mc_C#D(a
z&{j=~FqTF}RdawfBkoxleHq#Na423v|0vM_D@k<5Q>^4el#>a1YOf^FGOI&@1DmpV
z`lH7tvW}Xqus9+83`p0X_0d>g(v>XC&{6P|8my9par~iUXY<|Uc19fG~c2
zJ~@y_vVd@DTxoY>v9Lr%>O|(%b%4lX!k5%!h%j<
z6jq);?{+wsC`Z$mfp5=nJ|)iKc!dcOrORlNwKE{Jh^>UdZKp-O=xwE$P&T<^r5_{poysVuD$%JK!LZEQN4aEH=_r;DmNH9&FWJa
zNvv6U@b43jqcxfHhDt*93%|E1#q*;Zj~F{Z&e*^dP*hS$4wd-nqYjCxyaI8j`vZJ)
z>Pjz!#XQRAUc#UZd)_esG&0F1g`J&Jp-B00kMRNK?H9Iwe}H?9;jGXfWaerixv}~x
zv7tA>_8aNTfeor3!KC35yoLKC*3=FYz)3q8c=?XSKeY&p9BW{q8~dpX3Z9bl)OSC&Q>XWLZNjBD&Ks(;)25bRt
zMPcEHZhwyTXAI|`>xrO1F#)u|f1J>9L>+EKTLjMgWNNm|@3(A6KvJPr;M0y{W*YJ{
zN8D^dwN^v&CR$lnjd|X@ZWbHa2ttXZ)NH8B?!7M}vm+L
zHahdL%boK6$O!DKFe}O3s^`4>xE*}+&G&r;1`m_syMYp}a<+tpPgJ~Y*ypZzq4@
z8dqmdGBL=5TMI8}!Nitrhk*{7^Ect4zZ|?2zt!-?z2ahU19;}i5GCm_WYKMtZrUaY
zj`yn!#h(TX_L*j^&rjXuKM@0phN*m{Jz@1jpJ}4lTRavLoKW&zJe7paYjakA)cDIn
z8gx>lpXRLj>Bx}2KF9#StAWuVYqZ9)=!)Rp(c7RQ|29qWAPwJ>OzCm-MMJyv^`3FDAWK%!L1KS(XLNo5LEXC
zgoNlLh0_0w9#Fn_JtPQ@NN5Ib(FSH%W9NRx
zdaSJ~3J3_iccqpRZ4bfEQ_y6Vg8Ln-GIq`0W5MFlzluU!{wxZ4ZrQ3;7Z<1XU0}a!
z$h=WjAkZ*rW5*3eO|
zZN(dCtQU0DK-G8Z@m?-1gT%4&kxgsl+_zK;j_pS<3SCM7L9*+eH3J9i82MfTB1_2E
zr#gCMzSD&FZ_E^)QR0+C8pS~ItuAPT+l!@TYtMelu(p8eD_iZ?nxp&bUvPo6m$>7i
z5OrOF$S{BPp32Y)Y|~YxnI0n?o0YUOq@fcFyMA}82CDm=`z?`^DPIYQ2-w^uZV5yZ
zs0o8l)$2fpdWzdl-4ex$J{w#v+cT~OaVpjHT
zVK8j~(dSf6eaTO`4K(}Tv8{fam%`ugp}xlOB;;0~q@Od3`)lPY@7~$B3T}OpLmj&I
zeyxGJB*Mp79MyYmiBOp>P{Lcz7XG2%?Y27N+pN=|F4p4ag}zI(!Wc-iyRQqr>`PeK
z-vEi#p4p4-QS|k({6OaMz!1&kh`%5bc)B~yT@Cm@Arc=WAy+cfrx1>(;G=TQz}9JT
zHrfPROpay7v|#2t@8V9-1+0AO)U*&HMto!I(MX#Jbc5@&up53;4ko&^lcV}Ra(~tc
zU{!RE@v4$qlJlMMl;`f<^46;co3nHGJlrn1JQCLO+!r|{I$0A@ebJ%STWUayTMt#=
zfB*}Oj)~}#SMe^OQi{uFar5o>pz>#9svY}OBLocc?+k|~%Zm}H1+)~6mg{Qi+0V)_
zf^Aco^NV4z;eL7L81%|P)YL4#JUrsV!lHF-+0~ao8l6=FS9ZfyN%harFBV{nJMhb>
zaDjnAp^Xs(SdkQU+UeHJUDgfacjaH^WABUV-V}_3Nkha=#}9
zFiTctrBmm~dvOBnRRr(TL%P2w-P-5a;QZ0d<6&keLj@oG7AuP;{~nHl5vZ;
zku+uNMi0~J{yIA`00(_(N?bFieD>xkbI3h(JG>-1+
zIHwc%*ztIlLuI#IZyDw@iP5*#8X=jjSnKKu8M}cTmlaV}6_l1j7fZ|J9ig5?v
z^u)N%{ptnOxgN&dSHL?5d0g;A``j4d``TpTjkYT=NlsdCb#j~oD0#tuCA*)yU00m~
zKOYij+?%1e)AV-xb^A27X6lRhQ@#oiV2p>??fb_C(pYdVcP|s?yX-t8rqE{L$fXX|
z?OW?x2j9BaQ!B|Juk=%)`w@=vbn0V0XqRqWbGe3vc0C3&6hT-o21XulT_6e&7lgx
zV4nH>A*E&QGq0L9Gs~*G9H-U019=et(y3uNNMad)JFCyPg0J?fHHH(*{#C^q^L(0JsvVv84UtH5;m
zwVETP&|x)zyWh?rHGgj4p49_kW%rM1R8l+rUdJ@lMph~g`BE~6rQe>WNwf8~W>Ub^
z@`y;ecizC4p@quAqp8$&JHpB=#ro@P%lfrk?V3GAiu~jOD7@usJMk
z=SuR#3r02W1UIDTo|Im~{is`r`+=%=jgV~kYK77c++3%<
zd`78d#X&gbSt#HJQD~3>X2R-477~3f{377ddu+8sW0T$+X~k+H}01d>_jj+*aZRKKgojV6OTXUD67#8hPwZDBhRfK3ux^b=x5;P+~J)J)ze!CTOIS55Bd{rf8H^I!lK#g!Y?dv@t9^!Xmo
z2mX-QG3ej8*BJ6a&)s@dco{7$SrKu9{8nprr8Rdw5fBzmSKgb`y!hq04VG1mnqd{P
zAxuOec6~_aPPJ+=Ogs;|U6XNMr#)9Buhmx!vm|lxadY}IwzdZwCDq(gFr}4>FneoM
zcv3ve>XQI0hBf+2vnNL#f+eutbIl`7)m$_ajtv;Ux+hO=OP^)jjz>4f7}z_?2b2i|
zpFb0p)l3%oGOb*F(vGj^aRio6a%v2{1(F|N!nwyObG|4uwy`{dXpQ*XlGL{Y`J*F!aV^$<<(Q7k
z??qp4FJpDrpT2_w_7YCDf6y!%)U#&B7R@3$PqC%3z4OwA;Lg%0@{M$XkH{Dk=i7HN
z93V3TFm;N)y&mH?!kvtqbA`Fy(k#J#?17QbDGUz4;!l;l3&dyZx#btR4U@*w6If9h
zcn3@VG2(sW@JXW)xW~@%8HU+)k&Dxejb~`=svZSX^bH5#xH%lUmhu#D4S?DiA%P=d`zLvFzL(DBV$8_GlcMZ3VoCPhFg8
zS)%Pl17(hvCLYvB%O{>4$d>U=ye`|ytWsF(fmUmTO<-p4kR^N6`&JHaFt}w#_pF-G
zyzE(i6)Xn%@v|Pds2@2U6C9$0!ER#pbf(ao+vL
zmVh0no9jNfUG?SvxRdn1Qi)-O@PrB2mG7-^;7Zm{2H|g8C3KzcS32B#_|1&kw>dp~
z#ogF<0r)e$VFuzEo6NHu=ZSOyn})bmMM~s3yL7_8IfpW^W!A{o`wB#=IXNY+CDlK8
z0(|)uRaNo@SjmIklp)G@(MKVHy@5vJ2Hqx;g4v?KPK`woTQHinsjb7RBB!gb_<19_
ztxZaXJ!=78_>w(AiINSQYFRJ$nuWC9_ZR!6v>jZHWxvKev9N?>B1P4*o8i)C;Vfl&
zJ+W}Hn=ptX4;R|UVEe7TEMB06mDCq~2KKXQ2KN2e?ykK2a00bj2Y?52FnzqO_{vUS
zippLi^36EMH*1xHp^e-ks$w47WDpd@tsswXd;0BMB~<@owYPd>=LUTwbkt^4VI4jt
zDEl6!G%g~aWFK#PbU2veB6~oTjiEAw)LQdvHl`j?R3+PcUrQJE*xd;d_MAS(WOj8?
zYKQiGdo7r(=YMFG@dw@`a!>2o*P1~JwUeKH)BX`r=wlSCf0Fhic%{-oPe*B(8GbKU
zadIt%1efM>5qF64>lm^%m$pQM%f7jwPV@cA3gwnB!SiL0o!1hn90QwkkL^blx@g7J
zl`dW+Gp$LNQ0PWFJ5RenbpPXwMkf$KVRqyn6H0x5k&7WQ_wS%{i@4O9XOD`Oq7Ey
zd1I#uLK;heoF7WH7Ob0{a{c1V_hl{8H2TB~lu-o58(9rnKx5O)2=MlwBVnlE{=_ll)T
z;w-Onw1aqW)I2${-$XuWK?ds@1#$lE?N{yeYd_4Y>?+0e>s)hlHF+0DL!vPbsgtVR;<;;1mwG4#V>l=kCOcrO>9g^o%V
z-H}SysMgbDHh8f@!AeicwXifaGx)P%Bm3%)b^ixmdUlHaO{Uq37?XRPq9TNL9!g7KDk
zwwe4?T&zdu*f-7wi#<8Z)ucvXTRW=rSVbPGnx`$Urj#?sQ&Kj|=dZKyWT^K#EW}Y*
z3MPkMJyZz~WzV-ty7;-^_>b=}!_}Dji7JY+II2@-1er{o>o#8a(F$Qjw{)DSrv+wt
zdtQ4Aw3eWrzWOq@x|^c=x(Ruw#V{-nv6u<_SSsQ`xVkLKbUs!Z&X70Yzoy?m7L^_r
z*4l_9xMOvk7dpXf`1S!6ls&%`-V=?2rRWKQDaB4_`uSlkV-$BQflFW2d#+qP=KWjL
zIQP4qlyJB@*8NVheeL?bhR1#aubQCu>E4?(zev&bh;2Gs5#N|sQ=m=fnj9q**xhf~
z_W3Vbaws?f0yH-fPMF%%6@)AQyo`G0N30WR&@^g$dT2MeQNd0j~Kg&vse1|m+1m6w%g=WCf76A
zsxyrDqLb}VT}twau1(i?z3ZkjT_sW3mWXDNeDCz1n9$GwcInvQ^AXXf@UrRu#w*U^
zh5C6`+}9&mdwz|~TS4LnjY3MFyMilNFrG6`lwHN!JTv9|CZZ~Q%Ld?02MJ(+e>(Gl
zegbCo}fzJ3*{@pY5pyyqJK_(L~@?Q3}aPka;l_=wzlrlW@yBmD%-+#pU6
ztDqhNu{tLFo=n4F%x|hoZ~Dir!th>JcSt`*92`jJWmOy}Xq0#TFh0);GXZsT%ACI%
z9^hfhSUNeh>+6VPc~;YW#-}3w$-=d7YTQzct^A|Wv>AEw^0I}V>4sm@Yii=_bB=x?
z`k1#e((9Qlvp$_vu5AlD&l~fu+|5WKj7Ms2;~O4lpj<&yYW4ck*|^0{7~{KMc9v!D`#7+t#9EN<5aFB`Czb1ll|v
zGV1>L&571qeQXdpe*5h5lQ{dazz7L58$xvtC&q0|Me)busVE+)7zi6^TpuG^Yqq;N
zy6aE^3p~z}II5YMLbsZ9Uab^|%2HHW>2R|jx=cnbKHhFaLG(Pv6p{qyKD@XwDeS$=
z_dQ1v><4Bz7hT!q^Ig{+Aw2mQYm9z6<^}l#^bfpeS5ro3{)K#JUmYRmcX8-xjY}WH
z?tnv5JB!RfUSennSr7%3jpr!$;3=+h=i>E_tcwksIQjVF@qz-{dRaozpW+tJBZqHT}JU
z_eeRtpK8O8TyxPpnV43AoS7pav~b-_qA9j%(YC|p_R0CZFaTgxq5EL|TM%#4()sPS
z+1(#OYGAUL{=EBE!ign?#fRi|>H&Sx`#SFD`g|S3GwWycRLIWe%?|>jS5y-#EHrSy
zMo%T7f4O}{#&!YJGGqi_y`v{`>mp4ipftEsK)Q_%nlk^G$9H7~EC>U-+5U9?e-;po
zY*Z{L^b!<(@=kp?NpF~57$(^#^LgCb8KwKB@37|Wf`&}-e_jqG>f*|%)r8nuBwpkR
z;9F8tJv7|h@#h~&IgrpyqIJZKI1LL6<$xX^S$WiLM-0U`Abxvx?bs{=6y|2J$yC~y
z+udDd5LRB&d|-=M1hARxdla~DD7IGRev%9>yS8a?ff!1SyE|g57gmdy=)qF5`KE=;
zWn!lQ6y`m!M#gPnyU=TAjz_gZBZ>4C`2r*eT139wg|)L$76wx16EBmjTP@btG
zjG(k{Rq{1PmA)l$xa4mEtt;`{C$7bW{sebs&I^q^y4XdJl{7zbzktN@Va9E;2lpEq
zKHQbd@~gsYGrSto^NqiZ*Xp?Z%Svty)?>Eo4Qq1lX_``qM90gnXq&U2
zqZS7*g+OFLuKyX=>PK&riwGZ!FD%~s2u;E@&R%sJ6X2Y{DVu!vCZiAMc3M$g>6EKC
z1sblGvM;y?i?r|62$V!6X{YPjq@sQCDKOFnU93MLcrW*ZlI_2U6Ofug-^&%P1}-I4
zMAPYoupDRlPxYB%f)!c6UEMmGDZa+TB2?pG6c8BrhAa`7$;2wtTP!}nCH6X=WHtfQ
zK9|Yi(VKDMs6#`3o!b&hF6+Yq&*~9`0nj=SZk)V=)C`1S2Y>X|i;1QGJo?vu8~xVQ
z7Hf~cefeUjk2-se7p*F3bMwzQp4Dm+6Up81(-#Xv**k&xpBrkCNmR{#af?LUi82-76L!%r8@9vncp0&?1
zmI_N3Mufv1W?P73KWvR-0|l4))S{@1m3N8NFp*obU%}bD5tp_B>SD$Hw(ka(dRd<$
z_cX%?7t?bLWuRc)7w8`j%~!}bvcVXyz63h*O!0KC-6eEsH&^@OJ_8t&dT@in-rQeG
zf4YX_oBr*n8oVspJD$lMARlj&v8d5Lv0TKr*K^vh7N?>`+~xvb9Lhllnxp7a=~Sbi
zJ;24}8IyxvHdS{i-|r$Zb^2cgn)Y401rlFdEJJ=1P+bZj>=6Jag{d1Ck~j6*Ab1-T
z`j5Y2g;TFigj2{uQBXDvD(M0uOO{NZNcgaL<*;@>mrO$FEC()&@3E2=k@U104tmvR
zxw}Px3MOT#6b*Kq>HA4c<wu2k_nYCgv`ULj=cm%Yq*oqXI;1{MyrZ;ET}#5puY3ZW6NuDPk>tvC;89
z1F4`X8Kdt-{S;OvOOZ~N#bolm%(??-_)cc*q1MTqt<)QT$nW&UVDVlp^k@h^9e+zA
z9-ZQrt2n^c&U=eZ|0}9H7hQvb2BG^5?x6^QAuZn3vFk!Bwihp&K10%2O(8Rn=Qo8G
zX%y;Dg_Z&%$zL@96DxQ`E)U@4(f2O1sJck4uMyI1qH#cJ(+X%OxSouQ-34v3+j^i&
z!0{5rwaXp4kyzQ5_$0P1%S821a*&Wfa?xAsi|4z<{F?=6#+K2&>3WRo>T<#Rz5Dl1
z{BfU7Ezq$C9rJ>#ew{w%f}j53yH7~cFgK9FJ2r{S;I*I-{8v+YIc37TGIr+2E2UjV
zk~A)P!OP2-e@^KwzD(#BfgGLrWYR#c<-dxIWlp@QoOGd$L7}g_63)9^_32KE5w#1czfU
z?UJ!2)#=d_LOV@jO**G~WlEqDFrWqw+SjI)S(k24&taV)+NF!R{TqZVrtlJWN);{Z
zU~H#tZc+F~#)nu0v&DfS-+dT}?GbQ1RB;Ol(Y32#m(hBH02R2CT>|*4DH?oUzpm*Q
zS2>MCp=7CVNdQY?Z2>OFoN>7j3k-m8WZMJ8FfcNFUhA+y@@i3qaV8#r&@`=A-xP3R*(74?AOSK8zOkXSFMm1CJk6ATG^*ue+ug
z$kW<9o`No`hPE@i8xl50mqwou`jnqlCUIH>x9%@1kmfB`OvUcako(!4DN*RzFXuXh
zDhh6<-O{A>O30Kau7b)uR|w|iB|BQ?c=KT^hudL1@bM4c4sLDLholsV&d0l4CYaNB
z^~?;)ELc0<5_<}ESdNI%2!c46NJ}=sJ=e1qY74f_CM836Y};HcE{16%Lb0QrQHSLwl;~5THr!ViX3rcj2uklng~s
zj`|)&vQxu@YsbLy2BdEvm-tf!(C1;{klm`=J7j^M3#NQboa51R5zxb&A~^0ceH_mk
zmoV-VGnm{@Tnwrif`}C~o4(j$%bIfGs&eVI#VJf*2#F=I{~dP8#+*}ln+X05U-EGc
z=9iycUISX4MAixn+-|bpuFbBGfzWO9q5=4op1DF%bg@_M54?Jczb7l0$ar}F)5%Ko
bXa{qeH;7SfG@${4{fCbw live nearby
+*** 4060 & 1010 => don't live nearby
+** If one or both pupils don't have a ZIP set (`null`) this method returns false
+|===
+
+TIP: Make sure you understand the difference between _value_ & _reference_ parameters! +
+If you aren't confident read it up again, this should be clear by now.
+
+== Impl. Requirements for `Pupil`
+
+You have to create and implement the `Pupil` `class` yourself.
+Thus, it is not already given in the starter code.
+
+. Create the `class` and implement it (= add members and methods) as described above
+** The usual requirements for _good_ & _clean_ code apply of course
+. Create unit tests to test all your _public_ methods
+** At least one 'happy path' test plus the major edge cases
+. Write the XMLDoc for (at least) all your public methods and properties as well as for the `class`
+
+== `Program` & Sample Run
+
+CAUTION: The existence of the `Pupil` `class` (e.g. constructor, properties,...) is _required_ for the business logic to execute => the application will _not_ compile until you have completed `Pupil`. +
+If you want to unit test your individual parts (https://en.wikipedia.org/wiki/Test-driven_development[TDD]) you can comment out parts of `Program` to allow your solution to compile.
+
+The main `Program` has already been provided with the starter code.
+It performs the following actions:
+
+. It creates several `Pupil` instances
+. It sets (valid & invalid) ZIP codes
+. It performs several age checks
+. It compares the ages of some pupils
+. It checks if some pupils live each other
+
+The results are printed to the terminal and should look like this:
+
+image::pics/sample_run.png[Sample Run]
\ No newline at end of file