diff --git a/docs/css/extra.css b/docs/css/extra.css
index 0f6c9c5634f85be9c46d6f47a048948bd69eb8e3..9876f66cc4686fb3e86c6a6b524ebdf5d96eaf45 100644
--- a/docs/css/extra.css
+++ b/docs/css/extra.css
@@ -120,3 +120,180 @@ a:hover {
color: #fff;
background-color: #453A62;
}
+
+
+input[type="checkbox"] {
+ display: none;
+}
+
+.wrap-collabsible {
+ margin: 1.2rem 0;
+}
+
+
+.lbl-toggle {
+ margin: 0px;
+}
+
+.toggle:checked + .lbl-toggle::before {
+ transform: rotate(90deg) translateX(-3px);
+}
+
+.collapsible-content {
+ margin-top: 5px;
+ max-height: 0px;
+ overflow: hidden;
+ transition: max-height 0.25s ease-in-out;
+}
+
+.toggle:checked + .lbl-toggle ~ .collapsible-content {
+ max-height: 500px;
+}
+
+.toggle:checked + .lbl-toggle {
+ border-bottom-right-radius: 0;
+ border-bottom-left-radius: 0;
+}
+
+.collapsible-content .content-inner {
+ background: rgba(0, 105, 255, 0.2);
+ border-bottom: 1px solid rgba(0, 105, 255, 0.45);
+ border-bottom-left-radius: 7px;
+ border-bottom-right-radius: 7px;
+ padding: 0.5rem 1rem;
+}
+
+.collapsible-content p {
+ margin-bottom: 0;
+}
+
+
+.platform-name img {
+ max-width: 40px;
+ max-height: 30px;
+ display: block;
+
+ max-width: 100%;
+ padding: unset;
+ line-height: unset;
+ background-color: unset;
+ border: unset;
+ border-radius: unset;
+ margin: 20px auto 0px auto;
+}
+
+
+.expander div {
+ position: relative;
+ height: 50px;
+ width: 40px;
+ margin: 10px auto 0px auto;
+ display: block;
+}
+
+.expander img {
+ position: absolute;
+ width: 40px;
+ display: block;
+ transition: all 400ms ease;
+
+ max-width: 100%;
+ padding: unset;
+ line-height: unset;
+ background-color: unset;
+ border: unset;
+ border-radius: unset;
+ margin: 0px auto 0px auto;
+}
+
+.expander img.expand-2 {
+ top: 8px;
+}
+
+.expander img.expand-3 {
+ top: 16px;
+}
+
+.expander:hover img.expand-2 {transform: translateY(5px);}
+.expander:hover img.expand-3 {transform: translateY(10px);}
+
+div.platforms {
+ display: flex;
+ justify-content: center;
+}
+
+div.platform {
+ margin: 0px 20px 0px 20px;
+}
+
+
+#linux-link, #mac-link, #freebsd-link, #windows-link, #wsl-link {
+ display: none;
+}
+
+#linux-link:target, #mac-link:target, #freebsd-link:target, #windows-link:target, #wsl-link:target {
+ display: block;
+}
+
+:target:before {
+content:"";
+display:block;
+height:150px; /* fixed header height*/
+margin:-150px 0 0; /* negative fixed header height */
+}
+
+
+.command-button {
+ display: flex;
+ align-items: center;
+}
+
+.command-button > pre {
+ background-color: #515151;
+ color: white;
+ margin: auto;
+ margin-top: 0px;
+ padding-top: 1rem;
+ padding-bottom: 1rem;
+ padding-right: 1rem;
+ text-align: center;
+ border-radius: 3px;
+ box-shadow: inset 0px 0px 20px 0px #333333;
+ font-size: 1em;
+ width: 55rem;
+ overflow: auto;
+ white-space: nowrap;
+}
+
+.ghcup-command:before {
+ color: #999;
+ content: " $ ";
+}
+
+div.command-button {
+ display: flex;
+ align-items: center;
+}
+
+div.command-button button {
+ color: white;
+ /* border: none; */
+ background-color: rgb(242, 242, 242);
+ border-width: 2px;
+ border-style: solid;
+ border-radius: 3px;
+
+ margin-left: 0.5rem;
+ margin-right: auto;
+ margin-top: 25px;
+ margin-bottom: 25px;
+ text-align: center;
+}
+
+div.command-button button:hover {
+ background: rgb(232, 232, 232);
+}
+
+div.command-button button:focus {
+ background: rgb(222, 222, 222);
+}
diff --git a/docs/expand-piece.svg b/docs/expand-piece.svg
new file mode 100644
index 0000000000000000000000000000000000000000..d76090f028cc98fc9ff462d1c7c8606aac734da9
--- /dev/null
+++ b/docs/expand-piece.svg
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="158.21451"
+ height="33.036404"
+ id="svg2997"
+ version="1.1"
+ inkscape:version="0.48.5 r10040"
+ sodipodi:docname="expand-piece.svg">
+ <defs
+ id="defs2999" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="11.2"
+ inkscape:cx="74.534935"
+ inkscape:cy="-6.6497355"
+ inkscape:document-units="px"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ fit-margin-top="0"
+ fit-margin-left="0"
+ fit-margin-right="0"
+ fit-margin-bottom="0"
+ inkscape:window-width="2560"
+ inkscape:window-height="1374"
+ inkscape:window-x="0"
+ inkscape:window-y="27"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata3002">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title />
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-218.01937,-324.40519)">
+ <path
+ style="fill:none;stroke:#524a67;stroke-width:13;stroke-linecap:round;stroke-linejoin:bevel;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+ d="m 224.64286,330.93361 74.64102,20 70.35898,-18.85263"
+ id="path2994"
+ inkscape:connector-curvature="0" />
+ </g>
+</svg>
diff --git a/docs/index.md b/docs/index.md
index 2e46ec16705953e9ef145d5eee6abc2cb5a74519..e6caa7b5e94c89a08edfaf050916d07dfc07f929 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -22,11 +22,111 @@ GHCup makes it easy to install specific versions of GHC on GNU/Linux,
macOS (aka Darwin), FreeBSD and Windows and can also bootstrap a fresh [Haskell developer environment](./install/#supported-tools) from scratch.
It follows the unix UNIX philosophy of [do one thing and do it well](https://en.wikipedia.org/wiki/Unix_philosophy#Do_One_Thing_and_Do_It_Well). Similar in scope to [rustup](https://github.com/rust-lang-nursery/rustup.rs), [pyenv](https://github.com/pyenv/pyenv) and [jenv](http://www.jenv.be).
-<div class="text-center">
-<a href="https://www.haskell.org/ghcup/" class="btn btn-primary" role="button">Quick Install</a>
+<div class="wrap-collabsible text-center"> <input id="collapsible" class="toggle" type="checkbox">
+<label for="collapsible" class="lbl-toggle btn btn-primary">Quick Install</label>
<a href="install/" class="btn btn-primary" role="button">Getting Started</a>
<a href="guide/" class="btn btn-primary" role="button">User Guide</a>
<a href="https://gitlab.haskell.org/haskell/ghcup-hs/-/issues" class="btn btn-primary" role="button">Issue tracker</a>
+ <div class="collapsible-content">
+ <div class="content-inner">
+ <h2>Select your platform</h3>
+ <div class="platforms">
+ <div class="platform">
+ <div class="platform-name"><img src="os-linux.svg" alt="Linux logo"> <h3>Linux</h3></div>
+ <a class="expander" href="#linux-link">
+ <div>
+ <img src="expand-piece.svg" class="expand-1">
+ <img src="expand-piece.svg" class="expand-2">
+ <img src="expand-piece.svg" class="expand-3">
+ </div>
+ </a>
+ </div>
+
+ <div class="platform">
+ <div class="platform-name"><img src="os-osx.svg" alt="Mac logo"> <h3>Mac OS X</h3></div>
+ <a class="expander" href="#mac-link">
+ <div>
+ <img src="expand-piece.svg" class="expand-1">
+ <img src="expand-piece.svg" class="expand-2">
+ <img src="expand-piece.svg" class="expand-3">
+ </div>
+ </a>
+ </div>
+
+ <div class="platform">
+ <div class="platform-name"><img src="os-freebsd.svg" alt="FreeBSD logo" style="fill: black;"> <h3>FreeBSD</h3></div>
+ <a class="expander" href="#freebsd-link">
+ <div>
+ <img src="expand-piece.svg" class="expand-1">
+ <img src="expand-piece.svg" class="expand-2">
+ <img src="expand-piece.svg" class="expand-3">
+ </div>
+ </a>
+ </div>
+
+ <div class="platform">
+ <div class="platform-name"><img src="os-windows.svg" alt="Windows logo"> <h3>Windows</h3></div>
+ <a class="expander" href="#windows-link">
+ <div>
+ <img src="expand-piece.svg" class="expand-1">
+ <img src="expand-piece.svg" class="expand-2">
+ <img src="expand-piece.svg" class="expand-3">
+ </div>
+ </a>
+ </div>
+
+ <div class="platform">
+ <div class="platform-name"><img src="os-windows.svg" alt="Windows logo"> <h3>WSL2</h3></div>
+ <a class="expander" href="#wsl-link">
+ <div>
+ <img src="expand-piece.svg" class="expand-1">
+ <img src="expand-piece.svg" class="expand-2">
+ <img src="expand-piece.svg" class="expand-3">
+ </div>
+ </a>
+ </div>
+
+ </div>
+
+ <div id="linux-link">
+ <hr/>
+ <h4>On Linux, run the following in your terminal (as a user other than root), then follow the onscreen instructions:</h4>
+ <div class="command-button">
+ <pre><span class="ghcup-command">curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh</span></pre>
+ </div>
+ </div>
+ <div id="mac-link">
+ <hr/>
+ <h4>On Mac, run the following in your terminal (as a user other than root), then follow the onscreen instructions:</h4>
+ <div class="command-button">
+ <pre><span class="ghcup-command">curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh</span></pre>
+ </div>
+ </div>
+ <div id="freebsd-link">
+ <hr/>
+ <h4>On FreeBSD, run the following in your terminal (as a user other than root), then follow the onscreen instructions:</h4>
+ <div class="command-button">
+ <pre><span class="ghcup-command">curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh</span></pre>
+ </div>
+ </div>
+ <div id="windows-link" class="anchor">
+ <hr/>
+ <h4>On Windows, run the following in a powershell session (as a non-admin user), then follow the onscreen instructions:</h4>
+ <div class="command-button">
+ <pre><span class="ghcup-command">Set-ExecutionPolicy Bypass -Scope Process -Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://www.haskell.org/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true</span></pre>
+ </div>
+ </div>
+
+ <div id="wsl-link">
+ <hr/>
+ <h4>On WSL2, run the following in your terminal (as a user other than root), then follow the onscreen instructions:</h4>
+ <div class="command-button">
+ <pre><span class="ghcup-command">curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh</span></pre>
+ </div>
+ </div>
+ </div>
+
+ </div>
</div>
diff --git a/docs/os-freebsd.svg b/docs/os-freebsd.svg
new file mode 100644
index 0000000000000000000000000000000000000000..ce1b59745324f078c24e1698d721a9a6d5ae9fe0
--- /dev/null
+++ b/docs/os-freebsd.svg
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Svg Vector Icons : http://www.onlinewebfonts.com/icon -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 1000 1000" enable-background="new 0 0 1000 1000" xml:space="preserve">
+<metadata> Svg Vector Icons : http://www.onlinewebfonts.com/icon </metadata>
+<g><path d="M81.5,647.7C11,409.2,148.6,158.9,388.6,88.9c106.5-31.1,215.5-21.4,309.8,19.8c-4.9,6.9-9.5,14-13.7,21c-46.1-10.7-81.4,3.8-90.2,43.3c-13.9,62.1,42.9,162.8,126.6,224.7c83.7,61.9,162.9,61.7,176.8-0.4c3.5-15.9,2.5-34.4-2.5-54.1c9.7-5.8,19.2-12.3,28.6-19.3c10.9,22.2,20,45.6,27.3,70.1c70.5,238.4-67.1,488.8-307.1,558.8C403.9,1022.8,151.9,886.1,81.5,647.7L81.5,647.7z M667.1,204.7c0.4-0.4,0.7-0.7,1-1.1C776.9,92.3,912.3,26.4,970.4,56.4c58.1,30.1-25.5,176.7-91.7,256.3c-20.1,20.6-41.2,39.7-62.5,56.8C742.2,343.2,686.1,282.8,667.1,204.7L667.1,204.7z M11,108.5C0.7,28.8,68.9,4.9,163.2,55.2c22.4,11.9,44.3,27,64.7,44.1c-56.2,38.6-104.5,90.4-139.5,154C46.4,206.7,16.9,153.5,11,108.5L11,108.5z"/></g>
+</svg>
\ No newline at end of file
diff --git a/docs/os-linux.svg b/docs/os-linux.svg
new file mode 100644
index 0000000000000000000000000000000000000000..18e483cb2dd178b599d485800bf17792b469cc92
--- /dev/null
+++ b/docs/os-linux.svg
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="708.66144"
+ height="857.81506"
+ id="svg3007"
+ version="1.1"
+ inkscape:version="0.48.5 r10040"
+ sodipodi:docname="linux.svg">
+ <defs
+ id="defs3009" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.35"
+ inkscape:cx="345.28122"
+ inkscape:cy="375.85573"
+ inkscape:document-units="px"
+ inkscape:current-layer="text2999"
+ showgrid="false"
+ inkscape:window-width="2560"
+ inkscape:window-height="1374"
+ inkscape:window-x="0"
+ inkscape:window-y="27"
+ inkscape:window-maximized="1"
+ units="cm"
+ fit-margin-top="0"
+ fit-margin-left="0"
+ fit-margin-right="0"
+ fit-margin-bottom="0" />
+ <metadata
+ id="metadata3012">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-35.433071,63.88618)">
+ <path
+ inkscape:connector-curvature="0"
+ style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:normal;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;baseline-shift:baseline;color:#000000;fill:#000000;fill-opacity:1;stroke:none;stroke-width:309;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+ d="m 407.78259,-63.885865 c -5.50873,-0.01007 -11.25467,0.221097 -17.24663,0.698832 -151.44034,12.19639 -111.27731,172.185293 -113.52498,225.760433 -2.76559,39.17912 -10.7093,70.05493 -37.65515,108.35728 -31.65734,37.64621 -76.22729,98.57709 -97.34124,162.00402 -9.96481,29.93478 -14.70669,60.44635 -10.32746,89.32352 -1.3718,1.22846 -2.67777,2.51556 -3.91957,3.84127 -9.29459,9.92281 -16.16224,21.94573 -23.81454,30.04053 -7.149273,7.13157 -17.335189,9.84418 -28.528667,13.86011 -11.197757,4.01773 -23.49204,9.94102 -30.954745,24.26137 0,0 0,0.005 -0.005,0.007 -0.01218,0.0238 -0.02547,0.0461 -0.03816,0.0703 l 0,0 c -6.755617,12.61799 -4.747277,27.1486 -2.684066,40.61093 2.063272,13.46217 4.152016,26.18346 1.379482,34.81434 -8.862262,24.22286 -9.993724,40.9783 -3.754978,53.13208 6.252047,12.17909 19.106775,17.55476 33.635407,20.58924 29.057347,6.06892 68.408607,4.56076 99.421957,20.99815 l 2.66563,-5.02968 -2.63804,5.04467 c 33.2013,17.35854 66.86088,23.52414 93.71531,17.39039 19.4699,-4.44703 35.27484,-16.04026 43.39171,-33.87948 21.00445,-0.10329 44.05315,-8.9992 80.97431,-11.03212 25.04734,-2.01755 56.33588,8.8946 92.32544,6.89621 0.94075,3.90462 2.30228,7.66025 4.166,11.22902 0.0191,0.0367 0.037,0.073 0.0565,0.10928 13.95143,27.89813 39.87419,40.65877 67.49992,38.47853 27.66216,-2.18303 57.07262,-18.49393 80.84647,-46.78632 l -4.35833,-3.6627 4.39165,3.62239 c 22.66004,-27.47602 60.27198,-38.86926 85.21172,-53.91132 12.46992,-7.52124 22.58833,-16.93894 23.37012,-30.61751 0.78137,-13.6717 -7.24514,-28.99303 -25.70186,-49.48067 0,0 -0.005,-0.005 -0.005,-0.005 -0.007,-0.009 -0.0144,-0.017 -0.0216,-0.0255 -6.06426,-6.85303 -8.95726,-19.55446 -12.06623,-33.08031 -3.10684,-13.51762 -6.57481,-28.09935 -17.67261,-37.54916 l 0,0 c -0.0222,-0.0196 -0.0446,-0.0371 -0.0668,-0.0565 0,0 0,0 0,0 -4.41677,-3.84869 -9.00656,-6.46081 -13.62872,-8.21572 15.42945,-45.75986 9.37563,-91.32556 -6.19944,-132.50113 -19.115,-50.53385 -52.48693,-94.56634 -77.97362,-124.68843 -28.5282,-35.98392 -56.43129,-70.14776 -55.88163,-120.60662 0.84975,-77.011218 8.47096,-219.826209 -127.04556,-220.011161 z m 18.34628,118.643307 c 7.68981,0 14.25742,2.25397 21.0038,7.15062 6.85352,4.97429 11.79099,11.20136 15.77046,19.89724 3.90574,8.47479 5.78493,16.765228 5.96918,26.603428 0,0.25793 0,0.47896 0.0737,0.7369 0.0737,10.096 -1.65808,18.68131 -5.49019,27.45088 -2.18659,5.00397 -4.69769,9.20386 -7.70326,12.83995 -1.02037,-0.48987 -2.08011,-0.96088 -3.17921,-1.41285 l 0,0 c -7.61844,-3.263 -13.4627,-5.33952 -18.33357,-7.02968 1.76566,-2.12238 3.23589,-4.63951 4.52871,-7.78619 1.95288,-4.75319 2.9109,-9.39599 3.09513,-14.92295 0,-0.22114 0.0737,-0.40539 0.0737,-0.66331 0.1105,-5.30584 -0.58955,-9.83807 -2.13711,-14.4808 -1.62126,-4.86374 -3.6847,-8.364138 -6.66927,-11.275048 -2.98459,-2.91102 -5.96917,-4.2374 -9.54336,-4.34805 -0.16756,-0.0101 -0.33463,-0.0101 -0.49969,-0.0101 -3.36198,0.0101 -6.28124,1.16298 -9.30153,3.6916 -3.16882,2.65307 -5.527,6.042818 -7.47993,10.759258 -1.95287,4.71634 -2.9109,9.39585 -3.09508,14.95979 -0.037,0.22114 -0.037,0.40539 -0.037,0.62643 -0.0637,3.05835 0.13058,5.86005 0.6022,8.58065 -6.87909,-3.42776 -13.36178,-5.76468 -19.44586,-7.21275 -0.34682,-2.63091 -0.54743,-5.34583 -0.61148,-8.18451 l 0,-0.77387 c -0.11056,-10.05921 1.54757,-18.681298 5.4165,-27.450778 3.86894,-8.76959 8.65901,-15.07045 15.40197,-20.19214 6.74295,-5.12168 13.37535,-7.47985 21.22375,-7.55355 0.12265,0 0.24528,0 0.36733,0 z m -105.25063,8.33313 c 5.10126,0.0121 9.66594,1.71632 14.38753,5.48676 5.1217,4.08989 8.99062,9.32212 12.23314,16.69153 3.24251,7.3694 4.97432,14.738698 5.45331,23.434588 l 0,0.0732 c 0.23218,3.65219 0.20379,7.09001 -0.0841,10.41947 -1.00892,0.28676 -1.99763,0.59704 -2.96615,0.93048 -5.50045,1.89336 -10.34796,4.47365 -14.57292,7.26346 0.41314,-2.91831 0.47463,-5.87927 0.15775,-9.18071 -0.0371,-0.18425 -0.0371,-0.33162 -0.0371,-0.51578 -0.44217,-4.38478 -1.36333,-8.06945 -2.91089,-11.79101 -1.65808,-3.86877 -3.50045,-6.59553 -5.93236,-8.69586 -2.20386,-1.903278 -4.28619,-2.777298 -6.57714,-2.759988 -0.23701,0 -0.47671,0.0131 -0.71849,0.0332 -2.57929,0.2209 -4.7164,1.47368 -6.743,3.942498 -2.02656,2.46871 -3.35302,5.52702 -4.31104,9.58008 -0.95803,4.05318 -1.21596,8.03266 -0.81066,12.6016 0,0.18416 0.0371,0.33171 0.0371,0.51586 0.44211,4.42167 1.32645,8.10626 2.91088,11.82791 1.62126,3.83204 3.50045,6.55868 5.93236,8.65891 0.40727,0.35174 0.81019,0.6677 1.21129,0.94998 -2.52954,1.94681 -3.7374,2.84435 -5.81024,4.36747 -1.32948,0.97552 -2.91286,2.13703 -4.75322,3.49357 -4.01343,-3.75973 -7.14438,-8.48491 -9.8819,-14.70649 -3.24251,-7.36927 -4.97432,-14.73871 -5.49018,-23.4346 l 0,-0.0732 c -0.47899,-8.69577 0.36847,-16.17572 2.76352,-23.913518 2.39505,-7.73789 5.60075,-13.33852 10.2434,-17.94451 4.6427,-4.60579 9.32229,-6.92711 14.95985,-7.2218 0.44042,-0.0242 0.87692,-0.0352 1.30918,-0.0332 z m 47.86748,60.328528 c 11.85658,-0.0458 26.12439,3.84137 43.39749,14.94721 10.60991,6.89962 18.8657,7.47626 37.87621,15.61839 l 0.0228,0.0101 0.0233,0.009 c 9.14674,3.75287 14.51541,8.64454 17.13839,13.7956 2.62293,5.15116 2.68708,10.73707 0.49165,16.61331 -4.39072,11.75274 -18.40589,24.12121 -38.07313,30.2628 l -0.0186,0.008 -0.0175,0.008 c -9.58965,3.11567 -17.95175,9.9961 -27.81012,15.63339 -9.85808,5.63699 -21.01325,10.1836 -36.18123,9.30614 0,-8e-5 0,0 0,0 -12.91279,-0.75261 -20.63157,-5.1363 -27.61094,-10.74548 -6.97955,-5.60927 -13.0616,-12.65611 -21.96762,-17.88568 l -0.0228,-0.0137 -0.0233,-0.0137 c -14.34552,-8.10836 -22.1775,-17.48651 -24.63551,-25.6166 -2.45809,-8.13013 -0.15126,-15.06986 6.96633,-20.40398 8.00219,-5.99706 13.56097,-10.07641 17.26382,-12.79381 3.67848,-2.69928 5.2089,-3.71141 6.3803,-4.8362 0.006,-0.009 0.0123,-0.0128 0.0185,-0.0183 0,0 0.005,-0.009 0.005,-0.009 6.01265,-5.69136 15.59728,-16.06039 30.04507,-21.0337 4.97264,-1.71177 10.52135,-2.81616 16.73192,-2.8407 z m 82.90989,49.03512 c -5.1165,0.30507 -10.47514,2.93936 -16.71458,6.42286 -6.2395,3.48341 -13.25602,7.9394 -20.85995,12.32752 -15.20781,8.77624 -32.71394,17.16948 -50.11162,17.16948 -17.42471,0 -31.34606,-8.04745 -41.78774,-16.32197 -5.22086,-4.13728 -9.52984,-8.30459 -12.97238,-11.52842 -1.72127,-1.61201 -3.21407,-2.98586 -4.60701,-4.05895 -1.39268,-1.07307 -2.52631,-2.1371 -4.85688,-2.1371 l -0.11168,4.89716 c -0.16687,1.63864 -0.33834,1.58812 -0.27059,1.63278 0.10871,0.0714 0.64946,0.25783 1.28044,0.74386 1.02404,0.78889 2.44551,2.07487 4.13257,3.65474 3.37415,3.15979 7.85768,7.50416 13.37774,11.87851 11.04,8.7486 26.39345,17.72443 45.81553,17.72443 19.44908,0 37.8502,-9.0906 53.3542,-18.03767 7.75193,-4.47357 14.79245,-8.93912 20.77931,-12.28148 5.98655,-3.34245 11.02348,-5.43837 13.93957,-5.61227 l -0.38693,-6.47348 z m 17.28809,23.27447 c 12.91771,50.92115 42.9627,124.47072 62.27343,160.36425 10.26433,19.04333 30.68512,59.50377 39.50787,108.25133 5.59046,-0.17127 11.74615,0.64098 18.33819,2.32708 23.06771,-59.80219 -19.56113,-124.2171 -39.0542,-142.15612 -7.86992,-7.63655 -8.2482,-11.05804 -4.34675,-10.8963 21.14919,18.70291 48.91343,56.32043 59.01476,98.78056 4.60604,19.36109 5.58806,39.71497 0.64599,59.80235 2.41794,1.00448 4.87363,2.09659 7.36243,3.27477 37.02795,18.03073 50.72215,33.70986 44.13786,55.109 -2.16863,-0.0761 -4.30183,-0.0675 -6.38252,-0.0175 -0.19419,0.005 -0.38692,0.0101 -0.58039,0.0148 5.36205,-16.9624 -6.5167,-29.47308 -38.16979,-43.79469 -32.83054,-14.44394 -58.99175,-13.00693 -63.41335,16.28631 -0.28298,1.53469 -0.51061,3.09853 -0.68399,4.68414 -2.45279,0.85176 -4.91893,1.93925 -7.39125,3.29204 -15.41611,8.43525 -23.8304,23.7408 -28.51025,42.51314 -4.67608,18.75716 -6.01663,41.43346 -7.30717,66.92419 0,0.005 0,0.009 0,0.0132 -0.78851,12.81759 -6.05827,30.15383 -11.40294,48.5158 -53.78147,38.36325 -128.42502,54.98431 -191.80023,11.73339 -4.29494,-6.79423 -9.2218,-13.52602 -14.29316,-20.16546 -3.2385,-4.23996 -6.56524,-8.454 -9.87265,-12.60867 6.5058,0.005 12.03576,-1.06037 16.50509,-3.08692 5.55787,-2.52017 9.46294,-6.56804 11.39488,-11.76454 3.86384,-10.39316 -0.0169,-25.0546 -12.38629,-41.79711 -12.36863,-16.74135 -33.31667,-35.63553 -64.09851,-54.51358 0,0 -0.005,0 -0.005,-0.005 -22.61406,-14.0691 -35.26118,-31.31359 -41.18086,-50.03678 -5.92024,-18.72483 -5.09014,-38.97245 -0.52737,-58.96299 8.7578,-38.3711 31.25988,-75.69006 45.61747,-99.10986 3.86549,-2.8442 1.38107,5.27944 -14.5349,34.83522 -14.26425,27.02229 -40.93131,89.38371 -4.41932,138.06271 0.97573,-34.64244 9.24887,-69.97344 23.13748,-103.02138 20.22983,-45.85661 62.54332,-125.37763 65.90401,-188.75699 1.73273,1.25821 7.68701,5.27572 10.34013,6.78451 0.005,0.008 0.0117,0.008 0.017,0.009 7.76249,4.57119 13.59244,11.25324 21.14318,17.32153 7.5657,6.0803 17.01729,11.33203 31.29675,12.16406 l 0,0 c 16.66707,0.96445 29.36983,-4.19787 39.77727,-10.14905 10.39178,-5.94216 18.69349,-12.51837 26.55852,-15.08535 0.0123,-0.008 0.0239,-0.008 0.0355,-0.0113 16.61951,-5.19718 29.83377,-14.39595 37.35342,-25.12494 z m 105.55922,291.52274 c 6.73161,-0.0312 14.88609,2.21313 23.81226,6.20638 24.02409,11.09092 31.54084,20.59739 24.98213,34.56235 -5.527,10.53819 -29.18268,27.30348 -45.39528,22.88189 -16.54418,-4.27423 -24.61366,-28.11415 -21.92387,-46.1322 1.44083,-12.23549 8.36135,-17.47091 18.52476,-17.51842 z m -27.18143,32.9261 c 1.35802,22.03362 12.25934,44.50549 31.53855,49.36899 21.09753,5.55873 51.51581,-12.54314 64.35873,-27.3081 2.56085,-0.1025 5.06453,-0.22799 7.49602,-0.28668 11.26569,-0.27202 20.71453,0.37107 30.36871,8.81438 l 0.0334,0.0286 0.0344,0.0286 c 7.419,6.28553 10.9455,18.16389 14.0041,31.47065 3.05844,13.3068 5.50422,27.79937 14.67654,38.12376 l 0.0137,0.0148 0.0127,0.0148 c 17.63401,19.56838 23.30213,32.7951 22.81967,41.23729 -0.48253,8.44241 -6.59507,14.70976 -17.88217,21.51734 -22.56443,13.60962 -62.54539,25.44424 -88.08231,56.37684 -22.17411,26.3884 -49.21298,40.88134 -73.02578,42.76074 -23.81279,1.87925 -44.35761,-8.00399 -56.47007,-32.31472 l -0.0276,-0.0551 -0.0286,-0.0542 c -7.51419,-14.29408 -4.38399,-36.85208 1.94594,-60.64633 6.33007,-23.79442 15.42469,-48.2261 16.64212,-68.08383 l 0,-0.0312 0,-0.0302 c 1.28789,-25.44312 2.71199,-47.66251 6.98596,-64.80656 4.27391,-17.14405 11.00373,-28.75506 22.92793,-35.27967 0.55528,-0.3038 1.10651,-0.59044 1.65463,-0.8613 z m -387.22543,1.66273 c 1.77975,0.007 3.66318,0.1558 5.66981,0.45944 13.49768,2.04462 25.26814,11.48208 36.60841,26.86358 11.34037,15.38173 21.89234,36.37883 32.73959,59.67004 l 0.0138,0.0286 0.0127,0.0276 c 8.71684,18.1933 27.11081,38.19813 42.69857,58.60595 15.58768,20.4078 27.65156,40.89263 26.08057,56.57134 l -0.007,0.0681 -0.005,0.0679 c -2.03222,26.7408 -17.11654,41.2982 -40.27247,46.58714 -23.14903,5.28718 -54.53105,0.017 -85.87605,-16.36472 -0.009,-0.005 -0.0186,-0.009 -0.0276,-0.0148 -34.67886,-18.36731 -75.93364,-16.54296 -102.397339,-22.07006 -13.235445,-2.76443 -21.871626,-6.92036 -25.835367,-14.64216 -3.964013,-7.72153 -4.052482,-21.19325 4.370898,-44.16301 l 0.03705,-0.1014 0.03333,-0.10255 c 4.165689,-12.84964 1.082883,-26.9091 -0.939592,-40.10545 -2.022476,-13.19641 -3.011543,-25.1997 1.494601,-33.56614 l 0.02074,-0.0382 0.02054,-0.0392 c 5.769358,-11.12094 14.231783,-15.09641 24.734594,-18.86442 10.502751,-3.76822 22.956785,-6.72755 32.791335,-16.58338 l 0.0509,-0.052 0.0508,-0.053 c 9.09167,-9.59117 15.92092,-21.61352 23.91357,-30.14646 6.7438,-7.19963 13.49253,-11.97133 23.66489,-12.04201 0.1177,0 0.236,0 0.35465,0 z"
+ id="path154" />
+ <g
+ transform="matrix(0.91159133,0,0,0.91159133,-140.97298,1091.3033)"
+ style="font-size:429.75283813px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+ id="text2999" />
+ </g>
+</svg>
diff --git a/docs/os-osx.svg b/docs/os-osx.svg
new file mode 100644
index 0000000000000000000000000000000000000000..f64d76956e55da0fad2d0cae9fec7df4111f7d1d
--- /dev/null
+++ b/docs/os-osx.svg
@@ -0,0 +1,143 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ version="1.0"
+ width="800"
+ height="950"
+ id="svg2">
+ <defs
+ id="defs4">
+ <linearGradient
+ id="linearGradient3784">
+ <stop
+ id="stop3786"
+ style="stop-color:#ffffff;stop-opacity:1"
+ offset="0" />
+ <stop
+ id="stop3788"
+ style="stop-color:#888888;stop-opacity:1"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient3776">
+ <stop
+ id="stop3778"
+ style="stop-color:#ffffff;stop-opacity:1"
+ offset="0" />
+ <stop
+ id="stop3780"
+ style="stop-color:#ffffff;stop-opacity:0"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient3754">
+ <stop
+ id="stop3756"
+ style="stop-color:#ffffff;stop-opacity:1"
+ offset="0" />
+ <stop
+ id="stop3758"
+ style="stop-color:#ffffff;stop-opacity:0"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient3734">
+ <stop
+ id="stop3736"
+ style="stop-color:#6c6d6f;stop-opacity:1"
+ offset="0" />
+ <stop
+ id="stop3738"
+ style="stop-color:#010101;stop-opacity:1"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ x1="581.96649"
+ y1="409.16061"
+ x2="544.40381"
+ y2="311.21347"
+ id="linearGradient3760"
+ xlink:href="#linearGradient3754"
+ gradientUnits="userSpaceOnUse" />
+ <linearGradient
+ x1="591.31964"
+ y1="593.75946"
+ x2="587.03571"
+ y2="434.31064"
+ id="linearGradient3764"
+ xlink:href="#linearGradient3734"
+ gradientUnits="userSpaceOnUse" />
+ <linearGradient
+ x1="591.31964"
+ y1="593.75946"
+ x2="587.03571"
+ y2="434.31064"
+ id="linearGradient3773"
+ xlink:href="#linearGradient3734"
+ gradientUnits="userSpaceOnUse"
+ gradientTransform="translate(-2.7999999e-6,-5.0000001e-6)" />
+ <linearGradient
+ x1="592.88464"
+ y1="409.21036"
+ x2="572.06653"
+ y2="317.52728"
+ id="linearGradient3782"
+ xlink:href="#linearGradient3776"
+ gradientUnits="userSpaceOnUse"
+ gradientTransform="matrix(4.1074798,0,0,4.1074798,-2012.1445,-1474.6712)" />
+ <linearGradient
+ x1="621.8504"
+ y1="527.79108"
+ x2="575.15466"
+ y2="358.30902"
+ id="linearGradient3790"
+ xlink:href="#linearGradient3784"
+ gradientUnits="userSpaceOnUse" />
+ <linearGradient
+ x1="591.31964"
+ y1="593.75946"
+ x2="587.03571"
+ y2="434.31064"
+ id="linearGradient3796"
+ xlink:href="#linearGradient3734"
+ gradientUnits="userSpaceOnUse" />
+ <linearGradient
+ x1="591.31964"
+ y1="593.75946"
+ x2="587.03571"
+ y2="434.31064"
+ id="linearGradient3813"
+ xlink:href="#linearGradient3734"
+ gradientUnits="userSpaceOnUse"
+ gradientTransform="matrix(4.1074798,0,0,4.1074798,-2012.1445,-1474.6712)" />
+ <linearGradient
+ x1="621.8504"
+ y1="527.79108"
+ x2="575.15466"
+ y2="358.30902"
+ id="linearGradient3815"
+ xlink:href="#linearGradient3784"
+ gradientUnits="userSpaceOnUse"
+ gradientTransform="matrix(4.1074798,0,0,4.1074798,-2012.1445,-1474.6712)" />
+ </defs>
+ <path
+ d="M -1763.2143,1058.9693 L -1763.2143,950.04075 L -1724.2857,1040.5765 L -1685.3571,950.04075 L -1685.3571,1058.9693"
+ id="path3199"
+ style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ <path
+ d="M 9.2490229,7.8722656 C 9.0747426,10.220019 9.5551534,12.587324 10.789328,14.675279 L 283.03823,474.32796 L 15.153526,926.66418 C 13.0537,930.26743 13.090092,934.72063 15.153526,938.34483 C 17.216918,941.9691 20.995183,944.21594 25.165508,944.24933 L 230.41114,944.24933 C 234.53312,944.22267 238.33677,942.02829 240.42312,938.47319 L 399.07452,670.58848 L 557.72593,938.47319 C 559.81228,942.02829 563.61593,944.22267 567.73791,944.24933 L 773.1119,944.24933 C 777.28223,944.21594 781.06049,941.96906 783.12389,938.34483 C 785.18744,934.72067 785.22371,930.26743 783.12389,926.66418 L 515.23918,474.32796 L 787.35972,14.675279 C 788.58462,12.5734 788.96226,10.218047 788.77167,7.8722656 L 559.13787,7.8722656 L 399.07452,278.19578 L 239.01118,7.8722656 L 9.2490229,7.8722656 z"
+ id="path3762"
+ style="fill:url(#linearGradient3815);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1" />
+ <path
+ d="M 20.80131,8.7707768 L 296.51589,474.32796 L 25.165508,932.56868 L 230.41114,932.56868 L 399.07452,647.74063 L 567.73791,932.56868 L 773.1119,932.56868 L 501.76152,474.32796 L 777.34774,8.7707768 L 572.10211,8.7707768 L 399.07452,301.04364 L 226.04694,8.7707768 L 20.80131,8.7707768 z"
+ id="path3705"
+ style="fill:url(#linearGradient3813);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ <path
+ d="M 20.80131,8.7707768 L 201.9155,314.64967 C 251.61658,285.27827 303.41256,257.12462 357.61466,230.95977 L 226.04694,8.7707768 L 20.80131,8.7707768 z M 572.10211,8.7707768 L 470.05691,181.15657 C 548.90117,149.37671 632.73447,122.22713 722.53856,101.31743 L 777.34774,8.7707768 L 572.10211,8.7707768 z"
+ id="path3771"
+ style="opacity:0.47619048;fill:url(#linearGradient3782);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+</svg>
diff --git a/docs/os-windows.svg b/docs/os-windows.svg
new file mode 100644
index 0000000000000000000000000000000000000000..818da415200b43c7623aaaa8a55a2ed4d5048d98
--- /dev/null
+++ b/docs/os-windows.svg
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<!-- Created with Inkscape (http://www.inkscape.org/) by Marsupilami -->
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.1"
+ width="766"
+ height="768"
+ viewBox="-2.61977004 -2.61977004 92.56520808 92.83416708"
+ id="svg8375">
+ <defs
+ id="defs8377" />
+ <path
+ d="M 0,12.40183 35.68737,7.5416 35.70297,41.96435 0.03321,42.16748 z m 35.67037,33.52906 0.0277,34.45332 -35.66989,-4.9041 -0.002,-29.77972 z M 39.99644,6.90595 87.31462,0 l 0,41.527 -47.31818,0.37565 z M 87.32567,46.25471 87.31457,87.59463 39.9964,80.91625 39.9301,46.17767 z"
+ id="path13" />
+</svg>
+<!-- version: 20110311, original size: 87.325668 87.594627, border: 3% -->