Permalink
Commits on Dec 15, 2017
  1. Add an introductory API overview block for EventSource

    sideshowbarker authored and domenic committed Dec 15, 2017
    This change adds a domintro block in the section that defines the EventSource
    interface. It also adds markup to cause more implementor-specific parts of the
    “Server-sent events” section to be suppressed in the developer edition.
Commits on Dec 13, 2017
Commits on Dec 12, 2017
  1. Add domintro blocks for “Web storage” interfaces

    sideshowbarker authored and domenic committed Dec 12, 2017
    This change adds domintro blocks in the “Web storage” section and adds
    markup to cause more implementer-specific parts of that section of the
    spec to be suppressed in the developer edition.
    
    While here, removed some bogus spec text that implied you could return
    null for window.sessionStorage, contradicting the IDL and also the
    sentence after it that said that such a storage area must always exist.
Commits on Oct 31, 2017
  1. Dev edition: show "About this spec" on the index only

    sideshowbarker authored and domenic committed Oct 31, 2017
    This change causes the dev edition "About this specification" section to
    be shown only on the https://html.spec.whatwg.org/dev/ (index) page
    rather than on every (split) page of the dev edition.
    
    Fixes #3160.
Commits on Oct 29, 2017
  1. Editorial: Fix “should” in input/textarea domintro

    sideshowbarker authored and domenic committed Oct 28, 2017
    This change replaces an accidental occurrence of the RFC 2119 keyword
    “should” in the domintro for attributes and methods related to selection
    inside “input” and “textarea” element content.
  2. Editorial: Cut dev-edition event-handler “must”s

    sideshowbarker authored and domenic committed Oct 28, 2017
    This change fixes a few places in the developer edition that had this language:
    
    > The following are the event handlers (and their corresponding event handler
    > event types) that must be supported...
    
    The fix ensure that the developer edition has instead this language:
    
    > The following are the event handlers (and their corresponding event handler
    > event types) supported...
    
    That is, the “that must be” part gets suppressed in the developer edition.
Commits on Oct 27, 2017
  1. Add a domintro block for WebSocket interface

    sideshowbarker authored and domenic committed Oct 27, 2017
    This change adds a domintro block in the section that defines the WebSocket
    interface and also the section that defines the CloseEvent interface.
    Additionally, it adds markup to cause more implementor-specific parts of the
    “Web sockets” section of the spec to be supressed in the developer edition.
Commits on Oct 25, 2017
  1. Editorial: remove stray heading from dev edition

    sideshowbarker authored and annevk committed Oct 25, 2017
    This change suppresses a stray “IDL definitions” subheading that otherwise shows
    up at https://html.spec.whatwg.org/dev/webappapis.html#idl-definitions (in the
    dev edition) as a content-less subsection (because all that subsection contains
    is an IDL block, which the dev build already automatically suppresses).
Commits on Oct 17, 2017
  1. Editorial: mark "subdfn"s in some places where they were missing

    sideshowbarker authored and domenic committed Oct 17, 2017
    This change adds the "subdfn" attribute to some elements in "domintro"
    sections that were missing it. This enables the dev edition to have the
    right fragment IDs and cross-references for those items.
Commits on Oct 6, 2017
  1. Require UTF-8

    sideshowbarker authored and annevk committed Oct 6, 2017
    This change adds a “must” requirement for UTF-8 in all but one of the places in the standard that define a means for specifying a character encoding.
    
    Specifically, it makes UTF-8 required for any “character encoding declaration”, which includes the HTTP Content-Type header sent with any document, the `<meta charset>` element, and the `<meta http-equiv=content-type>` element.
    
    Along with those, this change also makes UTF-8 required for `<script charset>` but also moves `<script charset>` to being obsolete-but-conforming (because now that both documents and scripts are required to use UTF-8, it’s redundant to specify `charset` on the `script` element, since it inherits from the document).
    
    To make the normative source of those requirements clear, this change also adds a specific citation to the relevant requirement from the Encoding standard, and updates the in-document IANA registration for text/html media type to indicate that UTF-8 is required. Finally, it changes an existing requirement for authoring tools to use UTF-8 from a “should” to a “must”.
    
    The one place where this change doesn’t yet add a requirement for UTF-8 is for the `form` element’s `accept-charset` attribute. For that, see issue #3097.
    
    Closes #3004.
Commits on Oct 3, 2017
  1. Editorial: fix URLs to avoid redirects; use https

    sideshowbarker authored and domenic committed Oct 3, 2017
    This change updates various URLs in the spec to avoid redirects and to
    replace more http URLs with https URLs where we can (e.g., for all the
    links to unicode.org documents in the References section). It also
    tweaks the header links to fix #2906.
Commits on Oct 2, 2017
  1. Fix some broken/stale external and internal links

    sideshowbarker authored and domenic committed Sep 27, 2017
    This change fixes some links — both external and internal — mostly links with
    broken fragments. Some specific notes about a couple complete removals of links:
    
    * Removes stale link to WebIDL `RegExp` , which the WebIDL spec no longer has —
      and all references for which were already dropped from the HTML spec anyway.
    
    * Removes broken link to the definition of the CSS `<position>` data type, which
      isn’t actually currently referenced in the HTML spec.
    
    * Removes crufty link to Service Workers “use cache”, which has already been
      superseded by other language in the Service Workers spec and HTML spec.
