deploy: ab63796

documentation.html

@@ -778,8 +778,17 @@ <h3 id="importing-external-rules">Importing External Rules</h3>
        grammar, NOT the source.  Grammars MUST be compiled by a version that
        supports imports in order to be imported.  Only rules that are allowed
        start rules are valid.  It can be useful to specify
-       <code>--allowed-start-rules \*</code> in library grammars. All of the
-       following are valid:</p>
+       <code>--allowed-start-rules *</code> (with appropriate escaping for
+       your shell!) in library grammars.  Imports are only valid in output
+       formats "es" and "commonjs".  If you use imports, you should use
+       <code>{ output: "source" }</code>; the default output of "parser" will
+       call `eval` on the source which fails immediately for some formats
+       (e.g. "es") and will not find modules in the expected places for others
+       (e.g. "commonjs").  The
+       <a href="https://github.com/peggyjs/from-mem/">from-mem</a> project is
+       used by the Peggy CLI to resolve these issues, but note well its
+       relatively severe limitations.</p>
+       <p>All of the following are valid:</p>
     <ul>
       <li><code>import * as num from "number.js" // Call with num.number</code></li>
       <li><code>import num from "number.js" // Calls the default rule</code></li>

index.html

@@ -43,7 +43,7 @@ <h2>Parser Generator for JavaScript</h2>
   <div class="label">Download browser version</div>
   <span id="download">
     <a title="Download a minified version of Peggy for the browser"
-      href="https://unpkg.com/[email protected].1/browser/peggy.min.js">minified</a>
+      href="https://unpkg.com/[email protected].2/browser/peggy.min.js">minified</a>
   </span>
   <iframe id="discord"
     src="https://discordapp.com/widget?id=985995982909100082&theme=dark"

js/examples.js

@@ -1,4 +1,4 @@
-// @generated by Peggy 4.0.1.
+// @generated by Peggy 4.0.2.
 //
 // https://peggyjs.org/
 (function(root) {