Skip to content

Industry-based resolutions for issues and errata reported against any PDF-related specification

Notifications You must be signed in to change notification settings

pdf-association/pdf-issues

Repository files navigation

PDF Specification Issues

PDF support     PDF subsets     LinkedIn     Twitter Follow     YouTube Channel Subscribers

Get your sponsored copy of ISO 32000-2 or PDF/UA-2 now! Includes industry and ISO-approved errata and various ISO PDF 2.0 extensions.

Stats

Open Errata     Closed Errata     ISO 32000-2 Amd1     ISO Approved Errata     ISO Submitted Errata

About

This public GitHub repository is hosted by the PDF Association and provides every stakeholder a means of openly reporting errata against any PDF specification, including ISO publications and certain PDF Association industry specifications. Errata are resolved via consensus in PDF Association Technical Working Groups (open to members) and published at https://pdf-issues.pdfa.org/. For ISO publications, these industry resolutions are passed to the relevant ISO working group for later ratification.

All issues in PDF specifications are important, from minor typos and formatting issues, to larger ambiguous, unclear or apparently contradictory statements. By reaching consensus on resolutions as an industry, PDF interoperability and implementation reliability can be improved.

The current set of resolved errata are presented as additions, deletions or Editor Notes to the published wording in the relevant ISO standard organized by clause number. GitHub Issue numbers will appear as popup tooltips when hovering over changes and refer back to closed GitHub pdf-issues.

  • If a small blue ISO logo is also shown ISO approved logo, then that errata has been approved by both the PDF Association's appropriate TWG and the appropriate ISO working groups responsible for PDF.

  • If a small gray ISO logo is also shown ISO submitted logo, then that errata has been approved by the PDF Association's appropriate TWG and submitted to the appropriate ISO working group and is waiting for approval.

  • If no ISO logo is shown then the errata has been resolved by a PDF Association Technical Working Group but has not yet been submitted to ISO for ratification.

Due to ISO copyright, only minimal surrounding text from the relevant ISO publication is provided that is sufficient to understand where the resolution is being applied.

Errata in the following PDF specifications are supported:

Core PDF technologies

  • PDF/X-6 (ISO 15930-9:2020) - Resolved errata
  • PDF/X-5 (ISO 15930-8:2010)
  • PDF/X-4 (ISO 15930-7:2010)
  • PDF/X-3 (ISO 15930-6:2003)
  • PDF/VT-3 (ISO 16612-3:2020) - Resolved Errata
  • PDF/VT-2 (ISO 16612-2:2010)
  • PDF/UA-1 (ISO 14289-1:2014)
  • PDF/UA-2 (ISO 14289-2:2024)

Other ISO PDF publications

Errata on PDF 1.7 (ISO 32000-1:2008) and withdrawn ISO publications are not supported - refer to ISO 32000-2 instead. The PDF Association maintains a full list of all PDF-related ISO publications.

Not all resolutions proposed here are officially authorized by the ISO working groups responsible for PDF and may get changed when reviewed by the ISO working group.

A Simple Process

  1. Open a new GitHub Issue. Clearly explain the mistake you have found in a PDF specification, or the feature you would like to see in a future version.
  2. The community can discuss and contribute to open issues here in GitHub, and work towards a proposed resolution.
  3. The PDF Association's PDF Technical Working Group (TWG) will consider all input and reach a consensus for each proposed resolution. Issues related to PDF subset standards or specific technical topics may get delegated to other TWGs.
  4. Each issue will be updated with the agreed resolution and then Closed by moderators once the resolution is published at https://pdf-issues.pdfa.org/.
  5. At some later time, errata will be passed to the appropriate ISO working group for formal ratification.

A full list of all ISO and industry-agreed issue resolutions (as pseudo-markup) is actively maintained at https://pdf-issues.pdfa.org/.

Directly referencing resolutions

Errata can always be referred by the appropriate GitHub issue numbers(s). Resolutions are published to a set of static URLs at https://pdf-issues.pdfa.org/ of the form <standard-number>/clause<clause-number>.html. Each of these resolution pages also includes anchor points for all Headings (#Hx.y.z anchors to heading X.Y.Z in the appropriate ISO standard) and Tables (#TableXXX anchors to Table XXX in the appropriate ISO standard). This allows very precise linkages to final resolution outcomes, without scrolling through long technical GitHub discussions.

For example:

Legal

In contributing to this GitHub repository, you acknowledge that all content you share may be reproduced in whole or in part in future PDF Association publications, ISO standards or other deliverables. It is your responsibility in submitting such content to ensure that the agreement of any copyright holder has been obtained. More information about ISO contribution processes can be found here.

About

Industry-based resolutions for issues and errata reported against any PDF-related specification

Topics

Resources

Code of conduct

Stars

Watchers

Forks