From 8ecf69a5c4469111ed5adb58421e442f5eadfdbe Mon Sep 17 00:00:00 2001
From: MarkBaker <mark@demon-angel.eu>
Date: Thu, 15 Sep 2022 21:07:31 +0200
Subject: [PATCH] Handle additional merge options like those provide in
 OpenOffice or LibreOffice to hide cell values in a merge range rather than
 empty them, or to merge the values as well as the cells This includes reading
 hidden values in merge ranges, so that Unmerging can restore their visibility

---
 CHANGELOG.md                                  |   6 +-
 .../images/12-01-MergeCells-Options-2.png     | Bin 0 -> 3313 bytes
 .../images/12-01-MergeCells-Options-3.png     | Bin 0 -> 5029 bytes
 .../images/12-01-MergeCells-Options.png       | Bin 0 -> 22477 bytes
 docs/topics/recipes.md                        |  60 ++++++-
 src/PhpSpreadsheet/Reader/Gnumeric.php        |   2 +-
 src/PhpSpreadsheet/Reader/Ods.php             |   3 +-
 src/PhpSpreadsheet/Reader/Xls.php             |   2 +-
 src/PhpSpreadsheet/Reader/Xlsx.php            |   2 +-
 src/PhpSpreadsheet/Reader/Xml.php             |   3 +-
 src/PhpSpreadsheet/Worksheet/Worksheet.php    |  76 ++++++--
 .../Worksheet/MergeBehaviourTest.php          | 166 ++++++++++++++++++
 12 files changed, 291 insertions(+), 29 deletions(-)
 create mode 100644 docs/topics/images/12-01-MergeCells-Options-2.png
 create mode 100644 docs/topics/images/12-01-MergeCells-Options-3.png
 create mode 100644 docs/topics/images/12-01-MergeCells-Options.png
 create mode 100644 tests/PhpSpreadsheetTests/Worksheet/MergeBehaviourTest.php