Commits on Oct 1, 2017
  1. Update CSS Overflow reference to version we need

    sideshowbarker committed Oct 1, 2017
    The HTML spec depends on having a CSS Overflow spec that defines the CSS
    ‘overflow’ property, but the spec at https://drafts.csswg.org/css-overflow/
    no longer defines the ‘overflow’ property; instead, the ‘overflow’ property
    definition is in the spec at https://drafts.csswg.org/css-overflow-3/. So, for
    the time being at least, we have the HTML spec reference use that version
    (the Level 3 version) of the CSS Overflow spec.
    
    This change also drops *‘Level N’* qualifiers from a couple other CSS spec
    names in the References section — because, regardless of what version of a
    particular CSS module spec we’re referencing, our style is to consistently just
    cite the name of the spec without the *‘Level N’* qualifier.
Commits on Sep 27, 2017
  1. Add Secure Contexts to References section

    sideshowbarker authored and annevk committed Sep 27, 2017
    This change adds Secure Contexts to the References section. (We had somehow overlooked this til now…)
Commits on Sep 16, 2017
  1. Clarify template content model and syntax

    sideshowbarker committed Sep 16, 2017
    This change adds a link in the `template` *Content model* header
    directly to the related example in the prose of the `template` section
    that helps make clear why the content model is `Nothing`.
    
    This change also adds the `template` element as a new (sixth) element
    type in the HTML Syntax: Writing HTML documents: Elements section.
    
    Fixes #3021.
Commits on Sep 9, 2017
  1. Make some minor fixes to the FAQ

    sideshowbarker committed Sep 9, 2017
    This change is minor cleanup for 5d512fe
  2. Editorial: Update Intersection Observer spec URL

    sideshowbarker authored and foolip committed Sep 9, 2017
    We recently transferred ownership of the Intersection Observer spec from the
    WICG to the W3C. This change updates the reference here to use the new URL. The
    editing responsibilities for the spec also changed hands recently, so this
    commit also updates the name of the editor in the reference.
Commits on Sep 6, 2017
  1. Bring outdated parts of the FAQ up to date

    sideshowbarker authored and domenic committed Sep 6, 2017
    This change touches older parts of the FAQ that have become outdated,
    making adjustments to the wording to bring them into alignment with the
    language in the current spec and working mode. Some general copy-editing
    refinements are also included in the change.
Commits on Aug 28, 2017
  1. Editorial: Clarify what happens to U+0000 chars

    sideshowbarker authored and zcorpan committed Aug 28, 2017
    This changes updates a non-normative note to clarify that in some cases, the
    spec requires parsers to replace U+0000 characters with U+FFFD characters.
Commits on Aug 19, 2017
  1. Fix broken step reference in “fire a DND event” algorithm

    sideshowbarker authored and annevk committed Aug 19, 2017
    A step in the “fire a DND event” algorithm referred back to an action occurring
    in the “first step” of the algorithm, but since the time when that reference was
    first made, additional steps were apparently added to the beginning of the
    algorithm such that what had been the first step is now step 3. So this change
    refines the algorithm to instead set and use an internal flag rather than
    relying on a hardcoded reference back to a specific step.
    
    Credit to @rniwa for catching it.
Commits on Jul 17, 2017
  1. dfn what it means for elements to be “referenced”

    sideshowbarker committed Jul 15, 2017
    See https://stackoverflow.com/q/45070672/441757
    
    In a few places, the spec contains statements like the following:
    
    > The figure element ... is typically referenced as a single unit from the main
    > flow of the document.
    
    ...but the spec never defines exactly what “referenced” means, which apparently
    can lead some readers to speculate and be confused about the intended meaning.
    
    So this change makes clear what “referenced” means when used in the spec.
Commits on Jul 13, 2017
Commits on Jun 15, 2017
  1. Editorial: Add missing word “attribute”

    sideshowbarker authored and domenic committed Jun 15, 2017
    This is a minor editorial change that adds the word “attribute” to a few
    sentences where it had been inadvertently omitted.
