From f6122fd32b90c83ab5b04baa8d6c62290be324b5 Mon Sep 17 00:00:00 2001
From: "David P. Caldwell" <david@davidpcaldwell.com>
Date: Mon, 9 Sep 2024 20:51:14 -0400
Subject: [PATCH] #1657: Clean up loader/jrunscript/api.html

---
 loader/jrunscript/api.html            | 54 ---------------------------
 loader/jrunscript/expression.fifty.ts |  7 +++-
 2 files changed, 5 insertions(+), 56 deletions(-)

diff --git a/loader/jrunscript/api.html b/loader/jrunscript/api.html
index d7cbac7f8..a049dd22c 100644
--- a/loader/jrunscript/api.html
+++ b/loader/jrunscript/api.html
@@ -54,20 +54,6 @@ <h1>Properties</h1>
 		</p>
 		<div class="label">has properties:</div>
 		<ul>
-			<li class="object" jsapi:id="mime">
-				<div class="name"><a id="mime">mime</a></div>
-				<span>__DESCRIPTION__</span>
-				<div class="label">has properties:</div>
-				<script type="application/x.jsapi#initialize">
-					scope.api = jsh.unit.$slime;
-				</script>
-			</li>
-			<li class="object">
-				<div class="name">java</div>
-				<div>
-					Provides the ability to interact with native Java constructs.
-				</div>
-			</li>
 			<li class="constructor" jsapi:id="Resource">
 				<div class="name"><a id="$exports.Resource">Resource</a></div>
 				<span>Creates a <code>Resource</code> which has additional capabilities beyond the SLIME runtime <code>Resource</code>.</span>
@@ -581,47 +567,7 @@ <h1>Properties</h1>
 					verify(child).evaluate(function() { return this.run; }).is.not.equalTo(null);
 				</script>
 			</li>
-			<li class="object">
-				<div class="name">classpath</div>
-				<span>__DESCRIPTION__</span>
-				<div class="label">has properties:</div>
-				<ul>
-				</ul>
-			</li>
-			<li class="function" jsapi:id="namespace">
-				<div class="name">namespace</div>
-				<span>The platform loader's <a href="../api.html#exports.namespace"><code>namespace</code></a> method.</span>
-			</li>
-			<li class="function" jsapi:id="run">
-				<div class="name">run</div>
-				<span jsapi:id="description">
-					The platform loader's <a href="../api.html#exports.run"><code>run</code></a> method. Note that this version
-					accepts Java <a href="#types.script">script</a> instances as well as SLIME scripts.
-				</span>
-			</li>
-			<li class="function" jsapi:id="file">
-				<div class="name">file</div>
-				<span>
-					The platform loader's <a href="../api.html#exports.file"><code>file</code></a> method.  Note that this version
-					accepts Java <a href="#types.script">script</a> instances as well as SLIME scripts.
-				</span>
-			</li>
 		</ul>
-		<div>
-			If the underlying engine is Rhino, the following additional properties are added:
-			<div class="label">has properties:</div>
-			<ul>
-				<li class="function">
-					<div class="name">getDebugger</div>
-					<span>__DESCRIPTION__</span>
-					<div class="returns">
-						<div class="label">Returns</div>
-						<span class="type">__TYPE__</span>
-						<span>__DESCRIPTION__</span>
-					</div>
-				</li>
-			</ul>
-		</div>
 	</div>
 </body>
 </html>
diff --git a/loader/jrunscript/expression.fifty.ts b/loader/jrunscript/expression.fifty.ts
index ddb3c4200..b75b99ebd 100644
--- a/loader/jrunscript/expression.fifty.ts
+++ b/loader/jrunscript/expression.fifty.ts
@@ -17,6 +17,9 @@
  * For each engine, two embeddings are included: a servlet-based embedding and an embedding that supports
  * `jsh`.
  *
+ * If the underlying engine is Rhino, the {@link slime.runtime.$engine} implementation's `debugger` property is implemented in terms
+ * of the Rhino debugger.
+ *
  * ## Changes to `$api`
  *
  * The Java runtime replaces the `Type.fromName` function of {@link slime.$api.mime.Export} with a version that uses the
@@ -224,8 +227,8 @@ namespace slime.jrunscript.runtime {
 	 */
 	export interface Exports extends slime.runtime.Exports {
 		/**
-		 * The `jrunscript` implementation enhances the default MIME implementation by using the
-		 * `java.net.URLConnection.getFileNameMap()` method as an additional way to guess content types from file names.
+		 * The Java implementation enhances the default {@link slime.$api.mime.Export} implementation in the same way as the
+		 * `$api.mime` implementation is enhanced; see the {@link slime.jrunscript.runtime | "Changes to `$api`"} section.
 		 */
 		mime: slime.runtime.Exports["mime"]