From ca4c2f57e023ca819d688e9123b618fa60ed9242 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Thu, 8 Nov 2018 16:46:18 +0100
Subject: [PATCH 01/10] Mention that makeOutputTextarea merges out+err

Thanks @LanX!
---
 using.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/using.md b/using.md
index 86a3330..408ae81 100644
--- a/using.md
+++ b/using.md
@@ -410,11 +410,11 @@ Defaults to a simple implementation that logs via `console.debug()`.
 
 #### `Perl.makeOutputTextarea(id)`
 
-This function will create a new DOM `<textarea>` element, set up a `Perl.output`
-handler that redirects Perl's output into the `<textarea>`, and return the
-DOM element. You may optionally pass this function a string argument giving
-a DOM ID. You will need to add the `<textarea>` to your DOM yourself
-(see `webperl_demo.html` for an example).
+This function will create a new DOM `<textarea>` element, set up a
+`Perl.output` handler that redirects Perl's output (merged STDOUT and STDERR)
+into the `<textarea>`, and return the DOM element. You may optionally pass this
+function a string argument giving a DOM ID. You will need to add the
+`<textarea>` to your DOM yourself (see `webperl_demo.html` for an example).
 
 
 WebPerl.pm

From 5d8fe5b39a12826082350e8f04fc117c31babced Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Mon, 12 Nov 2018 11:57:09 +0100
Subject: [PATCH 02/10] Added favicon

---
 _misc/wp1.ico | Bin 0 -> 1150 bytes
 _misc/wp2.ico | Bin 0 -> 1150 bytes
 _misc/wp3.ico | Bin 0 -> 1150 bytes
 favicon.ico   | Bin 0 -> 1150 bytes
 4 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _misc/wp1.ico
 create mode 100644 _misc/wp2.ico
 create mode 100644 _misc/wp3.ico
 create mode 100644 favicon.ico

