PDF 2.0 Issues
This public GitHub repository "pdf-issues" is hosted by the PDF Association and provides all developers a means of openly reporting errata against ISO PDF related standards for review and resolution by industry and ISO experts. All issues in ISO PDF related standards 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 will 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 ISO logo is also shown , then that errata has been approved by the appropriate ISO working groups responsible for PDF.
Due to ISO copyright, only minimal surrounding text from the relevant ISO standard is provided that is sufficient to understand how the resolution is being applied.
Errata in the following published ISO publications are supported:
Core PDF technologies
- PDF 2.0 (ISO 32000-2:2020) - Resolved errata
- ECMAScript for PDF 2.0 (ISO 21757-1:2020) - Resolved errata
- XFDF 3.0 (ISO 19444-1:2019)
PDF/A (ISO 19005) - PDF for long-term preservation
- PDF/A-4 (ISO 19005-4:2020) - Resolved errata
- PDF/A-3 (ISO 19005-3:2012) - see TechNote 0010
- PDF/A-2 (ISO 19005-2:2011) - see TechNote 0010
- PDF/A-1 (ISO 19005-1:2005) - see PDF/A-1 Technical Notes and TechNote 0010
PDF/X (ISO 15930) - PDF for prepress digital data exchange
- 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 (ISO 16612) - PDF for variable data & transactional printing
- PDF/VT-3 (ISO 16612-3:2020) - Resolved Errata
- PDF/VT-2 (ISO 16612-2:2010)
PDF/UA (ISO 14289) - PDF for universal accessibility
- PDF/UA-1 (ISO 14289-1:2014)
Other ISO PDF publications
Errata on PDF 1.7 (ISO 32000-1:2008) and withdrawn ISO publications are not supported. 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
- Open a new GitHub Issue. Clearly explain the mistake you have found in a published ISO PDF 2.0-based standard, or the feature you would like to see in a future version.
- The community can discuss and contribute to open issues here in GitHub, and work towards a proposed resolution.
- 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 may also get passed on to other TWGs.
- 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/.
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:
- https://pdf-issues.pdfa.org/21757-1-2020/ links directly to every resolution in ISO 21757-1:2020 ECMAscript for PDF 2.0.
- https://pdf-issues.pdfa.org/32000-2-2020/clauseAnnexQ.html links directly to all resolutions in Annex Q (normative) Method for determining transparency on a page of ISO 32000-2:2020 (PDF 2.0).
- https://pdf-issues.pdfa.org/32000-2-2020/clause12.html#H12.5.6.5 links directly to all resolutions in ISO 32000-2:2020 (PDF 2.0) clause 12.5.6.5 Link annotations.
- https://pdf-issues.pdfa.org/32000-2-2020/clause08.html#Table87 links directly to all resolutions in ISO 32000-2:2020 (PDF 2.0) Table 87 - Additional entries specific to an image dictionary.
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.