From c8d3ff055c220ef12e22bcf013d05132456a9ce8 Mon Sep 17 00:00:00 2001
From: "Fletcher T. Penney" <fletcher@fletcherpenney.net>
Date: Wed, 15 Mar 2017 11:35:06 -0400
Subject: [PATCH] CHANGED: Update documentation

---
 DevelopmentNotes/DevelopmentNotes.epub |  Bin 0 -> 13645 bytes
 DevelopmentNotes/DevelopmentNotes.fodt | 1311 ++++++++++++++++++++++++
 DevelopmentNotes/DevelopmentNotes.html |  599 +++++++++++
 DevelopmentNotes/DevelopmentNotes.pdf  |  Bin 0 -> 103994 bytes
 DevelopmentNotes/DevelopmentNotes.txt  |  184 +++-
 README.md                              |  305 +-----
 templates/README.md.in                 |  305 +-----
 7 files changed, 2198 insertions(+), 506 deletions(-)
 create mode 100644 DevelopmentNotes/DevelopmentNotes.epub
 create mode 100644 DevelopmentNotes/DevelopmentNotes.fodt
 create mode 100644 DevelopmentNotes/DevelopmentNotes.html
 create mode 100644 DevelopmentNotes/DevelopmentNotes.pdf

diff --git a/DevelopmentNotes/DevelopmentNotes.epub b/DevelopmentNotes/DevelopmentNotes.epub
new file mode 100644
index 0000000000000000000000000000000000000000..1c2e6680623101d2a8162b0fadd025cdb62116cc
GIT binary patch
literal 13645
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

literal 0
HcmV?d00001

diff --git a/DevelopmentNotes/DevelopmentNotes.fodt b/DevelopmentNotes/DevelopmentNotes.fodt
new file mode 100644
index 0000000..092949d
--- /dev/null
+++ b/DevelopmentNotes/DevelopmentNotes.fodt
@@ -0,0 +1,1311 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<office:document xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0"
+     xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0"
+     xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0"
+     xmlns:table="urn:oasis:names:tc:opendocument:xmlns:table:1.0"
+     xmlns:draw="urn:oasis:names:tc:opendocument:xmlns:drawing:1.0"
+     xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0"
+     xmlns:xlink="http://www.w3.org/1999/xlink"
+     xmlns:dc="http://purl.org/dc/elements/1.1/"
+     xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0"
+     xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0"
+     xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0"
+     xmlns:chart="urn:oasis:names:tc:opendocument:xmlns:chart:1.0"
+     xmlns:dr3d="urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0"
+     xmlns:math="http://www.w3.org/1998/Math/MathML"
+     xmlns:form="urn:oasis:names:tc:opendocument:xmlns:form:1.0"
+     xmlns:script="urn:oasis:names:tc:opendocument:xmlns:script:1.0"
+     xmlns:config="urn:oasis:names:tc:opendocument:xmlns:config:1.0"
+     xmlns:ooo="http://openoffice.org/2004/office"
+     xmlns:ooow="http://openoffice.org/2004/writer"
+     xmlns:oooc="http://openoffice.org/2004/calc"
+     xmlns:dom="http://www.w3.org/2001/xml-events"
+     xmlns:xforms="http://www.w3.org/2002/xforms"
+     xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xmlns:rpt="http://openoffice.org/2005/report"
+     xmlns:of="urn:oasis:names:tc:opendocument:xmlns:of:1.2"
+     xmlns:xhtml="http://www.w3.org/1999/xhtml"
+     xmlns:grddl="http://www.w3.org/2003/g/data-view#"
+     xmlns:tableooo="http://openoffice.org/2009/table"
+     xmlns:field="urn:openoffice:names:experimental:ooo-ms-interop:xmlns:field:1.0"
+     xmlns:formx="urn:openoffice:names:experimental:ooxml-odf-interop:xmlns:form:1.0"
+     xmlns:css3t="http://www.w3.org/TR/css3-text/"
+     office:version="1.2"
+     grddl:transformation="http://docs.oasis-open.org/office/1.2/xslt/odf2rdf.xsl"
+     office:mimetype="application/vnd.oasis.opendocument.text">
+<office:font-face-decls>
+   <style:font-face style:name="Courier New" svg:font-family="'Courier New'"
+                    style:font-adornments="Regular"
+                    style:font-family-generic="modern"
+                    style:font-pitch="fixed"/>
+</office:font-face-decls>
+<office:styles>
+<style:style style:name="Standard" style:family="paragraph" style:class="text">
+      <style:paragraph-properties fo:margin-top="0in" fo:margin-bottom="0.15in"     fo:text-align="justify" style:justify-single-word="false"/>
+   </style:style>
+<style:style style:name="Preformatted_20_Text" style:display-name="Preformatted Text"
+             style:family="paragraph"
+             style:parent-style-name="Standard"
+             style:class="html">
+   <style:paragraph-properties fo:margin-top="0in" fo:margin-bottom="0in" fo:text-align="start"
+                               style:justify-single-word="false"/>
+   <style:text-properties style:font-name="Courier New" fo:font-size="11pt"
+                          style:font-name-asian="Courier New"
+                          style:font-size-asian="11pt"
+                          style:font-name-complex="Courier New"
+                          style:font-size-complex="11pt"/>
+</style:style>
+<style:style style:name="Source_20_Text" style:display-name="Source Text"
+             style:family="text">
+   <style:text-properties style:font-name="Courier New" style:font-name-asian="Courier New"
+                          style:font-name-complex="Courier New"
+                          fo:font-size="11pt"/>
+</style:style>
+<style:style style:name="List" style:family="paragraph"
+             style:parent-style-name="Standard"
+             style:class="list">
+   <style:paragraph-properties fo:text-align="start" style:justify-single-word="false"/>
+   <style:text-properties style:font-size-asian="12pt"/>
+</style:style>
+<style:style style:name="Quotations" style:family="paragraph"
+             style:parent-style-name="Standard"
+             style:class="html">
+   <style:paragraph-properties fo:margin-left="0.3937in" fo:margin-right="0.3937in" fo:margin-top="0in"
+                               fo:margin-bottom="0.1965in"
+                               fo:text-align="justify"                               style:justify-single-word="false"                               fo:text-indent="0in"
+                               style:auto-text-indent="false"/>
+</style:style>
+<style:style style:name="Table_20_Heading" style:display-name="Table Heading"
+             style:family="paragraph"
+             style:parent-style-name="Table_20_Contents"
+             style:class="extra">
+   <style:paragraph-properties fo:text-align="center" style:justify-single-word="false"
+                               text:number-lines="false"
+                               text:line-number="0"/>
+   <style:text-properties fo:font-weight="bold" style:font-weight-asian="bold"
+                          style:font-weight-complex="bold"/>
+</style:style>
+<style:style style:name="Horizontal_20_Line" style:display-name="Horizontal Line"
+             style:family="paragraph"
+             style:parent-style-name="Standard"
+             style:class="html">
+   <style:paragraph-properties fo:margin-top="0in" fo:margin-bottom="0.1965in"
+                               style:border-line-width-bottom="0.0008in 0.0138in 0.0008in"
+                               fo:padding="0in"
+                               fo:border-left="none"
+                               fo:border-right="none"
+                               fo:border-top="none"
+                               fo:border-bottom="0.0154in double #808080"
+                               text:number-lines="false"
+                               text:line-number="0"
+                               style:join-border="false"/>
+   <style:text-properties fo:font-size="6pt" style:font-size-asian="6pt" style:font-size-complex="6pt"/>
+</style:style>
+<style:style style:name="Footnote_20_anchor" style:display-name="Footnote anchor"              style:family="text">    <style:text-properties style:text-position="super 58%"/> </style:style>
+<style:style style:name="TOC_Item" style:family="paragraph" style:parent-style-name="Standard">
+ <style:paragraph-properties>
+  <style:tab-stops>
+   <style:tab-stop style:position="6.7283in" style:type="right" style:leader-style="dotted" style:leader-text="."/>
+  </style:tab-stops>
+ </style:paragraph-properties>
+</style:style>
+  <text:notes-configuration text:note-class="footnote" text:default-style-name="Footnote" text:citation-style-name="Footnote_20_Symbol" text:citation-body-style-name="Footnote_20_anchor" text:master-page-name="Footnote" style:num-format="a" text:start-value="0" text:footnotes-position="page" text:start-numbering-at="page"/>
+  <text:notes-configuration text:note-class="endnote" text:default-style-name="Endnote" text:citation-style-name="Endnote_20_Symbol" text:citation-body-style-name="Endnote_20_anchor" text:master-page-name="Endnote" style:num-format="1" text:start-value="0"/>
+</office:styles>
+<office:automatic-styles>   <style:style style:name="MMD-Italic" style:family="text">
+      <style:text-properties fo:font-style="italic" style:font-style-asian="italic"
+                             style:font-style-complex="italic"/>
+   </style:style>
+   <style:style style:name="MMD-Bold" style:family="text">
+      <style:text-properties fo:font-weight="bold" style:font-weight-asian="bold"
+                             style:font-weight-complex="bold"/>
+   </style:style>
+   <style:style style:name="MMD-Superscript" style:family="text">
+      <style:text-properties style:text-position="super 58%"/>
+   </style:style>
+   <style:style style:name="MMD-Subscript" style:family="text">
+      <style:text-properties style:text-position="sub 58%"/>
+   </style:style>
+   <style:style style:name="Strike" style:family="text">
+      <style:text-properties style:text-line-through-style="solid" />
+   </style:style>
+   <style:style style:name="Underline" style:family="text">
+      <style:text-properties style:text-underline-style="solid" style:text-underline-color="font-color"/>
+   </style:style>
+   <style:style style:name="Highlight" style:family="text">
+      <style:text-properties fo:background-color="#FFFF00" />
+   </style:style>
+   <style:style style:name="Comment" style:family="text">
+      <style:text-properties fo:color="#0000BB" />
+   </style:style>
+<style:style style:name="MMD-Table" style:family="paragraph" style:parent-style-name="Standard">
+   <style:paragraph-properties fo:margin-top="0in" fo:margin-bottom="0.05in"/>
+</style:style>
+<style:style style:name="MMD-Table-Center" style:family="paragraph" style:parent-style-name="MMD-Table">
+   <style:paragraph-properties fo:text-align="center" style:justify-single-word="false"/>
+</style:style>
+<style:style style:name="MMD-Table-Right" style:family="paragraph" style:parent-style-name="MMD-Table">
+   <style:paragraph-properties fo:text-align="right" style:justify-single-word="false"/>
+</style:style>
+<style:style style:name="P2" style:family="paragraph" style:parent-style-name="Standard"
+             style:list-style-name="L2">
+<style:paragraph-properties fo:text-align="start" style:justify-single-word="false"/>
+</style:style>
+<style:style style:name="fr1" style:family="graphic" style:parent-style-name="Frame">
+   <style:graphic-properties style:print-content="true" style:vertical-pos="top"
+                             style:vertical-rel="baseline"
+                             fo:padding="0in"
+                             fo:border="none"
+                             style:shadow="none"/>
+</style:style>
+<style:style style:name="P1" style:family="paragraph" style:parent-style-name="Standard"
+             style:list-style-name="L1"/>
+<text:list-style style:name="L1">
+	<text:list-level-style-bullet text:level="1" text:style-name="Numbering_20_Symbols" style:num-suffix="." text:bullet-char="•">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="0.5in" fo:text-indent="-0.25in" fo:margin-left="0.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-bullet>
+	<text:list-level-style-bullet text:level="2" text:style-name="Numbering_20_Symbols" style:num-suffix="." text:bullet-char="◦">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="0.75in" fo:text-indent="-0.25in" fo:margin-left="0.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-bullet>
+	<text:list-level-style-bullet text:level="3" text:style-name="Numbering_20_Symbols" style:num-suffix="." text:bullet-char="▪">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1in" fo:text-indent="-0.25in" fo:margin-left="1in"/>
+		</style:list-level-properties>
+	</text:list-level-style-bullet>
+	<text:list-level-style-number text:level="4" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.25in" fo:text-indent="-0.25in" fo:margin-left="1.25in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="5" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.5in" fo:text-indent="-0.25in" fo:margin-left="1.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="6" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.75in" fo:text-indent="-0.25in" fo:margin-left="1.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="7" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2in" fo:text-indent="-0.25in" fo:margin-left="2in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="8" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.25in" fo:text-indent="-0.25in" fo:margin-left="2.25in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="9" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.5in" fo:text-indent="-0.25in" fo:margin-left="2.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="10" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.75in" fo:text-indent="-0.25in" fo:margin-left="2.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+</text:list-style>
+<text:list-style style:name="L2">
+	<text:list-level-style-number text:level="1" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="0.5in" fo:text-indent="-0.25in" fo:margin-left="0.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="2" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="0.75in" fo:text-indent="-0.25in" fo:margin-left="0.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="3" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1in" fo:text-indent="-0.25in" fo:margin-left="1in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="4" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.25in" fo:text-indent="-0.25in" fo:margin-left="1.25in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="5" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.5in" fo:text-indent="-0.25in" fo:margin-left="1.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="6" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="1.75in" fo:text-indent="-0.25in" fo:margin-left="1.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="7" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2in" fo:text-indent="-0.25in" fo:margin-left="2in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="8" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.25in" fo:text-indent="-0.25in" fo:margin-left="2.25in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="9" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.5in" fo:text-indent="-0.25in" fo:margin-left="2.5in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+	<text:list-level-style-number text:level="10" text:style-name="Standard" style:num-suffix="." style:num-format="1">
+		<style:list-level-properties text:list-level-position-and-space-mode="label-alignment">
+			<style:list-level-label-alignment text:label-followed-by="listtab" text:list-tab-stop-position="2.75in" fo:text-indent="-0.25in" fo:margin-left="2.75in"/>
+		</style:list-level-properties>
+	</text:list-level-style-number>
+</text:list-style>
+</office:automatic-styles>
+ <office:master-styles>
+  <style:master-page style:name="Endnote" >
+    <style:header><text:h text:outline-level="2">Bibliography</text:h></style:header></style:master-page>
+  <style:master-page style:name="Footnote" style:page-layout-name="pm2"/>
+ </office:master-styles>
+<office:meta>
+	<dc:title>MultiMarkdown v6 Development Notes</dc:title>
+	<meta:user-defined meta:name="author">Fletcher T. Penney</meta:user-defined>
+	<meta:user-defined meta:name="date">2017-03-14</meta:user-defined>
+</office:meta>
+<office:body>
+<office:text>
+<text:h text:outline-level="3"><text:bookmark text:name="introduction"/>Introduction </text:h>
+
+<text:p text:style-name="Standard">This document includes some notes on the development of MultiMarkdown (MMD) v6. Most of it
+will be interesting only to other developers or those needing to choose the
+absolute &#8220;best&#8221; Markdown (MD) implementation for their needs &#8211; it is not required
+reading to understand how the software works.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="whyanewversion"/>Why a New Version? </text:h>
+
+<text:p text:style-name="Standard">MultiMarkdown version 5 was released in November of 2015, but the codebase was
+essentially the same as that of v4 &#8211; and that was released in beta in April
+of 2013. A few key things prompted work on a new version:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="Standard">Accuracy &#8211; MMD v4 and v5 were the most accurate versions yet, and a lot of
+effort went into finding and resolving various edge cases. However, it began
+to feel like a game of whack-a-mole where new bugs would creep in every time I
+fixed an old one. The PEG<text:note text:id="gn1" text:note-class="glossary"><text:note-body><text:p text:style-name="Footnote">Parsing Expression Grammar <text:a xlink:type="simple" xlink:href="https://en.wikipedia.org/wiki/Parsing_expression_grammar">https://en.wikipedia.org/wiki/Parsing_expression_grammar</text:a></text:p></text:note-body></text:note> began to feel rather convoluted in spots, even
+though it did allow for a precise (if not always accurate) specification of
+the grammar.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Performance &#8211; &#8220;Back in the day&#8221; <text:a xlink:type="simple" xlink:href="https://github.com/jgm/peg-markdown">peg-markdown</text:a> was one of the fastest
+Markdown parsers around. MMD v3 was based on peg-markdown, and would leap-
+frog with it in terms of performance. Then <text:a xlink:type="simple" xlink:href="http://commonmark.org/">CommonMark</text:a> was released, which
+was a bit faster. Then a couple of years went by and CommonMark became <text:span text:style-name="MMD-Italic">much</text:span>
+faster &#8211; in one of my test suites, MMD v 5.4.0 takes about 25 times longer to
+process a long document than CommonMark 0.27.0.</text:p></text:list-item>
+
+</text:list>
+
+<text:p text:style-name="Standard">In the spring of 2016, I decided I wanted to rewrite MultiMarkdown from scratch,
+building the parser myself rather than relying on a pre-rolled solution. (I
+had been using <text:a xlink:type="simple" xlink:href="https://github.com/ooc-lang/greg">greg</text:a> to compile the PEG
+into parser code. It worked well overall, but lacked some features I needed,
+requiring a lot of workarounds.)</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="firstattempt"/>First Attempt </text:h>
+
+<text:p text:style-name="Standard">My first attempt started by hand-crafting a parser that scanned through the
+document a line at a time, deciding what to do with each line as it found
+them. I used regex parsers made with <text:a xlink:type="simple" xlink:href="http://re2c.org/index.html">re2c</text:a> to
+help classify each line, and then a separate parser layer to process groups of
+lines into blocks. Initially this approach worked well, and was really
+efficient. But I quickly began to code my way into a dead-end &#8211; the strategy
+was not elegant enough to handle things like nested lists, etc.</text:p>
+
+<text:p text:style-name="Standard">One thing that did turn out well from the first attempt, however, was an
+approach for handling <text:span text:style-name="Source_20_Text">&lt;emph&gt;</text:span> and <text:span text:style-name="Source_20_Text">&lt;strong&gt;</text:span> parsing. I&#8217;ve learned over the
+years that this can be one of the hardest parts of coding accurately for
+Markdown. There are many examples that are obvious to a person, but difficult
+to properly &#8220;explain&#8221; how to parse to a computer.</text:p>
+
+<text:p text:style-name="Standard">No solution is perfect, but I developed an approach that seems to accurately
+handle a wide range of situations without a great deal of complexity:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">Scan the documents for asterisks (<text:span text:style-name="Source_20_Text">*</text:span>). Each one will be handled one at a
+time.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Unlike brackets (<text:span text:style-name="Source_20_Text">[</text:span> and <text:span text:style-name="Source_20_Text">]</text:span>), an asterisk is &#8220;ambidextrous&#8221;, in that it
+may be able to open a matched pair of asterisks, close a pair, or both. For
+example, in <text:span text:style-name="Source_20_Text">foo *bar* foo</text:span>:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">The first asterisk can open a pair, but not close one.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">The second asterisk can close a pair, but not open one.</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">So, once the asterisks have been identified, each has to be examined to
+determine whether it can open/close/both. The algorithm is not that complex,
+but I&#8217;ll describe it in general terms. Check the code for more specifics.
+This approach seems to work, but might still need some slight tweaking. In
+the future, I&#8217;ll codify this better in language rather than just in code.</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">If there is whitespace to the left of an asterisk, it can&#8217;t close.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">If there is whitespace or punctuation to the right it can&#8217;t open.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">&#8220;Runs&#8221; of asterisks, e.g. <text:span text:style-name="Source_20_Text">**bar</text:span> are treated as a unit in terms of
+looking left/right.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Asterisks inside a word are a bit trickier &#8211; we look at the number of
+asterisks before the word, the number in the current run, and the number
+of asterisks after the word to determine which combinations, if any, are
+permitted.</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Once all asterisks have been tagged as able to open/close/both, we proceed
+through them in order:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">When we encounter a tag that can close, we look to see if there is a
+previous opener that has not been paired off. If so, pair the two and
+remove the opener from the list of available asterisks.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">When we encounter an opener, add it to the stack of available openers.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">When encounter an asterisk that can do both, see if it can close an
+existing opener. If not, then add it to the stack.</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">After all tokens in the block have been paired, then we look for nesting
+pairs of asterisks in order to create <text:span text:style-name="Source_20_Text">&lt;emph&gt;</text:span> and <text:span text:style-name="Source_20_Text">&lt;strong&gt;</text:span> sets. For
+example, assume we have six asterisks wrapped around a word, three in front,
+and three after. The asterisks are indicated with numbers: <text:span text:style-name="Source_20_Text">123foo456</text:span>. We
+proceed in the following manner:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">Based on the pairing algorithm above, these asterisks would be paired as
+follows, with matching asterisks sharing numbers &#8211; <text:span text:style-name="Source_20_Text">123foo321</text:span>.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Moving forwards, we come to asterisk &#8220;1&#8221;. It is followed by an
+asterisk, so we check to see if they should be grouped as a <text:span text:style-name="Source_20_Text">&lt;strong&gt;</text:span>.
+Since the &#8220;1&#8221; asterisks are wrapped immediately outside the &#8220;2&#8221; asterisks,
+they are joined together. More than two pairs can&#8217;t be joined, so we now
+get the following &#8211; <text:span text:style-name="Source_20_Text">112foo211</text:span>, where the &#8220;11&#8221; represents the opening
+and closing of a <text:span text:style-name="Source_20_Text">&lt;strong&gt;</text:span>, and the &#8220;2&#8221; represents a <text:span text:style-name="Source_20_Text">&lt;emph&gt;</text:span>.</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">When matching a pair, any unclosed openers that are on the stack are
+removed, preventing pairs from &#8220;crossing&#8221; or &#8220;intersecting&#8221;. Pairs can wrap
+around each other, e.g. <text:span text:style-name="Source_20_Text">[(foo)]</text:span>, but not intersect like <text:span text:style-name="Source_20_Text">[(foo])</text:span>. In the
+second case, the brackets would close, removing the <text:span text:style-name="Source_20_Text">(</text:span> from the stack.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">This same approach is used in all tokens that are matched in pairs&#8211;
+<text:span text:style-name="Source_20_Text">[foo]</text:span>, <text:span text:style-name="Source_20_Text">(foo)</text:span>, <text:span text:style-name="Source_20_Text">_foo_</text:span>, etc. There&#8217;s slightly more to it, but once you
+figure out how to assign opening/closing ability, the rest is easy. By using
+a stack to track available openers, it can be performed efficiently.</text:p></text:list-item>
+
+</text:list>
+
+<text:p text:style-name="Standard">In my testing, this approach has worked quite well. It handles all the basic
+scenarios I&#8217;ve thrown at it, and all of the &#8220;basic&#8221; and &#8220;devious&#8221; edge cases I
+have thought of (some of these don&#8217;t necessarily have a &#8220;right&#8221; answer &#8211; but
+v6 gives consistency answers that seem as reasonable as any others to me).
+There are also three more edge cases I&#8217;ve come up can still stump it, and
+ironically they are handled correctly by most implementations. They just
+don&#8217;t follow the rules above. I&#8217;ll continue to work on this.</text:p>
+
+<text:p text:style-name="Standard">In the end, I scrapped this effort, but kept the lessons learned in the token
+pairing algorithm.</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="secondattempt"/>Second Attempt </text:h>
+
+<text:p text:style-name="Standard">I tried again this past Fall. This time, I approached the problem with lots
+of reading. <text:span text:style-name="MMD-Italic">Lots and lots</text:span> of reading &#8211; tons of websites, computer science
+journal articles, PhD theses, etc. Learned a lot about lexers, and a lot
+about parsers, including hand-crafting vs using parser generators. In brief:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">I learned about the <text:a xlink:type="simple" xlink:href="https://en.wikipedia.org/wiki/Aho-Corasick_algorithm">Aho–Corasick algorithm</text:a>, which is a great way to
+efficiently search a string for multiple target strings at once. I used this
+to create a custom lexer to identify tokens in a MultiMarkdown text document
+(e.g. <text:span text:style-name="Source_20_Text">*</text:span>, <text:span text:style-name="Source_20_Text">[</text:span>, <text:span text:style-name="Source_20_Text">{++</text:span>, etc.). I learned a lot, and had a good time working
+out the implementation. This code efficiently allowed me to break a string of
+text into the tokens that mattered for Markdown parsing.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">However, in a few instances I really needed some features of regular
+expressions to simplify more complex structures. After a quick bit of testing,
+using re2c to create a tokenizer was just as efficient, and allowed me to
+incorporate some regex functionality that simplified later parsing. I&#8217;ll keep
+the Aho-Corasick stuff around, and will probably experiment more with it
+later. But I didn&#8217;t need it for MMD now. <text:span text:style-name="Source_20_Text">lexer.re</text:span> contains the source for
+the tokenizer.</text:p></text:list-item>
+
+</text:list>
+
+<text:p text:style-name="Standard">I looked long and hard for a way to simplify the parsing algorithm to try and
+&#8220;touch&#8221; each token only once. Ideally, the program could step through each
+token, and decide when to create a new block, when to pair things together,
+etc. But I&#8217;m not convinced it&#8217;s possible. Since Markdown&#8217;s grammar varies
+based on context, it seems to work best when handled in distinct phases:</text:p>
+
+<text:list text:style-name="L2">
+<text:list-item>
+<text:p text:style-name="Standard">Tokenize the string to identify key sections of text. This includes line
+breaks, allowing the text to be examined one line at time.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Join series of lines together into blocks, such as paragraphs, code blocks,
+lists, etc.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">The tokens inside each block can then be paired together to create more
+complex syntax such as links, strong, emphasis, etc.</text:p></text:list-item>
+
+</text:list>
+
+<text:p text:style-name="Standard">To handle the block parsing, I started off using the Aho-Corasick code to
+handle my first attempt. I had actually implemented some basic regex
+functionality, and used that to group lines together to create blocks. But
+this quickly fell apart in the face of more complex structures such as
+recursive lists. After a lot of searching, and <text:span text:style-name="MMD-Italic">tons</text:span> more reading, I
+ultimately decided to use a parser generator to handle the task of group lines
+into blocks. <text:span text:style-name="Source_20_Text">parser.y</text:span> has the source for this, and it is processed by the
+<text:a xlink:type="simple" xlink:href="http://www.hwaci.com/sw/lemon/">lemon</text:a> parser generator to create the actual
+code.</text:p>
+
+<text:p text:style-name="Standard">I chose to do this because hand-crafting the block parser would be complex.
+The end result would likely be difficult to read and understand, which would
+make it difficult to update later on. Using the parser generator allows me to
+write things out in a way that can more easily be understood by a person. In
+all likelihood, the performance is probably as good as anything I could do
+anyway, if not better.</text:p>
+
+<text:p text:style-name="Standard">Because lemon is a LALR(1) parser, it does require a bit of thinking ahead
+about how to create the grammar used. But so far, it has been able to handle
+everything I have thrown at it.</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="optimization"/>Optimization </text:h>
+
+<text:p text:style-name="Standard">One of my goals for MMD 6 was performance. So I&#8217;ve paid attention to speed
+along the way, and have tried to use a few tricks to keep things fast. Here
+are some things I&#8217;ve learned along the way. In no particular order:</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="memoryallocation"/>Memory Allocation </text:h>
+
+<text:p text:style-name="Standard">When parsing a long document, a <text:span text:style-name="MMD-Italic">lot</text:span> of token structures are created. Each
+one requires a small bit of memory to be allocated. In aggregate, that time
+added up and slowed down performance.</text:p>
+
+<text:p text:style-name="Standard">After reading for a bit, I ended up coming up with an approach that uses
+larger chunks of memory. I allocate pools of of memory in large slabs for
+smaller &#8220;objects&#8221;&quot;. For example, I allocate memory for 1024 tokens at a
+single time, and then dole that memory out as needed. When the slab is empty,
+a new one is allocated. This dramatically improved performance.</text:p>
+
+<text:p text:style-name="Standard">When pairing tokens, I created a new stack for each block. I realized that an
+empty stack didn&#8217;t have any &#8220;leftover&#8221; cruft to interfere with re-use, so I
+just used one for the entire document. Again a sizeable improvement in
+performance from only allocating one object instead of many. When recursing
+to a deeper level, the stack just gets deeper, but earlier levels aren&#8217;t
+modified.</text:p>
+
+<text:p text:style-name="Standard">Speaking of tokens, I realized that the average document contains a lot of
+single spaces (there&#8217;s one between every two words I have written, for
+example.) The vast majority of the time, these single spaces have no effect
+on the output of Markdown documents. I changed my whitespace token search to
+only flag runs of 2 or more spaces, dramatically reducing the number of
+tokens. This gives the benefit of needing fewer memory allocations, and also
+reduces the number of tokens that need to be processed later on. The only
+downside is remember to check for a single space character in a few instances
+where it matters.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="properinputbuffering"/>Proper input buffering </text:h>
+
+<text:p text:style-name="Standard">When I first began last spring, I was amazed to see how much time was being
+spent by MultiMarkdown simply reading the input file. Then I discovered it
+was because I was reading it one character at a time. I switched to using a
+buffered read approach and the time to read the file went to almost nothing. I
+experimented with different buffer sizes, but they did not seem to make a
+measurable difference.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="outputbuffering"/>Output Buffering </text:h>
+
+<text:p text:style-name="Standard">I experimented with different approaches to creating the output after parsing.
+I tried printing directly to <text:span text:style-name="Source_20_Text">stdout</text:span>, and even played with different
+buffering settings. None of those seemed to work well, and all were slower
+than using the <text:span text:style-name="Source_20_Text">d_string</text:span> approach (formerly call <text:span text:style-name="Source_20_Text">GString</text:span> in MMD 5).</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="fastsearches"/>Fast Searches </text:h>
+
+<text:p text:style-name="Standard">After getting basic Markdown functionality complete, I discovered during
+testing that the time required to parse a document grew exponentially as the
+document grew longer. Performance was on par with CommonMark for shorter
+documents, but fell increasingly behind in larger tests. Time profiling found
+that the culprit was searching for link definitions when they didn&#8217;t exist.
+My first approach was to keep a stack of used link definitions, and to iterate
+through them when necessary. In long documents, this performs very poorly.
+More research and I ended up using
+<text:a xlink:type="simple" xlink:href="http://troydhanson.github.io/uthash/">uthash</text:a>. This allows me to search for
+a link (or footnote, etc.) by &#8220;name&#8221; rather than searching through an array.
+This allowed me to get MMD&#8217;s performance back to O(n), taking roughly twice as
+much time to process a document that is twice as long.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="efficientutilityfunctions"/>Efficient Utility Functions </text:h>
+
+<text:p text:style-name="Standard">It is frequently necessary when parsing Markdown to check what sort of
+character we are dealing with at a certain position &#8211; a letter, whitespace,
+punctuation, etc. I created a lookup table for this via <text:span text:style-name="Source_20_Text">char_lookup.c</text:span> and
+hard-coded it in <text:span text:style-name="Source_20_Text">char.c</text:span>. These routines allow me to quickly, and
+consistently, classify any byte within a document. This saved a lot of
+programming time, and saved time tracking down bugs from handling things
+slightly differently under different circumstances. I also suspect it
+improved performance, but don&#8217;t have the data to back it up.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="testingwhilewriting"/>Testing While Writing </text:h>
+
+<text:p text:style-name="Standard">I developed several chunks of code in parallel while creating MMD 6. The vast
+majority of it was developed largely in a <text:a xlink:type="simple" xlink:href="https://en.wikipedia.org/wiki/Test-driven_development">test-driven development</text:a> approach.
+The other code was largely created with extensive unit testing to accomplish
+this.</text:p>
+
+<text:p text:style-name="Standard">MMD isn&#8217;t particularly amenable to this approach at the small level, but
+instead I relied more on integration testing with an ever-growing collection
+of text files and the corresponding HTML files in the MMD 6 test suite. This
+allowed me to ensure new features work properly and that old features aren&#8217;t
+broken. At this time, there are 29 text files in the test suite, and many
+more to come.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="otherlessons"/>Other Lessons </text:h>
+
+<text:p text:style-name="Standard">Some things that didn&#8217;t do me any good&#8230;.</text:p>
+
+<text:p text:style-name="Standard">I considered differences between using <text:span text:style-name="Source_20_Text">malloc</text:span> and <text:span text:style-name="Source_20_Text">calloc</text:span> when initializing
+tokens. The time saved by using <text:span text:style-name="Source_20_Text">malloc</text:span> was basically exactly offset by the
+initial time required to initialize the token to default null values as
+compared to using <text:span text:style-name="Source_20_Text">calloc</text:span>. When trying <text:span text:style-name="Source_20_Text">calloc</text:span> failed to help me out
+(thinking that clearing a single slab in the object pool would be faster), I
+stuck with <text:span text:style-name="Source_20_Text">malloc</text:span> as it makes more sense to me in my workflow.</text:p>
+
+<text:p text:style-name="Standard">I read a bit about <text:a xlink:type="simple" xlink:href="http://www.catb.org/esr/structure-packing/">struct padding</text:a> and reordered some of my structs. It was
+until later that I discovered the <text:span text:style-name="Source_20_Text">-Wpadded</text:span> option, and it&#8217;s not clear
+whether my changes modified anything. Since the structs were being padded
+automatically, there was no noticeable performance change, and I didn&#8217;t have
+the tools to measure whether I could have improved memory usage at all. Not
+sure this would be worth the effort &#8211; much lower hanging fruit available.</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="performance"/>Performance </text:h>
+
+<text:p text:style-name="Standard">Basic tests show that currently MMD 6 takes about 20&#8211;25% longer the CommonMark
+0.27.0 to process long files (e.g. 0.2 MB). However, it is around 5% <text:span text:style-name="MMD-Italic">faster</text:span>
+than CommonMark when parsing a shorter file (27 kB) (measured by parsing the
+same file 200 times over). This test suite is performed by using the Markdown
+[syntax page], modified to avoid the use of the Setext header at the top. The
+longer files tested are created by copying the same syntax page onto itself,
+thereby doubling the length of the file with each iteration.</text:p>
+
+<text:p text:style-name="Standard">The largest file I test is approximately 108 MB (4096 copies of the syntax
+page). On my machine (2012 Mac mini with 2.3 GHz Intel Core i7, 16 GB RAM),
+it takes approximately 4.4 seconds to parse with MMD 6 and 3.7 seconds with
+CommonMark. MMD 6 processes approximately 25 MB/s on this test file.
+CommonMark 0.27.0 gets about 29 MB/s on the same machine.</text:p>
+
+<text:p text:style-name="Standard">There are some slight variations with the smaller test files (8&#8211;32 copies),
+but overall the performance of both programs (MMD 6 and CommonMark) are
+roughly linear as the test file gets bigger (double the file size and it takes
+twice as long to parse, aka O(n)).</text:p>
+
+<text:p text:style-name="Standard">Out of curiosity, I ran the same tests on the original Markdown.pl by Gruber
+(v 1.0.2b8). It took approximately 178 seconds to parse 128 copies of the
+file (3.4 MB) and was demonstrating quadratic performance characteristics
+(double the file size and it takes 2<text:span text:style-name="MMD-Superscript">2</text:span> or 4 times longer to process, aka
+O(n<text:span text:style-name="MMD-Superscript">2</text:span>)). I didn&#8217;t bother running it on larger versions of the test file. For
+comparison, MMD 6 can process 128 copies in approximately 140 msec.</text:p>
+
+<text:p text:style-name="Standard">Of note, the throughput speed drops when testing more complicated files
+containing more advanced MultiMarkdown features, though it still seems to
+maintain linear performance characteristics. A second test file is created by
+concatenating all of the test suite files (including the Markdown syntax
+file). In this case, MMD gets about 13 MB/s. CommonMark doesn&#8217;t support
+these additional features, so testing it with that file is not relevant. I
+will work to see whether there are certain features in particular that are
+more challenging and see whether they can be reworked to improve performance.</text:p>
+
+<text:p text:style-name="Standard">As above, I have done some high level optimization of the parse strategy, but
+I&#8217;m sure there&#8217;s still a lot of room for further improvement to be made.
+Suggestions welcome!</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="testing"/>Testing </text:h>
+
+<text:h text:outline-level="4"><text:bookmark text:name="testsuite"/>Test Suite </text:h>
+
+<text:p text:style-name="Standard">The development of MMD v6 was heavily, but not absolutely, influenced by the
+philosophy of test-driven development. While coding, I made use of test
+suites to verify successful implementation of new features, to avoid
+regression problems when adding new features, and to identify known edge cases
+in need of proper handling.</text:p>
+
+<text:p text:style-name="Standard">The test suite (located in <text:span text:style-name="Source_20_Text">tests/MMD6Tests</text:span>) is a &#8220;living&#8221; collection of
+documents that will continue to be updated as new bugs and edge cases are
+identified. This helps make proper integration testing of the entire
+application with every release.</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="fuzztesting"/>Fuzz Testing </text:h>
+
+<text:p text:style-name="Standard">I was not familiar with the concept of <text:a xlink:type="simple" xlink:href="#fuzztesting">Fuzz Testing</text:a>
+(https://en.wikipedia.org/wiki/Fuzzing) until a user mentioned something about
+it to me a year or two ago. I had never used it before, but it seemed like a
+good idea. I implement it in two ways.</text:p>
+
+<text:p text:style-name="Standard">The first is that I created a simplified version of the line parser that
+simply accepts various combinations of line type identifiers to see if they
+would successfully parse. The line parser is responsible for taking a series
+of line types (e.g. plain text, indented line, etc.) and determining what sort
+of block they should become. The file <text:span text:style-name="Source_20_Text">test/parser_text.y</text:span> is run through the
+<text:span text:style-name="Source_20_Text">lemon</text:span> program, compiled (with or without the <text:span text:style-name="Source_20_Text">-DNDEBUG</text:span> flag) and then run.
+It sequentially throws every combination of line types at the simplified line
+parser to make sure that it doesn&#8217;t choke. When I first did this, I found
+several combinations of lines that did not pass.</text:p>
+
+<text:p text:style-name="Standard"><text:span text:style-name="MMD-Bold">NOTE</text:span>: This does not verify accurate parsing, simply that the parser does
+not crash by an unacceptable combination of lines.</text:p>
+
+<text:p text:style-name="Standard">The second form of fuzz testing I have started using more recently. This is
+using the <text:a xlink:type="simple" xlink:href="http://lcamtuf.coredump.cx/afl/">American fuzzy lop</text:a> program to try
+to find text input that crashes MMD. This works by taking sample input (e.g.
+files from the test suite), modifying them slightly, and trying the modified
+versions. Do this over and over and over, and some interesting edge cases are
+sometimes identified. I have found some interesting edge cases this way.
+Definitely a very useful tool!</text:p>
+
+<text:h text:outline-level="4"><text:bookmark text:name="unittesting"/>Unit Testing </text:h>
+
+<text:p text:style-name="Standard">Some of the original development was done with unit testing in some other
+tools I developed. This code formed the basis of a few parts of MMD.
+Otherwise, it was hard to see how to really create very good unit tests for
+the development of MMD. So there is really not much unit testing built into
+the code or used during the development.</text:p>
+
+<text:h text:outline-level="3"><text:bookmark text:name="changelog"/>Changelog </text:h>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;03&#8211;13 &#8211; v 6.0.0-b2:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add CriticMarkup preprocessor that works across empty lines when accepting/rejecting markup</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add back the mmd6 latex title file</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Basic EPUB 3 support &#8211; uses &#8216;miniz&#8217; library to zip creation</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Update QuickStart and EPUB code</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Update QuickStart guide</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Update test suite</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Don't duplicate LaTeX glossary definitions</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix abbreviations in ODF; Improve test suite</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Improve glossaries and abbreviations; Update QuickStart</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Tidy up some compiler warnings in code</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">FIXED: Use custom UUID code to minimize external dependencies</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;03&#8211;09 &#8211; v 6.0.0-b1:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add French translations; fix typo in German</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add Quick Start guide</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add functionality to automatically identify abbreviations and glossary terms in source</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Improve LaTeX configuration files</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Update German translations</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Use native ODF table of contents instead of a manual list</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Use native command for table of contents in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Bring HTML and ODF into line with LaTeX as to output of abbreviatinos on first and subsequent uses</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Slight performance tweak</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Update German test suite</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Allow <text:span text:style-name="Source_20_Text">{{TOC}}</text:span> in latex verbatim</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Don't free token_pool if never initialized</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix German typo</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix missing token type</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Improve performance of checking document for metadata, which improves performance when checking for possible transclusion</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">FIXED: Update test suite for abbreviation changes</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;03&#8211;05 &#8211; v 0.4.2-b:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add and utility functions; fix memory leak</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Initial abbreviation support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Keep working on Abbreviations/Glossaries</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Refactor abbreviation code; Add inline abbreviations; Fix abbreviations in ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Update Inline Footnote test</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Add comments to i18n.h</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Finish refactoring note&#8211;related code</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Refactor footnotes</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Refactor glossary code</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Remove offset from html export functions</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: latex list items need to block optional argument to allow &#8216;[&#8217; as first character</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Merge branch &#8216;release/0.4.1-b&#8217; into develop</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;03&#8211;04 &#8211; v 0.4.1-b:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="Standard">FIXED: Add glossary localization</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;03&#8211;04 &#8211; v 0.4.0-b:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add TOC support to ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add glossary support to ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add prelim code for handling abbreviations</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for Swift Package Maker; CHANGED: Restructure source directory</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Added LaTeX support for escaped characters, fenced code blocks, images, links</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Basic ODF Support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Better document strong/emph algorithm</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Continue ODF progress</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Continue to work on ODF export</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Continue work on ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Finish ODF support for lists</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Improve performance when exporting</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Improve token_pool memory handling</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Prototype support for Glossaries</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support &#8216;latexconfig&#8217; metadata</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Use multiple cases in glossary tests</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Don't force glossary terms into lowercase</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix Makefile for new source file location</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix algorithm for creating TOC to properly handle &#8216;incorrect&#8217; levels</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix linebreaks in LaTeX; ADDED: Add Linebreaks test file</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix new_source script for new directory structure</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix non&#8211;breaking space in ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix padding at end of document body in ODF</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix underscores in raw latex</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Potential bug</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">NOTE: Add shared library build option</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;02&#8211;17 &#8211; v 0.3.1.a:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: &#8216;finalize&#8217; beamer support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add escaped newline as linebreak; start on beamer/memoir support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: CriticMarkup test for LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Custom LaTeX output for CriticMarkup comments</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support mmd export format</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Work on cpack installer &#8211; change project name for compatibility</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Adjust latex metadata configuration for consistency</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+CHANGED: Configure cmake to use C99</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Add custom implementation for cross&#8211;platform support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix German HTML tests</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix cpack destination directory issue</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix memory leaks etc</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix warning in custom vasprintf</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Modify CMakeLists.txt to test for use of clang compiler</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Work on memory leaks</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">NOTE: Adjust license width to improve display on smaller terminal windows</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;02&#8211;14 &#8211; v 0.3.0a:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add basic image support to LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add file transclusion</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for citation &#8216;locators&#8217;</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for manual labels on ATX Headers</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for manual labels on Setext Headers</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for tables in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: HTML Comments appear as raw LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Improved citation support in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support \autoref{} in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support combined options in LaTeX citations that use the &#8216;][&#8217; syntax</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support language specifier in fenced code blocks</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support metadata in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Update Citations test suite</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Escaped LaTeX characters</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix bug in URL parsing</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix bug in citation links</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix bug when no closing divider or newline at end of last table cell</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix issue printing &#8216;&#8211;&#8217;</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Fix scan_url test suite</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Get Math working in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Improve reliability or link scanner</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Properly add id attribute to new instances of citation only</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Properly handle manual labels with TOC</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Properly print hash characters in LaTeX</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Separate LaTeX verbatim and texttt character handling</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+FIXED: Update Escapes test LaTeX result</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">FIXED: Work on escaping LaTeX characters</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;02&#8211;08 &#8211; v 0.1.4a:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="Standard">ADDED: Add smart quote support for other languages (resolves #15)</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;02&#8211;08 &#8211; v 0.1.3a:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for reference image id attributes</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Add support for table captions</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Metadata support for base header level</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support distinction between 3 and 5 backticks in fenced code blocks</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+ADDED: Support Setext headers</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">FIXED: Fix issue with metadata disrupting smart quotes</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;02&#8211;07 &#8211; v 0.1.2a:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="Standard">&#8220;pathologic&#8221; test suite &#8211; fix handling of nested brackets, e.g.
+<text:span text:style-name="Source_20_Text">[[[[foo]]]]</text:span> to avoid bogging down checking for reference links that
+don&#8217;t exist.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Table support &#8211; a single blank line separates sections of tables, so
+at least two blank lines are needed between adjacent tables.</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Definition list support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+&#8220;fuzz testing&#8221; &#8211; stress test the parser for unexpected failures</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Table of Contents support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Improved compatibility mode parsing</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">2017&#8211;01&#8211;28 &#8211; v 0.1.1a includes a few updates:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+Metadata support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Metadata variables support</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Extended ASCII range character checking</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Rudimentary language translations, including German</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Improved performance</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">Additional testing:</text:p>
+
+<text:list text:style-name="L1">
+<text:list-item>
+<text:p text:style-name="P1">
+CriticMarkup</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+HTML Blokcs</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="P1">
+Metadata/Variables</text:p></text:list-item>
+
+<text:list-item>
+<text:p text:style-name="Standard">&#8220;pathologic&#8221; test cases from CommonMark</text:p></text:list-item>
+
+</text:list></text:list-item>
+
+</text:list></text:list-item>
+
+</text:list>
+</office:text>
+</office:body>
+</office:document>
diff --git a/DevelopmentNotes/DevelopmentNotes.html b/DevelopmentNotes/DevelopmentNotes.html
new file mode 100644
index 0000000..493aa2b
--- /dev/null
+++ b/DevelopmentNotes/DevelopmentNotes.html
@@ -0,0 +1,599 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+<head>
+	<meta charset="utf-8"/>
+	<title>MultiMarkdown v6 Development Notes</title>
+	<meta name="author" content="Fletcher T. Penney"/>
+	<meta name="date" content="2017-03-14"/>
+</head>
+<body>
+
+<h3 id="introduction">Introduction </h3>
+
+<p>This document includes some notes on the development of MultiMarkdown (<abbr title="MultiMarkdown">MMD</abbr>) v6. Most of it
+will be interesting only to other developers or those needing to choose the
+absolute &#8220;best&#8221; Markdown (<abbr title="Markdown">MD</abbr>) implementation for their needs &#8211; it is not required
+reading to understand how the software works.</p>
+
+<h4 id="whyanewversion">Why a New Version? </h4>
+
+<p>MultiMarkdown version 5 was released in November of 2015, but the codebase was
+essentially the same as that of v4 &#8211; and that was released in beta in April
+of 2013. A few key things prompted work on a new version:</p>
+
+<ul>
+<li><p>Accuracy &#8211; <abbr title="MultiMarkdown">MMD</abbr> v4 and v5 were the most accurate versions yet, and a lot of
+effort went into finding and resolving various edge cases. However, it began
+to feel like a game of whack-a-mole where new bugs would creep in every time I
+fixed an old one. The <a href="#gn:1" id="gnref:1" title="see glossary" class="glossary">PEG</a> began to feel rather convoluted in spots, even
+though it did allow for a precise (if not always accurate) specification of
+the grammar.</p></li>
+<li><p>Performance &#8211; &#8220;Back in the day&#8221; <a href="https://github.com/jgm/peg-markdown">peg-markdown</a> was one of the fastest
+Markdown parsers around. <abbr title="MultiMarkdown">MMD</abbr> v3 was based on peg-markdown, and would leap-
+frog with it in terms of performance. Then <a href="http://commonmark.org/">CommonMark</a> was released, which
+was a bit faster. Then a couple of years went by and CommonMark became <em>much</em>
+faster &#8211; in one of my test suites, <abbr title="MultiMarkdown">MMD</abbr> v 5.4.0 takes about 25 times longer to
+process a long document than CommonMark 0.27.0.</p></li>
+</ul>
+
+<p>In the spring of 2016, I decided I wanted to rewrite MultiMarkdown from scratch,
+building the parser myself rather than relying on a pre-rolled solution. (I
+had been using <a href="https://github.com/ooc-lang/greg">greg</a> to compile the PEG
+into parser code. It worked well overall, but lacked some features I needed,
+requiring a lot of workarounds.)</p>
+
+<h3 id="firstattempt">First Attempt </h3>
+
+<p>My first attempt started by hand-crafting a parser that scanned through the
+document a line at a time, deciding what to do with each line as it found
+them. I used regex parsers made with <a href="http://re2c.org/index.html">re2c</a> to
+help classify each line, and then a separate parser layer to process groups of
+lines into blocks. Initially this approach worked well, and was really
+efficient. But I quickly began to code my way into a dead-end &#8211; the strategy
+was not elegant enough to handle things like nested lists, etc.</p>
+
+<p>One thing that did turn out well from the first attempt, however, was an
+approach for handling <code>&lt;emph&gt;</code> and <code>&lt;strong&gt;</code> parsing. I&#8217;ve learned over the
+years that this can be one of the hardest parts of coding accurately for
+Markdown. There are many examples that are obvious to a person, but difficult
+to properly &#8220;explain&#8221; how to parse to a computer.</p>
+
+<p>No solution is perfect, but I developed an approach that seems to accurately
+handle a wide range of situations without a great deal of complexity:</p>
+
+<ol>
+<li><p>Scan the documents for asterisks (<code>*</code>). Each one will be handled one at a
+time.</p></li>
+<li><p>Unlike brackets (<code>[</code> and <code>]</code>), an asterisk is &#8220;ambidextrous&#8221;, in that it
+may be able to open a matched pair of asterisks, close a pair, or both. For
+example, in <code>foo *bar* foo</code>:</p>
+
+<ol>
+<li><p>The first asterisk can open a pair, but not close one.</p></li>
+<li><p>The second asterisk can close a pair, but not open one.</p></li>
+</ol></li>
+<li><p>So, once the asterisks have been identified, each has to be examined to
+determine whether it can open/close/both. The algorithm is not that complex,
+but I&#8217;ll describe it in general terms. Check the code for more specifics.
+This approach seems to work, but might still need some slight tweaking. In
+the future, I&#8217;ll codify this better in language rather than just in code.</p>
+
+<ol>
+<li><p>If there is whitespace to the left of an asterisk, it can&#8217;t close.</p></li>
+<li><p>If there is whitespace or punctuation to the right it can&#8217;t open.</p></li>
+<li><p>&#8220;Runs&#8221; of asterisks, e.g. <code>**bar</code> are treated as a unit in terms of
+looking left/right.</p></li>
+<li><p>Asterisks inside a word are a bit trickier &#8211; we look at the number of
+asterisks before the word, the number in the current run, and the number
+of asterisks after the word to determine which combinations, if any, are
+permitted.</p></li>
+</ol></li>
+<li><p>Once all asterisks have been tagged as able to open/close/both, we proceed
+through them in order:</p>
+
+<ol>
+<li><p>When we encounter a tag that can close, we look to see if there is a
+previous opener that has not been paired off. If so, pair the two and
+remove the opener from the list of available asterisks.</p></li>
+<li><p>When we encounter an opener, add it to the stack of available openers.</p></li>
+<li><p>When encounter an asterisk that can do both, see if it can close an
+existing opener. If not, then add it to the stack.</p></li>
+</ol></li>
+<li><p>After all tokens in the block have been paired, then we look for nesting
+pairs of asterisks in order to create <code>&lt;emph&gt;</code> and <code>&lt;strong&gt;</code> sets. For
+example, assume we have six asterisks wrapped around a word, three in front,
+and three after. The asterisks are indicated with numbers: <code>123foo456</code>. We
+proceed in the following manner:</p>
+
+<ol>
+<li><p>Based on the pairing algorithm above, these asterisks would be paired as
+follows, with matching asterisks sharing numbers &#8211; <code>123foo321</code>.</p></li>
+<li><p>Moving forwards, we come to asterisk &#8220;1&#8221;. It is followed by an
+asterisk, so we check to see if they should be grouped as a <code>&lt;strong&gt;</code>.
+Since the &#8220;1&#8221; asterisks are wrapped immediately outside the &#8220;2&#8221; asterisks,
+they are joined together. More than two pairs can&#8217;t be joined, so we now
+get the following &#8211; <code>112foo211</code>, where the &#8220;11&#8221; represents the opening
+and closing of a <code>&lt;strong&gt;</code>, and the &#8220;2&#8221; represents a <code>&lt;emph&gt;</code>.</p></li>
+</ol></li>
+<li><p>When matching a pair, any unclosed openers that are on the stack are
+removed, preventing pairs from &#8220;crossing&#8221; or &#8220;intersecting&#8221;. Pairs can wrap
+around each other, e.g. <code>[(foo)]</code>, but not intersect like <code>[(foo])</code>. In the
+second case, the brackets would close, removing the <code>(</code> from the stack.</p></li>
+<li><p>This same approach is used in all tokens that are matched in pairs&#8211;
+<code>[foo]</code>, <code>(foo)</code>, <code>_foo_</code>, etc. There&#8217;s slightly more to it, but once you
+figure out how to assign opening/closing ability, the rest is easy. By using
+a stack to track available openers, it can be performed efficiently.</p></li>
+</ol>
+
+<p>In my testing, this approach has worked quite well. It handles all the basic
+scenarios I&#8217;ve thrown at it, and all of the &#8220;basic&#8221; and &#8220;devious&#8221; edge cases I
+have thought of (some of these don&#8217;t necessarily have a &#8220;right&#8221; answer &#8211; but
+v6 gives consistency answers that seem as reasonable as any others to me).
+There are also three more edge cases I&#8217;ve come up can still stump it, and
+ironically they are handled correctly by most implementations. They just
+don&#8217;t follow the rules above. I&#8217;ll continue to work on this.</p>
+
+<p>In the end, I scrapped this effort, but kept the lessons learned in the token
+pairing algorithm.</p>
+
+<h3 id="secondattempt">Second Attempt </h3>
+
+<p>I tried again this past Fall. This time, I approached the problem with lots
+of reading. <em>Lots and lots</em> of reading &#8211; tons of websites, computer science
+journal articles, PhD theses, etc. Learned a lot about lexers, and a lot
+about parsers, including hand-crafting vs using parser generators. In brief:</p>
+
+<ol>
+<li><p>I learned about the <a href="https://en.wikipedia.org/wiki/Aho-Corasick_algorithm">Aho–Corasick algorithm</a>, which is a great way to
+efficiently search a string for multiple target strings at once. I used this
+to create a custom lexer to identify tokens in a MultiMarkdown text document
+(e.g. <code>*</code>, <code>[</code>, <code>{++</code>, etc.). I learned a lot, and had a good time working
+out the implementation. This code efficiently allowed me to break a string of
+text into the tokens that mattered for Markdown parsing.</p></li>
+<li><p>However, in a few instances I really needed some features of regular
+expressions to simplify more complex structures. After a quick bit of testing,
+using re2c to create a tokenizer was just as efficient, and allowed me to
+incorporate some regex functionality that simplified later parsing. I&#8217;ll keep
+the Aho-Corasick stuff around, and will probably experiment more with it
+later. But I didn&#8217;t need it for <abbr title="MultiMarkdown">MMD</abbr> now. <code>lexer.re</code> contains the source for
+the tokenizer.</p></li>
+</ol>
+
+<p>I looked long and hard for a way to simplify the parsing algorithm to try and
+&#8220;touch&#8221; each token only once. Ideally, the program could step through each
+token, and decide when to create a new block, when to pair things together,
+etc. But I&#8217;m not convinced it&#8217;s possible. Since Markdown&#8217;s grammar varies
+based on context, it seems to work best when handled in distinct phases:</p>
+
+<ol>
+<li><p>Tokenize the string to identify key sections of text. This includes line
+breaks, allowing the text to be examined one line at time.</p></li>
+<li><p>Join series of lines together into blocks, such as paragraphs, code blocks,
+lists, etc.</p></li>
+<li><p>The tokens inside each block can then be paired together to create more
+complex syntax such as links, strong, emphasis, etc.</p></li>
+</ol>
+
+<p>To handle the block parsing, I started off using the Aho-Corasick code to
+handle my first attempt. I had actually implemented some basic regex
+functionality, and used that to group lines together to create blocks. But
+this quickly fell apart in the face of more complex structures such as
+recursive lists. After a lot of searching, and <em>tons</em> more reading, I
+ultimately decided to use a parser generator to handle the task of group lines
+into blocks. <code>parser.y</code> has the source for this, and it is processed by the
+<a href="http://www.hwaci.com/sw/lemon/">lemon</a> parser generator to create the actual
+code.</p>
+
+<p>I chose to do this because hand-crafting the block parser would be complex.
+The end result would likely be difficult to read and understand, which would
+make it difficult to update later on. Using the parser generator allows me to
+write things out in a way that can more easily be understood by a person. In
+all likelihood, the performance is probably as good as anything I could do
+anyway, if not better.</p>
+
+<p>Because lemon is a LALR(1) parser, it does require a bit of thinking ahead
+about how to create the grammar used. But so far, it has been able to handle
+everything I have thrown at it.</p>
+
+<h3 id="optimization">Optimization </h3>
+
+<p>One of my goals for <abbr title="MultiMarkdown">MMD</abbr> 6 was performance. So I&#8217;ve paid attention to speed
+along the way, and have tried to use a few tricks to keep things fast. Here
+are some things I&#8217;ve learned along the way. In no particular order:</p>
+
+<h4 id="memoryallocation">Memory Allocation </h4>
+
+<p>When parsing a long document, a <em>lot</em> of token structures are created. Each
+one requires a small bit of memory to be allocated. In aggregate, that time
+added up and slowed down performance.</p>
+
+<p>After reading for a bit, I ended up coming up with an approach that uses
+larger chunks of memory. I allocate pools of of memory in large slabs for
+smaller &#8220;objects&#8221;&quot;. For example, I allocate memory for 1024 tokens at a
+single time, and then dole that memory out as needed. When the slab is empty,
+a new one is allocated. This dramatically improved performance.</p>
+
+<p>When pairing tokens, I created a new stack for each block. I realized that an
+empty stack didn&#8217;t have any &#8220;leftover&#8221; cruft to interfere with re-use, so I
+just used one for the entire document. Again a sizeable improvement in
+performance from only allocating one object instead of many. When recursing
+to a deeper level, the stack just gets deeper, but earlier levels aren&#8217;t
+modified.</p>
+
+<p>Speaking of tokens, I realized that the average document contains a lot of
+single spaces (there&#8217;s one between every two words I have written, for
+example.) The vast majority of the time, these single spaces have no effect
+on the output of Markdown documents. I changed my whitespace token search to
+only flag runs of 2 or more spaces, dramatically reducing the number of
+tokens. This gives the benefit of needing fewer memory allocations, and also
+reduces the number of tokens that need to be processed later on. The only
+downside is remember to check for a single space character in a few instances
+where it matters.</p>
+
+<h4 id="properinputbuffering">Proper input buffering </h4>
+
+<p>When I first began last spring, I was amazed to see how much time was being
+spent by MultiMarkdown simply reading the input file. Then I discovered it
+was because I was reading it one character at a time. I switched to using a
+buffered read approach and the time to read the file went to almost nothing. I
+experimented with different buffer sizes, but they did not seem to make a
+measurable difference.</p>
+
+<h4 id="outputbuffering">Output Buffering </h4>
+
+<p>I experimented with different approaches to creating the output after parsing.
+I tried printing directly to <code>stdout</code>, and even played with different
+buffering settings. None of those seemed to work well, and all were slower
+than using the <code>d_string</code> approach (formerly call <code>GString</code> in MMD 5).</p>
+
+<h4 id="fastsearches">Fast Searches </h4>
+
+<p>After getting basic Markdown functionality complete, I discovered during
+testing that the time required to parse a document grew exponentially as the
+document grew longer. Performance was on par with CommonMark for shorter
+documents, but fell increasingly behind in larger tests. Time profiling found
+that the culprit was searching for link definitions when they didn&#8217;t exist.
+My first approach was to keep a stack of used link definitions, and to iterate
+through them when necessary. In long documents, this performs very poorly.
+More research and I ended up using
+<a href="http://troydhanson.github.io/uthash/">uthash</a>. This allows me to search for
+a link (or footnote, etc.) by &#8220;name&#8221; rather than searching through an array.
+This allowed me to get <abbr title="MultiMarkdown">MMD</abbr>&#8217;s performance back to O(n), taking roughly twice as
+much time to process a document that is twice as long.</p>
+
+<h4 id="efficientutilityfunctions">Efficient Utility Functions </h4>
+
+<p>It is frequently necessary when parsing Markdown to check what sort of
+character we are dealing with at a certain position &#8211; a letter, whitespace,
+punctuation, etc. I created a lookup table for this via <code>char_lookup.c</code> and
+hard-coded it in <code>char.c</code>. These routines allow me to quickly, and
+consistently, classify any byte within a document. This saved a lot of
+programming time, and saved time tracking down bugs from handling things
+slightly differently under different circumstances. I also suspect it
+improved performance, but don&#8217;t have the data to back it up.</p>
+
+<h4 id="testingwhilewriting">Testing While Writing </h4>
+
+<p>I developed several chunks of code in parallel while creating <abbr title="MultiMarkdown">MMD</abbr> 6. The vast
+majority of it was developed largely in a <a href="https://en.wikipedia.org/wiki/Test-driven_development">test-driven development</a> approach.
+The other code was largely created with extensive unit testing to accomplish
+this.</p>
+
+<p><abbr title="MultiMarkdown">MMD</abbr> isn&#8217;t particularly amenable to this approach at the small level, but
+instead I relied more on integration testing with an ever-growing collection
+of text files and the corresponding HTML files in the <abbr title="MultiMarkdown">MMD</abbr> 6 test suite. This
+allowed me to ensure new features work properly and that old features aren&#8217;t
+broken. At this time, there are 29 text files in the test suite, and many
+more to come.</p>
+
+<h4 id="otherlessons">Other Lessons </h4>
+
+<p>Some things that didn&#8217;t do me any good&#8230;.</p>
+
+<p>I considered differences between using <code>malloc</code> and <code>calloc</code> when initializing
+tokens. The time saved by using <code>malloc</code> was basically exactly offset by the
+initial time required to initialize the token to default null values as
+compared to using <code>calloc</code>. When trying <code>calloc</code> failed to help me out
+(thinking that clearing a single slab in the object pool would be faster), I
+stuck with <code>malloc</code> as it makes more sense to me in my workflow.</p>
+
+<p>I read a bit about <a href="http://www.catb.org/esr/structure-packing/">struct padding</a> and reordered some of my structs. It was
+until later that I discovered the <code>-Wpadded</code> option, and it&#8217;s not clear
+whether my changes modified anything. Since the structs were being padded
+automatically, there was no noticeable performance change, and I didn&#8217;t have
+the tools to measure whether I could have improved memory usage at all. Not
+sure this would be worth the effort &#8211; much lower hanging fruit available.</p>
+
+<h3 id="performance">Performance </h3>
+
+<p>Basic tests show that currently <abbr title="MultiMarkdown">MMD</abbr> 6 takes about 20&#8211;25% longer the CommonMark
+0.27.0 to process long files (e.g. 0.2 MB). However, it is around 5% <em>faster</em>
+than CommonMark when parsing a shorter file (27 kB) (measured by parsing the
+same file 200 times over). This test suite is performed by using the Markdown
+[syntax page], modified to avoid the use of the Setext header at the top. The
+longer files tested are created by copying the same syntax page onto itself,
+thereby doubling the length of the file with each iteration.</p>
+
+<p>The largest file I test is approximately 108 MB (4096 copies of the syntax
+page). On my machine (2012 Mac mini with 2.3 GHz Intel Core i7, 16 GB RAM),
+it takes approximately 4.4 seconds to parse with <abbr title="MultiMarkdown">MMD</abbr> 6 and 3.7 seconds with
+CommonMark. <abbr title="MultiMarkdown">MMD</abbr> 6 processes approximately 25 MB/s on this test file.
+CommonMark 0.27.0 gets about 29 MB/s on the same machine.</p>
+
+<p>There are some slight variations with the smaller test files (8&#8211;32 copies),
+but overall the performance of both programs (MMD 6 and CommonMark) are
+roughly linear as the test file gets bigger (double the file size and it takes
+twice as long to parse, aka O(n)).</p>
+
+<p>Out of curiosity, I ran the same tests on the original Markdown.pl by Gruber
+(v 1.0.2b8). It took approximately 178 seconds to parse 128 copies of the
+file (3.4 MB) and was demonstrating quadratic performance characteristics
+(double the file size and it takes 2<sup>2</sup> or 4 times longer to process, aka
+O(n<sup>2</sup>)). I didn&#8217;t bother running it on larger versions of the test file. For
+comparison, <abbr title="MultiMarkdown">MMD</abbr> 6 can process 128 copies in approximately 140 msec.</p>
+
+<p>Of note, the throughput speed drops when testing more complicated files
+containing more advanced MultiMarkdown features, though it still seems to
+maintain linear performance characteristics. A second test file is created by
+concatenating all of the test suite files (including the Markdown syntax
+file). In this case, <abbr title="MultiMarkdown">MMD</abbr> gets about 13 MB/s. CommonMark doesn&#8217;t support
+these additional features, so testing it with that file is not relevant. I
+will work to see whether there are certain features in particular that are
+more challenging and see whether they can be reworked to improve performance.</p>
+
+<p>As above, I have done some high level optimization of the parse strategy, but
+I&#8217;m sure there&#8217;s still a lot of room for further improvement to be made.
+Suggestions welcome!</p>
+
+<h3 id="testing">Testing </h3>
+
+<h4 id="testsuite">Test Suite </h4>
+
+<p>The development of <abbr title="MultiMarkdown">MMD</abbr> v6 was heavily, but not absolutely, influenced by the
+philosophy of test-driven development. While coding, I made use of test
+suites to verify successful implementation of new features, to avoid
+regression problems when adding new features, and to identify known edge cases
+in need of proper handling.</p>
+
+<p>The test suite (located in <code>tests/MMD6Tests</code>) is a &#8220;living&#8221; collection of
+documents that will continue to be updated as new bugs and edge cases are
+identified. This helps make proper integration testing of the entire
+application with every release.</p>
+
+<h4 id="fuzztesting">Fuzz Testing </h4>
+
+<p>I was not familiar with the concept of <a href="#fuzztesting">Fuzz Testing</a>
+(https://en.wikipedia.org/wiki/Fuzzing) until a user mentioned something about
+it to me a year or two ago. I had never used it before, but it seemed like a
+good idea. I implement it in two ways.</p>
+
+<p>The first is that I created a simplified version of the line parser that
+simply accepts various combinations of line type identifiers to see if they
+would successfully parse. The line parser is responsible for taking a series
+of line types (e.g. plain text, indented line, etc.) and determining what sort
+of block they should become. The file <code>test/parser_text.y</code> is run through the
+<code>lemon</code> program, compiled (with or without the <code>-DNDEBUG</code> flag) and then run.
+It sequentially throws every combination of line types at the simplified line
+parser to make sure that it doesn&#8217;t choke. When I first did this, I found
+several combinations of lines that did not pass.</p>
+
+<p><strong>NOTE</strong>: This does not verify accurate parsing, simply that the parser does
+not crash by an unacceptable combination of lines.</p>
+
+<p>The second form of fuzz testing I have started using more recently. This is
+using the <a href="http://lcamtuf.coredump.cx/afl/">American fuzzy lop</a> program to try
+to find text input that crashes <abbr title="MultiMarkdown">MMD</abbr>. This works by taking sample input (e.g.
+files from the test suite), modifying them slightly, and trying the modified
+versions. Do this over and over and over, and some interesting edge cases are
+sometimes identified. I have found some interesting edge cases this way.
+Definitely a very useful tool!</p>
+
+<h4 id="unittesting">Unit Testing </h4>
+
+<p>Some of the original development was done with unit testing in some other
+tools I developed. This code formed the basis of a few parts of <abbr title="MultiMarkdown">MMD</abbr>.
+Otherwise, it was hard to see how to really create very good unit tests for
+the development of <abbr title="MultiMarkdown">MMD</abbr>. So there is really not much unit testing built into
+the code or used during the development.</p>
+
+<h3 id="changelog">Changelog </h3>
+
+<ul>
+<li><p>2017&#8211;03&#8211;13 &#8211; v 6.0.0-b2:</p>
+
+<ul>
+<li>ADDED: Add CriticMarkup preprocessor that works across empty lines when accepting/rejecting markup</li>
+<li>ADDED: Add back the mmd6 latex title file</li>
+<li>ADDED: Basic EPUB 3 support &#8211; uses &#8216;miniz&#8217; library to zip creation</li>
+<li>ADDED: Update QuickStart and EPUB code</li>
+<li>CHANGED: Update QuickStart guide</li>
+<li>CHANGED: Update test suite</li>
+<li>FIXED: Don't duplicate LaTeX glossary definitions</li>
+<li>FIXED: Fix abbreviations in ODF; Improve test suite</li>
+<li>FIXED: Improve glossaries and abbreviations; Update QuickStart</li>
+<li>FIXED: Tidy up some compiler warnings in code</li>
+<li>FIXED: Use custom UUID code to minimize external dependencies</li>
+</ul></li>
+<li><p>2017&#8211;03&#8211;09 &#8211; v 6.0.0-b1:</p>
+
+<ul>
+<li>ADDED: Add French translations; fix typo in German</li>
+<li>ADDED: Add Quick Start guide</li>
+<li>ADDED: Add functionality to automatically identify abbreviations and glossary terms in source</li>
+<li>ADDED: Improve LaTeX configuration files</li>
+<li>ADDED: Update German translations</li>
+<li>ADDED: Use native ODF table of contents instead of a manual list</li>
+<li>ADDED: Use native command for table of contents in LaTeX</li>
+<li>CHANGED: Bring HTML and ODF into line with LaTeX as to output of abbreviatinos on first and subsequent uses</li>
+<li>CHANGED: Slight performance tweak</li>
+<li>CHANGED: Update German test suite</li>
+<li>FIXED: Allow <code>{{TOC}}</code> in latex verbatim</li>
+<li>FIXED: Don't free token_pool if never initialized</li>
+<li>FIXED: Fix German typo</li>
+<li>FIXED: Fix missing token type</li>
+<li>FIXED: Improve performance of checking document for metadata, which improves performance when checking for possible transclusion</li>
+<li>FIXED: Update test suite for abbreviation changes</li>
+</ul></li>
+<li><p>2017&#8211;03&#8211;05 &#8211; v 0.4.2-b:</p>
+
+<ul>
+<li>ADDED: Add and utility functions; fix memory leak</li>
+<li>ADDED: Initial abbreviation support</li>
+<li>ADDED: Keep working on Abbreviations/Glossaries</li>
+<li>ADDED: Refactor abbreviation code; Add inline abbreviations; Fix abbreviations in ODF</li>
+<li>ADDED: Update Inline Footnote test</li>
+<li>CHANGED: Add comments to i18n.h</li>
+<li>CHANGED: Finish refactoring note&#8211;related code</li>
+<li>CHANGED: Refactor footnotes</li>
+<li>CHANGED: Refactor glossary code</li>
+<li>CHANGED: Remove offset from html export functions</li>
+<li>FIXED: latex list items need to block optional argument to allow &#8216;[&#8217; as first character</li>
+<li>Merge branch &#8216;release/0.4.1-b&#8217; into develop</li>
+</ul></li>
+<li><p>2017&#8211;03&#8211;04 &#8211; v 0.4.1-b:</p>
+
+<ul>
+<li>FIXED: Add glossary localization</li>
+</ul></li>
+<li><p>2017&#8211;03&#8211;04 &#8211; v 0.4.0-b:</p>
+
+<ul>
+<li>ADDED: Add TOC support to ODF</li>
+<li>ADDED: Add glossary support to ODF</li>
+<li>ADDED: Add prelim code for handling abbreviations</li>
+<li>ADDED: Add support for Swift Package Maker; CHANGED: Restructure source directory</li>
+<li>ADDED: Added LaTeX support for escaped characters, fenced code blocks, images, links</li>
+<li>ADDED: Basic ODF Support</li>
+<li>ADDED: Better document strong/emph algorithm</li>
+<li>ADDED: Continue ODF progress</li>
+<li>ADDED: Continue to work on ODF export</li>
+<li>ADDED: Continue work on ODF</li>
+<li>ADDED: Finish ODF support for lists</li>
+<li>ADDED: Improve performance when exporting</li>
+<li>ADDED: Improve token_pool memory handling</li>
+<li>ADDED: Prototype support for Glossaries</li>
+<li>ADDED: Support &#8216;latexconfig&#8217; metadata</li>
+<li>CHANGED: Use multiple cases in glossary tests</li>
+<li>FIXED: Don't force glossary terms into lowercase</li>
+<li>FIXED: Fix Makefile for new source file location</li>
+<li>FIXED: Fix algorithm for creating TOC to properly handle &#8216;incorrect&#8217; levels</li>
+<li>FIXED: Fix linebreaks in LaTeX; ADDED: Add Linebreaks test file</li>
+<li>FIXED: Fix new_source script for new directory structure</li>
+<li>FIXED: Fix non&#8211;breaking space in ODF</li>
+<li>FIXED: Fix padding at end of document body in ODF</li>
+<li>FIXED: Fix underscores in raw latex</li>
+<li>FIXED: Potential bug</li>
+<li>NOTE: Add shared library build option</li>
+</ul></li>
+<li><p>2017&#8211;02&#8211;17 &#8211; v 0.3.1.a:</p>
+
+<ul>
+<li>ADDED: &#8216;finalize&#8217; beamer support</li>
+<li>ADDED: Add escaped newline as linebreak; start on beamer/memoir support</li>
+<li>ADDED: CriticMarkup test for LaTeX</li>
+<li>ADDED: Custom LaTeX output for CriticMarkup comments</li>
+<li>ADDED: Support mmd export format</li>
+<li>ADDED: Work on cpack installer &#8211; change project name for compatibility</li>
+<li>CHANGED: Adjust latex metadata configuration for consistency</li>
+<li>CHANGED: Configure cmake to use C99</li>
+<li>FIXED: Add custom implementation for cross&#8211;platform support</li>
+<li>FIXED: Fix German HTML tests</li>
+<li>FIXED: Fix cpack destination directory issue</li>
+<li>FIXED: Fix memory leaks etc</li>
+<li>FIXED: Fix warning in custom vasprintf</li>
+<li>FIXED: Modify CMakeLists.txt to test for use of clang compiler</li>
+<li>FIXED: Work on memory leaks</li>
+<li>NOTE: Adjust license width to improve display on smaller terminal windows</li>
+</ul></li>
+<li><p>2017&#8211;02&#8211;14 &#8211; v 0.3.0a:</p>
+
+<ul>
+<li>ADDED: Add basic image support to LaTeX</li>
+<li>ADDED: Add file transclusion</li>
+<li>ADDED: Add support for citation &#8216;locators&#8217;</li>
+<li>ADDED: Add support for manual labels on ATX Headers</li>
+<li>ADDED: Add support for manual labels on Setext Headers</li>
+<li>ADDED: Add support for tables in LaTeX</li>
+<li>ADDED: HTML Comments appear as raw LaTeX</li>
+<li>ADDED: Improved citation support in LaTeX</li>
+<li>ADDED: Support \autoref{} in LaTeX</li>
+<li>ADDED: Support combined options in LaTeX citations that use the &#8216;][&#8217; syntax</li>
+<li>ADDED: Support language specifier in fenced code blocks</li>
+<li>ADDED: Support metadata in LaTeX</li>
+<li>ADDED: Update Citations test suite</li>
+<li>FIXED: Escaped LaTeX characters</li>
+<li>FIXED: Fix bug in URL parsing</li>
+<li>FIXED: Fix bug in citation links</li>
+<li>FIXED: Fix bug when no closing divider or newline at end of last table cell</li>
+<li>FIXED: Fix issue printing &#8216;&#8211;&#8217;</li>
+<li>FIXED: Fix scan_url test suite</li>
+<li>FIXED: Get Math working in LaTeX</li>
+<li>FIXED: Improve reliability or link scanner</li>
+<li>FIXED: Properly add id attribute to new instances of citation only</li>
+<li>FIXED: Properly handle manual labels with TOC</li>
+<li>FIXED: Properly print hash characters in LaTeX</li>
+<li>FIXED: Separate LaTeX verbatim and texttt character handling</li>
+<li>FIXED: Update Escapes test LaTeX result</li>
+<li>FIXED: Work on escaping LaTeX characters</li>
+</ul></li>
+<li><p>2017&#8211;02&#8211;08 &#8211; v 0.1.4a:</p>
+
+<ul>
+<li>ADDED: Add smart quote support for other languages (resolves #15)</li>
+</ul></li>
+<li><p>2017&#8211;02&#8211;08 &#8211; v 0.1.3a:</p>
+
+<ul>
+<li>ADDED: Add support for reference image id attributes</li>
+<li>ADDED: Add support for table captions</li>
+<li>ADDED: Metadata support for base header level</li>
+<li>ADDED: Support distinction between 3 and 5 backticks in fenced code blocks</li>
+<li>ADDED: Support Setext headers</li>
+<li>FIXED: Fix issue with metadata disrupting smart quotes</li>
+</ul></li>
+<li><p>2017&#8211;02&#8211;07 &#8211; v 0.1.2a:</p>
+
+<ul>
+<li>&#8220;pathologic&#8221; test suite &#8211; fix handling of nested brackets, e.g.
+<code>[[[[foo]]]]</code> to avoid bogging down checking for reference links that
+don&#8217;t exist.</li>
+<li>Table support &#8211; a single blank line separates sections of tables, so
+at least two blank lines are needed between adjacent tables.</li>
+<li>Definition list support</li>
+<li>&#8220;fuzz testing&#8221; &#8211; stress test the parser for unexpected failures</li>
+<li>Table of Contents support</li>
+<li>Improved compatibility mode parsing</li>
+</ul></li>
+<li><p>2017&#8211;01&#8211;28 &#8211; v 0.1.1a includes a few updates:</p>
+
+<ul>
+<li>Metadata support</li>
+<li>Metadata variables support</li>
+<li>Extended ASCII range character checking</li>
+<li>Rudimentary language translations, including German</li>
+<li>Improved performance</li>
+<li>Additional testing:
+
+<ul>
+<li>CriticMarkup</li>
+<li>HTML Blokcs</li>
+<li>Metadata/Variables</li>
+<li>&#8220;pathologic&#8221; test cases from CommonMark</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<div class="glossary">
+<hr />
+<ol>
+
+<li id="gn:1">
+PEG: <p>Parsing Expression Grammar <a href="https://en.wikipedia.org/wiki/Parsing_expression_grammar">https://en.wikipedia.org/wiki/Parsing_expression_grammar</a> <a href="#gnref:1" title="return to body" class="reverseglossary">&#160;&#8617;</a></p>
+</li>
+
+</ol>
+</div>
+
+</body>
+</html>
+
diff --git a/DevelopmentNotes/DevelopmentNotes.pdf b/DevelopmentNotes/DevelopmentNotes.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..611a80d9429c4c58d22691398db49a2409a5ec43
GIT binary patch
literal 103994
zcma&tV{<0Zx-RP2w$-t1cWm3XlQ&Ms>e#kz+cw@L9oshc+^0^}IaO<ZSmV?90i(u!
z)dLD8F$o41Mh-ZN`Q?#yI1X+SW)epe8#sP`I3_uB2TM0A5>{qrR+9hcz%fZ!+qs#$
zkT6Nu8M~Q_nVUMAnZpSR!nwM+m>b)}d2W<wPq-X#qV&vZo>Hr8GlM$KP;exfp_SQ`
z9`DK^We||Sq2VTl435P92*#w4ATlLoi%mexf4#fE*m7@Vb1fX702a<4hOW9U;-otV
zSPGqGINQqPB{;R!^2s;1h`0jmgyd(m0!+UCDf7E^2~6ByeO=FO8X9X~GY!>4S+ZPK
zrj{J%jI84PLQp(TA$}8Z94<NfSN`%vFCjR6!AzSdR<mh}Mk=G~Nv$M;*7I#TG}gG^
zW8m90wa>6PXXv?hHwK*aDzoZ<jC8`{jaO1LvON)OM(vL8;v&P_5ECeM+<_bu*)ffB
zNpyV1@Q+scI+y2q=F4^*ai$&9aq}h>hVLyQ=g3XODG9xMY^{U_DeK=XqNWPw@vZ7=
z%!u9kv`1lBQ_P79^~T8gCZKz0`?X^XMjtV;3ZL)$P%MOLnLGsNbj#Xmry{nIVE19<
z@r6gRP^Ks}2)!zV<5ALZA_t07{1&AP4=^Q`&IgqrKwzmxsG4~R@3ekg3e+W#Fj8qe
z8qxw-UU)uO>0uwIDc{S#w=lURkA>bbuAS8W+3OLnZ-a>%*q?e^AT(=ZqT4fYvT7P4
z$+TwQ=|vMoHX`>Og|Z`7A$BoM23sF$b6`SDV=;~5Id5CCBdz-Y4h|4zGJ-anfn}aT
zhyL49tr3jdcC_2G_=BbjfXJ6v%}`HyHV+*nQ8*ZiO=M8*%4ELYhw1OZpU>t&HG@5@
zo%jQ0&a!awX&`WZ-Y?g(hy1?RrVn~|4lR7}VTneglF?loE*RrJzd{N6Z6bBb@A4@J
zHfBZ*fLMz~B8oz^3=VDKl=RntIt|_gzad-!KbhK3pz;Wy_8~==GiPVg&w$8~koQb9
zP6la&cj<Ud-XBM{a|*m8*c}3~tI|GboPbOLx|r?|(zVI}m3T-XiXwQq4>WhP&n~1m
z^GxMe1QQA1ekR8(!JT%0>3-jTFRsnVI)e<si}rBOYaSRy0ezAxDu>fA+k=@VRtw-F
zEsVM!yG-adrmW;!GxljaU9iW5Wu06T;-*Xc0P$njH-{=^#A+Vn^5wz2+P$}9f-!|x
zAC1}G8iKVKuxj7fmHvTNnLSwMlHk}|B<5&h(T7*C<)1lpF-3M4-f*gnz|KojGn3o)
zqI%zMRweMJL^s5imUW};2+X%PX%DaR+1Tp)<PN~*=p9Ft6c@HmTivx)VFw_fbB&`J
zD`{r-AR~N30@jxp;l-bYLYqhs&~89mTV-y@eam){Dt|THAst!TdjKCW$M{n-gp5gd
z^K7>hMQOG2`$*D!U}4A%ST`Za0TrTBvzumK$w&b7u~yT~a<H)bY49@3LHBT7aK<>d
zX-j1`^nZUtoCisu)g6#s_(z9qwq}@;y+<~>cOD6?P!M^h*AW46%eT6kP<r=KjSe!6
ziPB$PZ7-5WRw!8GEokd@x3ysM!A;*}vWh<h`J6zKn!8(nm+FPd{IJ#3YTlFj812%y
zwy33^Q|{Su>buu-4{y1d>P}&ZO<YkT2(pukGRLaP$4OTMFLbk+vY}#5`CA;z_+N%g
zvN718;D`kCu2D?^52UnEU(0E_a3zV{Idh3yMP(e1OcJ7qm&lsr4A#J7DBB-f|0=w(
zsoQ@~PaQ;6XMbcC41U}l>Pi5e8W|LedQIfJEjP2dXhDslyyWU(IxZ&Qaww+4MK<)>
zLfn4SYF%KYR-qrV`k>f23&ZjWk1ehB!q3bAXW0>;BLZT$QfG1D&HGAacP$*ERmjx#
zVbcAnU0F<n&V=O@hr=lk{eho0%S#8EY3rLvbImFFIH(L3>Nsa!{NX0-nRGs#Zuvzc
zT!etC5YnouIC#=HZEMpCy|DE-M>6;ue`g|B5+1icExFk=$}aTNoiE|BZJ1MX4R3C`
z5vvZAD3|jpa>2LHy0YD7*g*(3yy~+o@aWQap9W1vcpD?N^a{dLkOR{VKBFaH#I@E`
zr-c$XgxkQ|l;*iOwYhbn<C35huUD@}Bw>$RT>5jLpb2jnTn1reBzo~{(<8zl!R1$1
z6E^N8$s=>q22%kuMJFUVHy-H9aTZ+#Dij^Cv#AG-gdH@DvI<uEHL*Ly*oxw<npJmu
zs{hZuuZxe;F2-Jl*aDkV;@Ym;tYsjf+pkw4P%k_cFFr^@e%YB%;meU#Z?TZb$$w)Z
z613?uY=3(qY5gwDd`umiCf}{H24f5td8zvBP+FdoGn?va?g7|ft<hqSXW89${+)cy
zqeEzqD%u^+T@Ky&=<vY~X`F%3+u6D2qZzE7dP0--V1B>dKr7lbDLG=EwEpn~>anTo
zo(l!bkHoe%0%ZgdXZM>nt_Tt(^0x}fU-(e{RH<CrOqu6bXS_+0-ruc>2ja2WqrL=1
zf2z3A3b(kb`3#x-bU86}@?rdSQjF3*4PFoBBSoGp^b}6En;9KZuH*-OXO@EPUarmE
zAVDGdBxjJAsAfl{;{sBFpg9aTuX?foP0t5{w`nb#EB8)&VVN7~+Pb2nk*Bdv;%WPz
z59h-xbKkvlUQRBDxCfHeuCvYRRfo80K*u@2d_3ZS=>CGe*6;oot05F3#Rcy=HOPvV
zwdIvBM;vT)r#)$v{igYp(D<tJ5hju4S}@yS;xYB=eF9qzYVIfgN!cdg2P{-AstnHD
z!R-GH_y64fFATUi{;LqU|JOp$nu<MW$NcxA>AB`&R3+A9hZqEsVMKWfG65oOzQP8t
zQ%W)7EneJN`7M}6#w0G|vNCP<Yl>6)-x|-09%PpZ_T~5c*~f{ZqEP7_<3kg>9AK_Z
zA4A+9q%S*h9(lIw<l?$&?J`b!H)g42n^^iV@~k(r_S}$HKm5!)uXgQhLw+soY~wmk
zInjHkl&Rt~@l@Te)4%E3))wF>5WXkvgn8b*szX~XP9TRkI1K;N$NzJsny(KP@Ox^<
zG(B-*&lCY^EaASrR)_o7bcAHbdv(Zrx4Ws2dRw7c3^HZ$@JFFPF3-{r;>WNlq>uWJ
zH?I@tX%e3Iie;Z#VRNc18#WLosUP_lSeT+ksCVR*@TKJm3ijdg-=w@8utKb1<L2nk
z<m}}_&x7P7;+&#?3py0M<~kGS+u5|l5@a2u0&i67c<(3lIz+ZYd_fPftCcDd-(6)?
zYkOYcYKAz&wgEMmMxrL4PhG}}qII5?8+1NTvJ1=j+k{1`=i#tGk*jy@YJq9nNiTOF
zRe#pZ3$yV<Vz=iSy|#C%rvY5@6gUeiEyuDC>WA%TRL}B&L9OQ@!H3RlXMMPlN59LC
zW?WyDW9w!2HXs50AeLh1vcCU`mY+QZt<IXGm2Jt|l7YZN`*UL)D9sSz6h?12QPo9B
z7t;qddx_A|dAs@kr<})TQqzkoN{H8pP66VF|8n`l>+6ly5n#*37}EaV>mi|NkyjI<
zGN^utFxCF#>C^c9ZQc;GJN<|a<I{lNcr~UYzJF^@YwF4(`{$yEsdA@BDoS}~hE*Hn
znA*Rmx_H(=ky<*&S7SPVxx?>AK2rZw^6NaImS^<aRGX$+OpRk0aS4T7B=d06v1OZ$
z%=3Jfk?JDIH@x<3;ZP%aCO4Yoe}epHzsU!C<pD$A7(SCJ2dOg({48BnwB7E(n388(
z5I{Cy0*GgX95<EnIhAsV)K8HC`t_`Tb}khX?*}=X9%yTt?ny{sUOa~8mvt~<e}a*q
zq>0f~HUjshCO)|Os(lwG<acBUai-~K>NFUtXmNmsml7_FsS(Hep_=zhIU`JUA5Bua
zP#Xw_tg@ZFtJe%cqA4Dew_><^B!syF-QEN_l$eQh;9XGG2tEi%f7V8+m!OOtnNT|I
z8z14drh05m?2zk(8niNB%|}?PlyqJ5nQf~}Oy+iz$<~x0zt2vk!y)4~$I9dUP?rYy
zAuAsF>=xImN%WoZFK<W)%!akzQg!&Y26#?D)g?`q-my*!KwbzAa%Rl#9=RtH@I+my
zaDtJ90JW{fm|E*65|x9S4`o?Pyz3LoVOgDF`WDZbTG95FQm8Sw$~@nyrAAUWELEcE
zi=`0;Q*qYPxEy+h_heyQ$a!jZ)vd9A)m7r%{DgZ6XPg$&x+P9@%Jys5_oV*cnkgQ{
zc3*$I*=R=KQp?mBR3?q#ZlI_wF0KEG)V_56fFwEOA}MbBQ5kjbcfGM8n4RmkcJwZP
zq49IDbOq>_Y$(Ig;H8<qy9atbh*~qcTvJ9T4XXOk=gXjN6h(-li@za6AMs&8o2zRt
z0(&3Zo&V=-LV#dK@146Un<dctA7?hX**6VG_~$+I=K#U`5SSh>kkNo5dj1$J-4j#h
zx61@2^s*EdlDZC<wbWrDl4R!Ss%E;nHw%~~8#KsHN<Si|SESkel8uvy^`x3^${Hbn
zMc^s}B6Ne>F5$iey@YX$7!@>g!xFHTFgMH0ogwIRf${MNCxW$cbQlj3yRw=zl33Kx
z@a9jhLgVswA#tPK$vKF9#1y5I9o~m@ycHgcI*O7uoUZ$4cg??SS{AiN86eqy*lEmT
zOCm(MK8dsiRFq(5Bw4$!6_uq|`1xmG2C>HI#w@TYB?FnqEY|6<%L}iRs(O{v5`NGC
z#TB+)#(h)FsbJ;LmWCQ@_@%cNQa*+LDKbP!wGT%`2{ZB-JU9M8_-3u#Bv=I`{)6B_
ziCLi-VFbc1#`IEhEEPO}GOd}h6V%(b33AznM`DIm7_gMm{ra~Dg4|S4?UXVzlwYGh
z6>+^TMwa{QyTt6xZ+6&%P4ddf+iFQWGvS3k&n3b2;BE+YBZYldt>>|>B1*+BGzxx6
zTsKVnKtK3-c}e04fg@<4ivxl_bkIKeH%Ysz)~NdV#pZcSe<&>ONDV>jD^d}IgbvOK
zM;ZdTdfnUHIJQ@!vw`Ypop~$M1Gn)Jl)XO<-GHa!gSaNENI6iR9&f%dlt@GT2WZjr
z6MX5Pb*2^kwSKJACU|R|eql6Z1G^d*GfRxiz%eW|mO5uTUNk%NIk<zyMJjh{z5hHa
zIivitWbT@*+LYmb#iL-=;Sh#+%^uO9pEx`XA6qMw$PJN`$`E!~+m$t-sxiBSVG{t%
zan{ftetf4c4e;O-UU6Y-RSKso<?#~eITy!vQ$SGnuS4-!nqs&(isdBsbv|mT$n#jf
zGO<1Ftd|Tz)ZVv9D&|>!-mUk~=V{eh#F+M6@_Mzf$Jrdh(%)p#UmFvwPu(6qzZ&IT
zy#b8UGPN11{8@BZ@r@)fp+2@(gb~RxDQo0H25Ic+Wm3iv-;l%oVGO-bS|G>Z>vx<d
z55gLObI3CNLxGAEcNn2x_`1CbldOWsaNJ`vf!Ai`wz|FxXYu*D_qOx{QaC#O^*^1!
z!}4F8z{1S_zjZ>3HZb;p6U*<W?pAkGI0IE&IyHzy7*7fcm!uy=RhWo329#lmQ#J9F
zrKEOw=OikNI*L&fkcjPd;F9J#r=MM|P-XU12OuWe@q18BsG(KEv~KX`uZ1C{4s`VJ
zib`~O^3?LvYs<3Ft%iQG<J6T~?eU&lQT>rwd8o`)Joi#kEXbWZ2imuiGp**WgqwWE
zXQ|5x2>IOLJHCu`g#(jzffo<Fj@CB}i6l0O$F_}ckFPg?NM&Ge&~`=H3+D`NNRmy<
zjPTuGtC;}V`;bBKxmYc~EiCEA@2BbA^X9>PgVflx*c)xl=z<HNdO-1eNg36{v7FCW
zZK(y|AIt<%Diwz)e}=qhpNxh7zN8P{R?-j@ieo5C<-ITDw}^V{5}Xqc`az-Qf!kL`
z^uQ-2V|CNM!hTN0TL=1amO#_H0ktMH;WX$NBIBAQ#5MKpyXCJe4CHMay4pl`7EwIk
zr~DR|{KRIqvPyiN25A7u-wE0ST=<5#HTf1S`})GYMgSTfTRdt2xxVW5yq_tS3hej(
zy>wwmUfXOjpBgGM`bS?_q(kWdqb|PeLhwS)i|ZI)ikad?nGf$ju;AXC8JX3Wl<tD`
zmJ|7L;=cwy3wgv2Mp=>vW)<0>3Hl@7AaxJd7@6F{RQc}%z}644hq){4+Y?U6jCw!i
z#G`}vKMt&FDLBtnkkl53#IZ@*S)-E=!@TIJ-SB3cT!W$qcFZiK%xGQkPX}AB7@Fn}
zVCr3V4)?KMsYG)rpse;<GZbOq&aHynlPnUoDO$~z8+t}W*(53^{2TC^yZ7vESRb?1
z(wY>LQHg(LWkRZ^8I7)v2>7Vvm0|%ND=(;XAgzf}>zKdr#YaTU|C3c_0hmUm<2>Xd
zeA&H}Na;{w3gGp!tFqvydBZDUd97)qlxVa^^Nl5@Y4h=)aphgPb&oC$7>bw!NE>*u
zeTa2R0C|&~i~f@A$zzatyMI6sx4%M$^6DUR2_K#o$~+ab*2iJsb)cf*TA5zQUqFbT
z`RhQKz8LOWYGobXxxHk9(D8dRtU(^yFB}cg@6L*BV<wrIOl^EdvS;c{iK8}4Y;lIG
zKXtwO%x+;$33FOUD~pHVDU3YfZLxvp*F`hZdIOA<?u$KXj#NSM&QrGG$TNGCG&kDK
zM)f5lW+2uV#3x0m&re>7uKrE@OVZE>@?U#x><nZMi23<nGAf@?eY5%rH%ih`Oyw~C
z3s~-pvA&(5E@#^2c7zP9DqkyuVRaPaUK)_%kqO&#LhZCliQI+5FD}RgNx)^RMj}H`
z$w+hGwjGpie`O+Q4%%cCf_f1pi1klKGTvP6uP`(~uxtAQx53`bA^Vs2;+EUpJZ7Xn
z-oegd+ltWS!GVaEFxJnJKA}bn*H$LFnke5hg+Y&ODqGNr{S=a~?I&CqT~&SmxwdIH
zNtnU?5WYAQ3vGRq@jGUr&~W^&?S0p7j(RaRRp~|{jq4{_DW$b87Ij_FAP%kCRH8rK
zehRx%Nbk)_{Zd+Q(Df`t92CvPP16tl1bmsW0Zp%>L8^vb+AC-Im0FK+0allIk1nsA
zexa`1M5loSUTfsM{UULdcWsdjcpS!&-cH3rq^5~@;7zF0Hz3prD}A*}-=NJ#BcJsr
zlR5&Q!zP;Sw^`>w-OBg~c091^N=ahAmfE63_D&sfVc8w3Bv8}Dv&PNR)8tfb$Mg0>
z1edc^FoPbB@}KL@Y2as0bY!SGwBu!A?@giol3fJLV7Z3jI14`||GG<nUjNvtZeu4G
zol-UL&)nY;%5!9RpMPTW8_R}+iRBA{1?W*Ea5p6CC}|mju`MX|OInD2QSBLr<<t)(
z5zoJg|7K>JWMVBAgDH@?PH}xkjz9z@l2?d&2?Fmg)xGRUn}tEDLJ#O@dnVVZoghQ%
z{gttpMtuZD<!Wcx)YL%B33#Xb>6H@xOt`KU#^On^2fsJF#5nj0K8IO{Rq~CFf=Bt-
z6>s{fzY6Bs>(f-!*cE&$1@X)SDS{EQN>35UiTb06y1$GMGuxFC0KX1O^MPs(egvQx
z%DgkmoH3w8WG9CaYQ1@KW?S4B-^#n8lb(A4GIazLE9s17H+yjZVvne6#!V!hu3Y*M
zUwU)j9n800R{ao#a(r~*S_hdJLUQuF6711FkoLM^(7NaX3^_xD$8juV6Cc@M|JuFn
zU23YS>XN@zWToKjtQQWlw{-7)O+lG<`+K^h)HK=6L$T048JNZ)b2f}KLwXHqbMbU{
z);Ub)%1d~+vpjA!;glJ!tG^_4x!WepE@Sw!8_bXnv1?d0=^q&;{b3krkw`H>zRz~v
z>Vq=&?G%EXu0EMC`2GoeX|h&bg3zZ(UJnnOpvgpJO#K}ksZnv*!eT$eYxNci{CW6z
zGX#^72}P8}_WL8IS<XX-Iwo~gTKlMj(q;R3)!)iuSRSBK%5dpqqFP#izm3=XG(RWG
zK0|?*A=>%8le9Ezj5O%}i?Avq*(mdvBJA`i#!cmv7pk$YdbzjD``<XfNI<MS0gQxa
zB}kMNBkjK%s@jqUipW#)aEZDqLs1$mawc3`L^~KWFM>x{tSs+XdhwH=0d%#{%Fcub
zEqmbj4Cn>J61;tJ#0;IKT)7eoXmng8ZdjS~oD(cHh{=+P#`ABVj!?VWvC3|!h`ue`
z40mpclj4^4%FvcyUThC6HoQRuV>1j&h*vzG3;0V4n%{!!D?}DO1B?7%bwlGQ4SO*{
zY0bm;+d7cU5RV)X(&H*>S}PB`$jl$_2M1k3pgfriBmdJOEX@C<rNP3(^}mOR)@I^C
zE2`g4-TbD?9n4UdSYJ(!ok?07t$J>oJ1wMgJVZ1(23U6V*Mox|9tq8C^;NPVwG3Hi
z%=J>4;xB_7jl1)_n_e$Zz)!=pCT7KCvz`Efrgmxqjz18KCK6B;K6LK7T+1a+fOx!7
z%_WUR<2pC9@+~{l!nGFNK{TzNev#DSaUrjfyioL}a?TX$6P0msaN3Jo(;K@zG>@j2
z(y|sqq+S$G-i}u$o?Q3yaQoG@Zjbw%75m&J{SZa&+_G_4zsKLi_l;y%s*YB{*7Tq1
z)E2Po<}$q6$GfKyTyU(!=eAwJV?p_GQlO7Gxu>JPDpT7&J-IOHHB|I9(SEr=ecO6Y
zGmD&5UAf;<qSDt^;E^-Ao%!S{<vtfc^%2TRwczUR5XtHC(?G4cs!-WRSjVX?lStmS
z>TlL^`l#F1bsDTv4XHU(DP3(s$e^O(kPsbm&ciFGm<)J`(5rC!_?F5F6P}$U_r49F
z+itYBBCY-EjDo0{Bkgr)d(QJ4()sv;^{@)U=(^<|=M?4n*tZh;a7ShF{_`60C#1&S
zG?9uzi=`@{zKRqFqsRndJFIwII_0?i`dR<^L(y8tq_s1{Q1OC4X5GMLq&WIF!^TCv
z)=gs`7Wq`!W)g>`{*}pn6Apos)dAT$odMVOcHdmUi*fR|W~oiuUt))NNka0_DT06S
zA<jd&+Q^)vB7pSf0dJqTl;_2208CvL>F^l>7N?Sy<WYdP+a6x=&qSuy<a?xhb(zfL
z;uXS$Co+zJzrabLZ`c*PmJF5)V#PK^x(zE!>w7oN0S>6I?nDuYCv^Zfd`z^XxFSUz
zQ&Xk;4Kx|$3a7&3#}YS{@Kn{`WDxZO@rF~2Uhww6xh@0#ybte}`;1hPyxRS=KPpWt
za=NmM=@@4YDT(?iGlqD+Q_`t+q#=71O)8piPhSET<LG@(`7#QTr)$!9IoD52FDQRv
zLfds~UUoH1)xP<V$3wc<q=2o9J~bYp`mfEiD(e~=;!Il3rY7Gsv8wufmCgaOIaTDb
z%&d%LDv*?rtZiIZ^VI(K@tzg`5L6E+aI{)N6hS$n$HlaET2UU`J+zI{=gviF7h-Lk
zJ0pmVTt8n~ZIBiL=$4iRZbD}@euZC0B&%nf-lABRa}EG#Wn_kQj}R<umS5w=U2gyR
z6gryz(7>yl`)7tI+_h00|K}m=#t?PtGDA&k8jtw-uSk8C2IjQgUT7LJtV_WqYIrg4
zPoQ#U$Th8WizKI_a#?4`|MTFQ>7p8C%c<pqb%wE@=YmjT`x-g8N#*r~r(Oo;M@3(k
zmaOjgr|!PUzzS=&N^|9mzb!S=)IMYVP1CG`_|X1?aN~5RR!uTJ*F@&5WLL4+Q+HeY
z`rb8C<^Z|AU});Wl(!gykpZszUiSKBSj2s{5x@@k^3IY3JdicjW{u_E3RO@u|H&>V
z#9xC-T43?$kC6@3<_1GVIG&(Tcg3TROBEh_V^2qPZ!n$H>@sj+5@8llIhb&jpqmaB
zi2|8=bwlQO-&1<oD~}J_%KhOwb!Y|Y6VP-mm-=^l<G|bP4w9ujuGB)o%w`nTn?CgZ
za$6Bd{sYNn{1Fa6KL;+ONsHYTLFbLbCY72}hw*h&$)qHTcPx#nU+`2A2MWr$kREw3
zztZ_=J+v}ap3R(-RWcYvU^})D9QHo_#@cB1(rfKxX1u1m(wHHGRRP8KkpH|4=Xd*%
zh%^L-lgr&ZEbZMnh6YmJm>X`v23m~z$!TKKjZ7_a^35fcR@;yCIp3pM(D``|SqHY_
z>yp^vT2ZxVRk4|ZIYGB$Bqu~EpbJKM%AyrCj?w>*pSeKs#b^X3i)ANS7*S^??4M_P
z0z`KvjMk+V7?#msXddEkp`e$eg>0*{b}X#s<z(hTCkx}|d^1b7>W76kX!y^x4A=Zv
zHj1!!1g?%?DDfOlJRkA!aomflV2TxT>G&+m--i`t42fIw^g(Kse*)kymb?}cx-u@H
zHG)xo17l))<;DKBYhL0j8)Ai5>$-YhzThp=DNzV#<WkMh$oUpXY_~<Yh7Oz(1^yMy
z=^o=T5We{{kwq_lE_pq+;G8zv!n?}QS||xlmp;Cg=W{Mzf7*?%Be^9{r_Z_?w%Q^_
ztH8_Cg#hFmmQzfhIrSZ33Az5wp-^slEBXC2v>$wop*ibHgmYGDZX5tw{~DDr%?|EG
zH|$VcK-iwqy#Vj&Fv!P=>C0XD!HC8GP<%*{ry1>O_bjKo9eTOnkrn{|OwSPT^CxQR
zn;7$@r+-)$ODV#5sdq-!iqcZv*+lPfS5h)ycSRNC^NC>AHJiu~#R^>)5yaVr|3T8+
z{`n-noqVo<&kGLT&T`AWt8g#AIji&^vkJ=X68CoFE?t4w?}%RE4_|+V@A!duLUYf}
zXt~w%`{M_akEq(qDtr4_8dIn@WdgmmEJ9?u4Z66G20^@uEpz3k^Mty<1@aKnwGC{7
znS<t+#+BS7g|c<#kf3zrq;O(ds)Mn_*foED?UY#Fx|`^O10>#qze!j1YfQ;|tPgWK
zl{J-KP4JTR77_z7#JDoba2;w(+q<rA#p}EAG+1{$j7*=OV?$j#AQcIvT>pguEIj|S
z9>K!H!|}hZN2F*^ByRp^vf+cyjZK|n-zn`hOTPiVY+pv5zk*<&fCLTA+8G`+mjC;m
z9h4nL31^ch{kJs8`jk&y*O`&)HbhpQVYip3^ADpeXGfl;a;q1&{XX|I_^U;pgul}|
ze{xn|k4Kj*xFgz{MHjqjT=a*I-cg;Ho}_b6ge^^NPrJcL%jWey`vcKPxZQVrrMj9P
zam>f)x&Y2xfhU??2Y($~s*5QqxN0!<)8ds7a$he@^3<-Q*=tvHqY`(wZ2um4DiNEY
z0%YE({kbwX<>c=;d2x!Hh<Axk9l2js#BI{-LT=x!6}XmyTB)Ji7wBb08^!)t9o=V&
z=UOtO_Bfv6>VOlzmR35;q??_R3}fr&xleAnepq9&8$L?Snos2^5_$jJOLZt8<7#6r
znzWOiw1CpEHHN)ruf#lAon;D!Bk1ia@xMAqh-PM|2N@o2<lV$q447vgO(jMh>@owD
zcFW4$gZP7t9-gxYoG<Uz{p%j-v7JK)aq@<GB>QAo;a0A<NtY;d4KObad80fMa+&8s
zJcX&l-`$c7)yzX1%&Us5vgZ%5zS#mB;(Ob1h2tK7H96Q+Xs*<~>Q)wlovQQy8i&Mf
zazEy3AUjxX0w#?}O7d=kmD*EF{BgqZ>-p4pW(oYSzHrDI*)+a{d*NVF9L%5*r9MAV
zCf6+zh({JE?~%Q_IgJ|FK<TeZ<)$j59`;tgzMj1Q9VeV<uGtfK6_<Y%I^F=E3_N{r
zL_G*j`j^KgI6*TLC2+UX)OL-~!~AngJv1;Tqbnt0iiXVNa!ov9n@RA_{_MDD{yiKH
zWUcyyx&6nw*C{WYP+FQy?VRCSY~{ws{ur(D7n(nv%&8a(lxvNOPC}2}@NT$K(0(ZR
zg$AZj^yarA<{LwSHoEJ%3@<BEA1#Jq72b&B(`Tw)IpVFOpdX%0OjVeb^CjQWcb*+m
zgY_a2jd))bSF!cGee+8#ZR8d0%vys1Gvb``)H`eiP<xUxup{OnG&!VeP#vXZK}B0e
zt7rBvoZSu|b(}XGyc_p6V1w<~KX*vzE$u_SEQqpcv=;c6_yQ#Lsny(HJcWMc084vZ
z|KFWdsB~3I7_#39y!EqxHF3gn8&P(5$1TI%Z>8Q4g8lXd=C-&f@k_{bzRTyop5NPq
z1R<^SS8NtynWsP9>L3N(QvPUfIDrzN>v)2HTx)ROQ~;qr`Bo(EQ^d!-)vr#p3_N5o
z@|R?Sw>;FtGu7Z_<M0YoAYK7aIx7l`t!B&aU25gt!DTG&{gLei*;V<!TqR{tQ^vx!
z)x7nW&p7|`194`A<piMPY5&L`XZ%C2gWwEJd&McHdU4kzS4Nxh0)H@}7WX2X`SANg
zS^6#GS#wdEVXj3;;h$P&<1Tpx(V{pGu~=WS8l8nq?C&B%2Uh?th01eH>#LPdVLiyc
z$&g!#;1^;jE=gzdw1_Y-Y!d>BQudpRR8sjmT%<Ko-W>{`x)rzh%&~HvZFyxT`j?{V
zSI_J%If~QDMS*k^mmW2t-oAO%LnL!;&^<f{ti@JSulsl>VXK8h(+M-+hYE=f_u9K`
zH8EjL={(*#evUct*vq%2pX2s{1R1q95P2doOXyE#4BPQD^bN;y-M(&rsH#fJdLOOX
z9=%eu&2Dm_VX_}f3kdpjxoIuT()!Mc4*m)3(evG|Qz2>fN_Ag8W^CYuTtaI3qNdeM
zz9W(eevKon2d<wa;fBqWfUUcB_X5xZsY;Cy-&HFz@^8zkn7;L#<sJ1&ze^Y*K!S<n
z#zu^o=BYUZJlX<9wI=e<p$Z>jMpsJE$z%bGI%Cn6OjRnF*_`LRMy-7al-kYMO)bZm
zF*Z2cc&)L*g1ur@7yDnh2+$!;$87iAzm(W3%LQodi{|&Uvnf%kJ6u&)a~3_<de+NW
z#x~>53{POXR(EC8Q6C4EI!;h+6Q7E>uSjc4OlH^nS6Z7MS))9ERnU(*+l&1(B|Gh5
z3x@}0U`ngTJ()m?%{<P;Mul_TC!p4A&2w#)X+F$3$9_8$R&}ARP+ywh^bDy(p6B0M
zr7~2u$gQIIb!8P@^<S|TFRxWo>5#Y~x05{v=N`#e1;YT)IvI`dO-cyeF7B)rAIBoC
zqg(_ShYH6dVq(Nm@?KCWnX?%<m@87HSiCmG5-d5pPQqv3t7<oR>&BgMU!IbtIxh|G
zPc}fTKColiABSUZ14ri7X6;1M%9d;hs`-=}lPWJ_4O|mQX(sb&0Uj5X{6G8+;+~V3
zVs5vuta`3Zx?^OKj#sm09B`}=S?I#D@V@YQZ(=_6Zi?nq4Rzv0PjaQ5pkfIgk}?VC
zvxEoUHuHttC*vq9ki}CUQ;-#@n-uI;)Il)|b6fyhG$v1NR_D?!9^rD;w7`Q1UN8Y2
zRX$>?77V;Nd&AWSAE--Oy@(%fB^T`=Pw(8sC;`SOD@jDKzlYsH$f--$_z;I649_`S
zgJCjFff!m+Ckt2zs206ubV~g=3_kF3*H^D4dI?NU(`h`7h9j-Olt$hCxf>Ou&vxCZ
zr0U?_?7SLmoj8~4f#rlb0fM_`qBzGYbl>n`NU_m>X&r;^wytH}rTdU8)|3fw`{!p$
z>tWU@DadBs>xlTJIo7D0KUttZy?&l|#H{d{O8><MtX%)a2Hb31|63d6XvxO?#|FLs
z=~Xar)~}wMYoFIxH;KU6p_Ax7&SO9_ETkG`sEOOOP1N1ovMdj6Su8};%N{xr?M(X?
zIl1eER=sdJ5<6aBH@T@ph+|n+jUCWRCz6CvedrT}yq!1bd^PmiwRSlPoZ5B)B_?#v
zKO_uibPMZxdUKyz7By?@=H4ecH_g&&@*eZ#zJNe=HN!m0mn$;>7f*O0dArQ7IQi7c
z2{O>iusbA$_lLW*toclY=TUT@HfJpB;5HhZY|7F7M#@Vuk+$}T)wH_fmktMVOhTH9
zH>S4?R#!UeGcIMAkK2^Dqw1Edz7S(kh2vi0^!l4PnKp5leSIvm38Lne&S8%UwF|%a
z6I90Co)vTl4<kN$O^cEN#z{?-ntZ7jixLfkt;{2JMMg1B3TtJ_o*ul(Fl}*jdwKJr
zBVnJi2diEf5-9Cv|7v{O#R{*D;=9Z!<q#F>=1eUqLh7R3M6FqKRv9|LdxAqDPJU5w
zL8KaPM~sJU6)W|eY<&<LdvraVA*^8A1s`vZ9l66V7d2O+(_nYCHODB9@Fa*@t4KG|
zj0Y_J{i6LW&pv;P%?t~iw$euY`Kb-^+b~reOd4CA+?pR0oZ%o0{!JYobR6(i9~E8-
ze9p}fk@}lf!7*6rbk}QFc|?R6qze{dylfDw1+8uKDr$tN`Us445gjzB1o<Atc&WEc
zfKHwtlBGv5dt3OPXK~Nqn7hQEcpR}HGlruVJk^KbslIk>v?6yhgrQ($@iMWUSq}ln
zL{Ir@^LWOcRA=mEJe{mpZChwfn9OKwTebn{b7m&qNu>#SG}39}Fbz)RVxeDh%!O$V
zsolk$v-)oN?xM2b#KS~sNL6^s=R>)6V3h=!(C)@!(oiCX9y=-`$%7fh5$SfrCqhS>
zS#r<xcUw{*KV*WzPAA&J;1L-8v24-R4j#sqjp;@x`qIvVE5;+i{O2==9r~kRr+7!|
ze>o~;H{d1tSs87W{2eI1pwYmQEYZ}Vn{5BCFSDXt!9EOoN9Q}%k`ka$%Iq}^YsepA
zxa9XuKlR45<#@e`M&fw82)kl;raWS%>>iNlpZEFso&OLkG8|m<LTad^D|zMU6Qrnt
z#lm$Hak~{`YZfH?1!q=FvQ5_F`RUNGv>=XNUq5)JKwGC$O`gMO4faMPK)`4R(h}YL
z`3>m!g+4`DQPnl!l=ZDI%P9>ypg8(CpS#pdHu)mb$aH-C_K!!@zS=>JmMww(^IT=8
zWi!(hR+&WCf{h#zrRSSpzMwT{{ZNFTIppkK+7Yd$28bR6Dv+zMjx>dx3M$n|!r<~)
z&Etz5a!U;tHTZs9H*s)v*b&c^kNXPX9lfZ;@`D8wI9x6eC00vDP-C4epzcGyL8v)n
z)xG2y^7BL2U*0+ugCQde`B>S&b>q6s*8cM<E)ijAR8!)=r~Kkn45p8@tO#)IWF`N$
zoT+|jnVq;f{*IGe6I6h*#flbVFX1?@j3$ECpoNm&kSOHiVb`ENyQ0%6q}r)69_Igx
zu+%7W7+oVa_2FYx8Uve9M?2m<sL@Tp$Ou$`TKlCQd_UHsmpG7Xarh}l|M(WWl{#d!
z?D%}PL3u~D!N*UFcY5}j&GQTE$!xDJ@AYUfBWgZqAS&~Pv9WwleTP?N`Y8+;Rl{?m
zX+}M-*mGw?fP0xzL8XaE;^8m|>~B6dF>h4idUQ6}8<N7P-Pc26NcJLj#S53rN}h`6
z;p*33WlPD;)hePQmh1+?e`WO~L_|qQ+0GAXBD3{Ya+O!a1#8>o(p((}hmms!8yORi
zdW|~{HL?^q;dJ<<=g%|OY&lit6ks!TdDI%I&6q$~j#5XVv=OhvSP9h@XIXc_j$Zwu
z2Tjs$KG0h^n7~C&irgAQNy|gbei}E{3U$EmtZHQknH0OCeGsI6E~qV6PKB1%sZJz`
zrVn}EzRwm-TUXG~M|`m9UM*1}snLxUas^LLQzF*?k}sRizZ<Y8I27+(wp8OoL{l>3
z(^i)SemMcC+?Tne%eACiYx5=H(@PYU#KV5i-|`(q^2Nn$lG6mC5Y6xmphZ<ynIsbO
zqzSt>JgaI$RRVC=<iZ=7oU@r-3U0GD;1taKX2_4<t{_?IpNv8tdyY)d<-CH53bfvS
zLD<i8+;I_c$5DLjCStw#t2r1?dQQW*Y`<Sn`2!m@c#hw<@;$3PqJf^<M_X%2KUVIh
z_TrN1s=ix_e|f&60uTNvV-`2ENP@n-%5$co_viV@q8o_(7Np1E-&jQoT40MFY%bsR
zF!GFS@DzOJr>lGIoe@6BPTL<zx1Trt5-=Xaq%gI`mn?Ip<r=hNf^D6Ph1Z|f_cm*4
z5iTz-Kx+FgjLFkv*x)_76$#kNI^4Gl8|*+>h@*1$9}S`zBVB%4XlNATFne~#3D^<X
z{)9Ku$Hx9I>C4XcKhu|$m7DE<o4z&LvPu6b(ElfW=SR#dZ9+*001iNM1<oUR6?63~
zQjZQ2v_z|f5VAjfxu5UsxezqdR!AL61ZZ|{0blQU=#C0mo)2rtdC$bT{?v`~G3Q{|
zSzpdcr8H4{(ix^0npu8bZvb{XfER)M`GzAv8V}Zer=rSVcKNBa7Teu^C8gq`sWWy{
zKNEX_>q(OIXMBdXvUaEYWBcR%{OWfNc{?0~<6|nEBPz7IX}09ibK2LA(D3MC88K~l
zg_4F^MKd5gS`4>)s(+V$1&hnlCCSj<>F*+*BbwS;i~m!VcWzO8EhpcN*W9{!XQ4zd
zlw3o&b!s6PXUvl*YtT%)0$GP-qWD#<F$2dOud%-*gJpqj&OmKR$}e{WhqO`ZI@&G-
zP$_Y=tGQ%VhL6^oU!0K+#d<;{esitu5KPib9@065v`l-H;_e!mILyTGr2#)|?lUC;
zKuT#eKX#L9V?=zfF-XD@7m+3O*{*|VeFq1mP4-BG5a4bHx@Elq(}EC#Z7FCmX^Ej7
z2HQY~5MUHRp|#>~ErKML!moTwC=HM0KF!d9Gl{SQe8tg5hkRREFtQ_7SHQ2C5x;F4
zn6dcS@G~<v{>m6=d=S&kxsPC=2kuSRl6GO4IAF|PMO@N*^Eg35T_A51iwH6er=KsP
zo*V4Z1HR?2Vh4%o?~cg$IZm8*XO_Iz6iyS&^x#niysrKu8AnN|4RUjKsRpRYA#!@b
zgO|Y#fg&6GGSV#_vT@c+B#<{1(s7;~aIXew6SXmSvLq045h8NRycb#o8f?6)#;D%h
zuH4K`hOo(%3cw2xA}AkbnM7ZjmAb_(%g9u8t`-a8TA(*!+jEaU2D=wQIOCpiiNha4
z@U-IX7+6k~Mw^DV2X-`-CWJ459m*GGlHA$MB<c>cqRzSonR02Zm(N?V#$*2c-74=a
z)*k3h(#O(&W^NtjKHOyRK`Gcn@5Rllj6YZ<hrL^<?{o1OZYr$791m1ag@%@iJZIHV
zju#!7zJ)q>H2KtobfQs)gY-D5A=4y0D(0DcT1rQ3@YdyXHvY&-SPjO4)ZTw2{35I*
z=Q`&7O370j8B>Z<?H(wvTx$7lO2L&ur(WBxY(mle4lkqPEj+ni1pOuyk*j(l&*Q&p
z<4A=qxZA=-MMM8(@;q2aXX&l=L4B<v+%@e2Yo>psGs(Vji^BNP?M5j-6lS|~*Hjg#
z2W<hikbN>$pBz|M6xQ{h*|=Yw7GTp18xW7b!u?n3LTu4<9cRE<ut{@9z|9KJLVNKj
zH@t~s-7_vEtbB*L-<#~)cfWg^u8GsVjRviocVOYZq}-kd!0LERBD}7!@wDFn1@B%i
zCGWsU8yvL^i|w(}hCf=%0HHCKYeKI2n)!mI`mDt~L*P1ZL%?Rh8_TU1_GP$&Mtib3
zq|D@fjf_TN#;#Pp-OxFN``gC92K+kRnll8my+bc^wOhfgT*QhhLzk>8+}oK=@o*_5
zj?o4R)BIRwt4Ky_OC0<5hF(8$!3FuPuvZb-E@4L7rElt0(ko?b^_*-%9Tkv$b<h!a
zkV6PKnLx|*;5%dZcGt5>LR$$A?u|An@C#^aX!i9vfCPSD)z4D0$?2Yu%50#!;PsBs
zfVWfbL!V@)#agre#k?bs)g=3yYE*~(O@XK;z<|yuPr!f6MyN&PdsWL5S?#pFWyWbg
zwv^rid>!Ygsm%=1bYPD}TwDFMNlI8FW^%B`dK=?t@$pU0y*5~gH3alVJj8t-hIbM0
z^W+T@!fx2MmSF(h-j<6&1fq<c|HT)W-tvO~8hERq^JQ`w7(WDzB3syzK8WC6nmth4
zx;R4{BB|$8<sm4g5yG?M<eop}ognvcu#ezb`jz2bG|T<eGk5Ynp^kUGcr7D}*B#}O
zB7(OXXG+c<?JvN0bkrX&$+RaQMKG@T?G#5?YeGHX8QGrz5^SLDTKeUlF=OW<&JbtL
z((d_?&Hyd1I58u@rKS#MDh+irv6td9j?_1SODn8X_xH(PD8o*OJ6$nOxcdwdLspRS
z6aqVmFbIPQ#*>OkiT~Hjwn=|lh(8H7K2@~N45|GY*{g@NdJ(^LDiMwb`s{6^UEaK;
z%2GyPv|x2+rWh0SNAOAtK{i!KyL^mkxIJH-`?p!VnXpE*N(|H}>C<MBNC$7P@;kF%
zNK^UImOJ)TO;{R8o8lzS0C-%>+RgE^@Ks(OhaDm+wB!{{pMdoTM?t&g%Q{4!V5g@y
zQ{0;9KV=cC!z_t~Cl4?*4~fjCafMkz$L^(I@dchGVdevFN$0)e)qk32Y8!(5mZqB0
zE<%}jx#~u$oe1<NlM23$e{nMM9z3wh9;PjW+j)}i*vlk0r8N#?b4Ibn=@ImV+~?<a
z4hNtN(ulEebW!x~SXwXiDF>j^aonozXMw2%PJ6`(JbYbYl`J&*Ywz@9Twe00f;+0E
zw{NjDIMpXph5Sm5yW3dT!V_+v6DyM+H3kCtc&GhxT@5`k*{3cL5acm)-vb2EPu7)1
zTQ3}Ze~K#H_Pa#`ZF)f*<sJswnPn6_XrIDUv-p_!JEXX`DK$UYp%!QKnf%UKtke}7
z1W<=y)-qPF3@67ndW=`I3kDg#$#EB^Z?0&LfT!)(X-oF*D!921iG^Zb8T@#UTVO0)
z<oY)^;>R?_9S8W_ND<4H1Qwy9g3N*MROZ|P<VSoLtmAQ6G~CQsl+JH5y+4tN;P`zg
z0>5iHp>5PlYX6Sh@Q&+7_ET3`eobjUj@@9P3b`RZAg>zx?y->vRwy?zL@5;bp@Y!J
zM*kGOA<rWB`X*w)XP6=|U3{XavPSDs1zI;UrpCIL9XvoV{fwEERhdVK8X0kU9>!gM
z%pNtyp$>+!2|o<~AwY;>bC(kJj|D7P(p~$)%-lp=<DMrYUhqn42c@ZN`*?WRjaN8j
z9XdiC-Z$?RX0uLZXNehM=vfK8sIe*uJ&M|-Ku*fk>4g+B1R71~RZb1e<R1CZkA}qa
zdENgUSOxqv{@e<YhlOwcPdokpcQMqwoXkm>6isYY-R$9*6i8T@ng8#;ri-f^2{$vx
z|F_M_!o~c*mDP%luH)u7rvF-9`dG1WnCtPhyD|N){HpaID8zmG`WjP=sOd=?yM_2u
z-m|(JfK(*Dv<LMBwjB}wPyy21m&^uDQKE^8HY%>TM#3-g>T3C@phhAgv60+lj;JK{
z)MR*Wo+DP|YE3~gNTa-_Ms3Kss2aElItxsF4FWZ}V(!WiVuDjhe)y<%H;p4J=vWa#
z=GQ<RJMK%QzR>(}Nnsym<NAZ_bvkU!qxfW5qj17<nklHcKuGMtetctox;-7OTO&UF
zst~T=lb+ylZBM8q6iQ+C@Dp&(PlUkrKzi=LUH;obkllU;Bp?kk5KZj}H1D?ti!c#2
zxy5CmI@*9R5*iP@bODE@Gh2g8KA%*4h@Z-Q!U00ht`{^%NrZrR3P}dlE_nC+Oh1(y
z+pQRg<(A?+ze5McGzqw35I0YRJegV)p<HALl&2UvR3p0BBa~KRd6=;SdO;RU5q^-$
zFsPWU;3g>QwHWj7umY;`KM2*f{rJpKXfGhX`6SrPDI6{X?M^PBICS+8?u{T>f1>06
za1Ti1sr-ReU<66(#~;`e4HJOr#X=m0up@s(9k?J9cTOrNvy0_(qSJ!JHc3B(HrsOq
zJ-3ldfQg0gWZ?oB6(bCYpPFeg8eyT2tc)m-vln;<jiC@QX_F!iPL!~7b1RKB&>CnG
z)2er?%pD(<=c+CBS$Ws`e|z0t{u=w!_qu@dAdy-@-$Ku(O{+a?){$zy{Kb3bZ=d^W
zmF?xv#j#!Nv21J&Gs8C>B=bCUt<aR*s5j}-0`^W=>5z2p9B$K0+YcN{e9kKV>5Vd4
zB(<;orkZk6d|G69_giz`K7H9C9MqQdT;C&h@Ape~SU3y6-g~3{K|H_X)LNokO>4}q
zYvj46)_2>t3l(zQ59o=q*k%|~kT&cKUd)tFj@k4*Pt_i~3gAoGvfg`xszHZnQod1l
zX0K2TT^$(6f4zOGR2%8qYbU^9s<PHsxabfSgxbybG@Pxv0G1EutZ#ei=E{flsTnRu
zDkt8>J2nasf(#%il9{#`g)dn{@>7kUAxdMg0rk2Hk~ye$9HLe2+LnWwvutlkmD})J
zbm_tzl|Qgf&WyzK!vaN|eZMLkW&^V1gpi{QD}mZPwpv_eBZkpjBU9)$NMsk~8dTJQ
zQkU9n_mottupKN~iEKtlE1hqn*ei;TJH0k?FC++Ji%=sV>Jm+9iFs~Qs>@D)%k~0+
zr}Uw$2_Dquvf{7Pcq1PUltd!Pq&C(KF7v205pmjGVv2*H4Qs8|s*R~+_+qdkov8BP
z)(C+}Vm{9?py?$MeD(_m&Ig2V3Y6Pl@9zqf4n<KOzm+9dSf^tJV}OBC&5^}L?Sb&T
z+=5pS)`!$c$Vhl_BgRP+Q3v~NFOG*dKrem6nE=|TyJEq<?_$Xn^Sit|b7%EfLp>zR
zyt&G(vxlAzvG7tv)<~y}1z4~3kwPKUaJHqqP}u_xUe>>$%J>pYbi5eRaBHMOuxWf<
zIiX{^bWPDBpFZZOAuLgq4Eq5>J2#q`xYF)OORyItNvUf@n9(sy)?5N2^7C`%9GEkw
zHk^#tHx`2_1M>&+^Q_@U9*a02M9~fZRK+Q;lw<9kc#Zb!HD1H63c0g=$g_Y(%6J8Y
z!BK$&gOp{6P^fYg8;f6CU6m3{jA2X8EV(HM(99%_IFzEzh^SD*8TriU#GxaO-ZeWv
zcZzbhIHT1HR$--U*w|%&z=Djy`Ze$%FVt9^_kI-K%mgf-{^CC7)7f4~RVxUlO5oj!
zlUil#glK@~+L2u)mg3KQiNBv7@`XwZ12CUk^k$uV9n}rrYQd^70b!~X9Xl{>4F|A!
zjZ7X5XtHtB8`Q{uIG4gCo@9FR{@u1(Aknw|pV5Q5-%kw0g1%)jmoKc8YUdHC_-6w;
zo5eEI|G`OO{T7e>v<#mO+OV0ohX2CJ)6vM+Z{hSL03{KkgWNqY>1BdW-yEJEeP@kc
z0Oa(fE^dw~Q+l+9Bu)!5LLm#93Nnu6ayEhYK)e`X^(MGQ(!yD4x-N9EXrptF(c-w#
z;TiZZ8o3^$L+0iA-=lBDEZumUu#|CAwqnAairJPraSzFW$Ooavgc%Kk4loZNQ3G&T
z)S`@=P#2<LxogPZR_}-J{rnpf%hA&XcvH*E;2vp!x<Kt=nMa{)=z<zO0IAncr)EvO
z=FnhNH?D(+PVSq*N-*;kWwY|BtXuOvET}Y6jm-GQJQ0Ho&k9%4ToN5>o%D(eEz(>S
zHd7VQNf6iXd+pXlZ)Sc%Z@aJBlek4ZpOK0=0|<N-V%UsMnC7duW=WL(Y*o1xT)O)0
z)Z^L}r<KgagbI%L85)l?49#Of&e3Jx^dl2i+peyo7iyc7JJEnWD=F<$i#;oXhS6=n
z4d31k8IUTn2K48agKUO+k<z}}?0x;#j=7i6C~9}qaE+!v#@4>_@2MXlxk1qaEu!W}
zYn8$yg3C()4LI?CI6juh+d+^_vN+7#!N8`VJcY(N3+=n4KsB-wr$oLV4IDCMYyYr{
zOBWMx%XLq!>(@4r{AC7)cZ}fy>mjoV`2j~jZBBjMYGfFEKv1CceHSz_8e`PxKWEe!
zz1n|o0(e0v{kwmDq}!W{Jia>cj>HEAXtPZSZCY(QzW}~D@z#}k-%*;XV6HvAIr)F1
z)J+_IQJQS~1Zzq9i%X)j3L$27^_?cCc|zgBsdiFKs1^Igp9lUQ%HA=!lla^Ejcrey
ziEZ0<@{4WTwr$&*cw*bOHL<OmbL%-(x9a?>o^$(E_v`Ljy}o;|{n?g-9%-`;1|74S
z0ZD%7_U4C9^x0{xYW0{hd~orIUG~ALd8^;<31{xaN_aNt6^p(iA8aZf$c3Hdeo^!Z
zh3QYYm?uY{N1U`zo&H)^$AbK#T(*1zFNe(^W^m$FS$?a6sV-A0v*+30kZk`rQ~syX
zVPyRe@eL*>hW~Yus98hW?tlZO`?+p3dmX~Cr5utJufxpE)5||UAOpxLJtN4PkqtTG
z?kvIiZAD(uP%&9#ZH(>d_XL}2_1oDa`q37yU1!$JHQ!dx`wc9tol+uG-qt4nCYYcA
z&kJd+_dY56^XpVzmSaa$r|gPe)MYG0R!a}&r^^fbd7X=&&qbYwU(MUOlV8e)4pRM;
z@^?rDeS+@L`+1U!p1OQqjSq)ZpcVIM((?SW=AwUPE`d$r<<4_Y_kGitex2P~$NjHM
z`0WsVdn`DN)=pqaUnzE3a!tO?NYfXd`?mrRX^T!u55A9<9SG-prcJk)_>sL9-cz&d
zhBwB#7T->f)B$=wHu{FCZi|Gqgl`}2%{0|+W$d69AXdo%_gTr0BM-i-6~KU53p`pr
z(JKAjTCPr!U1iuBf6st;(;n@2X${XU%}F!H+BBebDFbLe+V<+UtT0hr-Oj4QNR(2;
zJ|;O3nRWWirfDvY;O)KIrNFIxdOSOgG*lL_zXiu-Q!1h&vT?J&w_HLXan9b_I$33_
zNApbmm#3u+9SV{=?A<J2!rhgl0H$+VQ&Do>N{~{r$oy;;S++OyEvpEcOY0>KdE5fa
z^u(!4mVJp`5hQUaYTYb#lI02NV;BBik$%qVV+=b{VD+5UEl(k6)CuZ=GU5{rGfa0J
z7sV%!q<anhgOUN?8V#L_n;%XxbG{<#cpF@&9HF<4%R}n24dn(SQExE=;*3wo$2;y#
zEv0(`!4s4y<mj-(ITZ;zt{*S4uRnMnWFI6YxIzPogTy}!<>UL_ulxLO{I0V|LV|w-
zWhB2EpdWgr1x{%Gg{iyrwMJM(1ccbXT_^yg@&@#*Ht4)H&TYJ`HJy@+qCxyCbT%~o
zh8VSV4-u3=7r1*bOzL>5=_9wXy-%SudeDN$rC<Hm)z#M#$Sip@Ht{MtI#WhRyoBWB
zYRQWS4$`fbKNkE)8`XqVC107-k_}^sD-QXdl`Q`LZf_QZp;2#!=wO^#$pbp@fFa8K
zDv6~ttL8PIPj3Thy>*1CZcLa`jVwN+y(U6QV21at@2X<=gz_2PU$Xr~1Q?&jp@dc_
zuSvq4ehYWA_ev`rFOpuok;3#^16g{5u77XstEe>!4Hvl2?QQhG#Fc+tDTE(La$j5E
zy!?@Qi19?8D}pfrph?6X*V@ss%Rsn7kZmTRmu2O@PdsM`Pm(ZzsHFk(2!Ry)WMT^6
zH%DG}FN{BHqlFjs0Ou;9F-O@%W{nL*i(gR(n~$~|<)mQ1T@8k1lSYhetDh(902_=I
zwiy&sZlqpaEuF=d3EhL~yYUG7ZcM(`B)L5n@TXJ9ia&HW)RjefhiKD*v+i?46i=#Y
z>Auq-nW`uxSc`Ye<xb)^?j2XnOH$!N6gG*m_h7GBvE#REs>GP<wIt6^T?X4OuX*BA
zbuKqFR}LwTR;$bL9#*f7i?G9IPYv_0Y;A|WkEu@b3JoNz>P}RCmmqXY`uoZDZja^u
zrtbp$l3CWGd4Ua;SLN-_W$=KOR4PJ>sY3)!qnwf9L&{HoIi0Lu?CG9b5B@V+oPv!b
zOpYaOedA{q=$2Pq7)1HG*@|K#I$glUT7wP581lVg()Q-tOL7ApB54Vd+Hr<2r;&rF
zpN$63vrTh0%cZME9ap7SG6;LhQ!5Na7+C>MhGv3Y2k9qcj<R`Ct*UwnmkDOx$zG+h
zf;$`egNX<Vw+P0b{zsRBkY$b)59FRSpQa;a@vk9B)%wRkFgJgT((SYwHHyHW%SoXk
z|BIA5ix1Byd}##k$Aw=URey`!iuN{1V5HuBNUIzMO+|53XG!VoV#$1AV1qOQHd-m)
z2j(7z>RH$$Qh^qD3#$x{x1;c)G&o3?7QQ}{BVFW`WwJmjM|N8mXWebEtjCO7&5QTQ
zuHRrYiyhJS_&)g+aU3x*XGBIL<z)-0ce&hg+=di(i)14tUSQvv5pP?e!H1+r!T7e;
zQENVQ7kw9CX0yV-TK!X)QZCzrD<#aa=Abv*DgrA>Hk8(Us@xaXhAbj*U|*`CQ{>9t
zrX%2&3aMz4YAqPSRGQ)<6XWMV6epG+6`nh)<0NXC>4PY6Ezy`P4x6+WPMKpy>0qmz
zVkz#cI^I9(tU^@sFoMxr$eB^)#V2DYdvh!}rX`7pBHTFrEDZ}xAy#8JzQ~~M*malC
z$VSxXe!-Ngk_&Ow?8}oy;(rc1Hzyiq3~m|Q@9yT_Z_vpRL+r#)>TU4T+{%{{o^%5@
z9W~FQwbG=Qvs6kMVRU`OVs*L~@<EMaVao6a_nD!cMKgvP`!ETn2y^6#O}$!loutsL
zi!*A96)H^{gVyuFy7eH%RQ{6G*Ab$xdQ2ZN(?{C(;(x3&ZgKf@l3C(uI}(>PHWt0C
zx1E*_oNC2@z0DrQl|hu20dLNmo`Uh@|M^}}C7wo0wA1#X<G3d0)65=5#mN-B(^2FJ
zZh#j8moJFA&kt`xWVmkAU5gihn9aXfM$e1Q#Xsd3SB!6eZqUZ%B)4kKX^lbtr=v1|
zV!tRC<QH;Q7t5GU58z}@NMr_0a0N(GFzN7(vDkne)zfcZ7%s9O52$p~_`Q^>JvT%B
z91QMUch<lNQ3$0`1OKL;bz{l`ZYGJMvXm=N*Yp<F{_0K>?$4-danr~*5M!uCd9L$$
zrIFsSgoal=$7N7sZXIWpyL%ri<PZWud;g$)UkV^LIJte7!_ae{y|xSOas@AJDQ3-N
z6c4L#9GqNP2PTSw>Xu5*Sd3N~-HBle>zjg{H}~Y_NvZi-12jIA^EYl#zuDv$s&%QZ
zb}i=OJGBbwUF7(Fybz*z?>j0A6V{$et-n57sgU2tJ#a(R)-$AF?4-eswIzY}<hJ(N
zmJdJ0AnHFvH=<CYhdN;b$R}y9kB{fi4nLp@X?fQF;B|fqH2(v_^%GV7U&m3J)uod*
z*igFP)y(Ck0WpN#qHo8>7b-2|V+JYf1EyB6zlorc^@t?m$b0x=$OTcDTdERaNfiYS
z&adk9pj=mU{=Dx^xs|bpA!;;GD<p`nT{*7}IYfiFJIN5E9d;-;zt^q2ytCYp-By44
zV0jh2$PFofMGZM2&2+c}_SYg#lH6Oq_~e+clU@>T2`V&22k(;}yINeImpMhG15YT9
znwRJ2GzWn!kxF#;zONtZ*aMV)J;c!XJS$?rggir2WDhDGT<u>M{eGyd&BmUOmHEQ8
zb5GvMHP@N2Gg*mk$_dw;8=Gl-<9$TOmn8MmCoLuQ#d63BPgzjy8m`e4ucY2f2d2lu
zK_62rq+%rYyxc9z<q87$$A4jiAy*)!lfZT@#8if`D?OiC1zlT;^S^|wJQ^#2tS4wg
z^32z&Y9c{!=^P>2MBTQ4m5lbywDj(F*I8JMc@`eXRtz<N9g-)EAR;JVYjk6FSb>Za
z`S$J!XI}OLp$j5ABKCP8zfjX0dJvTIfBE~2Y;wOEKq--`)I02HbR!lQkGu0zaroj+
z#r{j?rvF>OIy8XIw4&kFM)LW$2`XzkI$3FnC9YF1h~;mL(abhJLb0g)gPfO=Vsv{z
zl`rq#>~S@`ze@SwP*CW0y_J#r>RkrwI@$5|rKafT*i75e9XD-RXmVV1l56G!Z67Ze
zBfAhbfpR{v^1i<fr7t>MBlX79*|pcA*}7HTt4O1n+noDX5Hnw?v!mn1>?%)lXdZf8
zb&mSsFGi$QevlFUF-^&GT47R&2)^3xGctedFhhGYoIQpm7yKcAI{&@000khaf)ey+
zDP9Dbp$hLJxM7(;tM#RmvuEi;pk_c}fA#cLcrq2kom8y%5*JcW5B@fQUXqn+Y-L+e
z2d2;hPoBiie6r2JO)^aEq1+U$8&oilbToadSbfR)C)7`<Sj`HlCXMMf4E96z?^i?e
z{%dnRu81mN>7MB;j9^!|s{~Jf^20`QR$YC=#!*U`IS4xb)w(cw0JzVICPhKM8U-PH
zRx?IhyZy)7#LAIpdg3}j1)FnT+u3n3Y1^1E1LoaTPx)NZw7e&bf9aTP>{0DlX2Y$E
zh=2jS00%yDfS|5kj{co?tq4T_wCrVz`EW5hJ!?wxij0sbSiQwz;k7Liky+a+daKbl
zX@m?Z1qH@CIQLXeA?}cSuG;V<*k*+<gY?iu#?&S-#!*P9KE&_#u8qc3C6lgw4xv6s
zf$%u?K9YyO<M%v)h!8Fr&9sX3?;sFMYp6FK6u}~<z<Hi|?EX1og#6fmq){Y0fVj{l
z6Y1@JZqCcFZpDO}+gsFp*CD07<#Zaa{|c9ho!Yu#J&JSUv`N<`xcOU!e_YFLh2}es
zaXBvbP)E^7c^n_(oNlWae%g9tcOCrU5%-6Oajd=I^^nfE^dcZInQf0=nCHva<;K`4
z;84AG4~Wds60j{;%8(-V%$OJigU>(0li)?%aAZ0!=;-r7DWuR_`n}N=yD$OFj4o})
zkHETPU*$!h(abP&sAsyrvS?$zz;&st2<7gp6WKo6?YQ-sDK`?wY{EwBI2bf`hsunT
zIbB%wqA8>v2<*`qiTk*rzw|Yqm#ToOa*chXSwTC*NPV!RQx^{0h(i?{@Gob8M$jSg
zg0L%ioZVoT5D6%<@xa!uChPvNAp#eZQ>f>t-lPHT&|3%Q8A2s6k_SzaQ3e)maEwmK
z1KCbsYL_{A0Ia<=_4XLs^Spg<ibF?%QdUP+Hg0?da`OJTuV9N0BC*t>^Y>|Xd%diT
z>`EK~!5mkz@j27xT56Z8Rv&|%U^D!r;KY?6hTidoYVc)N$~7mwi&Qc3-s9d6I4e-0
zWv%e3Ayd~b(;M;JvXH0E<X2i5N-Jp2QZrM@gb_QrGCH8Mp9TWN>1yT6MTRZ@wVHXR
zy5Tg-=n?0{l#ydj?E46-NDt1pL&O`W*c;TMY1JeYIfb^^AtId4zU}l3Q)4q$JiR?X
zVYz;7>D%3;FqR})Pg7B<$2Wiau-k8d3<{#=)71GC!ZV~;=e*mswm81(_|}>+UM=Se
z>DblEathZ<3*ffh|AheS24tKL--mJP9Wv}-r{s#Ru>`AB!@^@ErpBu0acsDABfyG#
zVuIj1opEdi%{3|LS9$_**02blj!UN7EHhww*FJ_|_gaT5J(X@UyokB>FhAMl4BdFq
z^k*iDZ)G_XUCo#Y<l>z6Sj4V9!j#HR55mITDc9U)d|}n*%7d!m;_k#N+7i2^V!oir
zC5rUSyEu^in7y(x(Z_G#5}i$3uOsUaI4!?gVo4oI^whJ>#|0<wV^&635eZ)>B^R<=
z1MD}mazTv)m}PT@Sl}v=nD;vdWq~vd;dG-tk(i<bHSMGV3Yw?QF?OMQSOF$sSU41E
zhz8QfC(4sqSUB!cLWWlneS~|5<BOrtY8WsQ%^|N+bRmbH=K(3;Rwy1@xZBIy`@38$
z)GfvE?HLr$;uRV3xq_X27|ExB{IHePsX7bi*2F4Ux;~Zj9cTXG;NDcilL<8I;+tp{
zVSjb!g|zClj<j-R>NiVpaZDo5=R~#R@Dpzo*n$dOr5GpG{(+S?Z{e$0VJO;%26U-W
zS6dci{Nu^{LKZ);qg-jte{u)^DXhx$6Jh;-um3xub4y*vZi5ZYXXXd2L8=cRJsVJZ
zOI~!yEYM+J1cs>|5R-0_6)9v<j7<6&7AtyT)l5igsmL*)M<Z2CJJH3@^`dlZ!fq?N
zFIsq=o6tauMj?+7V9BHx=L^SUe-ckZ`g3lc8{^vw<AvJ}nD}9KdUY?|@EzB<!+L1l
zKSj3wvXkDnb(g-VClFg^?TKj5Qiv7m>|%RsyLB;{3`!<lX6wgi3}qW89M5kjY~oq@
zGWxntp!NZ*q&2!5a_~U}T)XpO#eg1r?82__10&h^O!b3D*YT`K_6K+E70H(_G@jP;
zLPVJ52t_K-@xDLaH8Ib_x}b2P(gSwh9D^-<_6Og1ZK^7(aSRd$_PbJlQ+fKKr|))P
z?vsr~VK*$@2%Q6XETkNMvfk_q;X`Eh{UoM%JCcDB>7+H6vqFFRNKf0k@Mun-SF<=G
zz7N%P0Kcr`|9vm-Kb#4Jrc}ini=lbY(=s=iIoIuEe>i@rz5r-_#aQ4AQ6Oy`?%_Fl
zpLf%Byca1-Nj-?lrq`)PDuy30))TCzF2U6Q6~QU#Dz#6I!1*}p2-u6Wwx7IY{55+K
zL$RvgHE!kA*D<27zhO@gKYu^HNcpFOrfNejW7Hd5p#oH07WzGAdm%(Z9Fs!z?~?iO
zstWG`-zmhtgk_Y5ki(B7aLOhX-=6Gr9>6qh5|9johCZ!Gd&Sm*NHhH>LX<({G4&28
z(ZH~$7{*vSt05kdp1u?!lUDVrsiW8Jj<Ve%-WmMZvO^`@I2?{ncAd5rI@yHzX<Zrf
zNOtvkSVkOQ+Do^*6S$WB*Qf;kIS8)=c)1y+ed4OJ(PqKm^5chHLn2%Nu-qhmx~Y40
zEo8Mv0_tDSnnGYJt$R*TGJjN(Z;<t#kXyrEk&8k7LNWKa3=ZGmdwe7DO|vmKvfCsX
zs;TI6ILVd7eO3~d9h7Xj*Af`^R@JsH)fv)9SocvBk)jh2igw89yCC~iTFH*tK3w)L
zDTEdoO?7SM^piVuP)Y30PQ2s~!Bd9$Tsd^mHO*7Sxdm0tmgdVgK>PLl0Nix#CcA=r
zG3n`Oi=~y~g5}#$IG=KW)!q9x1SbhuN)c4nIvg>z7YW1P(W6Gkii0(VNDGWvh(2pC
zsN`SpiK(P@z~e{hY>>tia{L;=issYw6K_>H_=X!qh(Kkm)b=9JQy*I!+gD2yVG&A^
zxTvS|5bWnUS>Q^v44@N$7TG1XuI4Mul;UKz$u7Xcmqu(0Y~+`%hC+<;1(EOz(MVNu
zcBc@lo=-iwvTBA6hwAQ9ZbkdMwVNJA?q!oh;)%8md*N<4aFuW%#ZyOJVQ+-cXV(7x
z$?N-yUN;;XneRogL;i4u&Y&~mR(V4Wtb3O}3l;v;6f7<v?~CFjI_V;@QDfy;E&M|x
zrG%!ho`e_K8Pj|TV05CMT6nGSge$)GE^}I0Ie@ps5)YzW*&Hz<fAC6=8yn`<p8Cov
zRmbvHEwdp6n=FS2ZW#(o*<!aRuVlQUj^6WvkMf3;Jf$gWjT4>QZJ6@w3MDy0;H%@n
zMI^J;`J4Z`Wx5^lBX%8v{{~iw6L##(&o3C>ZxETy_u>T#pWDCkxlbA1e*`WXb0o-b
zd*)dD8;CG}i|{{aBgcP$4ly#a{IB7Jm+D$^SsZA-d3t>t{!K*bTKPVi(#&19RczF%
zmTKGx91-Y$kU5waJ|C^TiQ*HBt0o!V|Io+cZG_G2aPnbt56|02XEjc&t+`{riCK>n
z;9xg~?6oCaisUjvYkyfyDjj5HXchG`vKLNOBj3o7y{R`jVnnu}U1~N}m{*uzi%M4~
zU<M!OU<E%CDpbXrUu%9=H+Pu(Kw3z4nkeC0(3;eUqKBRR4S@E4Jh`~cD4MSJ8(A=)
z=Xx1^<i&BXWxRVG^O48@>^Kk2*~+GCZHDD=#U1n(tM2~W?d$T{kKM+|KtHeIN~o9v
zKk&<x|4_f42znq{h5qQJ<KQo1Lsn6?<8MLz%I05z=Xgju|6qooWG>S4c0~^DpiHq$
zVLrWeHG$30{vP9nvKn(L+C&DXUaUCeO#b5zhFR-q^{%~fj2Tn<DiGB9h;G5&F>b2V
zk5FVKT%9ooMg^ST5=KGG&Q0J2^^pvKU2cuih7#}Z9AeJJ`nZUfy%>BW(5ij;cIG0O
z%le^F8cS#`KN%}a{VMPbEjX)?Jw1CIx@PCsn+ZPV{4L`!SiWDG+Hrsl?1rQW*2IHU
z!FnklnX4;!v9!k=(v8P?b%19X30(_lppO<<*LRY&?6!I}q&u*bYz1&oyl-vPE0ikm
z)@$JR|4EiBymZYANXgc`3jRSmvn~zg!@`Oj7YfNZsQz$~oH*6%wc9Kn2(um7n|K&s
zPP6LZAJ)^8LC5V&{PjZ}UFx9bTT1O#d5Xp~bLz|Y*pSPrbyggecgC+U(oF*M-uWQi
z-!HXmDqE177ZnoGY1&#8UkAyafF&QKyzWsFMRZ2BJkF7-XaCN0aOC3Ic10~5XnS+V
zVxJg3kJ{Vx2=3=m0pX%DWagds7P2Of{~^9$FA@!7m#gBh2W8l+z*xZng74|0>%r4?
zXM+IwlwAQ%!q@h9+cHf6ti={%f28W!#XUcLr6lvEa_*bsfCXa-PV3|?3vamX8%aTq
zI77r*e6EoC8=;8ZV?zG0z}B=|l}5_iQ^=&A|C(L#>xX`)j;XB79=5s>e%P6O6Hz<i
zFO2sVEm<~lt@?JJ0XTB7Sgh~7N5AC5p50k(iHvZjwK9^VE>(P+_f71VNea6}$C-Dp
z>{s<a9pf<1dgK{2gz={Mds(Seo0pAkc`HWEbSIOuf^80e9i>qa0FTHlats+Nk>v|j
z1Zk#B4{r-oJO5o9;nDZw9fYn#QD=D!oGz{0S!5DH;aeLRT1FG;FJs@$Zmfjdq+1rQ
z{6+zAtZidf-1p@%(;-*gD_X#_SR8e1dY+Nw(Tq^g1Gt`b?u24%?tm{3BT+)fATAYD
zp`4`+dY0ln&-dr(<oO|7^a8P)Dw#a#lHcdx!^%HtW^d;Grq1_ku<vRZ)0UgGo-oSM
z(t8IdJ)ld*w29`IE%D?-iyR05Vk_YvstTEx9z8aOJND}Q(8bXW1mIl7*Jd6#pYx%P
z)VT;KQfHn%9<`Ll3?Xn&e49O)IiH{cZhJxhNzDGg>7M_?VrOJx{QqI}w4DA+%>K*h
z?e&3yt<Lh9<Vd@bTey~9S(~+RYyCnKXO)0MX?s|ys|ACSUDv+I@IeL{oO{lxLijS~
zy(K62>Y;spiZh!dd7S^1E}M#(ghY~?7o6k)H|WwZN$$s8!X4vNrf9S$7c{$P8M{=z
zBgDFFxmnJrMyz_!j2*!Ze~{r+VrzOw##R-NUB`7_c<-{b2B{%wc&LegN^_JWDkJbH
zcmdY?Y4$pjYsay1{^h`Qjg%Ki@eqh4Q<|WUACmco31r$;7t$_pQq}uB&w*~YcsBGN
zgh(zPX17Ht0eXTe?5V^CKB8)H#Waevpe*y?qN6aJub_*>-TH<s9^KeC?bB&`Zo%-Z
z1pE$dALsYI8OU3F2*0ubtJx87ZTt_|{?7F(nHEv*u{xhF9o9*_S5Pxj|NWk&|74zH
znBCJ6g8g6AHE5NKq?9a_BPb!B(l*2T58R@M!W@FL)EM)hL47IfaoQ1(H=v_F2#ls-
z88Ov1p5p}82*W72(p5POP)--!MMpG7TT_=VL&{a(6K+f&BNK1d1n6h}8op7BY*#9!
zX*rFo!GMvOm15q8`+bbo&aC%G9{lgj^+RLOzyM%aFgGjY*<^GUd%>Ua3t`g6`);Rz
zyP<j*-ETC&$vRrh3wYdp%eYhV+EpkVg>s0h+eHl^I5DMp_i^Kn*{#~gV`m^(WF!*3
zG7DRzo5@Q0`}i^PxOE2T+wsgsBG!`ZH=xoD=@+Z>K!!^kh@*3(Xt19WT~mmG0oro4
zp2t1n$wZOCXrpvFTG9qhL*@IC)zWT1c6<BJsDPvZNl33QO}RT%rI#hlU;<G%EyXUR
zQ=4bFwv1rM=pC*^WG4&s1vWu+ctYciT5)s`u<mbs=OKy^?HCDIQ{BT>s%P=y$ESNS
z5g_`X{`OuYDOjA8za7CtC&_J~7ugqh&-rp@U4uQ6`tJ2;@-%uNDbr~ttE#Bg*SG_N
z<~!1azR5suGQ5Ve?7Y!))djZ}pT3PFKB<n>yOB$y2<ec#32g3!E77zh2Y1k8X$99~
zmmag%NC<7F;T(h91S6bg8+=_R(eisRljivE!4{~GqWYpMJ*jgAb~i+H-8Il&o3|%D
zC7-74ha6_qk;oX@pni|2ez6@L!-+v6_n3CbL%aP|V?*JWC%mfKsF};Xztw{kULmlP
zc6u4MJrO*kJ*>+)F03nLg1E==!smn{$N4VG=dmWUEDHS$IJ^&0mN_<QGle0Q)1}z@
zl$p)GunRu{Bt}5oaRKJcI{f^D0fgk?5TQo}s&ST1qn!1DQqwb&nD}E|XAEPT8L9QE
z*fbmL;6Kj0!Kd3<ecv7)ZlC$@u(W~2h$C(N-r}Np0%z{@dQ)<n*lKTHk|CY62=|t#
z?&Ed%0MKR)$&KCB<NWhRHA~VeOPQA;jAl16CvSs?=J*~9xq5rnxSbnc7%a*I8^E7W
z4S;~OVyQXJ{nt}^G-eS2#}LMQzT8mnuipTR6^@fMAH1l}lEkDBi?Z*BRRN>l%54Ug
zoa&C%i$gBOVlDjOqN5nD;)&-3ffoT7=YDfWqV#h{q;ZexyY&dC^%&=6;5?D~v-)f2
zbB@>i{-84f|49-5LkNJ8f$e`C0{F3a|8?~JQADIaVG@V{(KEveI}JLUFbo_3I_xYO
zEbSZ{a^$=Sl_cXuPh6pds$)}AM$S6ulMvqe;+`8qk5d7Um5Il4RT05L5hkXhKB+BA
z->6htDx%R!l#dm@&}-BD=9@X@G|j_>Sj=Ju@D7F)ndQZosAct%d(p6VObPb&;%IgT
zf!I?`rpP79V$~mPJ4hzHP96BCKCvWR(Xu%B)X2WybOoLaO##>5Qhr=_O;g9O`@eG$
z;qv-=-2xD6Gze)CKc*k3p^D}<=5_3EFm5(UWDfZ)AIH|#Ue~0}AW-%54n4?ekjOR2
z6G3Y1$?r-l$2FZ%6<udqM<aN+T~N#qCSq(x^dGyK8Qf4KJk-?dco3Ch6c)p8quH{P
zFE;8grtOFkX(!rInSRHcBUh}k(lV2bXA%$~^n=tx%*mCS2T)!c2fYqvK)QOa$?6&<
zA7p;J&Gw|l%?^X?MEO|&dz-?7X)07JqPD2&+gx6(oOZP4IBQ~nn+hEWsfHvBM?KiF
zI)0Q-CBK7xl$KkPCyb#@n{Xi<UcIVp#_;smk@pY;wt@KiV`re?j?EwC`CWqj-lQC?
zrojmQHIk}&zAXOA#Rb%*RGk1=vEK|#+!!CfAPb;dH>|mTc`S<?d0XUT4!C-DVM41{
zy)XGv<si0c>w8>%AT`yHZ)aMWz+{@+x$zOC|0BSO@{eKkp&(JcNl%VlJ)n&NSqjY8
z)K90g?Lsi;9!~Xmv-Dqw80+}p{YpDgIjm#d=|c6e+4G)SP8zj}Q$GL_*fQIQ(tv$N
z2S705(mIR{y8v$~CVfQ9IyOc-Ci{|kHt`2E--o=<Dm0TNBtz1DqQY4;!JxKs$CF#;
zlus_ye%l;MRW|*fY`1L+!8K?i9Q~7*@&fIFw^eFqzvqFQL^Z2ywt#NWS=P4nyE#-S
z76BV$`+%hvh}3ML!f(Dfj}5U6OnGL>^Xsr@%#fCT)}{RTQ+r9<K#4`;x%6tgt0=D3
z=#@5s2G={j$ze$oEa!U!k+H*AuO_D$bz8&FJUV>0!5bPE0qbw?cKKc^9IOlP&-^Al
zu+K+ySwKs-Y&ylLj{YL7WUNrqr18HeNAkf?haglhrLIk`1GtTx+6njB3z_sX!yI-M
zZ}E}uWsvv?dvBv*+G9R;UoR`;seCxqe1d#POxr*l-)_*^M*;I*LBz?8r7R2y<fo|U
zE}Tpd_J{zDgFa~1nnQj`X&!Kh_WBQla<TjS0yd<!0L<qzvZm(u$MH>Q^jY|~M$io^
zsP0mrF7ISthYJv=-i~)FB|;~=*CI-A-wQ2CO1p^17ti6TwBA`|MwYCzWp~Mrj{>!C
zhCK>?`=VT9!Vju|P9*Ca{>Uw)x2&(%yl=<>zwd|-_L=*Ke|Ci4Q?LI)cQ{%8Lqm>{
z?SGx4-cpx#`mg!$ceNWp18N`G%k<POu?u<kVy2u~;tx6|QT<jGrD^fwjqY|=Sa?KI
z+k$He7)(b0*5G;LQ($9w_)p9;=5;D&np?M(2*q859nDIpu#j<BEV4UT?l2Q0UuIkL
zjddfsjVbLPBgZ*;QR*F~x#hyG2sUIJ%JnXDSgSqv?pG2BU-p|t8nX2=MSh%`TCsNq
z8)!|sOZ1`&Z<Y$+a<*HU3(dT=9^KWm$u|!VOo*Z&`tWnY3nZhx{xKbK{7+P(FJsof
zQPBVc98p~`yTOa9tgMZ!*5yEv)lMmtHH-C1Dl0n3^M=%%^*fms(|yH3nJ>nvQ!%$C
z%W;pKTFvQ9Vl3qwm=O?2ia_RU4DPZjnZ9U?p@oJQ1p7MI3(y0Wf^1*-y+}5g-PF0@
ziXISi8GjQxMh#c7!8oI6$@QD2aPB(F>ga255`gn@+#NC`TcAy{s`wPvHBLUmpeG1z
zA}292jJMv*Z7yTsPMvw@fkmek8Y(!=DB_0rDts>`LZr4T_A;Iay2d_}qMV+IN$ZDq
zaE|*6GJd>jHr`7*XxZ_<txp2p+>VF*>=l+8$8o+Rt+feqI0&IdT4Tj}#pvk@zA-%;
zkL(vDNPGTe#Fz!{VNPg%G?ojC?7`taI8c9L<Wus~A_5IZMHc%hGG^2E+<P5>X&(|A
zLN%souyF42=q2&WRgwOTde%jlsSMJg*eBSBCF~(7?8Bv68&)XPIn)6`!S6{|s_|A6
zfbBe%SS{6N^<KMmsrIeo%@z3uS!Amg1&N0Im?Lc-c=gI!cV&SL!**waa46e2JrSeO
z;hTLJkai0dW&qd|vhR7r2VBoD0uQ3dz;2maCCdCGXEz8;65Xi%%1vuedr6Cg-pwjY
zY&(t4^BrF5*22PyPcm?Lgc?|a9VMN{iGA`V6Ug$Ne}g5)7NUc=BCdrF!hf4U`Yjr}
zZ{`il2I*)Y907Bgt|21uMwDwwvoNwh5!~4NGCB)q!oR7Cl@^PXX@5PZtZUiw`%g0Y
zX-;366L~oqUz3Kbca3=d4PrYEa7|;L<_~Ld6^B2(SqN{HoV9=6nMf!=oy6A*H{tv&
zoM9QMm~0*IKsplBbMf471?N^la=3hAm2CuQa?wYy&ecu?3MXedalP`@SyD5J7R0ag
ze2pgx=g6p8q~7(Ua6GrBPv_~7zSfP?f3Y8?1%GqD`pkhWVQz3(C3VYHd?4*Wd8P2E
z&M!^bshtxLoqRk`TA&)XpCla#lrC3Lw4DSyc=;>MQui+%Jbrd1T50}6+;fNB2Y;;M
zn}1&T{azzGk2{W5z5?P^S_w~RpVjg$a^l}GR*tm5ZY1@%68DT}iJQ(zD@S8I1Na-c
zBm_$W<8jY<WM-EL#aOZ?GF$o!>@?B_gfb{0jJWOQ<TM&8Bp39a=kcu_qVX2A#?8h>
zCH`m;93kOk7c;uzxrc^;Ps01U!4Z?a?hnUQ*~CuBzf%>@?F)7dpI2;x1u?S=%|ZT^
z-&rRnb8S{ndU~xBQGP&ovJ0pGQ`ne(aNPeRX~4qxf68Tq|My-(ijt09AOo7uv)V&F
z$$^j^f4<iS6RU<{1LStgkiLFwxjvA~`!h8-8CTKT1f|VP*K@YAcLNDuMl60&0=r_M
z`78{21RvB0(noxfK%s_Ya=co*gZAk{&QS9KlbqFij)t|JQB=uL%Fv*p!L2@{n>HQ#
z)<%paTZ2&v#&gj1W4<SMdeT!4+_FuNw?GYK@wmjJq7qro^FNP6x7@A>m0-qMCBuVN
z(TZvlHG6?=kKEd*%E*c9o|2JjZ)Iu$i@DU!=rS|w5KuO$U7^gZRNOSxRC+v2)}n(t
zn^TEQfGXhda;_<wJ?pPEd!9>I%@r^G)Lwi|gH5I}BU;HoJYCoEpcMq_JyUP9P7{>;
z@#Ml@_-n(tZRPZKo&&IUg)W&DrC9`Hfj=>G1W`Vm=GlOu0a^&lmYIW1sLFS^?UOSr
zCqneS?mP{hn&h6o03xThJ)!KhI9o?)KfDmqaCOu$?m0@94(0%I@vEdKV~0!5mJ*sd
z)GzL+hvEt#yf2h1x(rMFmJZBT>`tOeSYA1fw?U(x*rGYaD2?aB|M1Eg|7TT!k&uyv
zk?p@HgqR4~7+9J9`{`#k`@e4q*%^KyYX8eFQ;Zv=O47zW+k9}ok|>vAfH1PezpiI0
zypm8P!ekPX1e8d^F3D@v3aYLki3BP_3FML>G)gKddJsK@pRZ)|TkrfGuq?Hm;bHnT
zxjoakf-{}v7W0CBnc&L6N&+&0hyf%CoZ{lb+DAwTMM47v0u9W;8MCLZwz}gBR7MFG
z6F`it^c|oeHbAJ}DGwev1nQCimA?$CMyQSjg^>gjB^@9jK!hZ5XGe%a3$7C2-g_C)
z4kAEH0ul;rPerV_ZT`0i6{BZ*Cr-eY0uhOZlG67?jZ0w;J~ULA2r8cr>>SK#pbjeJ
zFGx(h0tejrXB^5Vlbkw@l$65k!h$l;ekig)A>NVu6%g;9I(a@39H_8Y??nJ6G3X<q
z?H~RkXdsS&VLAKBYk%Z<;B#of0e|-}YFrp${ToU|q$dUzq#mwW31!IgxIiM`AQxZI
zE1+*{1SA@uFSR!QHO!FRaJ?}k3bfPEK*G*FDDiyIO>~GwwFTr}PlIb9BB*y*!a?+)
z!4qK~LVLAvJp7v~7bpeUIUuM$`4=-jI5c>114a<6zvn~IftV&Y8`Y72)Wq7``jFJ&
zb_@B@Ij|vyt~*+H^9Ec533-wE{In44gS!TXu$~YV0?DBMzJsQhjuXIbgTJ)SAculS
z29gYhkctE_xDigmo{_lM``5F>JW)e++aH+S+zS#Z3P65fG4THdh5H7*=@a157od3q
zo}4-12mNjW(r1{(M;HRR)Q`0X+ud2ZwM`$e!}0qv|BE>b5?n@r1=arYaXtn!!{9~I
zzx2LyqbE*d?ks;<n@G8nm++0Qq9o)A?DG;5;{PF3NJxl9@*5a!g#YEUaasrJL!RI}
zp(?^&0E9kL=OJpRyvOV5MHu9YA7&5ut1%rPMP3Ih{(VQL6)Yk!|AqeMJL9@X>C2C$
zr~Iym>9dDh$!quQje7bM=jMBm$ktx%njebCg+Tw7X;yT9$p6Kz{MSXRtBb+Y4W#Wi
z-qN7ZjiZ7H$3Ep0A_g*0#K+SBqoqB4`lk*D#@Ry_ThAvMW}s6DvA$aZ*2@rj&<sex
z7j>xGuSIab82y{g54=GAo5X=Hu2EQ=P|PL%cLh;_geS~1R1|bjp;_~Ab|AkOcWJbL
zpu-c3_{Wb?TLOZ>U?@@Y!24!Tpj?D={!u{~s30(0x|=31HocI(?*amXD^X;0xZmpV
zZ$L4_t@lx6FMzKWKWGAo`#?e9BvgrV=RZy^_7esrzZ=QF$K&C~0P6*9NZ$$ptiM{c
zToz3k`zW}rq~6=sjWN}y*4uvOaX%T%t_EUf9O1ocT1WZ#JJvIaJ9IV&U%yIjMe;yX
zwNR5|z~m>Dl2?l(=eEGyG>XdC$Br)XI$}5|eZDKNKGOe<iK-Qn)uPWAuB_{7B$f!z
z{I+;IN+N0*tDSKdbxzx>+myGh7nGh$MXvDt)!JmD83zQNi>?CO_36XBs8fxn7@&zC
z2k3SRHmp!Bc~@5vp;Jqr=IMH3Ze2BE4jLYj%K`kbF5icE<i`z~w_6tOo=TTwuZmqA
z$TvvB%x^F^k*QfNL**#pbJBXSE%<X#hvgP$sngv3882nRtU7b4-v`eM(J=}yd0DqP
z8*c6cTq{e5?ByAr@wUL$8t0GbeO<Ea40&*cptHU!WeRiwM@2LHYd20%p6dg9nY@iN
zcuclr#zYCni-t66EX2PyarNbBX}p&}a{;!FvVX3eu8;b?-uXBZ8q2tAYNWK4uh134
zu`<m!g{GqI#QKsBX#ebHX_|YgHZe^v*f{L8_FK(Km94;Q{8J0HazOoTzX^DAU{Qh@
z&AqoSqGjR;70l<{2dq6PslDK9Q5t0P3P$K|M;&YlytVR<Vt^R<i%aT1+>%{6CozDQ
zLkcYIOXTi!(b;gV|LppDZ^{Z(u)UjpMQl4(`2?axW*42^tthbn6hWoe$&;tvQGPo%
z!InH5LV5{GG1w|L@d1}2=l5N=xEfI-nEUkrUPC@8)=EKl!FD8e8?DM1=hro_^czQl
zjPUisY5BPJ4>9wCT<Qg@YZL(I$*IGsc<S+5il!9&euOs;f^NkwYs>I^T;i{GUe2p0
za6?yYXI<!A+zGTC)$V2k=DO`&^s<)*TPaa%+0U?9jx`r|_q*<0b820)s{YCQkzg$8
zio`~*YmKai<_{verACf%$Q99pi{~2LMv(Tez_jE})fDt#7a|^TlZ9Ng7(9`Dn*{#b
zT>kWnI6E#`bwGR)G>!m!V-?i2vyU0P!QaN&VM|m{<?`}9(!tl#LGr9VaBLDt5B%p+
zGpZ15-rNx=#F63l!>#(*7U|KKSRC`;K?-oe;j0u0bT+ezvy<5maCkwjFJh(TBXo+s
zj8#<_XW~SSDsm0FB1p}iV~^b4v*nyE`mIcWt!w*fhKr~N%tP)1b=}e(Ak$*Ssdg!v
zgGn<Kg{6+Rj5Ta_SwvHi%X7PBNQsRoo+);^;%u~(_D1ImK{uRAya{e*qNy;PZr?SY
z_CN@?C2;qmUVZEBMlFQ>Z6op)kk~mMTkQGLeVBx>E-ybMdYtaPSrz*GEsgh+14e{2
zv6W9wxhx%a1nNrXG19Nv{LT~{I;5O{Fd1fXi{SycKE7)Zi;RCr9>{S!C*`uQtG{}%
ztsMyAKOb1@Cdq}&oRg?KyYOc1a%tNZ^_uLxZ)$9H<@n-VE!&nku8j!pvI@+GR}0Yy
zqiIo>o4}Da$>Pj)jZ9AU^Pl-%*WIV+Iq2a!xJ<rS%3o96dt12K-23)c>vBw8NFvIZ
zR03B=?I(HG-XUUSFiHWVoEkgrCXD47k&T~H)sn7Gqk(ao?$P?X7DLP??1vvP=HZQt
z*U*-4p`T_1<etcF5}Bhv^hqkw9dvz&j;EFOa5h5wcQ4{)SQs0ZJL7U{djpHqGl7yT
zGEu<l7_`>))i!!zf|kkp?4v3UkiOd0NmkzQDDoPJF2?#WJLt$ZIB-&{VpB2hDVZ=$
ze4+oDzqKN0!F#_F+#39(57YCaxOZ>ZiGs51u+(oxTb!n=ngJ;5a32AI*$bzxDFq^G
z3fzXj^bJmQ9Yb#zIbZVwUhVy3nXSUYUJc_bj?V{OQ1a_sWLs0-d)%EaItloNz92KO
zq*1mi$J;1DO^Zr;L0eigH&MhWUSx-5cwld)Mw*iR4@_@&5Bd7_>K)$#VCEa5lti5;
zlaE>1X8qZ(p_Ak>UW_TcgSz-Eb>^QSsY@@MOm-&gb6bbC18wD4SnCEQR-Sb=+?Xt`
zCLIbi=ZsfT$uS9$xFy%qE0fvW)OV)qT(P0Qc<L(2PUzlfc#+gC?3aRh)qk0^J^=*Z
z{wQY%ptMYvnD*g;yT36XQe2fw_=Xcf$RfS6)|9N7w(=Y@J(dUYWvp#-_m?DYCPIqm
zuLZqeVfF<(*22tnQQL`0$DVEbkswy@=dHAvd49KTVItq-MhVUa37UCwE;*!~`JZJS
zZ(VXZ)I5gCdmhLtQ9m=M`L`R?jtpbd_=L|fUr*AdOUlo@%FBfRzLf!xFo~r5jIKoD
zsT-tpcaBF}!DKH{pGcWXDf!uf0Lo#}k&;Q0ukhwNn;5G@rS~Z;;Tc{j%4H=E-}(e6
zCwz$FQZ{iEE>G1SC4`0lgr?oQuhXrO*6*KmQP~x*ba<ZJ*;VMiE{WC6htqVOyCbn5
zW;w~M;9D#)H{d1Q)ju<K2ngNL{BvLqLa<N;W~m^+W$`eh#l<p#cCq*uGUCpm<;z1|
zCgtp>t6MiCJ8wGX_if5TtTkN<AQuP<1Go7@pf+Mj*q--2o8BikBClX8u^4g;I}lJE
zaH9Ol?BF?<x7V6clE}a5VQDB_=cLBhUEBH{n(O#lnQ-;x^|Jh4rR+GiQtlOs*soSw
z{eg7+x$C`A&8%f2Y)Bhv<TdHWePSA<dFcJEZ+!4;;q9l_-83ca-z6BCN+#~(Bz4lo
zcNGWsU>ka6)dcyfi2(=wg@CFelIW(S8@}Y-ZUD+RO>qAVrqsFVJ#6S4CW4PkO&}sx
z&s@N<&3k=0{%J0GqO`#9WP;B<mnw-n)k<%5co|K<i6-W8D!(6nN^(%Dngs<r^?>(U
zrbNb7NJ-7QtXKuNLWo^#-8xF+0A5yC0VY1O8mO8hE9u?Phs?d(M|e<atemr;sA$J*
zqo>{bZ(8ZhZKuNX;t0fy^!*V@dChUN_(rAUHaOL9qEghwYHQ8QU_&{slNk*J&)89P
zW%0t}xVzVE-Ronu`Jw4?yup%4`{|wFwl4(C0O%JnBhBCGW~=3=5}jd75<y$$fMc>x
zs495*r_YBR2OO-FGgjh@B_Y)Ee`&4bQ80>e@mqx|UAkOUb{l95zt0JBUC+_$yO~Kq
z&qREt9RJ;FqATsmd9Z|!R^?`nW`@oT@(|#AV8pbobFQJFKAfrp@rnZ^2V06PZ=>_d
zADZ?iwws&t69qP_l2g>3IiZh+`zgc==AB^hg!)GR&M3u5J$Us-v>|E(pG|TW3GYH0
z5>iLo5E2@&udx?#CUivVlDKuJdwq5&JyP;FOHWLcX6K@%^$%?&rL9{Z*(x@|II)38
z`qlWF_w4X2%L%)N4IqhKvDF$1s$eYO2i+08=zj4A1}=J&Dc-8|%ObP4J#$8_cB{(2
zEjzaJgPuwVNm5&OoA5t+5*Iai&Ncgsbh)*q#C06|lmx7&^+YH(Q%@5_Kd-OTwQ@;A
zD<N$Y{?$XpvG+Aq8XWsUR#?9}l<8WyFgj4_miieT*|I=Jj<(U{cbRQ9qT=*J(q{yv
zVVd(2%vii|B6yo9t@7UBHM-VuZg37>Q}*7m0)#yd?f~D&TJ3}aCJx{)4SAc82<MvZ
ziE=7b_r-y2E=Dhl&&~ewR835ik4O(3{MjApzGnqY8rVCntu!$-NzXVl3b+Eb1S;`{
z<C+LdC(xGIjJ9Ar_w2_o!IDz-_o37`GHM7&WoZ*r%16!>Kx2<HY{DP(pV}WTVrYDR
zv_3vA0y-@dZy^gK@c3zwlVlui!CUGd1t7z3!v$$?Z35mDzmCX)z68yOKg;c=(WNb&
zhnZ=wYq$6Ot-%?8$*JKR;U-$%!}4jigA3^Nj#70mg&7+JRoxE)<5l7qxN0f7B~NU*
zakUA_Pg$_D-ZOg*FNDw4(UhI*@q0Rboem;}Ha$wHTZ?V%2#opt!l$nrb#$-ean5Nv
zTN6q8HO5Ef>^&0lU@@zZXNb>@{#=}L#dH8^DdkAj{+YpX-rJDy{KMa=Z5+7nG|_OC
zu68J_oC}ENh;0-Hovm}q2gWRtP`RKUx(=2bGKUi#t+LlbscDTcqf?}n4LYloJJ7be
zTL}{Ke{F(2nrs<clZHuDWM7C+h2e@oI#8h&rWwMN($*T%lj+2RB%3ezs3ex5CW;tM
z8+Oez-4IEm#$NaBMv<~i@wye=n9%v#XulT&-;&-;<HUQFa~-}0Ic=}-m48ub*(oII
zl-QdZ{|M4vsz8;Nr7B#D*23oEX5V6}-M+tTbR9<C=WA=KasI)7=8TCRW{;&6ouj8M
z_i$)IUaA-{O@_SiTOvKPu^3|;L#84x|Lsk*^1QX2lU&+Gt3&!7i7g^98Uo>}?UK(5
z)nFawIePuJtEL3cBvFfgns>br`#F229NO@3!7<JZ0!?EC8z2fU#h_FJ=$f3z7CIuT
zt31-#u&gR@W|=SpbAv^6wd)_fD`S7D-yI<U&j9l}xHJ|@LN$}qkpolnK9*b&PmIqH
z_Gs#>xAO{5?M9O-cTy7157peZeq#Ce6^|{=CzjoP?2ip@%@nomog2RZCl&j_Qi9~j
zT(a$_5#oK(68w-7Cf{N;<Hj&p-L{OA(hxholQ+BqF+EODW8>SalNwuJFJ&$Ge(()!
zNdgdoGW1h&zN(I(<VRI=^WIE$eF)WvypxawBpO}c#cj(%#L8?#)W38c@R73|ZBG$8
zx~f+^toJtiD>m8&pm=?QJ~GE!uJ0pp3if4#xVLpP48!XFvUuD4l={#&8j31rs)SxN
z8v*H(&fNywqo!&wV-dNv+L_&Pf)KzqpT|9y_&hyDXNlk|hP0e?$I>o)wX@1K3#^|t
zw9T6I>@F3Y7E^8DsNm|Fr|5@3V3Rk!>)3pizWzJ3DxIY<dcCX)F&I2G!`Z?(OsVjH
zhMt8i+m<B@4WNS+ad=@*Z2y8f#<T<75DN0qn!JuZ$>=^i)*YFOvHtt&-s!nn5q30%
z_mKcx@>@Z&4%=8N|4+hjd-Tk$nW<g)A4d$#m89|%T$>VRUC!)J%_-*y2}S<24j#1o
z;eyB{uVXOQVx}4g>F_9$7y@+3g03UIUk0sB)ZWTZ0cWv&o=Q}|o=YR6onxF#)cgi+
zKZ=jX6Ock<A1yvVA`EMc%02hBc#F0r%;RQXW{wffu>*egR^2|2$JL~y++h?gQ=J-{
z%{dUaP;NMD)Lxlv3IQ5zPCXfptuLEN6yVP>U-uQ!IF5E9LtJFmpIF<^7hBvuW2V<k
zn$2d8RO0~68O+RWmM^Zq@8(i*g${8s2nxZw$Q1f(epUxuW$;kCApWj6ApQA$gXZB;
zC?%6-N<2Kc5+ArLrc=|1tEs|1>*z#Yq9H+ea|g|b-p++*2SX8E@6E!z?T&f!x1?FE
zpA$68#st~+#OrHDPfLnbNHu#tnVm$>RtZ^9pg3_$bDOX}FB3;Ld)oB$NHU!;KCEX-
ztH%+a-TlVILr!<3YLi{AF6{f8zzuyy9K8I)M4Yoi*VTZr*@U4<b|f#oK6ScV&aL59
zPD*Wa%YCOiEb}Y7eu@h9xO1>v*D(@w-mpOS8cH=x+Y*zu^SvBvu%axZw#7^az8&$F
zQ)#QJCNH$n;P2?7s`GpgBQks-d|e(coVZ-u+yVnH>NL`$h52cvz)KsNDslC2OBUgi
z-BB^|0E1F$0l+iLz;_b$eB~)VSz2qqYSY?@6N2-J2GWgWmEHX2xFZRL19e3d(w15q
z3NBr1t81{75uu4Bd7h{)<AbI7aXwD5E26g)9Raorq`gXX!W;xyO&3cthL5LVhz=+!
z`(oy3YUZrsKMULMv_eQ5+6$W~!fgd!&XaMRTi>e;y2&j%T+#DZ=P7ITUHVDHDg`P&
z_qqp+aBAMHdG4>S0p*K{^@o&iZNaY%x=SHbTO^9gYWx^$)vgn{<VrbrC4lHN>Dpkb
zH+UwV`eOBmmeNk*a}(69+y3A~6YKX6R7Rf$2D6e1Qs`Ht*WDRvDiV4lsC^9@{A<rD
z64@3VS7z#lwj6y-a8CK#$HRi<CY^km^I&1Z?s)u3YG2?QYokTlJw8$JT2;FcHN8{*
z7+w?-Qg|Y3c|n+~5kv8GicX3|x2G3~Q;(tZR+dnkp9KxBzk2bpKK)Ax52RTa=&nVT
zFQ*tsD6!+J0xxtX751sGwnK}Ux~!vg(Hc5FH1PKZ`Io{@Kd7!*eFg*<M%<`FUp;n%
z`8Q?AkK3eOn3Pf{af@<wxP%eMU;v6O4gpKipDH!JO;G$9^lbaad-FCAv12`D+VLW`
zZcU5oXanN4|2%ZK3G8oRMwKw~M04w?S|-mdLlKgQ&^fsmFIx>7m=NTjzp1B+0v|=T
zdvSI<k?!cq^chbLAVo9j{YX{9B01b!m($a^o^hso;xaQC&a*X6(kWHEJO9Y!T>q5E
zYL%Rqyp1<Pt%-lpujuF3zraF&hZ#7uE{I`zu4^ahN&nHSGpoDuUHVt-GOw_hFmji?
z!FjxC8<M8GjEOVl4at=WRd@=~#%8U$+&wg!&i4N>b`DXR0By1^8(*o*wrzEF*|u%l
zRb94i+qP}nwyo*An0w}&`4_Xzlk3cUGa{bwL{5DEE1H0iUHec!QqBlrU2>n|B(s7e
z&p${g9Pkcfs<XJ7f-GOgC&hDia$e~97}r?Rx_g@^li<fw>XQ8PHJ=z)b&vK}bpM*+
zAQI%=0JGx{3@VJ~76ZFR7%SUC3%oJr7adXV&Cp)b?o-<P$bsO4$Z+R8uqd>(GgpRf
zZhD44%BZ$hociobA8@M@eVID!4x4?si?rm%478!a%*+hKwf=BXl}yawtRnUXSD2Q9
z$qP}3#{7Z5Wb_Q|xzpuQK5;)(6TPX9G6#~6?c0=?ti--J-<NLm;Dzvm5!t;X&%{Bn
zOC~Y7;^=9xUn6UqSY3sr_CI{G`QbaXANq{P6tD0O%r=(Vqq8{uUNEBr6w{=6mzi>j
znU<K*#n#2BKJeK!p)GfwNaPA<N3$y39rm&P1lm0UZbD45*BJ^jysL%!hQ;#|D!_YI
z-_nl#M{ge~<|@Xt3<9F->0*<g9zT>MoQY&b4IOd{oIigdtLArbLws2I!}@p+tI`5(
zTl*}g-LucE{n;Hv`If##HbB5hWR_|jw78L;)-3#|e5*;^Fc0+B#)-T}*`ns;ROvN>
zu~XOTt9b1gM33TH?a9MC#$+LRbuSA=`T!xiHnoB9W^%07HY|ljLGHGA$x*RXF&Zs^
zdgbvGrD<BdtawG~9sB~P<%4L<rd%uuAS90xXm=0LDGp$uF+TSo&3=B`uAdX<O*VD6
zmL2e<L1P16N3KVH+5euW`I}GCLp|3&LG=5Qa6CN#vo>MPQ_HZ(5CF5j&s(|jo&M=x
zBOri4*2^E{#rLbjrFc?pT1-6izL31PDaWG1bZ|arF7}2iM3kIKxQM}foY5)!a+3Sj
zjMx^wAJ6BgAsi2+Yq*28RX2Kq+La3~ou?7%km~#x#*$wb_vegG4sXeKbe-*^n&DDp
zMQ+ce#xlMv<u=>?`GNW)lgovJOo5wtQ>_Y4f$F+zjylly7QVIQMjLqRg<O6mDUHB5
zP0M!A8DFGgfQRnl?bXUb=1x<H{^+*k?ucy;iU3WmSTZwFzg!-_4WwFEdwVqA?!x}}
z??Y$wf?#E|;7Z)W*m}#*RpLmJw534361A7k*D_#3NjoGb5BIakMDS#!qgQAF@joBa
z%}&g0`w*a*1g&26!e^Ra4Y$`bS$uge*GHLkU#y}+v_Sk?O5@JWoiG|CX=6k=TlNka
z>!2qwH18Z1QiBsXRe|@_LqU?5+!9EQOm>+LTP+<SWvyD6jy_dIs}sm&aQZ$&bM+)#
zWri|R5+I3j$pf$!4KdEXZfR0{#ZAyt5e@q}?trVQ8Ct%?IE%8=A%AxpobN(}-a<pZ
zJzRH%;7he!IWhBBBfP|4o);*Gq7iVUIYaF@ua#3*@|dx19t4n2_LAu1U9Z(&MXn*q
z|H7VN%iJn_;9d<PadErvYaXDOdZLBZKT!JFH9@VdF<K3$Zq=p7N&VJgr`2~8;%s!c
z4j=umKyfaoPtZY@9s}%akq288;$v^$kn0o~I{!)H``-z%e-a-D>;G5sm<ZT8SQ-CY
z*ZZFmAIHD-|Et88<!Y*ypt(@}xE&WQ6ideI1Xf5ac7qE7O#(nBfbK#^I>QA+HJ>jG
zV1X4AHCF&Dd?8alv$MOo+4{Kj?tVDwx+k`*N^3J+=5^$k?RQt5k^7Al*%(qvh-3zg
zB%qJ!hcqaK2o@61%TSo?m&dewEQcXBIac=9skikHz)UbQ0~-ed82h)JSY!w&7%8Y-
zC-k@LrgR_@9DK;=Cp`p8C?rg<(CBAS)g>@+o~?}1@6!w*K{$|Hh&ss7P!J&@qro8~
zA%CFU+S*rNoH#rtAW*<2l3wWWDlq}xVCJ|OJ3eA63Mwt=t0naAKeNx#(ZRvbhmeql
z2A1B<13v6;@V|dK34yeJfaLt${_Kji?5H07^vv4801kc%B7F~kfnoe10AfMCM}!l_
zzyXn4USeLEm5017y}$rnBxIi^;P{Pbh#0~N)ToC50E6lG6wHDI`aU_vhe8ko!+6d>
zP9*q^1P%l&X9Iv-g$Ekk0N#Jz=tZ;(aBJ<C>q!Ial>;J21c1N;|A2x=f%O6q?BHHq
z!`S(JS;nV8-48B24BPyd1oLMpAQ4lsvFsGXvcuQ$n|@HhVE+76LxOkMgA?G|=J)<E
z!}_kx5@3LU{}$|=>v3HFK>>mjZ0i%?1Ki%A+Thjh7=tiSVDz8el)nPw0mx$^F%Sg4
z;tqBqzo#H~ZHIw!GvpuNKq23__ix(u%uxR|O^Z#w@elq?yDhx#C{_nQ+Wq~U6VuPF
zrSO9c7wH&-g8riGziSZ(98rY&<p#Og4ojl}tBACJiwGe_K<#J^0((1hl4JZ;J7rId
zi@^pX009!j`PsA#n8jnT^((raQi}iz^!5GLP~VZF!wB>H_`IqHbqM+gv{h!ET2g-d
zrtRqIOiYa32I2=sf`;}3l2d>qAc8{$7K;c20r?IqbzS(&PmTP|tp>Um3MTfW&Vh08
zoU_mSgG%6cf(U&7Z%bi-(9SLF?wjXpmCb1T+~ics=nqw?@9Izdk}q|U@AwJ(^N+4T
zkK*?Z(fdu%gKor85Avulb@-10)Q?Ra76ihN;isF;F~V(5AE+5HoVM*UkZ~;bd9iQ1
z-L15vmrZpkgk!(kZ@C{txKT8Sm$x0i?<;edw}&(<KPPa)Z|lY10XB5`p>}_NSUVXK
zu_m!WmILx|bAdzwpU2U@nb^d=07MQr;I^|Nd=?-up}?RYW9Gm8I9h-nag?70Faf`x
zBn7lRKd>LNNdWvGKU<FPi`|wr;DbH;fo=Tywy>|6?-(0Ff^7ig{+NB?z`q)Z^xNeG
zDq$0P|0LjC4E2@12I4;p#>yfytY31*YYT#NpQpCr_@b%>vL|INenTs^+LNb&+E&M(
z%mv1$WEUEDI9DmJUm>MO)6H@k7`x{Oi1;*@LP&b#?OP%Ncs0a9HJy*2*B{h|YuM-Y
zT2W{twz(Z(oA4Wd3s*tw=D^?-6!HsK_ij)dc9bcUseN$0YwQu7a~WzACd-@c)7RDz
zQFSlVsg6ee(i$<@+Qhf<@{MmN&Zya@=y_PNgT0QoZB~!lW%r_ZEMnpH8^*j_QIvcS
zbiH!}_<0x2nEDzrM|PF6i!{{vD(#xqj60tyYs8}y5tq}}Q?RXgB(8^y3PhkWx!=px
zAmyky_edI}OU|b+5V4*3JOjMJy={9N9SufSX{<udo*n&-4X#T|;_27JI#Vm;f$>V-
z5$S%x2P&sv1j)Kc<G91nS|7MWRyFbtL=<SH{XzBrFp^~P&+1J0Wn&0tfL{109~Gd{
z($U9D@2agFQf4}?I(*5&6V)VWhenEzqkOR5km|zjJyU^PgHxvxt8GCs;3GfnI~}I{
z&)-O7fZu=idjNd2rBXHu(RL+!V?Pp4`~8}F*8PW0ymQd(YCl|X0&D3dEe3w;5DC5b
z(rXPF1OJd6gk634`fh~UkZud#SSVv#EG9e>UYab{ts_gsE?x7D%r!UyZj2>0w+}cU
zd$siiEAbuluzGc5)v?T%Rgcp2WA_aEAc8}N{1($KDSCB2RA4GAnn)^QPLJ@8jy+?A
zXQY*%S=(L9B@w@vyC=)E)|BaK>yG?etug_&)4=bmU!Awtz5cQMZ4LU7i0#X86!(oJ
zin$X;R`fdd?|8|t!t59E(X64=3!3BTc3aE0*O<k1^!T0)W%Nb3Z*xmVaI>i{x>Ae*
zB{7)sv<rrC7@gyjW4Itlac)UsTC<AJg||B2Y(CzHvu5{>=g{V@LIqjqt_QUNt6rJh
zsY$a3KJ}hAzvdOijV>5Zn9u4Vo_^vxg7?+sU75da?223Ze)5mb<6r{qucX;0mULsy
z*DxNDW*suW?_@;=z!H)38Yz+a9?w=Ey8$kr4nX#37|Q(ooR^{RN5GsMVVO)~O>ftQ
zo+W=-l!x@LeDYEHIN+;C;c)p{3r@F{$Hab{BBf~75LG8gwixbCu6>!CPLvcYwOSl#
z9SyetqYt?gYl($U5WZ^9A#aPZhiqESKF9${tE=f4gs4qk%#XrP!yXh`q*|+YD<>1%
zjJ5ELEyd{49;4X+hlG3FAB+uWv3M(Nm1!KGTS{^3Om<V;EQs-6<|sjDjwfi1TU|-K
zrD{H+k;2XS?dx<a^z~Rbh*m&=y300$LAG!R`xKR7*X>TY4XKUZE4}H&*<7YOIP61_
z_9o`nK=F}6!4sg|voLM*%TO8|88<N8m`ivLfxPyc3)R$Cr>MJm5X#jWj!mkNNN_=#
z!B&kH8_nGYsy{e|2)<p}m7{N{k?U?zeNetp3C@TKa`F<|jCFXNa_|v!sDh9iL?~G!
z7pw?p@RwerMuxRtd83VC+%X-vS$kf;Eo7@P*=no>922tKH4t-F#*J_YQ<~}s<pAYW
zr?{&``7dlN^Cx@a3v$LsVU<*A(itjVf)5v~QyXiowJc|9h`I@H#XvduAXo6)@{{S-
zPEqs{(bnp;2rm?w#`rZQ1pi5j)9i!=q30Aam~lIi*5X1H<7p0)&<W%Y4B=5!m)FuE
z$kbf(+epHtP`kA&$I(gUDt9@i8*co(O}Ek=A#VLph+Dgbw(s+gYb_q(Y`_$*Pd>XN
zc|O|P@&Me`9A|><31r(!Ya>3^vt}8iYI9Rc#fqv1bG~0n)(x$fMu|GcCPV0rwe%_v
zETRYy(voz~84;VL1A!)2_}ez`@%StmSd*~<Pa+K$o$Toy?p9c7b>`CN>nx*872B~a
z_3fGKLe7ZH@+fEJuypM%I9GjU_fYzysbS4LQyes$53%-mms5pmzF!WYz@I<S>Fn3G
z+k3q>S3=1Z(SvRy{)KdqHyzqvrM^g&cOm&%MHpWX4P(ainom=6rA&4v_|gA#b3jG4
z3apX745#fb(64K&!;YxuQSJG1kyp;>=gB@qcf9UZJfjq$XxcTQ3AB~wy|NK+R_Sy9
zNpIu0p5m{Kf#+lnpOWSE3dkw6S5Ud$K58U51n}Tvb1yr#4H9o>a8aqRBxoO7Eug$M
z=9*_~>CoPgijW()(9gCp49h|=iI=A{UU<l1F}aSsTtMeYY`xw;e-vN@#ya^*e}M*b
z>Ml!J*A}jAV2!KbzN&3iiKEpI-@K4-BRm0lxvwQ}?Bfp3=!W(D3{va2XG{}-ZyXKK
zy5~=p<|)T+7#kzTSgM@j)-dPMc5vkXIE(*awG1%gVb*bpVG31BF-!umgn28IvPt%#
zw@Wt34Gw7bRww1rlTrT}Yv)(&#ebx1W_=!vIDJo*dW1G@Hv;7e?N;E)apz&ld3keG
zx1Z3pxG5;S?ZJflfG^P#n4d5om!(LeH`>?vdy&xLxHu0Emvf@}ckJXE&y{?O4uvtk
z#|_#py^k@~oP<f}X|dVmJ_20FHKW?<z99uKIVoWjAM^YD+t~e;vRZ87gCf{iqbnLt
zPptO+{Kpj{s1!}$mtv5&%3q0pA%tKVZqirZpqfx##XqQSlkuf+b>_DuUz?)Bpfb4?
zOfX9>1X5Nwr5gpV+vrQtb)UR?xioo7q--YVTr$WARcxwOs;s1{&{54=6s=r*No{62
zEu`5Hr$wxRFTt!&U)#L90}gF7QaYYE8RkKxQWQM4ywb|~RKa;L;N9d-BV^|mg=f>a
z5~+@GKX$3upS(}?C^?M2ZF=_DVqf9CJfXbqCO$@Z#yFtjG=GnL;-_JZ?2&CXr&8(+
zY&Ey@*n8Vm%!pR<cG<;6L%%rhVaFBWvzGtq{<|9@v4fF=yxkPmn@lW_He<VV(`FFY
zap~K{nt%QESn=Ukwju&Ko~V3AgSSF`Fs9YIWkKq4N4MR;oSh!0?VAxpn*?F9z)FLI
zPLAO_AL+==VYNp5sC`-Pw0Iwu54pTOni4VY;3b>#&Yoc<mKwJ*Fkrk}$|ut@<jpfy
z9MNK1(4$@<C}fe<p+x+sxYtHVmb8|y`+{Oq7opIKWAoBHHFn$1{YK;)igqsCU8s(5
zNV1wX%2jKm_b$N^KP8Y`epqhAScb2f&PxH}B?Y=Z3Xc?_?u6e>TK$bCpyGB?O*zL3
zN0GajkSR;(@WHjPDl)lO*QaAx@L8>#;{%U@e>zmj@Q(TucvB}F7i9a3=)q!gSCsB<
z5b3*xV>hY2@~9xE2m$%Q%T|dO{m4AzR8(vl?>m12-{b-!44H>+&{{EPH)yE#)n8{y
z4lBW04y|qhc69Td!?Pv957d<AWpP>z<R^V8o^V&y!x~yEQ(?hf|D#O-0B#tamUpJ?
z^_(ElI79E>+r_JAMyw2w*^XU%%<^f@%=cJxhE8zb-Nl{HTGO|w^t(b0PL9&Z<!svt
z0Ib}p#v9tXhPlxf$3qneRGzFZ;|O9fn`s+9EB;F{b=o|<oYs16tePI<-#>ziSo?@D
z7i3g+Q_ANsR`MROub`D8h&i2faDQ?soBm93e4J}D%eEsI*aJ-~y9~@-euyM|CHsBx
z`aT%hT1AgyIz?&K%q`|I<`P99(K;$aIOSAqIg4}M68Q+qb!BtBwSIBhP7|yxljmp?
zZ{h<&cnRf`uTg<XaX&v#mxt{c%`0id6`}ht(a-%K(=5qDi<#22n)@Hmg3T}Vr0JLC
z_I2p4UYh8UW6O^qLl9&Iqv_+bZd>7}aXi4&14s}HJZ5mQ_KanrA@b2JtkuKpR<uk)
ztI_SS=hUjLn@zqVvot5G!+MbtvbZg3u*ktT>9DXLwp0eAg1Q&b`ICEN;`SdK2!9##
z2O93t6Gw0Izh6E*Y#li_gVEFt&&of_dCO@PnO$~a3_MfF;~SzJwJOm_I!XV+hUdCF
zPy3RqcA}7UaH_pC5y(J|*<L&nF#O(-qiEqt$|=0ecy!edR<#b(dTwP-Vljm-dnvOk
z;z%N|9C%tcc*<Sh)S`;r`pX*M$X6-Xz)%f49u4d8U{`D?HBQ@cw$Is~a|5`lw0Z$0
zTKesLj$HE~!5WXfN!68XZdRxGt|!4I!qBpWoCg*rk=DGibj1d{!(YUkxgJY2u7B(^
zwY(o)Pf2$?^JP+ovpj%?g&F;kEgF(wm|EYci_T?oHR$v}9qBmxuP#PHD{`~xpwW$u
zY*ZtCy`Gu)>F6UUPjVe48)^<3zki(Zl0i0L#db}pS;D(bfh|T?@Qf-<f#Z5^&}|KF
zmBGFK<6QU<iV$AIa_}tWs)+|A48@Y<eaO|uUqVYXH<Cz|(Q`^ajR=36HBLI*JWy_q
zxd(Z88(%Se`p~y=2)GcCmkGEdPt5Qh{RH&HhN<c@S;&o-u@y$+)tLC*8f8Cv3HY!d
zGd8VcStJ~wx^qNRx{S%45L4f1{PO<elw7v<QM?@#&ldnk9sp5Q{-ip^!R7fzOeBKW
z#<Wy`vT9H?o&BPkAE~&?$@?ck>dp7eGAnVz(txiVF)pkL0n(_WMs};1SC{5gaFcht
zC$|{;7gU6IN8Xs{)%~XDLfk7(0Xsm=d2&xQ&CwbG>23LGuT<>{Me+%qf7FGS69Jjl
zZP*oz^{PT^{*7+6#KBbNi*I?!!JTf&<v=w65DUruV<S3Gd-X1KF(+VyS4L-<Y5j&k
zJ>zK*rpVz>->m1dWiy9BroXkbjagAxOt<npKdD>ko@3;h9Iq<6gnQZzF(Qhf$(%?L
zI6ZH)8IS#I*1c$*<rMSTVbhn)85$K}_i^FgcSrWsMv<G`8l|u#{xhk%N{el7qAOF+
za9|t@oP}@C50~Q|IFevutqpFR{x(0zX8$$E>NE)PDdb@hF9q^x{q%j1*Pe2|b2i)v
zQpd^BaimEOU280HldwOqPOmOiU=;4HJ`EGITax+$&VyqvZ8w}&d=}~v%yly!)$it1
zs8<9w@eebh9VN6-_#ONfp}RQ~D&@5khVYeGGUUa9j^U#gmnHfpWhIktOF=JtFcF`*
z&ie6Alao##Vjo?uv-ODV!CINgdOUU?1E>)UZwNwyAy64jJ$moFd!GB_dsckffVkYA
zFN$Oc8W>{1e81$b8nAO+JgIqj?c?EOd#b~*Sa>Qaqmg#ucGc_l=T?1HYjnWv)4(Wi
z(P#{Wgs`nRvV7A8riD*fx<~1HA-#3;8_676zSo!ll@sL!h>1Se;BElgchN7!?Q?>g
z7+qlvv*~R<GUq1qY_gsR8+;s|DUX=&#`@sPljvS&JDuH~)3>FZRw|N>j>yC{xSQ!}
z4=ZGeHJft74j(p{I(ka0wr7hm$g35@n&Dmq%|TA3^PA0KBgntMmV@d9lPYr8f{8f#
zX$ex=3Y+$DupCQG(bN{a+vhWoTC8O$8;Yk!T#55`vbZ;sqzb?^QS>UVp0IV{4e~`p
zAf`*L!7VSyhRtlcvk-{ep~e`*PWwY*R~Dufu<OC~{Fj)VJeT;jm6U~=ORKYJPR0oS
zWQi?ASp9M2=#L`Jt1%Pz@PXuQ^mDjaPne0|W8IW+zvu?_Wrwgd%@GC43#wAF+KJk&
zph>4HOFoGQM0|`#P9f$*aQ}M<=49Rl43GbqmzsdErkX%XA1}*lY$$FLUlhFMcq`%7
zqzpz!BAdkiQ<!ao=CY6>!OMq+D8)t=?b*AHm5ReMV!+o}ur6P@_JNje*A9;f;=g<4
z@$#0$I@$NPL;yg@jmAE*c=I`=;~d>FSOMnaG|S_gsqYO~QUJu6-M&(GActlWUvCAR
z(k73q=)M7)_%2HOFP#X~d6e=Rzn=Hc{+qZwpV^yak&}0@fjOb>9_bd^P{<{FU@s7R
z?UjatDXU4yj=g${a9jbM^xd+vqI-|YX%+i9Yv`u})alagOc&Ff^MOBwizEG0Cqs;B
zewICklC0w;=QT!(;1t}<um~IMtcaSF<G+8ZI@c7VT4%Z*I<fcM(_=~;mPuhF-(Rb~
zy|4ROsE)sHc*oHEBy<W;?djQ8jx5>Mh#gu?#GSc_sSYTZM5>WDI3rLqhw4d^Db8?7
z^F7$%J81`ER*v0UXwo)K7w}ItLHQzz8V;#1JV$bgf9>$S$BUOt>**8-k{zA)EwXHs
z8;79P2;G<{f|Oe@#&PZQ|0WRJIwEd&P${lB*#OW4mq*#y?l?jiU=w+3=;92cnNk=r
ztnUP@Nf=ZC8`zQ77lWxnv@-&)B?%r4wz)p<M?Y+LRS0FU;L0CCCHRSerg;>dPpMWD
z2bW%dSdtu4tFB_cWP2zcl=F0)ND(3TAMuOr;%-HYCMo9p{d!nw$OfH>>$SWq?&dN{
zzX0VaOW8pHGtN024JIEf#q?SKXQAXZ*V9UH>i15}UPRjSFQ0!&CDtBBOMWHIlJbb1
z+jX1>=6ACpqNT2F#-R-^c+}`WySNq}pBV7dCZoAN;md;1E*}gHC(WdJ8#=(zH6nUE
zsAm?gOK_nSV@$2ecJ62Ez?Rm`{dN0Csym3eoeH@oJTLNuKoF#4;AedgM4em;l#p#H
zm!E_%i9Vi>4@*w5a29quv!6QDKuc(>9|SwCyUi>$@8X&f$$Om<ZYz~_*;V@J*OlSe
zrbS=eIonz09uWuZZ3X)CGP6hp>7?uIq7qgO@^9EMqfaRmDSHde%2>+r@4os7vcLq_
zZXQV9K0^+QX^(Xcz=H~EVs+4tiDKhV?~#pML6VG*hf)+`*redygHcf#l<oz0JQxY|
zZHg<+O0$v0kj;&&!z3aw%`w?RMJcjY0iAe3aOX6GhX4;=W%na1s{0JKk98)L{CpD}
z92p$&?KY*}5fNQ}`^JbVj@vVsN~fi+^<-d5Ss|pExwPtvWM~yBF``A~d<J5#Wy-vk
z6zB5LpwqQM){}PD3e4D)A~AQ9TzMc_%z;Nj=bm-P1arwFuQL`Cd<j0Z$<Vp8P=uNj
z&vD5dGB}A`k%!FgWXLe>b42f>_8+|ECxRZ$jw!;5j`-1DwKZ~5%V?bl#jKrqye_tu
ziCdjHi0D?n$&%?0faBX+GPb7kYXhb6?cXc1P4atBrG&yvWuP6+()SE^-w*~ycXiK+
znmnKBDi-X!ey2>T)cq~O?g&WJT5$@<6vg@9SXw%V2Vz_XE-C~GaXLV#N}~j#YIz3e
z48(%9g)1-1d)4ou?BxEb>pISSJ{hOv*|5>K#sYnYLUNBFr4u50tMr~tUtM5vQ!W1R
zQLQA=Z=I$7QWhF(ak>r`T`qk#uk%r})OS-R($_F6W0xIU1Wk(*!n~(8IByJsrq-?~
z>Wke&OR+YT42p+qS1X_L;nQdsMQ>0jd69pRY0bv`*I*VcM$I&?PyX57Mp((0r&kLq
zT{#rabzgZdW3w0NIa<o=$ms&1i5Um>0}^q+$voF*y-B!L;d*K4APtY|+B0zfRhWJc
zhWP23iJR`Y?R7Hzbwi#lTIuy(MaXqjD+2H$!mY>8u)6JPG`AiW<4L4|MpP}W$RD)+
z@J2}^ms1937L%7Jz^o-P-oVuz{K6JSpCqH2&d9`@3hsp?8E-z5nKI>G(i<&jstmBt
zQNCur_GTDLns}9CGW;Aka~o3X!bA_FRxgQ^?6h#Wi7O#MY{3mO`vGa0cA2wT@TBWb
z2kHM-IZ$!q=X2IXKP|~OrLX>62(Q2HGKwi*Q}}~BFK0*Q&lKyzTh3lH{A}~g%XrwV
zKFJ~LWIp?n-0gb9^=Dy%HPPMn-)W?oFzCH47rMJDIgumtd7mXrBsVH<cr*>vqx(nx
z2L(sQ{y55z=;wwczTE?B?qaE`@$fm%wn?M)6KkDdr0jvqF)o=5TnQ|_s2R?FY?n6Y
z+dr#Ko!$sHhK2YSUIg!#q!+FZec2>Z548C;D;?v~=4Ub}c0%ryO{QoG(bMemgNH^v
zCj^I}Y_^0q`q)E<mjdnFXgrCMj1>&#b2tlo`-lHr(v|ge)`e)!lMFppZ$@z@B#!KJ
zp-FKrM%ey_9|kP3fsU(1>7vkxMS;ty0xx*VQW*Jy(yzHDF4WlXSkl6^@#wWfX3BuI
zFHzbz)+KqSy&3+IGSUX8kpj=O^zKK_mf|vkn0gMQZcdBfBlYA=zGuf&dnDK4>LU%Z
z^9r&FxB7dD`QS-#uS_A-BY<%U+7ZT;k$ydQ7qXuZqogJ)ChDf)vS-QLuBMmFmaEso
z;1Z%h?wFj{XPS95+<U=Vf@Xh5kYzOOdizE~DjLtpcC~X}+DR&|Bvoqp406-2^o%Yz
z9dddIQ_!pQ^+Xfi7_44mp%@-03W9C6sE(eWqB_Ib5Ha_i(bn9;&Y;<7*TKG+Y!Gt8
z)c7#gW|OBR=1nhgCywNZo1?N51Tio0qTY@lA(<MUEv-d&aiRv;1)cdxN1u7GZ!;o<
zhsuFDWSL~a2x6jcZR@4)qJwoW_3Z+ew8_LbnnfR`L<Zgd_E!!S8PvO_XSTTJd;((t
zXA54Wc#gD}Dx5>LVSlC_<)}^lwnSUPdG;Vn`#N|8cgXe>UOeBNh*#xqMw<R&fwn#Y
zBl=|Pgc%D78h`1-)KA?NRnG=XOoNMpMK|DF{%EpO&ZRTx0XNG%TA6wusQF3HhH2yS
z)OBUZA#4V>0pv3wrcj*lHhysE<qg&Bve<bTyetHMAdm4;H~XV@e6QNtw08UM<rI;D
zD4!5NEZlDQ*Fx<`A8m^XE+wIae$?&sKu}h!X=Oahj1k(MS?QA^f@!12I9*=$DDo=H
zJ=hwlOlM9__fgl&ZqYzlFydlpdWls9@_HfLuFQcA@ye$~JFE3f<n1g9GHFofB^@u%
zn1Hhxn}_0JTx4u29Ey_M_>-X-?T(UxtJ86EQm^ZveUYiqQRp$&mNmxB+`f+ZR?h3=
z`d00w#j+N^3dOnm>cE$WF#YsU{h7MomeTu5`3$qbwCT*TZtBcVwfvD;*F)DPo53M9
zMDEoK^;4XL^ks0Uo7cL0L%;W1GX9uwGjpa=bBP;?IK;Y^j?7Do8R&|eBRqwna9N;}
zk?y{l!jiid4{lGn3DrW~P7S{iXB)A~ih|l6J3r$qgruZ&*KvYo7qpdnk1F6Pde0f_
z<0Mr%A^g5i#o-JNEfg6vD`|?4pke@D(#5ZruFXddA7l34i@zhP>XCxsU@=qQN7g-E
zZW`l=O=Me<-saAFWz`{wW1jb%Zwxdj2z~KtPnn3dr6o3FG2yy{1@CA<DNswct4S2H
zxDf_%i&ZkJ0_@?A!ZqOnwnxj9L)$m&J;^=vz0xSkqkHSAKF2hBI%279{bkB938v0a
z;Vx}TRL~mZ(Pb5kG-78u;16wvX=;%uKQfyS!kwsL82bgup_Y+QKN&%^w5K+kbwc=u
z_#)JfsDuCy;4jGzCnEn-7Gw)25&65!+Kay{n1=zVZp7o2oGpd)y_WqwB;JKlv-HC!
zRuzGw#;nTXd*fO4yU$D$d#Cgw#s%lZ_v4tpiti>h56!-E4A#0m_81DtqMZh*iPN-e
za)l&sSAa|ooa_syGOWdb%Nt=)^6TqBXhHYi1gfkt)1hw_XV3ist7<Qy!So7HaN(9s
zA}1XZHLDt7pDBs-k;cO8cj||uK0|yuSv(#ecYY_Iu7)?}gh6rP6EpYSMLnQAQZ=^k
zh|8MGR0d3+5xnC-L<+7*(Nz6oB1UD6Hd<)jkTRz*-}a*bdKaGpW@3?&;*%Y_HYaJ{
zac{VYGBv6v2Nh^}8(p`ByJ{7j1b6k3iPqYiC7i~WqP>BM;#<V5_Nl}>HyVOVd<E9X
z!J3q0nD*0X@bF0eyv=P7#EHk{p)q-;xTW&Mqb!7FkIFQWt@@UrA_cSo1Rhhmwp3o3
z+8na0vy9wTniih4nnY`7MqDJRLSkqFj8wE#2FgUBQWUZ0o7Ij^(Z3{yu18zd<pPq*
zGey4KQ<sFDPFUm*uq!Ev&2ToJ!k3$l&k4glxI0Cr{P1^wI>_va-z<f=DX>RGP=P~u
zWog!)`_(ham(lu=4(Szmm`eZ&L=a&vX#g8u1)x7KY6?VV!ZInbM2D;|{*eiaBL=+}
z8g$18W-oZeUz+DA;)+#rcwv8Vy)o~&3#zX9-lv$x18fOi_#6oP5wuF8y0NntTRy<m
zZYiSppxE$C@*KdUYba^#9M4NGn~Yu}n`zQ|RQ?{<Nh&1t?mn5!VC@angTl|vprIl&
zNwA0<Lw6g>7mkAzL@v2hu$DepV7M~rIyzJYJa`%6M<?(C3W~C8@|PDt6yOFchk4Po
zu#;`&>2;^6L-ll8C2W+P>0OqM=3^Igy)8F8Sdj(}))ZL|8XhIJLfKC33r}>6L%yJ|
zBtRX~dxKi4R2k1$nK&EI3k=78fMd8Tvj3A6=6@5T{+|_w{ePt0nV49Z|C1Gl`CsM2
z|Je$o<j$k?fo;=P?{rZNU|%9M9K$fgWTd!|A}J=6RAM%nj!dvOxz1$HvuRc`5=V`%
zni^78he5MOx2_Jiv(`2q)1a(R{G7I{sMxv6;d>a#eDL0RanHGV_{X^~o6U5lS@W`u
z?GKU1<pqg@YxTQkA&VI?67+(^<xU(6P?LcI?==we#>ANpo<V-|XE>)phH?Xp76(A-
zk{J0zVeaZ->`;urXcHtt#`oa5f(JnjhK%KKtHTPAg=eiY$X8CQgMp&XV$U)IJwA?-
z2-f@a<;s%8^O4>M8Tm~g+5?#?9l{6v!OUdU1yBUG@=;*EenOeq6m^)JTORaeo~EUy
z0&V-}5c$D}{?@{f%K_H|y@qi2@_*fb_07`<gS%T`F?k{bnkInC<=dr!Ll^`Fwj@sv
z$s$IZE#$HRFC|ExJOpNmV<!XM1*-dv0o=qu7zAW{Z2Su(0<nRxjsyz0RtSj959;@?
zKwv*$8aV=lU0`5}#{fWGJWwEz79om=z%vbMBI0j`h<}<Qr2*%HAqv!+S~dQ!K0R|U
zFk!VnVtybPDCzLV=^s`Ad@`!zfZu9Vy(fCgm%eNVj&R0*7(jCMfT*s|c(MK92|@6f
z0Y(v;P=T?jWCVW*Qa^&w@Bn|cieslh<IeDOso#YWcOwjdP&6ld&2hS0_hIRwgn#3O
z5CnXPy4j0b-R>`y+y-gcdBh5N=L6@S1>}R&S68QkiQ*6u;DEs8w`;7nuk~A5cIRLq
z#mx~LpzG(Y9<>5!3aEn}pi%w&@OmLQnQt=EN&zrHJYlOE7r;VyHxCOgR*q|4spzky
zTXAQQAnl1$bk7-CO+9-<Gh-?$pFnyw(c4@^xrTnUd0}<XdIqJCml;u#0}zY@5wAtd
z2*<a;37GFzak~p>E;Flu+05p=Ukun|aWMu|py|3ayFuc?oRA+2AF`TL;l6AuFIX1M
zVS}qX&vC6sJynli&u=ypUMbSuD_A?`AvK~>NOx`vlBHqR__yX?K#+PSKS1Po*w~T;
zE}SrfXwU+OKR~HI0Q%b=g6?T2P}A-)r&#KJ#vt7gQ!I^st;&>WXnz(*7(!GEAfp9>
z#3N9<RG!Q5g%eGEHi|<5hR`Sj4e;NhF=C%o$NQjlUix(=g=qk&hMsc^*oIfDI-O|>
z6ca;aUp_#HI#C_~#de)l?W*MEOg}&mXf)p3Vz)tRz!fbxCF)4C`gY~4e2!g9>FM~k
zHc_*rYW^Bsv%hj`cn2#p?0w??IN`eV?z!meeNB<H`x-`Q2iNz<gDAXm)~QVD@4=S;
z&(oa3LzvH?K;cf;*>IFK9BAs4vYWC*&jr7gd`T0|&xD++w*~!@RM%twse6uUJk}6s
zApXhHppZBf7B==L2Yu%zQ`6^PWq;$XgbNpoQS6BHzQCl!?K_kt#7FU&igd?2$2?PV
zmB%MqWGgJ0E6tou$Boky=}6JvxYZBMRr?<tQ?+~bw{p_9h3jjX@AoNxo3j_1X&RWM
zp@)Z5;yVj9s{`xhi?<d~Ya9~%+DrQTV<KYtHiXBlQ#jX~*b<-*$VFts=+b_&oqEFy
z42aJaE<Ij|3RbHHIbDVM$O)7N47llL%eBEzP*ip-TqWXYt+$Yv^Cf#kb<?}{#P0kU
z1tZ8a;t%aDWs3W=QRuH`VrY}IrI<BMj+~B`cLS}wjI4a5oJ$Uq58L|M18w}v<X<xb
zsFUBT=+9kCM`?Xr5B_N6U(WsN4AjSZ^2&%%uQ-WsPz<87CL6~ba+>JAxVm>0S}V7x
zpC(tScAC)qoTF3uSj?YpmTJp9!p5)<8Cg8WWdBxb+kWyG@(yP&`Hs6W8#_2pEFXh<
z8{R)3jn>6aq{35d{Z)5U12TTgYpaPrv##|=>N>Ly^h{qrBQ=Gx7`6c?3e)~?YyxZx
zgS%Z3z#E_BjzN&@2WaOfSmJXdyO%b}vR-6=>GJDIS%h82>DN}v)Fl2qpm~OoNjT81
z0lE@?2w|It!@)dDIL?^V+Wm%N+v6pi)l%%u8IOsQ#Q|q}NMnXAZ^eytTMpG}uItET
zeSu6}v@d7}Xo!F$yPkK5@rH#pVc*z@pafGPcmDZ+88^6OgA&^u#komi4Hw$)>fD=J
zQai*RH_f{O;acFZFtOjk%%l(2UJwhc^iQ%=S%sH+RA*9`{iO&lwXc?gXP=(G(7kld
z-5~kBEHAmN@FHM`p7iD%i<`U2>f+hv7xx?F$VmMe2M@8diLFYpdDD65%3Y3xTu$ck
z7yA>!A$<zvnq%>y)lKkFxc$W>;op14u=tN)m97J2iIEUsT29aNeLB}GP}StjsWa?y
z?w88fqrKMrW{;=of*Px*tMc?jmAmHnZI!DTufsSC4=A1D-;EsV+Q&tUcO{+=R8&+o
z0z8)5*oE`gx*xT4uU3{(7W4K)hrbsxG^@?Ex01aLN6l8S6x@5vOfTMD^r!9-3a~4f
zh*A4-tgTzVch&SOE4JIGI&7N;kIgC`r^4K?scqGb7(bidSB}D;d7m-lu2d8_Zs%Qr
z*Bn-^XOlNXG=N<jsIUymhDh8Hr5=*S!U${b%RDx!**f`2>SVioZt8HROt*S=oMX(A
z#5(Y}IssC(HCLY-R#kW5>&c6J<%dV0SygwuElH|(tX!3XlNoCHCn;R6{05mCK@y21
z$5piPG`#Vp@{$u93_CA^(xt<F-g8PkGOXl+^>{VuaXq(xixQMn8z#8XVnTegD|L|U
ztJjiR{q4QHw(}dyRQ&Z7&%Jl<;E8v=eFW3OF0yi3W}D*2C2^<c%suZ$V$3t9YPv*x
zu|f?isb7@vaT0kQVUZhSIvJxM=)R!mvMP%!o6OW(@3QwZ*wLzesS@I!l7q+Jz3q|+
zOKKvMb=vrNKCgat@)#<dBtG4}Mp@>gPc~H8_h6)-m{@j`l7`vY`?9pWZ2ykys{Yzz
zdS~8_?(dkUaw$)?+ru9@)iK|2G@O#<<Mh8#G5vJ}+_|E$WU2En!kkn~9RSFONuJml
z=R!8D(>W(Q8rt8@F`mB36HN@!7-tLqMExmv5@{MzX%BzUj_2V%9(FSpm{)&buLii4
z(lcw%&I$>O#97Oq)6JvTaC)T8v(fqF@%%d6&cVoMEU&#DYJ!Uj+ZJt6=zWYS3Gk^J
zcb5r<jmo(Gyl%<$JprFjY-p#mpKNFE5&wXu^3d9vvZH_=@6NVG8hBp(bCU@zh@$$D
zPe?qS`1OJ<ibhhHBb0f=UFgP9QC7jLS+zv-$j%JvSnqQ)^4_l}aah34N$j~<I{k=q
z_79o`FEROA;qB61b$*}FEX%Jn&ANVgyj6(DbEgGJ1yERWBx5s`=$q}cE<WTj%l|o#
zM{9Ak=#|ULv~sO1rlAU(vE65GR;7~A4qNFiSX?;a65_V?myktbpMIe=bGtq}a*fA6
zON)l3cG26CF6|hhp<=eO+C3q9Oz5-BX;ez5dD-!;`lF4&f4jlvO}me_GKg!@fu<q1
zhWmWjB_5DW*bYwuT=eEoIY77+R<|=?A(0VlTBy{uqIYkx+5e2o_Eu2ifwggIYq_fo
zapTAuW{O8mj+(!j`fE%L9$xlOKih*0sj&74zvX$s4Q8rb;zqwN`?{@LZW?MwS<q2R
zoOW1F<@?4<NEXZf#ZneAo*|4dXrq-x-rPvm%s5@(Y`rHDI(=Nh5_5GYL9!3WidUM2
z;{J44)X*53=#FyRt?1#BO@OO|i8kf??zGs31owNNS^_mRI1<+RRylq9p6kV7_6H>E
zd&W^CDKq&co*8);BBDx%FB@%jCuPJ00v=sf$CBy3`W5n;qcOXLXk#^tF7B(g&-oPD
zTh>IBLw@0a&8WDTy@&FF5WMqW1@^F&51iPQH_u9Ht7FKv7@DV=`);8q1IyQDotV>q
zXNyu+f(H_>`UdV+b<4%-!hBB`I<it$@*8|m#XG_pS_ePR-*1JM>RCDKj)jE7PZQGb
zcz5aRg388v)ObZap;J0sw~P^sl92_>V^U9g>`TF>np6!jmNC32PmEnsR=kp|(oCGx
z?})Qw!6>B}_P(&0>K<&OZ1rCiA5@?Ay?NKdHw(&D#NtuOngu)378C!PKU4f{Wo@~f
z7qf+6cpE$RMzQ8Aa+W;aZ=$Kvitj9_=bt1i@Flz9x8qu9=vhb|Zu%e{J@&Jt4<J9V
zvt`t>b*t~kM|`U%jNcZLhPZX{z7Aaaet?SpPLBMCv4`n@_aOWmd)OE_{(I12B4A}^
z|BsL_HfF~Ea{?eL*_9{5dSm2j39CsN3AGAWvufQ_)LIyf5}8CKvYEnS2CGSQZoNg_
z^H-CFt%Z_xxy7Q#LdT5a^@sP58~+>e8{WsO_KLet|8Ql&46!9>OE5*Bz8D?>{ST-g
z&ft>74ovWD;J_}AhaEXJhF^}ZUrJ6+PH2?$Hkv_DV81?$ir6S9(C9XNZtyc~D5#$S
zBA5_96buO1>s!#Qe+<hOK*i-0gJ8XP1`!D6=bZ=y1ei^Z0a*{eE}%d3)yG*mXssXk
zcixT*Hv7rX`zB#EloNSx*N;;V;_sJc{{b9%AnZ_Dq?}(k(BOhVFNb^66so0JyvTNl
zUO%dy0)DJ81dzf+v8Q0<Hhxrald!SQPGF~B;eUW037|qNxCet@cF>YGad4X|GiO<S
z&4FG?L3UGMeyFF%q0d9#e}u}3s&Ml3)KjyF!Fqo-z=SCTcnR6K<VaTW{G6NvKH0E)
ztq7{4<uHUGqy4@WFnU1`(ce=LjS#`PdkLVxehYoJOaSgZ9cf!D5|R#j)&=$0ezI|@
zUUnQG%quV`uuAQ|@DV?5ehXt@*nkGD0fPk!1F2M3t56U<G7BXz^kPH#<wM?s{pOj&
zzP;<;6?1~=U4uV^tqtlx{_+SUA_C%T(=Fa1f!R&yAz}o|=|>9#eMS9=r2zDncnP2K
zOi}+iG1o@olKnsog9dqhtPz9ig={C%2g>O~%d^D#CbVZ!{~{y=W+99Ps8aOrQGsnO
zzas*J&t_F>SM>r!Luv2R)nECKcWn1_jCO4sK*8Q(-0b`KpM6PlS3q==gz<6sGAu*s
zAlrgZ-K~Fe8QP0!7r(~oKPTW_9lMhK5b8RD&9W|Qnni2$VjP-7daH$Vt!FJmlPC7D
z@{8;{gHPA8ssW+dUmBE;V<!Q+tb!x``YSHL`615T4h4=`Ra%6#zNKVfpD|B4>Ckz)
zY^II3x70;}vk_d}?S$1!qBkDW&;%ZJ)HMw2VSXMuMFlTH92$g|HKe&2T1}`TvVR+0
zgS1evc^T(HeQ1HT2d>WB@;}<XxQ3w^HlNnlK~7m_EJLd!-m!n&ZJaA}8AzaxK2LtV
zImiB(?4ns}<mr;h`ceAfduxAtIDda@eOQ0{ZbCRX*va~_$1wPb{+0tH=%)t(paUMh
zObJ$}&}g~tZ(y;!OFmPq^G-G4LGA+m!itCY^uo|(;}zoLj9D=8-%+I?y-C2q&B4Hu
zXEG26l`$=>Hwtu{^=IlcT`@7s)NI^U`7^p#Or`DE*Buzk<$!V{%Pryt!zyZS7&i=K
zt`;^aFt$UhEi{uvs~w*p491Iul1kfJyh`o=;=^}8H>sJ8YOzCXG1?4PrKRArt?(zL
z2VXT24)H$li7z}^S8T2C$o-=jvjzzlI<|(-3TPTexk#FF;!H%W0O#Gc2nYW`K?rHr
zioPk847_=2t}3IJs+)%IRC}bogXHz@(D&cH+w_dBqB!q55hp1xIe`boKaMx_p1M%u
zL?R)gvKmD4l<3xd1s%P#i)Fdkt^GF+C?avFS{77X;8^!H&8WP3y!f!uazY?Pla9-^
zK2_Tz&UrXO90QY^=7hQLpAu4(6KZ(u5*6$TUtUM|v3dP8xuQk?rrUAd5BEPFYCiU}
z5C5_$O83UXj2zDzxgi>B*-$)2$nuTlTXSqexn-8i{eHj902CLe#nXvu#yTW4?nDhg
zW}_5jOb%R(Q_6Gnj|$~swL<9B2YC{u`PTBvHJfdsbP&2!BDWOEXIWeMPd)ykJZN!o
z9MW%+J<8$lEM$}VIPSZwHlOaw>;=ZwYmCo0+Tu%2D`hL}Ti|f&GY<96pgG{D`M8b-
zGBYt!`6+6WHdGmWH&2W^Ubgf{`Qd?qNC|<bc>Z-5U**O}>TM_AGj(p=+*Wc4x$7vK
z2SysuW~g5$5DZVr;D*<<#z2f7!L`gr-^-?HI29t>qV1+PAibca;W5$sT*i))<=g~k
zGo8pzD&wcE$OD;jQp&kX-MtWJpojl@N9OJacWb=_UXLY)b3k(6$QIPMpUhSRVPeUy
zx7%L@r(bY3*^ZM1ilPQXdis`FEp+?qC=S?o^aKUcj3Uj%cMO`f`aG3xFW_I8B*QTS
z-w|f#@+m?XL7aTEo_R`%Moo4|uVfnm^SwKQ`hCyx_EUUmln>a#f1E&;k{{2|=)s*$
zKQqN3J2owuj%nXNEn7-tQ$5-_FkWh}uv^t@6;!^wJ-%i&oZl=5Bleg3FL=$G_C%4X
zW*EMnJy~kb!>S}Sb?r>3n6}tLrERw!#$8<TAjKRT)3&G*e7pS?)n}9r-z$bY<w$#c
z_%RUtPoa)P8nrnB$&%u3N&=>Zw7|c1NC9k+OGzw$zQzpsWhlPnGhU!ly(P4#gZNen
z>7?VxFMDxxXmZSu|Mg(ysh!0e#fPU&As}O~xvTri$mhQE-G<^2Pn&y<Z=js&CL9$8
zE5=KI80E=NL|7#j7_9#uB9oq0B&RJEpXk}WZ{jdd4`0`UUjzBDf5HP%GVi0*O(|Z6
zOim;?QnMXP=6_1ECb+boSp>dYn`0M$(y*rqSAgKXcG3%FppUJmyH3c5O<zJQwAykh
zxKyR{eL*&6@e0cjT9d$Q%xGD37-r^Gwuy{)UU=)|>7krbaLU8Gd*mRtfuyF?DppbM
zFUkA+NGO`|fGD8FcEj5&Y6BB<v;MY?F9k5xw0RRt=;zqvJ)k2Adw?mN8PHkw?sMqQ
zZjEzJ6E3uDU}-v@z&6PPqpFX_z>LLf<1Y9UTj5+vLL9-{Zk+s5XKesp{j&5zi20l_
zUI3>BBqQQbB`FpoGTgCIYmzAZTFCil-52y9Fnu)3JI}G`%egj~r|&jVFE5d3)YF@s
zj9*EQETrg<J-G&vPK@#^(m?F&eTmB?7$b~48WToL$9pbPZP{utsh2CBqg#82;CVp$
z4DY^~Kn?o^hXUpd4;WRLnaY|IY%9KcXRhm7xQCE~Ot3b)t}}bnKRR1PG%3Jx#!CSd
zva``CMr{a7aQ#r<go`ktx_y~RdFOiOwhG&#2)wOwgB_e=>WoP=N8wAV(C0{kZv5ae
zUgIux$mF*QtS5ZYHF4vb)>>P&oM3ztSKixOz3g9rX7P0sgD+b|(;W#d@_PFF7~9)*
zNhd)~Bj=hE_3tk(WfOJ1Rf#XB8oSHOEhx`14?7ZcI%2b1@I#0?MI}E27}u36dDOWq
zM_$DBjJzqKtc8Z)$)QhhlD5gOrM4aJ+L)rhCY%S>ck3=6^o%5CY28_a&ic&%dXg?R
zfwdi5)|OIVrv9u4Q1LNh#K(B<vHJi~Vl<ufcXT@$q;zdC4E^lA+V?f?x<I|^=vVEg
zwq$Rjj4Nz@4Ae|1xtC<6bLs3*sP1+Kx;tggV#J+Jk=V#AyExlk2%@FJL5*@m-F>wP
z^C7ikijH~t$2@$8c9`<wRx>;t%A7*Pi~!zfk9HYrZWjwm=q)6@WG%(QZ!VCa1L04}
zkc@@mw;wz3!#Ql%rnvddPpNzbWZmA|ELz9)Ggzum3YDIE+4Fnq1+L=`l!$L;zOS=r
z?C0tyJ)dYV9JSfu1roe-=(FqmtdDfPlWOFbXhOP46lFui6^rYWpdc1kh&EaTXxn0J
z(_b2hk>aA8V`MUg5xa^@Xb;^2%Xvu)ZBN`A!LhhLGjAJhxVl{*!><G%BSXqBx4=U*
zOwLNkwrU!O5xSkraOxH2Li$VRRXWw2lpu4;l+bvIp1v!}$n%*>37V+<%P}zfK0(=i
zLw*^oo3*(7ezfb;{C24j{7T2nzMc5imm;WsLV#;IS(26F>7WD)X%<10rG6q%nO#tb
z2LqYf5)STOCjN1aON!+vqbbj+7WAm{;wD|X58)a5D<vF`JRhXLS5cs^l6JM=L22DT
zav*)x$2=B35=YB!syYT8Hf)^K<aax{Kf-T-kSGGW&la`sG?EujWwDL@(a$=}Lgq;9
zc6o!Rh|`FS6*WrEd@pp2!=_d0m4WM%5bH<l$Y`}aEE%)VFY%7~LMQ83a>lrG$M`;j
z`+({@Ijp4uwx+iA`Jz0GERlol(HvjrX(W3`14<92auF~b9>mo$%{QH)SpSw&WGc#+
zW*mu&Otm||_<{Ti1nmL=@L(@LE}G;zLMcdRA=>G2Cy^#h@t8Y1mEIDy%QsfpDm$*}
z02IW<x|?kEiR=)HL#mUO0Tx$bVW&1=?_d-Gc?t7R7P$-XdhR+s+<rB{)g)sH&*J~Z
z*g5u!0(47y+qP}nwr$(CZ5wCXwr$(C&bF<4W+rduez?iZmrnWzbh5fu)l<12H#ZE6
zcXo*y7^FzAyo6||&jT|L^kvuL12ERy7^F&y%-#H_Npw)ka-g>ee&qlgp^DAqGjvp=
z+|Ax|CXMx|sbFAOQC`it@II7jFxgiq9(G!2Ne}sFzDL4bI%eDV*hWRnavnE0AsmqM
z3|?M<J6a~6;VuQ~qT-ZBa+B>!IT?tIkNGJ};irlD&yTwHaT^B_dX4e$I2}t`636V}
zrJZ@$t|+2;;?fD)wJ{E1{OFm#i3oY#XbnDoYP^CVAkJm&z*`MEmC?KVai_$Agt@AD
zN`GtQ*DYT+Jj-AY%tDuF_%+3|!&>`HGR_}Xw=1)7(a0ZGKYwQ8IBT49ain8J&BLbT
zh>19%w#r_HEhu?e9=PqKyWITZs0Rm+DT%-jo$I#$2##0N@g10kKH0qOQ-2^Wu%`+d
zLi3!qA2Bt^H69llO5XMMkbza39zqJ0?FVg;1AaGwG7?I&+*!SD$ta2k!|KXlqAy{|
zR8%Ln-7`PE{$r$rEEr1f1FagPcCL?Ycc#R~jY4JPlTxqod~0g#eRNNu>UQKiZ|mc~
zRSD9;zIIcW2olkIE(V-p^7<rDGwGYZ#Lei%A+rDadDVo<StXtdVZj|$Ic1|=Bet>a
z(Z)Eh^aO_qsTJ{bWl6Ysrkg0<@9wZ~!nW{15<pjiBi>xyQ%uDr5^B{9Co)?U`IxEi
zWT68``IL9Mpu8?@a-;&z72?4!zxw!eM(ZaAo@aH739CCdXRc^rFFYa*BuAp#`)Z-H
zjB!`kT#_5pn;!L|vp&|tGAP?`z>7!Zm5k{ishpE%&3S}1kG;f6X1%gMHdh%$yEI|%
zdA^%%Oqf57n86B8qhD7u?gO+G+f#IFlOL5{s9i~(=(%)zE}S1^pX4f{O?fQ$a5txb
ztbFiq+dO<-AS}~5$SH%8RZna2yMjeSUZzvG@LvdS82N@TMr4KYL3i?z5nSDYb_ms(
zE4v`8U6mB$HR)l`wGQ!<(`0m`+Y@8++`d2P^d>xbPEq%Lu4<Ce2Ida!IF3V>{iS&&
z;IEBnC@uW1VHrw(*YK(irFj8rB0Y>#Ik+#Dhl$SwN*4#)6jIF%r;GYH{Dk5^y56_l
zwY`;LqhG;{p6h>7A5obZaxqW?zgHuSFigCS1F=>GY6-@8><HC7n{%p$8p5IJ+l)bV
zB%fb!RAw{IZJngam<csW`jEVJv`-t`{*C?(ov?ga=whV=^%hhi@rL`V3h^a4Jd-@I
z@l28NZz{SHuK0ZBoD7MC2F^QTQ~<;qY22Vi7hwj-D`y`dyuK3W(cf@;*i3(VL0-Jt
zv6rZPSi%e8cw^ZD(Y&nku?f&XknUKhO6j#~Q;xr5Xge*`^%OqSb@z6Hybb>BCbKc;
zeU8Zb8=R$NE#N;`ad<i}1V+r1b&aEeYd+>)z3gOTP0t%#S76F2)8NEY;Gb{E4a1du
zY*c4_L}I6mh&v^L*~PApDFCz6VU3){-6#!|i;JV#gmjHUaLNFXrb52N;BC^E4a}k+
z(Rjt7ZYV9g96${|gjpY58ip}QOL9-4oJdkyjNc48WpWMbQ-&CuOcWO;cX%K7;+ga5
z!_A_|TtiAmx_4hf!w8NW81r;B74;}54-Gt#z!6>-6~u>4CE_!S5LUxD;^8o*nEra~
zx_#|#vq9ra>`v6`+50&g469i^U{>A|gA>J;ZYaEbSqf5{D&rCYAi{=~q0bDCamOp|
z>{&B+!Op+Vq;yI&e#Q>WHh6q+Mp_VM*E06r-T;ewQ?QuJ)Or8&gJt@5y*Lr@-u7k7
z`~*1qy(!<>*wt*)2&*wv=uG{bYD|^079E>i?l?Q44kk}_ShPrgh>UsWXNCdF?dEge
z+{L?!o~$WrN$`xUY|PngZ1IeSc`7BOP|=1W-z#PJ+zFEdDpJvQfZ|><2;Q~&cho6Y
z<3#Gu{24*_*|`kn%(0OzCRV%$Jda(zNqlaoV?NfJ@KsRwQmC#(d~b+1O0%~l0bUH#
zwV1!Zy1c`9hD3~c0_1*F=Ra=QqMU;dLEHCL4GP)6B;U{%QIM6RM6cig4yqYFUfFag
zY6DNUqW(iVhT85+MHYdygcWo<T)FxNq*+C*N!Zq*Ju66uBLY>E!!Ws{4@@iu?x|l&
z@^mVy?kipwN4|HB!egRk3%T{RXO@ueOz0(c2{y~%n2yk?4*iX#rsz6mso<U!WHFCh
z!6cf|*uOtFlNxhMNsUkgtzuwRo|cbSg;EY%mh6!F+B@G1^nDLHu^m@?E1fUT>3gG<
zf2!BEQ$u|DD?5nwXAk5`GVVi-s%xwE2qLT{^9Ncd3fO`Ajix)Zu>xx}J6f(J49YPR
zOa4&^{g`UPs^y*WA0IhI<G0Q#0UokUGRj%EIGBHJ5eRMtaS6+w>?Jbp6gbZ1SS$@!
zd(I)M-kx^4gnfHPe5Pn8FO-0}{_+FsV3Q{U>Gob!tg(9|P8PZ^FUKj$f98#xp5roC
z$!|3a1zw-CqDDu?0k-s#lg`pJ^Ux_#3*g|tQ{?yGM-W@A9TPKFP<`2n`VLQOYA$H=
zr=MFUwW=n<`KYs_(km~kVO3F#@Ao;A-IzgptuEgmY_X$P>t)Y3oEYIz0;eE2j~CmH
zxK~PzZMBo?=*)EfB~IJaK{fMbgjMWccVk`NZHp}WR)?n~wR@fZoaVIwS@pX4=@-&4
zB1P9Plg8|tVmI?5A*xFf2H1y=j1#=OTY2%MfAw-l(KPt`RIV+t+1(2Vm=;G(3-0dA
zEqrbDux)7a!g;pwwZqIh#3shhs~0Khq)5o6Oi+%Fap=!f3q71b>1H214}$e6t@bmI
zz`s%T+`4WcF`BpK7(e+Cp*X3IJ)`R9?agUs@WsSo#hX`&&nUmev%g^?;D?ZZld7Lp
zXuNtrydfeVIaoL7h@<eg_sUWKExLvfvdC<x-F6Wj9~WrJy`cSiM(@lG7sGE2syaim
z2r|3DStl)xpZ2$wP2DPesMj;AcF|Ppg;yimot|>3@cBdX#1Qb+!i83?-_X3F0MEj}
zB8PypMMqGx)Ig+u7l%ctvd_C<lDo3*YGXAk_R-7SUpU%&C-%d1nne40LT77zmfJ;{
zZr^4l^3t|FIkN~Q=S`$^MXzx!zl=k64*WnQm>-?Qc-8p1s9ZTx5+OYBT+sN8&>C9J
zV%HZ(@1u9y7f44jD{GTe>;_cm-a^i|zRw3t4#y@@UGwb3`kv5!j>YD>qs?Tfo=wv}
zaDXhLL%Imo<tc_xI%3nrxfrg6flHy?&SJ8}G<;$jjK+$1f1XW__472+*-Y*EsorGP
zzM`WCez2Gh+#4i^MgMdE_05%NheFJ#Z~xFFeBNuTulD96LUJ%)`uPTf06j!VZ-!!H
zWOOdgu9qYD@uoYeh3R7^5!&eU{Dssv{+YxxB{N0tni3d?e0rvO2Cv)X!^iWa8+8G3
zbFQ3<;_+y^U-sIj(b-mk>qWNNsb;@$=D?zsnBJqriWa>JGzaSj<y?;1EfWvuo^<|D
z&FTtbkQnwaf`Zsfs*%nZ48G`R`s<T_L=8s#L!po*N?rlITnC78daXNr0`rG7xcQ@T
z(%EsgB)$*NlTC6_%|P)|PMKo^_oQa?@BE$X+jK;Y970Yq)>^t5%E`s%9Nbyb!Olw2
z?Jd$chD&NWcUfdYHMT;b2bBbtnR{E_5R!&=BUeaY;T78KZ9T$nF!HGFM_8c<to~NE
z?r%&a4EG1AVfu&Dbur4$zGFG{!5`~#9tyAbZ=3flSM_XxS$Ve89bXafRSdXz^^l`9
zr15vE2MaU|6&-P;SvS0qh@F?x{p#9(kq^plQS#BpCU;~#`IH<@7cqr|SxgItf#y6*
z^Z215n@1D|3T^aALTlemzRW(<ytiR0x&BtEuB_ZwoPcV!=u*bjdm^M;zdebYGh@}u
zl+osfeqyna&s8)|<twX0()=@f&)43z_bRa{`O}}KusL>F5<exr;3&rM-!F%OZU>Kn
z#c|(`no1s){>vFq67IHKdU{(5W)$?v@vfoyJeT<_HLo$t$L$0TFY6~EIf}F^w+Dcu
z6Ja>=_z|xSCGJkXiO<|<VO^%NJ*HpqQ0Pd2|7kt)4|zmjZ)63<!}Fho$p2c8FtYsT
z#zer(!Os4l+kXcnv9PhT{r|ecYW}&xQm(PcOs3N2#WA=yM*r}3T^U=4FqrAV7>h9*
zr{^Tlno@qIkVer&Hlh=WtX6MGxtS`AWA;Ag+<x^s|8Sjs9({lBp6S(ocHUn4;Sush
zq!yzA9Rd9{p7)T%q^yS;A4P%+EKpzoK{6()h!rFhAZY^1Nl1W03phx`Xr_aKFAvBE
z04j#=7i?@Kz%(^A<swXg8|4Owc5xmH7Lmj-Iy^-3*NPJspab;xkjUgH#>OI%`M3vF
zz_6zWh$R>Nnu}Be02u57CQv7V0yxhQuEqR=86W~XZ6g2%fYm>!KoAiR4Fw6FNpJvw
z1s)No!>EC9@d^wPCrF$yR&!7+p`pcr02A^EwlATCwGR*89j}W-U=MH^I(#7UOF#m5
z92Qz|UyQlWNI-%W_aKOaOt7KLNFLJNfT0wEJ|PYiY~bL5gA@HU8Z4no*!j`-INUXK
zH`d}Pk%S%MNGeLi;E;EeCg($fk%SH}T<A!^vmei2djb@IAd$@ug(grb3-mZjByaJy
zpJ36(k0}vQAAk)LEda=Y0~r?L%ag<Z3G%J|%3yD=(l5z&N^+r(li-09;FMaJoJhJ7
zawOTZlVHJhex%AM(q$yTw7+)^fq%>I(+luoB2YNSO)N$PC~Poa4uAmUP?F3xv@c02
zSooVYspOwG?jJntAKmXC-Tj-_?!WSPkM920JMR~&<~CR;bD%pQnPeW{9%dZG<!k&)
zoM9R|66($Vz&|zwsL%P!o+8Wx!xBNuf;|btfb#BEj6@Fq9G-wcf@d4|7)m&?)WxVx
zkQjglDiTb>Di;Qcgc2C+cf|ZUF2uVqeysMc3tE8qM=FP89@5bgJJ}jd!TJ8zM^XNe
zfaK(U6>yit>i23GCHQUa07Fz8`v@K?DMc{>RB|%VR02J2SX@)?;MBju1Bm4DYy%~1
zjObhNrMOixb8P1K@$=E;o1VeTf&<L4n_A5S14~e=&L1;w#{r)vt@vUhmYnr_?A>Gm
zupd8Q$rop!U$uybsp;k@&+*vx>F;J+%eaDzh&Q^rHa}5Fs_`FTW@CQJbWVH~5$Tnu
zimys|480dV9fr>Kx7JWx(#7n5g=sqNlmx3%2AN2Hu97~CLYoa42R~3Ogcio*CSi+m
zh(4~4tz(0W4S)Ap-1n$CX=X-iH8KL|39qvE<JgTMc#5bpYXUpMuCAKGr>F<r)7{)f
zc3oWEn%V6YTj(4j&&ZabDh4@(7SrBu4uG>8wpQ-+Rrq~TZ+J>syY}a5mWlanE%90~
z>>pBz?9a6{-Y7NbRKA(?J4P3cYY*o)`_%?|JxhK>xw6a6_Y2+=W55XY4z#<E_jz8>
zie6?>XR!J^^O1TN8;tOnMN~M?kn}7eeDJ0Slu!D?^D6T8KWA7-d7pdU`g`mgobGIG
z?0;FYS|XVb3|)d}yqw9vKDOjuHP_6)_6W-IL|mvO0){&Vs|CR~YmEA^4k^%*;_##o
zj0PvYWVLMXTo&fY<rLFHdumZom^G=i4DQ%VDt~Wy0La8<IPhS4o9F5)8h*JH#*P^}
z^jz^l0FnJ-cX*oy(_Emzd^_~MEi|9^y=1|^MfBjUAsJ|Osxdy)-qa!Dq||R}NC~xh
zZ=}0TJO9ymZ?>Yao2Ic&8{Ml_)R}=yQTt;c!+E|?RgDfH?@G=cLYmQD%1??e*o{fW
z?z?K^RDriAS!lf^Z+1V@Jla4YBl`i@nhbyTC$GAoL<5_rbj!PTLVh;aO+>?ycpV`Y
zbj;tg$985kL|q|;T5)QY-I-p?78rJdzN{7Q&h-^pw&6P;ZihvTEl>5BFmYT+=3E}`
zv}*W5_*CiF_ok|!ZD@jukiE+~`cp{L|I*9n%o_ckcXKB*AXR?8L7z~`YsTHoz{3xL
zf!g0Q?ijlk8McqRdOS}!2QE@?RTgq*O8=;Vy<;5>Sg)fD<@x?7QoX#$oWcj*)jGnK
zY{gx@eYf;#l9n2-T7XYz_W8*xE{ju|e&=!?%sWtz2-PbRv&jjt(>*J1EhvklYr@iv
zBbDHta=QlhD_h~t#86Ld+r9q*!LYvCfYzHc2_eB2W}y{lA$8H0zu0OOrsE0H=jrMb
zrh#Y7FUoZ_#ju|7f0jy`RbE>zyMa6D*b;5+Go|-WLVcaoX&GnbMXC73nvuLB&SjRU
zxoaOM$>XRTrF9V8B4On#je6v%9Hoil%YNswoe{}mbguNZ&MgA8z3c9pP%SyW5|0|)
zeo0K`RSU6*4dxD=3dV-ls+Fl{c;Bc?Jc2V^z!R6FI{34q^%dOtb>-={U&aVst9VqA
zr|(Nie`ni28?OJ1!&o=Bpos7j0HsXK{Gw?60I8KQZA1c6D%Hz8Zw|*h*YsNWRLc>v
zQPRrE7IA4_7}!8BZAnC;JVdapb$*k)UOTXs<8Yx#YsvQBrgxI!?c$kCMrj$`u@!ZT
z$3!~e^J?yU4I!uLLoIWn15#DmeOFbsw3C+m#oaCK>jI(wcK$r58$9kw=EuA|ZzF1M
z^RsaIeDQ{9I=)G0g}EFr(NRE6H`=>+X3~xr-ekF(X{_tjpkM#U_vj05-1U`R=NEz;
zqIdDI!PL|eecq9Ko%gv#F;&-|3~e=2^l_15KMg$wN&8lZdm%ti@nHtIww?J@*;--q
zxZX|^TzOcVz4_j(@m(!8C<9ZlU{$ToEi(G0`2`-oWWT1Zv%GG&9;CaH5E^$-JKV4P
zYQ9y7N{w=MSki^v(RkE_uVlA?Y8Kv!zmqwhk=?pMO21g{Q(*s>>&CS5R80WKaFX$!
zKb>Xbp1_2?Qp+Mln9!C#n`U?-XfQ0Zlge_q`)*59#eH12UEF~^&-NR*RZmvCC^9DT
zpir3}O#P^{_{^Ji6bfQbYAxfY6>1VE(jxBDOlOVO%ZrSEvqve@e@?VM&uO=|Hbmn7
z8}7@f=Lu+wv~{9=nmmRL;|0>Eife^Dy(s04iN8c;q#ZvaoZnbVmcVKt#E-($_8_<_
zxnz2~Bv-#YE<b^qx3}%GHKolbNBtw0rdK;LC7FW;ZIu&dx~rCHkasmXMN56e>D}k(
z!y`J?!C2<_aW2U|*<(rdo9LwDIVd_H_*N*sR1F-jqw>wp&U$LKecR6Bkj{D|dJ#*(
zu2s5=HhtiPt<s`WC`*vo2ss_o>7=>cmsGeTd;0Qy^$c&NkPGe=@p~vK@zQ)ZtySn7
z(rHp~lX&m!Xw%;r8a1QK;4Pngd^h+p$*}5c#I{l92yWAI@Vnrj$@f%w&N)h%#cJu8
z?z~ZaB08~ZlqGaaRs7-tm4(f8J?<L`gq*Qk>%#H$lp(D%-EHF|$Z9!321Bq%%G3mX
zN68WLbnFqV$K?lEyeuy?H_iQ8#9q$!FxN{M({&>LOQFNz8CyM8U#Fo|S~aM736HZj
zgEVJA%Mrx@xuQiqG|L%@M<zpEx*lBXF%j%U*dFM~b5G;*RCaA><z(E9`p8dbuzLfk
z;J|i$`3e8;0WZr`SZot|%%1;Sz8#NY-7Da9_$`q~5gsS%0Fdw1CHhzU!KbNJq@ES(
zrW9jf(rD09wYudWm<XU8X1{OrsT>f_?_@kx_?g{<MHriwNZ9P=TIW^Tk2JBEOvckl
zsEXcfpYbmvW#dP`KP`J{XA5I1J(dvf%`4DpzTS|j7JIAD`$)ZU<rDOToN=A>(%-}>
zacsMgi*nZrlRTP8bPw$ErMFK=A0?*Esp;W9&G0p8Rs*N5bI)AxNY=R)0A-<@=-g=C
z>by(L$scW9HJ+UI#dBhi8S=~>qctzvG4)}PT(n5Zz>`v%8zMcnh*h#V!87q%=HqV5
zW;7HjPpdsq{4<?>ZjYG{L|)llk??F5^H)tAzmy-;qKb9)-7mZ?d5M11Sn09|*0B?2
za5x@jdQ{}DM_*1^8=-}4l~qM;F)YBLaB0uU$ydySCV$by)bY-pF(ozUs7ul{#<L_h
zstW{Y`^bRU%8}r0*|rZKHHaT@jss$32Pwl3{t*SCYH?O_<lMcHmjLRI&@k<nT`EbS
z%2Ibw)tE&=rWhg0L{6JiX8pXY@ra!NFoCD4PkNO@Mtk%UQ*NUj{p6lG{uJxp{J`FE
zxrxTD1UUwIb2BntJ~e^60hsupo~5|tziWpXDLTnQ)Ce{hh_+gL4tHS`c?ElF17c-%
z@94IjHO#VT@9mSN%eCz#&mBo_v3TY2YavthkaN2K`C1MD@lKZO?GvA+N`iNwO9>GQ
zO5VWkjygP*MS`%@&`5h$CH%7+fH^dm=_&y?+<#EppMtvbjfhN}=EUu0E#6i>+t!C#
zriJF%>vSO>>x;W#oS|N%jXf)auCbb}X_UhXL&&w1s^H-^j|Kbc4%OV?^yk`r^`F#m
z4%evNxj;gU42_WSw&8?hW(e@fNxC#I!FL4n88{QMAPRTsYHwsLyEz)4O*+=$@B@;4
zSf+4FjZSX;AZvcShk4p7sxko?<=WwNDkB!nqu&G{sBm4mpcZ-DJ2qPjhN7>ALB_<S
z!%j@cG8$hYfX|C=q>;GZ%zp>f(%^9Sm+tu8YLC6UFY~4M9Cs*@#r`RrO?V`A)oN*C
zvUg42Lm-b|jDlBh=j>ob^H3lC;IY3jx`#6OuMg2BMI*5sF{@W+wYI%Ox%Ht`?Axiu
zTijwawI$tJhLEy_3M|A2eZ%RveyTJzv=Au%7-vD++<QssYKZ&$s~!lWj8xNQtL^Fd
z7P(N5sj?~SC2mARx171k3<g^ovokbaeM~o?u`rsd;v8(0z@q(mRytYsvGppv=#{&(
z^0V;NTf+>Q3ze~u73Dq4<6-u`+;x+gqipDB4D?4MpKRTtTi<rT{7=XQ@-g}<8fD7v
zRNUTUPHkh2Oa~t|{*e=VX7AsFea@M<j(glS?@e%t{j|-cHSYLWQl*`p0vJO2ODJ@o
zF;iUjjm1_ODLsu_Gm<yDCW|-+#<=L&I=ic#qUDLwui}FJwUy-NdH0KOW?zGB!n%|^
zT+>Y};Wj)&R>IV`lrNfvGWKG#_8`3X8XaFz*UD%MjiuZ=1`=DAF^7Pa-HMPu5OJup
zWlOeT=7vsE7vpce=1+%s{x5#k<HoyAS$>hN#hWASfi0Pix$%>7oD6K2qb$ZJ?*??O
zQ6(@%lMtk%|C&3BCJ|}AeGS)AL^AZ?9<=Rp5&3|tT<s`ViW*rNylld^$-)b-Ujv4}
z!KSz_B8rvkiWLr}Yd@cU)Wcb==MKW4XW_0I)4Os-tv%Xb?57Bb3n1$Vg>*XKwEB8C
z*^WL!Z&rZt50oj5=U$>q?d8r11d6_5_m$0Vo18>9p@M1c=q4H6Ls*-;7dpo0djtvQ
zwd<5IXSg8IgJbbbc(RZ$adtX0=`xfMa~BzST}+!8@2;x<#$(n>^N$-{lFbrve1iB7
zL@#0njZl0vKWX!@dA5apb**D>PE2wT6o759cV&X7k@sALGdbF2YSNGRcLplz_zB_|
zD@e|2Q_YFc>M4-{%A+ldJ4mK1U*03*eo`|n(tVmDQNNZDMbU3mopa?!HtRnZuQh)l
zL2qF?gVM~3LKtBcnQWWp6i#4e9%tc%4)3OBLmtAa+BXx#e^N20Otn)v9emZ%9=J`s
zmWyqe-b=`Du)D@x!1B^1h~ICjS0&Fjv$xT%i{N(>qbJ+%EEBP;BUAb6`fYD~<=Y@z
zB~_-sSLXh!)HEY5>AYrm65foWf3!4BbaMXg5n8(-9Sy`-Fi?2_Kh%<r&L|EH9a^P|
zmYee%NKJ&Gc)5dewW^kuHI!-$@OxCVcW6%Wc3+}#VUH5KN(zE2V3qPDnu^1Q=zei@
zaj})^9}5t=@Tylz7gK9Xj~lg2rhP@ww^E~RHx6W%797jLYUKn3J)GjS#lJ$UYxB?^
ze}{Lkj_Si*Uazptq1xV>OWD`bWnn!e_QU%`Dq8vHNmDpK7n5RiMI=5Au>Wkb%^G@k
ze|AP)1-hl<#Eprjt2z;(qvVirw5(<NS5!cuGyhlFyvnGuLq$AYN|XW1-W(2_>-NFe
zjFD!pAc*I2C|L5avBaBcn1e$&k@pPR$9t+H(~t9tG@mOM!)c5(Vq|ojZF1D6PC(sQ
zd|#TL-c=m*zFRWT7Sfz*DgB?8F&b_aD)yoH;QQE4*O3KVVa1!0f}gYW&E8998HuwE
zaxxk3lzbL{B4T>^3+z5w@A^M!SN~&wFWZ0b@BNo({J*U4|1MrJF*9-eA9L^jyV|+B
z(>TRUww_d{_1de`#&ttgx3#L%W~<e<>wlkHFKf5nXR|r3=6*Bm{Igo*#6<2_5jmOE
zYh2+^;n_qr0R^$Wi4n0a#I(e?z~lm&f~s<Ji%N6z(_&F-1EW&#cWcu?!creoyApE?
z)1zAd&IsguD-#F=CMEy|MnDWs4h{nez&;zBovRrc8C*aVe@2Rm3d^6V2YCpAy=#76
ze{-&kOby`ipI#1Z&CPW!Oik{e(6_$aatjj>2NqT!j4VwoK);E}Z?tqoP=$y|3Sg1g
z>e#Di8bBwxk2Etd07_<HVry_>sep!9-u?%EFaTg|YvCq;Dd+spXwrRvd0>upEX<7W
z9J6C91C!7AXfOk76MNIs{kvCOgHr&8hP5WQuPtD4?10Rcz>?$xevqHdSlb^`6KnfN
z_Q8v~Tl$Rb*x;hzz@E$+;(dEHPQt|B{d0@Tvp0D=@TNYyfY|#z31MvDGJmO$wO91h
zx;4eQ=}o|Wi{pzoc{*R>fP&26nv&eDy>0&io9mgMl7nLdGusD!7z=<GF*2{0urx6^
zIDf+*qu-^R-%8}WK9xFiYwPouTbnHZq91Z_W^r(0X=5%7vC=+HSe)NeHpZr~f?xBB
z2yN^w01V8ZA-lgOpLu-d#Gn4yBKLED3cjR;=H^E?7hw%7OkjlRjgQ{gNdpdl<xD$&
z-HCqr6W)F!`+wz+zkkVZ{MY{aZw&wXzdrsmxi~g9rz|uveYhj-^Uq-fpzP-fkAC<^
zuQo9?xqR}E{Ju)47X1>u`-dR9FMn=90a_>bIWf#LeuXbg3l2}Oj4RAeFZ81rRGYuI
z$^UMq*1*PI(au!I{#?A<Qv)`~z`*>@l$ltW85n-cA8Gy!nVQ(X?REU7{?$KyYFz9K
z0RgG_ePw>$<LKzy<fiJ__$hhemr879{K^aVR{#OE)d9q7j;XE&&?0-u^KZjJCJqRG
zFI)R1Jn9pO`DIO8b#7*N2DSL2%?iBVJNzAc)F-a_1tYexH86ggvr=?fZesiD>i;P_
zz;6po?)lc&{oQ%=kN%mv?~~pcA72><Fms(44WORqVI`hv0An_{5RxdW3rBRJ7;kOY
zJD2aZPnB(xxB3ew-f<)Dil94$a;9Fjb(nd576`I(AORmn>gnFNpo*7^&S+}S_duq}
zjs0A}-{Z#Uv)N%)JoX&4%$C7L9Xxq(6Ve^zwg3+Dqw*>5U4CgUrEhfRqtB8=t_@-z
zoYIN$1Xm13kn$&}$+<Bk`HcJ_aN(d};70py7g*=w3d2H)j#uWkxCuWp&aU$X{uxYv
z-+q>+f&Rns3AeJO#_~p8(RG+?D|a-Xn~>pXT{|j@wXcxdkLu2BT;nwfdHPss`ulnV
z#Mf6niQqv8kH+n%x}{k71jhoeQh&j9W`nI6x@&z7-H`M(i?fA;aT#cZqpl*SsN+-1
zaH}n}MG!nWgpL7t4TDiMP;+3Dl9uUBgQ`PXFK))Av!0UFl_Y(9*5_J_f;-7|@Tr1v
zq|?$Ofo|K(;his8vBip@%mwvNrbi)@QqDTBhgUkjsN~+?(=DlUz+11nRNO2Gq_MAe
zVeddEH>{oQQ<b1m_gPn6l^ZpP+~RalXDy^JL<^Q-gctvawdtBvx<rp0cDyX};vVD6
zI$><;m65p^z!`-B3w01{a`Kot1SSxJ>3!j9ydofZ5kiC^gI@Rr{~M!@PuZqjgmq&)
zH6}HR$4jmRWpky3&$vomMq2GBx=M>s-0$4|lnA3fO}jO$7R(*bQ8F#O*uPeAF3AW`
z;;(Y9<XXw_h!*o!uU<6YBU}5uc(!%6OYmlu5hwB2s)<D;cP*)?H#DhrCz^9vj3$71
zys_NXjSm|XLa;iLLaPilomx!fhepbvc%t~rHQZCm!&{nVy&EV&{%wCTeY^dURRNy5
zWk2-dt8(<GPGiA;T40Z$j63Sq*+p*$AdRp*pv9d3`dzs^!1?&Wi6o5<1U?elXi1op
z=V~spuJU-Q@8G6zCf3tQE{ZrK-1N&(b(tu}V*W(@Y^J_<j0MW`2PZDu<u#Thhv2|I
z^=`aX-p|9mdu3YAQfS+O+4!PDUhc|?bCfw|SdqVS0a5eNQkK-5&OY5oE~Inru0NOR
zO}3IL-gr;5kHyO**Bg5HEhtb{wef+6$vNOc8d}eBFd>cX=4YR_Vg4Y>DpVmyG~UYJ
zq#`8fl~Fy*=gQUaP~+%3v%ZBC@zOV)BGo{4yga8Vpg`2*<2vc?sZ-Vuj=0y&p6_*=
zLhF<o%(X4VhxLE15J!;Jw~zCYdS=}I@Uf+BqLC8rcbNTnFARRv#2zuPfE-5y!On6A
zm#6n#$8>X9sow=u7bzdNqJc0NXqvT55-vACQPo<M#o4vJ1TMDt$sNdyo9dY3*7w*B
zILbrxFYlo@3yhCzf<*>3tS*5=gClplj652ud|IFUO+&(lOV~4NsRb@nFvMpp1PVgz
z8SB+4(Zad${pytzt`NwC9cr%PJvv?zqsJoOTUOvwOc|iw^#CgL9F?)8&2i3k`S_mK
zQBM@h3$`*PrC}5LdYPYb8k4IERU6`}B%`7O&nL_bZ@W=K;s<<>dkMnM3>x79W|>tm
zE~$4Gkg9ryApuEGtjDlG*j5pBLu;kg=!7ke;mIm+7izF`nfze;6IK9yP{foTsLY!#
zqB~RFP4F5?!8>U~1n%@EFUby!{L#@fQ3oC*@R3L)8{UvKWpC~jUcyRx4V;O|#_3}+
zE>SK-Fd#U^oY^7MHAsL8y8){pO2pZ&WCcI+Y|QPPiEZ(DjIvqrmI`a+|As(wf9TWK
z%@zU?Z%Szv{-~8Qa-IQT(GYt~trk9Z_OZTTxdpf|Y?Uq_DC&yeW1#MB7%l$dyToBd
zD)PZ44!ZV6C5zwrH-$V^FlKltmY%&u4r<TGw0P(nFKNc(1A{M)JY5EY9+UX-2)fh}
zq*MT+g4vYr1rf-tR6SGX#bXYyo_0>~D8f3)c=J~0s=UClE5WZ55-Fi6TPO3>yO*Gl
z!2IAm2Kpk(VS9GRzn?a*eZ^L1NKf~;u1IRIDfU#PS*LH;HXehx<``AjpzS0VVpN%S
z{M9$j2SlKIw+Rm;YD7H^Eo}PY3HVqGdRg;O(TFx~bWVA|p~08RY`cfFdHEfABQe`t
zMvytivkh^z`T^7=^Hv|FDT3{6R)1eex%iqVloQ8-T5-JhSOh@-KE&?^9C5CU7Ogy&
zw23MDDgrr{SZ|`nV&<~fONpTG=JN9pU{qnmasF@cwHB<lM+riojPt>eTQPyQfS~)O
z+s3l-!n{nBBEiaa5aVp%z}TS`3^G-v7GC=UWBiM_U9wItT!3C2*1>z=@WeLGkTt3g
z^+qkyebRD5Vtos}=XBwFxv!Mp$ac!*T%KaOUPpOKD6y>-6Uj1BQ2`~}_E22)jUk+G
zziFqmS0%~N>&&!9aK})AJNSmJTS&}mmZNQlfv`K**!ErWsm)hqiG?tEF(G6W^j#!3
zdo+t7Qbbg~Z+ZN8$v(<J190@nouDZ)SUU5JzmJlv)@-}tM#9RgZsc&6kRR8Vl9q_!
zmqVjYd2L`_G2v5ZN}7K=9yEV{)t-R%dUfW7eGv|tre)%j&-^cw7!Ml%Ci2hwnA=+q
zO%j^E<bn7{(Q*oYy|1V5ph>aYM150=LlYh2$FBS`e@_l;ekNx}{^?RFwc4-)o3>Z3
zq~JLg(TQ#oTg?Jn%Q*~<H{U4zfjlgQ8C~dGGs;!^K?eQP2KAFnl)<U%%FIO>+||S3
zS9Q#Vj~I{&a#oyq7Ij)(NB@NAa>6j5k9M2&Iq-chq-DwIYt=xvWiv)6Cfuo}J6MiG
zvq(BQwPYfa`EW@100%$aC837nTmGd^0+n|<P}XL3@}b=u#Q_=x!Ls?EYzn{2${csx
zi<fz_DsKLiea*Wm=78C`WlmGlI~Ou*vybSfp>Dn`of0V(yeWM!29KF#G18cH&$)sc
zKZWGK$%VF-GrH1S>CN&xr+5G4hM9Z?ts<JATuhu?Y&)ZweXC<f#C=I~H#=yKUWR*P
zN&4GQLg=XTM*7=fG}x<|A2BNO9nCawrehbyrjdFy_~48%h1t-cFwwJ-dMD|99=m67
zER0yJWPm+V&#+QDRv=0Q><U1nZL*LcUelR`dSxses{oVHoDm+ZoBiA;@uk)!BY9!b
zn>j2@l`Z(g5;i~qcIFH3{T?uOg~boTf@r50X6Z?!U6Dql0-4`w#f!=Krs$2QbYAv&
zu|GPgTZ9SDn{Z-gcD{#g3sPc8SlBnSI>}W|1tw$lL9aq`yo@=t-|AI`mcY$&@4D;)
zXI{~da_-s*Ta2E*aF*>(cn%=8>g*${c7nr6ntKYXj9gjt)YO_50UocdY<iVVpU=6r
zj%!US^h~`HsxT3t^i{mR3+uk!Zb<L2e%45jT^wtk_kV8F9jlIPPVvCRwdQ;-g4cOa
zQJ}6LBfa?WFIC(hBG9fVK5k3;9iZHj)uI{p$E%ePlUD-OJBFQg>fQhFJ!)+bGRG8g
z^0ScL1+oJgE9RQ==2_9Hg<_H32{8JiC{_it6_rL*Rb+BE=!p>EWm4{J0uE#z`d-HQ
zXj!|aqG;aZ{UbXkkyN|O-YJ|lirfdcJJQfj`zB5JeGdFfEeFnApy7$Xu<NlB>wF;j
zztR=PEDpOv?&tgJizci51>my@HxL0g?!T(<s3dWNgW^zvn62bCmTKMUxYbgy#>`$J
z*t%0&kETLyyqFTy&i8Qc{IiEQ-ae|Fbsp+<w%dOu-|fta%20u2um6=3Jtnq*ghOYv
zMJpjU%{R4y(LvPiL=F;Y)|T>82BGwz<$8x;U!>MB_RM$e!ZrRS<s}C?!`GBHSWC&h
zvH9@l@(@m{S7-K5zo|AF+`U|EcAl5gf-vi)R$_%n!3i&FjY;L~czYbVM08SFI)`JJ
zlv?z~k}!dsMYM{#+6>enw~){>PQdj(V{cV;^B%oFOWs)BYQxd0aaHxnIu+s~<ELWR
z?lPAR&x!}s(mSA2*7p>|kI1g0SZuXS>vetHdi-)ECJ@1vxG&s9`ptU7-8-cnjNQ@6
zER**UbFy8v`c1h97yrgLh`7cUx|c#q^itsc?faZv`aU!zBz#A_o>zWPOx984ySZl)
zPHUjEnZZDkSu3u*5$9~X9O79lxm1n-r+3(*yWQ>2_HUsvpCV>^z4xO7{->dJ%m}M7
zUpOM>r^wOi)s!PIZ|mU%H_*<5rm9VSAjr0>De%14M2LZztM0~k;VrE$GW|-8(2!a@
z7jY3=H9;$~IE2g>$|M;3Ig)g+pWHB4WPXwi9K(H=Ws%O#N$>6-Q*E<ns$!q_h!@PD
z8r8oIuOCKWr|tTV+eu=Z?By$Di7CrIp<^;0u@ALMgUxfqA&f6890{HCSpJSg&zhsT
z#?+omo0i$CWD@C18dfvyv4nf&T>2QB!}ipk8;hat@T*I+JgI2_(b!$C$%CC7&F%nt
z1=IOd&fvfG6*G|Dxbz%%y@Jkc<~)PB4mEko?a)Xu+=Cx+uUtt0Tv0LQ*BdPdwX4Tk
zprJRP%xuOU{nY7+PGd~e3$%rX-;8~5mUm1XwqHf@Et|;XCmbhD_~0C5-yaJL!9|R9
z5FTA)8Y&j8vD$ze-Zo#pFWQ0`9UZn{dDr{$i}pc_;GGt`ed#gHXpj%%)16CU+?m;#
zug@U7Jm!Bpssu*&P_1!h_KQ3IamOVWdVU-VKo$l0Jpw?#ohDBfBttslQ`p1z_g}b%
zjUMF=gYZKUdDQ3Yf^Dy#Y{2Kb|KupP$}$xYrtMtLn*<@w-R<h;IsGkBc#<|P@+==U
zT<5eO*LtHEnT$y!(QhH3VBBP4PjjjZQVey4PX>jh&2n$(kso^?5`Q!5!AQ3`0v4~m
zRlQI~v0G5SBdUGzOgwSw6YXy65(W#vBg1F~oO>0oQmArBQS>?Pb2X<R#zEoYNmeW^
z11eA<<rDE=@03S?z!$NVLCeBM@Lj~cxT|-88d3-a_0x)xA%?{@Q>?}_3^D8?hi(#+
z`-|Ugy>Z{y?PU-G$Lsp@u~;5dJf}qLT8YX%pV7Pm(Z>T4eEM=}zG+d3%ZL{poGNHO
z8I%`IvWl6900<s<$}a2fJfSYlZ=$=6GXHc-kIEIoB?&($4h>cI5KUC_y^~9qA@7VD
zkWM+-mI~vT=nH?0YpU<aE`LH@SIs6FR@DQnJ~C<$xxe=DBeu~Zf|vo40%unMz$k~P
zMt1VCj8QFi!N!oCTNJYv`B#cP=Oy}t)zuZja(`^oWO3~}?%bNotrg_D7PDrS4o>ws
zl`y740KF`9*(R>sScLGNrF~9&TxmwgYwYuWib+oL>Ol6=F0oe!$?Mu(5iOY8*FdWZ
zo>3~f-mJ)?X=i5U2O=HKmN=2~HSrm`1gqZVDb*tqy4p-|l}TMWc{H;VU8sFE|8MP{
z_S{L>PF9;mPCt*h#tj`~)c(p>kL4?`a>LgrIS+EJ$M6IDcQpuTUbAlDJcuLT9`OTt
z?8J;q{)yrE3pswm*Zt{5f`Lye8(ogwUCnEH|Ea<Y{p3taw`69=zdyE%oZ$H7en05v
zECobOfU>!*S7C+SD*nY@4+7JK5PY%(-tIl3LJ)TL#zY=owbunG@zP1AzJZV4)1E2d
zgzx@_RJZV4yAxMOY#l<d<54IgwT*>Y%Sm4fBeq&jcFd`NH6RQ9A(CJ2ZT8wfoLDo3
zl@>HR#{nUlJ-56RXf0s&^r~U=;fhf9YYqj%KEKD(*tW7VK^fwC()(7umRwmI^l<W6
z$Q0(+WuAUyJm&x&HAP0-Q>)5(=7xiXe#EkP<}F8h6EJJow9ZHx3{Vp&GdZO7L9mj~
z>j(r3o6tZf0+PQY;URTD`cvv~C1G{vzNv||T!hFiM=`wct$<2f9OH3#tDD4}vY|9x
zwPr-<`bB0ZjZ#a7jgdXBI}YT8H}7d~6VJFtfWn1j95fHMPe1JLUvieNf1U`~=z~VH
zqLALOVy9i73M$3os$eS%P<`2WP8om8{3i9ckYztGV5kYBsDf!8FWp{!3KOJQIMAHD
zjdqd4=;>>7XSci0a{QGT#N^%O6ed;{(Nv6(nYlsJ7s(B(2K9;^Y8Z@;%Vtw`(fui0
z$3Dr_Lf-BG(6=)(;+xO{fJqCq9ZYyFWImiS!peHsQ+5LNhGCh{zP4cQsPLDdwS;fu
zWym%?dgsW>h)A8xwZun9+Op8QTGV_z<}ys5>GmVl%&><_{>1~|T$Fd@`g3w__R{NC
zIRk~ub=P!Oc=c%yyBwLVjPaPfPJj3wlDMibOD8mk5@V_BOsz%1_2S$uIutsw+M^dy
z(R90#`QjS1imQqmMU#&|zkixP@Q!(1Iq>?*+iUx=1)gZgSTBa~de2-EsC1QfaLaVO
zZAL-wg|E^z;djy+hmNcib^+Bk)Y6kt{hy9D*DQ&)>Ask+GOtiq{EmDjS}7JivFff&
z$~k=w95VTOwY;KDs6!W}V39po<h7g+3lDe(Ohv%SEQzX_gqMcqNl)2d)HJVLF+Ww+
zZ?#?jO?-I#KYzpEZ)+rQ7uN&tOXK7kB9GziMf!kF4-0*_WxlNnG?_@oX3VBWKtQ2w
zY?@}$J)p#Rnlox9JuqR60kkboK1eaqi!?v9v&2bW%t3~Z>j})fqxz1RC6vl+W-*(n
zF)bS}<*K!MBh34^R4m1Rz}Xs`hS)v=XECKeja%;1p>u$Gx^Ao9FsurhIJ==H-j*LN
z+Lu#pD;T6=fV4==85&y|_-<vYchBp*t=uHdRUtXkAZv_76%_Rq+~yMs$|x5XV&y0p
zQvcPa^j!gOtK(83TMS#tIE~C)J+RfnLz~cM6qUaAQq(1OXb>3EcVh&#d>j;gnITYK
z_wV=G<q<c6g}%C97|GzH!o~KJvux@>{B|+6g#yJ-V_)LaM9d<Cl1tHf9ed>E!hhq$
znIaZd$Fq1F_+9GyjMiUx^9yE5S@8kWQhdQLd*m0t-USLCNu4kg1cfypsx!WBUJ^$s
z#GPeNn!sfZcWkq!TW@JTBJGO1>AM64_?PE`=w_Q;C`2_<BA}l8MeR1SiA3fd6NvSf
z0JV8-sQ6#<T4?$pJ%}NC<u~p__Y@VyttrNC0}=&b7FBVb1vjZH^l{m|=$#_8s#R}d
zB=ZTEq<`f)-ue*&34K9#bPEw5tpo2De`&6|5HWU6pmeB^R5YtS4x@ss#^RVgBmv=+
zz1}6Df5>kn#e>T2Day(z<&SMoX;rn4d;W<#!5?6^#1zolnl4+BdmtQ3)il27QT&oa
z5!vr?v?1<B*sXBIb8QU028*d;Gz4$cW>%Bo`G+O`2Or!9lm!~&OOM#2OIG)}OM`*l
z$1JML`a!1f5y;C_MU!wp5@5KaKpbv9-yjh<Z9L-4V#)zJwwhUttIz;m3%7(SU5TN7
zxLr*8)2dxw>g<jHhAX0a4G0Nr3nVyO>FFHzNkc~&`hrMgYfMuGR0bpG)j?d*Dv#4#
zX4!OjCWm2j&NlYlhMXZ3Gtzs_fRxo3G>A>D`{lJ86n!503M2(v34hj~Fub6$L)R%=
zI_WfKKGJuLkFCkii2GpRNjIbo`fU3>#zE>)s3f@zW45OMx)A~%oPgRY?X(GvWP9XK
zBaQ+(kh)Q?X7kpaPYet>gn&JCa~FUzVmDp_#fEZ9%n&VjaSDPH#8{9+??z(vvpPNh
z{$T{~2W5EbD}=UZ;c2GNPz8vprXZn&W;09{=ny!2z~{xAFvhI;wz*bEYd9(8;VVz&
zqv_fO)}_KMj!t3iTz`8!`r=1u1m^HG->t*Hk}u~196!218oAXvr^4Y4gH_9?wkue<
zrpmFk*!(<KN~R9Z4q$Z0ppxW|j07}{VzL>jdo%kdY|0S@wJ($+v*xb4pFs?wTH5Wi
z#KY#pkFc}o-g0f3NgymhuzHw{by+VlJTy<$<P)SMN7Vx7f=|8c;+xAp!0z_cLXe%W
ztO8==hN-BBA_;C=b=b<rZ4-ahuy-O>`LDOQV#!3W+|T}EUqMV#hOO6o&kptAz%C)^
zlQ3$!cRl|@bW5lWL0OxQ;K^*y@@m0PXKRu+M-VJWYRb5|CYLBXr15zW2qSUQfxI9L
zJ}BqhH;OXMdsbk8K%!5A;nTpnhNUh${2nxs41OTrydBW)EvoWrHCdX_LKdcRPjo3^
zV^=gR+z}qgb`Du-IfQ`|xp+cy-c|<ag!wVOomHJxi$OmzYmX+PO~q<(krGMoE=&Y^
zc{bZ#?V6jW<cqib`dHT#mJy*8*uRHBXD|kCOKgm_cyM{kEoJh~<$_*zpIu(Lf3j>;
zVv<UxV~7gO7C>CF#+rpdF2gM;=KhbkDUGZkvq);@lsobhU}~=Bo|Y2__*>VIrTe9o
zu6m3Rf;B_CuYuAL<??Kv!*=z^h)0;(ab%M|kjm<q$oO6lzp!d<$-X`6BtGBHWe{BD
zMP%A+^k_(F27~7nSDh2pz_oai*EI~o;()o&M0r&@fFACD6_`DXHWSyS=kQ$u9esLn
z$Ahgj7!%Yp@c5#Wxf<8sXZY7M_iV$AdxbD<39_N==4Tun??a;Jj|w1Yqc;Uik0W`J
zdbR3Ox0HsjU}3Gfh}+9_6bx075E8QUwm;3*NaQch<?4~}H03&Q>G@IufZ@1g)9*a+
z;)_~dj!e;DMZ-3cf#2R>Ya{)0$hxQcgQ(Q`j*^`s_$x(@(J7|F{E}ag{%dQG<fOI;
z+L+meZZS@^H;pt3tCimP0}CxoAaw^B1;QA-KhwEzC@Z$q4r*EmzDAk+0V&@H=w^Kt
z#@l%oVqv=MmFMe_H^02BjO}g<LUp+)AyGKjWV&{Lyqqo~oSTX$JH*3C0>;>Wga<od
z$%d|WiCc=>KDr8c#-R5m09&=e<co#y56ep))a6N+ux*Q^yQKqxZispb)&_E}r9W-T
zT}0k2gN;G_Hfht&@=&vn8>}8Y&SYXN?gqxLRF0kwimZ|Vd7g54d0iRsA+V^RnzJxX
zZDv<ScH|t@O)tPR?#D*Z3N$Y2q6$l>A!`qi-rx&NPrsRGgEeZsG;=(OkzPk?Kflnz
zc0_Wbb@f|ts7T{CC(XaPz0bw*cUM!+DGgn|?q(*l&J8@j(fqH<cElPAfNt|HX}*FX
zpfM}nSRZ0^P^{x8N56c7U-CExFZyJD&b>y1S$B^5BVI=L-V=(MDW?Xc*%&&L8Hs5b
z7bpd>I)+J)z;Hep&GDD!dn$B5*A?Yf7ZH{Mg?v<~{dlsg*&d7UtE~5^qtpFMce6iT
zh=&C)#27H7p@}@%Z`zeUlNmpRGLAC#DaF3cL21?EmvY@=h12^Rm=FgpO6R<%QxMf<
zvVwx}Wy{PZa-n~l2<nAA!~MJS$NM5BL5!BkbZNlID4herc0<o1?zxCxkSIxK6}4EO
zz&QyBgyxnc%8vR2sQQQ$_Nd}O4ZZi1@*WJ7$I{a3!|Wo{r0{ixj-mDvBDg`aL5Um`
z_gd)P+gLqqg*X+!drK*)YYf4cfT8FzjI^V}TU&c-V9~RRu`T$!HvBf!#CT3-sPqJA
zCYYV2t^Ksd04xiLrko6E7v!o%7ViC_pG}aN&y%MfGShdIV=KqxvmG^jkOra(Rr}wp
zBxBV(VUjjEY~JAy;ON+l%Mf|^9|kKj_B!TnY+@n~x9wg+<nMW&=>7+pmvW%`K)CrI
z!tlw3W@?%(6!CzyExXI^6D929altE+%mg~ZxVx$aFJM{5+5CNFsTGA}K7Tv{F;)1g
zFaum`)eQ6ZPA=F#BS6z?UM1x^&&yi0zPZ@+duTQ}Pk43pB=|MYLu5>t+o({U$sCyR
z-hsl^*AU>F7roY&FsPrxI%Kw1b}Btcl<T^@Z9btOBwMoOoo$?P50P8L(aOLnJtXff
zl97I9L3t=dxv5n3<w{`U8No8ISQPl`XN++{8OYy7uG?j>vTbUFwV2eU=K5MRzf1}f
zD35%#V@KH`heH`Iju3#Bf=?>he5=NaRda2LY<!3m#Rl1eG}<%)JZi+y<%ET)2qipV
z5qFd%ajVOnN*X#`;<q~>itl4<&k~^ux}2|fDYvYMs$0n4?j?4SpF$FY3YRF{>1AQ+
zA!HWaQcH%`Z3Kb-w(A7NnW<y<lw&@EW{Vd~_}mTDgo}V7qOFU5ggygd>&>5nTSxl0
zEikHA{qStVanJvv^<RP{5;1@my9uP}dFk68dMlrdj=ibeYW!?ubX5Dp5Oc6A<G}Y(
zbM4w)Rpmqeqh*@_2QNb}zfPMbtbz76COlX2HX*<mT(`LntZbQiZ~dQh?X|QiPfMX@
z^~5im{2Y8{CS*-cs;$#XeT74D!A94frki<ihKkOn#TS{_=pCTj!`o%^N{$N713!e-
zmS#`d^QcEG8NFPA)&E7<Im8OXL|gXSwr$(CZQHi_UE8*8+qP}nzPJCp<Rv}mq=z-C
z**Qto-fMB0&I(0Na6rdgn)gGTlm55y`H2o`RoDi=(i00pzkR~b(QX$jkP*CzJAg(h
zW4`Fx<UI`6!n!P?!~aX^+7e>Gd<ncOlrCV3$jt)*XHZG_&YUYiBTcMc+a0>A9<<@$
zlBn@i;m=ZZ<;M8GWV{#^nC%mfY%YA`tkX#`p5W#w6F#wo@#RE~V;&Z{WKLU<(MYL|
zh|csskcSr(wM4SiSp+B!yXEyBx4tYs{PEU+(?8U*<2FaP*!%@CHIE>;>$@EH#hVNI
zK6D0}!cJYg6%Z|X4ZCt&6p-eWc`5%XcrrB^Ccw@=n_M=b*B@0h*In5`(<Dq{1f2d5
z`j@_q;~o1VLUt}=`@U^>5Rx-MzuxzgoY9bI#yg+THo#R7ZBp+;oPd`ru|Ie;Ba5N(
zEhTqgz_eH<lhlr56aNTA-SD^$cCB59U*X_P!3Wafdgfq9MCDvkQENG>WVLT8WLv0(
zJ!02?5dpd%_#!r#3jY?kzQiXa`?2WJ%Ks)q_^B0{ckCtAUjOLm9pqz2)eJ~e(!mdQ
z+v>|)NE&!}n>Y<AUFQxeZ<My9)1dl`c%?=E=%9lSX6_``r#I<VM{%dKeiqE~bKwn(
z@7!ZD19|CmHlsz!qIdnGCgOyGqI3v<flFUYtJ;*yK*LSz%===K5(!MwrDGz!hMWq(
zf2IXzYRP1Lt`~aq8*aJ+Vc<cmfs+42Wa=yf4ZAniXwM?c(Gz2fk&u%AJU$;;T^?^n
zbz|}kyJSuVJKs;gnN<Vx>fpb|r|b1pVWiy|zr<(IL^=ZJ_Z$#0gZUPJfQE6~pz!9s
z@$)xkgOc&0m>pCQdW(w-7vEKz5m~#>RtkyRTpvw14~Qjc$j%n;`jY(e0?Ut8c#ez!
zZ`!>P_I`S+eaxFQO4U_f%?;NPQ_Oju1vfzpRR)u7O|;s!8y7Daki!m;h{LCD%IQI>
zmyJjrN8nCCvn{rOe{6k)D=z-{Qk6=ldF|G=CWGRZnYdoGnoVL@nzQ1m#a<cPvo*k2
zMl4sK5;m(D#WSy^JCQY`2Q+;S@%&qC1t$KqaFrD|4)+#zUE9T@v<J(}Fc{rT8MA<<
z?hzwkjz2+_`i@O0H&vymzjKcM?XB3E>uR%1caeA@9PQ~fxxvxxepk}tR7QMD>R0I&
zAe>HDhF1;#>dnNzq04>ei-C}$L<(*pg0oK7jD#V6ka~({8I(EfD%9>0q`m^Rb2=a^
zs&dpqd$Isqy)Q6`Gt8l2D48U-&H`{MTtlQ61~tx1YuBs>JD`As4&lJX(h2k%q0>a$
ztGOmBH^j^jybr+ZO|7Xj{b?K&8ZcwFT)S6zbnqOgk=db>03mA*fT?uJNM?_x0TUBr
z;^QLkLefCKT4AAvV~`tVX5A<Ra#};2Vk2Y<%U+Z7JEDhvrdnRIN>8_+`|->d`D#4_
zT;Dl;6t7gyPdn|ctxI;!cUqTZ14sgf`lU*I6W32Q7JFF@C9n)~X(boaipNsS6eSPu
zBOs7k!?^(_IJ!$gSC!}6&kst5$Sw!uc>xB^BP$@&zr?gwWS}i#Bd^7T3f3wQcS;k;
zOvaXdl9zTVi^Iz<bG)bw@IpB6kF0>d+D9^b5SQ3(*CKH;^GGIC6bqv5_SoqHvXQv0
zK5#BBIdrV=fYowh87b|OB9&y#eVEftR(`ikW|!nfgwJcUb3)n<@G<ieK+H=%=@n&4
z&wRAVeL^Kfbv^ES7i$jE@m>^x;B1mQer;ww8Xv!Di$^n11HpU1-2TI8rB*%XUadeY
zvpt8}b*A}qLP$15Wk~{9vLcJE>ctsF?4dpz4~Ftw4n*ML6+s7gdIH{lb8g>zmpXlC
z4Fji#INSHx2Hh(qi_|r=tzM{AkZX7?fa|+OTOo`ar7wThQB!0Wjxn&hI9Co^f{O@(
zWeVF(&GMRZ?Q7!Pvf$6M@CB*oyVk1-k;<v*-yE7EOHQX5<fFxInvr@hU^qU&c~YG?
zrJ$S>-!xuF6|623LP|ch-X<k!{MZTJz7?_;S9@_B%XQ0^jxZrIXVfWdYOfyhfV^YX
zj>#|;zns%3nfs=Sq$Lr|=6rh-^PHXD*2{W#HrP*7-}7N@7XYrCb#b6}=hJqUmF93b
zdFwsitxA{$RljjwZBd?GY@;}B=@slPz;lV1Ia$Tyk;STJr^*15-|772#lCz4U*z0w
z-p>d34{lMc8cl)yF|Oz-b_MxLu4J>HG8*vp1vkj^AZ}0nM&^X;BKdysF~@#l&kW8h
z@aN9SmB3UIi!MY*vS+~4A7GB0r<jm|UWcco(U6V$;W<j3_0ILR`U|>`w!)O$j}+R$
zWehobIhd|&wPT%kHSD@|TDlXqK>}4H=!~6LgsjZ=pn53I0r+|3J@@(NQ%G#cmjBs!
zG*=}$+Y)j~bmRG53r%i>88Q2~D+|7p9*}(mC;vJ9G!Lsjl&H1t`#DI(r6Dx)$XkG_
zj`X8&gP`OrhQ=LTzA;XsoG)a<VpN)?Enf2|^)4urR0pl@K2eyFoR7cL`Sp$4ETR`>
z%>a}wgyf7ppz!WY1yf0}Jg7?k5s@`jWVdwqs^r5<$IWSny_b502jg&F2?K9A$m4B;
zxIv%(aC`WGUHvl*M`|p(E^F%2Hq3BYPxHbTk|+MC*}MCrig5xu)~Czym|or)l0-XF
zz&Cl<vp9~rO-jWf?tiH-cnfDBex=(~FM5`R4sV^bQyL!4Y<BlFDCI(>Nyo_Bk)zOK
z;HWC=GySNGTb0VExbi$jAC;6DF-hM*T3v?C^6Z`OS|7u7jGAGt0+J1e1ZOCy>CrlL
zGIoC^=~c%6(5^sOZ}wyf89tUwKlZC*x3HH6jDMn_R$>9mt!yqqQe7sH1#A=b^wCCV
z=hz+doMsZAPe>eO9eeXDqp4plLY|}cWUa<+70=!lVHq8_A$|uh{#A0LMjx7Axui^0
z%mZeiM#lVKccXCxk6Iv?BBEGRrw}UbR~Zw16wQb!k|%9_KVIKae2GXxuOZF^1u^Ig
ziQMz1Pw+Z7+KUuU{6!_i7xlzM-_436$+X9Y*>7ct%|z9>W{~jwle)K4z1&}_u;M}P
z&Ik*JbOf@J6M0MF^mT*J8FwoISN^VFxRTa5LG*_MD|?$zDbP;c4BqWgFQ(d4W;8T%
z-oa?3KNJL)N=G;|yibhJ=nHZ4OA6t@X#gzn6xmRF&v}ORiHj@!Zu*Na()B}1t#m-`
zjdk)D9*vu1>cBkbu{b$$0lqMv<!EL94qtN0SJac2Bd`kVJKEPUci7RG_e27pHE|(!
zM9NxS_&H%h*PytRw}(Sl{&I$^Gi8bxHwk8GF#jWyvW<BZ*j|QWT><=5XJ;8v#Ci<3
z+9^zAKzvT&K&KH>{gLHZpUsOJ)t-&#kVl#8cYPumiM+x-CY7ANN$3>^o^#+@I|D)<
zlc`9|-Qn<1z(eBi>8*GjBpra!_Ice+Jli<;14RnS!90O;0)OJXZ6Q5}-%GEU*!dY*
z?s+)otb@oqxLN(AXo{%}Gvj?2z)Mt2(60zI8B#L_C-k)7OKr5>3pHxRCAZX<wG(oB
zQwn?GEC+F&nAiDp=7IwYZBbw)e9p@)5Y;5dn{|s)rR`OcV)&mo30o+p770B%UxN(Q
zI1k)eQ>@7cY8q2RxB0(Yc~&KYHJ3-|;UAwxFD{JZt{W;8?(RNbf#{i@lD-eAmNKbZ
zMljPb23u{UIM6hEOdgpl6}7g6Ir4uN_=U^-%h1HAj`(R&COQ0oK_@9^1yzo&#`zvG
z5QOW6?Z&LO8ngWd`$?}===TG3;Uk3ZWQUp^8#BWbKuc)}{?&D#J0ba#No0PH@b2*y
zB}lbVTAA4{Usiv`U=v;S%oAU-r6}I?FuKVWrDbW~o)@~2U+1y8Vgi@U0IaS>N!wf?
zl)LBgbsQ3A)hya#?GZWjhwnO#8X|kM$f_Kf59w?9doPhJGZK{~>#%ASh_spU$*<RF
zU0L~L<w30hL9CDvg=8Sa44PeRZGwYZYq~xkkT7e|E71+@rPRsq*bN6Dc&{O|^vI-&
z_+B${0Lr!8Jvl?Nl`jWQ8)I+|Vt}bhtAqY?tDvk3k-jmp-6EKUl~0T+KFaX0)#W$Q
zp7q|Mr$=?<7$C@zgk&d(5irHcWRaDAY8g0WWtP6rIpW%Arnz_0r++h1VRHOk5yrHd
z)QYv7dw<H>V4Fb!B1Etn`8}(3qobtlWH(vTvJ7+QI}|#jJBWKcxYz7S2JGa~+M=G#
z<ij2nK>I6}Mj0!Nro-&covUx4>%8&6ly5~RvJOpo7sC&wIDuCh#U9pI6gTFC8yMbO
zJL8sg7D`jMjd==-?-~+R>MH7%3Y2hF|4lphP_m&pZb{-Kr3w#Hbh{!CkQgd${97m@
z^1a7cy9|*A%1*s8RdVrn)tS>>=jw_g=h<n!Ve5d5X#o@1x0?(UkOla+1XZJq;xS{K
zSAE>z59H@60*4H>gWJh0III$ooIubB_*y_GK=xYTqsSR2_QH<scS0YATVqd3Zeo@h
z(QUOGNf}fU3orqXCK-cGPZ*>rtabxryUcb6SL`aTI572S8;}jR(zUb?CT2q~iWu&8
zE3WAj+<PNsJs85b9zU+WB$|xD&;w@T`Qx_D16HMv<uriB!I4k4{ci>Q%sRXH8fGU0
zUcx>RNp7XZ@f*jv2wuLkdR6L>F8o0U{m?#@(j^p6*`1jo4$r%oGFq=dQnRU4?nXNf
zny%`QhI+<BIuiyv4BQbyWmt4i<@_UtzjDN<Dtt>ZWxgX*eyP~wU%neRsiS%;Fk(zE
zL?6~8*%w3|lNB(kzk?ZYfb(~|z;J;XzYP&=24UZ@0SGegdyJ}1nyCFPCa^gxb_@({
zVZb6~kAele_W*0#EbX+TEMeIR5p<IO;zBG`Wgz=yY>-Qe>|pp1zdRhtkszAUZW5@a
z5JStDA^Hu7nCnd3JJY*TcPSa`(Ksgg9yr2xU%$TX38eFF%K1~HSBz*r5=u(iZpHtG
zmQ>C;QRcQ~b<PC6iJkHu4`vq?N91vnfc5abr#JOlLfCVWUHQZj{?mlD<rUZR{<-c-
z*5ghFSq_!E93IEM5syorNCljlE5|!eE7_eqC7mMiMj)kEgMQ+(`_@eae75T2Oe{!J
zs`q#awK8bGZths9U;-zB`l4nNSx?y_WY9yXe6ra-!?K<YS8$&QWj7W!oX(%8LRua^
z1e;vp&#nqy=wO6?z%pP=EMx4jwHNMg)Ed6IM%QmlKb|@BYwL`0W6Tz4nV%ero$$~M
zZIZ`=4O6kanB4^Hy}kNJZ+4I8$rrrmBRcb7-7N~Ol1aHI<5u5*aGPGWP6d1-v!ml0
zr1?{Xk+xIti5E0%+D0X^CEqBPAec}?ukaf6HBnz#;@uO@iIQ)rRh)OndRETyli-;d
zBOB~_axr8s$9SI%F%C74_zpRZWfe31a(+Bt>ZWc}xfy#9JeJk24E{h+E7Dy#562X=
zKU(!TkLH!w2WbK$;`+9+Wc1uB#5cw>!>pOQvZsZ9g2cQhQ)iR5IHO=~T%FC-Jq-*m
zc6@oayzCfJ(RB7>$W@Gi25GQ%Ls^C*S=0fJ#yM4(yuxMDa#0iENwe{mYYV><ZW~Jf
za}8<&<C|+_59@>MA*KoB`GAmIMzsXjYV#M)Ul2c&=I4y3#=v@D?1o@l5Hma+{$*h$
zp2CEj5^Wgu*SJwwYW`5Q0CN&H=pD{@6n{K)D1XZj1vSam@zLiGPe$XX6KZ=3b^Qk%
z*04^(MYGLVH}4H<rFL#)@{=u}``;7^i&-KIr2m_y39J{)CH<#x2UxIkQTdx1nsGBh
z9Wev1J4(Z#>MMRR8%S*Jnpy00Fa4$UM1U9xgp>Mcbq|kx)+(%N3gx1mV>?$5o@{SH
z?;BuB6nnRXfb|Z~SvEjH+nCQ!BbTQN%y*vQo63nFGxCM|i0H9aHUPpVR=&aq6%=5T
z@O_<3M{5*zs^Gg7GM+o?F{Hxe1(=UIm$#8vVE1S+wFlQ9*@BR$tRcC#*z313pum>`
zmb^R^ivm5Sx%_@r4Ds#3etc<OxDJ&1Pvh#@=I>+XIwLKsO4432nVQ2P@DCG{){v<8
zQq>WuG2FOQ?So9ht%yYK1H;GaU%GZXT#K7!HY=Y4%ch@CSNxf={x$Ort4kyoR**`8
zPCrZLMxaqo`!c9*lZ&^28~eG#ewKvO%|VPF05U-$swlkO9DFvdmN*P-12Tj@p=KTf
zQIB{?|8>(^z!XGI8uR>}Wf{7RVP9$8_mb5l7oNgWAWvRqWpBFp;@}wPVWb}J0)&{!
zx{I6ztB=6m?*=69LZcAyb0x(=>_KLIvF|=o-3QVbb-@5h%lfq+)Ut6TF;<BrC_L+~
zTA~5dTd^sYMT#j$*wb<LL;my(iDOZoT&fng_AT}T<UBkCa%<wjgu`5bYFrHKKe$uW
zIWT*OXjjOrkN@y*0j&n!Eo0U7x|%tJwsu)8FV=eDfTt@6Y=<(j8%cf{gku`ap8{)Q
zR>vgdB)4C-((4*|OdZAH9NVjn-QSMlm}cn0u*ja-zI)dZv)<$<XR7iS#YSU=vJVO(
z2G!?~yw5))zzGF%l$Exq7pv|LHJ>o?6J7%)9W9+}sOk@<Mb?z@a+F_YEL;BRX^NVD
zKVoku0)i0l7ugR`IMEDw$zV=Iw7X<j7P^oKK$qqWJO!ou-_De+A&$0h3Vf{uKIQC)
zImr=}^B@44k1~e*HAeLI<}n^JO>6a4vdM37|H9GSQR8yVonh!Uv%(%+z7T#Gk5lc|
zXT_x>99ou5yol^ohokgoqf0C^r&RG8`qFjtq;ZS}xr8XnTjr^N%YIC1h|3));(}u&
zUAwLIoOrW=Z_fG-kRs3DqlmV+fEv=e`7*q-qig<p+nvkLA1XeX!M@AQ^?b#zf>hMv
zx=$NWQeD~-9*2R{L`3n~2Fz=_FqeE&fmgB!U<Ia)Dk@A|OF+7}n8Nbwkw5&37`o^r
zqzeJQdr1bzIGlYjV@YwH0DKsKn|b?Oi%P;Jphl&>n8l{dD>8NW-g5evT3=X>>0rN&
z0Oc;LNT>+9oZuLFqh%qaz?VMP>?C9~5YoD;tq0Fme-Q}n-^jcm5v@2*Ne3hvTxhn|
zm6CzC@6tG`IH!O7@EC2(B|$GbW^bT2c3HDhpp%GT&HO<9fr&-eDA87j?|b$vs_pJR
zKu6`f;u-Ncrx~yUi=b{Y2-0U+Q#3kbDV3s_sj+VDKU@GOj--Czec`@e;Gom{ODSLa
z13Z3Tl0Vo7=d9c27g^pf%3X^eQGGcoJkmUY;bAc%us2VeNYmc<^G<mc0NYff|GBG|
zr-O(01y39CKpqNkuJh^Sq(XJ8fsJ#mVt7LBEG_%&AWc5JyC=c4LtXTGR&QF#o~9g3
zl?`%~-%nal4C+=oBdHvlTUNw|m<-;U;8b+>Z|K$uMgvJPq&S#<8Z@1cG7X_6!S?xU
zV42iGwF@!FB>!8Befj?6Oy<f|UQnoIbR1Gom~ZPUHZrIfat^9IyD2y9j>8@BRf|xm
zR67DQl_L#?Piny`>J7GNEgV<sEcfyo9afM`AflAd;I+K6qx*Wgj9N|EUgx<~;9QFH
zR#XTHXnJVC!Mk%(<a<>c3JJ&kjo&54UF*zkciUd9VRU&VNG;9j(fWjKFSY9HZpX4Q
zq1eb43;aB}*G+#Q2O77S_$VelV}dJip60#xvZBm|b<Ut#Yc2QZx|X?Xo6Qeh1h`pv
zlNNR8Fa0g)!QH^Ua;Ww)x_l^h3lLv2PiM|733EDvU5Xm*;V;cn-%+b6$YU1E0(Xm)
z6g6qqX{HP3dCWrM>A)p1zQ+p@89mPJK%)_uDONp{km|fzBLB|-ok-eS(ZMf@TE(m#
z&MVJ2V?u!VsEw@`LE30xLNJ<(n=@(ZO6!V*l%YL;JsKL^)Y`(qhlx!BG9wF(z-q0)
z5NeNSi773fZu9Gss-I-^uE`Al>gA{sNz-1L?U2(X5l^)nRSwJD?BC^VV6&?m%RS0n
zEfI<;n+K3RASlQAAssA!Y3U$XfFLP?pZB7Uj~64mwTlpStz6+ureNi<i^JvH(+epk
z09vW6Lkz`xt&*vhIxWaxgZa>m$r`dW;=Z3DcauFq4+u>ykd@~xEC!xB3sG&Or<p$#
zO(nVLDI-kdwvqU3|A@O8hvpv!loj+uSSSyq0a|MR$^O@M`eaIzcpt<*f=0VrWZRSu
z)d7y;w>g9gT7`o&e!8tGc{Vzpy{?!@X#gcc@-gjNv-K;m8c<)3EAf4$n?!&(BAA<;
zO-5;xxQf(tvtpDP&_OFGC#(6Td~=mYr;>&CbRyh{0&W?jc|?sYbc|A;Xc~(6YErQG
z3Y|-;m!ER;Uj!o3wv=y>2PqR?{5{0i``RA3Hl1NcCpi&rkumdf9$}<aQJlsy=z)tn
z(7XPqpftm9I?cFmiJS#8G7BNg`CCDqUK`N!zytx3(~>`75CJL`1IVa4P-slOtwP@L
z@Xc<Gz069>iRhkiyvWzwQAOpiotkZ4xih~cn@=t4mNHNfwP+3pwwG>)hfZ#VZ4xn}
zYQP{WYZ7;;-2u^HY^d*d7t~fxK8Wi;_#1gqhDX#vctU=xF>ulpJ}iMjcnox!#hrlb
zEtybNJjls&EHcI~cBGVT)2Nil{*^fo;>Bo~A|aKFZ0J$$TV~9s2Z^Evf!qCIw`>Z8
zyT25Nv5eSJ`b}b8_93X~RCawXC2}~2eM%qFa=B{wt%ObUB3yw?N_72L6mjXbn%`To
z3MsEO=4w|&%;NAML;HioBVlI)pfZ9Dr>w!ump&Q(DR=;0RFCoyRw}9HNhgZ_+Qj4!
zl<ZIgj3K{SO#uMfHsu*29JGoH3A;VZ4JxsX<jEAT&S}bBeuEzf>64)2=7W$$Ib%oc
z6ftw@R=(Ezu!-{Sf%LmIDC)HYybLqs0s}&bXM;}uUgcvU5~V=J)vAyaX|ls$dw6Do
zm2@JlLey7tb%z7+TQdb*-GU(5Y*L||F7cZnHUTVzpa>bCdhHVh15{0-Fnn)0T;zUw
z`qCnBQeK2(i=g))Iz@n7F~?;13vX$OY_0?Snc?GQ3np`){RX?qW$2tLGQ|$<JU7f?
zSdoQ}IBZ19su~gIdh4gm;+nolz^wzinP0|^``8$#)x~+YBqPuF09H#w79Xs~HFP|R
zOkEiyNMA~`o0!J6Z$iHqbiADG^kAo2tK9K@cY@)&?2Wc+*-<xj3|lFl0Hk<ME0z-p
zL>!I5^Rw5%iVDS>x+(3baY0>=5~P|*i7&oM&_lp%v_!^VetX5|4`9S~f6NVR%42SN
zu_r+=unZ_Ln+S=u#B)D5_>}PxmpWt<F-A)o{^5!8#R|$l@p#WmTDLlMb1H_DS8VoF
zrGy%S^Rp((<g@H5!ihL7XYK+nxRR0P>oiK7eFxa5+P51N1GCJfu$G6mAMhKpEZaPv
za|~9Twb(52is{+qa1L1f(-A(K3mMP)_Z+}es6NgiOXhi~l7U=d$D0+OA^5O>pU!rb
zJIgBF9B%om#CMmzar+Qc(>;Y4(?bi=@XdQ8iQRQt2oXwB+bhDI+9--YHxr6<qQ-78
z&5_zEpN7h0;Vspnfm&BdOjyfErN@}uP&3JOy{OP6LKV||VZYo__|Wi@aH|XLb*FT=
z6D@b4Gk1dm{eZOfQylgUSTdGW3(d|OY9+okgGF?)`QK0v38X((_ssNrf-^=FA*V4;
z!DvdPE4UG^*KI=}PY2SMEN{w})1>_uaXD0ASs@XJp-c;lAHk0dou*kg!t3SSc0vE%
zfSkPd=|d+E-wD+=lIqZ<z!_CYcXW1_VB%fxBzcMRpj;nlf%{yP0F_q`nQ>uW*kLa*
ze>x@gN$9=`<KJ(r&9BEALD;e+G?OS0W=Us!O)-`5bk6cC4zcrKe6nVed?+`Wa+MWL
zl?eRguFzCR-$VPG_f1`C&_y^+(tK950Fot-Gq)pMX{<qXtdUf%o|fuDbh~{Trp$eG
z&yc5hylqIlZtV9=-h?pme&eM?df}IZUEEMmS)njO*BYJ?YtT=$NL|obOk2;K|6h;H
zZ-M4)^<dNXgyC9jV#rFggMi0rEOgLytzT<ffz+%_+|JeZ8iQaBY1uf`1NSH+Yer8$
zYsqwm?3~{Qv>FwNyLR1hvAWdj7Xpzq;N*u;5eG4YVt4%PD2FRhigIsl8g-n1q4$u=
z0ZzHHi#L%?yqrS*&V!L-)YhB2u26(mAD&*rE801&C9hUX4hP?E@mfA3s`>N<{1jh~
zVF%Yw^8SOPjABMKv6*sUXf&|@L+3B&R<d*ZDd3u!f@F2F2P<Xh1Bto)x3Mn+4Nhz{
zk^^&n>)ZXq0;Y+VQs4D3(hAN>`8Ls+8x+D1;LT;(icXgq30#+A5G4{(z|qyst{)Xx
zObR?*%K@STne3{;>tUMSudxu-$$`6y5!1|<K{e#@V#|>W-N)y<ZDg6|Q`FI|`KVpu
zccWab{WNQ)iJN|stF8Qec)$eL`LP#2=i>wipZ4D|(n~(^&%Zy#j&m>C`#<z^O!U)@
z;|2?|c(iuQJ+QD{|57ouY(Xxza|9!3YPc$_5?tnJl?&RMtqy~^63`Yoso5Z0GB&WH
zU9ZoXXY$<;VTv2*PARp*pGM^siK>+)`$s|c@Rq*Q8?axs9n3f7j!cQCbWBP|rP(r+
zS|h6-qppxFwRB+N$lf+DH(r9Vb39*U&R6_Hw#U<>&L7eB3U1#P@D6!R+Q2-Ou~;}y
z|L}z#zR3aH5TYx_o(tRHA$Ri@uVy+YgVuXMo0Uu>bNmyVw=_UaP=Gw~CEP<@6c&{B
zDM|dL!G{9IO!L>F&X~M|HQWNS9oskA2n;^3zV#F%DqUT4pwISLR+1X-U~JIca!wd;
z8r%tP!tswh%mhe)-FLO&v^y2x6g0VzH)ncNCoE|$<Z_y$hYI@(p~F?^aUB{{gHSoE
z1=QTjOGH2TNlUxNv!jkL20wIUQvfR+jd-RNy(J=Nc<od(F`zkQs&UU$d3R6WXsfSd
z-B%sjmuLg9!+>~GAjpQ5?oVD5*%^B+7B$jq?2iF@j1t^{T;S)|@%KPq*vDLI#?iZ8
zl<DO0WT2HmG^&d3%>EsAe*nw7ZYkRsBG_Y(1NUi9XvsD~7ql`3O|k}N9<K3Gv?WP$
zTm#h-h+>{Y-y>W$K&{#9R?=G$bWcz{iew|ZVItAjc2V}z8ryvc3xO5ktQMa8Z(5SD
zWGVbXz)|Ia6`Wj9B!5Nl#oVOTOc)$)Inbp{S)lUO34L`Gy4f-KCApj!hZ`L0Y+4XR
zbNn67kN)p-vTg^1y0WGoH*TKbMfi?_D&=NY1x09IR};~OMqg9s{DnJiAko#+fPZmf
zaOfh2ksbNrH_)mpph{4T2)m!Gvf!ATA<XO3Gv7^@t`OVoaCek(^g}~IYe8I5lU?4I
z`*-7LtY=0!<vYBnph`Q8ACYN_Cz4AHUO~Fzz^mmixTjT~`FM!Scy<aGTh?kZK?NjJ
zfL(86OTA<r!1LN)sP76vUAdr~u(x9m-45w&+OmQ?TyReC%ZKb%?cXQI&SC)W_sN-C
z*3uHd2}1Yk$>^QlIcXGAg-+$@V++Nyp}waZnX$KY5lH_YT=z8ffiM@Ivu89O?!%pD
z9qXtj#!%cQsTspD?ywF&CLhS7fs*-5a1PSjjDR!I*_0T)!dMJhjcnWchcA{<0etXY
zU5@~|gU;|Ig1Z#b3yA>!CBq2*85Phqrqm|fYqsT9G;$`IW=>vC3GWC(sRT{rI<ocs
zmm$`Tf21op`1cUUcFXBcGUt4N+-(>`t$cveI|dy|m)%72hvLe1VSoJ(6H0^TD?$H3
z{`e{2C#P%#ob*wcM<T#SG3{l3<lbjgaS^O@1(vN?pQPb9W`vIC`@*dXP}(&<@aycT
zOH?9{Y9YIve+$W)n-bG9M)FpPK_+F*n1t6%k6SINWzRBWc}Q59v<pPyBG2{<f!!e@
z9fqhXn>;DQoR!es6}sJ*y&T!ligDCO+FhMA`wAwX4S@GY1S?BJ(`Biqmd7rBvO}yY
z-y*O7rjSD^fDlrp#Dh3`d)V1bw!k&g$NMCkyK>>;gz6o7UxDbY@lcEw5b95%0-3zh
zh}Hj<gfELDQ2xK#FSc1skG~5OKHKWzlVT-^ED5LoLhPz5KnNNYHx~*A^M={CF~8ba
zg@y_GtR?T_uZmVvX4>z(5~MA;AK#;+fE=xHUW{ETI{pRdDd3&4*SaBWaVzJJSsA6W
z30OXmx@LM*+Jz=2_3Duflr-@~2MZey_@4r`X++17qNP92tmy(T?eU5(-0k?y_eqs1
zR`+4mCAkKrYrvSoZ~J=?0g5_(YzappYD{qiw1+MO4aXg&M^BbtoxB16Vw2LEB}@OB
zC??4{jLw=)p9{`s4o*>9Qk^*$rKh1B$%{nTp7Z$geJ5H0Bz{^DKohOA#dQjSgV2Uy
zp|~IvY(c)U3vV@EDIp*z3guK8=5YLnN|Eo8g|7?D6a`(&p?}={QZz8U-h}NWc(8e?
z?>&cjAePz@kBjz{gF_^k`(?OqeIYSQB04a@=<z1RFIq$pbI2ch;#YTL1a1m%E&+=1
z3VTOa3-b3kaSH4^|N9pZO=EQ|#Z5MxJwa|HIKn#Sf9r`drzi94brQforgH9ZLoke9
z*=kz_`a2s=y2is0wgZC@!d<(Fzhbz6^4&i#avIWBA<M+u>;sEihUu+4OGQO{Jz%O5
znb+^{fd6RN!@p3B>Y`|e-mgE8xOdKc859;wX;fthW-X_0SabyoO-S@`kCB8zypb}k
z#Um(&T>x0CFt{RC^VQSdT@89{Ls<el@-?HZo?+tmCfuwyWjL&$*_HYJi<Aw#M*kZ!
zo;HLs`OP_gHB!R$-)qZqsNF5LkSF@dRs`?f<sT^X@B(+9&z^A0HpG6h3U6sff_r@a
zuX)CIof8(_rf}YA{GANCxeze@IWep_GiB*TYn&6kvn;+;I&i6aKj&_RxejTp@$(P-
zs1N3D5(c#aDxp_kJywXOtd|fpW1s@tsyzQukz=YN_uk_p$XHnc=l9o!_M<$ihGZMF
z3^@D=d+QDDogGkW{T{3#fh;N?1Ss9HENyycC69_TlP*e?{u}!^?-a*a`>g~{uvDt?
z8VPErs>qmnGXA#qHVi`dT{P|7a1Kw)ejcRs+qM~ahGur+M9}L+XEk5^A*67+v{tYG
z-TC;R^Y>O4@utA^?Pdr1!-m6p*KQ%89#8v)BGA6>Wz|&n{56FtC@v)PE4<PxpD#ae
zSrRwA$DqkehXA3h!umMJ;(ZCtYn0(E2HXkil344(^yA${E!x(~Cldd3kMkL1n@ers
z{e1-+9?{)QRb_i{w}1D0wHy*C(HYNQuMl9(UVrZ)yrR!OSPyY8pk@cWZFPZ*XE>I$
zzx-kLaSE+ozjC8n9=QUQgO>+xJ!HS<p_${nTllSB(RRdv!$vRRO;j37Y)3-yI@z>9
zH@)%qypLfcps|>c<c#S(X-PX{n?am=?MU-Nw{K0N#ue-lnwI&@u(*N6vllA>nht1T
zuKZ=RIAiUQ-K42q68gNRf6kh^G;z{>f$5gEAF<-Dp<PtT;OQd)6bTi*#o1sV$}90H
z-k-<6WkSd+WP6yPm>xjr2bJkAf@&O`Iwu$oWFH-S@+^@uXYEPFKCf8b^xgO57k9EA
zXa~P#JlSh_bc%aPv;P9O9QD0(|NU!;$GOgUisj(I8CQ{W!{P@YwG1*J&wHa**o?y*
zKSE5aGN@vaKGpRaIw|9rM+h1|o)%Rc3iPLsw<goC@dKHzpIvE_7p@;92AyJ;9KJ8y
z#Ntndg_J>=%tX>00X%H%z(LLYbD@vRrjadx(~ff8s%Oq!3XS4^7J|Or$`i~C!FuDt
z^zh4bN`a%g`I~N>Dz)iEU!~!+LkitVM29RTIH)$xwoi1oq&j?w-30BQc(!e{J?6b5
zu(+<frLN;PAgnFAXQUty1gMRyZW-$*%eZpJ;TWj0Hr9x+pWNuPT?A(4Wr#y1nQ7&~
zY_yd$0?SKg*OPau)}5rwB#{HnFQ+TNk$%}u5_T^NXC%*8?Pne~FD~Jdlz#UGChH2)
zcjyC6-+*?XT7oy<XbaR7@Q0k=sY*>gNT$CU{XhiI;|Nj|J=9lvHP3IDaY1pdCA;10
zY}-P2uCK4R81N#<VF)11{YR}5va5i*J6uNg_%1dftYG75tfi!+W!yvX4xG&TYU3UF
z?XjgrF2^d#QRlOtXCGyZ^a(8uWJq<g1N1n7PofzXZw`>(4?_M_Dl5y<+SqdRkI%;?
zTf~7)gMCuk`QF%hw0A7%1FT(PwtZ<)pZEod)&e@=e$~AO=fwo_PX&111i<rbHZjXa
z@-nP?*A>20m0*z`^&BU8BQZSWbLYX-Xn}5cK46#$&DxDmtO7i##SBAanrPf7pgyyp
zir8+sD3k2E_9b1iWY-y&rGB&9<N;;fm%GFZ4E{fk=&%ySC9)csx+uex(6G@Pa1^`v
zd}sxboTd$o7&FhH{SkvoPQ!*iHk^=jyDNbmWcs9WJE5F-8;j~<5+e6@Y7YizsHKEb
zdz6>`y$`R#&%WI$TdTD!DQ8EaT(WAY{J8@sN7yK`eA8|+n(jL{<0OZvihgfFXH#BD
z7be$EgiciR4YO`7_Z6jnQr3sHHmdPCtTM?)-f_IuquwJmW0n~rj(1bvo%Z2Y!aiyF
zWf91>IwfhF7|G+y9n;@18+uB3je*v7&7e}y3_;l8H#c%xaD&rJK4ZBGvyH6B^-KTU
zf3{@E{byA2<IZ8xsOC9X4<NOFz^|EJuxS7A*eslRo32*l1Twq!Rd9+lxm%T)4|lu=
z?PvtEQlw@2k&Qb~v6d-Uj#|268s9p}Kns&uw=lq&zArn`VfIT+Q^6A_WI-pWZ%Ht`
zYydpNelKy*nK<uq81NDF@7VJ@{fqTK4ntkg_fSK{B8Wa6%U-xN2i>p$mB<peEcS8c
z1W=cM2SgyT^Z_{LLJ3@jL!Amjx|6GsyOi@$^P-kPV|b0e!05KJME|YV>W7UAb|Cmf
zCzKuV-E4J-RKQT60ReRMBH@3=N&|jgB*z$Ao$mJR^GD}EL<GZroQOORcU7|JZ&C0{
zxh8pfNfGumpK+l?t)-DF6fjCNWFa~J$+||GKC%~oc>@jU1kDD`vWjbckm7is;Dn91
z$6hmh%`JaWG~tq#wSp6pBNYxTFv+=pm}61`6Lc!f^xbckAm0eqn45;(z>G9aqEUL#
zJDYop|Ji#`XqJhvZOi<@XK;#?2SdC={q;ZdBm7y@^1-zyxgTq_!0ah>SX&P^+;qFf
zU=JE@lfEoRYtrkH)(4+1COa#eL>qP6Qf3vQ$4L){$k@i!qQ3v=5^sRjsM2lPdf3bV
z_vj-rv7}KnC8b`_fJRw?$C6e!GQ?#r>K!oPu~3Rbd5^M@v@Y9z0Yk~pZ_oOX8(o=3
zCIyU5$kA6*Y(*#C%ZQWu6fNvUYKDR&jZ9H$(qdt^D7;PzqwRz5?El{ks$*mD+|qT_
z>@c-PhOB7mbaOb`lF#+4n<T{9L)$S|(2;dY)Zzw4N-=<|?jh1!%fac#@0meb1{aM>
z2?~t`<CicZgUeYnY+`usc2kAa`c5l5w}EP?7#|kQseWr<2#K5_#v&NeGU69!Q)+Y)
z7wGU#l$hokm`G_eq9)RVe)!_^++=T2rGHd~ow{Htk}>ILEoaUdzU0@b>UuElcg;$C
zTtp`T!e8itWmTMy1|R)V=1cQ2r^&sU{4Wl+hsI0e+@kf)x~kX!Nz8h2dxsD>zhk&U
z&p<{(qJ67fJ<WF)nBHebY}z2xLzXA2QJ$e2R%>=q1VKkBkb9f)ppN&lV9it;JSx!Z
zZ3nm_fTMjiKqS!M0Z#$Tk%WB^w;QFR4~+`S@0o@Y!~0`WipPIaLRh>_Q9oKdOzcab
znCZ3i(^7^!XovKlNSOS|GM4&XhrtOMB>vQMw7cJH!hC>tpalkMV;o1*Y2~Dw5zvX(
zD<%+WK>QBiGU>2Ssp693!(!j+LN;z}TEJ`tYF40D)P|gDJE69%BQKx!I3;Wav1t%p
z36#m7>5#mPT2Hi(%fx##Vi{Q`+O+YjH^OS<<0exow71NjmCk+B6Geq%omJdh;L(VM
zIMF;Ug5xYSMfFRwFu(^xP}B;Jo~IDQa(WLsO0|4Wes9K5vrUD&j^)uh7&==Co0mAm
zA-Ng0UA#n#NbYvt-hYr~IP(3-<6=P@I^1lpM6$Xnfd+({{MBrNF@U=<R?!{$$GVH)
zevg!;ZnVV}=u!%BNI(6+{`n{TN7IDl#LnKT?m}#NN!b#Nh3`CZ{$b_f4bo=-n6#pX
zhm$psJ;cvW!3b1A7}!MPnDRV6n%mB3Te+w&nKt1@)XD<2t28VHnW}7*1$WZVs`gmL
zB(GxF7OcU}&aW|3(lY9%e!Rux&D{PO0^}$@M@@W9yHlM?M-*`KG#b9W2XUdac=p>k
ze)(gmDutHm47+`4RIWfZZWU4MyXQNG9r1Z1kBNA`=^V=e{y!FNlP9<`p)vFTu5Z9$
zR#hd{WHW{Xqi|OY7%<9p<n<=b?4w@3j1YRdDM}e#swFyJ<v<7BD7E2(_sCI!5q*%=
z`BQ0SMkA=v@W%(dhl;Ogn!@$ezdCV3><!sHAq0l9T`YHQ;;m1r-evm2Mh!=9aoW5m
zLRz(w7H=diB|9JPb~h`LvdiO@)TxuEvB@1ZTzfj7YaU=+xi|8TvOT;^42~(}w4DRj
zdUV>Z_8tOw6c$N>MPnlI&{UMaL27#7*=sQyM#ic2kWw1oPKyMktNg>H1h=Q^;fRLG
zT4=Mg-REiVnj~v8_J=c>bl?(pe8JXP?4W8-rL>YmTD)&Xm$7=x>2_qd&4PQW0;5u5
z_yr~{bQdq)IK=f{d2uqViJS#nVPaKWZbbBWE$vo*c%)70ooCq4FsFR4e}G4OcIHA*
zKvdGfcp=Fe=<EKqMSwL$vImZ9!r}ceCfjuLoVm0g(>-?=mo~;b+xOjIfTL+H;pspd
z>&E|bE%BBtGWoQi(Y9bMkH1yLu6wv`>6&VqO?z)77S=p1Xe9qp=^*7vl~wNz#=yI5
z^>3)XWAj=5{^P%O=!A_wFHSjEsZ71C)SS<1o&aQsw&-I9J25Qa&y&(LP6-sIW#Sod
zIoIgDW=H44%fg9c@sQk+Rvx<(F({DopuviBSf$b?H1_9I{49WW9k?#Y0M)zRYM*d{
zuk(7t;D!I`b(HmV_3Tdc50$#qrES}ETkS7eNRizAwMMU%c5zr7CO5KH%N}Hv^>)&U
zJs8f7>-LV{W59Nv$aoy!Z*89(aeyYYY}~;Hr*^=sQ_Ui7XG;!jm0nO%|5IG_;Ey)0
z2d?2EU;j4@RoaiuadjcmWPl^#!u{_;AVI_DU=~zA&jJns=F-Te7pIQ`y2>ux4Ovm>
zp`}A2KkK&g2GRTp>lHWZe#uLgngp`f$Em2pnUY~q<~f)$g!?`hCx6FAqxu~hUuYL%
zZA$ak(Mwh3q;a=u!Ztcobu6&sH?Rmja(}V7ejiNjmAmBPjW|c8Zx+T<pqH-tthL>b
z+d<w?BM{)g<JunE>wZ=>Cl!rg8UR^}ci9irVrx&yJ{%pZTU+`#{*brVsM=!9_)lv+
zaLxw^sqvIIdg_FPhWkY1t7j82Zq8bmq>*D)%=V-8@??fv3l{dj!U!;prJGS=*RHDn
zt%h04ND8mP;Lq&LK|8AA=UEgtk>$7y_z9ewuiBmU@O*148k1Ud2xQvp&B~b{i7&aS
zn+^i8f7TC#<Rq`|+wj0}<z+DLqaqjq)IEdb<XW^xjQNi5D^oJ(kQtqXzmk#?FP*IP
z%T6_MEu#x`(amxig4Z4;kN8C|p7SHouTzL=@j79wu2TmlF&IdWO<pDPkHA1efo0dI
zg;9>PPH)0ZCF$R1LvDzqc^5a=X3XolFfM&~wZC8GgS*|cY?~D8##F`5P8cYF&JbI9
z2DU;`Ej`GaO=C1g7lS1owU1lK6LqqI71uRnZwTg^x3%Vin$@-+uS@8JqEUe1NASaA
zMW*zIT1`$YlrjC0C<^l9EFo^;4Sq=Rh1z9@KNepER*>WE^aKzk(X@kSsi90d^RE0L
zRgJgy*1U3;?6qV1@IlyL{FP@J7Yh-(Zn(C?Oe>zdtN*pnGis`bo3!bbd89kiD0l4s
zu2!Orm9ZY{$r1s)rC&cHO>Qv3Ew^{MZshbZVmL*#yI*Iqiq!{)q>p~+g$nS}N^ofW
z4n+iK@)k>~x=Eq&f$xxao_Pu(8k$Maq}p^rQu%PLBQwLcGk6who888U$2jN#Kayl2
zcIm|Q#JC{mh|#i%h?^M$S;$8Xu~O*W@xvn}!tS`EXvfgd$m~E!pfAR<^`+cJIw`o#
zTIz*pTaoB)i>y6pp->3GBZR<)D~_g!&Q3;0&B;61hj|foxIj+HS$%AX;t8<Pi>YIN
zyBk}n>yHwyNtXby*!tGAmEVKU=2XC+TRG}vv3&PM3aJavho>u{*BAC=usJg%;7G7#
zu_FRgYSMLOjifpla1}bV1_;#r9j_#nK&VV~+`P_E%9(W&0Ctq{2!B>4Un$PYJw}*&
zX1n8f?A~`NRaEirki2Dd-zf_NfK&`#_kK9AtC=QboWnFYVV-Be8F<3mXN}L<POSd<
zo|zon93s*u;{vEDG*zZu@SRt)K%U^G>uv5`c?;7AsQ|$>{zW$v8y?Gl;(#TXQR7+@
z$-~bBG!^;$P@9bvYRSt(K*)0PVMVx&(v3K(Nto7-E)L*cDhu)G6$vPSh;y9_OsSIV
zOww%hh2X;q+qAof_0(sxO6a1Ybln`Elh7e57g;BdE?^`?FD*{3heGFHub<6APC&6u
z?h8|1&^JiGl)qLNTLMm^W|vw8xPE2EY4{lgK_X&hK9(d2VzKa_$y$+@$MEQO`1hw9
z5fpCFSLF|sr<Z`%y`Q0bl4TDSyvDRM><M&(Ny1)gUoSx>h8BoeH6X-4_Kq*`NB1Sx
zlo|o843o*A&wt~=A`9EFNW((;2t-dQXzfW@K3R*#avQHsmUPVP!|_<@1}5jf>^p@_
zHUJ)OSRxB`s+PP2-L3A39*?{2Fx;f`mW^vNx>`?yLzOy2cyO8d)XwZU00(BpYzp$k
z-n3L7%6~S<cn;GqJr{pT#639^E-hSPv+O<}q!u<F2}{iA9#nJ)&4{!Y9Oz1==5Nrn
z;_!Q5$HGty<FRlPwXeDg)flL(X~WCmTAd_YJU*&p4zr#AFVZ&q|I-r3#PGjfI3@x{
z77hmH|2_WSq-{o4HfHw!@x=ZAN!vBe#vUcMX=FHCa#X4t4YsN_Tc@$MTdlec)UCE#
zVk2_BUb}Bsx13(5YchZ9U+rnLA<i{X$qITAYW?f0^CHWuqY<eIv4PO}h2>=S2BxM4
zFwH5YDGp5aK;NoOg9(XHoaq=GfVQ^(V6$b~0j$VI0Su9e0g#ac5|WaTV^Ii9tj}%%
zSeV^`6uw9Di%UyC=x6xp0EFNE>c3-LKr%M~#((|V(=|3WHM7<^e*R-@!>KSa0&-+z
z0muZZkpU2Ldcs0#G6IC8S3?O*504HX*#9@yLe&I_16bzAhesFwAsJX*0n~rC0WdVS
zFoOLqWfJe`(*TMG0QN7;4nw@NPY=(G58vV=!}iY(4`7|2zrSGvxPYW{V*GbqPGAx(
zfQ7NiiOsh>p#Mv0>mSwl?7(YX*o*#_K7*&WIJr16czzD@e}rvM!v+7f3lqEjXL&pE
zeSPNs)#tjhhMI&Ye%ha@*Z&CHD-!?~M-UE7j?SOtX$6q|80Qw|ru)C_Z~6?};QM`(
z4sIZu=|AeAECArh%)sEr)X3sveGL8$e;Kp>FOcv0o$U2ZO-_I6%{P7BzfEBINktJU
zl(;y=OMBU3a{kU)fVTVRf10R}*vi@f#6x{AqqA;*hR%$R?`r`RzZ;m7eWDl`Tbmjk
zz|pcY2j`}?IlrYK3g3GTGH?9ikN*V({)j>T;^x2p#BTl1&iy$L|JJ;J@8%0<)zlin
zR>}ULfWF7Df#boxpT+@Ve%alDt@Bg9{wVkRyel)lyQD;sna!zz!~X1k*}DT`HuS|T
zI4?B*YCyRnfp%n~PXgt{P63pGtNNNg)AUA0*M|q7EQ}x1mi%Lo1*XRP@AqsbPX&mj
zv;0HnKJAktVjleI|LA4^sB-mmloTXHazFnw@BW>T|E2kpo4Ru&_y6UI$d0bQ^N0Ko
zWqSu8w>kP620+UUY_-q)?d_gJ6Qk!39`g@$_+7s-Ixq=%9yWhOV649%;{EFnzwa;6
z<rh0TJSL&$fgii**u=p2+kN6!`5|s&d}H8%zU{B`t55bX?7PmDozan*F-Tjtk@XO+
zQDREQy>et0Hxps?^2!hdAFB0hC0|EnU)^@=CJU`~NVDKi4_Ri7W8`Jyve(1x&5=OT
zm18m3RCG7T$SEc6PF7|^JD^i?bym(7L!j;pn(;@6cJj$f&<k5ADMs+c!CgpDvF#Z5
z@=Jxg33&PixdgvKIuIXhq6jxJPSMJj#tdAF7(&bTV1rZhaAJx0qyPMV-rx<^<Zgid
zGFwAK$qv{i@0fXzgxuXX><g?&eq0^h?Thk#jc%Less3$Ts)CsoK05%r#C8`A@p8<M
zF@(R6lrjgA_6*XhlIae;MhweC#ac<?xqtHe$C1FjQ`xFyJYEZY1ZLv&rzb+cy@n;$
z!3*u=P52$>9yc&(*nphY^&0r~zH|<;M<9im$`HV(_fwcWS%`>;W3(r9s3&TFu9l)!
z#mHQ|dke{gzrFl4k|YwrF(}M)6L)HmzKzJv9Hc(S@QRnP8eE+<Wr&dH^TpT<VJhnp
znM`{QWv;cJpIyU`3o1<VlY+4GdkLmDv#f?+5rZDux}dS?#ZVVE6s=EIIWh3Urxw23
zmeab!b}fG733a0I^Elz50!lm>@B1~$z7)XHqD<JmY=rGUI&j0F3T&s8aWEYA&M`5}
zP_1N!Hv4cCRD7NYTGYmHjq7g>j?+1{c1t#LY^;I2Dr1k`<F4Y%xNr%VDvD(iEYI?t
zh^`EL6KcC@xr*TPrC4Bb@*3tcG1KmK(n=ZQ)zb{TwNIe(!C6)2)6E;N?+&4*uhYKA
zOG2rWprWjQakL6y9AHJ8tD(ElYg+bl=*7m%f8G8$k_Ryk^GtotcfuBEpeKn1C9LG<
zE(_qzYx7aZ7&Kl!uXW0L^Y%!|0#9Z{w;&MMXC!S051|sv4Ehrt-A2u8?htxDJY$Mw
zh|jil%esaQ>zGexfI2Zs&jA#Cr7z)fsq@`2J=oKW+Ebm>3AeF^sh^oy1?MPCi(hN~
z3BYaI{#=DfYr$qoz`m0?lnwbwq!HESR<vK!!L!pc;UVW@-E3LegQ8tmR;Az&9Wlsq
z43-r-JSUiER;z<EQLR{@Qf~8u$H~POC2Bfwf?Q2)^uRAbMJuK7@5F?h)k0t&*l`(L
z8LJo>(V9B*Bn0KH0BWYhZwd*e1I0BWt`D0n6<V%;&F)(X4y5U3X0gk;oi`8c?>mF~
z@ri~KXf<d2%U`af)N9qLg;@J<--#bud}o5lOzuv>d$o&a+3sm~>Xr5oIhccmNw_-k
z`ho<4Q;#+vUT3}WDeiB&$#}~B>~saXMQ?bNE55=u7FAE_R|F&6Rb&!)$Aqz4_-6ly
zuzT#$MS+$CyxX>I+qT{Pwr$(CZQHhO+qUh!+dU_fOfnyCa(~8Jsi%qzn6<c4V|!j>
z=H~&hej$EBh6A&w<Sf})AvG2MaXRE0o7My8)=VL>%p7lI-R>iRu9x2quqm1JK~Bc?
zY-a2?`*qvT-NK$lQg4e+fmk;jpi0cC*fT>b@ky;y*v>Jr%eo8+H!-3)sHW%E(^U{R
zRcg2=P{I#0?hY5lC1nXPv3b7qt?kv1>)l-wSt;rIr5aUea%cASrnn$}nO<-=KqjiY
zHm@qohX|alCEb@j`+GQXC^J>Y?g<vitTpCy6#eO(+4yVPuz%v0IWu)HATkB7%evqe
z9QoPPP81~l^APwiH2c=8QK)m9L-OCATonaw#BQcQtwn}!i6g|{FF%<yD?9DcVbUtn
zdN7<S^k!^Opf+H%R|yrCP+k-P)wJd$uuyoXiwQWAs8z>RJN2M~qy)#~#;iVUZM63h
zhiH!+jbRBFeK@Y#Tnt;iP6gO9W|{{C-Fm=bg{zQ1a=Zu?&88drgWzcKOr)YJzf-@=
zRRGlB!)_iPKkri63r<wK7_D+PScs?5zb*CnQ=uBK2yqhj#K_o2m=HLM<xNn)5;O5H
zK>qVCH4m!{f4En53ZU^xnZ$@_2D+Pog9geIIkurKPnx70I9%#6t_Gs+qbPDnsXuLJ
z!Kfx@G%YHWTAYFnW!9^jwNNVELX#eZzK*_5yUEVnn<hQ$#RYJx^Lv3`g;MEegi4tr
zK_?jHWHgFx+kV2uUX*`3aj$4*^uigs6<hc!8?Aonq|5K^RSx^14|*EHao9RdR_X$^
z@+j93Z?G4*;7Wl@Ay1hScz14%eexN?{=BhF6DhxC8pRX0QvPR&tFvO0Mfh2Ei=Q(S
z3u`!X!iWf0GgNGTln~xv$@Q6&^@+L<c{v3+B03>_^0GXHngp6WsRU3OZ<vgp!vWlE
z3{KNgdvhPEXuesY2d{&s+krUFv(rcWIL_q={j!%;k1#k%u25^}`cmkEMAxmQs>VsT
z4VT;D`(kFtc-(n-fLO<dqGUIFHJ}GL-vEfU$}DEwXr%rw(n%A;$j>=Lf-dh>6lTWX
zNyqer(D*k&?lAbbztX^_cF`d_UbUHIH4b7Tj%ZYkp`y2%yZ0y=-0Mx!v`?l@9KuCh
zb}6Si_88+VfRfnL*{W{Y6DW+Aq=ST8m}1vm4ho-tXXy8`*t}j1NZ%`ED4Spw08-ei
z_mOmFM^3E197w0IMxHSm>=dcH-Yzx$KMFGb#JNeLs1I3Di`#ca{Ps<(EoC2^+kP>E
zf*1mM5vnjmBu(a__lWsF1NxK+_=)zboi(O_<DP-#eE$&o7M)mK5}EV9r1$t8w|$`%
z<+ovHU~K#sGI6-4e0VqXVph4_wjcIh4zTXyOojb8ylUN~@d!K@1Y`5y2a2?X-+<GH
zD?$DXq)BwERtTS0S!$_QI+|38*uL?GD&ECvXl%7`^*HdgD8O|?n@X=8hAk*7Hog4$
zA98ptL8f+>jmhlZAdVx3vu5E^d%KG$^BaHMQhY3P)wpRO#}K(pzNQm%EM?3MXg$GF
zm7>00QnN?fBC?^zI^Hql(pml_1J+UJt>kpLD}nEjzxEdM^OhB;R`o_9;O?WCasds~
z`R8pqtzuUD^<m1PRu!jU*7{6qE$^mbPLVZw!(RV~ysAaiW-5HZ8IZ%A(TUevji;Zw
znO6U0h;OHk42#{;@@-MNI02G<KGY*{whHccQ*6sh{dcN_<#8+)qN6=+FbZxdm#Rk&
zLIj+qDFpgi0k`<%lW4Fc-e#SM#0at(3mFuCQlm$t#<0qC=AWX>n{jf?DAo;_tCRFM
zPJLR1do@;Ty?s&kS@I4X`eE1X%OFtD54x021vk2%ngI@K1m91)axJ@6i#%ZeK9TtB
zCA<ZJboIew6cu`o-vIgrYkV$0WeLj#3i%fAn|9YZ1@@hGbVK@f9B(a%EFQH}M}xPJ
z4)@?A*h`!4XFbZ|g12*e_?E<MD|`-c7H*up;geNS3d3+#?xn4!l;%nG*S=adEUP7<
z(Q1o>yFEyeW<4vJTISBPN-|k^;o4?sbE2BX{Ls&mP5s*Paa3tQ*82YEl|#w#5F<7B
z{cWbVsg<%ewO+0J3-dZ3PsuV=Q=ZcY7@}>nHSUkdPX!5<{z%JGS-CU|#kJ5Lx~urG
zPf%b+lV3561Vg5(!s5c9{V7lw6MjAf7v$XZn{p|CmTt&(PI)M!5!q^VItZl~)69k^
zJUL9`PBDtA`T!$f%?v3ckm2eqo(K*F#*o9zl1(94Eq_zibKJ=jV8s!V8E^S`)TNq;
zib6RjjHn90LcbE-Q*3fUtTbbMtky+xN1_#1+H?fD(%s2#JJ~rnPPvAhuaFVqH1#Yq
ziWs>t*_xMWZ%IoV9Bn7=g3;VWC4k857IwM|my92BTB2`Nv!8lGAPO=KBu4Hxsp!#j
z*zKVeQeF)DbX|mqX{ucKXg(`Y3^ND6NKLq6QV}dJDWD4lh(nkDMJt#uVw?2}*rA<y
z7va#teKe=a5pZaP+B}Z~xM9wVbj#|W_Fw0ulQ)f``ps~l0`>j6Ond#X9D;@}m$7J)
zWqI^pTc8s2VXgOB1Vm1e-wP0xvcEmE1ww}2onv^;)-&Y5DtH^VS1#~2xj2QxQ42&D
zRP)w&Q&dWE=+o%@Bfo8SbEmQ$O6;qmw`-W2uPN3lFDk>soFVKv4^4ek2h?RtD-s)d
z84*uVDDXCZ00L6ehwB`u;)_re$2&WQIV}v~*Es&2(62!@LXz5Kjj0fTppHV&l&!mu
zcG9{$%^zt>Y2qH%6!d!e4=DpJ#p+OT&~N&-%9{&v&RSm!BH%>jkO$b?S75|54O!XO
z3w0Ew%a@#?717xoH!CReGrCp^iF37GldtUHZ|6B(wi}I4ym+RDs$k?)WgY-|QVRO8
zb7k4C!}BFk(B=kIXE8!`+{dq;dsOh_F;u8OSAgxy`a4jgh5t7#$1<w<k`hoYZMO!_
zvycb!&G`w_Mwad`eJU+lkLD>>-xJ68!k;tu6)lAJ9<F1@u5QMyTei?1(`)2oIQcF$
zCZm^oHDWkoE@;3qNJs?aWY^#yQ@cZS*<^vET_Z4tds__O<0-!rcpfD<wda=>X7@Ai
zK}`CC^QCrcekfR<L5;PEp-wACjse-3&6a7|Y5DD$CxF|A9z|lZ_2|%EnXI0(h5@~n
z3`=A&C9w#$$F?=!)Wu%mzDsN$PNbW-OVLlT(QI6<d26x^&5=7p9$e35e(<yNj$U%a
z5dsyJp>aRUSx;nBciW@t&@>8FkmB1mL@85>350Et?c0ZO)4Q-5N<z>oGDw6%I((UV
z7=We+!I5fR6hk32Rcxh8?bAGr0iNPs0vS<JdZ2|&^c2hlQ^PQ|Kc9Y;3qcF&zJM?C
z5>kpGaH``j)tf&LHKqn_WnkEX#+|IX!r7T}66Ud#eM@P^+OZl^SQ4q~u~VkdeoR@Z
za|fll*1YM3W)emtYV*ZkOP~5&196N2lVcrH7E<~|V@u(rW_Se-a#0GlfQ1zl5#YSG
zg3Gs53d3h}*>wI+zUpzy9ZakuD#&*Sa*oE^Burw>=+4z(d<F;guLB$Uaw0d_w~bqf
zmr|<L`I-8Y<w^<pp|#vL1`8b!hj*nx+a;<?D_kjXeR^^de%p;%ivBzZ6~qlz{7CdH
z@#gNy&lIL%NxFq<;)>q(k>Khdia%pE5=<lFfUeTF{y|aCRussU940zB+xY6$dI`xD
z(jW(NYAdP(PF9ESgPna~%OEuG|IAMl)GFaKz<b+++6;9rb8Yh);1&_sorOn{ML<1k
zkS3db$C`G$9Z#Qa$T5(=jf@UoA9K8HtnjQxj9`fT8OyAWf7FeG-!yYY1<?r2%0F93
zy`Au-2^BiN9Zymfm)_dqr0?fO@HcfOtZ6gu6P*BTGEqxu=Z^oE1idu;vTa(2oww1I
zu*G@n!z%6pWSQumIE}<Gg44bf%SD-BssUH-U~qe0*eafE_G=?Btt{1Oq8&X%>?eaf
zci#-#F3^r-0{x$RZrm~_EpAU(ILPrGtv+?80YlXV9~){k`Udx*q6i&(`Ht&~U#i^X
zCC2s~96?{iXUoF;8e3aW3{x3io|oG3HA9riz(1waQ-)ElwT1+b!-vH`m;drb;bT78
z{sh%$jEh)bH1Dn|%5sgiA!J%g!=&OvrCKooYq$a5&_9z{pKu!DQmx(7!t#?>zvFIA
zH9k@<+qr?MU-O((Q)p3v`V>}w!1v#t7-Paea$<B{q8sLb$$WN55!hsQnchugzxxvL
z1p%Gt_CBcSI^5@D|C7hTQae<u0-svf!Z+$!f5g%Lw~Htg;ZZP3YF0DH!c<jTsJPOP
zx3P^wNVg&H%gNHyI<_vr(0l6Fi}ozMb{lw(R?tbE15fPo=-}&4TG_2}lc<{l4LD6V
z`6UGD<1N|P1qs)%lyj1~yLk&^SwIp-2AE3>zByZP`7hM-V*P_7EA*}*)FM&;OC+jq
zcZi(s&t}xiq^Kr$zugCbSycWZ|3DlO8C;xM6)+I-G?$(hqM<5+Qa6+JjHY`-N@HD5
z)*VS(89XY5o@}KrOBby#uqjuht*%g|)WZCML!D|`KyL5Wtr_6Epq-ViVF@A8!Jc^X
z4XdKun+QJvug+OYwG<lP18;tiKcRn*J4-5)r(unQH{yU1npb4)dG4;#pn?n+6c-}{
zdYp$04w@vti2wot(WWg}qGdgPvqT0Pj?a<fav^r4fKE42Ytqy~>yey_oJXD8#nWhZ
z+l`gPpj`u=O(Qku>=7T}6!20$Rx<jj`7q783|rgKfJ{?HzJ7BisGJi*xW)xhk9-Y=
z(nRvh#YOcsDv7i#?^m5-7A0zO0<^+1vIztehNMEiw)NudD4vE;a7>iPqj7+svu{&C
zbw>mWDPpGc06s6KEUaGZFs<?{=r1wnGaoSasErdi$5p{|h{jHh{~$X!2CdigD`Hx6
zz<fH2X(Yb4<oH70SsnlielEk>m5SdykA)>~gkd^7Wp9uA8Ut4m*z_hrOj8tE8C!sj
z!(aEZ)~dp3*tT4%QW@y|-G~6_xhLjIdzumHuF!%PlNOlFRo4BS;T*!O&9KRlTjS(Q
zU0E=CNn?;&W|J8KQK7qV$l;%n-I4SkMaCtlRm!zUzDxpyVu2U%re#J0s^aIKGB<6W
zdnH6b8d3s9l@#lwGoJ+<&t(DI-p7+!kxUPJD@PU?=!PMsEEYS|P^y97nUN%&S4)mZ
zne*gj_iIcP(>e>Qy4u4jw&eXxnsl~b4t8GA_%<{v{LO2Q{GFEW4IVA44Nagxljd4h
zYY#K6s=U=CO_l0T#A34-%EBx({b4yq8J(QZsE?H|5x-DWtWVR;o-p!qVw!rwboz)U
zq$g(;z7C|TgL>}bTQi^@AUY7i6(`t}>;?MXbQ@g1lN7c-n^*(41_m;o|4mjyVS>V;
z3pM!QqN(W3DrHNXABz2VHJdyW354@OI_JnM3}@tPmOjuuhe_^5TWx-pB;8r=0u<|8
z&R|6$PsmW;WwjMXzRwCYPamqLtr}B`GM(||fM7}e6y`g|oGvBkjrOpc!*GY=Lkge!
zgSayFS-A>ecWa2j4qc}A7TT6laCe9ID|;>rr(8O&S@;7m-ogqpd&^WW!MEUO92FPX
z>v=GE4pgP7BcOe#-_Cp}khaR~OufzZ8V7%)bQho_CFe)Av&G`>r^FV>S+=Wws(z>;
zoIk_yyUR@}Yy69ny($L8gYCH>@D}fhZ~jYy2AY*>8(IofDb@BfH!+(jPV1G5xx;vM
zF~=g-xDvDcc%}QsNNqoQRHlp+9Az;#B(BSm%goA-Hj3s)D8nE9`^SiQ#&A3D+#((h
zL*Jeg2sOJclnzqskw^p*h!G8^ox}>6kvec5mfwDhWJLAaE0p!!zd6Bj7W35{rV&<l
zq;*WYHV8c)LFACF-XU`V;17QL_$VJ+&x!QwEKcvpyI!9Z*F9=Alv`u97v@cgL5Au4
zAlS@_|57V8xA}_<N4PS6V&IW;k3GlIoja^BewgrvYJ?wrdE&GGu8KCRpa5%NdDlUU
zGx28IQ7G^V=<pL0kY!cP5A}wtL@1r0u0ixH(?}rC*7!!&El6}C)(D-a=f-sdAqw2s
z{u9ys%nD8m3L1%TTgMA;O55BWSj-bLUTJ!+M5|Gk5_6y)9o5~(v>@J^j|cecro}la
zgd1}k%Fs#sd7#Y6sBS?cpaXKeV$8t^`flyqp5#mH40@;9O&R~Uqw1E4J-pwrmwC&s
zLS!~R<Hw0_$*9|qMJWfZiX{H{kxw`ULuqMV<#Io|u@eco%l<(5t<89GWlZh#X0ut3
zGf^5o@i82q6q-(sD1NK7jN$JXMPjIHN+T~>8ysFSJ&p;fzVSO0*}1B@mBAor!D(s3
z_-!<FaFh93geYequ*57*FC@bg{*jnCRrkDo$9@7M$7F@#c5ILtN3~{ApoYuGYvXwC
zV;j<fz!Q1R)&NM4C|5kPXg0AWv8H%-J)MXBVjr#F(~t2D9lJAi0n8TBTkgE(#DXhZ
z#7?kOQ;bDIuI_N#J|l749hPSv5b9G(+s(nhL@f8z#s<-)r0OX{N=H^)>b-8)5A(f1
zZazx9$h&#RWEo`sbo_qn(xMgW`Ol+`MnLpm3d)>m%92>lbx?8+#5ugXc8uN^SHBW-
zG^pCiX7+`*A>lOn#iJ*dR3~@D{wi<NBp4rPM}>RQVax|ySTUKMU>I4`qCcpsga6IK
zH(adE+gB<e@EMzzDc}Y0o3$sq-JxI)!wn6m^_n(4!&%f<df2J)eOu`j;w`>40~x>4
zpq68uJe;)!>b%4e9W^nfJW4dD2~;FFdNN0_8izYXc@SJrCb6r>j(5UFx3c|+)K@}l
z+OWPER(@J`OtY?XCMrEH_MF$SFuAblD)NMeiRwIdYyAV&JN<;~TyvXtKnI{UHr2rQ
zUVvD{w*O^S{QBvqhorM11q<^~nedOgER=$Np!`$;3vZ0Z{Mx7$Xf$LSmHEZeI*i8&
zp3zk|L|un6(?=poY9#pX<_J1vJg1&_K}%^wB%wKRXg=6#S@Dsfj}gzeQxi>S0o%T?
zLl9A*O1`9K1#z_38Sr{fgA2(3@lu>_hS#As+n$UspUStnH{xF_n=FfV%F3?qtEcOe
z`x>S&t(v@?4W!9lYhV*JL<m%HaQievS<mW1`l6#}fIi1|qbzN<Wc<!}2+Z3@s{ijk
z59JU4sPRGci#-BML}J?q2#m}Hiw<M+FY;QKidFJLPzdV|*!-E$2YsC^sxa%LDL+g0
zYymwSwkT=l)}RU4nhqDNE8P8Vcw5kZrLrHAWRFMCsaQ0{rAm7lxNaT_I1f|XLc)g+
zinzb0_UTrLT{)><-i*SrL$S~+wHx$w6ZiXrf)qJ4h8M{<iyI#1HI4S)L?}qO+S7e@
zhrn0K@L}W|2@VMhRXEo6{64WcXXa)s=b9YS-zTZCSJ2*C(g)ZCbVTasg(KHVgDpd|
z`s7*dj&~AF=?y##{4&t`NX-z6($&{Rr1xa5S?Bw}-I#QzE(RNhXV~h);0Z)Lrs4Ll
zGuAv@p~)H!E3LC+(yj0EtGuoP5+>1xPHq+xZx5eZ(~9F;0;=+_gdDe0BJ_%x<x~q7
zLvkJ+oB683YQxN<^M@V7+ljU+h>!J5M@$~lsQrBG-3$T6_4A!*M$K0LFCw12;N9RU
zrbcC6D4=D)pQV!J{$|v#v$@dd#xaAsDj=r*^Spi5Usmaei@1x(1C(9GOVu#Uc9k*v
z`mx2GIC$GJegfQQ=;P4CbteBn+t}XTDkUs7q%tz<kyWa0j;V18EWA%KTK$*rRqnak
z+V5ofC3j7JViI-W*(U(zj{YIvG|Gw-mv|4k!yXDv;A5ex>WWTV_SJxE^$!4px%*$9
z3*Qw>S}BpoOBc!u<NPP2(IJrV+gnNM<6c%`A(PKC>z<AqTP82M_ohdVF9ltYHT0s*
z6CXEv_U+5bH>SpHwSb;d3Ie0&j!`pX(>yYIkse<mb2Eb=i|r#ctURKV12sd)xXG@6
z9(_xjZG8yIn7|mu@9?uQ=u8W{x%~89JD{8>J+KJaHkZzvzd*j#hdCjGndVFKQYn-Y
z_ZoKP-`x8lw^GS!-7vpmbs=3)tFBFi_fC9m#a=G`BOaA=r2zTm&A}m$Rws$mK!u^S
zyM7Fig~1fv0XxTVHV0~V{F>}z2p^wIo=`4?ztQjkHVEWXux@5LH(OGhPpBWLavT67
zR&qDTq}J~{zBdTDp4#OYW3gAGbnhvlz~}OIhQ*x^qS&I2s1N+;0!FQ%9&OHE6RE%}
zXF<NcqCM5Ft}l|Ucio{bdOQxyl*NS!f58|s$adUqg}tZ6R_(@6bL}N80LEU9ePN1Y
zTc^INa<C|idenqqi6+YM)U8<EjRVmbKU9MF(jr8~BG1A1ou7j5Ui@T!wP&Z|`XB`=
zhIbNVDdmr2c7NFwfrM?T{EQ!3TxG)K%*S00oTHjopdrgSjO?K*%kk|+k#`M=*e=k{
z);;Pv6^%ho6iR>@!jE9%Nd53m&8rIHDA(v%Ee=dlB9@2~S8$&pEUVP7WDytv)C0tD
zAkaP*o(1dvIf)1l5Z9n~a)v;E(De}qPI`L^wuTtdE`|?paPdGytOE5d@)$35i-Y%D
z*eJyoEH{aOk#*rV;N<B7{#{Y~qBu(7-HWm|%z2rBFP3UlKzSf^ng&WIhFvq|5KHqj
zfndK~TUf>uw6tD7%JQ6I8M7M^k8DZm@`Um~>s+nSam8xw(5XRZNh0k1OyL+ryqFeN
z{wJAwYy{{^rKHzI3e`|(;g$h>ZPeWnRBs_%088_=I&y$e%!q*ojVcBmTLPa;k+Qoe
zKrg8}=S_tasBoI#h6)<I6Z$f(x0{=vH?qCAWoIAo)u-7L0ZGUe1ldIAIEG`fbo@bv
zM>J4nyDWv<CZfbxvOD-tjw~CFX6(OZb_uJ9Koc73dJmRaw_BnCKR0ZB8e8B*Oo3v0
zl1uX**LU9yM;aL1ydwCWVPWq*m||;|eN`C3+V6pjJe9oriFKw+@F0>*;o-GC+j*N6
zNthj!1F@|k?-6R|VgvcZVdnD`jl!a}GNiscRgk1s{Vgs*i{m_-Um+AfEu3zQz9v8|
zF<1B5mPm1n?}teH#9_z^Zf#m{4YyI(s9)0}*OtEye2of)av5S8+K<h|3588%l^LN=
zwspcaIQfB1&mKwAIL9%TvS*Twm>FA-W*YVcjv;#+DJl4~&^3va^cwKDacXvibH4(D
zanB8C0<aA($2GmTM>$%y%SZ6_Psfi^vkz2{CAoy!;1%J=ur2}(1-*Vf{=Thn2rOoh
zGp_Z1iBrON5#=r&RJC;bXQ+UTHyp~X-6`-#{Dh~v5aw;y-mvKRJ6Ce32Oh-;ced&X
zD%gT@F^O{tdyXhTV8WZ-$POGsBYhj|ibw6XQ=M2a0?erY<^e1SS76_7YOHa9gy1u`
z!itwH)q1uwUlC*AfC;4Zp3TE-OB=~<+p$Qyndwb>b|gRc{cTjOm}_S|z@WsZt#0)C
zfIHP60^SOrmt;D?9O1WbzgM|zlyo6;)&B=Xg*8V$3zSS(>NjR4T6&=J+47q1`e>XZ
z4Fw&{2Tg7&{>}=hgxW*-Uc9FIzSfSP!>MUS`S69ke;#}*rR1TRz~DR`GN18ugHQej
z$hV1G0%hhCx*vyh#Tm&in9glH{LY(II#eSISj{+}y4mlV2zhk^vYeRTo~%wQ^o$1T
z9<lkf+U-m`S+op|LMTi2G+8Vb!eQ3Mhi~A#Gp=r>6<dl9(UOs_Y>Cu1gc)w!gbNp?
zG!K-wlX<(%3Y=NVv!#c%L7iWg7E7r$&L>^WK%zff_m=+U;F+3%RwkiG%(=4HmIQ1y
zbt4^VDFbyHWHH_~e*9v|(0DeCrd5N)ef@i-*^qkH7e_WR!$E$KKkPTDov(zmO=3;t
zvMUt*CBl)<V4`k2;;=m40i7XK)dE9JS>A}9K{;`W;h+5CgIkliE1mzJ_F`lvC)fPc
z+U9~A79HM{_VI~GPyIH$qnpM39F7>sMY;8HJ4Eaz{`lQ@xO{mI;806Hx~p;e;+@cx
z1hLCaPH~d+Mbl!XhCYPdoFx|(;l6Ftx6FC$QaMPqN!>D-R`V2o^>3jfo*9qo)V8v;
z`bO|IIccmt;1^+DH>@levx|PH?WNu@w8B~Gx&KB%M!y|PORPGi;e7q`2(~$)k|XLT
za0t0iLm!G-j(>%H4iVL^3l-rjp0g903#T1*Mj`~MkKpQcI(e%J!B?|U*#*OtRBeJs
z+?*+!=tVmpKinQi*gQJ76K88YP{Hz5I;}N^XGY-C`sW^PQvP%$)kJeoC?`Dz29j6g
z!6mj*5LC3j&6;K`CdQCBNu%QAH<_<6?%5m>QItGlpxLRRu6@0|cj7s`Oi-M{4#rj&
zx_klypWE&%T$-;xL)zjSY6J^gtS`IWnN}ymBk<;Wy|}Iv?WEqfzEcev<X|o4-`&?I
zj{}H7WQ@$udN`zQSnz$)8iB&a7vivF<S=3*6i-H12jSq5%o=!gBN>@OARkY#T-?$o
zcS}t@kV<^fZ$W&!c+<YLdCd34jZm?cmZ@%~tpX%HoV!UhgQK;>aMR1nx|7HFIfd+@
z$g=#KB)RkNGfQetzl2hvXc7lHh9e}Cye3hH$coi_Cq;OvBnkSymz)(-Fuxjd+3*Z^
zbDabpN`wJ-;NcnDj-!sgAu2cVpR%Ha2C2&2#gTh{V5=X3rlJ+Ux+BBPxy}S>){kIO
zvwll5zv#3PG@^Z)rzAYTO?PIu#_jEt7Jin$?!9%n03P0VP=3?Q)9uDD;IX>7m&B|O
znPR1<c4EmvQ9kC7oboKXLx+lNmQ$W&!Y;K&&h5YP>U1GVpkT4^-jR_65FPwSe{xaf
z2E#%`y_p}mReR}@q%~qz)}wDIRU#Xz%V?KyBv%wEL^fHo7WnRg1^#?e2tels3Up3M
z1vBG84*&NmPjUt`)>>4kJ-1SWjJU8s?^|Nu3nju!EiJEEy{C=O-uapkGB;LSeyJp)
zh(yKCE6QEx_zP#ibTdS4YkJNt|J)Xba?}`M68qMmXE=-2%oQXE;SX9{_1Lj2?J8bR
zM^i}&O=Ik79`Tc5!Av+yf?$u*T;%cl_qKeG4a0q@1R9S_Ow<-1I&Tw^dVAD0{)z>g
zT5j;r3-@S1Ay`qTjGEP>QXV=Nq(GG}A3^)#AepkKu*UmZPh3xQ%>66EasF%;!^9&+
z?c7ZcB}L-D1jCMYiPJW<Cxl~->2@)q)8cuF{9No+yPITN0m1R0B9aZaGabxPdh1wZ
zxzME<hl_YeiWg;5{oh_zG|FTkIoc{0D!O&0vfW)|kl<JWlUl({>8(8dbhNI?D>4rO
zgcIu0fuRf(SSyE}?xT@4qdcxja8T7s8`MQ;XuCk7Jb<5iKn;;LhT0&PkYvd&0$e}Q
ziaO6~Jr0FKyIORJU5U%Wh1Dz~n&?j|!_LM`FWEQFoZ*OdyWI0Wn7~Q`lcY3z6O|&U
z?=7=3RLnHo7ktsiemS1i(F%0tmiIyf$7-u{HE%7iJQ1RR*BGWo-pZ@3OYY<4->jUG
zEqA`SVsH_O$qi6_S9~X*PJAnV6lYcah6)+&i=r-y&cEMC9x$3=+g1pXjAC#PD}n04
zW4Fq=c#xMDNKfH>2zPbWDL9(G5rfx`wpbvw=F<_Yr^3O_4Cq<e5QXCN`T>3Tng4X!
zkO25Zi?4b;HwX7(T5F_radvI)@0r}Lx0`XV2{K&9_HDpjVFg-vR@!#yk)MZe=KCv)
zjcmFwLudC<BKn`6II*j79-w6Z#L64On3zQsOn(B@Xc2)xs9?EKz(GJe>TtPR?_-72
z0IfHFg$By3m`*D0H?0i)97SkE&r;BX#Jtl>J+<<is|s4ThE7U(vr;S6Sk9ayw^5<?
zKpVL_Q(XLyRaITi%$k)|D`i_4+qTp-?Y(auVx6bwdf%1+p&LT53jJ1g=ikx@g}7ta
z*oJLAu%fyKt6nQiWv60FyvDZ_oNzxSA?GvIW8CB%E`@(r%|~D@d#BjYq*Qpdt!OEw
z$TO<?Hn6?7a_)dOKSkrZt%(4r2Q`>UHSv*7LTLObnprABdyTJnpN>Ns+p1^9(RSM1
zWbE23(?Wnj9@*6;S{lQJSh|kZ*&=lReRH7cY??jw^_6!ESz@;6m8U_=I`$Q)G%-eR
zO33qY=%4~QTVF<u-FK7n%#VuXMvCF-Nxw@5QfsMsDW{vXB)Qywpq!?1_Z6~!r}tUO
zpEm8VGrM&iWF>%P;Br9@2?ERBe;<TvjJ|0n_ezo<-pyrj)W_NQJ^dNo_2Rd`4qpqX
zpTQaNe}ybM9D(T^LVuekwU4{3b7<+vh7@`+q=2_9^Z8wvNmaIO{vDBM1N$=IeOIx4
z@Sa@_au#F}GL9td&|`N!SbZPJSOs*u92nF=CSFUeNEtQBZ4#rJFS0(UKqQggN4c-w
zl6yvR$jN;h3pS5ghFFZsagD)RzeM7_i9{xQk@{`;AzV>TD~n|dym6hCURH9s!&6%e
ze9`WM$yUq8)Hcu@ka@kpJcFUTv@P0D00YxaSa~QF2d~tVcJzT^Wv>~OFMU?uPRt#j
zb{F!@+=6x`{wM^ERR%wAp95`<p3ULIr}&V6cBc*T!i=Q#9u32jTN05x@bUf9GPyN*
z-LPg|Odj0hX4yE)xiw}XI5$6&g;#-hkhyr0`Ky4VxoJouV(p!SA2g8PTlgo+&)^+m
z9$l0*{=gq#w5Fw>7z3ZKcey=FVroWyrl^JS_k9fn?XhRP>MWSTJy16B^FO5>L)$&b
z^VuG_pxIP88_MeC+9inNImpx9_!StNPSM#Q+0Q(xjVkWvqX2@q4d<m(co1m}QMgFh
zN1IcX>a)>BHTlMug8iWzp$?Ask${bGdCQKxzow)=@kZ0_H+>ubE70f{h$v{#`e<^3
zP3EL5WD~#EJP7ASD-6(#aoBUWJ8l-tp;XQR7$HdShBt)Ko(Ft<{u3=q$HX$%pF#M*
zexs}zYw|eJ@<T$^6L+Xe{Bl#zRDVQNY0f)(t9hu$<U`XMLVV}AoO-0n`+Fb${=Q|V
zMxM}J94pdQ<JS+|X4fig9CP3A4HNOlEB;}kt-Xk}ltX5(YGRG-6Mv}%(LCEX(T|)c
z?`iBNps?ePWNm}%@8eK1yFOa8@vEPMaH-n1?E#>~Il2tkE;4+ye?~kG4Lt;Tw~>|g
zfWXWgb?WsMv5!)w032dHeRtP>u-y|W*D=$;G$6y7{jl^e*Zs(a5~NJ-TOJ0jZ2TtB
zccM6QjI0+C5>0K|IK^h!HICNp;T()kHlkbVnAyqQPDnKQVf;ing-3+Kg<TQm;DWOI
z1vaXS0x7tGUM3bvP_^yYJ|22YR96_a`y$`Uw>$DaDc!ibXzsbeNc&0ajhu0jl7_Is
z(**w{D+PrKF&IO$Tq%DU`g(UkBANJ?@&_Vet4ldeeQ3^cY{l>*+%bmkW|U}IJt|5R
zhF3Rb>>JRH>LR{%Ag^#-LR=rP>SA|9klsBY3QxxN4@ylp(=w+(QlMy>)_bqF93(6g
zoM91-FOO%Y!cAQ4j;(y@sVzdh_h0+=%*ZhTN0G{UZJm>K23lrXd--%GNPq^}W+-=j
zW-S9vAqlZdUV>(aIJ59Ha=Jd;8^SKH?~Tqn$hq$7sOEuX45fQtPnIB^v=SRR>s(%w
zU{}wBm!EQgeZwm0@j?^VA=A;3|0bI}syBLtWcaHkn#Vx&LEmGAfju0U#<W+V_{liF
z7|yFC2X;E;M<JzjD2#RUEKpcglBW9o*@>c#CIoT;8L(p~Xb=o1TeK_Ju{<a9e??)L
zFm0{!p~0CXg_1*7p^pC;cYPAFF)QiGqn0-^pI!@RtwkxMxPWt1{BOB1n#p06ZRGFV
z_#3qMTI{K7w9qHNkXOF$(wS{$T+lgygqbrue@MA2Y>-=p9(HT>%t7%dnxp|l+x*;&
zw!Yaj1*{N-Ki*fn5p6nxdbr^Bc8%*=g;D|9x^O*tH2BUmK9f!rfuDcy#@ubNU}IE_
zsO=LAFfU-(OrphLQ!2{wRJoGVYMC6u*q!HuKja^ay7|ql<0uRPD2bOqLs7C!z2Xaw
zeRucK^sib{w<nWeGW~v>I6aqBysL6{VE<vFHb#v-qTbpVYSKn@)s)TSa5H=|iuvpG
zTjLZVIDPd56?8q^iBendtVRWr&~??~<g`KF^cVtex2R^62**F1#1qNJwu(mZ6<D-4
zl~Q%m36VwR>hs2@-}EP)aUweBy?VnTR%rVAXjVmNDI-|PI1p`jjtYw3+XAF$3mJ<r
z#bf#fWL_23<*93fn#{gx#Fq$FzKBi`p=dbftEJFffBu7;t7M`otL7nUb@tl~zW_mM
zQzUST2g5C119`<ikgr#b+>%~j&@840>Yr4ck79)XM6LI2{9BhUS#HHA^_uiQLD->M
ze=b081Q&HBnEsqUoLBLMbo1e*mI>8(+!v}<nzmLhYEs0}+!&$}O0KH>*|Td&`+$r+
zw(73128t7d+)2T3$-I_L93Y&jO(EdpbWYl997aK{BXSi;C#!i?5&>U&Xvfvq2?a)T
z&dX;`x?UftwJDrE#Gfe^=ZL}-g)0R?PmjU*7XyD;7^gH0J%r^%2PHH<XGwbs_d0Wx
z?}>7Sr{fcobEhxGDB@)f)XfYTC@_G;wE1Ow5XDdFMS1H-Kh`iYCQ_&OPGzEG#H-`h
zXs$9%*Q~r<37VRn(&wffYe*AxRS?^ex%`mw0?Mf`+bl>!kYc0&Z|u)dq;p~*!1Ut>
zoMkmkiY{iAHCv6doXaEJJVhX<HYcL!2Xs^rMNIwlT@XyluvH{pzqcIgEtdCvU0xs5
z=Ab1ogq{Pl<`4^eEjMMTcXks^?|Fz*14eDZX%RHehK_LJH}qeM>4@3-SBbHuN*<8X
z@Wd51pZ%%x2cQzMQX{2^&(<tGx>3zNWl0>PC4%a)H9S{LZJA75Ra9KJe*!G5ZhjNR
zdRL}hSBfAbo!Oh;tKsgOe-fO=x{tV1WwKYwC;|)1oJ+dftZ2xY&B@mxZ^6e6zNrHg
zAC%iqN$lBHLcd5oy);)uRCgJ4HF!`KJWdH8p6A>!*tL-ZA3Be;qr+)y4byHGy)YH!
z7I~{$tmLJDN#<hw2T3$<HrXZnOcPsSavi8Z(zgah;+6yUn3r^RTAX3hQ)`all@rA)
z8IE<OWv(To)K%QNlR<wwcxe~pDw&F2-u<7|QvSk!LuLow!=45<fvMz2)KV-qz~Z$y
znD0avxSXlMDYm*SiU7Taa<9;vH`_MAZZH9ga+@;F`IQGWc{0AHsM+jounfbd-|AHv
zaO8K3>z*#i1!wuA)fJ}#>Jzje;}^6pUqF~jZwDoz-8Of&3hULlo(c!aOr`w^ozb$U
z2c$;?d>+2-F{de<1Z;5ACn9I`>Hxo#dmnSJfc#ReI7SMtDAJ3)Q!I-#)20A2;e2a*
z`RK*9IOa$DWGvXvdBad<b4B1GGRx+AH5VaEWxw{h23_Q80>c9qu}QJcZkeNlfp4`}
zr~oU|F1_!v@t$&%l4bT=DTy&y?UK<N{o#M?B5TBu0`V+0X}cqDo&(sW&e0xZ|CW-o
z7AnzWqit8*0+Sm)8%bW8yxQ4UtEvTV5}a%;lcT&g^en+<k4P8IEYF`+8k)4Ak(CVW
zweh~Q9%@DuNM%L8E~D#<nc((askZ~iMIn@)N3?ONDjwug$<+maTEtab<1<QMKNO9e
zEY4};M8zz`x?4^?nKz)aA6TI^B}mng>DXO?Orv;`??+>iH+9cmQ5exM;&N#>odvNZ
z_#n|e2ORZ>-5ah{eLtBp&t2dSApPSu3aR?XS-r%_lXf$lx{7EoAZ3jQ!4d<3NycFh
z&!J}H?J$bl1$?htR8X`|Xr|lflN0f&Ai_HES;W-PRD&6r(z}-0@kQ{>z=BxFK6biE
z28-N~!R0l^W)Z)N5xwSiRy7M;U(ZjmxLJ1bu2BqgEw%+~Y}{sPhrYNEi=1YzN{ptc
z(8*UVX8fq)1bCjiQ-Tejl{ORAgyyeo=0H|z3`5lQ7QY##GDZiI>x!8(-hyJbNPBar
z`|b0F=)N_`C^w@=J%Io{+Xyy#?ywAVkE3{hzZD$Zx;qMJZ3b}Ky<_B>piLLAd>14M
zm$|etzf5*tS&2f5+AkU=k-3!PcaV=`d%Hy-9xWHx(&*L4?3}*&++j8W5hw2W(Lhza
z`*z?sugNss#2F{kz3NtIKviN|{_`_mP*mYA7bMiikA-fTiQ`S;x-WopT|roG0Z-KQ
zt58m=wj53T4UXIs$kw%Aw(Ktz`gBDDtnRF~RO%xc)a0jjjx%AH<)<B6qumIJfJl@3
zSLoguvwlOnOmB&F=wZV84S18DHX&q?{x2D*8CK^9PXV?smDDKbP3F`ixSX9Qvr>Vu
zSg#lUCErm?)6~=G1LSUuC8QyM;Bqls90Cuoy`CMQ86r^Q^Zoki4qQ%#+X<odl4Nf$
z$tQiHt8Kho+%qK-Pa*?kBDxo}&38PGdBKpyrB-v`4t==GaH?!@N#T?dQ5c=BMQ7Q;
zUEXjItdmfyD>E48`;JP%4l}PT0?^Y=TLeR7ABOhrRv5J7&cM|6C~=(NYD5!tfi(YY
z&mR60Y2A^dxkq;g%M-(YQuc?Op{5-RSF&`sirV&gKczTs+GdC=$K5^DpB8@Rin0Q)
z&ToOHi1#)J_Q`FhhFY!@!0XS_Z}q)sR2I;ej#7o^<hvI&14d!rTUd_LAl7_;?kXCW
zB>JL=I1YxE@<!$GI6W9ZbCvgG?PrW87Bi!HIEkH_ycXxlZ8*c4pOXObT~>JVV>umb
z$qe{LyZ*|;DO`KIxma#=gge{L*OKV!T_DyXQRs|eBJ>t_+@0C53|ZJxFl9?7i8<r(
zYX-kH3>jI*w-Mw$?&Vn!_e6m=oy|tPR2H&6ILn2d9dj9J4MMJtI<1Ki@LPNuJQ0%d
z<<ViwOo-r1i@3e$<}LA^jdxuseG7Bkcmg{Mxs2A_fF4?SG=FH>v*vt&gSsZ9U5%PY
z61hV+D6_sK|9sEgor<M|b=Ca-U>_FQ|JTwe>)kMXDC;<f)Jii1TP7KQnO;-cEl6Do
zmp6uw1W4*rDm2`h{tGmE8(6rRa96aU=#6+LHVFIO!q4e2^LJLGvx)as-G4N?bqGHZ
z6qR9Pfho32Z#YSRZfWL{S~iNDFPf)|sr~%QK|8*%cHN%)FcUR=2j$Kb+gu41FKRpf
zWKu`1>u20E?98u_J_y$YQdlF(psBMo4ZVO(%>%lRNVH|j=m$;B$x%y*Vzubi>&UhK
zZ<7nAL6NW)xD7e)Bv$1^=~F=ayj#MCD^d^lSOa{IeJbZ3fqET5w4YzLd+fexdQy|j
zag*T5XjHj(hqT79qBq>`NSA8rjr)a>ztac)H8FzD{yPMIegV?>!@~@sL=h%Vr`6>l
zvv2guPN=kSRpND+3$*wN#~reDpp*g6OF!1hXG)CNLGud#lx0s9eJi?y&(5Bmstv5V
zTe;O@cq;`>N*mR`sdBdq&Mz>D$I*3H6YrggX`Y`st6t)*`!9)$$POkPT45bn;?WJx
zR8^1(9E#KnSne7&I}Jwl2RBI(qJf8|mv=SFs{JVc7VvN*4#+<EX0-%T2&+aQcunI0
z-Tv>>@e{lq%H8v8wIhPrr>nhhfT6Djql#5|+$?HC4L<a-viTv|(W5hP$#(_o--va)
zFZIyOCWlCuRePcHhcC$9xz?}ym46tyb3{-nItyKac!OpJ$*I$D;-~9dV%F{>$CH`M
z4*GRofDgi|D<mfB;aX9`!~BOQmy>A~Y$b<1IDbLgW*#mL0rYMGLc$Rpcgy3=KBPX!
zjXn5MMQ)$bmK0$i?=KE4Np&JlN%?BkSNu~x*)(Kpcr55mRO64yRc`Kh9)j_E2?^f&
zp0Ef3+^A=-hsRc8f#gJT>sRwT+8{9eU7uLm-A6}Y*7!>WbWWgYw3JbI{!4Z<*Eq-s
zj&QedI;($OIC?V%iJIG&m+rfX{R!*F*w=LDji3rg+oS4OU0@miUNRA}VQp!b#Zd-e
zDf4jE-3_Ve_LOf0OJKpDNv(mza#5fPN~3w!_yk3(RG9~@6vcM-BrGP9d7QIlCM^l}
z-IT$}>ZjHc^%b~JFEgt_4Nn`~FI9nivGC;C10$8cfe@)!_+rmRlO#~l#rH<Fe+huY
zuKx#(&BVs^|7mO$PX|*%1_dK4Wfxm$26;jz#{W>ZxTTY`3n3>b$NvM_ge+|AZ2uQw
z6aMcC`&Qf9d7B;m`%XVF{?<&kM?Y8A{43(wVyDA#i8TAs#U!(>HIYoU1i8K6Zyro4
zGRbDzNrz*1Q_3RX1k8cpTu<ju%1Rg%d8{!rC3&mqmgbJPncPUPv7U8G9++1hNc3Xy
z2+w6D5fYXn=8ncCdkK>)x0j9JJ+LZpvYuEOV}SdMpb=|e)M&PaqdA%~@zI=B0+p9(
z#u7YTjp>wVH&Lze6x9OfV2V4kyDV7XnhL^7<!c3~7jh;#v`rxd9Ut40Y_WI`lP&Lw
zD{1v#oF%R@KB!~fWg;U7hD@Za4b=*dDonEyQFCCjj!=_|5mF?Ui-bkWF-$KbB`7Np
zX6EA*xhgij|4gkC&@XdAKcW<Z1wKfnJ_`-1DsVGtWK58zm@$}!$f5=ktN0}xWvnKR
zls7b5g%VWHQ%TH41{@*)YCMPVbjUz{un8I3ZL%i;i9Dz&#9%Jba$!lR97kFMyjVza
zSSJLUuqPT3J?)?HLA<Et1^6!r94vO_0KKHtFQw$AiiZn?bS%H2?in6p0Vy^hT)GHM
zs;*$IfHzBeR(L_wSkduiiir`(kkGniAR`Ffc)=iL0W=JfK`^HwK``+HbW8-U3rPJ!
zIDpNPh+8~C5gIYpy{ZWhv50lxs=`Rh%|e2Uf<1t$5*U*RwhB@Z$*EO#BLv75JBGG`
z4M>ShB7ixitUb&{Fun#9b<&wOY*qBGX2avlBe?(FIEAH;4HI@6u8$8l|KvCxc#bme
zjpZlj{s8<$0_V$hk8V=}&GpO>?AjE3eM!iC0mP=3<ygp-lZ$?l#D5dV=SVxAp#0}u
zt^EcL;wz!w_dBQVes0=H<!iu`f1>Y&|5f~5sy-QR+&t&*ExU)3Lt(6U{{5gm`OA5a
zAddb?=>0oh!0zA|uLHbU7}H?IT#!SP0%bvlEacs6lO13Jiq@f~J4M@>0h8JMxP7X<
zF*D3l3zZ4_B#WpiDCH!H^+Vow&7_I_V#Q?AWjO*#9nB6{nAUmH&(su!vNkzO0og?N
z{>pe18Ow*?hsD}A-Oqgu7r42<_nW_qg~;~|^(2gvO}>^%r^*5|n(<k1KQe6nX4E%i
z6>Yj;NhQV>7r9v`HY1;Uy@7c4eSadmcAGjj>FU9JF2YslIyK3$kK^7|=pDrR^`am$
z>upx1Safi@Kjs*-xy6EZgNqOyi<ns+0X++LL72SRQXDyfx*v5h)-|(iTI6>QkrE}b
zw!1~>9>91)8PsF>`5EqCR)OyUE3prj>i2h{!vp*Q(=lS!5i^gO#ZAglb&(Wfo^srB
ziMfaU9DXEPNhk4_Jb}n<ni&UCYxi@~<maR1F`YB<Y8d<%7R)@^7oGxvDQn_A(ayN7
z<|;c<cV~-0RZ^{GB<aV9?}p%ffpL6u$0XW1orE`=eN*6^W*^Wf6#1q$0GybWY#4QD
zvNIc<;!-B@iAvHQo=%&&M5Om#VUQg>hiR+4mT-X#4ILxxN%|-(Wv`mm)#7>y@N^NN
zj3Texfs!>00uY8S08c}A`DSEP8T^g7>^~HuiEk*w&w!eVMA9>1%%-%g-jI&$T*X>C
z310?Xk|_z3j7i`j4j1JPFO7_LxO`)jU9dS`_M!l&iCo&0Sq=s+y?4m#G#<J+n*P^$
z(ZrM~2Ix+b-=Yn9P#=x1HWuZH+hNo5Xhdbu>9Fo`aP6t^EG@NBU3(nr?0Wf!#er%z
zbzlJpW!{>SZ9p$5fA3PGhCfY6MLsT;M?U9oy5uXzZ&LLdR7N{f5{UqorkS~Ht+4rR
zcV3i}W43$9DUhiX({x96pYyk$8U%oq#vaM16=|KkXtf5pQ<rVKA2|4mm$wtUR=8){
zrS->LW7&uai+SRSQK?)HnL0$jW-n1b85}Lh-lJlJh6zS&D_-~tgA$Smd>J0~4_>Gi
z#Z9M2cLRq+xWTckxVL!qMT-NLZB|WDvC9<1@4rxq72hrS_bQFcbfeOC>(QySupVv8
z%uiWP^QHOf>ud7_!t_?;`>IsJKA_qiO%yjN6rp`hl(YPr$Wv9xj#FyVDKfbb{|53R
z%_UJ4_f^rAUmPZpNV3`m_HS-2OVixOsFMG_hE3BK*UT%XHT%(BDI6yG?HlK68KJ5M
z@YAfdt1iXcN?VqzzP5(Kdqo_apLG4WvCl<<%lmU<xzW*cZ+Djly|$OQP1S<o=<u3o
zq>n_&{sjB(6Y&YAG(5>7M75<P#aeNvHx{5@rcd}7W#BR}+)hG83YP-5K3E<_$u2ep
z1Yr;dap=Pn=`2DL;w_*`E*)VpuUWQ1-sgdHJ}G%me+Z^=zwF5n&hVQ}3t2FBVj!UK
z?Fz#>5@?p^9&DXXJ-NB%QE4o7MzV(9S6$X9;&r4Tuq<=?qUMZtK_%X!$s^pVd_Oat
z{)RL0bMxTE&c|(zQz7_p{O(+z)#uw0D5(=10%nX#3S7HbonX3nW##Tm1a<87mO!X`
z0hM<J&cr1&NK5~<AFljK7FX61I{!<Qy0U?pEZtR(WSgW;?xl+$ZaUB%HqA=OH_l?U
zzrcp9sIQ{nE3Fi(pAL0gDONO;s$pk$Ax0*$>)&PhYfWiw7+1hMQ}x?__Z?)`JHEwh
z$+P+}(q`kjTx#Rm`SLB|ilox>sI2JyfjyW_<<djqL$bbrX46|$fDShZ{Sx@Wq#D^_
zVCk09HRSh7G<4grf6zO~yc*f*qTen9S<94zS;lX@6?V8%=8Dh-DlxsZ=J%0M>Q$Yv
zV5#{^UG}B2!``57`RMT4|AOyJ-da{m!lmlUh!%e7Im_h<A1nA$S)0o}Be3t2dilcY
zve-DdqSKNLYD%M<nS2$<e+A{@AO{<u2~jFK9mCvm9B=+26=>S>Y+srkS{M3Aqb$qS
z!R)dau1=Z}Ho$ax#vxXRW=04tmXEXnE!!GnE5Z;|2{k?yjx)FtP=ptOl5r(vj+UYF
z#mz|8PRvL*W2nq{*lGWmfD1NH64;P;jSOkMZllu)q+C?or*07WV){pi<jV!xMq6XG
zi;!D2e%sC0YFl>AnFz#~!#Ch>MJg~Lt1%m6*U?@Deq43y(fJ(M9$w%E&*t~T!rcG2
z6V+q!J_l_^1$Eo9wFByRi&S^&<u$z&)Uo<vDQi(o@y<nj{%LQM%Pv^FDMkIBovhbK
z&+Vi4Ztb8Z{}>7%H|>42-oQ1uzg`=QZgJAnT-I~e{mUkYL<swte~oir-RI_YAq)OS
ztNO31Q?JL<(eN@w{NBku0{6Gyc?pM4r)P(AYk-SSlT^NkWFe*7MP>;3n<td2j4%g7
zzC{U48JX^i?IrhD$T@HCQF-q?m%u1<?!PyRy>kqo0f=6qxp1F|eiHsOFovi3_W+Du
z8NH_`pPciaFXsQ#*mXuVm2F`<NFSuAC<K%e1X3WONN*w#kR}L-1PFu{VhA8L6qO=M
zC?XLCkRnBtDrE+gB2B6yI0BIlq1q@?eMx-Inz!DpH*c+bzqR*1d!KLLyY4w>o&Dq7
zxub_9!ZcxFcDgBXUtMl&obc84JJ#9oo<>DtvybvT>v&<su4JXioowK%v*(Isp@%k>
zuX<QzUjha6OzjHEq^GIg#zz%SnZYXM!<^1<*$sZs3fWtI9i+8>GKj6?5DT6N*KDG2
zKg}4|W4mIQQle+-4H~x!6B@TV8_1)RPE;y=^4YJneusB*-r}3}^FhKw#Wx8;`{b8k
z9rNO-s~d?H`<dd&Ro#@uVwA0@jE3c=wX?Z+fparOdg#|WhTzV@ogMLlfReyl&1^xZ
z$M{W}3mrzfIAXaizLjVL<(%417{0L122J6hEoIet0rHVO-!p57sVnxBwO+m#O<|jq
zwUuBcJce&i<{iV)l|Y6X=VvdyLmbA9Z>YJ4!s7Z?vhC%_dXI8%TUw-|K70ztGV%0r
zmA;FaJ{(vd-D)DTv}euO4B5Q|f)>f3_&TC4S=y@ckBn<Ri7z!>QnuKgKjnVwJ#mkH
zU*zz&&V>q{#XZ(=rU)VRQT=7e=&%}N-R+_c1_DTNIi954|FswMA|NHN&tmT@_;64@
z-dyo6W7~)0$lXwlG~5ZN?*oKf?%w^mhFp%UtVB4uKgW*m@l^Qh$Eto#$N@%KqxK`;
za=&t1_7Mx)at&MTY1Po{PCq+SBWS;;$byE6=WW`tQ$pf3{G;92l6Z%}x3%A~=DdE(
zo7QCfdw$`E>YT+4<?9{F+wMcBayHmJ`OAVsAG8nD?i^U!8tdlRxW##mx3LSucm#+!
z_5EQ|=tmqD$Vxp=1w=pLCi8=AD{xV!y&?6N2i6ScDN6ll+Y`h``zH)}ax#alZNZ-J
z0*!>{o09t*-Ddsd$KVd0vi{>q+@o6x)gvDRMlW#W?x;nWPkss9HS9q=w+#!QpFH2|
z{CcduFfM8-sJMH$?!DEz`l7*-49k*^TZM|EiJrp3N1ns#;R%M`kD)U2At{j$utgRh
zly?!pmrODy3OLuXY~xqIp15QX(e{o({opRrZvm63DH5V&>X7L7p&b2Lcs;gWRJz&l
zLxz0GQ#VA}p3B;pZM$S`TdJ;pmeO&@?4G@;)mtGhmR{3FMWyi7{)oyt?^9LXxeb=V
zb@N<Slee_hnH4Dfcs<iMOVQE?V3}u!rNJ?zyhGmicE#VT)T`6;wcey}rg+?JDEOUw
zD12!my!DUpvf*&zoA4M*LKJrR*zOoaFJPl=<+NRM8OVhDaVL*<-9mx-rz_|^Z>uec
zgwV4H`-5wYq`1h@bWGXZ*;*uD4Y#C2M0k?gvoe?@Ww*ao^}E@NcyCcKYy>lAGx@eQ
zs4#b_PrvKzt|dbI&gj$CVsr83$VdD8B1WSn-G6h|m$K?#c9*(=c(gxG)=5bPPQ6u}
zz+kWu4SZ>Uq5+-;ZZtsuX~WSZC$KX027_&Ap!iqIMVdkn#?T}>(A5wi$i@rri~0{f
z1kERq26R$7pBGJ~Hy~*eozI6RxzoU(2EjC-cl|SwAeseEgP#@ynnGu$x6vg!3B3m_
zt<~>O7kXcG_MhSAv^Kgc-AoS;0D`OoUA<9mcv&DwABRHXsjtrrX@jx{1bgAp05o;G
zj>Dlm09d4(57H9_1YN}Wy9c_VaI#o;52~92L{S;62vGroOi>}h{y6slSs>?+p1k}q
z21q;#AZwrw1w&N8O4LdKL<yn{R{$%^fWb0UKZL*gKe^c8kXS6r9RM;y`UaplK^JWd
z?G=pzeSKY#7z_#rkhMX31puhmk9_0-mr%F>Dm6e!5uyx%sX^f|1*jtYXP#7l>a&@7
z1)%`cq~Jh+4;G0>2cVFEpnu1~6`_hyAg7iV?PK$I_2z^s{jUNB6#BD%0Z~!?vwooh
zhyN&F{2%p;h)cbgaWH?=-r22VLTH3yu3QX*uC<_H7MwC`GdCrD1KE-gYY!ZI@$sqH
zhC_ZJq~rbkDz>3Io>4F_Ix5d+Xf!4$YAkj%3Zlm_D=7uA=RL+e@D(kAHZ6#yY%=jE
zTudY}J*mwRlSG%R-Sk>wf5Nmzdg(o6`I(tXu0ui}MoL~jU8ch)*f|EOod0r?(`;FI
zaq;$iGNJ}im|RP6lm{_h*~Zs|nkVzjmqs3DAAVXN>$$&C&sZ?t({XdIigbSP6H%L8
zjGI*q_K5=Snmv<D`a;}ePA1L1jwu!i?u%u%(9}PA=5|)Kdzv4q(DAza%KZ`jvG$6Z
z$7J%#$NuHU(w6%7*sZDyeExXWhZzC3x=8|gNn^$gM=AxtEVbVLBE5rIaR?>3%wbGd
z*>6!ro6Z92Off7PjOX*27|&O`bzA|ZJm7!QS&i$+wiPzaN=oGw8h&V?eEQ9C1EWG1
z`q(ul3BYo`Y&p*4vOvOJD~3ivR0tIKYG%$dy{IQ&)=xUtRo0|uOK{?{f3SZ=MTrmo
z{K$Z#&Z(%ZZE?9nai8eo5%p`ijSd6v2l=JiB7;QJV{V12dF7XIRc^O$so!X>xMv`L
z+FWu@LN0+HL6n~uKZ<CaAzF{VoKK%nwjGug3Slceg7?_(A}};mG&{BVox)qDJi!eZ
z3~7;JS>)NXTJezt_IP-LDq8}N4Czc)3B))x=~VRo^GwwYpzX=|oYCH5)u-K^ce$$T
zo7490PsZs@c(QRZVpLW*8Q0H*Is8^Cy<@!z9eCBGC^$3BC*?K4+G@^R*cS(!2(o<0
zFzllFzT0>l-LvZ4Ao_KOD?95ArO~A7L`C;aEx&c3=$`&e7(!(%5`RG1gY-pscY@}0
z#P&MKE8QY_n70S<GLt1CBXxG;&9%igzfLungqawI?U#PvPIuYCjFi{?4kOII!*j<U
zG*7RX){r%zsoJ}1YM<xJUmPtT-dxvGAgm7)&3bd*%%aXR_&yikXD3YOT>iTWUF|Ou
z`j2v<y%oxX6LbONj=BzT1OuQj@D)ywwO1&048y49Lpy*Y1fT?fP>ojp{&)aXnRfo8
z6)nQUpQ_PT2%2U9aMaK>(l<~s&{KvRg2AdVU42!snju_Y53Z}LX8=)C)zbp}vkR5S
z42AKePLFU1<o_P#r_xOWl5_=c4JP1kxXcKoHn1KsiZ^3P2opFnC!NsCqMvlrN{%4G
zb&jhjvBPnmud+L)=nla}A9&7IxJ*I8*A_bXUL$ZfoP4mkvDfG6QD^1(=ojp9r&0;h
z_>^bCa+!pT9DCpte{*OV3{d8?;d(4hv_&Db%2fgFzISKC^>Lt!X7k#{j32^<xtVzi
zqJOCn!95r&*Up6Yxc-ZVYr}D0M#olo%Rs46ZFErO(N(sv7Uv<xt>}X(4hmZwxt#y}
ztWIfKJ(+b|hvdvPqA|jY<zLMY7UzyOonqoMkIi><1Hv_5F+aUfe_V`Nb4r!MDmBDz
z9u<id$YyGHX?YT&wI#~p*>V}ni}e9I4_uKNNL96!To=5S9CIAZ^{6%8ai!u9Jhv0O
zU8`y)Lz)X`U-Y@DTaI11_CZHq4kq?aj|$XhNIt1{tkPPzhA3qci;8n$BtFlSJSp(t
zNaGDBJ>WDEd)k&9n%gyZku&9nN85#)R?}BIB9<chxFU!~#-|H^dBbtl1}hpV@>TL`
zzR)g5gy7B$5o@ekh%M;%+egUj10SY0h)m!6He1r`x9(=9D>VJU`@y{z1{EBibjX-{
z^{=^1iMpDYk$H+ld;|F5O%sfT`YdA^hwcrZ6AWmHT7Cx(ueTq!Rte=T0?4#@vm5eB
z{H?dO>x{3mR2-@Acv0p1X04;X<k3V1!3egtwG?Ip<9mL1+q-jZJFdio95+_bCX!Ms
zJaJXC=>7#*nzwX`SuIIk>9U7F-{;SO^*(k$nu~O+SqzCq>Bxfc_I;j(!`-+iOyzIy
fnf&)y3cw?A`0Lc=n-fA^eW5CxQc{K%Mx6fwp)n=&

literal 0
HcmV?d00001

diff --git a/DevelopmentNotes/DevelopmentNotes.txt b/DevelopmentNotes/DevelopmentNotes.txt
index 0dbb37a..072d63d 100644
--- a/DevelopmentNotes/DevelopmentNotes.txt
+++ b/DevelopmentNotes/DevelopmentNotes.txt
@@ -163,7 +163,7 @@ the Aho-Corasick stuff around, and will probably experiment more with it
 later.  But I didn't need it for MMD now.  `lexer.re` contains the source for
 the tokenizer.
 
-[Aho–Corasick algorithm]: https://en.wikipedia.org/wiki/Aho%E2%80%93Corasick_algorithm
+[Aho–Corasick algorithm]: https://en.wikipedia.org/wiki/Aho-Corasick_algorithm
 
 I looked long and hard for a way to simplify the parsing algorithm to try and
 "touch" each token only once.  Ideally, the program could step through each
@@ -180,7 +180,7 @@ lists, etc.
 3. The tokens inside each block can then be paired together to create more
 complex syntax such as links, strong, emphasis, etc.
 
-To handle the block parsing, I started off using the [Aho-Corasick] code to
+To handle the block parsing, I started off using the Aho-Corasick code to
 handle my first attempt.  I had actually implemented some basic regex
 functionality, and used that to group lines together to create blocks.  But
 this quickly fell apart in the face of more complex structures such as
@@ -429,3 +429,183 @@ the code or used during the development.
 
 [?AST]: Abstract Syntax Tree <https://en.wikipedia.org/wiki/Abstract_syntax_tree>
 
+
+# Changelog #
+
+
+* 2017-03-13 -- v 6.0.0-b2:
+
+	*    ADDED: Add CriticMarkup preprocessor that works across empty lines when accepting/rejecting markup
+	*    ADDED: Add back the mmd6 latex title file
+	*    ADDED: Basic EPUB 3 support -- uses 'miniz' library to zip creation
+	*    ADDED: Update QuickStart and EPUB code
+	*    CHANGED: Update QuickStart guide
+	*    CHANGED: Update test suite
+	*    FIXED: Don't duplicate LaTeX glossary definitions
+	*    FIXED: Fix abbreviations in ODF; Improve test suite
+	*    FIXED: Improve glossaries and abbreviations; Update QuickStart
+	*    FIXED: Tidy up some compiler warnings in code
+	*    FIXED: Use custom UUID code to minimize external dependencies
+
+
+* 2017-03-09 -- v 6.0.0-b1:
+
+	*    ADDED: Add French translations; fix typo in German
+	*    ADDED: Add Quick Start guide
+	*    ADDED: Add functionality to automatically identify abbreviations and glossary terms in source
+	*    ADDED: Improve LaTeX configuration files
+	*    ADDED: Update German translations
+	*    ADDED: Use native ODF table of contents instead of a manual list
+	*    ADDED: Use native command for table of contents in LaTeX
+	*    CHANGED: Bring HTML and ODF into line with LaTeX as to output of abbreviatinos on first and subsequent uses
+	*    CHANGED: Slight performance tweak
+	*    CHANGED: Update German test suite
+	*    FIXED: Allow `{{TOC}}` in latex verbatim
+	*    FIXED: Don't free token_pool if never initialized
+	*    FIXED: Fix German typo
+	*    FIXED: Fix missing token type
+	*    FIXED: Improve performance of checking document for metadata, which improves performance when checking for possible transclusion
+	*    FIXED: Update test suite for abbreviation changes
+
+
+* 2017-03-05 -- v 0.4.2-b:
+
+	*    ADDED: Add  and  utility functions; fix memory leak
+	*    ADDED: Initial abbreviation support
+	*    ADDED: Keep working on Abbreviations/Glossaries
+	*    ADDED: Refactor abbreviation code; Add inline abbreviations; Fix abbreviations in ODF
+	*    ADDED: Update Inline Footnote test
+	*    CHANGED: Add comments to i18n.h
+	*    CHANGED: Finish refactoring note-related code
+	*    CHANGED: Refactor footnotes
+	*    CHANGED: Refactor glossary code
+	*    CHANGED: Remove offset from html export functions
+	*    FIXED: latex list items need to block optional argument to allow '[' as first character
+	*    Merge branch 'release/0.4.1-b' into develop
+
+
+* 2017-03-04 -- v 0.4.1-b:
+
+	*    FIXED: Add glossary localization
+
+
+* 2017-03-04 -- v 0.4.0-b:
+
+	*    ADDED: Add TOC support to ODF
+	*    ADDED: Add glossary support to ODF
+	*    ADDED: Add prelim code for handling abbreviations
+	*    ADDED: Add support for Swift Package Maker; CHANGED: Restructure source directory
+	*    ADDED: Added LaTeX support for escaped characters, fenced code blocks, images, links
+	*    ADDED: Basic ODF Support
+	*    ADDED: Better document strong/emph algorithm
+	*    ADDED: Continue ODF progress
+	*    ADDED: Continue to work on ODF export
+	*    ADDED: Continue work on ODF
+	*    ADDED: Finish ODF support for lists
+	*    ADDED: Improve performance when exporting
+	*    ADDED: Improve token_pool memory handling
+	*    ADDED: Prototype support for Glossaries
+	*    ADDED: Support 'latexconfig' metadata
+	*    CHANGED: Use multiple cases in glossary tests
+	*    FIXED: Don't force glossary terms into lowercase
+	*    FIXED: Fix Makefile for new source file location
+	*    FIXED: Fix algorithm for creating TOC to properly handle 'incorrect' levels
+	*    FIXED: Fix linebreaks in LaTeX; ADDED: Add Linebreaks test file
+	*    FIXED: Fix new_source script for new directory structure
+	*    FIXED: Fix non-breaking space in ODF
+	*    FIXED: Fix padding at end of document body in ODF
+	*    FIXED: Fix underscores in raw latex
+	*    FIXED: Potential bug
+	*    NOTE: Add shared library build option
+
+
+* 2017-02-17 -- v 0.3.1.a:
+
+	*    ADDED: 'finalize' beamer support
+	*    ADDED: Add escaped newline as linebreak; start on beamer/memoir support
+	*    ADDED: CriticMarkup test for LaTeX
+	*    ADDED: Custom LaTeX output for CriticMarkup comments
+	*    ADDED: Support mmd export format
+	*    ADDED: Work on cpack installer -- change project name for compatibility
+	*    CHANGED: Adjust latex metadata configuration for consistency
+	*    CHANGED: Configure cmake to use C99
+	*    FIXED: Add custom  implementation for cross-platform support
+	*    FIXED: Fix German HTML tests
+	*    FIXED: Fix cpack destination directory issue
+	*    FIXED: Fix memory leaks etc
+	*    FIXED: Fix warning in custom vasprintf
+	*    FIXED: Modify CMakeLists.txt to test for use of clang compiler
+	*    FIXED: Work on memory leaks
+	*    NOTE: Adjust license width to improve display on smaller terminal windows
+
+
+* 2017-02-14 -- v 0.3.0a:
+
+	*    ADDED: Add basic image support to LaTeX
+	*    ADDED: Add file transclusion
+	*    ADDED: Add support for citation 'locators'
+	*    ADDED: Add support for manual labels on ATX Headers
+	*    ADDED: Add support for manual labels on Setext Headers
+	*    ADDED: Add support for tables in LaTeX
+	*    ADDED: HTML Comments appear as raw LaTeX
+	*    ADDED: Improved citation support in LaTeX
+	*    ADDED: Support \autoref{} in LaTeX
+	*    ADDED: Support combined options in LaTeX citations that use the '\]\[' syntax
+	*    ADDED: Support language specifier in fenced code blocks
+	*    ADDED: Support metadata in LaTeX
+	*    ADDED: Update Citations test suite
+	*    FIXED: Escaped LaTeX characters
+	*    FIXED: Fix bug in URL parsing
+	*    FIXED: Fix bug in citation links
+	*    FIXED: Fix bug when no closing divider or newline at end of last table cell
+	*    FIXED: Fix issue printing '-'
+	*    FIXED: Fix scan_url test suite
+	*    FIXED: Get Math working in LaTeX
+	*    FIXED: Improve reliability or link scanner
+	*    FIXED: Properly add id attribute to new instances of citation only
+	*    FIXED: Properly handle manual labels with TOC
+	*    FIXED: Properly print hash characters in LaTeX
+	*    FIXED: Separate LaTeX verbatim and texttt character handling
+	*    FIXED: Update Escapes test LaTeX result
+	*    FIXED: Work on escaping LaTeX characters
+
+
+* 2017-02-08 -- v 0.1.4a:
+
+	*    ADDED: Add smart quote support for other languages (resolves #15)
+
+
+* 2017-02-08 -- v 0.1.3a:
+
+	*    ADDED: Add support for reference image id attributes
+	*    ADDED: Add support for table captions
+	*    ADDED: Metadata support for base header level
+	*    ADDED: Support distinction between 3 and 5 backticks in fenced code blocks
+	*    ADDED: Support Setext headers
+	*    FIXED: Fix issue with metadata disrupting smart quotes
+
+* 2017-02-07 --  v 0.1.2a:
+
+	* "pathologic" test suite -- fix handling of nested brackets, e.g.
+	`[[[[foo]]]]` to avoid bogging down checking for reference links that
+	don't exist.  
+	* Table support -- a single blank line separates sections of tables, so
+	at least two blank lines are needed between adjacent tables.
+	* Definition list support
+	* "fuzz testing" -- stress test the parser for unexpected failures
+	* Table of Contents support
+	* Improved compatibility mode parsing
+
+* 2017-01-28 -- v 0.1.1a includes a few updates:
+
+	* Metadata support
+	* Metadata variables support
+	* Extended ASCII range character checking
+	* Rudimentary language translations, including German
+	* Improved performance
+	* Additional testing:
+		* CriticMarkup
+		* HTML Blokcs
+		* Metadata/Variables
+		* "pathologic" test cases from CommonMark
+
diff --git a/README.md b/README.md
index 3ce8774..5d08aa6 100644
--- a/README.md
+++ b/README.md
@@ -9,222 +9,54 @@
 | Version:   | 6.0.0-b2      |  
 
 
-## Updates ##
-
-* 2017-03-13 -- v 6.0.0-b2:
-
-	*    ADDED: Add CriticMarkup preprocessor that works across empty lines when accepting/rejecting markup
-	*    ADDED: Add back the mmd6 latex title file
-	*    ADDED: Basic EPUB 3 support -- uses 'miniz' library to zip creation
-	*    ADDED: Update QuickStart and EPUB code
-	*    CHANGED: Update QuickStart guide
-	*    CHANGED: Update test suite
-	*    FIXED: Don't duplicate LaTeX glossary definitions
-	*    FIXED: Fix abbreviations in ODF; Improve test suite
-	*    FIXED: Improve glossaries and abbreviations; Update QuickStart
-	*    FIXED: Tidy up some compiler warnings in code
-	*    FIXED: Use custom UUID code to minimize external dependencies
-
-
-* 2017-03-09 -- v 6.0.0-b1:
-
-	*    ADDED: Add French translations; fix typo in German
-	*    ADDED: Add Quick Start guide
-	*    ADDED: Add functionality to automatically identify abbreviations and glossary terms in source
-	*    ADDED: Improve LaTeX configuration files
-	*    ADDED: Update German translations
-	*    ADDED: Use native ODF table of contents instead of a manual list
-	*    ADDED: Use native command for table of contents in LaTeX
-	*    CHANGED: Bring HTML and ODF into line with LaTeX as to output of abbreviatinos on first and subsequent uses
-	*    CHANGED: Slight performance tweak
-	*    CHANGED: Update German test suite
-	*    FIXED: Allow {{TOC}} in latex verbatim
-	*    FIXED: Don't free token_pool if never initialized
-	*    FIXED: Fix German typo
-	*    FIXED: Fix missing token type
-	*    FIXED: Improve performance of checking document for metadata, which improves performance when checking for possible transclusion
-	*    FIXED: Update test suite for abbreviation changes
-
-
-* 2017-03-05 -- v 0.4.2-b:
-
-	*    ADDED: Add  and  utility functions; fix memory leak
-	*    ADDED: Initial abbreviation support
-	*    ADDED: Keep working on Abbreviations/Glossaries
-	*    ADDED: Refactor abbreviation code; Add inline abbreviations; Fix abbreviations in ODF
-	*    ADDED: Update Inline Footnote test
-	*    CHANGED: Add comments to i18n.h
-	*    CHANGED: Finish refactoring note-related code
-	*    CHANGED: Refactor footnotes
-	*    CHANGED: Refactor glossary code
-	*    CHANGED: Remove offset from html export functions
-	*    FIXED: latex list items need to block optional argument to allow '[' as first character
-	*    Merge branch 'release/0.4.1-b' into develop
-
-
-* 2017-03-04 -- v 0.4.1-b:
-
-	*    FIXED: Add glossary localization
-
-
-* 2017-03-04 -- v 0.4.0-b:
-
-	*    ADDED: Add TOC support to ODF
-	*    ADDED: Add glossary support to ODF
-	*    ADDED: Add prelim code for handling abbreviations
-	*    ADDED: Add support for Swift Package Maker; CHANGED: Restructure source directory
-	*    ADDED: Added LaTeX support for escaped characters, fenced code blocks, images, links
-	*    ADDED: Basic ODF Support
-	*    ADDED: Better document strong/emph algorithm
-	*    ADDED: Continue ODF progress
-	*    ADDED: Continue to work on ODF export
-	*    ADDED: Continue work on ODF
-	*    ADDED: Finish ODF support for lists
-	*    ADDED: Improve performance when exporting
-	*    ADDED: Improve token_pool memory handling
-	*    ADDED: Prototype support for Glossaries
-	*    ADDED: Support 'latexconfig' metadata
-	*    CHANGED: Use multiple cases in glossary tests
-	*    FIXED: Don't force glossary terms into lowercase
-	*    FIXED: Fix Makefile for new source file location
-	*    FIXED: Fix algorithm for creating TOC to properly handle 'incorrect' levels
-	*    FIXED: Fix linebreaks in LaTeX; ADDED: Add Linebreaks test file
-	*    FIXED: Fix new_source script for new directory structure
-	*    FIXED: Fix non-breaking space in ODF
-	*    FIXED: Fix padding at end of document body in ODF
-	*    FIXED: Fix underscores in raw latex
-	*    FIXED: Potential bug
-	*    NOTE: Add shared library build option
-
-
-* 2017-02-17 -- v 0.3.1.a:
-
-	*    ADDED: 'finalize' beamer support
-	*    ADDED: Add escaped newline as linebreak; start on beamer/memoir support
-	*    ADDED: CriticMarkup test for LaTeX
-	*    ADDED: Custom LaTeX output for CriticMarkup comments
-	*    ADDED: Support mmd export format
-	*    ADDED: Work on cpack installer -- change project name for compatibility
-	*    CHANGED: Adjust latex metadata configuration for consistency
-	*    CHANGED: Configure cmake to use C99
-	*    FIXED: Add custom  implementation for cross-platform support
-	*    FIXED: Fix German HTML tests
-	*    FIXED: Fix cpack destination directory issue
-	*    FIXED: Fix memory leaks etc
-	*    FIXED: Fix warning in custom vasprintf
-	*    FIXED: Modify CMakeLists.txt to test for use of clang compiler
-	*    FIXED: Work on memory leaks
-	*    NOTE: Adjust license width to improve display on smaller terminal windows
-
-
-* 2017-02-14 -- v 0.3.0a:
-
-	*    ADDED: Add basic image support to LaTeX
-	*    ADDED: Add file transclusion
-	*    ADDED: Add support for citation 'locators'
-	*    ADDED: Add support for manual labels on ATX Headers
-	*    ADDED: Add support for manual labels on Setext Headers
-	*    ADDED: Add support for tables in LaTeX
-	*    ADDED: HTML Comments appear as raw LaTeX
-	*    ADDED: Improved citation support in LaTeX
-	*    ADDED: Support \autoref{} in LaTeX
-	*    ADDED: Support combined options in LaTeX citations that use the '\]\[' syntax
-	*    ADDED: Support language specifier in fenced code blocks
-	*    ADDED: Support metadata in LaTeX
-	*    ADDED: Update Citations test suite
-	*    FIXED: Escaped LaTeX characters
-	*    FIXED: Fix bug in URL parsing
-	*    FIXED: Fix bug in citation links
-	*    FIXED: Fix bug when no closing divider or newline at end of last table cell
-	*    FIXED: Fix issue printing '-'
-	*    FIXED: Fix scan_url test suite
-	*    FIXED: Get Math working in LaTeX
-	*    FIXED: Improve reliability or link scanner
-	*    FIXED: Properly add id attribute to new instances of citation only
-	*    FIXED: Properly handle manual labels with TOC
-	*    FIXED: Properly print hash characters in LaTeX
-	*    FIXED: Separate LaTeX verbatim and texttt character handling
-	*    FIXED: Update Escapes test LaTeX result
-	*    FIXED: Work on escaping LaTeX characters
-
-
-* 2017-02-08 -- v 0.1.4a:
-
-	*    ADDED: Add smart quote support for other languages (resolves #15)
-
-
-* 2017-02-08 -- v 0.1.3a:
-
-	*    ADDED: Add support for reference image id attributes
-	*    ADDED: Add support for table captions
-	*    ADDED: Metadata support for base header level
-	*    ADDED: Support distinction between 3 and 5 backticks in fenced code blocks
-	*    ADDED: Support Setext headers
-	*    FIXED: Fix issue with metadata disrupting smart quotes
-
-* 2017-02-07 --  v 0.1.2a:
-
-	* "pathologic" test suite -- fix handling of nested brackets, e.g.
-	`[[[[foo]]]]` to avoid bogging down checking for reference links that
-	don't exist.  
-	* Table support -- a single blank line separates sections of tables, so
-	at least two blank lines are needed between adjacent tables.
-	* Definition list support
-	* "fuzz testing" -- stress test the parser for unexpected failures
-	* Table of Contents support
-	* Improved compatibility mode parsing
-
-* 2017-01-28 -- v 0.1.1a includes a few updates:
-
-	* Metadata support
-	* Metadata variables support
-	* Extended ASCII range character checking
-	* Rudimentary language translations, including German
-	* Improved performance
-	* Additional testing:
-		* CriticMarkup
-		* HTML Blokcs
-		* Metadata/Variables
-		* "pathologic" test cases from CommonMark
+## An Announcement! ##
 
+MultiMarkdown v6 is finally here!  It's technically still in "beta" as I would
+like to hear back from a few more users to make sure I'm not missing anything,
+but it has been subjected to much more rigorous testing than any previous
+versions of MultiMarkdown in the past.  If you want more information about
+testing, see `DevelopmentNotes`.  It's basically feature complete as a
+replacement for MMD v5, and included additional features beyond that.
 
-## An Announcement! ##
 
-I would like to officially announce that MultiMarkdown version 6 is in public
-alpha.  It's finally at a point where it is usable, but there are quite a few
-caveats.
+## Obtaining MultiMarkdown ##
+
+You can download the latest installer for MacOS or Windows at Github:
+
+<https://github.com/fletcher/MultiMarkdown-6/releases>
 
-This post is a way for me to organize some of my thoughts, provide some
-history for those who are interested, and to provide some tips and tricks from
-my experiences for those who are working on their own products.
+To build from source, download from Github.  Then:
 
-But first, some background...
+	make release
+	(OR)
+	make debug
 
+	cd build
+	make
+
+You can optionally test using the test suite:
+
+	ctest
 
 
 ## Differences in MultiMarkdown Itself ##
 
-MultiMarkdown v6 is mostly about making a better MMD parser, but it will
-likely involve a few changes to the MultiMarkdown language itself.
+MultiMarkdown v6 is mostly about making a better MMD parser, but it involves a
+few changes to the MultiMarkdown syntax itself.
 
+1. Setext headers can consist of more than one line to be included in the
+header:
 
-1. {--I am thinking about removing Setext headers from the language.  I almost
-never use them, much preferring to use ATX style headers (`# foo #`).
-Additionally, I have never liked the fact that Setext headers allow the
-meaning of a line to be completely changed by the following line.  It makes
-the parsing slightly more difficult on a technical level (requiring some
-backtracking at times).  I'm not 100% certain on this, but right now I believe
-it's the only Markdown feature that doesn't exist in MMD 6 yet.--}{++I decided
-to go ahead and implement Setext headers, as it can be done with the new
-parser without backtracking.  One difference with older versions of MMD, as
-well as Markdown itself, is that a setext header can consist of more than one
-line to be included in the header.++}
+		This is
+		a header
+		========
 
 2. Whitespace is not allowed between the text brackets and label brackets in
 reference links, images, footnotes, etc.  For example `[foo] [bar]` will no
 longer be the same as `[foo][bar]`.
 
 3. Link and image titles can be quoted with `'foo'`, `"foo"`, or `(foo)`.
+Link attributes can be used in both reference and inline links/images.
 
 4. HTML elements are handled slightly differently.  There is no longer a
 `markdown="1"` feature.  Instead, HTML elements that are on a line by
@@ -232,7 +64,8 @@ themselves will open an HTML block that will cause the rest of the "paragraph"
 to be treated as HTML such that Markdown will not be parsed in side of it.
 HTML block-level tags are even "stronger" at starting an HTML block.  It is
 not quite as complex as the approach used in CommonMark, but is similar under
-most circumstances.
+most circumstances.  Leaving a blank line after the opening tag will allow
+MultiMarkdown parsing inside of the HTML block.
 
 	For example, this would not be parsed:
 
@@ -249,9 +82,10 @@ most circumstances.
 		</div>
 
 5. "Malformed" reference link definitions are handled slightly differently.
-For example, `Reference Footnotes.text` is parsed differently in compatibility
-mode than MMD-5.  This started as a side-effect of the parsing algorithm, but
-I actually think it makes sense.  This may or may not change in the future.
+For example, the test suite file `Reference Footnotes.text` is parsed
+differently in compatibility mode than MMD-5.  This started as a side-effect
+of the parsing algorithm, but I actually think it makes sense.  This may or
+may not change in the future.
 
 6. Table captions in MMD-6 must come immediately *after* the table, not
 before it.
@@ -261,61 +95,28 @@ before it.
 feature in MMD, but I don't see a problem with just making it default 
 behavior.
 
+8. Escaped spaces (`\ `) will be interpreted as a non-breaking space, if the
+output format supports it.
 
-## Where Does MultiMarkdown 6 Stand? ##
-
-
-### Features ###
-
-I *think* that all basic Markdown features have been implemented.
-Additionally, the following MultiMarkdown features have been implemented:
-
-* Automatic cross-reference targets
-* Basic Citation support
-* CriticMarkup support
-* Definition lists
-* Figures
-* Footnotes
-* Inline and reference footnotes
-* Image and Link attributes (attributes can now be used with inline links as
-	well as reference links)
-* Math support
-* Smart quotes (support for languages other than english is not fully
-	implemented yet)
-* Superscripts/subscripts
-* Table of Contents
-* Tables
-
-
-Things that are partially completed:
-
-* Citations -- still need:
-	* Syntax for "not cited" entries
-	* Output format
-	* HTML --> separate footnotes and citations?
-	* Locators required?
-* CriticMarkup -- need to decide:
-	* How to handle CM stretches that include blank lines
-* Fenced code blocks
-* Headers -- need support for manual labels
-* Metadata
-* Full/Snippet modes
-
-
-Things yet to be completed:
-
-* Abbreviations
-* Glossaries
-* File Transclusion
+9. CriticMarkup, Abbreviations, Glossary Terms, and Citations are handled
+slightly differently.  See the QuickStart guide for more information.
 
+10. Fenced code blocks can use leading/trailing "fences" of 3, 4, or 5
+backticks in length.  That should be sufficient for complex documents without
+requiring a more complex parser.  If there is no trailing fence, then the
+fenced block is considered to go through the end of the document.
 
-### Accuracy ###
+11. Emph and Strong parsing is conceptually the same, but the implementation
+is different.  It is designed for speed, accuracy, and consistency.  In
+general, it seems to handle edge cases much more reliably, but there are still
+a couple of situations that I would like to take into account, if possible.
+These are not situations that should occur often in "real life."
 
-MultiMarkdown v6 successfully parses the Markdown [syntax page], except for
-the Setext header at the top.  It passes the 29 test files currently in place.
-There are a few at
+12. EPUB 3 output is supported without need of any external tools.
 
-[syntax page]: https://daringfireball.net/projects/markdown/syntax
+13. Internationalization support for HTML phrases, such as "see footnote". See
+[Github](https://github.com/fletcher/MultiMarkdown-6/issues/37) for more
+information.
 
 
 
diff --git a/templates/README.md.in b/templates/README.md.in
index 5e388de..cada7c7 100644
--- a/templates/README.md.in
+++ b/templates/README.md.in
@@ -9,222 +9,54 @@
 | Version:   | @My_Project_Version@      |  
 
 
-## Updates ##
-
-* 2017-03-13 -- v 6.0.0-b2:
-
-	*    ADDED: Add CriticMarkup preprocessor that works across empty lines when accepting/rejecting markup
-	*    ADDED: Add back the mmd6 latex title file
-	*    ADDED: Basic EPUB 3 support -- uses 'miniz' library to zip creation
-	*    ADDED: Update QuickStart and EPUB code
-	*    CHANGED: Update QuickStart guide
-	*    CHANGED: Update test suite
-	*    FIXED: Don't duplicate LaTeX glossary definitions
-	*    FIXED: Fix abbreviations in ODF; Improve test suite
-	*    FIXED: Improve glossaries and abbreviations; Update QuickStart
-	*    FIXED: Tidy up some compiler warnings in code
-	*    FIXED: Use custom UUID code to minimize external dependencies
-
-
-* 2017-03-09 -- v 6.0.0-b1:
-
-	*    ADDED: Add French translations; fix typo in German
-	*    ADDED: Add Quick Start guide
-	*    ADDED: Add functionality to automatically identify abbreviations and glossary terms in source
-	*    ADDED: Improve LaTeX configuration files
-	*    ADDED: Update German translations
-	*    ADDED: Use native ODF table of contents instead of a manual list
-	*    ADDED: Use native command for table of contents in LaTeX
-	*    CHANGED: Bring HTML and ODF into line with LaTeX as to output of abbreviatinos on first and subsequent uses
-	*    CHANGED: Slight performance tweak
-	*    CHANGED: Update German test suite
-	*    FIXED: Allow {{TOC}} in latex verbatim
-	*    FIXED: Don't free token_pool if never initialized
-	*    FIXED: Fix German typo
-	*    FIXED: Fix missing token type
-	*    FIXED: Improve performance of checking document for metadata, which improves performance when checking for possible transclusion
-	*    FIXED: Update test suite for abbreviation changes
-
-
-* 2017-03-05 -- v 0.4.2-b:
-
-	*    ADDED: Add  and  utility functions; fix memory leak
-	*    ADDED: Initial abbreviation support
-	*    ADDED: Keep working on Abbreviations/Glossaries
-	*    ADDED: Refactor abbreviation code; Add inline abbreviations; Fix abbreviations in ODF
-	*    ADDED: Update Inline Footnote test
-	*    CHANGED: Add comments to i18n.h
-	*    CHANGED: Finish refactoring note-related code
-	*    CHANGED: Refactor footnotes
-	*    CHANGED: Refactor glossary code
-	*    CHANGED: Remove offset from html export functions
-	*    FIXED: latex list items need to block optional argument to allow '[' as first character
-	*    Merge branch 'release/0.4.1-b' into develop
-
-
-* 2017-03-04 -- v 0.4.1-b:
-
-	*    FIXED: Add glossary localization
-
-
-* 2017-03-04 -- v 0.4.0-b:
-
-	*    ADDED: Add TOC support to ODF
-	*    ADDED: Add glossary support to ODF
-	*    ADDED: Add prelim code for handling abbreviations
-	*    ADDED: Add support for Swift Package Maker; CHANGED: Restructure source directory
-	*    ADDED: Added LaTeX support for escaped characters, fenced code blocks, images, links
-	*    ADDED: Basic ODF Support
-	*    ADDED: Better document strong/emph algorithm
-	*    ADDED: Continue ODF progress
-	*    ADDED: Continue to work on ODF export
-	*    ADDED: Continue work on ODF
-	*    ADDED: Finish ODF support for lists
-	*    ADDED: Improve performance when exporting
-	*    ADDED: Improve token_pool memory handling
-	*    ADDED: Prototype support for Glossaries
-	*    ADDED: Support 'latexconfig' metadata
-	*    CHANGED: Use multiple cases in glossary tests
-	*    FIXED: Don't force glossary terms into lowercase
-	*    FIXED: Fix Makefile for new source file location
-	*    FIXED: Fix algorithm for creating TOC to properly handle 'incorrect' levels
-	*    FIXED: Fix linebreaks in LaTeX; ADDED: Add Linebreaks test file
-	*    FIXED: Fix new_source script for new directory structure
-	*    FIXED: Fix non-breaking space in ODF
-	*    FIXED: Fix padding at end of document body in ODF
-	*    FIXED: Fix underscores in raw latex
-	*    FIXED: Potential bug
-	*    NOTE: Add shared library build option
-
-
-* 2017-02-17 -- v 0.3.1.a:
-
-	*    ADDED: 'finalize' beamer support
-	*    ADDED: Add escaped newline as linebreak; start on beamer/memoir support
-	*    ADDED: CriticMarkup test for LaTeX
-	*    ADDED: Custom LaTeX output for CriticMarkup comments
-	*    ADDED: Support mmd export format
-	*    ADDED: Work on cpack installer -- change project name for compatibility
-	*    CHANGED: Adjust latex metadata configuration for consistency
-	*    CHANGED: Configure cmake to use C99
-	*    FIXED: Add custom  implementation for cross-platform support
-	*    FIXED: Fix German HTML tests
-	*    FIXED: Fix cpack destination directory issue
-	*    FIXED: Fix memory leaks etc
-	*    FIXED: Fix warning in custom vasprintf
-	*    FIXED: Modify CMakeLists.txt to test for use of clang compiler
-	*    FIXED: Work on memory leaks
-	*    NOTE: Adjust license width to improve display on smaller terminal windows
-
-
-* 2017-02-14 -- v 0.3.0a:
-
-	*    ADDED: Add basic image support to LaTeX
-	*    ADDED: Add file transclusion
-	*    ADDED: Add support for citation 'locators'
-	*    ADDED: Add support for manual labels on ATX Headers
-	*    ADDED: Add support for manual labels on Setext Headers
-	*    ADDED: Add support for tables in LaTeX
-	*    ADDED: HTML Comments appear as raw LaTeX
-	*    ADDED: Improved citation support in LaTeX
-	*    ADDED: Support \autoref{} in LaTeX
-	*    ADDED: Support combined options in LaTeX citations that use the '\]\[' syntax
-	*    ADDED: Support language specifier in fenced code blocks
-	*    ADDED: Support metadata in LaTeX
-	*    ADDED: Update Citations test suite
-	*    FIXED: Escaped LaTeX characters
-	*    FIXED: Fix bug in URL parsing
-	*    FIXED: Fix bug in citation links
-	*    FIXED: Fix bug when no closing divider or newline at end of last table cell
-	*    FIXED: Fix issue printing '-'
-	*    FIXED: Fix scan_url test suite
-	*    FIXED: Get Math working in LaTeX
-	*    FIXED: Improve reliability or link scanner
-	*    FIXED: Properly add id attribute to new instances of citation only
-	*    FIXED: Properly handle manual labels with TOC
-	*    FIXED: Properly print hash characters in LaTeX
-	*    FIXED: Separate LaTeX verbatim and texttt character handling
-	*    FIXED: Update Escapes test LaTeX result
-	*    FIXED: Work on escaping LaTeX characters
-
-
-* 2017-02-08 -- v 0.1.4a:
-
-	*    ADDED: Add smart quote support for other languages (resolves #15)
-
-
-* 2017-02-08 -- v 0.1.3a:
-
-	*    ADDED: Add support for reference image id attributes
-	*    ADDED: Add support for table captions
-	*    ADDED: Metadata support for base header level
-	*    ADDED: Support distinction between 3 and 5 backticks in fenced code blocks
-	*    ADDED: Support Setext headers
-	*    FIXED: Fix issue with metadata disrupting smart quotes
-
-* 2017-02-07 --  v 0.1.2a:
-
-	* "pathologic" test suite -- fix handling of nested brackets, e.g.
-	`[[[[foo]]]]` to avoid bogging down checking for reference links that
-	don't exist.  
-	* Table support -- a single blank line separates sections of tables, so
-	at least two blank lines are needed between adjacent tables.
-	* Definition list support
-	* "fuzz testing" -- stress test the parser for unexpected failures
-	* Table of Contents support
-	* Improved compatibility mode parsing
-
-* 2017-01-28 -- v 0.1.1a includes a few updates:
-
-	* Metadata support
-	* Metadata variables support
-	* Extended ASCII range character checking
-	* Rudimentary language translations, including German
-	* Improved performance
-	* Additional testing:
-		* CriticMarkup
-		* HTML Blokcs
-		* Metadata/Variables
-		* "pathologic" test cases from CommonMark
+## An Announcement! ##
 
+MultiMarkdown v6 is finally here!  It's technically still in "beta" as I would
+like to hear back from a few more users to make sure I'm not missing anything,
+but it has been subjected to much more rigorous testing than any previous
+versions of MultiMarkdown in the past.  If you want more information about
+testing, see `DevelopmentNotes`.  It's basically feature complete as a
+replacement for MMD v5, and included additional features beyond that.
 
-## An Announcement! ##
 
-I would like to officially announce that MultiMarkdown version 6 is in public
-alpha.  It's finally at a point where it is usable, but there are quite a few
-caveats.
+## Obtaining MultiMarkdown ##
+
+You can download the latest installer for MacOS or Windows at Github:
+
+<https://github.com/fletcher/MultiMarkdown-6/releases>
 
-This post is a way for me to organize some of my thoughts, provide some
-history for those who are interested, and to provide some tips and tricks from
-my experiences for those who are working on their own products.
+To build from source, download from Github.  Then:
 
-But first, some background...
+	make release
+	(OR)
+	make debug
 
+	cd build
+	make
+
+You can optionally test using the test suite:
+
+	ctest
 
 
 ## Differences in MultiMarkdown Itself ##
 
-MultiMarkdown v6 is mostly about making a better MMD parser, but it will
-likely involve a few changes to the MultiMarkdown language itself.
+MultiMarkdown v6 is mostly about making a better MMD parser, but it involves a
+few changes to the MultiMarkdown syntax itself.
 
+1. Setext headers can consist of more than one line to be included in the
+header:
 
-1. {--I am thinking about removing Setext headers from the language.  I almost
-never use them, much preferring to use ATX style headers (`# foo #`).
-Additionally, I have never liked the fact that Setext headers allow the
-meaning of a line to be completely changed by the following line.  It makes
-the parsing slightly more difficult on a technical level (requiring some
-backtracking at times).  I'm not 100% certain on this, but right now I believe
-it's the only Markdown feature that doesn't exist in MMD 6 yet.--}{++I decided
-to go ahead and implement Setext headers, as it can be done with the new
-parser without backtracking.  One difference with older versions of MMD, as
-well as Markdown itself, is that a setext header can consist of more than one
-line to be included in the header.++}
+		This is
+		a header
+		========
 
 2. Whitespace is not allowed between the text brackets and label brackets in
 reference links, images, footnotes, etc.  For example `[foo] [bar]` will no
 longer be the same as `[foo][bar]`.
 
 3. Link and image titles can be quoted with `'foo'`, `"foo"`, or `(foo)`.
+Link attributes can be used in both reference and inline links/images.
 
 4. HTML elements are handled slightly differently.  There is no longer a
 `markdown="1"` feature.  Instead, HTML elements that are on a line by
@@ -232,7 +64,8 @@ themselves will open an HTML block that will cause the rest of the "paragraph"
 to be treated as HTML such that Markdown will not be parsed in side of it.
 HTML block-level tags are even "stronger" at starting an HTML block.  It is
 not quite as complex as the approach used in CommonMark, but is similar under
-most circumstances.
+most circumstances.  Leaving a blank line after the opening tag will allow
+MultiMarkdown parsing inside of the HTML block.
 
 	For example, this would not be parsed:
 
@@ -249,9 +82,10 @@ most circumstances.
 		</div>
 
 5. "Malformed" reference link definitions are handled slightly differently.
-For example, `Reference Footnotes.text` is parsed differently in compatibility
-mode than MMD-5.  This started as a side-effect of the parsing algorithm, but
-I actually think it makes sense.  This may or may not change in the future.
+For example, the test suite file `Reference Footnotes.text` is parsed
+differently in compatibility mode than MMD-5.  This started as a side-effect
+of the parsing algorithm, but I actually think it makes sense.  This may or
+may not change in the future.
 
 6. Table captions in MMD-6 must come immediately *after* the table, not
 before it.
@@ -261,61 +95,28 @@ before it.
 feature in MMD, but I don't see a problem with just making it default 
 behavior.
 
+8. Escaped spaces (`\ `) will be interpreted as a non-breaking space, if the
+output format supports it.
 
-## Where Does MultiMarkdown 6 Stand? ##
-
-
-### Features ###
-
-I *think* that all basic Markdown features have been implemented.
-Additionally, the following MultiMarkdown features have been implemented:
-
-* Automatic cross-reference targets
-* Basic Citation support
-* CriticMarkup support
-* Definition lists
-* Figures
-* Footnotes
-* Inline and reference footnotes
-* Image and Link attributes (attributes can now be used with inline links as
-	well as reference links)
-* Math support
-* Smart quotes (support for languages other than english is not fully
-	implemented yet)
-* Superscripts/subscripts
-* Table of Contents
-* Tables
-
-
-Things that are partially completed:
-
-* Citations -- still need:
-	* Syntax for "not cited" entries
-	* Output format
-	* HTML --> separate footnotes and citations?
-	* Locators required?
-* CriticMarkup -- need to decide:
-	* How to handle CM stretches that include blank lines
-* Fenced code blocks
-* Headers -- need support for manual labels
-* Metadata
-* Full/Snippet modes
-
-
-Things yet to be completed:
-
-* Abbreviations
-* Glossaries
-* File Transclusion
+9. CriticMarkup, Abbreviations, Glossary Terms, and Citations are handled
+slightly differently.  See the QuickStart guide for more information.
 
+10. Fenced code blocks can use leading/trailing "fences" of 3, 4, or 5
+backticks in length.  That should be sufficient for complex documents without
+requiring a more complex parser.  If there is no trailing fence, then the
+fenced block is considered to go through the end of the document.
 
-### Accuracy ###
+11. Emph and Strong parsing is conceptually the same, but the implementation
+is different.  It is designed for speed, accuracy, and consistency.  In
+general, it seems to handle edge cases much more reliably, but there are still
+a couple of situations that I would like to take into account, if possible.
+These are not situations that should occur often in "real life."
 
-MultiMarkdown v6 successfully parses the Markdown [syntax page], except for
-the Setext header at the top.  It passes the 29 test files currently in place.
-There are a few at
+12. EPUB 3 output is supported without need of any external tools.
 
-[syntax page]: https://daringfireball.net/projects/markdown/syntax
+13. Internationalization support for HTML phrases, such as "see footnote". See
+[Github](https://github.com/fletcher/MultiMarkdown-6/issues/37) for more
+information.
 
 
 
-- 
2.40.0