diff --git a/CHANGELOG.md b/CHANGELOG.md
index dc17d852..f15e9d5b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,11 @@ and this project adheres to [Semantic Versioning](https://semver.org).
 
 ### Changed
 
-- Nothing
+- Allow variant behaviour when merging cells [Issue #3065](https://github.com/PHPOffice/PhpSpreadsheet/issues/3065)
+  - Merge methods now allow an additional `$behaviour` argument. Permitted values are:
+    - Worksheet::MERGE_CELL_CONTENT_EMPTY - Empty the content of the hidden cells (the default behaviour)
+    - Worksheet::MERGE_CELL_CONTENT_HIDE - Keep the content of the hidden cells
+    - Worksheet::MERGE_CELL_CONTENT_MERGE - Move the content of the hidden cells into the first cell
 
 ### Deprecated
 
diff --git a/docs/topics/images/12-01-MergeCells-Options-2.png b/docs/topics/images/12-01-MergeCells-Options-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..5e745fc934dc88c114b39dc1a45a48ddd88ad0aa
GIT binary patch
literal 3313
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

literal 0
HcmV?d00001

diff --git a/docs/topics/images/12-01-MergeCells-Options-3.png b/docs/topics/images/12-01-MergeCells-Options-3.png
new file mode 100644
index 0000000000000000000000000000000000000000..30ad346eac43344b9200a9c49928209a71663e35
GIT binary patch
literal 5029
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

literal 0
HcmV?d00001

diff --git a/docs/topics/images/12-01-MergeCells-Options.png b/docs/topics/images/12-01-MergeCells-Options.png
new file mode 100644
index 0000000000000000000000000000000000000000..34c8f5e3e6c54a021b8fc11de86ba5d3ba4e81b7
GIT binary patch
literal 22477
zcmb5WbyU>f_b#poiZl|+(4CS)m(<WPNOuWCgER<8=g>;$fD9lZDJ>vU5<_=LBc*iT
z7w^yK-tYRx`rY6CV-|}S>%7j{`<%1)ex7F!Q5tIUxL6>p2M-?LDk{ioK6vo36ZjZn
zq5)6(h{)1`9}nF$<)t4~3{h+Yzo6SlsY*R~@FgDm+8hJ;{i%zBzT1Nb&)n}n4;QVe
zy&pW#wNR9m((*RhYxSwsn#evg9yS<08m?KiIWZV+&rWl<+WPEuVz9mKPZayb!-F89
zOktF%0MZ>7`6$FhwdVmy#_L)4@&hACBUU7@kX!mb2|8ip+aSO66e%+FC$C&yee2m5
zTWSq#uNjuO%6jclx|7wU?Gcz;_dH9aD`#jiceZ(`e75m5RZMEzwM{-%$Dnb0fWQ5p
zWj4DPO+lE1U_n8*m)PQI?;(r|kvQ|Rp#&pHnsX2dx)g!ZD=-^oum))XREi+9dW#Ak
zM<L96=G@Gf@&Z!d<j25(uj#iQnpi#`fq{*J;XWpm5|*;7%%TCorNIUvQnDIq3A60X
zkq`s{eA0}7Fome_wEt-VibWQ||3Vgh9lfOWZ7>Xs^<RgAu&^aooxT0vT{jQqvpt<)
z3BDnc+_2-@wVR_BDaVrjU_TC)ESLqEYumXmCKx5O!S~)Fc_SeU+_f>}hq-s}oPKrf
zqe?OP3!oZsrg9TFWFj91emDYK@)P)jJu;uCWp~i`0)-@6G%W=kG#WQa4S2J;nqheJ
zLnh8QCB0gy#eiAr?8aLH4a=SGzH_2r=0@<~(;sal6v@$$kf2XmFVNC(H$&|(>kz0S
z>|M7~daV*j<B!tg?72__6zu0vECKv68XQyWb-?*KXPy3sqf53)WY{|fO_k+%*|NG(
z6(l9xsj1l6saGr@k*5GEdKhaW_{PRtTb1?=;jR+>?$v_)9f@_{yUkiQOnTjBzfzia
z4JV%~s?;OG@$@?yT^9)Llo9?Qc0P)7Nw~<%$~5k~*UhYM1Gih#UVCn(v|0#EJ%p&?
z87e0~d*=-;m%BVt3GVB7uzSE1hNrFlqVdw|<WI`zR_1l*swx>gTzbpXnxG};K*RrK
zGbz}h)dZ;qR}-m!J(X%2G(lzuK{yMXM!A&X4zS>s>Lc<E(;S6bWE)m7Merlk_9rzS
zf%x6tk-?d8Zj0$YD&ljM)c0wW!`z)@IHwMY+k2m|mxwhPBl54tjcM(UwTk%00C&jn
z$Ca0AA#UG;-vhf72bpk}m}+n(YUd!U*G6lCBJxGYvpZ_ukJ-(XYo8(uAz*`|qp{Kn
zB;F9SvbJu-L@DZlOcIVv%=<bL^)PV%%par#d{PVPM7S1ES5w;cvTQ+|45Qd!hhD1)
z!j7XnNM{ItTTSa*3&|eRkw&Ir?(iz?eIQWzO#(Nl+Nd65DJGKnU^i|nqD}tqv)TEw
zOtOS#H-;_TJv9m<9Oj*5H{KZbj3pAY|LOg~@3#ZnPs_hau7(ItO3T`hH<~~DC4ClY
zCZ8Q@sMF}zBq^kA+@0SB-udRsmO~M%<Ky00Cj1J^<C%_Pg2v{GuBg*CSygFLV$JP*
z>rVoZ@y64t;v>#fN0-HGdx@5&Grp%qVSUP`UZ)BQR3oQt6-u{!eCO)Jf0I5!WD0%~
zE%V1N1k@c(_~&k7=Nqy-r1gN;@7>hO17jvd{p=Wp1S<@sC+upi^gf1}nf^$K21dnV
zTYJAKMvXX@<u8LTW2N_VC^3iBp7zP?+0}y3W*6_GA_lcGtGJFjCvl){5SfZt97tXw
z2$z+0VHq5jfmeXy4T05WC72=>Fq^p<r!#n}L|^ug!xU0imN8S%Y{6@yqC#htq%yyA
zUMH?Z`9*BBUEnujGf5JPtc4z?H~Q7nrxE!YrSa=%V@7;A6PDj2aNEfJ`1xpf+dL@q
zHBzmUc3-8owNgyaj2|zC53Amq__KO^5`U9vV1&rQaGvl^ZAie{rZ-UsO5;;UZCZ5r
zWZ!0qr|@wLHkK`T<LCb9){d8&r(fEU{X_#-mLivEW#fYrzKynJVdB487scI`>0@lv
zSq9}+Uk?l>vMOwgQjMF`3RE*TRSXde7*|}5)7i9oS<nO-DMgU+A(?5mJR(l;CNG!&
z3I7h}5W1VGJy^(CAuQc;=*ojxKufvR>@US8lG0-6=fXnRx6R|vhkwJoO&d?&1P<Gs
zsI4}R;#~~wn!r6xH9VwWM$0VD#)uL*9vF%3HiCjq$bwJELc7U=#q??+?Q@=S731Gw
z<J!y^cLyG^5K3pw-r{`XuDM)y%QTlk$+gQHTQyjqkdV#B{=O`?`~ZHLXD)K0YG>uB
z?cz)_i*S}2Z!$fZv>cbBG<$je>)Wm!NvSx=EV6%|!~ATT$vr(mYkydO^I<mg$^HRp
zE8D*lNeLw9Q9@LRv+Ch7!WV10wyLYZ*;fYi9ovsRfmxR}FU7?~Yb7bN_}t)g1V2$!
zl-99B{zv`hWztt&9U?WJ{26xBBA-n=NnZ#7hN%FC?S$ikf>U+~PFZ946uy8?jL3?i
zQ#qJYL3Hyq^nw;)HxF~!RYMb!`k!`KLrL;+;7)RSjlaF)@wsjfGXry*H@Zh|T`;qR
zw`ce#^QoR&-^_gw9)G;3r9&m?$ie$lz{bE?>w@2aOfO=)gX+XA#6XDmjh6v&5mY(V
z9Nu(VxQwYKP6d^+2Rtc#vOR1YW*hd$Ag<<qy~2F?5Zzrdov9U!H$MWBts8-7;z#*5
zCUtR>?_Bo%epSiAdD?}2Tbd;)&}<6!{L{%k_bGKeJ28tgsFD@`+Y4@lyo{g|0(tBy
z(*DRVgkA|NDxTsj?(XBOT@6wHz*mMnJo`CsY)JSM)gMMlt*Z<J6+slca=gwWWX99+
zUpmy7>WB!{&1Orrc4VEEz0AK^S<a2B_i9p@PF#3+RZXx9#s7$WqO3(^Ga3rQ6(R1J
zMB1yP%jZc&EH13ugBNq+3IV?fpcbUOid_>{@tFo|MfFr%fa6z((Lu52DwX-C#ngji
z=?^q$IeYv2$RMb^V8rzVKdF^m|K6aLj*QPjyS*u9AMB<PppVFK#?mOT?K5~dMRbBX
zB2Fd*ttbz?Bk2@ZQ_P;{9x|uH21<gZxaSSOgN55f%x6<#)-J4e{*4$4Av>4>%#Jwc
zqc)n}*xe?S((T1iJssNQjP%Xa|6-9OF}8ToB0M$;+o@t=$MDnYqME3Z=ii0m`e|7X
zfTJKXXhq9_LHR3E$ftr_%<zwl8g~LVFFsqRTDz=8a<AslHag=q`Zl&lNGl*R2@UE4
z$B#M<CGR?xN=jYM%JS?E$YlZ+rMZr>FP6v3hjK2lKmE}&uK_^=+{T5R<Lz`!{IKg=
z-`V_nd3^*nbG62~;^n%Z9sETRt}-yX6?nUuo(FLZ`XQ`!Ged6+<{0_=Qc+N%dl@_;
zX0AUKfzjn$aoapED7~^%Bm}<MXMel&_1ESAR#rOs6)9SFSN>5572(I5KbdNdTZe<q
zf-6W}zp&x!u3&8nbIK>pK6<p%$o+G8!;-C^&yeigRjq=AG7ft^gI<<gC)-4o5_Vq-
zV<~NN@HGf`W(==Q+{4U+$ptwI!@l`r8Tx9#tpFi_^~u$WJnK`IYA@VTzUr){dJh@8
zwt|18E9|$!H9bhb@V>qW+n6ETF@uU@0lmt?64+I}BA++?RB&EfDtLH{ZNz(-Jwn(>
zzIo72JJl3uy?yp6Hkd<JSFbx<!@ieJNL3h-Kt2{{cHraloA7C0*TH7F`{}r8Ri=E?
zL&x}!gOQ=#={yc&n&#bh6uH$(GQ4l%e`MA&z(vqrPUd5_8$m#Ily+q`XjJaA@}wQM
z^ChA4X{wl~IjQw6T(mytH!URh8{>JTz^>877o^LD)hVEgPij+Ir79k)u3wa+GK0uB
zXY~WaMup(v<F*mJl(S#8ZME)h5LlO}8oZsAr~aqKAsMY3*uF*|?J&V9;Lc34uvZP+
zLL9*B<BLCv`t5K7o+w(b{YC_>QdJIHNT=c$^42S&O;1vkl1|=uOK*q>Zdf!DLe|ZF
zUY~<}uI<DUoNt-Oe#!PNN96i%YP$-9hOV1pFnx7_bY6ZT0mS*Ug11a?sF{m_!sSX4
zj&~!D32V+9S_1=vk6fm0biGQ0Z1EFP2K*>&j+&o{<ul6oRni_YiOF|sf6No`CC-;k
z?@mllBA(@rWj@F|Lud8~NM?IHq@(D<Ga9l(>tW)(g0VR2@)Enx`}Shfrz~LQV<KB4
zlzjJ_Ux-UH7s-AEW5-SVi)r4)ybr|RCH_J_J?$wZ1g(FSp)nt-ev)d^_4tGWYb&l=
zR6Nd30g+<dFJ8P?q_)0h6&>V86zZmfIppQ5fm;|yk5)0W^Y|cp0gc%?Xm+(c2fg6~
zZ!g?;0k1_6v*Ai}B|z`l{9Q~CgG}ecHR@5q62<sq?~L4~!YHuP_Cqz(uIN!0=wFc(
zbS$9kM}uoZSjRk@m}o_3*IfQGO8Ib-aoYTNg*z;MMj>1<w<2orn!~s$rGYp6H&SGI
z^0mOlQs`Ia6s)tZq~%*voHfp8czqGFvYK>KGfYMQY`LZ`f;c;9l%_Z5aX)&;1(w=o
zqg`tvCWsVW=@lYHR}`w$8I_O+OMa!8`q-vH3z?=LV)r=>)8Tvw!>9eReznz8XOAaF
zu2Ns4+3^HREPC%qhs5)>zEXcgKf6P(dM&0P#EpL~Lr2G&nAgcv_r^{IR0ee%dSH-)
zQ>5zRX%Swa)$TqwVu9pYa352xmr-3~l8);Qp;JL)%s}tgi`F2+mKJAzs-<f_O46}H
z_2XA}j89qgir*Ne%W4d8IT{LfhwtaJ`S*Na2F_7DR!q*|L<Q9gRV)PrO&)YlJ#5nY
zfs)Lh4P$>dDqV2$$%9R0_IPE|w=CcMrP+fZta3zr7Srv4f%5V_O&-5Z{7<w4a5g&d
z`!vI-zResaH}0GH@Tg>qd}s*$l{h<q-_ZNwlWOJ<L$Yr-Bf(d8rGS}c<U&t2f&$HG
zM+sYGgV|u3pk&fA6x{2C?DKqy_v+AMqXeA1R_<n7j2wuzg;1q1y6#&zxuDZbH3oU_
z(v)f7jST?rc7q(vAZbr-gTkt$G=sC3S@d|K6zRdGb!6{<@mI-pWOXzydUYbqBZ7q@
zs6^ah=Z7oAFMmzf+3WiGiJsm~1>QVQRUtsnul^=kMPP(ZpSZQmqG^$(s654Tkt`&z
z$%{Z$$tWU#q=^av!BQ+_;sl)+W1&3H<$ys~?_<mgs}%F)VdDZN;xr!oN{jA!FP;h@
zZxw1U{u=H7wZ;Sw0c(HD@;HBO<k1tn1jrYnefcIMG+^cXk0HUSX3V@)=r9$#ABEPh
zl$dZ~DTUjwT*>qbdg7g7yU7E_0#kmmLysq3z>{Qb>C{1CGE063;xJ;;fK|AlOXLwJ
z0COq7DOa}NicrXnhCEh8&^TzCA_@)vetIM)TO}1wt-CrRjfb(OVMd_@YW?$r{A_P-
z3We%uBt@4(GI7@hZf1M+7Fu;GB#*ua%cEhq+r4<kl21}fHL}SWA${>hQx9QHVHaND
zD=;jBy16=&LG&`>xqifuA}D<d!-@<3Wu~cz&%~e(f&*d899}IUJ}z{Obt11;FY}Om
zoIJWTLJ2x{;l<y(gey3IIBQ=?>oZhMgDK7bFtY;+K|DYUW!`(pnoevvN(U~rnDw@y
z7EfiSh(OC2Adg6b*s?^svIrB8`M_$+%lGCR-Ll>Qj<Z918;V#KjEqxJ0)?_EBCJN=
zLuN8)x0KKbDg7RSJQ^KHMaNY(v-4R7*ZcAzh%%k>U)NZ{G+NXyDJUcl>t`4+5JL`@
z@(azEVP|NoFW;KQ4y=S%7g6AMy4!er`CGTbs4pF05|9$hEHK=+^vM|yS-)f2BtiNL
zl@L}x6}EWu!V9SCA#mVioNA<O{5{ohuY>@kgY=0d7;9MsIZTy+7ON<S2&Ngw54=cS
z^1j>-yQV|O%l2AqIG5wqoP<s1e?uX2My~KvxwDz?O%+kc^9ME~4@JVR<6><IYZOi$
zIPtUMYOfuUcXC?MC9yi7zd0`MkPV`sNo6`at*61%e*nE5zS|6x%K#7Oi+zK-fYOO8
zLXK%(jk3_dN5>@u->&r<V)4*LXY#inpX<hCg1cTiwE%}eY*~ZbaTYw}fMf8H@HA-P
zRX4v9R-L9}qi`UpEFxILoX$f(L*^kxo%{CaW{%&!&mcBe%i*sWu8g9yp9S78U%u29
z2WdCC`<J-u_`r9xVu<o#S_EwI^n*#1SkW)wI&~0g+n_eI&e&P|!8-Wo@wQAu7lGy1
z+hKH29D$utvBkI+qfM|9!c&57^ci|SN36(zD+`hwzV8tpbgMRO7ethjzx94`;b7x^
zGg|S5No-UH-P>aM`Ss~qucLZ@&jI>HS1E$gP;`Sh87UDEKOV0AxGNHcy#MTJjBd?2
zx8KB=Ueo169*Jn;X(s)>eNzAVz3{UH!!7VhlLijy<P5C^R|Ed}92A8eoWN;oOS~!#
zgM+bp3lC|J6+n#1I_;1f_<MSInY2(bi}YV5f{-wgo`s(8rcTwA^E#}VZs<}9ly6yX
z`N`kqDO8Vd?GDtk6Z`KQnLdR34s``~P}1nQ+_FZG*gmzW(y$?Cd>qw2KOE>{m`{fu
zHcEn?uR!7P(Q*`rU*zoV5g)>hc3g_DW{O4ez<RSzN8|JI^=sn%v3FP9Kg<wn(H~8&
z*Dt`O3Mo}In0-+x)_qKaZ^5Pc3c0Y}b<l=YC3H0BPLr%RIYYt%r{Rn+pwucCt@epy
znf~+c@5=-~A0FO1f%o6;HV~~j-c_n*Q(ytyn2)=DhT`in;C3a*1ff_8a>m~K+=w8c
zLgO%EJPa4)h1|2%5lwKZ$;FT>PNCcn@6=GnB2}gN`6QZfZXFz&G~tjL$IYds`d^Xi
z3Iw4A!UrwR>x7JWH|wSWA*KwE;(|wd3pKLJp<f9%7?M90qo#U}`*1TX{RJ{AAbj1P
zSu~g)uXfmLZAzghiO7PpG>;dFlLe58E$GHrFwGjm0)fI|KH0VyZtl(xrXen*17Z9=
zX=x+<huI_EhNYk@CCEIq)f(RLhtrWUK=AlMj1eGsXZ}IUQ5<UP@A`mnO)w4S#1o1)
z_QaihAPlR~QSj`$bQ6Pg#@S5flY4G(Cw3RyWbWX6`;PEiex$+u{k=)dhJ+;h!hz!)
zdMWeIWTdPxVrJ9~x-c;fU4Y6#5PCuqibXi3?XePGk<Ias{ARC%w*98xz`dc-;&UMm
zCAHCf@hpb{VBCNxNyj3M@cCG~TK8Le#KQBvZcWW(jT>oAGt{!uDq>sgJ)~GIyZ_&z
z2H73+oC}p!xA(Ktv$me{r2{kKp1{QH&mLdJF+?zEyuz#Fk46q2F^(c#S!~^N&u)sU
zAc-wNIQ4i|0-eSOg_0;HRWTB?-Ls&P|A_=eMnY^#mMAH~ukWp-)cgq9=B9~2`?&SR
zvQ6gXAc+M&^y>OElz}Wj#Tjfz(PTfx33H#Rev_pStYGJUH|hAX$fRQv7((@%AX7^-
z%v0R3gnKWEFj~S(ms;B$h9cbVeK5|RZl|TX$(0#~`A__NNoMDMW1Kc58MO7!pLtmS
zwRf(6<ZHMFPN<qql)=EnwqVe<#sm2NeB(bW{P0M=!@6Ga;dh%%;!X}7MCF{M|G^ly
z;r;5f6B8lX?X9UOByfh5#bNG?1XR0h;XhYfwR=AOkZ5c>bHH-M4%V0(Z-RV?=kRc{
zqZrjIe_N^w7Z6;#)M`;`W`s(yd>G|d!oy(D2&UM99Y2D*B7IcwcYBUqkT?7z#?79I
z5L2IZk|BpQfIe*mnA+>oCPFw95aY**AprIumIoDWo<I;9Z|dxh$6LaUD)Q4!g&dlS
zxrUG3>T49tj}Eygp`?&@#^Bbe%ddH~`(0?FB+1E0>{Wg{&3KL&-?GE1o`nF`b9kYK
zlQ7gRWA9II6Wh71;yWH}oytryqV{B@uPt-A9sQ{ZrgVeGZ_xU!GkK84!tg<DfBm9x
z=_9u@f$WdNwd!LLEqI?bqd?T#<E<tOi_=KP7jCpMA)Z%rr|)NDI;_XUao>Rta|l^5
z6cP-ZzQ;(F43>s&HT4T}|9t%ueS-WaPAj;nmPq^JxV7XNZ}C%U4~-*`w)ZN3Aj|Wd
z-7E3eCwitt9eg(?J8`~w@6AG^k=b9K&u$yc?O$BH|9}SKl~zodTV}j0D*a-H%R&*8
z?wBdt?M~mouw})B9C%d_DQsqV$B7NRHWac7T!r=D!H1fj85YlL9@VB%{yATbce6f1
zT;@;l?MWz}FG$P}-|*c8sC~h36?G9JA@Ix3u4u-+<_KHn$!1~;w`%m@<l#D+_z)+o
ziHM3OGi`OU{>!+7@3+cJkGasF!umSL|8zz!h7{H5sm#9;w#Q9}6AQ7WP#O_R8KH;D
zt-*+M>g5qnK061GTKe*Vit@Kk_vR{FPiH$3(2$*I-(8}8=KwC%$>9%7*EcBH)17JT
zJ$IRBC`(Sh=k+63`r`Yr@pxKArv=&8)QcUqPq8#mp4Bozqeni^x@m7l+1hBd2wjM^
z9v7ovDO8hVFk(<4isk)FdntsqUCE`DhGM|5%H(htPiT}F^QpAxLV_&#;~TMH>8J@<
z(tJ~tFIU&pY?KIukAaOT`=bit;#qf}!oWKxAe70$?TK5*|HkbUnVh}mlWJ#g%B^JF
z+El|q1tx-odIG)^y8^zdTbMVqUfPkCN7R?oq<&TOFPIleJ?9FUn)Q&2x;(K=&P&4p
z+ritg8KSYTPQT=4VhleIbt;;aN0f?QoG+;4Up7WetUo(-du5y*^}AMw4T6>U&vvst
zqKcE@XH#B;7LpJ?dd=N1#2A#y<AKovqyI~qZo&Pb1ypy-$@YnZ32LmY^FtOPO_KNt
z;#$9_VP-!r_K6uji^p$jP6r>gyrdNMB$h0BZWos4i2ZE*3yl^@AyjCPht-xiLD78R
z7r%&Mxs}b9xOF*9>ySkW;p+n8*LogmM`H;W_?d`863A)7{}$u^(#VhQ(?DEK9sCn$
zg#RV?u*e~-)F0iawTH%y`)XIhoOk=;w!~41kS>5K1ma6F*msbBs^$9cz`uhVs5>$N
z9L)m=JmK+HntFucp)X@5St_3RGL!~5g9W`m{*w$4yr7%qEu2Vq8nOHMnm>e0ftZpn
z{1cJH>Hdk-)hq^xLN)TY_o1X#W-8wHMa|HagL~e|=9xkiI6AZosNcPOmeBWhcZuOZ
z5?=oX)gb#3RtVMO{0#NgGi`yC7wtSzldrulG`SCS;y^MY0}8D`@INzh5(0y0Qo?}c
z03}oO2nz+M7@B2n52QjGI$0ZVG*|(lFbbq^4=`4Qr-ug+!hE+Ghdu-O;pCxwha~|}
z9)iMtn~9CGyeH8|v;-StntUJXH0i^;zmH$LcOR5n$;ZqXmj%gmSjLP0_}^)%I5)s|
zr88_;?C2+;)hT1oJv5jYGMQF`0MQ<kkeCNVa=)(75+b;#yE`Du2?_|{QA@nLKL4Yt
zsv4OU|1_A!O3@Yc#?@f?RREBoA&AIqaP;?B$TpAod!T|o=GTC^&(%9Bf<?Uc=jWW7
z9sm65j=VS;mXv33bad2U``&MZ3B2R6EwMnzB;HnKXc8n}Vsu%4Q9Vwl1hS%m<cm{C
z-tk~9&=s4CV5@gGNE~RI5M2ZzFMhXYDaADFRC1Bms72L*%9L|t(#@aK`e?7Qo0X=_
z6_yKVd=Z;V(P>S$cVE~tX)<_KiK_fm4*mWf%FND(6{`t=y`MII-#HJu>?v(ZP#fXj
zX7|_Y8r?CiO1%49<_X$q0(?K{^w)XhqpVUq*<Uw{`pmtOQW|Jcj+)3UflR@-vww?w
zI(i~dpFT1DT+&a6av0RIh|y@52P(*TcbJ^0O&2@YV_$rl-WV<Td77$rG)S&)cmKu$
z6k4IDSHHdTy3y~~7AK_nP*NL$RiFmw#&9n(kS#RFqoV_ySqNpY1V`8IRdNSqFRHJ3
zczPy5OyB*H8*+&Jv)Z%zOvjp-1wXv(U44Yp&5^W6sG{uBkBx7>TZ_ap=4wCIgAzIR
zbG@QOzRP}{7E$6k^yj_WyIzZruBw?@Zq=9F5auk`_(%*@WNtH>cx+j1MU*b?SIno3
z$p}>|>NXy@I;roBx9Jsgc<ztXXbp>M`QSr`<G5LQ5m}bSp>KQ9K=bM4MQBC8?jrKn
zdFbpbq2bbDI;9g=qpGUJ^ajOz-y<~nM92zwltmUusKqK(bn}>s01a?r>3c@jswVzv
zSPjt?fp25_BgF080beV(lyY+~#-!9oe5$1M%^muQBJNa4Q&@oL^7Pib<{P;-!N<?E
z&lDGAnkv~0ZodmCYBjy_o`E?#j3<8I5SA!6`}iwK&9kvo+_^oKG4p)4aR!q>NbBB|
zveV2gbl#F7#dk=gZ%t(D2Oh%Nvy=wx@fJUA_m5SM+6H-5Lxa^%jY!CSR9u5Y3$Qk3
zxXfhDL;f)X8@Q>tFH*?CHVd$WslUGQ2FYy@o>AGjnN%oEr|asEKQmNFDPz&njPrm@
zM+Edrhw#>4Q?<XDVD1v^M!UM_h1no{U~<{;5~>9iJz5v0d)Z!|$<fVZJi9LS_swug
zI!%xap|GNnEzi^?Ibr&-fpUk8++?Que0eN9fykqV()1|5ENP+Ntm2oGhMgBPUFnvX
zJgESuUx}78E$`UYZ%d6sqXX1VGBg%ajQ?}}@em*!4Gs>*kiN8d13}Hs&W?|NxA9Ax
ztXvG+T1>O!C;!SmR9;=W7|6~isGfcBY=?Vj&~rcej8{=>WjE+hO>&sW_Mxcq7e(e~
zqk|`t>7*Cco8O5TQe<V-EZm%kbg}FMS(4k>u_@lNYB+~$)JDq^HqCv5XGJw*>2W2(
z@)*A_agbk?e(kl4Az~0Hjf4f&^)yb>84(a<=88pa(7%SyCSTSeeAj*BefW*xPKzxU
z^>a>^Zy-S{Y?>=I;@6W0t=JcS4sa1K#?s-<ZA%n-0USoL^Ck(|IrC^Gy9fs6-L^{Q
zLuwO%(AEY_ti-5-WO#(51{+n4SpSkRyTlw(u+=Z(<ikj!=x};SUmsmmRGZ8SKiw=f
zf|It0`V_n^U<?k!wMmPdr_Rg`j)J_dfGFn4Dj-5Owt&lawiFn+VWx{vn1H2FC`l$h
zfsg8@)jQ1aI!srIfiPYqRP!RzM7=n3ZOm;`>d9}++iltH=%*<jorPS-1h!@pN=PP6
zhoiNmDi%bGF`MRCj-q*fv`7XHXPD%uAh2KuvFLC4X;};<wbPn<R}0=sqE?a0D7wG1
zvV@TC@Ya=#VXqG-yn)J*%~B-`*<w&()a7{?e86OOg8V53MpTFO2+L0hNc?jkCqAf7
z)u0e^LPr;34T4v6z}(GVn`!1oLmsL`Lzy=Y000v%LMUl{`JxCSLOczcAOYQc!B(qr
ziuL_nQ%w6c(Ekd3*8cEX6)scY#O73gC$Kfod<QrhZF8DBOMX*W;NSPk$1S9UjwF6A
z{m4qaXO$W&$pE-m_6NFiOq->tm&rY15z&=`G2iM?4ZOV4_RX&bdyI-OWuGlQn?F5B
zo?URAef2Jf9-I7Uiz?0bXlVn%48W*&ymlIKC`a+T*i}N0H_uA!iD}M&w6gjGPA>88
z+}LXY;|q{=4!;l}rOG@t^e3;9ilBKrvt5odv+W((rHi;I$Du65eydyVF5v3wn$735
zOv6t{f3-bNcds7U7LRiA<0UdI3gTQd+vJu~14BQMdO3a%KogZIFFK@6$Xi5{UFZ)c
zG?>G%lh|Mj^XrYHJ+;QDs#GFqWD=<l1;IH#KM$1sGf=T8ZH0s$&g#{C&h~9X=N$#W
ziL_T@ImES<Dz<bOQYZIMkwVUDPh1RwkDkOq5+B%(d$NdsT5>G!M29;qH1T7@|1N(e
zcn2^$(zFVQDze(gjZ&_KP;dOxGMW1nTNne=a$S_6JfZxW^`W~@<_3eacx07T`aYEt
z0I58Lw1z(GWY=jF=gft)263`mF_w0+yR31zg@}J^&G*RoR~eS(#TqcUsI&VscLB8H
zf&5^uWMD@yhPvbpxZJJ*hN3f=cG?~-I_>oIkN~X@K?!9M9`9jV+$sDe4ed{{et~^u
zD?4R@N~(>#9cv8lMs>t-u09b`*>-7%f~7}7Y5>^zVwpt&hb?4`Mvw)sAVhIR+*eOs
zi5T8Q69Q16TT=&DU$eXzKOxsN%!!yKT)IhcC9lof!^1m>m||sG|9r6;Pk_wfXJ0O+
zs2O?xjp1uyCqJdW`!)2@>#qINkhA*Ed4#QTLu>8bUcAJnW#3kX0ZAzV3Ry6Xw=_BF
z`KSANN4~y&ZCP1a;9VeujbJO1P!OL=40A5k=q*oa#IV9EFOPEzdykp@RevVuZf(qT
zJNKg%^}D5>dRh`p_pRWDJ14v6^>>$v<q1N$i4TlA*NJ__3ZNKG=w5N?97gBh$Kk0)
zf7Q<gU&C{R-8M?g0-_nLhq8hkcZK~gkH1H?cjf%9XbvAzlm;d$u=CKlg5uy@NmQRy
zGC6jH&Db6f)NBTT?M0K)YH$4=EQh!GHuvp(p8H)6FDPy@<Tu-CBc*|m{Zr~XVwd#M
zr-^#VaJJ|fu!r9)LLTF8?arSfs5=n%u=?^O^6sM{<j{T)sL_<R0e(Bdi-ax)FYwRq
zUd@u&cP<MBgECY9leu~sp$q3?PYbd0?1-9)tsQY@f;;t`fJ{?+wQLFH?KZz_@BtgT
z+QwTf@tje9tOyZ+OhIdc;6o(y^0%(Wo^1Foph`JPCu`_|^4<3Vz*i0mN+}{JDJe&`
z0BZ1C`XG+`(|rmbsS>XCcifOjBvZ>zU+^sIi_fp`Pc-naXDzozXceA23tl%7=)0dA
zN5tP*byS!S?=E^B3msr3R;Bewh#tj{iSS6zd+lQ155D{nl<ZaC(!8DLHx<Awqq^77
za>v@vDN9<%HqPQgY&$OYnHg?@h4;_`qNWr|K7c}AerS29YNtAqG0E~Oikqr%?=wHB
zFV!@_2POBMZb4n*A{1~A0x$6II4h3AmFj_S<8RCZtfZDSd9|D$-U;<JlQ4#~h1@&l
z5BpKW$)7Tz<ydtJa^TYN0>td`Xn$P=G}8$MQ&z@))_O8&c<zD5yLTvxM@=pgI8~W?
zaCeU00?Mnk@Qi_^I^Dg9x*h2JrXnesK3S?^s3nc489!L8lqxKM7SygifaK|#_+X4K
zv|PMg{P6y>=ruF*M3uY7QQWDQ<c4v^Xtcf$oa*lS=UK6rzn^AL_?g<@3Un*uGHKkz
z3<$vgyqfx!zr%Agi)wXyWYc;lVSD`k7K;en#C1->R5fsg^}5(3%y!`8%K|95%4Sa-
zWeBm&&$OZDB*Oi}=R;b#k3LbgNwy{vjhNwY=DlG13{}~zG;DdoD)DvSfAIs(zYe?$
zF%AU8ub!@eIC#?Dt5pD*irda6$BBuC_$w*w@6OZ!w^jb_*@EE1xfVe(eJ^jIuy7Lc
zzIZL#K#BZ<+M01QUAP?$VDRbzs>CG;5~)dG;|TQa-S@Uk8iU3rYJ5@1{OPr!Y*9hi
zUyl@i?>Ce4Fs-*n_0@JcOS(I3U1ztOwB6~I`wL(>E|%OGxu1`UA3rISOSA>HMeYa4
zA8vD80L?5&3X!3HcNnh#8%K(^olD;+Y5)ObWn1wEgRjYCCLqNNgSA|T9RbxlTKw=N
zVWi6D?A`4fSA-uO!hpms(Sg6o)8W9V5@j!okcw8?|I<S)!$uFe9=*=j{$hn%@uHHD
zaKEh}f8OrD+(p#FE^Aw7Kn7PcLfkIj^<y|^O4hP{<Nz)#baV=!QkVN@a2ppbC+Pq<
zX7Ap9i<Mjsy<%4x+0wZo`81d*D1#W5yc4q#;8Xg2NHVfjYx_F!yQ&~A7cGelDdlaC
zy8GaQdz$HY4TEx>SBOA8zZZ%|63$-2C05WfX*im^l!XSFEpb4|R-WkS7U4mR3Zoq{
zNGDLxKprHQQ>@~X)rs-^`axW#*oFEr?*)v<{O!@^u*@~4;JnLC0&OaQ2IEy<2)TTV
zCK<SBk#^UOP&X-Smb|`RnxZH;e0ei+cRLw!{MV`k(Jhp*C>DKA_*lI0_g(JdiD0}l
z--_RBk=!}g*kN{AuZdEPut*3=pXl{$oxOtN%KPdg#W01m`I9NrO$PHPI9mVb^#e=L
zCAWAS>MXX)M1z3G;DfhGRgWH*zB8e9;Z1$L^#^#%*0XtGHtF@`)wenyv7Xm-MnW(`
zU|O`GK{OO{L<ZnbTOzZ=b*r#Dm1nv+te<%EH;?#wwvPartpbHZE`WoFk<6^V@zXjS
z2F3<R2mFU|zB?tw8-Tk5Z?B8_v7d7mhV6ZX{Veqacy3&|AhPIidBlro04OVcx___=
zL5Q9_-{Ao*Z20HjmNzVxPQz;39;Mb)3;7`1zugCa;4VD=AO!=1{LdD=ctByte^qz%
z3;yAdLzDg!D(@c!^anFhVj+-RApp(ZTP<shvQS`oZaW7{BeEw2rS7W$ElD7$<4A{0
zDj-}a!B{69LEN+{dIb<0!9xqrMiYd=KcxaanO#ais#Q4%-X>D2%jq?Pb5D4l$a{i}
z1)Fr8MsS=p+pV<@=HG8Gl%v|uW7-n}*O!{^bdlWR%7BJ*7OBXt&I-iwU@?HW2*HmV
zdLb(*pp<;Mh%n?Sk>9O{3|jh*B9BxxV8@%1cRoA+P#DBP2s3Wv{n}2qb1A|g_`XX|
z!XWwIlfb^m$V=~(7h=gd<2HpTT>)y4u-BZAS4E$3`!DB!8mH;nxC$@HUzWim$q8Si
z*Zb5EmFAjDejIn!M`f12o4yM{D=<<}>w1)9m5oqr7P%hsnF2NuI;{tg>Y9K+7Gg~;
zt^^8GIN16?&du)+e@t;1v)*XRabyZfC;myE^xJQkDZq7S{FC41##?{#xr;Za4tBdl
zy|3`)rzBx%J)(51#iPF}vWsu2oE6-w)#$(Uxv}u=(h(!E$k?@V-tzZ9o~V*KiM<U;
z4|&@tRda3HXFmqg9!`CbBxT`O5Wwi1c}Btnt8Hzi1o`hbZVJ`Va=V=s`78`Hnh%>^
zH+wXibFEeQ_wDw)%N;&7(90tSBiP>@XcUeXqm-*fz@T2uKPf(qQWJr(uU?ncYF3mR
z!?8X*i3{#n=E1}@2wCFRtmXIpens~>5p-jQCuT=#Vb?Vc7R*zW{G<*=bba!u;;i()
zm_z8ac<mnN-d)>VU+tl$kFY2KN0aC7t$2k1RP+b3h-k=aFHt;fyciSS53BuaRgA)q
zqskW77@h<_vZfG=^d6hoTAFXp;TPEze#`P_vB%WRDx*0-7%yAU6E}AcXjshx$m+QB
zWu&}W3UOU7d2JwzT{z5Gf%&WMj4>Uj2e~upXYPvzF9SkIF-d<C9ozQzR2d(t6*i2-
znHnz<?dM7b_pHjtv)_(k)WZor)0~$Y`M%ghKI})bFJ?K7j-)YqwGcb;kXFUk%k8Ui
z{(ihxr<rb|sV`FEZD+rAPM{?cLBppb3uZZEVVD!at+$^uz6ye(XDUIp6Yow2^6=6|
zzV){&c|4*b>?v|Wh~`W+&ytgSFziU*S)H7kc{TRd2J0*7eET}EC)N7@562_yOdyC4
z#r6EriJzV^y8BE7pGjP1;YOpj<a6&Da$hn;SO6@OAp)ujTPpw+wGvU9G@!oTj2pH<
zDm5sXh+lpSX!jG<^=YLOAjw2#dz#W+uhEVEy{hli97SVl5mRW}73L>maABcij$(hg
zVGu}9mkeX*!z0mmmT+z06_8dNAM|`Ti2b1e2CtUl|E!MxmW3PCee&R5(n0S86;*P3
zcz8%5j!8Z-fGC9<l8w@veft{Z#jY0Rb8RC6!uRHfpO596zg{q9Eq2PY+Hp5Ko+Btd
z>Dj{vJE<Dg;E{DS_4|=!Mu&+o69;-1=fcx!-)9$17bY85oIU!j67z1x?bp+1N_2G0
zUxXW?*u&~1QxumzVBj?pBL!tx4CD$h7aYyxIT5ISKzT8{mpC|{OiB4_nAX`Je;AC=
zLtsh<3J4xY9l(t<n%@e1wmY2*jG(@D&=Qmi>?IhhmYTnHIb+d9B$nu*|N4V@z#)fF
z#CqW-9Fm{BgWAVrH$A0W{ewvn-KXd<<oHV|u~O)v?uM|ILo1myitU-)i@2AcHo}yk
zp^zgEYx(KlGY?Hhh73oCIIMMD#GB1C%J@fMw~Tubi4|N0R->z=3k72HHKKh>-({~y
z3%A##B~4yhhOu+hP9ur_kI+whj=xN6anKDvJvdH|QN*6sS2FmPHt=%1$LCa(s5iBB
z+MD>E4N%my{ZdqQ+WaTQvzH*XKyIxriY_)9*RM4r6$M)lLS$rS4wiailX65FPE>&8
z5ux^)T%nX83b>tC*NN#bjlAD@D|=}-rBa572aM|@v6_$Q&k?cH5~Qh3s>@mD@+u|*
z7Gqe}tfmjKO&90Ql*)g(f-|`M;@Cq9b!=UyX0Imd`x*nzlh-u<oLCcn6}Z%aKwyr~
zOMUWr$4?6v-=|+yl~5j^sc*uK9|dv#7W&yEo!2qrC{i%&t)~_{ua0XVe$3oy+}+h|
z#P424&a#`DSn?H#*L6<++`c$-56#wfDMm$PX8p1}GHSbzXJ()b^$L$@O_oR-m>sgq
zT*Wu7@Qf1e>CVen<K-ML^6MzIk9a}lV%@eWC)*vD;|Z@G0!59IA>uf5Fmhq?K9K?R
zbr__<U<rKzs9vPuObmOZq;ulvQd`0akQE*n@hc|{3NY5Tlz&9|Qh(VK_$NS0MT%H~
z4Sak*LQtLFkBKpIwb1XW`s#@-gF1Agm6zYgTR|AdCNJ;$+fQyPH57Trw?20?&M)ix
zf=dGyS-obCOS8vw&ot!ypK#i|as8_i7&O3o?5#9~1kmR)z5sh%n?RG76AeQ&%Xo^(
z-8?LL5~#&!#D(0wt_7v?QMos}HXl%1x+H~v`&@<DmBV86%>gOW9DuppFT@__OWD7m
z>3j=hV&9P~2^KIG4`~TBkd~<&CByf4&39pu4Wu0j`TYQeH0xDC48gQ)wQd}0V8s9N
zOnxeEzes|d5kB-)Mck&88BSOHpMfqOl^8cr<mwus4!fvN?O`v(%sYj&XsDGTxVE)7
zBP9o_+uy^O+l9KCt7!wv11{E62R^oTa#{QXZ4-8Z+}oR|zhRT<7oX#Lb#cO1;%sl<
zeEutDdE_(y?8L-G`<)~`iTep5y%Uv~H$gpD<C?`dQEuY<{hh<^$(`zjo-38b=rRJ{
z3D~WH-0y6D`;CLZJ8Jj06bssA(j=Op5dB=Lr(nCgX%?oFM;V{HcL9leYbeb*xb0#i
zbA+Y3H+?X+K;*hJOx+UGt&j08G>~s%E1l1#qG_jC!D8bl+4PT`v0`=gtaH)b#{DMy
ztt<why5uU=v8kiJIW3H9i+8vwQ#5oj_XG`^mcas&nZ&_?w_+${0>vncm^B!yyTjw)
zzTS8+hJyXxT5KHn)NZ&65(ne}M7%`stpIG~{m_u3<Rzh4Mm}V!(lq|ux$zBp`{cXJ
z?cx;9#Y}Hq+Ul*t=fjH<SE_;K-xQK2cXUl}>h}oLZs$s})5ZfgR~+~=+I4#3sn38W
zq-=3N9WWb1F&)Se^xpPn&(Y3fJ!5h!iinvLfUiGzUzDxBnM6Rfy1qx@J1p!BEk)o_
z2D^LhP7hULC(1=Ed7PiClkS2}fA0Is#~)P?JdN?$t>L>9DnF91sXq`s#W1lJ2f;sU
z*XpSpakZV(9oa^~v=r3B0VyY77<sarmt!!+@(RWMHvj(xqe^&OayZ(Qqqt!nK)Ys-
zc~`*cTJm7p@|YUn$Sh(&^brAdV?01WapY_@<G&`sh%M3Yn>jKC9O>Yk`qiO)nPf#i
z<%Zzd(a~U8=hhR_fb91wqStX<J>f%3C%@OPBqbhJK4vLT`!LQTo_M!PeRtT2&BdW#
z?Y%c!_YNR-h#yhZ`CoZ@;{ZC$1L6kfB?&{sA@Cig;C_2z`VscZ7PM`r#cR?7rB{=b
zx5>$NdLl?4`KxB?BTiM@?$2oul!nb<M%4TIXu;ym9K+}z13f^&&I4e8B9C({dt#a5
zFP1$t-DG^9jw-A|MX$s7nydIu4sW)zv)(`U6ME9EK?b*=le8U`0b05`IRXIwLpin7
z>01xD07?tUe{!~zZAl<;pouH=>1yJ<|C#DHfdf^@BqbFBRYHzuayvfc_{7c(tVDDX
zK^=gpdH{5k!7N=^W<m8AI6$0IPy_l^!+=f=B~RHk3(q`Yr+!*^J^=ZjuS5vfq(coN
zDghh1nAP4ruwC%?qUZSLN0e+Eu@ta1J#rx$*!u47i@~`A@!pG?bDyIe>C?l%<qfkd
zBe>)y`0adAkg&CHP`Aw?{<2v>K-*8Z$#K=G!;XdU5Wf@xg}t{0V^KefBtt-7fJR`%
zGSDjab9SHOw44A&eEP7miYBZ+H)}pbEuJYEp!xv&FV6tB8>cjVmw(HE)Z^VbJTANq
zCNr*dknC>`PSGiwu}xw63)2N3$|{G*OqClx7jAkE$LhN;?^Q|w2s6eF3R{AKqxFR#
zh!GkHqN)HkUc?LXzy8yc&>u<I4i1EAa{yFLc0@dWcKh!i-OkkKhv)}bP=j*od}v0m
zAit_iO`&*p_T2Iazr6{Zd?5xf@ZVbrbDym(QTX*KGdwjRnl=XSZk4%d!ztR>?*mJ@
z&g&@_)inT%${h*j!)#r)$|~#EFG6L3`zR0eI4!Ou9<jcrDt76>kbJ+&q<%}(sv=>a
zk~V*RaYP{5i7RL%Y1O-)YI12w^cat#%A)(NL?yw(#7gqi&OW~6-5Gxb%R6Ps<M#Fw
znpUyx8~p%VGrD;4@tK*v%J$2hy#}wYe9ZFl@|Q0MOsc(sK#Nb|9j`_Nc!m(pmgIF_
zXFruN+xhUrH)aw#^S3~gX?AibCAY@<5f;jrQo^U4GjJ1KE$&}<79>S<!JLx@-{@}!
zmzS3*A`&0M6aIM@t1e<q<J+^FLz!}o6HCOS;wRu)aAZ4KhUncSNe(2D4II6e_!NhX
z+Y_0u=-;O$Aq*t85*Hpv7+w4y>!*R!uOk0BE#8m9d(8L{_l=j9%b4)a06Bm@nO?L~
zHbm?^&lzg>|3C#-BagIvEr%dM6x*ic^mc{3c^t?27|2x$h6p~M4GQoaC4A^b!f$`S
zGQkp4ANxw9N<-a92)nHM80-xJ94q`-9$}|;0IS`LTlCe}IH*C9H00#|zSHxt{VyPx
z1hrNBu+hZpbA`n}I<(3LNZfrZVRY-FK?V`|{MkaYuI=&loPh(Jj%Wnwqp6O~<2e5n
zdM{)H-8@pJfW!|p*iA_x4z?>Nx<U_r=TfNZBW|eIml*FMw8og0EW*+2cr+J&-#LYp
zWGjH46fPPV>x-8hNOoU+0MZ2wCco+%u&>MI8{wb7b?xA4l$ga8uay4j<$A9Pv~Xfz
z@B<ypPw*%X+q=OoJBzJ;aEO<|?-?nC3ybaXpx_b%oYSNwjgKAZoAv(&Erd?Tg0b?T
zKid_7OJL=_)|*%W?k{7X1If8B+90t00o+0V(%W}r@99oJGK0h6fFwyR8Sw7)>#^p8
zwt*htE2q_k9QSqo+6X=vf;f(RiidFsqGOEMe_CPFV0@=U1y=e!lU~WqIKBnM9Ovde
zfvoV|0HBXPvc9|=S1C;I0te```uYA{9v2W?=hpobpBB&q`wc7#3GQc~);|>Sq^ixK
zT*laIVcf&2u<<HqdMhppa~~~K%$i|Y{+9$kMBX{vlqLbsJXbiYF8QKfaUedCn9620
zChmW-XZs%zdFs7Yge-H+5293~fAnyvS@nj8@`LGo5ju5#fBTpxGCcFO_wr^Ll|O2&
z!iZfh#{2qX(GXg)y*7SU)AO0+(aCR@uXnZ{cawJH{~W-LWLC>7(KcY6iiU)7%f&+U
z3nmKxkKVnkN+U)?0^dNW;D7XKq*WIy(ar!uZN%*4*7=`R!l&$f(IHRpExz^xGCSDI
zF6`*A@{_Y=^ZplE<PzPpADK57e%}&&c8bJ#9GrK_DNKYnBP{FrY_lmu`%bJoq8}f$
zb}ib<y~x&KQI19y5}7)&jr1p}TAl7@2Z^XO0*t`=jj!QK55n0V6@fKjnAU5U&fGcT
zxsvf*lYtUwtA1!pZ1a4aMH5XS2|Qa8$XKZd2f7!s{K@c#0GTmsV?W=37F1tdY+LQ1
zeqx@!pcga+K2aW<*b7Rs>j^l}rlg0VhxxY=)illb$9k1V_q2bP_Y&i3JpBQojA|N@
z6mBEdG3emvX3XAwdor}LcLs>)x#EK4578p}OKQK`PXr_<zhasYj>0F=b|(GOz{@0k
zmGjp#KjZl*#yxrPh4L~+r5>^(K8?THxHG{5$vAeGz+>QXnirColc`gPiPXW|4OhTT
zCI7Pj)Fea)Ike30>u|N8?Gq##+txo<kC}DweRsWw@(10l%TmlN8AouZIwznnJO6*^
z%d)GAp2%L`qp0Q&UkKk8IMuJ(n<!+)f<fnMtwpF0mrpWZkHOsBjtb;r^wOcV_4NY$
z{D8zA;D&G3pwK`o0>U+N$|c*qzQv?d!=k0v<MHEiRl{sJC~=csU}_l~wo@_qHl*n=
z+Q&I{73A?r4nWU;(4R6ACMHj3&3*sSIZNGNxa5uXU&Ldh-tc4oO9K~0Q3Oic>$u>C
z)sC2X$#c%}^G_CTBRQUPhxlk)Ey__YOHKD7FN;$X$SM01W@EaR8e%wv3Gn}88D;{I
z`TBoXgO~dOZL<8|K)CBm_jpT!fUUh2m#rYX7${qWCbik!U={&=|Bw|pu8nS+e|<<<
z?Z=(YoT$I`!M;Psz;rIa2{_YSFVs+v6k~1~Q|DxQX=cMJ07%e=dL&zkTz+5vu%Ja)
zyiF<`wNN(S^IB!yOQ7YHi|Mr|l6yfyej0x7;A*g48&3Z-52h2<uL=B@R9xR>%eXOs
z&LKsFVS^JRe6(^+3gO)H2O<SWOCv_8{ao@oSj6?96aIP3qXc(nVKGHainjQ6o!P`}
zt#m*iaqiABU*;zOiyOnePVIGhMIl3Hft^Kk7uh#p=U|{lXaRIX+^e=^B<e`M9-IHB
z+LE2~t^XI*R$~x*8%^Gvc)BRnvhyneT`<JF(LW!+dM0o**~Rg3u+#k4l`f!0o-!t|
zmzUq|gqNCQ<Vlb@jQQ}}-595g;f_PYY`?Nm4d8K}UUcA~oA?&n{<5g)UynE1?KF7K
zq%go%*%3oKv);5DTarNYKcH43GR{*11r6ti1x{}|Fw6JQ`MC-evSGEs-vw@9!6KyS
z`L_gcQe`M;f*z9$4^!HBY!%$kmrd~QE4Lzl{}Hb%l4e{~&OQaVlu`-wCd3yHqaNbw
zuZK{0gePYKu(t6kuMo8aV}{PH7!iOqU)bdDJDnZ^r5ar*gjNv9#~ry8<u>q~|At9r
z5m@d~m23+CiOrUQfV5ennn2pSbvguuaGeJz80mi|xfM(ir}6MvAnUAY7~c1AxdY-&
zA<ENPycw5V;Ci6_TG_*nc$Qko<yCvYQqOt|JC7V=#AT+?pCI-M*!c?n6+aj!hufT@
zG%=nL5e}XW*cw0k<o>HO*)(g#ct)eSj!lcU5T$nGuOWnM4I~y1AQ@|bcSiq1FD2$5
z`yWuGLe~Ezm)3r=2P8_M0j<*Vd8ls9*qZ(@-uH4FdF5G@ujgr!Cy=PX8G(w;S}dhq
zT!3C0&i((Wm!bfXck8NmvOS{~<GFP)D$T$@Pv>41g(-^GlrFqh7w2~d8bXdXMayO{
zlxP3w)yl{HZ;>>w9Tx=7t8tr)4?vH%MxsuBPto5RI+1l$^5+IzvKIMmjYutOM{<Z<
zch@uw2OJT!N7CAs2b@ee&*81CwP(*pDc*Qd4e1~*>`BT$+{>wePL$%neDd`fNRFc(
zLfBjmWpDt%mQD>sJxj>-Vm*ZCqg2uIJz#7pHcP4XC=(r{5OK#GUHD=tdM{W~228E2
zO6phHPxCdOQHl>WOEYk6d>J0PUacLX9-M7En11e^egXqm=v21+#TsV=(f^0cX^?_|
zz5@B{-s$AP#-Ct(?+yD$rZfdO0=ehLk?xWgYeaxGu_D)fuZy{9_5@phuUF8wuq*tv
zpc3}E9N(^~&8~ycm*fCO5CR%GxY8pAVrXEHumuPmos~oh0DN&h2jEL{003Wln3pFW
z6p_>zf(;x2wGQ|P8uyUuFQ{AZshfIXv(J%X3;RQTuXA;^QuFP+4a&WPfS=7^V8CBc
z`4BKeWGuMJGv$^SS&5pQ^I>G-c8P|iG(<ln8veflJ05sIqwh)a+0xlWIv>9HanGyr
z9Pz7}?@RtO)v=~O-mAP74x>^Bng~Peeu0}NIczs=kG};?&J9y@!*z9aOv@zi>Pcbl
zx<92=APC^=P))EDq5lgG1OQh=&ey|W^+3P72>E!m+{N#8zNZ|g$Qy14lj;iX{BRn$
zv;_olNN!8~+64hs8A-Ms2Pnz^)y9>_L-qY{k$sIRxn(RFrWF}2ghpI@j4dQ<GKNaB
z%bo~hiiuLP+@V3JL?U}7OEhC?vE@@riYXbg<$Fe-<@d+$Pp@%j&OPUS-rMs$Z!}p^
zD7(*>JU#r=VRa}3-Xld;{sgkR*+g>4=x~zyc9w;Ck!;jbzUPt8tY!AhN*igqlHl2O
zuCe(#b?(9(*VN;z`KK9cFy=dmoZXiK%O;zOiA8?LYku9TIhm%~U==NCyGtf0G~7D6
zIko&)wcPj#ylH8F2N6~EZs^eb2XVbwi}1z3fW){|a4QUJ@rVuIrvRR!7c^Z3ir(+d
z)-vjUWqlGaOU9&#HU9kmBmZZ}aLunN9=Y4^PbjQ?(d<<tWyC&ub!pYglPUPYy~i?2
z%l2SkOX#<;jG1)9G9gXVLd{xz9nz$pp`M2%dDF@NucFiHQuP28-OfCa?fJwy=|nDO
z<T@9dFJ|n#UuL=8d=07}CjmdJkO-4d8}LZ4npnb-`h@FOHm5&q6fuPg6RzhG!mS$t
z@1)!BloIPZ38yoDPDtAMJJ0O%_KZ~n)eOoeDP@4<9ePUfZxwwlE)%d&nDzV3#aJHx
zyAJnnanQ)1UmvS#ms)#PBVQ^AjWWeoSZ8&NRV~A#GjlfyZ|d4#r4{^b!ZJ<nPS}dd
zF);$d7#&eX2>A{`+l6Yy6H)rDTvu_mMyvK{AC&SgSETfewqDkj1EP?AUsWjsRD@P4
zBK#s<3p9Nt^XbK}73cqfFl$R&RVw<&S+|<nua3pr80uMfQi}UaD}FBkds@s*ysbN>
zd#*!x<~avL+{h&M<~dhr+bceIdQIH%Z_SsYyzH#I{7n}PYBr$K7(BzeRu`Df-mT2Q
zp0!)gAS&gqOh4+l-mQUQU6x9lxxE>*F7rL0poJgX3K&8P5cy+grq|@zZ>_l(TWIs6
zDx)5f={5y$dwz^)i8>VN%9F_LEH1%_(t!-092SQi5#s~aYdHi)(`hue)6wzPp+495
zfcSw%2=uN2tn%phk%(><`GLXLqnxmZ*~U?mV1+rgkiH`-pWyOzk3hvKX{R2sH)ijK
z>0`W8ac1vMl;&fm0QYD|H7y7HUwadw(!1xjhIhA=<srt<(DKI&%kEwSRi8FbMmqcl
zeN7JrU56SSs8BWD1Lt&KHJ(FmPF>hb3<dq;<|rIwF=kTFp<dU5-oSt3d;lQqXC-R(
zkfy>;$}#8Ah_7D$o&k`|L&ehT^Rx3+*zRQg5ExnBt-KG634lr&nt(;fhjWB-0=7pB
z;_hq$<_yZs{j>@~B`v3nQG{RaRf?E1|B~Cuj<#JBm|Urby(chJKoQ_;t><<4siGpM
z#3WHct<1<+%!6BnccpM@R6+-H!U)PFQsHx$@@Q85yfG3nKRt|O7PD3lNHQS9bmQxQ
z1;bF_5XL`Y>4XDn8_D~Afd1Cm(?5Q{H{tx4td%+$q?R>-H`Zw8d4EB}m7jCQxApX_
z{8Hy^deGkmX!0xKug<(QaI!{eTLpa{eqrJ*Zo^rW<+N<TEvX+QqT08Rs~<hmhJXOV
z`(S1J;pbLdbQ#9Le(W~W<e7l>1gb;h=QkLQxfROjx2~1Jv_-MMKk>YxdoA}KJhmU0
zfa*qaxqV7s#4A^AFB;(^X=!fi#Uw{<o68pKNJ=kwg4N7&#cnw;9=#g;`qrG(ou2+^
zDSa7&HFZD5q|kDs(l&AfMOZ8>rLQg{e1)dFjjR~(F{6~`9WztV=Ny&qr=}I}SQ8Mz
zhgCIwIWDdcSt8FaBBZuQv_uq%cBELJUr2b+eCUx%>XFk{F4XK!IsHXj{G<hvl<Zre
z61(<s`^unL`M~Y<|2!{4LTx510uH`JG2y3|)q%bNPRrUNW+))v+yD_{-VyTf4FvC@
z9Wt#%ZV9c1)gPofFw>4z?gW`ik~4E!OSH^8Yal&1pfh3b2C|lM?vA8-+A#3xH*em|
z4WHZ&?4-UVClxN0W)PE;U|E{wMp_bsPJBq(KA9=J@b@FchiL47e;Ti0?+3`-plrY@
z=Jst<kFnK88boT{TlpA7eFJ2>A{2B**G>Yk@!>BfIw*byKI9elTO#9RPya-E?xzOr
z?k~1x<z3_D7cyO+-up1pDCT-yp@4xZPK6l{ca=N0)NMRkI;cKf_jo9THQcVM0VW0M
zrX2lXLtmm=3d!DsKrptg7-}lQl642<*uOp)86ZB2kj2$+nkCs*(-kbu_5%eX54A9P
zU9v(Cdg)QE_eNBLM<TpFoj~RQFGfVwN4k)(;)@h89&R8P84o~qP7B34i?-N|a1ZwJ
z;qHjW;~PK-!jZB{<N6-J{o>=rm?^$)CPMg}I3qEfJg5#&QO2-7RJ8gtz}NC{dJ?Mc
zy>H#M*Yv1LOxN-9Na?Uaz1@8Y9Y(lpMHyezlnOI7s&2;VMEd@3eJ@}nEG2J5>Cp1g
zu{r5Fo=JCY&w|~3>&$5D$$zCULppxZDVH%&F}R{EQs8)5eZb0{3Es@FFfzF*e0Nj$
zhak<8X*JgZ*P_$b;M7i*62{Y-RPy<H-^@NwpE0yT-5}x`?zy$q?5uwzRcFb&l)}Do
zDVQ!j*d4*@S5caX!C2=&CkitkMEI$e*|;8o$QN1n2Tfl=6PbxPQiM%a>YHji2pmVd
zJyNrzp5c5P>FZ#gR$6E`Kz<|ysd<UBrP<aY`+Fbnk_>8+EQZPDwLHBGK8q%ivSj$0
z#EDsjV@Ry=OoL$-V6GVMeNF5dex#W!is==KD!G0Q{<$y64yIiH{a1Zz>J9?`uB(&1
z6Sh@*SCS)_CJD&ZG6S4b>&a5a3&ORQQC5{!e}MJsvPzmct|UABBp91vR1|1$bbc{q
zUNUm`a#1>+C)0SI0|vayH;Mx_M0g#$cV3qV4Q{9Vab!%c<H)9im4b9S?0Nihr1X&x
z+ygu{k+ZA;Iyx@lBT<i0?UY0E^O}@b0Q**SFWF5MdzbN|A(QjPH=t)~i~;Pak6xs{
zXzQ~S82{3j>U4P&3LaXrc^3@IzAvutXC6wd*-+s=w@yR7LqCEfh(R5waY#W>#)m5G
zOW88Pf=~05;Jxx19md(Ne2dvDNyUfxcWq!0NvJ;Tuv+}1(T0?VW#}i8UL(WC;Qpl7
z!y8LhxA=8lbjr!}Q-1keS%bWTJAqv^X1nK^WtM|su*l|6pJ$#UK|;YzlA!R~xP6Eb
zmjv6;0LHlwfML6>MIo|-!P8!B^c@#qg5WU0RZfD1nWrJcy)a^ozAo1h5AQ!S^kxbg
z57R$%!DSto0S6aB<3&>9xyQ~uc!ibTE~JYjZ!fWwA)gs-$N^9mK2U8W%A%*ADEh}+
z0l`xIY%%!Vuj_z2Q>BuLeR$x~*2*Vu_X=;L?{UEdP{fde!*#SBnR`zB=Nc+$vSr@$
zYq9fy*}L5?PaI&RUl_PO=?)k-DGyv{q2*+IeqJ6t_R5%}ZIUu6TJo|oU;`r7d5c+*
zH3zCneYyJUWq0rAaC<5JFal{$w7?e|-dMyK`D9Yhz&_z$!pB$92nJ~v0=)iv1cZr~
zK6=g91~m@<`%LkEvZ7~_gyWPTD|an&{Bh_5tb=on(RIS7z6g3+Q#W7?|L+6bCk3y9
z{!qD7eQg8JTKsShP{0h-|NN1Vq5XS_UiEm;wTu<Bw}6IK%{s*Q#b%-17>QMl-*Nfq
zW9sU({rTTzoxnGNoC0Iwikvd3YYLgnXW(ZmUnUp8h@lP$`gpn;coPspyNRgE^H<D~
zUj7oyl)j!tLDb409hG%CCm+I@Hb%+)PPlU|6MpH97>k%Fx-;nub&R>WU}7MLP`=Oa
zib=h^fSs7d<e0jMkh<2zA!Ecug}sYlhOl-P;7FU*czw8zBNC5SKF_aZ1iZ(QIiT<>
zY^>)`;K)hOK?#%%IcOk=-SSd2bcje*2HA**wKxDuOA5`h6cxHFz?*2U8*L`wkUI=I
z!k{4pPW}M8knzX!l-ZOLxieAbz9<vG5pP4rOjdvjib6ct$&oUz4-_;?P+`wD(-{-_
zM-nf9=4EUd;jowmjRDey*Bt%Kf+k?J0PXWRF>gm863cGFL1{qOR`fayC#0d=PY-*F
zyZ1$HD@mE%0JFhvg(CzdOOQNa)qaK(1BYvafZpoQjD>=#Dt6Ut7Y#^LBfO^j!anE~
z*6s2pgu%n_baqSNpy|rniII961;)>_CoWNqky&bcDx7o2{1tX~k!hwnwzazoyl4=Y
zYCV9d{i!z?gHRy@VCzyIu<I?DvenU7&%+w3$}C~6(ih`Zm{=Vzefukd8pZslT*S#9
zde!QFu)(bm&=miBOhzhqjyPwRq<#pHVO<YyJQ>}rIZ3e)mt{hBKf@hlu6i60vb5O?
zPFaqkpEY|AEyjzJPk?<IC}ArlcBNM&vJU?}u|p|TF!+J@ESGX&+boSBAOVS*Pkz7&
zNs>_Mr!HSY4`jeTI8$ilZBG<@>Dljr0s9)cw>n`nN^2uO{+Scv&Mm6Vu%dz)1_UO3
z<$@rpjNp9u81sqlQDpW9HXz3DtsI3J(?_I=q#OZ;6$%(-_T|o(&r66uXvRpb$G?z#
z!`B@f_Fm3`GkS%H1+|b2kST&06F}NV*DhA!OhajE4L|E*2?gn*c|Uz15c|}3!Nr@6
z8)unjK)2&m<3AS1D@=SV^;hvzTvqcC_I8rT(RW=(yY4zxPB*SbE#J(&;iG}L)UX<s
zLQA#ZzuP6)P=#qOQ&~5p=o$JxmOpf-&@@``{m90POYSEAtCn2ahCDq@`~1bacvhSA
z{WqkZ?3s`S&7x271Sa<B#2z1`uWvUz$;+vt$zp3tK<4zO+i_5=>QZ>y=~f+B3NL(9
zH!>W6A`g9fi;m`Kd38|R<f50=DMnHn2b1-#HMbHDQB(P)ezrYbRyZA%o4SgnL|0fG
znE%pT<tWgw|I44H#rwzac}m09^sFBnv6CDsjbB^Y`29Aw&7pkNvFF{;ZX=&3rY?5<
z296P0WqJgwu`08lWdpPVg(fp?l!2(1V&v}OMuF7_f^P3UC`aMWetl#?t@y@_r=F-W
zJJpqJHyZjuRHO`KwQM%}E0}1JtVwtR@s3<be+4}&Iq8-yamo<YDb)*r^6IqcpOw2#
zyX+BvGI&hTU*;?(=6o)?!l2pCS>WI81Z#Gw5_0-jhP5|pj#L(yFW2{X6>X{45}03=
z_e+-lMrD6>|Fe8~%!@XeWM=Bf1vS#CS+KR)j8X=@j9?W9zidOULYQOed#;*weKkS4
zskved26=?Lz<FqMjeXo*a-6T0z^IgPLlFK~HUAi&wZIu?{F@?tO_eg2s4T)m`msKQ
znmSg#^`hn#u4?0rG567&)w)VL8{upAX<RyfiTBZM`JrEuO`_p!l892+f9IdiJKrzA
zw%6h<MM>)}#d^DK3BZ0l0u?5j;gG~Ou7l)Lvt#0L1_@<ALY;dH;v*Fu(>O&j$|o=}
zGs#<zAl(i?3dKj8%^^@T-Uq0}j9!ZKw~&rIdqSe26<@O(6}ROWH)o|~a+NBRd|~f@
zQ_**0XWib~Zte09+qv%6>sgM4?(>jn7)^LTAa!x{O}u}KNQ-D~)yDIr5mS-*8}dVS
zarcyW*Ld@dxyW8zispW^Jsc~vX0b6Bx~xzx0hbEqa<y)V!(**L#jusk4X!3t@L&ww
zevJ#loKS3|5z_Cf-_?=Vw26r8l)dPS5oi?U9n0RcezaEpLSnrCae<by=W&B>+%<wK
zV4+aqnJfI$I{2E;*Vc!OTf3*&u6u?3V*t)KG0h?B0;4Q_|F42AWYu*;dBQ%_IwS6y
z5MD5$N?^JlU$e^ZZnNI~jze!4GfgJB#TbXugc1gB$>@CJ7kvPn;6kItl5$_sfXX>A
Qf|tw0@Tft#zFXY?0K=D0BLDyZ

literal 0
HcmV?d00001

diff --git a/docs/topics/recipes.md b/docs/topics/recipes.md
index afa3dcc8..04a4e6aa 100644
--- a/docs/topics/recipes.md
+++ b/docs/topics/recipes.md
@@ -1332,22 +1332,72 @@ rows (default), or above. The following code adds the summary above:
 $spreadsheet->getActiveSheet()->setShowSummaryBelow(false);
 ```
 
-## Merge/unmerge cells
+## Merge/Unmerge cells
 
-If you have a big piece of data you want to display in a worksheet, you
-can merge two or more cells together, to become one cell. This can be
-done using the following code:
+If you have a big piece of data you want to display in a worksheet, or a
+heading that needs to span multiple sub-heading columns, you can merge
+two or more cells together, to become one cell. This can be done using
+the following code:
 
 ```php
 $spreadsheet->getActiveSheet()->mergeCells('A18:E22');
 ```
 
-Removing a merge can be done using the unmergeCells method:
+Removing a merge can be done using the `unmergeCells()` method:
 
 ```php
 $spreadsheet->getActiveSheet()->unmergeCells('A18:E22');
 ```
 
+MS Excel itself doesn't yet offer the functionality to simply hide the merged cells, or to merge the content of cells into a single cell, but it is available in Open/Libre Office.
+
+### Merge with MERGE_CELL_CONTENT_EMPTY
+
+The default behaviour is to empty all cells except for the top-left corner cell in the merge range; and this is also the default behaviour for the `mergeCells()` method in PhpSpreadsheet.
+When this behaviour is applied, those cell values will be set to null; and if they are subsequently Unmerged, they will be empty cells.
+
+Passing an extra flag value to the `mergeCells()` method in PhpSpreadsheet can change this behaviour.
+
+![12-01-MergeCells-Options.png](./images/12-01-MergeCells-Options.png)
+
+Possible flag values are:
+- Worksheet::MERGE_CELL_CONTENT_EMPTY (the default)
+- Worksheet::MERGE_CELL_CONTENT_HIDE
+- Worksheet::MERGE_CELL_CONTENT_MERGE
+
+### Merge with MERGE_CELL_CONTENT_HIDE
+
+The first alternative, available only in OpenOffice, is to hide those cells, but to leave their content intact.
+When a file saved as `Xlsx` in those applications is opened in MS Excel, and those cells are unmerged, the original content will still be present.
+
+```php
+$spreadsheet->getActiveSheet()->mergeCells('A1:C3', Worksheet::MERGE_CELL_CONTENT_HIDE);
+```
+
+Will replicate that behaviour.
+
+### Merge with MERGE_CELL_CONTENT_MERGE
+
+The second alternative, available in both OpenOffice and LibreOffice is to merge the content of every cell in the merge range into the top-left cell, while setting those hidden cells to empty.
+
+```php
+$spreadsheet->getActiveSheet()->mergeCells('A1:C3', Worksheet::MERGE_CELL_CONTENT_MERGE);
+```
+
+Particularly when the merged cells contain formulae, the logic for this merge seems strange:
+walking through the merge range, each cell is calculated in turn, and appended to the "master" cell, then it is emptied, so any subsequent calculations that reference the cell see an empty cell, not the pre-merge value. 
+For example, suppose our spreadsheet contains
+
+![12-01-MergeCells-Options-2.png](./images/12-01-MergeCells-Options-2.png)
+
+where `B2` is the formula `=5-B1` and `C2` is the formula `=A2/B2`,
+and we want to merge cells `A2` to `C2` with all the cell values merged.
+The result is:
+
+![12-01-MergeCells-Options-3.png](./images/12-01-MergeCells-Options-3.png)
+
+The cell value `12` from cell `A2` is fixed; the value from `B2` is the result of the formula `=5-B1` (`4`, which is appended to our merged value), and cell `B2` is then emptied, so when we evaluate cell `C2` with the formula `=A2/B2` it gives us `12 / 0` which results in a `#DIV/0!` error (so the error `#DIV/0!` is appended to our merged value rather than the original calculation result of `3`).
+
 ## Inserting or Removing rows/columns
 
 You can insert/remove rows/columns at a specific position. The following
diff --git a/src/PhpSpreadsheet/Reader/Gnumeric.php b/src/PhpSpreadsheet/Reader/Gnumeric.php
index ca087e61..1dcb0a12 100644
--- a/src/PhpSpreadsheet/Reader/Gnumeric.php
+++ b/src/PhpSpreadsheet/Reader/Gnumeric.php
@@ -363,7 +363,7 @@ class Gnumeric extends BaseReader
         if ($sheet !== null && isset($sheet->MergedRegions)) {
             foreach ($sheet->MergedRegions->Merge as $mergeCells) {
                 if (strpos((string) $mergeCells, ':') !== false) {
-                    $this->spreadsheet->getActiveSheet()->mergeCells($mergeCells);
+                    $this->spreadsheet->getActiveSheet()->mergeCells($mergeCells, Worksheet::MERGE_CELL_CONTENT_HIDE);
                 }
             }
         }
diff --git a/src/PhpSpreadsheet/Reader/Ods.php b/src/PhpSpreadsheet/Reader/Ods.php
index 7e776ab7..e3de4731 100644
--- a/src/PhpSpreadsheet/Reader/Ods.php
+++ b/src/PhpSpreadsheet/Reader/Ods.php
@@ -20,6 +20,7 @@ use PhpOffice\PhpSpreadsheet\Shared\Date;
 use PhpOffice\PhpSpreadsheet\Shared\File;
 use PhpOffice\PhpSpreadsheet\Spreadsheet;
 use PhpOffice\PhpSpreadsheet\Style\NumberFormat;
+use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
 use Throwable;
 use XMLReader;
 use ZipArchive;
@@ -759,7 +760,7 @@ class Ods extends BaseReader
                 }
 
                 $cellRange = $columnID . $rowID . ':' . $columnTo . $rowTo;
-                $spreadsheet->getActiveSheet()->mergeCells($cellRange);
+                $spreadsheet->getActiveSheet()->mergeCells($cellRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
             }
         }
     }
diff --git a/src/PhpSpreadsheet/Reader/Xls.php b/src/PhpSpreadsheet/Reader/Xls.php
index 71496ece..a8de5228 100644
--- a/src/PhpSpreadsheet/Reader/Xls.php
+++ b/src/PhpSpreadsheet/Reader/Xls.php
@@ -4585,7 +4585,7 @@ class Xls extends BaseReader
                     (strpos($cellRangeAddress, ':') !== false) &&
                     ($this->includeCellRangeFiltered($cellRangeAddress))
                 ) {
-                    $this->phpSheet->mergeCells($cellRangeAddress);
+                    $this->phpSheet->mergeCells($cellRangeAddress, Worksheet::MERGE_CELL_CONTENT_HIDE);
                 }
             }
         }
diff --git a/src/PhpSpreadsheet/Reader/Xlsx.php b/src/PhpSpreadsheet/Reader/Xlsx.php
index fc38375a..26cd1af3 100644
--- a/src/PhpSpreadsheet/Reader/Xlsx.php
+++ b/src/PhpSpreadsheet/Reader/Xlsx.php
@@ -914,7 +914,7 @@ class Xlsx extends BaseReader
                                 foreach ($xmlSheet->mergeCells->mergeCell as $mergeCell) {
                                     $mergeRef = (string) $mergeCell['ref'];
                                     if (strpos($mergeRef, ':') !== false) {
-                                        $docSheet->mergeCells((string) $mergeCell['ref']);
+                                        $docSheet->mergeCells((string) $mergeCell['ref'], Worksheet::MERGE_CELL_CONTENT_HIDE);
                                     }
                                 }
                             }
diff --git a/src/PhpSpreadsheet/Reader/Xml.php b/src/PhpSpreadsheet/Reader/Xml.php
index 0b5e0966..d8f0d9dc 100644
--- a/src/PhpSpreadsheet/Reader/Xml.php
+++ b/src/PhpSpreadsheet/Reader/Xml.php
@@ -18,6 +18,7 @@ use PhpOffice\PhpSpreadsheet\Shared\Date;
 use PhpOffice\PhpSpreadsheet\Shared\File;
 use PhpOffice\PhpSpreadsheet\Shared\StringHelper;
 use PhpOffice\PhpSpreadsheet\Spreadsheet;
+use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
 use SimpleXMLElement;
 
 /**
@@ -364,7 +365,7 @@ class Xml extends BaseReader
                                 $rowTo = $rowTo + $cell_ss['MergeDown'];
                             }
                             $cellRange .= ':' . $columnTo . $rowTo;
-                            $spreadsheet->getActiveSheet()->mergeCells($cellRange);
+                            $spreadsheet->getActiveSheet()->mergeCells($cellRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
                         }
 
                         $hasCalculatedValue = false;
diff --git a/src/PhpSpreadsheet/Worksheet/Worksheet.php b/src/PhpSpreadsheet/Worksheet/Worksheet.php
index d13d4141..55327932 100644
--- a/src/PhpSpreadsheet/Worksheet/Worksheet.php
+++ b/src/PhpSpreadsheet/Worksheet/Worksheet.php
@@ -41,6 +41,10 @@ class Worksheet implements IComparable
     public const SHEETSTATE_HIDDEN = 'hidden';
     public const SHEETSTATE_VERYHIDDEN = 'veryHidden';
 
+    public const MERGE_CELL_CONTENT_EMPTY = 'empty';
+    public const MERGE_CELL_CONTENT_HIDE = 'hide';
+    public const MERGE_CELL_CONTENT_MERGE = 'merge';
+
     protected const SHEET_NAME_REQUIRES_NO_QUOTES = '/^[_\p{L}][_\p{L}\p{N}]*$/mui';
 
     /**
@@ -1758,10 +1762,15 @@ class Worksheet implements IComparable
      * @param AddressRange|array<int>|string $range A simple string containing a Cell range like 'A1:E10'
      *              or passing in an array of [$fromColumnIndex, $fromRow, $toColumnIndex, $toRow] (e.g. [3, 5, 6, 8]),
      *              or an AddressRange.
+     * @param string $behaviour How the merged cells should behave.
+     *               Possible values are:
+     *                   MERGE_CELL_CONTENT_EMPTY - Empty the content of the hidden cells
+     *                   MERGE_CELL_CONTENT_HIDE - Keep the content of the hidden cells
+     *                   MERGE_CELL_CONTENT_MERGE - Move the content of the hidden cells into the first cell
      *
      * @return $this
      */
-    public function mergeCells($range)
+    public function mergeCells($range, $behaviour = self::MERGE_CELL_CONTENT_EMPTY)
     {
         $range = Functions::trimSheetFromCellReference(Validations::validateCellRange($range));
 
@@ -1793,18 +1802,22 @@ class Worksheet implements IComparable
             $this->getCell($upperLeft)->setValueExplicit(null, DataType::TYPE_NULL);
         }
 
-        // Blank out the rest of the cells in the range (if they exist)
-        if ($numberRows > $numberColumns) {
-            $this->clearMergeCellsByColumn($firstColumn, $lastColumn, $firstRow, $lastRow, $upperLeft);
-        } else {
-            $this->clearMergeCellsByRow($firstColumn, $lastColumnIndex, $firstRow, $lastRow, $upperLeft);
+        if ($behaviour !== self::MERGE_CELL_CONTENT_HIDE) {
+            // Blank out the rest of the cells in the range (if they exist)
+            if ($numberRows > $numberColumns) {
+                $this->clearMergeCellsByColumn($firstColumn, $lastColumn, $firstRow, $lastRow, $upperLeft, $behaviour);
+            } else {
+                $this->clearMergeCellsByRow($firstColumn, $lastColumnIndex, $firstRow, $lastRow, $upperLeft, $behaviour);
+            }
         }
 
         return $this;
     }
 
-    private function clearMergeCellsByColumn(string $firstColumn, string $lastColumn, int $firstRow, int $lastRow, string $upperLeft): void
+    private function clearMergeCellsByColumn(string $firstColumn, string $lastColumn, int $firstRow, int $lastRow, string $upperLeft, string $behaviour): void
     {
+        $leftCellValue = [$this->getCell($upperLeft)->getFormattedValue()];
+
         foreach ($this->getColumnIterator($firstColumn, $lastColumn) as $column) {
             $iterator = $column->getCellIterator($firstRow);
             $iterator->setIterateOnlyExistingCells(true);
@@ -1814,17 +1827,21 @@ class Worksheet implements IComparable
                     if ($row > $lastRow) {
                         break;
                     }
-                    $thisCell = $cell->getColumn() . $row;
-                    if ($upperLeft !== $thisCell) {
-                        $cell->setValueExplicit(null, DataType::TYPE_NULL);
-                    }
+                    $leftCellValue = $this->mergeCellBehaviour($cell, $upperLeft, $behaviour, $leftCellValue);
                 }
             }
         }
+
+        $leftCellValue = implode(' ', $leftCellValue);
+        if ($behaviour === self::MERGE_CELL_CONTENT_MERGE) {
+            $this->getCell($upperLeft)->setValueExplicit($leftCellValue, DataType::TYPE_STRING);
+        }
     }
 
-    private function clearMergeCellsByRow(string $firstColumn, int $lastColumnIndex, int $firstRow, int $lastRow, string $upperLeft): void
+    private function clearMergeCellsByRow(string $firstColumn, int $lastColumnIndex, int $firstRow, int $lastRow, string $upperLeft, string $behaviour): void
     {
+        $leftCellValue = [$this->getCell($upperLeft)->getFormattedValue()];
+
         foreach ($this->getRowIterator($firstRow, $lastRow) as $row) {
             $iterator = $row->getCellIterator($firstColumn);
             $iterator->setIterateOnlyExistingCells(true);
@@ -1835,13 +1852,31 @@ class Worksheet implements IComparable
                     if ($columnIndex > $lastColumnIndex) {
                         break;
                     }
-                    $thisCell = $column . $cell->getRow();
-                    if ($upperLeft !== $thisCell) {
-                        $cell->setValueExplicit(null, DataType::TYPE_NULL);
-                    }
+                    $leftCellValue = $this->mergeCellBehaviour($cell, $upperLeft, $behaviour, $leftCellValue);
                 }
             }
         }
+
+        $leftCellValue = implode(' ', $leftCellValue);
+        if ($behaviour === self::MERGE_CELL_CONTENT_MERGE) {
+            $this->getCell($upperLeft)->setValueExplicit($leftCellValue, DataType::TYPE_STRING);
+        }
+    }
+
+    public function mergeCellBehaviour(Cell $cell, string $upperLeft, string $behaviour, array $leftCellValue): array
+    {
+        if ($cell->getCoordinate() !== $upperLeft) {
+            Calculation::getInstance($cell->getWorksheet()->getParent())->flushInstance();
+            if ($behaviour === self::MERGE_CELL_CONTENT_MERGE) {
+                $cellValue = $cell->getFormattedValue();
+                if ($cellValue !== '') {
+                    $leftCellValue[] = $cellValue;
+                }
+            }
+            $cell->setValueExplicit(null, DataType::TYPE_NULL);
+        }
+
+        return $leftCellValue;
     }
 
     /**
@@ -1856,17 +1891,22 @@ class Worksheet implements IComparable
      * @param int $row1 Numeric row coordinate of the first cell
      * @param int $columnIndex2 Numeric column coordinate of the last cell
      * @param int $row2 Numeric row coordinate of the last cell
+     * @param string $behaviour How the merged cells should behave.
+     *               Possible values are:
+     *                   MERGE_CELL_CONTENT_EMPTY - Empty the content of the hidden cells
+     *                   MERGE_CELL_CONTENT_HIDE - Keep the content of the hidden cells
+     *                   MERGE_CELL_CONTENT_MERGE - Move the content of the hidden cells into the first cell
      *
      * @return $this
      */
-    public function mergeCellsByColumnAndRow($columnIndex1, $row1, $columnIndex2, $row2)
+    public function mergeCellsByColumnAndRow($columnIndex1, $row1, $columnIndex2, $row2, $behaviour = self::MERGE_CELL_CONTENT_EMPTY)
     {
         $cellRange = new CellRange(
             CellAddress::fromColumnAndRow($columnIndex1, $row1),
             CellAddress::fromColumnAndRow($columnIndex2, $row2)
         );
 
-        return $this->mergeCells($cellRange);
+        return $this->mergeCells($cellRange, $behaviour);
     }
 
     /**
diff --git a/tests/PhpSpreadsheetTests/Worksheet/MergeBehaviourTest.php b/tests/PhpSpreadsheetTests/Worksheet/MergeBehaviourTest.php
new file mode 100644
index 00000000..68c9d87a
--- /dev/null
+++ b/tests/PhpSpreadsheetTests/Worksheet/MergeBehaviourTest.php
@@ -0,0 +1,166 @@
+<?php
+
+namespace PhpOffice\PhpSpreadsheetTests\Worksheet;
+
+use PhpOffice\PhpSpreadsheet\Spreadsheet;
+use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
+use PhpOffice\PhpSpreadsheetTests\Functional\AbstractFunctional;
+
+class MergeBehaviourTest extends AbstractFunctional
+{
+    /**
+     * @var array
+     */
+    private $testDataRaw = [
+        [1.1, 2.2, '=ROUND(A1+B1, 1)'],
+        [4.4, 5.5, '=ROUND(A2+B2, 1)'],
+        ['=ROUND(A1+A2, 1)', '=ROUND(B1+B2, 1)', '=ROUND(A3+B3, 1)'],
+    ];
+
+    /**
+     * @var array
+     */
+    private $testDataFormatted = [
+        ['=DATE(1960, 12, 19)', '=DATE(2022, 09, 15)'],
+    ];
+
+    public function testMergeCellsDefaultBehaviour(): void
+    {
+        $expectedResult = [
+            [1.1, null, null],
+            [null, null, null],
+            [null, null, null],
+        ];
+
+        $mergeRange = 'A1:C3';
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($this->testDataRaw, null, 'A1', true);
+        $worksheet->mergeCells($mergeRange);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+
+    public function testMergeCellsDefaultBehaviourFormatted(): void
+    {
+        $expectedResult = [
+            ['1960-12-19', null],
+        ];
+
+        $mergeRange = 'A1:B1';
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($this->testDataFormatted, null, 'A1', true);
+        $worksheet->getStyle($mergeRange)->getNumberFormat()->setFormatCode('yyyy-mm-dd');
+        $worksheet->mergeCells($mergeRange);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+
+    public function testMergeCellsHideBehaviour(): void
+    {
+        $expectedResult = [
+            [1.1, 2.2, 3.3],
+            [4.4, 5.5, 9.9],
+            [5.5, 7.7, 13.2],
+        ];
+
+        $mergeRange = 'A1:C3';
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($this->testDataRaw, null, 'A1', true);
+        $worksheet->mergeCells($mergeRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+
+    public function testMergeCellsHideBehaviourFormatted(): void
+    {
+        $expectedResult = [
+            ['1960-12-19', '2022-09-15'],
+        ];
+
+        $mergeRange = 'A1:B1';
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($this->testDataFormatted, null, 'A1', true);
+        $worksheet->getStyle($mergeRange)->getNumberFormat()->setFormatCode('yyyy-mm-dd');
+        $worksheet->mergeCells($mergeRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+
+    /**
+     * @dataProvider mergeCellsMergeBehaviourProvider
+     */
+    public function testMergeCellsMergeBehaviour(array $testData, string $mergeRange, array $expectedResult): void
+    {
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($testData, null, 'A1', true);
+        // Force a precalculation to populate the calculation cache, so that we can verify that it is being cleared
+        $worksheet->toArray();
+        $worksheet->mergeCells($mergeRange, Worksheet::MERGE_CELL_CONTENT_MERGE);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+
+    public function mergeCellsMergeBehaviourProvider(): array
+    {
+        return [
+            'With Calculated Values' => [
+                $this->testDataRaw,
+                'A1:C3',
+                [
+                    ['1.1 2.2 1.1 4.4 5.5 0 1.1 0 0', null, null],
+                    [null, null, null],
+                    [null, null, null],
+                ],
+            ],
+            'With Empty Cells' => [
+                [
+                    [1, '', 2],
+                    [null, 3, null],
+                    [4, null, 5],
+                ],
+                'A1:C3',
+                [
+                    ['1 2 3 4 5', null, null],
+                    [null, null, null],
+                    [null, null, null],
+                ],
+            ],
+            [
+                [
+                    [12, '=5+1', '=A1/A2'],
+                ],
+                'A1:C1',
+                [
+                    ['12 6 #DIV/0!', null, null],
+                ],
+            ],
+        ];
+    }
+
+    public function testMergeCellsMergeBehaviourFormatted(): void
+    {
+        $expectedResult = [
+            ['1960-12-19 2022-09-15', null],
+        ];
+
+        $mergeRange = 'A1:B1';
+        $spreadsheet = new Spreadsheet();
+        $worksheet = $spreadsheet->getActiveSheet();
+        $worksheet->fromArray($this->testDataFormatted, null, 'A1', true);
+        $worksheet->getStyle($mergeRange)->getNumberFormat()->setFormatCode('yyyy-mm-dd');
+        $worksheet->mergeCells($mergeRange, Worksheet::MERGE_CELL_CONTENT_MERGE);
+
+        $mergeResult = $worksheet->toArray(null, true, true, false);
+        self::assertSame($expectedResult, $mergeResult);
+    }
+}