-
Notifications
You must be signed in to change notification settings - Fork 76
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
"origin" missing from HTML spec #807
Comments
Interesting. This is rather linked to w3c/reffy#1110, which introduced logic to eliminate duplicate definitions (feature released in the same version 10.3.0). The term "origin" has more than one generic (i.e. not namespaced to any other construct) definition in HTML:
Our code just keeps the former one, and more or less silently discards the latter one (it outputs a warning in the logs but that's typically something we fail to look at). Our assumption was that specs would never define the exact same term twice. There are a number (about 145) of such occurrences in HTML though ("origin", "ltr", "rtl", "geo", "captions", "descriptions", etc.). Looking at these terms, I see that all of them have only one exported definition, all other definitions being internal to the spec. That seems good. So the valid assumption should rather be that there is always only one exported definition of a given term. If there are multiple internal definitions of the same term, that does not seem fantastic to me, but that's the spec's problem, and more importantly it won't crash ReSpec since it only considers exported terms. I'll update the logic in Reffy accordingly. FWIW, there is actually one term that is exported twice in HTML: the |
See w3c/webref#807 for context. Reffy assumed that specs would define a term only once. The HTML spec has many internal re-definitions of the same term. That's probably not fantastic, but not fully wrong either, and references link to the right definition each time. This adjusts the assumption to "specs export a term only once". Private definitions are left intact (and these duplicates will re-appear in the extracts).
See w3c/webref#807 for context. Reffy assumed that specs would define a term only once. The HTML spec has many internal re-definitions of the same term. That's probably not fantastic, but not fully wrong either, and references link to the right definition each time. This adjusts the assumption to "specs export a term only once". Private definitions are left intact (and these duplicates will re-appear in the extracts).
Thank you both, this looks fixed to me now! |
Yes, fixed in Reffy and definition is now back in Webref and ReSpec's xref database. I also reported the duplicate exported |
7bfd13c#diff-f329e3f05c7626cf44bf8ed92ba9f20df3c6a2bd7ef3f3f966f6583afa3508d2L55045 removed the "origin" term from HTML even though it's still defined at the same URL. This was the first run with reffy 10.3.0, and w3c/reffy#1120 looks maybe-related.
The text was updated successfully, but these errors were encountered: