This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 12570 - Missing informative reference to PDF
Summary: Missing informative reference to PDF
Status: RESOLVED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: LC1 HTML5 spec (show other bugs)
Version: unspecified
Hardware: All All
: P5 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-04-29 14:24 UTC by Leonard Rosenthol
Modified: 2011-08-04 05:05 UTC (History)
8 users (show)

See Also:


Attachments

Description Leonard Rosenthol 2011-04-29 14:24:22 UTC
PDF is mentioned in about 20 times in the HTML5 spec of which about 7 or 8 of them are in normative text (such as the one below on HTMLImageElement). However, there no reference that defines PDF.  I would recommend that it be ISO 32000-1:2008 as that reference is the international standard.  BUT since the W3C has concerns over "pay-for-access" documents, please use the FREE version of the standard that Adobe distributes (by agreement with ISO).  That document can be found at http://www.adobe.com/devnet/acrobat/pdfs/PDF32000_2008.pdf.

Making this simple change will then ensure that there is no question about what developers should be using if/when implementing support for PDF in their products.
Comment 1 Aryeh Gregor 2011-06-24 19:20:50 UTC
EDITOR'S RESPONSE: This is an Editor's Response to your comment. If you are
satisfied with this response, please change the state of this bug to CLOSED. If
you have additional information and would like the Editor to reconsider, please
reopen this bug. If you would like to escalate the issue to the full HTML
Working Group, please add the TrackerRequest keyword to this bug, and suggest
title and text for the Tracker Issue; or you may create a Tracker Issue
yourself, if you are able to do so. For more details, see this document:

   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Additional Information Needed
Change Description: no spec change
Rationale: I cannot see any reference to PDF other than in examples.  Some of these are in normative text, but those are all clearly marked with "e.g." or "for example".  Please either say exactly where PDF is referred to in a normative context, or explain why we should have references (presumably informative) to specifications that are only mentioned in examples or non-normative contexts.

Note that there are many other formats that are mentioned only in examples.  E.g., one example in "The source element" mentions H.264, AAC, MP4, MPEG-4, AMR, 3GPP, Theora, Vorbis, Ogg, Speex, FLAC, and Dirac.  Do you think that all of these formats should have informative references to the relevant standards added?  If not, why is PDF different?
Comment 2 Leonard Rosenthol 2011-06-28 07:55:55 UTC
Your point is well taken.  

In that case, I would recommend that the reference be added as an informative reference (aka bibliographic).  I would say that any other format mentioned also be listed there as well, so that implementors have official references for any mentioned material.
Comment 3 Anne 2011-06-28 08:07:52 UTC
But why do implementors need that? These are only examples and do not have any material effect on implementations.
Comment 4 Leonard Rosenthol 2011-06-28 08:33:32 UTC
I am not familiar with the rules for W3C standards, but in other bodies where I have edited documents (ISO, ETSI, etc.) there are requirements that any other standard mentioned must be referenced in either normative or informative references.
Comment 5 Anne 2011-06-28 09:10:32 UTC
I guess you are right that this needs to be done at some point. Lowering priority as it is not very important.
Comment 6 Aryeh Gregor 2011-06-28 22:38:38 UTC
(In reply to comment #2)
> In that case, I would recommend that the reference be added as an informative
> reference (aka bibliographic).  I would say that any other format mentioned
> also be listed there as well, so that implementors have official references for
> any mentioned material.

That's a lot of work for no actual benefit I can see.  Implementers of HTML are unlikely to want to implement most of these other formats, and they should be as capable of finding the relevant standards as we are.

(In reply to comment #4)
> I am not familiar with the rules for W3C standards, but in other bodies where I
> have edited documents (ISO, ETSI, etc.) there are requirements that any other
> standard mentioned must be referenced in either normative or informative
> references.

I'm pretty sure that there is no such rule in W3C's Process.  Particularly not for things only mentioned in passing in examples.

(In reply to comment #5)
> I guess you are right that this needs to be done at some point. Lowering
> priority as it is not very important.

Why does it need to be done at some point?
Comment 7 Leonard Rosenthol 2011-06-29 16:15:57 UTC
Short of locating an actual W3C-wide policy for references, the CSS Working Group has both "normative" and "other references" which are referenced differently in the specification text, for example:

http://dev.w3.org/csswg/css3-regions/#references

The SVG working group uses "normative" and "informative" references:

http://www.w3.org/TR/SVG/refs.html

Seems like HTML5 should follow suit and this then belongs in the informative/other references.
Comment 8 Aryeh Gregor 2011-06-30 19:30:52 UTC
HTML5 also has non-normative references:

http://dev.w3.org/html5/spec/references.html#references

I just question whether merely mentioning a data format in non-normative text implies we have to give a non-normative reference for it.  Adopting that policy uniformly would mean adding tons of references that practically no readers will be interested in.  Not many readers of HTML5 are going to be writing a PDF implementation (or H.264 or Speex or whatever), and the ones who are can probably find the standard themselves.  By contrast, existing non-normative references are mostly things like Atom or NPAPI, which are simple and likely to be of interest to a lot of readers.
Comment 9 Ms2ger 2011-07-20 17:10:40 UTC
http://html5.org/tools/web-apps-tracker?from=6313&to=6314

Please mark the bug as "CLOSED" if you agree with its resolution.
Comment 10 Michael[tm] Smith 2011-08-04 05:05:13 UTC
mass-moved component to LC1