diff --git a/diigo-cache/scripts/compare-export.ts b/diigo-cache/scripts/compare-export.ts
index 9715ac0..5cb9208 100644
--- a/diigo-cache/scripts/compare-export.ts
+++ b/diigo-cache/scripts/compare-export.ts
@@ -1,10 +1,5 @@
 #!/usr/bin/env node
-/**
- * @file program script: does a cache hold everything in a diigo RSS
- * export? See {@link main}.
- *
- *     node scripts/compare-export.ts <cache.sqlite> <export.xml> <out-dir>
- */
+/** @file program script: does a cache hold everything in a diigo RSS export? See {@link main}. */
 import * as nodeFs from "node:fs/promises";
 import { basename, join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
@@ -107,6 +102,9 @@ export function outDir(fs: Pick<typeof nodeFs, "writeFile">, dir: string) {
 /**
  * Generates RSS from a cache's items (src/rss.ts) and compares it with a
  * diigo RSS export: title, tags, description, highlights + sticky notes.
+ *
+ *     node scripts/compare-export.ts <cache.sqlite> <export.xml> <out-dir>
+ *
  * Prints counts to stdout; writes <out-dir>/from-cache.rss and
  * <out-dir>/report.json (mismatched links, by category).
  *
diff --git a/diigo-cache/src/rss.ts b/diigo-cache/src/rss.ts
index d32ed59..dba55aa 100644
--- a/diigo-cache/src/rss.ts
+++ b/diigo-cache/src/rss.ts
@@ -1,8 +1,4 @@
-/**
- * @file cached diigo items as RSS 2.0, in the shape of diigo's RSS export
- * (`Tags:…;Description:…;Annotations and Sticky notes:…`), but well-formed
- * and with titles uncut. Pure: the caller supplies the dates.
- */
+/** @file cached diigo items as RSS 2.0, in the shape of diigo's RSS export. */
 
 import type { Item } from "./items.js";