fix: documentation and misspelling errors

Author: nicolaasuni

README.md

@@ -12,7 +12,7 @@
 
 [![Sponsor on GitHub](https://img.shields.io/badge/sponsor-github-EA4AAA.svg?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/tecnickcom)
 
-> 💖 **Keep TCPDF maintained.** `tc-lib-pdf` is the actively-developed successor to **TCPDF**, which is installed 100M+ times across 500+ PHP packages and is now maintenance-only. If your company depends on it, [become a sponsor](https://github.com/sponsors/tecnickcom) to keep this shared infrastructure secure and maintained — see [Sponsors](#sponsors) for tiers.
+> 💖 **Keep TCPDF maintained.** `tc-lib-pdf` is the actively-developed successor to **TCPDF**, which is installed 100M+ times across 500+ PHP packages and is now maintenance-only. If your company depends on it, [become a sponsor](https://github.com/sponsors/tecnickcom) to keep this shared infrastructure secure and maintained. See [Sponsors](#sponsors) for tiers.
 
 ---
 
@@ -49,20 +49,20 @@ It coordinates specialized companion packages for fonts, images, graphics, pages
 
 Releases follow [Semantic Versioning](https://semver.org):
 
-- **PATCH** — backwards-compatible bug fixes
-- **MINOR** — backwards-compatible new features
-- **MAJOR** — breaking changes
+- **PATCH**: backwards-compatible bug fixes
+- **MINOR**: backwards-compatible new features
+- **MAJOR**: breaking changes
 
 ---
 
 ## Sponsors
 
-`tc-lib-pdf` is the actively-developed successor to **TCPDF**, which is installed **100M+ times across 500+ PHP packages** and is now maintenance-only. If your product relies on TCPDF or `tc-lib-pdf`, sponsoring is how that shared infrastructure stays secure and maintained — closer to insurance on a dependency you already ship than to a donation.
+`tc-lib-pdf` is the actively-developed successor to **TCPDF**, which is installed **100M+ times across 500+ PHP packages** and is now maintenance-only. If your product relies on TCPDF or `tc-lib-pdf`, sponsoring is how that shared infrastructure stays secure and maintained, closer to insurance on a dependency you already ship than to a donation.
 
 [![Sponsor on GitHub](https://img.shields.io/badge/sponsor-github-EA4AAA.svg?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/tecnickcom)
 
 <!-- sponsors -->
-**Your logo here.** Be the first company to back the project — [become a sponsor →](https://github.com/sponsors/tecnickcom)
+**Your logo here.** Be the first company to back the project: [become a sponsor →](https://github.com/sponsors/tecnickcom)
 <!-- sponsors -->
 
 See **[SPONSORS.md](https://github.com/tecnickcom/.github/blob/main/SPONSORS.md)** for sponsorship tiers, how to add your logo, and the logo/content policy. Individual backers are listed in **[BACKERS.md](https://github.com/tecnickcom/.github/blob/main/BACKERS.md)**.
@@ -99,7 +99,7 @@ The fastest way to evaluate the library is to follow the installation and quick-
 - Bookmarks, named destinations, and table of contents
 - Automatic page numbering and page groups
 - Full page box control (Media/Crop/Bleed/Trim/Art), page reordering, and viewer preferences
-- **Per-page transparency group control** via `setPageTransparencyGroup()` — by default (`'auto'`) the page transparency `/Group` is emitted only on pages that actually blend, flattening fully-opaque pages for faster, more predictable printing on conservative RIPs/firmware; `'always'` keeps the group on every page (legacy) and `'never'` drops it entirely
+- **Per-page transparency group control** via `setPageTransparencyGroup()`: by default (`'auto'`) the page transparency `/Group` is emitted only on pages that actually blend, flattening fully-opaque pages for faster, more predictable printing on conservative RIPs/firmware; `'always'` keeps the group on every page (legacy) and `'never'` drops it entirely
 
 ### Images & Graphics
 - Native **JPEG**, **PNG**, and **SVG** support
@@ -111,19 +111,19 @@ The fastest way to evaluate the library is to follow the installation and quick-
 ### Security & Standards
 - Password and certificate-based document encryption (RC4 and AES, up to 256-bit)
 - Remote resource controls via `fileOptions` with host allowlists plus separate internal and markup local-path allowlists for external assets
-- **Digital signatures** — detached CMS (PKCS#7) and **PAdES baseline** signatures (ETSI EN 319 142-1) via the fluent `signature()` facade, with configurable appearance fields. Profiles: `legacy` (ISO 32000-1 `adbe.pkcs7.detached`), `pades-b-b`, `pades-b-t`, `pades-b-lt`, and `pades-b-lta` (`ETSI.CAdES.detached`), with RSA or ECDSA keys and `sha256`/`sha384`/`sha512` digests. Both local (private-key) and external/remote (HSM) signing are supported. The cryptography lives in the companion package [`tc-lib-pdf-sign`](https://github.com/tecnickcom/tc-lib-pdf-sign); see [doc/DIGITAL_SIGNATURES.md](doc/DIGITAL_SIGNATURES.md)
-- **RFC 3161 TSA timestamps** (PAdES B-T) — embed a trusted timestamp token from any RFC 3161-compliant Time Stamping Authority (TSA) into the CMS signature as the `id-aa-signatureTimeStampToken` attribute; configurable digest algorithm (`sha256`, `sha384`, `sha512`), policy OID, nonce, timeout, and TLS peer verification
-- **LTV (Long-Term Validation)** (PAdES B-LT) — embed revocation evidence in a post-signing incremental revision:
+- **Digital signatures**: detached CMS (PKCS#7) and **PAdES baseline** signatures (ETSI EN 319 142-1) via the fluent `signature()` facade, with configurable appearance fields. Profiles: `legacy` (ISO 32000-1 `adbe.pkcs7.detached`), `pades-b-b`, `pades-b-t`, `pades-b-lt`, and `pades-b-lta` (`ETSI.CAdES.detached`), with RSA or ECDSA keys and `sha256`/`sha384`/`sha512` digests. Both local (private-key) and external/remote (HSM) signing are supported. The cryptography lives in the companion package [`tc-lib-pdf-sign`](https://github.com/tecnickcom/tc-lib-pdf-sign); see [doc/DIGITAL_SIGNATURES.md](doc/DIGITAL_SIGNATURES.md)
+- **RFC 3161 TSA timestamps** (PAdES B-T): embed a trusted timestamp token from any RFC 3161-compliant Time Stamping Authority (TSA) into the CMS signature as the `id-aa-signatureTimeStampToken` attribute; configurable digest algorithm (`sha256`, `sha384`, `sha512`), policy OID, nonce, timeout, and TLS peer verification
+- **LTV (Long-Term Validation)** (PAdES B-LT): embed revocation evidence in a post-signing incremental revision:
   - collects the signing certificate chain and fetches OCSP responses and/or CRL payloads from AIA and CDP URLs
   - deduplicates binary payloads by fingerprint
   - emits a Document Security Store (`/DSS`) carrying `/VRI`, `/Certs`, `/OCSPs`, and `/CRLs`, referenced from the re-emitted document catalog
   - each feature (OCSP, CRL, cert embedding, DSS, VRI) can be enabled independently via the `signature()` LTV options
-- **Archive timestamps** (PAdES B-LTA) — add a `/Type /DocTimeStamp` archive timestamp over the whole document in a further incremental revision via `signature()->upgradeToLta()`
+- **Archive timestamps** (PAdES B-LTA): add a `/Type /DocTimeStamp` archive timestamp over the whole document in a further incremental revision via `signature()->upgradeToLta()`
 - **PDF annotations**: links, text notes, file attachments, markup, shapes, media, and widgets
 - **JavaScript** embedding
-- **PDF/A** (1/2/3, including a/b/u conformance levels) — see [doc/STANDARDS.md](doc/STANDARDS.md) and [E001_invoice.php](examples/E001_invoice.php) for a Factur-X / ZUGFeRD example
-- **PDF/X** (generic alias, PDF/X-1a, PDF/X-3, PDF/X-4, PDF/X-5) — print-exchange conformance: per-variant OutputIntent identifiers, GTS_PDFXVersion in Info dict and XMP, PDF version enforcement, CMYK color forcing for restrictive profiles (X-1a, X-3), transparency restrictions, and suppression of encryption and JavaScript
-- **PDF/UA** (generic alias, PDF/UA-1, PDF/UA-2) — accessibility conformance: tagged structure tree (`StructTreeRoot` / `ParentTree`), `MarkInfo /Marked true`, document language (`/Lang`), `DisplayDocTitle true`, `ActualText` for ligatures and special glyphs, figure alt-text tagging, and heading-level clamping to prevent skipped levels; PDF/UA-2 targets PDF 2.0
+- **PDF/A** (1/2/3, including a/b/u conformance levels): see [doc/STANDARDS.md](doc/STANDARDS.md) and [E001_invoice.php](examples/E001_invoice.php) for a Factur-X / ZUGFeRD example
+- **PDF/X** (generic alias, PDF/X-1a, PDF/X-3, PDF/X-4, PDF/X-5): print-exchange conformance covering per-variant OutputIntent identifiers, GTS_PDFXVersion in Info dict and XMP, PDF version enforcement, CMYK color forcing for restrictive profiles (X-1a, X-3), transparency restrictions, and suppression of encryption and JavaScript
+- **PDF/UA** (generic alias, PDF/UA-1, PDF/UA-2): accessibility conformance covering tagged structure tree (`StructTreeRoot` / `ParentTree`), `MarkInfo /Marked true`, document language (`/Lang`), `DisplayDocTitle true`, `ActualText` for ligatures and special glyphs, figure alt-text tagging, and heading-level clamping to prevent skipped levels; PDF/UA-2 targets PDF 2.0
 
 ### PDF Import
 - Import pages from existing PDFs as **Form XObjects** and place them on any destination page
@@ -216,17 +216,17 @@ $pdf->renderPDF($rawpdf);
 
 > **Note:** `realpath()` returns `false` when the fonts directory does not yet exist. If you see `K_PATH_FONTS` errors on first run, verify that fonts were generated after `composer install` (see [doc/FONTS.md](doc/FONTS.md)).
 
-For more complete examples — including invoices, images, barcodes, HTML tables, dedicated HTML selector/form/table showcases, PDF/X, and PDF/UA — see the [examples](examples) directory.
+For more complete examples (including invoices, images, barcodes, HTML tables, dedicated HTML selector/form/table showcases, PDF/X, and PDF/UA), see the [examples](examples) directory.
 Annotation-focused runnable example: [examples/E027_annotations.php](examples/E027_annotations.php).
 
 To run the bundled examples locally:
 
 ```bash
-make x       # build example assets
+make fonts   # generate the companion fonts used by the examples
 make server  # start a local PHP server
 ```
 
-Then open <http://localhost:8971/index.php>.
+Then open <http://localhost:8971/E000_overview.php>.
 
 If the minimal example fails on first run, verify these two points first:
 
@@ -258,11 +258,11 @@ Selected topic groups in the examples set:
 To preview examples locally:
 
 ```bash
-make x
+make fonts
 make server
 ```
 
-Then open <http://localhost:8971/index.php>.
+Then open <http://localhost:8971/E000_overview.php>.
 
 ---
 

doc/CACHE.md

@@ -4,7 +4,7 @@ Back to root overview: [README.md](../README.md#in-depth-documentation)
 
 Generating font subsets and processing images (decode, resize, re-encode) is computationally expensive. `tc-lib-pdf` can reuse these results across `Tcpdf` instances and PHP processes through an **optional external cache** that you provide.
 
-No cache backend is shipped: you implement a tiny interface that bridges to whatever store you already use (filesystem, APCu, Redis, a PSR-16 cache, ...). Caching is **disabled by default** — when no cache is supplied, behavior is unchanged.
+No cache backend is shipped: you implement a tiny interface that bridges to whatever store you already use (filesystem, APCu, Redis, a PSR-16 cache, ...). Caching is **disabled by default**: when no cache is supplied, behavior is unchanged.
 
 One cache instance is reused by every cacheable subsystem (currently font subsets and images, more may be added later), so a single backend, connection, and configuration serves them all.
 
@@ -63,8 +63,8 @@ $cache = new class implements CacheInterface {
 
 | Subsystem | Type constant | Cached value | Key prefix |
 |-----------|---------------|--------------|------------|
-| Font subsets | `CacheInterface::TYPE_FONT` | Raw subset font program (`string`, uncompressed) | `tc-lib-pdf-font:subset:v1:` |
-| Images | `CacheInterface::TYPE_IMAGE` | Processed image snapshot (`array`) | `tc-lib-pdf-image:v1:` |
+| Font subsets | `CacheInterface::TYPE_FONT` | Raw subset font program (`string`, uncompressed) | `tc-lib-pdf-font:subset:v2:` |
+| Images | `CacheInterface::TYPE_IMAGE` | Processed image snapshot (`array`) | `tc-lib-pdf-image:v2:` |
 
 Keys are already namespaced and schema-versioned by each sub-library, so a single shared store is collision-safe. The font subset cache is only consulted when font subsetting is enabled (`subsetfont: true`).
 
@@ -86,7 +86,7 @@ interface SelectiveCacheInterface extends CacheInterface
 
 When `supports()` returns `false` for a type, that type is disabled entirely: the cache is never queried or written for it, and your implementation never receives its data. A plain `CacheInterface` (without `supports()`) caches every type.
 
-Example — cache font subsets but never images:
+For example, to cache font subsets but never images:
 
 ```php
 use Com\Tecnick\Pdf\Cache\CacheInterface;

doc/ICC_PROFILE.md

@@ -2,4 +2,4 @@
 
 Back to root overview: [README.md](../README.md#in-depth-documentation)
 
-The bundled `sRGB.icc` profile is sourced from the Debian [`icc-profiles-free`](https://packages.debian.org/source/stable/icc-profiles-free) package.
+The bundled `sRGB.icc.z` profile (stored gzip-compressed) is sourced from the Debian [`icc-profiles-free`](https://packages.debian.org/source/stable/icc-profiles-free) package.

doc/STANDARDS.md

@@ -32,7 +32,12 @@ PDF/A-3 supports embedding arbitrary file attachments (for example XML invoice p
 ```php
 $pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa3');
 // ... build document ...
-$pdf->Annotation(/* file attachment annotation pointing to the XML */);
+$pdf->addContentAsEmbeddedFile(
+    file: 'factur-x.xml',
+    content: $invoiceXML,
+    mime: 'text/xml',
+    afrel: \Com\Tecnick\Pdf\AFRelationship::Alternative,
+);
 $pdf->setCustomXMP('x:xmpmeta.rdf:RDF.rdf:Description.pdfaExtension:schemas.rdf:Bag', $xmpBag);
 ```
 
@@ -94,7 +99,7 @@ When a PDF/UA mode is active the library automatically:
 To provide the document language explicitly:
 
 ```php
-$pdf->setDocInfo(['a_meta_language' => 'de-DE']);
+$pdf->setLanguageArray(['a_meta_language' => 'de-DE']);
 ```
 
 To tag decorative or repeated content as Artifact (for example headers, footers, and page numbers):

examples/E057_multisignature_incremental.php

@@ -211,11 +211,11 @@
 ]);
 
 // Primary signature appearance – placed on page 2 at the first slot.
-$pdf->setSignatureAppearance(posx: 100, posy: 45, width: 90, heigth: 35, page: $page2['pid'], name: 'Author');
+$pdf->setSignatureAppearance(posx: 100, posy: 45, width: 90, height: 35, page: $page2['pid'], name: 'Author');
 
 // Empty approval fields for the remaining approvers.
-$pdf->addEmptySignatureAppearance(posx: 100, posy: 90, width: 90, heigth: 35, page: $page2['pid'], name: 'Reviewer');
-$pdf->addEmptySignatureAppearance(posx: 100, posy: 135, width: 90, heigth: 35, page: $page2['pid'], name: 'Manager');
+$pdf->addEmptySignatureAppearance(posx: 100, posy: 90, width: 90, height: 35, page: $page2['pid'], name: 'Reviewer');
+$pdf->addEmptySignatureAppearance(posx: 100, posy: 135, width: 90, height: 35, page: $page2['pid'], name: 'Manager');
 
 // -----------------------------------------------------------------------
 // Page 3 – Workflow guide

examples/E075_external_signature_injection.php

@@ -67,7 +67,7 @@
     posx: $sigPosX,
     posy: $sigPosY,
     width: $sigWidth,
-    heigth: $sigHeight,
+    height: $sigHeight,
     page: $page['pid'],
     name: 'Remote Approval',
 );

examples/E076_absolute_position.php

@@ -29,7 +29,7 @@
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 076');
 $pdf->setTitle('Minimal Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf absolute positon');
+$pdf->setKeywords('TCPDF tc-lib-pdf absolute position');
 $pdf->setPDFFilename('076_absolute_position.pdf');
 
 // Line style

src/AFRelationship.php

@@ -5,13 +5,13 @@
 /**
  * AFRelationship.php
  *
- * @since       2026-07-17
- * @category    Library
- * @package     Pdf
- * @author      Nicola Asuni <info@tecnick.com>
- * @copyright   2002-2026 Nicola Asuni - Tecnick.com LTD
- * @license     https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
- * @link        https://github.com/tecnickcom/tc-lib-pdf
+ * @since     2026-07-17
+ * @category  Library
+ * @package   Pdf
+ * @author    Nicola Asuni <info@tecnick.com>
+ * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
+ * @license   https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
+ * @link      https://github.com/tecnickcom/tc-lib-pdf
  *
  * This file is part of tc-lib-pdf software library.
  */
@@ -26,13 +26,13 @@
  * Backed enum for the PDF/A-3 embedded file /AFRelationship value, as validated
  * by JavaScript::addEmbeddedFile().
  *
- * @since       2026-07-17
- * @category    Library
- * @package     Pdf
- * @author      Nicola Asuni <info@tecnick.com>
- * @copyright   2002-2026 Nicola Asuni - Tecnick.com LTD
- * @license     https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
- * @link        https://github.com/tecnickcom/tc-lib-pdf
+ * @since     2026-07-17
+ * @category  Library
+ * @package   Pdf
+ * @author    Nicola Asuni <info@tecnick.com>
+ * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
+ * @license   https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
+ * @link      https://github.com/tecnickcom/tc-lib-pdf
  */
 enum AFRelationship: string
 {

src/Base.php

@@ -745,12 +745,12 @@ abstract class Base
     public ObjImage $image;
 
     /**
-     * Time is seconds since EPOCH when the document was created.
+     * Time in seconds since EPOCH when the document was created.
      */
     protected int $doctime = 0;
 
     /**
-     *  Time is seconds since EPOCH when the document was modified.
+     *  Time in seconds since EPOCH when the document was modified.
      */
     protected int $docmodtime = 0;
 
@@ -813,7 +813,7 @@ abstract class Base
      *    False = LTR = Left-To-Right.
      *    True = RTL = Right-To-Left.
      *
-     * @val bool
+     * @var bool
      */
     protected bool $rtl = false;
 
@@ -822,7 +822,7 @@ abstract class Base
      *    False = LTR = Left-To-Right.
      *    True = RTL = Right-To-Left.
      *
-     * @val bool
+     * @var bool
      */
     protected bool $tmprtl = false;
 
@@ -883,7 +883,7 @@ abstract class Base
     ];
 
     /**
-     * Ration for small font.
+     * Ratio for small font.
      *
      * @var float
      */
@@ -897,7 +897,7 @@ abstract class Base
     protected const FONT_MONO = 'courier';
 
     /**
-     * Default eference values for unit conversion.
+     * Default reference values for unit conversion.
      *
      * @var TRefUnitValues
      */
@@ -1067,14 +1067,14 @@ abstract class Base
     protected array $embeddedfiles = [];
 
     /**
-     * Annotations indexed bu object IDs.
+     * Annotations indexed by object IDs.
      *
      * @var array<int, TAnnot>
      */
     protected array $annotation = [];
 
     /**
-     * Array containing the regular expression used to identify withespaces or word separators.
+     * Array containing the regular expression used to identify whitespaces or word separators.
      *
      * @var array{
      *         r: string,
@@ -1094,7 +1094,7 @@ abstract class Base
     protected string $pdffilename;
 
     /**
-     * Raw encoded fFile name of the PDF document.
+     * Raw encoded File name of the PDF document.
      */
     protected string $encpdffilename;
 
@@ -1297,7 +1297,7 @@ abstract class Base
     protected bool $defPageContentEnabled = false;
 
     /**
-     * Default font for defautl page content.
+     * Default font for default page content.
      *
      * @var ?TFontMetric
      */
@@ -1324,7 +1324,7 @@ abstract class Base
     /**
      * Default values for cell boundaries.
      *
-     * @const TCellBound
+     * @var TCellBound
      */
     public const ZEROCELLBOUND = [
         'T' => 0.0,
@@ -1336,7 +1336,7 @@ abstract class Base
     /**
      * Default values for cell.
      *
-     * @const TCellDef
+     * @var TCellDef
      */
     public const ZEROCELL = [
         'margin' => self::ZEROCELLBOUND,