docs: update all the READMEs with latest

Author: nlopes

README.adoc

@@ -73,7 +73,6 @@ acdc/
 
 == Known limitations
 
-* **Table spanning**: Row/column spanning not implemented
 * **Inline markup in code/links**: Bold/italic inside code spans and link text not parsed
 * **Cross-file references**: LSP and parser are single-file only
 

acdc-cli/README.adoc

@@ -82,6 +82,14 @@ cargo build --all-features
 * `manpage` - Manpage converter
 * `terminal` - Terminal converter with ANSI color support
 
+=== Parser Options
+
+* `setext` - Enable setext-style (two-line underlined) section headers
+
+=== Syntax Highlighting
+
+* `highlighting` - Enable syntax highlighting for source blocks in HTML output (uses syntect)
+
 === Development Tools
 
 * `inspect` - AST inspection tool for debugging parser output
@@ -145,6 +153,13 @@ Convert with terminal backend:
 acdc convert --backend terminal document.adoc
 ....
 
+Terminal output with pager disabled:
+
+[source,console]
+....
+acdc convert --backend terminal --no-pager document.adoc
+....
+
 Convert to embeddable HTML (no DOCTYPE, html, head, body):
 
 [source,console]

acdc-parser/README.adoc

@@ -56,7 +56,7 @@ The implementation here follows from:
 ** [x] Cell-level style (`s|`, `e|`, `m|`, `a|`, etc.)
 ** [x] CSV, PSV, DSV formats
 ** [x] AsciiDoc content in cells (`a` style)
-** [ ] Nested tables (not supported)
+** [x] Nested tables (`!===` delimiter in AsciiDoc cells)
 * [x] Admonition
 * [x] Anchors
 ** [x] Block anchors (`\[[id]]`)
@@ -72,6 +72,7 @@ The implementation here follows from:
 * [x] Cross References
 ** [x] xref macro
 ** [x] Shorthand notation (\<<id>>)
+** [x] Attribute substitution in targets and text
 * [x] Links and URLs
 ** [x] Link macro
 ** [x] URL detection and autolinks

acdc-parser/README.md

@@ -56,7 +56,7 @@ The implementation here follows from:
     * [x] Cell-level style (`s|`, `e|`, `m|`, `a|`, etc.)
     * [x] CSV, PSV, DSV formats
     * [x] AsciiDoc content in cells (`a` style)
-    * [ ] Nested tables (not supported)
+    * [x] Nested tables (`!===` delimiter in AsciiDoc cells)
 * [x] Admonition
 * [x] Anchors
     * [x] Block anchors (`[[id]]`)
@@ -72,6 +72,7 @@ The implementation here follows from:
 * [x] Cross References
     * [x] xref macro
     * [x] Shorthand notation (`<<id>>`)
+    * [x] Attribute substitution in targets and text
 * [x] Links and URLs
     * [x] Link macro
     * [x] URL detection and autolinks

converters/html/README.adoc

@@ -48,11 +48,53 @@ Supports all major AsciiDoc constructs:
 - **Text formatting**: Bold, italic, monospace, highlighting, subscript, superscript
 - **Lists**: Unordered, ordered, description lists, callout lists
 - **Blocks**: Listings, literals, examples, quotes, sidebars, open blocks
-- **Admonitions**: NOTE, TIP, IMPORTANT, WARNING, CAUTION
+- **Admonitions**: NOTE, TIP, IMPORTANT, WARNING, CAUTION (with Font Awesome icons when `:icons: font`)
 - **Media**: Images, videos (YouTube, Vimeo), audio
-- **Tables**: Full table support with headers, footers, and cell formatting
+- **Tables**: Full table support with headers, footers, cell formatting, cell spanning, and nested tables
 - **Cross-references**: Internal links and anchors
 - **Attributes**: Document-level attribute substitution
+- **Index terms**: Visible `((term))` and concealed `(((term,secondary,tertiary)))` with catalog generation
+
+### Section Numbering
+
+Documents with `:sectnums:` render numbered section headings (e.g., "1. Introduction", "1.1. Overview"). Control numbering depth with `:secnumlevels:` (default 3, max 5).
+
+[source,console]
+....
+acdc convert -a sectnums -a secnumlevels=2 document.adoc
+....
+
+Table of contents entries are also numbered when `:sectnums:` is set.
+
+### Syntax Highlighting
+
+Source blocks with a language specified render with syntax highlighting (requires the `highlighting` feature flag). Uses syntect with inline CSS styles.
+
+[source,console]
+....
+cargo build --features highlighting
+acdc convert document.adoc
+....
+
+Falls back to plain text when the language isn't recognized.
+
+### Table Enhancements
+
+Full table feature support:
+
+- **Cell spanning**: colspan (`2+|`), rowspan (`.2+|`), combined (`2.3+|`)
+- **Visual attributes**: `frame`, `grid`, `stripes`, `width`, `%autowidth`
+- **Nested tables**: Using `!===` delimiter in AsciiDoc cells
+- **Cell-level formatting**: Alignment, styles (strong, emphasis, monospace, etc.)
+
+### Substitution Control
+
+Verbatim blocks (listing, literal) support the `subs` attribute:
+
+- `subs=none` - disable all substitutions, output raw content
+- `subs=+quotes` - enable inline formatting in code blocks
+- `subs=+attributes` - enable attribute expansion
+- `subs=+replacements` - enable typography (arrows, dashes, ellipsis)
 
 ### Document Attributes
 

converters/terminal/README.adoc

@@ -9,6 +9,13 @@ A simple terminal converter for `AsciiDoc` documents.
 acdc convert --backend terminal simple.adoc
 ....
 
+When stdout is a TTY, output is automatically piped through a pager (defaults to `less -FRX` on Unix, `more` on Windows). Use `--no-pager` to disable, or set the `PAGER` environment variable for a custom pager.
+
+[source,console]
+....
+acdc convert --backend terminal --no-pager simple.adoc
+....
+
 image::images/simple.adoc.png["Simple Document"]
 
 You can also pass multiple files and it will parse and print them all.