diff --git a/_misc/wp1.ico b/_misc/wp1.ico
new file mode 100644
index 0000000000000000000000000000000000000000..e4559b81376d26bca9be994b97b527814a1b7a77
GIT binary patch
literal 1150
zcmd6my-EX75QQf}3qeRK>r^880z#0Wy<o4E3I;6l2sW02SlEaX2wLkSC|HVimV!T6
zs8}e1f)Kx>XJL_>!cF5W-_FiCcjn&RkcbjjwHn-O(Hw{viHI>kLiy22{YIAoqG<e=
z{!d=u7Pg`ChnLCDpU<5F{bhP)Kyw}n^z#eHR3H8M^S8bK5c$nBo7N^>e~^da5?<jQ
zu3!VCD`p{^d-SbDZ058%YrWEr*FKV8U=VKL2{d;XdPNE29<*-3dDVH*S-#e#VggaU
z+E1aiI>$4V;SS`FLn`#W<nP(scYWx(<9fyQ?{r{)-o~=)mg^<gnwtupTl?2iCfX>-
izfSqx3(SlYo{!<o@O(ZUak>_<-rx@dTc+NQXuuZ;S!iGY

literal 0
HcmV?d00001

diff --git a/_misc/wp2.ico b/_misc/wp2.ico
new file mode 100644
index 0000000000000000000000000000000000000000..ecc773d3208c3afc9093e651235cbf0bdbef5efe
GIT binary patch
literal 1150
zcmchWy)T1N6o-%cXd)7ABu&In!eC(00YL|=NEl2uNyWlKZ2kj_h{+(aGe`_lqeLXa
zgn=Mfh_4WzK|R0rz40oQPJYevo^#JV=ib}<VOGE|6f(ZmHdJI5F|&FgL?jc(<Wh<b
zk*yekO?ZMmuhXA5OY9DE)o;_+10_%ilE40)cGQdc<I0mB!HxZrj(o3oH7@6koKu*A
za@c}SXo4M(lv|qizQ%I(emhT23+%%=bc1vNXKC+eeSo;;(>NDi&R<4(lAD*4vktGF
zPyMxuk*oLHxlC7H-(9lq;TaBL63XDeG{!_9Q0GlpgVkA%dhJ2%4IFvx6YMMKEV^JC
zmSGAcwb#M5ukf|6x)YN2sTks*vs{8+Sc3}C-VeYcNSB}*-A74&6|{oxhTcdsjKB)4
zLK|#=q`2ORTaW5>Pc=_J=>J3^40>zhPz%TKn^f<Y))n*z@O6F<SuxkVb&hPjfz4ru
k+8f!F1+zfHEXK<eh0GL$6eL-Fn3eTK%o6y+taJiC0kdj#mH+?%

literal 0
HcmV?d00001

diff --git a/_misc/wp3.ico b/_misc/wp3.ico
new file mode 100644
index 0000000000000000000000000000000000000000..3df476663e9e3cd7c5dfe15538fab492f133c479
GIT binary patch
literal 1150
zcmbW0&niV>6vfvS1Et)Nfs{LvcmY!nAm)rvZW-K1F&B|A<q?j#oEI=5e+HxwMTxao
zyG~!<$?fdh@2>V<Yk%MA+%C}Kr`-m>JLnDqV*sWJN1Xi4DgV_s1EQ|NPc`x}k3QA#
zQ;l5AqffP8|BH+F<d{rU4(WG4a?+x~K7Rqs6Yak=*l&9OCGUDCpX7$@lW`Ii=SH8?
zVGiGjvRwz}+<#C<JgbuhXSILo&{k!(<XN3;JNrP@yBi|c<dNvi9a2{<8h1pw73-#T
z)hb`PT+MQ*UEQZrR?qQ728iCN{27ufy)XH@HV@sOxIb{e;Xaik`^z@g-S^zDx!1Y5
u(sS$nPR`_PipamJ`egz9QUYhBAm>)~uY17rB$q~k+eN+vbHRUDNqzw0xPEH@

literal 0
HcmV?d00001

diff --git a/favicon.ico b/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..3df476663e9e3cd7c5dfe15538fab492f133c479
GIT binary patch
literal 1150
zcmbW0&niV>6vfvS1Et)Nfs{LvcmY!nAm)rvZW-K1F&B|A<q?j#oEI=5e+HxwMTxao
zyG~!<$?fdh@2>V<Yk%MA+%C}Kr`-m>JLnDqV*sWJN1Xi4DgV_s1EQ|NPc`x}k3QA#
zQ;l5AqffP8|BH+F<d{rU4(WG4a?+x~K7Rqs6Yak=*l&9OCGUDCpX7$@lW`Ii=SH8?
zVGiGjvRwz}+<#C<JgbuhXSILo&{k!(<XN3;JNrP@yBi|c<dNvi9a2{<8h1pw73-#T
z)hb`PT+MQ*UEQZrR?qQ728iCN{27ufy)XH@HV@sOxIb{e;Xaik`^z@g-S^zDx!1Y5
u(sS$nPR`_PipamJ`egz9QUYhBAm>)~uY17rB$q~k+eN+vbHRUDNqzw0xPEH@

literal 0
HcmV?d00001


From 4e1e17b292ebe373ae4a811b5e9d1810d9dc5323 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Mon, 12 Nov 2018 16:47:32 +0100
Subject: [PATCH 03/10] Added experimental Perl 6 support

---
 building.md |   6 ++-
 index.md    |   7 ++-
 legal.md    |   3 +-
 notes.md    |   3 +-
 perl6.md    | 134 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 using.md    |   5 +-
 6 files changed, 152 insertions(+), 6 deletions(-)
 create mode 100644 perl6.md

diff --git a/building.md b/building.md
index 62aaf92..b196dc1 100644
--- a/building.md
+++ b/building.md
@@ -1,9 +1,10 @@
 
 \[ [Using](using.html) -
 Building -
+[🦋](perl6.html) -
 [Notes](notes.html) -
 [Legal](legal.html) -
-[GitHub Wiki](https://github.com/haukex/webperl/wiki/Building-WebPerl) \]
+[Wiki](https://github.com/haukex/webperl/wiki/Building-WebPerl) \]
 
 Building WebPerl
 ================
@@ -13,6 +14,9 @@ Building WebPerl
 Some things may not work yet, and parts of the API may still change.
 Your feedback is always appreciated!
 
+This page documents the Perl 5 support, for the *experimental*
+Perl 6 support, see [here](perl6.html).
+
 
 Prerequisites
 -------------
diff --git a/index.md b/index.md
index 9337354..626ef58 100644
--- a/index.md
+++ b/index.md
@@ -1,16 +1,17 @@
 
 \[ [Using](using.html) -
 [Building](building.html) -
+[🦋](perl6.html) -
 [Notes](notes.html) -
 [Legal](legal.html) -
-[GitHub Wiki](https://github.com/haukex/webperl/wiki) \]
+[Wiki](https://github.com/haukex/webperl/wiki) \]
 
 Welcome to WebPerl!
 ===================
 
 
 WebPerl uses the power of [WebAssembly](https://webassembly.org/) and
-[Emscripten](http://emscripten.org/) to let you run Perl 5 in the browser!
+[Emscripten](http://emscripten.org/) to let you run Perl in the browser!
 
 WebPerl does not translate your Perl code to JavaScript, instead, it is
 a port of the `perl` binary to WebAssembly, so that you have the full
@@ -20,6 +21,8 @@ power of Perl at your disposal!
 Some things may not work yet, and parts of the API may still change.
 Your feedback is always appreciated!
 
+[**New: Experimental Perl 6 Support**](perl6.html)
+
 ```html
 <script src="webperl.js"></script>
 <script type="text/perl">
diff --git a/legal.md b/legal.md
index 54eb3ea..e6b973b 100644
--- a/legal.md
+++ b/legal.md
@@ -1,9 +1,10 @@
 
 \[ [Using](using.html) -
 [Building](building.html) -
+[🦋](perl6.html) -
 [Notes](notes.html) -
 Legal -
-[GitHub Wiki](https://github.com/haukex/webperl/wiki) \]
+[Wiki](https://github.com/haukex/webperl/wiki) \]
 
 WebPerl Author, Copyright, and License
 ======================================
diff --git a/notes.md b/notes.md
index b9c89ef..4fbe725 100644
--- a/notes.md
+++ b/notes.md
@@ -1,9 +1,10 @@
 
 \[ [Using](using.html) -
 [Building](building.html) -
+[🦋](perl6.html) -
 Notes -
 [Legal](legal.html) -
-[GitHub Wiki](https://github.com/haukex/webperl/wiki) \]
+[Wiki](https://github.com/haukex/webperl/wiki) \]
 
 Misc. Notes on WebPerl
 ======================
diff --git a/perl6.md b/perl6.md
new file mode 100644
index 0000000..bd50ed8
--- /dev/null
+++ b/perl6.md
@@ -0,0 +1,134 @@
+
+\[ [Using](using.html) -
+[Building](building.html) -
+🦋 -
+[Notes](notes.html) -
+[Legal](legal.html) -
+[Wiki](https://github.com/haukex/webperl/wiki/Perl6) \]
+
+WebPerl Experimental Perl 6 Support 🦋
+=====================================
+
+
+Thanks to [**Paweł Murias**](https://github.com/pmurias) and his
+amazing work on **`Rakudo.js`** and
+[**6Pad**](https://perl6.github.io/6pad/), I've been able to patch
+support for Perl 6 into WebPerl!
+
+Currently **requires Google Chrome** (due to BigInt support), see the
+[Quick Start](#quick-start) below on how to get this up and running on
+your local machine!
+
+```html
+<script src="webperl.js"></script>
+<script type="text/perl6">
+
+print "Hello, Perl 6 World!\n";  # goes to JavaScript console by default
+
+my $document = EVAL(:lang<JavaScript>, 'return document');
+my $window   = EVAL(:lang<JavaScript>, 'return window');
+$document.getElementById('my_button')
+	.addEventListener("click", -> $event {
+		$window.alert("You clicked the button!");
+	} );
+</script>
+```
+
+
+Quick Start
+-----------
+
+In a console (the following assumes Linux):
+
+    $ git clone https://github.com/haukex/webperl.git
+    $ cd webperl
+    $ wget https://github.com/haukex/webperl/releases/download/v0.07-beta/webperl_prebuilt_v0.07-beta.zip
+    $ unzip -j webperl_prebuilt_v0.07-beta.zip '*/emperl.*' -d web
+    $ cpanm --installdeps .
+    $ cd experiments ; cpanm --installdeps . ; cd ..
+    $ experiments/p6/6init.pl   # this patches Perl 6 support in
+    $ plackup web/webperl.psgi
+
+Then point your Chrome browser at <http://localhost:5000/6demo.html>,
+and have a look at its source.
+
+Have fun!
+
+
+Experimental Status and Notes
+-----------------------------
+
+- I don't have enough experience with `Rakudo.js`
+	- <https://github.com/rakudo/rakudo/tree/master/src/vm/js>
+	- <https://perl6.github.io/6pad/>
+	- <http://blogs.perl.org/users/pawel_murias/>
+	- <https://github.com/perl6/perl6-parcel-example>
+	- <https://www.youtube.com/watch?v=LN0mKjmraVs>
+
+- requires BigInt support, which is currently only available in Chrome
+	- <https://developers.google.com/web/updates/2018/05/bigint>
+	- <https://github.com/tc39/proposal-bigint>
+	- <https://v8.dev/blog/bigint>
+
+- Large download (10MB compressed, 74MB uncompressed) - can we
+  repackage it to make it smaller, or is there a good way to
+  distribute this?
+
+- STDERR only goes to console, STDOUT gets output with HTML escapes
+
+
+Documentation
+-------------
+
+My code steal^H^H^H^H^Hborrows the prepackaged `Rakudo.js` build from
+[6Pad](https://perl6.github.io/6pad/) and caches it locally. The script
+`experiments/p6/6init.pl` also patches the experimental P6 support into
+`webperl.js` (see the [Quick Start](#quick-start) above).
+
+Note that both Perl 5 and Perl 6 are only loaded on demand by
+`webperl.js`, so if you only use one or the other, you won't have the
+overhead of loading both.
+
+For now, I've basically just patched `Rakudo.js`'s `evalP6()` into
+`Raku.eval()`, and `NQP_STDOUT` into `Raku.output`, to make things more
+like the Perl 5 WebPerl, and provided some of the same API for Perl 6
+as I provide for Perl 5.
+
+The JS API provided by WebPerl for Perl 6 currently closely mirrors
+[the Perl 5 API](using.html#webperljs): There is a JS object `Raku`
+which provides the following functions / properties that do mostly the
+same as for Perl 5:
+
+- `Raku.addStateChangeListener( function (from,to) {} )`
+- `Raku.state`
+- `Raku.output = function (str,chan) {}`
+- `Raku.makeOutputTextarea()`
+- `Raku.init( function () {} )`
+- `Raku.eval( code )`
+
+You can add Perl 6 code to your HTML pages with `<script>` tags
+with `type="text/perl6"` or `type="text/raku"`.
+
+For everything else, I defer to `Rakudo.js` for now! I will update this
+documentation as things evolve.
+
+
+***
+
+Additional notes on WebPerl's experimental Perl 6 support may be found
+in the [GitHub Wiki](https://github.com/haukex/webperl/wiki/Perl6).
+
+***
+
+Copyright (c) 2018 Hauke Daempfling (haukex@zero-g.net)
+at the Leibniz Institute of Freshwater Ecology and Inland Fisheries (IGB),
+Berlin, Germany, <http://www.igb-berlin.de>
+
+Please see the ["Legal" page](legal.html) for details.
+
+***
+
+You can find the source for this page at
+<https://github.com/haukex/webperl/blob/gh-pages/perl6.md>
+
+
diff --git a/using.md b/using.md
index 408ae81..b22900d 100644
--- a/using.md
+++ b/using.md
@@ -1,9 +1,10 @@
 
 \[ Using -
 [Building](building.html) -
+[🦋](perl6.html) -
 [Notes](notes.html) -
 [Legal](legal.html) -
-[GitHub Wiki](https://github.com/haukex/webperl/wiki/Using-WebPerl) \]
+[Wiki](https://github.com/haukex/webperl/wiki/Using-WebPerl) \]
 
 Using WebPerl
 =============
@@ -13,6 +14,8 @@ Using WebPerl
 Some things may not work yet, and parts of the API may still change.
 Your feedback is always appreciated!
 
+This page documents the Perl 5 support, for the *experimental*
+Perl 6 support, see [here](perl6.html).
 
 - [Basic Usage](#basic-usage)
 	- [Serving WebPerl](#serving-webperl)

From 5d028237ca5644233e5748153d0d35fce0b2df79 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Mon, 12 Nov 2018 16:56:18 +0100
Subject: [PATCH 04/10] Tweaks to the Perl 6 page

---
 perl6.md | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/perl6.md b/perl6.md
index bd50ed8..e82258e 100644
--- a/perl6.md
+++ b/perl6.md
@@ -23,7 +23,7 @@ your local machine!
 <script src="webperl.js"></script>
 <script type="text/perl6">
 
-print "Hello, Perl 6 World!\n";  # goes to JavaScript console by default
+say "Hello, Perl 6 World!";   # goes to JavaScript console by default
 
 my $document = EVAL(:lang<JavaScript>, 'return document');
 my $window   = EVAL(:lang<JavaScript>, 'return window');
@@ -38,19 +38,24 @@ $document.getElementById('my_button')
 Quick Start
 -----------
 
-In a console (the following assumes Linux):
-
-    $ git clone https://github.com/haukex/webperl.git
-    $ cd webperl
-    $ wget https://github.com/haukex/webperl/releases/download/v0.07-beta/webperl_prebuilt_v0.07-beta.zip
-    $ unzip -j webperl_prebuilt_v0.07-beta.zip '*/emperl.*' -d web
-    $ cpanm --installdeps .
-    $ cd experiments ; cpanm --installdeps . ; cd ..
-    $ experiments/p6/6init.pl   # this patches Perl 6 support in
-    $ plackup web/webperl.psgi
-
-Then point your Chrome browser at <http://localhost:5000/6demo.html>,
-and have a look at its source.
+- Prerequisites: `perl` (a recent version is recommended, e.g. v5.26 and up),
+  and [`cpanm`](https://metacpan.org/pod/App::cpanminus) to easily install
+  dependencies (otherwise, see the files `cpanfile` for the dependencies and
+  use the module installer of your choce).
+
+- In a shell (the following assumes Linux):
+  
+      $ git clone https://github.com/haukex/webperl.git
+      $ cd webperl
+      $ wget https://github.com/haukex/webperl/releases/download/v0.07-beta/webperl_prebuilt_v0.07-beta.zip
+      $ unzip -j webperl_prebuilt_v0.07-beta.zip '*/emperl.*' -d web
+      $ cpanm --installdeps .
+      $ cd experiments ; cpanm --installdeps . ; cd ..
+      $ experiments/p6/6init.pl   # this patches Perl 6 support in
+      $ plackup web/webperl.psgi
+
+- Then point your Chrome browser at <http://localhost:5000/6demo.html>,
+  and have a look at its source.
 
 Have fun!
 

From 9aebecff2361af9801294547c84e54bb6e09cb08 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Thu, 8 Nov 2018 16:44:02 +0100
Subject: [PATCH 05/10] Adjust paths

For haukex/emperl5@bc78e33552fd7d7db0b3ba2996f4d9408394e0b6

(cherry picked from commit 67ec248187ac0a8ce689e9ef58286646556010a9)
---
 building.md | 2 +-
 notes.md    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/building.md b/building.md
index b196dc1..fb429e5 100644
--- a/building.md
+++ b/building.md
@@ -58,7 +58,7 @@ Some of the central source files of WebPerl are:
 - [`emperl5/hints/emscripten.sh`](https://github.com/haukex/emperl5/blob/emperl_v5.28.0/hints/emscripten.sh)
 - [`emperl5/perlmain_noexit_patch`](https://github.com/haukex/emperl5/blob/emperl_v5.28.0/perlmain_noexit_patch)
 - [`emperl5/ext/WebPerl/WebPerl.xs`](https://github.com/haukex/emperl5/blob/emperl_v5.28.0/ext/WebPerl/WebPerl.xs)
-- [`emperl5/ext/WebPerl/WebPerl.pm`](https://github.com/haukex/emperl5/blob/emperl_v5.28.0/ext/WebPerl/WebPerl.pm)
+- [`emperl5/ext/WebPerl/lib/WebPerl.pm`](https://github.com/haukex/emperl5/blob/emperl_v5.28.0/ext/WebPerl/lib/WebPerl.pm)
 - [`webperl/web/webperl.js`](https://github.com/haukex/webperl/blob/master/web/webperl.js)
 
 
diff --git a/notes.md b/notes.md
index 4fbe725..4b083b9 100644
--- a/notes.md
+++ b/notes.md
@@ -134,7 +134,7 @@ Release Checklist
   
   At a minimum there is:
 	- `web/webperl.js` - `Perl.WebPerlVersion`
-	- `emperl5/ext/WebPerl/WebPerl.pm` - `$VERSION`
+	- `emperl5/ext/WebPerl/lib/WebPerl.pm` - `$VERSION`
 	- `pages/index.md` and `pages/using.md` - download links
 
 - Update [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) values as needed, e.g.:

From 57ccdd0d7af7ca6accc77dbaf9ff9bf36336863b Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Mon, 12 Nov 2018 17:19:19 +0100
Subject: [PATCH 06/10] Added a link

---
 notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notes.md b/notes.md
index 4b083b9..3c31b5f 100644
--- a/notes.md
+++ b/notes.md
@@ -18,6 +18,7 @@ Other places I've written about WebPerl:
 - [Run Perl 5 in the Browser!](https://www.perlmonks.org/?node_id=1220426)
 - [WebPerl Regex Tester (beta)](https://www.perlmonks.org/?node_id=1221705)
 - [Embedding WebPerl Code Demos into Other Pages](https://www.perlmonks.org/?node_id=1223812)
+- [WebPerl now has Experimental Perl 6 Support!](https://www.perlmonks.org/?node_id=1225647)
 
 I also gave a [lightning talk](http://act.perlconference.org/tpc-2018-glasgow/talk/7475)
 at YAPC::EU 2018 in Glasgow: [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)

From 04cf5ae21464d7dcfeb7a3d0755a5352eb2001e3 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Sun, 2 Dec 2018 15:08:24 +0100
Subject: [PATCH 07/10] Added a link

---
 notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notes.md b/notes.md
index 3c31b5f..78c5648 100644
--- a/notes.md
+++ b/notes.md
@@ -27,6 +27,7 @@ at YAPC::EU 2018 in Glasgow: [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)
 
 ### In the Press
 
+- [Perl Advent Calendar 2018, Day 2](http://www.perladvent.org/2018/2018-12-02.html) (by Mark Fowler)
 - [Reddit: Your scientists were so preoccupied with whether or not they could, they didn't stop to think if they should (2018-10-22)](https://www.reddit.com/r/programmingcirclejerk/comments/9qerw5/your_scientists_were_so_preoccupied_with_whether/) 😉
 - [Hacker News (2018-10-21)](https://news.ycombinator.com/item?id=18269071)
 - [Reddit /r/programming (2018-10-21)](https://www.reddit.com/r/programming/comments/9q65tf/run_perl_in_the_browser_with_webperl/)

From 4ef04f461f3bf23838632168de51cd3cc0c59f8f Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Sun, 17 Feb 2019 13:09:37 +0100
Subject: [PATCH 08/10] Updated Notes with To-Do's and Talks

---
 notes.md | 30 ++++++++++++++++++++++--------
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/notes.md b/notes.md
index 78c5648..464fd8f 100644
--- a/notes.md
+++ b/notes.md
@@ -20,13 +20,17 @@ Other places I've written about WebPerl:
 - [Embedding WebPerl Code Demos into Other Pages](https://www.perlmonks.org/?node_id=1223812)
 - [WebPerl now has Experimental Perl 6 Support!](https://www.perlmonks.org/?node_id=1225647)
 
-I also gave a [lightning talk](http://act.perlconference.org/tpc-2018-glasgow/talk/7475)
-at YAPC::EU 2018 in Glasgow: [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)
+Talks:
+
+- YAPC::EU 2018 in Glasgow - [lightning talk](http://act.perlconference.org/tpc-2018-glasgow/talk/7475), [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)
+- *(planned)* German Perl Workshop 2019 - [talk](http://act.yapc.eu/gpw2019/talk/7616) (in German 🇩🇪)
+- *(hopefully)* YAPC::EU 2019 ([PerlCon](https://perlcon.eu/)) in Rīga
 
 [![DOI 10.5281/zenodo.1400490](https://zenodo.org/badge/DOI/10.5281/zenodo.1400490.svg)](https://doi.org/10.5281/zenodo.1400490)
 
-### In the Press
+### "In the Press"
 
+- WebPerl gets a mention in Will Braswell's talk ["Perl 11 - The Future of Saint Larry's Language"](https://fosdem.org/2019/schedule/event/perl11/)
 - [Perl Advent Calendar 2018, Day 2](http://www.perladvent.org/2018/2018-12-02.html) (by Mark Fowler)
 - [Reddit: Your scientists were so preoccupied with whether or not they could, they didn't stop to think if they should (2018-10-22)](https://www.reddit.com/r/programmingcirclejerk/comments/9qerw5/your_scientists_were_so_preoccupied_with_whether/) 😉
 - [Hacker News (2018-10-21)](https://news.ycombinator.com/item?id=18269071)
@@ -40,34 +44,44 @@ TODOs
 
 1. Testing
 	
+	- How to best disable individual tests that we know won't work? (qx etc.)
+	- How to handle the many tests that call an external Perl?
+		- patching t/test.pl's runperl() seems easiest at the moment, and we can use the iframe method from the IDE
 	- Continue work on `WebPerl.t`
 		- More tests for Unicode support (Perl/JS interface, Perl.eval(), plus Emscripten's virtual FS)
 	- Focus on getting the tests running in the browser instead of node.js
 	- How to best package tests?
 		- If possible, a separate bundle, so that it can be loaded optionally and we don't need to rebuild
 		- How does `make test` find and handle all the various modules' `t`s?
-	- How to best disable individual tests that we know won't work? (qx etc.)
-	- How to handle the many tests that call an external Perl?
-		- patching t/test.pl's runperl() seems easiest at the moment, and we can use the iframe method from the IDE
 
 2. Misc
 	
 	- Write up a full RPC example
+	- Add `Future` to the WebPerl build for a little more async niceness?
+		- Would `Future::AsyncAwait` work in WebPerl? (Or maybe with a JS backend?)
+		- `Future::HTTP` (probably just as a frontend to XHR?)
+	- Improve Perl 6 integration
+		- Build a packaged Rakudo.js ourselves instead of borrowing from <https://perl6.github.io/6pad/>
+		- Perhaps get an API change or two into Rakudo.js: `STDOUT` currently gets output with HTML escapes
+		- See also notes in [Perl 6 Support 🦋](perl6.html)
 	- Investigate Emscripten's main loop concept for handling nonblocking sockets?
 	- Turn some patches from emperl5 into patches for P5P
 	- Submit some patches to Emscripten
 		- <https://github.com/kripken/emscripten/pull/7005>
 		- <https://github.com/kripken/emscripten/issues/7029>
 		- Would we need to patch Perl's signal functions if Emscripten's stubs weren't noisy?
-	- Add Perl.Util functions for making file uploads and downloads easier
+	- Add `Perl.Util` functions for making file uploads and downloads easier
 		- Plus an example showing how to use it to run a "legacy" Perl script with inputs and output
-	- Perhaps create a CPAN Bundle:: module or similar for `build.pl` deps?
 	- There is some potential for restructuring:
 		- `Perl.glue()` and `Perl.dispatch()` could go into `WebPerl.xs` (?)
 		- Parts of `webperl.js` could go into `common_preamble.js` or `WebPerl.xs`,
 		  so that `emperl.js` is runnable on its own in a Web Worker (?)
 		  (see notes in `perlrunner.html` / `e12f1aa25a000`)
 		- `nodeperl_dev_prerun.js` could probably be merged into that as well
+	- Could put a `WebPerl` stub on CPAN
+		- In theory could write a `WebPerl::Local` that contains the `WebPerl` API, and
+		  have various drivers such as `WebPerl::WebDriver` or `WebPerl::JSAny` that
+		  runs the code given to WebPerl's `js()`...
 	- Regarding the funky syntax highlighting on GitHub: <https://github.com/atom/language-html/issues/88#issuecomment-431361414>
 
 3. See Also

From e52844123f1f51d2da28904eb51a1367ea14c94c Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Sat, 2 Mar 2019 12:06:35 +0100
Subject: [PATCH 09/10] Added two sentences to Using, and updated Notes

---
 notes.md | 4 ++--
 using.md | 6 ++++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/notes.md b/notes.md
index 464fd8f..d95a607 100644
--- a/notes.md
+++ b/notes.md
@@ -23,8 +23,8 @@ Other places I've written about WebPerl:
 Talks:
 
 - YAPC::EU 2018 in Glasgow - [lightning talk](http://act.perlconference.org/tpc-2018-glasgow/talk/7475), [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)
-- *(planned)* German Perl Workshop 2019 - [talk](http://act.yapc.eu/gpw2019/talk/7616) (in German 🇩🇪)
-- *(hopefully)* YAPC::EU 2019 ([PerlCon](https://perlcon.eu/)) in Rīga
+- *(planned)* German Perl Workshop 2019 in Munich - [talk](http://act.yapc.eu/gpw2019/talk/7616) (slides in English, talk in German 🇩🇪)
+- *(planned)* YAPC::EU 2019 (PerlCon) in Rīga - [talk](https://perlcon.eu/talk/40)
 
 [![DOI 10.5281/zenodo.1400490](https://zenodo.org/badge/DOI/10.5281/zenodo.1400490.svg)](https://doi.org/10.5281/zenodo.1400490)
 
diff --git a/using.md b/using.md
index b22900d..0275cee 100644
--- a/using.md
+++ b/using.md
@@ -271,8 +271,9 @@ It is important to keep apart the different ways to access files:
 - A `<script type="text/perl" src="foo.pl"></script>` tag will cause `webperl.js`
   to fetch `foo.pl` from the *web server*, not the virtual filesystem!
   - *However*, that Perl script will *also* only see the virtual filesystem,
-    not the web server, so it won't even be able to see "itself". You can still
-    fetch things from the webserver using e.g. AJAX requests.
+    not the web server, so it won't even be able to see "itself" (`webperl.js`
+    may save files such as `/tmp/scripts.pl`, but that's *not* guaranteed).
+    You can still fetch things from the webserver using e.g. AJAX requests.
 
 While a WebPerl instance is running, you can modify files in the virtual file system
 as you might be used to from regular Perl. But the virtual filesystem is reloaded every
@@ -294,6 +295,7 @@ either. If you need to safely store files, it's best to store them on the user's
 In particular, even though you might make heavy use of `/mnt/idb` when testing with the "mini IDE",
 remember that this storage is *not* a way to distribute files to your users, and in fact, some
 users' browsers may automatically regularly clear the `IndexedDB`, or have it disabled altogether.
+It also may not work at all in a "sandboxed" `iframe`.
 For providing your application to your users, either use `<script type="text/perl">` tags,
 compile the script into the virtual file system, or use the JavaScript `Perl` object.
 

From f532330913f9d16c4915430a72c836c697bd6470 Mon Sep 17 00:00:00 2001
From: Hauke D <haukex@zero-g.net>
Date: Sat, 2 Mar 2019 13:13:54 +0100
Subject: [PATCH 10/10] Minor reordering of Notes

---
 notes.md | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/notes.md b/notes.md
index d95a607..93d54f3 100644
--- a/notes.md
+++ b/notes.md
@@ -20,7 +20,7 @@ Other places I've written about WebPerl:
 - [Embedding WebPerl Code Demos into Other Pages](https://www.perlmonks.org/?node_id=1223812)
 - [WebPerl now has Experimental Perl 6 Support!](https://www.perlmonks.org/?node_id=1225647)
 
-Talks:
+### Talks
 
 - YAPC::EU 2018 in Glasgow - [lightning talk](http://act.perlconference.org/tpc-2018-glasgow/talk/7475), [Video Link](https://youtu.be/KrGSg7uVZj0?t=29520)
 - *(planned)* German Perl Workshop 2019 in Munich - [talk](http://act.yapc.eu/gpw2019/talk/7616) (slides in English, talk in German 🇩🇪)
@@ -38,6 +38,14 @@ Talks:
 - [Facebook Group "Perl Programmers" (2018-10-20)](https://www.facebook.com/groups/perlprogrammers/permalink/2141844605848316/)
 - [Reddit /r/perl: WebPerl Regex Tester (2018-09-05)](https://www.reddit.com/r/perl/comments/9d5n77/webperl_regex_tester/)
 
+### Prior Art
+
+Several people have built microperl with Emscripten:
+
+- Harsha <https://github.com/moodyharsh/plu>
+- Shlomi Fish <https://github.com/shlomif/perl5-for-JavaScript--take2>
+- FUJI Goro <https://github.com/gfx/perl.js>
+
 
 TODOs
 -----
@@ -175,16 +183,6 @@ Release Checklist
 - If there was a `pages_for_vX.XX` branch of `gh-pages`, don't forget to merge that
 
 
-Prior Art
----------
-
-Several people have built microperl with Emscripten:
-
-- Harsha <https://github.com/moodyharsh/plu>
-- Shlomi Fish <https://github.com/shlomif/perl5-for-JavaScript--take2>
-- FUJI Goro <https://github.com/gfx/perl.js>
-
-
 ***
 
 Copyright (c) 2018 Hauke Daempfling (haukex@zero-g.net)