Re: [dita-comment] @keyref attribute is not defined for msgph, userinput, systemoutput and filepath in softwareDomain.mod

[Kristen James Eberlein <kris@eberleinconsulting.com>]

Hi, Makita-san.

I think that the grammar files are correct, and the written 
specification is in error. I'll put this on the agenda for our DITA TC 
call next week. Thank you for bringing this to our attention.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 7/1/2020 8:23 AM, Toshihiko Makita wrote:
> Hi List,
>
> If this is already reported or known problem, please forgive me.
>
> One of our user reported that <msgph>, <userinput>, <systemoutput> and 
> <filepath> in Software Domain should have @keyref attribute according 
> to the DITA 1.3 specification.
>
> > The following attributes are available on this element: Universal 
> attribute group , outputclass, and @keyref .
>
> 3.10.7.6.1 <msgph>
> http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/langRef/technicalContent/msgph.html#msgph 
>
>
> 3.10.7.6.7 <userinput>
> http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/langRef/technicalContent/userinput.html#userinput 
>
>
> 3.10.7.6.8 <systemoutput>
> http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/langRef/technicalContent/systemoutput.html#systemoutput 
>
>
> 3.10.7.6.6 <filepath>
> http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/langRef/technicalContent/filepath.html#filepath 
>
>
> However when this user authors @keyref attribute for these elements, 
> the XML Editor (oXygen) reports validation error for the next sample 
> data.
>
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
> <concept id="cSoftwareDomain" xml:lang="en-US">
> ÂÂÂ <title>Software Domain</title>
> ÂÂÂ <shortdesc>Testing software domain keyref function.</shortdesc>
> ÂÂÂ <conbody>
> ÂÂÂÂÂÂÂ <p>This <xmlelement>msgph</xmlelement> uses 
> <xmlatt>keyref</xmlatt> attribute: <msgph keyref="NOTE"/></p>
> ÂÂÂÂÂÂÂ <p>This <xmlelement>userinput</xmlelement> uses 
> <xmlatt>keyref</xmlatt> attribute: <userinput keyref="NOTE"/></p>
> ÂÂÂÂÂÂÂ <p>This <xmlelement>systemoutput</xmlelement> uses 
> <xmlatt>keyref</xmlatt> attribute: <systemoutput keyref="NOTE"/></p>
> ÂÂÂÂÂÂÂ <p>This <xmlelement>filepath</xmlelement> uses 
> <xmlatt>keyref</xmlatt> attribute: <filepath keyref="OT_PATH"/></p>
> ÂÂÂ </conbody>
> </concept>
>
> E [Xerces] Attribute "keyref" is not allowed to appear in element 
> "msgph".
> E [Xerces] Attribute "keyref" is not allowed to appear in element 
> "userinput".
> E [Xerces] Attribute "keyref" is not allowed to appear in element 
> "systemoutput".
> E [Xerces] Attribute "keyref" is not allowed to appear in element 
> "filepath".
>
> I have analyzed relevant DTD file and found that @keyref attribute is 
> not defined for these elements in softwareDomain.mod file.
>
> https://github.com/oasis-tcs/dita/blob/hotfix/DITA-1.3_Errata03/doctypes/dtd/technicalContent/dtd/softwareDomain.mod 
>
>
> https://github.com/dita-ot/dita-ot/blob/develop/src/main/plugins/org.oasis-open.dita.v1_3/dtd/technicalContent/dtd/softwareDomain.mod 
>
>
> If this is the bug, early fix is much appreciated.
>
> Regards,