Skip to content

pdf-association/pdf-issues

Repository files navigation

PDF 2.0 Issues

PDF support     PDF subsets     LinkedIn     Twitter Follow     YouTube Channel Subscribers

Get your zero-cost copy of ISO 32000-2 now! Includes ISO-approved errata and new PDF 2.0 crypto extensions.

Stats

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

About

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 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 the PDF Association's PDF 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 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/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)

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 published ISO PDF 2.0-based standard, 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 may also get passed on 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, some errata may 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