Skip to content

Run specfmt over source#12373

Open
keithamus wants to merge 1 commit intowhatwg:mainfrom
keithamus:run-specfmt-over-source
Open

Run specfmt over source#12373
keithamus wants to merge 1 commit intowhatwg:mainfrom
keithamus:run-specfmt-over-source

Conversation

@keithamus
Copy link
Copy Markdown
Member

@keithamus keithamus commented Apr 15, 2026

This is a simple editorial change that just runs specfmt source, committing the result.


I'm not sure if we want this, but running specfmt today introduces all of these changes which makes the tool more difficult to use than it could be.

I'd be happy to explore this some more, including:

  1. I can make a smaller set of PRs which change individual sections, which may be easier to merge?
  2. We can add a .git-blame-ignore-revs file to ensure this commit doesn't appear in blame logs.

/browsers.html ( diff )
/browsing-the-web.html ( diff )
/comms.html ( diff )
/document-sequences.html ( diff )
/dom.html ( diff )
/embedded-content.html ( diff )
/form-elements.html ( diff )
/iframe-embed-object.html ( diff )
/infrastructure.html ( diff )
/input.html ( diff )
/interactive-elements.html ( diff )
/links.html ( diff )
/media.html ( diff )
/nav-history-apis.html ( diff )
/semantics-other.html ( diff )
/semantics.html ( diff )
/server-sent-events.html ( diff )
/urls-and-fetching.html ( diff )
/web-messaging.html ( diff )
/webappapis.html ( diff )
/workers.html ( diff )

@keithamus keithamus requested review from annevk and zcorpan April 15, 2026 09:27
@keithamus keithamus added the editorial Changes that do not affect how the standard is understood label Apr 15, 2026
Copy link
Copy Markdown
Member

@zcorpan zcorpan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When running specfmt --full-spec source I get a much larger diff:

 1 file changed, 10310 insertions(+), 10536 deletions(-)

Comment thread source
Comment on lines +4255 to +4258
and <dfn
data-x-href="https://drafts.csswg.org/geometry/#create-a-dommatrix-from-the-2d-dictionary">create
a <code>DOMMatrix</code> from a 2D dictionary</dfn> algorithms for
<code>DOMMatrix2DInit</code> or <code>DOMMatrixInit</code></li>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should stay as-is. It's a bit curious that the previous lines above weren't reflowed despite being too long.

See the first commit in #11640

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial Changes that do not affect how the standard is understood

Development

Successfully merging this pull request may close these issues.

2 participants