[rfc-i] [IAB] draft-iab-xml2rfc-03, "1.3.3 Elements and Attributes Deprecated from v2"

Julian Reschke julian.reschke at gmx.de
Wed Mar 16 00:49:09 PDT 2016


On 2016-03-15 23:51, Paul Hoffman wrote:
>>> "Deprecate the "none" values for the "format" attribute in <xref>
>>> because it makes no sense semantically."
>>>
>>> That's incorrect -- an xref with format=none still represents an
>>> internal link, even though no extra text is generated. In formats that
>>> support linking (so anything except plain text) it is supposed to be
>>> mapped to a simple link. For instance:
>>>
>>>   <xref format="none" target="x">FOOBAR</xref>
>>
>> I think the intent is that anytime there is text inside the xref, it
>> acts like format="none", and the format attribute would be ignored.
>
> I think what Julian may be objecting to is that the case of
> format="default" with content is incorrectly defined. It currently says:
>
>        The "derivedContent" attribute will contain a text fragment that
>        describes the referenced part completely, such as "XML" for a
>        target that is a <reference>, or "Section 2" or "Table 4" for a
>        target to a non-reference.
>
> It should instead say "If there is no content, the "derivedContent"
> attribute will..." I will fix that for the next draft.

Well, until I see what "..." is I can't comment. I believe that 
pretending that nothing is auto-generated when there is text content is 
incorrect, and a breaking change compared to what the existing tools 
have been doing for plain text output for ages.

Best regards, Julian



More information about the rfc-interest mailing list