Commits on Jun 8, 2017
  1. Meta: Improve splitting of multipage output

    sideshowbarker authored and domenic committed Jun 8, 2017
    This splits the multipage spec into a larger number of individual pages,
    based on more subject-matter-oriented splits, instead of the current
    strategy which is haphazard and produces larger, less-user-friendly
    pages.
    
    Note that any broken incoming links (i.e. cases where the element with
    a given ID has moved to a new page) are automatically redirected by
    script.
    
    For reference, the files and file sizes before the split, as of this
    commit (compared to 8.6M index.html):
    
    1.3M forms.html
    1.1M embedded-content.html
    968K syntax.html
    828K semantics.html
    752K scripting.html
    716K browsers.html
    560K webappapis.html
    488K infrastructure.html
    380K indices.html
    324K interaction.html
    300K dom.html
    260K rendering.html
    212K comms.html
    192K microdata.html
    188K obsolete.html
    180K tables.html
    176K workers.html
    140K index.html
    120K xhtml.html
    108K introduction.html
     56K webstorage.html
     40K iana.html
     40K references.html
     36K acknowledgements.html
    
    and after:
    
    692K parsing.html
    552K media.html
    528K input.html
    436K canvas.html
    388K indices.html
    336K webappapis.html
    324K form-control-infrastructure.html
    300K dom.html
    260K rendering.html
    248K form-elements.html
    224K named-characters.html
    216K images.html
    208K semantics.html
    204K text-level-semantics.html
    192K microdata.html
    188K offline.html
    188K obsolete.html
    188K links.html
    188K interaction.html
    184K infrastructure.html
    180K browsing-the-web.html
    180K iframe-embed-object.html
    180K tables.html
    176K workers.html
    164K scripting.html
    152K dnd.html
    148K history.html
    144K interactive-elements.html
    144K sections.html
    140K index.html
    128K common-microsyntaxes.html
    120K grouping-content.html
    120K xhtml.html
    116K system-state.html
    108K forms.html
    108K window-object.html
    108K custom-elements.html
    108K introduction.html
    104K browsers.html
     96K web-messaging.html
     92K structured-data.html
     88K common-dom-interfaces.html
     84K semantics-other.html
     80K syntax.html
     76K embedded-content.html
     72K web-sockets.html
     64K imagebitmap-and-animations.html
     64K server-sent-events.html
     64K origin.html
     56K webstorage.html
     56K image-maps.html
     52K dynamic-markup-insertion.html
     44K urls-and-fetching.html
     44K timers-and-user-prompts.html
     40K iana.html
     40K references.html
     36K acknowledgements.html
     36K edits.html
     32K embedded-content-other.html
     24K comms.html
Commits on Jun 7, 2017
  1. Meta: enable <dfn> popups to work for the multipage spec

    sideshowbarker authored and domenic committed Jun 7, 2017
    This change enables the <dfn> popups in multipage output to show links
    to all cross-references for a term across all files in the multipage
    output.
    
    Also see prerequisite work in:
    
    - whatwg/resources.whatwg.org#56
    - whatwg/wattsi@b57d52c
    - whatwg/html-build@f1b66f0
Commits on Apr 12, 2017
  1. Make <link rel=canonical> a standard rel keyword

    sideshowbarker authored and domenic committed Apr 12, 2017
    This change adds “canonical” to the HTML spec as a standard keyword
    allowed in the value of the rel="" attribute for the <link> element.
    
    Fixes #2351.
  2. Meta: (re)export dfn for <link rel=serviceworker>

    sideshowbarker authored and annevk committed Apr 12, 2017
    The way we did this in 5aa74a0 doesn’t actually make it possible to use
    <{link/rel/serviceworker}> to create a cross-reference. But this does.
Commits on Apr 11, 2017
  1. Cut distracting statement about external resources

    sideshowbarker authored and domenic committed Apr 11, 2017
    The section of the spec that provide details about attributes for the
    link element contains the following statement:
    
    > Some of the attributes control whether or not the external resource is
    > to be applied (as defined below).
    
    This change drops that statement.
    
    That statement has been in the spec for 11 years but isn’t stating a
    normative requirement nor serving any useful purpose—instead, it’s
    actually just distracting and counter-productive in that despite saying
    “as defined below”, the notion of “to be applied” isn’t actually clearly
    defined at all in the prose anywhere in the spc below that statement.
    
    Fixes #2503.
Commits on Apr 7, 2017
Commits on Apr 6, 2017
  1. (Re)disallow script defer/async attributes w/o src

    sideshowbarker authored and domenic committed Apr 5, 2017
    This change restores the following document-conformance requirement:
    
    > The defer and async attributes must not be specified if the src
    > attribute is not present.
    
    That requirement was inadvertently dropped in cd1a9fb.
  2. Editorial: refine link-element section readability

    sideshowbarker authored and domenic committed Apr 6, 2017
    The section of the spec on the link element is long and a bit complicated.
    This editorial change does some reorganization to make it more usable/readable
    both for implementors and authors. It restructures it into several subsections
    for the normative requirements, and reorders content to keep generic link stuff
    first, with rel-specific stuff afterward, and grouped by rel.
    
    Before this change the UA requirements for implementors were intermingled among
    the document-conformance/informational parts for authors (1, 2, 3 above), and
    not called out with headings of any kind—which made the section less
    usable/readable both for implementors and authors.
    
    This change doesn’t add or alter any normative requirements; it just moves a few
    paragraphs around, adds some headings, and reorders some things.
Commits on Feb 15, 2017
  1. Add <link rel=serviceworker>+associated attributes

    sideshowbarker authored and domenic committed Feb 15, 2017
    This change defines the <link rel=serviceworker> link type and its
    associated “scope”, “workertype”, and “usecache” content attributes, as
    well as adding the corresponding “scope”, “workerType”, and “useCache”
    IDL attributes to the HTMLLinkElement interface definition.