<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>19514</bug_id>
          
          <creation_ts>2012-10-12 17:19:03 +0000</creation_ts>
          <short_desc>Support the FIXUP directive in publish.py</short_desc>
          <delta_ts>2012-10-15 21:56:31 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>Editor tools</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          <blocked>19515</blocked>
    
    <blocked>19522</blocked>
          <everconfirmed>1</everconfirmed>
          <reporter name="Edward O&apos;Connor">eoconnor</reporter>
          <assigned_to name="Edward O&apos;Connor">eoconnor</assigned_to>
          <cc>eoconnor</cc>
    
    <cc>erika.doyle</cc>
    
    <cc>robin</cc>
    
    <cc>silviapfeiffer1</cc>
    
    <cc>travil</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>76121</commentid>
    <comment_count>0</comment_count>
    <who name="Edward O&apos;Connor">eoconnor</who>
    <bug_when>2012-10-12 17:19:03 +0000</bug_when>
    <thetext>The FIXUP directive is used to munge H[1-6] elements to the correct levels in some of the specs produced from the source document (2d, microdata).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76149</commentid>
    <comment_count>1</comment_count>
    <who name="Edward O&apos;Connor">eoconnor</who>
    <bug_when>2012-10-12 18:49:44 +0000</bug_when>
    <thetext>I&apos;ll take a shot at this.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76172</commentid>
    <comment_count>2</comment_count>
    <who name="Edward O&apos;Connor">eoconnor</who>
    <bug_when>2012-10-12 21:02:19 +0000</bug_when>
    <thetext>EDITOR&apos;S RESPONSE: This is an Editor&apos;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: Accepted
Change Description: https://github.com/w3c/html/commit/7165244f9a0af773dec7d7fafb21254b0be784ff
Rationale: Fixed.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76289</commentid>
    <comment_count>3</comment_count>
    <who name="Robin Berjon">robin</who>
    <bug_when>2012-10-15 09:53:26 +0000</bug_when>
    <thetext>(In reply to comment #2)
&gt; Change Description:
&gt; https://github.com/w3c/html/commit/7165244f9a0af773dec7d7fafb21254b0be784ff

This is great, thanks!

Applying this and removing the hierarchy-wrangling code we had gets us very close to something that looks good, but not quite there entirely. The one piece that&apos;s missing is that by applying just this we get a spec in which HTMLPropertiesCollection is a subsection of Conformance Requirements — unlikely to be correct.

I&apos;ve tried to figure out if there&apos;s any instruction in the source to move this section around but I haven&apos;t found any. So in the meantime, I&apos;m updating my munging script to shuffle this around — but if there&apos;s a hook I&apos;ve missed please let me know.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76296</commentid>
    <comment_count>4</comment_count>
    <who name="Silvia Pfeiffer">silviapfeiffer1</who>
    <bug_when>2012-10-15 11:41:23 +0000</bug_when>
    <thetext>We can always introduce our own instructions if needed.

BTW it would be really valuable if we made a list of the directives that we actually care about. Right now I only know about w3c-html and FIXUP. Are there others?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76297</commentid>
    <comment_count>5</comment_count>
    <who name="Robin Berjon">robin</who>
    <bug_when>2012-10-15 12:12:12 +0000</bug_when>
    <thetext>(In reply to comment #4)
&gt; We can always introduce our own instructions if needed.

Sure; but before we do I want to make sure that we&apos;re not duplicating anything :)

&gt; BTW it would be really valuable if we made a list of the directives that we
&gt; actually care about. Right now I only know about w3c-html and FIXUP. Are
&gt; there others?

There are a bunch. BOILERPLATE and PUB for instance, as well as SET and INSERT. toc is used once. And the START/END aren&apos;t just for w3c-html, there are a bunch of others that we care about e.g. microdata.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76339</commentid>
    <comment_count>6</comment_count>
    <who name="Edward O&apos;Connor">eoconnor</who>
    <bug_when>2012-10-15 21:56:31 +0000</bug_when>
    <thetext>Silvia,

I essentially made such a list when I cobbled together syntax highlighting for the spec directives in specedit.el. Roughly, there are several categories:

1. Commands our editing infrastructure supports: BOILERPLATE, END, FIXUP, INSERT, INTERFACES?, PUB, SET, START, toc.

2. Commands our tooling doesn&apos;t support (yet): ADD-TOPIC, DEFER, REMOVE-TOPIC, TOPIC. Possibly also REFERENCES.

3. It also highlights things that I don&apos;t think Ian&apos;s tools do anything with but are useful for editors to notice while editing the spec, such as WARNING comments, FORK comments, and the like.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>