Commit `2eac492d17`

2eac492d17d6d5a1062e0cae8af31ad7c35dc76b

parent: f274b51656

Unregistered key

cmc <hello@cleberg.net> · 2026-08-23 05:13 UTC
committer: <noreply@github.com>

audit: entities are supported, not out of scope (#30)

`\alpha` renders as `&alpha;` in orgo exactly as in Emacs, from an entity table
generated out of org's own `org-entities`. The audit counted every use as
out-of-scope anyway, and `docs/guide/05-org-support.org` listed entities under
"Not supported, and what happens instead" as rendering to "Literal text" — while
the Supported section three tables above documented all 412 names, the
`\alphabet` boundary and `#+OPTIONS: e:nil`. The document contradicted itself.

`fixtures/audit-entities.org` joins the Emacs oracle, which reports 100%
agreement with 0 unexplained lines.

The out-of-scope fixture still reports 10 genuine gaps, so this narrows what the
audit calls a gap without blunting it.

Layout: unified · split

docs/guide/05-org-support.org −1

	@@ -186,7 +186,6 @@ a build.
186	\| Macros ={{{name}}}=, radio targets \| Literal text. \|	186	\| Macros ={{{name}}}=, radio targets \| Literal text. \|
187	\| Drawers other than =PROPERTIES= \| Captured and dropped, including =LOGBOOK=. \|	187	\| Drawers other than =PROPERTIES= \| Captured and dropped, including =LOGBOOK=. \|
188	\| Non-HTML export blocks \| Dropped entirely. \|	188	\| Non-HTML export blocks \| Dropped entirely. \|
189	\| Entities =\alpha= \| Literal text. \|
190	\| =#+TODO:= sequences \| Not read; the default keyword set is used. \|	189	\| =#+TODO:= sequences \| Not read; the default keyword set is used. \|
191	\| Planning lines, =: = fixed-width \| Render as ordinary paragraphs. \|	190	\| Planning lines, =: = fixed-width \| Render as ordinary paragraphs. \|
192		191

src/audit.rs +3 −1

             self.count(Scope::Out, "LaTeX fragment", at);
         }
         if entity_ref(line) {
-            self.count(Scope::Out, "entity (\\name)", at);
+            // Rendered, and rendered as org renders it: `\alpha` becomes `&alpha;` in
+            // both exporters. `fixtures/audit-entities.org` holds the oracle to that.
+            self.count(Scope::In, "entity (\\name)", at);
         }
         for (marker, name) in [
             ('*', "bold"),

tests/constructs.rs +10 −3

         "timestamps.org",
         "images.org",
         "tblfm.org",
+        "audit-entities.org",
     ] {
         let document = parse_fixture(name);
         assert!(
     );
 }
-/// A bare entity outside verbatim still counts.
+/// A bare entity outside verbatim still counts, and counts as supported: `\alpha`
+/// becomes `&alpha;` in orgo exactly as in Emacs, which the oracle checks on this same
+/// fixture. The 412 names come from org's own `org-entities`.
 #[test]
 fn audit_counts_real_entities() {
     let report = audit_fixture("audit-entities.org");
+    let line = report
+        .lines()
+        .find(|l| l.contains("entity (\\name)"))
+        .expect("a real entity is counted");
     assert!(
-        report.contains("entity (\\name)"),
+        line.starts_with("IN "),
-        "a real entity was not counted:\n{report}"
+        "an entity orgo renders exactly as Emacs does must not read as a gap:\n{line}"
     );
 }

tests/oracle.rs +1

	@@ -629,6 +629,7 @@ fn every_divergence_from_emacs_is_deliberate() {
629	"images.org",	629	"images.org",
630	"elements.org",	630	"elements.org",
631	"tblfm.org",	631	"tblfm.org",
		632	"audit-entities.org",
632	];	633	];
633	let mut offenders = Vec::new();	634	let mut offenders = Vec::new();
634	for fixture in fixtures {	635	for fixture in fixtures {

Commit 2eac492d17

Commit `2eac492d17`