search

rfc-format / draft-iab-rfcv3-preptool-bis

-bis document for the RFC format preptool draft
0 stars 0 forks source link

inconsistency with v3 spec with respect to derivedContent for xref->reference #6

Open reschke opened 7 years ago

reschke commented 7 years ago

https://greenbytes.de/tech/webdav/rfc7998.html#rfc.section.5.4.8.2

For format='default' and the "target" attribute points to a or \ element, the "derivedContent" is the value of the "target" attribute (or the "to" attribute of a \ element for the targeted \).

The v3 spec says that in this case "[xxx]" is inserted - so the prep tool essentially makes this case different from other cases of text insertion. It would be good if no special case was needed.

hildjj commented 7 years ago

Please give an example.

reschke commented 7 years ago

See above: when the target is a \, with anchor "ref" the formatter will insert "[ref]", while the prep tools wants the derived content to be "ref".

hildjj commented 7 years ago

I meant an example input, the output it currently gives, and the output you want. Please don't make make me chase down the details that you currently have in front of you.

reschke commented 7 years ago

Target:

<reference anchor="FOO" ...

Link:

<xref target="FOO"/>

Current:

<xref target="FOO" derivedContent="FOO"/>

Desired:

<xref target="FOO" derivedContent="[FOO]"/>